@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
package/dist/index.js CHANGED
@@ -36,6 +36,9 @@ Usage:
36
36
  apra-fleet install --skill none Skip skill installation
37
37
  apra-fleet install --no-skill Same as --skill none
38
38
  apra-fleet register-member --name <name> --path <folder> [options] Register a fleet member from the shell (see 'register-member --help')
39
+ apra-fleet remove-member --id <uuid> [--force] Remove a member registration from this install (see 'remove-member --help')
40
+ apra-fleet call --member <uuid> <tool> [--args-file <path>] Call a tool as a member session (see 'call --help')
41
+ apra-fleet call --member <uuid> --list-tools List the member session's tools
39
42
  apra-fleet uninstall Remove binary, hooks, and MCP registration
40
43
  apra-fleet secret --set <name> Deliver a secret to a waiting request
41
44
  apra-fleet secret --list List secrets
@@ -51,6 +54,7 @@ Usage:
51
54
  apra-fleet kb reject-directive <id> Reject a proposal or retire an active directive
52
55
  apra-fleet kb add-directive "<text>" [--symbols a,b] Create an already-active directive (human-only)
53
56
  apra-fleet kb commit [--repo <path>] [--global] Re-export + auto-commit the canonical bible (manual/recovery)
57
+ apra-fleet kb profile [full|developer|custom <a,b>] Show or set the KB tool profile for interactive sessions
54
58
  apra-fleet join <member-jwt> [--hub-url <url>] Activate a device using a member JWT obtained out-of-band from fleet-dashboard
55
59
  apra-fleet spoke <origin-member-id> Run as an outbound hub-connected spoke; requires apra-fleet join first
56
60
  apra-fleet --version Print version
@@ -73,6 +77,16 @@ else if (arg === 'register-member') {
73
77
  .then(m => m.runRegisterMember(process.argv.slice(3)))
74
78
  .catch(err => { logError('cli', `Register-member failed: ${err.message}`); process.exit(1); });
75
79
  }
80
+ else if (arg === 'remove-member') {
81
+ import('./cli/remove-member.js')
82
+ .then(m => m.runRemoveMember(process.argv.slice(3)))
83
+ .catch(err => { logError('cli', `Remove-member failed: ${err.message}`); process.exit(1); });
84
+ }
85
+ else if (arg === 'call') {
86
+ import('./cli/call.js')
87
+ .then(m => m.runCallCli(process.argv.slice(3)))
88
+ .catch(err => { logError('cli', `Call failed: ${err.message}`); process.exit(1); });
89
+ }
76
90
  else if (arg === 'uninstall') {
77
91
  import('./cli/uninstall.js')
78
92
  .then(m => m.runUninstall(process.argv.slice(3)))
@@ -130,7 +144,7 @@ else if (arg === 'kb-server') {
130
144
  import('./commands/kb-server.js')
131
145
  .then(async (m) => {
132
146
  const opts = m.parseKbServerArgs(process.argv.slice(3));
133
- await m.startKbServer(opts.port, opts.generateToken, opts.dbPath);
147
+ await m.startKbServer(opts.port, opts.generateToken, opts.dbPath, opts.tokenFile);
134
148
  })
135
149
  .catch(err => { logError('cli', `kb-server failed: ${err.message}`); process.exit(1); });
136
150
  }
@@ -169,6 +183,13 @@ else if (arg === 'kb') {
169
183
  .then(code => process.exit(code))
170
184
  .catch(err => { logError('cli', `kb commit failed: ${err.message}`); process.exit(1); });
171
185
  }
186
+ else if (subCmd === 'profile') {
187
+ // GitHub #759: show/set the install-wide KB tool profile. Required because
188
+ // the developer profile hides kb_setup from interactive sessions.
189
+ import('./cli/kb-profile.js')
190
+ .then(m => process.exit(m.runKbProfile(process.argv.slice(4))))
191
+ .catch(err => { logError('cli', `kb profile failed: ${err.message}`); process.exit(1); });
192
+ }
172
193
  else if (subCmd === 'import') {
173
194
  // T2.2 (F4, D3): post-merge entry point for absorbing a merged bible into
174
195
  // the local KB. Thin wrapper over the same kbImport the MCP tool uses.
@@ -258,6 +279,30 @@ else {
258
279
  console.error(`\nRun 'apra-fleet --help' for usage.`);
259
280
  process.exit(1);
260
281
  }
282
+ /**
283
+ * Exit code for "refusing to start because another/foreign server holds the
284
+ * port or data dir" (GitHub #584). Under a service manager (systemd
285
+ * Restart=on-failure, launchd KeepAlive SuccessfulExit=false) a non-zero exit
286
+ * restarts the server every few seconds -- each attempt a new fleet-<pid>.log
287
+ * that `apra-fleet watch` then follows -- while the cause persists. Only a
288
+ * launch by such a service manager (launchedByServiceManager: the
289
+ * APRA_FLEET_SERVICE marker, systemd INVOCATION_ID, launchd XPC_SERVICE_NAME)
290
+ * exits 0, like the already-running case. Every other launch (terminal, CI,
291
+ * nohup, containers, scripts) exits 1 so the refusal stays visible.
292
+ */
293
+ // Captured once by startHttpServer (which also strips our markers from the
294
+ // env so children never inherit them). Still "any service-manager hint":
295
+ // installs predating the APRA_FLEET_SERVICE marker rely on systemd/launchd
296
+ // vars, and for a refusal the only cost of a false positive (a hand-run shell
297
+ // under systemd) is exit code 0 instead of 1 -- the refusal is still printed.
298
+ let serviceManagedLaunch = null;
299
+ async function refusalExitCode() {
300
+ if (serviceManagedLaunch === null) {
301
+ const { launchedByServiceManager } = await import('./services/service-manager/types.js');
302
+ serviceManagedLaunch = launchedByServiceManager();
303
+ }
304
+ return serviceManagedLaunch ? 0 : 1;
305
+ }
261
306
  function resolveTransport(args) {
262
307
  if (args.length === 0)
263
308
  return 'http';
@@ -273,6 +318,17 @@ function resolveTransport(args) {
273
318
  }
274
319
  return 'invalid';
275
320
  }
321
+ /** Clear busy statuses persisted by a server that died mid-task. */
322
+ async function reconcileStartupBusyImpl() {
323
+ const { reconcileStaleBusy } = await import('./services/statusline.js');
324
+ const cleared = reconcileStaleBusy();
325
+ if (cleared.length > 0) {
326
+ logLine('startup', `reset stale busy status for ${cleared.length} member(s) left by a previous server: ${cleared.join(', ')}`);
327
+ }
328
+ }
329
+ function reconcileStartupBusy() {
330
+ void reconcileStartupBusyImpl().catch(() => { });
331
+ }
276
332
  async function startStdioServer() {
277
333
  const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
278
334
  const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
@@ -328,20 +384,71 @@ async function startStdioServer() {
328
384
  logLine('startup', `apra-fleet ${serverVersion} started transport=stdio${clientStr}${versionStr}${pidStr} FLEET_DIR=${FLEET_DIR}`);
329
385
  idleManager.start();
330
386
  void cleanupStaleTasks();
387
+ reconcileStartupBusy();
331
388
  purgeExpiredCredentials();
332
389
  void checkForUpdate();
390
+ // GitHub #562: leave a trace when the event loop freezes.
391
+ const { startEventLoopWatchdog } = await import('./services/event-loop-watchdog.js');
392
+ const { getActiveLogFile } = await import('./utils/log-helpers.js');
393
+ const watchdog = startEventLoopWatchdog({ logFile: getActiveLogFile() });
333
394
  const { cleanupAuthSocket } = await import('./services/auth-socket.js');
334
- process.on('SIGINT', () => { cleanupAuthSocket().then(() => { closeAllConnections(); stallDetector.stop(); process.exit(0); }); });
335
- process.on('SIGTERM', () => { cleanupAuthSocket().then(() => { closeAllConnections(); stallDetector.stop(); process.exit(0); }); });
395
+ // GitHub #585: every exit path (SIGINT/SIGTERM/SIGHUP/SIGBREAK, crashes)
396
+ // writes one synchronous shutdown record before the process exits.
397
+ const { installShutdownHandlers } = await import('./services/server-lifecycle.js');
398
+ let stdioStopping = false;
399
+ installShutdownHandlers(() => {
400
+ if (stdioStopping)
401
+ return;
402
+ stdioStopping = true;
403
+ void watchdog.stop();
404
+ cleanupAuthSocket().then(() => { closeAllConnections(); stallDetector.stop(); process.exit(0); });
405
+ });
336
406
  }
337
407
  async function startHttpServer() {
408
+ // GitHub #585 recovery: a service launch (logon, the Windows task's repeating
409
+ // revive trigger) that keeps failing backs off instead of retrying -- and
410
+ // writing a new fleet-<pid>.log -- every interval. See service-start-guard.ts.
411
+ const { consumeLaunchMarkers } = await import('./services/service-manager/types.js');
412
+ const launch = consumeLaunchMarkers();
413
+ serviceManagedLaunch = launch.managed;
414
+ // The stopped-by-user skip and the start backoff decide whether to start at
415
+ // all, so they apply ONLY to our own service templates (APRA_FLEET_SERVICE=1,
416
+ // set by the task wrapper, the plist and the unit) -- never to a hand-run
417
+ // `apra-fleet run` in a shell that merely inherited INVOCATION_ID or
418
+ // XPC_SERVICE_NAME (systemd-run --shell, tmux from a user unit, CI runners).
419
+ const startGuard = launch.service ? await import('./services/service-start-guard.js') : null;
420
+ if (startGuard) {
421
+ // A deliberate `apra-fleet stop` must stick across logon/boot on every OS:
422
+ // launchd RunAtLoad, an enabled systemd unit, the Windows HKCU Run
423
+ // fallback, or an old task that could not be disabled all launch us here.
424
+ // Exit 0 (launchd SuccessfulExit=false / systemd Restart=on-failure do not
425
+ // restart it) and KEEP the marker -- only `apra-fleet start`/install clear it.
426
+ const { readStoppedMarker, describeStoppedMarker } = await import('./services/stopped-marker.js');
427
+ const stopped = readStoppedMarker();
428
+ if (stopped) {
429
+ const line = `${new Date().toISOString()} apra-fleet service launch skipped: ${describeStoppedMarker(stopped)}`;
430
+ // Someone is watching (a console, or stderr on a mintty/Git Bash tty
431
+ // while stdout is piped): always say why.
432
+ if (process.stdout.isTTY || process.stderr.isTTY)
433
+ console.error(line);
434
+ else if (startGuard.shouldLogServiceNotice('stopped-by-user'))
435
+ console.log(line);
436
+ process.exit(0);
437
+ }
438
+ const skip = startGuard.serviceStartBackoff();
439
+ if (skip) {
440
+ console.log(`${new Date().toISOString()} ${skip}`);
441
+ process.exit(0);
442
+ }
443
+ startGuard.recordServiceStartAttempt();
444
+ }
338
445
  const { loadOnboardingState, resetSessionFlags } = await import('./services/onboarding.js');
339
446
  const { getAllAgents: getAgentsForStartup } = await import('./services/registry.js');
340
447
  // Pass current member count so upgrade detection works: existing registry + no onboarding.json -> skip banner
341
448
  loadOnboardingState(getAgentsForStartup().length);
342
449
  resetSessionFlags();
343
- const { checkRunningInstance, claimStartupLock } = await import('./services/singleton.js');
344
- const { createHttpTransport } = await import('./services/http-transport.js');
450
+ const { checkRunningInstance, claimStartupLock, unresponsiveInstanceMessage, portInUseMessage, readServerInfoPid, describePreviousServer, } = await import('./services/singleton.js');
451
+ const { createHttpTransport, PortInUseError } = await import('./services/http-transport.js');
345
452
  const { registerAllTools } = await import('./services/tool-registry.js');
346
453
  const { FLEET_DIR, SERVER_INFO_PATH } = await import('./paths.js');
347
454
  const { closeAllConnections } = await import('./services/ssh.js');
@@ -355,16 +462,53 @@ async function startHttpServer() {
355
462
  // Detect already-running instance before starting
356
463
  const instance = await checkRunningInstance();
357
464
  if (instance.running) {
358
- logLine('startup', `apra-fleet already running at ${instance.url} pid=${instance.pid} -- exiting`);
465
+ const msg = `apra-fleet already running at ${instance.url} pid=${instance.pid} -- exiting`;
466
+ if (startGuard) {
467
+ // Service launches (a revive-trigger tick) go to the service log only,
468
+ // not a fresh fleet-<pid>.log per tick, and at most once an hour (a
469
+ // server running outside the task would otherwise log ~288 lines/day).
470
+ if (startGuard.shouldLogServiceNotice('already-running')) {
471
+ console.log(`${new Date().toISOString()} ${msg}`);
472
+ }
473
+ startGuard.clearServiceStartFailures();
474
+ }
475
+ else {
476
+ logLine('startup', msg);
477
+ }
359
478
  process.exit(0);
360
479
  }
480
+ if (instance.state === 'gone') {
481
+ const previousNote = describePreviousServer(instance.previous);
482
+ if (previousNote)
483
+ logLine('startup', `${previousNote}; removed its stale server.json`);
484
+ }
485
+ if (instance.state === 'unresponsive') {
486
+ // A live server with a blocked event loop is not dead: starting a second
487
+ // one would split the fleet (GitHub #584). Refuse; the operator stops it.
488
+ logError('startup', unresponsiveInstanceMessage(instance));
489
+ process.exit(await refusalExitCode());
490
+ }
361
491
  // Atomic startup lock to prevent concurrent double-start race
362
492
  const lock = claimStartupLock();
363
493
  if (!lock.acquired) {
364
494
  logLine('startup', 'Another fleet instance is starting up -- exiting');
365
495
  process.exit(0);
366
496
  }
367
- const handle = await createHttpTransport({ registerTools: registerAllTools });
497
+ let handle;
498
+ try {
499
+ handle = await createHttpTransport({ registerTools: registerAllTools });
500
+ }
501
+ catch (err) {
502
+ lock.release();
503
+ if (err instanceof PortInUseError) {
504
+ const { findPortHolder, describePortConflict } = await import('./services/port-holder.js');
505
+ const { hasMemberInstallMarker } = await import('./cli/install-guard.js');
506
+ const conflict = describePortConflict(err.port, portInUseMessage(err.port, readServerInfoPid()), await findPortHolder(err.port), hasMemberInstallMarker() ? 'member' : 'full');
507
+ logError('startup', conflict.message);
508
+ process.exit(await refusalExitCode());
509
+ }
510
+ throw err;
511
+ }
368
512
  // Write server.json so other processes can detect this instance
369
513
  fs.mkdirSync(FLEET_DIR, { recursive: true });
370
514
  fs.writeFileSync(SERVER_INFO_PATH, JSON.stringify({
@@ -376,6 +520,12 @@ async function startHttpServer() {
376
520
  }));
377
521
  // Release startup lock now that server.json is written (server.json is the long-lived detection mechanism)
378
522
  lock.release();
523
+ // The stopped-by-user marker is NOT cleared here: only an explicit
524
+ // `apra-fleet start` / `apra-fleet install` ends a deliberate stop. (A
525
+ // service launch never gets this far while it exists; a manual `run`
526
+ // leaves it, so if this server later dies clients still do not
527
+ // auto-start -- the conservative side.)
528
+ startGuard?.clearServiceStartFailures();
379
529
  // Make HTTP handle available to shutdown_server tool
380
530
  setHttpHandle(handle);
381
531
  const stallDetector = getStallDetector();
@@ -388,8 +538,13 @@ async function startHttpServer() {
388
538
  logLine('startup', `apra-fleet ${serverVersion} started transport=http port=${handle.port} pid=${process.pid} FLEET_DIR=${FLEET_DIR}`);
389
539
  idleManager.start();
390
540
  void cleanupStaleTasks();
541
+ reconcileStartupBusy();
391
542
  purgeExpiredCredentials();
392
543
  void checkForUpdate();
544
+ // GitHub #562: leave a trace when the event loop freezes.
545
+ const { startEventLoopWatchdog } = await import('./services/event-loop-watchdog.js');
546
+ const { getActiveLogFile } = await import('./utils/log-helpers.js');
547
+ const watchdog = startEventLoopWatchdog({ logFile: getActiveLogFile() });
393
548
  async function shutdown() {
394
549
  try {
395
550
  lock.release();
@@ -399,6 +554,10 @@ async function startHttpServer() {
399
554
  fs.unlinkSync(SERVER_INFO_PATH);
400
555
  }
401
556
  catch { }
557
+ try {
558
+ await watchdog.stop();
559
+ }
560
+ catch { }
402
561
  try {
403
562
  await handle.close();
404
563
  }
@@ -417,7 +576,16 @@ async function startHttpServer() {
417
576
  catch { }
418
577
  process.exit(0);
419
578
  }
420
- process.on('SIGINT', () => void shutdown());
421
- process.on('SIGTERM', () => void shutdown());
579
+ // GitHub #585: every exit path (SIGINT/SIGTERM/SIGHUP/SIGBREAK, POST
580
+ // /shutdown, shutdown_server, crashes) writes one synchronous shutdown
581
+ // record to fleet-<pid>.log before the process exits.
582
+ const { installShutdownHandlers } = await import('./services/server-lifecycle.js');
583
+ let stopping = false;
584
+ installShutdownHandlers(() => {
585
+ if (stopping)
586
+ return;
587
+ stopping = true;
588
+ void shutdown();
589
+ });
422
590
  }
423
591
  //# sourceMappingURL=index.js.map
@@ -0,0 +1,77 @@
1
+ /**
2
+ * Bounded child environment for local Windows spawns.
3
+ *
4
+ * Why this exists: on a Windows fleet host, `bd dolt pull/push` repeatedly
5
+ * failed with
6
+ * fork/exec C:\Program Files\Git\mingw64\bin\git.exe: Not enough memory
7
+ * resources are available to process this command.
8
+ * while tens of GB of RAM were free. That text is ERROR_NOT_ENOUGH_MEMORY (8)
9
+ * from CreateProcess. With RAM free, the known causes are an oversized
10
+ * environment block (every spawn copies the whole block into the child, and
11
+ * each nested hop -- fleet server -> PowerShell/bash -> bd -> dolt -> git --
12
+ * copies it again) and desktop-heap exhaustion in a non-interactive session.
13
+ * The first one the product controls: WindowsCommands.getCleanEnv() builds
14
+ * Path as Machine Path + ';' + User Path with no dedupe, and the gitbash
15
+ * variant inherits the fleet server's env wholesale. See
16
+ * docs/troubleshooting.md ("git spawned by bd/dolt fails with Not enough
17
+ * memory resources") for the evidence and what was and was not reproduced.
18
+ *
19
+ * The rule (pure, unit-tested in tests/child-env-bound.test.ts):
20
+ * 1. PATH is deduplicated: entries compared case-insensitively with
21
+ * trailing slashes ignored, first occurrence kept, empty entries
22
+ * dropped. All PATH-named keys (Path/PATH) are merged into the first.
23
+ * 2. If the env block is still larger than CHILD_ENV_BLOCK_CAP_CHARS, the
24
+ * largest NON-PROTECTED variables are dropped, largest first, until it
25
+ * fits. Protected variables (what bd/dolt/git and the provider CLIs need:
26
+ * PATH, HOME/USERPROFILE and the session vars, temp dirs, git/ssh/proxy
27
+ * config, and anything that looks like a credential) are never dropped.
28
+ * 3. If protected variables alone exceed the cap, the env is returned as
29
+ * small as the rule can make it and `overCap` is set so the caller can
30
+ * say so loudly -- the rule never drops PATH or a credential to fit.
31
+ *
32
+ * ASCII only.
33
+ */
34
+ /**
35
+ * Cap on the child environment block, in UTF-16 code units (what Windows
36
+ * stores): 32767, the classic Windows environment-block limit and the hard
37
+ * per-variable limit. A normal Windows user env is 3-8K, so a block above
38
+ * this is a leak (duplicated PATH, an inherited oversized variable), not a
39
+ * legitimate need.
40
+ */
41
+ export declare const CHILD_ENV_BLOCK_CAP_CHARS = 32767;
42
+ export declare function isProtectedEnvName(name: string): boolean;
43
+ /**
44
+ * Size of an environment block as CreateProcess sees it: each variable is
45
+ * `NAME=VALUE\0`, and the block ends with one extra `\0`. JS string length is
46
+ * UTF-16 code units, the same unit Windows uses.
47
+ */
48
+ export declare function envBlockSize(env: Record<string, string>): number;
49
+ /** Dedupe a PATH value: case-insensitive, trailing slashes ignored, first wins, empties dropped. */
50
+ export declare function dedupePathValue(value: string, sep: string): string;
51
+ export interface BoundedEnvReport {
52
+ sizeBefore: number;
53
+ sizeAfter: number;
54
+ pathEntriesBefore: number;
55
+ pathEntriesAfter: number;
56
+ /** Names of variables dropped to fit the cap, largest first. */
57
+ dropped: string[];
58
+ /** True when protected variables alone exceed the cap. */
59
+ overCap: boolean;
60
+ }
61
+ /**
62
+ * Apply the bounding rule (see the file header). Never mutates `env`.
63
+ *
64
+ * @param env the environment the child would otherwise receive
65
+ * @param opts.sep PATH separator (';' on Windows, the default)
66
+ * @param opts.capChars block cap in UTF-16 code units
67
+ */
68
+ export declare function boundChildEnv(env: Record<string, string | undefined>, opts?: {
69
+ sep?: string;
70
+ capChars?: number;
71
+ }): {
72
+ env: Record<string, string>;
73
+ report: BoundedEnvReport;
74
+ };
75
+ /** One-line human summary of a report, for a warning log. */
76
+ export declare function describeBoundedEnv(report: BoundedEnvReport): string;
77
+ //# sourceMappingURL=child-env-bound.d.ts.map
@@ -0,0 +1,171 @@
1
+ /**
2
+ * Bounded child environment for local Windows spawns.
3
+ *
4
+ * Why this exists: on a Windows fleet host, `bd dolt pull/push` repeatedly
5
+ * failed with
6
+ * fork/exec C:\Program Files\Git\mingw64\bin\git.exe: Not enough memory
7
+ * resources are available to process this command.
8
+ * while tens of GB of RAM were free. That text is ERROR_NOT_ENOUGH_MEMORY (8)
9
+ * from CreateProcess. With RAM free, the known causes are an oversized
10
+ * environment block (every spawn copies the whole block into the child, and
11
+ * each nested hop -- fleet server -> PowerShell/bash -> bd -> dolt -> git --
12
+ * copies it again) and desktop-heap exhaustion in a non-interactive session.
13
+ * The first one the product controls: WindowsCommands.getCleanEnv() builds
14
+ * Path as Machine Path + ';' + User Path with no dedupe, and the gitbash
15
+ * variant inherits the fleet server's env wholesale. See
16
+ * docs/troubleshooting.md ("git spawned by bd/dolt fails with Not enough
17
+ * memory resources") for the evidence and what was and was not reproduced.
18
+ *
19
+ * The rule (pure, unit-tested in tests/child-env-bound.test.ts):
20
+ * 1. PATH is deduplicated: entries compared case-insensitively with
21
+ * trailing slashes ignored, first occurrence kept, empty entries
22
+ * dropped. All PATH-named keys (Path/PATH) are merged into the first.
23
+ * 2. If the env block is still larger than CHILD_ENV_BLOCK_CAP_CHARS, the
24
+ * largest NON-PROTECTED variables are dropped, largest first, until it
25
+ * fits. Protected variables (what bd/dolt/git and the provider CLIs need:
26
+ * PATH, HOME/USERPROFILE and the session vars, temp dirs, git/ssh/proxy
27
+ * config, and anything that looks like a credential) are never dropped.
28
+ * 3. If protected variables alone exceed the cap, the env is returned as
29
+ * small as the rule can make it and `overCap` is set so the caller can
30
+ * say so loudly -- the rule never drops PATH or a credential to fit.
31
+ *
32
+ * ASCII only.
33
+ */
34
+ /**
35
+ * Cap on the child environment block, in UTF-16 code units (what Windows
36
+ * stores): 32767, the classic Windows environment-block limit and the hard
37
+ * per-variable limit. A normal Windows user env is 3-8K, so a block above
38
+ * this is a leak (duplicated PATH, an inherited oversized variable), not a
39
+ * legitimate need.
40
+ */
41
+ export const CHILD_ENV_BLOCK_CAP_CHARS = 32767;
42
+ /** Variable names (case-insensitive) a bd/dolt/git/provider child needs. */
43
+ const PROTECTED_NAMES = new Set([
44
+ 'PATH', 'PATHEXT', 'HOME', 'USERPROFILE', 'HOMEDRIVE', 'HOMEPATH',
45
+ 'USERNAME', 'USERDOMAIN', 'COMPUTERNAME', 'APPDATA', 'LOCALAPPDATA',
46
+ 'PROGRAMDATA', 'PUBLIC', 'ALLUSERSPROFILE', 'SYSTEMROOT', 'SYSTEMDRIVE',
47
+ 'WINDIR', 'COMSPEC', 'TEMP', 'TMP', 'TMPDIR',
48
+ 'PROGRAMFILES', 'PROGRAMFILES(X86)', 'PROGRAMW6432',
49
+ 'COMMONPROGRAMFILES', 'COMMONPROGRAMFILES(X86)', 'COMMONPROGRAMW6432',
50
+ 'PSMODULEPATH', 'NUMBER_OF_PROCESSORS', 'PROCESSOR_ARCHITECTURE', 'OS',
51
+ 'MSYSTEM', 'SHELL', 'TERM', 'LANG', 'LC_ALL', 'TZ',
52
+ 'HTTP_PROXY', 'HTTPS_PROXY', 'NO_PROXY', 'ALL_PROXY',
53
+ ]);
54
+ /** Name prefixes (case-insensitive) a bd/dolt/git/provider child needs. */
55
+ const PROTECTED_PREFIXES = [
56
+ 'GIT_', 'GCM_', 'GH_', 'GITHUB_', 'SSH_', 'BEADS_', 'BD_', 'DOLT_',
57
+ 'APRA_', 'FLEET_', 'ANTHROPIC_', 'CLAUDE_', 'OPENAI_', 'CODEX_',
58
+ 'GEMINI_', 'GOOGLE_', 'COPILOT_', 'AWS_', 'AZURE_', 'NODE_', 'NPM_',
59
+ ];
60
+ /** Anything that looks like a credential is never dropped. */
61
+ const CREDENTIAL_NAME_RE = /(TOKEN|SECRET|PASSWORD|PASSWD|CREDENTIAL|API_?KEY|AUTH)/i;
62
+ export function isProtectedEnvName(name) {
63
+ const upper = name.toUpperCase();
64
+ if (PROTECTED_NAMES.has(upper))
65
+ return true;
66
+ if (PROTECTED_PREFIXES.some((p) => upper.startsWith(p)))
67
+ return true;
68
+ return CREDENTIAL_NAME_RE.test(name);
69
+ }
70
+ /**
71
+ * Size of an environment block as CreateProcess sees it: each variable is
72
+ * `NAME=VALUE\0`, and the block ends with one extra `\0`. JS string length is
73
+ * UTF-16 code units, the same unit Windows uses.
74
+ */
75
+ export function envBlockSize(env) {
76
+ let size = 1;
77
+ for (const [k, v] of Object.entries(env))
78
+ size += k.length + 1 + v.length + 1;
79
+ return size;
80
+ }
81
+ /** Dedupe a PATH value: case-insensitive, trailing slashes ignored, first wins, empties dropped. */
82
+ export function dedupePathValue(value, sep) {
83
+ const seen = new Set();
84
+ const out = [];
85
+ for (const raw of value.split(sep)) {
86
+ const entry = raw.trim();
87
+ if (!entry)
88
+ continue;
89
+ const norm = entry.replace(/[\\/]+$/, '').toLowerCase();
90
+ if (seen.has(norm))
91
+ continue;
92
+ seen.add(norm);
93
+ out.push(entry);
94
+ }
95
+ return out.join(sep);
96
+ }
97
+ /**
98
+ * Apply the bounding rule (see the file header). Never mutates `env`.
99
+ *
100
+ * @param env the environment the child would otherwise receive
101
+ * @param opts.sep PATH separator (';' on Windows, the default)
102
+ * @param opts.capChars block cap in UTF-16 code units
103
+ */
104
+ export function boundChildEnv(env, opts = {}) {
105
+ const sep = opts.sep ?? ';';
106
+ const cap = opts.capChars ?? CHILD_ENV_BLOCK_CAP_CHARS;
107
+ const input = {};
108
+ for (const [k, v] of Object.entries(env))
109
+ if (v !== undefined)
110
+ input[k] = v;
111
+ const sizeBefore = envBlockSize(input);
112
+ const out = {};
113
+ let pathKey = null;
114
+ const pathParts = [];
115
+ for (const [k, v] of Object.entries(input)) {
116
+ if (k.toUpperCase() === 'PATH') {
117
+ if (pathKey === null) {
118
+ pathKey = k;
119
+ out[k] = '';
120
+ }
121
+ pathParts.push(v);
122
+ continue;
123
+ }
124
+ out[k] = v;
125
+ }
126
+ const rawPath = pathParts.join(sep);
127
+ const pathEntriesBefore = rawPath.split(sep).filter((e) => e.trim()).length;
128
+ let pathEntriesAfter = 0;
129
+ if (pathKey !== null) {
130
+ out[pathKey] = dedupePathValue(rawPath, sep);
131
+ pathEntriesAfter = out[pathKey] ? out[pathKey].split(sep).length : 0;
132
+ }
133
+ const dropped = [];
134
+ let size = envBlockSize(out);
135
+ if (size > cap) {
136
+ const candidates = Object.keys(out)
137
+ .filter((k) => !isProtectedEnvName(k))
138
+ .sort((a, b) => (b.length + out[b].length) - (a.length + out[a].length));
139
+ for (const k of candidates) {
140
+ if (size <= cap)
141
+ break;
142
+ size -= k.length + 1 + out[k].length + 1;
143
+ delete out[k];
144
+ dropped.push(k);
145
+ }
146
+ }
147
+ return {
148
+ env: out,
149
+ report: {
150
+ sizeBefore,
151
+ sizeAfter: size,
152
+ pathEntriesBefore,
153
+ pathEntriesAfter,
154
+ dropped,
155
+ overCap: size > cap,
156
+ },
157
+ };
158
+ }
159
+ /** One-line human summary of a report, for a warning log. */
160
+ export function describeBoundedEnv(report) {
161
+ const parts = [
162
+ `child env block ${report.sizeBefore} -> ${report.sizeAfter} chars (cap ${CHILD_ENV_BLOCK_CAP_CHARS})`,
163
+ `PATH entries ${report.pathEntriesBefore} -> ${report.pathEntriesAfter}`,
164
+ ];
165
+ if (report.dropped.length)
166
+ parts.push(`dropped oversized vars: ${report.dropped.join(', ')}`);
167
+ if (report.overCap)
168
+ parts.push('STILL OVER CAP from protected vars alone (PATH/credentials) -- Windows may refuse to spawn child processes ("Not enough memory resources")');
169
+ return parts.join('; ');
170
+ }
171
+ //# sourceMappingURL=child-env-bound.js.map
@@ -0,0 +1,57 @@
1
+ /**
2
+ * The git executable every fleet-server git spawn uses.
3
+ *
4
+ * On Windows, CreateProcess (and libuv's own search, which Node's child_process
5
+ * uses) looks in the CURRENT DIRECTORY before PATH when a bare program name is
6
+ * given. Every KB / code-intelligence git call runs with a work folder as its
7
+ * cwd, so `execFileSync('git', ..., { cwd: workFolder })` would run a git.exe
8
+ * planted at the root of that work folder instead of the real git
9
+ * (apra-fleet-rx6b).
10
+ *
11
+ * gitExecutable() therefore resolves git ONCE, on win32, to an absolute path
12
+ * taken ONLY from PATH entries -- never the process cwd or any spawn cwd:
13
+ * - empty and relative PATH entries are skipped (a relative entry, like an
14
+ * empty one, would be resolved against the cwd);
15
+ * - surrounding double quotes on an entry are stripped;
16
+ * - PATHEXT order is honoured, restricted to the extensions a shell-less
17
+ * spawn can run directly (.EXE / .COM). A git.cmd / git.bat shim cannot be
18
+ * spawned without a shell (Node refuses it with EINVAL), so it is never
19
+ * returned; Git for Windows puts cmd\git.exe on PATH.
20
+ * The PATH-only search itself lives in windows-executable.ts (shared with the
21
+ * Windows shells the fleet server starts). The result is cached for the
22
+ * process. A missing git throws GitNotFoundError, one clear error naming PATH, instead of a confusing failure in whichever
23
+ * caller ran first. A failed lookup is not cached, so installing git later
24
+ * starts working without a restart.
25
+ *
26
+ * On every other platform the bare name 'git' is returned unchanged: execvp
27
+ * never searches the cwd unless PATH itself says so.
28
+ *
29
+ * Out of scope: packages/apra-fleet-client git spawns (separate package).
30
+ * Member-bound command STRINGS (src/os/*.ts builders, member-config-io, vcs
31
+ * providers) run on the member through its own shell and are not spawns by
32
+ * the fleet server's own process.
33
+ */
34
+ import { type WindowsExecutableDeps } from './windows-executable.js';
35
+ export declare const GIT_NOT_FOUND_CODE = "E-GIT-NOT-FOUND";
36
+ export declare class GitNotFoundError extends Error {
37
+ readonly searched: readonly string[];
38
+ readonly code = "E-GIT-NOT-FOUND";
39
+ constructor(searched: readonly string[]);
40
+ }
41
+ /** git has no preferred location: only the PATH fields of the shared deps apply. */
42
+ export type GitResolveDeps = Pick<WindowsExecutableDeps, 'platform' | 'pathValue' | 'pathext' | 'isFile'>;
43
+ export declare function defaultGitResolveDeps(): GitResolveDeps;
44
+ /**
45
+ * Pure resolution (no cache). Returns 'git' on non-Windows platforms; on win32
46
+ * returns an absolute path from a PATH entry or throws GitNotFoundError.
47
+ */
48
+ export declare function resolveGitExecutable(deps: GitResolveDeps): string;
49
+ /**
50
+ * The git executable for a fleet-server spawn: cached absolute PATH-only
51
+ * resolution on win32, bare 'git' elsewhere. Throws GitNotFoundError on win32
52
+ * when git is not on PATH.
53
+ */
54
+ export declare function gitExecutable(): string;
55
+ /** Test hook: forget the cached resolution. */
56
+ export declare function resetGitExecutableCache(): void;
57
+ //# sourceMappingURL=git-executable.d.ts.map