@apralabs/apra-fleet 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -1,19 +1,108 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
3
+ import type { KBEntry } from '../services/knowledge/types.js';
2
4
  export declare const kbExportSchema: z.ZodObject<{
3
- repo_path: z.ZodOptional<z.ZodString>;
5
+ repo_path: z.ZodOptional<z.ZodUnknown>;
6
+ repo: z.ZodOptional<z.ZodUnknown>;
7
+ repo_remote_url: z.ZodOptional<z.ZodUnknown>;
4
8
  scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
5
- repo_remote_url: z.ZodOptional<z.ZodString>;
9
+ baseBranch: z.ZodOptional<z.ZodString>;
10
+ baseCommit: z.ZodOptional<z.ZodString>;
6
11
  }, "strip", z.ZodTypeAny, {
12
+ repo?: unknown;
7
13
  scope?: "project" | "global" | undefined;
8
- repo_path?: string | undefined;
9
- repo_remote_url?: string | undefined;
14
+ repo_path?: unknown;
15
+ repo_remote_url?: unknown;
16
+ baseBranch?: string | undefined;
17
+ baseCommit?: string | undefined;
10
18
  }, {
19
+ repo?: unknown;
11
20
  scope?: "project" | "global" | undefined;
12
- repo_path?: string | undefined;
13
- repo_remote_url?: string | undefined;
21
+ repo_path?: unknown;
22
+ repo_remote_url?: unknown;
23
+ baseBranch?: string | undefined;
24
+ baseCommit?: string | undefined;
14
25
  }>;
15
26
  export type KbExportInput = z.infer<typeof kbExportSchema>;
27
+ export interface CanonicalEntry {
28
+ id: string;
29
+ type: string;
30
+ title: string;
31
+ summary: string;
32
+ symbols: string[];
33
+ source_files: string[];
34
+ confidence: string;
35
+ updated_at: string;
36
+ /**
37
+ * Bible format v3: the per-file hash basis (repo-relative path -> hash) the
38
+ * entry was admitted against, copied verbatim from the exporting provider's
39
+ * stored basis (SqliteProvider.getSourceFileBases) -- never re-hashed at
40
+ * write time. Keys are sorted so the file stays byte-stable. Absent on an
41
+ * entry carried over from a v1/v2 bible, which has no basis to carry.
42
+ */
43
+ source_file_hashes?: Record<string, string>;
44
+ }
45
+ /** The bible format version every writer emits. */
46
+ export declare const BIBLE_FORMAT_VERSION: 3;
47
+ /**
48
+ * The bible envelope. v3 (current) adds per-entry source_file_hashes; v2 is
49
+ * the same envelope without them. kb_import accepts v3, v2 and the legacy bare
50
+ * array, selecting on Array.isArray -- an older bible must keep importing.
51
+ */
52
+ export interface CanonicalBible {
53
+ version: typeof BIBLE_FORMAT_VERSION;
54
+ provenance: {
55
+ /** 40-char HEAD sha, or null when the repo has no commits or git is absent. */
56
+ commit: string | null;
57
+ branch: string | null;
58
+ entry_count: number;
59
+ };
60
+ entries: CanonicalEntry[];
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 declare function withSourceFileHashes(entry: CanonicalEntry, basis: Record<string, string>): CanonicalEntry;
68
+ /**
69
+ * Map a KB entry to the bible's stable field set. Shared with kb_bible_commit.
70
+ * `basis` is the entry's STORED per-file hash basis (the one the bible
71
+ * predicate admitted it against); when given and non-empty it is written as
72
+ * source_file_hashes (format v3). Nothing is hashed here.
73
+ */
74
+ export declare function toCanonicalEntry(e: KBEntry, basis?: Record<string, string> | null): CanonicalEntry;
75
+ /**
76
+ * Duplicate-id guard shared by every bible writer: a bible is keyed by id, so
77
+ * one about to be written with two entries sharing an id is corrupt. Throws
78
+ * (naming the id) BEFORE anything is written, so the file on disk is untouched.
79
+ */
80
+ export declare function assertNoDuplicateBibleIds(entries: Array<{
81
+ id?: unknown;
82
+ }>, toolName: string): void;
83
+ /** Deterministic id ordering so re-exports produce meaningful diffs. */
84
+ export declare function compareById(a: {
85
+ id: string;
86
+ }, b: {
87
+ id: string;
88
+ }): number;
89
+ /**
90
+ * The entries of the bible already on disk, in either shape (legacy bare array
91
+ * or v2/v3 envelope). null when the file is absent or unparseable.
92
+ */
93
+ export declare function readBibleEntries(outPath: string): CanonicalEntry[] | null;
94
+ /**
95
+ * PATHSPEC-ONLY commit of the bible file with the dedicated pm-kb identity:
96
+ * git add <path> then a commit scoped to -- <path>, so unrelated staged or
97
+ * dirty working-tree state is never swept in. Throws on any git failure; the
98
+ * caller decides whether that is fatal. Never pushes.
99
+ */
100
+ export declare function commitBiblePath(repoPath: string, outPath: string, message: string): void;
101
+ export declare function asciiSafeStringify(value: unknown): string;
102
+ export declare function requireLocalFolder(folder: string, toolName?: string): string;
16
103
  /** Test seam: the default is a trust decision, so it is asserted directly. */
17
104
  export declare function _autoCommitEnabledForTest(): boolean;
18
- export declare function kbExport(input: KbExportInput): Promise<string>;
105
+ export declare function isGitRepo(repoPath: string): boolean;
106
+ export declare function bibleContentChanged(repoPath: string, outPath: string): boolean;
107
+ export declare function kbExport(input: KbExportInput, anchor?: KbAnchor): Promise<string>;
19
108
  //# sourceMappingURL=kb-export.d.ts.map
@@ -1,12 +1,14 @@
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';
10
12
  // T3.4 (F8b, D8): export half of the shareable, diffable team bible. Writes
11
13
  // all CONFIRMED, non-superseded, non-stale project entries to
12
14
  // <repo>/.fleet/kb-canonical.json. Registered as a real MCP tool (not just an
@@ -18,15 +20,11 @@ import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
18
20
  // discretion: the export TOOL commits with its own dedicated identity
19
21
  // (pm-kb), so no role's "no git operations" rule is violated by this
20
22
  // 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.
23
+ // kb (self): the repo written to is the calling session's own folder -- the
24
+ // member's registered work folder for a member session, the server's working
25
+ // folder otherwise (src/services/knowledge/kb-self.ts). It is validated (must
26
+ // exist, be a git repo with an origin remote) or kb_export refuses with a
27
+ // typed E-SELF error; it is never a scope argument.
30
28
  // T3.3 (F9a, D8): scope param -- 'project' (default, unchanged behavior) reads
31
29
  // the PROJECT KB and writes .fleet/kb-canonical.json (as before); 'global'
32
30
  // reads the GLOBAL KB (providers.global -- the shared kb.sqlite at
@@ -35,13 +33,109 @@ import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
35
33
  // apra-fleet platform repo, committed there per D8). Same stable field set,
36
34
  // same asciiSafeStringify + deterministic id-sorted output, and the same
37
35
  // auto-commit behavior (T2.3) applies to the global file too.
36
+ // Provenance names the TARGET BASE branch: the branch the bible's entries will
37
+ // merge into, not the (typically feature) branch the export ran on. baseBranch
38
+ // and baseCommit let the caller say so explicitly; when omitted, provenance
39
+ // falls back to the export folder's own HEAD branch and commit (unchanged).
38
40
  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
41
  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).'),
42
+ .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).'),
43
+ baseBranch: z.string().min(1).optional()
44
+ .describe('The target base branch (the branch the entries merge into). Written to provenance.branch. Omitted: the export folder HEAD branch.'),
45
+ baseCommit: z.string().min(1).optional()
46
+ .describe('The base commit the entries were verified against. Written to provenance.commit. Omitted: the export folder HEAD commit.'),
47
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
48
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
49
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
44
50
  });
51
+ /** The bible format version every writer emits. */
52
+ export const BIBLE_FORMAT_VERSION = 3;
53
+ /** A basis map with its keys in sorted order, so serialization is byte-stable. */
54
+ function sortedBasis(basis) {
55
+ const out = {};
56
+ for (const key of Object.keys(basis).sort())
57
+ out[key] = basis[key];
58
+ return out;
59
+ }
60
+ /**
61
+ * A bible entry with `basis` attached as its source_file_hashes (keys sorted,
62
+ * copied verbatim -- never re-hashed); every other field is left as it is.
63
+ * Used by kb_bible_commit's legacy backfill.
64
+ */
65
+ export function withSourceFileHashes(entry, basis) {
66
+ return { ...entry, source_file_hashes: sortedBasis(basis) };
67
+ }
68
+ /**
69
+ * Map a KB entry to the bible's stable field set. Shared with kb_bible_commit.
70
+ * `basis` is the entry's STORED per-file hash basis (the one the bible
71
+ * predicate admitted it against); when given and non-empty it is written as
72
+ * source_file_hashes (format v3). Nothing is hashed here.
73
+ */
74
+ export function toCanonicalEntry(e, basis) {
75
+ const entry = {
76
+ id: e.id,
77
+ type: e.type,
78
+ title: e.title,
79
+ summary: e.summary,
80
+ symbols: e.symbols,
81
+ source_files: e.source_files,
82
+ confidence: e.confidence,
83
+ updated_at: e.promoted_at || e.created_at,
84
+ };
85
+ if (basis && Object.keys(basis).length > 0)
86
+ entry.source_file_hashes = sortedBasis(basis);
87
+ return entry;
88
+ }
89
+ /**
90
+ * Duplicate-id guard shared by every bible writer: a bible is keyed by id, so
91
+ * one about to be written with two entries sharing an id is corrupt. Throws
92
+ * (naming the id) BEFORE anything is written, so the file on disk is untouched.
93
+ */
94
+ export function assertNoDuplicateBibleIds(entries, toolName) {
95
+ const seen = new Set();
96
+ for (const e of entries) {
97
+ const id = String(e.id);
98
+ if (seen.has(id)) {
99
+ throw new Error(toolName + ': refusing to write a bible with duplicate entry id ' + JSON.stringify(id)
100
+ + ' -- the bible is keyed by id; resolve the duplicate in .fleet/kb-canonical.json first');
101
+ }
102
+ seen.add(id);
103
+ }
104
+ }
105
+ /** Deterministic id ordering so re-exports produce meaningful diffs. */
106
+ export function compareById(a, b) {
107
+ return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
108
+ }
109
+ /**
110
+ * The entries of the bible already on disk, in either shape (legacy bare array
111
+ * or v2/v3 envelope). null when the file is absent or unparseable.
112
+ */
113
+ export function readBibleEntries(outPath) {
114
+ if (!fs.existsSync(outPath))
115
+ return null;
116
+ try {
117
+ const parsed = JSON.parse(fs.readFileSync(outPath, 'utf-8'));
118
+ const existing = Array.isArray(parsed)
119
+ ? parsed
120
+ : (parsed && Array.isArray(parsed.entries) ? parsed.entries : null);
121
+ return existing;
122
+ }
123
+ catch {
124
+ return null;
125
+ }
126
+ }
127
+ /**
128
+ * PATHSPEC-ONLY commit of the bible file with the dedicated pm-kb identity:
129
+ * git add <path> then a commit scoped to -- <path>, so unrelated staged or
130
+ * dirty working-tree state is never swept in. Throws on any git failure; the
131
+ * caller decides whether that is fatal. Never pushes.
132
+ */
133
+ export function commitBiblePath(repoPath, outPath, message) {
134
+ execFileSync('git', ['add', outPath], {
135
+ cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true,
136
+ });
137
+ 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'], windowsHide: true });
138
+ }
45
139
  /**
46
140
  * Resolve HEAD, degrading gracefully to null rather than throwing: a repo with
47
141
  * no commits yet, a non-repo directory, or a machine without git must still be
@@ -81,7 +175,7 @@ function gitOrNull(repoPath, args) {
81
175
  return null;
82
176
  try {
83
177
  const out = execFileSync('git', args, {
84
- cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'],
178
+ cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
85
179
  }).trim();
86
180
  return out.length > 0 ? out : null;
87
181
  }
@@ -100,7 +194,7 @@ function gitOrNull(repoPath, args) {
100
194
  // ASCII too) and avoids template literals -- the pre-commit hook's
101
195
  // backtick-n/t/r scan false-positives on template-literal escape sequences,
102
196
  // the same gotcha T2.3's promote() fix worked around.
103
- function asciiSafeStringify(value) {
197
+ export function asciiSafeStringify(value) {
104
198
  const json = JSON.stringify(value, null, 2);
105
199
  const maxAsciiCode = 127;
106
200
  const escapePrefix = String.fromCharCode(92) + 'u'; // backslash + 'u', built at runtime
@@ -119,16 +213,14 @@ function asciiSafeStringify(value) {
119
213
  }
120
214
  return out;
121
215
  }
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);
216
+ // The resolved anchor folder must exist on THIS host: kb_export writes the
217
+ // bible file there, so an anchor naming a folder on another host (a remote
218
+ // member's work folder) has nothing meaningful to do and must refuse.
219
+ export function requireLocalFolder(folder, toolName = 'kb_export') {
220
+ if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory()) {
221
+ throw new Error(toolName + ': repo folder does not exist or is not a directory on this host: ' + folder);
130
222
  }
131
- return candidate;
223
+ return folder;
132
224
  }
133
225
  function autoCommitMode() {
134
226
  try {
@@ -152,7 +244,7 @@ function autoCommitEnabled() {
152
244
  return autoCommitMode() !== 'off';
153
245
  }
154
246
  // 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.
247
+ // Accepts every shape (legacy bare array, v2/v3 envelope) like entriesUnchanged.
156
248
  // null means "no comparable prior bible" -- absent file, or unparseable -- in
157
249
  // which case there is no shrink to detect and the export is a first write.
158
250
  function bibleEntryCount(outPath) {
@@ -173,7 +265,7 @@ function bibleEntryCount(outPath) {
173
265
  export function _autoCommitEnabledForTest() {
174
266
  return autoCommitEnabled();
175
267
  }
176
- function isGitRepo(repoPath) {
268
+ export function isGitRepo(repoPath) {
177
269
  return fs.existsSync(path.join(repoPath, '.git'));
178
270
  }
179
271
  // "Content actually changed" (D5): git status --porcelain against the exact
@@ -181,9 +273,9 @@ function isGitRepo(repoPath) {
181
273
  // already matches HEAD for this one path -- re-exporting an identical bible
182
274
  // is a no-op, so there is nothing to commit. Any output (modified, or a
183
275
  // brand-new untracked file on the very first export) means it changed.
184
- function bibleContentChanged(repoPath, outPath) {
276
+ export function bibleContentChanged(repoPath, outPath) {
185
277
  const status = execFileSync('git', ['status', '--porcelain', '--', outPath], {
186
- cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'],
278
+ cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
187
279
  });
188
280
  return status.trim().length > 0;
189
281
  }
@@ -224,12 +316,9 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
224
316
  try {
225
317
  if (!bibleContentChanged(repoPath, outPath))
226
318
  return false;
227
- execFileSync('git', ['add', outPath], {
228
- cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'],
229
- });
230
319
  const scopeLabel = scope === 'global' ? 'global knowledge bible' : 'knowledge bible';
231
320
  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'] });
321
+ commitBiblePath(repoPath, outPath, message);
233
322
  return true;
234
323
  }
235
324
  catch (err) {
@@ -238,44 +327,117 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
238
327
  return false;
239
328
  }
240
329
  }
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);
330
+ // Id ordering for the additive project merge, whose existing bible entries are
331
+ // raw objects (never re-shaped) and so carry an id of unknown type.
332
+ function byId(a, b) {
333
+ const x = String(a.id);
334
+ const y = String(b.id);
335
+ return x < y ? -1 : x > y ? 1 : 0;
336
+ }
337
+ /**
338
+ * Entries of the bible already on disk, as raw objects (never re-shaped, so
339
+ * they are written back byte-for-byte equivalent). Accepts the v2/v3 envelope and
340
+ * the legacy bare array. An absent file is an empty bible. A file that exists
341
+ * but cannot be parsed as either shape THROWS: the project export is additive
342
+ * and must never overwrite (and so silently drop) a bible it cannot read.
343
+ */
344
+ function readExistingBibleEntries(outPath) {
345
+ if (!fs.existsSync(outPath))
346
+ return [];
347
+ let parsed;
348
+ try {
349
+ parsed = JSON.parse(fs.readFileSync(outPath, 'utf-8'));
350
+ }
351
+ catch (err) {
352
+ throw new Error('kb_export: existing bible is not valid JSON, refusing to overwrite it: ' + outPath
353
+ + ' (' + (err instanceof Error ? err.message : String(err)) + ')');
354
+ }
355
+ const list = Array.isArray(parsed)
356
+ ? parsed
357
+ : (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries)
358
+ ? parsed.entries
359
+ : null);
360
+ if (list === null) {
361
+ throw new Error('kb_export: existing bible has no entries array, refusing to overwrite it: ' + outPath);
362
+ }
363
+ return list;
364
+ }
365
+ // PROJECT-SCOPE EXPORT: basis filter + additive merge.
366
+ //
367
+ // Only CONFIRMED (non-superseded, non-stale -- list() already excludes those)
368
+ // entries whose per-file hash basis matches the files in repoPath qualify (see
369
+ // qualifiesForProjectBible in services/knowledge/bible-basis-filter.ts). A
370
+ // member-local KB routinely holds entries about files the exported tree does
371
+ // not contain; publishing them would leak them into the committed artifact.
372
+ //
373
+ // The merge is ADDITIVE: every entry already in the bible is kept exactly as it
374
+ // is (curated, possibly human-edited), qualifying entries whose id is not yet
375
+ // present are added, and on an id collision the existing bible entry wins.
376
+ // Nothing is ever removed by an export -- removal is a human (or reconcile)
377
+ // edit of the file. Consequently the project bible never shrinks through this
378
+ // path and the shrink guard in maybeAutoCommitBible only matters for global.
379
+ //
380
+ // No new id to add -> the file is not touched at all (byte-identical,
381
+ // provenance untouched) and nothing is committed.
382
+ //
383
+ // `exported` in the response is the number of entries in the bible as written
384
+ // (or as left on disk when nothing was added), not the number newly added.
385
+ async function exportProjectBible(source, repoPath, outPath, input) {
386
+ const existing = readExistingBibleEntries(outPath);
387
+ const existingIds = new Set(existing.map(e => String(e.id)));
388
+ const confirmed = await source.list({ confidence: ['CONFIRMED'] });
389
+ const newCandidates = confirmed.filter(e => !existingIds.has(e.id));
390
+ const bases = source.getSourceFileBases(newCandidates.map(e => e.id));
391
+ const qualifying = await filterProjectBibleCandidates(newCandidates, bases, repoPath);
392
+ if (qualifying.length === 0) {
393
+ return JSON.stringify({ exported: existing.length, path: outPath, scope: 'project', committed: false });
394
+ }
395
+ // Each added entry carries the exact stored basis it was just admitted against.
396
+ const merged = [...existing, ...qualifying.map(e => toCanonicalEntry(e, bases.get(e.id)))].sort(byId);
397
+ assertNoDuplicateBibleIds(merged, 'kb_export');
398
+ const bible = {
399
+ version: BIBLE_FORMAT_VERSION,
400
+ provenance: {
401
+ commit: input.baseCommit ?? resolveHeadCommit(repoPath),
402
+ branch: input.baseBranch ?? resolveBranch(repoPath),
403
+ entry_count: merged.length,
404
+ },
405
+ entries: merged,
406
+ };
407
+ const fleetDir = path.dirname(outPath);
408
+ if (!fs.existsSync(fleetDir))
409
+ fs.mkdirSync(fleetDir, { recursive: true });
410
+ const previousEntryCount = bibleEntryCount(outPath);
411
+ fs.writeFileSync(outPath, asciiSafeStringify(bible) + '\n', 'utf-8');
412
+ const committed = maybeAutoCommitBible(repoPath, outPath, merged.length, 'project', previousEntryCount);
413
+ return JSON.stringify({ exported: merged.length, path: outPath, scope: 'project', committed });
414
+ }
415
+ export async function kbExport(input, anchor) {
416
+ // kb_export WRITES <folder>/.fleet/kb-canonical.json and git-commits it, so
417
+ // an unreachable folder has no meaningful behaviour left -- it must not
418
+ // proceed. An invalid anchor throws here, before getKbProviders is reached,
419
+ // so no provider is ever anchored somewhere the caller did not mean.
420
+ const resolved = resolveKbAnchor(anchor);
421
+ const repoPath = requireLocalFolder(resolved.folder);
253
422
  const scope = input.scope ?? 'project';
254
423
  // Read from the SAME repo we are about to write the bible into. Resolving the
255
424
  // source from process cwd while writing to repoPath is how repo A's entries
256
425
  // 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' });
426
+ const providers = await getKbProviders(repoPath, resolved.remoteUrl);
427
+ const fleetDir = path.join(repoPath, '.fleet');
428
+ const fileName = scope === 'global' ? 'kb-canonical-global.json' : 'kb-canonical.json';
429
+ const outPath = path.join(fleetDir, fileName);
430
+ if (scope === 'project') {
431
+ return exportProjectBible(requireSqliteProject(providers.project, 'kb_export'), repoPath, outPath, input);
432
+ }
433
+ const entries = await providers.global.list({ confidence: ['CONFIRMED'] });
260
434
  // Deterministic ordering by id so re-exports produce meaningful diffs.
261
435
  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');
436
+ .map(e => toCanonicalEntry(e))
437
+ .sort(compareById);
274
438
  if (!fs.existsSync(fleetDir)) {
275
439
  fs.mkdirSync(fleetDir, { recursive: true });
276
440
  }
277
- const fileName = scope === 'global' ? 'kb-canonical-global.json' : 'kb-canonical.json';
278
- const outPath = path.join(fleetDir, fileName);
279
441
  // KB-TRUST PHASE 3a: the bible records the commit it was exported from, so a
280
442
  // later audit can date its entries against the tree they were verified on.
281
443
  // Before this, a bible harvested from other repositories was indistinguishable
@@ -296,15 +458,16 @@ export async function kbExport(input) {
296
458
  // exists to avoid. When the entry set is unchanged the file is left exactly as
297
459
  // it is, which also keeps the recorded commit honest: it names the tree those
298
460
  // entries were last verified against, not the commit that stored them.
461
+ assertNoDuplicateBibleIds(canonical, 'kb_export');
299
462
  const nextEntriesJson = asciiSafeStringify(canonical);
300
463
  if (entriesUnchanged(outPath, nextEntriesJson)) {
301
464
  return JSON.stringify({ exported: canonical.length, path: outPath, scope, committed: false });
302
465
  }
303
466
  const bible = {
304
- version: 2,
467
+ version: BIBLE_FORMAT_VERSION,
305
468
  provenance: {
306
- commit: resolveHeadCommit(repoPath),
307
- branch: resolveBranch(repoPath),
469
+ commit: input.baseCommit ?? resolveHeadCommit(repoPath),
470
+ branch: input.baseBranch ?? resolveBranch(repoPath),
308
471
  entry_count: canonical.length,
309
472
  },
310
473
  entries: canonical,
@@ -1,23 +1,27 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
2
3
  export declare const kbFeedbackSchema: 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
  id: z.ZodString;
5
8
  reason: z.ZodString;
6
9
  role: z.ZodOptional<z.ZodString>;
7
- repo_remote_url: z.ZodOptional<z.ZodString>;
8
10
  }, "strip", z.ZodTypeAny, {
9
- reason: string;
10
11
  id: string;
12
+ reason: string;
11
13
  role?: string | undefined;
12
- repo_path?: string | undefined;
13
- repo_remote_url?: string | undefined;
14
+ repo?: unknown;
15
+ repo_path?: unknown;
16
+ repo_remote_url?: unknown;
14
17
  }, {
15
- reason: string;
16
18
  id: string;
19
+ reason: string;
17
20
  role?: string | undefined;
18
- repo_path?: string | undefined;
19
- repo_remote_url?: string | undefined;
21
+ repo?: unknown;
22
+ repo_path?: unknown;
23
+ repo_remote_url?: unknown;
20
24
  }>;
21
25
  export type KbFeedbackInput = z.infer<typeof kbFeedbackSchema>;
22
- export declare function kbFeedback(input: KbFeedbackInput): Promise<string>;
26
+ export declare function kbFeedback(input: KbFeedbackInput, anchor?: KbAnchor): Promise<string>;
23
27
  //# sourceMappingURL=kb-feedback.d.ts.map
@@ -1,6 +1,7 @@
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, memberOwnerTag } from '../services/knowledge/kb-self.js';
4
+ import { KbMemberViewError } from '../services/knowledge/member-bible-view.js';
4
5
  import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
5
6
  // D5 (T2.3) pattern, DUPLICATED here rather than imported: src/tools/kb-capture.ts
6
7
  // is touched ONLY by T1.1 per PLAN.md's shared-file sequencing, so this tool
@@ -14,13 +15,13 @@ function validateAuthor(role) {
14
15
  return 'unknown';
15
16
  }
16
17
  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
18
  id: z.string().min(1).describe('ID of the KB entry the feedback applies to'),
21
19
  reason: z.string().min(1).describe('What was wrong in practice -- appended to the entry content as an ASCII feedback note'),
22
20
  role: z.string().optional()
23
21
  .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.'),
22
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
23
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
24
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
24
25
  });
25
26
  // D7 (F8): downvote a KB entry that proved wrong in practice. Marks stale=1 +
26
27
  // flagged_for_review=1 and appends an ASCII feedback note "[feedback <ISO>]
@@ -30,8 +31,13 @@ export const kbFeedbackSchema = z.object({
30
31
  // resolves it in kb-review. EXCEPTION: an ACTIVE user-directive is flagged for
31
32
  // review only (never staled) because directives outrank agent experience and
32
33
  // 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);
34
+ export async function kbFeedback(input, anchor) {
35
+ // A MEMBER session reads its checkout bible view, which is read-only: a
36
+ // typed no-op that touches no store (checked before any provider is opened).
37
+ if (memberOwnerTag(anchor) !== undefined) {
38
+ throw new KbMemberViewError('E-MEMBER-VIEW-READ-ONLY', '', `kb_feedback is not available in a member session: member KB reads come from the checkout bible, which is read-only; 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.');
39
+ }
40
+ const providers = await getSelfKbProviders(anchor);
35
41
  const sqliteProvider = requireSqliteProject(providers.project, 'kb_feedback');
36
42
  const author = validateAuthor(input.role);
37
43
  const entry = await sqliteProvider.feedback(input.id, input.reason, author);
@@ -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