@apralabs/apra-fleet 0.3.6 → 0.4.0

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 (569) hide show
  1. package/README.md +245 -257
  2. package/dist/agents/backlog-groomer.md +287 -0
  3. package/dist/agents/deployer.md +52 -11
  4. package/dist/agents/doer.md +32 -7
  5. package/dist/agents/integ-test-runner.md +151 -61
  6. package/dist/agents/plan-reviewer.md +74 -17
  7. package/dist/agents/planner.md +94 -14
  8. package/dist/agents/regression-test-runner.md +216 -0
  9. package/dist/agents/reviewer.md +21 -6
  10. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  11. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  12. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  13. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  14. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  15. package/dist/agents/schemas/reviewer-output.json +4 -0
  16. package/dist/cli/agent-transform.d.ts +1 -0
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +77 -0
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts +3 -0
  21. package/dist/cli/auth.d.ts.map +1 -1
  22. package/dist/cli/auth.js +181 -5
  23. package/dist/cli/auth.js.map +1 -1
  24. package/dist/cli/config.d.ts +5 -1
  25. package/dist/cli/config.d.ts.map +1 -1
  26. package/dist/cli/config.js +7 -1
  27. package/dist/cli/config.js.map +1 -1
  28. package/dist/cli/dolt-install.d.ts +91 -0
  29. package/dist/cli/dolt-install.d.ts.map +1 -0
  30. package/dist/cli/dolt-install.js +334 -0
  31. package/dist/cli/dolt-install.js.map +1 -0
  32. package/dist/cli/install-guard.d.ts +29 -0
  33. package/dist/cli/install-guard.d.ts.map +1 -0
  34. package/dist/cli/install-guard.js +153 -0
  35. package/dist/cli/install-guard.js.map +1 -0
  36. package/dist/cli/install.d.ts +44 -3
  37. package/dist/cli/install.d.ts.map +1 -1
  38. package/dist/cli/install.js +604 -108
  39. package/dist/cli/install.js.map +1 -1
  40. package/dist/cli/join.d.ts +12 -0
  41. package/dist/cli/join.d.ts.map +1 -0
  42. package/dist/cli/join.js +87 -0
  43. package/dist/cli/join.js.map +1 -0
  44. package/dist/cli/register-member.d.ts +2 -0
  45. package/dist/cli/register-member.d.ts.map +1 -0
  46. package/dist/cli/register-member.js +193 -0
  47. package/dist/cli/register-member.js.map +1 -0
  48. package/dist/cli/restart.d.ts +2 -0
  49. package/dist/cli/restart.d.ts.map +1 -0
  50. package/dist/cli/restart.js +7 -0
  51. package/dist/cli/restart.js.map +1 -0
  52. package/dist/cli/spoke.d.ts +35 -0
  53. package/dist/cli/spoke.d.ts.map +1 -0
  54. package/dist/cli/spoke.js +212 -0
  55. package/dist/cli/spoke.js.map +1 -0
  56. package/dist/cli/start.d.ts +2 -0
  57. package/dist/cli/start.d.ts.map +1 -0
  58. package/dist/cli/start.js +92 -0
  59. package/dist/cli/start.js.map +1 -0
  60. package/dist/cli/status.d.ts +2 -0
  61. package/dist/cli/status.d.ts.map +1 -0
  62. package/dist/cli/status.js +83 -0
  63. package/dist/cli/status.js.map +1 -0
  64. package/dist/cli/stop.d.ts +2 -0
  65. package/dist/cli/stop.d.ts.map +1 -0
  66. package/dist/cli/stop.js +51 -0
  67. package/dist/cli/stop.js.map +1 -0
  68. package/dist/cli/uninstall.d.ts.map +1 -1
  69. package/dist/cli/uninstall.js +109 -9
  70. package/dist/cli/uninstall.js.map +1 -1
  71. package/dist/cli/update.d.ts.map +1 -1
  72. package/dist/cli/update.js +10 -1
  73. package/dist/cli/update.js.map +1 -1
  74. package/dist/cli/workflow-assets.d.ts +37 -0
  75. package/dist/cli/workflow-assets.d.ts.map +1 -0
  76. package/dist/cli/workflow-assets.js +144 -0
  77. package/dist/cli/workflow-assets.js.map +1 -0
  78. package/dist/cli/workflow.d.ts +75 -0
  79. package/dist/cli/workflow.d.ts.map +1 -0
  80. package/dist/cli/workflow.js +397 -0
  81. package/dist/cli/workflow.js.map +1 -0
  82. package/dist/hub-service/activity.d.ts +30 -0
  83. package/dist/hub-service/activity.d.ts.map +1 -0
  84. package/dist/hub-service/activity.js +20 -0
  85. package/dist/hub-service/activity.js.map +1 -0
  86. package/dist/hub-service/audit-log.d.ts +19 -0
  87. package/dist/hub-service/audit-log.d.ts.map +1 -0
  88. package/dist/hub-service/audit-log.js +13 -0
  89. package/dist/hub-service/audit-log.js.map +1 -0
  90. package/dist/hub-service/db/pool.d.ts +19 -0
  91. package/dist/hub-service/db/pool.d.ts.map +1 -0
  92. package/dist/hub-service/db/pool.js +53 -0
  93. package/dist/hub-service/db/pool.js.map +1 -0
  94. package/dist/hub-service/enrollment.d.ts +29 -0
  95. package/dist/hub-service/enrollment.d.ts.map +1 -0
  96. package/dist/hub-service/enrollment.js +48 -0
  97. package/dist/hub-service/enrollment.js.map +1 -0
  98. package/dist/hub-service/envelope-routes.d.ts +46 -0
  99. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  100. package/dist/hub-service/envelope-routes.js +94 -0
  101. package/dist/hub-service/envelope-routes.js.map +1 -0
  102. package/dist/hub-service/handlers/installers.d.ts +14 -0
  103. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  104. package/dist/hub-service/handlers/installers.js +8 -0
  105. package/dist/hub-service/handlers/installers.js.map +1 -0
  106. package/dist/hub-service/http-server.d.ts +31 -0
  107. package/dist/hub-service/http-server.d.ts.map +1 -0
  108. package/dist/hub-service/http-server.js +711 -0
  109. package/dist/hub-service/http-server.js.map +1 -0
  110. package/dist/hub-service/hub-jwt.d.ts +30 -0
  111. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  112. package/dist/hub-service/hub-jwt.js +105 -0
  113. package/dist/hub-service/hub-jwt.js.map +1 -0
  114. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  115. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  116. package/dist/hub-service/jwt-revocation.js +18 -0
  117. package/dist/hub-service/jwt-revocation.js.map +1 -0
  118. package/dist/hub-service/machines.d.ts +16 -0
  119. package/dist/hub-service/machines.d.ts.map +1 -0
  120. package/dist/hub-service/machines.js +14 -0
  121. package/dist/hub-service/machines.js.map +1 -0
  122. package/dist/hub-service/main.d.ts +3 -0
  123. package/dist/hub-service/main.d.ts.map +1 -0
  124. package/dist/hub-service/main.js +64 -0
  125. package/dist/hub-service/main.js.map +1 -0
  126. package/dist/hub-service/member-tokens.d.ts +11 -0
  127. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  128. package/dist/hub-service/member-tokens.js +49 -0
  129. package/dist/hub-service/member-tokens.js.map +1 -0
  130. package/dist/hub-service/member-view.d.ts +20 -0
  131. package/dist/hub-service/member-view.d.ts.map +1 -0
  132. package/dist/hub-service/member-view.js +76 -0
  133. package/dist/hub-service/member-view.js.map +1 -0
  134. package/dist/hub-service/members.d.ts +44 -0
  135. package/dist/hub-service/members.d.ts.map +1 -0
  136. package/dist/hub-service/members.js +25 -0
  137. package/dist/hub-service/members.js.map +1 -0
  138. package/dist/hub-service/presence.d.ts +40 -0
  139. package/dist/hub-service/presence.d.ts.map +1 -0
  140. package/dist/hub-service/presence.js +44 -0
  141. package/dist/hub-service/presence.js.map +1 -0
  142. package/dist/hub-service/project-view.d.ts +12 -0
  143. package/dist/hub-service/project-view.d.ts.map +1 -0
  144. package/dist/hub-service/project-view.js +34 -0
  145. package/dist/hub-service/project-view.js.map +1 -0
  146. package/dist/hub-service/projects.d.ts +48 -0
  147. package/dist/hub-service/projects.d.ts.map +1 -0
  148. package/dist/hub-service/projects.js +80 -0
  149. package/dist/hub-service/projects.js.map +1 -0
  150. package/dist/hub-service/relay-queue.d.ts +115 -0
  151. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  152. package/dist/hub-service/relay-queue.js +148 -0
  153. package/dist/hub-service/relay-queue.js.map +1 -0
  154. package/dist/hub-service/session-jwt.d.ts +10 -0
  155. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  156. package/dist/hub-service/session-jwt.js +69 -0
  157. package/dist/hub-service/session-jwt.js.map +1 -0
  158. package/dist/hub-service/usage.d.ts +40 -0
  159. package/dist/hub-service/usage.d.ts.map +1 -0
  160. package/dist/hub-service/usage.js +25 -0
  161. package/dist/hub-service/usage.js.map +1 -0
  162. package/dist/hub-service/users.d.ts +56 -0
  163. package/dist/hub-service/users.d.ts.map +1 -0
  164. package/dist/hub-service/users.js +72 -0
  165. package/dist/hub-service/users.js.map +1 -0
  166. package/dist/hub-service/workspaces.d.ts +20 -0
  167. package/dist/hub-service/workspaces.d.ts.map +1 -0
  168. package/dist/hub-service/workspaces.js +10 -0
  169. package/dist/hub-service/workspaces.js.map +1 -0
  170. package/dist/index.js +179 -132
  171. package/dist/index.js.map +1 -1
  172. package/dist/os/linux.d.ts +13 -0
  173. package/dist/os/linux.d.ts.map +1 -1
  174. package/dist/os/linux.js +62 -3
  175. package/dist/os/linux.js.map +1 -1
  176. package/dist/os/os-commands.d.ts +10 -0
  177. package/dist/os/os-commands.d.ts.map +1 -1
  178. package/dist/os/windows.d.ts +1 -0
  179. package/dist/os/windows.d.ts.map +1 -1
  180. package/dist/os/windows.js +21 -1
  181. package/dist/os/windows.js.map +1 -1
  182. package/dist/paths.d.ts +23 -0
  183. package/dist/paths.d.ts.map +1 -1
  184. package/dist/paths.js +29 -0
  185. package/dist/paths.js.map +1 -1
  186. package/dist/providers/agy.d.ts +9 -2
  187. package/dist/providers/agy.d.ts.map +1 -1
  188. package/dist/providers/agy.js +127 -14
  189. package/dist/providers/agy.js.map +1 -1
  190. package/dist/providers/claude.d.ts +6 -2
  191. package/dist/providers/claude.d.ts.map +1 -1
  192. package/dist/providers/claude.js +248 -9
  193. package/dist/providers/claude.js.map +1 -1
  194. package/dist/providers/codex.d.ts +3 -2
  195. package/dist/providers/codex.d.ts.map +1 -1
  196. package/dist/providers/codex.js +7 -0
  197. package/dist/providers/codex.js.map +1 -1
  198. package/dist/providers/copilot.d.ts +3 -2
  199. package/dist/providers/copilot.d.ts.map +1 -1
  200. package/dist/providers/copilot.js +8 -1
  201. package/dist/providers/copilot.js.map +1 -1
  202. package/dist/providers/gemini.d.ts +3 -2
  203. package/dist/providers/gemini.d.ts.map +1 -1
  204. package/dist/providers/gemini.js +11 -1
  205. package/dist/providers/gemini.js.map +1 -1
  206. package/dist/providers/index.d.ts +1 -0
  207. package/dist/providers/index.d.ts.map +1 -1
  208. package/dist/providers/index.js +3 -0
  209. package/dist/providers/index.js.map +1 -1
  210. package/dist/providers/none.d.ts +51 -0
  211. package/dist/providers/none.d.ts.map +1 -0
  212. package/dist/providers/none.js +103 -0
  213. package/dist/providers/none.js.map +1 -0
  214. package/dist/providers/opencode.d.ts +4 -2
  215. package/dist/providers/opencode.d.ts.map +1 -1
  216. package/dist/providers/opencode.js +49 -0
  217. package/dist/providers/opencode.js.map +1 -1
  218. package/dist/providers/provider.d.ts +79 -1
  219. package/dist/providers/provider.d.ts.map +1 -1
  220. package/dist/providers/provider.js +10 -0
  221. package/dist/providers/provider.js.map +1 -1
  222. package/dist/services/agent-provisioner.d.ts +3 -3
  223. package/dist/services/agent-provisioner.d.ts.map +1 -1
  224. package/dist/services/agent-provisioner.js +12 -5
  225. package/dist/services/agent-provisioner.js.map +1 -1
  226. package/dist/services/auth-socket.d.ts.map +1 -1
  227. package/dist/services/auth-socket.js +2 -0
  228. package/dist/services/auth-socket.js.map +1 -1
  229. package/dist/services/budget-awareness.d.ts +130 -0
  230. package/dist/services/budget-awareness.d.ts.map +1 -0
  231. package/dist/services/budget-awareness.js +129 -0
  232. package/dist/services/budget-awareness.js.map +1 -0
  233. package/dist/services/cloud-sync.d.ts +35 -0
  234. package/dist/services/cloud-sync.d.ts.map +1 -0
  235. package/dist/services/cloud-sync.js +90 -0
  236. package/dist/services/cloud-sync.js.map +1 -0
  237. package/dist/services/context-admission.d.ts +82 -0
  238. package/dist/services/context-admission.d.ts.map +1 -0
  239. package/dist/services/context-admission.js +136 -0
  240. package/dist/services/context-admission.js.map +1 -0
  241. package/dist/services/event-bus.d.ts +27 -0
  242. package/dist/services/event-bus.d.ts.map +1 -0
  243. package/dist/services/event-bus.js +20 -0
  244. package/dist/services/event-bus.js.map +1 -0
  245. package/dist/services/file-chunker.d.ts +38 -0
  246. package/dist/services/file-chunker.d.ts.map +1 -0
  247. package/dist/services/file-chunker.js +63 -0
  248. package/dist/services/file-chunker.js.map +1 -0
  249. package/dist/services/file-transfer-relay.d.ts +55 -0
  250. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  251. package/dist/services/file-transfer-relay.js +115 -0
  252. package/dist/services/file-transfer-relay.js.map +1 -0
  253. package/dist/services/github-app.d.ts.map +1 -1
  254. package/dist/services/github-app.js +1 -0
  255. package/dist/services/github-app.js.map +1 -1
  256. package/dist/services/http-transport.d.ts +25 -0
  257. package/dist/services/http-transport.d.ts.map +1 -0
  258. package/dist/services/http-transport.js +371 -0
  259. package/dist/services/http-transport.js.map +1 -0
  260. package/dist/services/hub-client.d.ts +69 -0
  261. package/dist/services/hub-client.d.ts.map +1 -0
  262. package/dist/services/hub-client.js +217 -0
  263. package/dist/services/hub-client.js.map +1 -0
  264. package/dist/services/jwt.d.ts +17 -0
  265. package/dist/services/jwt.d.ts.map +1 -0
  266. package/dist/services/jwt.js +70 -0
  267. package/dist/services/jwt.js.map +1 -0
  268. package/dist/services/known-sessions.d.ts +8 -0
  269. package/dist/services/known-sessions.d.ts.map +1 -0
  270. package/dist/services/known-sessions.js +40 -0
  271. package/dist/services/known-sessions.js.map +1 -0
  272. package/dist/services/model-pricing.d.ts +36 -0
  273. package/dist/services/model-pricing.d.ts.map +1 -0
  274. package/dist/services/model-pricing.js +108 -0
  275. package/dist/services/model-pricing.js.map +1 -0
  276. package/dist/services/orphan-recovery.d.ts +56 -0
  277. package/dist/services/orphan-recovery.d.ts.map +1 -0
  278. package/dist/services/orphan-recovery.js +111 -0
  279. package/dist/services/orphan-recovery.js.map +1 -0
  280. package/dist/services/pending-responses.d.ts +23 -0
  281. package/dist/services/pending-responses.d.ts.map +1 -0
  282. package/dist/services/pending-responses.js +52 -0
  283. package/dist/services/pending-responses.js.map +1 -0
  284. package/dist/services/registry.d.ts +4 -1
  285. package/dist/services/registry.d.ts.map +1 -1
  286. package/dist/services/registry.js +3 -0
  287. package/dist/services/registry.js.map +1 -1
  288. package/dist/services/relay-context.d.ts +23 -0
  289. package/dist/services/relay-context.d.ts.map +1 -0
  290. package/dist/services/relay-context.js +8 -0
  291. package/dist/services/relay-context.js.map +1 -0
  292. package/dist/services/relay-executor.d.ts +68 -0
  293. package/dist/services/relay-executor.d.ts.map +1 -0
  294. package/dist/services/relay-executor.js +70 -0
  295. package/dist/services/relay-executor.js.map +1 -0
  296. package/dist/services/relay-request.d.ts +65 -0
  297. package/dist/services/relay-request.d.ts.map +1 -0
  298. package/dist/services/relay-request.js +129 -0
  299. package/dist/services/relay-request.js.map +1 -0
  300. package/dist/services/relay-strategy.d.ts +19 -0
  301. package/dist/services/relay-strategy.d.ts.map +1 -0
  302. package/dist/services/relay-strategy.js +111 -0
  303. package/dist/services/relay-strategy.js.map +1 -0
  304. package/dist/services/service-manager/index.d.ts +5 -0
  305. package/dist/services/service-manager/index.d.ts.map +1 -0
  306. package/dist/services/service-manager/index.js +66 -0
  307. package/dist/services/service-manager/index.js.map +1 -0
  308. package/dist/services/service-manager/linux.d.ts +10 -0
  309. package/dist/services/service-manager/linux.d.ts.map +1 -0
  310. package/dist/services/service-manager/linux.js +97 -0
  311. package/dist/services/service-manager/linux.js.map +1 -0
  312. package/dist/services/service-manager/macos.d.ts +10 -0
  313. package/dist/services/service-manager/macos.d.ts.map +1 -0
  314. package/dist/services/service-manager/macos.js +94 -0
  315. package/dist/services/service-manager/macos.js.map +1 -0
  316. package/dist/services/service-manager/types.d.ts +18 -0
  317. package/dist/services/service-manager/types.d.ts.map +1 -0
  318. package/dist/services/service-manager/types.js +5 -0
  319. package/dist/services/service-manager/types.js.map +1 -0
  320. package/dist/services/service-manager/windows.d.ts +10 -0
  321. package/dist/services/service-manager/windows.d.ts.map +1 -0
  322. package/dist/services/service-manager/windows.js +73 -0
  323. package/dist/services/service-manager/windows.js.map +1 -0
  324. package/dist/services/session-registry.d.ts +70 -0
  325. package/dist/services/session-registry.d.ts.map +1 -0
  326. package/dist/services/session-registry.js +91 -0
  327. package/dist/services/session-registry.js.map +1 -0
  328. package/dist/services/singleton.d.ts +15 -0
  329. package/dist/services/singleton.d.ts.map +1 -0
  330. package/dist/services/singleton.js +98 -0
  331. package/dist/services/singleton.js.map +1 -0
  332. package/dist/services/sprint-coordination.d.ts +168 -0
  333. package/dist/services/sprint-coordination.d.ts.map +1 -0
  334. package/dist/services/sprint-coordination.js +564 -0
  335. package/dist/services/sprint-coordination.js.map +1 -0
  336. package/dist/services/ssh.d.ts.map +1 -1
  337. package/dist/services/ssh.js +70 -3
  338. package/dist/services/ssh.js.map +1 -1
  339. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  340. package/dist/services/stall/log-path-resolver.js +8 -1
  341. package/dist/services/stall/log-path-resolver.js.map +1 -1
  342. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  343. package/dist/services/stall/stall-detector.js +39 -7
  344. package/dist/services/stall/stall-detector.js.map +1 -1
  345. package/dist/services/stall/stall-poller.d.ts +16 -0
  346. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  347. package/dist/services/stall/stall-poller.js +136 -18
  348. package/dist/services/stall/stall-poller.js.map +1 -1
  349. package/dist/services/strategy.d.ts.map +1 -1
  350. package/dist/services/strategy.js +55 -5
  351. package/dist/services/strategy.js.map +1 -1
  352. package/dist/services/substitution-engine.d.ts +20 -0
  353. package/dist/services/substitution-engine.d.ts.map +1 -0
  354. package/dist/services/substitution-engine.js +92 -0
  355. package/dist/services/substitution-engine.js.map +1 -0
  356. package/dist/services/task-cleanup.d.ts.map +1 -1
  357. package/dist/services/task-cleanup.js +1 -9
  358. package/dist/services/task-cleanup.js.map +1 -1
  359. package/dist/services/token-issuer.d.ts +47 -0
  360. package/dist/services/token-issuer.d.ts.map +1 -0
  361. package/dist/services/token-issuer.js +63 -0
  362. package/dist/services/token-issuer.js.map +1 -0
  363. package/dist/services/tool-registry.d.ts +3 -0
  364. package/dist/services/tool-registry.d.ts.map +1 -0
  365. package/dist/services/tool-registry.js +139 -0
  366. package/dist/services/tool-registry.js.map +1 -0
  367. package/dist/services/user-config.d.ts +14 -0
  368. package/dist/services/user-config.d.ts.map +1 -1
  369. package/dist/services/user-config.js +55 -0
  370. package/dist/services/user-config.js.map +1 -1
  371. package/dist/services/vcs/types.d.ts +44 -0
  372. package/dist/services/vcs/types.d.ts.map +1 -1
  373. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  374. package/dist/skills/pm/cost.md +3 -0
  375. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  376. package/dist/tools/check-status.d.ts.map +1 -1
  377. package/dist/tools/check-status.js +8 -2
  378. package/dist/tools/check-status.js.map +1 -1
  379. package/dist/tools/child-id-allocator.d.ts +45 -0
  380. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  381. package/dist/tools/child-id-allocator.js +62 -0
  382. package/dist/tools/child-id-allocator.js.map +1 -0
  383. package/dist/tools/cloud-control.d.ts +2 -2
  384. package/dist/tools/compose-permissions.d.ts +12 -4
  385. package/dist/tools/compose-permissions.d.ts.map +1 -1
  386. package/dist/tools/compose-permissions.js +55 -4
  387. package/dist/tools/compose-permissions.js.map +1 -1
  388. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  389. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  390. package/dist/tools/dolt-push-mutex.js +83 -0
  391. package/dist/tools/dolt-push-mutex.js.map +1 -0
  392. package/dist/tools/execute-command.d.ts +11 -1
  393. package/dist/tools/execute-command.d.ts.map +1 -1
  394. package/dist/tools/execute-command.js +22 -5
  395. package/dist/tools/execute-command.js.map +1 -1
  396. package/dist/tools/execute-prompt.d.ts +72 -12
  397. package/dist/tools/execute-prompt.d.ts.map +1 -1
  398. package/dist/tools/execute-prompt.js +962 -71
  399. package/dist/tools/execute-prompt.js.map +1 -1
  400. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  401. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  402. package/dist/tools/get-member-model-pricing.js +29 -0
  403. package/dist/tools/get-member-model-pricing.js.map +1 -0
  404. package/dist/tools/list-members.d.ts.map +1 -1
  405. package/dist/tools/list-members.js +39 -7
  406. package/dist/tools/list-members.js.map +1 -1
  407. package/dist/tools/member-detail.d.ts +1 -1
  408. package/dist/tools/member-detail.d.ts.map +1 -1
  409. package/dist/tools/member-detail.js +8 -2
  410. package/dist/tools/member-detail.js.map +1 -1
  411. package/dist/tools/member-reservation.d.ts +29 -0
  412. package/dist/tools/member-reservation.d.ts.map +1 -0
  413. package/dist/tools/member-reservation.js +71 -0
  414. package/dist/tools/member-reservation.js.map +1 -0
  415. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  416. package/dist/tools/provision-vcs-auth.js +1 -1
  417. package/dist/tools/provision-vcs-auth.js.map +1 -1
  418. package/dist/tools/register-member.d.ts +17 -5
  419. package/dist/tools/register-member.d.ts.map +1 -1
  420. package/dist/tools/register-member.js +144 -5
  421. package/dist/tools/register-member.js.map +1 -1
  422. package/dist/tools/remove-member.d.ts +1 -1
  423. package/dist/tools/report-status.d.ts +33 -0
  424. package/dist/tools/report-status.d.ts.map +1 -0
  425. package/dist/tools/report-status.js +44 -0
  426. package/dist/tools/report-status.js.map +1 -0
  427. package/dist/tools/respond-to-message.d.ts +21 -0
  428. package/dist/tools/respond-to-message.d.ts.map +1 -0
  429. package/dist/tools/respond-to-message.js +23 -0
  430. package/dist/tools/respond-to-message.js.map +1 -0
  431. package/dist/tools/send-files.d.ts +3 -0
  432. package/dist/tools/send-files.d.ts.map +1 -1
  433. package/dist/tools/send-files.js +88 -8
  434. package/dist/tools/send-files.js.map +1 -1
  435. package/dist/tools/send-message.d.ts +27 -0
  436. package/dist/tools/send-message.d.ts.map +1 -0
  437. package/dist/tools/send-message.js +46 -0
  438. package/dist/tools/send-message.js.map +1 -0
  439. package/dist/tools/shutdown-server.d.ts +2 -0
  440. package/dist/tools/shutdown-server.d.ts.map +1 -1
  441. package/dist/tools/shutdown-server.js +19 -0
  442. package/dist/tools/shutdown-server.js.map +1 -1
  443. package/dist/tools/update-member.d.ts +8 -8
  444. package/dist/tools/update-member.d.ts.map +1 -1
  445. package/dist/tools/update-member.js +11 -1
  446. package/dist/tools/update-member.js.map +1 -1
  447. package/dist/types.d.ts +15 -3
  448. package/dist/types.d.ts.map +1 -1
  449. package/dist/utils/agent-helpers.d.ts +2 -1
  450. package/dist/utils/agent-helpers.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.js +7 -2
  452. package/dist/utils/agent-helpers.js.map +1 -1
  453. package/dist/utils/pid-helpers.d.ts +15 -0
  454. package/dist/utils/pid-helpers.d.ts.map +1 -1
  455. package/dist/utils/pid-helpers.js +23 -0
  456. package/dist/utils/pid-helpers.js.map +1 -1
  457. package/dist/utils/process-utils.d.ts +3 -0
  458. package/dist/utils/process-utils.d.ts.map +1 -0
  459. package/dist/utils/process-utils.js +42 -0
  460. package/dist/utils/process-utils.js.map +1 -0
  461. package/dist/utils/prompt-errors.d.ts +2 -1
  462. package/dist/utils/prompt-errors.d.ts.map +1 -1
  463. package/dist/utils/prompt-errors.js +13 -3
  464. package/dist/utils/prompt-errors.js.map +1 -1
  465. package/dist/utils/workspace-trust.d.ts +24 -0
  466. package/dist/utils/workspace-trust.d.ts.map +1 -0
  467. package/dist/utils/workspace-trust.js +35 -0
  468. package/dist/utils/workspace-trust.js.map +1 -0
  469. package/dist/workflows/auto-sprint.js +450 -87
  470. package/package.json +35 -7
  471. package/packages/apra-fleet-client/package.json +26 -0
  472. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  473. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  474. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  475. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  476. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  477. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  478. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  479. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  506. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  507. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  514. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  515. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  516. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  517. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  518. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  519. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  520. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  521. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  525. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  526. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  530. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  531. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  532. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  533. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  534. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  535. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  536. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  542. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  543. package/packages/apra-fleet-se/package.json +28 -0
  544. package/packages/apra-fleet-se/workflow.json +1 -0
  545. package/packages/apra-fleet-workflow/package.json +30 -0
  546. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  547. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  548. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  549. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  550. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  551. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  552. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  553. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  554. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  555. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  556. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  557. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  558. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  559. package/scripts/agy-transcript-reader.js +1 -0
  560. package/scripts/fleet-statusline.sh +17 -13
  561. package/skills/fleet/SKILL.md +37 -2
  562. package/skills/fleet/beads.md +14 -7
  563. package/skills/fleet/permissions.md +50 -0
  564. package/skills/fleet/profiles/base-dev.json +1 -0
  565. package/skills/fleet/profiles/base-reviewer.json +1 -0
  566. package/skills/fleet/profiles/node.json +2 -2
  567. package/version.json +1 -1
  568. package/scripts/agy-settings-merge.js +0 -27
  569. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,72 @@
1
+ import fs from 'fs';
2
+ import path from 'path';
3
+
4
+ // =============================================================================
5
+ // apra-fleet-417.2.3 -- dolt-literal guard checker.
6
+ //
7
+ // Invariant under test: NO source line in a scanned file may issue a direct
8
+ // `bd dolt pull` or `bd dolt push` command -- every dolt sync call must go
9
+ // through ./dolt-sync.mjs (the single permitted dolt command surface,
10
+ // apra-fleet-417.2.1/417.2.2). This is a mechanical, line-based scan, not a
11
+ // call-site parse: dolt-sync.mjs itself legitimately builds these exact
12
+ // command strings (that IS the sync module), so this guard is only ever
13
+ // pointed at OTHER files (runner.js in production; a throwaway fixture in
14
+ // this file's own tests) -- it is not meant to be run against dolt-sync.mjs.
15
+ //
16
+ // Two carve-outs, mirroring how runner.js already talks about dolt sync
17
+ // without issuing it directly:
18
+ // - Full-line comments (a line whose trimmed text starts with `//`, `*` or
19
+ // `/*`) -- prose that merely MENTIONS `bd dolt pull`/`bd dolt push`
20
+ // (e.g. explaining what the sync module does) is not a violation.
21
+ // - `import`/`require` lines referencing the sync module (dolt-sync.mjs) --
22
+ // so a line like `import { doltPullBefore } from './dolt-sync.mjs'` is
23
+ // never itself flagged.
24
+ // Anything else -- a live command()/template-literal/string containing the
25
+ // literal substring -- is a violation: the sync module must be called by its
26
+ // exported entry points, never re-inlined.
27
+ // =============================================================================
28
+
29
+ const DOLT_LITERAL_RE = /\bbd dolt (pull|push)\b/;
30
+
31
+ function isCommentLine(text) {
32
+ const trimmed = text.trim();
33
+ return trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*');
34
+ }
35
+
36
+ function isSyncModuleReference(text) {
37
+ return /\b(import|require)\b/.test(text) && /dolt-sync(\.mjs)?/.test(text);
38
+ }
39
+
40
+ /**
41
+ * Scans `src` for direct `bd dolt pull` / `bd dolt push` literals, skipping
42
+ * full-line comments and import/require lines that reference the sync
43
+ * module. Returns an array of { line, text } for every violating line.
44
+ */
45
+ export function findDoltLiteralViolations(src) {
46
+ const lines = src.split('\n');
47
+ const violations = [];
48
+ for (let i = 0; i < lines.length; i++) {
49
+ const text = lines[i];
50
+ if (!DOLT_LITERAL_RE.test(text)) continue;
51
+ if (isCommentLine(text)) continue;
52
+ if (isSyncModuleReference(text)) continue;
53
+ violations.push({ line: i + 1, text: text.trim() });
54
+ }
55
+ return violations;
56
+ }
57
+
58
+ /**
59
+ * Reads and scans the source file at `filePath`, returning { violations },
60
+ * each entry formatted as a human-readable message naming the offending
61
+ * file:line and pointing at ./dolt-sync.mjs as the required entry point.
62
+ */
63
+ export function checkDoltLiteralPath(filePath) {
64
+ const src = fs.readFileSync(filePath, 'utf8');
65
+ const fileLabel = path.basename(filePath);
66
+ const violations = findDoltLiteralViolations(src).map(({ line, text }) =>
67
+ `${fileLabel}:${line} issues a direct 'bd dolt pull'/'bd dolt push' literal ("${text}") -- ` +
68
+ `route it through ./dolt-sync.mjs (DoltSync.syncBefore/syncAfter/status) instead, the single ` +
69
+ `permitted dolt command surface (apra-fleet-417.2.1/417.2.2).`
70
+ );
71
+ return { violations };
72
+ }
@@ -0,0 +1,339 @@
1
+ // apra-fleet-eft.9.5 (Plan 3.4 -- Dolt conflict recovery ladder, Path B).
2
+ //
3
+ // Path B is the FALLBACK dolt recovery for a wedged clone that Path A
4
+ // (dolt-recovery.mjs, apra-fleet-eft.9.4) refuses to touch: either the
5
+ // conflict shape failed one of Path A's two deterministic gates
6
+ // (multi-row, or a table outside the allowlist), or a genuine operational
7
+ // failure made resolve-in-place unsafe. Where Path A resolves the conflict
8
+ // in place with zero data loss, Path B is deliberately more destructive but
9
+ // simpler and more robust: DISCARD the wedged clone's local dolt state
10
+ // entirely and re-bootstrap fresh from the shared remote, then replay back
11
+ // in the ONE local mutation that mattered (the doer streak's own write that
12
+ // triggered the D-push in the first place). Everything else the loser
13
+ // clone had locally that never made it to the remote is discarded on
14
+ // purpose -- by construction (single-writer token passing, one streak
15
+ // between D-pull and D-push) that is always small, and it is enumerated in
16
+ // the log rather than silently dropped.
17
+ //
18
+ // -----------------------------------------------------------------------------
19
+ // The VERIFIED runbook (implemented exactly, in this order):
20
+ //
21
+ // 1. Guard (Windows gotcha #1): assert config.yaml exists and still
22
+ // carries a non-empty `sync.remote` BEFORE touching anything. On
23
+ // Windows, `bd bootstrap` derives a broken `git+C:/...` URL when
24
+ // sync.remote is absent from config.yaml -- config.yaml is therefore
25
+ // the one file this recovery NEVER removes, but if it already lacks
26
+ // sync.remote the same breakage would occur regardless of how careful
27
+ // we are, so this is checked and escalated (never silently proceeded
28
+ // past) rather than discovered after the fact.
29
+ // 2. Enumerate: log every piece of local-only state about to be
30
+ // discarded (opts.listLocalState), so the loser clone's other
31
+ // unsynced writes are never silently dropped from the record even
32
+ // though they are not recovered.
33
+ // 3. Discard: remove `.beads/embeddeddolt`, `.beads/metadata.json`,
34
+ // `.beads/backup` -- KEEPING config.yaml untouched.
35
+ // 4. Re-bootstrap: `BD_NON_INTERACTIVE=1 bd bootstrap --yes` against the
36
+ // now-clean `.beads` dir (config.yaml + its sync.remote still in
37
+ // place is what lets bootstrap re-clone the shared remote correctly).
38
+ // 5. Windows gotcha #2 guard: if that bootstrap attempt fails because a
39
+ // leftover EMPTY database is still on disk (isBootstrapEmptyDbFailure
40
+ // classifies this from bootstrap's own output text), remove
41
+ // `.beads/embeddeddolt` again and retry bootstrap exactly ONCE more --
42
+ // bounded, never an unbounded retry loop.
43
+ // 6. Replay: re-issue the ONE pending mutation (opts.pendingMutation) --
44
+ // the loser clone's own local write -- against the freshly bootstrapped
45
+ // clone, so it is not lost even though everything else local was
46
+ // discarded in step 3.
47
+ // 7. Republish: `bd dolt push` the replayed mutation back to the shared
48
+ // remote.
49
+ //
50
+ // Any genuine operational failure (guard failure, bootstrap failure that
51
+ // survives the one bounded retry, a failed mutation replay, or a push still
52
+ // rejected) throws a typed DoltSyncError/DoltDivergedError so the caller
53
+ // (Tier 2 escalation, apra-fleet-eft.9.6) can route it onward -- Path B never
54
+ // silently swallows a failure the way it deliberately discards non-critical
55
+ // local state.
56
+ // =============================================================================
57
+
58
+ import { DoltDivergedError, DoltSyncError } from './errors.mjs';
59
+
60
+ /** The three paths Path B ALWAYS removes (in this order), never anything
61
+ * else. `.beads/config.yaml` (with its `sync.remote`) is deliberately never
62
+ * in this list -- see Windows gotcha #1 in the module doc above. */
63
+ export const DEFAULT_PATH_B_REMOVE_PATHS = [
64
+ '.beads/embeddeddolt',
65
+ '.beads/metadata.json',
66
+ '.beads/backup',
67
+ ];
68
+
69
+ /** The one path this recovery must NEVER remove. */
70
+ export const DEFAULT_CONFIG_PATH = '.beads/config.yaml';
71
+
72
+ /** Default local-backup dir enumerated (not removed by this module directly
73
+ * -- it is one of DEFAULT_PATH_B_REMOVE_PATHS -- but its contents are
74
+ * listed BEFORE removal so the discard is enumerated, not silent). */
75
+ export const DEFAULT_BACKUP_DIR = '.beads/backup';
76
+
77
+ /** Default embedded dolt data dir, re-removed on the bounded Windows
78
+ * gotcha #2 retry (a leftover empty DB there makes the first bootstrap
79
+ * retry fail until it is removed again). */
80
+ export const DEFAULT_EMBEDDED_DATA_DIR = '.beads/embeddeddolt';
81
+
82
+ /**
83
+ * Substrings in a failed `bd bootstrap` attempt that mark it as the verified
84
+ * Windows gotcha #2: a leftover EMPTY database left on disk (e.g. by a
85
+ * partially-completed prior bootstrap) makes the retry fail until
86
+ * `.beads/embeddeddolt` is removed again. Distinguished from any other
87
+ * bootstrap failure, which is NOT retried and instead thrown.
88
+ * @type {RegExp[]}
89
+ */
90
+ const BOOTSTRAP_EMPTY_DB_PATTERNS = [
91
+ /database already exists/i,
92
+ /directory not empty/i,
93
+ /already initiali[sz]ed/i,
94
+ /empty (database|db)/i,
95
+ /existing (dolt )?data ?dir/i,
96
+ ];
97
+
98
+ /**
99
+ * Does this `bd bootstrap` failure output describe the verified Windows
100
+ * gotcha #2 (leftover empty DB), as opposed to any other bootstrap failure
101
+ * that must not be blindly retried?
102
+ *
103
+ * @param {string} output
104
+ * @returns {boolean}
105
+ */
106
+ export function isBootstrapEmptyDbFailure(output) {
107
+ const text = String(output == null ? '' : output);
108
+ return BOOTSTRAP_EMPTY_DB_PATTERNS.some((re) => re.test(text));
109
+ }
110
+
111
+ /**
112
+ * Naive (dependency-free) check for a non-empty `sync.remote` in a
113
+ * config.yaml's raw text. Deliberately not a full YAML parse (no yaml
114
+ * dependency in this package) -- Path B only ever needs a yes/no guard on
115
+ * this one field, and callers/tests can inject their own `readConfig` for
116
+ * anything more precise.
117
+ *
118
+ * Recognizes BOTH forms `bd` itself writes for this key -- verified against
119
+ * a real bd-managed config.yaml (this repo's own .beads/config.yaml uses the
120
+ * flat form exclusively; the nested form was this function's original,
121
+ * untested assumption and never actually matched real output):
122
+ * - flat dotted key, one line: sync.remote: "git+https://...\"" or
123
+ * sync.remote: git+https://... (quoted or bare scalar)
124
+ * - nested block: sync:\n remote: git+https://...
125
+ * Without matching the flat form, this guard always reported false against
126
+ * every real config.yaml in this codebase, permanently blocking Path B
127
+ * behind a false "no sync.remote set" escalation to Tier 2 (apra-fleet-vkc.1
128
+ * post-review fix, found via a live manufactured-conflict test on
129
+ * fleet-win-dev1 -- not caught earlier because the existing tests only ever
130
+ * injected the nested form as a mock).
131
+ *
132
+ * @param {string} raw
133
+ * @returns {boolean}
134
+ */
135
+ export function hasSyncRemoteInYaml(raw) {
136
+ const text = String(raw == null ? '' : raw);
137
+ const flatMatch = text.match(/^sync\.remote:\s*(.*)$/m);
138
+ if (flatMatch) {
139
+ const value = flatMatch[1].trim().replace(/^"(.*)"$/, '$1').replace(/^'(.*)'$/, '$1').trim();
140
+ if (value.length > 0) return true;
141
+ }
142
+ const syncBlockMatch = text.match(/^sync:\s*\n((?:[ \t]+.*\n?)*)/m);
143
+ if (!syncBlockMatch) return false;
144
+ return /remote:\s*\S+/.test(syncBlockMatch[1]);
145
+ }
146
+
147
+ /**
148
+ * Default `readConfig()`: reads DEFAULT_CONFIG_PATH off disk and reports
149
+ * whether it exists and carries a non-empty `sync.remote`. Injectable
150
+ * (opts.readConfig) in tests so no real filesystem is touched.
151
+ *
152
+ * @param {string} [configPath]
153
+ * @returns {Promise<{ exists: boolean, raw: string|null, hasSyncRemote: boolean }>}
154
+ */
155
+ export async function defaultReadConfig(configPath = DEFAULT_CONFIG_PATH) {
156
+ const fs = await import('node:fs/promises');
157
+ let raw = null;
158
+ try {
159
+ raw = await fs.readFile(configPath, 'utf8');
160
+ } catch {
161
+ return { exists: false, raw: null, hasSyncRemote: false };
162
+ }
163
+ return { exists: true, raw, hasSyncRemote: hasSyncRemoteInYaml(raw) };
164
+ }
165
+
166
+ /**
167
+ * Default `removePath()`: `fs.rm(path, { recursive: true, force: true })`.
168
+ * Cross-platform (works identically on Windows and POSIX) -- deliberately
169
+ * NOT a shelled-out `rm -rf`, which does not exist natively on Windows.
170
+ * Injectable (opts.removePath) in tests so no real filesystem is touched.
171
+ *
172
+ * @param {string} targetPath
173
+ * @returns {Promise<void>}
174
+ */
175
+ export async function defaultRemovePath(targetPath) {
176
+ const fs = await import('node:fs/promises');
177
+ await fs.rm(targetPath, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 });
178
+ }
179
+
180
+ /**
181
+ * Default `listLocalState()`: enumerates the contents of the local backup
182
+ * dir (the one piece of loser-clone-only state most likely to hold real,
183
+ * never-to-be-recovered local writes) so the discard is logged rather than
184
+ * silent. Injectable (opts.listLocalState) in tests so no real filesystem is
185
+ * touched.
186
+ *
187
+ * @param {string} [backupDir]
188
+ * @returns {Promise<string[]>}
189
+ */
190
+ export async function defaultListLocalState(backupDir = DEFAULT_BACKUP_DIR) {
191
+ const fs = await import('node:fs/promises');
192
+ try {
193
+ const entries = await fs.readdir(backupDir);
194
+ if (entries.length === 0) {
195
+ return [`local backup dir '${backupDir}' is empty (nothing else to discard there)`];
196
+ }
197
+ return [`local backup dir '${backupDir}' contains ${entries.length} file(s), about to be discarded: ${entries.join(', ')}`];
198
+ } catch {
199
+ return [`local backup dir '${backupDir}' does not exist (nothing to enumerate there)`];
200
+ }
201
+ }
202
+
203
+ /**
204
+ * Path B: discard-and-re-bootstrap fallback dolt conflict recovery, with
205
+ * mutation replay and the two verified Windows gotchas guarded. Runs the
206
+ * VERIFIED runbook end-to-end via injected command()/removePath()/
207
+ * readConfig()/listLocalState() -- no agent dispatch.
208
+ *
209
+ * Return contract (never partial): on success returns
210
+ * `{ ok:true, recovered:true, mutationReplayed, removedPaths, discarded, reason }`.
211
+ * Any genuine operational failure (config guard, bootstrap failure surviving
212
+ * the one bounded retry, a failed mutation replay, or a still-rejected
213
+ * republish push) throws DoltSyncError/DoltDivergedError so the caller
214
+ * (apra-fleet-eft.9.6 Tier 2 escalation) can route it onward.
215
+ *
216
+ * @param {{
217
+ * member: string,
218
+ * command: (cmd: string, opts?: object) => Promise<{ ok: boolean, output?: string, error?: string|null }>,
219
+ * readConfig?: (configPath?: string) => Promise<{ exists: boolean, raw: string|null, hasSyncRemote: boolean }>,
220
+ * removePath?: (targetPath: string) => Promise<void>,
221
+ * listLocalState?: () => Promise<string[]>,
222
+ * configPath?: string,
223
+ * removePaths?: string[],
224
+ * embeddedDataDir?: string,
225
+ * pendingMutation?: { description: string, cmd: string } | null,
226
+ * log?: (msg: string) => void,
227
+ * }} opts
228
+ * @returns {Promise<{ ok: boolean, recovered: boolean, mutationReplayed: boolean, removedPaths: string[], discarded: string[], reason: string }>}
229
+ */
230
+ export async function recoverDoltConflictPathB(opts = {}) {
231
+ const {
232
+ member,
233
+ command,
234
+ readConfig = defaultReadConfig,
235
+ removePath = defaultRemovePath,
236
+ listLocalState = defaultListLocalState,
237
+ configPath = DEFAULT_CONFIG_PATH,
238
+ removePaths = DEFAULT_PATH_B_REMOVE_PATHS,
239
+ embeddedDataDir = DEFAULT_EMBEDDED_DATA_DIR,
240
+ pendingMutation = null,
241
+ log = () => {},
242
+ } = opts;
243
+
244
+ if (typeof command !== 'function') throw new Error('recoverDoltConflictPathB requires an injected command() in opts');
245
+ if (typeof readConfig !== 'function') throw new Error('recoverDoltConflictPathB requires an injected readConfig() in opts');
246
+ if (typeof removePath !== 'function') throw new Error('recoverDoltConflictPathB requires an injected removePath() in opts');
247
+ if (typeof listLocalState !== 'function') throw new Error('recoverDoltConflictPathB requires an injected listLocalState() in opts');
248
+
249
+ // --- Step 1: Windows gotcha #1 guard -- config.yaml must exist and
250
+ // already carry a non-empty sync.remote BEFORE we touch anything. We
251
+ // never remove config.yaml, but if it already lacks sync.remote the
252
+ // broken git+C:/ URL derivation would happen regardless of that care. ---
253
+ const configBefore = await readConfig(configPath);
254
+ if (!configBefore || !configBefore.exists) {
255
+ throw new DoltSyncError(
256
+ `[Dolt] Path B guard failed for member '${member}': '${configPath}' does not exist -- cannot safely re-bootstrap (Windows gotcha #1: bootstrap derives a broken git+C:/ URL without sync.remote). Escalating rather than proceeding blind.`,
257
+ { member, doltOutput: null },
258
+ );
259
+ }
260
+ if (!configBefore.hasSyncRemote) {
261
+ throw new DoltSyncError(
262
+ `[Dolt] Path B guard failed for member '${member}': '${configPath}' has no 'sync.remote' set -- re-bootstrapping would hit the verified Windows gotcha #1 (broken git+C:/ URL derivation). Escalating rather than proceeding blind.`,
263
+ { member, doltOutput: configBefore.raw },
264
+ );
265
+ }
266
+ log(`[Dolt] Path B guard passed for member '${member}': '${configPath}' present with sync.remote set -- safe to discard and re-bootstrap.`);
267
+
268
+ // --- Step 2: enumerate what is about to be discarded (never silent) ---
269
+ const discarded = await listLocalState();
270
+ for (const line of discarded) {
271
+ log(`[Dolt] Path B for member '${member}': DISCARDING (will NOT be recovered) -- ${line}`);
272
+ }
273
+
274
+ // --- Step 3: discard the wedged clone's local dolt state, keeping
275
+ // config.yaml untouched ---
276
+ const removedPaths = [];
277
+ for (const p of removePaths) {
278
+ log(`[Dolt] Path B for member '${member}': removing '${p}'.`);
279
+ await removePath(p);
280
+ removedPaths.push(p);
281
+ }
282
+
283
+ // --- Step 4: re-bootstrap fresh from the shared remote ---
284
+ const bootstrapCmd = 'BD_NON_INTERACTIVE=1 bd bootstrap --yes';
285
+ let bootstrap = await command(bootstrapCmd, { member_name: member, silent: true, failSoft: true, label: `Path B bootstrap for '${member}'` });
286
+
287
+ // --- Step 5: Windows gotcha #2 -- a leftover empty DB fails the first
288
+ // bootstrap attempt until embeddeddolt is removed again. Bounded: exactly
289
+ // ONE retry, never an unbounded loop. ---
290
+ if (bootstrap && bootstrap.ok === false && isBootstrapEmptyDbFailure(bootstrap.error || bootstrap.output)) {
291
+ log(`[Dolt] Path B for member '${member}': bootstrap failed with the verified Windows gotcha #2 (leftover empty DB) -- removing '${embeddedDataDir}' again and retrying bootstrap ONCE.`);
292
+ await removePath(embeddedDataDir);
293
+ bootstrap = await command(bootstrapCmd, { member_name: member, silent: true, failSoft: true, label: `Path B bootstrap retry (gotcha #2) for '${member}'` });
294
+ }
295
+
296
+ if (bootstrap && bootstrap.ok === false) {
297
+ throw new DoltSyncError(
298
+ `[Dolt] Path B bootstrap failed for member '${member}' and did not recover after the bounded gotcha #2 retry: ${bootstrap.error}`,
299
+ { member, doltOutput: bootstrap.error },
300
+ );
301
+ }
302
+ log(`[Dolt] Path B for member '${member}': re-bootstrapped clean from the shared remote.`);
303
+
304
+ // --- Step 6: replay the one pending mutation, so it is not lost even
305
+ // though everything else local was just discarded ---
306
+ let mutationReplayed = false;
307
+ if (pendingMutation && pendingMutation.cmd) {
308
+ log(`[Dolt] Path B for member '${member}': replaying the one pending mutation -- ${pendingMutation.description || pendingMutation.cmd}`);
309
+ const replay = await command(pendingMutation.cmd, { member_name: member, silent: true, failSoft: true, label: `Path B mutation replay for '${member}'` });
310
+ if (replay && replay.ok === false) {
311
+ throw new DoltSyncError(
312
+ `[Dolt] Path B re-bootstrapped member '${member}' but replaying the pending mutation failed -- it would be lost: ${replay.error}`,
313
+ { member, doltOutput: replay.error },
314
+ );
315
+ }
316
+ mutationReplayed = true;
317
+ } else {
318
+ log(`[Dolt] Path B for member '${member}': no pending mutation to replay.`);
319
+ }
320
+
321
+ // --- Step 7: republish the replayed clone ---
322
+ const push = await command('bd dolt push', { member_name: member, silent: true, failSoft: true, label: `Path B post-recovery D-push for '${member}'` });
323
+ if (push && push.ok === false) {
324
+ throw new DoltDivergedError(
325
+ `[Dolt] Path B recovered and replayed member '${member}' but the republishing push was still rejected: ${push.error}`,
326
+ { member, doltOutput: push.error, operation: 'path-b-push' },
327
+ );
328
+ }
329
+
330
+ log(`[Dolt] Path B SUCCEEDED for member '${member}': discarded and re-bootstrapped clean, replayed ${mutationReplayed ? 'the pending mutation' : 'no pending mutation'}, and republished.`);
331
+ return {
332
+ ok: true,
333
+ recovered: true,
334
+ mutationReplayed,
335
+ removedPaths,
336
+ discarded,
337
+ reason: `Path B discarded and re-bootstrapped member '${member}'${mutationReplayed ? ', replayed the pending mutation,' : ''} and republished`,
338
+ };
339
+ }