@apralabs/apra-fleet 0.4.3 → 0.4.4

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 (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -1,6 +1,7 @@
1
1
  import http from 'node:http';
2
2
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
3
  import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
4
+ import { type ToolScope } from './tool-scope.js';
4
5
  interface Session {
5
6
  server: McpServer;
6
7
  transport: StreamableHTTPServerTransport;
@@ -8,10 +9,57 @@ interface Session {
8
9
  * else the local workspace (127.0.0.1-only trust boundary). Event broadcast
9
10
  * is scoped by this -- events never cross a workspace wall. */
10
11
  workspaceId: string;
12
+ /** Identity that opened this session (see SessionOwner). Every later
13
+ * GET/DELETE/POST on the session id must come from the same identity. */
14
+ owner: SessionOwner;
11
15
  }
16
+ /**
17
+ * The identity a /mcp request carries, derived the same way at initialize and
18
+ * on every later request on that session:
19
+ * - `jwt`: a VERIFIED member JWT (Authorization: Bearer); bound by its
20
+ * member_id + workspace_id claims.
21
+ * - `secret`: no bearer, so the pre-route gate already required this
22
+ * install's access secret (X-Apra-Fleet-Member-Secret). `member` is the
23
+ * resolved ?member= id at initialize (null for a FULL-scope session).
24
+ *
25
+ * Binding rule (apra-fleet-b4g.138.6): a JWT caller may address only a
26
+ * session opened with a JWT for the same member and workspace; an access-secret
27
+ * caller may address only a session opened with the access secret. Within the
28
+ * secret kind any secret-opened session is addressable, whatever ?member= the
29
+ * opener used: the secret holder can open a FULL-scope session (a superset of
30
+ * every member session) at will, and ?member= is an unauthenticated label, so
31
+ * binding on it would add no security boundary while breaking clients whose
32
+ * later requests do not repeat the initialize URL's query string.
33
+ */
34
+ export type SessionOwner = {
35
+ kind: 'jwt';
36
+ memberId: string;
37
+ workspaceId: string;
38
+ } | {
39
+ kind: 'secret';
40
+ member: string | null;
41
+ engineOrigin: boolean;
42
+ kbMaintainer: boolean;
43
+ };
44
+ /** Why `caller` may not address a session owned by `owner`, or null when it may. */
45
+ export declare function sessionOwnerMismatch(owner: SessionOwner, caller: SessionOwner): string | null;
12
46
  export interface HttpTransportOptions {
13
- registerTools: (server: McpServer) => void | Promise<void>;
47
+ /** Registers the tool surface for ONE session. `scope` is derived from the
48
+ * session's identity at initialize (see the initialize branch): MEMBER for
49
+ * a valid member JWT or a registered ?member=, FULL otherwise. An
50
+ * implementation that ignores it registers whatever it always did. */
51
+ registerTools: (server: McpServer, scope: ToolScope) => void | Promise<void>;
14
52
  preferredPort?: number;
53
+ /** The member access secret file a `?member=` request is checked against
54
+ * (default: <data dir>/member-access.key; created when missing). */
55
+ memberSecretPath?: string;
56
+ }
57
+ /** Thrown by createHttpTransport when the configured (non-zero) port is already bound. */
58
+ export declare class PortInUseError extends Error {
59
+ readonly port: number;
60
+ readonly host: string;
61
+ readonly code = "EADDRINUSE";
62
+ constructor(port: number, host: string);
15
63
  }
16
64
  export interface HttpTransportHandle {
17
65
  httpServer: http.Server;
@@ -6,10 +6,39 @@ import { fleetEvents } from './event-bus.js';
6
6
  import { getOrCreateKey } from './jwt.js';
7
7
  import { getTokenIssuer, localWorkspaceId } from './token-issuer.js';
8
8
  import { sessionRegistry } from './session-registry.js';
9
+ import { FULL_TOOL_SCOPE, memberToolScope } from './tool-scope.js';
9
10
  import { getAgent, findAgentByName } from './registry.js';
10
- import { DEFAULT_PORT, DEFAULT_HOST } from '../paths.js';
11
+ import { DEFAULT_HOST, resolveServerPort } from '../paths.js';
11
12
  import { serverVersion } from '../version.js';
12
- import { logLine } from '../utils/log-helpers.js';
13
+ import { logLine, shortSid } from '../utils/log-helpers.js';
14
+ import { recordShutdown } from './server-lifecycle.js';
15
+ import { getOrCreateMemberAccessSecret, memberAccessSecretMatches, memberAccessSecretPath, readMemberAccessSecret, MEMBER_SECRET_HEADER } from './member-access-secret.js';
16
+ /** Why `caller` may not address a session owned by `owner`, or null when it may. */
17
+ export function sessionOwnerMismatch(owner, caller) {
18
+ if (owner.kind === 'jwt') {
19
+ if (caller.kind !== 'jwt')
20
+ return 'session was opened with a member JWT; the caller presented the access secret';
21
+ if (caller.memberId !== owner.memberId || caller.workspaceId !== owner.workspaceId) {
22
+ return 'session was opened by a different member JWT';
23
+ }
24
+ return null;
25
+ }
26
+ if (caller.kind !== 'secret')
27
+ return 'session was opened with the access secret; the caller presented a member JWT';
28
+ return null;
29
+ }
30
+ /** Thrown by createHttpTransport when the configured (non-zero) port is already bound. */
31
+ export class PortInUseError extends Error {
32
+ port;
33
+ host;
34
+ code = 'EADDRINUSE';
35
+ constructor(port, host) {
36
+ super(`port ${port} on ${host} is already in use`);
37
+ this.port = port;
38
+ this.host = host;
39
+ this.name = 'PortInUseError';
40
+ }
41
+ }
13
42
  function parseBody(req) {
14
43
  return new Promise((resolve, reject) => {
15
44
  const chunks = [];
@@ -99,6 +128,10 @@ function extractBearer(req) {
99
128
  export async function createHttpTransport(options) {
100
129
  const { registerTools, preferredPort } = options;
101
130
  const sessions = new Map();
131
+ // Every install has its member access secret from the first server start
132
+ // (install creates it too): a `?member=` request must present it.
133
+ const memberSecretPath = options.memberSecretPath ?? memberAccessSecretPath();
134
+ getOrCreateMemberAccessSecret(memberSecretPath);
102
135
  const startedAt = Date.now();
103
136
  // LOW-1: Track event listener references for cleanup in close()
104
137
  const eventCleanups = [];
@@ -115,8 +148,41 @@ export async function createHttpTransport(options) {
115
148
  res.end('Session not found');
116
149
  return;
117
150
  }
151
+ if (refuseForeignCaller(req, res, sessionId, session))
152
+ return;
118
153
  await session.transport.handleRequest(req, res);
119
154
  }
155
+ /** The identity this request carries. Called only past the pre-route gate,
156
+ * so a bearer here has already verified (re-verified to read its claims). */
157
+ function callerIdentity(req) {
158
+ const bearer = extractBearer(req);
159
+ if (bearer !== null) {
160
+ const claims = getTokenIssuer().verify(bearer);
161
+ return claims ? { kind: 'jwt', memberId: claims.member_id, workspaceId: claims.workspace_id } : null;
162
+ }
163
+ const params = new URL(req.url ?? '/', 'http://localhost').searchParams;
164
+ return {
165
+ kind: 'secret',
166
+ member: params.get('member'),
167
+ engineOrigin: params.get('origin') === 'engine',
168
+ kbMaintainer: params.get('kb_maintainer') === '1',
169
+ };
170
+ }
171
+ /** 403 (and true) when the caller is not the identity that opened `session`;
172
+ * the session is left untouched and no session detail is returned. */
173
+ function refuseForeignCaller(req, res, sessionId, session) {
174
+ const caller = callerIdentity(req);
175
+ const why = caller ? sessionOwnerMismatch(session.owner, caller) : 'caller identity could not be verified';
176
+ if (why === null)
177
+ return false;
178
+ logLine('session', `rejected ${req.method} on sid=${shortSid(sessionId)}: caller=${caller?.kind ?? 'unverified'} owner=${session.owner.kind} (${why})`);
179
+ res.writeHead(403, { 'Content-Type': 'application/json' });
180
+ res.end(JSON.stringify({
181
+ error: 'session identity mismatch',
182
+ detail: `This MCP session belongs to a different caller identity (${why}). A session can be used only with the credential that opened it; open a new session instead.`,
183
+ }));
184
+ return true;
185
+ }
120
186
  const httpServer = http.createServer(async (req, res) => {
121
187
  const url = req.url ?? '/';
122
188
  if (url === '/health' && req.method === 'GET') {
@@ -144,6 +210,8 @@ export async function createHttpTransport(options) {
144
210
  return;
145
211
  }
146
212
  const body = JSON.stringify({ status: 'shutting-down' });
213
+ // GitHub #585: name the real cause before re-entering the SIGINT path.
214
+ recordShutdown('http_shutdown');
147
215
  res.writeHead(200, { 'Content-Type': 'application/json' });
148
216
  res.end(body);
149
217
  setTimeout(() => {
@@ -156,11 +224,59 @@ export async function createHttpTransport(options) {
156
224
  res.end();
157
225
  return;
158
226
  }
227
+ // Every /mcp request without a member JWT must present this install's
228
+ // member access secret (an owner-only file in its data dir). The server
229
+ // binds loopback, where every local user can connect; the secret is what
230
+ // keeps another user's session -- or one configured for another install --
231
+ // out. That covers the ?member= route (a session acting as that member)
232
+ // AND the no-member route (a FULL-scope session, which includes command
233
+ // execution on this install's local members). Read per request so a
234
+ // replaced secret takes effect at once; a missing one refuses (never fails
235
+ // open). A member JWT (Authorization: Bearer) is its own credential, but
236
+ // only a VERIFIED one replaces the secret: any bearer that fails JWT
237
+ // verification is refused here for every method, so `Bearer x` cannot
238
+ // carry a GET (SSE stream) or DELETE (session teardown) past this gate.
239
+ {
240
+ const memberRouteParam = new URL(url, 'http://localhost').searchParams.get('member');
241
+ const gateBearer = extractBearer(req);
242
+ if (gateBearer !== null) {
243
+ if (!getTokenIssuer().verify(gateBearer)) {
244
+ logLine('session', `rejected ${req.method}: jwt verify failed member_param=${memberRouteParam ?? 'none'}`);
245
+ res.writeHead(401, { 'Content-Type': 'application/json' });
246
+ res.end(JSON.stringify({ error: 'invalid token' }));
247
+ return;
248
+ }
249
+ }
250
+ else {
251
+ const expected = readMemberAccessSecret(memberSecretPath);
252
+ if (!memberAccessSecretMatches(req.headers[MEMBER_SECRET_HEADER.toLowerCase()], expected)) {
253
+ const why = req.headers[MEMBER_SECRET_HEADER.toLowerCase()] === undefined ? 'missing' : 'wrong';
254
+ const route = memberRouteParam !== null ? 'member route' : 'full-scope route';
255
+ logLine('session', `rejected ${req.method} on ${route}: access secret ${why} member_param=${memberRouteParam ?? 'none'}`);
256
+ res.writeHead(401, { 'Content-Type': 'application/json' });
257
+ res.end(JSON.stringify({
258
+ error: memberRouteParam !== null ? 'member secret required' : 'access secret required',
259
+ detail: `An /mcp session must present this apra-fleet install's access secret in the ${MEMBER_SECRET_HEADER} header (the secret was ${why}). It is in member-access.key in the install's data dir, readable only by the install's user; a session configured for another install or another user is refused. Re-run 'apra-fleet install' to rewrite this machine's user-scope MCP registration (a project-scope .mcp.json cannot carry the secret: remove its apra-fleet URL entry or add the header from member-access.key in a git-ignored local config)${memberRouteParam !== null ? ', or compose_permissions / update_member with fleet_install "auto" to rewrite the member MCP config' : ''}.`,
260
+ }));
261
+ return;
262
+ }
263
+ }
264
+ }
159
265
  if (req.method === 'POST') {
160
266
  // JWT auth: verify Bearer token if present; unauthenticated (PM/tool) connections pass through
161
267
  const rawToken = extractBearer(req);
162
268
  const parsedUrl = new URL(req.url ?? '/', 'http://localhost');
163
269
  const memberParam = parsedUrl.searchParams.get('member');
270
+ // origin=engine: set ONLY by the engine's own member-session paths
271
+ // (client connectFleetMember with { origin: 'engine' }, used by memberCall
272
+ // and the `apra-fleet call` verb). Recorded on the session's tool scope so
273
+ // its kb_/code_ calls are not counted against the member.
274
+ const engineOrigin = parsedUrl.searchParams.get('origin') === 'engine';
275
+ // kb_maintainer=1: the engine's kb_maintainer grant (client
276
+ // connectFleetMember with { origin: 'engine', kbMaintainer: true }, used
277
+ // by memberCall for the member it chose as a repository's kb_maintainer).
278
+ // Honoured only with origin=engine; see memberToolScope.
279
+ const kbMaintainerParam = parsedUrl.searchParams.get('kb_maintainer') === '1';
164
280
  let postClaims = null;
165
281
  if (rawToken !== null) {
166
282
  postClaims = getTokenIssuer().verify(rawToken);
@@ -184,7 +300,10 @@ export async function createHttpTransport(options) {
184
300
  return;
185
301
  }
186
302
  if (isInitializeRequest(parsedBody)) {
187
- logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'}`);
303
+ logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'} engine_origin=${engineOrigin} kb_maintainer=${kbMaintainerParam}`);
304
+ if (kbMaintainerParam && !engineOrigin) {
305
+ logLine('session', 'kb_maintainer=1 without origin=engine ignored: the grant is engine-only');
306
+ }
188
307
  const body = parsedBody;
189
308
  const clientInfo = body?.params?.clientInfo ?? {};
190
309
  const clientCaps = body?.params?.capabilities ?? {};
@@ -204,13 +323,23 @@ export async function createHttpTransport(options) {
204
323
  // (unauthenticated local fallback) historically carried the friendly
205
324
  // name; new URLs carry the UUID, and legacy friendly names are resolved
206
325
  // to the UUID via the agent registry here.
326
+ //
327
+ // The param must name a REGISTERED member: an id that resolves through
328
+ // neither getAgent nor findAgentByName is refused with 403 rather than
329
+ // conjuring a member identity (and a member session) from a raw string.
207
330
  let fallbackMemberId = null;
208
331
  let fallbackWorkFolder = '';
209
332
  if (postClaims === null && memberParam !== null) {
210
333
  const agent = getAgent(memberParam) ?? findAgentByName(memberParam);
211
- fallbackMemberId = agent?.id ?? memberParam;
212
- fallbackWorkFolder = agent?.workFolder ?? '';
213
- if (agent && agent.id !== memberParam) {
334
+ if (!agent) {
335
+ logLine('session', `rejected initialize: unknown member_param=${memberParam}`);
336
+ res.writeHead(403, { 'Content-Type': 'application/json' });
337
+ res.end(JSON.stringify({ error: 'unknown member' }));
338
+ return;
339
+ }
340
+ fallbackMemberId = agent.id;
341
+ fallbackWorkFolder = agent.workFolder ?? '';
342
+ if (agent.id !== memberParam) {
214
343
  logLine('session', `resolved URL member param '${memberParam}' to member_id=${agent.id}`);
215
344
  }
216
345
  }
@@ -218,13 +347,26 @@ export async function createHttpTransport(options) {
218
347
  // from this machine (server binds 127.0.0.1), so they belong to the
219
348
  // local workspace. Authenticated sessions use the JWT's workspace_id.
220
349
  const sessionWorkspaceId = postClaims?.workspace_id ?? localWorkspaceId();
350
+ // Tool scope from the identity resolved above. A valid member JWT (a
351
+ // doer subprocess connect-back or an interactive member) or a
352
+ // registered ?member= makes this a MEMBER session: the base member
353
+ // allowlist, plus the channel tools (respond_to_message) only when the
354
+ // client declared claude/channel. No member identity at all is the
355
+ // local orchestrator/PM/tool session and keeps the FULL set.
356
+ const sessionMemberId = postClaims?.member_id ?? fallbackMemberId;
357
+ const toolScope = sessionMemberId
358
+ ? memberToolScope(sessionMemberId, channelCapable, engineOrigin, kbMaintainerParam)
359
+ : FULL_TOOL_SCOPE;
360
+ const sessionOwner = postClaims
361
+ ? { kind: 'jwt', memberId: postClaims.member_id, workspaceId: postClaims.workspace_id }
362
+ : { kind: 'secret', member: fallbackMemberId, engineOrigin, kbMaintainer: kbMaintainerParam };
221
363
  const sessionServer = new McpServer({ name: `apra fleet server ${serverVersion}`, version: serverVersion }, { capabilities: { logging: {}, experimental: { 'claude/channel': {} } } });
222
364
  const sessionTransport = new StreamableHTTPServerTransport({
223
365
  sessionIdGenerator: () => crypto.randomUUID(),
224
366
  onsessioninitialized: (sid) => {
225
- sessions.set(sid, { server: sessionServer, transport: sessionTransport, workspaceId: sessionWorkspaceId });
367
+ sessions.set(sid, { server: sessionServer, transport: sessionTransport, workspaceId: sessionWorkspaceId, owner: sessionOwner });
226
368
  const hasMember = !!(postClaims || fallbackMemberId);
227
- logLine('session', `new sid=${sid} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember}`);
369
+ logLine('session', `new sid=${shortSid(sid)} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember} scope=${toolScope.kind}`);
228
370
  // Register interactive member session when JWT claims are present.
229
371
  //
230
372
  // apra-fleet-eft.28.5: carry forward the launch-time pid captured
@@ -253,13 +395,28 @@ export async function createHttpTransport(options) {
253
395
  pid: postClaims.pid ?? priorPid,
254
396
  channelCapable,
255
397
  });
256
- logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${sid} channelCapable=${channelCapable}`);
398
+ logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${shortSid(sid)} channelCapable=${channelCapable}`);
257
399
  }
258
400
  else if (fallbackMemberId) {
259
401
  // apra-fleet-eft.50.1: same durable launch-pid fallback as the
260
402
  // JWT branch above, so a URL-param reconnect on a retry keeps a
261
403
  // pid for the interactive liveness check to test.
262
- const priorPid = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId)?.pid
404
+ if (!channelCapable) {
405
+ // A tool-only member session (apra-fleet call, memberCall, a
406
+ // non-interactive agent's per-folder MCP entry) never touches
407
+ // the session registry. The registry entry is the member's
408
+ // interactive routing target: send_message pushes channel
409
+ // notifications to its server, and execute_prompt reads its
410
+ // launch-time pid. Registering here would replace a launch
411
+ // placeholder (server:null, pid set) or a missing entry with a
412
+ // session that cannot receive those pushes; onsessionclosed
413
+ // skips it for the same reason.
414
+ const existing = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
415
+ logLine('session', `tool-only member session member_id=${fallbackMemberId} sid=${shortSid(sid)} not registered (registry entry ${existing ? 'sid=' + shortSid(existing.sessionId) : 'absent'} left as is)`);
416
+ return;
417
+ }
418
+ const existing = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
419
+ const priorPid = existing?.pid
263
420
  ?? sessionRegistry.lastKnownPid(sessionWorkspaceId, fallbackMemberId);
264
421
  sessionRegistry.register({
265
422
  member_id: fallbackMemberId,
@@ -272,11 +429,11 @@ export async function createHttpTransport(options) {
272
429
  pid: priorPid,
273
430
  channelCapable,
274
431
  });
275
- logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${sid} channelCapable=${channelCapable}`);
432
+ logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${shortSid(sid)} channelCapable=${channelCapable}`);
276
433
  }
277
434
  },
278
435
  onsessionclosed: (sid) => {
279
- logLine('session', `closed sid=${sid}`);
436
+ logLine('session', `closed sid=${shortSid(sid)}`);
280
437
  // LOW-2: Close the McpServer when its session closes
281
438
  const s = sessions.get(sid);
282
439
  if (s) {
@@ -292,25 +449,27 @@ export async function createHttpTransport(options) {
292
449
  const current = sessionRegistry.get(postClaims.workspace_id, postClaims.member_id);
293
450
  if (current?.sessionId === sid) {
294
451
  sessionRegistry.unregister(postClaims.workspace_id, postClaims.member_id);
295
- logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${sid}`);
452
+ logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${shortSid(sid)}`);
296
453
  }
297
454
  else {
298
- logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${sid} (superseded by sid=${current?.sessionId ?? 'none'})`);
455
+ logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${shortSid(sid)} (superseded by sid=${shortSid(current?.sessionId)})`);
299
456
  }
300
457
  }
301
- else if (fallbackMemberId) {
458
+ else if (fallbackMemberId && channelCapable) {
459
+ // A tool-only ?member= session never registered (see
460
+ // onsessioninitialized), so it never unregisters either.
302
461
  const current = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
303
462
  if (current?.sessionId === sid) {
304
463
  sessionRegistry.unregister(sessionWorkspaceId, fallbackMemberId);
305
- logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${sid}`);
464
+ logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${shortSid(sid)}`);
306
465
  }
307
466
  else {
308
- logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${sid} (superseded by sid=${current?.sessionId ?? 'none'})`);
467
+ logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${shortSid(sid)} (superseded by sid=${shortSid(current?.sessionId)})`);
309
468
  }
310
469
  }
311
470
  },
312
471
  });
313
- await registerTools(sessionServer);
472
+ await registerTools(sessionServer, toolScope);
314
473
  await sessionServer.connect(sessionTransport);
315
474
  await sessionTransport.handleRequest(req, res, parsedBody);
316
475
  return;
@@ -327,6 +486,8 @@ export async function createHttpTransport(options) {
327
486
  res.end('Session not found');
328
487
  return;
329
488
  }
489
+ if (refuseForeignCaller(req, res, sessionId, session))
490
+ return;
330
491
  await session.transport.handleRequest(req, res, parsedBody);
331
492
  return;
332
493
  }
@@ -366,28 +527,33 @@ export async function createHttpTransport(options) {
366
527
  // LOW-1: Store cleanup so close() can unsubscribe
367
528
  eventCleanups.push(() => fleetEvents.off(eventType, handler));
368
529
  }
369
- // Start listening: try preferred port, fall back to OS-assigned port.
530
+ // Start listening on the preferred port (no fallback, see below).
370
531
  // Bind host is configurable (APRA_FLEET_HOST, default 127.0.0.1) --
371
532
  // apra-fleet-fnz.4/us9.6. Binding beyond loopback is an explicit,
372
533
  // logged opt-in: several unauthenticated code paths in this file (the
373
534
  // ?member= URL-param fallback, /shutdown's admin-key check) were
374
535
  // written assuming only same-machine callers can reach this server.
375
- const targetPort = preferredPort ?? DEFAULT_PORT;
536
+ const targetPort = preferredPort ?? resolveServerPort();
376
537
  const bindHost = DEFAULT_HOST;
377
538
  if (bindHost !== '127.0.0.1') {
378
539
  logLine('session', `WARNING: binding to ${bindHost} (not loopback-only) -- unauthenticated requests (the ?member= URL-param fallback, /shutdown) are now reachable from any host that can route to this address, not just this machine. Set APRA_FLEET_HOST=127.0.0.1 (or unset it) to restore the loopback-only default.`);
379
540
  }
541
+ // A busy configured port is a hard error (GitHub #584): there is no
542
+ // fallback to an OS-assigned port, because every configured MCP client only
543
+ // knows the configured port -- a silently re-homed server is unreachable and
544
+ // splits the fleet in two on one data dir. An explicit port 0 (callers that
545
+ // ask for an ephemeral port) is unaffected.
380
546
  let port;
381
547
  try {
382
548
  port = await listenOnPort(httpServer, targetPort, bindHost);
383
549
  }
384
550
  catch (err) {
551
+ for (const cleanup of eventCleanups)
552
+ cleanup();
385
553
  if (err.code === 'EADDRINUSE') {
386
- port = await listenOnPort(httpServer, 0, bindHost);
387
- }
388
- else {
389
- throw err;
554
+ throw new PortInUseError(targetPort, bindHost);
390
555
  }
556
+ throw err;
391
557
  }
392
558
  // Same-machine callers (register_member's own local MCP connection) always
393
559
  // use loopback -- valid regardless of bindHost, since binding to 0.0.0.0
@@ -0,0 +1,2 @@
1
+ export declare const inFlightAgents: Set<string>;
2
+ //# sourceMappingURL=in-flight-agents.d.ts.map
@@ -0,0 +1,4 @@
1
+ // In-flight agent dispatches tracked across prompt executions.
2
+ // Shared between execute_prompt, stop_prompt, and tools checking agent busy state.
3
+ export const inFlightAgents = new Set();
4
+ //# sourceMappingURL=in-flight-agents.js.map
@@ -0,0 +1,53 @@
1
+ import type { FileHashResult } from './file-hash.js';
2
+ /**
3
+ * A cited/basis path must stay inside the exported repo: relative, with no
4
+ * '..' segment and no POSIX, drive-letter or UNC root. Anything else is never
5
+ * hashed and never qualifies (the bible only describes this tree).
6
+ */
7
+ export declare function isRepoRelativePath(file: string): boolean;
8
+ /** The minimal entry shape the predicate reads. */
9
+ export interface BibleCandidate {
10
+ id: string;
11
+ confidence: string;
12
+ source_files: string[];
13
+ }
14
+ /**
15
+ * True when an entry qualifies for the project bible:
16
+ * - confidence is CONFIRMED (callers already exclude superseded/stale rows);
17
+ * - it cites at least one source file;
18
+ * - its stored basis is non-empty (null/empty/unparseable basis never matches);
19
+ * - every cited source file has a key in the basis;
20
+ * - every cited and basis path is repo-relative (isRepoRelativePath);
21
+ * - every basis hash equals that file's current hash (a missing file -- a
22
+ * null/absent current hash -- is a mismatch).
23
+ * Same comparison semantics as SqliteProvider.basisFullyMatches, plus the
24
+ * source_files coverage check.
25
+ */
26
+ export declare function qualifiesForProjectBible(entry: BibleCandidate, basis: Record<string, string> | null | undefined, currentHashes: Record<string, Pick<FileHashResult, 'hash'> | null | undefined>): boolean;
27
+ /**
28
+ * Hash every basis file once (one batch, content at repoPath's HEAD commit)
29
+ * and return the entries that pass qualifiesForProjectBible, preserving input
30
+ * order. Throws KbHeadHashError when repoPath is not inside a git work tree.
31
+ */
32
+ export declare function filterProjectBibleCandidates<T extends BibleCandidate>(entries: T[], basisById: Map<string, Record<string, string> | null>, repoPath: string): Promise<T[]>;
33
+ /** The minimal bible-entry shape the legacy backfill reads. */
34
+ export interface BibleFileEntry {
35
+ id: string;
36
+ source_files: string[];
37
+ source_file_hashes?: Record<string, string>;
38
+ }
39
+ /** True when a bible entry carries a non-empty source_file_hashes map. */
40
+ export declare function hasCarriedBasis(entry: BibleFileEntry): boolean;
41
+ /**
42
+ * The bible entries that gain a basis: for each entry in `bibleEntries` with
43
+ * no carried source_file_hashes whose id is in `kbEntries` (the writer KB's
44
+ * live entries) with the same source_files set and a stored basis passing
45
+ * qualifiesForProjectBible at repoPath's HEAD, the id mapped to that stored
46
+ * basis. Entries that do not qualify are simply absent from the result (the
47
+ * caller keeps them unchanged; nothing is ever dropped). Hashes the candidate
48
+ * basis files once; with no candidate nothing is hashed (so no git check).
49
+ * Throws KbHeadHashError when there are candidates and repoPath is not inside
50
+ * a git work tree.
51
+ */
52
+ export declare function selectLegacyBibleBackfill<K extends BibleCandidate>(bibleEntries: BibleFileEntry[], kbEntries: K[], basisById: Map<string, Record<string, string> | null>, repoPath: string): Promise<Map<string, Record<string, string>>>;
53
+ //# sourceMappingURL=bible-basis-filter.d.ts.map
@@ -0,0 +1,134 @@
1
+ import path from 'node:path';
2
+ import { computeHeadFileHashBatch } from './file-hash.js';
3
+ /**
4
+ * A cited/basis path must stay inside the exported repo: relative, with no
5
+ * '..' segment and no POSIX, drive-letter or UNC root. Anything else is never
6
+ * hashed and never qualifies (the bible only describes this tree).
7
+ */
8
+ export function isRepoRelativePath(file) {
9
+ if (typeof file !== 'string' || file.length === 0)
10
+ return false;
11
+ if (path.posix.isAbsolute(file) || path.win32.isAbsolute(file) || /^[A-Za-z]:/.test(file))
12
+ return false;
13
+ return !file.split(/[\\/]+/).includes('..');
14
+ }
15
+ /**
16
+ * True when an entry qualifies for the project bible:
17
+ * - confidence is CONFIRMED (callers already exclude superseded/stale rows);
18
+ * - it cites at least one source file;
19
+ * - its stored basis is non-empty (null/empty/unparseable basis never matches);
20
+ * - every cited source file has a key in the basis;
21
+ * - every cited and basis path is repo-relative (isRepoRelativePath);
22
+ * - every basis hash equals that file's current hash (a missing file -- a
23
+ * null/absent current hash -- is a mismatch).
24
+ * Same comparison semantics as SqliteProvider.basisFullyMatches, plus the
25
+ * source_files coverage check.
26
+ */
27
+ export function qualifiesForProjectBible(entry, basis, currentHashes) {
28
+ if (entry.confidence !== 'CONFIRMED')
29
+ return false;
30
+ if (!Array.isArray(entry.source_files) || entry.source_files.length === 0)
31
+ return false;
32
+ if (!basis || typeof basis !== 'object')
33
+ return false;
34
+ const basisFiles = Object.keys(basis);
35
+ if (basisFiles.length === 0)
36
+ return false;
37
+ for (const file of entry.source_files) {
38
+ if (!isRepoRelativePath(file))
39
+ return false;
40
+ if (!Object.prototype.hasOwnProperty.call(basis, file))
41
+ return false;
42
+ }
43
+ for (const file of basisFiles) {
44
+ if (!isRepoRelativePath(file))
45
+ return false;
46
+ const current = currentHashes[file];
47
+ if (!current || typeof basis[file] !== 'string' || current.hash !== basis[file])
48
+ return false;
49
+ }
50
+ return true;
51
+ }
52
+ /**
53
+ * Hash every basis file once (one batch, content at repoPath's HEAD commit)
54
+ * and return the entries that pass qualifiesForProjectBible, preserving input
55
+ * order. Throws KbHeadHashError when repoPath is not inside a git work tree.
56
+ */
57
+ export async function filterProjectBibleCandidates(entries, basisById, repoPath) {
58
+ const fileSet = new Set();
59
+ for (const e of entries) {
60
+ const basis = basisById.get(e.id);
61
+ if (basis)
62
+ for (const f of Object.keys(basis))
63
+ if (isRepoRelativePath(f))
64
+ fileSet.add(f);
65
+ }
66
+ if (entries.length === 0)
67
+ return [];
68
+ const currentHashes = await computeHeadFileHashBatch([...fileSet], { cwd: repoPath });
69
+ return entries.filter(e => qualifiesForProjectBible(e, basisById.get(e.id), currentHashes));
70
+ }
71
+ /** True when a bible entry carries a non-empty source_file_hashes map. */
72
+ export function hasCarriedBasis(entry) {
73
+ const h = entry.source_file_hashes;
74
+ return !!h && typeof h === 'object' && !Array.isArray(h) && Object.keys(h).length > 0;
75
+ }
76
+ function sameFileSet(a, b) {
77
+ if (!Array.isArray(a) || !Array.isArray(b))
78
+ return false;
79
+ const sa = new Set(a);
80
+ const sb = new Set(b);
81
+ if (sa.size !== sb.size)
82
+ return false;
83
+ for (const f of sa)
84
+ if (!sb.has(f))
85
+ return false;
86
+ return true;
87
+ }
88
+ // Legacy-bible backfill (kb_bible_commit).
89
+ //
90
+ // A bible entry written before format v3 carries no source_file_hashes, so a
91
+ // clone importing it can only give it a local freshness-only basis and it is
92
+ // never re-published. When the bible writer's own KB holds the SAME id with a
93
+ // stored, verified basis, that basis can be attached to the bible entry. The
94
+ // rule is the admission predicate itself (qualifiesForProjectBible, cited files
95
+ // read at HEAD): nothing is re-hashed into the basis and no second rule is
96
+ // invented. One extra guard: the KB entry must cite exactly the bible entry's
97
+ // source_files, so the attached basis describes the files the bible entry
98
+ // cites and nothing else. A local freshness-only basis (from kb_import) reads
99
+ // as no basis (SqliteProvider.getSourceFileBases), so it never backfills.
100
+ /**
101
+ * The bible entries that gain a basis: for each entry in `bibleEntries` with
102
+ * no carried source_file_hashes whose id is in `kbEntries` (the writer KB's
103
+ * live entries) with the same source_files set and a stored basis passing
104
+ * qualifiesForProjectBible at repoPath's HEAD, the id mapped to that stored
105
+ * basis. Entries that do not qualify are simply absent from the result (the
106
+ * caller keeps them unchanged; nothing is ever dropped). Hashes the candidate
107
+ * basis files once; with no candidate nothing is hashed (so no git check).
108
+ * Throws KbHeadHashError when there are candidates and repoPath is not inside
109
+ * a git work tree.
110
+ */
111
+ export async function selectLegacyBibleBackfill(bibleEntries, kbEntries, basisById, repoPath) {
112
+ const kbById = new Map();
113
+ for (const e of kbEntries)
114
+ kbById.set(e.id, e);
115
+ const candidates = [];
116
+ for (const b of bibleEntries) {
117
+ if (hasCarriedBasis(b))
118
+ continue;
119
+ const kb = kbById.get(b.id);
120
+ if (!kb || !basisById.get(b.id))
121
+ continue;
122
+ if (!sameFileSet(kb.source_files, b.source_files))
123
+ continue;
124
+ candidates.push({ id: b.id, confidence: kb.confidence, source_files: b.source_files });
125
+ }
126
+ const out = new Map();
127
+ if (candidates.length === 0)
128
+ return out;
129
+ const passing = await filterProjectBibleCandidates(candidates, basisById, repoPath);
130
+ for (const c of passing)
131
+ out.set(c.id, basisById.get(c.id));
132
+ return out;
133
+ }
134
+ //# sourceMappingURL=bible-basis-filter.js.map