@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -1,27 +1,21 @@
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
- import { getKbProviders } from '../services/knowledge/kb-providers.js';
5
+ import { getSelfReadKb } from '../services/knowledge/kb-self.js';
6
+ import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
5
7
  import { validateFilePaths } from '../services/knowledge/path-validation.js';
6
- import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
7
8
  import { getProvider } from './code-intelligence.js';
8
9
  import { FLEET_DIR } from '../paths.js';
9
10
  export const kbSessionPrimeSchema = z.object({
10
- ...kbScopeFields,
11
+ confidence: z.array(z.enum(['CONFIRMED', 'INFERRED', 'UNVERIFIED'])).min(1).optional()
12
+ .describe('Only surface entries whose confidence tier is in this list. Default when omitted: ["CONFIRMED"] (undisputed) -- INFERRED and UNVERIFIED entries are surfaced only when listed explicitly.'),
11
13
  session_files: z.array(z.string()).optional().describe('Files the agent expects to touch this session'),
12
14
  hint_symbols: z.array(z.string()).optional().describe('Symbols likely to be relevant'),
13
15
  hint_modules: z.array(z.string()).optional().describe('Module names likely to be relevant'),
14
- // F4 (T1.6): repo path resolution precedence for the canonical-bible
15
- // cold-seed below -- (1) this explicit repo_path input, validated (must
16
- // exist and be a directory); (2) validated session context -- this
17
- // process's own working directory, used ONLY when repo_path is omitted,
18
- // put through the exact same existence + isDirectory check, never trusted
19
- // blindly; (3) neither validates -- the cold-seed block is skipped
20
- // silently (the existing non-fatal hard-skip contract: prime must never
21
- // fail because the repo root could not be validated). There is no bare
22
- // process.cwd() fallback: the fallback tier is validated the same way
23
- // explicit input is.
24
- repo_path: z.string().optional().describe('Repo root for the canonical-bible cold-seed (.fleet/kb-canonical.json). Precedence: this explicit input, when given and valid, wins; otherwise falls back to the validated session working directory; if neither validates, the cold-seed merge is skipped silently.'),
16
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
17
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
18
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
25
19
  });
26
20
  // Graph-neighbor expansion caps (T1.3 P4b, design D4). Exported for tests.
27
21
  // NEIGHBOR_CAP: max distinct neighbor symbols carried into the extra KB query.
@@ -74,17 +68,14 @@ function canonicalMatchesHints(entry, hintSymbols, hintModules) {
74
68
  return true;
75
69
  return false;
76
70
  }
77
- // F4 (T1.6): shared validation for both precedence tiers -- an explicit
78
- // repo_path (tier 1) and the session working directory fallback (tier 2, used
79
- // only when repo_path is omitted) go through the identical existence +
80
- // isDirectory check. Neither tier is ever trusted without it. Returns null
81
- // (rather than throwing) when nothing validates, so the caller can hard-skip
82
- // per the existing non-fatal cold-seed contract.
83
- function resolveRepoPath(explicit) {
84
- const candidate = explicit || process.cwd();
85
- if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory())
71
+ // The cold-seed below reads <folder>/.fleet/kb-canonical.json, so it needs the
72
+ // anchor folder to be a readable directory on THIS host. Returns null (rather
73
+ // than throwing) when it is not -- a remote member's folder -- so the caller
74
+ // can hard-skip per the existing non-fatal cold-seed contract.
75
+ function localDirOrNull(folder) {
76
+ if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory())
86
77
  return null;
87
- return candidate;
78
+ return folder;
88
79
  }
89
80
  // T3.5 (F9c, D8): `via` param added, defaulting to 'canonical-bible' so the
90
81
  // existing project-bible call site below is byte-for-byte unchanged. The new
@@ -150,26 +141,29 @@ function parseContextNeighbors(result) {
150
141
  return [];
151
142
  }
152
143
  }
153
- export async function kbSessionPrime(input) {
144
+ export async function kbSessionPrime(input, anchor) {
154
145
  if (input.session_files?.length)
155
146
  validateFilePaths(input.session_files);
156
- // Prime the KB belonging to the repo being primed, not the server's cwd.
157
- //
158
- // apra-fleet-b4g.4: an explicitly supplied repo_path is passed through
159
- // VERBATIM, even when it does not exist on this host (a remote member's
160
- // Windows work folder). Routing it through resolveRepoPath() here turned
161
- // such a path into null and then, via `?? undefined`, into getKbProviders'
162
- // `cwd ?? process.cwd()` -- so the provider serving that member ended up
163
- // anchored at the FLEET SERVER'S OWN working directory while repo_remote_url
164
- // pointed it at the real shared project KB, and prime re-hashed every
165
- // candidate entry's basis against a tree that does not describe it. Keeping
166
- // the caller's path means the anchor is honestly "a path this host cannot
167
- // see", which SqliteProvider.anchorIsMissing() handles by declining to
168
- // produce a freshness verdict at all. resolveRepoPath still guards the
169
- // omitted-repo_path fallback (never a bare process.cwd()) and the cold-seed
170
- // block below, which does need a readable directory.
171
- const providers = await getKbProviders(input.repo_path ?? resolveRepoPath() ?? undefined, input.repo_remote_url);
147
+ // Prime the calling session's own KB (kb-self.ts): a member session's work
148
+ // folder, else the server's folder. A remote member's folder is carried
149
+ // verbatim even though this host cannot see it -- SqliteProvider.
150
+ // anchorIsMissing() then declines to produce a freshness verdict rather
151
+ // than re-hashing against an unrelated tree.
152
+ // A MEMBER session primes from its checkout bible view unless it explicitly
153
+ // asks for INFERRED/UNVERIFIED (kb-self.ts getSelfReadKb).
154
+ // That explicit request is answered from the per-repo DB with only the
155
+ // caller's own captures (ownerTag): every block below honours it, and the
156
+ // bible cold-seeds are skipped (bible entries are nobody's own capture).
157
+ const { providers, anchor: resolved, ownerTag } = await getSelfReadKb(anchor, input.confidence);
158
+ if (ownerTag !== undefined)
159
+ requireSqliteProject(providers.project, 'kb_session_prime');
160
+ // Default-trusted reads: CONFIRMED + undisputed unless the caller lists tiers.
161
+ const confidence = input.confidence?.length ? input.confidence : ['CONFIRMED'];
162
+ const exclude_disputed = !input.confidence?.length;
172
163
  const result = await providers.project.prime({
164
+ confidence,
165
+ exclude_disputed,
166
+ owner_tag: ownerTag,
173
167
  session_files: input.session_files,
174
168
  hint_symbols: input.hint_symbols,
175
169
  hint_modules: input.hint_modules,
@@ -189,6 +183,9 @@ export async function kbSessionPrime(input) {
189
183
  l1_only: true,
190
184
  limit: 10,
191
185
  include_stale: false,
186
+ confidence,
187
+ exclude_disputed,
188
+ owner_tag: ownerTag,
192
189
  });
193
190
  const globalEntries = globalResult.results
194
191
  .filter(e => e.type === 'knowledge')
@@ -246,6 +243,9 @@ export async function kbSessionPrime(input) {
246
243
  l1_only: true,
247
244
  limit: 10,
248
245
  include_stale: false,
246
+ confidence,
247
+ exclude_disputed,
248
+ owner_tag: ownerTag,
249
249
  });
250
250
  // Merge below direct hits: skip ids already present (direct + global),
251
251
  // mark each addition via "graph-neighbor", cap at ADDED_ENTRY_CAP.
@@ -277,9 +277,9 @@ export async function kbSessionPrime(input) {
277
277
  // live-KB hit gathered above. Non-fatal: the entire block is a hard skip --
278
278
  // missing file, unreadable/malformed JSON, or a bad shape leaves `result`
279
279
  // exactly as built above (same contract as the neighbor block).
280
- if ((result.top_entries ?? []).length < COLD_KB_MAX) {
280
+ if (ownerTag === undefined && (result.top_entries ?? []).length < COLD_KB_MAX) {
281
281
  try {
282
- const repoRoot = resolveRepoPath(input.repo_path);
282
+ const repoRoot = localDirOrNull(resolved.folder);
283
283
  const canonicalPath = repoRoot ? path.join(repoRoot, '.fleet', 'kb-canonical.json') : null;
284
284
  if (canonicalPath && fs.existsSync(canonicalPath)) {
285
285
  const raw = fs.readFileSync(canonicalPath, 'utf-8');
@@ -341,7 +341,7 @@ export async function kbSessionPrime(input) {
341
341
  // project-bible block: missing file, unreadable/malformed JSON, or a bad
342
342
  // shape leaves `result` exactly as built above -- warm sessions (>=
343
343
  // COLD_KB_MAX) never reach this block at all.
344
- if ((result.top_entries ?? []).length < COLD_KB_MAX) {
344
+ if (ownerTag === undefined && (result.top_entries ?? []).length < COLD_KB_MAX) {
345
345
  try {
346
346
  const globalBiblePath = path.join(FLEET_DIR, 'knowledge', 'global', 'kb-canonical-global.json');
347
347
  if (fs.existsSync(globalBiblePath)) {
@@ -1,20 +1,27 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
2
3
  export declare const kbSetupSchema: 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
  provider: z.ZodOptional<z.ZodEnum<["sqlite", "http"]>>;
5
8
  remote: z.ZodOptional<z.ZodString>;
6
9
  token: z.ZodOptional<z.ZodString>;
7
10
  }, "strip", z.ZodTypeAny, {
8
11
  remote?: string | undefined;
12
+ repo?: unknown;
9
13
  provider?: "http" | "sqlite" | undefined;
10
14
  token?: string | undefined;
11
- repo_path?: string | undefined;
15
+ repo_path?: unknown;
16
+ repo_remote_url?: unknown;
12
17
  }, {
13
18
  remote?: string | undefined;
19
+ repo?: unknown;
14
20
  provider?: "http" | "sqlite" | undefined;
15
21
  token?: string | undefined;
16
- repo_path?: string | undefined;
22
+ repo_path?: unknown;
23
+ repo_remote_url?: unknown;
17
24
  }>;
18
25
  export type KbSetupInput = z.infer<typeof kbSetupSchema>;
19
- export declare function kbSetup(input: KbSetupInput): Promise<string>;
26
+ export declare function kbSetup(input: KbSetupInput, anchor?: KbAnchor): Promise<string>;
20
27
  //# sourceMappingURL=kb-setup.d.ts.map
@@ -1,49 +1,168 @@
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
- import { FLEET_DIR } from '../paths.js';
5
5
  import { installKbPostCommitHook } from './kb-invalidate.js';
6
+ import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
6
7
  import { encryptPassword } from '../utils/crypto.js';
8
+ import { logWarn } from '../utils/log-helpers.js';
9
+ import { resolveKbAnchor, KbSelfError } from '../services/knowledge/kb-self.js';
7
10
  export const kbSetupSchema = z.object({
8
- repo_path: z.string().optional()
9
- .describe('Path to git repository for post-commit hook installation (default: current directory)'),
10
11
  provider: z.enum(['sqlite', 'http']).optional()
11
12
  .describe('KB provider type (default: sqlite)'),
12
13
  remote: z.string().optional()
13
- .describe('Remote KB server URL (required when provider=http)'),
14
+ .describe('Remote KB server URL, http(s) only (required when provider=http). Use https for any non-loopback host: plain http sends the token in cleartext.'),
14
15
  token: z.string().optional()
15
16
  .describe('Authentication token for remote KB server (stored encrypted, never logged)'),
17
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
18
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
19
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
16
20
  });
17
- const KB_CONFIG_DIR = path.join(FLEET_DIR, 'knowledge');
18
- const KB_CONFIG_PATH = path.join(KB_CONFIG_DIR, 'config.json');
19
- export async function kbSetup(input) {
20
- const steps = [];
21
- // Install git post-commit hook
22
- const repoPath = input.repo_path || process.cwd();
23
- const gitDir = path.join(repoPath, '.git');
24
- if (fs.existsSync(gitDir)) {
25
- installKbPostCommitHook(repoPath);
26
- steps.push('Installed git post-commit hook for KB invalidation');
27
- }
28
- else {
29
- steps.push('Skipped git hook: no .git directory found at ' + repoPath);
30
- }
31
- // Write provider config
32
- if (!fs.existsSync(KB_CONFIG_DIR)) {
33
- fs.mkdirSync(KB_CONFIG_DIR, { recursive: true });
34
- }
35
- const config = {
36
- provider: input.provider || (input.remote ? 'http' : 'sqlite'),
37
- };
21
+ const KB_CONFIG_FILE_MODE = 0o600;
22
+ // Hostnames (as URL.hostname normalizes them) that never leave this machine,
23
+ // so plain http to them cannot put the bearer token on the wire. 127.0.0.0/8
24
+ // is loopback in full; URL() already rewrites numeric forms like 2130706433
25
+ // or 127.1 to dotted quads. Exact matches only -- localhost.example.com is not
26
+ // loopback.
27
+ function isLoopbackHostname(hostname) {
28
+ const lower = hostname.toLowerCase();
29
+ return lower === 'localhost' || lower === '[::1]' || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(lower);
30
+ }
31
+ /**
32
+ * Parse the remote KB URL and return any transport warnings. Throws when the
33
+ * value is not an http(s) URL. Messages name the field and at most the scheme
34
+ * and host -- never the raw value, which may carry user:pass@ or a query token.
35
+ *
36
+ * my-beads-db-u00.6: plain http to a non-loopback host WARNS rather than being
37
+ * refused. Refusing would break existing LAN deployments the next time they
38
+ * re-run kb_setup, and configs already on disk are never re-validated, so a
39
+ * refusal here would not close the hole for them anyway.
40
+ */
41
+ function checkRemoteUrl(remote) {
42
+ let url;
43
+ try {
44
+ url = new URL(remote);
45
+ }
46
+ catch {
47
+ throw new Error('kb_setup: remote is not a valid URL; expected http(s)://host[:port]');
48
+ }
49
+ if (url.protocol !== 'http:' && url.protocol !== 'https:') {
50
+ throw new Error(`kb_setup: remote must use http or https, got scheme "${url.protocol}"`);
51
+ }
52
+ if (url.protocol === 'http:' && !isLoopbackHostname(url.hostname)) {
53
+ return [
54
+ `remote uses plain http to non-loopback host "${url.hostname}": any KB token is sent ` +
55
+ 'in cleartext on every KB call. Use an https:// remote.',
56
+ ];
57
+ }
58
+ return [];
59
+ }
60
+ /**
61
+ * The config kb_setup merges into. Absent -> empty. Malformed (bad JSON, or
62
+ * not a JSON object) -> empty plus a warning: kb_setup is the tool an operator
63
+ * runs to REPAIR the KB config, so an unreadable file must not make it throw.
64
+ */
65
+ function readExistingConfig(warnings) {
66
+ if (!fs.existsSync(KB_CONFIG_PATH))
67
+ return {};
68
+ let parsed;
69
+ try {
70
+ parsed = JSON.parse(fs.readFileSync(KB_CONFIG_PATH, 'utf-8'));
71
+ }
72
+ catch {
73
+ // The parser's message quotes part of the file, which may hold the
74
+ // encrypted token, so it is not repeated here.
75
+ return discardMalformed(warnings, 'it is not valid JSON');
76
+ }
77
+ if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
78
+ return discardMalformed(warnings, 'it is not a JSON object');
79
+ }
80
+ return parsed;
81
+ }
82
+ function discardMalformed(warnings, reason) {
83
+ const warning = `existing KB config at ${KB_CONFIG_PATH} was discarded because ${reason}; ` +
84
+ 'any other settings it held (e.g. bible.autoCommit) must be set again.';
85
+ logWarn('kb_setup', warning);
86
+ warnings.push(warning);
87
+ return {};
88
+ }
89
+ /**
90
+ * Merge the keys kb_setup owns over the existing config; every other key is
91
+ * left as it was.
92
+ *
93
+ * - provider is written only when provider or remote is passed, so a bare
94
+ * kb_setup run to install the hook in another repo does not flip an
95
+ * install already pointed at a remote back to sqlite. A fresh file still
96
+ * gets provider "sqlite", as before.
97
+ * - token_encrypted is kept while the url is unchanged, so a re-run that only
98
+ * installs a hook or switches provider keeps working. When remote moves the
99
+ * url to a different server and no token is passed, the old token is
100
+ * dropped with a warning: sending one server's bearer token to another
101
+ * leaks the credential.
102
+ */
103
+ function applySetupInput(config, input, steps, warnings) {
104
+ if (input.provider || input.remote) {
105
+ config.provider = input.provider || 'http';
106
+ }
107
+ else if (!config.provider) {
108
+ config.provider = 'sqlite';
109
+ }
38
110
  if (input.remote) {
111
+ const urlChanged = config.url !== input.remote;
39
112
  config.url = input.remote;
113
+ if (urlChanged && !input.token && config.token_encrypted) {
114
+ delete config.token_encrypted;
115
+ const warning = 'remote changed and no token was given: the token stored for the previous ' +
116
+ 'remote was removed rather than sent to the new one. Re-run kb_setup with a token.';
117
+ logWarn('kb_setup', warning);
118
+ warnings.push(warning);
119
+ }
40
120
  }
41
121
  if (input.token) {
42
122
  config.token_encrypted = encryptPassword(input.token);
43
123
  steps.push('Stored remote token encrypted (AES-256-GCM)');
44
124
  }
45
- fs.writeFileSync(KB_CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });
125
+ }
126
+ // writeFileSync's mode applies only when it CREATES the file, and a merge
127
+ // usually rewrites an existing one, so the mode is set explicitly as well.
128
+ function writeConfig(config) {
129
+ fs.mkdirSync(path.dirname(KB_CONFIG_PATH), { recursive: true });
130
+ fs.writeFileSync(KB_CONFIG_PATH, JSON.stringify(config, null, 2), { mode: KB_CONFIG_FILE_MODE });
131
+ fs.chmodSync(KB_CONFIG_PATH, KB_CONFIG_FILE_MODE);
132
+ }
133
+ export async function kbSetup(input, anchor) {
134
+ const steps = [];
135
+ // Validate before any side effect, so a bad remote installs no hook and
136
+ // leaves any existing config untouched.
137
+ const warnings = input.remote ? checkRemoteUrl(input.remote) : [];
138
+ for (const warning of warnings) {
139
+ logWarn('kb_setup', warning);
140
+ }
141
+ // Install git post-commit hook into the calling session's own repo (kb-self.ts).
142
+ // A folder that cannot carry a KB identity skips the hook with the typed
143
+ // reason; the provider config below is machine-wide and is still written.
144
+ let repoPath = null;
145
+ try {
146
+ repoPath = resolveKbAnchor(anchor).folder;
147
+ }
148
+ catch (err) {
149
+ if (!(err instanceof KbSelfError))
150
+ throw err;
151
+ steps.push('Skipped git hook: ' + err.message);
152
+ }
153
+ if (repoPath !== null) {
154
+ if (fs.existsSync(path.join(repoPath, '.git'))) {
155
+ installKbPostCommitHook(repoPath);
156
+ steps.push('Installed git post-commit hook for KB invalidation');
157
+ }
158
+ else {
159
+ steps.push('Skipped git hook: no .git directory found at ' + repoPath);
160
+ }
161
+ }
162
+ const config = readExistingConfig(warnings);
163
+ applySetupInput(config, input, steps, warnings);
164
+ writeConfig(config);
46
165
  steps.push('Wrote KB config to ' + KB_CONFIG_PATH);
47
- return JSON.stringify({ success: true, steps });
166
+ return JSON.stringify({ success: true, steps, warnings });
48
167
  }
49
168
  //# sourceMappingURL=kb-setup.js.map
@@ -1,20 +1,21 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
2
3
  export declare const kbStatsSchema: z.ZodObject<{
3
- repo: z.ZodOptional<z.ZodString>;
4
- 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>;
5
7
  symbols: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6
- repo_remote_url: z.ZodOptional<z.ZodString>;
7
8
  }, "strip", z.ZodTypeAny, {
9
+ repo?: unknown;
8
10
  symbols?: string[] | undefined;
9
- repo_path?: string | undefined;
10
- repo_remote_url?: string | undefined;
11
- repo?: string | undefined;
11
+ repo_path?: unknown;
12
+ repo_remote_url?: unknown;
12
13
  }, {
14
+ repo?: unknown;
13
15
  symbols?: string[] | undefined;
14
- repo_path?: string | undefined;
15
- repo_remote_url?: string | undefined;
16
- repo?: string | undefined;
16
+ repo_path?: unknown;
17
+ repo_remote_url?: unknown;
17
18
  }>;
18
19
  export type KbStatsInput = z.infer<typeof kbStatsSchema>;
19
- export declare function kbStats(input: KbStatsInput): Promise<string>;
20
+ export declare function kbStats(input: KbStatsInput, anchor?: KbAnchor): Promise<string>;
20
21
  //# sourceMappingURL=kb-stats.d.ts.map
@@ -1,8 +1,9 @@
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
- import { getKbProviders } from '../services/knowledge/kb-providers.js';
5
- import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
5
+ import { getSelfReadKb } from '../services/knowledge/kb-self.js';
6
+ import { isSqliteProject } from '../services/knowledge/require-sqlite-project.js';
6
7
  // T2.1 (F5, D4): kb_stats -- a read-only aggregation tool, following the
7
8
  // kb_list no-bump pattern (SqliteProvider.stats() never touches use_count/
8
9
  // last_accessed). Reports the KB's health: confidence/type totals,
@@ -13,48 +14,29 @@ import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
13
14
  // bible drift is VISIBILITY for the machine that owns the KB -- CI cannot see
14
15
  // the local kb.sqlite, so no CI gate reads this tool or its drift number.
15
16
  export const kbStatsSchema = z.object({
16
- ...kbScopeFields,
17
- repo: z.string().optional()
18
- .describe('Path to the repo root for the canonical-bible drift check (.fleet/kb-canonical.json). Precedence: this explicit input, when given and valid, wins; otherwise falls back to repo_path, then to the validated session working directory (same validation as kb_export/kb_session_prime); if none validates, bible.present is reported false and drift equals the full live-CONFIRMED count -- kb_stats never fails because of this.'),
19
- // apra-fleet-src: every other kb_* tool (kb_list, kb_capture, kb_promote,
20
- // kb_session_prime, kb_export) names this input `repo_path`. kb_stats alone
21
- // took `repo`, and zod strips unknown keys silently -- so calling it the way
22
- // every sibling is called did not error, it fell back to the SERVER's cwd and
23
- // reported a fully-zeroed KB for a populated repo. A confidently wrong "there
24
- // is nothing here" is worse than a failure, because kb_stats is exactly the
25
- // tool an operator reaches for to ask whether the KB is working.
26
- repo_path: z.string().optional()
27
- .describe('Alias for `repo`, matching the input name used by every other kb_* tool. Ignored when `repo` is also supplied.'),
28
17
  symbols: z.array(z.string()).optional()
29
18
  .describe('Symbols to check coverage for: per-symbol boolean (a live CONFIRMED entry whose symbols array contains it, exact match) plus the overall fraction.'),
19
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
20
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
21
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
30
22
  });
31
- // F4 (T1.6) precedence pattern, reused here: explicit input > validated
32
- // process.cwd() > null (non-fatal -- kb_stats never throws over a bad repo
33
- // path, it just reports bible.present = false).
34
- function resolveRepoPath(explicit) {
35
- const candidate = explicit || process.cwd();
36
- if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory())
23
+ // The bible-drift read needs the anchor folder to be a readable directory on
24
+ // THIS host; null (non-fatal -- kb_stats never throws over it, it just reports
25
+ // bible.present = false) when it is not, e.g. a remote member's folder.
26
+ function localDirOrNull(folder) {
27
+ if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory())
37
28
  return null;
38
- return candidate;
29
+ return folder;
39
30
  }
40
- export async function kbStats(input) {
41
- // `repo` wins over the `repo_path` alias so existing callers are unaffected.
42
- const requestedRepo = input.repo ?? input.repo_path;
43
- // Stats must describe the repo asked about, not the server's cwd.
44
- //
45
- // apra-fleet-b4g.7: an explicitly supplied repo path is passed through
46
- // VERBATIM, exactly as kb_session_prime does (see the note at
47
- // kb-session-prime.ts:186). Routing it through resolveRepoPath() here turned
48
- // a remote member's unreachable work folder into null and then, via
49
- // `?? undefined`, into getKbProviders' `cwd ?? process.cwd()` -- so the slug
50
- // came from repo_remote_url (the REAL shared project KB) while the anchor
51
- // became the fleet server's own working directory, and every basis hash was
52
- // computed against a tree that does not describe those entries. Keeping the
53
- // caller's path means the anchor is honestly "a path this host cannot see",
54
- // which SqliteProvider.anchorIsMissing() handles by declining to produce a
55
- // freshness verdict at all. resolveRepoPath still guards the omitted-path
56
- // fallback and the bible-drift read below, which does need a readable dir.
57
- const providers = await getKbProviders(requestedRepo ?? resolveRepoPath() ?? undefined, input.repo_remote_url);
31
+ export async function kbStats(input, anchor) {
32
+ // Stats describe the calling session's own KB (kb-self.ts). A remote
33
+ // member's folder is carried verbatim even though this host cannot see it --
34
+ // SqliteProvider.anchorIsMissing() then declines to produce a freshness
35
+ // verdict rather than hashing against an unrelated tree.
36
+ // A MEMBER session reports on its checkout bible view (kb-self.ts
37
+ // getSelfReadKb): totals.by_confidence.CONFIRMED is the bible's CONFIRMED
38
+ // count. kb_stats takes no tier filter, so a member always gets the view.
39
+ const { providers, anchor: resolved } = await getSelfReadKb(anchor);
58
40
  const providerStats = await providers.project.stats({ symbols: input.symbols });
59
41
  // D5: bible.drift = count of live CONFIRMED entries whose updated_at
60
42
  // (promoted_at || created_at, matching kb_export's own field) is newer than
@@ -62,53 +44,73 @@ export async function kbStats(input) {
62
44
  // ALL live CONFIRMED entries, present = false. list({confidence:'CONFIRMED'})
63
45
  // already returns exactly the "live CONFIRMED" set (superseded_at IS NULL
64
46
  // AND stale = 0 are list()'s hardcoded defaults) without bumping use_count.
65
- let bible = { present: false, entries: 0, drift: 0 };
66
- try {
67
- const liveConfirmed = await providers.project.list({ confidence: 'CONFIRMED' });
68
- const liveUpdatedAts = liveConfirmed.map(e => e.promoted_at || e.created_at);
69
- // Degraded-safe fallback shared by every "can't use the bible file" path
70
- // below (absent, unreadable, malformed JSON, non-array shape): drift
71
- // equals ALL live CONFIRMED entries per D5, never silently lost to 0.
72
- bible = { present: false, entries: 0, drift: liveConfirmed.length };
73
- const repoPath = resolveRepoPath(requestedRepo);
74
- const biblePath = repoPath ? path.join(repoPath, '.fleet', 'kb-canonical.json') : null;
75
- if (biblePath && fs.existsSync(biblePath)) {
76
- try {
77
- const raw = fs.readFileSync(biblePath, 'utf-8');
78
- const parsed = JSON.parse(raw);
79
- // KB-TRUST PHASE 3a: the bible has two shapes -- a legacy bare array and
80
- // the v2 { version, provenance, entries } envelope. Handle BOTH: reading
81
- // only the array shape would silently report present:false and a drift
82
- // of every live CONFIRMED entry against a perfectly good v2 bible, and
83
- // this block degrades quietly by design, so that would never be noticed.
84
- const entries = Array.isArray(parsed)
85
- ? parsed
86
- : (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries))
87
- ? parsed.entries
88
- : null;
89
- if (entries !== null) {
90
- let newest = null;
91
- for (const entry of entries) {
92
- const updatedAt = entry?.updated_at;
93
- if (typeof updatedAt === 'string' && (!newest || updatedAt > newest))
94
- newest = updatedAt;
47
+ //
48
+ // my-beads-db-0cd.13: the SqliteProvider-only check sits OUTSIDE the
49
+ // degraded-safe try block below, on purpose. Previously requireSqliteProject
50
+ // sat INSIDE that try, so its throw over an HttpKbProvider project was
51
+ // swallowed by the same catch that guards a merely-missing/malformed bible
52
+ // file, and the tool returned the ambiguous { present: false, entries: 0,
53
+ // drift: 0 } -- indistinguishable from an up-to-date bible. A remote
54
+ // provider now gets its own distinguishable, non-throwing shape instead.
55
+ //
56
+ // my-beads-db-u00.3: kb_stats is the one SqliteProvider-only call site that
57
+ // DEGRADES rather than failing fast, so it asks the type question with the
58
+ // non-throwing isSqliteProject guard. Catching requireSqliteProject's throw
59
+ // as a type test would also swallow any unrelated error on that path.
60
+ let bible;
61
+ const project = providers.project;
62
+ if (!isSqliteProject(project)) {
63
+ bible = { computable: false, reason: 'bible drift is not computable over a remote HTTP provider' };
64
+ }
65
+ else {
66
+ bible = { present: false, entries: 0, drift: 0 };
67
+ try {
68
+ const liveConfirmed = await project.list({ confidence: ['CONFIRMED'] });
69
+ const liveUpdatedAts = liveConfirmed.map(e => e.promoted_at || e.created_at);
70
+ // Degraded-safe fallback shared by every "can't use the bible file" path
71
+ // below (absent, unreadable, malformed JSON, non-array shape): drift
72
+ // equals ALL live CONFIRMED entries per D5, never silently lost to 0.
73
+ bible = { present: false, entries: 0, drift: liveConfirmed.length };
74
+ const repoPath = localDirOrNull(resolved.folder);
75
+ const biblePath = repoPath ? path.join(repoPath, '.fleet', 'kb-canonical.json') : null;
76
+ if (biblePath && fs.existsSync(biblePath)) {
77
+ try {
78
+ const raw = fs.readFileSync(biblePath, 'utf-8');
79
+ const parsed = JSON.parse(raw);
80
+ // KB-TRUST PHASE 3a: the bible has two shapes -- a legacy bare array and
81
+ // the v2 { version, provenance, entries } envelope. Handle BOTH: reading
82
+ // only the array shape would silently report present:false and a drift
83
+ // of every live CONFIRMED entry against a perfectly good v2 bible, and
84
+ // this block degrades quietly by design, so that would never be noticed.
85
+ const entries = Array.isArray(parsed)
86
+ ? parsed
87
+ : (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries))
88
+ ? parsed.entries
89
+ : null;
90
+ if (entries !== null) {
91
+ let newest = null;
92
+ for (const entry of entries) {
93
+ const updatedAt = entry?.updated_at;
94
+ if (typeof updatedAt === 'string' && (!newest || updatedAt > newest))
95
+ newest = updatedAt;
96
+ }
97
+ const drift = newest === null
98
+ ? liveConfirmed.length
99
+ : liveUpdatedAts.filter(u => u > newest).length;
100
+ bible = { present: true, entries: entries.length, drift };
95
101
  }
96
- const drift = newest === null
97
- ? liveConfirmed.length
98
- : liveUpdatedAts.filter(u => u > newest).length;
99
- bible = { present: true, entries: entries.length, drift };
100
102
  }
101
- }
102
- catch {
103
- // Malformed/unreadable bible file: leave the absent-shape fallback
104
- // (drift = all live CONFIRMED) set above.
103
+ catch {
104
+ // Malformed/unreadable bible file: leave the absent-shape fallback
105
+ // (drift = all live CONFIRMED) set above.
106
+ }
105
107
  }
106
108
  }
107
- }
108
- catch {
109
- // Degraded-safe: kb_stats never throws over the bible file. Falls back to
110
- // the "absent, drift 0" shape initialized above (only reachable if the
111
- // list({confidence:'CONFIRMED'}) read itself failed).
109
+ catch {
110
+ // Degraded-safe: kb_stats never throws over the bible file. Falls back to
111
+ // the "absent, drift 0" shape initialized above (only reachable if the
112
+ // list({confidence:'CONFIRMED'}) read itself failed).
113
+ }
112
114
  }
113
115
  return JSON.stringify({ ...providerStats, bible });
114
116
  }
@@ -3,11 +3,11 @@ export declare const listMembersSchema: z.ZodObject<{
3
3
  format: z.ZodDefault<z.ZodEnum<["compact", "json"]>>;
4
4
  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5
5
  }, "strip", z.ZodTypeAny, {
6
- format: "compact" | "json";
6
+ format: "json" | "compact";
7
7
  tags?: string[] | undefined;
8
8
  }, {
9
9
  tags?: string[] | undefined;
10
- format?: "compact" | "json" | undefined;
10
+ format?: "json" | "compact" | undefined;
11
11
  }>;
12
12
  export type ListMembersInput = z.infer<typeof listMembersSchema>;
13
13
  export declare function listMembers(input?: ListMembersInput): Promise<string>;