@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,479 @@
1
+ /**
2
+ * Project-level role-agent shadow check.
3
+ *
4
+ * agent-provisioner.ts keeps the member's USER-level agents dir
5
+ * (~/.claude/agents, ...) hash-current with fleet's managed role set. The
6
+ * provider CLI, however, gives the PROJECT-level dir (<workFolder>/.claude/agents)
7
+ * precedence: a stale doer.md left in a member's checkout silently replaces the
8
+ * role prompt fleet delivered, while the user-level dir still looks current.
9
+ *
10
+ * Before dispatch (and on register_member/update_member) this module lists the
11
+ * project-level agents dir on the member, finds files that collide with a
12
+ * managed role (same frontmatter `name:` -- the CLI's agent identity; the
13
+ * basename is only a fallback when a file has no `name:`), and:
14
+ * - untracked (not in the git index, or the work folder is not a git repo):
15
+ * QUARANTINES them into <workFolder>/.claude/agents-shadowed-by-fleet/<stamp>/
16
+ * (outside the dir the CLI loads agents from; never deleted) with a
17
+ * `*` .gitignore so the moved files cannot be swept into a commit;
18
+ * - tracked: leaves them untouched and reports them loudly on every dispatch.
19
+ *
20
+ * The listing is recursive: the CLI discovers agent files in subdirectories of
21
+ * the agents dir too, so a nested file with a colliding `name:` also shadows.
22
+ *
23
+ * Probe + quarantine are at most two member commands, built per OS/shell
24
+ * (POSIX sh, or PowerShell delivered via -EncodedCommand). Nothing here ever
25
+ * throws or blocks a dispatch: failures come back as a warning string.
26
+ */
27
+ import os from 'node:os';
28
+ import path from 'node:path';
29
+ import { getStrategy } from './strategy.js';
30
+ import { getAgentOS, getAgentShell, isPosixShell } from '../utils/agent-helpers.js';
31
+ import { logWarn } from '../utils/log-helpers.js';
32
+ import { escapeShellArg, escapePowerShellArg } from '../utils/shell-escape.js';
33
+ import { wrapPowerShellEncoded } from '../os/windows.js';
34
+ import { getProvider } from '../providers/index.js';
35
+ import { loadCanonicalAgentSet, remoteAgentsDir } from './agent-provisioner.js';
36
+ import { getMemberHomeDir } from './member-home.js';
37
+ export const QUARANTINE_DIR_NAME = 'agents-shadowed-by-fleet';
38
+ const PROBE_TIMEOUT_MS = 20_000;
39
+ // Tab/LF as chars, not PowerShell backtick escapes (portability pre-commit hook).
40
+ const PS_TAB_LF = '$TAB = [string][char]9; $LF = [string][char]10';
41
+ // ---------------------------------------------------------------------------
42
+ // Pure helpers
43
+ // ---------------------------------------------------------------------------
44
+ /** Frontmatter `name:` of a markdown agent file, '' when absent. */
45
+ export function frontmatterName(content) {
46
+ const fm = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
47
+ if (!fm)
48
+ return '';
49
+ const m = /^name:[ \t]*(.*)$/m.exec(fm[1]);
50
+ return m ? cleanName(m[1]) : '';
51
+ }
52
+ function cleanName(raw) {
53
+ return raw.replace(/\r/g, '').trim().replace(/^["']|["']$/g, '').trim();
54
+ }
55
+ /** Managed role set: the top-level .md files of the canonical agent set. */
56
+ export function managedRolesFrom(canonical) {
57
+ const basenames = new Set();
58
+ const names = new Set();
59
+ for (const f of canonical) {
60
+ if (f.relPath.includes('/') || !f.relPath.toLowerCase().endsWith('.md'))
61
+ continue;
62
+ basenames.add(f.relPath.toLowerCase());
63
+ names.add((frontmatterName(f.content) || f.relPath.replace(/\.md$/i, '')).toLowerCase());
64
+ }
65
+ return { basenames, names };
66
+ }
67
+ /** Project-relative agents dir for a provider, or null when the provider has no managed set. */
68
+ export function projectAgentsDirRelative(provider) {
69
+ if (remoteAgentsDir(provider) === null)
70
+ return null;
71
+ const project = getProvider(provider).agentDirectories('__probe__').project.replace(/\\/g, '/');
72
+ return path.posix.dirname(project);
73
+ }
74
+ /** Join member-side path segments with the member's native separator. */
75
+ export function memberJoin(windowsNative, ...parts) {
76
+ const sep = windowsNative ? '\\' : '/';
77
+ const cleaned = parts
78
+ .map((p, i) => {
79
+ let s = p.replace(/[\\/]+/g, sep);
80
+ if (i > 0)
81
+ s = s.replace(/^[\\/]+/, '');
82
+ if (i < parts.length - 1)
83
+ s = s.replace(/[\\/]+$/, '');
84
+ return s;
85
+ })
86
+ .filter(s => s.length > 0);
87
+ return cleaned.join(sep);
88
+ }
89
+ /** Build the one-round-trip listing command for the member's OS/shell. */
90
+ //
91
+ // Git state: 'repo' only when git ran and confirmed a work tree; 'norepo' only
92
+ // when git ran and said "not a git repository", or when no git ran/answered
93
+ // and no ancestor of the work folder has a .git entry. Anything else
94
+ // (git missing inside a repo, dubious-ownership refusal, ...) is 'unknown',
95
+ // which classifyShadows treats as tracked (report only, never move).
96
+ //
97
+ // `linkPaths`: the work-folder-relative prefixes of the agents dir (e.g.
98
+ // .claude, .claude/agents). If any is a symlink/junction the listing is
99
+ // skipped (FLEETSHADOW_LINK) -- it may point at the managed user-level dir.
100
+ export function buildShadowProbeCommand(posix, agentsDir, workFolder, linkPaths = [agentsDir]) {
101
+ if (posix) {
102
+ return [
103
+ `d=${escapeShellArg(agentsDir)}; w=${escapeShellArg(workFolder)}`,
104
+ 'g=unknown',
105
+ 'if command -v git >/dev/null 2>&1; then',
106
+ ' o=$(LC_ALL=C git -C "$w" rev-parse --is-inside-work-tree 2>&1); rc=$?',
107
+ ' if [ "$rc" -eq 0 ] && [ "$o" = true ]; then g=repo',
108
+ " elif printf '%s' \"$o\" | grep -qi 'not a git repository'; then g=norepo; fi",
109
+ 'fi',
110
+ 'if [ "$g" = unknown ]; then',
111
+ ' p="$w"; found=0',
112
+ ' while :; do if [ -e "$p/.git" ]; then found=1; break; fi; q=$(dirname -- "$p"); [ "$q" = "$p" ] && break; p="$q"; done',
113
+ ' [ "$found" = 0 ] && g=norepo',
114
+ 'fi',
115
+ "printf 'FLEETSHADOW_GIT\\t%s\\n' \"$g\"",
116
+ 'lnk=0',
117
+ ...linkPaths.map(lp => `if [ -L ${escapeShellArg(lp)} ]; then lnk=1; printf 'FLEETSHADOW_LINK\\t%s\\n' ${escapeShellArg(lp)}; fi`),
118
+ 'if [ "$lnk" = 0 ] && [ -d "$d" ]; then',
119
+ // -P: never follow symlinks (a linked subdir could lead into the managed user-level dir).
120
+ " find -P \"$d\" -type f -name '*.md' 2>/dev/null | while IFS= read -r f; do",
121
+ // `name:` only inside the leading --- frontmatter block.
122
+ " n=$(awk 'NR>40{exit} NR==1{if ($0 !~ /^---[ \\t\\r]*$/) exit; next} /^---[ \\t\\r]*$/{exit} /^name:/{sub(/^name:[ \\t]*/,\"\"); print; exit}' \"$f\" 2>/dev/null)",
123
+ ' t=U',
124
+ ' if [ "$g" = repo ] && git -C "$w" ls-files --error-unmatch -- "$f" >/dev/null 2>&1; then t=T; fi',
125
+ " printf 'FLEETSHADOW\\t%s\\t%s\\t%s\\n' \"$t\" \"${f#\"$d\"/}\" \"$n\"",
126
+ ' done',
127
+ 'fi',
128
+ "printf 'FLEETSHADOW_DONE\\n'",
129
+ ].join('\n');
130
+ }
131
+ const ps = [
132
+ "$ErrorActionPreference = 'Continue'",
133
+ PS_TAB_LF,
134
+ `$d = ${escapePowerShellArg(agentsDir)}; $w = ${escapePowerShellArg(workFolder)}`,
135
+ "$g = 'unknown'",
136
+ 'if (Get-Command git -ErrorAction SilentlyContinue) {',
137
+ " $env:LC_ALL = 'C'",
138
+ ' $o = (& git -C $w rev-parse --is-inside-work-tree 2>&1 | Out-String)',
139
+ " if ($LASTEXITCODE -eq 0 -and $o.Trim() -eq 'true') { $g = 'repo' } elseif ($o -match 'not a git repository') { $g = 'norepo' }",
140
+ '}',
141
+ "if ($g -eq 'unknown') {",
142
+ ' $p = $w; $found = $false',
143
+ " while ($p) { if (Test-Path -LiteralPath (Join-Path $p '.git')) { $found = $true; break }; $parent = Split-Path -Parent $p; if (-not $parent -or $parent -eq $p) { break }; $p = $parent }",
144
+ " if (-not $found) { $g = 'norepo' }",
145
+ '}',
146
+ "[Console]::Out.Write('FLEETSHADOW_GIT' + $TAB + $g + $LF)",
147
+ '$lnk = $false',
148
+ ...linkPaths.map(lp => `$i = Get-Item -LiteralPath ${escapePowerShellArg(lp)} -Force -ErrorAction SilentlyContinue; if ($i -and ($i.Attributes -band [IO.FileAttributes]::ReparsePoint)) { $lnk = $true; [Console]::Out.Write('FLEETSHADOW_LINK' + $TAB + ${escapePowerShellArg(lp)} + $LF) }`),
149
+ 'if (-not $lnk -and (Test-Path -LiteralPath $d -PathType Container)) {',
150
+ " $root = (Get-Item -LiteralPath $d).FullName.TrimEnd('\\', '/')",
151
+ // Manual walk: Get-ChildItem -Recurse descends into nested junctions/symlinked
152
+ // dirs, which could lead into the managed user-level dir. Skip reparse-point dirs.
153
+ ' $mds = New-Object System.Collections.ArrayList; $stack = New-Object System.Collections.Stack; $stack.Push($d)',
154
+ ' while ($stack.Count -gt 0) {',
155
+ ' $cur = $stack.Pop()',
156
+ " foreach ($c in @(Get-ChildItem -LiteralPath $cur -ErrorAction SilentlyContinue)) {",
157
+ " if ($c.PSIsContainer) { if (-not ($c.Attributes -band [IO.FileAttributes]::ReparsePoint)) { $stack.Push($c.FullName) } }",
158
+ " elseif ($c.Name -like '*.md') { [void]$mds.Add($c) }",
159
+ ' }',
160
+ ' }',
161
+ ' $mds | ForEach-Object {',
162
+ ' $f = $_.FullName',
163
+ " $rel = $f.Substring($root.Length).TrimStart('\\', '/') -replace '\\\\', '/'",
164
+ " $n = ''",
165
+ // `name:` only inside the leading --- frontmatter block.
166
+ " $ls = @(Get-Content -LiteralPath $f -TotalCount 40 -ErrorAction SilentlyContinue)",
167
+ " if ($ls.Count -gt 0 -and $ls[0] -match '^---\\s*$') { for ($k = 1; $k -lt $ls.Count; $k++) { if ($ls[$k] -match '^---\\s*$') { break }; if ($ls[$k] -match '^name:\\s*(.*)$') { $n = $Matches[1]; break } } }",
168
+ " $t = 'U'",
169
+ " if ($g -eq 'repo') { & git -C $w ls-files --error-unmatch -- $f *> $null; if ($LASTEXITCODE -eq 0) { $t = 'T' } }",
170
+ " [Console]::Out.Write('FLEETSHADOW' + $TAB + $t + $TAB + $rel + $TAB + $n + $LF)",
171
+ ' }',
172
+ '}',
173
+ '$global:LASTEXITCODE = 0',
174
+ "[Console]::Out.Write('FLEETSHADOW_DONE' + $LF)",
175
+ ].join('\n');
176
+ return wrapPowerShellEncoded(ps);
177
+ }
178
+ /** Parse the probe's stdout. Returns null when the output is not a complete probe transcript. */
179
+ export function parseShadowProbeOutput(stdout) {
180
+ let gitState = null;
181
+ let done = false;
182
+ const entries = [];
183
+ const links = [];
184
+ for (const raw of stdout.split('\n')) {
185
+ const line = raw.replace(/\r$/, '');
186
+ if (line === 'FLEETSHADOW_DONE') {
187
+ done = true;
188
+ continue;
189
+ }
190
+ const parts = line.split('\t');
191
+ if (parts[0] === 'FLEETSHADOW_LINK' && parts.length >= 2) {
192
+ links.push(parts[1]);
193
+ continue;
194
+ }
195
+ if (parts[0] === 'FLEETSHADOW_GIT' && parts.length >= 2) {
196
+ const g = parts[1].trim();
197
+ gitState = g === 'repo' || g === 'norepo' ? g : 'unknown';
198
+ continue;
199
+ }
200
+ if (parts[0] === 'FLEETSHADOW' && parts.length >= 3) {
201
+ const relPath = parts[2].replace(/\\/g, '/').replace(/^\.\//, '');
202
+ if (!isSafeRelPath(relPath))
203
+ continue;
204
+ entries.push({ relPath, tracked: parts[1] === 'T', name: cleanName(parts.slice(3).join('\t')) });
205
+ }
206
+ }
207
+ if (!done || gitState === null)
208
+ return null;
209
+ return { gitState, entries, links };
210
+ }
211
+ function isSafeRelPath(rel) {
212
+ if (!rel || rel.startsWith('/') || /^[A-Za-z]:/.test(rel))
213
+ return false;
214
+ return !rel.split('/').some(seg => seg === '..' || seg === '');
215
+ }
216
+ /**
217
+ * A file shadows a managed role when its frontmatter `name:` equals a managed
218
+ * role name: the CLI identifies subagents by that name, not by filename, so
219
+ * reviewer.md with `name: code-reviewer` shadows nothing. Only a file with no
220
+ * `name:` falls back to its basename. Case-insensitive.
221
+ * An 'unknown' git state (e.g. git failed inside a real repo) is treated as
222
+ * tracked -- never move a file we cannot prove is untracked.
223
+ */
224
+ export function classifyShadows(probe, roles) {
225
+ const untracked = [];
226
+ const tracked = [];
227
+ for (const e of probe.entries) {
228
+ const base = e.relPath.split('/').pop().toLowerCase();
229
+ const collides = e.name ? roles.names.has(e.name.toLowerCase()) : roles.basenames.has(base);
230
+ if (!collides)
231
+ continue;
232
+ if (e.tracked || probe.gitState === 'unknown')
233
+ tracked.push(e);
234
+ else
235
+ untracked.push(e);
236
+ }
237
+ return { untracked, tracked };
238
+ }
239
+ /** Build the quarantine command: moves each file under quarantineDir, preserving its relative path. */
240
+ export function buildQuarantineCommand(posix, windowsNative, agentsDir, quarantineRoot, quarantineDir, relPaths) {
241
+ const j = (...p) => memberJoin(windowsNative, ...p);
242
+ if (posix) {
243
+ const q = escapeShellArg;
244
+ const lines = [
245
+ `mkdir -p ${q(quarantineDir)} && printf '*\\n' > ${q(j(quarantineRoot, '.gitignore'))}`,
246
+ ...relPaths.map(rel => {
247
+ const dstDir = path.posix.dirname(rel) === '.' ? quarantineDir : j(quarantineDir, path.posix.dirname(rel));
248
+ const src = q(j(agentsDir, rel));
249
+ const dst = q(j(quarantineDir, rel));
250
+ // Reported per file; MOVED only when the source is gone and the copy landed.
251
+ return `if mkdir -p ${q(dstDir)} && mv -f -- ${src} ${dst} && [ ! -e ${src} ] && [ -e ${dst} ]; then printf 'FLEETMOVED\\t%s\\n' ${q(rel)}; else printf 'FLEETMOVEFAIL\\t%s\\n' ${q(rel)}; fi`;
252
+ }),
253
+ "printf 'FLEETQUARANTINE_DONE\\n'",
254
+ ];
255
+ return lines.join('\n');
256
+ }
257
+ const q = escapePowerShellArg;
258
+ const lines = [
259
+ // Cmdlet errors are non-terminating by default; force them terminating so
260
+ // the per-file catch sees them and a failed move is never reported MOVED.
261
+ "$ErrorActionPreference = 'Stop'",
262
+ PS_TAB_LF,
263
+ `try { New-Item -ItemType Directory -Force -Path ${q(quarantineDir)} -ErrorAction Stop | Out-Null; Set-Content -LiteralPath ${q(j(quarantineRoot, '.gitignore'))} -Value '*' -ErrorAction Stop } catch { }`,
264
+ ...relPaths.map(rel => {
265
+ const dstDir = path.posix.dirname(rel) === '.' ? quarantineDir : j(quarantineDir, path.posix.dirname(rel));
266
+ const src = q(j(agentsDir, rel));
267
+ const dst = q(j(quarantineDir, rel));
268
+ return `try { New-Item -ItemType Directory -Force -Path ${q(dstDir)} -ErrorAction Stop | Out-Null; Move-Item -LiteralPath ${src} -Destination ${dst} -Force -ErrorAction Stop; if ((Test-Path -LiteralPath ${src}) -or -not (Test-Path -LiteralPath ${dst})) { throw 'move not verified' }; [Console]::Out.Write('FLEETMOVED' + $TAB + ${q(rel)} + $LF) } catch { [Console]::Out.Write('FLEETMOVEFAIL' + $TAB + ${q(rel)} + $LF) }`;
269
+ }),
270
+ "[Console]::Out.Write('FLEETQUARANTINE_DONE' + $LF)",
271
+ ];
272
+ return wrapPowerShellEncoded(lines.join('\n'));
273
+ }
274
+ export function parseQuarantineOutput(stdout) {
275
+ const moved = [];
276
+ const failed = [];
277
+ for (const raw of stdout.split('\n')) {
278
+ const [tag, rel] = raw.replace(/\r$/, '').split('\t');
279
+ if (tag === 'FLEETMOVED' && rel)
280
+ moved.push(rel);
281
+ else if (tag === 'FLEETMOVEFAIL' && rel)
282
+ failed.push(rel);
283
+ }
284
+ return { moved, failed };
285
+ }
286
+ function describeFiles(entries) {
287
+ return entries
288
+ .map(e => (typeof e === 'string' ? e : e.name ? `${e.relPath} (name: ${e.name})` : e.relPath))
289
+ .join(', ');
290
+ }
291
+ function samePath(a, b, caseInsensitive) {
292
+ const norm = (p) => {
293
+ const s = p.replace(/\\/g, '/').replace(/\/+$/, '');
294
+ return caseInsensitive ? s.toLowerCase() : s;
295
+ };
296
+ return norm(a) === norm(b);
297
+ }
298
+ // ---------------------------------------------------------------------------
299
+ // Member-facing check
300
+ // ---------------------------------------------------------------------------
301
+ function resolveWorkFolder(agent) {
302
+ const wf = agent.workFolder;
303
+ if (agent.agentType === 'local' && (wf === '~' || wf.startsWith('~/')))
304
+ return wf.replace('~', os.homedir());
305
+ return wf;
306
+ }
307
+ function isAbsoluteMemberPath(p) {
308
+ return p.startsWith('/') || /^[A-Za-z]:[\\/]/.test(p) || /^\\\\[^\\/]/.test(p);
309
+ }
310
+ /**
311
+ * Probe the member's project-level agents dir and quarantine/report shadows.
312
+ * Uncached. Never throws: a failed member command yields status 'probe_failed'
313
+ * with a warning; an unexpected internal error is rethrown only to the cached
314
+ * wrapper, which logs it (callers of this function get a warning instead).
315
+ */
316
+ export async function checkProjectAgentShadows(agent, now = new Date()) {
317
+ const base = { status: 'skipped', tracked: [], quarantined: [], notMoved: [] };
318
+ const provider = agent.llmProvider ?? 'claude';
319
+ const relDir = projectAgentsDirRelative(provider);
320
+ if (!relDir)
321
+ return { ...base, skippedReason: `${provider} does not use role-agent files` };
322
+ const workFolder = resolveWorkFolder(agent);
323
+ if (!workFolder || !isAbsoluteMemberPath(workFolder)) {
324
+ return { ...base, skippedReason: 'work folder is not an absolute path' };
325
+ }
326
+ const targetOs = getAgentOS(agent);
327
+ const posix = isPosixShell(targetOs, getAgentShell(agent));
328
+ const windowsNative = targetOs === 'windows' && !posix;
329
+ const wf = windowsNative ? workFolder.replace(/\//g, '\\') : workFolder.replace(/\\/g, '/');
330
+ const agentsDir = memberJoin(windowsNative, wf, relDir);
331
+ const where = `${wf.replace(/\\/g, '/')}/${relDir}`;
332
+ const roles = managedRolesFrom(loadCanonicalAgentSet(provider));
333
+ // Guard: when the work folder IS the member's home dir, the project-level dir
334
+ // is the user-level dir fleet itself provisions -- nothing there is a shadow.
335
+ const homeRel = remoteAgentsDir(provider);
336
+ const home = await getMemberHomeDir(agent);
337
+ if (home && homeRel && samePath(memberJoin(windowsNative, home, homeRel), agentsDir, targetOs !== 'linux')) {
338
+ return { ...base, skippedReason: 'project agents dir is the user-level agents dir' };
339
+ }
340
+ const strategy = getStrategy(agent);
341
+ let probe = null;
342
+ let failDetail = '';
343
+ try {
344
+ // Every prefix of the agents dir under the work folder (.claude, .claude/agents).
345
+ const segs = relDir.split('/');
346
+ const linkPaths = segs.map((_, i) => memberJoin(windowsNative, wf, segs.slice(0, i + 1).join('/')));
347
+ const r = await strategy.execCommand(buildShadowProbeCommand(posix, agentsDir, wf, linkPaths), PROBE_TIMEOUT_MS);
348
+ if (r.code !== 0)
349
+ failDetail = `exit ${r.code}${r.stderr.trim() ? `: ${r.stderr.trim().slice(0, 200)}` : ''}`;
350
+ else {
351
+ probe = parseShadowProbeOutput(r.stdout);
352
+ if (!probe)
353
+ failDetail = 'unparseable probe output';
354
+ }
355
+ }
356
+ catch (err) {
357
+ failDetail = err?.message ?? String(err);
358
+ }
359
+ if (!probe) {
360
+ const warning = `Could not check ${where} on "${agent.friendlyName}" for project-level agent files that would shadow fleet's managed role prompts (${failDetail}). Dispatch continues; if stale role files exist there they override the delivered prompts.`;
361
+ return { ...base, status: 'probe_failed', projectAgentsDir: where, warning };
362
+ }
363
+ if (probe.links.length > 0) {
364
+ // A linked agents dir may resolve to the managed user-level dir; moving
365
+ // anything through it could strip the delivered role set. Skip, and say so.
366
+ const warning = `Skipped the project-level agent shadow check on "${agent.friendlyName}": ${probe.links.join(', ')} is a symlink/junction, so fleet did not inspect or move anything in ${where}. If it points at stale role files they override the delivered prompts.`;
367
+ return { ...base, projectAgentsDir: where, skippedReason: 'agents dir is a symlink/junction', warning };
368
+ }
369
+ const cls = classifyShadows(probe, roles);
370
+ const result = { ...base, status: 'clean', projectAgentsDir: where, tracked: cls.tracked.map(e => e.relPath) };
371
+ const persistent = [];
372
+ const oneShot = [];
373
+ // Unknown home: the "shadows" may be fleet's own user-level files (work
374
+ // folder == home). Never cache such a result; retry once the home resolves.
375
+ if (home === null && (cls.untracked.length > 0 || cls.tracked.length > 0))
376
+ result.retry = true;
377
+ if (cls.untracked.length > 0 && home === null) {
378
+ // Without the member's home we cannot rule out that this dir IS the
379
+ // user-level managed dir -- report only, never move.
380
+ result.notMoved = cls.untracked.map(e => e.relPath);
381
+ persistent.push(`Untracked project-level agent file(s) on "${agent.friendlyName}" shadow fleet's managed role prompts but were not quarantined (member home dir could not be verified): ${describeFiles(cls.untracked)} in ${where}. The member's CLI loads these instead of the delivered role prompts -- remove them.`);
382
+ }
383
+ else if (cls.untracked.length > 0) {
384
+ const stamp = now.toISOString().replace(/[:.]/g, '-');
385
+ const qRootRel = path.posix.join(path.posix.dirname(relDir), QUARANTINE_DIR_NAME);
386
+ const quarantineRoot = memberJoin(windowsNative, wf, qRootRel);
387
+ const quarantineDir = memberJoin(windowsNative, quarantineRoot, stamp);
388
+ const qWhere = `${wf.replace(/\\/g, '/')}/${qRootRel}/${stamp}`;
389
+ const rels = cls.untracked.map(e => e.relPath);
390
+ let moved = [];
391
+ let failed = rels;
392
+ let moveErr = '';
393
+ try {
394
+ const r = await strategy.execCommand(buildQuarantineCommand(posix, windowsNative, agentsDir, quarantineRoot, quarantineDir, rels), PROBE_TIMEOUT_MS);
395
+ const parsed = parseQuarantineOutput(r.stdout);
396
+ moved = parsed.moved.filter(m => rels.includes(m));
397
+ failed = rels.filter(rel => !moved.includes(rel));
398
+ if (failed.length > 0 && r.code !== 0)
399
+ moveErr = ` (exit ${r.code})`;
400
+ }
401
+ catch (err) {
402
+ moveErr = ` (${err?.message ?? String(err)})`;
403
+ }
404
+ result.quarantined = moved;
405
+ result.notMoved = failed;
406
+ if (failed.length > 0)
407
+ result.retry = true;
408
+ if (moved.length > 0) {
409
+ result.quarantineDir = qWhere;
410
+ oneShot.push(`Quarantined ${moved.length} untracked project-level agent file(s) on "${agent.friendlyName}" that shadowed fleet's managed role prompts: moved ${describeFiles(moved)} from ${where} to ${qWhere}.`);
411
+ }
412
+ if (failed.length > 0) {
413
+ persistent.push(`Could not quarantine untracked project-level agent file(s) on "${agent.friendlyName}" that shadow fleet's managed role prompts${moveErr}: ${describeFiles(failed)} in ${where}. The member's CLI loads these instead of the delivered role prompts -- remove them.`);
414
+ }
415
+ }
416
+ if (cls.tracked.length > 0) {
417
+ const why = probe.gitState === 'unknown' ? 'could not be verified as untracked (git state unknown)' : 'are tracked in git';
418
+ persistent.push(`Project-level agent file(s) on "${agent.friendlyName}" shadow fleet's managed role prompts and ${why}, so fleet left them in place: ${describeFiles(cls.tracked)} in ${where}. The member's CLI loads these INSTEAD of the role prompts fleet delivers, because their frontmatter name: matches a managed role (renaming the file does not help) -- remove them from the repo or change their name: to one fleet does not manage.`);
419
+ }
420
+ if (cls.untracked.length > 0 || cls.tracked.length > 0)
421
+ result.status = 'shadowed';
422
+ const all = [...oneShot, ...persistent];
423
+ if (all.length > 0)
424
+ result.warning = all.join(' ');
425
+ if (persistent.length > 0)
426
+ result.persistentWarning = persistent.join(' ');
427
+ return result;
428
+ }
429
+ // ---------------------------------------------------------------------------
430
+ // Per-uptime cache (per member + work folder)
431
+ // ---------------------------------------------------------------------------
432
+ /** key -> persistent warning to re-emit on every dispatch ('' when clean). */
433
+ // Known limitation: a 'clean' entry is not invalidated when the member's
434
+ // checkout changes mid-uptime (e.g. a branch switch that adds a tracked
435
+ // .claude/agents/doer.md). Tracked shadows are report-only anyway; the next
436
+ // register_member/update_member or server restart re-checks.
437
+ export const shadowCheckCache = new Map();
438
+ function cacheKey(agent) {
439
+ return `${agent.id}\u0000${agent.workFolder}`;
440
+ }
441
+ /** Drop cached results for a member (all work folders). Called by register_member/update_member. */
442
+ export function invalidateProjectAgentShadowCache(agentId) {
443
+ const prefix = `${agentId}\u0000`;
444
+ for (const k of [...shadowCheckCache.keys()])
445
+ if (k.startsWith(prefix))
446
+ shadowCheckCache.delete(k);
447
+ }
448
+ /**
449
+ * Dispatch-time entry point. Runs the check once per member+workFolder per
450
+ * server uptime; tracked/unmovable shadows are re-reported on every dispatch
451
+ * from the cache (no extra round trip). A probe failure is not cached, so the
452
+ * next dispatch retries. Returns the warning text for this dispatch, if any.
453
+ * Never throws.
454
+ */
455
+ export async function ensureNoProjectAgentShadows(agent) {
456
+ const key = cacheKey(agent);
457
+ const cached = shadowCheckCache.get(key);
458
+ if (cached !== undefined)
459
+ return cached || undefined;
460
+ try {
461
+ const r = await checkProjectAgentShadows(agent);
462
+ if (r.warning)
463
+ logWarn('agent_shadow', r.warning, agent);
464
+ if (r.status !== 'probe_failed' && !r.retry)
465
+ shadowCheckCache.set(key, r.persistentWarning ?? '');
466
+ return r.warning;
467
+ }
468
+ catch (err) {
469
+ // Internal error (not a member-side probe failure): log, never block.
470
+ logWarn('agent_shadow', `project-level agent shadow check errored for "${agent.friendlyName}": ${err?.message ?? String(err)}`, agent);
471
+ return undefined;
472
+ }
473
+ }
474
+ /** register_member/update_member entry point: invalidate, run uncached, return a warning if any. Never throws. */
475
+ export async function recheckProjectAgentShadows(agent) {
476
+ invalidateProjectAgentShadowCache(agent.id);
477
+ return ensureNoProjectAgentShadows(agent);
478
+ }
479
+ //# sourceMappingURL=agent-shadow.js.map
@@ -14,14 +14,21 @@ export interface NewProjectScriptOptions {
14
14
  workFolder: string;
15
15
  model: string;
16
16
  home?: string | null;
17
- /** Extra environment for the agy process (the member's stored auth env vars). */
17
+ /** Extra NON-SECRET environment for the agy process. The script text is part of
18
+ * the member command line -- credentials go through stageAuthEnv instead. */
18
19
  env?: Record<string, string>;
19
- /** Test seam: run this executable (plus leading args) instead of `agy`. */
20
+ /** Test seam: run this executable (plus leading args) instead of `agy`.
21
+ * AGY_NODE_SELF means the node binary running the member-side script. */
20
22
  agyCommand?: {
21
23
  file: string;
22
24
  args: string[];
23
25
  };
24
26
  }
27
+ /** agyCommand.file sentinel: spawn the member-side node itself
28
+ * (process.execPath evaluated ON THE MEMBER). Keeps host paths out of the
29
+ * member command line -- a host absolute path is meaningless on a remote
30
+ * member and is environment-derived text in a shell command. */
31
+ export declare const AGY_NODE_SELF = "<node-self>";
25
32
  /**
26
33
  * Member-side node script: list ~/.gemini/config/projects, run
27
34
  * `agy --new-project` (spawned directly, no shell) in the work folder with a
@@ -17,7 +17,7 @@ import { getStrategy } from './strategy.js';
17
17
  import { updateAgent } from './registry.js';
18
18
  import { buildAgyNodeCommand, AGY_MODEL_FOR_TIER } from '../providers/agy.js';
19
19
  import { getModelOverride } from './user-config.js';
20
- import { decryptPassword } from '../utils/crypto.js';
20
+ import { stageAuthEnv, removeMemberSecretFile } from './member-secret-env.js';
21
21
  import { logLine, logWarn } from '../utils/log-helpers.js';
22
22
  /** Raised when an agy project cannot be created or verified. */
23
23
  export class AgyProjectError extends Error {
@@ -72,6 +72,11 @@ if (!fs.existsSync(f)) {
72
72
  }
73
73
  console.log(${JSON.stringify(PROBE_MARKER)} + JSON.stringify({ state }));`;
74
74
  }
75
+ /** agyCommand.file sentinel: spawn the member-side node itself
76
+ * (process.execPath evaluated ON THE MEMBER). Keeps host paths out of the
77
+ * member command line -- a host absolute path is meaningless on a remote
78
+ * member and is environment-derived text in a shell command. */
79
+ export const AGY_NODE_SELF = '<node-self>';
75
80
  /**
76
81
  * Member-side node script: list ~/.gemini/config/projects, run
77
82
  * `agy --new-project` (spawned directly, no shell) in the work folder with a
@@ -109,7 +114,7 @@ const extra = [path.join(home, '.local', 'bin')];
109
114
  if (process.platform === 'win32' && env.LOCALAPPDATA) extra.push(path.join(env.LOCALAPPDATA, 'agy', 'bin'));
110
115
  env[pathKey] = extra.join(path.delimiter) + path.delimiter + (env[pathKey] || '');
111
116
  const args = ${JSON.stringify(args)}.map(function (a) { return a === '__LOG_FILE__' ? logFile : a; });
112
- const r = cp.spawnSync(${JSON.stringify(file)}, args, { cwd: ${JSON.stringify(opts.workFolder)}, env: env, encoding: 'utf8', timeout: ${NEW_PROJECT_SPAWN_TIMEOUT_MS}, windowsHide: true });
117
+ const r = cp.spawnSync(${file === AGY_NODE_SELF ? 'process.execPath' : JSON.stringify(file)}, args, { cwd: ${JSON.stringify(opts.workFolder)}, env: env, encoding: 'utf8', timeout: ${NEW_PROJECT_SPAWN_TIMEOUT_MS}, windowsHide: true });
113
118
  const created = list().filter(function (f) { return !before.has(f); }).map(function (f) { return f.slice(0, -5); });
114
119
  const logIds = [];
115
120
  try {
@@ -221,20 +226,6 @@ export function parseAgyNewProjectResult(result) {
221
226
  }
222
227
  return id;
223
228
  }
224
- /** Stored auth env vars for the member (e.g. ANTIGRAVITY_API_KEY), passed to
225
- * the agy process through node's spawn env rather than a shell prefix. */
226
- function memberAuthEnv(agent) {
227
- const out = {};
228
- for (const [name, encrypted] of Object.entries(agent.encryptedEnvVars ?? {})) {
229
- try {
230
- out[name] = decryptPassword(encrypted);
231
- }
232
- catch {
233
- // an undecryptable entry is skipped; agy then falls back to its own auth
234
- }
235
- }
236
- return out;
237
- }
238
229
  function defaultExec(agent) {
239
230
  const strategy = getStrategy(agent);
240
231
  return (command, timeoutMs) => strategy.execCommand(command, timeoutMs);
@@ -301,18 +292,30 @@ export async function provisionAgyProject(agent, exec = defaultExec(agent), agyC
301
292
  // ~/.gemini and run a model turn. Without a test override the stand-in
302
293
  // exits 97 and provisioning fails ("agy exited 97").
303
294
  if (!agyCommand && process.env.NODE_ENV === 'test') {
304
- agyCommand = { file: process.execPath, args: ['-e', 'process.exit(97)', '--'] };
295
+ agyCommand = { file: AGY_NODE_SELF, args: ['-e', 'process.exit(97)', '--'] };
305
296
  }
306
297
  const model = getModelOverride('agy', 'cheap') ?? AGY_MODEL_FOR_TIER.cheap;
298
+ // Stored auth env vars reach agy through the staged env file the command
299
+ // loads (inherited by node, then by the agy spawn) -- never embedded in the
300
+ // script text, which is part of the member command line for the whole run.
307
301
  const script = buildAgyNewProjectScript({
308
302
  workFolder: agent.workFolder,
309
303
  model,
310
304
  home: homeFor(agent),
311
- env: memberAuthEnv(agent),
312
305
  agyCommand,
313
306
  });
314
307
  const cmd = buildAgyNodeCommand(script, memberOs(agent), 'FLEET_AGY_NEW_PROJECT_EOF');
315
- return withMachineLock(agent, async () => parseAgyNewProjectResult(await exec(cmd, NEW_PROJECT_EXEC_TIMEOUT_MS)));
308
+ return withMachineLock(agent, async () => {
309
+ const staged = await stageAuthEnv(agent);
310
+ try {
311
+ return parseAgyNewProjectResult(await exec(staged.prefix + cmd, NEW_PROJECT_EXEC_TIMEOUT_MS));
312
+ }
313
+ catch (err) {
314
+ if (staged.path)
315
+ await removeMemberSecretFile(agent, staged.path);
316
+ throw err;
317
+ }
318
+ });
316
319
  }
317
320
  /**
318
321
  * Returns a verified project id for an agy member, creating the project when
@@ -61,6 +61,24 @@ export declare function collectOobConfirm(credentialName: string, _opts?: {
61
61
  confirmed: boolean;
62
62
  terminalUnavailable: boolean;
63
63
  }>;
64
+ /**
65
+ * The manual-entry instruction shown when no terminal (and no browser UI) can
66
+ * collect a credential. ASCII only.
67
+ *
68
+ * Credential-collection modes name the credential by the caller's prompt
69
+ * label (the `--prompt` value in `extraArgs`, e.g. a provider's
70
+ * missingCredential.promptFor text) and tell the operator to store it under
71
+ * a secret NAME of their choosing, then pass {{secret.NAME}}. The member name
72
+ * is never offered as a secret name: `secret --set <member>` stored the value
73
+ * under the member's name, which no credential field references.
74
+ *
75
+ * Confirm mode keeps `secret --confirm <name>`: there `memberName` IS the
76
+ * credential name being confirmed (see collectOobConfirm).
77
+ */
78
+ export declare function buildHeadlessFallback(memberName: string, reason: string, context?: {
79
+ command?: string;
80
+ onMember?: string;
81
+ }, extraArgs?: string[]): string;
64
82
  /**
65
83
  * Returns true when a graphical display is available on Linux/BSD.
66
84
  * Checks $DISPLAY (X11) and $WAYLAND_DISPLAY (Wayland).
@@ -76,6 +94,31 @@ export declare function isSSHSession(): boolean;
76
94
  * SSH and headless service sessions have SESSIONNAME !== 'Console'.
77
95
  */
78
96
  export declare function hasInteractiveDesktop(): boolean;
97
+ /**
98
+ * Build the AppleScript that opens a macOS Terminal window, runs the auth
99
+ * command in it, and waits for it to finish. Terminal's `do script` hands the
100
+ * string to the user's login shell, so every argv element is POSIX
101
+ * single-quoted (member names and the --prompt text can carry spaces and
102
+ * caller-supplied host/username values), and the whole command is then escaped
103
+ * for the AppleScript string literal (backslash first, then double quote).
104
+ * The command writes its own exit code to `tmpFile` so the caller can read it.
105
+ * Exported for tests.
106
+ */
107
+ export declare function buildMacTerminalAppleScript(fullArgs: string[], tmpFile: string): string;
108
+ /** Title of the Windows credential-entry console window (set by the child). */
109
+ export declare const WINDOWS_AUTH_WINDOW_TITLE = "Fleet Password Entry";
110
+ /** Env var the `secret` CLI reads to title its console window on Windows. */
111
+ export declare const OOB_WINDOW_TITLE_ENV = "APRA_FLEET_OOB_WINDOW_TITLE";
112
+ /**
113
+ * Build the spawn() call that opens the Windows credential-entry console.
114
+ * Returns the file/argv for a hidden PowerShell launcher plus the env vars it
115
+ * reads. Exported for tests.
116
+ */
117
+ export declare function buildWindowsAuthLaunch(fullArgs: string[]): {
118
+ file: string;
119
+ args: string[];
120
+ env: Record<string, string>;
121
+ };
79
122
  /**
80
123
  * Launch a new terminal window running `apra-fleet secret --set <memberName>` or `apra-fleet auth <memberName>`.
81
124
  * Records the spawned PID in the pending request so it can be killed when credential is received.