@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,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { existsSync, readFileSync } from 'fs';
2
+ import { existsSync, readFileSync, statSync } from 'fs';
3
3
  import { execFileSync } from 'child_process';
4
4
  import { join } from 'path';
5
5
  import { getAllAgents } from '../services/registry.js';
@@ -18,10 +18,20 @@ import { parseGpuUtilization } from '../utils/gpu-parser.js';
18
18
  import { getUpdateNotice } from '../services/update-check.js';
19
19
  import { getActiveLogFile } from '../utils/log-helpers.js';
20
20
  import { USAGE_LOG_PATH, ROTATED_USAGE_LOG_PATH } from './code-intelligence-telemetry.js';
21
+ import { codeIndexReadiness } from './code-intelligence-readiness.js';
21
22
  import { kbStats } from './kb-stats.js';
22
23
  import { checkVersionMismatch } from '../services/version-check.js';
24
+ import { SqliteProvider } from '../services/knowledge/sqlite-provider.js';
25
+ import { listKbScopes, knowledgeRootDir, GLOBAL_KB_SCOPE } from '../services/knowledge/kb-scopes.js';
26
+ import { resolveProjectSlug } from '../services/knowledge/project-slug.js';
27
+ import { readKbConfigFromDisk } from '../services/knowledge/kb-config.js';
23
28
  export const fleetStatusSchema = z.object({
24
29
  format: z.enum(['compact', 'json']).default('compact').describe('Output format: "compact" (default, few lines) or "json" (structured data for detailed rendering)'),
30
+ // The fleet server is one long-lived process serving every project, so its
31
+ // own working directory says nothing about which repo the caller means.
32
+ // Repo-specific sections (code-intel index health, KB bible drift) are only
33
+ // computed when the caller names the repo explicitly.
34
+ repo_path: z.string().optional().describe("Absolute path to a repo checkout. When given, fleet_status also reports that repo's code-intelligence index health and the canonical-bible drift of its KB scope. Omit it for the fleet-wide view: KB health for every project scope, no per-repo sections. The server's own working directory is never used."),
25
35
  });
26
36
  /**
27
37
  * Build the busy label for a member confirmed running via SSH process check.
@@ -99,32 +109,37 @@ async function checkAgent(agent) {
99
109
  // Process SSH connection result
100
110
  if (connResult.status === 'fulfilled' && connResult.value.ok) {
101
111
  row.status = 'online';
102
- const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
103
112
  const provider = getProvider(agent.llmProvider);
104
- // Run fleet process check and GPU utilization in parallel
105
- const [busyResult, gpuResult] = await Promise.allSettled([
106
- strategy.execCommand(cmds.fleetProcessCheck(agent.workFolder, agent.sessionId, provider.processName), 10000),
107
- strategy.execCommand(cmds.gpuUtilization(), 10000),
108
- ]);
109
- if (busyResult.status === 'fulfilled') {
110
- const output = busyResult.value.stdout.trim().toLowerCase();
111
- if (output.includes('fleet-busy')) {
112
- row.busy = busyLabel(agent.id);
113
- }
114
- else if (output.includes('other-busy')) {
115
- row.busy = 'idle*';
113
+ if (agent.llmProvider === 'none' || !provider.processName) {
114
+ row.busy = 'idle';
115
+ }
116
+ else {
117
+ const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
118
+ // Run fleet process check and GPU utilization in parallel
119
+ const [busyResult, gpuResult] = await Promise.allSettled([
120
+ strategy.execCommand(cmds.fleetProcessCheck(agent.workFolder, agent.sessionId, provider.processName), 10000),
121
+ strategy.execCommand(cmds.gpuUtilization(), 10000),
122
+ ]);
123
+ if (busyResult.status === 'fulfilled') {
124
+ const output = busyResult.value.stdout.trim().toLowerCase();
125
+ if (output.includes('fleet-busy')) {
126
+ row.busy = busyLabel(agent.id);
127
+ }
128
+ else if (output.includes('other-busy')) {
129
+ row.busy = 'idle*';
130
+ }
131
+ else {
132
+ row.busy = 'idle';
133
+ }
116
134
  }
117
135
  else {
118
- row.busy = 'idle';
136
+ row.busy = 'unknown';
119
137
  }
120
- }
121
- else {
122
- row.busy = 'unknown';
123
- }
124
- if (gpuResult.status === 'fulfilled' && row.cloudInfo) {
125
- const gpuNum = parseGpuUtilization(gpuResult.value.stdout);
126
- if (gpuNum !== undefined) {
127
- row.cloudInfo.gpuUtil = gpuNum;
138
+ if (gpuResult.status === 'fulfilled' && row.cloudInfo) {
139
+ const gpuNum = parseGpuUtilization(gpuResult.value.stdout);
140
+ if (gpuNum !== undefined) {
141
+ row.cloudInfo.gpuUtil = gpuNum;
142
+ }
128
143
  }
129
144
  }
130
145
  }
@@ -138,24 +153,29 @@ async function checkAgent(agent) {
138
153
  ]);
139
154
  if (conn.ok) {
140
155
  row.status = 'online';
141
- try {
142
- const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
143
- const provider = getProvider(agent.llmProvider);
144
- const busyCheck = await strategy.execCommand(cmds.fleetProcessCheck(agent.workFolder, agent.sessionId, provider.processName), 10000);
145
- const output = busyCheck.stdout.trim().toLowerCase();
146
- if (output.includes('fleet-busy')) {
147
- row.busy = 'BUSY';
148
- }
149
- else if (output.includes('other-busy')) {
150
- row.busy = 'idle*';
156
+ const provider = getProvider(agent.llmProvider);
157
+ if (agent.llmProvider === 'none' || !provider.processName) {
158
+ row.busy = 'idle';
159
+ }
160
+ else {
161
+ try {
162
+ const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
163
+ const busyCheck = await strategy.execCommand(cmds.fleetProcessCheck(agent.workFolder, agent.sessionId, provider.processName), 10000);
164
+ const output = busyCheck.stdout.trim().toLowerCase();
165
+ if (output.includes('fleet-busy')) {
166
+ row.busy = 'BUSY';
167
+ }
168
+ else if (output.includes('other-busy')) {
169
+ row.busy = 'idle*';
170
+ }
171
+ else {
172
+ row.busy = 'idle';
173
+ }
151
174
  }
152
- else {
153
- row.busy = 'idle';
175
+ catch {
176
+ row.busy = 'unknown';
154
177
  }
155
178
  }
156
- catch {
157
- row.busy = 'unknown';
158
- }
159
179
  }
160
180
  }
161
181
  catch {
@@ -177,7 +197,7 @@ function readGitNexusMeta(repoDir) {
177
197
  function currentHead(repoDir) {
178
198
  try {
179
199
  return execFileSync('git', ['rev-parse', 'HEAD'], {
180
- cwd: repoDir, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
200
+ cwd: repoDir, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
181
201
  }).trim();
182
202
  }
183
203
  catch {
@@ -187,7 +207,7 @@ function currentHead(repoDir) {
187
207
  function commitsBehindCount(repoDir, lastCommit, head) {
188
208
  try {
189
209
  const out = execFileSync('git', ['rev-list', '--count', `${lastCommit}..${head}`], {
190
- cwd: repoDir, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
210
+ cwd: repoDir, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
191
211
  }).trim();
192
212
  const count = Number.parseInt(out, 10);
193
213
  return Number.isFinite(count) ? count : null;
@@ -249,6 +269,10 @@ export function codeIntelligenceHealth(repoDir) {
249
269
  const meta = readGitNexusMeta(repoDir);
250
270
  if (!meta)
251
271
  return { present: false };
272
+ // Same predicate as the code_* pre-flight: a placeholder meta.json, an
273
+ // incremental-in-progress index or a held analyze lock is not an index.
274
+ if (!codeIndexReadiness('gitnexus', repoDir).ready)
275
+ return { present: false };
252
276
  const health = {
253
277
  present: true,
254
278
  nodes: meta.stats?.nodes,
@@ -300,9 +324,13 @@ function topSymbolsFragment(topSymbols) {
300
324
  return ` | top symbols (30d): ${rendered}`;
301
325
  }
302
326
  /** Render the one-line compact fleet_status code intelligence summary. */
327
+ export const CODE_INTEL_NO_REPO_REASON = 'per-repo index; pass repo_path to fleet_status (or repo to code_map) to check a repo';
303
328
  export function codeIntelligenceCompactLine(health) {
329
+ if (health.computable === false) {
330
+ return `code-intel: ${health.reason ?? CODE_INTEL_NO_REPO_REASON}` + topSymbolsFragment(health.topSymbols);
331
+ }
304
332
  if (!health.present) {
305
- return "code-intel: no index (run 'npx gitnexus analyze' or /pm index)" + topSymbolsFragment(health.topSymbols);
333
+ return "code-intel: no index (run 'npx gitnexus analyze --index-only' or /pm index)" + topSymbolsFragment(health.topSymbols);
306
334
  }
307
335
  const nodes = health.nodes ?? 0;
308
336
  const edges = health.edges ?? 0;
@@ -310,11 +338,88 @@ export function codeIntelligenceCompactLine(health) {
310
338
  const indexedAt = health.indexedAt ?? 'unknown';
311
339
  return `code-intel: index present | ${nodes} nodes / ${edges} edges / ${files} files | indexed ${indexedAt} | ${headComparisonLabel(health)}${topSymbolsFragment(health.topSymbols)}`;
312
340
  }
313
- /** Read kb_stats and shape it for fleet_status. Never throws -- any failure (DB unavailable, bad JSON) yields null so the caller omits the KB section entirely. */
314
- export async function kbHealthSummary() {
341
+ // Bible drift needs a repo checkout (.fleet/kb-canonical.json). A scope does
342
+ // not record one and the server's cwd is not a repo, so drift is reported
343
+ // only for the scope of an explicitly supplied repo_path.
344
+ export const KB_BIBLE_NO_REPO_REASON = 'bible drift needs a repo checkout; pass repo_path to fleet_status';
345
+ export const KB_BIBLE_GLOBAL_REASON = 'bible drift is not tracked for the global KB';
346
+ // Expected "not computed" states; rendering them on every compact line would
347
+ // be noise. The HTTP-provider reason is NOT here: it is a real signal.
348
+ const SILENT_BIBLE_REASONS = new Set([KB_BIBLE_NO_REPO_REASON, KB_BIBLE_GLOBAL_REASON]);
349
+ async function readScopeStats(loc) {
350
+ const provider = new SqliteProvider(loc.dbPath);
351
+ try {
352
+ await provider.init();
353
+ const { totals, stale, flagged, superseded, retrieval, promote_ratio } = await provider.stats();
354
+ return { totals, stale, flagged, superseded, retrieval, promote_ratio };
355
+ }
356
+ finally {
357
+ try {
358
+ provider.close();
359
+ }
360
+ catch { /* best effort */ }
361
+ }
362
+ }
363
+ async function bibleForRepo(repoPath) {
364
+ try {
365
+ const parsed = JSON.parse(await kbStats({}, { folder: repoPath }));
366
+ return parsed.bible ?? null;
367
+ }
368
+ catch {
369
+ return null;
370
+ }
371
+ }
372
+ function configuredProjectProvider() {
373
+ try {
374
+ return readKbConfigFromDisk().provider === 'http' ? 'http' : 'sqlite';
375
+ }
376
+ catch {
377
+ // kb-providers degrades a broken config to the local SqliteProvider.
378
+ return 'sqlite';
379
+ }
380
+ }
381
+ /**
382
+ * Enumerate every KB scope on disk and shape per-scope health for
383
+ * fleet_status. Independent of process.cwd(). Never throws -- a scope that
384
+ * cannot be read is listed under `errors`; any unexpected failure yields null
385
+ * so the caller omits the KB section entirely.
386
+ */
387
+ export async function kbHealthSummary(opts = {}) {
315
388
  try {
316
- const raw = await kbStats({});
317
- return JSON.parse(raw);
389
+ const locations = listKbScopes(opts.knowledgeDir ?? knowledgeRootDir());
390
+ let repoSlug = null;
391
+ if (opts.repoPath) {
392
+ try {
393
+ repoSlug = resolveProjectSlug(opts.repoPath);
394
+ }
395
+ catch {
396
+ repoSlug = null;
397
+ }
398
+ }
399
+ const scopes = [];
400
+ const errors = [];
401
+ let global = null;
402
+ for (const loc of locations) {
403
+ let stats;
404
+ try {
405
+ stats = await readScopeStats(loc);
406
+ }
407
+ catch (err) {
408
+ errors.push({ scope: loc.slug, error: err instanceof Error ? err.message : String(err) });
409
+ continue;
410
+ }
411
+ if (loc.slug === GLOBAL_KB_SCOPE) {
412
+ global = { scope: loc.slug, ...stats, bible: { computable: false, reason: KB_BIBLE_GLOBAL_REASON } };
413
+ continue;
414
+ }
415
+ let bible = { computable: false, reason: KB_BIBLE_NO_REPO_REASON };
416
+ if (opts.repoPath && repoSlug === loc.slug) {
417
+ bible = (await bibleForRepo(opts.repoPath)) ?? bible;
418
+ }
419
+ scopes.push({ scope: loc.slug, ...stats, bible });
420
+ }
421
+ const totalEntries = scopes.reduce((n, s) => n + s.totals.total, 0) + (global?.totals.total ?? 0);
422
+ return { projectProvider: configuredProjectProvider(), scopes, global, errors, totalEntries };
318
423
  }
319
424
  catch {
320
425
  return null;
@@ -323,20 +428,49 @@ export async function kbHealthSummary() {
323
428
  // D5 (AMENDED): with F6a auto-commit in place inside kb_export, nonzero drift
324
429
  // is an ANOMALY signal (a failed auto-commit), not a routine reminder -- the
325
430
  // wording says so explicitly. Omitted entirely when drift is not positive
326
- // (nothing anomalous to report).
431
+ // (nothing anomalous to report) or not computed for an expected reason.
327
432
  function bibleDriftFragment(bible) {
328
433
  if (!('drift' in bible))
329
- return ` | bible: ${bible.reason}`;
434
+ return SILENT_BIBLE_REASONS.has(bible.reason) ? '' : ` | bible: ${bible.reason}`;
330
435
  if (bible.drift <= 0)
331
436
  return '';
332
437
  return ` | bible: ${bible.drift} promotions behind (auto-commit may have failed -- run apra-fleet kb commit)`;
333
438
  }
334
- /** Render the one-line compact fleet_status KB health summary. */
335
- export function kbHealthCompactLine(health) {
439
+ /** Render one compact KB health line for a single scope, labeled `kb[<scope>]` when a label is given. */
440
+ export function kbHealthCompactLine(health, label) {
336
441
  const hitRatePct = health.retrieval.hit_rate === null ? 'n/a' : `${Math.round(health.retrieval.hit_rate * 100)}%`;
337
442
  const promotePct = health.promote_ratio === null ? 'n/a' : `${Math.round(health.promote_ratio * 100)}%`;
338
443
  const confirmed = health.totals.by_confidence.CONFIRMED ?? 0;
339
- return `kb: ${health.totals.total} entries (confirmed:${confirmed} stale:${health.stale} flagged:${health.flagged}) | hit-rate:${hitRatePct} | promote-ratio:${promotePct}${bibleDriftFragment(health.bible)}`;
444
+ const prefix = label ? `kb[${label}]` : 'kb';
445
+ return `${prefix}: ${health.totals.total} entries (confirmed:${confirmed} stale:${health.stale} flagged:${health.flagged}) | hit-rate:${hitRatePct} | promote-ratio:${promotePct}${bibleDriftFragment(health.bible)}`;
446
+ }
447
+ /**
448
+ * Render the compact multi-scope KB section: one summary line, then one
449
+ * indented line per non-empty scope (projects first, then global). Empty
450
+ * scopes are collapsed into a single trailing line so an unused `default`
451
+ * scope never reads as "the KB is empty".
452
+ */
453
+ export function kbHealthCompactLines(health) {
454
+ if (health.scopes.length === 0 && !health.global && health.errors.length === 0) {
455
+ return 'kb: no knowledge bases found yet (none captured on this server)';
456
+ }
457
+ const nonEmpty = health.scopes.filter(s => s.totals.total > 0);
458
+ const empty = health.scopes.filter(s => s.totals.total === 0).map(s => s.scope);
459
+ const globalNonEmpty = health.global && health.global.totals.total > 0 ? health.global : null;
460
+ if (health.global && !globalNonEmpty)
461
+ empty.push(health.global.scope);
462
+ const remoteNote = health.projectProvider === 'http' ? ' | project KBs served by remote http provider; local fallback copies shown' : '';
463
+ const lines = [];
464
+ lines.push(`kb: ${health.totalEntries} entries across ${nonEmpty.length} project scope(s)${globalNonEmpty ? ' + global' : ''}${remoteNote}`);
465
+ for (const s of nonEmpty)
466
+ lines.push(` ${kbHealthCompactLine(s, s.scope)}`);
467
+ if (globalNonEmpty)
468
+ lines.push(` ${kbHealthCompactLine(globalNonEmpty, globalNonEmpty.scope)}`);
469
+ for (const e of health.errors)
470
+ lines.push(` kb[${e.scope}]: unreadable (${e.error})`);
471
+ if (empty.length > 0)
472
+ lines.push(` kb: empty scope(s): ${empty.join(', ')}`);
473
+ return lines.join('\n');
340
474
  }
341
475
  // ---------------------------------------------------------------------------
342
476
  // Server version handshake (T2.4, F7, D6). Compares the compiled-in
@@ -398,9 +532,32 @@ export async function fleetStatus(input) {
398
532
  writeStatusline(statusOverrides);
399
533
  const updateNotice = getUpdateNotice();
400
534
  const logFile = getActiveLogFile();
535
+ // The server's process.cwd() is never consulted: it is one process serving
536
+ // every project, launched from an arbitrary directory. Repo-specific
537
+ // sections are computed only for an explicitly named, existing repo_path.
538
+ const requestedRepo = input?.repo_path;
539
+ let repoPath;
540
+ if (requestedRepo) {
541
+ try {
542
+ if (statSync(requestedRepo).isDirectory())
543
+ repoPath = requestedRepo;
544
+ }
545
+ catch {
546
+ repoPath = undefined;
547
+ }
548
+ }
401
549
  let codeIntelligence;
402
550
  try {
403
- codeIntelligence = codeIntelligenceHealth(process.cwd());
551
+ if (repoPath) {
552
+ codeIntelligence = { ...codeIntelligenceHealth(repoPath), repoPath };
553
+ }
554
+ else {
555
+ codeIntelligence = {
556
+ present: false,
557
+ computable: false,
558
+ reason: requestedRepo ? `repo_path not found: ${requestedRepo}` : CODE_INTEL_NO_REPO_REASON,
559
+ };
560
+ }
404
561
  }
405
562
  catch {
406
563
  // Defensive: codeIntelligenceHealth() already degrades gracefully
@@ -426,7 +583,7 @@ export async function fleetStatus(input) {
426
583
  // NEVER fails because of the KB.
427
584
  let kbHealth = null;
428
585
  try {
429
- kbHealth = await kbHealthSummary();
586
+ kbHealth = await kbHealthSummary({ repoPath });
430
587
  }
431
588
  catch {
432
589
  kbHealth = null;
@@ -507,7 +664,7 @@ export async function fleetStatus(input) {
507
664
  }
508
665
  t += codeIntelligenceCompactLine(codeIntelligence) + '\n';
509
666
  if (kbHealth)
510
- t += kbHealthCompactLine(kbHealth) + '\n';
667
+ t += kbHealthCompactLines(kbHealth) + '\n';
511
668
  if (versionMismatch)
512
669
  t += versionMismatchCompactLine(versionMismatch) + '\n';
513
670
  return t;
@@ -26,14 +26,14 @@ export declare const childIdAllocatorSchema: z.ZodObject<{
26
26
  pid: z.ZodOptional<z.ZodNumber>;
27
27
  floor: z.ZodOptional<z.ZodNumber>;
28
28
  }, "strip", z.ZodTypeAny, {
29
- action: "confirm" | "status" | "release" | "allocate";
29
+ action: "status" | "confirm" | "release" | "allocate";
30
30
  pid?: number | undefined;
31
31
  token?: string | undefined;
32
32
  floor?: number | undefined;
33
33
  sprint_id?: string | undefined;
34
34
  parent_id?: string | undefined;
35
35
  }, {
36
- action: "confirm" | "status" | "release" | "allocate";
36
+ action: "status" | "confirm" | "release" | "allocate";
37
37
  pid?: number | undefined;
38
38
  token?: string | undefined;
39
39
  floor?: number | undefined;
@@ -28,7 +28,7 @@ export const childIdAllocatorSchema = z.object({
28
28
  token: z.string().min(1).optional().describe('Reservation token returned by "allocate". Required for "confirm" and "release".'),
29
29
  sprint_id: z.string().min(1).optional().describe('Opaque sprint identity, for introspection/logging.'),
30
30
  pid: z.number().int().optional().describe('Caller process id, so an abandoned reservation is reclaimed via a dead-pid probe instead of waiting out the full lease.'),
31
- floor: z.number().int().min(0).optional().describe('Count of children the parent ALREADY has. On first touch of a parent the counter is seeded above this, so a pre-existing child id is never re-minted.'),
31
+ floor: z.number().int().min(0).optional().describe('Highest EXISTING child seq under the parent (e.g. 7 when .7 exists). The counter is never below this, and pooled (released) ids at or below it are discarded on every allocate, so a pre-existing child id is never re-minted.'),
32
32
  });
33
33
  export async function childIdAllocator(input) {
34
34
  const allocator = await getChildIdAllocator();
@@ -0,0 +1,8 @@
1
+ import { type ScheduleReindexOutcome } from './code-intelligence-reindex.js';
2
+ export type { ScheduleReindexOutcome } from './code-intelligence-reindex.js';
3
+ /**
4
+ * Ask for a background reindex of `repo` (config- and cooldown-gated, single
5
+ * flight per repo). Never throws.
6
+ */
7
+ export declare function scheduleIndexBuild(repo: string): ScheduleReindexOutcome;
8
+ //# sourceMappingURL=code-index-heal.d.ts.map
@@ -0,0 +1,21 @@
1
+ // The code_* pre-flight's self-heal seam: start a background index build for a
2
+ // repo whose gitnexus index is missing or was left interrupted mid-write.
3
+ //
4
+ // Its own tiny module (not inlined into code-intelligence-readiness.ts) so the
5
+ // test setup can replace exactly this one side effect -- spawning a real
6
+ // `npx gitnexus analyze` -- for every test file, while each file remains free
7
+ // to mock or spread the reindex module itself.
8
+ import { scheduleReindex } from './code-intelligence-reindex.js';
9
+ /**
10
+ * Ask for a background reindex of `repo` (config- and cooldown-gated, single
11
+ * flight per repo). Never throws.
12
+ */
13
+ export function scheduleIndexBuild(repo) {
14
+ try {
15
+ return scheduleReindex(repo);
16
+ }
17
+ catch (err) {
18
+ return { started: false, reason: 'spawn-failed', detail: err instanceof Error ? err.message : String(err) };
19
+ }
20
+ }
21
+ //# sourceMappingURL=code-index-heal.js.map
@@ -0,0 +1,45 @@
1
+ /** What the gitnexus index directory of a repo says about itself. */
2
+ export interface GitNexusIndexState {
3
+ /** <repo>/.gitnexus/meta.json exists and parses. */
4
+ metaPresent: boolean;
5
+ /** meta.lastCommit; '' for a placeholder or an absent meta. */
6
+ lastCommit: string;
7
+ /** meta.indexedAt (ISO time gitnexus stamped the build); '' when absent. */
8
+ indexedAt: string;
9
+ /** meta.incrementalInProgress is set (an analyze is mid-write or died mid-write). */
10
+ incrementalInProgress: boolean;
11
+ /** The analyze lock is held by a live process. */
12
+ lockHeld: boolean;
13
+ }
14
+ export declare function isPidAlive(pid: number): boolean;
15
+ /** Read the gitnexus index state of `repo`. Never throws. */
16
+ export declare function readGitNexusIndexState(repo: string): GitNexusIndexState;
17
+ /**
18
+ * An identity for the index generation on disk: changes whenever an analyze
19
+ * finishes (new lastCommit and/or indexedAt). '' when there is no meta.json.
20
+ * Used to notice that the index under a long-lived reader (the gitnexus MCP
21
+ * child) was replaced, and that an index changed while a call was answered.
22
+ */
23
+ export declare function indexGeneration(state: GitNexusIndexState): string;
24
+ /** What fleet recorded about the last analyze it ran for a repo. */
25
+ export interface RecordedIndexBuild {
26
+ /** meta.lastCommit right after fleet's analyze finished. */
27
+ indexedCommit: string;
28
+ /** ISO time that analyze finished. */
29
+ finished: string;
30
+ }
31
+ /**
32
+ * Why the index metadata of `repo` disagrees with itself, or null when it is
33
+ * consistent (or there is nothing to compare against). Two cross-checks, each
34
+ * skipped when its second copy is absent:
35
+ *
36
+ * - gitnexus registry: every registry entry whose storagePath is this repo's
37
+ * .gitnexus disagrees with meta.lastCommit.
38
+ * - fleet's record (`recorded`): fleet's last finished analyze saw commit X,
39
+ * meta now says Y, and meta was not rewritten by a later analyze (its
40
+ * indexedAt is not after fleet's run finished).
41
+ *
42
+ * Never throws; any IO failure reads as "no evidence of inconsistency".
43
+ */
44
+ export declare function indexInconsistency(repo: string, state: GitNexusIndexState, recorded?: RecordedIndexBuild | null): string | null;
45
+ //# sourceMappingURL=code-index-state.d.ts.map
@@ -0,0 +1,115 @@
1
+ // Pure reader of a repo's gitnexus index directory (<repo>/.gitnexus). Its own
2
+ // leaf module (no project imports) so both the readiness check and the analyze
3
+ // runner (code-intelligence-reindex.ts) can use it without a circular import.
4
+ import { existsSync, readFileSync } from 'fs';
5
+ import { homedir } from 'os';
6
+ import { join, resolve } from 'path';
7
+ // Verified against the installed gitnexus 1.6.12 package:
8
+ // - dist/storage/index-lock.js: LOCK_FILENAME = 'analyze.lock', a JSON pidfile
9
+ // ({ pid, hostname, token, ... }) in the index meta dir (<repo>/.gitnexus).
10
+ // This is the macOS/BSD (and fallback) backend; the Windows/Linux socket
11
+ // backend leaves no file, so for those hosts the file check is a no-op and
12
+ // the status.json/in-process running signal covers an analyze we started.
13
+ // A file that exists but cannot be parsed is treated as held (conservative:
14
+ // gitnexus itself treats it as a half-written live lock).
15
+ // - dist/core/index-freshness.js getIndexIncompleteReasons: meta
16
+ // `incrementalInProgress` set => 'incremental-in-progress' (index incomplete).
17
+ export function isPidAlive(pid) {
18
+ try {
19
+ process.kill(pid, 0);
20
+ return true;
21
+ }
22
+ catch (e) {
23
+ return e.code === 'EPERM';
24
+ }
25
+ }
26
+ function analyzeLockHeld(gitnexusDir) {
27
+ const lockPath = join(gitnexusDir, 'analyze.lock');
28
+ if (!existsSync(lockPath))
29
+ return false;
30
+ try {
31
+ const rec = JSON.parse(readFileSync(lockPath, 'utf8'));
32
+ if (typeof rec.pid === 'number' && Number.isInteger(rec.pid) && rec.pid > 0)
33
+ return isPidAlive(rec.pid);
34
+ }
35
+ catch { /* malformed / half-written: fall through to held */ }
36
+ return true;
37
+ }
38
+ /** Read the gitnexus index state of `repo`. Never throws. */
39
+ export function readGitNexusIndexState(repo) {
40
+ const dir = join(repo, '.gitnexus');
41
+ const state = { metaPresent: false, lastCommit: '', indexedAt: '', incrementalInProgress: false, lockHeld: false };
42
+ try {
43
+ const meta = JSON.parse(readFileSync(join(dir, 'meta.json'), 'utf8'));
44
+ state.metaPresent = true;
45
+ state.lastCommit = typeof meta.lastCommit === 'string' ? meta.lastCommit : '';
46
+ state.indexedAt = typeof meta.indexedAt === 'string' ? meta.indexedAt : '';
47
+ state.incrementalInProgress = !!meta.incrementalInProgress;
48
+ }
49
+ catch { /* absent or unparseable meta reads as no index */ }
50
+ try {
51
+ state.lockHeld = analyzeLockHeld(dir);
52
+ }
53
+ catch { /* ignore */ }
54
+ return state;
55
+ }
56
+ /**
57
+ * An identity for the index generation on disk: changes whenever an analyze
58
+ * finishes (new lastCommit and/or indexedAt). '' when there is no meta.json.
59
+ * Used to notice that the index under a long-lived reader (the gitnexus MCP
60
+ * child) was replaced, and that an index changed while a call was answered.
61
+ */
62
+ export function indexGeneration(state) {
63
+ return state.metaPresent ? `${state.lastCommit}|${state.indexedAt}` : '';
64
+ }
65
+ // gitnexus keeps a second copy of every index's metadata in its global
66
+ // registry (verified against gitnexus 1.6.12 dist/storage/global-dir.js and
67
+ // repo-manager.js): <GITNEXUS_HOME or ~/.gitnexus>/registry.json, an array of
68
+ // { path, storagePath, lastCommit, indexedAt, ... }. analyze writes meta.json
69
+ // first and registers the repo after it, so a run that dies between the two
70
+ // leaves the copies disagreeing -- and the gitnexus MCP server resolves repos
71
+ // through the registry.
72
+ function gitnexusRegistryPath() {
73
+ const home = process.env.GITNEXUS_HOME || join(homedir(), '.gitnexus');
74
+ return join(home, 'registry.json');
75
+ }
76
+ /**
77
+ * Why the index metadata of `repo` disagrees with itself, or null when it is
78
+ * consistent (or there is nothing to compare against). Two cross-checks, each
79
+ * skipped when its second copy is absent:
80
+ *
81
+ * - gitnexus registry: every registry entry whose storagePath is this repo's
82
+ * .gitnexus disagrees with meta.lastCommit.
83
+ * - fleet's record (`recorded`): fleet's last finished analyze saw commit X,
84
+ * meta now says Y, and meta was not rewritten by a later analyze (its
85
+ * indexedAt is not after fleet's run finished).
86
+ *
87
+ * Never throws; any IO failure reads as "no evidence of inconsistency".
88
+ */
89
+ export function indexInconsistency(repo, state, recorded) {
90
+ if (!state.metaPresent || state.lastCommit === '')
91
+ return null;
92
+ const short = (c) => c.slice(0, 8);
93
+ try {
94
+ const raw = JSON.parse(readFileSync(gitnexusRegistryPath(), 'utf8'));
95
+ const entries = Array.isArray(raw) ? raw : (raw && typeof raw === 'object' && Array.isArray(raw.repos) ? raw.repos : []);
96
+ const storage = resolve(repo, '.gitnexus');
97
+ const mine = entries.filter((e) => !!e && typeof e === 'object' && typeof e.storagePath === 'string'
98
+ && resolve(e.storagePath) === storage);
99
+ const commits = mine.map((e) => (typeof e.lastCommit === 'string' ? e.lastCommit : ''));
100
+ if (commits.length > 0 && !commits.includes(state.lastCommit)) {
101
+ return `gitnexus's registry records the index at ${short(commits[0]) || '(none)'} but its meta.json says ${short(state.lastCommit)}`;
102
+ }
103
+ }
104
+ catch { /* no registry, or unreadable: no evidence */ }
105
+ if (recorded && recorded.indexedCommit && recorded.indexedCommit !== state.lastCommit) {
106
+ const fin = Date.parse(recorded.finished);
107
+ const at = Date.parse(state.indexedAt);
108
+ const rewrittenLater = Number.isFinite(at) && Number.isFinite(fin) && at > fin;
109
+ if (!rewrittenLater) {
110
+ return `fleet's last analyze recorded the index at ${short(recorded.indexedCommit)} but meta.json now says ${short(state.lastCommit)}`;
111
+ }
112
+ }
113
+ return null;
114
+ }
115
+ //# sourceMappingURL=code-index-state.js.map