@apralabs/apra-fleet 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -1,7 +1,8 @@
1
- import { execFile } from 'node:child_process';
1
+ import { execFile, spawn } from 'node:child_process';
2
2
  import { createHash } from 'node:crypto';
3
3
  import fs from 'node:fs';
4
4
  import path from 'node:path';
5
+ import { logWarn } from '../../utils/log-helpers.js';
5
6
  // T3.1 (D4 fold-in, Phase 2 review MEDIUM yashr-d8b): computeFileHashBatch
6
7
  // gains an optional { cwd } anchor so a caller resolving a bible/basis against
7
8
  // a DIFFERENT repo root (e.g. kb_import's --repo) never needs to mutate the
@@ -14,7 +15,7 @@ import path from 'node:path';
14
15
  // (implicit process.cwd() resolution via fs/execFile defaults).
15
16
  function execFileAsync(cmd, args, opts) {
16
17
  return new Promise((resolve, reject) => {
17
- execFile(cmd, args, opts ?? {}, (err, stdout, stderr) => {
18
+ execFile(cmd, args, { ...opts, windowsHide: true }, (err, stdout, stderr) => {
18
19
  if (err)
19
20
  reject(err);
20
21
  else
@@ -57,35 +58,65 @@ export async function computeFileHashBatch(filePaths, opts) {
57
58
  }
58
59
  if (existing.length === 0)
59
60
  return result;
60
- let gitSucceeded = false;
61
- try {
62
- const { stdout } = await execFileAsync('git', ['hash-object', ...existing.map(resolvePath)], root ? { cwd: root } : undefined);
63
- const lines = stdout.trim().split('\n');
64
- if (lines.length === existing.length) {
65
- for (let i = 0; i < existing.length; i++) {
66
- const hash = lines[i].trim();
67
- if (hash.length > 0) {
68
- result[existing[i]] = { hash, type: 'git' };
69
- }
70
- else {
71
- result[existing[i]] = { hash: sha256File(resolvePath(existing[i])), type: 'sha256' };
61
+ // One `git hash-object` per chunk, each kept under HASH_ARGV_CHAR_BUDGET:
62
+ // a single argv holding every path overflowed the Windows command-line limit
63
+ // (32767 chars) for large bibles / long checkout paths, git failed, and the
64
+ // sha256 fallback below then never matched the stored git-type basis -- so
65
+ // freshnessSweep silently staled EVERY entry.
66
+ for (const chunk of chunkByArgvLength(existing, resolvePath)) {
67
+ let gitSucceeded = false;
68
+ try {
69
+ const { stdout } = await execFileAsync('git', ['hash-object', ...chunk.map(resolvePath)], root ? { cwd: root } : undefined);
70
+ const lines = stdout.trim().split('\n');
71
+ if (lines.length === chunk.length) {
72
+ for (let i = 0; i < chunk.length; i++) {
73
+ const hash = lines[i].trim();
74
+ if (hash.length > 0) {
75
+ result[chunk[i]] = { hash, type: 'git' };
76
+ }
77
+ else {
78
+ result[chunk[i]] = { hash: sha256File(resolvePath(chunk[i])), type: 'sha256' };
79
+ }
72
80
  }
81
+ gitSucceeded = true;
73
82
  }
74
- gitSucceeded = true;
75
83
  }
76
- }
77
- catch {
78
- // fall through to per-file sha256
79
- }
80
- if (!gitSucceeded) {
81
- for (const p of existing) {
82
- if (!result[p]) {
83
- result[p] = { hash: sha256File(resolvePath(p)), type: 'sha256' };
84
+ catch (err) {
85
+ // Not silent: a sha256 fallback cannot match a git-type basis, so every
86
+ // entry citing these files will look stale until git hashing works again.
87
+ logWarn('kb_hash', `git hash-object failed for ${chunk.length} file(s); falling back to sha256, so freshness checks against git-type bases will report them stale: ${err?.message ?? String(err)}`);
88
+ }
89
+ if (!gitSucceeded) {
90
+ for (const p of chunk) {
91
+ if (!result[p]) {
92
+ result[p] = { hash: sha256File(resolvePath(p)), type: 'sha256' };
93
+ }
84
94
  }
85
95
  }
86
96
  }
87
97
  return result;
88
98
  }
99
+ // Well under the Windows 32767-char command-line limit (and POSIX ARG_MAX),
100
+ // leaving room for the executable path and quoting overhead.
101
+ const HASH_ARGV_CHAR_BUDGET = 8000;
102
+ function chunkByArgvLength(paths, resolvePath) {
103
+ const chunks = [];
104
+ let current = [];
105
+ let length = 0;
106
+ for (const p of paths) {
107
+ const cost = resolvePath(p).length + 3; // separator + possible quotes
108
+ if (current.length > 0 && length + cost > HASH_ARGV_CHAR_BUDGET) {
109
+ chunks.push(current);
110
+ current = [];
111
+ length = 0;
112
+ }
113
+ current.push(p);
114
+ length += cost;
115
+ }
116
+ if (current.length > 0)
117
+ chunks.push(current);
118
+ return chunks;
119
+ }
89
120
  export async function checkStaleness(entry) {
90
121
  if (entry.type !== 'context-cache')
91
122
  return { stale: false };
@@ -120,4 +151,103 @@ export async function checkStaleness(entry) {
120
151
  throw err;
121
152
  }
122
153
  }
154
+ /**
155
+ * The repo folder a HEAD-anchored hash was asked for is not inside a git work
156
+ * tree. Thrown instead of silently falling back to hashing files on disk:
157
+ * a disk hash is a working-tree hash, not a branch-HEAD hash.
158
+ */
159
+ export class KbHeadHashError extends Error {
160
+ code = 'E-BIBLE-BASIS-NOT-GIT';
161
+ folder;
162
+ remediation;
163
+ constructor(folder, detail) {
164
+ const remediation = `Run this from a git checkout ('git init' or clone the repository into '${folder}').`;
165
+ super(`E-BIBLE-BASIS-NOT-GIT: '${folder}' is not inside a git work tree, so file content at HEAD cannot be read (${detail}). Remediation: ${remediation}`);
166
+ this.name = 'KbHeadHashError';
167
+ this.folder = folder;
168
+ this.remediation = remediation;
169
+ }
170
+ }
171
+ function gitWithStdin(args, cwd, input) {
172
+ return new Promise((resolve, reject) => {
173
+ const child = spawn('git', args, { cwd, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
174
+ const out = [];
175
+ const err = [];
176
+ child.stdout.on('data', (d) => out.push(d));
177
+ child.stderr.on('data', (d) => err.push(d));
178
+ child.on('error', reject);
179
+ child.on('close', code => {
180
+ if (code === 0)
181
+ resolve(Buffer.concat(out).toString('utf-8'));
182
+ else
183
+ reject(new Error(`git ${args.join(' ')} exited ${code}: ${Buffer.concat(err).toString('utf-8').trim()}`));
184
+ });
185
+ child.stdin.end(input);
186
+ });
187
+ }
188
+ /**
189
+ * Hash each file's content AT THE WORK TREE'S HEAD COMMIT (not the file on
190
+ * disk), keyed by the original path strings. Relative paths resolve against
191
+ * `cwd`, exactly as computeFileHashBatch({ cwd }) resolves them.
192
+ *
193
+ * Digest: the git blob id of HEAD:<path>. That is the same digest the stored
194
+ * basis carries -- computeFileHashBatch runs `git hash-object <file>`, which
195
+ * applies the same clean filters as `git add`, so a file whose on-disk content
196
+ * equals its HEAD content hashes to the HEAD blob id. Uncommitted edits
197
+ * therefore never change the result.
198
+ *
199
+ * A file absent at HEAD (untracked, deleted, a directory, a submodule) maps to
200
+ * null. An unborn HEAD (no commit yet) maps every file to null. A `cwd` that is
201
+ * not inside a git work tree throws KbHeadHashError -- never a disk fallback.
202
+ * Absolute paths are not supported (they map to null): HEAD content is only
203
+ * addressable repo-relatively.
204
+ */
205
+ export async function computeHeadFileHashBatch(filePaths, opts) {
206
+ const result = {};
207
+ const cwd = opts.cwd;
208
+ // The git check runs even for an empty list, so a caller in a non-git
209
+ // folder always fails loud rather than quietly admitting nothing.
210
+ let prefix;
211
+ try {
212
+ const { stdout } = await execFileAsync('git', ['rev-parse', '--is-inside-work-tree', '--show-prefix'], { cwd });
213
+ const lines = stdout.split('\n');
214
+ if (lines[0].trim() !== 'true')
215
+ throw new Error('not inside a work tree');
216
+ prefix = (lines[1] ?? '').trim();
217
+ }
218
+ catch (err) {
219
+ throw new KbHeadHashError(cwd, err?.message ?? String(err));
220
+ }
221
+ if (filePaths.length === 0)
222
+ return result;
223
+ for (const p of filePaths)
224
+ result[p] = null;
225
+ try {
226
+ await execFileAsync('git', ['rev-parse', '--verify', '--quiet', 'HEAD^{commit}'], { cwd });
227
+ }
228
+ catch {
229
+ return result; // unborn HEAD: nothing is committed, so nothing matches
230
+ }
231
+ const queried = [];
232
+ const lines = [];
233
+ for (const p of filePaths) {
234
+ if (typeof p !== 'string' || p.length === 0 || /[\r\n]/.test(p) || path.isAbsolute(p) || path.win32.isAbsolute(p))
235
+ continue;
236
+ const rel = path.posix.normalize(prefix + p.replace(/\\/g, '/'));
237
+ if (rel.startsWith('../') || rel === '..' || rel === '.')
238
+ continue;
239
+ queried.push(p);
240
+ lines.push('HEAD:' + rel);
241
+ }
242
+ if (queried.length === 0)
243
+ return result;
244
+ const stdout = await gitWithStdin(['cat-file', '--batch-check=%(objectname) %(objecttype)'], cwd, lines.join('\n') + '\n');
245
+ const outLines = stdout.split('\n');
246
+ for (let i = 0; i < queried.length; i++) {
247
+ const [oid, type] = (outLines[i] ?? '').trim().split(' ');
248
+ if (type === 'blob' && /^[0-9a-f]{40,64}$/.test(oid))
249
+ result[queried[i]] = { hash: oid, type: 'git' };
250
+ }
251
+ return result;
252
+ }
123
253
  //# sourceMappingURL=file-hash.js.map
@@ -1,5 +1,5 @@
1
1
  import { SqliteProvider } from './sqlite-provider.js';
2
- import type { MemoryProvider, KBEntry, KBEntryInput, QueryOptions, KBResult, FileContextResult, PrimeOptions, PrimedContext, SyncOptions, SyncResult, AudnDecision, Confidence, ProviderStats } from './types.js';
2
+ import type { MemoryProvider, KBEntry, KBEntryInput, QueryOptions, EntryTrustFilter, KBResult, FileContextResult, PrimeOptions, PrimedContext, SyncOptions, SyncResult, AudnDecision, Confidence, ProviderStats, DiscardResult, RetireOptions } from './types.js';
3
3
  type QueuedOperation = {
4
4
  op: 'capture';
5
5
  input: KBEntryInput;
@@ -24,13 +24,14 @@ export declare class HttpKbProvider implements MemoryProvider {
24
24
  audn_decision: AudnDecision;
25
25
  }>;
26
26
  query(opts: QueryOptions): Promise<KBResult>;
27
- context(files: string[]): Promise<FileContextResult[]>;
27
+ context(files: string[], confidence?: Confidence[], excludeDisputed?: boolean): Promise<FileContextResult[]>;
28
+ discard(_ids: string[], _opts?: RetireOptions): Promise<DiscardResult>;
28
29
  invalidate(files: string[]): Promise<{
29
30
  invalidated: number;
30
31
  }>;
31
32
  getLinked(id: string): Promise<KBEntry[]>;
32
33
  touch(ids: string[]): Promise<number>;
33
- relatedClaims(ids: string[], limit?: number): Promise<KBEntry[]>;
34
+ relatedClaims(ids: string[], limit?: number, filter?: EntryTrustFilter): Promise<KBEntry[]>;
34
35
  prime(opts: PrimeOptions): Promise<PrimedContext>;
35
36
  promote(id: string, reason?: string): Promise<{
36
37
  id: string;
@@ -151,6 +151,10 @@ export class HttpKbProvider {
151
151
  params.include_stale = 'true';
152
152
  if (opts.include_superseded)
153
153
  params.include_superseded = 'true';
154
+ if (opts.confidence?.length)
155
+ params.confidence = opts.confidence.join(',');
156
+ if (opts.exclude_disputed)
157
+ params.exclude_disputed = 'true';
154
158
  try {
155
159
  return await this.rawRequest('GET', '/api/kb/query', undefined, params);
156
160
  }
@@ -161,19 +165,27 @@ export class HttpKbProvider {
161
165
  throw err;
162
166
  }
163
167
  }
164
- async context(files) {
168
+ async context(files, confidence, excludeDisputed) {
165
169
  await this.tryFlushQueue();
166
170
  try {
167
- const result = await this.rawRequest('GET', '/api/kb/context', undefined, { files: files.join(',') });
171
+ const ctxParams = { files: files.join(',') };
172
+ if (confidence?.length)
173
+ ctxParams.confidence = confidence.join(',');
174
+ if (excludeDisputed)
175
+ ctxParams.exclude_disputed = 'true';
176
+ const result = await this.rawRequest('GET', '/api/kb/context', undefined, ctxParams);
168
177
  return result.results;
169
178
  }
170
179
  catch (err) {
171
180
  if (isConnectionError(err)) {
172
- return this.fallback.context(files);
181
+ return this.fallback.context(files, confidence, excludeDisputed);
173
182
  }
174
183
  throw err;
175
184
  }
176
185
  }
186
+ async discard(_ids, _opts) {
187
+ throw new Error('kb_invalidate {ids} (id-level discard) is not supported by the HTTP KB provider');
188
+ }
177
189
  async invalidate(files) {
178
190
  await this.tryFlushQueue();
179
191
  try {
@@ -204,9 +216,9 @@ export class HttpKbProvider {
204
216
  // Delegated to the local store like getLinked: the graph lives alongside the
205
217
  // entries, and there is no remote route for it. Never throws -- a graph miss
206
218
  // must degrade to "no related claims", not fail a prime.
207
- async relatedClaims(ids, limit) {
219
+ async relatedClaims(ids, limit, filter) {
208
220
  try {
209
- return await this.fallback.relatedClaims(ids, limit);
221
+ return await this.fallback.relatedClaims(ids, limit, filter);
210
222
  }
211
223
  catch {
212
224
  return [];
@@ -0,0 +1,15 @@
1
+ import type { KbAnchor } from './kb-self.js';
2
+ export type KbMaintainerGrantErrorCode = 'E-KB-MAINTAINER-REQUIRED';
3
+ export declare class KbMaintainerGrantError extends Error {
4
+ readonly code: KbMaintainerGrantErrorCode;
5
+ readonly remediation: string;
6
+ constructor(problem: string, remediation: string);
7
+ }
8
+ /**
9
+ * True when the executing tool call comes from a MEMBER session that does NOT
10
+ * carry the kb_maintainer grant. False for a FULL session, for an in-process
11
+ * caller passing an explicit KbAnchor (same predicate as memberOwnerTag), and
12
+ * for the kb_maintainer member session.
13
+ */
14
+ export declare function memberLacksKbMaintainer(anchor?: KbAnchor): boolean;
15
+ //# sourceMappingURL=kb-maintainer-grant.d.ts.map
@@ -0,0 +1,34 @@
1
+ // The kb_maintainer grant, as seen from inside a kb_* tool handler.
2
+ //
3
+ // A MEMBER session carries the grant only when the engine opened it as a
4
+ // repository's kb_maintainer (origin=engine&kb_maintainer=1, see
5
+ // src/services/tool-scope.ts). Tool exposure (member-tool-allowlist.ts) keeps
6
+ // the CONFIRMED-minting tools off every other member session; this module is
7
+ // for the tools every member session IS served but whose particular input can
8
+ // mint or retire CONFIRMED (kb_import with an explicit path, kb_invalidate of a
9
+ // CONFIRMED entry). Like the grant itself it is a routing guard that keeps agent
10
+ // sessions off those paths, not a security boundary against a local process
11
+ // (which can open a FULL session).
12
+ import { getSessionKbMaintainer, getSessionMemberId } from '../tool-scope.js';
13
+ export class KbMaintainerGrantError extends Error {
14
+ code;
15
+ remediation;
16
+ constructor(problem, remediation) {
17
+ super(`E-KB-MAINTAINER-REQUIRED: ${problem} Remediation: ${remediation}`);
18
+ this.name = 'KbMaintainerGrantError';
19
+ this.code = 'E-KB-MAINTAINER-REQUIRED';
20
+ this.remediation = remediation;
21
+ }
22
+ }
23
+ /**
24
+ * True when the executing tool call comes from a MEMBER session that does NOT
25
+ * carry the kb_maintainer grant. False for a FULL session, for an in-process
26
+ * caller passing an explicit KbAnchor (same predicate as memberOwnerTag), and
27
+ * for the kb_maintainer member session.
28
+ */
29
+ export function memberLacksKbMaintainer(anchor) {
30
+ if (anchor !== undefined)
31
+ return false;
32
+ return getSessionMemberId() !== undefined && !getSessionKbMaintainer();
33
+ }
34
+ //# sourceMappingURL=kb-maintainer-grant.js.map
@@ -6,6 +6,10 @@ export interface KbProviders {
6
6
  projectSlug: string;
7
7
  }
8
8
  export declare function createKbProviders(cwd?: string, remoteUrl?: string): Promise<KbProviders>;
9
+ /** The single shared global KB provider. */
10
+ export declare function getGlobalKbProvider(): Promise<SqliteProvider>;
11
+ /** The project slug (KB identity) for a repo folder, cached like getKbProviders'. */
12
+ export declare function getProjectSlug(cwd?: string, remoteUrl?: string): string;
9
13
  /**
10
14
  * Resolve the KB providers for a repo. `cwd` should be the repo the call is
11
15
  * about -- omitting it falls back to the calling process's cwd, which is only
@@ -15,6 +15,10 @@ export async function createKbProviders(cwd, remoteUrl) {
15
15
  // open a separate connection to the same file for every repo the process
16
16
  // touches -- so it gets its own single-slot cache.
17
17
  let _globalProvider = null;
18
+ /** The single shared global KB provider. */
19
+ export function getGlobalKbProvider() {
20
+ return getGlobalProvider();
21
+ }
18
22
  function getGlobalProvider() {
19
23
  if (!_globalProvider) {
20
24
  _globalProvider = (async () => {
@@ -219,6 +223,10 @@ function slugFor(cwd, remoteUrl) {
219
223
  }
220
224
  return slug;
221
225
  }
226
+ /** The project slug (KB identity) for a repo folder, cached like getKbProviders'. */
227
+ export function getProjectSlug(cwd, remoteUrl) {
228
+ return slugFor(cwd, remoteUrl);
229
+ }
222
230
  /**
223
231
  * Resolve the KB providers for a repo. `cwd` should be the repo the call is
224
232
  * about -- omitting it falls back to the calling process's cwd, which is only
@@ -0,0 +1,28 @@
1
+ import { z } from 'zod';
2
+ export type KbRemovedScopeKey = 'repo_path' | 'repo' | 'repo_remote_url';
3
+ /** What replaces each removed key, phrased as the caller's fix. */
4
+ export declare const KB_REMOVED_SCOPE_KEY_REPLACEMENTS: Readonly<Record<KbRemovedScopeKey, string>>;
5
+ export declare const KB_REMOVED_SCOPE_KEYS: KbRemovedScopeKey[];
6
+ /**
7
+ * Spread into every kb_* input schema (last, after the tool's own keys) so a
8
+ * removed key reaches the wrapper instead of being stripped by the MCP layer.
9
+ * Typed `unknown` on purpose: any value, even a well-formed path, is refused.
10
+ */
11
+ export declare const KB_REMOVED_SCOPE_KEYS_SHAPE: {
12
+ repo_path: z.ZodOptional<z.ZodUnknown>;
13
+ repo: z.ZodOptional<z.ZodUnknown>;
14
+ repo_remote_url: z.ZodOptional<z.ZodUnknown>;
15
+ };
16
+ export declare class KbScopeKeyRemovedError extends Error {
17
+ readonly code: "E-SCOPE-KEY-REMOVED";
18
+ readonly keys: KbRemovedScopeKey[];
19
+ constructor(tool: string, keys: KbRemovedScopeKey[]);
20
+ }
21
+ /**
22
+ * Refuse a kb_* call that carries any removed scope key. A key that is present
23
+ * with value undefined is treated as absent (some clients serialise optional
24
+ * fields that way); any other value -- including null or '' -- is refused,
25
+ * because the caller evidently meant to scope the call.
26
+ */
27
+ export declare function assertNoRemovedKbScopeKeys(tool: string, input: unknown): void;
28
+ //# sourceMappingURL=kb-removed-scope-keys.d.ts.map
@@ -0,0 +1,59 @@
1
+ // Removed kb_* scope keys: repo_path, repo, repo_remote_url.
2
+ //
3
+ // Before the KB redesign every kb_* tool took repo_path and repo_remote_url
4
+ // (kb_stats and kb_import also took repo) to say which repository's KB a call
5
+ // was about. The redesign removed them: a kb_* call now always acts on the
6
+ // CALLING SESSION's own KB (kb-self.ts). An MCP server built from a zod raw
7
+ // shape strips undeclared keys before the handler runs, so an existing caller
8
+ // still passing one would have been silently re-pointed at a different KB.
9
+ //
10
+ // So the keys stay DECLARED on every kb_* input schema (KB_REMOVED_SCOPE_KEYS_
11
+ // SHAPE, described as removed) purely so they reach the tool wrapper, and the
12
+ // wrapper refuses any call carrying one (assertNoRemovedKbScopeKeys) with a
13
+ // typed E-SCOPE-KEY-REMOVED error naming the key and what replaces it. The
14
+ // call is refused before any KB is resolved or opened, so nothing changes.
15
+ import { z } from 'zod';
16
+ /** What replaces each removed key, phrased as the caller's fix. */
17
+ export const KB_REMOVED_SCOPE_KEY_REPLACEMENTS = Object.freeze({
18
+ repo_path: "nothing -- drop it: every kb_* call acts on the calling session's own KB (a member session's registered work folder; a FULL session's fleet server working folder). To act on another repository, call from a member session registered on that folder.",
19
+ repo: "nothing -- drop it: same as repo_path, the KB (and kb_stats' bible drift check) is the calling session's own repository. kb_import names a bible file with path, which is unchanged.",
20
+ repo_remote_url: "nothing -- drop it: a remote member's KB identity is its registered origin remote (record it with update_member git_repos) and is resolved from the calling member session.",
21
+ });
22
+ export const KB_REMOVED_SCOPE_KEYS = Object.keys(KB_REMOVED_SCOPE_KEY_REPLACEMENTS);
23
+ const removedDescription = 'REMOVED -- do not pass. A call carrying it fails with E-SCOPE-KEY-REMOVED; the KB is always the calling session\'s own.';
24
+ /**
25
+ * Spread into every kb_* input schema (last, after the tool's own keys) so a
26
+ * removed key reaches the wrapper instead of being stripped by the MCP layer.
27
+ * Typed `unknown` on purpose: any value, even a well-formed path, is refused.
28
+ */
29
+ export const KB_REMOVED_SCOPE_KEYS_SHAPE = {
30
+ repo_path: z.unknown().optional().describe(removedDescription),
31
+ repo: z.unknown().optional().describe(removedDescription),
32
+ repo_remote_url: z.unknown().optional().describe(removedDescription),
33
+ };
34
+ export class KbScopeKeyRemovedError extends Error {
35
+ code = 'E-SCOPE-KEY-REMOVED';
36
+ keys;
37
+ constructor(tool, keys) {
38
+ const named = keys.map(k => `'${k}'`).join(', ');
39
+ const fixes = keys.map(k => `${k}: ${KB_REMOVED_SCOPE_KEY_REPLACEMENTS[k]}`).join(' ');
40
+ super(`E-SCOPE-KEY-REMOVED: ${tool} no longer accepts ${named} (removed in the KB redesign); the call was not run and no KB was changed. ` +
41
+ `Remediation: ${fixes}`);
42
+ this.name = 'KbScopeKeyRemovedError';
43
+ this.keys = keys;
44
+ }
45
+ }
46
+ /**
47
+ * Refuse a kb_* call that carries any removed scope key. A key that is present
48
+ * with value undefined is treated as absent (some clients serialise optional
49
+ * fields that way); any other value -- including null or '' -- is refused,
50
+ * because the caller evidently meant to scope the call.
51
+ */
52
+ export function assertNoRemovedKbScopeKeys(tool, input) {
53
+ if (!input || typeof input !== 'object')
54
+ return;
55
+ const present = KB_REMOVED_SCOPE_KEYS.filter(k => input[k] !== undefined);
56
+ if (present.length > 0)
57
+ throw new KbScopeKeyRemovedError(tool, present);
58
+ }
59
+ //# sourceMappingURL=kb-removed-scope-keys.js.map
@@ -0,0 +1,14 @@
1
+ export declare const GLOBAL_KB_SCOPE = "global";
2
+ export declare const DEFAULT_KB_SCOPE = "default";
3
+ export interface KbScopeLocation {
4
+ slug: string;
5
+ dbPath: string;
6
+ }
7
+ export declare function knowledgeRootDir(): string;
8
+ /**
9
+ * List every scope directory under `knowledgeDir` that holds a kb.sqlite,
10
+ * sorted by slug. Never throws: an absent or unreadable knowledge dir yields
11
+ * an empty list. Read-only -- never creates a directory or database.
12
+ */
13
+ export declare function listKbScopes(knowledgeDir?: string): KbScopeLocation[];
14
+ //# sourceMappingURL=kb-scopes.d.ts.map
@@ -0,0 +1,47 @@
1
+ import fs from 'fs';
2
+ import path from 'path';
3
+ import { FLEET_DIR } from '../../paths.js';
4
+ // Enumerates the KB scopes that exist on disk under FLEET_DIR/knowledge/.
5
+ //
6
+ // The fleet server is ONE long-lived process serving every project a user
7
+ // works on, so anything that reports on "the KB" server-side must look at
8
+ // every scope rather than derive one from the server's own process.cwd()
9
+ // (which is arbitrary -- e.g. C:\Windows\System32 for a detached launch).
10
+ // Each scope is a directory named by its project slug (see project-slug.ts)
11
+ // holding a kb.sqlite; `global` is the single shared cross-project KB, and
12
+ // `default` is where captures from non-git directories land. Other entries in
13
+ // the knowledge dir (config.json, kb-server token files) are not scopes and
14
+ // are ignored: only a directory containing kb.sqlite counts.
15
+ export const GLOBAL_KB_SCOPE = 'global';
16
+ export const DEFAULT_KB_SCOPE = 'default';
17
+ export function knowledgeRootDir() {
18
+ return path.join(FLEET_DIR, 'knowledge');
19
+ }
20
+ /**
21
+ * List every scope directory under `knowledgeDir` that holds a kb.sqlite,
22
+ * sorted by slug. Never throws: an absent or unreadable knowledge dir yields
23
+ * an empty list. Read-only -- never creates a directory or database.
24
+ */
25
+ export function listKbScopes(knowledgeDir = knowledgeRootDir()) {
26
+ let names;
27
+ try {
28
+ names = fs.readdirSync(knowledgeDir);
29
+ }
30
+ catch {
31
+ return [];
32
+ }
33
+ const scopes = [];
34
+ for (const name of names) {
35
+ const dbPath = path.join(knowledgeDir, name, 'kb.sqlite');
36
+ try {
37
+ if (fs.statSync(path.join(knowledgeDir, name)).isDirectory() && fs.statSync(dbPath).isFile()) {
38
+ scopes.push({ slug: name, dbPath });
39
+ }
40
+ }
41
+ catch {
42
+ // Not a scope (plain file, missing kb.sqlite, or unreadable) -- skip.
43
+ }
44
+ }
45
+ return scopes.sort((a, b) => a.slug.localeCompare(b.slug));
46
+ }
47
+ //# sourceMappingURL=kb-scopes.js.map
@@ -0,0 +1,91 @@
1
+ import type { Agent } from '../../types.js';
2
+ import { type KbProviders } from './kb-providers.js';
3
+ /** Explicit KB anchor for in-process callers. Not exposed on any tool schema. */
4
+ export interface KbAnchor {
5
+ /** Repo root the KB is about (anchors relative source_files). */
6
+ folder: string;
7
+ /** Origin remote URL, when the folder lives on another host. */
8
+ remoteUrl?: string;
9
+ /** Registered member whose host the folder lives on (set with remoteUrl). */
10
+ memberId?: string;
11
+ }
12
+ export type KbSelfErrorCode = 'E-SELF-NO-WORKFOLDER' | 'E-SELF-NOT-A-REPO' | 'E-SELF-NO-REMOTE';
13
+ export declare class KbSelfError extends Error {
14
+ readonly code: KbSelfErrorCode;
15
+ readonly folder: string;
16
+ readonly remediation: string;
17
+ constructor(code: KbSelfErrorCode, folder: string, problem: string, remediation: string);
18
+ }
19
+ /**
20
+ * Validate a local folder as a (self) repo: it exists and is a git repository.
21
+ * Shared by kb (self) and code (self) resolution -- code tools need no origin
22
+ * remote (an index is keyed by folder, not by KB identity), kb tools add the
23
+ * remote check on top (validateSelfFolder).
24
+ */
25
+ export declare function validateSelfRepoFolder(folder: string, memberLabel?: string): void;
26
+ /** Validate a local folder as a KB anchor: exists, is a git repo, has an origin remote. */
27
+ export declare function validateSelfFolder(folder: string, memberLabel?: string): KbAnchor;
28
+ /** The calling session's (self) folder before any repo validation. */
29
+ export interface SelfSession {
30
+ /** Member id of a MEMBER session; undefined for a FULL session. */
31
+ memberId?: string;
32
+ /** Member friendly name (or id) used in error text; undefined for FULL. */
33
+ memberLabel?: string;
34
+ /** The member's registered work folder, or the server working folder. */
35
+ folder: string;
36
+ /** The registered member (MEMBER session only). */
37
+ agent?: Agent;
38
+ }
39
+ /**
40
+ * Resolve WHICH folder the calling session means by (self): a MEMBER session's
41
+ * registered work folder, a FULL session's server working folder. A MEMBER
42
+ * session whose member is unregistered or has no work folder is refused with
43
+ * E-SELF-NO-WORKFOLDER -- it never falls back to the server folder.
44
+ */
45
+ export declare function resolveSelfSession(): SelfSession;
46
+ /**
47
+ * Resolve the calling session's own KB anchor (see header). Throws KbSelfError
48
+ * when the resolved folder cannot carry a KB identity.
49
+ */
50
+ export declare function resolveSelfAnchor(): KbAnchor;
51
+ /** The anchor a kb_* handler uses: the explicit in-process anchor, else (self). */
52
+ export declare function resolveKbAnchor(anchor?: KbAnchor): KbAnchor;
53
+ /** KB providers for a kb_* handler call. */
54
+ export declare function getSelfKbProviders(anchor?: KbAnchor): Promise<KbProviders>;
55
+ /**
56
+ * The own-scope tag of the calling MEMBER session, 'member:<uuid>', or
57
+ * undefined for a FULL session or an in-process caller passing an explicit
58
+ * KbAnchor (same predicate getSelfReadKb uses to pick the bible view).
59
+ * MEMBER captures carry this tag, and MEMBER INFERRED/UNVERIFIED reads,
60
+ * kb_promote and kb_invalidate act only on entries carrying it.
61
+ */
62
+ export declare function memberOwnerTag(anchor?: KbAnchor): string | undefined;
63
+ /** KB providers for a read-only kb_* call, plus the anchor they were resolved from. */
64
+ export interface SelfReadKb {
65
+ providers: KbProviders;
66
+ anchor: KbAnchor;
67
+ /** True when `providers.project` is the member's in-memory bible view. */
68
+ memberView: boolean;
69
+ /**
70
+ * Set when a MEMBER session explicitly asked for INFERRED/UNVERIFIED: the
71
+ * request is answered from the per-repo DB and every read must return only
72
+ * entries carrying this tag (member:<uuid>), so a member never sees another
73
+ * member's unconfirmed captures even when they share a machine.
74
+ */
75
+ ownerTag?: string;
76
+ }
77
+ /**
78
+ * Providers for the read tools (kb_query, kb_session_prime, kb_list,
79
+ * kb_context, kb_stats). A MEMBER session (no explicit anchor) reads its own
80
+ * checkout bible through the in-memory view (member-bible-view.ts); the
81
+ * per-repo DB is shared by every member of the repo, whichever branch each is
82
+ * on. Everything else keeps the per-repo DB: FULL sessions, in-process callers
83
+ * passing an explicit KbAnchor, and a MEMBER request that explicitly names the
84
+ * INFERRED or UNVERIFIED tier (a bible carries the CONFIRMED set, so those
85
+ * tiers are not the view's to answer). The global KB is unchanged either way.
86
+ * That last MEMBER case carries `ownerTag`: it sees only its own captures.
87
+ */
88
+ export declare function getSelfReadKb(anchor?: KbAnchor, confidence?: readonly string[]): Promise<SelfReadKb>;
89
+ /** Appended to every kb_* tool description so callers know there is no scope argument. */
90
+ export declare const KB_SELF_NOTE = " Scope: always the calling session's own KB -- a member session uses its registered work folder, any other session the fleet server's working folder; 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).";
91
+ //# sourceMappingURL=kb-self.d.ts.map