@apralabs/apra-fleet 0.3.6 → 0.4.1

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 (826) hide show
  1. package/README.md +378 -252
  2. package/dist/agents/backlog-groomer.md +303 -0
  3. package/dist/agents/ci-watcher.md +13 -1
  4. package/dist/agents/deployer.md +66 -13
  5. package/dist/agents/doer.md +67 -8
  6. package/dist/agents/harvester.md +22 -3
  7. package/dist/agents/integ-test-runner.md +166 -60
  8. package/dist/agents/kb-reconciler.md +216 -0
  9. package/dist/agents/plan-reviewer.md +88 -18
  10. package/dist/agents/planner.md +182 -19
  11. package/dist/agents/regression-test-runner.md +234 -0
  12. package/dist/agents/reviewer.md +125 -9
  13. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  14. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  15. package/dist/agents/schemas/doer-output.json +63 -3
  16. package/dist/agents/schemas/harvester-output.json +59 -2
  17. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  18. package/dist/agents/schemas/kb-reconciler-output.json +87 -0
  19. package/dist/agents/schemas/planner-output.json +65 -0
  20. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  21. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  22. package/dist/agents/schemas/reviewer-output.json +108 -7
  23. package/dist/cli/agent-transform.d.ts +1 -0
  24. package/dist/cli/agent-transform.d.ts.map +1 -1
  25. package/dist/cli/agent-transform.js +77 -0
  26. package/dist/cli/agent-transform.js.map +1 -1
  27. package/dist/cli/auth.d.ts +3 -0
  28. package/dist/cli/auth.d.ts.map +1 -1
  29. package/dist/cli/auth.js +181 -5
  30. package/dist/cli/auth.js.map +1 -1
  31. package/dist/cli/config.d.ts +5 -1
  32. package/dist/cli/config.d.ts.map +1 -1
  33. package/dist/cli/config.js +7 -1
  34. package/dist/cli/config.js.map +1 -1
  35. package/dist/cli/dolt-install.d.ts +91 -0
  36. package/dist/cli/dolt-install.d.ts.map +1 -0
  37. package/dist/cli/dolt-install.js +334 -0
  38. package/dist/cli/dolt-install.js.map +1 -0
  39. package/dist/cli/install-guard.d.ts +29 -0
  40. package/dist/cli/install-guard.d.ts.map +1 -0
  41. package/dist/cli/install-guard.js +153 -0
  42. package/dist/cli/install-guard.js.map +1 -0
  43. package/dist/cli/install.d.ts +45 -3
  44. package/dist/cli/install.d.ts.map +1 -1
  45. package/dist/cli/install.js +736 -109
  46. package/dist/cli/install.js.map +1 -1
  47. package/dist/cli/join.d.ts +12 -0
  48. package/dist/cli/join.d.ts.map +1 -0
  49. package/dist/cli/join.js +87 -0
  50. package/dist/cli/join.js.map +1 -0
  51. package/dist/cli/kb-commit.d.ts +12 -0
  52. package/dist/cli/kb-commit.d.ts.map +1 -0
  53. package/dist/cli/kb-commit.js +53 -0
  54. package/dist/cli/kb-commit.js.map +1 -0
  55. package/dist/cli/kb-directives.d.ts +17 -0
  56. package/dist/cli/kb-directives.d.ts.map +1 -0
  57. package/dist/cli/kb-directives.js +146 -0
  58. package/dist/cli/kb-directives.js.map +1 -0
  59. package/dist/cli/kb-import.d.ts +13 -0
  60. package/dist/cli/kb-import.d.ts.map +1 -0
  61. package/dist/cli/kb-import.js +56 -0
  62. package/dist/cli/kb-import.js.map +1 -0
  63. package/dist/cli/register-member.d.ts +2 -0
  64. package/dist/cli/register-member.d.ts.map +1 -0
  65. package/dist/cli/register-member.js +193 -0
  66. package/dist/cli/register-member.js.map +1 -0
  67. package/dist/cli/restart.d.ts +2 -0
  68. package/dist/cli/restart.d.ts.map +1 -0
  69. package/dist/cli/restart.js +7 -0
  70. package/dist/cli/restart.js.map +1 -0
  71. package/dist/cli/spoke.d.ts +35 -0
  72. package/dist/cli/spoke.d.ts.map +1 -0
  73. package/dist/cli/spoke.js +212 -0
  74. package/dist/cli/spoke.js.map +1 -0
  75. package/dist/cli/start.d.ts +2 -0
  76. package/dist/cli/start.d.ts.map +1 -0
  77. package/dist/cli/start.js +92 -0
  78. package/dist/cli/start.js.map +1 -0
  79. package/dist/cli/status.d.ts +2 -0
  80. package/dist/cli/status.d.ts.map +1 -0
  81. package/dist/cli/status.js +83 -0
  82. package/dist/cli/status.js.map +1 -0
  83. package/dist/cli/stop.d.ts +2 -0
  84. package/dist/cli/stop.d.ts.map +1 -0
  85. package/dist/cli/stop.js +51 -0
  86. package/dist/cli/stop.js.map +1 -0
  87. package/dist/cli/uninstall.d.ts.map +1 -1
  88. package/dist/cli/uninstall.js +120 -9
  89. package/dist/cli/uninstall.js.map +1 -1
  90. package/dist/cli/update.d.ts.map +1 -1
  91. package/dist/cli/update.js +10 -1
  92. package/dist/cli/update.js.map +1 -1
  93. package/dist/cli/watch.d.ts +53 -4
  94. package/dist/cli/watch.d.ts.map +1 -1
  95. package/dist/cli/watch.js +118 -17
  96. package/dist/cli/watch.js.map +1 -1
  97. package/dist/cli/workflow-assets.d.ts +37 -0
  98. package/dist/cli/workflow-assets.d.ts.map +1 -0
  99. package/dist/cli/workflow-assets.js +144 -0
  100. package/dist/cli/workflow-assets.js.map +1 -0
  101. package/dist/cli/workflow.d.ts +75 -0
  102. package/dist/cli/workflow.d.ts.map +1 -0
  103. package/dist/cli/workflow.js +397 -0
  104. package/dist/cli/workflow.js.map +1 -0
  105. package/dist/commands/kb-server.d.ts +8 -0
  106. package/dist/commands/kb-server.d.ts.map +1 -0
  107. package/dist/commands/kb-server.js +221 -0
  108. package/dist/commands/kb-server.js.map +1 -0
  109. package/dist/hub-service/activity.d.ts +30 -0
  110. package/dist/hub-service/activity.d.ts.map +1 -0
  111. package/dist/hub-service/activity.js +20 -0
  112. package/dist/hub-service/activity.js.map +1 -0
  113. package/dist/hub-service/audit-log.d.ts +19 -0
  114. package/dist/hub-service/audit-log.d.ts.map +1 -0
  115. package/dist/hub-service/audit-log.js +13 -0
  116. package/dist/hub-service/audit-log.js.map +1 -0
  117. package/dist/hub-service/db/pool.d.ts +19 -0
  118. package/dist/hub-service/db/pool.d.ts.map +1 -0
  119. package/dist/hub-service/db/pool.js +53 -0
  120. package/dist/hub-service/db/pool.js.map +1 -0
  121. package/dist/hub-service/enrollment.d.ts +29 -0
  122. package/dist/hub-service/enrollment.d.ts.map +1 -0
  123. package/dist/hub-service/enrollment.js +48 -0
  124. package/dist/hub-service/enrollment.js.map +1 -0
  125. package/dist/hub-service/envelope-routes.d.ts +46 -0
  126. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  127. package/dist/hub-service/envelope-routes.js +94 -0
  128. package/dist/hub-service/envelope-routes.js.map +1 -0
  129. package/dist/hub-service/handlers/installers.d.ts +14 -0
  130. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  131. package/dist/hub-service/handlers/installers.js +8 -0
  132. package/dist/hub-service/handlers/installers.js.map +1 -0
  133. package/dist/hub-service/http-server.d.ts +31 -0
  134. package/dist/hub-service/http-server.d.ts.map +1 -0
  135. package/dist/hub-service/http-server.js +711 -0
  136. package/dist/hub-service/http-server.js.map +1 -0
  137. package/dist/hub-service/hub-jwt.d.ts +30 -0
  138. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  139. package/dist/hub-service/hub-jwt.js +105 -0
  140. package/dist/hub-service/hub-jwt.js.map +1 -0
  141. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  142. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  143. package/dist/hub-service/jwt-revocation.js +18 -0
  144. package/dist/hub-service/jwt-revocation.js.map +1 -0
  145. package/dist/hub-service/machines.d.ts +16 -0
  146. package/dist/hub-service/machines.d.ts.map +1 -0
  147. package/dist/hub-service/machines.js +14 -0
  148. package/dist/hub-service/machines.js.map +1 -0
  149. package/dist/hub-service/main.d.ts +3 -0
  150. package/dist/hub-service/main.d.ts.map +1 -0
  151. package/dist/hub-service/main.js +64 -0
  152. package/dist/hub-service/main.js.map +1 -0
  153. package/dist/hub-service/member-tokens.d.ts +11 -0
  154. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  155. package/dist/hub-service/member-tokens.js +49 -0
  156. package/dist/hub-service/member-tokens.js.map +1 -0
  157. package/dist/hub-service/member-view.d.ts +20 -0
  158. package/dist/hub-service/member-view.d.ts.map +1 -0
  159. package/dist/hub-service/member-view.js +76 -0
  160. package/dist/hub-service/member-view.js.map +1 -0
  161. package/dist/hub-service/members.d.ts +44 -0
  162. package/dist/hub-service/members.d.ts.map +1 -0
  163. package/dist/hub-service/members.js +25 -0
  164. package/dist/hub-service/members.js.map +1 -0
  165. package/dist/hub-service/presence.d.ts +40 -0
  166. package/dist/hub-service/presence.d.ts.map +1 -0
  167. package/dist/hub-service/presence.js +44 -0
  168. package/dist/hub-service/presence.js.map +1 -0
  169. package/dist/hub-service/project-view.d.ts +12 -0
  170. package/dist/hub-service/project-view.d.ts.map +1 -0
  171. package/dist/hub-service/project-view.js +34 -0
  172. package/dist/hub-service/project-view.js.map +1 -0
  173. package/dist/hub-service/projects.d.ts +48 -0
  174. package/dist/hub-service/projects.d.ts.map +1 -0
  175. package/dist/hub-service/projects.js +80 -0
  176. package/dist/hub-service/projects.js.map +1 -0
  177. package/dist/hub-service/relay-queue.d.ts +115 -0
  178. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  179. package/dist/hub-service/relay-queue.js +148 -0
  180. package/dist/hub-service/relay-queue.js.map +1 -0
  181. package/dist/hub-service/session-jwt.d.ts +10 -0
  182. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  183. package/dist/hub-service/session-jwt.js +69 -0
  184. package/dist/hub-service/session-jwt.js.map +1 -0
  185. package/dist/hub-service/usage.d.ts +40 -0
  186. package/dist/hub-service/usage.d.ts.map +1 -0
  187. package/dist/hub-service/usage.js +25 -0
  188. package/dist/hub-service/usage.js.map +1 -0
  189. package/dist/hub-service/users.d.ts +56 -0
  190. package/dist/hub-service/users.d.ts.map +1 -0
  191. package/dist/hub-service/users.js +72 -0
  192. package/dist/hub-service/users.js.map +1 -0
  193. package/dist/hub-service/workspaces.d.ts +20 -0
  194. package/dist/hub-service/workspaces.d.ts.map +1 -0
  195. package/dist/hub-service/workspaces.js +10 -0
  196. package/dist/hub-service/workspaces.js.map +1 -0
  197. package/dist/index.js +254 -132
  198. package/dist/index.js.map +1 -1
  199. package/dist/os/linux.d.ts +14 -0
  200. package/dist/os/linux.d.ts.map +1 -1
  201. package/dist/os/linux.js +80 -4
  202. package/dist/os/linux.js.map +1 -1
  203. package/dist/os/os-commands.d.ts +15 -0
  204. package/dist/os/os-commands.d.ts.map +1 -1
  205. package/dist/os/windows.d.ts +36 -0
  206. package/dist/os/windows.d.ts.map +1 -1
  207. package/dist/os/windows.js +74 -18
  208. package/dist/os/windows.js.map +1 -1
  209. package/dist/paths.d.ts +23 -0
  210. package/dist/paths.d.ts.map +1 -1
  211. package/dist/paths.js +29 -0
  212. package/dist/paths.js.map +1 -1
  213. package/dist/providers/agy.d.ts +20 -2
  214. package/dist/providers/agy.d.ts.map +1 -1
  215. package/dist/providers/agy.js +259 -21
  216. package/dist/providers/agy.js.map +1 -1
  217. package/dist/providers/claude.d.ts +16 -2
  218. package/dist/providers/claude.d.ts.map +1 -1
  219. package/dist/providers/claude.js +283 -16
  220. package/dist/providers/claude.js.map +1 -1
  221. package/dist/providers/codex.d.ts +13 -2
  222. package/dist/providers/codex.d.ts.map +1 -1
  223. package/dist/providers/codex.js +36 -6
  224. package/dist/providers/codex.js.map +1 -1
  225. package/dist/providers/copilot.d.ts +13 -2
  226. package/dist/providers/copilot.d.ts.map +1 -1
  227. package/dist/providers/copilot.js +34 -7
  228. package/dist/providers/copilot.js.map +1 -1
  229. package/dist/providers/email/headers.d.ts +15 -0
  230. package/dist/providers/email/headers.d.ts.map +1 -0
  231. package/dist/providers/email/headers.js +42 -0
  232. package/dist/providers/email/headers.js.map +1 -0
  233. package/dist/providers/email/index.d.ts +18 -0
  234. package/dist/providers/email/index.d.ts.map +1 -0
  235. package/dist/providers/email/index.js +60 -0
  236. package/dist/providers/email/index.js.map +1 -0
  237. package/dist/providers/email/provider.d.ts +49 -0
  238. package/dist/providers/email/provider.d.ts.map +1 -0
  239. package/dist/providers/email/provider.js +2 -0
  240. package/dist/providers/email/provider.js.map +1 -0
  241. package/dist/providers/email/sendgrid.d.ts +12 -0
  242. package/dist/providers/email/sendgrid.d.ts.map +1 -0
  243. package/dist/providers/email/sendgrid.js +67 -0
  244. package/dist/providers/email/sendgrid.js.map +1 -0
  245. package/dist/providers/email/smtp.d.ts +65 -0
  246. package/dist/providers/email/smtp.d.ts.map +1 -0
  247. package/dist/providers/email/smtp.js +373 -0
  248. package/dist/providers/email/smtp.js.map +1 -0
  249. package/dist/providers/gemini.d.ts +13 -2
  250. package/dist/providers/gemini.d.ts.map +1 -1
  251. package/dist/providers/gemini.js +49 -5
  252. package/dist/providers/gemini.js.map +1 -1
  253. package/dist/providers/index.d.ts +1 -0
  254. package/dist/providers/index.d.ts.map +1 -1
  255. package/dist/providers/index.js +3 -0
  256. package/dist/providers/index.js.map +1 -1
  257. package/dist/providers/none.d.ts +61 -0
  258. package/dist/providers/none.d.ts.map +1 -0
  259. package/dist/providers/none.js +124 -0
  260. package/dist/providers/none.js.map +1 -0
  261. package/dist/providers/opencode.d.ts +14 -2
  262. package/dist/providers/opencode.d.ts.map +1 -1
  263. package/dist/providers/opencode.js +104 -4
  264. package/dist/providers/opencode.js.map +1 -1
  265. package/dist/providers/provider.d.ts +156 -1
  266. package/dist/providers/provider.d.ts.map +1 -1
  267. package/dist/providers/provider.js +54 -0
  268. package/dist/providers/provider.js.map +1 -1
  269. package/dist/services/agent-provisioner.d.ts +3 -3
  270. package/dist/services/agent-provisioner.d.ts.map +1 -1
  271. package/dist/services/agent-provisioner.js +11 -7
  272. package/dist/services/agent-provisioner.js.map +1 -1
  273. package/dist/services/auth-socket.d.ts.map +1 -1
  274. package/dist/services/auth-socket.js +2 -0
  275. package/dist/services/auth-socket.js.map +1 -1
  276. package/dist/services/budget-awareness.d.ts +130 -0
  277. package/dist/services/budget-awareness.d.ts.map +1 -0
  278. package/dist/services/budget-awareness.js +129 -0
  279. package/dist/services/budget-awareness.js.map +1 -0
  280. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  281. package/dist/services/cloud/lifecycle.js +3 -0
  282. package/dist/services/cloud/lifecycle.js.map +1 -1
  283. package/dist/services/cloud/task-wrapper.d.ts +18 -0
  284. package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
  285. package/dist/services/cloud/task-wrapper.js +157 -0
  286. package/dist/services/cloud/task-wrapper.js.map +1 -1
  287. package/dist/services/cloud-sync.d.ts +35 -0
  288. package/dist/services/cloud-sync.d.ts.map +1 -0
  289. package/dist/services/cloud-sync.js +90 -0
  290. package/dist/services/cloud-sync.js.map +1 -0
  291. package/dist/services/context-admission.d.ts +82 -0
  292. package/dist/services/context-admission.d.ts.map +1 -0
  293. package/dist/services/context-admission.js +136 -0
  294. package/dist/services/context-admission.js.map +1 -0
  295. package/dist/services/event-bus.d.ts +27 -0
  296. package/dist/services/event-bus.d.ts.map +1 -0
  297. package/dist/services/event-bus.js +20 -0
  298. package/dist/services/event-bus.js.map +1 -0
  299. package/dist/services/file-chunker.d.ts +38 -0
  300. package/dist/services/file-chunker.d.ts.map +1 -0
  301. package/dist/services/file-chunker.js +63 -0
  302. package/dist/services/file-chunker.js.map +1 -0
  303. package/dist/services/file-transfer-relay.d.ts +55 -0
  304. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  305. package/dist/services/file-transfer-relay.js +115 -0
  306. package/dist/services/file-transfer-relay.js.map +1 -0
  307. package/dist/services/github-app.d.ts.map +1 -1
  308. package/dist/services/github-app.js +12 -2
  309. package/dist/services/github-app.js.map +1 -1
  310. package/dist/services/http-transport.d.ts +25 -0
  311. package/dist/services/http-transport.d.ts.map +1 -0
  312. package/dist/services/http-transport.js +371 -0
  313. package/dist/services/http-transport.js.map +1 -0
  314. package/dist/services/hub-client.d.ts +69 -0
  315. package/dist/services/hub-client.d.ts.map +1 -0
  316. package/dist/services/hub-client.js +217 -0
  317. package/dist/services/hub-client.js.map +1 -0
  318. package/dist/services/jwt.d.ts +17 -0
  319. package/dist/services/jwt.d.ts.map +1 -0
  320. package/dist/services/jwt.js +70 -0
  321. package/dist/services/jwt.js.map +1 -0
  322. package/dist/services/knowledge/audn.d.ts +37 -0
  323. package/dist/services/knowledge/audn.d.ts.map +1 -0
  324. package/dist/services/knowledge/audn.js +219 -0
  325. package/dist/services/knowledge/audn.js.map +1 -0
  326. package/dist/services/knowledge/file-hash.d.ts +11 -0
  327. package/dist/services/knowledge/file-hash.d.ts.map +1 -0
  328. package/dist/services/knowledge/file-hash.js +123 -0
  329. package/dist/services/knowledge/file-hash.js.map +1 -0
  330. package/dist/services/knowledge/http-provider.d.ts +46 -0
  331. package/dist/services/knowledge/http-provider.d.ts.map +1 -0
  332. package/dist/services/knowledge/http-provider.js +254 -0
  333. package/dist/services/knowledge/http-provider.js.map +1 -0
  334. package/dist/services/knowledge/kb-providers.d.ts +15 -0
  335. package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
  336. package/dist/services/knowledge/kb-providers.js +92 -0
  337. package/dist/services/knowledge/kb-providers.js.map +1 -0
  338. package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
  339. package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
  340. package/dist/services/knowledge/kb-scope-input.js +11 -0
  341. package/dist/services/knowledge/kb-scope-input.js.map +1 -0
  342. package/dist/services/knowledge/kb-service.d.ts +3 -0
  343. package/dist/services/knowledge/kb-service.d.ts.map +1 -0
  344. package/dist/services/knowledge/kb-service.js +2 -0
  345. package/dist/services/knowledge/kb-service.js.map +1 -0
  346. package/dist/services/knowledge/path-validation.d.ts +2 -0
  347. package/dist/services/knowledge/path-validation.d.ts.map +1 -0
  348. package/dist/services/knowledge/path-validation.js +13 -0
  349. package/dist/services/knowledge/path-validation.js.map +1 -0
  350. package/dist/services/knowledge/pre-init.d.ts +14 -0
  351. package/dist/services/knowledge/pre-init.d.ts.map +1 -0
  352. package/dist/services/knowledge/pre-init.js +147 -0
  353. package/dist/services/knowledge/pre-init.js.map +1 -0
  354. package/dist/services/knowledge/project-slug.d.ts +2 -0
  355. package/dist/services/knowledge/project-slug.d.ts.map +1 -0
  356. package/dist/services/knowledge/project-slug.js +49 -0
  357. package/dist/services/knowledge/project-slug.js.map +1 -0
  358. package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
  359. package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
  360. package/dist/services/knowledge/sqlite-provider.js +1646 -0
  361. package/dist/services/knowledge/sqlite-provider.js.map +1 -0
  362. package/dist/services/knowledge/types.d.ts +163 -0
  363. package/dist/services/knowledge/types.d.ts.map +1 -0
  364. package/dist/services/knowledge/types.js +9 -0
  365. package/dist/services/knowledge/types.js.map +1 -0
  366. package/dist/services/known-sessions.d.ts +8 -0
  367. package/dist/services/known-sessions.d.ts.map +1 -0
  368. package/dist/services/known-sessions.js +40 -0
  369. package/dist/services/known-sessions.js.map +1 -0
  370. package/dist/services/member-home.d.ts +89 -0
  371. package/dist/services/member-home.d.ts.map +1 -0
  372. package/dist/services/member-home.js +256 -0
  373. package/dist/services/member-home.js.map +1 -0
  374. package/dist/services/member-remote-url.d.ts +34 -0
  375. package/dist/services/member-remote-url.d.ts.map +1 -0
  376. package/dist/services/member-remote-url.js +39 -0
  377. package/dist/services/member-remote-url.js.map +1 -0
  378. package/dist/services/model-pricing.d.ts +36 -0
  379. package/dist/services/model-pricing.d.ts.map +1 -0
  380. package/dist/services/model-pricing.js +108 -0
  381. package/dist/services/model-pricing.js.map +1 -0
  382. package/dist/services/orphan-recovery.d.ts +59 -0
  383. package/dist/services/orphan-recovery.d.ts.map +1 -0
  384. package/dist/services/orphan-recovery.js +122 -0
  385. package/dist/services/orphan-recovery.js.map +1 -0
  386. package/dist/services/pending-responses.d.ts +23 -0
  387. package/dist/services/pending-responses.d.ts.map +1 -0
  388. package/dist/services/pending-responses.js +52 -0
  389. package/dist/services/pending-responses.js.map +1 -0
  390. package/dist/services/preflight-check.d.ts +56 -0
  391. package/dist/services/preflight-check.d.ts.map +1 -0
  392. package/dist/services/preflight-check.js +277 -0
  393. package/dist/services/preflight-check.js.map +1 -0
  394. package/dist/services/registry.d.ts +4 -1
  395. package/dist/services/registry.d.ts.map +1 -1
  396. package/dist/services/registry.js +3 -0
  397. package/dist/services/registry.js.map +1 -1
  398. package/dist/services/relay-context.d.ts +23 -0
  399. package/dist/services/relay-context.d.ts.map +1 -0
  400. package/dist/services/relay-context.js +8 -0
  401. package/dist/services/relay-context.js.map +1 -0
  402. package/dist/services/relay-executor.d.ts +68 -0
  403. package/dist/services/relay-executor.d.ts.map +1 -0
  404. package/dist/services/relay-executor.js +70 -0
  405. package/dist/services/relay-executor.js.map +1 -0
  406. package/dist/services/relay-request.d.ts +65 -0
  407. package/dist/services/relay-request.d.ts.map +1 -0
  408. package/dist/services/relay-request.js +129 -0
  409. package/dist/services/relay-request.js.map +1 -0
  410. package/dist/services/relay-strategy.d.ts +19 -0
  411. package/dist/services/relay-strategy.d.ts.map +1 -0
  412. package/dist/services/relay-strategy.js +111 -0
  413. package/dist/services/relay-strategy.js.map +1 -0
  414. package/dist/services/service-manager/index.d.ts +5 -0
  415. package/dist/services/service-manager/index.d.ts.map +1 -0
  416. package/dist/services/service-manager/index.js +66 -0
  417. package/dist/services/service-manager/index.js.map +1 -0
  418. package/dist/services/service-manager/linux.d.ts +10 -0
  419. package/dist/services/service-manager/linux.d.ts.map +1 -0
  420. package/dist/services/service-manager/linux.js +97 -0
  421. package/dist/services/service-manager/linux.js.map +1 -0
  422. package/dist/services/service-manager/macos.d.ts +10 -0
  423. package/dist/services/service-manager/macos.d.ts.map +1 -0
  424. package/dist/services/service-manager/macos.js +94 -0
  425. package/dist/services/service-manager/macos.js.map +1 -0
  426. package/dist/services/service-manager/types.d.ts +18 -0
  427. package/dist/services/service-manager/types.d.ts.map +1 -0
  428. package/dist/services/service-manager/types.js +5 -0
  429. package/dist/services/service-manager/types.js.map +1 -0
  430. package/dist/services/service-manager/windows.d.ts +10 -0
  431. package/dist/services/service-manager/windows.d.ts.map +1 -0
  432. package/dist/services/service-manager/windows.js +73 -0
  433. package/dist/services/service-manager/windows.js.map +1 -0
  434. package/dist/services/session-registry.d.ts +70 -0
  435. package/dist/services/session-registry.d.ts.map +1 -0
  436. package/dist/services/session-registry.js +91 -0
  437. package/dist/services/session-registry.js.map +1 -0
  438. package/dist/services/singleton.d.ts +15 -0
  439. package/dist/services/singleton.d.ts.map +1 -0
  440. package/dist/services/singleton.js +98 -0
  441. package/dist/services/singleton.js.map +1 -0
  442. package/dist/services/sprint-coordination.d.ts +168 -0
  443. package/dist/services/sprint-coordination.d.ts.map +1 -0
  444. package/dist/services/sprint-coordination.js +564 -0
  445. package/dist/services/sprint-coordination.js.map +1 -0
  446. package/dist/services/ssh.d.ts.map +1 -1
  447. package/dist/services/ssh.js +70 -3
  448. package/dist/services/ssh.js.map +1 -1
  449. package/dist/services/stall/log-path-resolver.d.ts +11 -8
  450. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  451. package/dist/services/stall/log-path-resolver.js +17 -33
  452. package/dist/services/stall/log-path-resolver.js.map +1 -1
  453. package/dist/services/stall/stall-detector.d.ts +32 -0
  454. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  455. package/dist/services/stall/stall-detector.js +187 -12
  456. package/dist/services/stall/stall-detector.js.map +1 -1
  457. package/dist/services/stall/stall-poller.d.ts +50 -0
  458. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  459. package/dist/services/stall/stall-poller.js +268 -18
  460. package/dist/services/stall/stall-poller.js.map +1 -1
  461. package/dist/services/strategy.d.ts.map +1 -1
  462. package/dist/services/strategy.js +57 -7
  463. package/dist/services/strategy.js.map +1 -1
  464. package/dist/services/substitution-engine.d.ts +20 -0
  465. package/dist/services/substitution-engine.d.ts.map +1 -0
  466. package/dist/services/substitution-engine.js +92 -0
  467. package/dist/services/substitution-engine.js.map +1 -0
  468. package/dist/services/task-cleanup.d.ts.map +1 -1
  469. package/dist/services/task-cleanup.js +1 -9
  470. package/dist/services/task-cleanup.js.map +1 -1
  471. package/dist/services/token-issuer.d.ts +47 -0
  472. package/dist/services/token-issuer.d.ts.map +1 -0
  473. package/dist/services/token-issuer.js +63 -0
  474. package/dist/services/token-issuer.js.map +1 -0
  475. package/dist/services/tool-registry.d.ts +3 -0
  476. package/dist/services/tool-registry.d.ts.map +1 -0
  477. package/dist/services/tool-registry.js +225 -0
  478. package/dist/services/tool-registry.js.map +1 -0
  479. package/dist/services/user-config.d.ts +14 -0
  480. package/dist/services/user-config.d.ts.map +1 -1
  481. package/dist/services/user-config.js +55 -0
  482. package/dist/services/user-config.js.map +1 -1
  483. package/dist/services/vcs/github.d.ts.map +1 -1
  484. package/dist/services/vcs/github.js +32 -1
  485. package/dist/services/vcs/github.js.map +1 -1
  486. package/dist/services/vcs/types.d.ts +44 -0
  487. package/dist/services/vcs/types.d.ts.map +1 -1
  488. package/dist/services/version-check.d.ts +22 -0
  489. package/dist/services/version-check.d.ts.map +1 -0
  490. package/dist/services/version-check.js +103 -0
  491. package/dist/services/version-check.js.map +1 -0
  492. package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
  493. package/dist/skills/pm/beads.md +6 -0
  494. package/dist/skills/pm/cost.md +3 -0
  495. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  496. package/dist/skills/pm/fleet-addendum.md +6 -0
  497. package/dist/skills/pm/index.md +56 -0
  498. package/dist/skills/pm/kb-reconcile.md +132 -0
  499. package/dist/skills/pm/kb-review.md +109 -0
  500. package/dist/tools/check-status.d.ts +47 -0
  501. package/dist/tools/check-status.d.ts.map +1 -1
  502. package/dist/tools/check-status.js +250 -2
  503. package/dist/tools/check-status.js.map +1 -1
  504. package/dist/tools/child-id-allocator.d.ts +45 -0
  505. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  506. package/dist/tools/child-id-allocator.js +62 -0
  507. package/dist/tools/child-id-allocator.js.map +1 -0
  508. package/dist/tools/cloud-control.d.ts +2 -2
  509. package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
  510. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
  511. package/dist/tools/code-intelligence-codebase-memory.js +270 -0
  512. package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
  513. package/dist/tools/code-intelligence-freshness.d.ts +2 -0
  514. package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
  515. package/dist/tools/code-intelligence-freshness.js +26 -0
  516. package/dist/tools/code-intelligence-freshness.js.map +1 -0
  517. package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
  518. package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
  519. package/dist/tools/code-intelligence-gitnexus.js +475 -0
  520. package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
  521. package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
  522. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
  523. package/dist/tools/code-intelligence-kb-enrich.js +65 -0
  524. package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
  525. package/dist/tools/code-intelligence-reindex.d.ts +7 -0
  526. package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
  527. package/dist/tools/code-intelligence-reindex.js +106 -0
  528. package/dist/tools/code-intelligence-reindex.js.map +1 -0
  529. package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
  530. package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
  531. package/dist/tools/code-intelligence-telemetry.js +52 -0
  532. package/dist/tools/code-intelligence-telemetry.js.map +1 -0
  533. package/dist/tools/code-intelligence-tests.d.ts +2 -0
  534. package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
  535. package/dist/tools/code-intelligence-tests.js +24 -0
  536. package/dist/tools/code-intelligence-tests.js.map +1 -0
  537. package/dist/tools/code-intelligence.d.ts +114 -0
  538. package/dist/tools/code-intelligence.d.ts.map +1 -0
  539. package/dist/tools/code-intelligence.js +124 -0
  540. package/dist/tools/code-intelligence.js.map +1 -0
  541. package/dist/tools/compose-permissions.d.ts +38 -4
  542. package/dist/tools/compose-permissions.d.ts.map +1 -1
  543. package/dist/tools/compose-permissions.js +295 -33
  544. package/dist/tools/compose-permissions.js.map +1 -1
  545. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  546. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  547. package/dist/tools/dolt-push-mutex.js +83 -0
  548. package/dist/tools/dolt-push-mutex.js.map +1 -0
  549. package/dist/tools/execute-command.d.ts +13 -1
  550. package/dist/tools/execute-command.d.ts.map +1 -1
  551. package/dist/tools/execute-command.js +108 -21
  552. package/dist/tools/execute-command.js.map +1 -1
  553. package/dist/tools/execute-prompt.d.ts +84 -12
  554. package/dist/tools/execute-prompt.d.ts.map +1 -1
  555. package/dist/tools/execute-prompt.js +1191 -88
  556. package/dist/tools/execute-prompt.js.map +1 -1
  557. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  558. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  559. package/dist/tools/get-member-model-pricing.js +29 -0
  560. package/dist/tools/get-member-model-pricing.js.map +1 -0
  561. package/dist/tools/kb-capture.d.ts +53 -0
  562. package/dist/tools/kb-capture.d.ts.map +1 -0
  563. package/dist/tools/kb-capture.js +130 -0
  564. package/dist/tools/kb-capture.js.map +1 -0
  565. package/dist/tools/kb-context.d.ts +17 -0
  566. package/dist/tools/kb-context.d.ts.map +1 -0
  567. package/dist/tools/kb-context.js +29 -0
  568. package/dist/tools/kb-context.js.map +1 -0
  569. package/dist/tools/kb-export.d.ts +19 -0
  570. package/dist/tools/kb-export.d.ts.map +1 -0
  571. package/dist/tools/kb-export.js +344 -0
  572. package/dist/tools/kb-export.js.map +1 -0
  573. package/dist/tools/kb-feedback.d.ts +23 -0
  574. package/dist/tools/kb-feedback.d.ts.map +1 -0
  575. package/dist/tools/kb-feedback.js +43 -0
  576. package/dist/tools/kb-feedback.js.map +1 -0
  577. package/dist/tools/kb-freshness-sweep.d.ts +14 -0
  578. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
  579. package/dist/tools/kb-freshness-sweep.js +29 -0
  580. package/dist/tools/kb-freshness-sweep.js.map +1 -0
  581. package/dist/tools/kb-harvest.d.ts +20 -0
  582. package/dist/tools/kb-harvest.d.ts.map +1 -0
  583. package/dist/tools/kb-harvest.js +143 -0
  584. package/dist/tools/kb-harvest.js.map +1 -0
  585. package/dist/tools/kb-import.d.ts +44 -0
  586. package/dist/tools/kb-import.d.ts.map +1 -0
  587. package/dist/tools/kb-import.js +239 -0
  588. package/dist/tools/kb-import.js.map +1 -0
  589. package/dist/tools/kb-invalidate.d.ts +19 -0
  590. package/dist/tools/kb-invalidate.d.ts.map +1 -0
  591. package/dist/tools/kb-invalidate.js +34 -0
  592. package/dist/tools/kb-invalidate.js.map +1 -0
  593. package/dist/tools/kb-list.d.ts +32 -0
  594. package/dist/tools/kb-list.d.ts.map +1 -0
  595. package/dist/tools/kb-list.js +43 -0
  596. package/dist/tools/kb-list.js.map +1 -0
  597. package/dist/tools/kb-promote.d.ts +20 -0
  598. package/dist/tools/kb-promote.d.ts.map +1 -0
  599. package/dist/tools/kb-promote.js +20 -0
  600. package/dist/tools/kb-promote.js.map +1 -0
  601. package/dist/tools/kb-query.d.ts +35 -0
  602. package/dist/tools/kb-query.d.ts.map +1 -0
  603. package/dist/tools/kb-query.js +111 -0
  604. package/dist/tools/kb-query.js.map +1 -0
  605. package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
  606. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
  607. package/dist/tools/kb-reconcile-prefilter.js +26 -0
  608. package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
  609. package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
  610. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
  611. package/dist/tools/kb-resolve-contradiction.js +37 -0
  612. package/dist/tools/kb-resolve-contradiction.js.map +1 -0
  613. package/dist/tools/kb-session-prime.d.ts +26 -0
  614. package/dist/tools/kb-session-prime.d.ts.map +1 -0
  615. package/dist/tools/kb-session-prime.js +392 -0
  616. package/dist/tools/kb-session-prime.js.map +1 -0
  617. package/dist/tools/kb-setup.d.ts +20 -0
  618. package/dist/tools/kb-setup.d.ts.map +1 -0
  619. package/dist/tools/kb-setup.js +49 -0
  620. package/dist/tools/kb-setup.js.map +1 -0
  621. package/dist/tools/kb-stats.d.ts +20 -0
  622. package/dist/tools/kb-stats.d.ts.map +1 -0
  623. package/dist/tools/kb-stats.js +115 -0
  624. package/dist/tools/kb-stats.js.map +1 -0
  625. package/dist/tools/list-members.d.ts.map +1 -1
  626. package/dist/tools/list-members.js +39 -7
  627. package/dist/tools/list-members.js.map +1 -1
  628. package/dist/tools/member-detail.d.ts +1 -1
  629. package/dist/tools/member-detail.d.ts.map +1 -1
  630. package/dist/tools/member-detail.js +16 -2
  631. package/dist/tools/member-detail.js.map +1 -1
  632. package/dist/tools/member-reservation.d.ts +29 -0
  633. package/dist/tools/member-reservation.d.ts.map +1 -0
  634. package/dist/tools/member-reservation.js +71 -0
  635. package/dist/tools/member-reservation.js.map +1 -0
  636. package/dist/tools/monitor-task.d.ts.map +1 -1
  637. package/dist/tools/monitor-task.js +21 -3
  638. package/dist/tools/monitor-task.js.map +1 -1
  639. package/dist/tools/provision-auth.d.ts.map +1 -1
  640. package/dist/tools/provision-auth.js +10 -3
  641. package/dist/tools/provision-auth.js.map +1 -1
  642. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  643. package/dist/tools/provision-vcs-auth.js +1 -1
  644. package/dist/tools/provision-vcs-auth.js.map +1 -1
  645. package/dist/tools/register-member.d.ts +20 -5
  646. package/dist/tools/register-member.d.ts.map +1 -1
  647. package/dist/tools/register-member.js +174 -6
  648. package/dist/tools/register-member.js.map +1 -1
  649. package/dist/tools/remove-member.d.ts +1 -1
  650. package/dist/tools/remove-member.d.ts.map +1 -1
  651. package/dist/tools/remove-member.js +17 -3
  652. package/dist/tools/remove-member.js.map +1 -1
  653. package/dist/tools/report-status.d.ts +33 -0
  654. package/dist/tools/report-status.d.ts.map +1 -0
  655. package/dist/tools/report-status.js +45 -0
  656. package/dist/tools/report-status.js.map +1 -0
  657. package/dist/tools/respond-to-message.d.ts +21 -0
  658. package/dist/tools/respond-to-message.d.ts.map +1 -0
  659. package/dist/tools/respond-to-message.js +23 -0
  660. package/dist/tools/respond-to-message.js.map +1 -0
  661. package/dist/tools/send-email.d.ts +69 -0
  662. package/dist/tools/send-email.d.ts.map +1 -0
  663. package/dist/tools/send-email.js +177 -0
  664. package/dist/tools/send-email.js.map +1 -0
  665. package/dist/tools/send-files.d.ts +3 -0
  666. package/dist/tools/send-files.d.ts.map +1 -1
  667. package/dist/tools/send-files.js +88 -8
  668. package/dist/tools/send-files.js.map +1 -1
  669. package/dist/tools/send-message.d.ts +27 -0
  670. package/dist/tools/send-message.d.ts.map +1 -0
  671. package/dist/tools/send-message.js +46 -0
  672. package/dist/tools/send-message.js.map +1 -0
  673. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  674. package/dist/tools/setup-ssh-key.js +2 -0
  675. package/dist/tools/setup-ssh-key.js.map +1 -1
  676. package/dist/tools/shutdown-server.d.ts +2 -0
  677. package/dist/tools/shutdown-server.d.ts.map +1 -1
  678. package/dist/tools/shutdown-server.js +19 -0
  679. package/dist/tools/shutdown-server.js.map +1 -1
  680. package/dist/tools/update-member.d.ts +11 -8
  681. package/dist/tools/update-member.d.ts.map +1 -1
  682. package/dist/tools/update-member.js +36 -2
  683. package/dist/tools/update-member.js.map +1 -1
  684. package/dist/types.d.ts +16 -3
  685. package/dist/types.d.ts.map +1 -1
  686. package/dist/utils/agent-helpers.d.ts +2 -1
  687. package/dist/utils/agent-helpers.d.ts.map +1 -1
  688. package/dist/utils/agent-helpers.js +7 -2
  689. package/dist/utils/agent-helpers.js.map +1 -1
  690. package/dist/utils/pid-helpers.d.ts +15 -0
  691. package/dist/utils/pid-helpers.d.ts.map +1 -1
  692. package/dist/utils/pid-helpers.js +23 -0
  693. package/dist/utils/pid-helpers.js.map +1 -1
  694. package/dist/utils/process-utils.d.ts +3 -0
  695. package/dist/utils/process-utils.d.ts.map +1 -0
  696. package/dist/utils/process-utils.js +42 -0
  697. package/dist/utils/process-utils.js.map +1 -0
  698. package/dist/utils/prompt-errors.d.ts +2 -1
  699. package/dist/utils/prompt-errors.d.ts.map +1 -1
  700. package/dist/utils/prompt-errors.js +13 -3
  701. package/dist/utils/prompt-errors.js.map +1 -1
  702. package/dist/utils/session-caller.d.ts +28 -0
  703. package/dist/utils/session-caller.d.ts.map +1 -0
  704. package/dist/utils/session-caller.js +24 -0
  705. package/dist/utils/session-caller.js.map +1 -0
  706. package/dist/utils/work-folder-validation.d.ts +39 -0
  707. package/dist/utils/work-folder-validation.d.ts.map +1 -0
  708. package/dist/utils/work-folder-validation.js +60 -0
  709. package/dist/utils/work-folder-validation.js.map +1 -0
  710. package/dist/utils/workspace-trust.d.ts +24 -0
  711. package/dist/utils/workspace-trust.d.ts.map +1 -0
  712. package/dist/utils/workspace-trust.js +35 -0
  713. package/dist/utils/workspace-trust.js.map +1 -0
  714. package/dist/workflows/auto-sprint.js +994 -91
  715. package/package.json +40 -9
  716. package/packages/apra-fleet-client/package.json +26 -0
  717. package/packages/apra-fleet-client/src/client/api.mjs +510 -0
  718. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  719. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  720. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  721. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  722. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  723. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +303 -0
  724. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
  725. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
  726. package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
  727. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
  728. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
  729. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
  730. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
  731. package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
  732. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
  733. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -0
  734. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  735. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  736. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  737. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  738. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  739. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  740. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  741. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +82 -0
  742. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  743. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +75 -0
  744. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  745. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  746. package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
  747. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  748. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  749. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
  750. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  751. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  752. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  753. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +135 -0
  754. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  755. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +148 -0
  756. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  757. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  758. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +127 -0
  759. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
  760. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
  761. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
  762. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  763. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  764. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  765. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  766. package/packages/apra-fleet-se/bin/cli.mjs +864 -0
  767. package/packages/apra-fleet-se/bin/serve.mjs +395 -0
  768. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  769. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -0
  770. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  771. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  772. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -0
  773. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
  774. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
  775. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
  776. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  777. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
  778. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  779. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  780. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
  781. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
  782. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
  783. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  784. package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
  785. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
  786. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
  787. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  788. package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
  789. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  790. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  791. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  792. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  793. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  794. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +235 -0
  795. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  796. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
  797. package/packages/apra-fleet-se/package.json +29 -0
  798. package/packages/apra-fleet-se/workflow.json +1 -0
  799. package/packages/apra-fleet-workflow/package.json +30 -0
  800. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  801. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  802. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  803. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1439 -0
  804. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  805. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  806. package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
  807. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  808. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  809. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  810. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1727 -0
  811. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  812. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  813. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  814. package/scripts/agy-transcript-reader.js +1 -0
  815. package/scripts/fleet-statusline.sh +17 -13
  816. package/skills/fleet/SKILL.md +37 -2
  817. package/skills/fleet/beads.md +14 -7
  818. package/skills/fleet/knowledge-agent.md +66 -0
  819. package/skills/fleet/permissions.md +76 -2
  820. package/skills/fleet/profiles/base-dev.json +11 -1
  821. package/skills/fleet/profiles/base-reviewer.json +9 -1
  822. package/skills/fleet/profiles/node.json +2 -2
  823. package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
  824. package/version.json +1 -1
  825. package/scripts/agy-settings-merge.js +0 -27
  826. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,101 @@
1
+ // apra-fleet-x8r.1: closed/required bead-count derivation for the
2
+ // beads-closed/required progress-bar widget.
3
+ //
4
+ // Deliberately does NOT re-walk the parent-edge BFS runner.js's
5
+ // bdListScoped()/decomposedParentIds() already perform to discover "what is
6
+ // in scope for this sprint" -- that would be a second, independently
7
+ // maintained definition of "in scope" that could silently drift from the
8
+ // completion gate's own. Instead this takes the ALREADY-SCOPED bead list the
9
+ // caller already has on hand (dashboard.mjs's `sprintTasks`, itself built
10
+ // from `bdListScoped('')` -- see runner.js's updateDashboard()) and only
11
+ // derives the two counts a viewer needs from it: how many of those beads are
12
+ // closed, and how many total. Pure/sync, no I/O -- takes data, returns data.
13
+ //
14
+ // apra-fleet-4p5-style: also embedded verbatim (via `.toString()`) into
15
+ // viewer-extensions.mjs's browser-side `<script>` alongside renderBeadsHtml,
16
+ // so the exact function under test here is the exact function that renders
17
+ // the widget in the browser -- never a hand-duplicated copy.
18
+ //
19
+ // apra-fleet-x8r.4: `required` originally defaulted to `beads.length` --
20
+ // EVERY bead in the sprint's scope, regardless of priority or structure. But
21
+ // runner.js's real completion gate (~line 8134) computes
22
+ // `openAtGoal = bdListScoped('--status=<NOT_DONE> --priority-max=<goalMax>')
23
+ // MINUS decomposedParentIds()`: below-goal-priority beads and decomposed
24
+ // parent (grouping) nodes are NOT part of the required-to-close set that
25
+ // actually gates sprint exit. Left unfiltered, a sprint whose scope contains
26
+ // either could legitimately complete while this widget still showed less
27
+ // than N/N -- the opposite of "how much of this sprint's required work is
28
+ // done". `opts` is ADDITIVE-OPTIONAL (a bare `computeSprintProgress(beads)`
29
+ // call -- e.g. a caller that has not been plumbed a goalMax/decomposed set
30
+ // yet -- keeps its original all-of-scope behavior) so every existing/future
31
+ // call site stays valid without redesigning this signature again.
32
+ //
33
+ // Both fields are plumbed in from the SAME server-side sources runner.js's
34
+ // gate itself uses (goalPriorityMax(validated.goal), decomposedParentIds())
35
+ // -- never re-derived here or client-side, so there is exactly one
36
+ // "what does this sprint still need to close" definition in the package.
37
+
38
+ // apra-fleet-x8r.8: runner.js's partitionByGoalMembership() (eft.52.1.3) can
39
+ // place a below-goal-priority bead in the Sprint section via a documented
40
+ // blocks-edge exception -- a bead that BLOCKS an in-goal bead is admitted
41
+ // into 'sprint' placement even though its own priority is below goalMax. That
42
+ // server-computed decision is tagged verbatim onto the row as `placement`
43
+ // ('sprint' | 'backlog') and is exactly what the beads TREE (renderBeadsHtml)
44
+ // honors when deciding which section a row renders in. Before this fix,
45
+ // computeSprintProgress() re-derived membership from raw numeric priority
46
+ // alone (`priority > goalMax` -> excluded), ignoring `placement` -- so a
47
+ // blocks-exception bead could render as an open Sprint row in the tree while
48
+ // being silently excluded from the 'M/N' count directly above it (the bar
49
+ // reads N/N while a visibly-open row sits right below). Reusing `placement`
50
+ // when present (rather than re-deriving from priority) makes the bar and the
51
+ // tree agree on exactly the same admitted set.
52
+ /**
53
+ * @param {Array<{id?: string, status?: string, priority?: number, placement?: string}>} beads the
54
+ * sprint's already-scoped bead list (e.g. dashboard.mjs's `sprintTasks`,
55
+ * sourced from `bdListScoped('')`)
56
+ * @param {{ goalMax?: number, decomposedParentIds?: Iterable<string> }} [opts]
57
+ * `goalMax` is the NUMERIC worst priority tier named in the sprint's goal
58
+ * (e.g. `goalPriorityMax('P1/P2')` -> `'P2'` -> `goalMax: 2`) -- a bead
59
+ * whose `priority` is a finite number strictly greater than `goalMax` is
60
+ * below-goal and excluded from `required`/`closed`, UNLESS that bead
61
+ * carries a server-computed `placement` field (apra-fleet-eft.52.1.3),
62
+ * in which case `placement` decides membership instead (`'backlog'` ->
63
+ * excluded, anything else, e.g. `'sprint'` -> included) so the bar can
64
+ * never disagree with the tree it sits above (apra-fleet-x8r.8). Rows with
65
+ * no `placement` field (dashboard.mjs's listAllBeads-sourced rows never
66
+ * carry one) fall back to the plain numeric filter, unchanged.
67
+ * `decomposedParentIds` is the set of bead ids that are themselves someone
68
+ * else's `.parent` (any status) -- excluded the same way runner.js's exit
69
+ * gate excludes them, regardless of `placement`.
70
+ * Omitting `opts` (or either field) applies no filtering on that axis,
71
+ * preserving the pre-x8r.4 "every bead in scope" behavior.
72
+ * @returns {{ closed: number, required: number, fraction: number }}
73
+ * `fraction` is `closed / required`, clamped to 0 when `required` is 0
74
+ * (never NaN/Infinity from a divide-by-zero).
75
+ */
76
+ export function computeSprintProgress(beads, opts) {
77
+ const list = Array.isArray(beads) ? beads : [];
78
+ const goalMax = opts && typeof opts.goalMax === 'number' && Number.isFinite(opts.goalMax)
79
+ ? opts.goalMax
80
+ : null;
81
+ const decomposedParentIds = opts && opts.decomposedParentIds
82
+ ? new Set(opts.decomposedParentIds)
83
+ : null;
84
+ const filtered = list.filter((b) => {
85
+ if (!b) return false;
86
+ if (decomposedParentIds && decomposedParentIds.has(b.id)) return false;
87
+ if (typeof b.placement === 'string') {
88
+ // Server-computed placement already decided which section this
89
+ // bead belongs to (including the blocks-edge exception) -- reuse
90
+ // it verbatim instead of re-deriving from priority, so the bar
91
+ // agrees with the tree exactly.
92
+ return b.placement !== 'backlog';
93
+ }
94
+ if (goalMax !== null && typeof b.priority === 'number' && b.priority > goalMax) return false;
95
+ return true;
96
+ });
97
+ const required = filtered.length;
98
+ const closed = filtered.filter((b) => String(b.status).toLowerCase() === 'closed').length;
99
+ const fraction = required > 0 ? closed / required : 0;
100
+ return { closed, required, fraction };
101
+ }
@@ -0,0 +1,435 @@
1
+ /**
2
+ * VCSModule -- orchestrator-side (fleet-se), provider-dispatched command
3
+ * builder for VCS actions raised against a hosted repo provider.
4
+ *
5
+ * Architectural context (apra-fleet-tfx, correction note 2026-08-02): this
6
+ * module lives in the orchestrator (fleet-se, alongside runner.js and the
7
+ * server-side src/services/vcs/ provider seam -- see that seam's
8
+ * VcsProviderService in src/services/vcs/types.ts, which this module's shape
9
+ * mirrors/extends rather than inventing a parallel one). It NEVER runs on the
10
+ * member and NEVER performs network I/O itself. Its only job is: given a
11
+ * provider name and the already-minted credential, deterministically build
12
+ * the exact command (a curl(1) invocation over the provider's REST API) that
13
+ * the member will run via execute_command, plus the metadata a caller needs
14
+ * to interpret that command's output (success / already-exists / error).
15
+ *
16
+ * The member is a dumb executor: it holds no VCS-abstraction code and makes
17
+ * no choice about how the PR gets raised. No vendor CLI (`gh`, `hub`, ...)
18
+ * appears anywhere in the commands this module builds, and there is no
19
+ * server-side fallback -- callers that get an unsupported provider get a
20
+ * clear ASCII "ERROR:" failure, never a silently wrong command.
21
+ *
22
+ * Token-safety invariant (apra-fleet-tfx.7 AC3): the raw token is placed only
23
+ * in the `command` string that is actually dispatched for execution (never
24
+ * echoed by curl itself -- no -v/--trace flag is ever added). Every field
25
+ * meant for logs (`logSafeCommand`) has the token replaced with a fixed
26
+ * redaction marker. Callers must log/echo `logSafeCommand`, never `command`.
27
+ */
28
+
29
+ import { VCS_FAILURE_KINDS, VCS_RETRYABLE_KINDS } from './errors.mjs';
30
+ import {
31
+ DEFAULT_VCS_PROVIDER,
32
+ registerVcsProvider,
33
+ unregisterVcsProvider,
34
+ isKnownVcsProvider,
35
+ listVcsProviders,
36
+ listVcsAuthProviders,
37
+ getVcsProvider,
38
+ resolveVcsProviderChain,
39
+ resolveVcsProviderForHost,
40
+ } from './vcs-providers/index.mjs';
41
+
42
+ /**
43
+ * Provider-dispatched command build step. `action` is one of
44
+ * 'create-pull-request' | 'comment'; `params.provider` selects the REST
45
+ * dispatch. Pure and deterministic -- no network I/O, no filesystem access,
46
+ * no randomness (beyond whatever caller-supplied fields it is handed).
47
+ *
48
+ * apra-fleet-647.1.5.1: dispatches through the vcs-providers/ registry --
49
+ * each provider's own command builders live as a `builders` field on its
50
+ * descriptor (see ./vcs-providers/github.mjs) rather than in a second
51
+ * provider-name-keyed table here. Adding a provider's builders is therefore
52
+ * one file under vcs-providers/, never a change to this function.
53
+ *
54
+ * Returns { provider, action, command, logSafeCommand, interpret }.
55
+ * Throws an Error whose message starts with the ASCII marker "ERROR:" for an
56
+ * unsupported/unknown provider or missing required fields, rather than
57
+ * silently building a wrong command.
58
+ */
59
+ function buildVcsCommand(action, params) {
60
+ const provider = params && params.provider;
61
+ const impl = getVcsProvider(provider);
62
+ if (!impl) {
63
+ const known = listVcsAuthProviders().join(', ');
64
+ throw new Error(`ERROR: VCSModule: unsupported VCS provider "${provider}" -- known providers: ${known}.`);
65
+ }
66
+ const builder = impl.builders && impl.builders[action];
67
+ if (!builder) {
68
+ throw new Error(`ERROR: VCSModule: provider "${provider}" does not yet implement action "${action}".`);
69
+ }
70
+ return builder(params);
71
+ }
72
+
73
+ /** Build a "raise a PR" command for the given provider. */
74
+ export function buildCreatePrCommand(params) {
75
+ return buildVcsCommand('create-pull-request', params);
76
+ }
77
+
78
+ // ---------------------------------------------------------------------------
79
+ // Provider resolution (apra-fleet-647.1.2.1; refolded onto the registry
80
+ // apra-fleet-647.1.5.1)
81
+ // ---------------------------------------------------------------------------
82
+ //
83
+ // Each provider owns its OWN default auth-mode vocabulary (GitHub: App vs.
84
+ // PAT; Bitbucket/Azure DevOps have no such axis -- they always authenticate
85
+ // via their own single token field) so a caller (runner.js) never has to
86
+ // hardcode a provider-specific mode literal alongside the provider name.
87
+ // `null` means "this provider has no separate auth-mode choice at
88
+ // provision_vcs_auth call time". That per-provider default now lives as the
89
+ // `defaultAuthMode` field on the provider's OWN descriptor (see
90
+ // ./vcs-providers/github.mjs, ./vcs-providers/bitbucket.mjs,
91
+ // ./vcs-providers/azure-devops.mjs) rather than in a second provider-name-
92
+ // keyed table here.
93
+ //
94
+ // GitHub defaults to 'github-app' (never 'pat') because that is the mode
95
+ // runner.js has always hardcoded -- resolveProvider() must reproduce that
96
+ // exact behavior for every already-github-provisioned member, not merely a
97
+ // plausible one (apra-fleet-647.1.2.1 AC: "Existing GitHub members behave
98
+ // exactly as before").
99
+
100
+ /**
101
+ * Resolve `member`'s persisted VCS provider (and that provider's own default
102
+ * auth mode) from the fleet member registry, via the injected `fleetApi`'s
103
+ * `memberDetail()` (member_detail, the only MCP surface that currently
104
+ * exposes Agent.vcsProvider -- src/tools/member-detail.ts). NO default, NO
105
+ * guessing: an absent or unrecognized vcsProvider is a typed "ERROR:"
106
+ * failure naming the member and the known providers, never a silent GitHub
107
+ * assumption (apra-fleet-647.1.2's whole point).
108
+ *
109
+ * The known-provider vocabulary is listVcsAuthProviders() -- every registered
110
+ * vcs-providers/ descriptor that declares its own `defaultAuthMode` (this
111
+ * module's single manifest of member-facing VCS auth backends it is aware of
112
+ * at all; see ./vcs-providers/index.mjs's isAuthBackend()) -- so a provider
113
+ * added there is automatically recognized here too, no second list to keep
114
+ * in sync.
115
+ *
116
+ * @param {string} member
117
+ * @param {{ fleetApi: { memberDetail: (opts: { member_name: string, format?: string }) => Promise<any> } }} opts
118
+ * @returns {Promise<{ provider: string, authMode: string|null }>}
119
+ */
120
+ export async function resolveProvider(member, { fleetApi } = {}) {
121
+ if (!fleetApi || typeof fleetApi.memberDetail !== 'function') {
122
+ throw new Error(`ERROR: VCSModule: resolveProvider requires an injected fleetApi.memberDetail() -- cannot resolve a VCS provider for member '${member}' without one.`);
123
+ }
124
+ const known = listVcsAuthProviders();
125
+
126
+ let res;
127
+ try {
128
+ res = await fleetApi.memberDetail({ member_name: member, format: 'json' });
129
+ } catch (err) {
130
+ throw new Error(`ERROR: VCSModule: resolveProvider could not read the member registry for member '${member}': ${err && err.message ? err.message : err}`);
131
+ }
132
+ const text = typeof res === 'string'
133
+ ? res
134
+ : (res && Array.isArray(res.content) && res.content[0] && typeof res.content[0].text === 'string')
135
+ ? res.content[0].text
136
+ : '';
137
+
138
+ let parsed = null;
139
+ try {
140
+ parsed = JSON.parse(text);
141
+ } catch {
142
+ // member_detail returns a plain (non-JSON) string when the member
143
+ // itself cannot be resolved (see resolveMember in
144
+ // src/utils/resolve-member.ts) -- surface that text as-is rather
145
+ // than a generic parse-error message, since it already names the
146
+ // problem (e.g. "no member found matching ...").
147
+ throw new Error(`ERROR: VCSModule: resolveProvider could not resolve member '${member}' from the registry: ${text || '(empty member_detail response)'}`);
148
+ }
149
+
150
+ const provider = parsed && typeof parsed.vcsProvider === 'string' ? parsed.vcsProvider : null;
151
+ if (!provider || !known.includes(provider)) {
152
+ throw new Error(`ERROR: VCSModule: resolveProvider: member '${member}' has no registered VCS provider (vcsProvider: ${provider ? `"${provider}"` : '(absent)'}) -- known providers: ${known.join(', ')}. Provision one via provision_vcs_auth with an explicit 'provider' before relying on resolveProvider.`);
153
+ }
154
+
155
+ const impl = getVcsProvider(provider);
156
+ return { provider, authMode: impl && Object.prototype.hasOwnProperty.call(impl, 'defaultAuthMode') ? impl.defaultAuthMode : null };
157
+ }
158
+
159
+ /** Build a "comment on abort" command for the given provider. */
160
+ export function buildCommentCommand(params) {
161
+ return buildVcsCommand('comment', params);
162
+ }
163
+
164
+ // ---------------------------------------------------------------------------
165
+ // Failure classification (apra-fleet-647.1.3.1)
166
+ // ---------------------------------------------------------------------------
167
+ //
168
+ // classifyFailure() is the ONE place VCS stderr is ever parsed. No other file
169
+ // may carry a regex over a git/dolt/provider error string: add a pattern to a
170
+ // provider file under ./vcs-providers/ instead. Downstream code branches on
171
+ // the neutral `kind` ALONE -- never on `providerCode`, never on `raw`.
172
+ //
173
+ // TAXONOMY (the neutral vocabulary; canonical definitions in errors.mjs
174
+ // VCS_FAILURE_KINDS)
175
+ //
176
+ // kind | retryable | meaning | remediation
177
+ // -----------------------+-----------+------------------------------------------+---------------------------
178
+ // AUTH_EXPIRED | false | credential missing/stale/invalid | re-provision, then retry
179
+ // AUTH_DENIED | false | identity refused; lacks access | operator grants access
180
+ // DIVERGED | false | non-FF / unmerged / conflicted | never auto-resolve
181
+ // TRANSIENT | true | network / server / lock blip | retry, bounded
182
+ // NO_REMOTE | false | no remote configured; nothing to sync | none; benign no-op
183
+ // UNSUPPORTED_OPERATION | false | action not implemented for this provider | fix the call/config
184
+ // UNKNOWN | false | unrecognized -- must surface, not guess | operator triage
185
+ //
186
+ // `retryable` is true ONLY for TRANSIENT, and means "safe to re-run the same
187
+ // command with NO remediation first". AUTH_EXPIRED is therefore false even
188
+ // though the self-heal path retries once -- that retry follows remediation.
189
+ //
190
+ // PRECEDENCE. Kinds are checked in KIND_PRECEDENCE order and the first match
191
+ // wins, so a stderr carrying several signals gets the most dangerous reading:
192
+ // DIVERGED before AUTH before TRANSIENT is exactly runner.js's
193
+ // classifyGitFailure ordering -- a diverged state must never be misread as a
194
+ // retryable blip because its message happens to contain a lock or credential
195
+ // word, and an auth failure must never be blindly retried. NO_REMOTE and
196
+ // UNSUPPORTED_OPERATION come last because their texts are the narrowest and
197
+ // the least dangerous to under-match. A provider may override the order with
198
+ // its own `precedence` array (dolt's classifier, for example, promotes
199
+ // no-remote to first) without any change here.
200
+
201
+ const KIND_PRECEDENCE = Object.freeze([
202
+ VCS_FAILURE_KINDS.DIVERGED,
203
+ VCS_FAILURE_KINDS.AUTH_EXPIRED,
204
+ VCS_FAILURE_KINDS.AUTH_DENIED,
205
+ VCS_FAILURE_KINDS.TRANSIENT,
206
+ VCS_FAILURE_KINDS.NO_REMOTE,
207
+ VCS_FAILURE_KINDS.UNSUPPORTED_OPERATION,
208
+ ]);
209
+
210
+ /**
211
+ * Classify a failed VCS command's raw stderr/stdout into the neutral taxonomy.
212
+ *
213
+ * PURE: no I/O, no clock, no randomness, no module-level mutable state, and no
214
+ * global (/g) regexes -- calling it twice with the same input always returns a
215
+ * deeply-equal result.
216
+ *
217
+ * NON-THROWING, including for an unknown/absent provider, which falls back to
218
+ * the default provider's chain. This is a DELIBERATE asymmetry with
219
+ * buildVcsCommand() above, which DOES throw "ERROR:" on an unsupported
220
+ * provider: building a wrong command silently would corrupt a repo, whereas a
221
+ * classifier that throws would convert a recoverable sync failure into a crash
222
+ * -- and would do it precisely when something is already going wrong. An
223
+ * unmatched stderr returns UNKNOWN, which is never retried and never
224
+ * self-healed, so a mis-fallback degrades to "surface it", not to a guess.
225
+ *
226
+ * @param {string} rawStderr - the raw stderr/stdout of the failed command
227
+ * @param {{ provider?: string }} [opts] - provider selects the rule chain;
228
+ * defaults to DEFAULT_VCS_PROVIDER ('github'), which reproduces runner.js's
229
+ * full auth pattern set exactly.
230
+ * @returns {{ kind: string, providerCode: string|null, retryable: boolean, raw: string }}
231
+ * `kind` is the ONLY field control flow may branch on. `providerCode` is the
232
+ * provider-specific token (e.g. an HTTP status, or an Azure DevOps
233
+ * 'TF401019') carried as a DIAGNOSTIC detail. `raw` is the input, normalized
234
+ * to a string, so a caller can log the evidence behind the verdict.
235
+ */
236
+ export function classifyFailure(rawStderr, opts = {}) {
237
+ const raw = String(rawStderr == null ? '' : rawStderr);
238
+ const providerName = (opts && opts.provider) || DEFAULT_VCS_PROVIDER;
239
+ const chain = resolveVcsProviderChain(providerName);
240
+
241
+ const precedence = chain.find((p) => Array.isArray(p.precedence))?.precedence || KIND_PRECEDENCE;
242
+
243
+ let kind = VCS_FAILURE_KINDS.UNKNOWN;
244
+ outer:
245
+ for (const candidate of precedence) {
246
+ // Most-derived provider first within each kind, so a provider can
247
+ // sharpen a base verdict without editing the base.
248
+ for (const provider of chain) {
249
+ const patterns = (provider.rules && provider.rules[candidate]) || [];
250
+ for (const re of patterns) {
251
+ if (re.test(raw)) {
252
+ kind = candidate;
253
+ break outer;
254
+ }
255
+ }
256
+ }
257
+ }
258
+
259
+ let providerCode = null;
260
+ for (const provider of chain) {
261
+ if (typeof provider.extractProviderCode === 'function') {
262
+ providerCode = provider.extractProviderCode(raw) ?? null;
263
+ if (providerCode !== null) break;
264
+ }
265
+ }
266
+
267
+ return { kind, providerCode, retryable: VCS_RETRYABLE_KINDS.has(kind), raw };
268
+ }
269
+
270
+ /**
271
+ * Adapter from the neutral taxonomy to runner.js's legacy git verdict
272
+ * vocabulary, so apra-fleet-647.1.3.2 can delete GIT_*_PATTERNS and delegate
273
+ * classifyGitFailure() to classifyFailure() with NO verdict change.
274
+ *
275
+ * Both AUTH kinds collapse to 'auth' (today's classifier does not distinguish
276
+ * them). NO_REMOTE and UNSUPPORTED_OPERATION collapse to 'unknown' because git
277
+ * has no such verdict today and 'unknown' is what those texts classify as --
278
+ * preserving parity, not inventing behavior.
279
+ *
280
+ * @param {string} kind - a VCS_FAILURE_KINDS member
281
+ * @returns {'diverged'|'auth'|'transient'|'unknown'}
282
+ */
283
+ export function toGitVerdict(kind) {
284
+ switch (kind) {
285
+ case VCS_FAILURE_KINDS.DIVERGED: return 'diverged';
286
+ case VCS_FAILURE_KINDS.AUTH_EXPIRED:
287
+ case VCS_FAILURE_KINDS.AUTH_DENIED: return 'auth';
288
+ case VCS_FAILURE_KINDS.TRANSIENT: return 'transient';
289
+ default: return 'unknown';
290
+ }
291
+ }
292
+
293
+ /**
294
+ * Adapter from the neutral taxonomy to dolt-sync.mjs's legacy classifyDoltFailure
295
+ * verdict vocabulary (apra-fleet-647.1.3.2), so classifyDoltFailure can delegate
296
+ * to classifyFailure(raw, { provider: 'dolt' }) with NO verdict change. The
297
+ * companion of toGitVerdict() above -- same collapsing rules, but preserves the
298
+ * three dolt-only benign/fatal kinds (NO_REMOTE, EMPTY_REMOTE,
299
+ * REMOTE_UNREACHABLE) that git has no equivalent of, instead of folding them
300
+ * into 'unknown'.
301
+ *
302
+ * Both AUTH kinds collapse to 'auth' -- classifyDoltFailure has never
303
+ * distinguished them (DoltVCS's own AUTH_EXPIRED table already carries every
304
+ * dolt auth literal, including the publickey-refusal one; see dolt.mjs).
305
+ *
306
+ * @param {string} kind - a VCS_FAILURE_KINDS member
307
+ * @returns {'no-remote'|'empty-remote'|'remote-unreachable'|'auth'|'diverged'|'transient'|'unknown'}
308
+ */
309
+ export function toDoltVerdict(kind) {
310
+ switch (kind) {
311
+ case VCS_FAILURE_KINDS.NO_REMOTE: return 'no-remote';
312
+ case VCS_FAILURE_KINDS.EMPTY_REMOTE: return 'empty-remote';
313
+ case VCS_FAILURE_KINDS.REMOTE_UNREACHABLE: return 'remote-unreachable';
314
+ case VCS_FAILURE_KINDS.DIVERGED: return 'diverged';
315
+ case VCS_FAILURE_KINDS.AUTH_EXPIRED:
316
+ case VCS_FAILURE_KINDS.AUTH_DENIED: return 'auth';
317
+ case VCS_FAILURE_KINDS.TRANSIENT: return 'transient';
318
+ default: return 'unknown';
319
+ }
320
+ }
321
+
322
+ // ---------------------------------------------------------------------------
323
+ // capabilities(remoteUrl) (apra-fleet-647.1.4.1)
324
+ // ---------------------------------------------------------------------------
325
+ //
326
+ // The ONE place a git remote URL is parsed into a host and classified for PR
327
+ // capability -- replaces runner.js's isHostedGithubRemote(), whose regex
328
+ // hardcoded 'github.com' literally and treated every other host (Azure
329
+ // DevOps, GitLab, GitHub Enterprise, ...) as "non-hosted" by default. Here
330
+ // the URL is parsed into a bare host and the decision is delegated to
331
+ // whichever registered provider's matchesHost() claims it (see
332
+ // resolveVcsProviderForHost() in ./vcs-providers/index.mjs) -- so a provider
333
+ // added later (e.g. a real Azure DevOps/GitLab implementation) gains
334
+ // capability recognition for free, with zero change here.
335
+
336
+ /**
337
+ * Parse a git remote URL into its scheme and bare lowercase host, or null for
338
+ * anything unresolvable (missing/empty/malformed). Accepts the three shapes
339
+ * runner.js's PR-gate call sites can see:
340
+ * - a normal URL with a scheme: https://[user@]host/owner/repo(.git)
341
+ * ssh://[user@]host/owner/repo
342
+ * file:///path/to/bare.git
343
+ * - scp-like SSH shorthand with NO scheme: user@host:owner/repo(.git)
344
+ * @param {unknown} remoteUrl
345
+ * @returns {{ scheme: string, host: string|null } | null}
346
+ */
347
+ function parseRemote(remoteUrl) {
348
+ const url = String(remoteUrl ?? '').trim();
349
+ if (!url) return null;
350
+
351
+ // scp-like shorthand (e.g. git@github.com:owner/repo.git) has no
352
+ // `scheme://` prefix at all, which `new URL()` cannot parse -- detect and
353
+ // extract the host directly. Guarded by the scheme-prefix test so an
354
+ // actual `ssh://user@host/...` URL (which DOES have a scheme) falls
355
+ // through to the URL branch below instead.
356
+ if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(url)) {
357
+ const scpMatch = /^[^@\s/]+@([^:\s/]+):/.exec(url);
358
+ if (scpMatch) return { scheme: 'ssh', host: scpMatch[1].toLowerCase() };
359
+ return null;
360
+ }
361
+
362
+ let parsed;
363
+ try {
364
+ parsed = new URL(url);
365
+ } catch {
366
+ return null;
367
+ }
368
+ const scheme = parsed.protocol.replace(/:$/, '').toLowerCase();
369
+ if (scheme === 'file') return { scheme: 'file', host: null };
370
+ const host = parsed.hostname ? parsed.hostname.toLowerCase() : null;
371
+ if (!host) return null;
372
+ return { scheme, host };
373
+ }
374
+
375
+ /**
376
+ * Answer what a git 'origin' remote supports, dispatched through the
377
+ * resolved provider implementation -- NOT a literal host list. Used by
378
+ * runner.js's Publish-PR non-hosted-remote gate and finalizeAbort's
379
+ * abort-PR gate; both replace their former isHostedGithubRemote() call with
380
+ * this.
381
+ *
382
+ * Behavior preserved from isHostedGithubRemote() (apra-fleet-647.1.4 AC):
383
+ * - a `file://` remote: hasRemote:true, canOpenPullRequest:false
384
+ * - missing/empty/unresolvable URL: hasRemote:false, canOpenPullRequest:false (fails closed)
385
+ * - a `github.com` remote (any of the 3 URL shapes isHostedGithubRemote
386
+ * recognized): canOpenPullRequest:true, same as before.
387
+ * NEW behavior (the whole point of apra-fleet-647.1.4): a GitHub Enterprise
388
+ * host, or any other resolvable host, is classified by asking its provider
389
+ * rather than being bucketed into "non-hosted" purely for not being
390
+ * literally 'github.com'.
391
+ *
392
+ * @param {unknown} remoteUrl
393
+ * @returns {{ hasRemote: boolean, canOpenPullRequest: boolean, host: string|null }}
394
+ */
395
+ export function capabilities(remoteUrl) {
396
+ const parsed = parseRemote(remoteUrl);
397
+ if (!parsed) return { hasRemote: false, canOpenPullRequest: false, host: null };
398
+ if (parsed.scheme === 'file') return { hasRemote: true, canOpenPullRequest: false, host: null };
399
+
400
+ const provider = resolveVcsProviderForHost(parsed.host);
401
+ const providerCaps = (provider && typeof provider.capabilitiesForHost === 'function')
402
+ ? provider.capabilitiesForHost(parsed.host)
403
+ : { canOpenPullRequest: false };
404
+ return { hasRemote: true, canOpenPullRequest: !!providerCaps.canOpenPullRequest, host: parsed.host };
405
+ }
406
+
407
+ export const VCSModule = {
408
+ buildCreatePrCommand,
409
+ buildCommentCommand,
410
+ classifyFailure,
411
+ toGitVerdict,
412
+ toDoltVerdict,
413
+ resolveProvider,
414
+ capabilities,
415
+ registerVcsProvider,
416
+ unregisterVcsProvider,
417
+ isKnownVcsProvider,
418
+ listVcsProviders,
419
+ listVcsAuthProviders,
420
+ getVcsProvider,
421
+ DEFAULT_VCS_PROVIDER,
422
+ };
423
+
424
+ export {
425
+ VCS_FAILURE_KINDS,
426
+ DEFAULT_VCS_PROVIDER,
427
+ registerVcsProvider,
428
+ unregisterVcsProvider,
429
+ isKnownVcsProvider,
430
+ listVcsProviders,
431
+ listVcsAuthProviders,
432
+ getVcsProvider,
433
+ };
434
+
435
+ export default VCSModule;
@@ -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;