@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
@@ -0,0 +1,156 @@
1
+ import { type AnalyzeProgress } from './code-intelligence-reindex.js';
2
+ import { type ScheduleReindexOutcome } from './code-index-heal.js';
3
+ export { readGitNexusIndexState, type GitNexusIndexState } from './code-index-state.js';
4
+ export type CodeIntelErrorCode = 'E-CODE-INDEX-NOT-READY' | 'E-CODE-INTEL-DISABLED';
5
+ export declare class CodeIntelError extends Error {
6
+ readonly code: CodeIntelErrorCode;
7
+ readonly remediation: string;
8
+ /**
9
+ * Machine-readable detail returned beside the one-line message as the error
10
+ * tool result's `structuredContent` (the tool wrapper in
11
+ * src/services/tool-registry.ts maps any thrown error carrying it). Set on
12
+ * every E-CODE-INDEX-NOT-READY (IndexNotReadyData); absent otherwise.
13
+ */
14
+ readonly structuredContent?: Record<string, unknown>;
15
+ /**
16
+ * The text the tool result carries. An MCP client may hand its model only
17
+ * the text of an error result (Claude Code does), so the retry guidance and
18
+ * build progress in structuredContent are repeated here, still on one line.
19
+ */
20
+ readonly toolText: string;
21
+ constructor(code: CodeIntelErrorCode, problem: string, remediation: string, structuredContent?: Record<string, unknown>);
22
+ }
23
+ /**
24
+ * Suggested wait before the single retry while a build runs or was just
25
+ * requested, when the folder has no earlier build to estimate from: every
26
+ * fleet-run analyze is a full rebuild, measured at 126-261 s on a repo of about
27
+ * 43000 graph nodes. With an earlier build the wait is what should remain of
28
+ * it (expectedBuildRemainingMs).
29
+ */
30
+ export declare const RETRY_AFTER_BUILDING_MS = 180000;
31
+ /** Suggested wait when a build finished moments ago (the scheduler's cooldown). */
32
+ export declare const RETRY_AFTER_COOLDOWN_MS = 60000;
33
+ /** Suggested wait when the index changed under a call (a rebuild may already be done). */
34
+ export declare const RETRY_AFTER_CHANGED_MS = 5000;
35
+ /**
36
+ * The structured data on every E-CODE-INDEX-NOT-READY tool result
37
+ * (`structuredContent`), also rendered into the one-line result text
38
+ * (CodeIntelError.toolText):
39
+ *
40
+ * retry_after_ms -- always a number: how long to wait before ONE retry.
41
+ * 0 together with retry_will_help: false when no build
42
+ * is running and none could be requested, so waiting
43
+ * and retrying will not help (follow the remediation or
44
+ * fall back).
45
+ * retry_will_help -- false when no build is running and none was requested.
46
+ * state -- the readiness state ('changed' for an answer discarded
47
+ * because the index changed while the call ran).
48
+ * build -- 'running' (an analyze is live), 'requested' (one was
49
+ * just started for this call), or 'none'.
50
+ * heal -- the automatic build outcome when one was attempted
51
+ * ('started' or the scheduler's not-started reason).
52
+ * progress -- the live analyze's phase, elapsed time, last log line
53
+ * and line count (as code_status shows) when one is
54
+ * recorded for the folder.
55
+ */
56
+ export interface IndexNotReadyData {
57
+ code: 'E-CODE-INDEX-NOT-READY';
58
+ provider: CodeIndexProvider;
59
+ state: CodeIndexNotReadyState | 'changed';
60
+ retry_after_ms: number;
61
+ retry_will_help: boolean;
62
+ build: 'running' | 'requested' | 'none';
63
+ heal?: string;
64
+ progress?: AnalyzeProgress;
65
+ }
66
+ export type CodeIndexProvider = 'gitnexus' | 'codebase-memory';
67
+ /**
68
+ * Why an index is not ready:
69
+ * building -- an analyze is live (this server's run, a held analyze lock,
70
+ * or a recorded run whose pid is alive);
71
+ * interrupted -- meta.json says incrementalInProgress but no analyze is live:
72
+ * a run died mid-write and nothing will finish it;
73
+ * missing -- no usable index and no analyze is live;
74
+ * inconsistent -- the index looks complete but its metadata disagrees with
75
+ * itself (gitnexus's registry, or fleet's record of its last
76
+ * build, names a different commit than meta.json), and no
77
+ * analyze is live: a torn write whose answers cannot be
78
+ * trusted. `detail` says which copies disagree.
79
+ */
80
+ export type CodeIndexNotReadyState = 'missing' | 'building' | 'interrupted' | 'inconsistent';
81
+ export type CodeIndexReadiness = {
82
+ ready: true;
83
+ } | {
84
+ ready: false;
85
+ state: CodeIndexNotReadyState;
86
+ detail?: string;
87
+ };
88
+ export declare const CODEBASE_MEMORY_CACHE_DIR: string;
89
+ /** The commit a gitnexus answer for `repo` is served from ('' when unknown). */
90
+ export declare function indexedCommitOf(repo: string): string;
91
+ /**
92
+ * THE readiness check for a code index -- the one place that decides whether
93
+ * a provider can answer for `repo`. Never throws; any IO failure reads as
94
+ * not ready.
95
+ *
96
+ * gitnexus -- ready when <repo>/.gitnexus/meta.json has a non-empty
97
+ * lastCommit AND no incrementalInProgress flag AND no
98
+ * analyze is live (see 'building' below) AND the
99
+ * metadata is consistent (indexInconsistency). An
100
+ * analyze rewrites the index IN PLACE, so a complete-
101
+ * looking meta.json under a live analyze is NOT served:
102
+ * that is the fence that keeps a half-rewritten graph
103
+ * from answering. A placeholder meta.json
104
+ * (lastCommit '') is NOT an index. Not ready is
105
+ * 'building' while an analyze is LIVE -- this server's
106
+ * own run, a held analyze lock, or a status.json run
107
+ * (codeIndexDir) whose pid is alive, which covers a run
108
+ * left by a previous server instance where the gitnexus
109
+ * lock is a socket with no file (Windows/Linux). With no
110
+ * live analyze, a meta.json still flagged
111
+ * incrementalInProgress is 'interrupted' (a run died
112
+ * mid-write), anything else 'missing' -- both are dead
113
+ * states the code_* pre-flight heals by starting a build.
114
+ * codebase-memory -- ready when its cache dir holds at least one project
115
+ * database; it exposes no building signal.
116
+ *
117
+ * Pure: never starts anything (fleet/member health reports call it too).
118
+ */
119
+ export declare function codeIndexReadiness(provider: CodeIndexProvider, repo?: string): CodeIndexReadiness;
120
+ /**
121
+ * What the pre-flight did about a not-ready index: the scheduler's outcome, or
122
+ * 'remote-member' when the work folder is not on this host (nothing can be
123
+ * built here). Omitted when no heal was attempted.
124
+ */
125
+ export type IndexHealOutcome = ScheduleReindexOutcome | {
126
+ started: false;
127
+ reason: 'remote-member';
128
+ detail?: string;
129
+ };
130
+ /** The typed error for a readiness result that is not ready. */
131
+ export declare function indexNotReadyError(provider: CodeIndexProvider, repo: string | undefined, state: CodeIndexNotReadyState, heal?: IndexHealOutcome, detail?: string): CodeIntelError;
132
+ /**
133
+ * The typed error for an answer discarded because the index changed while the
134
+ * call ran: `after` is readiness re-read once the call returned. Not ready ->
135
+ * the error for that state; still ready -> the index was replaced (an analyze
136
+ * finished) mid-call. Either way: retry.
137
+ */
138
+ export declare function indexChangedDuringCallError(repo: string, after: CodeIndexReadiness): CodeIntelError;
139
+ /** Throw E-CODE-INDEX-NOT-READY unless the provider's index for `repo` is ready. Never starts a build. */
140
+ export declare function assertCodeIndexReady(provider: CodeIndexProvider, repo?: string): void;
141
+ /**
142
+ * The gitnexus code_* pre-flight: return when `repo`'s index is ready, else
143
+ * throw E-CODE-INDEX-NOT-READY -- but first HEAL a dead index. A 'missing',
144
+ * 'interrupted' or 'inconsistent' index gets a background build (scheduleIndexBuild: config-,
145
+ * cooldown- and single-flight-gated, never throws), so a stale or crashed
146
+ * index recovers without anyone running analyze by hand; the error then says
147
+ * whether a build started or why not. Never schedules for a 'building' index,
148
+ * nor for a work folder that is not on this host (`remote`, or absent here):
149
+ * that error says so instead.
150
+ */
151
+ export declare function ensureGitNexusIndexReady(repo: string, opts?: {
152
+ remote?: boolean;
153
+ }): void;
154
+ /** The typed error every NullProvider method throws. */
155
+ export declare function codeIntelDisabledError(method: string): CodeIntelError;
156
+ //# sourceMappingURL=code-intelligence-readiness.d.ts.map
@@ -0,0 +1,291 @@
1
+ // Typed code_* errors and the single code-index readiness check.
2
+ //
3
+ // Kept in its own module -- NOT importing from code-intelligence.ts -- so the
4
+ // provider files (code-intelligence-gitnexus.ts, -codebase-memory.ts) can
5
+ // import it as a value without a circular import (same reason as
6
+ // code-intelligence-reindex.ts).
7
+ //
8
+ // Errors are THROWN, never returned as a result object: the code_* handlers
9
+ // JSON.stringify a provider result into an ok envelope, so a returned
10
+ // "error-shaped" object would read as success to the caller. A thrown error
11
+ // becomes an isError tool result at the MCP boundary. Each message is one
12
+ // line, 'CODE: problem Remediation: ...' -- the same pattern as KbSelfError
13
+ // (src/services/knowledge/kb-self.ts).
14
+ import { existsSync, readdirSync } from 'fs';
15
+ import { homedir } from 'os';
16
+ import { join } from 'path';
17
+ import { analyzeProgress, expectedBuildRemainingMs, isRecordedAnalyzeAlive, isReindexRunning, recordedIndexBuild } from './code-intelligence-reindex.js';
18
+ import { indexInconsistency, readGitNexusIndexState } from './code-index-state.js';
19
+ import { scheduleIndexBuild } from './code-index-heal.js';
20
+ import { missingOnServerPathMessage } from '../utils/find-on-path.js';
21
+ export { readGitNexusIndexState } from './code-index-state.js';
22
+ export class CodeIntelError extends Error {
23
+ code;
24
+ remediation;
25
+ /**
26
+ * Machine-readable detail returned beside the one-line message as the error
27
+ * tool result's `structuredContent` (the tool wrapper in
28
+ * src/services/tool-registry.ts maps any thrown error carrying it). Set on
29
+ * every E-CODE-INDEX-NOT-READY (IndexNotReadyData); absent otherwise.
30
+ */
31
+ structuredContent;
32
+ /**
33
+ * The text the tool result carries. An MCP client may hand its model only
34
+ * the text of an error result (Claude Code does), so the retry guidance and
35
+ * build progress in structuredContent are repeated here, still on one line.
36
+ */
37
+ toolText;
38
+ constructor(code, problem, remediation, structuredContent) {
39
+ super(`${code}: ${problem} Remediation: ${remediation}`);
40
+ this.name = 'CodeIntelError';
41
+ this.code = code;
42
+ this.remediation = remediation;
43
+ if (structuredContent)
44
+ this.structuredContent = structuredContent;
45
+ this.toolText = this.message + retryGuidanceText(structuredContent);
46
+ }
47
+ }
48
+ /** One-line rendering of IndexNotReadyData for the tool result text ('' when there is none). */
49
+ function retryGuidanceText(data) {
50
+ if (!data || typeof data.retry_after_ms !== 'number')
51
+ return '';
52
+ const fields = [`retry_after_ms=${data.retry_after_ms}`, `retry_will_help=${data.retry_will_help}`, `build=${data.build}`, `state=${data.state}`];
53
+ if (typeof data.heal === 'string')
54
+ fields.push(`heal=${data.heal}`);
55
+ const p = data.progress;
56
+ if (p) {
57
+ const last = String(p.last_line ?? '').replace(/\s+/g, ' ').trim().slice(0, 200);
58
+ fields.push(`progress: phase=${p.phase} elapsed_ms=${p.elapsed_ms} line_count=${p.line_count} last_line='${last}'`);
59
+ }
60
+ const advice = data.retry_after_ms > 0
61
+ ? 'Wait retry_after_ms once, retry once, then fall back to text search; do not poll code_status in a loop.'
62
+ : 'Waiting and retrying will not help: follow the remediation or fall back to text search.';
63
+ return ` ${advice} [${fields.join(' ')}]`;
64
+ }
65
+ /**
66
+ * Suggested wait before the single retry while a build runs or was just
67
+ * requested, when the folder has no earlier build to estimate from: every
68
+ * fleet-run analyze is a full rebuild, measured at 126-261 s on a repo of about
69
+ * 43000 graph nodes. With an earlier build the wait is what should remain of
70
+ * it (expectedBuildRemainingMs).
71
+ */
72
+ export const RETRY_AFTER_BUILDING_MS = 180_000;
73
+ /** Suggested wait when a build finished moments ago (the scheduler's cooldown). */
74
+ export const RETRY_AFTER_COOLDOWN_MS = 60_000;
75
+ /** Suggested wait when the index changed under a call (a rebuild may already be done). */
76
+ export const RETRY_AFTER_CHANGED_MS = 5_000;
77
+ /** The wait for a build that is running or was just requested for `repo`. */
78
+ function buildingRetryMs(repo) {
79
+ return (repo ? expectedBuildRemainingMs(repo) : null) ?? RETRY_AFTER_BUILDING_MS;
80
+ }
81
+ function notReadyData(provider, repo, state, build, retryAfterMs, heal) {
82
+ const data = {
83
+ code: 'E-CODE-INDEX-NOT-READY',
84
+ provider,
85
+ state,
86
+ retry_after_ms: retryAfterMs,
87
+ retry_will_help: retryAfterMs > 0,
88
+ build,
89
+ };
90
+ if (heal !== undefined)
91
+ data.heal = heal;
92
+ if (provider === 'gitnexus' && repo) {
93
+ const progress = analyzeProgress(repo);
94
+ if (progress)
95
+ data.progress = progress;
96
+ }
97
+ return data;
98
+ }
99
+ // codebase-memory-mcp's default database storage directory (its README
100
+ // "Persistence" section: SQLite databases under ~/.cache/codebase-memory-mcp/).
101
+ export const CODEBASE_MEMORY_CACHE_DIR = join(homedir(), '.cache', 'codebase-memory-mcp');
102
+ /** The commit a gitnexus answer for `repo` is served from ('' when unknown). */
103
+ export function indexedCommitOf(repo) {
104
+ return readGitNexusIndexState(repo).lastCommit;
105
+ }
106
+ /**
107
+ * THE readiness check for a code index -- the one place that decides whether
108
+ * a provider can answer for `repo`. Never throws; any IO failure reads as
109
+ * not ready.
110
+ *
111
+ * gitnexus -- ready when <repo>/.gitnexus/meta.json has a non-empty
112
+ * lastCommit AND no incrementalInProgress flag AND no
113
+ * analyze is live (see 'building' below) AND the
114
+ * metadata is consistent (indexInconsistency). An
115
+ * analyze rewrites the index IN PLACE, so a complete-
116
+ * looking meta.json under a live analyze is NOT served:
117
+ * that is the fence that keeps a half-rewritten graph
118
+ * from answering. A placeholder meta.json
119
+ * (lastCommit '') is NOT an index. Not ready is
120
+ * 'building' while an analyze is LIVE -- this server's
121
+ * own run, a held analyze lock, or a status.json run
122
+ * (codeIndexDir) whose pid is alive, which covers a run
123
+ * left by a previous server instance where the gitnexus
124
+ * lock is a socket with no file (Windows/Linux). With no
125
+ * live analyze, a meta.json still flagged
126
+ * incrementalInProgress is 'interrupted' (a run died
127
+ * mid-write), anything else 'missing' -- both are dead
128
+ * states the code_* pre-flight heals by starting a build.
129
+ * codebase-memory -- ready when its cache dir holds at least one project
130
+ * database; it exposes no building signal.
131
+ *
132
+ * Pure: never starts anything (fleet/member health reports call it too).
133
+ */
134
+ export function codeIndexReadiness(provider, repo) {
135
+ try {
136
+ if (provider === 'codebase-memory') {
137
+ const ready = existsSync(CODEBASE_MEMORY_CACHE_DIR) && readdirSync(CODEBASE_MEMORY_CACHE_DIR).length > 0;
138
+ return ready ? { ready: true } : { ready: false, state: 'missing' };
139
+ }
140
+ if (!repo)
141
+ return { ready: true };
142
+ const idx = readGitNexusIndexState(repo);
143
+ // Live analyze first: it may be rewriting an index whose meta.json still
144
+ // reads as complete.
145
+ if (idx.lockHeld || isReindexRunning(repo) || isRecordedAnalyzeAlive(repo))
146
+ return { ready: false, state: 'building' };
147
+ if (idx.metaPresent && idx.incrementalInProgress)
148
+ return { ready: false, state: 'interrupted' };
149
+ if (!idx.metaPresent || idx.lastCommit === '')
150
+ return { ready: false, state: 'missing' };
151
+ const inconsistency = indexInconsistency(repo, idx, recordedIndexBuild(repo));
152
+ if (inconsistency)
153
+ return { ready: false, state: 'inconsistent', detail: inconsistency };
154
+ return { ready: true };
155
+ }
156
+ catch {
157
+ return { ready: false, state: 'missing' };
158
+ }
159
+ }
160
+ const RETRY_SOON = 'Retry the same call in a few minutes (code_status shows the build progress).';
161
+ /** The typed error for a readiness result that is not ready. */
162
+ export function indexNotReadyError(provider, repo, state, heal, detail) {
163
+ const where = repo ? ` for '${repo}'` : '';
164
+ if (provider === 'codebase-memory') {
165
+ // codebase-memory exposes no building signal and fleet never builds its
166
+ // index: waiting will not help until someone indexes the project.
167
+ return new CodeIntelError('E-CODE-INDEX-NOT-READY', `No codebase-memory code index found${where}.`, `Say "Index this project" to your agent (or run 'codebase-memory-mcp cli index_repository' on the repo), then retry.`, notReadyData(provider, repo, state, 'none', 0));
168
+ }
169
+ if (state === 'building') {
170
+ return new CodeIntelError('E-CODE-INDEX-NOT-READY', `The gitnexus code index${where} is still being built.`, RETRY_SOON, notReadyData(provider, repo, state, 'running', buildingRetryMs(repo)));
171
+ }
172
+ const problem = state === 'interrupted'
173
+ ? `The gitnexus code index${where} is marked incomplete and no running analyze was found.`
174
+ : state === 'inconsistent'
175
+ ? `The gitnexus code index${where} has inconsistent metadata${detail ? ` (${detail})` : ''}, so its answers cannot be trusted.`
176
+ : `No gitnexus code index found${where}.`;
177
+ const [what, remediation] = healText(heal);
178
+ const [build, retryAfterMs] = healRetry(heal, repo);
179
+ const healName = heal ? (heal.started ? 'started' : heal.reason) : undefined;
180
+ return new CodeIntelError('E-CODE-INDEX-NOT-READY', `${problem}${what}`, remediation, notReadyData(provider, repo, state, build, retryAfterMs, healName));
181
+ }
182
+ /** [sentence appended to the problem, remediation] for a heal outcome. */
183
+ function healText(heal) {
184
+ const detail = heal && !heal.started && heal.detail ? ` (${heal.detail})` : '';
185
+ if (!heal)
186
+ return ['', 'Call code_reindex to build the index, then retry the same call.'];
187
+ if (heal.started)
188
+ return [' An index build was requested automatically.', RETRY_SOON];
189
+ switch (heal.reason) {
190
+ case 'already-running':
191
+ return [' An index build is already running.', RETRY_SOON];
192
+ case 'paused': {
193
+ const p = heal.pause;
194
+ const last = p.lastLine ? `, last line '${p.lastLine}'` : '';
195
+ return [
196
+ ` Automatic rebuilds for this folder are paused: the last automatic analyze ended '${p.result}' without a ready index (log: ${p.logPath}${last}).`,
197
+ 'Read that log, fix the cause, then call code_reindex -- it retries the build and re-arms automatic rebuilds.',
198
+ ];
199
+ }
200
+ case 'disabled':
201
+ return [
202
+ ' Automatic index builds are off (autoReindex.enabled is false in the code-intelligence config.json).',
203
+ 'Call code_reindex to build the index, then retry the same call.',
204
+ ];
205
+ case 'cooldown':
206
+ return [
207
+ ` An index build finished moments ago${detail}.`,
208
+ 'Retry the same call in a minute or so; if it still fails, check code_status and call code_reindex.',
209
+ ];
210
+ case 'npx-not-found':
211
+ // heal.detail is spawnAnalyze's npxUnavailableReason(): which tool is
212
+ // missing (npx or node), the PATH searched, and the install/refresh
213
+ // remedy -- the same text code_reindex reports.
214
+ return [
215
+ ' The fleet server cannot start a build: a tool it needs is not on its PATH.',
216
+ `${heal.detail || missingOnServerPathMessage('npx')} Then retry the same call.`,
217
+ ];
218
+ case 'remote-member':
219
+ return [
220
+ ' The work folder is not on this host, so this server cannot build an index for it.',
221
+ 'Use the code_* tools from a session on the host that holds the work folder (code_reindex there builds the index), then retry.',
222
+ ];
223
+ default:
224
+ return [
225
+ ` Starting an automatic index build failed: ${heal.reason}${detail}.`,
226
+ 'Read the analyze log via code_status, then call code_reindex and retry.',
227
+ ];
228
+ }
229
+ }
230
+ /** [build, retry_after_ms] for a heal outcome: only a running/requested build or a cooldown is worth waiting for. */
231
+ function healRetry(heal, repo) {
232
+ if (!heal)
233
+ return ['none', 0];
234
+ if (heal.started)
235
+ return ['requested', buildingRetryMs(repo)];
236
+ if (heal.reason === 'already-running')
237
+ return ['running', buildingRetryMs(repo)];
238
+ if (heal.reason === 'cooldown')
239
+ return ['none', RETRY_AFTER_COOLDOWN_MS];
240
+ return ['none', 0];
241
+ }
242
+ /**
243
+ * The typed error for an answer discarded because the index changed while the
244
+ * call ran: `after` is readiness re-read once the call returned. Not ready ->
245
+ * the error for that state; still ready -> the index was replaced (an analyze
246
+ * finished) mid-call. Either way: retry.
247
+ */
248
+ export function indexChangedDuringCallError(repo, after) {
249
+ if (!after.ready && after.state !== 'building') {
250
+ return new CodeIntelError('E-CODE-INDEX-NOT-READY', `The gitnexus code index for '${repo}' changed while this call was answered and is now ${after.state}${after.detail ? ` (${after.detail})` : ''}; the answer was discarded.`, 'Retry the same call; it requests a rebuild if one is needed (code_status shows the index state).', notReadyData('gitnexus', repo, 'changed', 'none', RETRY_AFTER_CHANGED_MS));
251
+ }
252
+ const why = after.ready ? 'was replaced by an index build' : 'started being rebuilt';
253
+ return new CodeIntelError('E-CODE-INDEX-NOT-READY', `The gitnexus code index for '${repo}' ${why} while this call was answered; the answer was discarded.`, RETRY_SOON, after.ready
254
+ ? notReadyData('gitnexus', repo, 'changed', 'none', RETRY_AFTER_CHANGED_MS)
255
+ : notReadyData('gitnexus', repo, 'changed', 'running', buildingRetryMs(repo)));
256
+ }
257
+ /** Throw E-CODE-INDEX-NOT-READY unless the provider's index for `repo` is ready. Never starts a build. */
258
+ export function assertCodeIndexReady(provider, repo) {
259
+ const readiness = codeIndexReadiness(provider, repo);
260
+ if (!readiness.ready)
261
+ throw indexNotReadyError(provider, repo, readiness.state, undefined, readiness.detail);
262
+ }
263
+ /**
264
+ * The gitnexus code_* pre-flight: return when `repo`'s index is ready, else
265
+ * throw E-CODE-INDEX-NOT-READY -- but first HEAL a dead index. A 'missing',
266
+ * 'interrupted' or 'inconsistent' index gets a background build (scheduleIndexBuild: config-,
267
+ * cooldown- and single-flight-gated, never throws), so a stale or crashed
268
+ * index recovers without anyone running analyze by hand; the error then says
269
+ * whether a build started or why not. Never schedules for a 'building' index,
270
+ * nor for a work folder that is not on this host (`remote`, or absent here):
271
+ * that error says so instead.
272
+ */
273
+ export function ensureGitNexusIndexReady(repo, opts = {}) {
274
+ const readiness = codeIndexReadiness('gitnexus', repo);
275
+ if (readiness.ready)
276
+ return;
277
+ if (readiness.state === 'building')
278
+ throw indexNotReadyError('gitnexus', repo, 'building');
279
+ let local = false;
280
+ try {
281
+ local = !opts.remote && existsSync(repo);
282
+ }
283
+ catch { /* treat as not local */ }
284
+ const heal = local ? scheduleIndexBuild(repo) : { started: false, reason: 'remote-member' };
285
+ throw indexNotReadyError('gitnexus', repo, readiness.state, heal, readiness.detail);
286
+ }
287
+ /** The typed error every NullProvider method throws. */
288
+ export function codeIntelDisabledError(method) {
289
+ return new CodeIntelError('E-CODE-INTEL-DISABLED', `Code intelligence is disabled (provider 'none'), so ${method} cannot be answered.`, `Pick a provider: update_member code_intel_provider ('gitnexus' or 'codebase-memory') for this member, or set "provider" in the code-intelligence config.json (apra-fleet install), then retry.`);
290
+ }
291
+ //# sourceMappingURL=code-intelligence-readiness.js.map
@@ -1,7 +1,226 @@
1
+ import { type ChildProcess } from 'child_process';
2
+ import { type RecordedIndexBuild } from './code-index-state.js';
3
+ import type { CodeIndexNotReadyState, CodeIndexReadiness } from './code-intelligence-readiness.js';
4
+ /** Why automatic rebuilds of a repo are paused: the automatic run that failed. */
5
+ export interface AutoReindexPause {
6
+ /** Result of that run ('failed', 'incomplete', or 'up-to-date' that still left no ready index). */
7
+ result: AnalyzeResult;
8
+ lastLine: string;
9
+ logPath: string;
10
+ finished: string;
11
+ }
1
12
  export declare const DEFAULT_COOLDOWN_MS = 120000;
2
13
  export declare function shouldStartReindex(entry: {
3
14
  running: boolean;
4
15
  lastFinishedAt?: number;
5
16
  } | undefined, now: number, cooldownMs?: number): boolean;
17
+ /** True while a background reindex this server started for `repoPath` is still running. */
18
+ export declare function isReindexRunning(repoPath: string): boolean;
19
+ export type AnalyzePhase = 'starting' | 'running' | 'done';
20
+ export type AnalyzeResult = 'indexed' | 'up-to-date' | 'incomplete' | 'failed';
21
+ export interface AnalyzeStatus {
22
+ repo: string;
23
+ pid: number | null;
24
+ started: string;
25
+ lockHeld: boolean;
26
+ lastLine: string;
27
+ lineCount: number;
28
+ phase: AnalyzePhase;
29
+ result: AnalyzeResult | null;
30
+ exitCode: number | null;
31
+ finished?: string;
32
+ /** Set on a failed run whose log names a cause the fleet recognizes. */
33
+ failureCause?: AnalyzeFailureCause;
34
+ /** meta.json lastCommit when the run finished (fleet's own record of the build). */
35
+ indexedCommit?: string;
36
+ /** How long the last finished build of this folder took (estimates the wait for this one). */
37
+ previousBuildMs?: number;
38
+ }
39
+ export type NotStartedReason = 'already-running' | 'npx-not-found' | 'gitnexus-not-found' | 'spawn-failed' | 'remote-member' | 'gitnexus-too-old';
40
+ /** Directory holding analyze.log + status.json for `repo`. */
41
+ export declare function codeIndexDir(repo: string): string;
42
+ /** Resolve an executable on PATH (PATHEXT-aware on Windows) without a shell. */
43
+ export declare function findOnPath(name: string): string | null;
44
+ /**
45
+ * Fleet's record of the last analyze it finished for `repo` (status.json):
46
+ * the commit meta.json named when that run ended. null when no finished,
47
+ * successful run is recorded (or it belongs to another folder sharing the
48
+ * slug dir). Never throws.
49
+ */
50
+ export declare function recordedIndexBuild(repo: string): RecordedIndexBuild | null;
51
+ export declare const GITNEXUS_MIN_VERSION = "1.6.5";
52
+ export declare const GITNEXUS_PACKAGE_SPEC = "gitnexus@>=1.6.5";
53
+ export declare const GITNEXUS_ANALYZE_ARGS: readonly string[];
54
+ /**
55
+ * An npx argv that is safe under a shell. On Windows spawn() runs through
56
+ * cmd.exe (shell: true), where an unquoted `>=` is a redirection, so the
57
+ * version-range package spec is double-quoted there.
58
+ */
59
+ export declare function npxArgsForShell(args: readonly string[], shell: boolean): string[];
60
+ /** Failure cause: the installed gitnexus rejects --index-only (too old). */
61
+ export type AnalyzeFailureCause = 'gitnexus-too-old';
62
+ /** One-line cause + fix reported wherever the too-old failure surfaces. */
63
+ export declare const GITNEXUS_TOO_OLD_DETAIL: string;
64
+ export declare const GITNEXUS_REPO_ARTIFACTS: readonly string[];
65
+ /**
66
+ * Adds each repo-relative path to `repoPath`'s git exclude file, resolved by
67
+ * git itself (`git rev-parse --git-path info/exclude`) so a linked worktree
68
+ * (where .git is a file) uses its common dir's exclude. Synchronous, never
69
+ * throws: a failure is logged and the caller carries on. Returns true when the
70
+ * exclude file holds every entry afterwards.
71
+ */
72
+ export declare function ensureLocalGitExcluded(repoPath: string, relPaths: readonly string[]): boolean;
73
+ export declare const GITNEXUS_INJECTED_BLOCK_FILES: readonly string[];
74
+ /**
75
+ * Repo-relative agent docs of `repoPath` that still carry a gitnexus block
76
+ * injected by an earlier plain analyze run. READ-ONLY: it never edits the work
77
+ * tree (--index-only never removes such a block, so a clone dirtied before the
78
+ * fleet switched to it stays dirty until a human removes it). Never throws.
79
+ */
80
+ export declare function detectInjectedGitnexusBlocks(repoPath: string): string[];
81
+ /** The one-line WARN for a non-empty detectInjectedGitnexusBlocks() result. */
82
+ export declare function injectedBlockWarning(files: readonly string[]): string | null;
83
+ export type SpawnAnalyzeOutcome = {
84
+ started: true;
85
+ child: ChildProcess;
86
+ dir: string;
87
+ } | {
88
+ started: false;
89
+ reason: NotStartedReason;
90
+ detail?: string;
91
+ };
92
+ /**
93
+ * Synchronously start `npx -y gitnexus analyze --index-only --force` in `repoPath` (detached off win32), with
94
+ * stdout+stderr going straight to analyze.log (a file descriptor, so the run
95
+ * outlives this server) and status.json kept current until exit. Never
96
+ * throws. Does NOT apply config/cooldown -- callers decide whether to start.
97
+ * `auto` marks an automatic run: one that ends without a ready index pauses
98
+ * automatic runs for the repo (see ReindexEntry.autoPaused). An explicit run
99
+ * (auto false, i.e. code_reindex) clears any pause when it starts.
100
+ */
101
+ export declare function spawnAnalyze(repoPath: string, opts?: {
102
+ auto?: boolean;
103
+ }): SpawnAnalyzeOutcome;
104
+ /** Why an automatic reindex request did not start an analyze. */
105
+ export type ScheduleNotStartedReason = 'disabled' | 'cooldown' | 'paused' | NotStartedReason;
106
+ export type ScheduleReindexOutcome = {
107
+ started: true;
108
+ } | {
109
+ started: false;
110
+ reason: 'paused';
111
+ pause: AutoReindexPause;
112
+ detail?: string;
113
+ } | {
114
+ started: false;
115
+ reason: Exclude<ScheduleNotStartedReason, 'paused'>;
116
+ detail?: string;
117
+ };
118
+ /** The pause on automatic rebuilds of `repoPath`, or null when they are armed. */
119
+ export declare function autoReindexPause(repoPath: string): AutoReindexPause | null;
120
+ /** Re-arm automatic rebuilds of `repoPath` (an explicit code_reindex does this). */
121
+ export declare function clearAutoReindexPause(repoPath: string): void;
122
+ export declare function scheduleReindex(repoPath: string): ScheduleReindexOutcome;
123
+ /** Boolean form of scheduleReindex (the freshness-note trigger). Never throws. */
6
124
  export declare function maybeScheduleReindex(repoPath: string): boolean;
125
+ export declare const RECORDED_ANALYZE_MAX_AGE_MS: number;
126
+ /**
127
+ * True when status.json under codeIndexDir(repo) records an analyze that has
128
+ * not finished and whose pid is still alive -- e.g. one started by a PREVIOUS
129
+ * server instance that is still running. On Windows/Linux the gitnexus lock
130
+ * leaves no file, so this is the cross-process signal for such a run. A
131
+ * finished, pid-less, dead-pid or implausibly old record is not live. Never
132
+ * throws.
133
+ */
134
+ export declare function isRecordedAnalyzeAlive(repoPath: string, now?: number): boolean;
135
+ /**
136
+ * Progress of the analyze run recorded for `repo` (status.json) while it has
137
+ * not finished -- the same data code_status reports under `analyze`, reduced
138
+ * to what a caller waiting on the index needs. null when no run is recorded
139
+ * for this folder or the recorded run is done. The last line and line count
140
+ * are read from analyze.log, so they are current even for a run started by an
141
+ * earlier server instance. Never throws.
142
+ */
143
+ export interface AnalyzeProgress {
144
+ phase: AnalyzePhase;
145
+ /** Milliseconds since the run started; null when its start time is unknown. */
146
+ elapsed_ms: number | null;
147
+ last_line: string;
148
+ line_count: number;
149
+ }
150
+ export declare function analyzeProgress(repoPath: string, now?: number): AnalyzeProgress | null;
151
+ /**
152
+ * How long the live build of `repo` should still take, from the folder's last
153
+ * finished build (bounded, with a margin); null when nothing is running or no
154
+ * earlier build is recorded.
155
+ */
156
+ export declare function expectedBuildRemainingMs(repoPath: string, now?: number): number | null;
157
+ export declare const FIRST_TICK_BOUND_MS = 8000;
158
+ /** Every code_reindex response carries the commit the index is built at (null when none/remote). */
159
+ export type CodeReindexResult = {
160
+ indexedCommit: string | null;
161
+ injectedBlockFiles?: string[];
162
+ } & CodeReindexOutcome;
163
+ export type CodeReindexOutcome = {
164
+ outcome: 'started';
165
+ pid: number | null;
166
+ lastLine: string;
167
+ lockHeld: boolean;
168
+ logPath: string;
169
+ } | {
170
+ outcome: 'up-to-date';
171
+ lastLine: string;
172
+ logPath: string;
173
+ } | {
174
+ outcome: 'starting';
175
+ firstTick: false;
176
+ pid: number | null;
177
+ note: string;
178
+ logPath: string;
179
+ } | {
180
+ outcome: 'already-running';
181
+ reason: 'already-running';
182
+ detail?: string;
183
+ status: AnalyzeStatus | null;
184
+ } | {
185
+ outcome: 'not-started';
186
+ reason: NotStartedReason | 'analyze-failed';
187
+ detail?: string;
188
+ logPath?: string;
189
+ };
190
+ /**
191
+ * Start (or report) an analyze for `repo` and return after the FIRST TICK:
192
+ * analyze lock held, process alive and at least one log line; or the run
193
+ * ended with 'Already up to date'. Never claims 'started' without a tick: a
194
+ * missing npx / gitnexus, or a run that dies before ticking, is a typed
195
+ * 'not-started'. If the bound elapses with the process alive but silent the
196
+ * outcome is 'starting' (firstTick false), still not 'started'.
197
+ */
198
+ export declare function codeReindex(repo: string, boundMs?: number): Promise<CodeReindexResult>;
199
+ export interface CodeStatusResult {
200
+ repo: string;
201
+ /** status.json of the last analyze run for this folder, or null if none has run. */
202
+ analyze: AnalyzeStatus | null;
203
+ ready: boolean;
204
+ readiness: 'ready' | CodeIndexNotReadyState;
205
+ /** Why the index metadata disagrees with itself (readiness 'inconsistent'); null otherwise. */
206
+ inconsistency: string | null;
207
+ indexedCommit: string | null;
208
+ incrementalInProgress: boolean;
209
+ lockHeld: boolean;
210
+ /** analyze.log of the last run; null when no analyze has written one under this install. */
211
+ logPath: string | null;
212
+ /** Set when an automatic run failed and automatic rebuilds are paused until code_reindex. */
213
+ autoReindexPaused: AutoReindexPause | null;
214
+ /** Agent docs still carrying a gitnexus block from an earlier plain analyze; [] when clean. */
215
+ injectedBlockFiles: string[];
216
+ /** One-line WARN naming those files and the fix; null when clean. */
217
+ injectedBlockWarning: string | null;
218
+ }
219
+ /**
220
+ * status.json + live readiness + the indexed commit for `repo`. `readiness` is
221
+ * the result of THE readiness check (codeIndexReadiness), passed in by the
222
+ * caller so code_status and the code_* pre-flight can never disagree (it lives
223
+ * in a module that imports this one). Never throws on IO.
224
+ */
225
+ export declare function codeStatus(repo: string, readiness: CodeIndexReadiness): CodeStatusResult;
7
226
  //# sourceMappingURL=code-intelligence-reindex.d.ts.map