@apralabs/apra-fleet 0.4.1 → 0.4.2

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 (276) hide show
  1. package/README.md +16 -8
  2. package/dist/agents/backlog-groomer.md +17 -21
  3. package/dist/agents/ci-watcher.md +3 -0
  4. package/dist/agents/deployer.md +22 -44
  5. package/dist/agents/doer.md +131 -132
  6. package/dist/agents/harvester.md +20 -32
  7. package/dist/agents/integ-test-runner.md +81 -113
  8. package/dist/agents/kb-reconciler.md +31 -42
  9. package/dist/agents/plan-reviewer.md +32 -44
  10. package/dist/agents/planner.md +51 -63
  11. package/dist/agents/regression-test-runner.md +65 -80
  12. package/dist/agents/reviewer.md +56 -83
  13. package/dist/agents/schemas/integ-test-runner-output.json +1 -1
  14. package/dist/agents/schemas/regression-test-runner-output.json +4 -17
  15. package/dist/cli/auth.d.ts.map +1 -1
  16. package/dist/cli/auth.js +1 -2
  17. package/dist/cli/auth.js.map +1 -1
  18. package/dist/cli/config.d.ts +3 -3
  19. package/dist/cli/config.d.ts.map +1 -1
  20. package/dist/cli/config.js +4 -13
  21. package/dist/cli/config.js.map +1 -1
  22. package/dist/cli/install.d.ts.map +1 -1
  23. package/dist/cli/install.js +5 -39
  24. package/dist/cli/install.js.map +1 -1
  25. package/dist/cli/register-member.js +1 -1
  26. package/dist/cli/start.d.ts.map +1 -1
  27. package/dist/cli/start.js +7 -0
  28. package/dist/cli/start.js.map +1 -1
  29. package/dist/cli/uninstall.d.ts.map +1 -1
  30. package/dist/cli/uninstall.js +5 -3
  31. package/dist/cli/uninstall.js.map +1 -1
  32. package/dist/cli/watch.d.ts +26 -3
  33. package/dist/cli/watch.d.ts.map +1 -1
  34. package/dist/cli/watch.js +41 -9
  35. package/dist/cli/watch.js.map +1 -1
  36. package/dist/os/git-bash-candidates.d.ts +35 -0
  37. package/dist/os/git-bash-candidates.d.ts.map +1 -0
  38. package/dist/os/git-bash-candidates.js +46 -0
  39. package/dist/os/git-bash-candidates.js.map +1 -0
  40. package/dist/os/index.d.ts +13 -4
  41. package/dist/os/index.d.ts.map +1 -1
  42. package/dist/os/index.js +17 -2
  43. package/dist/os/index.js.map +1 -1
  44. package/dist/os/linux.js +1 -1
  45. package/dist/os/linux.js.map +1 -1
  46. package/dist/os/os-commands.d.ts +7 -0
  47. package/dist/os/os-commands.d.ts.map +1 -1
  48. package/dist/os/os-commands.js.map +1 -1
  49. package/dist/os/windows-gitbash.d.ts +93 -0
  50. package/dist/os/windows-gitbash.d.ts.map +1 -0
  51. package/dist/os/windows-gitbash.js +244 -0
  52. package/dist/os/windows-gitbash.js.map +1 -0
  53. package/dist/os/windows.d.ts.map +1 -1
  54. package/dist/os/windows.js +27 -5
  55. package/dist/os/windows.js.map +1 -1
  56. package/dist/providers/agy.d.ts +3 -2
  57. package/dist/providers/agy.d.ts.map +1 -1
  58. package/dist/providers/agy.js +11 -2
  59. package/dist/providers/agy.js.map +1 -1
  60. package/dist/providers/claude.d.ts +3 -2
  61. package/dist/providers/claude.d.ts.map +1 -1
  62. package/dist/providers/claude.js +22 -3
  63. package/dist/providers/claude.js.map +1 -1
  64. package/dist/providers/codex.d.ts +3 -2
  65. package/dist/providers/codex.d.ts.map +1 -1
  66. package/dist/providers/codex.js +5 -2
  67. package/dist/providers/codex.js.map +1 -1
  68. package/dist/providers/copilot.d.ts +3 -2
  69. package/dist/providers/copilot.d.ts.map +1 -1
  70. package/dist/providers/copilot.js +7 -2
  71. package/dist/providers/copilot.js.map +1 -1
  72. package/dist/providers/index.d.ts +0 -1
  73. package/dist/providers/index.d.ts.map +1 -1
  74. package/dist/providers/index.js +0 -3
  75. package/dist/providers/index.js.map +1 -1
  76. package/dist/providers/none.d.ts +3 -2
  77. package/dist/providers/none.d.ts.map +1 -1
  78. package/dist/providers/none.js +5 -2
  79. package/dist/providers/none.js.map +1 -1
  80. package/dist/providers/opencode.d.ts +3 -2
  81. package/dist/providers/opencode.d.ts.map +1 -1
  82. package/dist/providers/opencode.js +5 -2
  83. package/dist/providers/opencode.js.map +1 -1
  84. package/dist/providers/provider.d.ts +16 -7
  85. package/dist/providers/provider.d.ts.map +1 -1
  86. package/dist/providers/provider.js +2 -2
  87. package/dist/providers/provider.js.map +1 -1
  88. package/dist/services/agent-provisioner.js +2 -2
  89. package/dist/services/agent-provisioner.js.map +1 -1
  90. package/dist/services/cloud/activity.js +2 -2
  91. package/dist/services/cloud/activity.js.map +1 -1
  92. package/dist/services/context-admission.d.ts.map +1 -1
  93. package/dist/services/context-admission.js +9 -7
  94. package/dist/services/context-admission.js.map +1 -1
  95. package/dist/services/credential-cleanup.d.ts.map +1 -1
  96. package/dist/services/credential-cleanup.js +22 -3
  97. package/dist/services/credential-cleanup.js.map +1 -1
  98. package/dist/services/member-home.d.ts +1 -1
  99. package/dist/services/member-home.d.ts.map +1 -1
  100. package/dist/services/member-home.js +15 -12
  101. package/dist/services/member-home.js.map +1 -1
  102. package/dist/services/model-pricing.d.ts.map +1 -1
  103. package/dist/services/model-pricing.js +0 -5
  104. package/dist/services/model-pricing.js.map +1 -1
  105. package/dist/services/orphan-recovery.d.ts +6 -3
  106. package/dist/services/orphan-recovery.d.ts.map +1 -1
  107. package/dist/services/orphan-recovery.js +17 -14
  108. package/dist/services/orphan-recovery.js.map +1 -1
  109. package/dist/services/preflight-check.js +2 -2
  110. package/dist/services/preflight-check.js.map +1 -1
  111. package/dist/services/shell-probe.d.ts +131 -0
  112. package/dist/services/shell-probe.d.ts.map +1 -0
  113. package/dist/services/shell-probe.js +210 -0
  114. package/dist/services/shell-probe.js.map +1 -0
  115. package/dist/services/singleton.d.ts +2 -0
  116. package/dist/services/singleton.d.ts.map +1 -1
  117. package/dist/services/singleton.js +1 -1
  118. package/dist/services/singleton.js.map +1 -1
  119. package/dist/services/ssh.js +2 -2
  120. package/dist/services/ssh.js.map +1 -1
  121. package/dist/services/stall/find-log-file.d.ts.map +1 -1
  122. package/dist/services/stall/find-log-file.js +22 -16
  123. package/dist/services/stall/find-log-file.js.map +1 -1
  124. package/dist/services/stall/read-log-tail.d.ts.map +1 -1
  125. package/dist/services/stall/read-log-tail.js +6 -5
  126. package/dist/services/stall/read-log-tail.js.map +1 -1
  127. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  128. package/dist/services/stall/stall-poller.js +35 -42
  129. package/dist/services/stall/stall-poller.js.map +1 -1
  130. package/dist/services/strategy.d.ts +9 -0
  131. package/dist/services/strategy.d.ts.map +1 -1
  132. package/dist/services/strategy.js +40 -6
  133. package/dist/services/strategy.js.map +1 -1
  134. package/dist/services/user-config.js +1 -1
  135. package/dist/services/user-config.js.map +1 -1
  136. package/dist/services/vcs/azure-devops.d.ts +1 -1
  137. package/dist/services/vcs/azure-devops.d.ts.map +1 -1
  138. package/dist/services/vcs/azure-devops.js +105 -10
  139. package/dist/services/vcs/azure-devops.js.map +1 -1
  140. package/dist/services/vcs/bitbucket.d.ts.map +1 -1
  141. package/dist/services/vcs/bitbucket.js +16 -0
  142. package/dist/services/vcs/bitbucket.js.map +1 -1
  143. package/dist/services/vcs/github.d.ts.map +1 -1
  144. package/dist/services/vcs/github.js +24 -0
  145. package/dist/services/vcs/github.js.map +1 -1
  146. package/dist/services/vcs/types.d.ts +123 -2
  147. package/dist/services/vcs/types.d.ts.map +1 -1
  148. package/dist/skills/fleet-sprint-cli/SKILL.md +2 -1
  149. package/dist/skills/pm/SKILL.md +0 -1
  150. package/dist/skills/pm/cost.md +0 -1
  151. package/dist/skills/pm/fleet-addendum.md +0 -1
  152. package/dist/tools/check-status.js +3 -3
  153. package/dist/tools/check-status.js.map +1 -1
  154. package/dist/tools/cloud-control.js +2 -2
  155. package/dist/tools/cloud-control.js.map +1 -1
  156. package/dist/tools/compose-permissions.d.ts.map +1 -1
  157. package/dist/tools/compose-permissions.js +37 -24
  158. package/dist/tools/compose-permissions.js.map +1 -1
  159. package/dist/tools/execute-command.d.ts.map +1 -1
  160. package/dist/tools/execute-command.js +28 -12
  161. package/dist/tools/execute-command.js.map +1 -1
  162. package/dist/tools/execute-prompt.d.ts.map +1 -1
  163. package/dist/tools/execute-prompt.js +55 -18
  164. package/dist/tools/execute-prompt.js.map +1 -1
  165. package/dist/tools/list-members.d.ts.map +1 -1
  166. package/dist/tools/list-members.js +6 -2
  167. package/dist/tools/list-members.js.map +1 -1
  168. package/dist/tools/member-detail.d.ts.map +1 -1
  169. package/dist/tools/member-detail.js +5 -3
  170. package/dist/tools/member-detail.js.map +1 -1
  171. package/dist/tools/member-reservation.d.ts.map +1 -1
  172. package/dist/tools/member-reservation.js +13 -1
  173. package/dist/tools/member-reservation.js.map +1 -1
  174. package/dist/tools/monitor-task.d.ts.map +1 -1
  175. package/dist/tools/monitor-task.js +17 -2
  176. package/dist/tools/monitor-task.js.map +1 -1
  177. package/dist/tools/provision-auth.js +5 -5
  178. package/dist/tools/provision-auth.js.map +1 -1
  179. package/dist/tools/provision-vcs-auth.d.ts +5 -2
  180. package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
  181. package/dist/tools/provision-vcs-auth.js +58 -52
  182. package/dist/tools/provision-vcs-auth.js.map +1 -1
  183. package/dist/tools/register-member.d.ts +18 -12
  184. package/dist/tools/register-member.d.ts.map +1 -1
  185. package/dist/tools/register-member.js +42 -4
  186. package/dist/tools/register-member.js.map +1 -1
  187. package/dist/tools/remove-member.js +2 -2
  188. package/dist/tools/remove-member.js.map +1 -1
  189. package/dist/tools/revoke-vcs-auth.js +2 -2
  190. package/dist/tools/revoke-vcs-auth.js.map +1 -1
  191. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  192. package/dist/tools/setup-ssh-key.js +2 -1
  193. package/dist/tools/setup-ssh-key.js.map +1 -1
  194. package/dist/tools/stop-prompt.js +2 -2
  195. package/dist/tools/stop-prompt.js.map +1 -1
  196. package/dist/tools/update-agent-cli.js +2 -2
  197. package/dist/tools/update-agent-cli.js.map +1 -1
  198. package/dist/tools/update-member.d.ts +18 -12
  199. package/dist/tools/update-member.d.ts.map +1 -1
  200. package/dist/tools/update-member.js +18 -1
  201. package/dist/tools/update-member.js.map +1 -1
  202. package/dist/types.d.ts +11 -1
  203. package/dist/types.d.ts.map +1 -1
  204. package/dist/utils/agent-helpers.d.ts +36 -0
  205. package/dist/utils/agent-helpers.d.ts.map +1 -1
  206. package/dist/utils/agent-helpers.js +39 -1
  207. package/dist/utils/agent-helpers.js.map +1 -1
  208. package/dist/utils/platform.d.ts +7 -0
  209. package/dist/utils/platform.d.ts.map +1 -1
  210. package/dist/utils/platform.js +11 -1
  211. package/dist/utils/platform.js.map +1 -1
  212. package/dist/utils/workspace-trust.d.ts.map +1 -1
  213. package/dist/utils/workspace-trust.js +5 -1
  214. package/dist/utils/workspace-trust.js.map +1 -1
  215. package/dist/workflows/auto-sprint.js +4 -17
  216. package/package.json +2 -2
  217. package/packages/apra-fleet-client/src/client/api.mjs +92 -3
  218. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +17 -21
  219. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +3 -0
  220. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +22 -44
  221. package/packages/apra-fleet-se/apra-pm/agents/doer.md +131 -132
  222. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +20 -32
  223. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +81 -113
  224. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +31 -42
  225. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +32 -44
  226. package/packages/apra-fleet-se/apra-pm/agents/planner.md +51 -63
  227. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +65 -80
  228. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +56 -83
  229. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
  230. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
  231. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +0 -1
  232. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -1
  233. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +0 -1
  234. package/packages/apra-fleet-se/bin/cli.mjs +132 -3
  235. package/packages/apra-fleet-se/bin/serve.mjs +36 -1
  236. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +151 -33
  237. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +22 -7
  238. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
  239. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +9 -4
  240. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +2 -2
  241. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +12 -12
  242. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
  243. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
  244. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +67 -16
  245. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +41 -0
  246. package/packages/apra-fleet-se/fleet-sprint/runner.js +1140 -209
  247. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
  248. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +154 -0
  249. package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
  250. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
  251. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +2 -1
  252. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +51 -0
  253. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +657 -12
  254. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
  255. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +60 -43
  256. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +205 -2
  257. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +164 -0
  258. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +92 -37
  259. package/packages/apra-fleet-workflow/src/viewer/index.mjs +167 -1
  260. package/packages/apra-fleet-workflow/src/workflow/index.mjs +435 -31
  261. package/skills/fleet/SKILL.md +20 -9
  262. package/skills/fleet/auth-azdevops.md +44 -5
  263. package/skills/fleet/auth-bitbucket.md +3 -3
  264. package/skills/fleet/auth-github.md +2 -2
  265. package/skills/fleet/beads-conflict-resolution.md +141 -0
  266. package/skills/fleet/beads.md +16 -12
  267. package/skills/fleet/onboarding.md +4 -4
  268. package/skills/fleet/permissions.md +6 -6
  269. package/skills/fleet/skill-matrix.md +1 -1
  270. package/skills/fleet/troubleshooting.md +2 -1
  271. package/version.json +1 -1
  272. package/dist/providers/gemini.d.ts +0 -52
  273. package/dist/providers/gemini.d.ts.map +0 -1
  274. package/dist/providers/gemini.js +0 -236
  275. package/dist/providers/gemini.js.map +0 -1
  276. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
@@ -3,6 +3,7 @@
3
3
  */
4
4
  import type { Agent } from '../types.js';
5
5
  import type { RemoteOS } from './platform.js';
6
+ import type { MemberShell } from '../os/os-commands.js';
6
7
  /**
7
8
  * Look up an agent by ID or return a formatted error string.
8
9
  * Eliminates the repeated pattern of getAgent() + "not found" check in every tool.
@@ -13,6 +14,41 @@ export declare function getAgentOrFail(id: string): Agent | string;
13
14
  * Eliminates repeated `agent.os ?? 'linux'` casts.
14
15
  */
15
16
  export declare function getAgentOS(agent: Agent): RemoteOS;
17
+ /**
18
+ * Get the registered shell for an agent (undefined if none recorded/detected).
19
+ * Pass alongside getAgentOS() to getOsCommands() so a gitbash Windows member
20
+ * resolves to bash command strings instead of the PowerShell default.
21
+ */
22
+ export declare function getAgentShell(agent: Agent): MemberShell | undefined;
23
+ /**
24
+ * True when `os`/`shell` resolve to a POSIX-speaking shell -- any non-Windows
25
+ * OS, or a Windows member registered as Git-for-Windows bash
26
+ * (apra-fleet-7dir.2.4/2.5). A Windows member with no shell recorded, or
27
+ * pwsh7/powershell5, still resolves to PowerShell exactly as before.
28
+ *
29
+ * THE single definition of this predicate (apra-fleet-7dir.11) -- every
30
+ * former private copy (member-home.ts, orphan-recovery.ts,
31
+ * compose-permissions.ts, execute-prompt.ts's isPosixShellMember) now calls
32
+ * through here so a future shell enum value (WSL, cmd) is added in exactly
33
+ * one place.
34
+ *
35
+ * The first parameter also accepts a plain `isWindows` boolean, for the one
36
+ * call site (compose-permissions.ts) that only ever had a boolean on hand --
37
+ * behaviourally identical to passing 'windows' / a non-windows RemoteOS,
38
+ * kept as an overload rather than forcing that caller to synthesize a
39
+ * RemoteOS value it doesn't otherwise need. `os: RemoteOS` also accepts a
40
+ * `TargetOS` (src/providers/provider.ts) value as-is: the two are the same
41
+ * three-value string union, just declared independently.
42
+ */
43
+ export declare function isPosixShell(os: RemoteOS, shell?: MemberShell): boolean;
44
+ export declare function isPosixShell(isWindows: boolean, shell?: MemberShell): boolean;
45
+ /**
46
+ * Agent-taking convenience wrapper around isPosixShell -- reads the member's
47
+ * os/shell off the Agent itself instead of requiring the caller to unpack
48
+ * getAgentOS(agent)/getAgentShell(agent) first (apra-fleet-7dir.11; formerly
49
+ * execute-prompt.ts's private isPosixShellMember).
50
+ */
51
+ export declare function isPosixShellMember(agent: Agent): boolean;
16
52
  /**
17
53
  * Format a host label for display.
18
54
  * Local agents show "(local)", relay agents show "(relay)", remote agents
@@ -1 +1 @@
1
- {"version":3,"file":"agent-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/agent-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAIpD;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAEpE;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAYvF;AAOD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,CAAC,EAAE,EACV,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GAClD;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAarD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAOpE"}
1
+ {"version":3,"file":"agent-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/agent-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;AACzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;AAM/E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAIpD;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAEpE;AAmBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAgBvF;AAOD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,CAAC,EAAE,EACV,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GAClD;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAarD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAOpE"}
@@ -17,6 +17,27 @@ export function getAgentOrFail(id) {
17
17
  export function getAgentOS(agent) {
18
18
  return (agent.os ?? 'linux');
19
19
  }
20
+ /**
21
+ * Get the registered shell for an agent (undefined if none recorded/detected).
22
+ * Pass alongside getAgentOS() to getOsCommands() so a gitbash Windows member
23
+ * resolves to bash command strings instead of the PowerShell default.
24
+ */
25
+ export function getAgentShell(agent) {
26
+ return agent.shell;
27
+ }
28
+ export function isPosixShell(osOrIsWindows, shell) {
29
+ const isWindows = typeof osOrIsWindows === 'boolean' ? osOrIsWindows : osOrIsWindows === 'windows';
30
+ return !isWindows || shell === 'gitbash';
31
+ }
32
+ /**
33
+ * Agent-taking convenience wrapper around isPosixShell -- reads the member's
34
+ * os/shell off the Agent itself instead of requiring the caller to unpack
35
+ * getAgentOS(agent)/getAgentShell(agent) first (apra-fleet-7dir.11; formerly
36
+ * execute-prompt.ts's private isPosixShellMember).
37
+ */
38
+ export function isPosixShellMember(agent) {
39
+ return isPosixShell(getAgentOS(agent), getAgentShell(agent));
40
+ }
20
41
  /**
21
42
  * Format a host label for display.
22
43
  * Local agents show "(local)", relay agents show "(relay)", remote agents
@@ -40,7 +61,20 @@ let idleTouchHook;
40
61
  export function setIdleTouchHook(fn) {
41
62
  idleTouchHook = fn;
42
63
  }
43
- const EXPIRY_WARNING_MS = 10 * 60 * 1000; // 10 minutes
64
+ const EXPIRY_WARNING_MS = 10 * 60 * 1000; // 10 minutes -- sized for GitHub App tokens (~1hr lifetime)
65
+ // apra-fleet-5co8.5.1: long-lived PAT providers (Azure DevOps PATs run
66
+ // weeks/months per skills/fleet/auth-azdevops.md's "Set expiration"
67
+ // guidance, unlike a GitHub App token's ~1hr lifetime the 10-minute
68
+ // threshold above was designed for) need a heads-up long before the
69
+ // minute-scale check above would ever fire.
70
+ const DAY_SCALE_WARNING_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
71
+ // apra-fleet-5co8.5.1: providers this day-scale threshold applies to.
72
+ // Deliberately scoped by provider rather than made unconditional: a
73
+ // GitHub App token's remaining lifetime is always well inside 7 days, so an
74
+ // unscoped check would spuriously warn on every fresh GitHub deploy and
75
+ // change existing GitHub short-lived-token behavior (see
76
+ // agent-helpers.test.ts 'returns null when token is not near expiry').
77
+ const DAY_SCALE_WARNING_PROVIDERS = new Set(['azure-devops']);
44
78
  /**
45
79
  * Check if an agent's VCS token is expired or expiring soon.
46
80
  * Returns a warning string if action is needed, or null if OK / no expiry tracked.
@@ -57,6 +91,10 @@ export function checkVcsTokenExpiry(agent, now = new Date()) {
57
91
  const mins = Math.ceil(remaining / 60000);
58
92
  return `⚠️ VCS token expires in ${mins} minute${mins === 1 ? '' : 's'} (${agent.vcsTokenExpiresAt}) — consider refreshing.`;
59
93
  }
94
+ if (agent.vcsProvider && DAY_SCALE_WARNING_PROVIDERS.has(agent.vcsProvider) && remaining <= DAY_SCALE_WARNING_MS) {
95
+ const days = Math.ceil(remaining / (24 * 60 * 60 * 1000));
96
+ return `⚠️ VCS token expires in ${days} day${days === 1 ? '' : 's'} (${agent.vcsTokenExpiresAt}) — consider refreshing.`;
97
+ }
60
98
  return null;
61
99
  }
62
100
  // In-memory PID store — transient, lives only for the server process lifetime.
@@ -1 +1 @@
1
- {"version":3,"file":"agent-helpers.js","sourceRoot":"","sources":["../../src/utils/agent-helpers.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent-helpers.js","sourceRoot":"","sources":["../../src/utils/agent-helpers.ts"],"names":[],"mappings":"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"}
@@ -9,5 +9,12 @@ export declare function isContainedInWorkFolder(workFolder: string, remotePath:
9
9
  * that path.posix.resolve incorrectly treats as relative (since they don't start with '/').
10
10
  */
11
11
  export declare function resolveRemotePath(workFolder: string, subPath: string): string;
12
+ /**
13
+ * True when `uname -s` output identifies a POSIX-emulation layer running on
14
+ * Windows (Git-for-Windows / MSYS2 / Cygwin). This is the ONLY reliable way to
15
+ * tell a Git-for-Windows bash.exe apart from the WSL launcher of the same name
16
+ * under System32: the WSL one also exits 0 but reports "Linux".
17
+ */
18
+ export declare function isWindowsPosixUname(unameOutput: string): boolean;
12
19
  export declare function detectOS(unameOutput: string, verOutput: string): RemoteOS;
13
20
  //# sourceMappingURL=platform.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAErD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAqBvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW7E;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAWzE"}
1
+ {"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAErD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAqBvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW7E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAWzE"}
@@ -44,6 +44,16 @@ export function resolveRemotePath(workFolder, subPath) {
44
44
  return path.posix.resolve(normWorkFolder, normSubPath);
45
45
  }
46
46
  }
47
+ /**
48
+ * True when `uname -s` output identifies a POSIX-emulation layer running on
49
+ * Windows (Git-for-Windows / MSYS2 / Cygwin). This is the ONLY reliable way to
50
+ * tell a Git-for-Windows bash.exe apart from the WSL launcher of the same name
51
+ * under System32: the WSL one also exits 0 but reports "Linux".
52
+ */
53
+ export function isWindowsPosixUname(unameOutput) {
54
+ const uname = unameOutput.trim().toLowerCase();
55
+ return uname.startsWith('mingw') || uname.startsWith('msys') || uname.startsWith('cygwin');
56
+ }
47
57
  export function detectOS(unameOutput, verOutput) {
48
58
  if (verOutput.toLowerCase().includes('windows') || verOutput.toLowerCase().includes('microsoft')) {
49
59
  return 'windows';
@@ -52,7 +62,7 @@ export function detectOS(unameOutput, verOutput) {
52
62
  if (uname === 'darwin')
53
63
  return 'macos';
54
64
  // Git Bash / MSYS2 / Cygwin on Windows report MINGW*, MSYS*, or CYGWIN*
55
- if (uname.startsWith('mingw') || uname.startsWith('msys') || uname.startsWith('cygwin')) {
65
+ if (isWindowsPosixUname(unameOutput)) {
56
66
  return 'windows';
57
67
  }
58
68
  return 'linux';
@@ -1 +1 @@
1
- {"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"workspace-trust.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-trust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAavH"}
1
+ {"version":3,"file":"workspace-trust.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-trust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvH"}
@@ -1,5 +1,6 @@
1
1
  import { getStrategy } from '../services/strategy.js';
2
2
  import { getProvider } from '../providers/index.js';
3
+ import { getAgentShell } from './agent-helpers.js';
3
4
  import { logLine, logWarn } from './log-helpers.js';
4
5
  /**
5
6
  * Idempotently seeds Claude workspace trust for `agent`'s work folder
@@ -25,7 +26,10 @@ export async function seedWorkspaceTrust(agent, strategy, tag = 'workspace-trust
25
26
  try {
26
27
  const provider = getProvider(agent.llmProvider);
27
28
  const strat = strategy ?? getStrategy(agent);
28
- const result = await provider.ensureWorkspaceTrusted(agent.workFolder, (command, timeoutMs) => strat.execCommand(command, timeoutMs), agent.os);
29
+ const result = await provider.ensureWorkspaceTrusted(agent.workFolder, (command, timeoutMs) => strat.execCommand(command, timeoutMs), agent.os,
30
+ // The member's REGISTERED shell, not just its OS: a gitbash Windows
31
+ // member needs POSIX trust-seeding strings (apra-fleet-7dir.2.8).
32
+ getAgentShell(agent));
29
33
  logLine(tag, `workspace trust for "${agent.friendlyName}": ${result.detail}`, agent);
30
34
  }
31
35
  catch (e) {
@@ -1 +1 @@
1
- {"version":3,"file":"workspace-trust.js","sourceRoot":"","sources":["../../src/utils/workspace-trust.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAY,EAAE,QAAwB,EAAE,GAAG,GAAG,iBAAiB;IACtG,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,QAAQ,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,sBAAsB,CAClD,KAAK,CAAC,UAAU,EAChB,CAAC,OAAe,EAAE,SAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,EAC9E,KAAK,CAAC,EAAE,CACT,CAAC;QACF,OAAO,CAAC,GAAG,EAAE,wBAAwB,KAAK,CAAC,YAAY,MAAM,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,EAAE,sCAAsC,KAAK,CAAC,YAAY,kBAAkB,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACnH,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"workspace-trust.js","sourceRoot":"","sources":["../../src/utils/workspace-trust.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAY,EAAE,QAAwB,EAAE,GAAG,GAAG,iBAAiB;IACtG,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,QAAQ,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,sBAAsB,CAClD,KAAK,CAAC,UAAU,EAChB,CAAC,OAAe,EAAE,SAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,EAC9E,KAAK,CAAC,EAAE;QACR,oEAAoE;QACpE,kEAAkE;QAClE,aAAa,CAAC,KAAK,CAAC,CACrB,CAAC;QACF,OAAO,CAAC,GAAG,EAAE,wBAAwB,KAAK,CAAC,YAAY,MAAM,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,EAAE,sCAAsC,KAAK,CAAC,YAAY,kBAAkB,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACnH,CAAC;AACH,CAAC"}
@@ -1612,7 +1612,7 @@ const INTEG_RUN_SCHEMA = {
1612
1612
  },
1613
1613
  "deployedSha": {
1614
1614
  "type": "string",
1615
- "description": "The deploy-verified git commit part 2 (smoke test) actually ran against. Optional for backward compatibility, but an orchestrator that supplied a deployed SHA in the dispatch prompt treats a missing or mismatching value as INCONCLUSIVE evidence (never a pass). See integ-test-runner.md 'Part-2 evidence freshness'."
1615
+ "description": "The git commit the verification actually ran against. Optional for backward compatibility, but an orchestrator that supplied a deployed SHA in the dispatch prompt treats a missing or mismatching value as INCONCLUSIVE evidence (never a pass). See integ-test-runner.md Step 4."
1616
1616
  },
1617
1617
  "verifySetClosed": {
1618
1618
  "type": "array",
@@ -1689,7 +1689,7 @@ const REGRESSION_RUN_SCHEMA = {
1689
1689
  },
1690
1690
  "smokePassed": {
1691
1691
  "type": "boolean",
1692
- "description": "Result of playbook Part 2 -- the toy-sprint smoke test."
1692
+ "description": "Result of playbook Part 2 -- the sandbox smoke test."
1693
1693
  },
1694
1694
  "bugsFiled": {
1695
1695
  "type": "array",
@@ -1704,21 +1704,8 @@ const REGRESSION_RUN_SCHEMA = {
1704
1704
  },
1705
1705
  "smokeEvidence": {
1706
1706
  "type": "object",
1707
- "description": "Optional structured evidence from Part 2 (the toy-sprint smoke test), so the result is machine-checkable instead of self-reported prose.",
1708
- "properties": {
1709
- "versionStdout": {
1710
- "type": "string",
1711
- "description": "Verbatim stdout of running the toy CLI's --version on the sprint branch."
1712
- },
1713
- "canaryStatus": {
1714
- "type": "string",
1715
- "description": "The status field from `bd show gh-toy-4ef` (e.g. \"closed\")."
1716
- },
1717
- "toyRepoHeadSha": {
1718
- "type": "string",
1719
- "description": "The toy repo's head commit SHA after the toy sprint."
1720
- }
1721
- }
1707
+ "additionalProperties": true,
1708
+ "description": "Optional structured evidence from Part 2 (the target repo's own smoke test), so the result is machine-checkable instead of self-reported prose. This schema does not define its shape -- the target repo's regression-test-playbook.md (Part 2 / smoke test section) does. Omit if that playbook defines no structured evidence."
1722
1709
  }
1723
1710
  }
1724
1711
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@apralabs/apra-fleet",
3
- "version": "0.4.1",
3
+ "version": "0.4.2",
4
4
  "description": "MCP server for orchestrating multiple agentic AI instances (Claude, Gemini, Codex, Copilot, AGY) across machines via SSH",
5
5
  "author": "Apra Labs",
6
6
  "homepage": "https://github.com/Apra-Labs/apra-fleet",
@@ -23,7 +23,7 @@
23
23
  "apra-fleet": "dist/index.js"
24
24
  },
25
25
  "engines": {
26
- "node": ">=22.5.0"
26
+ "node": ">=22.16.0"
27
27
  },
28
28
  "files": [
29
29
  "dist/",
@@ -100,10 +100,25 @@
100
100
  * @property {"password" | "key"} [auth_type] - Authentication method
101
101
  * @property {string} [password] - SSH password
102
102
  * @property {string} [key_path] - Path to SSH private key
103
- * @property {string} [llm_provider] - LLM provider for this member
103
+ * @property {"read" | "push" | "admin" | "issues" | "full"} [git_access] - Git access level for this member
104
+ * @property {string[]} [git_repos] - Git repositories this member can access (e.g. ["Apra-Labs/ApraPipes"])
105
+ * @property {"aws"} [cloud_provider] - Cloud provider. When set, cloud_instance_id and key_path are required.
106
+ * @property {string} [cloud_instance_id] - EC2 instance ID (e.g. "i-0abc123def456789a"). Required when cloud_provider is set.
107
+ * @property {string} [cloud_region] - AWS region (default: "us-east-1")
108
+ * @property {string} [cloud_profile] - AWS CLI profile name (e.g. "apra")
109
+ * @property {number} [cloud_idle_timeout_min] - Minutes of inactivity before auto-stop (default: 30)
110
+ * @property {string} [cloud_activity_command] - Custom shell command for workload detection. Must output "busy" or "idle" on stdout.
111
+ * @property {"claude" | "codex" | "copilot" | "agy" | "opencode" | "none"} [llm_provider] - LLM provider for this member (default: "claude")
112
+ * @property {"gpt-oss-120b" | "gpt-120" | "gemini-3.5-flash-lite" | "haiku" | "gpt-5.4-mini"} [model_cheap] - Custom cheap model choice from a curated list
113
+ * @property {"gemini-3.5-flash" | "gpt-oss-120b" | "gpt-120" | "sonnet" | "gpt-5.4"} [model_standard] - Custom standard model choice from a curated list
114
+ * @property {"sonnet" | "opus" | "gpt-oss-120b"} [model_premium] - Custom premium model choice from a curated list
115
+ * @property {{cheap?: string, standard?: string, premium?: string}} [model_tiers] - Per-member model tier map. A single model fills all tiers.
116
+ * @property {"codebase-memory" | "gitnexus" | "none"} [code_intel_provider] - Code-intelligence provider for this member (default: fleet-wide config)
104
117
  * @property {string} [category] - Optional group label
105
118
  * @property {string[]} [tags] - Optional list of free-form labels
106
119
  * @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode for unattended execution
120
+ * @property {boolean} [unreservable] - Mark this member as never exclusively reservable, so it can be shared by more than one sprint at once (e.g. fleet-sprint's shared "orchestrator" role)
121
+ * @property {"gitbash" | "pwsh7" | "powershell5"} [shell] - Override the probed Windows shell for this member. Windows members only -- ignored for non-windows members.
107
122
  */
108
123
 
109
124
  /**
@@ -117,11 +132,54 @@
117
132
  * @property {number} [port] - New SSH port
118
133
  * @property {"password" | "key"} [auth_type] - New auth method
119
134
  * @property {string} [password] - New SSH password
135
+ * @property {boolean} [rotate_password] - Trigger secure out-of-band password re-entry for a member already using password auth. Ignored if auth_type is not password.
120
136
  * @property {string} [key_path] - New SSH private key path
121
- * @property {string} [llm_provider] - Change the LLM provider
137
+ * @property {"read" | "push" | "admin" | "issues" | "full"} [git_access] - Git access level for this member
138
+ * @property {string[]} [git_repos] - Git repositories this member can access (e.g. ["Apra-Labs/ApraPipes"])
139
+ * @property {string} [icon] - Override the auto-assigned emoji icon. Use named aliases (e.g. blue-circle, green-square) or a raw emoji.
140
+ * @property {string} [cloud_region] - AWS region for the cloud instance
141
+ * @property {string} [cloud_profile] - AWS CLI profile name
142
+ * @property {number} [cloud_idle_timeout_min] - Minutes of inactivity before auto-stop
143
+ * @property {string} [cloud_activity_command] - Custom shell command for workload detection. Must output "busy" or "idle". Pass empty string to clear.
144
+ * @property {"claude" | "codex" | "copilot" | "agy" | "opencode"} [llm_provider] - Change the LLM provider
145
+ * @property {"gpt-oss-120b" | "gpt-120" | "gemini-3.5-flash-lite" | "haiku" | "gpt-5.4-mini"} [model_cheap] - Change custom cheap model
146
+ * @property {"gemini-3.5-flash" | "gpt-oss-120b" | "gpt-120" | "sonnet" | "gpt-5.4"} [model_standard] - Change custom standard model
147
+ * @property {"sonnet" | "opus" | "gpt-oss-120b"} [model_premium] - Change custom premium model
148
+ * @property {{cheap?: string, standard?: string, premium?: string}} [model_tiers] - Per-member model tier map with free-form model IDs. A single model fills all tiers.
149
+ * @property {"codebase-memory" | "gitnexus" | "none"} [code_intel_provider] - Change the code-intelligence provider for this member
122
150
  * @property {string} [category] - Group label
123
151
  * @property {string[]} [tags] - Free-form labels
124
152
  * @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode
153
+ * @property {boolean} [unreservable] - Mark/unmark this member as shared/never exclusively reservable
154
+ * @property {"gitbash" | "pwsh7" | "powershell5"} [shell] - Override the probed Windows shell for this member. Windows members only -- ignored for non-windows members.
155
+ */
156
+
157
+ /**
158
+ * Structured result returned by memberDetail() when called with format: 'json'
159
+ * (src/tools/member-detail.ts). When format is 'compact' (the default), memberDetail()
160
+ * instead returns a plain multi-line text summary, not this shape.
161
+ * @typedef {Object} MemberDetailResult
162
+ * @property {string} server_version - Fleet server version string
163
+ * @property {string} name - Friendly name of the member
164
+ * @property {string} icon - Emoji icon for this member
165
+ * @property {string} id - UUID of the member
166
+ * @property {"local" | "remote"} type - Member type
167
+ * @property {string} host - "(local)" for local members, or "host:port" for remote members
168
+ * @property {string} [username] - SSH username (remote members)
169
+ * @property {string} os - Detected/registered operating system
170
+ * @property {"gitbash" | "pwsh7" | "powershell5"} [shell] - Registered Windows shell for this member (Windows members only)
171
+ * @property {string} folder - Working directory on the target machine
172
+ * @property {string} [repo_remote_url] - Origin URL of the git repo in `folder`, when known
173
+ * @property {string} [vcsProvider] - VCS provider configured for this member
174
+ * @property {Object} connectivity - Connectivity check result (status, latencyMs, auth, keyPath, or error)
175
+ * @property {boolean} [offline] - Set when the member could not be reached
176
+ * @property {string} llmProvider - LLM provider for this member (default: "claude")
177
+ * @property {Object} [llm_cli] - LLM CLI info: { version, auth }
178
+ * @property {Object|string} [tokenUsage] - Cumulative token usage, or "compute only" for llmProvider "none"
179
+ * @property {Object} [session] - Session info: { id, lastActivity, lastLlmActivityAt, status, idleSecs }
180
+ * @property {Object} [resources] - System resource snapshot: { cpu, memory, disk, gpu }
181
+ * @property {string} [branch] - Current git branch in `folder`, when it is a git repo
182
+ * @property {Object} [cloud] - Cloud instance details, for cloud-backed members only
125
183
  */
126
184
 
127
185
  /**
@@ -162,6 +220,35 @@
162
220
  * @property {string} [org_url] - Azure DevOps organization URL (e.g. https://dev.azure.com/myorg)
163
221
  * @property {string} [pat] - Azure DevOps personal access token. Supports {{secure.NAME}}
164
222
  * token -- resolved from the credential store server-side before use.
223
+ * @property {string} [pat_expires_at] - ISO 8601 date/time the Azure DevOps PAT expires, as
224
+ * chosen when creating the token. Propagated to the member registry so provisioning can
225
+ * warn when the PAT is nearing expiry. Must be parseable by Date.parse -- the server
226
+ * REJECTS an unparseable value rather than storing it, because a NaN expiry silences the
227
+ * warning and makes the credential-cleanup timer fall back to its 55-minute default.
228
+ */
229
+
230
+ /**
231
+ * @typedef {Object} VcsPullRequestResponseMapping
232
+ * @property {string} idField - Body field carrying the PR identifier
233
+ * (GitHub: 'number', Azure DevOps: 'pullRequestId').
234
+ * @property {string|null} webUrlField - Body field carrying the browsable PR
235
+ * URL, or null when the body carries none (Azure DevOps).
236
+ * @property {string|null} webUrlTemplate - Template to CONSTRUCT the
237
+ * browsable URL when webUrlField is null, or null when the URL is read
238
+ * straight from the body.
239
+ *
240
+ * Mirrors the `pullRequestResponse` descriptor hook (apra-fleet-lzfv.4) from
241
+ * packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs and the
242
+ * canonical src/services/vcs/types.ts `VcsPullRequestResponseMapping`
243
+ * field-for-field, so the fleet-sprint provider registry, the server-side
244
+ * VCS contract and this client never drift. Declaration-only: the
245
+ * executable `map(body, ctx)` the JS descriptor also carries is
246
+ * deliberately NOT restated here, because index.mjs's own contract comment
247
+ * says a mirroring consumer restates `idField`/`webUrlField`/
248
+ * `webUrlTemplate` while `map` stays the single executable source of truth
249
+ * that reads those same declared fields. This typedef is declarative-only
250
+ * today: no MCP tool in this client yet returns a create-pull-request
251
+ * response for a caller to map.
165
252
  */
166
253
 
167
254
  /**
@@ -319,8 +406,10 @@ export class ApraFleet {
319
406
  }
320
407
 
321
408
  /**
322
- * Get detailed status for one member: connectivity, session, work folder, provider.
409
+ * Get detailed status for one member: connectivity, session, work folder, provider, registered shell (Windows).
323
410
  * @param {{ member_id?: string, member_name?: string, format?: 'compact'|'json' }} options
411
+ * @returns {Promise<string|MemberDetailResult>} A compact text summary when format is
412
+ * "compact" (default), or the structured MemberDetailResult object when format is "json".
324
413
  */
325
414
  async memberDetail(options) {
326
415
  return this.mcpClient.callTool('member_detail', options);
@@ -16,9 +16,7 @@ analyze AND mutate beads directly -- but you never touch code beyond reading it.
16
16
  2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo whose backlog
17
17
  you are grooming, and `hint_modules` naming the subsystems the assigned beads touch.
18
18
  Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts. This matters
19
- most for duplicate detection and sprint-set grouping: two beads that read as unrelated
20
- are often the same underlying issue, and the KB is where that has already been written
21
- down.
19
+ most for duplicate detection and sprint-set grouping.
22
20
  3. When grooming turns up a durable backlog fact -- two ids that are genuinely the same
23
21
  work, a dependency between beads that their text does not state, or a recurring reason
24
22
  items land unactionable -- call `mcp__apra-fleet__kb_capture` with type "knowledge".
@@ -94,24 +92,23 @@ The canonical machine-readable contract lives in the sibling file
94
92
 
95
93
  ## Beads semantics
96
94
 
97
- - `parent-child` = GROUPING. `blocks` = ORDERING. Never conflate them. One parent only.
95
+ Graph semantics (`parent-child` = grouping, `blocks` = ordering, epic rules, `bd epic
96
+ status` gotchas) are canonical in `_shared/GRAPH-SEMANTICS.md`, the sibling file
97
+ installed alongside this one -- read it; do not restate or improvise those rules here.
98
+ Semantics specific to this role:
99
+
98
100
  - `assignee` is set explicitly (`bd update <id> --assignee <identity>`) or via
99
101
  `bd update <id> --claim` (also flips status to `in_progress`). Fall back to `owner`
100
- (static, set once at creation) only when `assignee` is empty.
101
- - `issue_type` does NOT affect ready/dispatch eligibility. Only three things hide a bead
102
- from ready work: an unclosed child, an unmet `blocks` dependency, or status not
103
- `open`/`in_progress`.
104
- - `epic -> feature -> task` is a loose convention. The one hard rule: an epic may
105
- `blocks` only another epic -- bd does not enforce same-type pairs.
106
- - `bd epic status <id>` only rolls up correctly when `<id>` is actually typed `epic`;
107
- on a non-epic id it silently returns unrelated epics.
102
+ (static, set at creation) only when `assignee` is empty.
103
+ - Only three things hide a bead from ready work: an unclosed child, an unmet `blocks`
104
+ dependency, or status not `open`/`in_progress`. `issue_type` never does.
108
105
  - `gate` (`bd create --type=gate --await-type=<kind> --await-id=<id>`) blocks dependents
109
106
  until an external condition resolves. Documented await-types are GitHub-shaped; when
110
107
  recommending a gate, describe the pattern and let the operator pick an await-type
111
108
  matching their actual VCS/CI.
112
- - Title prefixes are convention, not schema, but widely matched on: `[test]` = verification
113
- work for a sibling/parent; `[impl]` = implementation; `[integ]` = filed by an
114
- integration/re-verification pass; `[regression][carry-over]` = rolled-over regression bug.
109
+ - Title prefixes are convention, not schema, but widely matched on: `[test]` =
110
+ verification work; `[impl]` = implementation; `[integ]` = filed by an integration
111
+ pass; `[regression][carry-over]` = rolled-over regression bug.
115
112
 
116
113
  ## Step 1 -- Load the backlog, scoped to identity
117
114
 
@@ -127,9 +124,8 @@ Fall back to non-`--json`/non-`--assignee` forms if unsupported, then filter cli
127
124
  visibly separate. `bd show <id> --json` before any judgment call -- never flag
128
125
  description quality from a summary line alone.
129
126
 
130
- If a `bd` JSON payload is too large to read directly, redirect it under a scratch dir
131
- instead of the repo root -- e.g. `.beads/tmp/<name>.json` (already covered by the
132
- existing `.beads/` gitignore entry) -- never write scratch JSON to the repo root.
127
+ If a `bd` JSON payload is too large to read directly, redirect it to a gitignored
128
+ scratch path (e.g. `.beads/tmp/<name>.json`) -- never to the repo root.
133
129
 
134
130
  ## Step 2 -- Structural deadlock scan (every time)
135
131
 
@@ -241,10 +237,10 @@ The canonical machine-readable contract for this output lives in the sibling fil
241
237
  ```json
242
238
  {
243
239
  "status": "OK",
244
- "identity": "akhil.kumar@gmail.com",
240
+ "identity": "dev@example.com",
245
241
  "notes": "12 ready, 2 sprint sets proposed, 1 duplicate merged, 3 needing grooming.",
246
242
  "ready": [
247
- { "id": "BD-14", "type": "task", "priority": "P1", "status": "open", "assignee": "akhil.kumar@gmail.com", "ageDays": 4, "size": "M", "rationale": "No blockers, clear AC, feeds the auth epic." }
243
+ { "id": "BD-14", "type": "task", "priority": "P1", "status": "open", "assignee": "dev@example.com", "ageDays": 4, "size": "M", "rationale": "No blockers, clear AC, feeds the auth epic." }
248
244
  ],
249
245
  "sprintSets": [
250
246
  { "label": "auth-hardening", "beadIds": ["BD-14", "BD-15"], "reason": "Shared parent BD-10, sequential blocks edge." }
@@ -263,7 +259,7 @@ The canonical machine-readable contract for this output lives in the sibling fil
263
259
  ],
264
260
  "notYours": [],
265
261
  "stale": [
266
- { "id": "BD-60", "type": "bug", "priority": "P1", "status": "open", "assignee": "akhil.kumar@gmail.com", "ageDays": 95, "size": "S", "rationale": "P1, 95 days untouched -- likely dropped, confirm before continuing to carry it." }
262
+ { "id": "BD-60", "type": "bug", "priority": "P1", "status": "open", "assignee": "dev@example.com", "ageDays": 95, "size": "S", "rationale": "P1, 95 days untouched -- likely dropped, confirm before continuing to carry it." }
267
263
  ],
268
264
  "structuralIssues": [
269
265
  { "kind": "deadlock", "description": "BD-70 blocks its own parent BD-71", "beadIds": ["BD-70", "BD-71"] }
@@ -48,6 +48,9 @@ gh run list --pr <prNumber> --limit 5 --json databaseId,status,conclusion,headSh
48
48
  (In PR-scoped mode, apply Step 2 to the runs for the PR's head commit instead of
49
49
  `expectedHeadSha`.)
50
50
 
51
+ If `gh` is unavailable or the repo's remote is not GitHub, do not guess at another CI
52
+ system: return `status: "not_configured"` with `notes` naming what was found.
53
+
51
54
  ## Step 2 -- Interpret the result
52
55
 
53
56
  **No runs returned**: CI has never been triggered on this branch.
@@ -30,27 +30,19 @@ not improvise deploy steps that are not written down in the runbook.
30
30
 
31
31
  ## Step 0a -- Check permissions before running anything
32
32
 
33
- Read `deploy.md`. Look for a `## Permissions` section. If found, verify each
34
- listed command prefix is covered by the MERGED effective permission set --
35
- on Claude Code that means SOME entry in `permissions.allow` of EITHER
36
- `.claude/settings.json` (the team-committed, shared baseline) OR
37
- `.claude/settings.local.json` (the per-checkout, individual/gitignored file;
38
- this is the ONLY file the fleet's `compose_permissions` tool ever writes to
39
- for Claude Code members -- see `skills/fleet/permissions.md`). Claude Code
40
- merges `permissions.allow` from both files, so a grant in EITHER one counts
41
- as coverage; checking only `settings.json` misses every grant
42
- `compose_permissions` delivered. A broader prefix entry counts as coverage
43
- too -- e.g. `Bash(docker:*)` covers `docker compose`. Other providers keep
44
- the equivalent allowlist in their own native config file (see
45
- `src/providers/*.ts`).
46
-
47
- Run the merge MECHANICALLY, in one command, rather than reading each file
48
- separately and merging by eye -- two sequential `cat`s invite stopping at the
49
- first (often-empty) file and never getting to the second, which silently
50
- reports a real grant as missing (observed live, apra-fleet: `settings.json`
51
- legitimately carries no `permissions.allow` in this repo's convention -- every
52
- grant lives in `settings.local.json` -- so a by-eye read that stops at the
53
- first empty file always concludes "nothing is granted" even when it is):
33
+ Read `deploy.md`. If it has a `## Permissions` section, verify each listed
34
+ command prefix is covered by the MERGED effective permission set -- on
35
+ Claude Code, the union of `permissions.allow` from BOTH
36
+ `.claude/settings.json` (team-committed baseline) AND
37
+ `.claude/settings.local.json` (per-checkout, gitignored -- the only file the
38
+ fleet's `compose_permissions` tool writes to; see
39
+ `skills/fleet/permissions.md`). A grant in either file counts; a broader
40
+ prefix counts too (e.g. `Bash(docker:*)` covers `docker compose`). Other
41
+ providers keep the equivalent allowlist in their own native config file.
42
+
43
+ Compute the union MECHANICALLY, in one command -- reading the files
44
+ separately and merging by eye reliably misses grants when the first file is
45
+ empty:
54
46
 
55
47
  ```bash
56
48
  node -e '
@@ -67,29 +59,15 @@ console.log(JSON.stringify([...allow], null, 2));
67
59
  # use your provider's native config file(s) otherwise
68
60
  ```
69
61
 
70
- Check every required command prefix against this one merged list. If any
71
- required command prefix has no covering entry in it, STOP immediately and
72
- return `deployed: false` with notes listing every missing entry, e.g.:
73
-
74
- Missing permissions in the merged CLI permission settings (.claude/settings.json
75
- + .claude/settings.local.json on Claude Code -- neither file covers these):
76
- Bash(docker *)
77
- Bash(docker-compose *)
78
- Ask the orchestrator/operator to run compose_permissions with the missing
79
- grant(s), then re-trigger the sprint.
80
-
81
- Do NOT attempt to add the permissions yourself, by editing any file directly:
82
- - `.claude/settings.json` is the team-committed baseline -- changes there
83
- require the team/a PR, never a self-edit.
84
- - `.claude/settings.local.json` is the correct target for an individual/local
85
- grant, but it must be provisioned via the `compose_permissions` MCP tool
86
- (grant mode), NOT hand-edited either -- that tool is the provider-agnostic
87
- delivery mechanism (this repo supports non-Claude providers too: Gemini,
88
- AGY, OpenCode, Codex -- each has its own native config path via the same
89
- tool).
90
- The correct escalation when a required permission is missing from the merged
91
- effective set is: ask the orchestrator/operator to run `compose_permissions`
92
- with the missing grant. Do NOT proceed past Step 0a if any permissions are missing.
62
+ Check every required prefix against this one merged list. If any prefix has
63
+ no covering entry, STOP immediately and return `deployed: false`, listing
64
+ every missing entry in `notes` and asking the orchestrator/operator to run
65
+ `compose_permissions` with the missing grant(s), then re-trigger the sprint.
66
+ NEVER add permissions yourself: `.claude/settings.json` changes require a
67
+ team PR, and `.claude/settings.local.json` must be provisioned via the
68
+ `compose_permissions` MCP tool (the provider-agnostic delivery mechanism
69
+ across all supported providers), never hand-edited. Do NOT proceed past
70
+ Step 0a while any permission is missing.
93
71
 
94
72
  ## Step 0b -- Knowledge Bank (required -- do this BEFORE any deploy.md operation)
95
73