@apralabs/apra-fleet 0.4.2 → 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 (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  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/plan-reviewer-output.json +37 -0
  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 +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  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 +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,198 @@
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 server's own working folder.
9
+ //
10
+ // An HTTP server cannot see a client's cwd, so there is no separate (self) for
11
+ // local non-member callers: they get the server's folder.
12
+ //
13
+ // KB identity comes from the resolved folder's origin remote, so a folder that
14
+ // is missing, is not a git repository, or has no origin remote is refused with
15
+ // a typed error carrying one line of remediation -- never silently mapped to a
16
+ // directory-name or 'default' KB.
17
+ //
18
+ // In-process callers that already know exactly which repo they mean (the
19
+ // execute_prompt post-dispatch harvest, the `kb commit` CLI) pass an explicit
20
+ // KbAnchor as the handler's second argument. That argument is not part of any
21
+ // tool's input schema, so no MCP client can supply it.
22
+ import fs from 'node:fs';
23
+ import path from 'node:path';
24
+ import { execFileSync } from 'node:child_process';
25
+ import { getSessionMemberId } from '../tool-scope.js';
26
+ import { getAgent } from '../registry.js';
27
+ import { knownRepoRemoteUrl } from '../member-remote-url.js';
28
+ import { getKbProviders, getGlobalKbProvider, getProjectSlug } from './kb-providers.js';
29
+ import { getMemberBibleView } from './member-bible-view.js';
30
+ export class KbSelfError extends Error {
31
+ code;
32
+ folder;
33
+ remediation;
34
+ constructor(code, folder, problem, remediation) {
35
+ super(`${code}: ${problem} Remediation: ${remediation}`);
36
+ this.name = 'KbSelfError';
37
+ this.code = code;
38
+ this.folder = folder;
39
+ this.remediation = remediation;
40
+ }
41
+ }
42
+ function whose(memberLabel) {
43
+ return memberLabel ? `member '${memberLabel}' work folder` : 'server working folder';
44
+ }
45
+ // A FULL session (no member identity) resolves to the fleet SERVER's working
46
+ // folder, never the client's: an HTTP server cannot see a client's cwd. A
47
+ // caller hitting a self error there usually expected its own directory, so the
48
+ // error names that cause and both fixes explicitly.
49
+ const FULL_SESSION_CAUSE = "This is a FULL session (no member identity), so its KB is the fleet server's own working folder, not the calling client's directory";
50
+ const FULL_SESSION_FIX = 'Restart the fleet server with its working folder set to the repository whose KB you want, or call from a member session (?member=<id>) of a member registered on that repository.';
51
+ function noWorkFolder(folder, memberLabel) {
52
+ 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
53
+ ? 'Create the folder or re-register the member with an existing work folder (register_member / update_member).'
54
+ : FULL_SESSION_FIX);
55
+ }
56
+ function gitOut(folder, args) {
57
+ // Same ceiling as resolveProjectSlug: the folder itself must be the repo, so a
58
+ // temp folder that merely sits inside some other checkout is not mistaken
59
+ // for that checkout.
60
+ const env = { ...process.env, GIT_CEILING_DIRECTORIES: path.dirname(folder) };
61
+ try {
62
+ return execFileSync('git', args, {
63
+ cwd: folder, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
64
+ }).trim();
65
+ }
66
+ catch {
67
+ return null;
68
+ }
69
+ }
70
+ /**
71
+ * Validate a local folder as a (self) repo: it exists and is a git repository.
72
+ * Shared by kb (self) and code (self) resolution -- code tools need no origin
73
+ * remote (an index is keyed by folder, not by KB identity), kb tools add the
74
+ * remote check on top (validateSelfFolder).
75
+ */
76
+ export function validateSelfRepoFolder(folder, memberLabel) {
77
+ let isDir = false;
78
+ try {
79
+ isDir = !!folder && fs.statSync(folder).isDirectory();
80
+ }
81
+ catch {
82
+ isDir = false;
83
+ }
84
+ if (!isDir)
85
+ throw noWorkFolder(folder, memberLabel);
86
+ if (gitOut(folder, ['rev-parse', '--git-dir']) === null) {
87
+ throw new KbSelfError('E-SELF-NOT-A-REPO', folder, memberLabel
88
+ ? `The ${whose(memberLabel)} '${folder}' is not a git repository.`
89
+ : `${FULL_SESSION_CAUSE}; '${folder}' is not a git repository.`, memberLabel
90
+ ? `Run 'git init' (or clone the project) in '${folder}' and add an origin remote.`
91
+ : `${FULL_SESSION_FIX} Or make '${folder}' itself a git repository with an origin remote.`);
92
+ }
93
+ }
94
+ /** Validate a local folder as a KB anchor: exists, is a git repo, has an origin remote. */
95
+ export function validateSelfFolder(folder, memberLabel) {
96
+ validateSelfRepoFolder(folder, memberLabel);
97
+ const remote = gitOut(folder, ['remote', 'get-url', 'origin']);
98
+ if (!remote) {
99
+ throw new KbSelfError('E-SELF-NO-REMOTE', folder, memberLabel
100
+ ? `The ${whose(memberLabel)} '${folder}' has no origin remote, so it has no KB identity.`
101
+ : `${FULL_SESSION_CAUSE}; '${folder}' has no origin remote, so it has no KB identity.`, memberLabel
102
+ ? `Run 'git remote add origin <url>' in '${folder}'.`
103
+ : `${FULL_SESSION_FIX} Or run 'git remote add origin <url>' in '${folder}'.`);
104
+ }
105
+ return { folder };
106
+ }
107
+ /**
108
+ * Resolve WHICH folder the calling session means by (self): a MEMBER session's
109
+ * registered work folder, a FULL session's server working folder. A MEMBER
110
+ * session whose member is unregistered or has no work folder is refused with
111
+ * E-SELF-NO-WORKFOLDER -- it never falls back to the server folder.
112
+ */
113
+ export function resolveSelfSession() {
114
+ const memberId = getSessionMemberId();
115
+ if (memberId === undefined)
116
+ return { folder: process.cwd() };
117
+ const agent = getAgent(memberId);
118
+ const label = agent?.friendlyName ?? memberId;
119
+ const folder = agent?.workFolder ?? '';
120
+ if (!agent || !folder)
121
+ throw noWorkFolder(folder, label);
122
+ return { memberId, memberLabel: label, folder, agent };
123
+ }
124
+ /**
125
+ * Resolve the calling session's own KB anchor (see header). Throws KbSelfError
126
+ * when the resolved folder cannot carry a KB identity.
127
+ */
128
+ export function resolveSelfAnchor() {
129
+ const self = resolveSelfSession();
130
+ const { agent, folder, memberLabel: label, memberId } = self;
131
+ if (!agent)
132
+ return validateSelfFolder(folder);
133
+ if (agent.agentType !== 'local') {
134
+ // The work folder lives on another host: git cannot be shelled out there,
135
+ // so the KB identity is the member's single known origin remote.
136
+ const remoteUrl = knownRepoRemoteUrl(agent);
137
+ if (!remoteUrl) {
138
+ 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.`);
139
+ }
140
+ return { folder, remoteUrl, memberId };
141
+ }
142
+ return validateSelfFolder(folder, label);
143
+ }
144
+ /** The anchor a kb_* handler uses: the explicit in-process anchor, else (self). */
145
+ export function resolveKbAnchor(anchor) {
146
+ return anchor ?? resolveSelfAnchor();
147
+ }
148
+ /** KB providers for a kb_* handler call. */
149
+ export async function getSelfKbProviders(anchor) {
150
+ const resolved = resolveKbAnchor(anchor);
151
+ return getKbProviders(resolved.folder, resolved.remoteUrl);
152
+ }
153
+ /**
154
+ * The own-scope tag of the calling MEMBER session, 'member:<uuid>', or
155
+ * undefined for a FULL session or an in-process caller passing an explicit
156
+ * KbAnchor (same predicate getSelfReadKb uses to pick the bible view).
157
+ * MEMBER captures carry this tag, and MEMBER INFERRED/UNVERIFIED reads,
158
+ * kb_promote and kb_invalidate act only on entries carrying it.
159
+ */
160
+ export function memberOwnerTag(anchor) {
161
+ if (anchor !== undefined)
162
+ return undefined;
163
+ const memberId = getSessionMemberId();
164
+ return memberId === undefined ? undefined : `member:${memberId}`;
165
+ }
166
+ /**
167
+ * Providers for the read tools (kb_query, kb_session_prime, kb_list,
168
+ * kb_context, kb_stats). A MEMBER session (no explicit anchor) reads its own
169
+ * checkout bible through the in-memory view (member-bible-view.ts); the
170
+ * per-repo DB is shared by every member of the repo, whichever branch each is
171
+ * on. Everything else keeps the per-repo DB: FULL sessions, in-process callers
172
+ * passing an explicit KbAnchor, and a MEMBER request that explicitly names the
173
+ * INFERRED or UNVERIFIED tier (a bible carries the CONFIRMED set, so those
174
+ * tiers are not the view's to answer). The global KB is unchanged either way.
175
+ * That last MEMBER case carries `ownerTag`: it sees only its own captures.
176
+ */
177
+ export async function getSelfReadKb(anchor, confidence) {
178
+ const resolved = resolveKbAnchor(anchor);
179
+ const namesUnconfirmedTier = (confidence ?? []).some(c => c !== 'CONFIRMED');
180
+ if (anchor === undefined && getSessionMemberId() !== undefined && !namesUnconfirmedTier) {
181
+ const [project, global] = await Promise.all([getMemberBibleView(resolved), getGlobalKbProvider()]);
182
+ return {
183
+ providers: { project, global, projectSlug: getProjectSlug(resolved.folder, resolved.remoteUrl) },
184
+ anchor: resolved,
185
+ memberView: true,
186
+ };
187
+ }
188
+ const ownerTag = memberOwnerTag(anchor);
189
+ return {
190
+ providers: await getKbProviders(resolved.folder, resolved.remoteUrl),
191
+ anchor: resolved,
192
+ memberView: false,
193
+ ...(ownerTag !== undefined ? { ownerTag } : {}),
194
+ };
195
+ }
196
+ /** Appended to every kb_* tool description so callers know there is no scope argument. */
197
+ export 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).';
198
+ //# 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,194 @@
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 { readBibleEntries, parseBibleText, 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
+ const entries = missing ? [] : readBibleEntries(biblePath, 'member bible view');
72
+ // repoRoot anchors relative source_files exactly as the per-repo provider
73
+ // does, so the capture basis check and prime()'s freshness check judge the
74
+ // bible against the member's own checkout.
75
+ const provider = new SqliteProvider(':memory:', repoRoot);
76
+ await provider.init();
77
+ if (entries.length > 0)
78
+ await importBibleEntries(provider, entries, { verbatim: true });
79
+ return provider;
80
+ }
81
+ function remoteFail(folder, problem) {
82
+ 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.');
83
+ }
84
+ function remoteBiblePath(agent, folder) {
85
+ const win = getAgentOS(agent) === 'windows' && !isPosixShell('windows', getAgentShell(agent));
86
+ return win ? `${folder.replace(/[\\/]+$/, '')}\\.fleet\\kb-canonical.json` : `${folder.replace(/\/+$/, '')}/.fleet/kb-canonical.json`;
87
+ }
88
+ const REMOTE_TIMEOUT_MS = 20_000;
89
+ /** Command that prints "<mtime> <size>" for the bible, or MISSING. */
90
+ function statCommand(agent, p) {
91
+ if (getAgentOS(agent) === 'windows' && !isPosixShell('windows', getAgentShell(agent))) {
92
+ const q = p.replace(/'/g, "''");
93
+ 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') }`);
94
+ }
95
+ const q = `'${p.replace(/'/g, `'\\''`)}'`;
96
+ return `if [ -f ${q} ]; then (stat -c '%Y %s' ${q} 2>/dev/null || stat -f '%m %z' ${q}); else printf MISSING; fi`;
97
+ }
98
+ function catCommand(agent, p) {
99
+ if (getAgentOS(agent) === 'windows' && !isPosixShell('windows', getAgentShell(agent))) {
100
+ const q = p.replace(/'/g, "''");
101
+ return wrapPowerShellEncoded(`[Console]::Out.Write([System.IO.File]::ReadAllText('${q}'))`);
102
+ }
103
+ return `cat '${p.replace(/'/g, `'\\''`)}'`;
104
+ }
105
+ async function getRemoteMemberBibleView(anchor) {
106
+ const agent = anchor.memberId ? getAgent(anchor.memberId) : undefined;
107
+ if (!agent) {
108
+ throw remoteFail(anchor.folder, `The member for work folder '${anchor.folder}' is not registered, so its checkout bible cannot be fetched.`);
109
+ }
110
+ const strategy = getStrategy(agent);
111
+ const biblePath = remoteBiblePath(agent, anchor.folder);
112
+ const key = `remote:${agent.id}:${biblePath}`;
113
+ const run = async (cmd) => {
114
+ let r;
115
+ try {
116
+ r = await strategy.execCommand(cmd, REMOTE_TIMEOUT_MS);
117
+ }
118
+ catch (err) {
119
+ throw remoteFail(anchor.folder, `Could not reach member '${agent.friendlyName}' to read its checkout bible: ${err instanceof Error ? err.message : String(err)}.`);
120
+ }
121
+ if (r.code !== 0) {
122
+ throw remoteFail(anchor.folder, `Reading the bible on member '${agent.friendlyName}' failed (exit ${r.code}): ${r.stderr.trim()}.`);
123
+ }
124
+ return r.stdout;
125
+ };
126
+ const statOut = (await run(statCommand(agent, biblePath))).split(/\r?\n/).map(l => l.trim()).filter(Boolean).pop() ?? '';
127
+ let mtimeMs = -1;
128
+ let size = -1;
129
+ if (statOut !== 'MISSING') {
130
+ const m = /^(\d+) (\d+)$/.exec(statOut);
131
+ if (!m)
132
+ throw remoteFail(anchor.folder, `Unexpected stat output from member '${agent.friendlyName}': '${statOut.slice(0, 80)}'.`);
133
+ mtimeMs = Number(m[1]);
134
+ size = Number(m[2]);
135
+ }
136
+ const current = _views.get(key);
137
+ if (current && current.mtimeMs === mtimeMs && current.size === size)
138
+ return current.provider;
139
+ const build = async () => {
140
+ _loadCounts.set(key, (_loadCounts.get(key) ?? 0) + 1);
141
+ const entries = mtimeMs === -1 ? [] : parseBibleText(await run(catCommand(agent, biblePath)), biblePath, 'member bible view');
142
+ // The member's checkout is on another host: nothing here can verify its
143
+ // source files, so import unanchored, then bind the remote folder so
144
+ // freshness issues no verdict (see SqliteProvider.bindRepoPath).
145
+ const provider = new SqliteProvider(':memory:');
146
+ await provider.init();
147
+ if (entries.length > 0)
148
+ await importBibleEntries(provider, entries, { verbatim: true });
149
+ provider.bindRepoPath(anchor.folder);
150
+ return provider;
151
+ };
152
+ const slot = { mtimeMs, size, provider: build() };
153
+ _views.set(key, slot);
154
+ slot.provider.catch(() => {
155
+ if (_views.get(key) === slot)
156
+ _views.delete(key);
157
+ });
158
+ return slot.provider;
159
+ }
160
+ /**
161
+ * The in-memory view of the anchor's checkout bible. Rebuilt when the file's
162
+ * mtime or size changed since the last load; otherwise the cached view.
163
+ */
164
+ export async function getMemberBibleView(anchor) {
165
+ if (anchor.remoteUrl !== undefined)
166
+ return getRemoteMemberBibleView(anchor);
167
+ const biblePath = memberBiblePath(anchor.folder);
168
+ const { mtimeMs, size } = statOrMissing(biblePath);
169
+ const current = _views.get(biblePath);
170
+ if (current && current.mtimeMs === mtimeMs && current.size === size) {
171
+ return current.provider;
172
+ }
173
+ // The replaced view is not closed: a concurrent reader may still hold it
174
+ // mid-call. Dropping the reference lets it be collected.
175
+ const slot = { mtimeMs, size, provider: buildView(biblePath, anchor.folder, mtimeMs === -1) };
176
+ _views.set(biblePath, slot);
177
+ // Never cache a failed build (a malformed bible must fail on every read, and
178
+ // a fixed bible must load without a restart).
179
+ slot.provider.catch(() => {
180
+ if (_views.get(biblePath) === slot)
181
+ _views.delete(biblePath);
182
+ });
183
+ return slot.provider;
184
+ }
185
+ /** Number of times the view for this bible path has been (re)built. For tests. */
186
+ export function memberBibleViewLoadCount(biblePath) {
187
+ return _loadCounts.get(biblePath) ?? 0;
188
+ }
189
+ /** Drop every cached view (what a server restart does). */
190
+ export function resetMemberBibleViews() {
191
+ _views.clear();
192
+ _loadCounts.clear();
193
+ }
194
+ //# sourceMappingURL=member-bible-view.js.map
@@ -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
  }
@@ -11,7 +11,7 @@ export function resolveProjectSlug(cwd, remoteUrl) {
11
11
  // 1. git remote URL
12
12
  try {
13
13
  const remote = execFileSync('git', ['remote', 'get-url', 'origin'], {
14
- cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
14
+ cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
15
15
  }).trim();
16
16
  const slug = slugify(remote);
17
17
  if (slug)
@@ -21,7 +21,7 @@ export function resolveProjectSlug(cwd, remoteUrl) {
21
21
  // 2. git repo root dir name
22
22
  try {
23
23
  const root = execFileSync('git', ['rev-parse', '--show-toplevel'], {
24
- cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
24
+ cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
25
25
  }).trim();
26
26
  const slug = slugify(path.basename(root));
27
27
  if (slug)
@@ -0,0 +1,32 @@
1
+ import { SqliteProvider } from './sqlite-provider.js';
2
+ import type { MemoryProvider } from './types.js';
3
+ /**
4
+ * Non-throwing type guard: true when the project KB provider is a
5
+ * SqliteProvider. For call sites that DEGRADE over a remote provider rather
6
+ * than refusing (kb_stats) -- they must ask the type question directly, not
7
+ * catch requireSqliteProject's throw, which would also swallow any other
8
+ * error raised on that path.
9
+ */
10
+ export declare function isSqliteProject(provider: MemoryProvider): provider is SqliteProvider;
11
+ /**
12
+ * Narrows a project KB provider to SqliteProvider, for call sites that use
13
+ * SqliteProvider-only capabilities not part of the MemoryProvider interface
14
+ * (list, feedback, freshnessSweep, reconcilePrefilter, resolveContradiction,
15
+ * hasEntry, the DirectiveProvider methods, and capture's second CaptureOpts
16
+ * argument).
17
+ *
18
+ * Accepts MemoryProvider (not SqliteProvider) on purpose: KbProviders.project is
19
+ * SqliteProvider today, but a later task widens it to MemoryProvider so an
20
+ * HttpKbProvider can be selected. This helper already compiles and behaves
21
+ * identically against today's narrower type, so callers can adopt it ahead of
22
+ * that widening without breaking anything, and once the widening lands every
23
+ * SqliteProvider-only call site routes through here instead of failing to compile.
24
+ *
25
+ * @param provider the project KB provider to narrow
26
+ * @param callerLabel short label identifying the call site, surfaced in the
27
+ * thrown error message (e.g. the tool name)
28
+ * @throws Error naming callerLabel when provider is not a SqliteProvider --
29
+ * never returns a null/undefined sentinel
30
+ */
31
+ export declare function requireSqliteProject(provider: MemoryProvider, callerLabel: string): SqliteProvider;
32
+ //# sourceMappingURL=require-sqlite-project.d.ts.map
@@ -0,0 +1,38 @@
1
+ import { SqliteProvider } from './sqlite-provider.js';
2
+ /**
3
+ * Non-throwing type guard: true when the project KB provider is a
4
+ * SqliteProvider. For call sites that DEGRADE over a remote provider rather
5
+ * than refusing (kb_stats) -- they must ask the type question directly, not
6
+ * catch requireSqliteProject's throw, which would also swallow any other
7
+ * error raised on that path.
8
+ */
9
+ export function isSqliteProject(provider) {
10
+ return provider instanceof SqliteProvider;
11
+ }
12
+ /**
13
+ * Narrows a project KB provider to SqliteProvider, for call sites that use
14
+ * SqliteProvider-only capabilities not part of the MemoryProvider interface
15
+ * (list, feedback, freshnessSweep, reconcilePrefilter, resolveContradiction,
16
+ * hasEntry, the DirectiveProvider methods, and capture's second CaptureOpts
17
+ * argument).
18
+ *
19
+ * Accepts MemoryProvider (not SqliteProvider) on purpose: KbProviders.project is
20
+ * SqliteProvider today, but a later task widens it to MemoryProvider so an
21
+ * HttpKbProvider can be selected. This helper already compiles and behaves
22
+ * identically against today's narrower type, so callers can adopt it ahead of
23
+ * that widening without breaking anything, and once the widening lands every
24
+ * SqliteProvider-only call site routes through here instead of failing to compile.
25
+ *
26
+ * @param provider the project KB provider to narrow
27
+ * @param callerLabel short label identifying the call site, surfaced in the
28
+ * thrown error message (e.g. the tool name)
29
+ * @throws Error naming callerLabel when provider is not a SqliteProvider --
30
+ * never returns a null/undefined sentinel
31
+ */
32
+ export function requireSqliteProject(provider, callerLabel) {
33
+ if (isSqliteProject(provider)) {
34
+ return provider;
35
+ }
36
+ throw new Error(`${callerLabel}: this operation is not supported when the KB is backed by a remote HTTP provider`);
37
+ }
38
+ //# sourceMappingURL=require-sqlite-project.js.map
@@ -1,4 +1,5 @@
1
- import type { MemoryProvider, KBEntry, KBEntryInput, CaptureOpts, QueryOptions, KBResult, FileContextResult, PrimeOptions, PrimedContext, SyncOptions, SyncResult, AudnDecision, Confidence, ProviderStats } from './types.js';
1
+ import { type DiscardResult, type RetireOptions } from './types.js';
2
+ import type { MemoryProvider, KBEntry, KBEntryInput, CaptureOpts, CaptureResult, QueryOptions, EntryTrustFilter, KBResult, FileContextResult, PrimeOptions, PrimedContext, SyncOptions, SyncResult, Confidence, ProviderStats } from './types.js';
2
3
  export declare class SqliteProvider implements MemoryProvider {
3
4
  private db;
4
5
  readonly dbPath: string;
@@ -10,9 +11,25 @@ export declare class SqliteProvider implements MemoryProvider {
10
11
  * repo-blindness failure class of apra-fleet-tm7. Undefined for the single
11
12
  * shared global KB, which spans every repo and has no one root.
12
13
  */
13
- readonly repoPath: string | undefined;
14
+ repoPath: string | undefined;
14
15
  constructor(dbPath?: string, repoPath?: string);
16
+ /**
17
+ * Re-anchor after loading. Used only by the remote member bible view: the
18
+ * member's checkout is not on this host, so entries are imported with no
19
+ * anchor (the basis gate cannot check files here), then the remote folder is
20
+ * bound so freshness reads treat the anchor as missing and issue no verdict.
21
+ */
22
+ bindRepoPath(repoPath: string | undefined): void;
15
23
  init(): Promise<void>;
24
+ /**
25
+ * Record `blobId` (a git object id of a bible's bytes) as written or
26
+ * imported by the maintainer side. Idempotent: re-recording keeps the first
27
+ * row. Only trusted callers (kb_bible_commit and kb_import from a FULL or
28
+ * kb_maintainer session) may call this.
29
+ */
30
+ recordTrustedBibleBlob(blobId: string, source: 'kb_bible_commit' | 'kb_import'): void;
31
+ /** True when `blobId` was recorded by recordTrustedBibleBlob. */
32
+ isTrustedBibleBlob(blobId: string): boolean;
16
33
  private getDb;
17
34
  private rowToEntry;
18
35
  private insertEntry;
@@ -60,11 +77,28 @@ export declare class SqliteProvider implements MemoryProvider {
60
77
  * entry while unexpected failures still propagate.
61
78
  */
62
79
  private assertCheckableBasis;
80
+ /**
81
+ * The ONLY way this provider hashes source files: relative paths anchor at
82
+ * the provider repo (never process.cwd()) when one is set. Every call site
83
+ * goes through here so a new call cannot forget the anchor.
84
+ */
85
+ private hashAnchored;
63
86
  private computeSourceFileHashes;
64
87
  private static readonly FEEDBACK_MARKER_RE;
65
88
  private freshnessRevivable;
66
89
  private basisFullyMatches;
67
90
  private parseBasis;
91
+ /**
92
+ * Read-only accessor for the stored per-file hash basis (source_file_hashes)
93
+ * of the given entry ids. Each requested id maps to its parsed basis, or null
94
+ * when the basis is empty/unparseable or the id is unknown. Used by kb_export's
95
+ * project-scope bible filter and kb_bible_commit admission; internal to this
96
+ * provider, not an MCP surface. A local freshness-only basis
97
+ * (local_basis_only = 1, a legacy bible import) maps to null: it was hashed
98
+ * from this clone, never verified, so it must never be exported or admit an
99
+ * entry to the bible.
100
+ */
101
+ getSourceFileBases(ids: string[]): Map<string, Record<string, string> | null>;
68
102
  private checkFreshness;
69
103
  freshnessSweep(root?: string): Promise<{
70
104
  checked: number;
@@ -86,29 +120,48 @@ export declare class SqliteProvider implements MemoryProvider {
86
120
  */
87
121
  private decayConceptEntries;
88
122
  private wireLinks;
89
- capture(input: KBEntryInput, opts?: CaptureOpts): Promise<{
90
- id: string;
91
- audn_decision: AudnDecision;
92
- }>;
123
+ capture(input: KBEntryInput, opts?: CaptureOpts): Promise<CaptureResult>;
93
124
  hasEntry(id: string): boolean;
94
125
  touch(ids: string[]): Promise<number>;
95
126
  query(opts: QueryOptions): Promise<KBResult>;
96
- context(files: string[]): Promise<FileContextResult[]>;
97
- invalidate(files: string[]): Promise<{
127
+ context(files: string[], confidence?: Confidence[], excludeDisputed?: boolean, ownerTag?: string): Promise<FileContextResult[]>;
128
+ discard(ids: string[], opts?: RetireOptions): Promise<DiscardResult>;
129
+ /**
130
+ * For each id this KB holds as RETIRED, why: 'superseded' or 'invalidated'.
131
+ * Ids that are unknown, or known and not retired, are absent from the map.
132
+ *
133
+ * Retired means superseded_at is set (reason from retired_reason; NULL, a
134
+ * row retired before that column existed, counts as 'superseded'), or
135
+ * content_hash = 'invalidated' (kb_invalidate by file) -> 'invalidated'.
136
+ *
137
+ * A merely STALE row (stale = 1 from the freshness sweep, superseded_at
138
+ * NULL, content_hash not 'invalidated') is NOT retired: staleness means the
139
+ * cited files moved, which the next capture or sweep can clear, while
140
+ * superseded and invalidated are explicit curation decisions. Only those two
141
+ * remove an entry from the bible (kb_bible_commit).
142
+ */
143
+ getRetirementReasons(ids: string[]): Map<string, 'superseded' | 'invalidated'>;
144
+ invalidate(files: string[], opts?: RetireOptions): Promise<{
98
145
  invalidated: number;
146
+ refused?: string[];
99
147
  }>;
100
148
  getLinked(id: string): Promise<KBEntry[]>;
101
- relatedClaims(ids: string[], limit?: number): Promise<KBEntry[]>;
149
+ relatedClaims(ids: string[], limit?: number, filter?: EntryTrustFilter): Promise<KBEntry[]>;
102
150
  prime(opts: PrimeOptions): Promise<PrimedContext>;
103
151
  list(opts: {
104
- confidence?: Confidence;
152
+ confidence?: Confidence[];
105
153
  type?: KBEntry['type'];
106
154
  module?: string;
107
155
  symbol?: string;
108
156
  tag?: string;
109
157
  limit?: number;
158
+ exclude_disputed?: boolean;
159
+ /** MEMBER own-scope: only entries tagged with this value (ANDed with `tag`). */
160
+ owner_tag?: string;
110
161
  }): Promise<KBEntry[]>;
111
- promote(id: string, reason?: string): Promise<{
162
+ promote(id: string, reason?: string, opts?: {
163
+ ownerTag?: string;
164
+ }): Promise<{
112
165
  id: string;
113
166
  confidence_before: Confidence;
114
167
  confidence_after: Confidence;