@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
@@ -1,76 +1,189 @@
1
- import { existsSync, readFileSync } from 'fs';
1
+ import { readFileSync } from 'fs';
2
2
  import { execFileSync } from 'child_process';
3
3
  import { join } from 'path';
4
4
  import { Client } from '@modelcontextprotocol/sdk/client/index.js';
5
5
  import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
6
+ import { ErrorCode } from '@modelcontextprotocol/sdk/types.js';
6
7
  import { freshnessNote } from './code-intelligence-freshness.js';
7
- import { maybeScheduleReindex } from './code-intelligence-reindex.js';
8
+ import { maybeScheduleReindex, GITNEXUS_PACKAGE_SPEC } from './code-intelligence-reindex.js';
9
+ import { scheduleIndexBuild } from './code-index-heal.js';
8
10
  import { isTestPath } from './code-intelligence-tests.js';
11
+ import { codeIndexReadiness, ensureGitNexusIndexReady, indexChangedDuringCallError } from './code-intelligence-readiness.js';
12
+ import { indexGeneration, readGitNexusIndexState } from './code-index-state.js';
9
13
  import { logError } from '../utils/log-helpers.js';
10
- let sharedClient = null;
14
+ import { missingOnServerPathMessage, npxUnavailableReason } from '../utils/find-on-path.js';
15
+ import { gitExecutable } from '../os/git-executable.js';
16
+ import { redactKnownSecrets } from '../utils/redact-known-secrets.js';
17
+ let sharedEntry = null;
11
18
  let connectionPromise = null;
19
+ // Index generation (indexGeneration: meta lastCommit|indexedAt) each repo had
20
+ // when a child last answered for it, kept per child (ClientEntry above). The
21
+ // child is long-lived and keeps its own handle on a repo's index; when an
22
+ // analyze replaces that index on disk, the old handle can read a half-old,
23
+ // half-new graph and resolve a name to an unrelated symbol. A changed
24
+ // generation therefore recycles the child before the next call.
12
25
  // Structured, actionable "offline" result. Same shape as a normal MCP tool
13
26
  // result (content array of text plus isError) so callers never receive an
14
27
  // unhandled throw or a silent empty result -- mirrors the F3.1 error shape.
15
28
  const OFFLINE_MESSAGE = "Code intelligence is offline: the gitnexus service could not be reached. " +
16
- "Start or reinstall it by running 'npx gitnexus analyze' in the repo " +
29
+ "Start or reinstall it by running 'npx gitnexus analyze --index-only --force' in the repo " +
17
30
  "(or /pm index), then retry.";
18
31
  function offlineResult(detail) {
19
32
  const text = detail ? `${OFFLINE_MESSAGE} (${detail})` : OFFLINE_MESSAGE;
20
33
  return { content: [{ type: 'text', text }], isError: true };
21
34
  }
22
- // Structured, actionable "missing index" result (F3.1). Returned without ever
23
- // spawning or contacting the child gitnexus process when a repo has not been
24
- // indexed yet.
25
- function missingIndexResult(repo) {
26
- const text = `No code intelligence index found for ${repo}. Run 'npx gitnexus analyze' in the repo (or /pm index) and retry.`;
27
- return { content: [{ type: 'text', text }], isError: true };
35
+ // The child's stderr is the only record of why it failed (npx install errors,
36
+ // a crash on start). Reading it also keeps an unread pipe from stalling the
37
+ // child. Only the end is kept, and it is scrubbed before it is cut, so a cut
38
+ // cannot leave half a credential that the patterns no longer recognise.
39
+ const STDERR_KEEP_CHARS = 8000;
40
+ const STDERR_REPORT_CHARS = 2000;
41
+ function scrubChildText(text) {
42
+ return redactKnownSecrets(text, [])
43
+ .replace(/\x1b\[[0-9;]*[A-Za-z]/g, '')
44
+ .replace(/(_auth(?:Token)?|_password)(\s*[=:]\s*)\S+/gi, '$1$2****')
45
+ .replace(/(:\/\/)[^\s/@]+@/g, '$1****@')
46
+ .replace(/\b(?:npm_[A-Za-z0-9]{20,}|sk-ant-[A-Za-z0-9_-]+)/g, '****')
47
+ .replace(/[^\x20-\x7E]+/g, ' ');
48
+ }
49
+ function captureChildStderr(transport) {
50
+ let kept = '';
51
+ transport.stderr?.on('data', (chunk) => {
52
+ kept = (kept + String(chunk)).slice(-STDERR_KEEP_CHARS);
53
+ });
54
+ return () => scrubChildText(kept).slice(-STDERR_REPORT_CHARS);
55
+ }
56
+ /** Why the child failed: timeout or not, in which stage, how long it took, and its stderr. */
57
+ function childFailureDetail(err, stage, startedAt, stderr) {
58
+ const message = scrubChildText(err instanceof Error ? err.message : String(err));
59
+ const outcome = err?.code === ErrorCode.RequestTimeout ? 'TIMEOUT' : 'failed';
60
+ return `${outcome} during ${stage} after ${Date.now() - startedAt} ms: ${message}; child stderr: ${stderr || '(empty)'}`;
28
61
  }
29
- // Reset the shared connection state so the next call reconnects from scratch.
30
- function resetConnection() {
31
- sharedClient = null;
32
- connectionPromise = null;
62
+ function closeEntry(entry) {
63
+ if (entry.closed)
64
+ return;
65
+ entry.closed = true;
66
+ try {
67
+ const closing = entry.client.close?.();
68
+ if (closing && typeof closing.catch === 'function')
69
+ closing.catch(() => { });
70
+ }
71
+ catch { /* already gone */ }
33
72
  }
34
- async function getGitNexusClient() {
35
- if (sharedClient)
36
- return sharedClient;
73
+ /**
74
+ * Retire `entry`: if it is the shared child, unshare it so the next call
75
+ * starts a fresh one; close it now if nothing is running on it, otherwise
76
+ * when its last in-flight call is released.
77
+ */
78
+ function retireEntry(entry) {
79
+ if (sharedEntry === entry) {
80
+ sharedEntry = null;
81
+ connectionPromise = null;
82
+ }
83
+ entry.retired = true;
84
+ if (entry.inFlight === 0)
85
+ closeEntry(entry);
86
+ }
87
+ /** Retire the current child (if any) so the next call starts a fresh one. */
88
+ function recycleConnection() {
89
+ if (sharedEntry)
90
+ retireEntry(sharedEntry);
91
+ }
92
+ function releaseEntry(entry) {
93
+ entry.inFlight -= 1;
94
+ if (entry.retired && entry.inFlight === 0)
95
+ closeEntry(entry);
96
+ }
97
+ async function getGitNexusEntry() {
98
+ if (sharedEntry)
99
+ return sharedEntry;
37
100
  if (connectionPromise)
38
101
  return connectionPromise;
39
- connectionPromise = (async () => {
102
+ // Declared before the body so the body can compare it by identity (a later
103
+ // recycle may have replaced connectionPromise while connect was running).
104
+ // eslint-disable-next-line prefer-const
105
+ let pending = null;
106
+ pending = (async () => {
107
+ // Fail with the cause, not a bare "spawn npx ENOENT": a service-managed
108
+ // server only has the PATH its service definition recorded at install.
109
+ const npxReason = npxUnavailableReason();
110
+ if (npxReason)
111
+ throw new Error(npxReason); // failure reset below
40
112
  const transport = new StdioClientTransport({
41
113
  command: 'npx',
42
- args: ['-y', 'gitnexus', 'mcp'],
114
+ args: ['-y', GITNEXUS_PACKAGE_SPEC, 'mcp'],
43
115
  stderr: 'pipe',
44
116
  });
117
+ const stderrTail = captureChildStderr(transport);
45
118
  const client = new Client({ name: 'apra-fleet', version: '1.0.0' }, { capabilities: {} });
119
+ const entry = { client, inFlight: 0, retired: false, closed: false, servedGeneration: new Map(), stderrTail };
46
120
  // Transport death reset: if the child process dies (close) or the
47
- // transport/client errors after a successful connect, drop the cached
48
- // client and promise so the next call reconnects. Guard on identity so a
49
- // late handler for a client that was already replaced does not clobber a
50
- // newer connection.
121
+ // transport/client errors after a successful connect, stop handing it
122
+ // out so the next call reconnects. Guard on identity so a late handler
123
+ // for a child that was already replaced does not clobber a newer one.
51
124
  const onDeath = () => {
52
- if (sharedClient === client) {
53
- resetConnection();
54
- }
125
+ // retireEntry unshares only if this entry is still the shared one, and
126
+ // closes it (idempotently) once nothing is running on it.
127
+ retireEntry(entry);
55
128
  };
56
129
  transport.onclose = onDeath;
57
130
  transport.onerror = onDeath;
58
131
  client.onclose = onDeath;
59
132
  client.onerror = onDeath;
133
+ const connectStart = Date.now();
60
134
  try {
61
135
  await client.connect(transport);
62
136
  }
63
137
  catch (err) {
64
- // Failure reset: clear the poisoned promise (sharedClient stays null) so
65
- // the NEXT call attempts a brand-new connection instead of awaiting a
66
- // rejected promise forever. Rethrow so the current caller sees failure.
67
- connectionPromise = null;
68
- throw err;
138
+ // No entry reaches callGitNexus on this path, so the reason travels in the error.
139
+ throw new Error(childFailureDetail(err, 'connect', connectStart, stderrTail()), { cause: err });
69
140
  }
70
- sharedClient = client;
71
- return client;
141
+ if (connectionPromise === pending) {
142
+ // A child that died while connecting is never shared; clear the
143
+ // resolved promise too, or every later call would get it back.
144
+ if (entry.retired)
145
+ connectionPromise = null;
146
+ else
147
+ sharedEntry = entry;
148
+ }
149
+ return entry;
72
150
  })();
73
- return connectionPromise;
151
+ const settled = pending;
152
+ connectionPromise = settled;
153
+ // Failure reset: clear the poisoned promise (sharedEntry stays null) so the
154
+ // NEXT call attempts a brand-new connection instead of awaiting a rejected
155
+ // promise forever; the current caller still sees the rejection. Attached
156
+ // here, not inside the async body, because the npx check throws before the
157
+ // body's first await -- i.e. before connectionPromise is even assigned.
158
+ settled.catch(() => {
159
+ if (connectionPromise === settled)
160
+ connectionPromise = null;
161
+ });
162
+ return settled;
163
+ }
164
+ /**
165
+ * Take a reference on a live, non-retired child. A child retired between its
166
+ * connect resolving and this continuation running (another call recycled it)
167
+ * is skipped, never used: it may already be closed. Bounded: a child that
168
+ * dies on every start (a crash-on-start gitnexus build) would otherwise make
169
+ * this re-spawn npx forever and the code_* call never return; after
170
+ * GITNEXUS_ACQUIRE_ATTEMPTS retired children it throws, and callGitNexus turns
171
+ * that into the offline result.
172
+ */
173
+ const GITNEXUS_ACQUIRE_ATTEMPTS = 3;
174
+ async function acquireGitNexusEntry() {
175
+ let lastStderr = '';
176
+ for (let attempt = 1; attempt <= GITNEXUS_ACQUIRE_ATTEMPTS; attempt++) {
177
+ const entry = await getGitNexusEntry();
178
+ if (!entry.retired) {
179
+ entry.inFlight += 1;
180
+ return entry;
181
+ }
182
+ lastStderr = entry.stderrTail();
183
+ if (entry.inFlight === 0)
184
+ closeEntry(entry);
185
+ }
186
+ throw new Error(`gitnexus child exited or was retired ${GITNEXUS_ACQUIRE_ATTEMPTS} times in a row before it could serve a call (it is crashing on start or being recycled repeatedly); child stderr: ${lastStderr || '(empty)'}`);
74
187
  }
75
188
  // Freshness metadata (F2.2): when a call carries a `repo` param and the index
76
189
  // exists, compare meta.json's lastCommit against the repo's current
@@ -89,8 +202,8 @@ function computeFreshnessNote(repo) {
89
202
  try {
90
203
  const metaPath = join(repo, '.gitnexus', 'meta.json');
91
204
  const meta = JSON.parse(readFileSync(metaPath, 'utf-8'));
92
- const head = execFileSync('git', ['rev-parse', 'HEAD'], {
93
- cwd: repo, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
205
+ const head = execFileSync(gitExecutable(), ['rev-parse', 'HEAD'], {
206
+ cwd: repo, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
94
207
  }).trim();
95
208
  const diverged = freshnessNote(meta.lastCommit, head) !== null;
96
209
  let reindexScheduled = false;
@@ -129,33 +242,351 @@ function appendFreshnessNote(result, note) {
129
242
  // result and the shared state is reset so the next call reconnects.
130
243
  //
131
244
  // Pre-flight (F3.1): when the call carries a non-empty `repo` param, verify
132
- // the repo has been indexed (`<repo>/.gitnexus/meta.json` exists) BEFORE ever
133
- // touching the child process. Calls without a `repo` param are forwarded
134
- // untouched -- the check only applies when a repo is named.
245
+ // the repo's index is ready (codeIndexReadiness, code-intelligence-readiness.ts
246
+ // -- the one readiness check) BEFORE ever touching the child process; a
247
+ // not-ready index throws E-CODE-INDEX-NOT-READY. A missing or interrupted
248
+ // (died mid-write) index first gets a background build started
249
+ // (ensureGitNexusIndexReady), so a dead index heals itself instead of failing
250
+ // every call until someone reindexes by hand. Every code_* tool call carries the calling
251
+ // session's resolved (self) folder as `repo` (resolveCodeSelf in
252
+ // code-intelligence.ts); a direct provider call without one is forwarded
253
+ // untouched.
254
+ //
255
+ // Consistency fence: the index generation is read before the call; a child
256
+ // that last answered this repo from an older generation is recycled first.
257
+ // AFTER the call, readiness and the generation are checked again: if an
258
+ // analyze started, finished, or left the metadata inconsistent while the
259
+ // call ran, the answer may come from a half-rewritten index and is DISCARDED
260
+ // with E-CODE-INDEX-NOT-READY rather than returned.
135
261
  async function callGitNexus(name, params) {
136
262
  const repo = params.repo;
137
263
  const hasRepo = typeof repo === 'string' && repo.length > 0;
264
+ let generation = '';
138
265
  if (hasRepo) {
139
- const metaPath = join(repo, '.gitnexus', 'meta.json');
140
- if (!existsSync(metaPath)) {
141
- return missingIndexResult(repo);
142
- }
266
+ ensureGitNexusIndexReady(repo);
267
+ generation = indexGeneration(readGitNexusIndexState(repo));
268
+ const seen = sharedEntry?.servedGeneration.get(repo);
269
+ if (seen !== undefined && seen !== generation)
270
+ recycleConnection();
143
271
  }
272
+ let result;
273
+ let entry = null;
274
+ let callStart = 0;
144
275
  try {
145
- const client = await getGitNexusClient();
146
- const result = await client.callTool({ name, arguments: params });
147
- if (hasRepo) {
148
- const note = computeFreshnessNote(repo);
149
- if (note)
150
- return appendFreshnessNote(result, note);
151
- }
152
- return result;
276
+ entry = await acquireGitNexusEntry();
277
+ callStart = Date.now();
278
+ result = await entry.client.callTool({ name, arguments: params });
153
279
  }
154
280
  catch (err) {
155
- resetConnection();
156
- const detail = err instanceof Error ? err.message : String(err);
281
+ // Retire only the child THIS call ran on -- never a fresh child another
282
+ // call already swapped in. A failed connect has no entry: the connect
283
+ // path already cleared its poisoned promise.
284
+ if (entry)
285
+ retireEntry(entry);
286
+ let detail = entry
287
+ ? childFailureDetail(err, `call of ${name}`, callStart, entry.stderrTail())
288
+ : err instanceof Error ? err.message : String(err);
289
+ // Only the spawn error itself means npx is missing. The detail also holds child
290
+ // stderr, where ENOENT next to an _npx cache path says nothing about PATH. Only
291
+ // a failed connect carries the spawn error, as the cause of its wrapper.
292
+ const cause = err instanceof Error ? err.cause : undefined;
293
+ if (!entry && cause instanceof Error && /\bspawn npx ENOENT\b/.test(cause.message)) {
294
+ detail = `${detail}: ${missingOnServerPathMessage('npx')}`;
295
+ }
157
296
  return offlineResult(detail);
158
297
  }
298
+ finally {
299
+ if (entry)
300
+ releaseEntry(entry);
301
+ }
302
+ if (!hasRepo)
303
+ return result;
304
+ const after = codeIndexReadiness('gitnexus', repo);
305
+ const generationAfter = indexGeneration(readGitNexusIndexState(repo));
306
+ if (!after.ready || generationAfter !== generation) {
307
+ // The child may hold a handle on the index that just changed.
308
+ retireEntry(entry);
309
+ throw indexChangedDuringCallError(repo, after);
310
+ }
311
+ entry.servedGeneration.set(repo, generation);
312
+ const note = computeFreshnessNote(repo);
313
+ return note ? appendFreshnessNote(result, note) : result;
314
+ }
315
+ const QUALIFIER_SEPS = ['.', '::', '#', ':', '/'];
316
+ /** True when `qualified` is `simple` or a qualified form ending in it. */
317
+ function endsWithSymbol(qualified, simple) {
318
+ if (qualified === '' || simple === '')
319
+ return false;
320
+ return qualified === simple || QUALIFIER_SEPS.some((sep) => qualified.endsWith(sep + simple));
321
+ }
322
+ /**
323
+ * Drop the disambiguation tags gitnexus appends to an id AFTER the qualified
324
+ * name, so the symbol segment can be compared with a plain name:
325
+ * '#<arity>' (every Method, Constructor and class-nested Function), followed
326
+ * by optional collision tags ('~type1,type2', '$const'), '~shape:<...>'
327
+ * parameter-shape tags, '~T1,T2' class template arguments and '~c:<hash>'
328
+ * constraints. Several of these contain a single ':' themselves, so they must
329
+ * go before the id is split. Only the last path segment is scanned for a '~'
330
+ * tag (a '~' in a directory name is not a tag), and a '~' right after '.' or
331
+ * ':' starts a C++ destructor name ('Foo.~Foo'), not a tag.
332
+ *
333
+ * The '#<arity>' tag is recognised only in the last path segment and only
334
+ * where it ends the id or is followed by a '~'/'$' tag, so a directory or
335
+ * file name holding '#<digit>' ('src/issue#12/b.ts') stays part of the path.
336
+ *
337
+ * gitnexus (1.6.x callable-id) also names a function-local callable by its
338
+ * declaration position, '<name>@<row>:<col>' ('outer.pick@1:2'). That ':' is
339
+ * not an id separator, so every such position suffix in the symbol segment
340
+ * is dropped too ('outer.pick'); an '@' in a directory ('src/@scope/pkg') is
341
+ * untouched.
342
+ */
343
+ function stripIdTags(id) {
344
+ const lastSegment = id.lastIndexOf('/') + 1;
345
+ const arityMatch = /#\d+(?=$|[~$])/.exec(id.slice(lastSegment));
346
+ let head = arityMatch ? id.slice(0, lastSegment + arityMatch.index) : id;
347
+ for (let i = lastSegment; i < head.length; i++) {
348
+ if (head[i] !== '~')
349
+ continue;
350
+ const prev = i > 0 ? head[i - 1] : '';
351
+ if (prev === '.' || prev === ':')
352
+ continue;
353
+ head = head.slice(0, i);
354
+ break;
355
+ }
356
+ return head.slice(0, lastSegment) + head.slice(lastSegment).replace(/@\d+:\d+(?=$|[.#])/g, '');
357
+ }
358
+ /**
359
+ * Split a gitnexus id/uid ("Function:src/a.ts:Svc.run", "a.mjs:fn",
360
+ * "Function:src/a.rs:ns::fn") at its last SINGLE ':' (a '::' is part of the
361
+ * symbol) into the file part before it and the symbol segment after it.
362
+ * Returns null when the id has no single ':' -- nothing to cross-check.
363
+ */
364
+ function splitSymbolId(rawId) {
365
+ const id = stripIdTags(rawId);
366
+ const singles = [];
367
+ for (let i = 0; i < id.length; i++) {
368
+ if (id[i] !== ':')
369
+ continue;
370
+ if (id[i + 1] === ':') {
371
+ i++;
372
+ continue;
373
+ }
374
+ singles.push(i);
375
+ }
376
+ if (singles.length === 0)
377
+ return null;
378
+ const last = singles[singles.length - 1];
379
+ const prev = singles.length > 1 ? singles[singles.length - 2] + 1 : 0;
380
+ return { file: id.slice(prev, last), symbol: id.slice(last + 1) };
381
+ }
382
+ function sameFile(a, b) {
383
+ return a === b || a.endsWith('/' + b) || b.endsWith('/' + a);
384
+ }
385
+ /**
386
+ * True when `resolved` is the symbol `requested` names: equal to its name,
387
+ * id (uid) or file path, or a qualified form ending in the name
388
+ * (Class.method, ns::fn, Class#method, file.ts:fn, dir/file.ts). A response
389
+ * that resolved nothing (no name and no id) has nothing to contradict.
390
+ *
391
+ * A matching name alone is not proof: a corrupt index can return the
392
+ * requested name on a node whose id names an unrelated symbol (name
393
+ * 'runUninstall', id 'beads-children.mjs:claimBeadsBatched'). So when an id
394
+ * is present its symbol segment must agree with the name (or, with no name,
395
+ * with the request), and a file part that looks like a path must agree with
396
+ * filePath; any disagreement is a mismatch even if the name matches.
397
+ */
398
+ export function resolvesToRequested(requested, resolved) {
399
+ const req = requested.trim();
400
+ const name = resolved.name ?? '';
401
+ const id = resolved.id ?? '';
402
+ if (req === '' || (name === '' && id === ''))
403
+ return true;
404
+ const parts = id !== '' ? splitSymbolId(id) : null;
405
+ if (parts) {
406
+ // The id's own symbol must be the symbol the response names.
407
+ if (name !== '' && !endsWithSymbol(parts.symbol, name))
408
+ return false;
409
+ // A path-like file part must be the file the response names.
410
+ const filePath = resolved.filePath ?? '';
411
+ if (filePath !== '' && /[./]/.test(parts.file) && !sameFile(parts.file, filePath))
412
+ return false;
413
+ }
414
+ if (req === name || req === id || req === resolved.filePath)
415
+ return true;
416
+ if (name !== '')
417
+ return endsWithSymbol(req, name);
418
+ // No name: compare the request with the id's symbol segment.
419
+ return parts !== null && (endsWithSymbol(req, parts.symbol) || endsWithSymbol(parts.symbol, req));
420
+ }
421
+ function resolvedFrom(value) {
422
+ if (!value || typeof value !== 'object')
423
+ return null;
424
+ const v = value;
425
+ const str = (x) => (typeof x === 'string' && x !== '' ? x : undefined);
426
+ const out = { name: str(v.name), id: str(v.id) ?? str(v.uid), filePath: str(v.filePath) };
427
+ return out.name || out.id ? out : null;
428
+ }
429
+ /**
430
+ * Flag a code_impact ('impact', resolved symbol in payload.target) or
431
+ * code_context ('context', payload.symbol) result whose resolved symbol is not
432
+ * the requested one. Returns the result unchanged when it matches, is an
433
+ * error, or is not the JSON shape gitnexus returns.
434
+ */
435
+ export function flagResolutionMismatch(result, requested, kind) {
436
+ if (typeof requested !== 'string' || isErrorResult(result))
437
+ return result;
438
+ if (!result || typeof result !== 'object' || !('content' in result))
439
+ return result;
440
+ const content = result.content;
441
+ if (!Array.isArray(content) || content.length === 0)
442
+ return result;
443
+ const first = content[0];
444
+ if (!first || typeof first.text !== 'string')
445
+ return result;
446
+ const sep = '\n\n---\n';
447
+ const cut = first.text.indexOf(sep);
448
+ const jsonPart = cut >= 0 ? first.text.slice(0, cut) : first.text;
449
+ const suffix = cut >= 0 ? first.text.slice(cut) : '';
450
+ let payload;
451
+ try {
452
+ const parsed = JSON.parse(jsonPart);
453
+ if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
454
+ return result;
455
+ payload = parsed;
456
+ }
457
+ catch {
458
+ return result;
459
+ }
460
+ const resolved = resolvedFrom(kind === 'impact' ? payload.target : payload.symbol);
461
+ if (!resolved || resolvesToRequested(requested, resolved))
462
+ return result;
463
+ const mismatch = { requested, resolved };
464
+ const what = `${resolved.name ?? resolved.id}${resolved.filePath ? ` (${resolved.filePath})` : ''}` +
465
+ (resolved.name && resolved.id ? `, id ${resolved.id}` : '');
466
+ const warning = `[code-intelligence] RESOLUTION MISMATCH: '${requested}' resolved to a different symbol, ${what}. ` +
467
+ 'This answer is about that symbol, not the one requested; confidence is LOW. ' +
468
+ 'Check the name (or pass file_path), and run code_status -- an index rebuilt or left inconsistent can map a name to an unrelated symbol.';
469
+ const patched = { ...payload, resolution_mismatch: mismatch, confidence: 'LOW' };
470
+ if (kind === 'impact' && 'risk' in payload) {
471
+ patched.unverified_risk = payload.risk;
472
+ patched.risk = 'UNKNOWN';
473
+ }
474
+ const rest = result;
475
+ return {
476
+ ...rest,
477
+ content: [
478
+ { ...first, text: JSON.stringify(patched, null, 2) + suffix },
479
+ ...content.slice(1),
480
+ { type: 'text', text: warning },
481
+ ],
482
+ resolution_mismatch: mismatch,
483
+ confidence: 'LOW',
484
+ };
485
+ }
486
+ // ---------------------------------------------------------------------------
487
+ // Corrupt-index check (code_impact / code_context "not found"). gitnexus
488
+ // 1.6.12's incremental analyze of a large repo rewrites rows of files it did
489
+ // not change. Reproduced with one one-line edit on a repo of 43297 nodes: the
490
+ // total stayed about the same, but only 34011 distinct ids were left (9287
491
+ // rows now duplicate another row, and an earlier run left 7774 blank ones).
492
+ // Every symbol whose row was overwritten answers "Target 'x' not found" /
493
+ // "Symbol 'x' not found" although it exists, and the index stays broken until
494
+ // a full rebuild. A healthy index has one row per id. Fleet-run analyzes are
495
+ // full rebuilds (GITNEXUS_ANALYZE_ARGS carries --force), but an index corrupted
496
+ // before that, or by an incremental analyze run by hand, still answers this
497
+ // way. So a not-found answer is cross-checked: when ids are not unique, the
498
+ // answer is marked as unreliable and a rebuild is asked for
499
+ // (scheduleIndexBuild: config-, cooldown- and single-flight-gated).
500
+ // ---------------------------------------------------------------------------
501
+ const NOT_FOUND_ERROR = /^(?:Target|Symbol) '([\s\S]*)' not found\.?$/;
502
+ // Every node of a healthy index has its own id ('<Label>:<path>[:<name>]').
503
+ // count(DISTINCT) folds duplicated and blank ids and skips null ones, so the
504
+ // difference covers all three.
505
+ export const INDEX_ID_UNIQUENESS_QUERY = 'MATCH (n) RETURN count(n) AS total, count(DISTINCT n.id) AS distinct_ids';
506
+ /** The name a code_impact / code_context result reports as not found, or null. */
507
+ export function notFoundName(result) {
508
+ const parts = splitPayload(result);
509
+ if (!parts)
510
+ return null;
511
+ const error = parts.payload.error;
512
+ if (typeof error !== 'string')
513
+ return null;
514
+ const m = NOT_FOUND_ERROR.exec(error.trim());
515
+ return m ? m[1] : null;
516
+ }
517
+ function splitPayload(result) {
518
+ if (isErrorResult(result) || !result || typeof result !== 'object' || !('content' in result))
519
+ return null;
520
+ const content = result.content;
521
+ if (!Array.isArray(content) || content.length === 0)
522
+ return null;
523
+ const first = content[0];
524
+ if (!first || typeof first.text !== 'string')
525
+ return null;
526
+ const sep = '\n\n---\n';
527
+ const cut = first.text.indexOf(sep);
528
+ try {
529
+ const parsed = JSON.parse(cut >= 0 ? first.text.slice(0, cut) : first.text);
530
+ if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
531
+ return null;
532
+ return { payload: parsed, suffix: cut >= 0 ? first.text.slice(cut) : '', first, content };
533
+ }
534
+ catch {
535
+ return null;
536
+ }
537
+ }
538
+ /** Rows beyond one per distinct id in `repo`'s index, or null when it cannot be read. */
539
+ async function damagedRows(repo) {
540
+ let result;
541
+ try {
542
+ result = await callGitNexus('cypher', { query: INDEX_ID_UNIQUENESS_QUERY, repo });
543
+ }
544
+ catch {
545
+ return null;
546
+ }
547
+ const payload = extractCypherPayload(result);
548
+ if (!payload)
549
+ return null;
550
+ const row = parseMarkdownTable(payload.markdown)[0];
551
+ if (!row || row.total === undefined || row.distinct_ids === undefined)
552
+ return null;
553
+ const n = Number(row.total) - Number(row.distinct_ids);
554
+ return Number.isFinite(n) ? n : null;
555
+ }
556
+ /**
557
+ * When a code_impact / code_context answer is "not found" and `repo`'s index
558
+ * holds overwritten rows (ids that are not unique), return the answer marked as unreliable (payload
559
+ * index_integrity + confidence LOW, plus a warning naming the cause and what
560
+ * happens next) and ask for a rebuild. Any other result, or one whose
561
+ * index checks out, is returned unchanged.
562
+ */
563
+ export async function flagCorruptIndexNotFound(result, repo) {
564
+ if (typeof repo !== 'string' || repo === '')
565
+ return result;
566
+ const name = notFoundName(result);
567
+ if (name === null)
568
+ return result;
569
+ const damaged = await damagedRows(repo);
570
+ if (damaged === null || damaged <= 0)
571
+ return result;
572
+ const rebuild = scheduleIndexBuild(repo);
573
+ const integrity = { corrupt: true, damaged_rows: damaged, rebuild };
574
+ const parts = splitPayload(result);
575
+ const next = rebuild.started
576
+ ? 'A full rebuild of the index has started; retry once code_status reports it ready.'
577
+ : `No rebuild started (${rebuild.reason}${rebuild.detail ? `: ${rebuild.detail}` : ''}); run code_reindex, which always rebuilds the index in full.`;
578
+ const warning = `[code-intelligence] INDEX CORRUPT: '${name}' was not found, but ${damaged} rows in this code index ` +
579
+ 'have overwritten other symbols, so this is NOT evidence that the symbol does not exist. ' +
580
+ `${next} Until then, use a text search for this symbol.`;
581
+ const patched = { ...parts.payload, index_integrity: integrity, confidence: 'LOW' };
582
+ return {
583
+ ...result,
584
+ content: [
585
+ { ...parts.first, text: JSON.stringify(patched, null, 2) + parts.suffix },
586
+ ...parts.content.slice(1),
587
+ { type: 'text', text: warning },
588
+ ],
589
+ };
159
590
  }
160
591
  // Small, pure, exported so both T2.1 (code_map) and T2.2 (code_flow) can reuse
161
592
  // it and it can be unit tested directly without mocking the MCP client.
@@ -401,13 +832,15 @@ export class GitNexusProvider {
401
832
  });
402
833
  }
403
834
  async impact(params) {
404
- return callGitNexus('impact', params);
835
+ const result = await callGitNexus('impact', params);
836
+ return flagResolutionMismatch(await flagCorruptIndexNotFound(result, params.repo), params.target, 'impact');
405
837
  }
406
838
  async query(params) {
407
839
  return callGitNexus('query', params);
408
840
  }
409
841
  async context(params) {
410
- return callGitNexus('context', params);
842
+ const result = await callGitNexus('context', params);
843
+ return flagResolutionMismatch(await flagCorruptIndexNotFound(result, params.repo), params.name, 'context');
411
844
  }
412
845
  // T2.1: architectural map via Community nodes (rung 2 -- compose over cypher;
413
846
  // no direct communities/map tool exists on gitnexus 1.6.7). See Decisions
@@ -1,7 +1,7 @@
1
1
  // P4a KB enrichment for code_context (T3.3, design D4). The gitnexus
2
2
  // provider file (code-intelligence-gitnexus.ts) must NOT import the KB
3
3
  // service -- that would create a src/tools <-> src/services cycle. This
4
- // helper is imported ONLY by the code_context handler in src/index.ts: the
4
+ // helper is imported ONLY by the code_context handler in src/services/tool-registry.ts: the
5
5
  // handler calls the provider, then this helper, then merges the two results.
6
6
  import { getKbProviders } from '../services/knowledge/kb-providers.js';
7
7
  const SUMMARY_TRUNCATE_LEN = 120;
@@ -33,11 +33,12 @@ export async function enrichContextWithKb(name, result, repoPath, remoteUrl) {
33
33
  if (isErrorResult(result))
34
34
  return result;
35
35
  try {
36
- // Enrich from the KB of the repo the code_context call is about; without
37
- // this the server's cwd decides, and one repo's knowledge annotates
38
- // another's symbols. remoteUrl (repo_remote_url on the code_context
39
- // input) lets a remote member's call resolve the correct project KB even
40
- // when repoPath is a path on another host that this process cannot stat.
36
+ // Enrich from the KB of the repo the code_context call is about -- the
37
+ // calling session's resolved (self) folder; without this the server's cwd
38
+ // decides, and one repo's knowledge annotates another's symbols. remoteUrl
39
+ // (a remote member's single known origin remote) lets a remote member's
40
+ // call resolve the correct project KB even when repoPath is a path on
41
+ // another host that this process cannot stat.
41
42
  const providers = await getKbProviders(repoPath, remoteUrl);
42
43
  const kbResult = await providers.project.query({
43
44
  query: name,