@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
@@ -1,12 +1,16 @@
1
1
  import { z } from 'zod';
2
+ import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
2
3
  import fs from 'node:fs';
3
4
  import path from 'node:path';
4
5
  import { execFileSync } from 'node:child_process';
5
6
  import { getKbProviders } from '../services/knowledge/kb-providers.js';
6
- import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
7
+ import { resolveKbAnchor } from '../services/knowledge/kb-self.js';
7
8
  import { logWarn } from '../utils/log-helpers.js';
8
9
  import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
9
10
  import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
11
+ import { filterProjectBibleCandidates } from '../services/knowledge/bible-basis-filter.js';
12
+ import { extractBibleDemotions, standingAgainstTombstone } from '../services/knowledge/bible-import.js';
13
+ import { gitExecutable } from '../os/git-executable.js';
10
14
  // T3.4 (F8b, D8): export half of the shareable, diffable team bible. Writes
11
15
  // all CONFIRMED, non-superseded, non-stale project entries to
12
16
  // <repo>/.fleet/kb-canonical.json. Registered as a real MCP tool (not just an
@@ -18,15 +22,11 @@ import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
18
22
  // discretion: the export TOOL commits with its own dedicated identity
19
23
  // (pm-kb), so no role's "no git operations" rule is violated by this
20
24
  // automatic side effect.
21
- // F4 (T1.6): repo path resolution precedence -- (1) explicit repo_path input,
22
- // validated (must exist and be a directory) or kb_export refuses with a clear
23
- // error; (2) validated session context -- this process's own working
24
- // directory, used ONLY when repo_path is omitted, and put through the exact
25
- // same existence + isDirectory check as an explicit path, never trusted
26
- // blindly; (3) neither validates -- kb_export refuses with a clear error
27
- // rather than silently writing relative to an arbitrary path. There is no
28
- // bare process.cwd() fallback: the fallback tier is validated the same way
29
- // explicit input is.
25
+ // kb (self): the repo written to is the calling session's own folder -- the
26
+ // member's registered work folder for a member session, the server's working
27
+ // folder otherwise (src/services/knowledge/kb-self.ts). It is validated (must
28
+ // exist, be a git repo with an origin remote) or kb_export refuses with a
29
+ // typed E-SELF error; it is never a scope argument.
30
30
  // T3.3 (F9a, D8): scope param -- 'project' (default, unchanged behavior) reads
31
31
  // the PROJECT KB and writes .fleet/kb-canonical.json (as before); 'global'
32
32
  // reads the GLOBAL KB (providers.global -- the shared kb.sqlite at
@@ -35,13 +35,129 @@ import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
35
35
  // apra-fleet platform repo, committed there per D8). Same stable field set,
36
36
  // same asciiSafeStringify + deterministic id-sorted output, and the same
37
37
  // auto-commit behavior (T2.3) applies to the global file too.
38
+ // Provenance names the TARGET BASE branch: the branch the bible's entries will
39
+ // merge into, not the (typically feature) branch the export ran on. baseBranch
40
+ // and baseCommit let the caller say so explicitly; when omitted, provenance
41
+ // falls back to the export folder's own HEAD branch and commit (unchanged).
38
42
  export const kbExportSchema = z.object({
39
- ...kbScopeFields,
40
- repo_path: z.string().optional()
41
- .describe('Path to the repo root to write the canonical bible into. Precedence: this explicit input, when given, is validated (must exist and be a directory) or the call fails; when omitted, falls back to the validated session working directory (same validation, not a blind default); if neither validates, kb_export refuses with a clear error.'),
42
43
  scope: z.enum(['project', 'global']).optional()
43
- .describe('project (default, unchanged): export the project KB to .fleet/kb-canonical.json. global: export the GLOBAL KB to .fleet/kb-canonical-global.json in the given repo path (in practice the apra-fleet platform repo, committed there so the installer can distribute it -- D8).'),
44
+ .describe('project (default, unchanged): export the project KB to .fleet/kb-canonical.json. global: export the GLOBAL KB to .fleet/kb-canonical-global.json in the calling session\'s own repo (in practice the apra-fleet platform repo, committed there so the installer can distribute it -- D8).'),
45
+ baseBranch: z.string().min(1).optional()
46
+ .describe('The target base branch (the branch the entries merge into). Written to provenance.branch. Omitted: the export folder HEAD branch.'),
47
+ baseCommit: z.string().min(1).optional()
48
+ .describe('The base commit the entries were verified against. Written to provenance.commit. Omitted: the export folder HEAD commit.'),
49
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
50
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
51
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
44
52
  });
53
+ /** The bible format version every writer emits. */
54
+ export const BIBLE_FORMAT_VERSION = 3;
55
+ /** A basis map with its keys in sorted order, so serialization is byte-stable. */
56
+ function sortedBasis(basis) {
57
+ const out = {};
58
+ for (const key of Object.keys(basis).sort())
59
+ out[key] = basis[key];
60
+ return out;
61
+ }
62
+ /**
63
+ * A bible entry with `basis` attached as its source_file_hashes (keys sorted,
64
+ * copied verbatim -- never re-hashed); every other field is left as it is.
65
+ * Used by kb_bible_commit's legacy backfill.
66
+ */
67
+ export function withSourceFileHashes(entry, basis) {
68
+ return { ...entry, source_file_hashes: sortedBasis(basis) };
69
+ }
70
+ /**
71
+ * Map a KB entry to the bible's stable field set. Shared with kb_bible_commit.
72
+ * `basis` is the entry's STORED per-file hash basis (the one the bible
73
+ * predicate admitted it against); when given and non-empty it is written as
74
+ * source_file_hashes (format v3). Nothing is hashed here.
75
+ */
76
+ /**
77
+ * `trustTime` is the row's bible trust time (SqliteProvider.getBibleTrustTimes)
78
+ * when the caller has it, so an entry this clone imported keeps the updated_at
79
+ * its bible carried instead of taking the local import time. null/undefined
80
+ * falls back to promoted_at, then created_at.
81
+ */
82
+ export function toCanonicalEntry(e, basis, trustTime) {
83
+ const entry = {
84
+ id: e.id,
85
+ type: e.type,
86
+ title: e.title,
87
+ summary: e.summary,
88
+ symbols: e.symbols,
89
+ source_files: e.source_files,
90
+ confidence: e.confidence,
91
+ updated_at: trustTime || e.promoted_at || e.created_at,
92
+ };
93
+ if (basis && Object.keys(basis).length > 0)
94
+ entry.source_file_hashes = sortedBasis(basis);
95
+ return entry;
96
+ }
97
+ /**
98
+ * Duplicate-id guard shared by every bible writer: a bible is keyed by id, so
99
+ * one about to be written with two entries sharing an id is corrupt. Throws
100
+ * (naming the id) BEFORE anything is written, so the file on disk is untouched.
101
+ */
102
+ export function assertNoDuplicateBibleIds(entries, toolName) {
103
+ const seen = new Set();
104
+ for (const e of entries) {
105
+ const id = String(e.id);
106
+ if (seen.has(id)) {
107
+ throw new Error(toolName + ': refusing to write a bible with duplicate entry id ' + JSON.stringify(id)
108
+ + ' -- the bible is keyed by id; resolve the duplicate in .fleet/kb-canonical.json first');
109
+ }
110
+ seen.add(id);
111
+ }
112
+ }
113
+ /** Deterministic id ordering so re-exports produce meaningful diffs. */
114
+ export function compareById(a, b) {
115
+ return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
116
+ }
117
+ /**
118
+ * The entries of the bible already on disk, in either shape (legacy bare array
119
+ * or v2/v3 envelope). null when the file is absent or unparseable.
120
+ *
121
+ * Entries only, exactly as before: callers that do not care about tombstones are
122
+ * unchanged. readBibleDocument below is the sibling reader for callers that do.
123
+ */
124
+ export function readBibleEntries(outPath) {
125
+ return readBibleDocument(outPath)?.entries ?? null;
126
+ }
127
+ /**
128
+ * The entries AND the demotion tombstones of the bible already on disk. Same
129
+ * acceptance as readBibleEntries (both shapes; null when absent or unparseable);
130
+ * a bible with no demotions field yields an empty tombstone list, never a
131
+ * failure.
132
+ */
133
+ export function readBibleDocument(outPath) {
134
+ if (!fs.existsSync(outPath))
135
+ return null;
136
+ try {
137
+ const parsed = JSON.parse(fs.readFileSync(outPath, 'utf-8'));
138
+ const existing = Array.isArray(parsed)
139
+ ? parsed
140
+ : (parsed && Array.isArray(parsed.entries) ? parsed.entries : null);
141
+ if (existing === null)
142
+ return null;
143
+ return { entries: existing, demotions: extractBibleDemotions(parsed) };
144
+ }
145
+ catch {
146
+ return null;
147
+ }
148
+ }
149
+ /**
150
+ * PATHSPEC-ONLY commit of the bible file with the dedicated pm-kb identity:
151
+ * git add <path> then a commit scoped to -- <path>, so unrelated staged or
152
+ * dirty working-tree state is never swept in. Throws on any git failure; the
153
+ * caller decides whether that is fatal. Never pushes.
154
+ */
155
+ export function commitBiblePath(repoPath, outPath, message) {
156
+ execFileSync(gitExecutable(), ['add', outPath], {
157
+ cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true,
158
+ });
159
+ execFileSync(gitExecutable(), ['-c', 'user.name=pm-kb', '-c', 'user.email=kb@pm.local', 'commit', '-m', message, '--', outPath], { cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
160
+ }
45
161
  /**
46
162
  * Resolve HEAD, degrading gracefully to null rather than throwing: a repo with
47
163
  * no commits yet, a non-repo directory, or a machine without git must still be
@@ -80,8 +196,8 @@ function gitOrNull(repoPath, args) {
80
196
  if (!isGitRepo(repoPath))
81
197
  return null;
82
198
  try {
83
- const out = execFileSync('git', args, {
84
- cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'],
199
+ const out = execFileSync(gitExecutable(), args, {
200
+ cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
85
201
  }).trim();
86
202
  return out.length > 0 ? out : null;
87
203
  }
@@ -100,7 +216,7 @@ function gitOrNull(repoPath, args) {
100
216
  // ASCII too) and avoids template literals -- the pre-commit hook's
101
217
  // backtick-n/t/r scan false-positives on template-literal escape sequences,
102
218
  // the same gotcha T2.3's promote() fix worked around.
103
- function asciiSafeStringify(value) {
219
+ export function asciiSafeStringify(value) {
104
220
  const json = JSON.stringify(value, null, 2);
105
221
  const maxAsciiCode = 127;
106
222
  const escapePrefix = String.fromCharCode(92) + 'u'; // backslash + 'u', built at runtime
@@ -119,16 +235,14 @@ function asciiSafeStringify(value) {
119
235
  }
120
236
  return out;
121
237
  }
122
- // F4 (T1.6): shared validation for both precedence tiers -- an explicit
123
- // repo_path (tier 1) and the session working directory fallback (tier 2, used
124
- // only when repo_path is omitted) go through the identical existence +
125
- // isDirectory check. Neither tier is ever trusted without it.
126
- function resolveRepoPath(explicit) {
127
- const candidate = explicit || process.cwd();
128
- if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory()) {
129
- throw new Error('kb_export: repo_path does not exist or is not a directory: ' + candidate);
238
+ // The resolved anchor folder must exist on THIS host: kb_export writes the
239
+ // bible file there, so an anchor naming a folder on another host (a remote
240
+ // member's work folder) has nothing meaningful to do and must refuse.
241
+ export function requireLocalFolder(folder, toolName = 'kb_export') {
242
+ if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory()) {
243
+ throw new Error(toolName + ': repo folder does not exist or is not a directory on this host: ' + folder);
130
244
  }
131
- return candidate;
245
+ return folder;
132
246
  }
133
247
  function autoCommitMode() {
134
248
  try {
@@ -152,7 +266,7 @@ function autoCommitEnabled() {
152
266
  return autoCommitMode() !== 'off';
153
267
  }
154
268
  // The entry count of the bible ALREADY on disk, read before we overwrite it.
155
- // Accepts both shapes (legacy bare array, v2 envelope) like entriesUnchanged.
269
+ // Accepts every shape (legacy bare array, v2/v3 envelope) like entriesUnchanged.
156
270
  // null means "no comparable prior bible" -- absent file, or unparseable -- in
157
271
  // which case there is no shrink to detect and the export is a first write.
158
272
  function bibleEntryCount(outPath) {
@@ -173,7 +287,7 @@ function bibleEntryCount(outPath) {
173
287
  export function _autoCommitEnabledForTest() {
174
288
  return autoCommitEnabled();
175
289
  }
176
- function isGitRepo(repoPath) {
290
+ export function isGitRepo(repoPath) {
177
291
  return fs.existsSync(path.join(repoPath, '.git'));
178
292
  }
179
293
  // "Content actually changed" (D5): git status --porcelain against the exact
@@ -181,9 +295,9 @@ function isGitRepo(repoPath) {
181
295
  // already matches HEAD for this one path -- re-exporting an identical bible
182
296
  // is a no-op, so there is nothing to commit. Any output (modified, or a
183
297
  // brand-new untracked file on the very first export) means it changed.
184
- function bibleContentChanged(repoPath, outPath) {
185
- const status = execFileSync('git', ['status', '--porcelain', '--', outPath], {
186
- cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'],
298
+ export function bibleContentChanged(repoPath, outPath) {
299
+ const status = execFileSync(gitExecutable(), ['status', '--porcelain', '--', outPath], {
300
+ cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
187
301
  });
188
302
  return status.trim().length > 0;
189
303
  }
@@ -224,12 +338,9 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
224
338
  try {
225
339
  if (!bibleContentChanged(repoPath, outPath))
226
340
  return false;
227
- execFileSync('git', ['add', outPath], {
228
- cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'],
229
- });
230
341
  const scopeLabel = scope === 'global' ? 'global knowledge bible' : 'knowledge bible';
231
342
  const message = 'chore(kb): update ' + scopeLabel + ' -- ' + entryCount + ' confirmed entries';
232
- execFileSync('git', ['-c', 'user.name=pm-kb', '-c', 'user.email=kb@pm.local', 'commit', '-m', message, '--', outPath], { cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'] });
343
+ commitBiblePath(repoPath, outPath, message);
233
344
  return true;
234
345
  }
235
346
  catch (err) {
@@ -238,44 +349,138 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
238
349
  return false;
239
350
  }
240
351
  }
241
- export async function kbExport(input) {
242
- // apra-fleet-b4g.7: this is the third resolveRepoPath site, and it stays a
243
- // hard failure rather than adopting kb_session_prime/kb_stats' pass-verbatim
244
- // rule. Those two only READ through the anchor, so an unreachable remote path
245
- // can be carried honestly and suppressed by SqliteProvider.anchorIsMissing().
246
- // kb_export WRITES <repo_path>/.fleet/kb-canonical.json and git-commits it, so
247
- // an unreachable path has no meaningful behaviour left -- it must not proceed.
248
- // What matters for the shared anchor policy is that it never degrades to the
249
- // fleet server's process.cwd(): a supplied-but-invalid repo_path throws here,
250
- // before getKbProviders is reached, so no provider is ever anchored at the
251
- // server's own working directory (pinned in kb-anchor-never-cwd.test.ts).
252
- const repoPath = resolveRepoPath(input.repo_path);
352
+ // Id ordering for the additive project merge, whose existing bible entries are
353
+ // raw objects (never re-shaped) and so carry an id of unknown type.
354
+ function byId(a, b) {
355
+ const x = String(a.id);
356
+ const y = String(b.id);
357
+ return x < y ? -1 : x > y ? 1 : 0;
358
+ }
359
+ /**
360
+ * Entries of the bible already on disk, as raw objects (never re-shaped, so
361
+ * they are written back byte-for-byte equivalent). Accepts the v2/v3 envelope and
362
+ * the legacy bare array. An absent file is an empty bible. A file that exists
363
+ * but cannot be parsed as either shape THROWS: the project export is additive
364
+ * and must never overwrite (and so silently drop) a bible it cannot read.
365
+ */
366
+ function readExistingBibleDocument(outPath) {
367
+ if (!fs.existsSync(outPath))
368
+ return { entries: [], demotions: [] };
369
+ let parsed;
370
+ try {
371
+ parsed = JSON.parse(fs.readFileSync(outPath, 'utf-8'));
372
+ }
373
+ catch (err) {
374
+ throw new Error('kb_export: existing bible is not valid JSON, refusing to overwrite it: ' + outPath
375
+ + ' (' + (err instanceof Error ? err.message : String(err)) + ')');
376
+ }
377
+ const list = Array.isArray(parsed)
378
+ ? parsed
379
+ : (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries)
380
+ ? parsed.entries
381
+ : null);
382
+ if (list === null) {
383
+ throw new Error('kb_export: existing bible has no entries array, refusing to overwrite it: ' + outPath);
384
+ }
385
+ return { entries: list, demotions: extractBibleDemotions(parsed) };
386
+ }
387
+ // PROJECT-SCOPE EXPORT: basis filter + additive merge.
388
+ //
389
+ // Only CONFIRMED (non-superseded, non-stale -- list() already excludes those)
390
+ // entries whose per-file hash basis matches the files in repoPath qualify (see
391
+ // qualifiesForProjectBible in services/knowledge/bible-basis-filter.ts). A
392
+ // member-local KB routinely holds entries about files the exported tree does
393
+ // not contain; publishing them would leak them into the committed artifact.
394
+ //
395
+ // The merge is ADDITIVE: every entry already in the bible is kept exactly as it
396
+ // is (curated, possibly human-edited), qualifying entries whose id is not yet
397
+ // present are added, and on an id collision the existing bible entry wins.
398
+ // Nothing is ever removed by an export -- removal is a human (or reconcile)
399
+ // edit of the file. Consequently the project bible never shrinks through this
400
+ // path and the shrink guard in maybeAutoCommitBible only matters for global.
401
+ //
402
+ // No new id to add -> the file is not touched at all (byte-identical,
403
+ // provenance untouched) and nothing is committed.
404
+ //
405
+ // `exported` in the response is the number of entries in the bible as written
406
+ // (or as left on disk when nothing was added), not the number newly added.
407
+ async function exportProjectBible(source, repoPath, outPath, input) {
408
+ const { entries: existing, demotions } = readExistingBibleDocument(outPath);
409
+ const existingIds = new Set(existing.map(e => String(e.id)));
410
+ const tombstones = new Map(demotions.map(d => [d.id, d]));
411
+ const confirmed = await source.list({ confidence: ['CONFIRMED'] });
412
+ // TOMBSTONE GATE, before the basis filter. An id another clone demoted is not
413
+ // re-added just because this clone still holds it CONFIRMED -- that is how a
414
+ // demotion would be silently undone on the next export. The ONE exception is a
415
+ // row standingAgainstTombstone calls 'repromoted' -- the same rule kb_import
416
+ // applies -- so the entry comes back and its tombstone is cleared in the same
417
+ // write.
418
+ const notInBible = confirmed.filter(e => !existingIds.has(e.id));
419
+ const trustTimes = source.getBibleTrustTimes(notInBible.map(e => e.id));
420
+ const newCandidates = notInBible.filter(e => {
421
+ const tombstone = tombstones.get(e.id);
422
+ if (!tombstone)
423
+ return true;
424
+ return standingAgainstTombstone(trustTimes.get(e.id) ?? null, tombstone.at) === 'repromoted';
425
+ });
426
+ const bases = source.getSourceFileBases(newCandidates.map(e => e.id));
427
+ const qualifying = await filterProjectBibleCandidates(newCandidates, bases, repoPath);
428
+ if (qualifying.length === 0) {
429
+ return JSON.stringify({ exported: existing.length, path: outPath, scope: 'project', committed: false });
430
+ }
431
+ for (const e of qualifying)
432
+ tombstones.delete(e.id);
433
+ // Each added entry carries the exact stored basis it was just admitted against.
434
+ const merged = [...existing, ...qualifying.map(e => toCanonicalEntry(e, bases.get(e.id), trustTimes.get(e.id)))].sort(byId);
435
+ assertNoDuplicateBibleIds(merged, 'kb_export');
436
+ const nextDemotions = Array.from(tombstones.values()).sort(compareById);
437
+ const bible = {
438
+ version: BIBLE_FORMAT_VERSION,
439
+ provenance: {
440
+ commit: input.baseCommit ?? resolveHeadCommit(repoPath),
441
+ branch: input.baseBranch ?? resolveBranch(repoPath),
442
+ // Entries only: the tombstones below are deliberately not counted.
443
+ entry_count: merged.length,
444
+ },
445
+ entries: merged,
446
+ // Omitted entirely when there are none, so a bible that never saw a
447
+ // demotion is byte-identical to one written before the field existed.
448
+ ...(nextDemotions.length > 0 ? { demotions: nextDemotions } : {}),
449
+ };
450
+ const fleetDir = path.dirname(outPath);
451
+ if (!fs.existsSync(fleetDir))
452
+ fs.mkdirSync(fleetDir, { recursive: true });
453
+ const previousEntryCount = bibleEntryCount(outPath);
454
+ fs.writeFileSync(outPath, asciiSafeStringify(bible) + '\n', 'utf-8');
455
+ const committed = maybeAutoCommitBible(repoPath, outPath, merged.length, 'project', previousEntryCount);
456
+ return JSON.stringify({ exported: merged.length, path: outPath, scope: 'project', committed });
457
+ }
458
+ export async function kbExport(input, anchor) {
459
+ // kb_export WRITES <folder>/.fleet/kb-canonical.json and git-commits it, so
460
+ // an unreachable folder has no meaningful behaviour left -- it must not
461
+ // proceed. An invalid anchor throws here, before getKbProviders is reached,
462
+ // so no provider is ever anchored somewhere the caller did not mean.
463
+ const resolved = resolveKbAnchor(anchor);
464
+ const repoPath = requireLocalFolder(resolved.folder);
253
465
  const scope = input.scope ?? 'project';
254
466
  // Read from the SAME repo we are about to write the bible into. Resolving the
255
467
  // source from process cwd while writing to repoPath is how repo A's entries
256
468
  // used to end up serialised into repo B's committed bible.
257
- const providers = await getKbProviders(repoPath, input.repo_remote_url);
258
- const source = scope === 'global' ? providers.global : requireSqliteProject(providers.project, 'kb_export');
259
- const entries = await source.list({ confidence: 'CONFIRMED' });
469
+ const providers = await getKbProviders(repoPath, resolved.remoteUrl);
470
+ const fleetDir = path.join(repoPath, '.fleet');
471
+ const fileName = scope === 'global' ? 'kb-canonical-global.json' : 'kb-canonical.json';
472
+ const outPath = path.join(fleetDir, fileName);
473
+ if (scope === 'project') {
474
+ return exportProjectBible(requireSqliteProject(providers.project, 'kb_export'), repoPath, outPath, input);
475
+ }
476
+ const entries = await providers.global.list({ confidence: ['CONFIRMED'] });
260
477
  // Deterministic ordering by id so re-exports produce meaningful diffs.
261
478
  const canonical = entries
262
- .map(e => ({
263
- id: e.id,
264
- type: e.type,
265
- title: e.title,
266
- summary: e.summary,
267
- symbols: e.symbols,
268
- source_files: e.source_files,
269
- confidence: e.confidence,
270
- updated_at: e.promoted_at || e.created_at,
271
- }))
272
- .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
273
- const fleetDir = path.join(repoPath, '.fleet');
479
+ .map(e => toCanonicalEntry(e))
480
+ .sort(compareById);
274
481
  if (!fs.existsSync(fleetDir)) {
275
482
  fs.mkdirSync(fleetDir, { recursive: true });
276
483
  }
277
- const fileName = scope === 'global' ? 'kb-canonical-global.json' : 'kb-canonical.json';
278
- const outPath = path.join(fleetDir, fileName);
279
484
  // KB-TRUST PHASE 3a: the bible records the commit it was exported from, so a
280
485
  // later audit can date its entries against the tree they were verified on.
281
486
  // Before this, a bible harvested from other repositories was indistinguishable
@@ -296,15 +501,16 @@ export async function kbExport(input) {
296
501
  // exists to avoid. When the entry set is unchanged the file is left exactly as
297
502
  // it is, which also keeps the recorded commit honest: it names the tree those
298
503
  // entries were last verified against, not the commit that stored them.
504
+ assertNoDuplicateBibleIds(canonical, 'kb_export');
299
505
  const nextEntriesJson = asciiSafeStringify(canonical);
300
506
  if (entriesUnchanged(outPath, nextEntriesJson)) {
301
507
  return JSON.stringify({ exported: canonical.length, path: outPath, scope, committed: false });
302
508
  }
303
509
  const bible = {
304
- version: 2,
510
+ version: BIBLE_FORMAT_VERSION,
305
511
  provenance: {
306
- commit: resolveHeadCommit(repoPath),
307
- branch: resolveBranch(repoPath),
512
+ commit: input.baseCommit ?? resolveHeadCommit(repoPath),
513
+ branch: input.baseBranch ?? resolveBranch(repoPath),
308
514
  entry_count: canonical.length,
309
515
  },
310
516
  entries: canonical,
@@ -1,23 +1,29 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
3
+ import type { Author } from '../services/knowledge/types.js';
4
+ export declare function validateAuthor(role: string | undefined): Author | 'unknown';
2
5
  export declare const kbFeedbackSchema: z.ZodObject<{
3
- repo_path: z.ZodOptional<z.ZodString>;
6
+ repo_path: z.ZodOptional<z.ZodUnknown>;
7
+ repo: z.ZodOptional<z.ZodUnknown>;
8
+ repo_remote_url: z.ZodOptional<z.ZodUnknown>;
4
9
  id: z.ZodString;
5
10
  reason: z.ZodString;
6
11
  role: z.ZodOptional<z.ZodString>;
7
- repo_remote_url: z.ZodOptional<z.ZodString>;
8
12
  }, "strip", z.ZodTypeAny, {
9
- reason: string;
10
13
  id: string;
14
+ reason: string;
11
15
  role?: string | undefined;
12
- repo_path?: string | undefined;
13
- repo_remote_url?: string | undefined;
16
+ repo?: unknown;
17
+ repo_path?: unknown;
18
+ repo_remote_url?: unknown;
14
19
  }, {
15
- reason: string;
16
20
  id: string;
21
+ reason: string;
17
22
  role?: string | undefined;
18
- repo_path?: string | undefined;
19
- repo_remote_url?: string | undefined;
23
+ repo?: unknown;
24
+ repo_path?: unknown;
25
+ repo_remote_url?: unknown;
20
26
  }>;
21
27
  export type KbFeedbackInput = z.infer<typeof kbFeedbackSchema>;
22
- export declare function kbFeedback(input: KbFeedbackInput): Promise<string>;
28
+ export declare function kbFeedback(input: KbFeedbackInput, anchor?: KbAnchor): Promise<string>;
23
29
  //# sourceMappingURL=kb-feedback.d.ts.map
@@ -1,26 +1,28 @@
1
1
  import { z } from 'zod';
2
- import { getKbProviders } from '../services/knowledge/kb-providers.js';
3
- import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
4
- import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
2
+ import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
3
+ import { getSelfKbProviders, memberOwnerTag } from '../services/knowledge/kb-self.js';
4
+ import { KbMemberViewError } from '../services/knowledge/member-bible-view.js';
5
+ import { isSqliteProject } from '../services/knowledge/require-sqlite-project.js';
6
+ import { HttpKbProvider } from '../services/knowledge/http-provider.js';
5
7
  // D5 (T2.3) pattern, DUPLICATED here rather than imported: src/tools/kb-capture.ts
6
8
  // is touched ONLY by T1.1 per PLAN.md's shared-file sequencing, so this tool
7
9
  // validates its own role hint against the same Author enum instead of
8
10
  // exporting a shared helper out of a file this task must not modify.
9
11
  const AUTHOR_VALUES = ['doer', 'reviewer', 'planner', 'plan-reviewer', 'kb-agent', 'kb-reconciler', 'harvest', 'pm', 'user'];
10
- function validateAuthor(role) {
12
+ export function validateAuthor(role) {
11
13
  if (role && AUTHOR_VALUES.includes(role)) {
12
14
  return role;
13
15
  }
14
16
  return 'unknown';
15
17
  }
16
18
  export const kbFeedbackSchema = z.object({
17
- ...kbScopeFields,
18
- repo_path: z.string().optional()
19
- .describe('Path to the repo root this call is about. Selects WHICH project KB is read/written. When omitted, falls back to the calling process cwd, which is only correct for single-repo CLI use -- server-handled tool calls must pass it explicitly.'),
20
19
  id: z.string().min(1).describe('ID of the KB entry the feedback applies to'),
21
20
  reason: z.string().min(1).describe('What was wrong in practice -- appended to the entry content as an ASCII feedback note'),
22
21
  role: z.string().optional()
23
22
  .describe('Role hint for provenance: doer/reviewer/planner/plan-reviewer/kb-agent/harvest/pm/user. Validated server-side against the Author enum; invalid or absent stamps "unknown" in the note.'),
23
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
24
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
25
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
24
26
  });
25
27
  // D7 (F8): downvote a KB entry that proved wrong in practice. Marks stale=1 +
26
28
  // flagged_for_review=1 and appends an ASCII feedback note "[feedback <ISO>]
@@ -30,11 +32,25 @@ export const kbFeedbackSchema = z.object({
30
32
  // resolves it in kb-review. EXCEPTION: an ACTIVE user-directive is flagged for
31
33
  // review only (never staled) because directives outrank agent experience and
32
34
  // the human decides -- see SqliteProvider.feedback() for the exact guard.
33
- export async function kbFeedback(input) {
34
- const providers = await getKbProviders(input.repo_path, input.repo_remote_url);
35
- const sqliteProvider = requireSqliteProject(providers.project, 'kb_feedback');
35
+ export async function kbFeedback(input, anchor) {
36
+ // A MEMBER session does not downvote entries in the shared KB, under either
37
+ // provider: a typed no-op that touches no store (checked before any provider
38
+ // is opened).
39
+ if (memberOwnerTag(anchor) !== undefined) {
40
+ throw new KbMemberViewError('E-MEMBER-VIEW-READ-ONLY', '', `kb_feedback is not available in a member session: a member session does not flag entries in the shared KB (over SQLite its reads come from the read-only checkout bible; under an http KB provider the server's entries are shared by every member); entry '${input.id}' was not changed.`, 'Run kb_feedback from a FULL session (no member identity), or flag the entry for review through the maintainer.');
41
+ }
42
+ const providers = await getSelfKbProviders(anchor);
36
43
  const author = validateAuthor(input.role);
37
- const entry = await sqliteProvider.feedback(input.id, input.reason, author);
44
+ // An HTTP-backed KB: the remote server owns the entry and decides its
45
+ // stale/flagged state; its response is returned as is (an unreachable
46
+ // server is a thrown E-KB-HTTP-UNREACHABLE; nothing is queued). Confidence is never written or invented client-side.
47
+ if (providers.project instanceof HttpKbProvider) {
48
+ return JSON.stringify(await providers.project.feedback(input.id, input.reason, author));
49
+ }
50
+ if (!isSqliteProject(providers.project)) {
51
+ throw new Error('kb_feedback: this operation is not supported by the configured KB provider');
52
+ }
53
+ const entry = await providers.project.feedback(input.id, input.reason, author);
38
54
  return JSON.stringify({
39
55
  id: entry.id,
40
56
  stale: entry.stale,
@@ -1,14 +1,18 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
2
3
  export declare const kbFreshnessSweepSchema: z.ZodObject<{
3
- repo_path: z.ZodOptional<z.ZodString>;
4
- repo_remote_url: z.ZodOptional<z.ZodString>;
4
+ repo_path: z.ZodOptional<z.ZodUnknown>;
5
+ repo: z.ZodOptional<z.ZodUnknown>;
6
+ repo_remote_url: z.ZodOptional<z.ZodUnknown>;
5
7
  }, "strip", z.ZodTypeAny, {
6
- repo_path?: string | undefined;
7
- repo_remote_url?: string | undefined;
8
+ repo?: unknown;
9
+ repo_path?: unknown;
10
+ repo_remote_url?: unknown;
8
11
  }, {
9
- repo_path?: string | undefined;
10
- repo_remote_url?: string | undefined;
12
+ repo?: unknown;
13
+ repo_path?: unknown;
14
+ repo_remote_url?: unknown;
11
15
  }>;
12
16
  export type KbFreshnessSweepInput = z.infer<typeof kbFreshnessSweepSchema>;
13
- export declare function kbFreshnessSweep(input: KbFreshnessSweepInput): Promise<string>;
17
+ export declare function kbFreshnessSweep(input: KbFreshnessSweepInput, anchor?: KbAnchor): Promise<string>;
14
18
  //# sourceMappingURL=kb-freshness-sweep.d.ts.map
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
- import { getKbProviders } from '../services/knowledge/kb-providers.js';
3
- import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
2
+ import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
3
+ import { getSelfKbProviders } from '../services/knowledge/kb-self.js';
4
4
  import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
5
5
  // T1.3 (F2/D2 HARDENED, resolution R2): kb_freshness_sweep -- a bounded,
6
6
  // full-KB BIDIRECTIONAL freshness sweep. Re-hashes the stored per-file basis of
@@ -12,12 +12,12 @@ import { requireSqliteProject } from '../services/knowledge/require-sqlite-proje
12
12
  // revival requires a sweep, not just a prime. Invoked standalone by the PM
13
13
  // reconcile flow and internally by kb_import.
14
14
  export const kbFreshnessSweepSchema = z.object({
15
- ...kbScopeFields,
16
- repo_path: z.string().optional()
17
- .describe('Path to the repo root this call is about. Selects WHICH project KB is read/written. When omitted, falls back to the calling process cwd, which is only correct for single-repo CLI use -- server-handled tool calls must pass it explicitly.'),
15
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
16
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
17
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
18
18
  });
19
- export async function kbFreshnessSweep(input) {
20
- const providers = await getKbProviders(input.repo_path, input.repo_remote_url);
19
+ export async function kbFreshnessSweep(input, anchor) {
20
+ const providers = await getSelfKbProviders(anchor);
21
21
  // apra-fleet-b4g.4 (criterion 5): no explicit root on purpose -- freshnessSweep
22
22
  // now defaults to the provider's OWN anchor (the root the basis was stored
23
23
  // against), which is exactly what this call site wants. Passing a root here
@@ -1,20 +1,24 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
2
3
  export declare const kbHarvestSchema: z.ZodObject<{
3
- repo_path: z.ZodOptional<z.ZodString>;
4
+ repo_path: z.ZodOptional<z.ZodUnknown>;
5
+ repo: z.ZodOptional<z.ZodUnknown>;
6
+ repo_remote_url: z.ZodOptional<z.ZodUnknown>;
4
7
  session_transcript: z.ZodOptional<z.ZodString>;
5
8
  session_id: z.ZodOptional<z.ZodString>;
6
- repo_remote_url: z.ZodOptional<z.ZodString>;
7
9
  }, "strip", z.ZodTypeAny, {
8
- repo_path?: string | undefined;
9
- repo_remote_url?: string | undefined;
10
+ repo?: unknown;
11
+ repo_path?: unknown;
12
+ repo_remote_url?: unknown;
10
13
  session_transcript?: string | undefined;
11
14
  session_id?: string | undefined;
12
15
  }, {
13
- repo_path?: string | undefined;
14
- repo_remote_url?: string | undefined;
16
+ repo?: unknown;
17
+ repo_path?: unknown;
18
+ repo_remote_url?: unknown;
15
19
  session_transcript?: string | undefined;
16
20
  session_id?: string | undefined;
17
21
  }>;
18
22
  export type KbHarvestInput = z.infer<typeof kbHarvestSchema>;
19
- export declare function kbHarvest(input: KbHarvestInput): Promise<string>;
23
+ export declare function kbHarvest(input: KbHarvestInput, anchor?: KbAnchor): Promise<string>;
20
24
  //# sourceMappingURL=kb-harvest.d.ts.map