@apralabs/apra-fleet 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -4,18 +4,24 @@
4
4
  // code-intelligence-freshness.ts precedent: code-intelligence.ts re-exports
5
5
  // GitNexusProvider from gitnexus.ts, so anything gitnexus.ts needs at module
6
6
  // load time must live outside code-intelligence.ts).
7
- import { spawn } from 'child_process';
8
- import { readFileSync } from 'fs';
7
+ import { execFileSync, spawn } from 'child_process';
8
+ import { closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, statSync, writeFileSync, } from 'fs';
9
9
  import { homedir } from 'os';
10
- import { join } from 'path';
10
+ import { dirname, isAbsolute, join } from 'path';
11
11
  import { logWarn, logError } from '../utils/log-helpers.js';
12
+ import { findExecutableOnPath, missingOnServerPathMessage, npxUnavailableReason } from '../utils/find-on-path.js';
13
+ import { FLEET_DIR } from '../paths.js';
14
+ import { resolveProjectSlug } from '../services/knowledge/project-slug.js';
15
+ import { indexInconsistency, isPidAlive, readGitNexusIndexState } from './code-index-state.js';
16
+ import { excludeLineFor } from '../services/member-config-io.js';
17
+ import { gitExecutable } from '../os/git-executable.js';
12
18
  // Module-level per-repo state (design D3): in-memory is acceptable -- the
13
19
  // server is long-lived, and a restart just means one extra reindex.
14
20
  const state = new Map();
15
21
  const CONFIG_PATH = join(homedir(), '.apra-fleet', 'data', 'code-intelligence', 'config.json');
16
22
  export const DEFAULT_COOLDOWN_MS = 120000;
17
- // Bound how much stderr is retained for the non-zero-exit log line.
18
- const STDERR_TAIL_MAX_CHARS = 4000;
23
+ // Bound how much of the analyze log tail is read back for status / exit logging.
24
+ const LOG_TAIL_MAX_BYTES = 4000;
19
25
  // Pure decision function (design D3): single-flight per repo + cooldown. No
20
26
  // timers, no IO -- unit-testable directly. `entry` mirrors the shape the
21
27
  // module keeps internally, but as plain data (a `running` flag instead of the
@@ -42,65 +48,611 @@ function readAutoReindexConfig() {
42
48
  return {};
43
49
  }
44
50
  }
45
- // Consults config + the decision function, then spawns
46
- // `npx gitnexus analyze` with cwd = repoPath, detached, stdio ignored except
47
- // a captured tail of stderr logged on non-zero exit. Never awaited on the
48
- // tool-call path (it does not await the child), never throws -- every
49
- // failure path is logged and this function returns false instead. Returns
50
- // whether a reindex was actually started.
51
- export function maybeScheduleReindex(repoPath) {
51
+ /** True while a background reindex this server started for `repoPath` is still running. */
52
+ export function isReindexRunning(repoPath) {
53
+ return !!state.get(repoPath)?.runningChild;
54
+ }
55
+ /** Directory holding analyze.log + status.json for `repo`. */
56
+ export function codeIndexDir(repo) {
57
+ return join(FLEET_DIR, 'code-index', resolveProjectSlug(repo));
58
+ }
59
+ function statusPath(dir) { return join(dir, 'status.json'); }
60
+ function logPath(dir) { return join(dir, 'analyze.log'); }
61
+ function writeStatus(dir, status) {
52
62
  try {
53
- const config = readAutoReindexConfig();
54
- if (config.enabled === false)
55
- return false;
56
- const cooldownMs = typeof config.cooldownMs === 'number' ? config.cooldownMs : DEFAULT_COOLDOWN_MS;
57
- const existing = state.get(repoPath);
58
- const decisionEntry = existing
59
- ? { running: !!existing.runningChild, lastFinishedAt: existing.lastFinishedAt }
60
- : undefined;
61
- if (!shouldStartReindex(decisionEntry, Date.now(), cooldownMs))
63
+ const tmp = statusPath(dir) + '.tmp';
64
+ writeFileSync(tmp, JSON.stringify(status, null, 2));
65
+ renameSync(tmp, statusPath(dir));
66
+ }
67
+ catch (err) {
68
+ logWarn('code-intelligence-reindex', `could not write status.json in ${dir}: ${err instanceof Error ? err.message : String(err)}`);
69
+ }
70
+ }
71
+ function readStatusFile(dir) {
72
+ try {
73
+ return JSON.parse(readFileSync(statusPath(dir), 'utf8'));
74
+ }
75
+ catch {
76
+ return null;
77
+ }
78
+ }
79
+ /** Last up-to-LOG_TAIL_MAX_BYTES of analyze.log, split into non-empty lines. */
80
+ function readLogLines(dir) {
81
+ try {
82
+ const path = logPath(dir);
83
+ const size = statSync(path).size;
84
+ const raw = readFileSync(path, 'utf8');
85
+ const text = size > LOG_TAIL_MAX_BYTES ? raw.slice(-LOG_TAIL_MAX_BYTES) : raw;
86
+ return text.split(/\r?\n/).map((l) => l.trimEnd()).filter((l) => l.length > 0);
87
+ }
88
+ catch {
89
+ return [];
90
+ }
91
+ }
92
+ function logLineCount(dir) {
93
+ try {
94
+ return readFileSync(logPath(dir), 'utf8').split(/\r?\n/).filter((l) => l.trim().length > 0).length;
95
+ }
96
+ catch {
97
+ return 0;
98
+ }
99
+ }
100
+ /** Resolve an executable on PATH (PATHEXT-aware on Windows) without a shell. */
101
+ export function findOnPath(name) {
102
+ return findExecutableOnPath(name);
103
+ }
104
+ const GITNEXUS_MISSING = /not found|E404|404 Not Found|could not determine executable|ENOENT|ENOTFOUND|EAI_AGAIN/i;
105
+ function resultFromExit(dir, repo, code) {
106
+ if (code !== 0)
107
+ return 'failed';
108
+ if (readLogLines(dir).some((l) => /already up to date/i.test(l)))
109
+ return 'up-to-date';
110
+ const idx = readGitNexusIndexState(repo);
111
+ return idx.metaPresent && idx.lastCommit !== '' && !idx.incrementalInProgress && !indexInconsistency(repo, idx) ? 'indexed' : 'incomplete';
112
+ }
113
+ /**
114
+ * Fleet's record of the last analyze it finished for `repo` (status.json):
115
+ * the commit meta.json named when that run ended. null when no finished,
116
+ * successful run is recorded (or it belongs to another folder sharing the
117
+ * slug dir). Never throws.
118
+ */
119
+ export function recordedIndexBuild(repo) {
120
+ try {
121
+ const status = readStatusFile(codeIndexDir(repo));
122
+ if (!status || status.phase !== 'done' || !status.finished)
123
+ return null;
124
+ if (typeof status.repo === 'string' && status.repo !== repo)
125
+ return null;
126
+ if (status.result !== 'indexed' && status.result !== 'up-to-date')
127
+ return null;
128
+ if (typeof status.indexedCommit !== 'string' || status.indexedCommit === '')
129
+ return null;
130
+ return { indexedCommit: status.indexedCommit, finished: status.finished };
131
+ }
132
+ catch {
133
+ return null;
134
+ }
135
+ }
136
+ // The exact argv every fleet-initiated analyze runs. `--index-only` is
137
+ // gitnexus's pure index mode: it builds the index under .gitnexus/ but skips
138
+ // every AI-context write into the work tree (the AGENTS.md / CLAUDE.md block
139
+ // and the .claude/skills + .agents/skills folders). Without it, indexing a
140
+ // member's TARGET repo dirties tracked files a doer would then commit. An
141
+ // older gitnexus that does not know the flag fails loudly (analyze-failed with
142
+ // its "unknown option" line), never silently falls back to a writing run.
143
+ //
144
+ // The package is resolved at a pinned MINIMUM version: 1.6.5 is the first
145
+ // gitnexus release whose CLI defines --index-only (verified against the
146
+ // published tarballs: 1.6.4's dist/cli/index.js has no such option, 1.6.5's
147
+ // does). One constant feeds both the analyze argv and the MCP child argv.
148
+ export const GITNEXUS_MIN_VERSION = '1.6.5';
149
+ export const GITNEXUS_PACKAGE_SPEC = `gitnexus@>=${GITNEXUS_MIN_VERSION}`;
150
+ // -y is npx's own flag (before the package): the analyze child is hidden, so
151
+ // npx's "Ok to proceed?" install prompt would hang it unseen.
152
+ //
153
+ // `--force` makes every fleet-initiated analyze a FULL rebuild of the graph
154
+ // DB (parser output is still replayed from gitnexus's parse cache for
155
+ // unchanged files, so it costs roughly 2x an incremental run, not a cold
156
+ // build). gitnexus 1.6.12's incremental writeback -- in place and with
157
+ // GITNEXUS_ATOMIC_INCREMENTAL=1 alike -- overwrites thousands of symbol rows of
158
+ // files it did not change on a large repo (reproduced: one run after a one-line
159
+ // edit left 7774, resp. 9334, blank rows, or 9287 rows duplicating another
160
+ // row's id, in an index a fresh build had left with one row per id). Lookups of those symbols answer "not
161
+ // found", and since every later incremental run keeps unchanged rows as they
162
+ // are, the index never recovers on its own. A full rebuild also skips
163
+ // gitnexus's "Already up to date" shortcut, so code_reindex can always
164
+ // repair a corrupt index at the same commit.
165
+ export const GITNEXUS_ANALYZE_ARGS = ['-y', GITNEXUS_PACKAGE_SPEC, 'analyze', '--index-only', '--force'];
166
+ /**
167
+ * An npx argv that is safe under a shell. On Windows spawn() runs through
168
+ * cmd.exe (shell: true), where an unquoted `>=` is a redirection, so the
169
+ * version-range package spec is double-quoted there.
170
+ */
171
+ export function npxArgsForShell(args, shell) {
172
+ return args.map((a) => (shell && /[<>^&|]/.test(a) ? `"${a}"` : a));
173
+ }
174
+ /** The CLI parser's rejection of the flag, as it lands in analyze.log. */
175
+ const UNKNOWN_INDEX_ONLY = /unknown option\b.*--index-only|--index-only.*unknown option|unrecognized (?:option|argument)\b.*--index-only/i;
176
+ /** One-line cause + fix reported wherever the too-old failure surfaces. */
177
+ export const GITNEXUS_TOO_OLD_DETAIL = `the installed gitnexus does not support --index-only (needs >= ${GITNEXUS_MIN_VERSION}): upgrade gitnexus ` +
178
+ `(npx -y ${GITNEXUS_PACKAGE_SPEC} analyze --index-only --force) or clear the npx cache (npm cache clean --force), then rerun code_reindex`;
179
+ function failureCauseOf(lines) {
180
+ return lines.some((l) => UNKNOWN_INDEX_ONLY.test(l)) ? 'gitnexus-too-old' : undefined;
181
+ }
182
+ // Work-tree paths an index-only analyze still creates inside the repo. They
183
+ // go into the repo's git exclude file (local, untracked) -- never .gitignore.
184
+ export const GITNEXUS_REPO_ARTIFACTS = ['.gitnexus/'];
185
+ /**
186
+ * Adds each repo-relative path to `repoPath`'s git exclude file, resolved by
187
+ * git itself (`git rev-parse --git-path info/exclude`) so a linked worktree
188
+ * (where .git is a file) uses its common dir's exclude. Synchronous, never
189
+ * throws: a failure is logged and the caller carries on. Returns true when the
190
+ * exclude file holds every entry afterwards.
191
+ */
192
+ export function ensureLocalGitExcluded(repoPath, relPaths) {
193
+ try {
194
+ const out = execFileSync(gitExecutable(), ['rev-parse', '--git-path', 'info/exclude'], {
195
+ cwd: repoPath, encoding: 'utf8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
196
+ }).trim().split(/\r?\n/)[0]?.trim() ?? '';
197
+ if (!out)
62
198
  return false;
63
- let child;
199
+ const excludePath = isAbsolute(out) ? out : join(repoPath, out);
200
+ let current = '';
64
201
  try {
65
- child = spawn('npx', ['gitnexus', 'analyze'], {
66
- cwd: repoPath,
67
- detached: true,
68
- stdio: ['ignore', 'ignore', 'pipe'],
69
- shell: process.platform === 'win32',
70
- });
202
+ current = readFileSync(excludePath, 'utf8').replace(/\r\n/g, '\n');
71
203
  }
72
- catch (err) {
73
- const detail = err instanceof Error ? err.message : String(err);
74
- logError('code-intelligence-reindex', `failed to spawn background reindex for ${repoPath}: ${detail}`);
75
- return false;
204
+ catch { /* absent: create it */ }
205
+ const have = new Set(current.split('\n').map((l) => l.trim()));
206
+ const missing = [...new Set(relPaths.map(excludeLineFor))].filter((l) => !have.has(l));
207
+ if (missing.length === 0)
208
+ return true;
209
+ const base = current.replace(/\n+$/, '');
210
+ mkdirSync(dirname(excludePath), { recursive: true });
211
+ writeFileSync(excludePath, (base ? `${base}\n` : '') + missing.join('\n') + '\n');
212
+ return true;
213
+ }
214
+ catch (err) {
215
+ logWarn('code-intelligence-reindex', `could not add ${relPaths.join(', ')} to the git exclude file of ${repoPath}: ${err instanceof Error ? err.message : String(err)}`);
216
+ return false;
217
+ }
218
+ }
219
+ // Agent docs a plain (non --index-only) `gitnexus analyze` injects its block
220
+ // into. gitnexus's cli/ai-context.js (verified in the 1.6.5 tarball) wraps the
221
+ // block in `<!-- gitnexus:start -->` ... `<!-- gitnexus:end -->` and writes it
222
+ // to AGENTS.md and CLAUDE.md at the repo root. Only a marker on a line of its
223
+ // own counts: ai-context.js itself quotes the marker inline in prose.
224
+ export const GITNEXUS_INJECTED_BLOCK_FILES = ['AGENTS.md', 'CLAUDE.md'];
225
+ const INJECTED_BLOCK_MARKER = /^<!-- gitnexus:start -->[ \t]*$/m;
226
+ /**
227
+ * Repo-relative agent docs of `repoPath` that still carry a gitnexus block
228
+ * injected by an earlier plain analyze run. READ-ONLY: it never edits the work
229
+ * tree (--index-only never removes such a block, so a clone dirtied before the
230
+ * fleet switched to it stays dirty until a human removes it). Never throws.
231
+ */
232
+ export function detectInjectedGitnexusBlocks(repoPath) {
233
+ const found = [];
234
+ for (const rel of GITNEXUS_INJECTED_BLOCK_FILES) {
235
+ try {
236
+ if (INJECTED_BLOCK_MARKER.test(readFileSync(join(repoPath, rel), 'utf8')))
237
+ found.push(rel);
76
238
  }
77
- state.set(repoPath, { runningChild: child, lastFinishedAt: existing?.lastFinishedAt });
78
- let stderrTail = '';
79
- child.stderr?.on('data', (chunk) => {
80
- stderrTail = (stderrTail + chunk.toString('utf8')).slice(-STDERR_TAIL_MAX_CHARS);
81
- });
82
- child.on('error', (err) => {
83
- state.set(repoPath, { lastFinishedAt: Date.now() });
84
- logError('code-intelligence-reindex', `background reindex process error for ${repoPath}: ${err.message}`);
85
- });
86
- child.on('exit', (code) => {
87
- state.set(repoPath, { lastFinishedAt: Date.now() });
88
- if (code !== 0) {
89
- logWarn('code-intelligence-reindex', `background reindex for ${repoPath} exited with code ${code}: ${stderrTail}`);
90
- }
239
+ catch { /* absent or unreadable: nothing to report */ }
240
+ }
241
+ return found;
242
+ }
243
+ /** The one-line WARN for a non-empty detectInjectedGitnexusBlocks() result. */
244
+ export function injectedBlockWarning(files) {
245
+ if (files.length === 0)
246
+ return null;
247
+ return `WARN: ${files.join(', ')} carries a gitnexus block injected by an earlier plain 'gitnexus analyze' run ` +
248
+ '(--index-only never removes it): remove the block between <!-- gitnexus:start --> and <!-- gitnexus:end --> and commit.';
249
+ }
250
+ /**
251
+ * Synchronously start `npx -y gitnexus analyze --index-only --force` in `repoPath` (detached off win32), with
252
+ * stdout+stderr going straight to analyze.log (a file descriptor, so the run
253
+ * outlives this server) and status.json kept current until exit. Never
254
+ * throws. Does NOT apply config/cooldown -- callers decide whether to start.
255
+ * `auto` marks an automatic run: one that ends without a ready index pauses
256
+ * automatic runs for the repo (see ReindexEntry.autoPaused). An explicit run
257
+ * (auto false, i.e. code_reindex) clears any pause when it starts.
258
+ */
259
+ export function spawnAnalyze(repoPath, opts = {}) {
260
+ const auto = opts.auto === true;
261
+ const existing = state.get(repoPath);
262
+ if (existing?.runningChild)
263
+ return { started: false, reason: 'already-running' };
264
+ if (readGitNexusIndexState(repoPath).lockHeld) {
265
+ return { started: false, reason: 'already-running', detail: 'a gitnexus analyze lock is held for this folder' };
266
+ }
267
+ const npxReason = npxUnavailableReason();
268
+ if (npxReason) {
269
+ return { started: false, reason: 'npx-not-found', detail: npxReason };
270
+ }
271
+ let dir;
272
+ let fd;
273
+ try {
274
+ dir = codeIndexDir(repoPath);
275
+ mkdirSync(dir, { recursive: true });
276
+ fd = openSync(logPath(dir), 'w');
277
+ }
278
+ catch (err) {
279
+ const detail = err instanceof Error ? err.message : String(err);
280
+ logError('code-intelligence-reindex', `cannot open analyze log for ${repoPath}: ${detail}`);
281
+ return { started: false, reason: 'spawn-failed', detail };
282
+ }
283
+ // Keep the index dir out of `git status` before analyze creates it.
284
+ ensureLocalGitExcluded(repoPath, GITNEXUS_REPO_ARTIFACTS);
285
+ let child;
286
+ try {
287
+ child = spawn('npx', npxArgsForShell(GITNEXUS_ANALYZE_ARGS, process.platform === 'win32'), {
288
+ cwd: repoPath,
289
+ // win32: NOT detached. A detached child has no console, so the
290
+ // node/git processes the cmd.exe shell starts each open a visible,
291
+ // focus-stealing console window; non-detached + windowsHide gives
292
+ // the whole tree one hidden console. The reindex still outlives the
293
+ // server: libuv lets grandchildren break away from its job object.
294
+ detached: process.platform !== 'win32',
295
+ windowsHide: true,
296
+ stdio: ['ignore', fd, fd],
297
+ shell: process.platform === 'win32',
91
298
  });
92
- child.unref();
93
- return true;
94
299
  }
95
300
  catch (err) {
96
301
  try {
97
- const detail = err instanceof Error ? err.message : String(err);
98
- logError('code-intelligence-reindex', `maybeScheduleReindex failed for ${repoPath}: ${detail}`);
302
+ closeSync(fd);
303
+ }
304
+ catch { /* ignore */ }
305
+ const detail = err instanceof Error ? err.message : String(err);
306
+ logError('code-intelligence-reindex', `failed to spawn background reindex for ${repoPath}: ${detail}`);
307
+ return { started: false, reason: 'spawn-failed', detail };
308
+ }
309
+ try {
310
+ closeSync(fd);
311
+ }
312
+ catch { /* the child holds its own copy */ }
313
+ const startedIso = new Date().toISOString();
314
+ const previousBuildMs = lastBuildDurationMs(dir);
315
+ const status = {
316
+ repo: repoPath, pid: child.pid ?? null, started: startedIso, lockHeld: false,
317
+ lastLine: '', lineCount: 0, phase: 'starting', result: null, exitCode: null,
318
+ ...(previousBuildMs !== null ? { previousBuildMs } : {}),
319
+ };
320
+ writeStatus(dir, status);
321
+ state.set(repoPath, {
322
+ runningChild: child,
323
+ runningAuto: auto,
324
+ lastFinishedAt: existing?.lastFinishedAt,
325
+ autoPaused: auto ? existing?.autoPaused : undefined,
326
+ gitnexusTooOld: auto ? existing?.gitnexusTooOld : undefined,
327
+ });
328
+ const refresh = () => {
329
+ const lines = readLogLines(dir);
330
+ status.lastLine = lines.length > 0 ? lines[lines.length - 1] : '';
331
+ status.lineCount = logLineCount(dir);
332
+ status.lockHeld = readGitNexusIndexState(repoPath).lockHeld;
333
+ if (status.phase === 'starting' && status.lineCount > 0)
334
+ status.phase = 'running';
335
+ writeStatus(dir, status);
336
+ };
337
+ const poller = setInterval(refresh, 300);
338
+ poller.unref?.();
339
+ const finish = (code, errMsg) => {
340
+ clearInterval(poller);
341
+ const lines = readLogLines(dir);
342
+ status.lastLine = lines.length > 0 ? lines[lines.length - 1] : (errMsg ?? '');
343
+ status.lineCount = logLineCount(dir);
344
+ status.lockHeld = false;
345
+ status.phase = 'done';
346
+ status.exitCode = code;
347
+ status.result = errMsg ? 'failed' : resultFromExit(dir, repoPath, code);
348
+ const failureCause = status.result === 'failed' ? failureCauseOf(lines) : undefined;
349
+ if (failureCause)
350
+ status.failureCause = failureCause;
351
+ status.finished = new Date().toISOString();
352
+ const idx = readGitNexusIndexState(repoPath);
353
+ if (idx.lastCommit)
354
+ status.indexedCommit = idx.lastCommit;
355
+ writeStatus(dir, status);
356
+ // An index whose metadata disagrees with itself is not ready either: an
357
+ // automatic run that leaves one pauses automatic rebuilds like any other.
358
+ const indexReady = idx.metaPresent && idx.lastCommit !== '' && !idx.incrementalInProgress && !indexInconsistency(repoPath, idx);
359
+ const prev = state.get(repoPath);
360
+ let autoPaused;
361
+ if (!indexReady && auto) {
362
+ autoPaused = { result: status.result, lastLine: status.lastLine, logPath: logPath(dir), finished: status.finished };
363
+ }
364
+ else if (!indexReady) {
365
+ autoPaused = prev?.autoPaused;
366
+ }
367
+ state.set(repoPath, { lastFinishedAt: Date.now(), autoPaused, gitnexusTooOld: failureCause === 'gitnexus-too-old' ? true : undefined });
368
+ // One warning per finished run: the failure detail and, for an automatic
369
+ // run, that automatic rebuilds are now paused.
370
+ const pausedNote = autoPaused && auto
371
+ ? '; automatic rebuilds paused until code_reindex or a server restart'
372
+ : '';
373
+ if (status.result === 'failed') {
374
+ logWarn('code-intelligence-reindex', `background reindex for ${repoPath} ended failed (${errMsg ?? `exit ${code}`}): ${lines.slice(-5).join(' | ')}${pausedNote}`);
375
+ }
376
+ else if (pausedNote) {
377
+ logWarn('code-intelligence-reindex', `automatic reindex for ${repoPath} ended ${status.result} without a ready index${pausedNote}`);
378
+ }
379
+ };
380
+ child.on('error', (err) => {
381
+ logError('code-intelligence-reindex', `background reindex process error for ${repoPath}: ${err.message}`);
382
+ finish(null, err.message);
383
+ });
384
+ child.on('exit', (code) => finish(code));
385
+ child.unref();
386
+ return { started: true, child, dir };
387
+ }
388
+ /** The pause on automatic rebuilds of `repoPath`, or null when they are armed. */
389
+ export function autoReindexPause(repoPath) {
390
+ return state.get(repoPath)?.autoPaused ?? null;
391
+ }
392
+ /** Re-arm automatic rebuilds of `repoPath` (an explicit code_reindex does this). */
393
+ export function clearAutoReindexPause(repoPath) {
394
+ const entry = state.get(repoPath);
395
+ if (entry?.autoPaused || entry?.gitnexusTooOld)
396
+ state.set(repoPath, { ...entry, autoPaused: undefined, gitnexusTooOld: undefined });
397
+ }
398
+ // Consults config + the decision function, then starts the shared analyze
399
+ // runner. Never awaited on the tool-call path (it does not await the child),
400
+ // never throws -- every failure path is logged and a typed not-started
401
+ // outcome is returned instead, so a caller can say WHY no build started
402
+ // (auto-reindex disabled in config, cooldown, npx missing, ...).
403
+ export function scheduleReindex(repoPath) {
404
+ try {
405
+ const config = readAutoReindexConfig();
406
+ if (config.enabled === false)
407
+ return { started: false, reason: 'disabled' };
408
+ const cooldownMs = typeof config.cooldownMs === 'number' ? config.cooldownMs : DEFAULT_COOLDOWN_MS;
409
+ const existing = state.get(repoPath);
410
+ if (existing?.runningChild)
411
+ return { started: false, reason: 'already-running' };
412
+ if (existing?.gitnexusTooOld)
413
+ return { started: false, reason: 'gitnexus-too-old', detail: GITNEXUS_TOO_OLD_DETAIL };
414
+ if (existing?.autoPaused)
415
+ return { started: false, reason: 'paused', pause: existing.autoPaused };
416
+ const decisionEntry = existing ? { running: false, lastFinishedAt: existing.lastFinishedAt } : undefined;
417
+ if (!shouldStartReindex(decisionEntry, Date.now(), cooldownMs)) {
418
+ return { started: false, reason: 'cooldown', detail: `an index build finished less than ${Math.round(cooldownMs / 1000)}s ago` };
419
+ }
420
+ const out = spawnAnalyze(repoPath, { auto: true });
421
+ return out.started ? { started: true } : { started: false, reason: out.reason, detail: out.detail };
422
+ }
423
+ catch (err) {
424
+ const detail = err instanceof Error ? err.message : String(err);
425
+ try {
426
+ logError('code-intelligence-reindex', `scheduleReindex failed for ${repoPath}: ${detail}`);
99
427
  }
100
428
  catch {
101
429
  // ignore -- logging itself must never throw out of this function
102
430
  }
431
+ return { started: false, reason: 'spawn-failed', detail };
432
+ }
433
+ }
434
+ /** Boolean form of scheduleReindex (the freshness-note trigger). Never throws. */
435
+ export function maybeScheduleReindex(repoPath) {
436
+ return scheduleReindex(repoPath).started;
437
+ }
438
+ // A recorded run older than this is never trusted as live by its pid alone:
439
+ // the pid may have been reused by an unrelated process long after the run died.
440
+ export const RECORDED_ANALYZE_MAX_AGE_MS = 6 * 60 * 60 * 1000;
441
+ /**
442
+ * True when status.json under codeIndexDir(repo) records an analyze that has
443
+ * not finished and whose pid is still alive -- e.g. one started by a PREVIOUS
444
+ * server instance that is still running. On Windows/Linux the gitnexus lock
445
+ * leaves no file, so this is the cross-process signal for such a run. A
446
+ * finished, pid-less, dead-pid or implausibly old record is not live. Never
447
+ * throws.
448
+ */
449
+ export function isRecordedAnalyzeAlive(repoPath, now = Date.now()) {
450
+ try {
451
+ const status = readStatusFile(codeIndexDir(repoPath));
452
+ if (!status || status.phase === 'done')
453
+ return false;
454
+ // codeIndexDir is keyed by project slug, which two folders can share.
455
+ if (typeof status.repo === 'string' && status.repo !== repoPath)
456
+ return false;
457
+ if (typeof status.pid !== 'number' || !Number.isInteger(status.pid) || status.pid <= 0)
458
+ return false;
459
+ const started = Date.parse(status.started);
460
+ if (Number.isFinite(started) && now - started > RECORDED_ANALYZE_MAX_AGE_MS)
461
+ return false;
462
+ // A complete index stamped AFTER the run started is that run's own final
463
+ // write: the index is no longer being rewritten, whatever the pid (which
464
+ // may have been reused) says. Readiness fences a complete index on a live
465
+ // recorded run, so this keeps a stale record from fencing it for hours.
466
+ const idx = readGitNexusIndexState(repoPath);
467
+ const indexedAt = Date.parse(idx.indexedAt);
468
+ if (idx.metaPresent && !idx.incrementalInProgress && Number.isFinite(started) && Number.isFinite(indexedAt) && indexedAt > started)
469
+ return false;
470
+ return isPidAlive(status.pid);
471
+ }
472
+ catch {
103
473
  return false;
104
474
  }
105
475
  }
476
+ export function analyzeProgress(repoPath, now = Date.now()) {
477
+ try {
478
+ const dir = codeIndexDir(repoPath);
479
+ const status = readStatusFile(dir);
480
+ if (!status || status.phase === 'done')
481
+ return null;
482
+ if (typeof status.repo === 'string' && status.repo !== repoPath)
483
+ return null;
484
+ const started = Date.parse(status.started);
485
+ const lines = readLogLines(dir);
486
+ return {
487
+ phase: status.phase,
488
+ elapsed_ms: Number.isFinite(started) ? Math.max(0, now - started) : null,
489
+ last_line: lines.length > 0 ? lines[lines.length - 1] : (status.lastLine ?? ''),
490
+ line_count: Math.max(logLineCount(dir), status.lineCount ?? 0),
491
+ };
492
+ }
493
+ catch {
494
+ return null;
495
+ }
496
+ }
497
+ /** Duration of the last run that built this folder's index, read before a new run overwrites status.json. */
498
+ function lastBuildDurationMs(dir) {
499
+ const status = readStatusFile(dir);
500
+ if (!status)
501
+ return null;
502
+ if (status.phase === 'done' && status.result === 'indexed' && status.finished) {
503
+ const ms = Date.parse(status.finished) - Date.parse(status.started);
504
+ if (Number.isFinite(ms) && ms > 0)
505
+ return ms;
506
+ }
507
+ return typeof status.previousBuildMs === 'number' ? status.previousBuildMs : null;
508
+ }
509
+ const MIN_BUILD_WAIT_MS = 15_000;
510
+ const MAX_BUILD_WAIT_MS = 600_000;
511
+ /**
512
+ * How long the live build of `repo` should still take, from the folder's last
513
+ * finished build (bounded, with a margin); null when nothing is running or no
514
+ * earlier build is recorded.
515
+ */
516
+ export function expectedBuildRemainingMs(repoPath, now = Date.now()) {
517
+ try {
518
+ const status = readStatusFile(codeIndexDir(repoPath));
519
+ if (!status || status.phase === 'done' || typeof status.previousBuildMs !== 'number')
520
+ return null;
521
+ if (typeof status.repo === 'string' && status.repo !== repoPath)
522
+ return null;
523
+ const started = Date.parse(status.started);
524
+ const elapsed = Number.isFinite(started) ? Math.max(0, now - started) : 0;
525
+ const remaining = Math.round(status.previousBuildMs * 1.2) - elapsed;
526
+ return Math.min(MAX_BUILD_WAIT_MS, Math.max(MIN_BUILD_WAIT_MS, remaining));
527
+ }
528
+ catch {
529
+ return null;
530
+ }
531
+ }
532
+ // ---------------------------------------------------------------------------
533
+ // code_reindex / code_status
534
+ // ---------------------------------------------------------------------------
535
+ export const FIRST_TICK_BOUND_MS = 8000;
536
+ const FIRST_TICK_POLL_MS = 100;
537
+ // Where the gitnexus lock is a kernel socket (Linux/Windows) there is no lock
538
+ // file to observe; after this grace a live process with output is a tick.
539
+ const LOCK_OBSERVE_GRACE_MS = 1500;
540
+ const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
541
+ /**
542
+ * Start (or report) an analyze for `repo` and return after the FIRST TICK:
543
+ * analyze lock held, process alive and at least one log line; or the run
544
+ * ended with 'Already up to date'. Never claims 'started' without a tick: a
545
+ * missing npx / gitnexus, or a run that dies before ticking, is a typed
546
+ * 'not-started'. If the bound elapses with the process alive but silent the
547
+ * outcome is 'starting' (firstTick false), still not 'started'.
548
+ */
549
+ export async function codeReindex(repo, boundMs = FIRST_TICK_BOUND_MS) {
550
+ const r = await codeReindexOutcome(repo, boundMs);
551
+ let indexedCommit = null;
552
+ try {
553
+ indexedCommit = readGitNexusIndexState(repo).lastCommit || null;
554
+ }
555
+ catch { /* never throw on IO */ }
556
+ return { ...r, indexedCommit, injectedBlockFiles: detectInjectedGitnexusBlocks(repo) };
557
+ }
558
+ async function codeReindexOutcome(repo, boundMs) {
559
+ // An explicit reindex re-arms automatic rebuilds paused by a failed automatic run.
560
+ clearAutoReindexPause(repo);
561
+ const out = spawnAnalyze(repo);
562
+ if (!out.started) {
563
+ if (out.reason === 'already-running') {
564
+ let status = null;
565
+ try {
566
+ status = readStatusFile(codeIndexDir(repo));
567
+ }
568
+ catch { /* ignore */ }
569
+ return { outcome: 'already-running', reason: 'already-running', detail: out.detail, status };
570
+ }
571
+ return { outcome: 'not-started', reason: out.reason, detail: out.detail };
572
+ }
573
+ const { child, dir } = out;
574
+ let exited = false;
575
+ let exitCode = null;
576
+ let spawnError;
577
+ child.on('exit', (c) => { exited = true; exitCode = c; });
578
+ child.on('error', (e) => { exited = true; spawnError = e.message; });
579
+ const t0 = Date.now();
580
+ const log = logPath(dir);
581
+ while (Date.now() - t0 < boundMs) {
582
+ const lines = readLogLines(dir);
583
+ const last = lines.length > 0 ? lines[lines.length - 1] : '';
584
+ if (exited) {
585
+ if (spawnError) {
586
+ const missing = /ENOENT/.test(spawnError);
587
+ const detail = missing ? `${spawnError}: ${missingOnServerPathMessage('npx')}` : spawnError;
588
+ return { outcome: 'not-started', reason: missing ? 'npx-not-found' : 'spawn-failed', detail, logPath: log };
589
+ }
590
+ if (exitCode === 0) {
591
+ if (lines.some((l) => /already up to date/i.test(l)))
592
+ return { outcome: 'up-to-date', lastLine: last, logPath: log };
593
+ return { outcome: 'started', pid: child.pid ?? null, lastLine: last, lockHeld: false, logPath: log };
594
+ }
595
+ if (failureCauseOf(lines) === 'gitnexus-too-old') {
596
+ return { outcome: 'not-started', reason: 'gitnexus-too-old', detail: GITNEXUS_TOO_OLD_DETAIL, logPath: log };
597
+ }
598
+ const missing = GITNEXUS_MISSING.test(lines.join('\n'));
599
+ return {
600
+ outcome: 'not-started',
601
+ reason: missing ? 'gitnexus-not-found' : 'analyze-failed',
602
+ detail: last || `analyze exited with code ${exitCode}`,
603
+ logPath: log,
604
+ };
605
+ }
606
+ if (lines.length > 0 && child.pid && isPidAlive(child.pid)) {
607
+ const lockHeld = readGitNexusIndexState(repo).lockHeld;
608
+ if (lockHeld || Date.now() - t0 >= LOCK_OBSERVE_GRACE_MS) {
609
+ return { outcome: 'started', pid: child.pid, lastLine: last, lockHeld, logPath: log };
610
+ }
611
+ }
612
+ await sleep(FIRST_TICK_POLL_MS);
613
+ }
614
+ return {
615
+ outcome: 'starting', firstTick: false, pid: child.pid ?? null, logPath: log,
616
+ note: 'analyze is running but has not yet produced output or taken its lock; poll code_status.',
617
+ };
618
+ }
619
+ /**
620
+ * status.json + live readiness + the indexed commit for `repo`. `readiness` is
621
+ * the result of THE readiness check (codeIndexReadiness), passed in by the
622
+ * caller so code_status and the code_* pre-flight can never disagree (it lives
623
+ * in a module that imports this one). Never throws on IO.
624
+ */
625
+ export function codeStatus(repo, readiness) {
626
+ const dir = codeIndexDir(repo);
627
+ let analyze = readStatusFile(dir);
628
+ // A run recorded as in-flight whose process is gone (server restarted mid-run)
629
+ // is reconciled from the log + index instead of reporting 'running' forever.
630
+ if (analyze && analyze.phase !== 'done' && !state.get(repo)?.runningChild && !(analyze.pid && isPidAlive(analyze.pid))) {
631
+ const lines = readLogLines(dir);
632
+ analyze = {
633
+ ...analyze,
634
+ phase: 'done',
635
+ lastLine: lines.length > 0 ? lines[lines.length - 1] : analyze.lastLine,
636
+ lockHeld: false,
637
+ // Exit code is unknown after a restart: only the index/log can confirm success.
638
+ result: resultFromExit(dir, repo, 0),
639
+ };
640
+ }
641
+ const idx = readGitNexusIndexState(repo);
642
+ const log = logPath(dir);
643
+ const injected = detectInjectedGitnexusBlocks(repo);
644
+ return {
645
+ repo, analyze,
646
+ ready: readiness.ready,
647
+ readiness: readiness.ready ? 'ready' : readiness.state,
648
+ inconsistency: !readiness.ready && readiness.state === 'inconsistent' ? (readiness.detail ?? null) : null,
649
+ indexedCommit: idx.lastCommit || null,
650
+ incrementalInProgress: idx.incrementalInProgress,
651
+ lockHeld: idx.lockHeld,
652
+ logPath: existsSync(log) ? log : null,
653
+ autoReindexPaused: autoReindexPause(repo),
654
+ injectedBlockFiles: injected,
655
+ injectedBlockWarning: injectedBlockWarning(injected),
656
+ };
657
+ }
106
658
  //# sourceMappingURL=code-intelligence-reindex.js.map