@apralabs/apra-fleet 0.3.5 → 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 (571) 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/secret.js +8 -2
  53. package/dist/cli/secret.js.map +1 -1
  54. package/dist/cli/spoke.d.ts +35 -0
  55. package/dist/cli/spoke.d.ts.map +1 -0
  56. package/dist/cli/spoke.js +212 -0
  57. package/dist/cli/spoke.js.map +1 -0
  58. package/dist/cli/start.d.ts +2 -0
  59. package/dist/cli/start.d.ts.map +1 -0
  60. package/dist/cli/start.js +92 -0
  61. package/dist/cli/start.js.map +1 -0
  62. package/dist/cli/status.d.ts +2 -0
  63. package/dist/cli/status.d.ts.map +1 -0
  64. package/dist/cli/status.js +83 -0
  65. package/dist/cli/status.js.map +1 -0
  66. package/dist/cli/stop.d.ts +2 -0
  67. package/dist/cli/stop.d.ts.map +1 -0
  68. package/dist/cli/stop.js +51 -0
  69. package/dist/cli/stop.js.map +1 -0
  70. package/dist/cli/uninstall.d.ts.map +1 -1
  71. package/dist/cli/uninstall.js +109 -9
  72. package/dist/cli/uninstall.js.map +1 -1
  73. package/dist/cli/update.d.ts.map +1 -1
  74. package/dist/cli/update.js +10 -1
  75. package/dist/cli/update.js.map +1 -1
  76. package/dist/cli/workflow-assets.d.ts +37 -0
  77. package/dist/cli/workflow-assets.d.ts.map +1 -0
  78. package/dist/cli/workflow-assets.js +144 -0
  79. package/dist/cli/workflow-assets.js.map +1 -0
  80. package/dist/cli/workflow.d.ts +75 -0
  81. package/dist/cli/workflow.d.ts.map +1 -0
  82. package/dist/cli/workflow.js +397 -0
  83. package/dist/cli/workflow.js.map +1 -0
  84. package/dist/hub-service/activity.d.ts +30 -0
  85. package/dist/hub-service/activity.d.ts.map +1 -0
  86. package/dist/hub-service/activity.js +20 -0
  87. package/dist/hub-service/activity.js.map +1 -0
  88. package/dist/hub-service/audit-log.d.ts +19 -0
  89. package/dist/hub-service/audit-log.d.ts.map +1 -0
  90. package/dist/hub-service/audit-log.js +13 -0
  91. package/dist/hub-service/audit-log.js.map +1 -0
  92. package/dist/hub-service/db/pool.d.ts +19 -0
  93. package/dist/hub-service/db/pool.d.ts.map +1 -0
  94. package/dist/hub-service/db/pool.js +53 -0
  95. package/dist/hub-service/db/pool.js.map +1 -0
  96. package/dist/hub-service/enrollment.d.ts +29 -0
  97. package/dist/hub-service/enrollment.d.ts.map +1 -0
  98. package/dist/hub-service/enrollment.js +48 -0
  99. package/dist/hub-service/enrollment.js.map +1 -0
  100. package/dist/hub-service/envelope-routes.d.ts +46 -0
  101. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  102. package/dist/hub-service/envelope-routes.js +94 -0
  103. package/dist/hub-service/envelope-routes.js.map +1 -0
  104. package/dist/hub-service/handlers/installers.d.ts +14 -0
  105. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  106. package/dist/hub-service/handlers/installers.js +8 -0
  107. package/dist/hub-service/handlers/installers.js.map +1 -0
  108. package/dist/hub-service/http-server.d.ts +31 -0
  109. package/dist/hub-service/http-server.d.ts.map +1 -0
  110. package/dist/hub-service/http-server.js +711 -0
  111. package/dist/hub-service/http-server.js.map +1 -0
  112. package/dist/hub-service/hub-jwt.d.ts +30 -0
  113. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  114. package/dist/hub-service/hub-jwt.js +105 -0
  115. package/dist/hub-service/hub-jwt.js.map +1 -0
  116. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  117. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  118. package/dist/hub-service/jwt-revocation.js +18 -0
  119. package/dist/hub-service/jwt-revocation.js.map +1 -0
  120. package/dist/hub-service/machines.d.ts +16 -0
  121. package/dist/hub-service/machines.d.ts.map +1 -0
  122. package/dist/hub-service/machines.js +14 -0
  123. package/dist/hub-service/machines.js.map +1 -0
  124. package/dist/hub-service/main.d.ts +3 -0
  125. package/dist/hub-service/main.d.ts.map +1 -0
  126. package/dist/hub-service/main.js +64 -0
  127. package/dist/hub-service/main.js.map +1 -0
  128. package/dist/hub-service/member-tokens.d.ts +11 -0
  129. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  130. package/dist/hub-service/member-tokens.js +49 -0
  131. package/dist/hub-service/member-tokens.js.map +1 -0
  132. package/dist/hub-service/member-view.d.ts +20 -0
  133. package/dist/hub-service/member-view.d.ts.map +1 -0
  134. package/dist/hub-service/member-view.js +76 -0
  135. package/dist/hub-service/member-view.js.map +1 -0
  136. package/dist/hub-service/members.d.ts +44 -0
  137. package/dist/hub-service/members.d.ts.map +1 -0
  138. package/dist/hub-service/members.js +25 -0
  139. package/dist/hub-service/members.js.map +1 -0
  140. package/dist/hub-service/presence.d.ts +40 -0
  141. package/dist/hub-service/presence.d.ts.map +1 -0
  142. package/dist/hub-service/presence.js +44 -0
  143. package/dist/hub-service/presence.js.map +1 -0
  144. package/dist/hub-service/project-view.d.ts +12 -0
  145. package/dist/hub-service/project-view.d.ts.map +1 -0
  146. package/dist/hub-service/project-view.js +34 -0
  147. package/dist/hub-service/project-view.js.map +1 -0
  148. package/dist/hub-service/projects.d.ts +48 -0
  149. package/dist/hub-service/projects.d.ts.map +1 -0
  150. package/dist/hub-service/projects.js +80 -0
  151. package/dist/hub-service/projects.js.map +1 -0
  152. package/dist/hub-service/relay-queue.d.ts +115 -0
  153. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  154. package/dist/hub-service/relay-queue.js +148 -0
  155. package/dist/hub-service/relay-queue.js.map +1 -0
  156. package/dist/hub-service/session-jwt.d.ts +10 -0
  157. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  158. package/dist/hub-service/session-jwt.js +69 -0
  159. package/dist/hub-service/session-jwt.js.map +1 -0
  160. package/dist/hub-service/usage.d.ts +40 -0
  161. package/dist/hub-service/usage.d.ts.map +1 -0
  162. package/dist/hub-service/usage.js +25 -0
  163. package/dist/hub-service/usage.js.map +1 -0
  164. package/dist/hub-service/users.d.ts +56 -0
  165. package/dist/hub-service/users.d.ts.map +1 -0
  166. package/dist/hub-service/users.js +72 -0
  167. package/dist/hub-service/users.js.map +1 -0
  168. package/dist/hub-service/workspaces.d.ts +20 -0
  169. package/dist/hub-service/workspaces.d.ts.map +1 -0
  170. package/dist/hub-service/workspaces.js +10 -0
  171. package/dist/hub-service/workspaces.js.map +1 -0
  172. package/dist/index.js +179 -132
  173. package/dist/index.js.map +1 -1
  174. package/dist/os/linux.d.ts +13 -0
  175. package/dist/os/linux.d.ts.map +1 -1
  176. package/dist/os/linux.js +62 -3
  177. package/dist/os/linux.js.map +1 -1
  178. package/dist/os/os-commands.d.ts +10 -0
  179. package/dist/os/os-commands.d.ts.map +1 -1
  180. package/dist/os/windows.d.ts +1 -0
  181. package/dist/os/windows.d.ts.map +1 -1
  182. package/dist/os/windows.js +21 -1
  183. package/dist/os/windows.js.map +1 -1
  184. package/dist/paths.d.ts +23 -0
  185. package/dist/paths.d.ts.map +1 -1
  186. package/dist/paths.js +29 -0
  187. package/dist/paths.js.map +1 -1
  188. package/dist/providers/agy.d.ts +9 -2
  189. package/dist/providers/agy.d.ts.map +1 -1
  190. package/dist/providers/agy.js +127 -14
  191. package/dist/providers/agy.js.map +1 -1
  192. package/dist/providers/claude.d.ts +6 -2
  193. package/dist/providers/claude.d.ts.map +1 -1
  194. package/dist/providers/claude.js +248 -9
  195. package/dist/providers/claude.js.map +1 -1
  196. package/dist/providers/codex.d.ts +3 -2
  197. package/dist/providers/codex.d.ts.map +1 -1
  198. package/dist/providers/codex.js +7 -0
  199. package/dist/providers/codex.js.map +1 -1
  200. package/dist/providers/copilot.d.ts +3 -2
  201. package/dist/providers/copilot.d.ts.map +1 -1
  202. package/dist/providers/copilot.js +8 -1
  203. package/dist/providers/copilot.js.map +1 -1
  204. package/dist/providers/gemini.d.ts +3 -2
  205. package/dist/providers/gemini.d.ts.map +1 -1
  206. package/dist/providers/gemini.js +11 -1
  207. package/dist/providers/gemini.js.map +1 -1
  208. package/dist/providers/index.d.ts +1 -0
  209. package/dist/providers/index.d.ts.map +1 -1
  210. package/dist/providers/index.js +3 -0
  211. package/dist/providers/index.js.map +1 -1
  212. package/dist/providers/none.d.ts +51 -0
  213. package/dist/providers/none.d.ts.map +1 -0
  214. package/dist/providers/none.js +103 -0
  215. package/dist/providers/none.js.map +1 -0
  216. package/dist/providers/opencode.d.ts +4 -2
  217. package/dist/providers/opencode.d.ts.map +1 -1
  218. package/dist/providers/opencode.js +49 -0
  219. package/dist/providers/opencode.js.map +1 -1
  220. package/dist/providers/provider.d.ts +79 -1
  221. package/dist/providers/provider.d.ts.map +1 -1
  222. package/dist/providers/provider.js +10 -0
  223. package/dist/providers/provider.js.map +1 -1
  224. package/dist/services/agent-provisioner.d.ts +3 -3
  225. package/dist/services/agent-provisioner.d.ts.map +1 -1
  226. package/dist/services/agent-provisioner.js +12 -5
  227. package/dist/services/agent-provisioner.js.map +1 -1
  228. package/dist/services/auth-socket.d.ts.map +1 -1
  229. package/dist/services/auth-socket.js +2 -0
  230. package/dist/services/auth-socket.js.map +1 -1
  231. package/dist/services/budget-awareness.d.ts +130 -0
  232. package/dist/services/budget-awareness.d.ts.map +1 -0
  233. package/dist/services/budget-awareness.js +129 -0
  234. package/dist/services/budget-awareness.js.map +1 -0
  235. package/dist/services/cloud-sync.d.ts +35 -0
  236. package/dist/services/cloud-sync.d.ts.map +1 -0
  237. package/dist/services/cloud-sync.js +90 -0
  238. package/dist/services/cloud-sync.js.map +1 -0
  239. package/dist/services/context-admission.d.ts +82 -0
  240. package/dist/services/context-admission.d.ts.map +1 -0
  241. package/dist/services/context-admission.js +136 -0
  242. package/dist/services/context-admission.js.map +1 -0
  243. package/dist/services/event-bus.d.ts +27 -0
  244. package/dist/services/event-bus.d.ts.map +1 -0
  245. package/dist/services/event-bus.js +20 -0
  246. package/dist/services/event-bus.js.map +1 -0
  247. package/dist/services/file-chunker.d.ts +38 -0
  248. package/dist/services/file-chunker.d.ts.map +1 -0
  249. package/dist/services/file-chunker.js +63 -0
  250. package/dist/services/file-chunker.js.map +1 -0
  251. package/dist/services/file-transfer-relay.d.ts +55 -0
  252. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  253. package/dist/services/file-transfer-relay.js +115 -0
  254. package/dist/services/file-transfer-relay.js.map +1 -0
  255. package/dist/services/github-app.d.ts.map +1 -1
  256. package/dist/services/github-app.js +1 -0
  257. package/dist/services/github-app.js.map +1 -1
  258. package/dist/services/http-transport.d.ts +25 -0
  259. package/dist/services/http-transport.d.ts.map +1 -0
  260. package/dist/services/http-transport.js +371 -0
  261. package/dist/services/http-transport.js.map +1 -0
  262. package/dist/services/hub-client.d.ts +69 -0
  263. package/dist/services/hub-client.d.ts.map +1 -0
  264. package/dist/services/hub-client.js +217 -0
  265. package/dist/services/hub-client.js.map +1 -0
  266. package/dist/services/jwt.d.ts +17 -0
  267. package/dist/services/jwt.d.ts.map +1 -0
  268. package/dist/services/jwt.js +70 -0
  269. package/dist/services/jwt.js.map +1 -0
  270. package/dist/services/known-sessions.d.ts +8 -0
  271. package/dist/services/known-sessions.d.ts.map +1 -0
  272. package/dist/services/known-sessions.js +40 -0
  273. package/dist/services/known-sessions.js.map +1 -0
  274. package/dist/services/model-pricing.d.ts +36 -0
  275. package/dist/services/model-pricing.d.ts.map +1 -0
  276. package/dist/services/model-pricing.js +108 -0
  277. package/dist/services/model-pricing.js.map +1 -0
  278. package/dist/services/orphan-recovery.d.ts +56 -0
  279. package/dist/services/orphan-recovery.d.ts.map +1 -0
  280. package/dist/services/orphan-recovery.js +111 -0
  281. package/dist/services/orphan-recovery.js.map +1 -0
  282. package/dist/services/pending-responses.d.ts +23 -0
  283. package/dist/services/pending-responses.d.ts.map +1 -0
  284. package/dist/services/pending-responses.js +52 -0
  285. package/dist/services/pending-responses.js.map +1 -0
  286. package/dist/services/registry.d.ts +4 -1
  287. package/dist/services/registry.d.ts.map +1 -1
  288. package/dist/services/registry.js +3 -0
  289. package/dist/services/registry.js.map +1 -1
  290. package/dist/services/relay-context.d.ts +23 -0
  291. package/dist/services/relay-context.d.ts.map +1 -0
  292. package/dist/services/relay-context.js +8 -0
  293. package/dist/services/relay-context.js.map +1 -0
  294. package/dist/services/relay-executor.d.ts +68 -0
  295. package/dist/services/relay-executor.d.ts.map +1 -0
  296. package/dist/services/relay-executor.js +70 -0
  297. package/dist/services/relay-executor.js.map +1 -0
  298. package/dist/services/relay-request.d.ts +65 -0
  299. package/dist/services/relay-request.d.ts.map +1 -0
  300. package/dist/services/relay-request.js +129 -0
  301. package/dist/services/relay-request.js.map +1 -0
  302. package/dist/services/relay-strategy.d.ts +19 -0
  303. package/dist/services/relay-strategy.d.ts.map +1 -0
  304. package/dist/services/relay-strategy.js +111 -0
  305. package/dist/services/relay-strategy.js.map +1 -0
  306. package/dist/services/service-manager/index.d.ts +5 -0
  307. package/dist/services/service-manager/index.d.ts.map +1 -0
  308. package/dist/services/service-manager/index.js +66 -0
  309. package/dist/services/service-manager/index.js.map +1 -0
  310. package/dist/services/service-manager/linux.d.ts +10 -0
  311. package/dist/services/service-manager/linux.d.ts.map +1 -0
  312. package/dist/services/service-manager/linux.js +97 -0
  313. package/dist/services/service-manager/linux.js.map +1 -0
  314. package/dist/services/service-manager/macos.d.ts +10 -0
  315. package/dist/services/service-manager/macos.d.ts.map +1 -0
  316. package/dist/services/service-manager/macos.js +94 -0
  317. package/dist/services/service-manager/macos.js.map +1 -0
  318. package/dist/services/service-manager/types.d.ts +18 -0
  319. package/dist/services/service-manager/types.d.ts.map +1 -0
  320. package/dist/services/service-manager/types.js +5 -0
  321. package/dist/services/service-manager/types.js.map +1 -0
  322. package/dist/services/service-manager/windows.d.ts +10 -0
  323. package/dist/services/service-manager/windows.d.ts.map +1 -0
  324. package/dist/services/service-manager/windows.js +73 -0
  325. package/dist/services/service-manager/windows.js.map +1 -0
  326. package/dist/services/session-registry.d.ts +70 -0
  327. package/dist/services/session-registry.d.ts.map +1 -0
  328. package/dist/services/session-registry.js +91 -0
  329. package/dist/services/session-registry.js.map +1 -0
  330. package/dist/services/singleton.d.ts +15 -0
  331. package/dist/services/singleton.d.ts.map +1 -0
  332. package/dist/services/singleton.js +98 -0
  333. package/dist/services/singleton.js.map +1 -0
  334. package/dist/services/sprint-coordination.d.ts +168 -0
  335. package/dist/services/sprint-coordination.d.ts.map +1 -0
  336. package/dist/services/sprint-coordination.js +564 -0
  337. package/dist/services/sprint-coordination.js.map +1 -0
  338. package/dist/services/ssh.d.ts.map +1 -1
  339. package/dist/services/ssh.js +70 -3
  340. package/dist/services/ssh.js.map +1 -1
  341. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  342. package/dist/services/stall/log-path-resolver.js +8 -1
  343. package/dist/services/stall/log-path-resolver.js.map +1 -1
  344. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  345. package/dist/services/stall/stall-detector.js +39 -7
  346. package/dist/services/stall/stall-detector.js.map +1 -1
  347. package/dist/services/stall/stall-poller.d.ts +16 -0
  348. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  349. package/dist/services/stall/stall-poller.js +136 -18
  350. package/dist/services/stall/stall-poller.js.map +1 -1
  351. package/dist/services/strategy.d.ts.map +1 -1
  352. package/dist/services/strategy.js +55 -5
  353. package/dist/services/strategy.js.map +1 -1
  354. package/dist/services/substitution-engine.d.ts +20 -0
  355. package/dist/services/substitution-engine.d.ts.map +1 -0
  356. package/dist/services/substitution-engine.js +92 -0
  357. package/dist/services/substitution-engine.js.map +1 -0
  358. package/dist/services/task-cleanup.d.ts.map +1 -1
  359. package/dist/services/task-cleanup.js +1 -9
  360. package/dist/services/task-cleanup.js.map +1 -1
  361. package/dist/services/token-issuer.d.ts +47 -0
  362. package/dist/services/token-issuer.d.ts.map +1 -0
  363. package/dist/services/token-issuer.js +63 -0
  364. package/dist/services/token-issuer.js.map +1 -0
  365. package/dist/services/tool-registry.d.ts +3 -0
  366. package/dist/services/tool-registry.d.ts.map +1 -0
  367. package/dist/services/tool-registry.js +139 -0
  368. package/dist/services/tool-registry.js.map +1 -0
  369. package/dist/services/user-config.d.ts +14 -0
  370. package/dist/services/user-config.d.ts.map +1 -1
  371. package/dist/services/user-config.js +55 -0
  372. package/dist/services/user-config.js.map +1 -1
  373. package/dist/services/vcs/types.d.ts +44 -0
  374. package/dist/services/vcs/types.d.ts.map +1 -1
  375. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  376. package/dist/skills/pm/cost.md +3 -0
  377. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  378. package/dist/tools/check-status.d.ts.map +1 -1
  379. package/dist/tools/check-status.js +8 -2
  380. package/dist/tools/check-status.js.map +1 -1
  381. package/dist/tools/child-id-allocator.d.ts +45 -0
  382. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  383. package/dist/tools/child-id-allocator.js +62 -0
  384. package/dist/tools/child-id-allocator.js.map +1 -0
  385. package/dist/tools/cloud-control.d.ts +2 -2
  386. package/dist/tools/compose-permissions.d.ts +12 -4
  387. package/dist/tools/compose-permissions.d.ts.map +1 -1
  388. package/dist/tools/compose-permissions.js +55 -4
  389. package/dist/tools/compose-permissions.js.map +1 -1
  390. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  391. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  392. package/dist/tools/dolt-push-mutex.js +83 -0
  393. package/dist/tools/dolt-push-mutex.js.map +1 -0
  394. package/dist/tools/execute-command.d.ts +11 -1
  395. package/dist/tools/execute-command.d.ts.map +1 -1
  396. package/dist/tools/execute-command.js +22 -5
  397. package/dist/tools/execute-command.js.map +1 -1
  398. package/dist/tools/execute-prompt.d.ts +72 -12
  399. package/dist/tools/execute-prompt.d.ts.map +1 -1
  400. package/dist/tools/execute-prompt.js +962 -71
  401. package/dist/tools/execute-prompt.js.map +1 -1
  402. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  403. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  404. package/dist/tools/get-member-model-pricing.js +29 -0
  405. package/dist/tools/get-member-model-pricing.js.map +1 -0
  406. package/dist/tools/list-members.d.ts.map +1 -1
  407. package/dist/tools/list-members.js +39 -7
  408. package/dist/tools/list-members.js.map +1 -1
  409. package/dist/tools/member-detail.d.ts +1 -1
  410. package/dist/tools/member-detail.d.ts.map +1 -1
  411. package/dist/tools/member-detail.js +8 -2
  412. package/dist/tools/member-detail.js.map +1 -1
  413. package/dist/tools/member-reservation.d.ts +29 -0
  414. package/dist/tools/member-reservation.d.ts.map +1 -0
  415. package/dist/tools/member-reservation.js +71 -0
  416. package/dist/tools/member-reservation.js.map +1 -0
  417. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  418. package/dist/tools/provision-vcs-auth.js +1 -1
  419. package/dist/tools/provision-vcs-auth.js.map +1 -1
  420. package/dist/tools/register-member.d.ts +17 -5
  421. package/dist/tools/register-member.d.ts.map +1 -1
  422. package/dist/tools/register-member.js +144 -5
  423. package/dist/tools/register-member.js.map +1 -1
  424. package/dist/tools/remove-member.d.ts +1 -1
  425. package/dist/tools/report-status.d.ts +33 -0
  426. package/dist/tools/report-status.d.ts.map +1 -0
  427. package/dist/tools/report-status.js +44 -0
  428. package/dist/tools/report-status.js.map +1 -0
  429. package/dist/tools/respond-to-message.d.ts +21 -0
  430. package/dist/tools/respond-to-message.d.ts.map +1 -0
  431. package/dist/tools/respond-to-message.js +23 -0
  432. package/dist/tools/respond-to-message.js.map +1 -0
  433. package/dist/tools/send-files.d.ts +3 -0
  434. package/dist/tools/send-files.d.ts.map +1 -1
  435. package/dist/tools/send-files.js +88 -8
  436. package/dist/tools/send-files.js.map +1 -1
  437. package/dist/tools/send-message.d.ts +27 -0
  438. package/dist/tools/send-message.d.ts.map +1 -0
  439. package/dist/tools/send-message.js +46 -0
  440. package/dist/tools/send-message.js.map +1 -0
  441. package/dist/tools/shutdown-server.d.ts +2 -0
  442. package/dist/tools/shutdown-server.d.ts.map +1 -1
  443. package/dist/tools/shutdown-server.js +19 -0
  444. package/dist/tools/shutdown-server.js.map +1 -1
  445. package/dist/tools/update-member.d.ts +8 -8
  446. package/dist/tools/update-member.d.ts.map +1 -1
  447. package/dist/tools/update-member.js +11 -1
  448. package/dist/tools/update-member.js.map +1 -1
  449. package/dist/types.d.ts +15 -3
  450. package/dist/types.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.d.ts +2 -1
  452. package/dist/utils/agent-helpers.d.ts.map +1 -1
  453. package/dist/utils/agent-helpers.js +7 -2
  454. package/dist/utils/agent-helpers.js.map +1 -1
  455. package/dist/utils/pid-helpers.d.ts +15 -0
  456. package/dist/utils/pid-helpers.d.ts.map +1 -1
  457. package/dist/utils/pid-helpers.js +23 -0
  458. package/dist/utils/pid-helpers.js.map +1 -1
  459. package/dist/utils/process-utils.d.ts +3 -0
  460. package/dist/utils/process-utils.d.ts.map +1 -0
  461. package/dist/utils/process-utils.js +42 -0
  462. package/dist/utils/process-utils.js.map +1 -0
  463. package/dist/utils/prompt-errors.d.ts +2 -1
  464. package/dist/utils/prompt-errors.d.ts.map +1 -1
  465. package/dist/utils/prompt-errors.js +13 -3
  466. package/dist/utils/prompt-errors.js.map +1 -1
  467. package/dist/utils/workspace-trust.d.ts +24 -0
  468. package/dist/utils/workspace-trust.d.ts.map +1 -0
  469. package/dist/utils/workspace-trust.js +35 -0
  470. package/dist/utils/workspace-trust.js.map +1 -0
  471. package/dist/workflows/auto-sprint.js +450 -87
  472. package/package.json +35 -7
  473. package/packages/apra-fleet-client/package.json +26 -0
  474. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  475. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  476. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  477. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  478. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  479. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  506. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  507. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  514. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  515. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  516. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  517. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  518. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  519. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  520. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  521. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  525. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  526. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  530. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  531. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  532. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  533. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  534. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  535. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  536. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  542. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  543. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  544. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  545. package/packages/apra-fleet-se/package.json +28 -0
  546. package/packages/apra-fleet-se/workflow.json +1 -0
  547. package/packages/apra-fleet-workflow/package.json +30 -0
  548. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  549. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  550. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  551. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  552. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  553. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  554. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  555. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  556. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  557. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  558. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  559. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  560. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  561. package/scripts/agy-transcript-reader.js +1 -0
  562. package/scripts/fleet-statusline.sh +17 -13
  563. package/skills/fleet/SKILL.md +37 -2
  564. package/skills/fleet/beads.md +14 -7
  565. package/skills/fleet/permissions.md +50 -0
  566. package/skills/fleet/profiles/base-dev.json +1 -0
  567. package/skills/fleet/profiles/base-reviewer.json +1 -0
  568. package/skills/fleet/profiles/node.json +2 -2
  569. package/version.json +1 -1
  570. package/scripts/agy-settings-merge.js +0 -27
  571. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,68 @@
1
+ /**
2
+ * AzureDevOpsVCS -- the Azure DevOps provider entry (apra-fleet-647.1.5.1).
3
+ *
4
+ * Registered so Azure DevOps is a first-class member of the SAME registry
5
+ * that drives classifyFailure(), resolveProvider() and buildVcsCommand() --
6
+ * before this file existed, 'azure-devops' was only a name-keyed entry in
7
+ * vcs-module.mjs's now-deleted BUILDERS/DEFAULT_AUTH_MODES tables, which a
8
+ * new provider had to also edit.
9
+ *
10
+ * No auth-mode axis of its own (a single PAT token field at
11
+ * provision_vcs_auth time, same as Bitbucket -- see ./bitbucket.mjs), and no
12
+ * REST create-pull-request/comment builders implemented yet -- both are
13
+ * DELIBERATELY absent (`builders: null`) rather than guessed at, so
14
+ * buildVcsCommand() fails closed with a clear ASCII "ERROR: ... does not yet
15
+ * implement action ..." instead of silently building a wrong command.
16
+ * Declaring `defaultAuthMode` (even as `null`) is what makes 'azure-devops'
17
+ * part of resolveProvider()'s known vocabulary -- see ./index.mjs's
18
+ * isAuthBackend().
19
+ *
20
+ * Extends GenericGitVCS for stderr classification. Azure DevOps' own
21
+ * TF-numbered error codes (e.g. TF401019) previously were NOT added as a
22
+ * dedicated pattern here, on the reasoning that the realistic full stderr for
23
+ * an expired/invalid Azure DevOps credential over git-over-HTTPS still
24
+ * carries git's own generic "fatal: Authentication failed for '<url>'" tail
25
+ * line, which GenericGitVCS already classifies AUTH_EXPIRED (see
26
+ * test/vcs-nongithub-auth-selfheal.test.mjs, apra-fleet-647.1.3.4).
27
+ *
28
+ * apra-fleet-417.6 (BLOCKS apra-fleet-647.1.3.4's own AC that no non-GitHub
29
+ * provider signal is recognized without that tail): a bare 'remote:
30
+ * TF401019: ...' line -- e.g. a REST/API path, or any transport that does not
31
+ * append git's own tail -- reached classifyFailure() as UNKNOWN before this
32
+ * pattern existed. TF401019's own text ("does not exist, or you do not have
33
+ * permission to perform this operation") is Azure DevOps' deliberately
34
+ * ambiguous repo-not-found-or-no-access message; re-minting the identical PAT
35
+ * cannot fix either case (a missing repo needs creating, a real permission
36
+ * gap needs granting), so this is AUTH_DENIED, not AUTH_EXPIRED -- consistent
37
+ * with vcs-classify-failure.test.mjs's own AC1 example provider, which models
38
+ * TF401019 the same way.
39
+ *
40
+ * ASCII only.
41
+ */
42
+
43
+ import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
44
+
45
+ const AUTH_DENIED = [
46
+ /TF401019/,
47
+ ];
48
+
49
+ /** Best-effort Azure DevOps TF-numbered error code, purely DIAGNOSTIC: never
50
+ * branch on it -- branch on `kind`. */
51
+ function extractProviderCode(raw) {
52
+ const text = String(raw == null ? '' : raw);
53
+ const match = text.match(/\b(TF\d{6})\b/);
54
+ return match ? match[1] : null;
55
+ }
56
+
57
+ export const AzureDevOpsVCS = Object.freeze({
58
+ name: 'azure-devops',
59
+ extends: 'generic-git',
60
+ rules: Object.freeze({
61
+ [K.AUTH_DENIED]: AUTH_DENIED,
62
+ }),
63
+ extractProviderCode,
64
+ defaultAuthMode: null,
65
+ builders: null,
66
+ });
67
+
68
+ export default AzureDevOpsVCS;
@@ -0,0 +1,53 @@
1
+ /**
2
+ * BitbucketVCS -- the Bitbucket provider entry (apra-fleet-647.1.5.1).
3
+ *
4
+ * Registered so Bitbucket is a first-class member of the SAME registry that
5
+ * drives classifyFailure(), resolveProvider() and buildVcsCommand() --
6
+ * before this file existed, 'bitbucket' was only a name-keyed entry in
7
+ * vcs-module.mjs's now-deleted BUILDERS/DEFAULT_AUTH_MODES tables, which a
8
+ * new provider had to also edit.
9
+ *
10
+ * No auth-mode axis of its own (Bitbucket authenticates via a single app
11
+ * password / token field at provision_vcs_auth time, same as Azure DevOps --
12
+ * see ./azure-devops.mjs), and no REST create-pull-request/comment builders
13
+ * implemented yet -- both are DELIBERATELY absent (`builders: null`) rather
14
+ * than guessed at, so buildVcsCommand() fails closed with a clear ASCII
15
+ * "ERROR: ... does not yet implement action ..." instead of silently
16
+ * building a wrong command. Declaring `defaultAuthMode` (even as `null`) is
17
+ * what makes 'bitbucket' part of resolveProvider()'s known vocabulary -- see
18
+ * ./index.mjs's isAuthBackend().
19
+ *
20
+ * Extends GenericGitVCS for stderr classification (Bitbucket speaks plain
21
+ * git-over-HTTPS/SSH; it had no vendor-specific auth literal in the parity
22
+ * corpus before apra-fleet-417.6 -- see generic-git.mjs's own header note on
23
+ * what belongs portable vs. vendor-specific).
24
+ *
25
+ * apra-fleet-417.6: 'remote: Invalid or expired app password.' is
26
+ * Bitbucket's own literal for a dead/rotated app password, reached without
27
+ * git's generic "fatal: Authentication failed" tail (e.g. over a transport
28
+ * that does not append it). The text says "expired" outright, and
29
+ * re-provisioning a fresh app password is exactly the fix, so AUTH_EXPIRED
30
+ * (contrast Azure DevOps' TF401019, which is AUTH_DENIED -- see
31
+ * ./azure-devops.mjs -- because re-minting the same credential there cannot
32
+ * help).
33
+ *
34
+ * ASCII only.
35
+ */
36
+
37
+ import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
38
+
39
+ const AUTH_EXPIRED = [
40
+ /Invalid or expired app password/i,
41
+ ];
42
+
43
+ export const BitbucketVCS = Object.freeze({
44
+ name: 'bitbucket',
45
+ extends: 'generic-git',
46
+ rules: Object.freeze({
47
+ [K.AUTH_EXPIRED]: AUTH_EXPIRED,
48
+ }),
49
+ defaultAuthMode: null,
50
+ builders: null,
51
+ });
52
+
53
+ export default BitbucketVCS;
@@ -0,0 +1,146 @@
1
+ /**
2
+ * DoltVCS -- the Dolt (beads-sync) provider for VCSModule.classifyFailure()
3
+ * (apra-fleet-647.1.3.2).
4
+ *
5
+ * `extends: null` DELIBERATELY -- this does NOT extend GenericGitVCS or
6
+ * GitHubVCS. classifyFailure()'s inheritance walk is ADDITIVE (a provider's
7
+ * own rules are checked FIRST, but every ancestor's rules are still checked
8
+ * too), so extending either would import git-flavored TRANSIENT texts
9
+ * ('fetch failed', 'transport failure while executing command',
10
+ * 'ssh_exchange_identification', ...) into Dolt's classification. Those
11
+ * strings classify 'unknown' (never retried) for dolt today; silently
12
+ * widening TRANSIENT would change that verdict, which apra-fleet-647.1.3.2
13
+ * AC3 (no verdict change) forbids. Every table below is therefore dolt's OWN
14
+ * copy, even where it duplicates a GenericGitVCS/GitHubVCS pattern verbatim
15
+ * (the 8 shared auth literals) -- see generic-git.mjs's "DELIBERATELY NOT
16
+ * FOLDED IN" note, which named this exact tradeoff in advance.
17
+ *
18
+ * PARITY CONSTRAINT: every regex table here is dolt-sync.mjs's own
19
+ * DOLT_*_PATTERNS verbatim (apra-fleet-417.3.1's classifyDoltFailure), so
20
+ * dolt-sync.mjs can delegate to VCSModule.classifyFailure(raw, {provider:
21
+ * 'dolt'}) with NO verdict change.
22
+ *
23
+ * PRECEDENCE (apra-fleet-spp / apra-fleet-417.3.1): no-remote, empty-remote
24
+ * and remote-unreachable are checked first (each is a distinct benign/fatal
25
+ * non-error condition that must win over a looser downstream pattern), THEN
26
+ * auth, THEN diverged, THEN transient -- auth is deliberately checked BEFORE
27
+ * diverged here (the OPPOSITE of GenericGitVCS/GitHubVCS's default
28
+ * DIVERGED-before-AUTH order): a live incident (2026-08-02, fleet-mac) had a
29
+ * `could not read Username for` credential failure misclassified as data
30
+ * divergence by a looser conflict pattern and hard-aborted an otherwise
31
+ * healthy sprint, when the fix was simply to re-provision credentials. A
32
+ * credential failure must never reach 'diverged' for dolt.
33
+ *
34
+ * PURITY: non-global regexes only -- see the note in ./generic-git.mjs.
35
+ *
36
+ * ASCII only.
37
+ */
38
+
39
+ import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
40
+
41
+ /** Verbatim DOLT_NO_REMOTE_PATTERNS. */
42
+ const NO_REMOTE = [
43
+ /error 1105.*no remote/i,
44
+ /\bno remote\b/i,
45
+ ];
46
+
47
+ /** Verbatim DOLT_EMPTY_REMOTE_PATTERNS. */
48
+ const EMPTY_REMOTE = [
49
+ /error 1105.*no branches found in remote/i,
50
+ /no branches found in remote/i,
51
+ ];
52
+
53
+ /** Verbatim DOLT_REMOTE_UNREACHABLE_PATTERNS. */
54
+ const REMOTE_UNREACHABLE = [
55
+ /could not be accessed/i,
56
+ /failed to get remote db/i,
57
+ /stat [^:]+: no such file or directory/i,
58
+ ];
59
+
60
+ /** Verbatim DOLT_AUTH_PATTERNS. dolt-sync.mjs's classifyDoltFailure returns a
61
+ * single undifferentiated 'auth' (no AUTH_EXPIRED/AUTH_DENIED split), so
62
+ * every one of these -- including the publickey-refusal literal -- lands in
63
+ * AUTH_EXPIRED here; toDoltVerdict() collapses both AUTH_* kinds back to
64
+ * 'auth' regardless, so this bucketing is verdict-neutral. */
65
+ const AUTH_EXPIRED = [
66
+ /could not read Username for/i,
67
+ /could not read Password for/i,
68
+ /Authentication failed/i,
69
+ /Permission denied \(publickey\)/i,
70
+ /remote: Invalid username or (token|password)/i,
71
+ /terminal prompts disabled/i,
72
+ /support for password authentication was removed/i,
73
+ /Bad credentials/i,
74
+ ];
75
+
76
+ /** Verbatim DOLT_DIVERGED_PATTERNS. */
77
+ const DIVERGED = [
78
+ /conflict/i,
79
+ /would (be )?overwrit/i,
80
+ /cannot fast[- ]forward/i,
81
+ /not possible to fast[- ]forward/i,
82
+ /non-fast-forward/i,
83
+ /\[rejected\]/i,
84
+ /failed to push/i,
85
+ /updates were rejected/i,
86
+ /remote (is )?ahead/i,
87
+ /behind the remote/i,
88
+ /not up[- ]to[- ]date/i,
89
+ /have diverged/i,
90
+ /merge (is )?required/i,
91
+ /working set (is )?not clean/i,
92
+ ];
93
+
94
+ /** Verbatim DOLT_TRANSIENT_PATTERNS. */
95
+ const TRANSIENT = [
96
+ /could not resolve host/i,
97
+ /unable to (access|connect)/i,
98
+ /connection (timed out|reset|refused)/i,
99
+ /operation timed out/i,
100
+ /\btimed out\b/i,
101
+ /\btimeout\b/i,
102
+ /temporary failure/i,
103
+ /early eof/i,
104
+ /rpc failed/i,
105
+ /the remote end hung up/i,
106
+ /server (is )?(starting|not ready|unavailable)/i,
107
+ /connection refused/i,
108
+ /dial tcp/i,
109
+ /i\/o timeout/i,
110
+ /database is locked/i,
111
+ /lock/i,
112
+ ];
113
+
114
+ const PRECEDENCE = Object.freeze([
115
+ K.NO_REMOTE,
116
+ K.EMPTY_REMOTE,
117
+ K.REMOTE_UNREACHABLE,
118
+ K.AUTH_EXPIRED,
119
+ K.AUTH_DENIED,
120
+ K.DIVERGED,
121
+ K.TRANSIENT,
122
+ ]);
123
+
124
+ export const DoltVCS = Object.freeze({
125
+ name: 'dolt',
126
+ extends: null,
127
+ precedence: PRECEDENCE,
128
+ rules: Object.freeze({
129
+ [K.NO_REMOTE]: NO_REMOTE,
130
+ [K.EMPTY_REMOTE]: EMPTY_REMOTE,
131
+ [K.REMOTE_UNREACHABLE]: REMOTE_UNREACHABLE,
132
+ [K.AUTH_EXPIRED]: AUTH_EXPIRED,
133
+ [K.DIVERGED]: DIVERGED,
134
+ [K.TRANSIENT]: TRANSIENT,
135
+ }),
136
+ /** Dolt stderr carries no vendor error code today. */
137
+ extractProviderCode() {
138
+ return null;
139
+ },
140
+ // Deliberately NO matchesHost/capabilitiesForHost: Dolt is a beads-sync
141
+ // backend, not a git-remote PR-hosting provider, so it must never be a
142
+ // candidate in VCSModule.capabilities()'s host dispatch
143
+ // (resolveVcsProviderForHost skips any provider with no matchesHost).
144
+ });
145
+
146
+ export default DoltVCS;
@@ -0,0 +1,176 @@
1
+ /**
2
+ * GenericGitVCS -- the portable base provider for VCSModule.classifyFailure().
3
+ *
4
+ * Owns ONLY the texts any git/OpenSSH client emits regardless of who hosts the
5
+ * remote. Anything with a vendor's name, product literal or error code in it
6
+ * belongs in that vendor's provider file (see ./github.mjs), never here.
7
+ *
8
+ * Every provider file has this exact shape, and adding a provider means adding
9
+ * one more file like it (plus one registration line in ./index.mjs) -- never a
10
+ * change to classifyFailure's dispatch contract:
11
+ *
12
+ * {
13
+ * name: string // the `provider` value callers pass
14
+ * extends: string|null // provider whose rules are inherited
15
+ * rules: { [VCS_FAILURE_KIND]: RegExp[] }
16
+ * precedence: string[]|undefined // optional kind-check order override
17
+ * extractProviderCode: (raw) => string|null
18
+ * }
19
+ *
20
+ * PURITY: every regex here is non-global on purpose. A module-level /g regex
21
+ * retains `lastIndex` between calls, which would make classifyFailure return
22
+ * different answers for the same input on successive calls.
23
+ *
24
+ * PARITY CONSTRAINT (apra-fleet-647.1.3.1 AC2): the DIVERGED and TRANSIENT
25
+ * tables below are runner.js's GIT_DIVERGED_PATTERNS / GIT_TRANSIENT_PATTERNS
26
+ * verbatim, and the AUTH tables are the six PORTABLE members of
27
+ * GIT_AUTH_PATTERNS / DOLT_AUTH_PATTERNS (those two lists are identical; their
28
+ * two remaining members are GitHub literals and live in ./github.mjs). This is
29
+ * what lets apra-fleet-647.1.3.2 delete those tables and delegate with no
30
+ * verdict change.
31
+ *
32
+ * DELIBERATELY NOT FOLDED IN: dolt-sync.mjs's DOLT_TRANSIENT_PATTERNS is
33
+ * BROADER than the git set (bare /lock/i, /database is locked/i, /dial tcp/i,
34
+ * /connection refused/i, /server (is )?(starting|not ready|unavailable)/i,
35
+ * /unable to (access|connect)/i), and dolt has two extra classes with no
36
+ * neutral kind yet (empty-remote, remote-unreachable). Folding dolt's wider
37
+ * transient set in here would silently widen GIT classification -- a git stderr
38
+ * merely containing "lock" is 'unknown' (never retried) today and would start
39
+ * being retried. A dolt delegation must add its own provider file and the two
40
+ * missing kinds; it must not widen this one.
41
+ *
42
+ * ASCII only.
43
+ */
44
+
45
+ import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
46
+
47
+ /** Non-fast-forward / unmerged / conflicted. Verbatim GIT_DIVERGED_PATTERNS. */
48
+ const DIVERGED = [
49
+ /not possible to fast-forward/i,
50
+ /non-fast-forward/i,
51
+ /fast-forwards? are not allowed/i,
52
+ /\[rejected\]/i,
53
+ /failed to push some refs/i,
54
+ /updates were rejected/i,
55
+ /unmerged/i,
56
+ /needs merge/i,
57
+ /would be overwritten/i,
58
+ /^conflict/im,
59
+ /automatic merge failed/i,
60
+ /have diverged/i,
61
+ ];
62
+
63
+ /** Credential missing / stale / rejected as invalid -- re-provisioning can fix
64
+ * it. git and OpenSSH emit all of these with no vendor involvement: the first
65
+ * three are git's credential-helper prompts (or their suppression), and the
66
+ * last is git's own refusal text for basic-auth-over-HTTPS.
67
+ *
68
+ * apra-fleet-417.6: 'remote: 401 Unauthorized' is Gitea's literal in the
69
+ * 647.1.3 epic's provider list, but the text itself is a bare HTTP status
70
+ * with no vendor name or product literal in it -- exactly the kind of entry
71
+ * this file's header says belongs here rather than in a dedicated
72
+ * gitea.mjs. HTTP's own semantics pick the AUTH_* split: 401 means "you did
73
+ * not authenticate" (no/expired/invalid credential -- re-provisioning is the
74
+ * fix), as opposed to 403 ("you authenticated fine, but you may not do
75
+ * this" -- see AUTH_DENIED below). No dedicated Gitea provider file/registry
76
+ * entry is added for this: registering a classification-only 'gitea'
77
+ * provider would flip buildVcsCommand()'s unknown-provider error for it from
78
+ * "unsupported VCS provider" to "does not yet implement action", which is
79
+ * not this bead's scope. */
80
+ const AUTH_EXPIRED = [
81
+ /could not read Username for/i,
82
+ /could not read Password for/i,
83
+ /terminal prompts disabled/i,
84
+ /Authentication failed/i,
85
+ /support for password authentication was removed/i,
86
+ /remote:\s*401 Unauthorized/i,
87
+ ];
88
+
89
+ /** Identity understood, access refused. OpenSSH offered a key and the server
90
+ * rejected it: minting the same credential again cannot help.
91
+ *
92
+ * apra-fleet-417.6: 'remote: HTTP Basic: Access denied' is GitLab's literal
93
+ * in the 647.1.3 epic's provider list, but -- same rationale as the 401
94
+ * entry above -- it names no vendor and is the generic Apache/git-http-
95
+ * backend basic-auth refusal text, so it lives here rather than in a
96
+ * dedicated gitlab.mjs (no registered 'gitlab' provider is added for the
97
+ * same buildVcsCommand()-error-shape reason documented on AUTH_EXPIRED
98
+ * above). The literal says "Access denied", not "expired"/"invalid" --
99
+ * HTTP's 403-shaped refusal, not a 401 -- so AUTH_DENIED, not
100
+ * AUTH_EXPIRED. */
101
+ const AUTH_DENIED = [
102
+ /Permission denied \(publickey\)/i,
103
+ /HTTP Basic:\s*Access denied/i,
104
+ ];
105
+
106
+ /** Network / lock blips a plain retry can clear. Verbatim
107
+ * GIT_TRANSIENT_PATTERNS -- including the two dispatch-channel texts, which
108
+ * are a transient failure of the fleet transport rather than of git, and must
109
+ * be retried rather than left 'unknown' (which is sprint-fatal). */
110
+ const TRANSIENT = [
111
+ /could not resolve host/i,
112
+ /unable to access/i,
113
+ /connection (timed out|reset|refused)/i,
114
+ /operation timed out/i,
115
+ /\btimed out\b/i,
116
+ /\btimeout\b/i,
117
+ /temporary failure/i,
118
+ /early eof/i,
119
+ /rpc failed/i,
120
+ /the remote end hung up/i,
121
+ /index\.lock/i,
122
+ /unable to create '.*lock'/i,
123
+ /cannot lock ref/i,
124
+ /ssh_exchange_identification/i,
125
+ /transport failure while executing command/i,
126
+ /fetch failed/i,
127
+ ];
128
+
129
+ /** No remote configured at all -- nothing to push or pull. Kept narrow on
130
+ * purpose: these must never swallow a real failure that merely mentions the
131
+ * word "remote". */
132
+ const NO_REMOTE = [
133
+ /error 1105.*no remote/i,
134
+ /\bno remote\b/i,
135
+ /no such remote/i,
136
+ ];
137
+
138
+ /** VCSModule's OWN refusal texts (vcs-module.mjs buildVcsCommand). Kept to
139
+ * exactly those two literals -- a broad /not supported/i would capture
140
+ * unrelated remote chatter. */
141
+ const UNSUPPORTED_OPERATION = [
142
+ /unsupported VCS provider/i,
143
+ /does not yet implement action/i,
144
+ ];
145
+
146
+ export const GenericGitVCS = Object.freeze({
147
+ name: 'generic-git',
148
+ extends: null,
149
+ rules: Object.freeze({
150
+ [K.DIVERGED]: DIVERGED,
151
+ [K.AUTH_EXPIRED]: AUTH_EXPIRED,
152
+ [K.AUTH_DENIED]: AUTH_DENIED,
153
+ [K.TRANSIENT]: TRANSIENT,
154
+ [K.NO_REMOTE]: NO_REMOTE,
155
+ [K.UNSUPPORTED_OPERATION]: UNSUPPORTED_OPERATION,
156
+ }),
157
+ /** Portable git stderr carries no vendor error code. */
158
+ extractProviderCode() {
159
+ return null;
160
+ },
161
+ /** Catch-all for VCSModule.capabilities() host dispatch (apra-fleet-
162
+ * 647.1.4.1): every resolvable host matches SOME provider, and this is
163
+ * the fallback when no more specific provider (e.g. GitHubVCS) claims
164
+ * it, so resolveVcsProviderForHost() never returns nothing. */
165
+ matchesHost() {
166
+ return true;
167
+ },
168
+ /** No REST create-pull-request implementation exists for a generic/
169
+ * unrecognized host (Azure DevOps, GitLab, or anything else VCSModule
170
+ * has no provider for yet) -- fails closed, never guesses a vendor. */
171
+ capabilitiesForHost() {
172
+ return { canOpenPullRequest: false };
173
+ },
174
+ });
175
+
176
+ export default GenericGitVCS;
@@ -0,0 +1,222 @@
1
+ /**
2
+ * GitHubVCS -- the GitHub provider for VCSModule.classifyFailure(), and (apra-
3
+ * fleet-647.1.5.1) THE manifest entry for everything else GitHub-specific:
4
+ * its default auth mode and its create-pull-request/comment command builders.
5
+ * Before 647.1.5.1 those lived in two separate provider-name-keyed tables in
6
+ * vcs-module.mjs (BUILDERS, DEFAULT_AUTH_MODES) that a new provider had to
7
+ * also edit; now they are fields on THIS descriptor, so adding a provider is
8
+ * one file here, nothing in vcs-module.mjs.
9
+ *
10
+ * Owns ONLY GitHub's own literals and inherits everything portable from
11
+ * GenericGitVCS via `extends` (a GitHub push still fails with plain git and
12
+ * OpenSSH texts, so those must not be duplicated here). Inherited patterns are
13
+ * checked too; this file's patterns are checked FIRST within each kind, so a
14
+ * provider can always sharpen a base verdict without editing the base.
15
+ *
16
+ * PARITY NOTE (apra-fleet-647.1.3.1 AC2): the two members of runner.js's
17
+ * GIT_AUTH_PATTERNS / DOLT_AUTH_PATTERNS that are GitHub-specific live here.
18
+ * Together with GenericGitVCS's six, `provider: 'github'` reproduces those
19
+ * lists EXACTLY -- which is why 'github' is classifyFailure's default provider
20
+ * (see vcs-module.mjs): runner.js applies the full eight unconditionally today,
21
+ * so anything less would be a verdict regression for apra-fleet-647.1.3.2.
22
+ *
23
+ * PURITY: non-global regexes only -- see the note in ./generic-git.mjs.
24
+ *
25
+ * ASCII only.
26
+ */
27
+
28
+ import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
29
+
30
+ const GITHUB_API = 'https://api.github.com';
31
+ const REDACTED = '***REDACTED***';
32
+ const REPO_RE = /^[\w.-]+\/[\w.-]+$/;
33
+
34
+ /** Single-quote a string for embedding in a POSIX shell command,
35
+ * closing/reopening the quote around any embedded single quotes. */
36
+ function shQuote(value) {
37
+ return `'${String(value).replace(/'/g, `'\\''`)}'`;
38
+ }
39
+
40
+ function assertRepo(repo) {
41
+ const value = String(repo ?? '').trim();
42
+ if (!REPO_RE.test(value)) {
43
+ throw new Error(`ERROR: VCSModule: invalid repo "${repo}" -- expected "owner/name" (e.g. "Apra-Labs/apra-fleet").`);
44
+ }
45
+ return value;
46
+ }
47
+
48
+ function assertToken(token) {
49
+ const value = String(token ?? '');
50
+ if (!value) {
51
+ throw new Error('ERROR: VCSModule: no token supplied -- caller must mint one via provision_vcs_auth before calling VCSModule.');
52
+ }
53
+ return value;
54
+ }
55
+
56
+ /** Build the GitHub REST "create pull request" curl command.
57
+ * POST /repos/{owner}/{repo}/pulls -- see
58
+ * https://docs.github.com/en/rest/pulls/pulls#create-a-pull-request */
59
+ function buildGitHubCreatePrCommand({ repo, base, head, title, body, token }) {
60
+ const safeRepo = assertRepo(repo);
61
+ const safeToken = assertToken(token);
62
+ if (!base) throw new Error('ERROR: VCSModule: "base" branch is required to build a create-pull-request command.');
63
+ if (!head) throw new Error('ERROR: VCSModule: "head" branch is required to build a create-pull-request command.');
64
+ if (!title) throw new Error('ERROR: VCSModule: "title" is required to build a create-pull-request command.');
65
+
66
+ const payload = { title, head, base };
67
+ if (body !== undefined) payload.body = body;
68
+ const payloadJson = JSON.stringify(payload);
69
+ const url = `${GITHUB_API}/repos/${safeRepo}/pulls`;
70
+
71
+ const buildCurl = (authToken) => [
72
+ 'curl -sS -X POST',
73
+ `-H ${shQuote(`Authorization: Bearer ${authToken}`)}`,
74
+ `-H ${shQuote('Accept: application/vnd.github+json')}`,
75
+ `-H ${shQuote('Content-Type: application/json')}`,
76
+ `-H ${shQuote('X-GitHub-Api-Version: 2022-11-28')}`,
77
+ `-d ${shQuote(payloadJson)}`,
78
+ `-w ${shQuote('\n%{http_code}')}`,
79
+ url,
80
+ ].join(' ');
81
+
82
+ return {
83
+ provider: 'github',
84
+ action: 'create-pull-request',
85
+ command: buildCurl(safeToken),
86
+ logSafeCommand: buildCurl(REDACTED),
87
+ // Interpretation contract mirrors the reverted server-side tool
88
+ // (src/tools/create-pull-request.ts) so callers migrating to
89
+ // VCSModule keep the same success/already-exists/error semantics:
90
+ // - 2xx -> success; body has .number/.html_url
91
+ // - 422 + "already exists" text -> idempotent success
92
+ // - anything else -> error
93
+ interpret: {
94
+ successStatusRange: [200, 299],
95
+ alreadyExistsStatus: 422,
96
+ alreadyExistsPattern: 'already exists',
97
+ },
98
+ };
99
+ }
100
+
101
+ /** Build the GitHub REST "comment on an issue/PR" curl command, used to
102
+ * annotate an existing PR when a sprint aborts after the PR was already
103
+ * raised (rather than opening a second PR for the same head).
104
+ * POST /repos/{owner}/{repo}/issues/{issue_number}/comments -- see
105
+ * https://docs.github.com/en/rest/issues/comments#create-an-issue-comment */
106
+ function buildGitHubCommentCommand({ repo, issue_number: issueNumber, body, token }) {
107
+ const safeRepo = assertRepo(repo);
108
+ const safeToken = assertToken(token);
109
+ if (!issueNumber) throw new Error('ERROR: VCSModule: "issue_number" is required to build a comment command.');
110
+ if (!body) throw new Error('ERROR: VCSModule: "body" is required to build a comment command.');
111
+
112
+ const payloadJson = JSON.stringify({ body });
113
+ const url = `${GITHUB_API}/repos/${safeRepo}/issues/${issueNumber}/comments`;
114
+
115
+ const buildCurl = (authToken) => [
116
+ 'curl -sS -X POST',
117
+ `-H ${shQuote(`Authorization: Bearer ${authToken}`)}`,
118
+ `-H ${shQuote('Accept: application/vnd.github+json')}`,
119
+ `-H ${shQuote('Content-Type: application/json')}`,
120
+ `-H ${shQuote('X-GitHub-Api-Version: 2022-11-28')}`,
121
+ `-d ${shQuote(payloadJson)}`,
122
+ `-w ${shQuote('\n%{http_code}')}`,
123
+ url,
124
+ ].join(' ');
125
+
126
+ return {
127
+ provider: 'github',
128
+ action: 'comment',
129
+ command: buildCurl(safeToken),
130
+ logSafeCommand: buildCurl(REDACTED),
131
+ interpret: {
132
+ successStatusRange: [200, 299],
133
+ },
134
+ };
135
+ }
136
+
137
+ /** GitHub's credential-rejection literals. "remote: Invalid username or
138
+ * token/password" is what a git push over HTTPS gets back from GitHub with a
139
+ * dead PAT; "Bad credentials" is the REST API's equivalent, which reaches us
140
+ * through the curl commands VCSModule builds. Both mean the token itself is
141
+ * no longer good -- re-provisioning is the remedy, so AUTH_EXPIRED. */
142
+ const AUTH_EXPIRED = [
143
+ /remote: Invalid username or (token|password)/i,
144
+ /Bad credentials/i,
145
+ ];
146
+
147
+ // DELIBERATELY ABSENT, and not an oversight: GitHub texts that are NOT in
148
+ // runner.js's pattern tables today -- scope/permission refusals ("Resource not
149
+ // accessible by integration", the vague "remote: Repository not found" for a
150
+ // private repo) and throttling ("API rate limit exceeded", "secondary rate
151
+ // limit"). Each classifies as 'unknown' today, so adding it here would CHANGE
152
+ // the verdict apra-fleet-647.1.3.2 must preserve: a rate-limit text would newly
153
+ // become retryable, a permission refusal would newly trigger the auth
154
+ // self-heal. Widening the taxonomy is a real behavior change and belongs in its
155
+ // own bead with its own tests, not smuggled in under a no-verdict-change
156
+ // consolidation.
157
+
158
+ /** Best-effort GitHub provider code, purely DIAGNOSTIC: never branch on it --
159
+ * branch on `kind`. Returns the HTTP status git/curl surfaced (e.g. '403'
160
+ * from git's "The requested URL returned error: 403", or the trailing status
161
+ * code the VCSModule curl commands append via -w '\n%{http_code}'), else null.
162
+ *
163
+ * Constructed in-function rather than hoisted: these are exec/match calls on
164
+ * patterns that must never carry `lastIndex` state between classifyFailure
165
+ * calls (AC3 purity).
166
+ */
167
+ function extractProviderCode(raw) {
168
+ const text = String(raw == null ? '' : raw);
169
+ const urlError = text.match(/requested URL returned error:\s*(\d{3})/i);
170
+ if (urlError) return urlError[1];
171
+ const httpStatus = text.match(/\bHTTP(?:\/[\d.]+)?\s+(\d{3})\b/);
172
+ if (httpStatus) return httpStatus[1];
173
+ const trailing = text.match(/(?:^|\n)\s*(\d{3})\s*$/);
174
+ if (trailing) return trailing[1];
175
+ return null;
176
+ }
177
+
178
+ /** Host-recognition for VCSModule.capabilities() (apra-fleet-647.1.4.1).
179
+ * `github.com` itself plus GitHub Enterprise Server hosts, which have no
180
+ * fixed domain -- an operator names theirs anything ("github.mycompany.com",
181
+ * "ghe.internal", ...) -- so there is no closed literal list to match
182
+ * against. The portable signal every such host shares is the vendor name
183
+ * itself appearing in the hostname; a host with no "github" substring (Azure
184
+ * DevOps' dev.azure.com, GitLab's gitlab.com or a self-hosted
185
+ * gitlab.example.com, ...) is deliberately left to GenericGitVCS's
186
+ * catch-all rather than guessed at here. */
187
+ function matchesHost(host) {
188
+ return typeof host === 'string' && /github/i.test(host);
189
+ }
190
+
191
+ /** Every host this provider matches can open a PR via the REST call
192
+ * buildGitHubCreatePrCommand() builds -- github.com and GitHub Enterprise
193
+ * Server alike speak the same `/repos/{owner}/{repo}/pulls` shape. */
194
+ function capabilitiesForHost(_host) {
195
+ return { canOpenPullRequest: true };
196
+ }
197
+
198
+ export const GitHubVCS = Object.freeze({
199
+ name: 'github',
200
+ extends: 'generic-git',
201
+ rules: Object.freeze({
202
+ [K.AUTH_EXPIRED]: AUTH_EXPIRED,
203
+ }),
204
+ extractProviderCode,
205
+ matchesHost,
206
+ capabilitiesForHost,
207
+ // apra-fleet-647.1.5.1: GitHub's own default auth mode (App, never PAT --
208
+ // see vcs-module.mjs resolveProvider()'s header note on why this must stay
209
+ // 'github-app') and its command builders. A provider descriptor need not
210
+ // declare `defaultAuthMode`/`builders` at all (see ./generic-git.mjs,
211
+ // ./dolt.mjs -- classification-only providers that are not a member-facing
212
+ // VCS auth backend); declaring `defaultAuthMode` (even as `null`) is what
213
+ // makes a provider part of resolveProvider()'s/buildVcsCommand()'s known
214
+ // vocabulary -- see ./index.mjs's isAuthBackend().
215
+ defaultAuthMode: 'github-app',
216
+ builders: Object.freeze({
217
+ 'create-pull-request': buildGitHubCreatePrCommand,
218
+ comment: buildGitHubCommentCommand,
219
+ }),
220
+ });
221
+
222
+ export default GitHubVCS;