@apralabs/apra-fleet 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -0,0 +1,177 @@
1
+ /**
2
+ * `apra-fleet call` -- generic member-session tool call.
3
+ *
4
+ * apra-fleet call --member <uuid> [--kb-maintainer] <tool> [--args-file <path>]
5
+ * apra-fleet call --member <uuid> [--kb-maintainer] --list-tools
6
+ *
7
+ * Opens a MEMBER session (?member=<uuid>) against the LOCAL server through
8
+ * apra-fleet-client, so the server's own input schema validates the arguments
9
+ * and the member tool allowlist applies. Arguments are ALWAYS read from a JSON
10
+ * file -- there is deliberately no inline-JSON flag. Without --args-file the
11
+ * arguments are {}, allowed only for a tool whose input schema requires none. The session is opened with
12
+ * origin=engine, so its kb_/code_ calls are excluded from session_stats. Failures are printed as a
13
+ * structured JSON error on stderr and the exit code is non-zero.
14
+ *
15
+ * --kb-maintainer adds the engine's kb_maintainer grant (kb_maintainer=1): the
16
+ * session is also served kb_promote, kb_resolve_contradiction and
17
+ * kb_reconcile_prefilter, and may pass kb_import an explicit path. Remote
18
+ * memberCall passes it only when calling as a repository's kb_maintainer.
19
+ */
20
+ import fs from 'node:fs';
21
+ const USAGE = `apra-fleet call -- call a tool as a registered member session
22
+
23
+ Usage:
24
+ apra-fleet call --member <uuid> [--kb-maintainer] <tool> [--args-file <path>]
25
+ apra-fleet call --member <uuid> [--kb-maintainer] --list-tools
26
+
27
+ --member <uuid> Registered member id (an unregistered id fails with HTTP 403)
28
+ --args-file <path> JSON file holding the tool arguments (a JSON object); omit it
29
+ for a tool with no required arguments (they default to {})
30
+ --rm-args-file Delete the args file once read (used by remote memberCall)
31
+ --kb-maintainer Open the session with the kb_maintainer grant (adds kb_promote
32
+ and kb_resolve_contradiction; used by memberCall for the
33
+ repository's kb_maintainer)
34
+ --list-tools Print the member session's tools/list
35
+ --help, -h Show this help`;
36
+ function parse(argv) {
37
+ const out = { listTools: false, rmArgsFile: false, kbMaintainer: false, help: false };
38
+ for (let i = 0; i < argv.length; i++) {
39
+ const a = argv[i];
40
+ if (a === '--help' || a === '-h')
41
+ out.help = true;
42
+ else if (a === '--list-tools')
43
+ out.listTools = true;
44
+ else if (a === '--rm-args-file')
45
+ out.rmArgsFile = true;
46
+ else if (a === '--kb-maintainer')
47
+ out.kbMaintainer = true;
48
+ else if (a === '--member' || a === '--args-file') {
49
+ const v = argv[++i];
50
+ if (v === undefined || v.startsWith('--'))
51
+ return { error: `${a} requires a value` };
52
+ if (a === '--member')
53
+ out.member = v;
54
+ else
55
+ out.argsFile = v;
56
+ }
57
+ else if (a.startsWith('--'))
58
+ return { error: `unknown option ${a}` };
59
+ else if (out.tool === undefined)
60
+ out.tool = a;
61
+ else
62
+ return { error: `unexpected argument ${a}` };
63
+ }
64
+ return out;
65
+ }
66
+ function fail(io, code, message, extra = {}) {
67
+ io.err(JSON.stringify({ error: { code, message, ...extra } }));
68
+ return 1;
69
+ }
70
+ /** The required argument names of `tool` in a tools/list answer ([] when the
71
+ * tool is not listed: the server then reports the unknown tool itself). */
72
+ function requiredArgs(list, tool) {
73
+ const tools = list?.tools;
74
+ const t = Array.isArray(tools) ? tools.find(x => x?.name === tool) : undefined;
75
+ const req = t?.inputSchema?.required;
76
+ return Array.isArray(req) ? req.map(String) : [];
77
+ }
78
+ /** Returns the process exit code. */
79
+ export async function runCall(argv, deps = {}) {
80
+ const io = deps.io ?? { out: t => console.log(t), err: t => console.error(t) };
81
+ const parsed = parse(argv);
82
+ if ('error' in parsed)
83
+ return fail(io, 'E-USAGE', parsed.error);
84
+ if (parsed.help) {
85
+ io.out(USAGE);
86
+ return 0;
87
+ }
88
+ if (!parsed.member)
89
+ return fail(io, 'E-USAGE', '--member <uuid> is required');
90
+ if (parsed.listTools) {
91
+ if (parsed.tool || parsed.argsFile)
92
+ return fail(io, 'E-USAGE', '--list-tools takes no tool name or --args-file');
93
+ }
94
+ else {
95
+ if (!parsed.tool)
96
+ return fail(io, 'E-USAGE', 'a tool name is required (or use --list-tools)');
97
+ if (parsed.rmArgsFile && !parsed.argsFile)
98
+ return fail(io, 'E-USAGE', '--rm-args-file requires --args-file <path>');
99
+ }
100
+ // No --args-file: the arguments default to {} -- checked against the tool's
101
+ // input schema once connected (a tool with required arguments still needs a file).
102
+ let args = parsed.listTools ? undefined : {};
103
+ if (!parsed.listTools && parsed.argsFile) {
104
+ try {
105
+ args = JSON.parse((deps.readFile ?? (p => fs.readFileSync(p, 'utf8')))(parsed.argsFile));
106
+ }
107
+ catch (e) {
108
+ return fail(io, 'E-ARGS-FILE', `cannot read JSON from ${parsed.argsFile}: ${e.message}`);
109
+ }
110
+ finally {
111
+ if (parsed.rmArgsFile) {
112
+ try {
113
+ (deps.removeFile ?? (p => fs.rmSync(p, { force: true })))(parsed.argsFile);
114
+ }
115
+ catch { /* ignore */ }
116
+ }
117
+ }
118
+ if (args === null || typeof args !== 'object' || Array.isArray(args)) {
119
+ return fail(io, 'E-ARGS-FILE', `${parsed.argsFile} must contain a JSON object`);
120
+ }
121
+ }
122
+ const connect = deps.connect ?? (async (id, opts) => {
123
+ const m = await import('@apralabs/apra-fleet-client/server-resolution');
124
+ // origin=engine: this verb is the engine acting as the member (remote
125
+ // memberCall), so its kb_/code_ calls are not counted in session_stats.
126
+ return m.connectFleetMember(id, { origin: 'engine', ...(opts.kbMaintainer ? { kbMaintainer: true } : {}) });
127
+ });
128
+ let session;
129
+ try {
130
+ session = await connect(parsed.member, { kbMaintainer: parsed.kbMaintainer });
131
+ }
132
+ catch (e) {
133
+ const err = e;
134
+ if (err.status === 403) {
135
+ return fail(io, 'E-MEMBER-FORBIDDEN', `server refused member ${parsed.member}: not a registered member (HTTP 403)`, { status: 403 });
136
+ }
137
+ if (err.status === 401) {
138
+ return fail(io, 'E-MEMBER-SECRET', `server refused the member session for ${parsed.member}: the member access secret (member-access.key in this install's data dir) was missing or did not match (HTTP 401). Run this as the install's own user, with the same APRA_FLEET_DATA_DIR as its server.`, { status: 401 });
139
+ }
140
+ return fail(io, err.code ?? 'E-CONNECT', err.message);
141
+ }
142
+ try {
143
+ if (parsed.listTools) {
144
+ io.out(JSON.stringify(await session.mcpClient.listTools()));
145
+ return 0;
146
+ }
147
+ if (!parsed.argsFile) {
148
+ const required = requiredArgs(await session.mcpClient.listTools(), parsed.tool);
149
+ if (required.length) {
150
+ return fail(io, 'E-USAGE', `--args-file <path> is required (${parsed.tool} requires: ${required.join(', ')})`, { tool: parsed.tool });
151
+ }
152
+ }
153
+ const result = await session.mcpClient.callTool(parsed.tool, args);
154
+ if (result && result.isError) {
155
+ const text = (result.content ?? []).map(c => c.text ?? '').join('\n');
156
+ return fail(io, 'E-TOOL', text || 'tool returned an error', { tool: parsed.tool });
157
+ }
158
+ io.out(JSON.stringify(result));
159
+ return 0;
160
+ }
161
+ catch (e) {
162
+ return fail(io, 'E-CALL', e.message, { tool: parsed.tool });
163
+ }
164
+ finally {
165
+ try {
166
+ if (session.close)
167
+ await session.close();
168
+ else
169
+ session.transport.stop?.();
170
+ }
171
+ catch { /* ignore */ }
172
+ }
173
+ }
174
+ export function runCallCli(argv) {
175
+ runCall(argv).then(code => process.exit(code), e => { console.error(String(e)); process.exit(1); });
176
+ }
177
+ //# sourceMappingURL=call.js.map
@@ -0,0 +1,75 @@
1
+ import { type ProviderInstallConfig } from './config.js';
2
+ export declare const CLAUDE_MOD_MARKETPLACE = "apra-fleet-local";
3
+ export declare const CLAUDE_MOD_PLUGIN = "fleet-status";
4
+ export declare const CLAUDE_MOD_ID = "fleet-status@apra-fleet-local";
5
+ /** Repo-relative source folder of the mod (packaged as the claudePlugins manifest section). */
6
+ export declare const CLAUDE_MOD_SOURCE_DIR = "plugins/claude-code/fleet-status";
7
+ export declare function isClaudeModRuntimeFile(relPath: string): boolean;
8
+ /** <apra-fleet home>/claude-plugins -- the local marketplace root. */
9
+ export declare function claudePluginsDir(): string;
10
+ /** The marketplace manifest written next to the plugin folder. */
11
+ export declare function claudeModMarketplaceJson(): string;
12
+ /**
13
+ * True when `statusLine` is the entry apra-fleet install wrote: its command
14
+ * runs apra-fleet's fleet-statusline script. Anything else is the user's own
15
+ * and is never overwritten or removed.
16
+ */
17
+ export declare function isApraFleetStatusLine(statusLine: unknown): boolean;
18
+ /** Remove the statusLine from `paths`' settings only if apra-fleet wrote it. Returns true when removed. */
19
+ export declare function removeApraFleetStatusLine(paths: ProviderInstallConfig): boolean;
20
+ export interface ClaudeModDeps {
21
+ /** Absolute path of the claude executable, or null when it is not on PATH. */
22
+ resolveClaude: () => string | null;
23
+ /** Run `file args...`; resolves on exit 0, throws (with stderr/stdout attached) otherwise. */
24
+ exec: (file: string, args: string[], timeoutMs: number) => void;
25
+ }
26
+ /**
27
+ * The spawn for `file args...` without a shell. Node refuses to spawn a
28
+ * .cmd/.bat (npm's claude.cmd) without a shell (CVE-2024-27980), and
29
+ * shell:true would join argv unquoted -- so for those the cmd.exe line is
30
+ * built here with every argument quoted and passed verbatim. Exported for tests.
31
+ */
32
+ export declare function claudeSpawnSpec(file: string, args: string[], platform?: NodeJS.Platform, comSpec?: string | undefined): {
33
+ cmd: string;
34
+ argv: string[];
35
+ verbatim: boolean;
36
+ };
37
+ /** Test-only: inject fakes for the claude CLI calls. */
38
+ export declare function _setClaudeModDeps(overrides: Partial<ClaudeModDeps>): void;
39
+ /** Test-only: restore the real claude CLI deps. */
40
+ export declare function _resetClaudeModDeps(): void;
41
+ export declare function claudeModStepEnabled(): boolean;
42
+ export type ClaudeModResult = {
43
+ status: 'installed';
44
+ dir: string;
45
+ note?: string;
46
+ } | {
47
+ status: 'skipped';
48
+ reason: string;
49
+ };
50
+ /** True when Claude's settings already have the mod enabled (an earlier install registered it). */
51
+ export declare function claudeModRegistered(paths: ProviderInstallConfig): boolean;
52
+ /**
53
+ * Install (or upgrade) the fleet-status mod for Claude Code. `files` are the
54
+ * mod's runtime files relative to the mod folder. Never throws: any failure is
55
+ * returned as `skipped` with a one-line reason, and the caller keeps the
56
+ * statusLine fallback. `installed` only when BOTH
57
+ * claude plugin marketplace add <dir> --scope user
58
+ * claude plugin install fleet-status@apra-fleet-local --scope user
59
+ * exited 0 (both are idempotent: re-running them on an existing install exits 0).
60
+ */
61
+ export declare function installClaudeMod(files: Array<{
62
+ relPath: string;
63
+ content: Buffer | string;
64
+ }>, opts?: {
65
+ alreadyRegistered?: boolean;
66
+ }): ClaudeModResult;
67
+ /**
68
+ * Remove the fleet-status mod: best-effort `claude plugin uninstall` and
69
+ * `claude plugin marketplace remove` (non-zero exits mean "already gone"),
70
+ * then the claude-plugins folder, and finally any leftover plugin/marketplace
71
+ * keys in Claude's settings (for when the claude CLI is unavailable). Prints
72
+ * one plan line (also under --dry-run). Returns true when anything was found.
73
+ */
74
+ export declare function uninstallClaudeMod(paths: ProviderInstallConfig, dryRun: boolean): boolean;
75
+ //# sourceMappingURL=claude-mod.d.ts.map
@@ -0,0 +1,288 @@
1
+ /**
2
+ * The fleet-status Claude Code mod (plugins/claude-code/fleet-status/): a
3
+ * plugin with function hooks that shows apra-fleet member status in Claude
4
+ * Code's status line and a /fleet-status pane, reading the fleet_snapshot MCP
5
+ * tool. `apra-fleet install --llm claude` installs it in place of the
6
+ * statusLine script; uninstall removes it.
7
+ *
8
+ * Layout on disk -- a local folder marketplace under the apra-fleet home:
9
+ * <FLEET_BASE>/claude-plugins/.claude-plugin/marketplace.json (apra-fleet-local)
10
+ * <FLEET_BASE>/claude-plugins/fleet-status/... (the plugin)
11
+ * A plugin installed from a folder marketplace whose entry is a relative path
12
+ * is read from that folder, so an upgrade only re-copies the files.
13
+ *
14
+ * Every `claude` call is argv-based (no shell, no variable expansion), with
15
+ * windowsHide and an explicit timeout. This module must not import install.ts:
16
+ * uninstall.ts uses it and its tests mock install.ts wholesale.
17
+ */
18
+ import fs from 'node:fs';
19
+ import path from 'node:path';
20
+ import { spawnSync } from 'node:child_process';
21
+ import { FLEET_BASE, readConfig, writeConfig } from './config.js';
22
+ import { findExecutableOnPath, splitPath } from '../utils/find-on-path.js';
23
+ export const CLAUDE_MOD_MARKETPLACE = 'apra-fleet-local';
24
+ export const CLAUDE_MOD_PLUGIN = 'fleet-status';
25
+ export const CLAUDE_MOD_ID = `${CLAUDE_MOD_PLUGIN}@${CLAUDE_MOD_MARKETPLACE}`;
26
+ /** Repo-relative source folder of the mod (packaged as the claudePlugins manifest section). */
27
+ export const CLAUDE_MOD_SOURCE_DIR = 'plugins/claude-code/fleet-status';
28
+ /**
29
+ * Paths (relative to the mod folder, forward slashes) that are authoring-time
30
+ * only and never shipped: generated type stubs (gitignored, ~1MB), tests, and
31
+ * the tsconfig that extends those stubs. Mirrored EXACTLY by
32
+ * scripts/gen-sea-config.mjs (claudeModRuntimeFile) so the SEA binary and a
33
+ * dev/npm install ship the same tree.
34
+ */
35
+ const CLAUDE_MOD_EXCLUDED_DIRS = new Set(['tests', 'test', 'node_modules']);
36
+ export function isClaudeModRuntimeFile(relPath) {
37
+ const p = relPath.replace(/\\/g, '/');
38
+ if (p === 'tsconfig.json')
39
+ return false;
40
+ if (p.startsWith('.claude-plugin/types/'))
41
+ return false;
42
+ const parts = p.split('/');
43
+ if (parts.slice(0, -1).some((d) => CLAUDE_MOD_EXCLUDED_DIRS.has(d)))
44
+ return false;
45
+ if (parts[parts.length - 1] === '.gitignore')
46
+ return false;
47
+ return true;
48
+ }
49
+ /** <apra-fleet home>/claude-plugins -- the local marketplace root. */
50
+ export function claudePluginsDir() {
51
+ return path.join(FLEET_BASE, 'claude-plugins');
52
+ }
53
+ /** The marketplace manifest written next to the plugin folder. */
54
+ export function claudeModMarketplaceJson() {
55
+ return JSON.stringify({
56
+ name: CLAUDE_MOD_MARKETPLACE,
57
+ owner: { name: 'Apra Labs' },
58
+ description: 'Claude Code plugins installed locally by apra-fleet.',
59
+ plugins: [
60
+ {
61
+ name: CLAUDE_MOD_PLUGIN,
62
+ source: `./${CLAUDE_MOD_PLUGIN}`,
63
+ description: 'apra-fleet member status in the status line and a /fleet-status pane.',
64
+ },
65
+ ],
66
+ }, null, 2) + '\n';
67
+ }
68
+ // --- statusLine ownership (all providers) ---
69
+ /**
70
+ * True when `statusLine` is the entry apra-fleet install wrote: its command
71
+ * runs apra-fleet's fleet-statusline script. Anything else is the user's own
72
+ * and is never overwritten or removed.
73
+ */
74
+ export function isApraFleetStatusLine(statusLine) {
75
+ const cmd = statusLine?.command;
76
+ return typeof cmd === 'string' && cmd.includes('fleet-statusline');
77
+ }
78
+ /** Remove the statusLine from `paths`' settings only if apra-fleet wrote it. Returns true when removed. */
79
+ export function removeApraFleetStatusLine(paths) {
80
+ const settings = readConfig(paths);
81
+ if (!settings.statusLine || !isApraFleetStatusLine(settings.statusLine))
82
+ return false;
83
+ delete settings.statusLine;
84
+ writeConfig(paths, settings);
85
+ return true;
86
+ }
87
+ /** Quote one argument for a cmd.exe command line (Windows paths never contain `"`). */
88
+ function cmdQuote(arg) {
89
+ return /[\s"&|<>^()%!,;=]/.test(arg) ? `"${arg}"` : arg;
90
+ }
91
+ /**
92
+ * The spawn for `file args...` without a shell. Node refuses to spawn a
93
+ * .cmd/.bat (npm's claude.cmd) without a shell (CVE-2024-27980), and
94
+ * shell:true would join argv unquoted -- so for those the cmd.exe line is
95
+ * built here with every argument quoted and passed verbatim. Exported for tests.
96
+ */
97
+ export function claudeSpawnSpec(file, args, platform = process.platform, comSpec = process.env.ComSpec) {
98
+ if (platform === 'win32' && /\.(cmd|bat)$/i.test(file)) {
99
+ return { cmd: comSpec || 'cmd.exe', argv: ['/d', '/s', '/c', `"${[file, ...args].map(cmdQuote).join(' ')}"`], verbatim: true };
100
+ }
101
+ return { cmd: file, argv: args, verbatim: false };
102
+ }
103
+ function realExec(file, args, timeoutMs) {
104
+ const spec = claudeSpawnSpec(file, args);
105
+ const r = spawnSync(spec.cmd, spec.argv, {
106
+ stdio: ['ignore', 'pipe', 'pipe'], timeout: timeoutMs, windowsHide: true, encoding: 'utf-8', windowsVerbatimArguments: spec.verbatim,
107
+ });
108
+ if (r.error)
109
+ throw Object.assign(r.error, { stdout: r.stdout, stderr: r.stderr });
110
+ if (r.status !== 0) {
111
+ throw Object.assign(new Error(`exited ${r.status ?? r.signal}`), { status: r.status, signal: r.signal, stdout: r.stdout, stderr: r.stderr });
112
+ }
113
+ }
114
+ /**
115
+ * The claude executable on PATH, without a shell. On Windows only real
116
+ * launchers count (claude.exe from the native installer, claude.cmd/.bat from
117
+ * npm): npm also drops an extensionless POSIX `claude` shim next to the .cmd,
118
+ * which a plain PATHEXT walk ('' first) would pick and which cannot be spawned.
119
+ */
120
+ function resolveClaudeOnPath() {
121
+ if (process.platform !== 'win32')
122
+ return findExecutableOnPath('claude');
123
+ for (const dir of splitPath(process.env.PATH ?? '', 'win32')) {
124
+ for (const ext of ['.exe', '.cmd', '.bat']) {
125
+ const candidate = path.win32.join(dir, `claude${ext}`);
126
+ try {
127
+ if (fs.statSync(candidate).isFile())
128
+ return candidate;
129
+ }
130
+ catch { /* not here */ }
131
+ }
132
+ }
133
+ return null;
134
+ }
135
+ const realClaudeModDeps = {
136
+ resolveClaude: resolveClaudeOnPath,
137
+ exec: realExec,
138
+ };
139
+ let claudeModDeps = realClaudeModDeps;
140
+ /** Test-only: inject fakes for the claude CLI calls. */
141
+ export function _setClaudeModDeps(overrides) {
142
+ claudeModDeps = { ...realClaudeModDeps, ...overrides };
143
+ }
144
+ /** Test-only: restore the real claude CLI deps. */
145
+ export function _resetClaudeModDeps() {
146
+ claudeModDeps = realClaudeModDeps;
147
+ }
148
+ export function claudeModStepEnabled() {
149
+ if (process.env.NODE_ENV !== 'test')
150
+ return true;
151
+ return process.env.APRA_FLEET_ENABLE_CLAUDE_MOD_STEP === '1';
152
+ }
153
+ /** Per-call timeout for each `claude plugin ...` command. */
154
+ const CLAUDE_CLI_TIMEOUT_MS = 60_000;
155
+ /** One printable ASCII line describing why a claude call failed. */
156
+ function failureText(err) {
157
+ const e = err;
158
+ if (e?.code === 'ETIMEDOUT' || e?.signal === 'SIGTERM')
159
+ return `timed out after ${CLAUDE_CLI_TIMEOUT_MS / 1000}s`;
160
+ if (e?.code === 'ENOENT')
161
+ return 'claude executable could not be started (ENOENT)';
162
+ const pick = (v) => String(v ?? '').split(/\r?\n/).map((l) => l.replace(/[^\x20-\x7e]/g, '').trim()).find(Boolean);
163
+ const detail = pick(e?.stderr) ?? pick(e?.stdout) ?? pick(e?.message) ?? 'unknown error';
164
+ return typeof e?.status === 'number' ? `exit ${e.status}: ${detail}` : detail;
165
+ }
166
+ /** True when Claude's settings already have the mod enabled (an earlier install registered it). */
167
+ export function claudeModRegistered(paths) {
168
+ return hasKey(readConfig(paths).enabledPlugins, CLAUDE_MOD_ID);
169
+ }
170
+ /**
171
+ * Install (or upgrade) the fleet-status mod for Claude Code. `files` are the
172
+ * mod's runtime files relative to the mod folder. Never throws: any failure is
173
+ * returned as `skipped` with a one-line reason, and the caller keeps the
174
+ * statusLine fallback. `installed` only when BOTH
175
+ * claude plugin marketplace add <dir> --scope user
176
+ * claude plugin install fleet-status@apra-fleet-local --scope user
177
+ * exited 0 (both are idempotent: re-running them on an existing install exits 0).
178
+ */
179
+ export function installClaudeMod(files, opts = {}) {
180
+ const runtime = files.filter((f) => isClaudeModRuntimeFile(f.relPath));
181
+ if (!runtime.some((f) => f.relPath.replace(/\\/g, '/') === '.claude-plugin/plugin.json')) {
182
+ return { status: 'skipped', reason: 'the mod files are not packaged in this apra-fleet build' };
183
+ }
184
+ const deps = claudeModDeps;
185
+ let claude;
186
+ try {
187
+ claude = deps.resolveClaude();
188
+ }
189
+ catch {
190
+ claude = null;
191
+ }
192
+ const dir = claudePluginsDir();
193
+ // An earlier install already registered the mod, which Claude reads in place
194
+ // from `dir`: refresh the files even without the CLI (e.g. an update run with
195
+ // a narrow PATH), rather than falling back to the statusLine script and
196
+ // showing fleet status twice.
197
+ const refreshOnly = !claude && opts.alreadyRegistered === true && fs.existsSync(dir);
198
+ if (!claude && !refreshOnly)
199
+ return { status: 'skipped', reason: "the 'claude' CLI was not found on PATH" };
200
+ try {
201
+ const pluginDir = path.join(dir, CLAUDE_MOD_PLUGIN);
202
+ // Clear first so files dropped by a newer mod version do not linger.
203
+ fs.rmSync(pluginDir, { recursive: true, force: true });
204
+ for (const f of runtime) {
205
+ const dest = path.join(pluginDir, ...f.relPath.replace(/\\/g, '/').split('/'));
206
+ fs.mkdirSync(path.dirname(dest), { recursive: true });
207
+ fs.writeFileSync(dest, f.content);
208
+ }
209
+ fs.mkdirSync(path.join(dir, '.claude-plugin'), { recursive: true });
210
+ fs.writeFileSync(path.join(dir, '.claude-plugin', 'marketplace.json'), claudeModMarketplaceJson());
211
+ }
212
+ catch (err) {
213
+ return { status: 'skipped', reason: `could not write ${dir}: ${err.message}` };
214
+ }
215
+ if (!claude) {
216
+ return { status: 'installed', dir, note: "already registered; files refreshed (the 'claude' CLI was not found on PATH)" };
217
+ }
218
+ const steps = [
219
+ ['plugin', 'marketplace', 'add', dir, '--scope', 'user'],
220
+ ['plugin', 'install', CLAUDE_MOD_ID, '--scope', 'user'],
221
+ ];
222
+ for (const args of steps) {
223
+ try {
224
+ deps.exec(claude, args, CLAUDE_CLI_TIMEOUT_MS);
225
+ }
226
+ catch (err) {
227
+ // An old claude without the `plugin` subcommand lands here too (non-zero exit).
228
+ return { status: 'skipped', reason: `'claude ${args.slice(0, 3).join(' ')}' failed (${failureText(err)})` };
229
+ }
230
+ }
231
+ return { status: 'installed', dir };
232
+ }
233
+ function hasKey(obj, key) {
234
+ return !!obj && typeof obj === 'object' && Object.prototype.hasOwnProperty.call(obj, key);
235
+ }
236
+ /**
237
+ * Remove the fleet-status mod: best-effort `claude plugin uninstall` and
238
+ * `claude plugin marketplace remove` (non-zero exits mean "already gone"),
239
+ * then the claude-plugins folder, and finally any leftover plugin/marketplace
240
+ * keys in Claude's settings (for when the claude CLI is unavailable). Prints
241
+ * one plan line (also under --dry-run). Returns true when anything was found.
242
+ */
243
+ export function uninstallClaudeMod(paths, dryRun) {
244
+ const dir = claudePluginsDir();
245
+ const settings = readConfig(paths);
246
+ const inSettings = hasKey(settings.enabledPlugins, CLAUDE_MOD_ID) || hasKey(settings.extraKnownMarketplaces, CLAUDE_MOD_MARKETPLACE);
247
+ const onDisk = fs.existsSync(dir);
248
+ if (!onDisk && !inSettings)
249
+ return false;
250
+ console.log(` - Removing fleet-status Claude Code mod (${CLAUDE_MOD_ID}): ${dir}`);
251
+ if (dryRun)
252
+ return true;
253
+ if (claudeModStepEnabled()) {
254
+ let claude = null;
255
+ try {
256
+ claude = claudeModDeps.resolveClaude();
257
+ }
258
+ catch { /* not on PATH */ }
259
+ if (claude) {
260
+ for (const args of [
261
+ ['plugin', 'uninstall', CLAUDE_MOD_ID, '--scope', 'user'],
262
+ ['plugin', 'marketplace', 'remove', CLAUDE_MOD_MARKETPLACE],
263
+ ]) {
264
+ try {
265
+ claudeModDeps.exec(claude, args, CLAUDE_CLI_TIMEOUT_MS);
266
+ }
267
+ catch { /* already removed */ }
268
+ }
269
+ }
270
+ }
271
+ if (onDisk)
272
+ fs.rmSync(dir, { recursive: true, force: true });
273
+ // Re-read: the claude CLI above edits the same settings file.
274
+ const after = readConfig(paths);
275
+ let changed = false;
276
+ if (hasKey(after.enabledPlugins, CLAUDE_MOD_ID)) {
277
+ delete after.enabledPlugins[CLAUDE_MOD_ID];
278
+ changed = true;
279
+ }
280
+ if (hasKey(after.extraKnownMarketplaces, CLAUDE_MOD_MARKETPLACE)) {
281
+ delete after.extraKnownMarketplaces[CLAUDE_MOD_MARKETPLACE];
282
+ changed = true;
283
+ }
284
+ if (changed)
285
+ writeConfig(paths, after);
286
+ return true;
287
+ }
288
+ //# sourceMappingURL=claude-mod.js.map
@@ -37,7 +37,30 @@ export declare function getProviderInstallConfig(provider: LlmProvider, homeDir?
37
37
  */
38
38
  export declare function getAgentsDirRelative(provider: LlmProvider): string | undefined;
39
39
  export declare function readConfig(paths: ProviderInstallConfig): any;
40
- export declare function writeConfig(paths: ProviderInstallConfig, config: any): void;
40
+ /**
41
+ * Write a file that carries a credential: owner-only (0600), never briefly
42
+ * readable by others. writeFileSync's mode applies only when the file is
43
+ * created, so an existing file (a provider config the user already had, at
44
+ * 0644) is chmod-ed BEFORE the credential is written into it; a new file is
45
+ * created 0600. The final chmod pins exactly 0600 whatever the umask.
46
+ */
47
+ export declare function writeOwnerOnlyFile(file: string, content: string): void;
48
+ /**
49
+ * writeOwnerOnlyFile for a file another process saves concurrently (Claude
50
+ * Code's ~/.claude.json): the content goes to an owner-only temp file in the
51
+ * same directory, then replaces the target by rename, so a crash or a racing
52
+ * save never leaves it truncated. When the rename fails (e.g. the target is
53
+ * briefly locked on Windows) it falls back to the in-place owner-only write.
54
+ * A symlinked file keeps its link: the temp file is placed next to, and
55
+ * renamed over, the link's real target. On POSIX a file owned by another uid
56
+ * (e.g. install run under sudo) is written in place, since a rename would
57
+ * hand it to the current user. The temp file takes the existing file's
58
+ * owner permission bits (never group/other).
59
+ */
60
+ export declare function writeOwnerOnlyFileAtomic(file: string, content: string): void;
61
+ export declare function writeConfig(paths: ProviderInstallConfig, config: any, opts?: {
62
+ ownerOnly?: boolean;
63
+ }): void;
41
64
  export declare function readInstallConfig(installConfigPath?: string): MultiProviderInstallConfig;
42
65
  export declare function writeInstallConfig(llm: string, skill: 'none' | 'all' | 'fleet' | 'pm', workflowsMode?: 'all' | 'none'): void;
43
66
  //# sourceMappingURL=config.d.ts.map
@@ -141,7 +141,71 @@ export function readConfig(paths) {
141
141
  return {};
142
142
  }
143
143
  }
144
- export function writeConfig(paths, config) {
144
+ /**
145
+ * Write a file that carries a credential: owner-only (0600), never briefly
146
+ * readable by others. writeFileSync's mode applies only when the file is
147
+ * created, so an existing file (a provider config the user already had, at
148
+ * 0644) is chmod-ed BEFORE the credential is written into it; a new file is
149
+ * created 0600. The final chmod pins exactly 0600 whatever the umask.
150
+ */
151
+ export function writeOwnerOnlyFile(file, content) {
152
+ try {
153
+ fs.chmodSync(file, 0o600);
154
+ }
155
+ catch (err) {
156
+ if (err.code !== 'ENOENT')
157
+ throw err;
158
+ }
159
+ fs.writeFileSync(file, content, { mode: 0o600 });
160
+ fs.chmodSync(file, 0o600);
161
+ }
162
+ /**
163
+ * writeOwnerOnlyFile for a file another process saves concurrently (Claude
164
+ * Code's ~/.claude.json): the content goes to an owner-only temp file in the
165
+ * same directory, then replaces the target by rename, so a crash or a racing
166
+ * save never leaves it truncated. When the rename fails (e.g. the target is
167
+ * briefly locked on Windows) it falls back to the in-place owner-only write.
168
+ * A symlinked file keeps its link: the temp file is placed next to, and
169
+ * renamed over, the link's real target. On POSIX a file owned by another uid
170
+ * (e.g. install run under sudo) is written in place, since a rename would
171
+ * hand it to the current user. The temp file takes the existing file's
172
+ * owner permission bits (never group/other).
173
+ */
174
+ export function writeOwnerOnlyFileAtomic(file, content) {
175
+ let target = file;
176
+ try {
177
+ const real = fs.realpathSync(file);
178
+ if (typeof real === 'string' && real)
179
+ target = real;
180
+ }
181
+ catch { /* missing: write at `file` */ }
182
+ let st;
183
+ try {
184
+ st = fs.statSync(target);
185
+ }
186
+ catch { /* new file */ }
187
+ const getuid = process.getuid;
188
+ if (st && typeof getuid === 'function' && typeof st.uid === 'number' && st.uid !== getuid()) {
189
+ writeOwnerOnlyFile(target, content);
190
+ return;
191
+ }
192
+ const mode = st && typeof st.mode === 'number' && (st.mode & 0o700) ? (st.mode & 0o700) | 0o600 : 0o600;
193
+ const tmp = path.join(path.dirname(target), `.${path.basename(target)}.${process.pid}.${Date.now()}.tmp`);
194
+ try {
195
+ fs.writeFileSync(tmp, content, { mode, flag: 'wx' });
196
+ fs.chmodSync(tmp, mode);
197
+ fs.renameSync(tmp, target);
198
+ return;
199
+ }
200
+ catch {
201
+ try {
202
+ fs.unlinkSync(tmp);
203
+ }
204
+ catch { /* not created / already moved */ }
205
+ }
206
+ writeOwnerOnlyFile(target, content);
207
+ }
208
+ export function writeConfig(paths, config, opts = {}) {
145
209
  fs.mkdirSync(paths.configDir, { recursive: true });
146
210
  let content = '';
147
211
  if (paths.settingsFile.endsWith('.toml')) {
@@ -150,7 +214,10 @@ export function writeConfig(paths, config) {
150
214
  else {
151
215
  content = JSON.stringify(config, null, 2) + '\n';
152
216
  }
153
- fs.writeFileSync(paths.settingsFile, content);
217
+ if (opts.ownerOnly)
218
+ writeOwnerOnlyFile(paths.settingsFile, content);
219
+ else
220
+ fs.writeFileSync(paths.settingsFile, content);
154
221
  }
155
222
  export function readInstallConfig(installConfigPath = INSTALL_CONFIG_PATH) {
156
223
  if (!fs.existsSync(installConfigPath)) {