@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,56 @@
1
+ /**
2
+ * Owner-only file-system helpers for the server's data dir and logs.
3
+ *
4
+ * POSIX: directories are created/tightened to 0700 and files to 0600 with
5
+ * chmod (the mkdir/open `mode` alone is filtered by the umask and never
6
+ * tightens an existing path).
7
+ *
8
+ * Windows: chmod cannot express an ACL, and relying on the user-profile ACL
9
+ * the data dir would inherit is not enough -- APRA_FLEET_DATA_DIR can point
10
+ * anywhere (e.g. C:\fleet-data, readable by every local user). So the path's
11
+ * inherited ACEs are removed and only the current user is granted full
12
+ * control: `icacls <path> /inheritance:r /grant:r <user>:F` (directories get
13
+ * `(OI)(CI)F` so new children inherit it). icacls runs through execFile, never
14
+ * a shell, so the path needs no quoting.
15
+ *
16
+ * Every helper reports failure by return value (a reason string), never by
17
+ * throwing: a log or data dir that cannot be tightened must not stop the
18
+ * server. Callers log the reason.
19
+ */
20
+ export interface OwnerOnlyDeps {
21
+ platform?: NodeJS.Platform;
22
+ execFile?: (file: string, args: string[]) => void;
23
+ /** Windows account to grant (default: currentWindowsUser()). */
24
+ windowsUser?: string;
25
+ }
26
+ /**
27
+ * The account icacls (and the service task) grants on Windows, read from this
28
+ * process's token: `whoami` prints DOMAIN\user (<COMPUTERNAME>\user for a local
29
+ * account). Never env USERDOMAIN: Win32-OpenSSH sets it to WORKGROUP on a
30
+ * workgroup machine, a name that maps to no account. Falls back to the bare
31
+ * token user name (os.userInfo), which icacls/schtasks resolve themselves.
32
+ */
33
+ export declare function currentWindowsUser(whoami?: () => string): string;
34
+ /**
35
+ * Windows install step: restrict each path to the owner and return one loud
36
+ * `[!]` line per failure, naming the file and the manual fix (empty on
37
+ * success). Callers gate on win32; POSIX keeps its chmod path.
38
+ */
39
+ export declare function ownerOnlyInstallWarnings(targets: Array<{
40
+ path: string;
41
+ kind: 'file' | 'dir';
42
+ }>, deps?: OwnerOnlyDeps): string[];
43
+ /**
44
+ * Restrict `target` (an existing file or directory) to the current user.
45
+ * Returns null on success, else a one-line reason.
46
+ */
47
+ export declare function restrictToOwner(target: string, kind: 'file' | 'dir', deps?: OwnerOnlyDeps): string | null;
48
+ /** mkdir -p `dir` (0700) and restrict it to the owner. Returns failure reasons. */
49
+ export declare function ensureOwnerOnlyDir(dir: string, deps?: OwnerOnlyDeps): string[];
50
+ /**
51
+ * Open `file` for append, created 0600, and restrict it (new or pre-existing)
52
+ * to the owner. Throws only when the open itself fails; restriction failures
53
+ * are pushed onto `problems`.
54
+ */
55
+ export declare function openOwnerOnlyAppend(file: string, problems?: string[], deps?: OwnerOnlyDeps): number;
56
+ //# sourceMappingURL=owner-only-fs.d.ts.map
@@ -0,0 +1,98 @@
1
+ import fs from 'node:fs';
2
+ import os from 'node:os';
3
+ import { execFileSync } from 'node:child_process';
4
+ function defaultExecFile(file, args) {
5
+ execFileSync(file, args, { stdio: 'ignore', windowsHide: true, timeout: 15_000 });
6
+ }
7
+ function defaultWhoami() {
8
+ return execFileSync('whoami', [], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true, timeout: 15_000 });
9
+ }
10
+ let cachedWindowsUser;
11
+ /**
12
+ * The account icacls (and the service task) grants on Windows, read from this
13
+ * process's token: `whoami` prints DOMAIN\user (<COMPUTERNAME>\user for a local
14
+ * account). Never env USERDOMAIN: Win32-OpenSSH sets it to WORKGROUP on a
15
+ * workgroup machine, a name that maps to no account. Falls back to the bare
16
+ * token user name (os.userInfo), which icacls/schtasks resolve themselves.
17
+ */
18
+ export function currentWindowsUser(whoami) {
19
+ if (!whoami && cachedWindowsUser)
20
+ return cachedWindowsUser;
21
+ let name;
22
+ try {
23
+ const out = (whoami ?? defaultWhoami)().trim();
24
+ if (/^[^\\\s]+\\[^\\]+$/.test(out) && !out.includes(String.fromCharCode(0xfffd)))
25
+ name = out;
26
+ }
27
+ catch { /* fall back below */ }
28
+ if (!name) {
29
+ try {
30
+ name = os.userInfo().username;
31
+ }
32
+ catch {
33
+ name = 'unknown';
34
+ }
35
+ }
36
+ if (!whoami)
37
+ cachedWindowsUser = name;
38
+ return name;
39
+ }
40
+ /**
41
+ * Windows install step: restrict each path to the owner and return one loud
42
+ * `[!]` line per failure, naming the file and the manual fix (empty on
43
+ * success). Callers gate on win32; POSIX keeps its chmod path.
44
+ */
45
+ export function ownerOnlyInstallWarnings(targets, deps = {}) {
46
+ const out = [];
47
+ for (const t of targets) {
48
+ if (!fs.existsSync(t.path))
49
+ continue;
50
+ const why = restrictToOwner(t.path, t.kind, deps);
51
+ if (!why)
52
+ continue;
53
+ const user = deps.windowsUser ?? currentWindowsUser();
54
+ const grant = t.kind === 'dir' ? `${user}:(OI)(CI)F` : `${user}:F`;
55
+ out.push(` [!] ${t.path} is NOT owner-only (${why}). Other local users may read it. Fix: icacls "${t.path}" /inheritance:r /grant:r "${grant}"`);
56
+ }
57
+ return out;
58
+ }
59
+ /**
60
+ * Restrict `target` (an existing file or directory) to the current user.
61
+ * Returns null on success, else a one-line reason.
62
+ */
63
+ export function restrictToOwner(target, kind, deps = {}) {
64
+ const platform = deps.platform ?? process.platform;
65
+ try {
66
+ if (platform === 'win32') {
67
+ const user = deps.windowsUser ?? currentWindowsUser();
68
+ const grant = kind === 'dir' ? `${user}:(OI)(CI)F` : `${user}:F`;
69
+ (deps.execFile ?? defaultExecFile)('icacls', [target, '/inheritance:r', '/grant:r', grant]);
70
+ }
71
+ else {
72
+ fs.chmodSync(target, kind === 'dir' ? 0o700 : 0o600);
73
+ }
74
+ return null;
75
+ }
76
+ catch (err) {
77
+ return `could not restrict ${target} to its owner: ${err.message}`;
78
+ }
79
+ }
80
+ /** mkdir -p `dir` (0700) and restrict it to the owner. Returns failure reasons. */
81
+ export function ensureOwnerOnlyDir(dir, deps = {}) {
82
+ fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
83
+ const why = restrictToOwner(dir, 'dir', deps);
84
+ return why ? [why] : [];
85
+ }
86
+ /**
87
+ * Open `file` for append, created 0600, and restrict it (new or pre-existing)
88
+ * to the owner. Throws only when the open itself fails; restriction failures
89
+ * are pushed onto `problems`.
90
+ */
91
+ export function openOwnerOnlyAppend(file, problems = [], deps = {}) {
92
+ const fd = fs.openSync(file, 'a', 0o600);
93
+ const why = restrictToOwner(file, 'file', deps);
94
+ if (why)
95
+ problems.push(why);
96
+ return fd;
97
+ }
98
+ //# sourceMappingURL=owner-only-fs.js.map
@@ -1,3 +1,31 @@
1
1
  export declare function isPidAlive(pid: number): boolean;
2
+ /** True when a process command line is an apra-fleet server: the SEA binary,
3
+ * or node running a dist/index.js build. */
4
+ export declare function isApraFleetCommandLine(cmd: string): boolean;
5
+ /** The command line of a live pid, or null when it cannot be read. */
6
+ export declare function processCommandLine(pid: number): string | null;
7
+ /**
8
+ * Windows image name of a live pid from `tasklist /FI "PID eq N" /FO CSV /NH`,
9
+ * or null when it cannot be read (no such pid, or tasklist failed).
10
+ */
11
+ export declare function processImageName(pid: number): string | null;
12
+ /** The image name from tasklist CSV output for pid, or null (e.g. the
13
+ * localized "INFO: No tasks are running..." line, which is not CSV). */
14
+ export declare function parseTasklistImage(out: string, pid: number): string | null;
15
+ /** Image names an apra-fleet server runs as: the SEA binary, or node. */
16
+ export declare function isApraFleetImage(image: string): boolean;
17
+ export interface FleetIdentityProbes {
18
+ platform: NodeJS.Platform;
19
+ commandLine: (pid: number) => string | null;
20
+ imageName: (pid: number) => string | null;
21
+ }
22
+ /**
23
+ * GitHub #584 review: before force-killing the pid recorded in server.json,
24
+ * confirm it is still an apra-fleet server -- pids are reused, and the port
25
+ * owner may be a foreign app. true / false, or null when it cannot be told.
26
+ * On Windows, when the command line is unreadable (Get-CimInstance returned
27
+ * nothing), fall back to the tasklist image name.
28
+ */
29
+ export declare function isApraFleetProcess(pid: number, probes?: FleetIdentityProbes): boolean | null;
2
30
  export declare function postShutdown(url: string): Promise<void>;
3
31
  //# sourceMappingURL=process-utils.d.ts.map
@@ -1,4 +1,5 @@
1
1
  import http from 'node:http';
2
+ import { execFileSync } from 'node:child_process';
2
3
  export function isPidAlive(pid) {
3
4
  try {
4
5
  process.kill(pid, 0);
@@ -8,6 +9,73 @@ export function isPidAlive(pid) {
8
9
  return false;
9
10
  }
10
11
  }
12
+ /** True when a process command line is an apra-fleet server: the SEA binary,
13
+ * or node running a dist/index.js build. */
14
+ export function isApraFleetCommandLine(cmd) {
15
+ return /apra-fleet/i.test(cmd) || /dist[\\/]index\.js/i.test(cmd);
16
+ }
17
+ /** The command line of a live pid, or null when it cannot be read. */
18
+ export function processCommandLine(pid) {
19
+ if (!Number.isInteger(pid) || pid <= 0)
20
+ return null;
21
+ const opts = { encoding: 'utf8', stdio: 'pipe', windowsHide: true, timeout: 10_000 };
22
+ try {
23
+ const out = process.platform === 'win32'
24
+ ? execFileSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
25
+ `(Get-CimInstance Win32_Process -Filter "ProcessId=${pid}").CommandLine`], opts)
26
+ : execFileSync('ps', ['-p', String(pid), '-o', 'command='], opts);
27
+ const trimmed = String(out).trim();
28
+ return trimmed === '' ? null : trimmed;
29
+ }
30
+ catch {
31
+ return null;
32
+ }
33
+ }
34
+ /**
35
+ * Windows image name of a live pid from `tasklist /FI "PID eq N" /FO CSV /NH`,
36
+ * or null when it cannot be read (no such pid, or tasklist failed).
37
+ */
38
+ export function processImageName(pid) {
39
+ if (!Number.isInteger(pid) || pid <= 0)
40
+ return null;
41
+ try {
42
+ const out = execFileSync('tasklist', ['/FI', `PID eq ${pid}`, '/FO', 'CSV', '/NH'], { encoding: 'utf8', stdio: 'pipe', windowsHide: true, timeout: 10_000 });
43
+ return parseTasklistImage(String(out), pid);
44
+ }
45
+ catch {
46
+ return null;
47
+ }
48
+ }
49
+ /** The image name from tasklist CSV output for pid, or null (e.g. the
50
+ * localized "INFO: No tasks are running..." line, which is not CSV). */
51
+ export function parseTasklistImage(out, pid) {
52
+ for (const line of out.split(/\r?\n/)) {
53
+ const m = /^"([^"]+)","(\d+)"/.exec(line.trim());
54
+ if (m && Number(m[2]) === pid)
55
+ return m[1];
56
+ }
57
+ return null;
58
+ }
59
+ /** Image names an apra-fleet server runs as: the SEA binary, or node. */
60
+ export function isApraFleetImage(image) {
61
+ return /^(apra-fleet|node)\.exe$/i.test(image.trim());
62
+ }
63
+ /**
64
+ * GitHub #584 review: before force-killing the pid recorded in server.json,
65
+ * confirm it is still an apra-fleet server -- pids are reused, and the port
66
+ * owner may be a foreign app. true / false, or null when it cannot be told.
67
+ * On Windows, when the command line is unreadable (Get-CimInstance returned
68
+ * nothing), fall back to the tasklist image name.
69
+ */
70
+ export function isApraFleetProcess(pid, probes = { platform: process.platform, commandLine: processCommandLine, imageName: processImageName }) {
71
+ const cmd = probes.commandLine(pid);
72
+ if (cmd !== null)
73
+ return isApraFleetCommandLine(cmd);
74
+ if (probes.platform !== 'win32')
75
+ return null;
76
+ const image = probes.imageName(pid);
77
+ return image === null ? null : isApraFleetImage(image);
78
+ }
11
79
  export async function postShutdown(url) {
12
80
  const shutdownUrl = url.replace(/\/mcp$/, '/shutdown');
13
81
  const parsed = new URL(shutdownUrl);
@@ -6,9 +6,18 @@ const patterns = [
6
6
  // actionable signature is not swallowed by a broader pattern. Remediation: seed trust
7
7
  // via ensureWorkspaceTrusted(workFolder) (apra-fleet-eft.40.1/40.2).
8
8
  { category: 'workspace_not_trusted', re: /this workspace has not been trusted/i },
9
- { category: 'auth', re: /not logged in|unauthorized|\b401\b|authentication_error|expired.*token|permission_error|invalid.*api.*key|api_key_missing|antigravity_api_key|unauthenticated/i },
10
- { category: 'server', re: /\b500\b|\b502\b|\b503\b|internal server error|api_error|connection refused|endpoint not reachable|no route to host|dial tcp|failed to connect|network unreachable|dns lookup failed/i },
9
+ // OAuth-expired CLI result (is_error, terminal_reason api_error, "Failed to authenticate:
10
+ // OAuth session expired and could not be refreshed") also carries api_error; auth is
11
+ // tested before overloaded/server so it is not misread as a retryable server failure.
12
+ { category: 'auth', re: /not logged in|unauthorized|\b401\b|authentication_error|expired.*token|permission_error|invalid.*api.*key|api_key_missing|antigravity_api_key|unauthenticated|failed to authenticate|oauth session expired|could not be refreshed/i },
13
+ // apra-fleet-hzeb.1: overloaded MUST be tested before server. A usage-limit /
14
+ // rate-limit payload (e.g. a 429) commonly ALSO carries an `api_error` string,
15
+ // which the server pattern would otherwise claim first and misclassify as a
16
+ // transient server error. Ordering overloaded ahead keeps a 429+api_error
17
+ // payload classified as overloaded (retryable-with-backoff / usage-limit family),
18
+ // not server.
11
19
  { category: 'overloaded', re: /\b429\b|\b529\b|overloaded|rate limit|quota exceeded|resource_exhausted|credit limit|usage limit/i },
20
+ { category: 'server', re: /\b500\b|\b502\b|\b503\b|internal server error|api_error|connection refused|endpoint not reachable|no route to host|dial tcp|failed to connect|network unreachable|dns lookup failed/i },
12
21
  ];
13
22
  export function classifyPromptError(output) {
14
23
  return patterns.find(p => p.re.test(output))?.category ?? 'unknown';
@@ -6,8 +6,10 @@ import { type SessionState } from '../services/session-registry.js';
6
6
  * `identity` is what credential scoping consumes:
7
7
  * - `*` -- stdio / fleet-operator (no sessionId at all)
8
8
  * - a member friendly name -- registered session whose agent is still in the registry
9
- * - `session:<id>` -- HTTP session that cannot be resolved to a live member
10
- * (unknown sid, or the backing agent was removed). Never a raw member UUID.
9
+ * - `session:<short sid>` -- HTTP session that cannot be resolved to a live member
10
+ * (unknown sid, or the backing agent was removed). Never a raw member UUID. The sid is
11
+ * shortened (shortSid) because denial messages naming this identity reach
12
+ * fleet.log; it only has to never match a member name.
11
13
  */
12
14
  export interface SessionCaller {
13
15
  sessionId?: string;
@@ -1,5 +1,6 @@
1
1
  import { sessionRegistry } from '../services/session-registry.js';
2
2
  import { getAgentOrFail } from './agent-helpers.js';
3
+ import { shortSid } from './log-helpers.js';
3
4
  /**
4
5
  * Shared session -> caller identity lookup used by send_email (credential
5
6
  * scoping) and report_status (member identification).
@@ -14,10 +15,10 @@ export function resolveSessionCaller(sessionId) {
14
15
  return { identity: '*' };
15
16
  const session = sessionRegistry.findBySessionId(sessionId);
16
17
  if (!session)
17
- return { sessionId, identity: `session:${sessionId}` };
18
+ return { sessionId, identity: `session:${shortSid(sessionId)}` };
18
19
  const agent = getAgentOrFail(session.member_id);
19
20
  if (typeof agent === 'string') {
20
- return { sessionId, session, identity: `session:${sessionId}` };
21
+ return { sessionId, session, identity: `session:${shortSid(sessionId)}` };
21
22
  }
22
23
  return { sessionId, session, agent, identity: agent.friendlyName };
23
24
  }
@@ -2,10 +2,19 @@
2
2
  * Centralized shell escaping functions to prevent command injection (CWE-78).
3
3
  * Used by platform.ts, execute-prompt.ts, and provision-auth.ts.
4
4
  */
5
+ /**
6
+ * The interior transform escapeShellArg wraps in single quotes, factored out
7
+ * so a value that must sit INSIDE an already-open single-quoted string (e.g.
8
+ * vcs-credential-exec.ts's inline token placeholder) can reuse the exact same
9
+ * escaping without also picking up the wrapping quotes. escapeShellArg is
10
+ * defined in terms of this function rather than repeating the replace, so the
11
+ * two can never drift apart (apra-fleet-3swo.7.16).
12
+ */
13
+ export declare function escapeShellArgInner(s: string): string;
5
14
  /**
6
15
  * Escape a string for safe use inside single-quoted Unix shell arguments.
7
16
  * Handles embedded single quotes by ending the quote, adding an escaped quote, and reopening.
8
- * e.g. "it's" → 'it'\''s'
17
+ * e.g. "it's" -> 'it'\''s'
9
18
  */
10
19
  export declare function escapeShellArg(s: string): string;
11
20
  /**
@@ -13,15 +22,38 @@ export declare function escapeShellArg(s: string): string;
13
22
  * Escapes: $ ` " \ ! (characters with special meaning inside double quotes).
14
23
  */
15
24
  export declare function escapeDoubleQuoted(s: string): string;
25
+ /**
26
+ * Escape a literal value for embedding inside "..." in a member-bound command.
27
+ * POSIX: backslash, ", $ and backtick are live inside double quotes. `!` is
28
+ * deliberately NOT escaped (unlike escapeDoubleQuoted): history expansion is
29
+ * off in the non-interactive shells commands run in, so `\!` would stay a
30
+ * literal backslash + `!` and corrupt the path. PowerShell: backtick, ", $ (and
31
+ * the curly double quotes U+201C..U+201E, which PowerShell treats as quotes)
32
+ * are live and are escaped with a backtick; backslash is literal there.
33
+ * A literal newline needs no escaping: it is inert inside "..." in both shells.
34
+ */
35
+ export declare function escapeForDoubleQuotes(s: string, powershell: boolean): string;
16
36
  /**
17
37
  * Escape a string for safe use inside double-quoted Windows cmd.exe arguments.
18
38
  * Escapes: " & | ^ < > (cmd.exe metacharacters).
19
39
  */
20
40
  export declare function escapeWindowsArg(s: string): string;
41
+ /**
42
+ * The interior transform escapePowerShellArg wraps in single quotes, factored
43
+ * out for the same reason as escapeShellArgInner above: a value that must sit
44
+ * INSIDE an already-open PowerShell single-quoted string reuses this directly
45
+ * instead of re-implementing the doubling rule (apra-fleet-3swo.7.16).
46
+ *
47
+ * PowerShell treats U+2018..U+201B (curly/low-9/reversed single quotes) as
48
+ * single-quote characters too, so any of them would end the literal. Each
49
+ * quote character is doubled as itself, which PowerShell reads back as that
50
+ * one literal character. Strings without these characters are unchanged.
51
+ */
52
+ export declare function escapePowerShellArgInner(s: string): string;
21
53
  /**
22
54
  * Escape a string for safe use as a PowerShell single-quoted string literal.
23
- * Single-quoted strings in PowerShell are fully literal — no variable expansion.
24
- * Internal single quotes are escaped by doubling them: ' → ''
55
+ * Single-quoted strings in PowerShell are fully literal -- no variable expansion.
56
+ * Internal single quotes (ASCII ' and U+2018..U+201B) are escaped by doubling them.
25
57
  * Returns the value wrapped in single quotes.
26
58
  */
27
59
  export declare function escapePowerShellArg(s: string): string;
@@ -34,6 +66,29 @@ export declare function escapeBatchMetachars(s: string): string;
34
66
  * Escape regex metacharacters for use in `grep -E` patterns.
35
67
  */
36
68
  export declare function escapeGrepPattern(s: string): string;
69
+ /**
70
+ * Escape a literal string for use inside a sed POSIX basic regular expression
71
+ * delimited by `/`. Backslash is escaped first so an input backslash can never
72
+ * combine with a following character into an escape sequence. Characters that
73
+ * are only special in ERE (+ ? | ( ) { }) are left alone: GNU sed gives `\+`
74
+ * etc. a special meaning in BRE, so escaping them would change the match.
75
+ */
76
+ export declare function escapeSedBasicRegex(s: string): string;
77
+ /**
78
+ * Escape a string for use inside an AppleScript double-quoted string literal.
79
+ * Backslash is the AppleScript escape character, so it is doubled first;
80
+ * then embedded double quotes are backslash-escaped.
81
+ */
82
+ export declare function escapeAppleScriptString(s: string): string;
83
+ /**
84
+ * Quote one argument for a Windows command line as parsed by the MSVC CRT /
85
+ * CommandLineToArgvW (what node.exe and most native programs use). Backslashes
86
+ * are literal unless they precede a double quote, so runs of backslashes before
87
+ * a quote (or the closing quote) are doubled. This is NOT cmd.exe quoting --
88
+ * the result must never be handed to cmd.exe, which also expands % and treats
89
+ * & | ^ < > as operators.
90
+ */
91
+ export declare function quoteWindowsArgv(arg: string): string;
37
92
  /**
38
93
  * Validate and sanitize a session ID to prevent injection.
39
94
  * Session IDs must be alphanumeric with dashes and underscores only.
@@ -2,13 +2,24 @@
2
2
  * Centralized shell escaping functions to prevent command injection (CWE-78).
3
3
  * Used by platform.ts, execute-prompt.ts, and provision-auth.ts.
4
4
  */
5
+ /**
6
+ * The interior transform escapeShellArg wraps in single quotes, factored out
7
+ * so a value that must sit INSIDE an already-open single-quoted string (e.g.
8
+ * vcs-credential-exec.ts's inline token placeholder) can reuse the exact same
9
+ * escaping without also picking up the wrapping quotes. escapeShellArg is
10
+ * defined in terms of this function rather than repeating the replace, so the
11
+ * two can never drift apart (apra-fleet-3swo.7.16).
12
+ */
13
+ export function escapeShellArgInner(s) {
14
+ return s.replace(/'/g, "'\\''");
15
+ }
5
16
  /**
6
17
  * Escape a string for safe use inside single-quoted Unix shell arguments.
7
18
  * Handles embedded single quotes by ending the quote, adding an escaped quote, and reopening.
8
- * e.g. "it's" → 'it'\''s'
19
+ * e.g. "it's" -> 'it'\''s'
9
20
  */
10
21
  export function escapeShellArg(s) {
11
- return "'" + s.replace(/'/g, "'\\''") + "'";
22
+ return "'" + escapeShellArgInner(s) + "'";
12
23
  }
13
24
  /**
14
25
  * Escape a string for safe use inside double-quoted Unix shell arguments.
@@ -22,6 +33,21 @@ export function escapeDoubleQuoted(s) {
22
33
  .replace(/`/g, '\\`')
23
34
  .replace(/!/g, '\\!');
24
35
  }
36
+ /**
37
+ * Escape a literal value for embedding inside "..." in a member-bound command.
38
+ * POSIX: backslash, ", $ and backtick are live inside double quotes. `!` is
39
+ * deliberately NOT escaped (unlike escapeDoubleQuoted): history expansion is
40
+ * off in the non-interactive shells commands run in, so `\!` would stay a
41
+ * literal backslash + `!` and corrupt the path. PowerShell: backtick, ", $ (and
42
+ * the curly double quotes U+201C..U+201E, which PowerShell treats as quotes)
43
+ * are live and are escaped with a backtick; backslash is literal there.
44
+ * A literal newline needs no escaping: it is inert inside "..." in both shells.
45
+ */
46
+ export function escapeForDoubleQuotes(s, powershell) {
47
+ return powershell
48
+ ? s.replace(/[`"$\u201C-\u201E]/g, '`$&')
49
+ : s.replace(/[\\"$`]/g, '\\$&');
50
+ }
25
51
  /**
26
52
  * Escape a string for safe use inside double-quoted Windows cmd.exe arguments.
27
53
  * Escapes: " & | ^ < > (cmd.exe metacharacters).
@@ -31,14 +57,28 @@ export function escapeWindowsArg(s) {
31
57
  .replace(/"/g, '""')
32
58
  .replace(/([&|^<>])/g, '^$1');
33
59
  }
60
+ /**
61
+ * The interior transform escapePowerShellArg wraps in single quotes, factored
62
+ * out for the same reason as escapeShellArgInner above: a value that must sit
63
+ * INSIDE an already-open PowerShell single-quoted string reuses this directly
64
+ * instead of re-implementing the doubling rule (apra-fleet-3swo.7.16).
65
+ *
66
+ * PowerShell treats U+2018..U+201B (curly/low-9/reversed single quotes) as
67
+ * single-quote characters too, so any of them would end the literal. Each
68
+ * quote character is doubled as itself, which PowerShell reads back as that
69
+ * one literal character. Strings without these characters are unchanged.
70
+ */
71
+ export function escapePowerShellArgInner(s) {
72
+ return s.replace(/['\u2018-\u201B]/g, '$&$&');
73
+ }
34
74
  /**
35
75
  * Escape a string for safe use as a PowerShell single-quoted string literal.
36
- * Single-quoted strings in PowerShell are fully literal — no variable expansion.
37
- * Internal single quotes are escaped by doubling them: ' → ''
76
+ * Single-quoted strings in PowerShell are fully literal -- no variable expansion.
77
+ * Internal single quotes (ASCII ' and U+2018..U+201B) are escaped by doubling them.
38
78
  * Returns the value wrapped in single quotes.
39
79
  */
40
80
  export function escapePowerShellArg(s) {
41
- return "'" + s.replace(/'/g, "''") + "'";
81
+ return "'" + escapePowerShellArgInner(s) + "'";
42
82
  }
43
83
  /**
44
84
  * Escape batch (cmd.exe) metacharacters for safe use in .bat file content.
@@ -53,6 +93,52 @@ export function escapeBatchMetachars(s) {
53
93
  export function escapeGrepPattern(s) {
54
94
  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
55
95
  }
96
+ /**
97
+ * Escape a literal string for use inside a sed POSIX basic regular expression
98
+ * delimited by `/`. Backslash is escaped first so an input backslash can never
99
+ * combine with a following character into an escape sequence. Characters that
100
+ * are only special in ERE (+ ? | ( ) { }) are left alone: GNU sed gives `\+`
101
+ * etc. a special meaning in BRE, so escaping them would change the match.
102
+ */
103
+ export function escapeSedBasicRegex(s) {
104
+ return s.replace(/[\\/.*[\]^$]/g, '\\$&');
105
+ }
106
+ /**
107
+ * Escape a string for use inside an AppleScript double-quoted string literal.
108
+ * Backslash is the AppleScript escape character, so it is doubled first;
109
+ * then embedded double quotes are backslash-escaped.
110
+ */
111
+ export function escapeAppleScriptString(s) {
112
+ return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
113
+ }
114
+ /**
115
+ * Quote one argument for a Windows command line as parsed by the MSVC CRT /
116
+ * CommandLineToArgvW (what node.exe and most native programs use). Backslashes
117
+ * are literal unless they precede a double quote, so runs of backslashes before
118
+ * a quote (or the closing quote) are doubled. This is NOT cmd.exe quoting --
119
+ * the result must never be handed to cmd.exe, which also expands % and treats
120
+ * & | ^ < > as operators.
121
+ */
122
+ export function quoteWindowsArgv(arg) {
123
+ if (arg !== '' && !/[\s"]/.test(arg))
124
+ return arg;
125
+ let out = '"';
126
+ let backslashes = 0;
127
+ for (const ch of arg) {
128
+ if (ch === '\\') {
129
+ backslashes++;
130
+ continue;
131
+ }
132
+ if (ch === '"') {
133
+ out += '\\'.repeat(backslashes * 2 + 1) + '"';
134
+ }
135
+ else {
136
+ out += '\\'.repeat(backslashes) + ch;
137
+ }
138
+ backslashes = 0;
139
+ }
140
+ return out + '\\'.repeat(backslashes * 2) + '"';
141
+ }
56
142
  /**
57
143
  * Validate and sanitize a session ID to prevent injection.
58
144
  * Session IDs must be alphanumeric with dashes and underscores only.
@@ -12,6 +12,9 @@ export function classifySshError(error) {
12
12
  if (/ETIMEDOUT|ENOTFOUND|EHOSTUNREACH/i.test(msg)) {
13
13
  return 'Host unreachable — check hostname and network';
14
14
  }
15
+ if (/Channel open failure/i.test(msg)) {
16
+ return "The member's sshd refused a new SSH session - its per-connection session limit (sshd MaxSessions, default 10) is likely exhausted by concurrent or leaked sessions";
17
+ }
15
18
  if (/password prompt could not be opened|OOB|auth-socket/i.test(msg)) {
16
19
  return "Password prompt could not be opened. Try passing the password directly via the 'password' field.";
17
20
  }
@@ -0,0 +1,65 @@
1
+ /**
2
+ * detectVcsProviderFromRemoteUrl -- map a git remote URL onto the VCS provider
3
+ * that hosts it (apra-fleet-5oo).
4
+ *
5
+ * WHY THIS EXISTS. `register_member` could fully register a dispatch-capable
6
+ * member (llm_provider: 'claude') while leaving Agent.vcsProvider unset --
7
+ * nothing in registration ever asked for or detected it. The gap only surfaced
8
+ * hours later, mid-sprint, when fleet-sprint's VCSModule.resolveProvider()
9
+ * threw "member has no registered VCS provider" on the first push/PR. This
10
+ * function is the registration-time half of the fix: a best-effort read of the
11
+ * member's own `origin` remote is mapped to a provider here, so the common case
12
+ * needs no operator input at all.
13
+ *
14
+ * PARALLEL IMPLEMENTATION, DELIBERATELY. The orchestrator-side (fleet-se)
15
+ * equivalent of this logic lives in
16
+ * packages/apra-fleet-se/fleet-sprint/vcs-module.mjs (parseRemote /
17
+ * parseProviderRepoRef) and each provider descriptor's own matchesHost()
18
+ * under packages/apra-fleet-se/fleet-sprint/vcs-providers/. That code is a
19
+ * separate package with its own registry and cannot be imported from the
20
+ * server's src/ tree. The host rules below are kept deliberately in step with
21
+ * those descriptors -- azure-devops.mjs's and bitbucket.mjs's anchored
22
+ * HOST_REs, and github.mjs's anchored matchesHostForAuth() -- so the two
23
+ * halves never disagree about who owns a host. Note that github.mjs ALSO
24
+ * exports a deliberately wider substring matchesHost(); that one answers the
25
+ * capabilities axis ("could a PR be opened here?", where GitHub Enterprise
26
+ * Server must say yes) and is NOT the matcher any credential decision uses.
27
+ *
28
+ * URL SHAPES. Every form git itself accepts for a hosted remote:
29
+ * - https://host/owner/repo(.git) scheme'd, optional userinfo/port
30
+ * - http://host/owner/repo(.git)
31
+ * - ssh://git@host(:port)/owner/repo(.git) scheme'd ssh
32
+ * - git://host/owner/repo.git the read-only git protocol
33
+ * - git@host:owner/repo(.git) scp-like shorthand (NO scheme --
34
+ * `new URL()` cannot parse it)
35
+ * A `file://` remote, a local path, an empty/absent URL, or a host no provider
36
+ * below claims all return null: "unknown", never a guess. Callers must treat
37
+ * null as "could not determine", not as an error.
38
+ *
39
+ * Host matching is ANCHORED on purpose. A substring test would let
40
+ * `github.com.evil.example` or `dev.azure.com.attacker.test` claim a provider
41
+ * and send a member's freshly-minted push credential at the wrong host.
42
+ * GitHub Enterprise Server hosts (which have no fixed domain) are therefore
43
+ * NOT auto-detected here -- an operator registers those with an explicit
44
+ * `vcs_provider`.
45
+ *
46
+ * Pure: no I/O, no throwing, no mutation. ASCII only.
47
+ */
48
+ /** The provider vocabulary Agent.vcsProvider accepts (src/types.ts). */
49
+ export type DetectedVcsProvider = 'github' | 'bitbucket' | 'azure-devops';
50
+ /**
51
+ * Extract the lowercased hostname from a git remote URL, for BOTH shapes git
52
+ * speaks. Returns null for a file:// remote, a bare local path, or anything
53
+ * unparseable -- mirroring vcs-module.mjs's parseRemote().
54
+ */
55
+ export declare function parseRemoteHost(remoteUrl: unknown): string | null;
56
+ /**
57
+ * Resolve a git remote URL to the VCS provider that hosts it.
58
+ *
59
+ * @param remoteUrl a git remote URL in any of the shapes documented above.
60
+ * @returns 'github' | 'bitbucket' | 'azure-devops', or null when the URL is
61
+ * absent/unparseable or its host is not one this function recognizes.
62
+ * Null is "unknown", NEVER a default provider.
63
+ */
64
+ export declare function detectVcsProviderFromRemoteUrl(remoteUrl: unknown): DetectedVcsProvider | null;
65
+ //# sourceMappingURL=vcs-provider-detect.d.ts.map