@apralabs/apra-fleet 0.4.2 → 0.4.4

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 (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  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 +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  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 +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. 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
@@ -0,0 +1,103 @@
1
+ import type { Agent, SSHExecResult } from '../types.js';
2
+ export type AgyExecFn = (command: string, timeoutMs?: number) => Promise<SSHExecResult>;
3
+ /** Raised when an agy project cannot be created or verified. */
4
+ export declare class AgyProjectError extends Error {
5
+ constructor(message: string);
6
+ }
7
+ export declare function isValidAgyProjectId(id: unknown): id is string;
8
+ /** The prompt of the one model turn `agy --new-project` needs. It asks for no
9
+ * tool use: the id is read from the new project file and agy's own log, never
10
+ * from the model (the model does not know it -- see docs/agy-provider.md section 1). */
11
+ export declare const AGY_NEW_PROJECT_PROMPT = "Reply with only the word OK. Do not use any tools.";
12
+ export declare function buildAgyProjectProbeScript(projectId: string, home?: string | null): string;
13
+ export interface NewProjectScriptOptions {
14
+ workFolder: string;
15
+ model: string;
16
+ home?: string | null;
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. */
19
+ env?: Record<string, string>;
20
+ /** Test seam: run this executable (plus leading args) instead of `agy`. */
21
+ agyCommand?: {
22
+ file: string;
23
+ args: string[];
24
+ };
25
+ }
26
+ /**
27
+ * Member-side node script: list ~/.gemini/config/projects, run
28
+ * `agy --new-project` (spawned directly, no shell) in the work folder with a
29
+ * --log-file, list again, and report the new file names plus the ids agy
30
+ * logged as `created project "<name>" (id=<id>)`. The log file is deleted and
31
+ * its content is never echoed (it carries the account e-mail).
32
+ */
33
+ export declare function buildAgyNewProjectScript(opts: NewProjectScriptOptions): string;
34
+ /**
35
+ * Member-side script for remove_member's best-effort cleanup: deletes the
36
+ * member's own `<projectId>.json` plus, if present, the legacy
37
+ * `fleet-<memberId>.json` from an earlier design (older fleet versions), from ~/.gemini/config/projects only. A missing
38
+ * target is not an error (fs.rm's force:true); any other failure (e.g.
39
+ * permission denied) is reported back per target so the caller can decide
40
+ * whether it is warning-worthy.
41
+ */
42
+ export declare function buildAgyProjectDeleteScript(projectId: string, memberId: string, home?: string | null): string;
43
+ export interface AgyProjectDeleteResult {
44
+ deleted: string[];
45
+ errors: string[];
46
+ }
47
+ export declare function parseAgyProjectDeleteResult(result: SSHExecResult): AgyProjectDeleteResult;
48
+ export type AgyProjectState = 'ok' | 'missing' | 'corrupt' | 'id_mismatch';
49
+ export declare function parseAgyProjectProbe(result: SSHExecResult): AgyProjectState;
50
+ /**
51
+ * Validates the output of the new-project script: exactly one new
52
+ * `<uuid>.json` must have appeared, and agy's own log must name the same id.
53
+ * Anything else throws with the evidence.
54
+ */
55
+ export declare function parseAgyNewProjectResult(result: SSHExecResult): string;
56
+ export declare function probeAgyProject(agent: Agent, projectId: string, exec?: AgyExecFn): Promise<AgyProjectState>;
57
+ /**
58
+ * remove_member's best-effort cleanup: deletes the member's own agy project
59
+ * file (and a legacy fleet-<id>.json, if present) from its machine. Callers
60
+ * must skip this entirely when another registered member shares the same
61
+ * agyProjectId, and must treat any thrown AgyProjectError as a warning, not a
62
+ * reason to abort the removal.
63
+ */
64
+ export declare function removeAgyProject(agent: Agent, exec?: AgyExecFn): Promise<AgyProjectDeleteResult>;
65
+ /** Test seam: run a stand-in executable instead of the real `agy` on the
66
+ * member (undefined restores the default). */
67
+ export declare function setAgyCommandForTests(cmd: {
68
+ file: string;
69
+ args: string[];
70
+ } | undefined): void;
71
+ /** Creates a new agy project for the member and returns its id. Does not
72
+ * persist it -- see ensureAgyProject. */
73
+ export declare function provisionAgyProject(agent: Agent, exec?: AgyExecFn, agyCommand?: {
74
+ file: string;
75
+ args: string[];
76
+ } | undefined): Promise<string>;
77
+ export interface EnsureAgyProjectResult {
78
+ projectId: string;
79
+ /** Set when a project was created by this call, with the reason. */
80
+ provisioned?: 'no_project_id' | 'missing' | 'corrupt' | 'id_mismatch' | 'invalid_project_id';
81
+ }
82
+ export interface EnsureAgyProjectOptions {
83
+ exec?: AgyExecFn;
84
+ /** Write a newly created id to the registry (default true). register_member
85
+ * passes false because the member is not in the registry yet. */
86
+ persist?: boolean;
87
+ /** Test seam, forwarded to provisionAgyProject. */
88
+ agyCommand?: {
89
+ file: string;
90
+ args: string[];
91
+ };
92
+ }
93
+ /**
94
+ * Returns a verified project id for an agy member, creating the project when
95
+ * the member has none (upgrade path for members registered before project
96
+ * binding) or when its project file is missing, unparseable or names a
97
+ * different id. Sets `agent.agyProjectId` on the passed object and, unless
98
+ * persist is false, in the registry. Throws AgyProjectError on failure --
99
+ * callers must treat that as a hard error, never fall back to running agy
100
+ * without --project.
101
+ */
102
+ export declare function ensureAgyProject(agent: Agent, options?: EnsureAgyProjectOptions): Promise<EnsureAgyProjectResult>;
103
+ //# sourceMappingURL=agy-project.d.ts.map