@apralabs/apra-fleet 0.4.2 → 0.4.4

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