@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
@@ -0,0 +1,358 @@
1
+ // kb (self) resolution: which repo a kb_* tool call is about.
2
+ //
3
+ // No kb_* tool takes a scope parameter. The KB a call reads/writes is derived
4
+ // from WHO is calling:
5
+ //
6
+ // MEMBER session (?member=<uuid> or a member JWT) -- the member's registered
7
+ // work folder (getSessionMemberId() from the tool-scope lane).
8
+ // FULL session (no member identity) -- the MCP client's roots (roots/list,
9
+ // cached per session by src/services/session-roots.ts): the first offered
10
+ // root that is a git repository with an origin remote wins. The server's
11
+ // own working folder is used only when the client offers no roots.
12
+ //
13
+ // An HTTP server cannot see a client's cwd, so a FULL session whose client
14
+ // offers no roots gets the server's folder.
15
+ //
16
+ // KB identity comes from the resolved folder's origin remote, so a folder that
17
+ // is missing, is not a git repository, or has no origin remote is refused with
18
+ // a typed error carrying one line of remediation -- never silently mapped to a
19
+ // directory-name or 'default' KB.
20
+ //
21
+ // In-process callers that already know exactly which repo they mean (the
22
+ // execute_prompt post-dispatch harvest, the `kb commit` CLI) pass an explicit
23
+ // KbAnchor as the handler's second argument. That argument is not part of any
24
+ // tool's input schema, so no MCP client can supply it.
25
+ import fs from 'node:fs';
26
+ import path from 'node:path';
27
+ import { execFileSync } from 'node:child_process';
28
+ import { getSelfMemoSlot, getSessionMemberId, getSessionRoots } from '../tool-scope.js';
29
+ import { getAgent } from '../registry.js';
30
+ import { knownRepoRemoteUrl } from '../member-remote-url.js';
31
+ import { getKbProviders, getGlobalKbProvider, getProjectSlug, kbConfigSelectsHttp } from './kb-providers.js';
32
+ import { getMemberBibleView } from './member-bible-view.js';
33
+ import { isSqliteProject, requireSqliteProject } from './require-sqlite-project.js';
34
+ import { HttpKbProvider } from './http-provider.js';
35
+ import { gitExecutable } from '../../os/git-executable.js';
36
+ export class KbSelfError extends Error {
37
+ code;
38
+ folder;
39
+ remediation;
40
+ constructor(code, folder, problem, remediation) {
41
+ super(`${code}: ${problem} Remediation: ${remediation}`);
42
+ this.name = 'KbSelfError';
43
+ this.code = code;
44
+ this.folder = folder;
45
+ this.remediation = remediation;
46
+ }
47
+ }
48
+ function whose(memberLabel) {
49
+ return memberLabel ? `member '${memberLabel}' work folder` : 'server working folder';
50
+ }
51
+ // A FULL session (no member identity) resolves from the MCP client's roots
52
+ // when the client offers any (see resolveSelfSession), else from the fleet
53
+ // SERVER's working folder -- never the client's cwd, which an HTTP server
54
+ // cannot see. A caller hitting a self error on the server-folder path usually
55
+ // expected its own directory, so the error names that cause (including
56
+ // whether the client offered roots) and every fix explicitly.
57
+ function fullSessionCause() {
58
+ return "This is a FULL session (no member identity) and the client offered no MCP roots, so its scope is the fleet server's own working folder, not the calling client's directory";
59
+ }
60
+ const FULL_SESSION_FIX = "Open the client in the repository (a client that offers MCP roots is scoped to its first root inside a git repository with an origin remote), restart the fleet server with its working folder set to that repository, or call from a member session (?member=<id>) of a member registered on it.";
61
+ function listForError(items) {
62
+ const shown = items.slice(0, 5).map(i => `'${i}'`).join(', ');
63
+ return items.length > 5 ? `${shown}, and ${items.length - 5} more` : shown;
64
+ }
65
+ function noWorkFolder(folder, memberLabel) {
66
+ return new KbSelfError('E-SELF-NO-WORKFOLDER', folder, `The ${whose(memberLabel)} ${folder ? `'${folder}' does not exist or is not a directory.` : 'is not set.'}`, memberLabel
67
+ ? 'Create the folder or re-register the member with an existing work folder (register_member / update_member).'
68
+ : FULL_SESSION_FIX);
69
+ }
70
+ function gitOut(folder, args, opts = {}) {
71
+ // Same ceiling as resolveProjectSlug: the folder itself must be the repo, so a
72
+ // temp folder that merely sits inside some other checkout is not mistaken
73
+ // for that checkout.
74
+ const env = opts.ceiling === false ? process.env : { ...process.env, GIT_CEILING_DIRECTORIES: path.dirname(folder) };
75
+ try {
76
+ return execFileSync(gitExecutable(), args, {
77
+ cwd: folder, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
78
+ }).trim();
79
+ }
80
+ catch {
81
+ return null;
82
+ }
83
+ }
84
+ /**
85
+ * Validate a local folder as a (self) repo: it exists and is a git repository.
86
+ * Shared by kb (self) and code (self) resolution -- code tools need no origin
87
+ * remote (an index is keyed by folder, not by KB identity), kb tools add the
88
+ * remote check on top (validateSelfFolder).
89
+ */
90
+ export function validateSelfRepoFolder(folder, memberLabel) {
91
+ let isDir = false;
92
+ try {
93
+ isDir = !!folder && fs.statSync(folder).isDirectory();
94
+ }
95
+ catch {
96
+ isDir = false;
97
+ }
98
+ if (!isDir)
99
+ throw noWorkFolder(folder, memberLabel);
100
+ if (gitOut(folder, ['rev-parse', '--git-dir']) === null) {
101
+ throw new KbSelfError('E-SELF-NOT-A-REPO', folder, memberLabel
102
+ ? `The ${whose(memberLabel)} '${folder}' is not a git repository.`
103
+ : `${fullSessionCause()}; '${folder}' is not a git repository.`, memberLabel
104
+ ? `Run 'git init' (or clone the project) in '${folder}' and add an origin remote.`
105
+ : `${FULL_SESSION_FIX} Or make '${folder}' itself a git repository with an origin remote.`);
106
+ }
107
+ }
108
+ /** Validate a local folder as a KB anchor: exists, is a git repo, has an origin remote. */
109
+ export function validateSelfFolder(folder, memberLabel) {
110
+ validateSelfRepoFolder(folder, memberLabel);
111
+ const remote = gitOut(folder, ['remote', 'get-url', 'origin']);
112
+ if (!remote) {
113
+ throw new KbSelfError('E-SELF-NO-REMOTE', folder, memberLabel
114
+ ? `The ${whose(memberLabel)} '${folder}' has no origin remote, so it has no KB identity.`
115
+ : `${fullSessionCause()}; '${folder}' has no origin remote, so it has no KB identity.`, memberLabel
116
+ ? `Run 'git remote add origin <url>' in '${folder}'.`
117
+ : `${FULL_SESSION_FIX} Or run 'git remote add origin <url>' in '${folder}'.`);
118
+ }
119
+ return { folder };
120
+ }
121
+ function hasOriginRemote(folder) {
122
+ return !!gitOut(folder, ['remote', 'get-url', 'origin']);
123
+ }
124
+ /**
125
+ * The top level of the git repository a client root sits in, or null when it
126
+ * is in none. Unlike a member's registered work folder, a root is wherever the
127
+ * client was opened, often a subfolder, so there is no ceiling here. A root
128
+ * that already is the top level keeps its spelling (git answers with resolved
129
+ * symlinks, short names expanded and forward slashes), so it names the same
130
+ * index and KB folder as before.
131
+ */
132
+ function rootRepoTopLevel(root) {
133
+ const top = gitOut(root, ['rev-parse', '--show-toplevel'], { ceiling: false });
134
+ if (!top)
135
+ return null;
136
+ try {
137
+ if (fs.realpathSync.native(root) === fs.realpathSync.native(top))
138
+ return root;
139
+ }
140
+ catch { /* fall through to git's answer */ }
141
+ return path.resolve(top);
142
+ }
143
+ /**
144
+ * FULL session (self) selection (owner decision: client roots first, server
145
+ * working folder only when the client offers no roots). A root inside a git
146
+ * repository stands for that repository's top level, so a client opened in a
147
+ * subfolder scopes to the repository:
148
+ *
149
+ * 1. The first offered root in a git repository with an origin remote.
150
+ * 2. Extension for code_* only: when roots are offered and none has an
151
+ * origin, the first offered root in a git repository
152
+ * (rootWithoutOrigin: kb_* refuses it).
153
+ * 3. No roots offered (no roots capability or an empty list): the server
154
+ * working folder.
155
+ *
156
+ * Everything else is refused, never answered from the server folder: it may be
157
+ * an unrelated repository, and the caller could not tell.
158
+ * - Asking the client failed: E-SELF-NO-WORKFOLDER naming the failure; the
159
+ * next call asks again.
160
+ * - No offered root is a folder on this host (a remote client's path, a
161
+ * deleted folder, a non-file URI): E-SELF-NO-WORKFOLDER.
162
+ * - Roots on this host but none in a git repository: E-SELF-NOT-A-REPO.
163
+ */
164
+ function selectFullSessionFolder() {
165
+ const roots = getSessionRoots();
166
+ if (roots?.fetchError !== undefined) {
167
+ throw new KbSelfError('E-SELF-NO-WORKFOLDER', '', `This is a FULL session (no member identity) and asking the client for its MCP roots failed (${roots.fetchError}), so the session's scope is unknown; the call was not run and the server's working folder was not used in its place.`, 'Retry the same call: each call asks the client again. If it keeps failing, restart the client or check that it answers roots/list.');
168
+ }
169
+ if (!roots || roots.offered.length === 0) {
170
+ return { folder: process.cwd(), source: 'cwd', ...(roots ? { roots } : {}) };
171
+ }
172
+ if (roots.folders.length === 0) {
173
+ throw new KbSelfError('E-SELF-NO-WORKFOLDER', roots.offered[0], `This is a FULL session (no member identity) and the client offered MCP roots, but none of them (${listForError(roots.offered)}) is a folder on this host, so the session has no KB or code scope; the server's working folder was not used in its place.`, 'Open the client on this host in a git repository with an origin remote, or call from a member session (?member=<id>) of a member registered on that folder.');
174
+ }
175
+ let firstRepo;
176
+ for (const root of roots.folders) {
177
+ const folder = rootRepoTopLevel(root);
178
+ if (folder === null)
179
+ continue;
180
+ if (hasOriginRemote(folder))
181
+ return { folder, source: 'root', roots };
182
+ if (firstRepo === undefined)
183
+ firstRepo = folder;
184
+ }
185
+ if (firstRepo !== undefined)
186
+ return { folder: firstRepo, source: 'root', rootWithoutOrigin: true, roots };
187
+ throw new KbSelfError('E-SELF-NOT-A-REPO', roots.folders[0], `This is a FULL session (no member identity) and the client offered MCP roots, but none of them (${listForError(roots.folders)}) is in a git repository, so the session has no KB or code scope.`, `Open the client in a git repository with an origin remote (or add one as a root), or run 'git init' and 'git remote add origin <url>' in '${roots.folders[0]}'.`);
188
+ }
189
+ /**
190
+ * Resolve WHICH folder the calling session means by (self): a MEMBER session's
191
+ * registered work folder; a FULL session's selected client root, else the
192
+ * server working folder (selectFullSessionFolder). A MEMBER session whose
193
+ * member is unregistered or has no work folder is refused with
194
+ * E-SELF-NO-WORKFOLDER -- it never falls back to the server folder, and never
195
+ * reads client roots.
196
+ *
197
+ * Inside a tool call the FULL selection is memoized for the rest of that call,
198
+ * so kb (self) and code (self) share one answer and cannot diverge.
199
+ */
200
+ export function resolveSelfSession() {
201
+ const memberId = getSessionMemberId();
202
+ if (memberId === undefined) {
203
+ const memo = getSelfMemoSlot();
204
+ if (!memo)
205
+ return selectFullSessionFolder();
206
+ if (memo.error !== undefined)
207
+ throw memo.error;
208
+ if (memo.value !== undefined)
209
+ return memo.value;
210
+ try {
211
+ memo.value = selectFullSessionFolder();
212
+ return memo.value;
213
+ }
214
+ catch (e) {
215
+ memo.error = e;
216
+ throw e;
217
+ }
218
+ }
219
+ const agent = getAgent(memberId);
220
+ const label = agent?.friendlyName ?? memberId;
221
+ const folder = agent?.workFolder ?? '';
222
+ if (!agent || !folder)
223
+ throw noWorkFolder(folder, label);
224
+ return { memberId, memberLabel: label, folder, agent };
225
+ }
226
+ /**
227
+ * Resolve the calling session's own KB anchor (see header). Throws KbSelfError
228
+ * when the resolved folder cannot carry a KB identity.
229
+ */
230
+ export function resolveSelfAnchor() {
231
+ const self = resolveSelfSession();
232
+ const { agent, folder, memberLabel: label, memberId } = self;
233
+ if (!agent) {
234
+ if (self.rootWithoutOrigin) {
235
+ throw new KbSelfError('E-SELF-NO-REMOTE', folder, `This is a FULL session (no member identity) and none of the client's MCP roots (${listForError(self.roots?.folders ?? [folder])}) is in a git repository with an origin remote, so the session has no KB identity (code tools use the first offered git repository, '${folder}').`, `Run 'git remote add origin <url>' in '${folder}', or open the client in a repository that has an origin remote.`);
236
+ }
237
+ return validateSelfFolder(folder);
238
+ }
239
+ if (agent.agentType !== 'local') {
240
+ // The work folder lives on another host: git cannot be shelled out there,
241
+ // so the KB identity is the member's single known origin remote.
242
+ const remoteUrl = knownRepoRemoteUrl(agent);
243
+ if (!remoteUrl) {
244
+ throw new KbSelfError('E-SELF-NO-REMOTE', folder, `Member '${label}' work folder '${folder}' is on another host and the member has no single known origin remote, so it has no KB identity.`, `Record the repo's origin URL on the member (update_member git_repos: ["<origin url>"]) or call kb tools from a session on the member's own host.`);
245
+ }
246
+ return { folder, remoteUrl, memberId };
247
+ }
248
+ return validateSelfFolder(folder, label);
249
+ }
250
+ /** The anchor a kb_* handler uses: the explicit in-process anchor, else (self). */
251
+ export function resolveKbAnchor(anchor) {
252
+ return anchor ?? resolveSelfAnchor();
253
+ }
254
+ /** KB providers for a kb_* handler call. */
255
+ export async function getSelfKbProviders(anchor) {
256
+ const resolved = resolveKbAnchor(anchor);
257
+ return getKbProviders(resolved.folder, resolved.remoteUrl);
258
+ }
259
+ /**
260
+ * The own-scope tag of the calling MEMBER session, 'member:<uuid>', or
261
+ * undefined for a FULL session or an in-process caller passing an explicit
262
+ * KbAnchor (same predicate getSelfReadKb uses to pick the bible view).
263
+ * MEMBER captures carry this tag, and MEMBER INFERRED/UNVERIFIED reads,
264
+ * kb_promote and kb_invalidate act only on entries carrying it.
265
+ */
266
+ export function memberOwnerTag(anchor) {
267
+ if (anchor !== undefined)
268
+ return undefined;
269
+ const memberId = getSessionMemberId();
270
+ return memberId === undefined ? undefined : `member:${memberId}`;
271
+ }
272
+ export async function getSelfReadKb(anchor, confidence, opts = {}) {
273
+ const resolved = resolveKbAnchor(anchor);
274
+ const isMemberSelf = anchor === undefined && getSessionMemberId() !== undefined;
275
+ const namesUnconfirmedTier = (confidence ?? []).some(c => c !== 'CONFIRMED');
276
+ // Decided from the config, so the default (SQLite) path opens no store here.
277
+ if (isMemberSelf && kbConfigSelectsHttp()) {
278
+ const providers = await getKbProviders(resolved.folder, resolved.remoteUrl);
279
+ if (!isSqliteProject(providers.project)) {
280
+ const ownerTag = namesUnconfirmedTier || opts.ownScope ? memberOwnerTag(anchor) : undefined;
281
+ return { providers, anchor: resolved, memberView: false, ...(ownerTag !== undefined ? { ownerTag } : {}) };
282
+ }
283
+ }
284
+ if (isMemberSelf && !namesUnconfirmedTier && !opts.ownScope) {
285
+ const [project, global] = await Promise.all([getMemberBibleView(resolved), getGlobalKbProvider()]);
286
+ return {
287
+ providers: { project, global, projectSlug: getProjectSlug(resolved.folder, resolved.remoteUrl) },
288
+ anchor: resolved,
289
+ memberView: true,
290
+ };
291
+ }
292
+ const ownerTag = memberOwnerTag(anchor);
293
+ return {
294
+ providers: await getKbProviders(resolved.folder, resolved.remoteUrl),
295
+ anchor: resolved,
296
+ memberView: false,
297
+ ...(ownerTag !== undefined ? { ownerTag } : {}),
298
+ };
299
+ }
300
+ /**
301
+ * The shared split read for a MEMBER session whose explicit tier list names
302
+ * CONFIRMED together with at least one other tier. Returns null for every other
303
+ * request, which then keeps its existing path through getSelfReadKb: a FULL
304
+ * session, an explicit-KbAnchor caller, a CONFIRMED-only (or omitted) tier list
305
+ * (bible view), and a list naming only non-CONFIRMED tiers (own captures only).
306
+ *
307
+ * Callers query each half with its own tiers and owner tag, then merge with
308
+ * mergeSplitById (bible copy wins) and apply their limit after the merge.
309
+ *
310
+ * HTTP per-repo provider: the own half is the KB server, owner-tagged (the
311
+ * http provider re-checks the tag on every entry it returns), and the
312
+ * CONFIRMED half is the KB server too, with no owner tag, so the mixed read is
313
+ * a superset of the CONFIRMED-only read, which the server also answers. Any other non-sqlite provider is refused with requireSqliteProject's
314
+ * error naming `callerLabel`: answering with the bible half alone would
315
+ * silently drop tiers the caller asked for.
316
+ */
317
+ export async function getMemberSplitRead(anchor, confidence, callerLabel) {
318
+ if (anchor !== undefined || getSessionMemberId() === undefined)
319
+ return null;
320
+ const tiers = [...new Set(confidence ?? [])];
321
+ if (!tiers.includes('CONFIRMED') || tiers.every(t => t === 'CONFIRMED'))
322
+ return null;
323
+ const ownerTag = memberOwnerTag(anchor);
324
+ if (ownerTag === undefined)
325
+ return null;
326
+ const resolved = resolveKbAnchor(anchor);
327
+ const repo = await getKbProviders(resolved.folder, resolved.remoteUrl);
328
+ const ownProject = repo.project instanceof HttpKbProvider
329
+ ? repo.project
330
+ : requireSqliteProject(repo.project, callerLabel);
331
+ // Under http the server answers the CONFIRMED half as well: the bible is
332
+ // never loaded (on a remote member that load would also be an SSH round trip).
333
+ const confirmedProject = ownProject instanceof HttpKbProvider
334
+ ? Promise.resolve(ownProject)
335
+ : getMemberBibleView(resolved);
336
+ const [bibleProject, global] = await Promise.all([confirmedProject, getGlobalKbProvider()]);
337
+ return {
338
+ anchor: resolved,
339
+ projectSlug: repo.projectSlug,
340
+ bible: { project: bibleProject, global, tiers: ['CONFIRMED'] },
341
+ own: { project: ownProject, global: repo.global, tiers, ownerTag },
342
+ };
343
+ }
344
+ /**
345
+ * Merge the two halves of a split read: every `bible` row, then each `own` row
346
+ * whose id the bible half did not already return (the bible copy wins). An
347
+ * optional `order` re-sorts the merged list; `limit` is applied last.
348
+ */
349
+ export function mergeSplitById(bible, own, opts = {}) {
350
+ const seen = new Set(bible.map(e => e.id));
351
+ let merged = [...bible, ...own.filter(e => !seen.has(e.id))];
352
+ if (opts.order)
353
+ merged = merged.sort(opts.order);
354
+ return opts.limit !== undefined ? merged.slice(0, opts.limit) : merged;
355
+ }
356
+ /** Appended to every kb_* tool description so callers know there is no scope argument. */
357
+ export const KB_SELF_NOTE = ' Scope: always the calling session\'s own KB -- a member session uses its registered work folder; any other session uses the first MCP client root (roots/list) inside a git repository with an origin remote, as that repository\'s top level, or the fleet server\'s working folder when the client offers no roots; there is no repo/path scope argument (the removed repo_path, repo and repo_remote_url keys fail with E-SCOPE-KEY-REMOVED). Fails with E-SELF-NO-WORKFOLDER, E-SELF-NOT-A-REPO or E-SELF-NO-REMOTE (each with a one-line remediation) when that folder cannot carry a KB identity (it must be a git repository with an origin remote).';
358
+ //# sourceMappingURL=kb-self.js.map
@@ -0,0 +1,21 @@
1
+ import { SqliteProvider } from './sqlite-provider.js';
2
+ import type { KbAnchor } from './kb-self.js';
3
+ export type KbMemberViewErrorCode = 'E-MEMBER-VIEW-REMOTE' | 'E-MEMBER-VIEW-READ-ONLY';
4
+ export declare class KbMemberViewError extends Error {
5
+ readonly code: KbMemberViewErrorCode;
6
+ readonly folder: string;
7
+ readonly remediation: string;
8
+ constructor(code: KbMemberViewErrorCode, folder: string, problem: string, remediation: string);
9
+ }
10
+ /** The bible file a member view is built from. */
11
+ export declare function memberBiblePath(folder: string): string;
12
+ /**
13
+ * The in-memory view of the anchor's checkout bible. Rebuilt when the file's
14
+ * mtime or size changed since the last load; otherwise the cached view.
15
+ */
16
+ export declare function getMemberBibleView(anchor: KbAnchor): Promise<SqliteProvider>;
17
+ /** Number of times the view for this bible path has been (re)built. For tests. */
18
+ export declare function memberBibleViewLoadCount(biblePath: string): number;
19
+ /** Drop every cached view (what a server restart does). */
20
+ export declare function resetMemberBibleViews(): void;
21
+ //# sourceMappingURL=member-bible-view.d.ts.map
@@ -0,0 +1,207 @@
1
+ // Member bible view: MEMBER-session KB reads come from an in-memory SQLite view
2
+ // of the member's own checkout bible, (self)/.fleet/kb-canonical.json.
3
+ //
4
+ // Why a view and not the per-repo DB: several members of ONE repository share
5
+ // one per-repo kb.sqlite (KB identity is the origin remote), but their
6
+ // checkouts can sit on different branches whose bibles differ. Each member
7
+ // must see the CONFIRMED set its own checkout carries.
8
+ //
9
+ // How:
10
+ // - The bible is loaded into a SqliteProvider over DatabaseSync(':memory:')
11
+ // -- the SAME provider class the per-repo DB uses, so ranking, prime() and
12
+ // relatedClaims() behave identically. Entries go through the shared
13
+ // bible-import loader (import mode: bible confidence preserved, directives
14
+ // quarantined as pending proposals, basis check), but VERBATIM: no AUDN
15
+ // dedupe/update/contradiction against sibling entries, so every entry keeps
16
+ // its bible id and confidence and none is flagged by another. The bible is
17
+ // already reviewed; the view reproduces it, it does not re-curate it.
18
+ // - One view per bible file path, so members on different branches (different
19
+ // checkouts, different paths) get different views.
20
+ // - Each read does ONE fs.stat. When mtimeMs or size differs from the values
21
+ // recorded at the last load, the view is rebuilt. The file is never hashed.
22
+ // - The cache is process memory only: a server restart starts empty and the
23
+ // first read rebuilds. No file, table or column is added anywhere.
24
+ // - A missing bible is an empty view. A malformed bible throws KbBibleError
25
+ // (E-BIBLE-MALFORMED) every time it is read; it is never cached as empty.
26
+ // - An anchor whose folder is on another host (remoteUrl + memberId set) is
27
+ // served the same way: one cheap stat command over the member transport
28
+ // (mtime + size), and the bible text is fetched only when that changed.
29
+ // Cached per (member, folder). If the member cannot be reached the read
30
+ // fails loudly (E-MEMBER-VIEW-REMOTE); it never falls back to the per-repo DB.
31
+ import fs from 'node:fs';
32
+ import path from 'node:path';
33
+ import { SqliteProvider } from './sqlite-provider.js';
34
+ import { readBibleDocument, parseBibleDocument, excludeTombstonedEntries, importBibleEntries, } from './bible-import.js';
35
+ import { getAgent } from '../registry.js';
36
+ import { getStrategy } from '../strategy.js';
37
+ import { getAgentOS, getAgentShell, isPosixShell } from '../../utils/agent-helpers.js';
38
+ import { wrapPowerShellEncoded } from '../../os/windows.js';
39
+ export class KbMemberViewError extends Error {
40
+ code;
41
+ folder;
42
+ remediation;
43
+ constructor(code, folder, problem, remediation) {
44
+ super(`${code}: ${problem} Remediation: ${remediation}`);
45
+ this.name = 'KbMemberViewError';
46
+ this.code = code;
47
+ this.folder = folder;
48
+ this.remediation = remediation;
49
+ }
50
+ }
51
+ /** The bible file a member view is built from. */
52
+ export function memberBiblePath(folder) {
53
+ return path.join(folder, '.fleet', 'kb-canonical.json');
54
+ }
55
+ const _views = new Map();
56
+ const _loadCounts = new Map();
57
+ function statOrMissing(biblePath) {
58
+ try {
59
+ const st = fs.statSync(biblePath);
60
+ return { mtimeMs: st.mtimeMs, size: st.size };
61
+ }
62
+ catch (err) {
63
+ if (err.code === 'ENOENT')
64
+ return { mtimeMs: -1, size: -1 };
65
+ throw err;
66
+ }
67
+ }
68
+ async function buildView(biblePath, repoRoot, missing) {
69
+ _loadCounts.set(biblePath, (_loadCounts.get(biblePath) ?? 0) + 1);
70
+ // Parse BEFORE opening the database, so a malformed bible costs nothing.
71
+ // DOCUMENT reader: the view must honour the bible's demotion tombstones, and
72
+ // the only way it can is by not listing the tombstoned entry. The provider
73
+ // below starts EMPTY, so there is no local row for a tombstone to demote --
74
+ // the import-side demotion branch is the wrong tool here and is deliberately
75
+ // not used.
76
+ const doc = missing
77
+ ? { entries: [], demotions: [] }
78
+ : readBibleDocument(biblePath, 'member bible view');
79
+ const entries = excludeTombstonedEntries(doc.entries, doc.demotions);
80
+ // repoRoot anchors relative source_files exactly as the per-repo provider
81
+ // does, so the capture basis check and prime()'s freshness check judge the
82
+ // bible against the member's own checkout.
83
+ const provider = new SqliteProvider(':memory:', repoRoot);
84
+ await provider.init();
85
+ if (entries.length > 0)
86
+ await importBibleEntries(provider, entries, { verbatim: true });
87
+ return provider;
88
+ }
89
+ function remoteFail(folder, problem) {
90
+ return new KbMemberViewError('E-MEMBER-VIEW-REMOTE', folder, problem, 'Check the member is reachable (member_detail / update_member), then retry; the member must have its checkout bible at <work folder>/.fleet/kb-canonical.json.');
91
+ }
92
+ function remoteBiblePath(agent, folder) {
93
+ const win = getAgentOS(agent) === 'windows' && !isPosixShell('windows', getAgentShell(agent));
94
+ return win ? `${folder.replace(/[\\/]+$/, '')}\\.fleet\\kb-canonical.json` : `${folder.replace(/\/+$/, '')}/.fleet/kb-canonical.json`;
95
+ }
96
+ const REMOTE_TIMEOUT_MS = 20_000;
97
+ /** Command that prints "<mtime> <size>" for the bible, or MISSING. */
98
+ function statCommand(agent, p) {
99
+ if (getAgentOS(agent) === 'windows' && !isPosixShell('windows', getAgentShell(agent))) {
100
+ const q = p.replace(/'/g, "''");
101
+ return wrapPowerShellEncoded(`if (Test-Path -LiteralPath '${q}') { $i = Get-Item -LiteralPath '${q}'; [Console]::Out.Write("$($i.LastWriteTimeUtc.Ticks) $($i.Length)") } else { [Console]::Out.Write('MISSING') }`);
102
+ }
103
+ const q = `'${p.replace(/'/g, `'\\''`)}'`;
104
+ return `if [ -f ${q} ]; then (stat -c '%Y %s' ${q} 2>/dev/null || stat -f '%m %z' ${q}); else printf MISSING; fi`;
105
+ }
106
+ function catCommand(agent, p) {
107
+ if (getAgentOS(agent) === 'windows' && !isPosixShell('windows', getAgentShell(agent))) {
108
+ const q = p.replace(/'/g, "''");
109
+ return wrapPowerShellEncoded(`[Console]::Out.Write([System.IO.File]::ReadAllText('${q}'))`);
110
+ }
111
+ return `cat '${p.replace(/'/g, `'\\''`)}'`;
112
+ }
113
+ async function getRemoteMemberBibleView(anchor) {
114
+ const agent = anchor.memberId ? getAgent(anchor.memberId) : undefined;
115
+ if (!agent) {
116
+ throw remoteFail(anchor.folder, `The member for work folder '${anchor.folder}' is not registered, so its checkout bible cannot be fetched.`);
117
+ }
118
+ const strategy = getStrategy(agent);
119
+ const biblePath = remoteBiblePath(agent, anchor.folder);
120
+ const key = `remote:${agent.id}:${biblePath}`;
121
+ const run = async (cmd) => {
122
+ let r;
123
+ try {
124
+ r = await strategy.execCommand(cmd, REMOTE_TIMEOUT_MS);
125
+ }
126
+ catch (err) {
127
+ throw remoteFail(anchor.folder, `Could not reach member '${agent.friendlyName}' to read its checkout bible: ${err instanceof Error ? err.message : String(err)}.`);
128
+ }
129
+ if (r.code !== 0) {
130
+ throw remoteFail(anchor.folder, `Reading the bible on member '${agent.friendlyName}' failed (exit ${r.code}): ${r.stderr.trim()}.`);
131
+ }
132
+ return r.stdout;
133
+ };
134
+ const statOut = (await run(statCommand(agent, biblePath))).split(/\r?\n/).map(l => l.trim()).filter(Boolean).pop() ?? '';
135
+ let mtimeMs = -1;
136
+ let size = -1;
137
+ if (statOut !== 'MISSING') {
138
+ const m = /^(\d+) (\d+)$/.exec(statOut);
139
+ if (!m)
140
+ throw remoteFail(anchor.folder, `Unexpected stat output from member '${agent.friendlyName}': '${statOut.slice(0, 80)}'.`);
141
+ mtimeMs = Number(m[1]);
142
+ size = Number(m[2]);
143
+ }
144
+ const current = _views.get(key);
145
+ if (current && current.mtimeMs === mtimeMs && current.size === size)
146
+ return current.provider;
147
+ const build = async () => {
148
+ _loadCounts.set(key, (_loadCounts.get(key) ?? 0) + 1);
149
+ // Same tombstone rule as the local path above -- a demotion must not be
150
+ // visible on one transport and invisible on the other.
151
+ const remoteDoc = mtimeMs === -1
152
+ ? { entries: [], demotions: [] }
153
+ : parseBibleDocument(await run(catCommand(agent, biblePath)), biblePath, 'member bible view');
154
+ const entries = excludeTombstonedEntries(remoteDoc.entries, remoteDoc.demotions);
155
+ // The member's checkout is on another host: nothing here can verify its
156
+ // source files, so import unanchored, then bind the remote folder so
157
+ // freshness issues no verdict (see SqliteProvider.bindRepoPath).
158
+ const provider = new SqliteProvider(':memory:');
159
+ await provider.init();
160
+ if (entries.length > 0)
161
+ await importBibleEntries(provider, entries, { verbatim: true });
162
+ provider.bindRepoPath(anchor.folder);
163
+ return provider;
164
+ };
165
+ const slot = { mtimeMs, size, provider: build() };
166
+ _views.set(key, slot);
167
+ slot.provider.catch(() => {
168
+ if (_views.get(key) === slot)
169
+ _views.delete(key);
170
+ });
171
+ return slot.provider;
172
+ }
173
+ /**
174
+ * The in-memory view of the anchor's checkout bible. Rebuilt when the file's
175
+ * mtime or size changed since the last load; otherwise the cached view.
176
+ */
177
+ export async function getMemberBibleView(anchor) {
178
+ if (anchor.remoteUrl !== undefined)
179
+ return getRemoteMemberBibleView(anchor);
180
+ const biblePath = memberBiblePath(anchor.folder);
181
+ const { mtimeMs, size } = statOrMissing(biblePath);
182
+ const current = _views.get(biblePath);
183
+ if (current && current.mtimeMs === mtimeMs && current.size === size) {
184
+ return current.provider;
185
+ }
186
+ // The replaced view is not closed: a concurrent reader may still hold it
187
+ // mid-call. Dropping the reference lets it be collected.
188
+ const slot = { mtimeMs, size, provider: buildView(biblePath, anchor.folder, mtimeMs === -1) };
189
+ _views.set(biblePath, slot);
190
+ // Never cache a failed build (a malformed bible must fail on every read, and
191
+ // a fixed bible must load without a restart).
192
+ slot.provider.catch(() => {
193
+ if (_views.get(biblePath) === slot)
194
+ _views.delete(biblePath);
195
+ });
196
+ return slot.provider;
197
+ }
198
+ /** Number of times the view for this bible path has been (re)built. For tests. */
199
+ export function memberBibleViewLoadCount(biblePath) {
200
+ return _loadCounts.get(biblePath) ?? 0;
201
+ }
202
+ /** Drop every cached view (what a server restart does). */
203
+ export function resetMemberBibleViews() {
204
+ _views.clear();
205
+ _loadCounts.clear();
206
+ }
207
+ //# sourceMappingURL=member-bible-view.js.map
@@ -1,2 +1,9 @@
1
+ /**
2
+ * True when `file` cannot be repo-relative on ANY platform: absolute in POSIX
3
+ * or Windows form (leading / or \, or a drive letter), or with a '..' segment
4
+ * under either separator. Independent of the host OS, so a path checked here
5
+ * means the same on the KB server as on this machine.
6
+ */
7
+ export declare function isAbsoluteOrTraversing(file: string): boolean;
1
8
  export declare function validateFilePaths(files: string[]): void;
2
9
  //# sourceMappingURL=path-validation.d.ts.map
@@ -1,4 +1,15 @@
1
1
  import path from 'node:path';
2
+ /**
3
+ * True when `file` cannot be repo-relative on ANY platform: absolute in POSIX
4
+ * or Windows form (leading / or \, or a drive letter), or with a '..' segment
5
+ * under either separator. Independent of the host OS, so a path checked here
6
+ * means the same on the KB server as on this machine.
7
+ */
8
+ export function isAbsoluteOrTraversing(file) {
9
+ if (/^[\\/]/.test(file) || /^[A-Za-z]:/.test(file))
10
+ return true;
11
+ return file.split(/[\\/]/).includes('..');
12
+ }
2
13
  export function validateFilePaths(files) {
3
14
  for (const file of files) {
4
15
  if (path.isAbsolute(file)) {
@@ -26,6 +26,7 @@ export function detectProviderAvailability() {
26
26
  encoding: 'utf-8',
27
27
  timeout: 5000,
28
28
  stdio: ['ignore', 'pipe', 'ignore'],
29
+ windowsHide: true,
29
30
  }).trim();
30
31
  return { available: true, provider: PROVIDER_BINARY, version: output || undefined };
31
32
  }
@@ -1,5 +1,6 @@
1
1
  import { execFileSync } from 'child_process';
2
2
  import path from 'path';
3
+ import { gitExecutable } from '../../os/git-executable.js';
3
4
  export function resolveProjectSlug(cwd, remoteUrl) {
4
5
  if (remoteUrl && remoteUrl.trim()) {
5
6
  const slug = slugify(remoteUrl);
@@ -10,8 +11,8 @@ export function resolveProjectSlug(cwd, remoteUrl) {
10
11
  const env = { ...process.env, GIT_CEILING_DIRECTORIES: path.dirname(dir) };
11
12
  // 1. git remote URL
12
13
  try {
13
- const remote = execFileSync('git', ['remote', 'get-url', 'origin'], {
14
- cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
14
+ const remote = execFileSync(gitExecutable(), ['remote', 'get-url', 'origin'], {
15
+ cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
15
16
  }).trim();
16
17
  const slug = slugify(remote);
17
18
  if (slug)
@@ -20,8 +21,8 @@ export function resolveProjectSlug(cwd, remoteUrl) {
20
21
  catch { }
21
22
  // 2. git repo root dir name
22
23
  try {
23
- const root = execFileSync('git', ['rev-parse', '--show-toplevel'], {
24
- cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
24
+ const root = execFileSync(gitExecutable(), ['rev-parse', '--show-toplevel'], {
25
+ cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
25
26
  }).trim();
26
27
  const slug = slugify(path.basename(root));
27
28
  if (slug)