@apralabs/apra-fleet 0.4.3 → 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 (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  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/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -1,11 +1,76 @@
1
- import { execFileSync } from 'node:child_process';
1
+ import { execFileSync, spawn } from 'node:child_process';
2
2
  import fs from 'node:fs';
3
3
  import path from 'node:path';
4
- import { WINDOWS_TASK_NAME } from './types.js';
4
+ import { WINDOWS_TASK_NAME, SERVICE_ENV_MARKER } from './types.js';
5
5
  import { gracefulStopByServerJson } from './index.js';
6
+ import { clearServiceStartFailures } from '../service-start-guard.js';
7
+ import { readStoppedMarker } from '../stopped-marker.js';
8
+ import { SERVICE_NOTICE_PATH, writeServiceNotice, clearServiceNotice } from '../service-notice.js';
6
9
  import { BIN_DIR } from '../../cli/config.js';
10
+ import { selfInvocationLines } from '../../cli/install-guard.js';
11
+ import { currentWindowsUser } from '../../utils/owner-only-fs.js';
7
12
  const WRAPPER_PATH = path.join(BIN_DIR, 'apra-fleet-service.bat');
8
- const defaultSchtasksRunner = (args) => execFileSync('schtasks', args, { timeout: 30_000, windowsHide: true });
13
+ /** HKCU Run key used ONLY as the last-resort fallback (logon autostart, no restart). */
14
+ export const RUN_KEY = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run';
15
+ export const RUN_VALUE = WINDOWS_TASK_NAME;
16
+ /** Default repeat interval of the task's revive trigger. */
17
+ export const DEFAULT_REPEAT_MINUTES = 5;
18
+ /**
19
+ * Test-only override of the revive-trigger interval in minutes (1..1440), so a
20
+ * manual non-admin verification does not have to wait 5 minutes per cycle.
21
+ * Read once at register() time; not a supported user setting.
22
+ */
23
+ export const REPEAT_MINUTES_ENV = 'APRA_FLEET_TASK_REPEAT_MINUTES';
24
+ // GitHub #585: every schtasks/taskkill/reg call pipes ALL stdio (stderr too)
25
+ // and hides its console window. Inherited stderr printed schtasks' localized
26
+ // "ERROR: The system cannot find the file specified." above apra-fleet status
27
+ // whenever no task was registered.
28
+ const QUIET = { stdio: 'pipe', windowsHide: true, timeout: 30_000 };
29
+ function quietExec(cmd, args) {
30
+ return execFileSync(cmd, args, QUIET);
31
+ }
32
+ const defaultSchtasksRunner = (args) => quietExec('schtasks', args);
33
+ const defaultRegRunner = (args) => quietExec('reg', args);
34
+ /**
35
+ * The schtasks error text of a failed run, without execFileSync's
36
+ * "Command failed: <command line>" prefix, on one line.
37
+ */
38
+ export function schtasksErrorReason(msg) {
39
+ const lines = msg.split(/\r?\n/).map(l => l.trim()).filter(l => l && !/^Command failed:/i.test(l));
40
+ return lines.join(' ') || msg.trim() || '(no error text)';
41
+ }
42
+ /** Append a timestamped install message to the service log (best-effort). */
43
+ function appendServiceLog(logPath, text) {
44
+ try {
45
+ fs.appendFileSync(logPath, `[${new Date().toISOString()}] apra-fleet install: ${text.replace(/\n/g, '\r\n')}\r\n`);
46
+ }
47
+ catch { /* best-effort */ }
48
+ }
49
+ function indent(text, by = ' ') {
50
+ return text.split('\n').map(l => by + l).join('\n');
51
+ }
52
+ function defaultSpawnDetached(cmd, args, verbatim = false) {
53
+ const child = spawn(cmd, args, { detached: true, stdio: 'ignore', windowsHide: true, windowsVerbatimArguments: verbatim });
54
+ child.unref();
55
+ }
56
+ /** Decode schtasks output (UTF-16 with BOM, or a single-byte codepage). */
57
+ function decodeSchtasks(raw) {
58
+ const text = typeof raw === 'string' ? raw
59
+ : raw.toString(raw[0] === 0xff && raw[1] === 0xfe ? 'utf16le' : 'utf8');
60
+ return text.replace(/\u0000/g, '');
61
+ }
62
+ /**
63
+ * Whether a task's XML definition is enabled. Task Scheduler's
64
+ * <Settings><Enabled> defaults to true when absent; XML tag names are not
65
+ * localized (unlike the CSV/LIST status text).
66
+ */
67
+ export function taskXmlEnabled(raw) {
68
+ const settings = /<Settings>([\s\S]*?)<\/Settings>/i.exec(decodeSchtasks(raw));
69
+ if (!settings)
70
+ return true;
71
+ const m = /<Enabled>\s*(true|false)\s*<\/Enabled>/i.exec(settings[1]);
72
+ return m ? m[1].toLowerCase() === 'true' : true;
73
+ }
9
74
  function normalizeTaskPath(p) {
10
75
  return p.replace(/"/g, '').replace(/\//g, '\\').trim().toLowerCase();
11
76
  }
@@ -15,69 +80,555 @@ function normalizeTaskPath(p) {
15
80
  * not localized, unlike schtasks' human-readable output.
16
81
  */
17
82
  export function taskXmlCommand(raw) {
18
- const decoded = typeof raw === 'string' ? raw
19
- : raw.toString(raw[0] === 0xff && raw[1] === 0xfe ? 'utf16le' : 'utf8');
20
- const text = decoded.replace(/\u0000/g, '');
21
- const m = /<Command>([\s\S]*?)<\/Command>/i.exec(text);
22
- return m ? m[1].trim() : null;
83
+ const m = /<Command>([\s\S]*?)<\/Command>/i.exec(decodeSchtasks(raw));
84
+ return m ? xmlUnescape(m[1].trim()) : null;
85
+ }
86
+ /** Escape a value for an XML text node (every interpolated value goes through this). */
87
+ export function xmlEscape(s) {
88
+ return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
89
+ .replace(/"/g, '&quot;').replace(/'/g, '&apos;');
90
+ }
91
+ function xmlUnescape(s) {
92
+ return s.replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"')
93
+ .replace(/&apos;/g, "'").replace(/&amp;/g, '&');
94
+ }
95
+ /**
96
+ * DOMAIN\user of the current account, read from the process token (whoami),
97
+ * never from env USERDOMAIN (WORKGROUP under Win32-OpenSSH on a workgroup
98
+ * machine) and never by shell expansion. A standard user may only register a
99
+ * logon trigger scoped to THEIR OWN account -- an unscoped LogonTrigger means
100
+ * "any user" and needs elevation (verified in a Windows Sandbox spike, Win10 19041).
101
+ */
102
+ export function resolveTaskUserId(whoami = () => decodeSchtasks(quietExec('whoami', []))) {
103
+ return currentWindowsUser(whoami);
104
+ }
105
+ /** Local wall-clock time as Task Scheduler's StartBoundary (no zone = local). */
106
+ export function localStartBoundary(d) {
107
+ const p = (n) => String(n).padStart(2, '0');
108
+ return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}T${p(d.getHours())}:${p(d.getMinutes())}:00`;
109
+ }
110
+ export function repeatMinutesFrom(env) {
111
+ const n = parseInt(env[REPEAT_MINUTES_ENV] ?? '', 10);
112
+ return Number.isFinite(n) && n >= 1 && n <= 1440 ? n : DEFAULT_REPEAT_MINUTES;
113
+ }
114
+ /**
115
+ * The service wrapper (.bat): sets the service-launch marker, makes sure the
116
+ * log dir exists (a deleted data dir must not make every revive fail the
117
+ * `>>` redirect before the server even starts), then runs the server with
118
+ * output appended to the log. Its exit code is the server's.
119
+ */
120
+ export function buildWrapperBat(binaryPath, args, logPath) {
121
+ const logDir = path.win32.dirname(logPath);
122
+ const quotedArgs = args.map(a => `"${a}"`).join(' ');
123
+ return [
124
+ '@echo off',
125
+ // The file is UTF-8; cmd reads each following line in the active code
126
+ // page, so switch to UTF-8 first -- otherwise a non-ASCII profile path
127
+ // (C:\Users\Jos<e-acute>) is garbled and the server never starts.
128
+ 'chcp 65001>nul',
129
+ `set ${SERVICE_ENV_MARKER}=1`,
130
+ `if not exist "${logDir}\\" mkdir "${logDir}"`,
131
+ `"${binaryPath}" ${quotedArgs} >> "${logPath}" 2>&1`,
132
+ ].join('\r\n');
133
+ }
134
+ /** The hidden launcher script that sits next to the wrapper. */
135
+ export function launcherPathFor(wrapperPath) {
136
+ // A Windows-style wrapper path (drive letter, UNC or backslashes) keeps win32
137
+ // semantics; a POSIX absolute path must stay POSIX or path.win32 turns it
138
+ // into a cwd-relative '\\tmp\\...' string.
139
+ const flavor = /^[A-Za-z]:|^\\\\|\\/.test(wrapperPath) ? path.win32 : path.posix;
140
+ return flavor.join(flavor.dirname(wrapperPath), 'apra-fleet-service.js');
141
+ }
142
+ /**
143
+ * JScript launcher run by wscript.exe: starts the wrapper with window style 0
144
+ * (no console on the user's desktop -- an InteractiveToken task running the
145
+ * .bat directly opens a visible cmd window on every start/revive, and closing
146
+ * it kills the server), waits for it, and returns its exit code so Task
147
+ * Scheduler's Last Result stays meaningful. The path is embedded as a JSON
148
+ * string literal (valid JScript: backslashes and quotes escaped).
149
+ */
150
+ export function buildLauncherJs(wrapperPath) {
151
+ return [
152
+ '// apra-fleet service launcher (generated by apra-fleet install): runs the',
153
+ '// service wrapper hidden and returns its exit code to Task Scheduler.',
154
+ "var shell = new ActiveXObject('WScript.Shell');",
155
+ `var wrapper = ${asciiJsString(wrapperPath)};`,
156
+ "WScript.Quit(shell.Run('\"' + wrapper + '\"', 0, true));",
157
+ '',
158
+ ].join('\r\n');
159
+ }
160
+ /**
161
+ * A JScript string literal that is pure ASCII: JSON escaping plus \uXXXX for
162
+ * every non-ASCII char. WSH decodes a .js file in the ANSI code page, so a
163
+ * UTF-8 path (C:\Users\Jos<e-acute>) made the launcher silently exit 0
164
+ * without running the wrapper; an ASCII file reads identically in every code
165
+ * page (chosen over UTF-16LE+BOM: no encoding dependency at all).
166
+ */
167
+ export function asciiJsString(s) {
168
+ return JSON.stringify(s).replace(/[\u007f-\uffff]/g, (c) => '\\u' + c.charCodeAt(0).toString(16).padStart(4, '0'));
169
+ }
170
+ /**
171
+ * Whether Windows Script Host runs here (it can be disabled by policy): runs a
172
+ * one-line probe script that must exit 42. Any other outcome -> no WSH.
173
+ */
174
+ export function defaultProbeWsh(env, dir) {
175
+ const probe = path.join(dir, 'apra-fleet-wsh-probe.js');
176
+ try {
177
+ fs.writeFileSync(probe, 'WScript.Quit(42);\r\n');
178
+ execFileSync(wscriptPath(env), ['//B', '//Nologo', '//E:JScript', probe], { stdio: 'pipe', windowsHide: true, timeout: 15_000 });
179
+ return false;
180
+ }
181
+ catch (err) {
182
+ return err.status === 42;
183
+ }
184
+ finally {
185
+ try {
186
+ fs.unlinkSync(probe);
187
+ }
188
+ catch { /* best-effort */ }
189
+ }
190
+ }
191
+ /** wscript.exe, resolved in JS from SystemRoot (no shell expansion). */
192
+ export function wscriptPath(env = process.env) {
193
+ return path.win32.join(env.SystemRoot || env.SYSTEMROOT || 'C:\\Windows', 'System32', 'wscript.exe');
194
+ }
195
+ /** wscript arguments for the launcher: batch mode, no logo, forced JScript engine. */
196
+ export function launcherArguments(launcherPath) {
197
+ return `//B //Nologo //E:JScript "${launcherPath}"`;
198
+ }
199
+ /** The <Arguments> of an existing task's XML definition, or null. */
200
+ export function taskXmlArguments(raw) {
201
+ const m = /<Arguments>([\s\S]*?)<\/Arguments>/i.exec(decodeSchtasks(raw));
202
+ return m ? xmlUnescape(m[1].trim()) : null;
203
+ }
204
+ /** Whether a task action is wscript.exe running `launcherPath` (our hidden launcher). */
205
+ function runsOurLauncher(command, args, launcherPath) {
206
+ return command !== null && /wscript\.exe"?$/i.test(command.trim()) && args !== null
207
+ && normalizeTaskPath(args).includes(normalizeTaskPath(launcherPath));
208
+ }
209
+ /** Whether the action is `wrapperPath` split at a space into Command + Arguments. */
210
+ export function runsSplitWrapper(command, args, wrapperPath) {
211
+ if (command === null || args === null || !args.trim())
212
+ return false;
213
+ return normalizeTaskPath(`${command} ${args}`) === normalizeTaskPath(wrapperPath)
214
+ && normalizeTaskPath(command) !== normalizeTaskPath(wrapperPath);
215
+ }
216
+ export function legacyTaskProblems(raw, opts) {
217
+ const xml = decodeSchtasks(raw);
218
+ const problems = [];
219
+ // No <Triggers> section (truncated/unreadable output): no claim, so a
220
+ // parse problem never produces upgrade guidance.
221
+ const triggersMatch = /<Triggers>([\s\S]*?)<\/Triggers>/i.exec(xml);
222
+ if (!triggersMatch)
223
+ return problems;
224
+ const triggers = triggersMatch[1];
225
+ const repeating = [...triggers.matchAll(/<(TimeTrigger|CalendarTrigger)\b[^>]*>([\s\S]*?)<\/\1>/gi)]
226
+ .some(m => /<Repetition>[\s\S]*?<Interval>\s*P[^<]*<\/Interval>/i.test(m[2]));
227
+ if (!repeating)
228
+ problems.push('no-revive');
229
+ const command = taskXmlCommand(xml);
230
+ const args = taskXmlArguments(xml);
231
+ const split = !!opts.wrapperPath && runsSplitWrapper(command, args, opts.wrapperPath);
232
+ // A split task never starts the server, so it has no console to speak of.
233
+ if (!split && opts.launcherExpected && !runsOurLauncher(command, args, opts.launcherPath)) {
234
+ problems.push('visible-console');
235
+ }
236
+ if (split)
237
+ problems.push('split-path');
238
+ const logonTriggers = [...triggers.matchAll(/<LogonTrigger\b[^>]*>([\s\S]*?)<\/LogonTrigger>|<LogonTrigger\b[^>]*\/>/gi)];
239
+ if (logonTriggers.some(m => !/<UserId>\s*\S[\s\S]*?<\/UserId>/i.test(m[1] ?? '')))
240
+ problems.push('elevated');
241
+ return problems;
242
+ }
243
+ const LEGACY_PROBLEM_TEXT = {
244
+ 'no-revive': 'no automatic revive after a crash',
245
+ 'visible-console': 'the server runs in a visible console window',
246
+ 'split-path': 'the task command is split at a space in the install path, so the server does not start',
247
+ 'elevated': "'apra-fleet stop' cannot disable the task",
248
+ };
249
+ /** Short form for apra-fleet status: "legacy task (upgrade needed: ...)". */
250
+ export function legacyTaskDetail(problems) {
251
+ return `legacy task (upgrade needed: ${problems.map(p => LEGACY_PROBLEM_TEXT[p]).join('; ')})`;
252
+ }
253
+ /**
254
+ * The exact manual fix, shared by install, status and stop. The elevated
255
+ * delete is only needed for an elevated-owned task ('elevated'); a user-owned
256
+ * old-form task is replaced by a plain re-install. apra-fleet never runs
257
+ * anything elevated itself and never needs an elevated install. --force: the
258
+ * server the old task started is normally still running, and install refuses
259
+ * to replace a running server without it.
260
+ */
261
+ export function legacyTaskFix(problems, execPath = process.execPath) {
262
+ const install = upgradeCommandLines(execPath).map(l => ` ${l}`);
263
+ if (!problems.includes('elevated')) {
264
+ return ['To upgrade it, run from a normal prompt:', ...install].join('\n');
265
+ }
266
+ return [
267
+ 'To upgrade it, run once from an elevated prompt (Run as administrator):',
268
+ ` schtasks /delete /tn ${WINDOWS_TASK_NAME} /f`,
269
+ 'then, from a normal prompt (do not run the install itself elevated):',
270
+ ...install,
271
+ ].join('\n');
272
+ }
273
+ /**
274
+ * `install --force` as a command that works where this runs. A standalone
275
+ * install does not put apra-fleet on PATH: the running installer names its
276
+ * own path (like the running-server refusal); the installed binary (status,
277
+ * stop) points at the downloaded installer; node (npm global/dev) has
278
+ * apra-fleet on PATH.
279
+ */
280
+ export function upgradeCommandLines(execPath) {
281
+ const base = path.win32.basename(execPath).toLowerCase();
282
+ if (base === 'node.exe' || base === 'node')
283
+ return ['apra-fleet install --force'];
284
+ if (path.win32.resolve(execPath).toLowerCase() === path.win32.resolve(BIN_DIR, 'apra-fleet.exe').toLowerCase()) {
285
+ return ['<the apra-fleet installer .exe you downloaded> install --force'];
286
+ }
287
+ return selfInvocationLines({ platform: 'win32', execPath, sea: true, args: ['install', '--force'] });
288
+ }
289
+ /** Full actionable guidance: what is missing and the exact fix. */
290
+ export function legacyTaskGuidance(problems) {
291
+ const intro = problems.includes('elevated')
292
+ ? [`The ${WINDOWS_TASK_NAME} scheduled task was registered by an older apra-fleet from an elevated prompt,`,
293
+ 'so it cannot be replaced from a normal shell and is still in use. Missing:']
294
+ : [`The ${WINDOWS_TASK_NAME} scheduled task was registered by an older apra-fleet and is still in use. Missing:`];
295
+ return [
296
+ ...intro,
297
+ ...problems.map(p => ` - ${LEGACY_PROBLEM_TEXT[p]}`),
298
+ legacyTaskFix(problems),
299
+ ].join('\n');
300
+ }
301
+ /**
302
+ * The ApraFleet task definition (GitHub #585 recovery). User-level only:
303
+ * - LogonTrigger scoped to the current user (the only form a standard user
304
+ * may register);
305
+ * - a TimeTrigger repeating every N minutes, indefinitely, which revives a
306
+ * server that was killed or crashed. Task Scheduler's RestartOnFailure is
307
+ * deliberately NOT used: it never fires for a non-zero exit or a killed
308
+ * process (only for launch failures);
309
+ * - MultipleInstancesPolicy IgnoreNew makes the trigger a no-op while the
310
+ * server runs; ExecutionTimeLimit PT0S = no time limit;
311
+ * - InteractiveToken + LeastPrivilege: runs as the logged-on user, never
312
+ * elevated, never as a system account.
313
+ */
314
+ export function buildTaskXml(p) {
315
+ const user = xmlEscape(p.userId);
316
+ return [
317
+ '<?xml version="1.0" encoding="UTF-16"?>',
318
+ '<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">',
319
+ ' <RegistrationInfo>',
320
+ ' <Description>Apra Fleet MCP server (per-user). Managed by apra-fleet install/start/stop/uninstall.</Description>',
321
+ ' </RegistrationInfo>',
322
+ ' <Triggers>',
323
+ ' <LogonTrigger>',
324
+ ' <Enabled>true</Enabled>',
325
+ ` <UserId>${user}</UserId>`,
326
+ ' </LogonTrigger>',
327
+ ' <TimeTrigger>',
328
+ ' <Repetition>',
329
+ ` <Interval>PT${p.repeatMinutes}M</Interval>`,
330
+ ' <StopAtDurationEnd>false</StopAtDurationEnd>',
331
+ ' </Repetition>',
332
+ ` <StartBoundary>${xmlEscape(p.startBoundary)}</StartBoundary>`,
333
+ ' <Enabled>true</Enabled>',
334
+ ' </TimeTrigger>',
335
+ ' </Triggers>',
336
+ ' <Principals>',
337
+ ' <Principal id="Author">',
338
+ ` <UserId>${user}</UserId>`,
339
+ ' <LogonType>InteractiveToken</LogonType>',
340
+ ' <RunLevel>LeastPrivilege</RunLevel>',
341
+ ' </Principal>',
342
+ ' </Principals>',
343
+ ' <Settings>',
344
+ ' <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>',
345
+ ' <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>',
346
+ ' <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>',
347
+ ' <AllowHardTerminate>true</AllowHardTerminate>',
348
+ ' <StartWhenAvailable>true</StartWhenAvailable>',
349
+ ' <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>',
350
+ ' <IdleSettings>',
351
+ ' <StopOnIdleEnd>false</StopOnIdleEnd>',
352
+ ' <RestartOnIdle>false</RestartOnIdle>',
353
+ ' </IdleSettings>',
354
+ ' <AllowStartOnDemand>true</AllowStartOnDemand>',
355
+ ' <Enabled>true</Enabled>',
356
+ ' <Hidden>false</Hidden>',
357
+ ' <RunOnlyIfIdle>false</RunOnlyIfIdle>',
358
+ ' <WakeToRun>false</WakeToRun>',
359
+ ' <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>',
360
+ ' <Priority>7</Priority>',
361
+ ' </Settings>',
362
+ ' <Actions Context="Author">',
363
+ ' <Exec>',
364
+ ` <Command>${xmlEscape(p.command)}</Command>`,
365
+ ...(p.arguments ? [` <Arguments>${xmlEscape(p.arguments)}</Arguments>`] : []),
366
+ ' </Exec>',
367
+ ' </Actions>',
368
+ '</Task>',
369
+ '',
370
+ ].join('\r\n');
371
+ }
372
+ /** UTF-16LE with BOM -- what schtasks /xml expects for a UTF-16 declaration. */
373
+ export function encodeTaskXml(xml) {
374
+ return Buffer.concat([Buffer.from([0xff, 0xfe]), Buffer.from(xml, 'utf16le')]);
23
375
  }
24
376
  export class WindowsServiceManager {
25
377
  runSchtasks;
26
378
  wrapperPath;
27
379
  reusedExistingTask = false;
28
- constructor(runSchtasks = defaultSchtasksRunner, wrapperPath = WRAPPER_PATH) {
380
+ runReg;
381
+ env;
382
+ now;
383
+ whoami;
384
+ spawnDetached;
385
+ probeWsh;
386
+ stoppedByUser;
387
+ interactive;
388
+ noticePath;
389
+ constructor(runSchtasks = defaultSchtasksRunner, wrapperPath = WRAPPER_PATH, opts = {}) {
29
390
  this.runSchtasks = runSchtasks;
30
391
  this.wrapperPath = wrapperPath;
392
+ this.runReg = opts.runReg ?? defaultRegRunner;
393
+ this.env = opts.env ?? process.env;
394
+ this.now = opts.now ?? (() => new Date());
395
+ this.whoami = opts.whoami;
396
+ this.spawnDetached = opts.spawnDetached ?? defaultSpawnDetached;
397
+ this.probeWsh = opts.probeWsh ?? defaultProbeWsh;
398
+ this.stoppedByUser = opts.stoppedByUser ?? (() => readStoppedMarker() !== null);
399
+ this.interactive = opts.interactive ?? (() => !!process.stdout.isTTY);
400
+ this.noticePath = opts.noticePath ?? SERVICE_NOTICE_PATH;
31
401
  }
32
402
  async register(binaryPath, args, logPath) {
33
403
  this.reusedExistingTask = false;
34
404
  // The wrapper is rewritten BEFORE /create so that a reused task (below)
35
405
  // also launches the new binary.
36
406
  fs.mkdirSync(path.dirname(this.wrapperPath), { recursive: true });
37
- const quotedArgs = args.map(a => `"${a}"`).join(' ');
38
- const lines = ['@echo off', `"${binaryPath}" ${quotedArgs} >> "${logPath}" 2>&1`];
39
- fs.writeFileSync(this.wrapperPath, lines.join('\r\n'), 'utf8');
407
+ // The wrapper's >> redirect fails (exit 1, nothing logged) when the log
408
+ // dir is missing; create it now -- the wrapper also re-creates it.
40
409
  try {
41
- this.runSchtasks([
42
- '/create', '/tn', WINDOWS_TASK_NAME,
43
- '/tr', this.wrapperPath,
44
- '/sc', 'onlogon', '/rl', 'limited', '/f',
45
- ]);
46
- return 'created';
410
+ fs.mkdirSync(path.dirname(logPath), { recursive: true });
47
411
  }
48
- catch (createErr) {
49
- // Any /create failure (typically "Access is denied" -- localized, so not
50
- // matched -- when the existing task was created elevated): reuse the
51
- // existing task only if it already runs our wrapper.
52
- const createMsg = createErr.message;
53
- let command;
412
+ catch { /* the wrapper retries */ }
413
+ fs.writeFileSync(this.wrapperPath, buildWrapperBat(binaryPath, args, logPath), 'utf8');
414
+ const launcherPath = launcherPathFor(this.wrapperPath);
415
+ fs.writeFileSync(launcherPath, buildLauncherJs(this.wrapperPath), 'utf8');
416
+ // S4: Windows Script Host can be disabled by policy; then the hidden
417
+ // launcher never runs. Fall back to running the .bat directly (a visible
418
+ // console window) and say so.
419
+ const hidden = this.probeWsh(this.env, path.dirname(this.wrapperPath));
420
+ // Applied only once we know what will launch the server: a task/Run entry
421
+ // registered for the .bat must leave no launcher behind (start() in
422
+ // Run-entry mode prefers it), but a reused task that already runs wscript +
423
+ // our launcher keeps it -- the probe can give a false negative (timeout
424
+ // under slow AV, failed probe-file write).
425
+ const visibleFallback = () => {
426
+ try {
427
+ fs.unlinkSync(launcherPath);
428
+ }
429
+ catch { /* absent */ }
430
+ console.warn(' Windows Script Host is unavailable, so the server cannot be launched hidden: it will run in a ' +
431
+ 'visible console window. Do not close that window (closing it stops the server).');
432
+ };
433
+ const runValue = hidden ? `"${wscriptPath(this.env)}" ${launcherArguments(launcherPath)}` : `"${this.wrapperPath}"`;
434
+ const xmlPath = path.join(path.dirname(this.wrapperPath), 'apra-fleet-task.xml');
435
+ const xml = buildTaskXml({
436
+ command: hidden ? wscriptPath(this.env) : this.wrapperPath,
437
+ arguments: hidden ? launcherArguments(launcherPath) : undefined,
438
+ userId: resolveTaskUserId(this.whoami),
439
+ startBoundary: localStartBoundary(this.now()),
440
+ repeatMinutes: repeatMinutesFrom(this.env),
441
+ });
442
+ /** Registers the task from the XML; null on success, else the error message. */
443
+ const tryCreate = () => {
54
444
  try {
55
- command = taskXmlCommand(this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME, '/xml']));
445
+ fs.writeFileSync(xmlPath, encodeTaskXml(xml));
446
+ this.runSchtasks(['/create', '/tn', WINDOWS_TASK_NAME, '/xml', xmlPath, '/f']);
447
+ return null;
448
+ }
449
+ catch (createErr) {
450
+ return createErr.message;
451
+ }
452
+ finally {
453
+ try {
454
+ fs.unlinkSync(xmlPath);
455
+ }
456
+ catch { /* best-effort */ }
56
457
  }
57
- catch {
58
- throw new Error(`schtasks /create failed and no existing ${WINDOWS_TASK_NAME} task was found: ${createMsg}`);
458
+ };
459
+ const created = () => {
460
+ // A task now covers logon autostart: drop a Run-key fallback left by an
461
+ // earlier install so the server is not launched twice at logon.
462
+ this.deleteRunKey();
463
+ clearServiceNotice(this.noticePath);
464
+ if (!hidden)
465
+ visibleFallback();
466
+ return 'created';
467
+ };
468
+ const createMsg = tryCreate();
469
+ if (createMsg === null)
470
+ return created();
471
+ // /create failed (typically "Access is denied" -- localized, so not
472
+ // matched -- when the existing task was created elevated): reuse the
473
+ // existing task only if it already runs our wrapper.
474
+ let command = null;
475
+ let taskArgs = null;
476
+ let existing = '';
477
+ let taskFound = false;
478
+ try {
479
+ existing = this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME, '/xml']);
480
+ command = taskXmlCommand(existing);
481
+ taskArgs = taskXmlArguments(existing);
482
+ taskFound = true;
483
+ }
484
+ catch { /* no task */ }
485
+ // Ours: the wrapper itself (tasks from earlier installs), the wrapper split
486
+ // at a space by 0.4.3's unquoted /tr (broken, so legacy), or wscript
487
+ // running our hidden launcher.
488
+ const runsWrapper = command !== null && normalizeTaskPath(command) === normalizeTaskPath(this.wrapperPath);
489
+ const runsSplit = runsSplitWrapper(command, taskArgs, this.wrapperPath);
490
+ const runsLauncher = runsOurLauncher(command, taskArgs, launcherPath);
491
+ /** Prints the manual fix for a legacy task /create could not replace, and persists it. */
492
+ const reportLegacy = (problems) => {
493
+ // /create was just refused, so this task cannot be disabled either.
494
+ // apra-fleet never elevates: the user gets the exact manual fix.
495
+ if (!problems.includes('elevated'))
496
+ problems.push('elevated');
497
+ const guidance = legacyTaskGuidance(problems);
498
+ console.warn(indent(guidance));
499
+ // A detached install (apra-fleet update) has no console: persist it
500
+ // for the next service verb (already shown when this one is
501
+ // interactive), and leave it in the service log.
502
+ writeServiceNotice(guidance, this.noticePath, new Date(), this.interactive());
503
+ appendServiceLog(logPath, guidance);
504
+ };
505
+ // A split task runs "C:\Users\John" and never starts the server: reusing
506
+ // it would leave no autostart. Report it and fall through to the HKCU Run
507
+ // entry below until the user replaces the task.
508
+ const splitTask = taskFound && runsSplit;
509
+ if (splitTask) {
510
+ const problems = legacyTaskProblems(existing, { launcherPath, launcherExpected: hidden, wrapperPath: this.wrapperPath });
511
+ if (!problems.includes('split-path'))
512
+ problems.push('split-path');
513
+ reportLegacy(problems);
514
+ }
515
+ else if (taskFound && (runsWrapper || runsLauncher)) {
516
+ const problems = legacyTaskProblems(existing, { launcherPath, launcherExpected: hidden, wrapperPath: this.wrapperPath });
517
+ if (problems.length > 0) {
518
+ reportLegacy(problems);
59
519
  }
60
- if (command === null || normalizeTaskPath(command) !== normalizeTaskPath(this.wrapperPath)) {
61
- throw new Error(`schtasks /create failed and the existing ${WINDOWS_TASK_NAME} task runs ${command ?? '(unknown)'}, ` +
62
- `not ${this.wrapperPath}: ${createMsg}`);
520
+ else {
521
+ clearServiceNotice(this.noticePath);
63
522
  }
64
523
  this.reusedExistingTask = true;
524
+ // A reused launcher task needs the launcher (written above); a reused
525
+ // .bat task runs visibly whatever the probe said.
526
+ if (runsWrapper && !hidden)
527
+ visibleFallback();
65
528
  return 'reused';
66
529
  }
530
+ if (taskFound && !splitTask) {
531
+ throw new Error(`schtasks /create failed and the existing ${WINDOWS_TASK_NAME} task runs ${command ?? '(unknown)'}, ` +
532
+ `not ${this.wrapperPath}: ${createMsg}`);
533
+ }
534
+ // Last resort: a per-user HKCU Run entry. Logon autostart only -- nothing
535
+ // revives a server that dies mid-session. Say WHY the task was refused:
536
+ // without it the fallback is undiagnosable.
537
+ console.warn(` schtasks /create failed: ${schtasksErrorReason(createMsg)}`);
538
+ if (!hidden)
539
+ visibleFallback();
540
+ if (!splitTask)
541
+ clearServiceNotice(this.noticePath);
542
+ try {
543
+ this.runReg(['add', RUN_KEY, '/v', RUN_VALUE, '/t', 'REG_SZ', '/d', runValue, '/f']);
544
+ }
545
+ catch (regErr) {
546
+ throw new Error(`schtasks /create failed and ${splitTask ? `the existing ${WINDOWS_TASK_NAME} task cannot start the server`
547
+ : `no existing ${WINDOWS_TASK_NAME} task was found`}: ${createMsg}; ` +
548
+ `the HKCU Run fallback also failed: ${regErr.message}`);
549
+ }
550
+ return 'run-key';
551
+ }
552
+ /** Problems of the installed task when it is a legacy one (empty: current or unreadable). */
553
+ installedLegacyProblems() {
554
+ try {
555
+ const raw = this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME, '/xml']);
556
+ return this.legacyProblemsOf(raw);
557
+ }
558
+ catch {
559
+ return [];
560
+ }
561
+ }
562
+ legacyProblemsOf(raw) {
563
+ const launcherPath = launcherPathFor(this.wrapperPath);
564
+ // Only OUR task (wrapper, split wrapper, or wscript + our launcher) gets
565
+ // upgrade advice: a foreign task named ApraFleet must not be told to
566
+ // delete itself.
567
+ const command = taskXmlCommand(raw);
568
+ const args = taskXmlArguments(raw);
569
+ const ours = (command !== null && normalizeTaskPath(command) === normalizeTaskPath(this.wrapperPath))
570
+ || runsSplitWrapper(command, args, this.wrapperPath)
571
+ || runsOurLauncher(command, args, launcherPath);
572
+ if (!ours)
573
+ return [];
574
+ // install keeps the launcher only when the task should use it (WSH works).
575
+ let launcherExpected = false;
576
+ try {
577
+ launcherExpected = fs.existsSync(launcherPath);
578
+ }
579
+ catch { /* treat as absent */ }
580
+ return legacyTaskProblems(raw, { launcherPath, launcherExpected, wrapperPath: this.wrapperPath });
67
581
  }
68
582
  async unregister() {
69
583
  try {
70
- execFileSync('schtasks', ['/delete', '/tn', WINDOWS_TASK_NAME, '/f']);
584
+ this.runSchtasks(['/delete', '/tn', WINDOWS_TASK_NAME, '/f']);
71
585
  }
72
586
  catch {
73
587
  // Tolerate task-not-found
74
588
  }
589
+ this.deleteRunKey();
590
+ clearServiceNotice(this.noticePath);
591
+ try {
592
+ fs.unlinkSync(this.wrapperPath);
593
+ }
594
+ catch { }
75
595
  try {
76
- fs.unlinkSync(WRAPPER_PATH);
596
+ fs.unlinkSync(launcherPathFor(this.wrapperPath));
77
597
  }
78
598
  catch { }
79
599
  }
80
600
  async start() {
601
+ // An explicit start is never skipped by the failed-start backoff.
602
+ clearServiceStartFailures();
603
+ const task = this.taskExists();
604
+ // A 0.4.3 task split at a space never starts the server: install then
605
+ // added the Run entry, which start must use instead of the task. (A task
606
+ // this install just reused is never a split one.)
607
+ if (!task || (!this.reusedExistingTask && this.runKeyExists()
608
+ && this.installedLegacyProblems().includes('split-path'))) {
609
+ if (this.runKeyExists()) {
610
+ // HKCU Run fallback: no task to run -- launch the way the Run entry
611
+ // does: the hidden launcher, or (no launcher) cmd with the wrapper
612
+ // quoted verbatim so a path with & or spaces stays one argument.
613
+ const launcher = launcherPathFor(this.wrapperPath);
614
+ if (fs.existsSync(launcher)) {
615
+ this.spawnDetached(wscriptPath(this.env), ['//B', '//Nologo', '//E:JScript', launcher]);
616
+ }
617
+ else {
618
+ this.spawnDetached('cmd.exe', ['/d', '/s', '/c', `""${this.wrapperPath}""`], true);
619
+ }
620
+ return;
621
+ }
622
+ throw new Error(`no ${WINDOWS_TASK_NAME} task or HKCU Run entry is registered -- run apra-fleet install`);
623
+ }
624
+ // A user stop disabled the task (so its revive trigger cannot undo the
625
+ // stop); starting re-enables it. A disabled task also refuses /run.
626
+ // Best-effort: a reused (elevated) task may refuse /change, and /run
627
+ // below then surfaces the real failure.
628
+ try {
629
+ this.runSchtasks(['/change', '/tn', WINDOWS_TASK_NAME, '/enable']);
630
+ }
631
+ catch { /* see above */ }
81
632
  if (this.reusedExistingTask) {
82
633
  // Reused task: run synchronously so a failure is surfaced, not swallowed.
83
634
  try {
@@ -88,44 +639,110 @@ export class WindowsServiceManager {
88
639
  }
89
640
  return;
90
641
  }
91
- // Use spawn (detached) so schtasks /run does not block the installer.
92
- // schtasks /run returns quickly but on some Windows versions it waits
93
- // for the launched process -- detaching avoids that.
94
- const { spawn } = await import('node:child_process');
95
- const child = spawn('schtasks', ['/run', '/tn', WINDOWS_TASK_NAME], {
96
- detached: true, stdio: 'ignore',
97
- });
98
- child.unref();
642
+ // Detached so schtasks /run does not block the installer (on some Windows
643
+ // versions it waits for the launched process).
644
+ this.spawnDetached('schtasks', ['/run', '/tn', WINDOWS_TASK_NAME]);
99
645
  }
100
646
  async stop() {
101
- await gracefulStopByServerJson((pid) => {
647
+ // Disable FIRST: the task's repeating trigger would otherwise relaunch the
648
+ // server within one interval, undoing a deliberate stop. start/install
649
+ // re-enable it.
650
+ if (this.taskExists()) {
102
651
  try {
103
- execFileSync('taskkill', ['/F', '/PID', String(pid)]);
652
+ this.runSchtasks(['/change', '/tn', WINDOWS_TASK_NAME, '/disable']);
653
+ }
654
+ catch (err) {
655
+ console.warn(`Could not disable the ${WINDOWS_TASK_NAME} task (${err.message.trim()}).`);
656
+ const problems = this.installedLegacyProblems();
657
+ if (problems.length > 0) {
658
+ // Disabling was just refused, whatever the XML says.
659
+ if (!problems.includes('elevated'))
660
+ problems.push('elevated');
661
+ console.warn(legacyTaskGuidance(problems));
662
+ }
663
+ // The stopped-by-user marker (written by apra-fleet stop) makes every
664
+ // service launch exit without starting the server.
665
+ console.warn("A stop made with 'apra-fleet stop' still holds: until 'apra-fleet start', every launch of the task " +
666
+ 'exits without starting the server.');
667
+ }
668
+ }
669
+ return gracefulStopByServerJson((pid) => {
670
+ try {
671
+ quietExec('taskkill', ['/F', '/PID', String(pid)]);
104
672
  }
105
673
  catch { }
106
674
  });
107
675
  }
108
676
  async query() {
677
+ let out;
109
678
  try {
110
- const out = execFileSync('schtasks', ['/query', '/tn', WINDOWS_TASK_NAME, '/fo', 'csv', '/nh'], { encoding: 'utf8' });
111
- // CSV line: "TaskName","Next Run Time","Status"
112
- const line = out.trim().split(/\r?\n/)[0] ?? '';
113
- const cols = line.split('","');
114
- const status = (cols[2] ?? '').replace(/"/g, '').trim();
115
- return { installed: true, running: status === 'Running' };
679
+ out = decodeSchtasks(this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME, '/fo', 'csv', '/nh']));
116
680
  }
117
681
  catch {
682
+ if (this.runKeyExists()) {
683
+ return {
684
+ installed: true, running: false, enabled: true,
685
+ detail: 'logon autostart via HKCU Run -- no automatic restart; re-run apra-fleet install to retry the task',
686
+ };
687
+ }
118
688
  return { installed: false, running: false };
119
689
  }
690
+ // CSV line: "TaskName","Next Run Time","Status"
691
+ const line = out.trim().split(/\r?\n/)[0] ?? '';
692
+ const cols = line.split('","');
693
+ const status = (cols[2] ?? '').replace(/"/g, '').trim();
694
+ // GitHub #585: report enabled, so status no longer shows every installed
695
+ // task as "installed (disabled)". If the XML query itself fails the task
696
+ // still exists (the CSV query just answered), so default to enabled.
697
+ let enabled = true;
698
+ let legacy = [];
699
+ try {
700
+ const raw = this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME, '/xml']);
701
+ enabled = taskXmlEnabled(raw);
702
+ legacy = this.legacyProblemsOf(raw);
703
+ }
704
+ catch { /* keep defaults */ }
705
+ const result = { installed: true, running: status === 'Running', enabled };
706
+ const details = [];
707
+ if (!enabled) {
708
+ details.push(this.stoppedByUser()
709
+ ? "stopped by user -- 'apra-fleet start' re-enables it"
710
+ : "task disabled outside apra-fleet -- 'apra-fleet start' re-enables it");
711
+ }
712
+ if (legacy.length > 0) {
713
+ details.push(legacyTaskDetail(legacy));
714
+ result.notice = legacyTaskFix(legacy);
715
+ }
716
+ if (details.length > 0)
717
+ result.detail = details.join('; ');
718
+ return result;
120
719
  }
121
720
  async isInstalled() {
721
+ return this.taskExists() || this.runKeyExists();
722
+ }
723
+ taskExists() {
724
+ try {
725
+ this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME]);
726
+ return true;
727
+ }
728
+ catch {
729
+ return false;
730
+ }
731
+ }
732
+ runKeyExists() {
122
733
  try {
123
- execFileSync('schtasks', ['/query', '/tn', WINDOWS_TASK_NAME]);
734
+ this.runReg(['query', RUN_KEY, '/v', RUN_VALUE]);
124
735
  return true;
125
736
  }
126
737
  catch {
127
738
  return false;
128
739
  }
129
740
  }
741
+ deleteRunKey() {
742
+ try {
743
+ this.runReg(['delete', RUN_KEY, '/v', RUN_VALUE, '/f']);
744
+ }
745
+ catch { /* absent */ }
746
+ }
130
747
  }
131
748
  //# sourceMappingURL=windows.js.map