@apralabs/apra-fleet 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -0,0 +1,77 @@
1
+ export declare const REPOSITORY_HEADER = "X-Repository";
2
+ export declare const REPOSITORY_COMMIT_HEADER = "X-Repository-Commit";
3
+ export declare const REPOSITORY_BRANCH_HEADER = "X-Repository-Branch";
4
+ /** Longest X-Repository-Branch value (after percent-encoding) that is sent. */
5
+ export declare const MAX_BRANCH_LENGTH = 255;
6
+ /** Longest X-Repository value a receiving server accepts. */
7
+ export declare const MAX_REPOSITORY_LENGTH = 512;
8
+ /** The repository a provider sends with every request. */
9
+ export interface RepositoryIdentity {
10
+ /** Normalised origin remote, `host/path` (see normaliseRepositoryRemote). */
11
+ remote: string;
12
+ /** HEAD sha of the local folder; undefined when unknown. Must not throw. */
13
+ commitOf?: () => string | undefined;
14
+ /**
15
+ * Checked-out branch of the local folder, percent-encoded; undefined when
16
+ * unknown or HEAD is detached. Must not throw.
17
+ */
18
+ branchOf?: () => string | undefined;
19
+ }
20
+ /**
21
+ * Normalise a git remote URL to `host/path`: no scheme, no user info or
22
+ * credentials, no port, no query or fragment, no trailing `.git` or `/`. The
23
+ * host is lowercased; the path keeps its case. ssh forms (`git@host:org/repo`,
24
+ * `ssh://git@host/org/repo`) map to the same value as https. Azure DevOps
25
+ * spellings fold to `dev.azure.com/<org>/<project>/_git/<repo>` (org
26
+ * lowercased), as the receiving server canonicalises them. Characters outside
27
+ * printable ASCII (space, non-ASCII) are percent-encoded.
28
+ *
29
+ * Returns undefined for anything that is not a network remote (a local path, a
30
+ * file:// URL) or that would not be a valid header value.
31
+ */
32
+ export declare function normaliseRepositoryRemote(remoteUrl: string): string | undefined;
33
+ /**
34
+ * True when `value` is a header value a receiving server accepts: at most 512
35
+ * printable ASCII characters, no spaces, no scheme, no '@' before the first '/'.
36
+ */
37
+ export declare function isValidRepositoryValue(value: string): boolean;
38
+ /** A full SHA-1 or SHA-256 commit id, lowercase. */
39
+ export declare const COMMIT_SHA: RegExp;
40
+ /** How long a read HEAD sha is reused before git is asked again. */
41
+ export declare const HEAD_COMMIT_TTL_MS = 5000;
42
+ /**
43
+ * A reader for the HEAD sha of a local folder, cached for `ttlMs` so it is not
44
+ * re-read on every request. Returns undefined (never throws) when the folder
45
+ * is not a git repository or HEAD cannot be resolved (unborn branch).
46
+ */
47
+ export declare function headCommitReader(folder: string, ttlMs?: number): () => string | undefined;
48
+ /**
49
+ * True when `value` is an X-Repository-Branch value that may be sent: 1-255
50
+ * printable ASCII characters, no spaces.
51
+ */
52
+ export declare function isValidBranchValue(value: string): boolean;
53
+ /**
54
+ * The header value for a branch name: characters outside printable ASCII
55
+ * (non-ASCII, control, space) percent-encoded as UTF-8. Undefined when the
56
+ * result is empty or longer than MAX_BRANCH_LENGTH.
57
+ */
58
+ export declare function branchHeaderValue(branch: string): string | undefined;
59
+ /**
60
+ * A reader for the checked-out branch of a local folder (`git symbolic-ref
61
+ * --quiet HEAD`, with `refs/heads/` stripped), cached for `ttlMs` like
62
+ * headCommitReader so a branch switch shows within one TTL. `--short` is not
63
+ * used: it prints `heads/x` when a tag `x` also exists. Returns the header value
64
+ * (see branchHeaderValue), or undefined (never throws) on a detached HEAD, a HEAD
65
+ * not under refs/heads/, a folder that is not a git repository, a git failure or
66
+ * timeout, or an invalid value.
67
+ */
68
+ export declare function headBranchReader(folder: string, ttlMs?: number): () => string | undefined;
69
+ /**
70
+ * The repository identity for a resolved KB anchor, or undefined when there is
71
+ * none. `remoteUrl` is set only when the folder lives on another host: then
72
+ * the identity is that remote and the commit and branch are unknown (git
73
+ * cannot run there). Otherwise the identity is the local folder's origin
74
+ * remote, the commit is its HEAD and the branch its checked-out branch.
75
+ */
76
+ export declare function resolveRepositoryIdentity(folder: string, remoteUrl?: string): RepositoryIdentity | undefined;
77
+ //# sourceMappingURL=repository-header.d.ts.map
@@ -0,0 +1,233 @@
1
+ // The repository a remote KB request is about, as the HTTP provider sends it.
2
+ //
3
+ // kb_* tools take no repository argument: fleet resolves the repository from
4
+ // the calling session (kb-self.ts). HttpKbProvider forwards that resolved
5
+ // repository to a shared remote KB server as two headers, so the server can
6
+ // keep repositories apart:
7
+ //
8
+ // X-Repository the normalised origin remote, `host/path`
9
+ // X-Repository-Commit the HEAD sha of the local folder, when readable
10
+ // X-Repository-Branch the checked-out branch of the local folder, when on
11
+ // one (not detached), percent-encoded
12
+ //
13
+ // All values come ONLY from fleet's resolved anchor, never from tool input.
14
+ import { execFileSync } from 'node:child_process';
15
+ import path from 'node:path';
16
+ import { gitExecutable } from '../../os/git-executable.js';
17
+ export const REPOSITORY_HEADER = 'X-Repository';
18
+ export const REPOSITORY_COMMIT_HEADER = 'X-Repository-Commit';
19
+ export const REPOSITORY_BRANCH_HEADER = 'X-Repository-Branch';
20
+ /** Longest X-Repository-Branch value (after percent-encoding) that is sent. */
21
+ export const MAX_BRANCH_LENGTH = 255;
22
+ /** Longest X-Repository value a receiving server accepts. */
23
+ export const MAX_REPOSITORY_LENGTH = 512;
24
+ const AZURE_HOST = 'dev.azure.com';
25
+ const VISUALSTUDIO_SUFFIX = '.visualstudio.com';
26
+ const URL_SCHEMES = new Set(['http', 'https', 'ssh', 'git', 'git+ssh', 'ssh+git']);
27
+ const HOSTNAME = /^(?:[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?|\[[0-9a-f:.]+\])$/;
28
+ /**
29
+ * Normalise a git remote URL to `host/path`: no scheme, no user info or
30
+ * credentials, no port, no query or fragment, no trailing `.git` or `/`. The
31
+ * host is lowercased; the path keeps its case. ssh forms (`git@host:org/repo`,
32
+ * `ssh://git@host/org/repo`) map to the same value as https. Azure DevOps
33
+ * spellings fold to `dev.azure.com/<org>/<project>/_git/<repo>` (org
34
+ * lowercased), as the receiving server canonicalises them. Characters outside
35
+ * printable ASCII (space, non-ASCII) are percent-encoded.
36
+ *
37
+ * Returns undefined for anything that is not a network remote (a local path, a
38
+ * file:// URL) or that would not be a valid header value.
39
+ */
40
+ export function normaliseRepositoryRemote(remoteUrl) {
41
+ const raw = remoteUrl.trim();
42
+ if (!raw || raw.includes('\\'))
43
+ return undefined;
44
+ let hostPart;
45
+ let pathPart;
46
+ const scheme = /^([a-zA-Z][a-zA-Z0-9+.-]*):\/\/(.*)$/.exec(raw);
47
+ if (scheme) {
48
+ if (!URL_SCHEMES.has(scheme[1].toLowerCase()))
49
+ return undefined;
50
+ const rest = scheme[2];
51
+ const slash = rest.indexOf('/');
52
+ const authority = slash < 0 ? rest : rest.slice(0, slash);
53
+ pathPart = slash < 0 ? '' : rest.slice(slash + 1);
54
+ // Drop user info (and any credentials in it): everything up to the LAST '@'
55
+ // of the authority, then the port.
56
+ hostPart = authority.slice(authority.lastIndexOf('@') + 1).replace(/:\d*$/, '');
57
+ }
58
+ else {
59
+ // scp-like form: [user@]host:path. A single-letter "host" is a Windows
60
+ // drive (C:/x), and a path with no ':' before its first '/' is local.
61
+ const scp = /^(?:[^@/]*@)?([^@/:]+):(.*)$/.exec(raw);
62
+ if (!scp || scp[1].length < 2)
63
+ return undefined;
64
+ hostPart = scp[1];
65
+ pathPart = scp[2];
66
+ }
67
+ // Real userinfo sits in the authority and is already stripped. An '@' still in
68
+ // the path means the parser misread credentials as the host (a password with a
69
+ // numeric prefix and a '/', e.g. `https://u:1234/pw@host/o/r` turns `u:1234`
70
+ // into host `u` and a port). Checked before the query/fragment strip so a
71
+ // `#`/`?` in such a password cannot hide the '@'. Send no header.
72
+ if (pathPart.includes('@'))
73
+ return undefined;
74
+ // Query and fragment never identify a repository and can carry tokens.
75
+ pathPart = pathPart.replace(/[?#].*$/, '');
76
+ const host = hostPart.toLowerCase();
77
+ const repoPath = pathPart
78
+ .replace(/^\/+/, '')
79
+ .replace(/\/+$/, '')
80
+ .replace(/\.git$/i, '')
81
+ .replace(/\/+$/, '');
82
+ // The host must be a hostname or a bracketed IPv6 literal. Anything else (a
83
+ // password containing '/', a query before the path, a non-numeric port) means
84
+ // the authority was not parsed as the remote intended, and what is left could
85
+ // carry credentials or tokens: send no header rather than a leaking one.
86
+ if (!repoPath || !HOSTNAME.test(host))
87
+ return undefined;
88
+ const value = canonicaliseAzure(percentEncode(`${host}/${repoPath}`));
89
+ return isValidRepositoryValue(value) ? value : undefined;
90
+ }
91
+ /**
92
+ * True when `value` is a header value a receiving server accepts: at most 512
93
+ * printable ASCII characters, no spaces, no scheme, no '@' before the first '/'.
94
+ */
95
+ export function isValidRepositoryValue(value) {
96
+ if (value.length === 0 || value.length > MAX_REPOSITORY_LENGTH)
97
+ return false;
98
+ if (!/^[!-~]+$/.test(value) || value.includes('://'))
99
+ return false;
100
+ const at = value.indexOf('@');
101
+ const slash = value.indexOf('/');
102
+ return slash > 0 && (at < 0 || slash < at);
103
+ }
104
+ function percentEncode(value) {
105
+ let out = '';
106
+ for (const ch of value) {
107
+ out += /^[!-~]$/.test(ch)
108
+ ? ch
109
+ : Array.from(Buffer.from(ch, 'utf8'), b => `%${b.toString(16).toUpperCase().padStart(2, '0')}`).join('');
110
+ }
111
+ return out;
112
+ }
113
+ function azureKey(org, project, repo) {
114
+ return `${AZURE_HOST}/${org.toLowerCase()}/${project}/_git/${repo}`;
115
+ }
116
+ const eq = (a, b) => a.toLowerCase() === b.toLowerCase();
117
+ // Mirrors the receiving server's canonicalisation of Azure DevOps spellings,
118
+ // so fleet sends the canonical key rather than relying on the server to fold it.
119
+ function canonicaliseAzure(value) {
120
+ const segments = value.split('/');
121
+ if (segments.some(s => s.length === 0))
122
+ return value;
123
+ const host = segments[0];
124
+ // ssh.dev.azure.com/v3/<org>/<project>/<repo>, vs-ssh.visualstudio.com/v3/...
125
+ if ((host === 'ssh.dev.azure.com' || host === 'vs-ssh.visualstudio.com')
126
+ && segments.length === 5 && eq(segments[1], 'v3')) {
127
+ return azureKey(segments[2], segments[3], segments[4]);
128
+ }
129
+ // dev.azure.com/<org>/<project>/_git/<repo>
130
+ if (host === AZURE_HOST && segments.length === 5 && eq(segments[3], '_git')) {
131
+ return azureKey(segments[1], segments[2], segments[4]);
132
+ }
133
+ if (host.endsWith(VISUALSTUDIO_SUFFIX) && host.length > VISUALSTUDIO_SUFFIX.length) {
134
+ const org = host.slice(0, -VISUALSTUDIO_SUFFIX.length);
135
+ // <org>.visualstudio.com/<project>/_git/<repo>
136
+ if (segments.length === 4 && eq(segments[2], '_git')) {
137
+ return azureKey(org, segments[1], segments[3]);
138
+ }
139
+ // <org>.visualstudio.com/DefaultCollection/<project>/_git/<repo>
140
+ if (segments.length === 5 && eq(segments[1], 'DefaultCollection') && eq(segments[3], '_git')) {
141
+ return azureKey(org, segments[2], segments[4]);
142
+ }
143
+ }
144
+ return value;
145
+ }
146
+ function gitOut(folder, args) {
147
+ // Same ceiling as resolveProjectSlug / kb-self: the folder itself must be the
148
+ // repository, never a checkout it merely sits inside.
149
+ const env = { ...process.env, GIT_CEILING_DIRECTORIES: path.dirname(folder) };
150
+ try {
151
+ return execFileSync(gitExecutable(), args, {
152
+ cwd: folder, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
153
+ }).trim();
154
+ }
155
+ catch {
156
+ return undefined;
157
+ }
158
+ }
159
+ /** A full SHA-1 or SHA-256 commit id, lowercase. */
160
+ export const COMMIT_SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
161
+ /** How long a read HEAD sha is reused before git is asked again. */
162
+ export const HEAD_COMMIT_TTL_MS = 5000;
163
+ /**
164
+ * A reader for the HEAD sha of a local folder, cached for `ttlMs` so it is not
165
+ * re-read on every request. Returns undefined (never throws) when the folder
166
+ * is not a git repository or HEAD cannot be resolved (unborn branch).
167
+ */
168
+ export function headCommitReader(folder, ttlMs = HEAD_COMMIT_TTL_MS) {
169
+ let cached;
170
+ return () => {
171
+ const now = Date.now();
172
+ if (cached && now - cached.at < ttlMs)
173
+ return cached.value;
174
+ const sha = gitOut(folder, ['rev-parse', '--verify', '--quiet', 'HEAD^{commit}'])?.toLowerCase();
175
+ cached = { value: sha && COMMIT_SHA.test(sha) ? sha : undefined, at: now };
176
+ return cached.value;
177
+ };
178
+ }
179
+ const BRANCH_REF_PREFIX = 'refs/heads/';
180
+ /**
181
+ * True when `value` is an X-Repository-Branch value that may be sent: 1-255
182
+ * printable ASCII characters, no spaces.
183
+ */
184
+ export function isValidBranchValue(value) {
185
+ return value.length > 0 && value.length <= MAX_BRANCH_LENGTH && /^[!-~]+$/.test(value);
186
+ }
187
+ /**
188
+ * The header value for a branch name: characters outside printable ASCII
189
+ * (non-ASCII, control, space) percent-encoded as UTF-8. Undefined when the
190
+ * result is empty or longer than MAX_BRANCH_LENGTH.
191
+ */
192
+ export function branchHeaderValue(branch) {
193
+ const value = percentEncode(branch);
194
+ return isValidBranchValue(value) ? value : undefined;
195
+ }
196
+ /**
197
+ * A reader for the checked-out branch of a local folder (`git symbolic-ref
198
+ * --quiet HEAD`, with `refs/heads/` stripped), cached for `ttlMs` like
199
+ * headCommitReader so a branch switch shows within one TTL. `--short` is not
200
+ * used: it prints `heads/x` when a tag `x` also exists. Returns the header value
201
+ * (see branchHeaderValue), or undefined (never throws) on a detached HEAD, a HEAD
202
+ * not under refs/heads/, a folder that is not a git repository, a git failure or
203
+ * timeout, or an invalid value.
204
+ */
205
+ export function headBranchReader(folder, ttlMs = HEAD_COMMIT_TTL_MS) {
206
+ let cached;
207
+ return () => {
208
+ const now = Date.now();
209
+ if (cached && now - cached.at < ttlMs)
210
+ return cached.value;
211
+ const ref = gitOut(folder, ['symbolic-ref', '--quiet', 'HEAD']);
212
+ const branch = ref?.startsWith(BRANCH_REF_PREFIX) ? ref.slice(BRANCH_REF_PREFIX.length) : undefined;
213
+ cached = { value: branch ? branchHeaderValue(branch) : undefined, at: now };
214
+ return cached.value;
215
+ };
216
+ }
217
+ /**
218
+ * The repository identity for a resolved KB anchor, or undefined when there is
219
+ * none. `remoteUrl` is set only when the folder lives on another host: then
220
+ * the identity is that remote and the commit and branch are unknown (git
221
+ * cannot run there). Otherwise the identity is the local folder's origin
222
+ * remote, the commit is its HEAD and the branch its checked-out branch.
223
+ */
224
+ export function resolveRepositoryIdentity(folder, remoteUrl) {
225
+ if (remoteUrl && remoteUrl.trim()) {
226
+ const remote = normaliseRepositoryRemote(remoteUrl);
227
+ return remote ? { remote } : undefined;
228
+ }
229
+ const origin = gitOut(folder, ['remote', 'get-url', 'origin']);
230
+ const remote = origin ? normaliseRepositoryRemote(origin) : undefined;
231
+ return remote ? { remote, commitOf: headCommitReader(folder), branchOf: headBranchReader(folder) } : undefined;
232
+ }
233
+ //# sourceMappingURL=repository-header.js.map
@@ -11,7 +11,7 @@ export declare function isSqliteProject(provider: MemoryProvider): provider is S
11
11
  /**
12
12
  * Narrows a project KB provider to SqliteProvider, for call sites that use
13
13
  * SqliteProvider-only capabilities not part of the MemoryProvider interface
14
- * (list, feedback, freshnessSweep, reconcilePrefilter, resolveContradiction,
14
+ * (list, freshnessSweep, reconcilePrefilter, resolveContradiction,
15
15
  * hasEntry, the DirectiveProvider methods, and capture's second CaptureOpts
16
16
  * argument).
17
17
  *
@@ -12,7 +12,7 @@ export function isSqliteProject(provider) {
12
12
  /**
13
13
  * Narrows a project KB provider to SqliteProvider, for call sites that use
14
14
  * SqliteProvider-only capabilities not part of the MemoryProvider interface
15
- * (list, feedback, freshnessSweep, reconcilePrefilter, resolveContradiction,
15
+ * (list, freshnessSweep, reconcilePrefilter, resolveContradiction,
16
16
  * hasEntry, the DirectiveProvider methods, and capture's second CaptureOpts
17
17
  * argument).
18
18
  *
@@ -1,4 +1,10 @@
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';
3
+ /**
4
+ * The reason recorded when a demotion arrives through the committed project
5
+ * bible rather than a local kb_demote. Must clear MIN_DEMOTE_REASON_LENGTH.
6
+ */
7
+ export declare const BIBLE_DEMOTION_REASON = "demoted in the project bible";
2
8
  export declare class SqliteProvider implements MemoryProvider {
3
9
  private db;
4
10
  readonly dbPath: string;
@@ -10,9 +16,25 @@ export declare class SqliteProvider implements MemoryProvider {
10
16
  * repo-blindness failure class of apra-fleet-tm7. Undefined for the single
11
17
  * shared global KB, which spans every repo and has no one root.
12
18
  */
13
- readonly repoPath: string | undefined;
19
+ repoPath: string | undefined;
14
20
  constructor(dbPath?: string, repoPath?: string);
21
+ /**
22
+ * Re-anchor after loading. Used only by the remote member bible view: the
23
+ * member's checkout is not on this host, so entries are imported with no
24
+ * anchor (the basis gate cannot check files here), then the remote folder is
25
+ * bound so freshness reads treat the anchor as missing and issue no verdict.
26
+ */
27
+ bindRepoPath(repoPath: string | undefined): void;
15
28
  init(): Promise<void>;
29
+ /**
30
+ * Record `blobId` (a git object id of a bible's bytes) as written or
31
+ * imported by the maintainer side. Idempotent: re-recording keeps the first
32
+ * row. Only trusted callers (kb_bible_commit and kb_import from a FULL or
33
+ * kb_maintainer session) may call this.
34
+ */
35
+ recordTrustedBibleBlob(blobId: string, source: 'kb_bible_commit' | 'kb_import'): void;
36
+ /** True when `blobId` was recorded by recordTrustedBibleBlob. */
37
+ isTrustedBibleBlob(blobId: string): boolean;
16
38
  private getDb;
17
39
  private rowToEntry;
18
40
  private insertEntry;
@@ -60,11 +82,77 @@ export declare class SqliteProvider implements MemoryProvider {
60
82
  * entry while unexpected failures still propagate.
61
83
  */
62
84
  private assertCheckableBasis;
85
+ /**
86
+ * The ONLY way this provider hashes source files: relative paths anchor at
87
+ * the provider repo (never process.cwd()) when one is set. Every call site
88
+ * goes through here so a new call cannot forget the anchor.
89
+ */
90
+ private hashAnchored;
63
91
  private computeSourceFileHashes;
64
92
  private static readonly FEEDBACK_MARKER_RE;
65
93
  private freshnessRevivable;
66
94
  private basisFullyMatches;
67
95
  private parseBasis;
96
+ /**
97
+ * Read-only accessor for the stored per-file hash basis (source_file_hashes)
98
+ * of the given entry ids. Each requested id maps to its parsed basis, or null
99
+ * when the basis is empty/unparseable or the id is unknown. Used by kb_export's
100
+ * project-scope bible filter and kb_bible_commit admission; internal to this
101
+ * provider, not an MCP surface. A local freshness-only basis
102
+ * (local_basis_only = 1, a legacy bible import) maps to null: it was hashed
103
+ * from this clone, never verified, so it must never be exported or admit an
104
+ * entry to the bible.
105
+ */
106
+ getSourceFileBases(ids: string[]): Map<string, Record<string, string> | null>;
107
+ /**
108
+ * The bible trust time of each given id that exists: when this clone's trust
109
+ * in the row dates from, as a bible records it. promoted_at when the row was
110
+ * promoted here; else the updated_at the bible carried when the row was
111
+ * imported (bible_updated_at); else null for an imported row from before that
112
+ * column existed -- its trust came from a bible, and the local import time
113
+ * says nothing about when it was promoted. Any other row falls back to
114
+ * created_at. An unknown id is absent from the map. Fed to
115
+ * standingAgainstTombstone (bible-import.ts) by kb_export, and used for the
116
+ * updated_at a bible writer records, so every clone compares the same value.
117
+ * Internal to this provider, not an MCP surface.
118
+ */
119
+ getBibleTrustTimes(ids: string[]): Map<string, string | null>;
120
+ /** getBibleTrustTimes' rule for one raw row (needs promoted_at, bible_updated_at, source, created_at). */
121
+ private bibleTrustTimeOf;
122
+ /**
123
+ * Read-only accessor for the demotion state of the given entry ids: the
124
+ * CURRENT confidence and demoted_at of each id that exists. An unknown id is
125
+ * simply absent from the map.
126
+ *
127
+ * Deliberately NOT routed through list(): list() excludes stale and superseded
128
+ * rows, and a demoted entry that later went stale is exactly the one whose
129
+ * tombstone other clones most need -- their bible still carries the entry.
130
+ * Policy (what counts as demoted enough to tombstone) lives in the caller
131
+ * (src/tools/kb-bible-commit.ts); this member only reports the two columns.
132
+ * Internal to this provider, not an MCP surface.
133
+ */
134
+ getDemotionState(ids: string[]): Map<string, {
135
+ confidence: Confidence;
136
+ demoted_at?: string;
137
+ }>;
138
+ /**
139
+ * For each of the given ids that EXISTS locally, whether that row is LIVE
140
+ * CONFIRMED: confidence is CONFIRMED and the row is not stale, not superseded
141
+ * and not flagged_for_review.
142
+ *
143
+ * An id with NO local row is simply ABSENT from the map -- the caller must be
144
+ * able to tell "I hold a row and it is no longer trustworthy" (do not surface
145
+ * the bible's version of it) from "I have never seen this id" (the cold-seed
146
+ * case the bible exists to serve). A boolean-only return would conflate them.
147
+ *
148
+ * ONE predicate, deliberately not a demoted_at check. A demotion is only one
149
+ * of the ways a row stops being live CONFIRMED; staleness, supersession and a
150
+ * review flag are the others, and a cold seed that re-surfaced the bible's
151
+ * CONFIRMED copy of any of them would be re-asserting knowledge this clone has
152
+ * already stopped trusting. Reads the rows DIRECTLY rather than through list(),
153
+ * which filters stale and superseded rows out and so cannot report them.
154
+ */
155
+ getLiveConfirmedState(ids: string[]): Map<string, boolean>;
68
156
  private checkFreshness;
69
157
  freshnessSweep(root?: string): Promise<{
70
158
  checked: number;
@@ -86,33 +174,167 @@ export declare class SqliteProvider implements MemoryProvider {
86
174
  */
87
175
  private decayConceptEntries;
88
176
  private wireLinks;
89
- capture(input: KBEntryInput, opts?: CaptureOpts): Promise<{
90
- id: string;
91
- audn_decision: AudnDecision;
92
- }>;
177
+ capture(input: KBEntryInput, opts?: CaptureOpts): Promise<CaptureResult>;
93
178
  hasEntry(id: string): boolean;
94
179
  touch(ids: string[]): Promise<number>;
95
180
  query(opts: QueryOptions): Promise<KBResult>;
96
- context(files: string[]): Promise<FileContextResult[]>;
97
- invalidate(files: string[]): Promise<{
181
+ context(files: string[], confidence?: Confidence[], excludeDisputed?: boolean, ownerTag?: string): Promise<FileContextResult[]>;
182
+ discard(ids: string[], opts?: RetireOptions): Promise<DiscardResult>;
183
+ /**
184
+ * For each id this KB holds as RETIRED, why: 'superseded' or 'invalidated'.
185
+ * Ids that are unknown, or known and not retired, are absent from the map.
186
+ *
187
+ * Retired means superseded_at is set (reason from retired_reason; NULL, a
188
+ * row retired before that column existed, counts as 'superseded'), or
189
+ * content_hash = 'invalidated' (kb_invalidate by file) -> 'invalidated'.
190
+ *
191
+ * A merely STALE row (stale = 1 from the freshness sweep, superseded_at
192
+ * NULL, content_hash not 'invalidated') is NOT retired: staleness means the
193
+ * cited files moved, which the next capture or sweep can clear, while
194
+ * superseded and invalidated are explicit curation decisions. Only those two
195
+ * remove an entry from the bible (kb_bible_commit).
196
+ */
197
+ getRetirementReasons(ids: string[]): Map<string, 'superseded' | 'invalidated'>;
198
+ invalidate(files: string[], opts?: RetireOptions): Promise<{
98
199
  invalidated: number;
200
+ refused?: string[];
99
201
  }>;
100
202
  getLinked(id: string): Promise<KBEntry[]>;
101
- relatedClaims(ids: string[], limit?: number): Promise<KBEntry[]>;
203
+ relatedClaims(ids: string[], limit?: number, filter?: EntryTrustFilter): Promise<KBEntry[]>;
102
204
  prime(opts: PrimeOptions): Promise<PrimedContext>;
103
205
  list(opts: {
104
- confidence?: Confidence;
206
+ confidence?: Confidence[];
105
207
  type?: KBEntry['type'];
106
208
  module?: string;
107
209
  symbol?: string;
108
210
  tag?: string;
109
211
  limit?: number;
212
+ exclude_disputed?: boolean;
213
+ /** MEMBER own-scope: only entries tagged with this value (ANDed with `tag`). */
214
+ owner_tag?: string;
215
+ /** Also list stale entries (kb_list never sets it; the kb-server ownership lookup does). */
216
+ include_stale?: boolean;
110
217
  }): Promise<KBEntry[]>;
111
- promote(id: string, reason?: string): Promise<{
218
+ promote(id: string, reason?: string, opts?: {
219
+ ownerTag?: string;
220
+ }): Promise<{
112
221
  id: string;
113
222
  confidence_before: Confidence;
114
223
  confidence_after: Confidence;
115
224
  }>;
225
+ /**
226
+ * Evidence paths cited by a demote. Deliberately STRICTER than the basis
227
+ * check promote() runs: a demote reason is an audit record, so a path that
228
+ * cannot be pointed at inside this provider's anchor is refused rather than
229
+ * recorded as an unverifiable string.
230
+ *
231
+ * Refuses, all with E-DEMOTE-EVIDENCE-UNRESOLVED:
232
+ * - any path that is not anchor-relative -- an ABSOLUTE path, or one with
233
+ * a '..' segment. Both are "out of the anchor": an absolute path names a
234
+ * location the anchor does not contain, and was previously accepted and
235
+ * recorded verbatim, which contradicted this very comment. The check is
236
+ * delegated to validateFilePaths (path-validation.ts), the SAME guard
237
+ * every other caller-supplied kb_* file list already runs (kb_capture,
238
+ * kb_context, kb_invalidate, kb_session_prime and the HTTP routes), so
239
+ * this is not a third hand-rolled path guard. It runs BEFORE existence,
240
+ * so a path that happens to land on a real file outside the repo is
241
+ * still refused, and it applies even on the shared-global no-anchor KB,
242
+ * where nothing absolute could be verified against an anchor anyway;
243
+ * - a path that does not resolve, via the SAME resolver promote uses
244
+ * (unresolvableBasisFiles -> resolveBasisFile);
245
+ * - a path that resolves to something that is not a regular file
246
+ * (directories are not evidence).
247
+ */
248
+ private assertResolvableDemoteEvidence;
249
+ /**
250
+ * The demote-time basis snapshot: sha256 of each cited source file AS IT IS
251
+ * ON DISK RIGHT NOW, keyed by the original (unresolved) path string, the
252
+ * same key convention source_file_hashes uses.
253
+ *
254
+ * This MUST NOT be derived from the source_file_hashes column. That column
255
+ * is the CAPTURE-time basis; copying it was the defect in the superseded
256
+ * upstream attempt, and it silently breaks the ping-pong guard that asks
257
+ * whether the tree has moved on SINCE the demotion. Files that cannot be
258
+ * read are simply absent from the map (a demote is still allowed on an
259
+ * entry whose basis has since disappeared -- unlike promote, which refuses).
260
+ *
261
+ * sha256 and not `git hash-object`: this snapshot is compared against a
262
+ * later re-read of the same files by the same code, so it must not depend on
263
+ * git being available or on the file being in a work tree.
264
+ */
265
+ private demoteBasisHashes;
266
+ /**
267
+ * kb_demote: withdraw trust from a CONFIRMED entry, CONFIRMED -> INFERRED.
268
+ *
269
+ * The inverse of promote() in intent but NOT its mirror image in mechanics:
270
+ *
271
+ * - it is NOT a ladder. Only CONFIRMED is demotable; INFERRED/UNVERIFIED
272
+ * are REFUSED (E-DEMOTE-NOT-CONFIRMED), never silently returned as a
273
+ * no-op, so a caller can never believe it lowered trust that was already
274
+ * at the floor;
275
+ * - promoted_at and source are left untouched. promote() stamps
276
+ * source='promotion'; a demotion must not erase the provenance of the
277
+ * promotion it is reversing, and promoted_at stays as the record of when
278
+ * the (now withdrawn) trust was granted;
279
+ * - a STALE entry MAY be demoted. Staleness is a freshness verdict, trust
280
+ * is a separate axis, and the entries most worth demoting are exactly the
281
+ * ones the sweep has already flagged;
282
+ * - evidence is REQUIRED, like promote's resolvable basis: at least one
283
+ * evidence file, each of which must resolve inside the anchor
284
+ * (E-DEMOTE-EVIDENCE-UNRESOLVED otherwise).
285
+ *
286
+ * EVERY refusal is checked BEFORE any write, in the order below, and the
287
+ * order is load-bearing: the own-scope/unknown-id check comes first so a
288
+ * member can never learn that an entry it does not own exists by probing for
289
+ * a different refusal message.
290
+ */
291
+ demote(id: string, reason: string, evidenceFiles: string[], opts?: {
292
+ ownerTag?: string;
293
+ }): Promise<{
294
+ id: string;
295
+ confidence_before: Confidence;
296
+ confidence_after: Confidence;
297
+ }>;
298
+ /**
299
+ * Apply ONE explicit demotion tombstone from a committed project bible to the
300
+ * local row, so a demotion recorded on another clone actually lands here.
301
+ *
302
+ * Returns true only when a row was written. Every "no" is a silent false, not
303
+ * a throw: a bible carries tombstones for the whole project and most clones
304
+ * hold only some of those ids, so an inapplicable tombstone is the normal
305
+ * case, not an error.
306
+ *
307
+ * The rules, each of which silently corrupts another clone's KB if got wrong:
308
+ *
309
+ * - NEVER CREATE. A tombstoned id with no local row stays absent. A
310
+ * tombstone withdraws trust in a row; it is not a way to author one.
311
+ * - ONE RE-PROMOTION RULE. Demote only when standingAgainstTombstone
312
+ * (bible-import.ts) says 'withdrawn' for the row's bible trust time
313
+ * (getBibleTrustTimes): promoted_at, else the updated_at the bible carried
314
+ * at import -- never the local import time. kb_export uses the same rule to
315
+ * decide whether to re-add a tombstoned entry, so the two never disagree.
316
+ * - demoted_at is stamped with the TOMBSTONE's value, not now(): it records
317
+ * when trust was withdrawn, which happened on the other clone. That value
318
+ * is clamped to now (clampBibleTimeToNow), so a future-dated tombstone
319
+ * never stores a demoted_at that every later re-promotion falls before.
320
+ * - NO ownerTag CHECK. Bible-imported rows carry no member tag (see
321
+ * importBibleEntries, which builds its input with tags: [] and author
322
+ * 'unknown'), so an owner check here would make every imported row
323
+ * permanently undemotable. The trust boundary for this path is the
324
+ * git-reviewed bible file, not entry ownership.
325
+ *
326
+ * ABSENCE IS NEVER A DEMOTION: this method is only ever called for an id that
327
+ * carries an EXPLICIT tombstone. A local CONFIRMED row merely missing from the
328
+ * bible (a local-only promotion, or one refused by the basis filter) is never
329
+ * passed here and must stay untouched.
330
+ *
331
+ * Two refusals are inherited from demote() because they are invariants of the
332
+ * store, not of the local/remote distinction: a superseded row is already out
333
+ * of every read path (the write would have no observable meaning), and a
334
+ * user-directive is human-terminal in both directions -- a bible must not be
335
+ * able to deactivate a directive a human set here.
336
+ */
337
+ applyBibleDemotion(id: string, tombstoneAt: string): boolean;
116
338
  feedback(id: string, reason: string, author: string): Promise<KBEntry>;
117
339
  flaggedPairs(): Promise<{
118
340
  original: KBEntry;