@mastra/factory 0.28.0-alpha.1 → 0.28.0-alpha.10

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 (646) hide show
  1. package/README.md +361 -162
  2. package/dist/auth.d.ts.map +1 -1
  3. package/dist/auth.js +12 -6
  4. package/dist/auth.js.map +1 -1
  5. package/dist/boards/board-events.d.ts +23 -3
  6. package/dist/boards/board-events.d.ts.map +1 -1
  7. package/dist/boards/board-events.js +44 -7
  8. package/dist/boards/board-events.js.map +1 -1
  9. package/dist/boards/board-writes.d.ts +2 -2
  10. package/dist/boards/board-writes.d.ts.map +1 -1
  11. package/dist/boards/board-writes.js +23 -9
  12. package/dist/boards/board-writes.js.map +1 -1
  13. package/dist/boards/card-facts.d.ts +3 -1
  14. package/dist/boards/card-facts.d.ts.map +1 -1
  15. package/dist/boards/card-facts.js +30 -4
  16. package/dist/boards/card-facts.js.map +1 -1
  17. package/dist/boards/default-board.d.ts +7 -0
  18. package/dist/boards/default-board.d.ts.map +1 -0
  19. package/dist/boards/default-board.js +10 -0
  20. package/dist/boards/default-board.js.map +1 -0
  21. package/dist/boards/define-board.d.ts +40 -18
  22. package/dist/boards/define-board.d.ts.map +1 -1
  23. package/dist/boards/define-board.js +64 -42
  24. package/dist/boards/define-board.js.map +1 -1
  25. package/dist/boards/index.d.ts +6 -9
  26. package/dist/boards/index.d.ts.map +1 -1
  27. package/dist/boards/index.js +6 -20
  28. package/dist/boards/intake-routing.d.ts +29 -9
  29. package/dist/boards/intake-routing.d.ts.map +1 -1
  30. package/dist/boards/intake-routing.js +72 -20
  31. package/dist/boards/intake-routing.js.map +1 -1
  32. package/dist/boards/legacy-plan-role.d.ts.map +1 -1
  33. package/dist/boards/legacy-plan-role.js +7 -2
  34. package/dist/boards/legacy-plan-role.js.map +1 -1
  35. package/dist/boards/phase-automation.d.ts +7 -0
  36. package/dist/boards/phase-automation.d.ts.map +1 -1
  37. package/dist/boards/phase-automation.js +16 -5
  38. package/dist/boards/phase-automation.js.map +1 -1
  39. package/dist/boards/phase-runner.d.ts +18 -10
  40. package/dist/boards/phase-runner.d.ts.map +1 -1
  41. package/dist/boards/phase-runner.js +39 -34
  42. package/dist/boards/phase-runner.js.map +1 -1
  43. package/dist/boards/project-boards.d.ts +57 -11
  44. package/dist/boards/project-boards.d.ts.map +1 -1
  45. package/dist/boards/project-boards.js +161 -34
  46. package/dist/boards/project-boards.js.map +1 -1
  47. package/dist/boards/registry.d.ts +7 -1
  48. package/dist/boards/registry.d.ts.map +1 -1
  49. package/dist/boards/registry.js +19 -4
  50. package/dist/boards/registry.js.map +1 -1
  51. package/dist/boards/relocate.d.ts +1 -1
  52. package/dist/boards/relocate.d.ts.map +1 -1
  53. package/dist/boards/relocate.js +3 -2
  54. package/dist/boards/relocate.js.map +1 -1
  55. package/dist/boards/review.d.ts +5 -2
  56. package/dist/boards/review.d.ts.map +1 -1
  57. package/dist/boards/review.js +12 -11
  58. package/dist/boards/review.js.map +1 -1
  59. package/dist/boards/semantics.d.ts +160 -20
  60. package/dist/boards/semantics.d.ts.map +1 -1
  61. package/dist/boards/semantics.js +255 -23
  62. package/dist/boards/semantics.js.map +1 -1
  63. package/dist/boards/stored-board.d.ts +32 -18
  64. package/dist/boards/stored-board.d.ts.map +1 -1
  65. package/dist/boards/stored-board.js +31 -97
  66. package/dist/boards/stored-board.js.map +1 -1
  67. package/dist/boards/work-migrations.d.ts +43 -0
  68. package/dist/boards/work-migrations.d.ts.map +1 -0
  69. package/dist/boards/work-migrations.js +353 -0
  70. package/dist/boards/work-migrations.js.map +1 -0
  71. package/dist/boards/work-routes.d.ts +58 -0
  72. package/dist/boards/work-routes.d.ts.map +1 -0
  73. package/dist/boards/work-routes.js +270 -0
  74. package/dist/boards/work-routes.js.map +1 -0
  75. package/dist/boards/work-seeds.d.ts +9 -0
  76. package/dist/boards/work-seeds.d.ts.map +1 -0
  77. package/dist/boards/work-seeds.js +56 -0
  78. package/dist/boards/work-seeds.js.map +1 -0
  79. package/dist/boards/work.d.ts +8 -19
  80. package/dist/boards/work.d.ts.map +1 -1
  81. package/dist/boards/work.js +33 -281
  82. package/dist/boards/work.js.map +1 -1
  83. package/dist/environment/build-runner.d.ts.map +1 -1
  84. package/dist/environment/build-runner.js +2 -2
  85. package/dist/environment/build-runner.js.map +1 -1
  86. package/dist/environment/build-workflow.d.ts.map +1 -1
  87. package/dist/environment/build-workflow.js +6 -5
  88. package/dist/environment/build-workflow.js.map +1 -1
  89. package/dist/environment/build.d.ts +15 -2
  90. package/dist/environment/build.d.ts.map +1 -1
  91. package/dist/environment/build.js +32 -9
  92. package/dist/environment/build.js.map +1 -1
  93. package/dist/factory.d.ts +34 -7
  94. package/dist/factory.d.ts.map +1 -1
  95. package/dist/factory.js +161 -133
  96. package/dist/factory.js.map +1 -1
  97. package/dist/feed-events.d.ts +4 -4
  98. package/dist/feed-events.d.ts.map +1 -1
  99. package/dist/feed-events.js +6 -6
  100. package/dist/feed-events.js.map +1 -1
  101. package/dist/index.d.ts +7 -2
  102. package/dist/index.d.ts.map +1 -1
  103. package/dist/index.js +5 -3
  104. package/dist/integrations/base.d.ts +6 -13
  105. package/dist/integrations/base.d.ts.map +1 -1
  106. package/dist/integrations/closing-references.d.ts +15 -0
  107. package/dist/integrations/closing-references.d.ts.map +1 -0
  108. package/dist/integrations/closing-references.js +69 -0
  109. package/dist/integrations/closing-references.js.map +1 -0
  110. package/dist/integrations/github/default-rules.d.ts +15 -66
  111. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  112. package/dist/integrations/github/default-rules.js +129 -73
  113. package/dist/integrations/github/default-rules.js.map +1 -1
  114. package/dist/integrations/github/integration.d.ts.map +1 -1
  115. package/dist/integrations/github/integration.js +7 -3
  116. package/dist/integrations/github/integration.js.map +1 -1
  117. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  118. package/dist/integrations/github/issue-reconciler.js +5 -3
  119. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  120. package/dist/integrations/github/provenance.js +1 -1
  121. package/dist/integrations/github/provenance.js.map +1 -1
  122. package/dist/integrations/github/pull-request-source.d.ts +8 -0
  123. package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
  124. package/dist/integrations/github/pull-request-source.js +17 -0
  125. package/dist/integrations/github/pull-request-source.js.map +1 -0
  126. package/dist/integrations/github/reconcile-worker.d.ts +5 -1
  127. package/dist/integrations/github/reconcile-worker.d.ts.map +1 -1
  128. package/dist/integrations/github/reconcile-worker.js +39 -6
  129. package/dist/integrations/github/reconcile-worker.js.map +1 -1
  130. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -1
  131. package/dist/integrations/github/review-status-reporter.js +7 -3
  132. package/dist/integrations/github/review-status-reporter.js.map +1 -1
  133. package/dist/integrations/github/routes.d.ts +4 -3
  134. package/dist/integrations/github/routes.d.ts.map +1 -1
  135. package/dist/integrations/github/routes.js +10 -87
  136. package/dist/integrations/github/routes.js.map +1 -1
  137. package/dist/integrations/github/rules.d.ts +79 -7
  138. package/dist/integrations/github/rules.d.ts.map +1 -1
  139. package/dist/integrations/github/rules.js +426 -102
  140. package/dist/integrations/github/rules.js.map +1 -1
  141. package/dist/integrations/github/sandbox.d.ts +10 -2
  142. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  143. package/dist/integrations/github/sandbox.js +20 -4
  144. package/dist/integrations/github/sandbox.js.map +1 -1
  145. package/dist/integrations/github/session-subscriptions.js +2 -2
  146. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  147. package/dist/integrations/github/token-refresh.d.ts +2 -1
  148. package/dist/integrations/github/token-refresh.d.ts.map +1 -1
  149. package/dist/integrations/github/token-refresh.js.map +1 -1
  150. package/dist/integrations/gitlab/agent-tools.js +1 -1
  151. package/dist/integrations/gitlab/default-rules.d.ts +73 -31
  152. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  153. package/dist/integrations/gitlab/default-rules.js +106 -43
  154. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  155. package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
  156. package/dist/integrations/gitlab/issue-reconciler.js +2 -1
  157. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  158. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  159. package/dist/integrations/gitlab/merge-request-reconciler.js +12 -5
  160. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  161. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  162. package/dist/integrations/gitlab/routes.js +1 -3
  163. package/dist/integrations/gitlab/routes.js.map +1 -1
  164. package/dist/integrations/gitlab/rules.d.ts +6 -1
  165. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  166. package/dist/integrations/gitlab/rules.js +119 -30
  167. package/dist/integrations/gitlab/rules.js.map +1 -1
  168. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  169. package/dist/integrations/incidentio/agent-tools.js +6 -6
  170. package/dist/integrations/incidentio/agent-tools.js.map +1 -1
  171. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  172. package/dist/integrations/incidentio/default-rules.js +3 -3
  173. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  174. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  175. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  176. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  177. package/dist/integrations/incidentio/routes.d.ts +2 -2
  178. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  179. package/dist/integrations/incidentio/routes.js +10 -13
  180. package/dist/integrations/incidentio/routes.js.map +1 -1
  181. package/dist/integrations/incidentio/rules.d.ts +4 -4
  182. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  183. package/dist/integrations/incidentio/rules.js +18 -14
  184. package/dist/integrations/incidentio/rules.js.map +1 -1
  185. package/dist/integrations/issue-reconciler.js +1 -1
  186. package/dist/integrations/issue-reconciler.js.map +1 -1
  187. package/dist/integrations/jira/agent-tools.js +1 -1
  188. package/dist/integrations/jira/binding-scope.d.ts +5 -6
  189. package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
  190. package/dist/integrations/jira/binding-scope.js +9 -11
  191. package/dist/integrations/jira/binding-scope.js.map +1 -1
  192. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  193. package/dist/integrations/jira/default-rules.js +3 -3
  194. package/dist/integrations/jira/default-rules.js.map +1 -1
  195. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  196. package/dist/integrations/jira/issue-reconciler.js +2 -1
  197. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  198. package/dist/integrations/jira/routes.d.ts.map +1 -1
  199. package/dist/integrations/jira/routes.js +3 -5
  200. package/dist/integrations/jira/routes.js.map +1 -1
  201. package/dist/integrations/jira/rules.d.ts +4 -4
  202. package/dist/integrations/jira/rules.d.ts.map +1 -1
  203. package/dist/integrations/jira/rules.js +18 -14
  204. package/dist/integrations/jira/rules.js.map +1 -1
  205. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  206. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  207. package/dist/integrations/linear/agent-tools.js +81 -3
  208. package/dist/integrations/linear/agent-tools.js.map +1 -1
  209. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  210. package/dist/integrations/linear/default-rules.js +3 -3
  211. package/dist/integrations/linear/default-rules.js.map +1 -1
  212. package/dist/integrations/linear/integration.d.ts +4 -1
  213. package/dist/integrations/linear/integration.d.ts.map +1 -1
  214. package/dist/integrations/linear/integration.js +21 -1
  215. package/dist/integrations/linear/integration.js.map +1 -1
  216. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  217. package/dist/integrations/linear/issue-reconciler.js +2 -1
  218. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  219. package/dist/integrations/linear/routes.d.ts +2 -1
  220. package/dist/integrations/linear/routes.d.ts.map +1 -1
  221. package/dist/integrations/linear/routes.js +15 -17
  222. package/dist/integrations/linear/routes.js.map +1 -1
  223. package/dist/integrations/linear/rules.d.ts +4 -4
  224. package/dist/integrations/linear/rules.d.ts.map +1 -1
  225. package/dist/integrations/linear/rules.js +16 -15
  226. package/dist/integrations/linear/rules.js.map +1 -1
  227. package/dist/integrations/platform/connect/session-tools.d.ts +5 -0
  228. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
  229. package/dist/integrations/platform/connect/session-tools.js +5 -0
  230. package/dist/integrations/platform/connect/session-tools.js.map +1 -1
  231. package/dist/integrations/platform/github/event-worker.d.ts +4 -1
  232. package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
  233. package/dist/integrations/platform/github/event-worker.js +39 -3
  234. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  235. package/dist/integrations/platform/github/integration.d.ts +8 -0
  236. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  237. package/dist/integrations/platform/github/integration.js +131 -87
  238. package/dist/integrations/platform/github/integration.js.map +1 -1
  239. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  240. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  241. package/dist/integrations/platform/jira/routes.js +3 -5
  242. package/dist/integrations/platform/jira/routes.js.map +1 -1
  243. package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
  244. package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
  245. package/dist/integrations/platform/linear/event-worker.js +1 -1
  246. package/dist/integrations/platform/linear/event-worker.js.map +1 -1
  247. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  248. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  249. package/dist/integrations/platform/linear/integration.js +6 -5
  250. package/dist/integrations/platform/linear/integration.js.map +1 -1
  251. package/dist/integrations/slack/chat-tools.js +1 -1
  252. package/dist/integrations/slack/integration.d.ts +0 -2
  253. package/dist/integrations/slack/integration.d.ts.map +1 -1
  254. package/dist/integrations/slack/integration.js +0 -5
  255. package/dist/integrations/slack/integration.js.map +1 -1
  256. package/dist/integrations/slack/reply-tool.js +1 -1
  257. package/dist/integrations/slack/run-error-card.js +1 -0
  258. package/dist/integrations/slack/run-error-card.js.map +1 -1
  259. package/dist/integrations/slack/share-file-tool.js +1 -1
  260. package/dist/integrations/slack/slack.d.ts +13 -22
  261. package/dist/integrations/slack/slack.d.ts.map +1 -1
  262. package/dist/integrations/slack/slack.js +22 -83
  263. package/dist/integrations/slack/slack.js.map +1 -1
  264. package/dist/links.d.ts +1 -2
  265. package/dist/links.d.ts.map +1 -1
  266. package/dist/links.js +4 -4
  267. package/dist/links.js.map +1 -1
  268. package/dist/mcp/routes.js +3 -3
  269. package/dist/mcp/routes.js.map +1 -1
  270. package/dist/provider-display-name.d.ts.map +1 -1
  271. package/dist/provider-display-name.js +1 -0
  272. package/dist/provider-display-name.js.map +1 -1
  273. package/dist/routes/attention-parked.d.ts +1 -0
  274. package/dist/routes/attention-parked.d.ts.map +1 -1
  275. package/dist/routes/attention-parked.js +2 -2
  276. package/dist/routes/attention-parked.js.map +1 -1
  277. package/dist/routes/attention-providers.d.ts +0 -25
  278. package/dist/routes/attention-providers.d.ts.map +1 -1
  279. package/dist/routes/attention-providers.js +2 -150
  280. package/dist/routes/attention-providers.js.map +1 -1
  281. package/dist/routes/attention.d.ts +0 -2
  282. package/dist/routes/attention.d.ts.map +1 -1
  283. package/dist/routes/attention.js +2 -13
  284. package/dist/routes/attention.js.map +1 -1
  285. package/dist/routes/automation-runs.d.ts +5 -1
  286. package/dist/routes/automation-runs.d.ts.map +1 -1
  287. package/dist/routes/automation-runs.js +15 -0
  288. package/dist/routes/automation-runs.js.map +1 -1
  289. package/dist/routes/board-snapshot.d.ts +15 -0
  290. package/dist/routes/board-snapshot.d.ts.map +1 -0
  291. package/dist/routes/board-snapshot.js +41 -0
  292. package/dist/routes/board-snapshot.js.map +1 -0
  293. package/dist/routes/boards.d.ts +2 -2
  294. package/dist/routes/boards.d.ts.map +1 -1
  295. package/dist/routes/boards.js +1 -17
  296. package/dist/routes/boards.js.map +1 -1
  297. package/dist/routes/config.d.ts +11 -1
  298. package/dist/routes/config.d.ts.map +1 -1
  299. package/dist/routes/config.js +120 -22
  300. package/dist/routes/config.js.map +1 -1
  301. package/dist/routes/contracts.d.ts +251 -51
  302. package/dist/routes/contracts.d.ts.map +1 -1
  303. package/dist/routes/contracts.js +120 -40
  304. package/dist/routes/contracts.js.map +1 -1
  305. package/dist/routes/feed-events.d.ts +15 -0
  306. package/dist/routes/feed-events.d.ts.map +1 -0
  307. package/dist/routes/feed-events.js +68 -0
  308. package/dist/routes/feed-events.js.map +1 -0
  309. package/dist/routes/fs.d.ts +4 -0
  310. package/dist/routes/fs.d.ts.map +1 -1
  311. package/dist/routes/fs.js +8 -4
  312. package/dist/routes/fs.js.map +1 -1
  313. package/dist/routes/intake-routes.d.ts.map +1 -1
  314. package/dist/routes/intake-routes.js +6 -1
  315. package/dist/routes/intake-routes.js.map +1 -1
  316. package/dist/routes/intake.d.ts +0 -23
  317. package/dist/routes/intake.d.ts.map +1 -1
  318. package/dist/routes/intake.js +13 -309
  319. package/dist/routes/intake.js.map +1 -1
  320. package/dist/routes/knowledge.js +1 -1
  321. package/dist/routes/mastra-gateway.d.ts +19 -0
  322. package/dist/routes/mastra-gateway.d.ts.map +1 -0
  323. package/dist/routes/mastra-gateway.js +120 -0
  324. package/dist/routes/mastra-gateway.js.map +1 -0
  325. package/dist/routes/projects.d.ts +1 -1
  326. package/dist/routes/projects.d.ts.map +1 -1
  327. package/dist/routes/projects.js +74 -58
  328. package/dist/routes/projects.js.map +1 -1
  329. package/dist/routes/provider-credentials.d.ts +6 -1
  330. package/dist/routes/provider-credentials.d.ts.map +1 -1
  331. package/dist/routes/provider-credentials.js +42 -7
  332. package/dist/routes/provider-credentials.js.map +1 -1
  333. package/dist/routes/route.d.ts +6 -0
  334. package/dist/routes/route.d.ts.map +1 -1
  335. package/dist/routes/route.js.map +1 -1
  336. package/dist/routes/running-packages.d.ts +13 -0
  337. package/dist/routes/running-packages.d.ts.map +1 -0
  338. package/dist/routes/running-packages.js +45 -0
  339. package/dist/routes/running-packages.js.map +1 -0
  340. package/dist/routes/sandbox-envs.d.ts +26 -0
  341. package/dist/routes/sandbox-envs.d.ts.map +1 -0
  342. package/dist/routes/sandbox-envs.js +180 -0
  343. package/dist/routes/sandbox-envs.js.map +1 -0
  344. package/dist/routes/session-access.d.ts.map +1 -1
  345. package/dist/routes/session-access.js +12 -3
  346. package/dist/routes/session-access.js.map +1 -1
  347. package/dist/routes/surface.d.ts +10 -8
  348. package/dist/routes/surface.d.ts.map +1 -1
  349. package/dist/routes/surface.js +105 -42
  350. package/dist/routes/surface.js.map +1 -1
  351. package/dist/routes/tenant-credentials.d.ts.map +1 -1
  352. package/dist/routes/tenant-credentials.js +5 -1
  353. package/dist/routes/tenant-credentials.js.map +1 -1
  354. package/dist/routes/work-items.d.ts +0 -3
  355. package/dist/routes/work-items.d.ts.map +1 -1
  356. package/dist/routes/work-items.js +38 -10
  357. package/dist/routes/work-items.js.map +1 -1
  358. package/dist/rules/binding-context.d.ts.map +1 -1
  359. package/dist/rules/binding-context.js +1 -0
  360. package/dist/rules/binding-context.js.map +1 -1
  361. package/dist/rules/dispatcher.d.ts +0 -9
  362. package/dist/rules/dispatcher.d.ts.map +1 -1
  363. package/dist/rules/dispatcher.js +362 -69
  364. package/dist/rules/dispatcher.js.map +1 -1
  365. package/dist/rules/event-rules.d.ts +33 -2
  366. package/dist/rules/event-rules.d.ts.map +1 -1
  367. package/dist/rules/event-rules.js +46 -11
  368. package/dist/rules/event-rules.js.map +1 -1
  369. package/dist/rules/index.d.ts +2 -4
  370. package/dist/rules/index.d.ts.map +1 -1
  371. package/dist/rules/index.js +2 -3
  372. package/dist/rules/phase-goal.d.ts +54 -0
  373. package/dist/rules/phase-goal.d.ts.map +1 -0
  374. package/dist/rules/phase-goal.js +70 -0
  375. package/dist/rules/phase-goal.js.map +1 -0
  376. package/dist/rules/phase-tools.d.ts +11 -0
  377. package/dist/rules/phase-tools.d.ts.map +1 -0
  378. package/dist/rules/phase-tools.js +19 -0
  379. package/dist/rules/phase-tools.js.map +1 -0
  380. package/dist/rules/processor.d.ts.map +1 -1
  381. package/dist/rules/processor.js +116 -15
  382. package/dist/rules/processor.js.map +1 -1
  383. package/dist/rules/review-source-tool.d.ts +4 -1
  384. package/dist/rules/review-source-tool.d.ts.map +1 -1
  385. package/dist/rules/review-source-tool.js +24 -4
  386. package/dist/rules/review-source-tool.js.map +1 -1
  387. package/dist/rules/rule-group.d.ts +1 -1
  388. package/dist/rules/rule-group.d.ts.map +1 -1
  389. package/dist/rules/rule-group.js +15 -6
  390. package/dist/rules/rule-group.js.map +1 -1
  391. package/dist/rules/start-coordinator.d.ts +5 -1
  392. package/dist/rules/start-coordinator.d.ts.map +1 -1
  393. package/dist/rules/start-coordinator.js +9 -3
  394. package/dist/rules/start-coordinator.js.map +1 -1
  395. package/dist/rules/tools.d.ts.map +1 -1
  396. package/dist/rules/tools.js +39 -28
  397. package/dist/rules/tools.js.map +1 -1
  398. package/dist/rules/transition-service.d.ts +4 -10
  399. package/dist/rules/transition-service.d.ts.map +1 -1
  400. package/dist/rules/transition-service.js +61 -55
  401. package/dist/rules/transition-service.js.map +1 -1
  402. package/dist/rules/types.d.ts +86 -36
  403. package/dist/rules/types.d.ts.map +1 -1
  404. package/dist/rules/types.js +5 -41
  405. package/dist/rules/types.js.map +1 -1
  406. package/dist/rules/validation.d.ts.map +1 -1
  407. package/dist/rules/validation.js +32 -2
  408. package/dist/rules/validation.js.map +1 -1
  409. package/dist/run-error.d.ts +1 -1
  410. package/dist/run-error.d.ts.map +1 -1
  411. package/dist/run-error.js +38 -5
  412. package/dist/run-error.js.map +1 -1
  413. package/dist/sandbox/sandbox-env-cache.d.ts +33 -0
  414. package/dist/sandbox/sandbox-env-cache.d.ts.map +1 -0
  415. package/dist/sandbox/sandbox-env-cache.js +140 -0
  416. package/dist/sandbox/sandbox-env-cache.js.map +1 -0
  417. package/dist/sandbox/sandbox-env.d.ts +77 -0
  418. package/dist/sandbox/sandbox-env.d.ts.map +1 -0
  419. package/dist/sandbox/sandbox-env.js +130 -0
  420. package/dist/sandbox/sandbox-env.js.map +1 -0
  421. package/dist/secret-encryption.d.ts +21 -0
  422. package/dist/secret-encryption.d.ts.map +1 -1
  423. package/dist/secret-encryption.js +31 -4
  424. package/dist/secret-encryption.js.map +1 -1
  425. package/dist/session/live-sessions.d.ts +11 -4
  426. package/dist/session/live-sessions.d.ts.map +1 -1
  427. package/dist/session/live-sessions.js +31 -10
  428. package/dist/session/live-sessions.js.map +1 -1
  429. package/dist/session/self-review-gate.d.ts +6 -4
  430. package/dist/session/self-review-gate.d.ts.map +1 -1
  431. package/dist/session/self-review-gate.js +9 -12
  432. package/dist/session/self-review-gate.js.map +1 -1
  433. package/dist/session/session-threads.d.ts +2 -3
  434. package/dist/session/session-threads.d.ts.map +1 -1
  435. package/dist/session/session-threads.js.map +1 -1
  436. package/dist/session/source-control-tools.d.ts +39 -13
  437. package/dist/session/source-control-tools.d.ts.map +1 -1
  438. package/dist/session/source-control-tools.js +55 -61
  439. package/dist/session/source-control-tools.js.map +1 -1
  440. package/dist/session/work-item-state-processor.d.ts +24 -0
  441. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  442. package/dist/session/work-item-state-processor.js +275 -0
  443. package/dist/session/work-item-state-processor.js.map +1 -0
  444. package/dist/storage/domains/audit/actions.d.ts +2 -1
  445. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  446. package/dist/storage/domains/audit/actions.js +5 -4
  447. package/dist/storage/domains/audit/actions.js.map +1 -1
  448. package/dist/storage/domains/boards/base.d.ts +85 -32
  449. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  450. package/dist/storage/domains/boards/base.js +120 -131
  451. package/dist/storage/domains/boards/base.js.map +1 -1
  452. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  453. package/dist/storage/domains/boards/schemas.js +12 -0
  454. package/dist/storage/domains/boards/schemas.js.map +1 -1
  455. package/dist/storage/domains/channel-identity/base.d.ts +0 -4
  456. package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
  457. package/dist/storage/domains/channel-identity/base.js +0 -7
  458. package/dist/storage/domains/channel-identity/base.js.map +1 -1
  459. package/dist/storage/domains/intake/base.d.ts +5 -45
  460. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  461. package/dist/storage/domains/intake/base.js +11 -89
  462. package/dist/storage/domains/intake/base.js.map +1 -1
  463. package/dist/storage/domains/projects/base.d.ts +17 -9
  464. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  465. package/dist/storage/domains/projects/base.js +15 -7
  466. package/dist/storage/domains/projects/base.js.map +1 -1
  467. package/dist/storage/domains/sandbox-envs/base.d.ts +70 -0
  468. package/dist/storage/domains/sandbox-envs/base.d.ts.map +1 -0
  469. package/dist/storage/domains/sandbox-envs/base.js +227 -0
  470. package/dist/storage/domains/sandbox-envs/base.js.map +1 -0
  471. package/dist/storage/domains/work-items/base.d.ts +62 -22
  472. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  473. package/dist/storage/domains/work-items/base.js +218 -146
  474. package/dist/storage/domains/work-items/base.js.map +1 -1
  475. package/dist/storage/domains/work-items/board-version.d.ts +6 -2
  476. package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
  477. package/dist/storage/domains/work-items/board-version.js +20 -9
  478. package/dist/storage/domains/work-items/board-version.js.map +1 -1
  479. package/dist/storage/domains/work-items/cards.d.ts +28 -5
  480. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  481. package/dist/storage/domains/work-items/cards.js +156 -23
  482. package/dist/storage/domains/work-items/cards.js.map +1 -1
  483. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  484. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  485. package/dist/storage/domains/work-items/legacy-review.js +109 -0
  486. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  487. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  488. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  489. package/dist/storage/domains/work-items/metrics.js +14 -32
  490. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  491. package/dist/storage/domains/work-items/work-item-schema.d.ts +4 -2
  492. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  493. package/dist/storage/domains/work-items/work-item-schema.js +59 -26
  494. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  495. package/dist/tools/approval-tools.d.ts.map +1 -1
  496. package/dist/tools/approval-tools.js +28 -9
  497. package/dist/tools/approval-tools.js.map +1 -1
  498. package/dist/tools/index.d.ts +1 -1
  499. package/dist/tools/index.js +1 -1
  500. package/dist/tools/index.js.map +1 -1
  501. package/dist/tools/messaging-tools.d.ts +3 -0
  502. package/dist/tools/messaging-tools.d.ts.map +1 -1
  503. package/dist/tools/messaging-tools.js +2 -1
  504. package/dist/tools/messaging-tools.js.map +1 -1
  505. package/dist/tools/read-tools.d.ts +8 -4
  506. package/dist/tools/read-tools.d.ts.map +1 -1
  507. package/dist/tools/read-tools.js +86 -37
  508. package/dist/tools/read-tools.js.map +1 -1
  509. package/dist/tools/reports.d.ts +1 -0
  510. package/dist/tools/reports.d.ts.map +1 -1
  511. package/dist/tools/reports.js +2 -1
  512. package/dist/tools/reports.js.map +1 -1
  513. package/dist/tools/run-watch.d.ts +1 -1
  514. package/dist/tools/run-watch.d.ts.map +1 -1
  515. package/dist/tools/run-watch.js +1 -0
  516. package/dist/tools/run-watch.js.map +1 -1
  517. package/dist/tools/sandbox-tools.js +1 -1
  518. package/dist/tools/session-tools.js +1 -1
  519. package/dist/tools/sessions-state-processor.d.ts +2 -0
  520. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  521. package/dist/tools/sessions-state-processor.js +4 -2
  522. package/dist/tools/sessions-state-processor.js.map +1 -1
  523. package/dist/tools/side-sessions.d.ts +2 -0
  524. package/dist/tools/side-sessions.d.ts.map +1 -1
  525. package/dist/tools/side-sessions.js +2 -1
  526. package/dist/tools/side-sessions.js.map +1 -1
  527. package/dist/tools/work-item-tools.d.ts +0 -3
  528. package/dist/tools/work-item-tools.d.ts.map +1 -1
  529. package/dist/tools/work-item-tools.js +10 -20
  530. package/dist/tools/work-item-tools.js.map +1 -1
  531. package/dist/work-item-branch.d.ts +13 -0
  532. package/dist/work-item-branch.d.ts.map +1 -1
  533. package/dist/work-item-branch.js +16 -1
  534. package/dist/work-item-branch.js.map +1 -1
  535. package/dist/work-items/create-work-item.d.ts +6 -0
  536. package/dist/work-items/create-work-item.d.ts.map +1 -1
  537. package/dist/work-items/create-work-item.js +28 -3
  538. package/dist/work-items/create-work-item.js.map +1 -1
  539. package/dist/work-items/description-context.d.ts +5 -0
  540. package/dist/work-items/description-context.d.ts.map +1 -0
  541. package/dist/work-items/description-context.js +17 -0
  542. package/dist/work-items/description-context.js.map +1 -0
  543. package/dist/work-items/providers/base.d.ts +4 -1
  544. package/dist/work-items/providers/base.d.ts.map +1 -1
  545. package/dist/work-items/providers/base.js +6 -1
  546. package/dist/work-items/providers/base.js.map +1 -1
  547. package/dist/work-items/providers/github.d.ts.map +1 -1
  548. package/dist/work-items/providers/github.js +2 -1
  549. package/dist/work-items/providers/github.js.map +1 -1
  550. package/dist/work-items/providers/gitlab.d.ts.map +1 -1
  551. package/dist/work-items/providers/gitlab.js +2 -1
  552. package/dist/work-items/providers/gitlab.js.map +1 -1
  553. package/dist/work-items/providers/jira.d.ts.map +1 -1
  554. package/dist/work-items/providers/jira.js +3 -2
  555. package/dist/work-items/providers/jira.js.map +1 -1
  556. package/dist/work-items/providers/linear.d.ts.map +1 -1
  557. package/dist/work-items/providers/linear.js +3 -2
  558. package/dist/work-items/providers/linear.js.map +1 -1
  559. package/dist/work-items/providers/types.d.ts +6 -0
  560. package/dist/work-items/providers/types.d.ts.map +1 -1
  561. package/dist/work-items/split-migration.d.ts.map +1 -1
  562. package/dist/work-items/split-migration.js +8 -8
  563. package/dist/work-items/split-migration.js.map +1 -1
  564. package/dist/workspace.d.ts +3 -1
  565. package/dist/workspace.d.ts.map +1 -1
  566. package/dist/workspace.js +116 -32
  567. package/dist/workspace.js.map +1 -1
  568. package/factory-skills/configure-factory-rules/SKILL.md +13 -11
  569. package/factory-skills/factory-build/SKILL.md +64 -0
  570. package/factory-skills/factory-gitlab-rereview/SKILL.md +4 -4
  571. package/factory-skills/factory-gitlab-review/SKILL.md +6 -6
  572. package/factory-skills/factory-plan/SKILL.md +8 -10
  573. package/factory-skills/factory-rereview/SKILL.md +74 -28
  574. package/factory-skills/factory-review/SKILL.md +85 -29
  575. package/factory-skills/factory-self-review/SKILL.md +32 -13
  576. package/factory-skills/factory-triage/SKILL.md +36 -32
  577. package/package.json +12 -12
  578. package/dist/boards/index.js.map +0 -1
  579. package/dist/boards/pull-request-review.d.ts +0 -14
  580. package/dist/boards/pull-request-review.d.ts.map +0 -1
  581. package/dist/boards/pull-request-review.js +0 -81
  582. package/dist/boards/pull-request-review.js.map +0 -1
  583. package/dist/boards/work-tool-rules.d.ts +0 -8
  584. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  585. package/dist/boards/work-tool-rules.js +0 -19
  586. package/dist/boards/work-tool-rules.js.map +0 -1
  587. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
  588. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
  589. package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
  590. package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
  591. package/dist/integrations/slack/emoji.d.ts +0 -3
  592. package/dist/integrations/slack/emoji.d.ts.map +0 -1
  593. package/dist/integrations/slack/emoji.js +0 -11
  594. package/dist/integrations/slack/emoji.js.map +0 -1
  595. package/dist/integrations/slack/feed-publisher.d.ts +0 -26
  596. package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
  597. package/dist/integrations/slack/feed-publisher.js +0 -43
  598. package/dist/integrations/slack/feed-publisher.js.map +0 -1
  599. package/dist/routes/attention-activity.d.ts +0 -23
  600. package/dist/routes/attention-activity.d.ts.map +0 -1
  601. package/dist/routes/attention-activity.js +0 -154
  602. package/dist/routes/attention-activity.js.map +0 -1
  603. package/dist/rules/resolve.d.ts +0 -15
  604. package/dist/rules/resolve.d.ts.map +0 -1
  605. package/dist/rules/resolve.js +0 -22
  606. package/dist/rules/resolve.js.map +0 -1
  607. package/dist/storage/domains/comments/activity.d.ts +0 -40
  608. package/dist/storage/domains/comments/activity.d.ts.map +0 -1
  609. package/dist/storage/domains/comments/activity.js +0 -93
  610. package/dist/storage/domains/comments/activity.js.map +0 -1
  611. package/dist/storage/domains/comments/actor.d.ts +0 -51
  612. package/dist/storage/domains/comments/actor.d.ts.map +0 -1
  613. package/dist/storage/domains/comments/actor.js +0 -37
  614. package/dist/storage/domains/comments/actor.js.map +0 -1
  615. package/dist/storage/domains/comments/base.d.ts +0 -245
  616. package/dist/storage/domains/comments/base.d.ts.map +0 -1
  617. package/dist/storage/domains/comments/base.js +0 -539
  618. package/dist/storage/domains/comments/base.js.map +0 -1
  619. package/dist/storage/domains/comments/domain.d.ts +0 -135
  620. package/dist/storage/domains/comments/domain.d.ts.map +0 -1
  621. package/dist/storage/domains/comments/domain.js +0 -284
  622. package/dist/storage/domains/comments/domain.js.map +0 -1
  623. package/dist/storage/domains/comments/feed-context.d.ts +0 -22
  624. package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
  625. package/dist/storage/domains/comments/feed-context.js +0 -88
  626. package/dist/storage/domains/comments/feed-context.js.map +0 -1
  627. package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
  628. package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
  629. package/dist/storage/domains/comments/feed-sync.js +0 -1
  630. package/dist/storage/domains/comments/parse.d.ts +0 -23
  631. package/dist/storage/domains/comments/parse.d.ts.map +0 -1
  632. package/dist/storage/domains/comments/parse.js +0 -89
  633. package/dist/storage/domains/comments/parse.js.map +0 -1
  634. package/dist/storage/domains/comments/routes.d.ts +0 -24
  635. package/dist/storage/domains/comments/routes.d.ts.map +0 -1
  636. package/dist/storage/domains/comments/routes.js +0 -299
  637. package/dist/storage/domains/comments/routes.js.map +0 -1
  638. package/dist/storage/domains/comments/schema.d.ts +0 -5
  639. package/dist/storage/domains/comments/schema.d.ts.map +0 -1
  640. package/dist/storage/domains/comments/schema.js +0 -178
  641. package/dist/storage/domains/comments/schema.js.map +0 -1
  642. package/dist/storage/domains/comments/wire.d.ts +0 -40
  643. package/dist/storage/domains/comments/wire.d.ts.map +0 -1
  644. package/dist/storage/domains/comments/wire.js +0 -36
  645. package/dist/storage/domains/comments/wire.js.map +0 -1
  646. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -23,9 +23,9 @@ export interface FactoryTransitionRequest {
23
23
  };
24
24
  cause: string;
25
25
  causalChain?: readonly FactoryRuleCausalEntry[];
26
- /** Internal materialization path: evaluate only the destination onEnter leaf even when already at that stage. */
26
+ /** Internal materialization path: start the destination phase's runner even when already at that stage. */
27
27
  initialEntry?: boolean;
28
- /** Re-runs the stage's entry rules when the item already holds that stage, to restart work the entry invalidated. */
28
+ /** Starts the stage's runner again when the item already holds that stage, to restart work the entry invalidated. */
29
29
  reenter?: boolean;
30
30
  /** Internal proof that this move consumes an approved `submit_plan` result. */
31
31
  planApproved?: true;
@@ -33,12 +33,11 @@ export interface FactoryTransitionRequest {
33
33
  completedTool?: string;
34
34
  /**
35
35
  * Internal: an intake route moves the card on a status event. A route is admin-authored, so it
36
- * may name any phase on the card's board regardless of the board's next phases; it enters a
37
- * working phase only when the route allows it.
36
+ * may name any phase on the card's board regardless of the board's next phases, working ones
37
+ * included. The phase's `autoStart` and the dispatcher's approval check decide whether its run starts.
38
38
  */
39
39
  eventRoute?: {
40
40
  routeId: string;
41
- allowWorkingPhase: boolean;
42
41
  };
43
42
  }
44
43
  export interface FactoryTransitionServiceOptions {
@@ -93,11 +92,6 @@ export interface FactoryTransitionServiceOptions {
93
92
  workItemId: string;
94
93
  item: Card;
95
94
  }) => Promise<void> | void;
96
- /** Resolves whether a project self-reviews Work items before the change request opens. Unset means off. */
97
- selfReviewEnabled?: (tenant: {
98
- orgId: string;
99
- factoryProjectId: string;
100
- }) => Promise<boolean>;
101
95
  }
102
96
  export declare function auditActorOf(actor: FactoryRuleActor): {
103
97
  actorId: string;
@@ -1 +1 @@
1
- {"version":3,"file":"transition-service.d.ts","sourceRoot":"","sources":["../../src/rules/transition-service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transition-service.d.ts","sourceRoot":"","sources":["../../src/rules/transition-service.ts"],"names":[],"mappings":"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"}
@@ -1,11 +1,14 @@
1
- import { autoApprovedExitTool } from "../boards/phase-automation.js";
1
+ import "../boards/index.js";
2
+ import { autoApprovedExitTool, exitToolSucceeded } from "../boards/phase-automation.js";
3
+ import "../boards/define-board.js";
4
+ import "../boards/default-board.js";
5
+ import { phaseRunDecision } from "../boards/phase-runner.js";
2
6
  import { toBoardSource } from "../boards/project-boards.js";
7
+ import { boardFlow, boardForWorkItem, hasPullRequest, pullRequestCardRejection } from "../boards/semantics.js";
3
8
  import { boardTransitionPolicyResultSchema, immutablePolicySnapshot } from "../boards/transition-policy.js";
4
- import { workPullRequestCardRejection } from "../boards/work.js";
5
9
  import { isAgentActor } from "../storage/domains/work-items/base.js";
6
- import { resolveFactoryStageRules } from "./resolve.js";
7
- import { factoryRuleSourceForWorkItem, isFactoryRuleStage, workItemSource } from "./types.js";
8
- import { assertFactoryDecisionTarget, validateFactoryRuleDecision, validateFactoryRuleDecisions } from "./validation.js";
10
+ import { factoryRuleSourceForWorkItem, workItemSource } from "./types.js";
11
+ import { assertFactoryDecisionTarget, validateFactoryRuleDecisions } from "./validation.js";
9
12
  // src/rules/transition-service.ts
10
13
  const RULE_TIMEOUT_MS = 5e3;
11
14
  const MAX_REJECTION_REASON = 512;
@@ -50,10 +53,30 @@ function auditActorOf(actor) {
50
53
  };
51
54
  }
52
55
  }
56
+ function isStale(result) {
57
+ return result.status === "rejected" && result.code === "stale";
58
+ }
59
+ /** Tell the caller where the card is now, so a model doesn't read "stale" as "already moved". */
60
+ function staleRejection(result, current) {
61
+ const stage = currentStage(current.stages) ?? current.stages.join(", ");
62
+ return rejection(result.transitionId, result.itemId, "stale", `The card changed (now revision ${current.revision}, in ${stage}). Retry with expectedRevision ${current.revision} if the move still applies.`);
63
+ }
53
64
  function currentStage(stages) {
54
- if (stages.length !== 1) return void 0;
55
- const stage = stages[0];
56
- return isFactoryRuleStage(stage) ? stage : void 0;
65
+ return stages.length === 1 ? stages[0] : void 0;
66
+ }
67
+ /**
68
+ * Whether moving a card from `from` to `to` hands it to the board's builder for the first time: `to`
69
+ * runs in the seat of the board's build phase ({@link boardFlow}), and `from` is a resting phase or a
70
+ * working phase of another seat that is no review (Work: Intake or Triage into Planning or Building).
71
+ */
72
+ function acceptsWork(board, from, to) {
73
+ const buildRole = boardFlow(board).buildRole;
74
+ if (!buildRole || board.roleForPhase(to) !== buildRole) return false;
75
+ const fromPhase = board.phases[from];
76
+ if (!fromPhase || fromPhase.kind === "terminal") return false;
77
+ if (fromPhase.kind === "resting") return true;
78
+ const fromRole = fromPhase.runner.context;
79
+ return fromRole !== buildRole && fromRole !== "review";
57
80
  }
58
81
  function transitionConsent(working, humanMove) {
59
82
  if (!working) return "disarm";
@@ -110,7 +133,6 @@ var FactoryTransitionService = class {
110
133
  #terminalCleanupTimeoutMs;
111
134
  #onAccepted;
112
135
  #onTransitionCommitted;
113
- #selfReviewEnabled;
114
136
  #audit;
115
137
  constructor(options) {
116
138
  this.#configVersion = options.configVersion;
@@ -121,7 +143,6 @@ var FactoryTransitionService = class {
121
143
  this.#onTerminalStage = options.onTerminalStage;
122
144
  this.#onAccepted = options.onAccepted;
123
145
  this.#onTransitionCommitted = options.onTransitionCommitted;
124
- this.#selfReviewEnabled = options.selfReviewEnabled;
125
146
  this.#terminalCleanupTimeoutMs = options.terminalCleanupTimeoutMs ?? TERMINAL_CLEANUP_TIMEOUT_MS;
126
147
  }
127
148
  get configVersion() {
@@ -140,7 +161,14 @@ var FactoryTransitionService = class {
140
161
  await this.#recordTransition(request, void 0, rejection);
141
162
  return rejection;
142
163
  }
143
- const result = await this.#evaluateAndCommit(request, transitionId, item);
164
+ let result = await this.#evaluateAndCommit(request, transitionId, item);
165
+ if (isStale(result)) {
166
+ const current = await this.#storage.get({
167
+ orgId: request.orgId,
168
+ id: request.workItemId
169
+ });
170
+ if (current) result = staleRejection(result, current);
171
+ }
144
172
  await this.#recordTransition(request, item, result);
145
173
  this.#notifyCommitted(request, item, result);
146
174
  return result;
@@ -163,7 +191,7 @@ var FactoryTransitionService = class {
163
191
  /** A rejection can outlive its work item: the row still names the id the caller asked for. */
164
192
  async #recordTransition(request, item, result) {
165
193
  if (!this.#audit) return;
166
- const from = item ? currentStage(item.stages) : void 0;
194
+ const from = item && item.stages.length === 1 ? item.stages[0] : void 0;
167
195
  if (result.status === "accepted" && result.stage === from && !request.reenter) return;
168
196
  const { action, ...detail } = result.status === "accepted" ? {
169
197
  action: "factory.work_item.stage_moved",
@@ -207,23 +235,26 @@ var FactoryTransitionService = class {
207
235
  const itemSource = workItemSource(item.externalSource);
208
236
  const source = factoryRuleSourceForWorkItem(itemSource);
209
237
  const isPullRequest = source === "pullRequest" || source === "gitlabPullRequest";
210
- const legacyBoard = isPullRequest ? "review" : "work";
211
- if (item.board === null && !boards.has(legacyBoard)) return this.#commitRejection(request, transitionId, "invalid_transition", "This legacy work item has no assigned board. Assign an installed board and phase through the work-item PATCH endpoint before transitioning it.");
212
- const itemBoard = item.board ?? legacyBoard;
238
+ if (item.board === null && !boards.has("work")) return this.#commitRejection(request, transitionId, "invalid_transition", "This legacy work item has no assigned board. Assign an installed board and phase through the work-item PATCH endpoint before transitioning it.");
239
+ const itemBoard = boardForWorkItem(item);
213
240
  if (request.board !== itemBoard) return this.#commitRejection(request, transitionId, "invalid_transition", `The work item belongs to board "${itemBoard}", not "${request.board}".`);
214
- if (itemBoard === "review" && !isPullRequest) return this.#commitRejection(request, transitionId, "invalid_transition", "The work item does not belong to the requested board.");
215
241
  const board = boards.get(request.board);
216
242
  if (!board) return this.#commitRejection(request, transitionId, "invalid_transition", `Board "${request.board}" is not installed.`);
217
243
  const fromStage = item.stages.length === 1 ? item.stages[0] : void 0;
218
244
  if (!fromStage || !Object.prototype.hasOwnProperty.call(board.phases, fromStage)) return this.#commitRejection(request, transitionId, "invalid_transition", "The work item does not have one canonical phase on the requested board.");
245
+ const cardShapeRejection = pullRequestCardRejection(board, {
246
+ standalonePullRequest: isPullRequest,
247
+ hasPullRequest: hasPullRequest({
248
+ workItem: item.workItem,
249
+ source: itemSource
250
+ })
251
+ }, request.stage);
252
+ if (cardShapeRejection) return this.#commitRejection(request, transitionId, "invalid_transition", cardShapeRejection);
219
253
  if (!Object.prototype.hasOwnProperty.call(board.phases, request.stage) || !request.eventRoute && !board.allowsTransition(fromStage, request.stage)) {
220
254
  const nextStages = [...new Set((board.transitions[fromStage] ?? []).map((transition) => transition.to))];
221
255
  const nextStagesReason = nextStages.length > 0 ? `Next stages declared from ${fromStage}: ${nextStages.join(", ")}.` : `No next stage is declared from ${fromStage}.`;
222
256
  return this.#commitRejection(request, transitionId, "invalid_transition", `The ${board.name} board does not allow moving from ${fromStage} to ${request.stage}. ${nextStagesReason}`);
223
257
  }
224
- const pullRequestCardRejection = request.board === "work" ? workPullRequestCardRejection(isPullRequest, request.stage) : void 0;
225
- if (pullRequestCardRejection) return this.#commitRejection(request, transitionId, "invalid_transition", pullRequestCardRejection);
226
- if (request.eventRoute && !request.eventRoute.allowWorkingPhase && fromStage !== request.stage && board.isWorking(request.stage)) return this.#commitRejection(request, transitionId, "approval_required", `Intake route ${request.eventRoute.routeId} moves cards into ${board.phases[request.stage]?.name ?? request.stage}, a working phase, only when the route allows working phases.`);
227
258
  const humanMove = request.actor.type === "human" && fromStage !== request.stage && request.cause !== "run_start";
228
259
  const entersWorking = board.isWorking(request.stage);
229
260
  const seatRole = board.roleForPhase(request.stage);
@@ -264,13 +295,11 @@ var FactoryTransitionService = class {
264
295
  const plansAutoApproved = autoApprovedExitTool(boards, item) === "submit_plan";
265
296
  const fromPhase = board.phases[fromStage];
266
297
  const exitTool = fromPhase?.kind === "working" ? fromPhase.exitTool : void 0;
267
- if (request.actor.type !== "human" && !request.eventRoute && exitTool && board.tools[exitTool.id] && fromStage !== request.stage && entersWorking && !(exitTool.id === "submit_plan" ? request.planApproved === true : request.completedTool === exitTool.id)) {
268
- if (autoApprovedExitTool(boards, item) !== exitTool.id) return {
269
- outcome: "rejected",
270
- code: "approval_required",
271
- reason: exitTool.id === "submit_plan" ? `A person has to approve this plan. Ask them to say so in a chat they are signed in to (Slack, terminal, web); that turn can move the card into ${board.phases[request.stage]?.name ?? request.stage} with factory_transition_work_item.` : `${fromPhase.name} ends when ${exitTool.id} succeeds, and that moves the card. A person can also move it from the Factory board or a chat they are signed in to.`
272
- };
273
- }
298
+ if (request.actor.type !== "human" && !request.eventRoute && exitTool && fromStage !== request.stage && entersWorking && !(exitTool.id === "submit_plan" ? request.planApproved === true : request.completedTool === exitTool.id) && !exitToolSucceeded(item, fromStage, exitTool.id)) return {
299
+ outcome: "rejected",
300
+ code: "approval_required",
301
+ reason: exitTool.id === "submit_plan" ? `${fromPhase.name} ends when submit_plan comes back with an approved plan; until then the card stays here. Call submit_plan and wait for a person to approve the plan (or for it to be approved automatically), then move the card into ${board.phases[request.stage]?.name ?? request.stage} with factory_transition_work_item.` : `${fromPhase.name} ends when ${exitTool.id} succeeds; until then the card stays here. A person can also move it from the Factory board or a chat they are signed in to.`
302
+ };
274
303
  const policy = boardTransitionPolicyResultSchema.parse(await board.transitionPolicy?.(immutablePolicySnapshot({
275
304
  ...contextBase,
276
305
  item: {
@@ -289,37 +318,14 @@ var FactoryTransitionService = class {
289
318
  code: policy.code,
290
319
  reason: policy.reason
291
320
  };
292
- const selfReviewEnabled = request.board === "work" && this.#selfReviewEnabled ? await this.#selfReviewEnabled({
293
- orgId: request.orgId,
294
- factoryProjectId: request.factoryProjectId
295
- }) : false;
296
- const decisions = [];
297
- for (const rule of resolveFactoryStageRules(boards, {
298
- board: request.board,
299
- source,
300
- fromStage,
301
- toStage: request.stage,
321
+ const run = phaseRunDecision(board, request.stage, contextBase, {
302
322
  initialEntry: request.initialEntry,
303
323
  reenter: request.reenter
304
- })) {
305
- const context = Object.freeze({
306
- ...contextBase,
307
- selfReviewEnabled,
308
- stage: rule.phase === "exit" ? fromStage : request.stage
309
- });
310
- const raw = await rule.handler(context);
311
- if (raw === void 0) continue;
312
- const decision = validateFactoryRuleDecision(raw, context.causalChain.length);
313
- if (decision.type === "reject") return {
314
- outcome: "rejected",
315
- code: decision.code,
316
- reason: decision.reason
317
- };
324
+ });
325
+ const validated = validateFactoryRuleDecisions(run ? [run] : [], contextBase.causalChain.length).filter((decision) => {
318
326
  assertFactoryDecisionTarget(decision, boards, itemBoard);
319
- if (startsRun(decision) && runAlreadyUnderway(request, decision)) continue;
320
- decisions.push(decision);
321
- }
322
- const validated = validateFactoryRuleDecisions(decisions);
327
+ return !(startsRun(decision) && runAlreadyUnderway(request, decision));
328
+ });
323
329
  if (humanMove) {
324
330
  const message = stageTransitionMessage(fromStage, request.stage);
325
331
  const skill = validated.find((decision) => decision.type === "invokeSkill");
@@ -338,7 +344,7 @@ var FactoryTransitionService = class {
338
344
  }
339
345
  return {
340
346
  outcome: "accepted",
341
- intents: { accepted: request.board === "work" && isHumanTransition(request) && (fromStage === "intake" || fromStage === "triage") && (request.stage === "planning" || request.stage === "execute") },
347
+ intents: { accepted: isHumanTransition(request) && acceptsWork(board, fromStage, request.stage) },
342
348
  decisions: validateFactoryRuleDecisions(validated)
343
349
  };
344
350
  })(), this.#timeoutMs);
@@ -1 +1 @@
1
- {"version":3,"file":"transition-service.js","names":[],"sources":["../../src/rules/transition-service.ts"],"sourcesContent":["import type { BoardRegistry } from '../boards/index.js';\nimport { autoApprovedExitTool } from '../boards/phase-automation.js';\nimport { toBoardSource } from '../boards/project-boards.js';\nimport type { ProjectBoardSource } from '../boards/project-boards.js';\nimport { boardTransitionPolicyResultSchema, immutablePolicySnapshot } from '../boards/transition-policy.js';\nimport { workPullRequestCardRejection } from '../boards/work.js';\nimport type { AuditActorProfileInput, AuditActorType, AuditContext } from '../storage/domains/audit/base.js';\nimport type { AuditRecorder } from '../storage/domains/audit/domain.js';\nimport { isAgentActor } from '../storage/domains/work-items/base.js';\nimport type { Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { resolveFactoryStageRules } from './resolve.js';\nimport type {\n FactoryCommitDecision,\n FactoryRuleActor,\n FactoryRuleBoard,\n FactoryRuleCausalEntry,\n FactoryRuleRejectionCode,\n FactoryRuleStage,\n FactoryStageRuleContext,\n FactoryTransitionResult,\n} from './types.js';\nimport { factoryRuleSourceForWorkItem, isFactoryRuleStage, workItemSource } from './types.js';\nimport {\n MAX_FACTORY_RULE_CAUSAL_DEPTH,\n assertFactoryDecisionTarget,\n validateFactoryRuleDecision,\n validateFactoryRuleDecisions,\n} from './validation.js';\n\nconst RULE_TIMEOUT_MS = 5_000;\nconst MAX_REJECTION_REASON = 512;\n/** Longest a committed transition waits for terminal resource cleanup. Cleanup\n * reattaches remote sandboxes, so a hung provider call must not leave the\n * already-committed transition request pending; past this bound the cleanup\n * keeps running in the background as pure best-effort. */\nconst TERMINAL_CLEANUP_TIMEOUT_MS = 30_000;\n\nexport interface FactoryTransitionRequest {\n orgId: string;\n factoryProjectId: string;\n workItemId: string;\n /** Installed board id; the service rejects boards that are not installed. */\n board: string;\n stage: FactoryRuleStage;\n expectedRevision: number;\n actor: FactoryRuleActor;\n actorProfile?: AuditActorProfileInput;\n /** Where a browser request came from; rules and agents carry none. */\n context?: AuditContext;\n ingress: { type: 'human' | 'agent' | 'toolResult' | 'github' | 'rule'; identity: string; transitionId?: string };\n cause: string;\n causalChain?: readonly FactoryRuleCausalEntry[];\n /** Internal materialization path: evaluate only the destination onEnter leaf even when already at that stage. */\n initialEntry?: boolean;\n /** Re-runs the stage's entry rules when the item already holds that stage, to restart work the entry invalidated. */\n reenter?: boolean;\n /** Internal proof that this move consumes an approved `submit_plan` result. */\n planApproved?: true;\n /** Internal: the tool whose successful result this move consumes (a tool-result rule's move). */\n completedTool?: string;\n /**\n * Internal: an intake route moves the card on a status event. A route is admin-authored, so it\n * may name any phase on the card's board regardless of the board's next phases; it enters a\n * working phase only when the route allows it.\n */\n eventRoute?: { routeId: string; allowWorkingPhase: boolean };\n}\n\nexport interface FactoryTransitionServiceOptions {\n configVersion: string;\n storage: WorkItemsStorage;\n /** A fixed registry, or the per-project boards; each transition loads its project's boards. */\n boards?: BoardRegistry | ProjectBoardSource;\n /** Every commit, accepted or rejected, lands here as `stage_moved` / `transition_rejected` under the request's actor. */\n audit?: AuditRecorder;\n timeoutMs?: number;\n /**\n * Called after a transition commits into a phase the board declares\n * terminal — the point where the item's sessions stop receiving runs, so\n * resources they hold (e.g. sandboxes) can be released for reuse. Awaited,\n * but failures are swallowed: releasing resources must never break or roll\n * back the committed transition.\n */\n onTerminalStage?: (args: {\n orgId: string;\n factoryProjectId: string;\n workItemId: string;\n stage: FactoryRuleStage;\n revision: number;\n /** The actor that committed this terminal transition. Lets cleanup leave\n * the seat that drove its own transition (an agent tool call) untouched. */\n actor: FactoryRuleActor;\n }) => Promise<void> | void;\n /**\n * Called after a transition commits a stage change, e.g. to tell the item's\n * followers. Not awaited, and failures are logged: a notification must never\n * fail or delay the committed transition.\n */\n onTransitionCommitted?: (args: {\n orgId: string;\n factoryProjectId: string;\n workItemId: string;\n fromStage: string | undefined;\n toStage: string;\n }) => Promise<void> | void;\n /** Upper bound on how long a committed transition waits for\n * `onTerminalStage` before returning (default 30s). The cleanup continues\n * in the background past the bound. */\n terminalCleanupTimeoutMs?: number;\n /**\n * Called after a person moves a Work card from Intake or Triage into Planning or\n * Building, which approves the work. Fire-and-forget: failures are swallowed, the committed transition never\n * depends on it.\n */\n onAccepted?: (args: {\n orgId: string;\n factoryProjectId: string;\n workItemId: string;\n item: Card;\n }) => Promise<void> | void;\n /** Resolves whether a project self-reviews Work items before the change request opens. Unset means off. */\n selfReviewEnabled?: (tenant: { orgId: string; factoryProjectId: string }) => Promise<boolean>;\n}\n\nfunction rejection(\n transitionId: string,\n itemId: string,\n code: FactoryRuleRejectionCode,\n reason: string,\n): FactoryTransitionResult {\n return { status: 'rejected', transitionId, itemId, code, reason: reason.slice(0, MAX_REJECTION_REASON) };\n}\n\nfunction actorId(actor: FactoryRuleActor): string {\n switch (actor.type) {\n case 'human':\n case 'system':\n return actor.id;\n case 'agent':\n return `agent:${actor.bindingId}`;\n case 'github':\n return `github:${actor.login}`;\n case 'gitlab':\n return `gitlab:${actor.username}`;\n }\n}\n\n// The dispatcher executes an agent-approved decision as a human actor so its consent carries; the trail still names the agent.\nexport function auditActorOf(actor: FactoryRuleActor): { actorId: string; actorType: AuditActorType } {\n const id = actorId(actor);\n switch (actor.type) {\n case 'github':\n case 'gitlab':\n return { actorId: id, actorType: 'human' };\n case 'human':\n return { actorId: id, actorType: isAgentActor(id) ? 'agent' : 'human' };\n default:\n return { actorId: id, actorType: actor.type };\n }\n}\n\nexport function currentStage(stages: readonly string[]): FactoryRuleStage | undefined {\n if (stages.length !== 1) return undefined;\n const stage = stages[0];\n return isFactoryRuleStage(stage) ? stage : undefined;\n}\n\ninterface TransitionConsentOptions {\n autonomy?: 'arm' | 'disarm';\n consentedBy?: string;\n /** A person moved a Work card out of Intake or Triage into Planning or Building: that move approves the work. */\n accepted?: boolean;\n}\n\n// Entering a resting lane disarms whoever rests it; only a person's move into a working lane arms.\nfunction transitionConsent(working: boolean, humanMove: boolean): 'arm' | 'disarm' | undefined {\n if (!working) return 'disarm';\n return humanMove ? 'arm' : undefined;\n}\n\n// An event arriving as data (GitHub, sweeps) never pre-approves the runs its transition queues.\nfunction bearsConsent(actor: FactoryRuleActor): boolean {\n return actor.type === 'human' || actor.type === 'agent';\n}\n\n// Rides the transition's own revision-checked commit, so a stale or rejected commit flips nothing.\nfunction consentEffect(\n request: FactoryTransitionRequest,\n working: boolean,\n humanMove: boolean,\n): TransitionConsentOptions {\n // A provider event (a reopen, a close) is not a person's say-so: whatever a person armed before\n // no longer stands once a route moves the card.\n if (request.eventRoute) return { autonomy: 'disarm' };\n const autonomy = transitionConsent(working, humanMove);\n return bearsConsent(request.actor) ? { autonomy, consentedBy: actorId(request.actor) } : { autonomy };\n}\n\ntype RunStartDecision = Extract<FactoryCommitDecision, { type: 'invokeSkill' | 'sendMessage' }>;\n\nfunction startsRun(decision: FactoryCommitDecision): decision is RunStartDecision {\n return decision.type === 'invokeSkill' || (decision.type === 'sendMessage' && decision.prepareBinding === true);\n}\n\n// Answering a recorded run start, or the role's own mid-run agent, with a run would start a second one.\n// A run that starts after its own agent's move is queued onto that agent's run instead.\nfunction runAlreadyUnderway(request: FactoryTransitionRequest, decision: RunStartDecision): boolean {\n if (request.cause === 'run_start') return true;\n if (decision.type === 'invokeSkill' && decision.startsAfterOwnMove === true) return false;\n return request.actor.type === 'agent' && request.actor.role === decision.role;\n}\n\nfunction stageTransitionMessage(fromStage: FactoryRuleStage, toStage: FactoryRuleStage): string {\n return `This work was moved from the ${fromStage} stage to the ${toStage} stage.`;\n}\n\nfunction isHumanTransition(request: FactoryTransitionRequest): boolean {\n return request.actor.type === 'human' && request.ingress.type === 'human';\n}\n\nfunction ruleFailure(error: unknown): { code: FactoryRuleRejectionCode; reason: string } {\n return {\n code: 'rule_error',\n reason: error instanceof Error ? `Factory rule failed: ${error.message}` : 'Factory rule failed.',\n };\n}\n\nasync function withRuleTimeout<T>(operation: Promise<T>, timeoutMs: number): Promise<T> {\n let timer: ReturnType<typeof setTimeout> | undefined;\n const timeout = new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(new Error('FACTORY_RULE_TIMEOUT')), timeoutMs);\n });\n try {\n return await Promise.race([operation, timeout]);\n } finally {\n if (timer) clearTimeout(timer);\n }\n}\n\nexport class FactoryTransitionService {\n readonly #configVersion: string;\n readonly #boards: ProjectBoardSource;\n readonly #storage: WorkItemsStorage;\n readonly #timeoutMs: number;\n readonly #onTerminalStage: FactoryTransitionServiceOptions['onTerminalStage'];\n readonly #terminalCleanupTimeoutMs: number;\n readonly #onAccepted: FactoryTransitionServiceOptions['onAccepted'];\n readonly #onTransitionCommitted: FactoryTransitionServiceOptions['onTransitionCommitted'];\n readonly #selfReviewEnabled: FactoryTransitionServiceOptions['selfReviewEnabled'];\n readonly #audit: AuditRecorder | undefined;\n\n constructor(options: FactoryTransitionServiceOptions) {\n this.#configVersion = options.configVersion;\n this.#boards = toBoardSource(options.boards);\n this.#storage = options.storage;\n this.#audit = options.audit;\n this.#timeoutMs = options.timeoutMs ?? RULE_TIMEOUT_MS;\n this.#onTerminalStage = options.onTerminalStage;\n this.#onAccepted = options.onAccepted;\n this.#onTransitionCommitted = options.onTransitionCommitted;\n this.#selfReviewEnabled = options.selfReviewEnabled;\n this.#terminalCleanupTimeoutMs = options.terminalCleanupTimeoutMs ?? TERMINAL_CLEANUP_TIMEOUT_MS;\n }\n\n get configVersion(): string {\n return this.#configVersion;\n }\n\n async transition(request: FactoryTransitionRequest): Promise<FactoryTransitionResult> {\n const replay = await this.#storage.getTransitionResultByIngress(\n request.orgId,\n request.factoryProjectId,\n request.ingress.identity,\n );\n if (replay) return replay as unknown as FactoryTransitionResult;\n\n const transitionId = request.ingress.transitionId ?? globalThis.crypto.randomUUID();\n const item = await this.#storage.get({ orgId: request.orgId, id: request.workItemId });\n if (!item) {\n const rejection = await this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n 'Work item not found.',\n );\n await this.#recordTransition(request, undefined, rejection);\n return rejection;\n }\n const result = await this.#evaluateAndCommit(request, transitionId, item);\n await this.#recordTransition(request, item, result);\n this.#notifyCommitted(request, item, result);\n return result;\n }\n\n #notifyCommitted(request: FactoryTransitionRequest, item: Card, result: FactoryTransitionResult): void {\n const onTransitionCommitted = this.#onTransitionCommitted;\n if (!onTransitionCommitted || result.status !== 'accepted') return;\n // Board-neutral: `currentStage` only knows the built-in rule stages.\n const fromStage = item.stages.length === 1 ? item.stages[0] : undefined;\n if (result.stage === fromStage) return;\n // Inside the chain so a synchronous throw is isolated the same way an async rejection is.\n void Promise.resolve()\n .then(() =>\n onTransitionCommitted({\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n workItemId: item.id,\n fromStage,\n toStage: result.stage,\n }),\n )\n .catch(error => {\n console.warn(`[factory] stage notification failed for work item ${item.id}:`, error);\n });\n }\n\n /** A rejection can outlive its work item: the row still names the id the caller asked for. */\n async #recordTransition(\n request: FactoryTransitionRequest,\n item: Card | undefined,\n result: FactoryTransitionResult,\n ): Promise<void> {\n if (!this.#audit) return;\n const from = item ? currentStage(item.stages) : undefined;\n if (result.status === 'accepted' && result.stage === from && !request.reenter) return;\n const outcome =\n result.status === 'accepted'\n ? { action: 'factory.work_item.stage_moved' as const, to: result.stage, revision: result.revision }\n : {\n action: 'factory.work_item.transition_rejected' as const,\n to: request.stage,\n code: result.code,\n reason: result.reason,\n };\n const { action, ...detail } = outcome;\n await this.#audit\n .record({\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n ...auditActorOf(request.actor),\n actorProfile: request.actorProfile,\n ...(request.context ? { context: request.context } : {}),\n action,\n idempotencyKey: result.transitionId,\n targets: [{ type: 'work_item', id: item?.id ?? request.workItemId, ...(item ? { name: item.title } : {}) }],\n metadata: {\n transitionId: result.transitionId,\n ingressType: request.ingress.type,\n cause: request.cause,\n configVersion: this.#configVersion,\n ...(from ? { from } : {}),\n ...(request.reenter ? { reenter: true } : {}),\n ...detail,\n },\n })\n .catch(error => {\n console.warn(`[factory] audit failed for transition ${result.transitionId}:`, error);\n });\n }\n\n async #evaluateAndCommit(\n request: FactoryTransitionRequest,\n transitionId: string,\n item: Card,\n ): Promise<FactoryTransitionResult> {\n const boards = await this.#boards.load(request);\n if (request.causalChain && request.causalChain.length > MAX_FACTORY_RULE_CAUSAL_DEPTH) {\n return this.#commitRejection(\n request,\n transitionId,\n 'causal_depth_exceeded',\n 'Factory rule causal depth exceeded.',\n );\n }\n const itemSource = workItemSource(item.externalSource);\n const source = factoryRuleSourceForWorkItem(itemSource);\n const isPullRequest = source === 'pullRequest' || source === 'gitlabPullRequest';\n const legacyBoard = isPullRequest ? 'review' : 'work';\n if (item.board === null && !boards.has(legacyBoard)) {\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n 'This legacy work item has no assigned board. Assign an installed board and phase through the work-item PATCH endpoint before transitioning it.',\n );\n }\n const itemBoard = item.board ?? legacyBoard;\n if (request.board !== itemBoard) {\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n `The work item belongs to board \"${itemBoard}\", not \"${request.board}\".`,\n );\n }\n // Review holds only pull requests; Work holds both, and keeps a pull request's card to review.\n if (itemBoard === 'review' && !isPullRequest) {\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n 'The work item does not belong to the requested board.',\n );\n }\n const board = boards.get(request.board);\n if (!board) {\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n `Board \"${request.board}\" is not installed.`,\n );\n }\n const fromStage = item.stages.length === 1 ? item.stages[0] : undefined;\n if (!fromStage || !Object.prototype.hasOwnProperty.call(board.phases, fromStage)) {\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n 'The work item does not have one canonical phase on the requested board.',\n );\n }\n if (\n !Object.prototype.hasOwnProperty.call(board.phases, request.stage) ||\n (!request.eventRoute && !board.allowsTransition(fromStage, request.stage))\n ) {\n const nextStages = [...new Set((board.transitions[fromStage] ?? []).map(transition => transition.to))];\n const nextStagesReason =\n nextStages.length > 0\n ? `Next stages declared from ${fromStage}: ${nextStages.join(', ')}.`\n : `No next stage is declared from ${fromStage}.`;\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n `The ${board.name} board does not allow moving from ${fromStage} to ${request.stage}. ${nextStagesReason}`,\n );\n }\n const pullRequestCardRejection =\n request.board === 'work' ? workPullRequestCardRejection(isPullRequest, request.stage) : undefined;\n if (pullRequestCardRejection) {\n return this.#commitRejection(request, transitionId, 'invalid_transition', pullRequestCardRejection);\n }\n\n if (\n request.eventRoute &&\n !request.eventRoute.allowWorkingPhase &&\n fromStage !== request.stage &&\n board.isWorking(request.stage)\n ) {\n return this.#commitRejection(\n request,\n transitionId,\n 'approval_required',\n `Intake route ${request.eventRoute.routeId} moves cards into ${board.phases[request.stage]?.name ?? request.stage}, a working phase, only when the route allows working phases.`,\n );\n }\n\n // The coordinator's own self-move at run start would otherwise inject a second run's kickoff.\n const humanMove = request.actor.type === 'human' && fromStage !== request.stage && request.cause !== 'run_start';\n // The board, not the phase name, says whether a seat is engaged on either side of this move.\n const entersWorking = board.isWorking(request.stage);\n const seatRole = board.roleForPhase(request.stage);\n\n const contextBase = {\n tenant: { orgId: request.orgId, projectId: request.factoryProjectId },\n actor: request.actor,\n ingress: { type: request.ingress.type, id: request.ingress.identity },\n cause: request.cause,\n causalChain: request.causalChain ?? [],\n configVersion: this.#configVersion,\n item: {\n id: item.id,\n source: itemSource,\n sourceKey: item.externalSource\n ? `${item.externalSource.integrationId}:${item.externalSource.type}:${item.externalSource.externalId}`\n : null,\n parentWorkItemId: item.parentWorkItemId,\n title: item.title,\n url: item.externalSource?.url ?? null,\n stages: [...item.stages],\n workItem: item.workItem,\n acceptedAt: item.acceptedAt,\n metadata: item.metadata,\n },\n board: request.board,\n itemRevision: item.revision,\n source,\n fromStage,\n toStage: request.stage,\n } satisfies Omit<FactoryStageRuleContext, 'stage'>;\n\n let evaluation:\n | { outcome: 'accepted'; decisions: Record<string, unknown>[]; intents: TransitionConsentOptions }\n | { outcome: 'rejected'; code: string; reason: string };\n try {\n evaluation = await withRuleTimeout(\n (async () => {\n // Plans are approved without a person only where the card's phase auto-approves submit_plan.\n const plansAutoApproved = autoApprovedExitTool(boards, item) === 'submit_plan';\n // When the board's own rule for a phase's exit tool moves the card on success, that\n // result is the handoff to the next working phase (for submit_plan, only an approved\n // plan). Anyone but a person needs it, unless the tool is auto-approved for this card.\n const fromPhase = board.phases[fromStage];\n const exitTool = fromPhase?.kind === 'working' ? fromPhase.exitTool : undefined;\n if (\n request.actor.type !== 'human' &&\n !request.eventRoute &&\n exitTool &&\n board.tools[exitTool.id] &&\n fromStage !== request.stage &&\n entersWorking &&\n !(exitTool.id === 'submit_plan' ? request.planApproved === true : request.completedTool === exitTool.id)\n ) {\n if (autoApprovedExitTool(boards, item) !== exitTool.id) {\n return {\n outcome: 'rejected' as const,\n code: 'approval_required',\n reason:\n exitTool.id === 'submit_plan'\n ? `A person has to approve this plan. Ask them to say so in a chat they are signed in to (Slack, terminal, web); that turn can move the card into ${board.phases[request.stage]?.name ?? request.stage} with factory_transition_work_item.`\n : `${fromPhase!.name} ends when ${exitTool.id} succeeds, and that moves the card. A person can also move it from the Factory board or a chat they are signed in to.`,\n };\n }\n }\n const policy = boardTransitionPolicyResultSchema.parse(\n await board.transitionPolicy?.(\n immutablePolicySnapshot({\n ...contextBase,\n item: { ...contextBase.item, triageType: item.triageType },\n initialEntry: request.initialEntry ?? false,\n reenter: request.reenter ?? false,\n isHumanTransition: isHumanTransition(request),\n plansAutoApproved,\n planApproved: request.planApproved === true,\n requestedTriageType: undefined,\n }),\n ),\n );\n if (policy?.type === 'reject') {\n return { outcome: 'rejected' as const, code: policy.code, reason: policy.reason };\n }\n const selfReviewEnabled =\n request.board === 'work' && this.#selfReviewEnabled\n ? await this.#selfReviewEnabled({ orgId: request.orgId, factoryProjectId: request.factoryProjectId })\n : false;\n const decisions: FactoryCommitDecision[] = [];\n for (const rule of resolveFactoryStageRules(boards, {\n board: request.board,\n source,\n fromStage,\n toStage: request.stage,\n initialEntry: request.initialEntry,\n reenter: request.reenter,\n })) {\n const context: FactoryStageRuleContext = Object.freeze({\n ...contextBase,\n selfReviewEnabled,\n stage: rule.phase === 'exit' ? fromStage : request.stage,\n });\n const raw = await rule.handler(context);\n if (raw === undefined) continue;\n const decision = validateFactoryRuleDecision(raw, context.causalChain.length);\n if (decision.type === 'reject') {\n return { outcome: 'rejected' as const, code: decision.code, reason: decision.reason };\n }\n assertFactoryDecisionTarget(decision, boards, itemBoard);\n if (startsRun(decision) && runAlreadyUnderway(request, decision)) continue;\n decisions.push(decision);\n }\n const validated = validateFactoryRuleDecisions(decisions);\n if (humanMove) {\n const message = stageTransitionMessage(fromStage, request.stage);\n const skill = validated.find(decision => decision.type === 'invokeSkill');\n if (skill) {\n skill.precedingMessage = message;\n } else {\n validated.unshift({\n type: 'sendMessage',\n idempotencyKey: `factory-stage:${transitionId}`,\n message,\n priority: 'urgent',\n idleBehavior: 'wake',\n // Parking a card says stop: no seat is right by construction, so\n // the notice goes to whichever session is live — or nobody.\n ...(entersWorking && seatRole !== undefined ? { role: seatRole, prepareBinding: true } : {}),\n });\n }\n }\n return {\n outcome: 'accepted' as const,\n intents: {\n accepted:\n request.board === 'work' &&\n isHumanTransition(request) &&\n (fromStage === 'intake' || fromStage === 'triage') &&\n (request.stage === 'planning' || request.stage === 'execute'),\n },\n decisions: validateFactoryRuleDecisions(validated) as unknown as Record<string, unknown>[],\n };\n })(),\n this.#timeoutMs,\n );\n } catch (error) {\n const failed =\n error instanceof Error && error.message === 'FACTORY_RULE_TIMEOUT'\n ? { code: 'timeout' as const, reason: 'Factory rule evaluation timed out.' }\n : ruleFailure(error);\n evaluation = { outcome: 'rejected', ...failed };\n }\n return this.#commit(\n request,\n transitionId,\n evaluation,\n evaluation.outcome === 'accepted'\n ? { ...consentEffect(request, entersWorking, humanMove), ...evaluation.intents }\n : {},\n boards,\n );\n }\n\n async #commitRejection(\n request: FactoryTransitionRequest,\n transitionId: string,\n code: FactoryRuleRejectionCode,\n reason: string,\n ): Promise<FactoryTransitionResult> {\n return this.#commit(\n request,\n transitionId,\n { outcome: 'rejected', code, reason: reason.slice(0, MAX_REJECTION_REASON) },\n {},\n undefined,\n );\n }\n\n async #commit(\n request: FactoryTransitionRequest,\n transitionId: string,\n evaluation:\n | { outcome: 'accepted'; decisions: Record<string, unknown>[] }\n | { outcome: 'rejected'; code: string; reason: string },\n options: TransitionConsentOptions,\n // The registry the move was evaluated against; rejected moves never release resources.\n boards: BoardRegistry | undefined,\n ): Promise<FactoryTransitionResult> {\n const committed = await this.#storage.commitTransition({\n autonomy: options.autonomy,\n consentedBy: options.consentedBy,\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n workItemId: request.workItemId,\n expectedRevision: request.expectedRevision,\n destinationStage: request.stage,\n actorId: actorId(request.actor),\n ingress: { identity: request.ingress.identity, triggerType: request.ingress.type, transitionId },\n configVersion: this.#configVersion,\n causalChain: [...(request.causalChain ?? [])],\n evaluation,\n });\n if (committed.status === 'missing') {\n return rejection(transitionId, request.workItemId, 'invalid_transition', 'Work item not found.');\n }\n const result = committed.result as unknown as FactoryTransitionResult;\n if (\n this.#onAccepted &&\n options.accepted &&\n committed.status === 'committed' &&\n result.status === 'accepted' &&\n committed.item\n ) {\n const item = committed.item;\n const onAccepted = this.#onAccepted;\n // Invoke inside the chain so a synchronous throw is isolated the same way an async rejection is.\n void Promise.resolve()\n .then(() =>\n onAccepted({\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n workItemId: request.workItemId,\n item,\n }),\n )\n .catch(error => {\n console.warn(`[factory] acceptance hook failed for work item ${request.workItemId}:`, error);\n });\n }\n // Only an installed board's declaration releases resources; an unknown board or phase never does.\n if (\n this.#onTerminalStage &&\n result.status === 'accepted' &&\n boards?.get(request.board)?.isTerminal(result.stage) === true\n ) {\n let timer: ReturnType<typeof setTimeout> | undefined;\n try {\n const cleanup = Promise.resolve(\n this.#onTerminalStage({\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n workItemId: request.workItemId,\n stage: result.stage,\n revision: result.revision,\n actor: request.actor,\n }),\n );\n // A late rejection after the timeout wins the race must not surface\n // as an unhandled rejection.\n cleanup.catch(() => {});\n await Promise.race([\n cleanup,\n new Promise<void>(resolve => {\n timer = setTimeout(resolve, this.#terminalCleanupTimeoutMs);\n }),\n ]);\n } catch {\n // Resource release is best-effort — never fail a committed transition.\n } finally {\n clearTimeout(timer);\n }\n }\n return result;\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"transition-service.js","names":[],"sources":["../../src/rules/transition-service.ts"],"sourcesContent":["import { DEFAULT_BOARD_ID, REVIEW_CONTEXT } from '../boards/index.js';\nimport type { BoardRegistry, InstalledBoard } from '../boards/index.js';\nimport { autoApprovedExitTool, exitToolSucceeded } from '../boards/phase-automation.js';\nimport { phaseRunDecision } from '../boards/phase-runner.js';\nimport { toBoardSource } from '../boards/project-boards.js';\nimport type { ProjectBoardSource } from '../boards/project-boards.js';\nimport { boardFlow, boardForWorkItem, hasPullRequest, pullRequestCardRejection } from '../boards/semantics.js';\nimport { boardTransitionPolicyResultSchema, immutablePolicySnapshot } from '../boards/transition-policy.js';\nimport type { AuditActorProfileInput, AuditActorType, AuditContext } from '../storage/domains/audit/base.js';\nimport type { AuditRecorder } from '../storage/domains/audit/domain.js';\nimport { isAgentActor } from '../storage/domains/work-items/base.js';\nimport type { Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport type {\n FactoryCommitDecision,\n FactoryRuleActor,\n FactoryRuleBoard,\n FactoryRuleCausalEntry,\n FactoryRuleRejectionCode,\n FactoryRuleStage,\n FactoryStageRuleContext,\n FactoryTransitionResult,\n FactoryTransitionResultRejected,\n} from './types.js';\nimport { factoryRuleSourceForWorkItem, workItemSource } from './types.js';\nimport {\n MAX_FACTORY_RULE_CAUSAL_DEPTH,\n assertFactoryDecisionTarget,\n validateFactoryRuleDecision,\n validateFactoryRuleDecisions,\n} from './validation.js';\n\nconst RULE_TIMEOUT_MS = 5_000;\nconst MAX_REJECTION_REASON = 512;\n/** Longest a committed transition waits for terminal resource cleanup. Cleanup\n * reattaches remote sandboxes, so a hung provider call must not leave the\n * already-committed transition request pending; past this bound the cleanup\n * keeps running in the background as pure best-effort. */\nconst TERMINAL_CLEANUP_TIMEOUT_MS = 30_000;\n\nexport interface FactoryTransitionRequest {\n orgId: string;\n factoryProjectId: string;\n workItemId: string;\n /** Installed board id; the service rejects boards that are not installed. */\n board: string;\n stage: FactoryRuleStage;\n expectedRevision: number;\n actor: FactoryRuleActor;\n actorProfile?: AuditActorProfileInput;\n /** Where a browser request came from; rules and agents carry none. */\n context?: AuditContext;\n ingress: { type: 'human' | 'agent' | 'toolResult' | 'github' | 'rule'; identity: string; transitionId?: string };\n cause: string;\n causalChain?: readonly FactoryRuleCausalEntry[];\n /** Internal materialization path: start the destination phase's runner even when already at that stage. */\n initialEntry?: boolean;\n /** Starts the stage's runner again when the item already holds that stage, to restart work the entry invalidated. */\n reenter?: boolean;\n /** Internal proof that this move consumes an approved `submit_plan` result. */\n planApproved?: true;\n /** Internal: the tool whose successful result this move consumes (a tool-result rule's move). */\n completedTool?: string;\n /**\n * Internal: an intake route moves the card on a status event. A route is admin-authored, so it\n * may name any phase on the card's board regardless of the board's next phases, working ones\n * included. The phase's `autoStart` and the dispatcher's approval check decide whether its run starts.\n */\n eventRoute?: { routeId: string };\n}\n\nexport interface FactoryTransitionServiceOptions {\n configVersion: string;\n storage: WorkItemsStorage;\n /** A fixed registry, or the per-project boards; each transition loads its project's boards. */\n boards?: BoardRegistry | ProjectBoardSource;\n /** Every commit, accepted or rejected, lands here as `stage_moved` / `transition_rejected` under the request's actor. */\n audit?: AuditRecorder;\n timeoutMs?: number;\n /**\n * Called after a transition commits into a phase the board declares\n * terminal — the point where the item's sessions stop receiving runs, so\n * resources they hold (e.g. sandboxes) can be released for reuse. Awaited,\n * but failures are swallowed: releasing resources must never break or roll\n * back the committed transition.\n */\n onTerminalStage?: (args: {\n orgId: string;\n factoryProjectId: string;\n workItemId: string;\n stage: FactoryRuleStage;\n revision: number;\n /** The actor that committed this terminal transition. Lets cleanup leave\n * the seat that drove its own transition (an agent tool call) untouched. */\n actor: FactoryRuleActor;\n }) => Promise<void> | void;\n /**\n * Called after a transition commits a stage change, e.g. to tell the item's\n * followers. Not awaited, and failures are logged: a notification must never\n * fail or delay the committed transition.\n */\n onTransitionCommitted?: (args: {\n orgId: string;\n factoryProjectId: string;\n workItemId: string;\n fromStage: string | undefined;\n toStage: string;\n }) => Promise<void> | void;\n /** Upper bound on how long a committed transition waits for\n * `onTerminalStage` before returning (default 30s). The cleanup continues\n * in the background past the bound. */\n terminalCleanupTimeoutMs?: number;\n /**\n * Called after a person moves a Work card from Intake or Triage into Planning or\n * Building, which approves the work. Fire-and-forget: failures are swallowed, the committed transition never\n * depends on it.\n */\n onAccepted?: (args: {\n orgId: string;\n factoryProjectId: string;\n workItemId: string;\n item: Card;\n }) => Promise<void> | void;\n}\n\nfunction rejection(\n transitionId: string,\n itemId: string,\n code: FactoryRuleRejectionCode,\n reason: string,\n): FactoryTransitionResult {\n return { status: 'rejected', transitionId, itemId, code, reason: reason.slice(0, MAX_REJECTION_REASON) };\n}\n\nfunction actorId(actor: FactoryRuleActor): string {\n switch (actor.type) {\n case 'human':\n case 'system':\n return actor.id;\n case 'agent':\n return `agent:${actor.bindingId}`;\n case 'github':\n return `github:${actor.login}`;\n case 'gitlab':\n return `gitlab:${actor.username}`;\n }\n}\n\n// The dispatcher executes an agent-approved decision as a human actor so its consent carries; the trail still names the agent.\nexport function auditActorOf(actor: FactoryRuleActor): { actorId: string; actorType: AuditActorType } {\n const id = actorId(actor);\n switch (actor.type) {\n case 'github':\n case 'gitlab':\n return { actorId: id, actorType: 'human' };\n case 'human':\n return { actorId: id, actorType: isAgentActor(id) ? 'agent' : 'human' };\n default:\n return { actorId: id, actorType: actor.type };\n }\n}\n\nfunction isStale(result: FactoryTransitionResult): result is FactoryTransitionResultRejected {\n return result.status === 'rejected' && result.code === 'stale';\n}\n\n/** Tell the caller where the card is now, so a model doesn't read \"stale\" as \"already moved\". */\nfunction staleRejection(result: FactoryTransitionResultRejected, current: Card): FactoryTransitionResult {\n const stage = currentStage(current.stages) ?? current.stages.join(', ');\n return rejection(\n result.transitionId,\n result.itemId,\n 'stale',\n `The card changed (now revision ${current.revision}, in ${stage}). Retry with expectedRevision ${current.revision} if the move still applies.`,\n );\n}\n\nexport function currentStage(stages: readonly string[]): FactoryRuleStage | undefined {\n return stages.length === 1 ? stages[0] : undefined;\n}\n\ninterface TransitionConsentOptions {\n autonomy?: 'arm' | 'disarm';\n consentedBy?: string;\n /** A person moved a card into its board's build seat from before it (see {@link acceptsWork}): that move approves the work. */\n accepted?: boolean;\n}\n\n/**\n * Whether moving a card from `from` to `to` hands it to the board's builder for the first time: `to`\n * runs in the seat of the board's build phase ({@link boardFlow}), and `from` is a resting phase or a\n * working phase of another seat that is no review (Work: Intake or Triage into Planning or Building).\n */\nfunction acceptsWork(board: InstalledBoard, from: string, to: string): boolean {\n const buildRole = boardFlow(board).buildRole;\n if (!buildRole || board.roleForPhase(to) !== buildRole) return false;\n const fromPhase = board.phases[from];\n if (!fromPhase || fromPhase.kind === 'terminal') return false;\n if (fromPhase.kind === 'resting') return true;\n const fromRole = fromPhase.runner.context;\n return fromRole !== buildRole && fromRole !== REVIEW_CONTEXT;\n}\n\n// Entering a resting lane disarms whoever rests it; only a person's move into a working lane arms.\nfunction transitionConsent(working: boolean, humanMove: boolean): 'arm' | 'disarm' | undefined {\n if (!working) return 'disarm';\n return humanMove ? 'arm' : undefined;\n}\n\n// An event arriving as data (GitHub, sweeps) never pre-approves the runs its transition queues.\nfunction bearsConsent(actor: FactoryRuleActor): boolean {\n return actor.type === 'human' || actor.type === 'agent';\n}\n\n// Rides the transition's own revision-checked commit, so a stale or rejected commit flips nothing.\nfunction consentEffect(\n request: FactoryTransitionRequest,\n working: boolean,\n humanMove: boolean,\n): TransitionConsentOptions {\n // A provider event (a reopen, a close) is not a person's say-so: whatever a person armed before\n // no longer stands once a route moves the card.\n if (request.eventRoute) return { autonomy: 'disarm' };\n const autonomy = transitionConsent(working, humanMove);\n return bearsConsent(request.actor) ? { autonomy, consentedBy: actorId(request.actor) } : { autonomy };\n}\n\ntype RunStartDecision = Extract<FactoryCommitDecision, { type: 'invokeSkill' | 'sendMessage' }>;\n\nfunction startsRun(decision: FactoryCommitDecision): decision is RunStartDecision {\n return decision.type === 'invokeSkill' || (decision.type === 'sendMessage' && decision.prepareBinding === true);\n}\n\n// Answering a recorded run start, or the role's own mid-run agent, with a run would start a second one.\n// A run that starts after its own agent's move is queued onto that agent's run instead.\nfunction runAlreadyUnderway(request: FactoryTransitionRequest, decision: RunStartDecision): boolean {\n if (request.cause === 'run_start') return true;\n if (decision.type === 'invokeSkill' && decision.startsAfterOwnMove === true) return false;\n return request.actor.type === 'agent' && request.actor.role === decision.role;\n}\n\nfunction stageTransitionMessage(fromStage: FactoryRuleStage, toStage: FactoryRuleStage): string {\n return `This work was moved from the ${fromStage} stage to the ${toStage} stage.`;\n}\n\nfunction isHumanTransition(request: FactoryTransitionRequest): boolean {\n return request.actor.type === 'human' && request.ingress.type === 'human';\n}\n\nfunction ruleFailure(error: unknown): { code: FactoryRuleRejectionCode; reason: string } {\n return {\n code: 'rule_error',\n reason: error instanceof Error ? `Factory rule failed: ${error.message}` : 'Factory rule failed.',\n };\n}\n\nasync function withRuleTimeout<T>(operation: Promise<T>, timeoutMs: number): Promise<T> {\n let timer: ReturnType<typeof setTimeout> | undefined;\n const timeout = new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(new Error('FACTORY_RULE_TIMEOUT')), timeoutMs);\n });\n try {\n return await Promise.race([operation, timeout]);\n } finally {\n if (timer) clearTimeout(timer);\n }\n}\n\nexport class FactoryTransitionService {\n readonly #configVersion: string;\n readonly #boards: ProjectBoardSource;\n readonly #storage: WorkItemsStorage;\n readonly #timeoutMs: number;\n readonly #onTerminalStage: FactoryTransitionServiceOptions['onTerminalStage'];\n readonly #terminalCleanupTimeoutMs: number;\n readonly #onAccepted: FactoryTransitionServiceOptions['onAccepted'];\n readonly #onTransitionCommitted: FactoryTransitionServiceOptions['onTransitionCommitted'];\n readonly #audit: AuditRecorder | undefined;\n\n constructor(options: FactoryTransitionServiceOptions) {\n this.#configVersion = options.configVersion;\n this.#boards = toBoardSource(options.boards);\n this.#storage = options.storage;\n this.#audit = options.audit;\n this.#timeoutMs = options.timeoutMs ?? RULE_TIMEOUT_MS;\n this.#onTerminalStage = options.onTerminalStage;\n this.#onAccepted = options.onAccepted;\n this.#onTransitionCommitted = options.onTransitionCommitted;\n this.#terminalCleanupTimeoutMs = options.terminalCleanupTimeoutMs ?? TERMINAL_CLEANUP_TIMEOUT_MS;\n }\n\n get configVersion(): string {\n return this.#configVersion;\n }\n\n async transition(request: FactoryTransitionRequest): Promise<FactoryTransitionResult> {\n const replay = await this.#storage.getTransitionResultByIngress(\n request.orgId,\n request.factoryProjectId,\n request.ingress.identity,\n );\n if (replay) return replay as unknown as FactoryTransitionResult;\n\n const transitionId = request.ingress.transitionId ?? globalThis.crypto.randomUUID();\n const item = await this.#storage.get({ orgId: request.orgId, id: request.workItemId });\n if (!item) {\n const rejection = await this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n 'Work item not found.',\n );\n await this.#recordTransition(request, undefined, rejection);\n return rejection;\n }\n let result = await this.#evaluateAndCommit(request, transitionId, item);\n if (isStale(result)) {\n const current = await this.#storage.get({ orgId: request.orgId, id: request.workItemId });\n if (current) result = staleRejection(result, current);\n }\n await this.#recordTransition(request, item, result);\n this.#notifyCommitted(request, item, result);\n return result;\n }\n\n #notifyCommitted(request: FactoryTransitionRequest, item: Card, result: FactoryTransitionResult): void {\n const onTransitionCommitted = this.#onTransitionCommitted;\n if (!onTransitionCommitted || result.status !== 'accepted') return;\n // Board-neutral: `currentStage` only knows the built-in rule stages.\n const fromStage = item.stages.length === 1 ? item.stages[0] : undefined;\n if (result.stage === fromStage) return;\n // Inside the chain so a synchronous throw is isolated the same way an async rejection is.\n void Promise.resolve()\n .then(() =>\n onTransitionCommitted({\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n workItemId: item.id,\n fromStage,\n toStage: result.stage,\n }),\n )\n .catch(error => {\n console.warn(`[factory] stage notification failed for work item ${item.id}:`, error);\n });\n }\n\n /** A rejection can outlive its work item: the row still names the id the caller asked for. */\n async #recordTransition(\n request: FactoryTransitionRequest,\n item: Card | undefined,\n result: FactoryTransitionResult,\n ): Promise<void> {\n if (!this.#audit) return;\n // Board-neutral, like the stage notification: `currentStage` only knows the\n // built-in rule stages and would drop custom-board phases.\n const from = item && item.stages.length === 1 ? item.stages[0] : undefined;\n if (result.status === 'accepted' && result.stage === from && !request.reenter) return;\n const outcome =\n result.status === 'accepted'\n ? { action: 'factory.work_item.stage_moved' as const, to: result.stage, revision: result.revision }\n : {\n action: 'factory.work_item.transition_rejected' as const,\n to: request.stage,\n code: result.code,\n reason: result.reason,\n };\n const { action, ...detail } = outcome;\n await this.#audit\n .record({\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n ...auditActorOf(request.actor),\n actorProfile: request.actorProfile,\n ...(request.context ? { context: request.context } : {}),\n action,\n idempotencyKey: result.transitionId,\n targets: [{ type: 'work_item', id: item?.id ?? request.workItemId, ...(item ? { name: item.title } : {}) }],\n metadata: {\n transitionId: result.transitionId,\n ingressType: request.ingress.type,\n cause: request.cause,\n configVersion: this.#configVersion,\n ...(from ? { from } : {}),\n ...(request.reenter ? { reenter: true } : {}),\n ...detail,\n },\n })\n .catch(error => {\n console.warn(`[factory] audit failed for transition ${result.transitionId}:`, error);\n });\n }\n\n async #evaluateAndCommit(\n request: FactoryTransitionRequest,\n transitionId: string,\n item: Card,\n ): Promise<FactoryTransitionResult> {\n const boards = await this.#boards.load(request);\n if (request.causalChain && request.causalChain.length > MAX_FACTORY_RULE_CAUSAL_DEPTH) {\n return this.#commitRejection(\n request,\n transitionId,\n 'causal_depth_exceeded',\n 'Factory rule causal depth exceeded.',\n );\n }\n const itemSource = workItemSource(item.externalSource);\n const source = factoryRuleSourceForWorkItem(itemSource);\n const isPullRequest = source === 'pullRequest' || source === 'gitlabPullRequest';\n // Rows filed before boards were persisted belong to the default board.\n if (item.board === null && !boards.has(DEFAULT_BOARD_ID)) {\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n 'This legacy work item has no assigned board. Assign an installed board and phase through the work-item PATCH endpoint before transitioning it.',\n );\n }\n const itemBoard = boardForWorkItem(item);\n if (request.board !== itemBoard) {\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n `The work item belongs to board \"${itemBoard}\", not \"${request.board}\".`,\n );\n }\n const board = boards.get(request.board);\n if (!board) {\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n `Board \"${request.board}\" is not installed.`,\n );\n }\n const fromStage = item.stages.length === 1 ? item.stages[0] : undefined;\n if (!fromStage || !Object.prototype.hasOwnProperty.call(board.phases, fromStage)) {\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n 'The work item does not have one canonical phase on the requested board.',\n );\n }\n // The board's own reason comes first: its phase graph alone only says the move is not\n // declared, which leaves an agent moving an issue card to PR review guessing why.\n const cardShapeRejection = pullRequestCardRejection(\n board,\n {\n standalonePullRequest: isPullRequest,\n hasPullRequest: hasPullRequest({ workItem: item.workItem, source: itemSource }),\n },\n request.stage,\n );\n if (cardShapeRejection) {\n return this.#commitRejection(request, transitionId, 'invalid_transition', cardShapeRejection);\n }\n if (\n !Object.prototype.hasOwnProperty.call(board.phases, request.stage) ||\n (!request.eventRoute && !board.allowsTransition(fromStage, request.stage))\n ) {\n const nextStages = [...new Set((board.transitions[fromStage] ?? []).map(transition => transition.to))];\n const nextStagesReason =\n nextStages.length > 0\n ? `Next stages declared from ${fromStage}: ${nextStages.join(', ')}.`\n : `No next stage is declared from ${fromStage}.`;\n return this.#commitRejection(\n request,\n transitionId,\n 'invalid_transition',\n `The ${board.name} board does not allow moving from ${fromStage} to ${request.stage}. ${nextStagesReason}`,\n );\n }\n\n // The coordinator's own self-move at run start would otherwise inject a second run's kickoff.\n const humanMove = request.actor.type === 'human' && fromStage !== request.stage && request.cause !== 'run_start';\n // The board, not the phase name, says whether a seat is engaged on either side of this move.\n const entersWorking = board.isWorking(request.stage);\n const seatRole = board.roleForPhase(request.stage);\n\n const contextBase = {\n tenant: { orgId: request.orgId, projectId: request.factoryProjectId },\n actor: request.actor,\n ingress: { type: request.ingress.type, id: request.ingress.identity },\n cause: request.cause,\n causalChain: request.causalChain ?? [],\n configVersion: this.#configVersion,\n item: {\n id: item.id,\n source: itemSource,\n sourceKey: item.externalSource\n ? `${item.externalSource.integrationId}:${item.externalSource.type}:${item.externalSource.externalId}`\n : null,\n parentWorkItemId: item.parentWorkItemId,\n title: item.title,\n url: item.externalSource?.url ?? null,\n stages: [...item.stages],\n workItem: item.workItem,\n acceptedAt: item.acceptedAt,\n metadata: item.metadata,\n },\n board: request.board,\n itemRevision: item.revision,\n source,\n fromStage,\n toStage: request.stage,\n } satisfies Omit<FactoryStageRuleContext, 'stage'>;\n\n let evaluation:\n | { outcome: 'accepted'; decisions: Record<string, unknown>[]; intents: TransitionConsentOptions }\n | { outcome: 'rejected'; code: string; reason: string };\n try {\n evaluation = await withRuleTimeout(\n (async () => {\n // Plans are approved without a person only where the card's phase auto-approves submit_plan.\n const plansAutoApproved = autoApprovedExitTool(boards, item) === 'submit_plan';\n // A phase with an exit tool holds the card until the tool succeeds (for submit_plan, with\n // an approved plan; autoApprove only decides whether it approves itself). Then the agent,\n // or the board's own rule for the tool, moves the card. A person can move it any time.\n const fromPhase = board.phases[fromStage];\n const exitTool = fromPhase?.kind === 'working' ? fromPhase.exitTool : undefined;\n if (\n request.actor.type !== 'human' &&\n !request.eventRoute &&\n exitTool &&\n fromStage !== request.stage &&\n entersWorking &&\n !(exitTool.id === 'submit_plan' ? request.planApproved === true : request.completedTool === exitTool.id) &&\n !exitToolSucceeded(item, fromStage, exitTool.id)\n ) {\n return {\n outcome: 'rejected' as const,\n code: 'approval_required',\n reason:\n exitTool.id === 'submit_plan'\n ? `${fromPhase!.name} ends when submit_plan comes back with an approved plan; until then the card stays here. Call submit_plan and wait for a person to approve the plan (or for it to be approved automatically), then move the card into ${board.phases[request.stage]?.name ?? request.stage} with factory_transition_work_item.`\n : `${fromPhase!.name} ends when ${exitTool.id} succeeds; until then the card stays here. A person can also move it from the Factory board or a chat they are signed in to.`,\n };\n }\n const policy = boardTransitionPolicyResultSchema.parse(\n await board.transitionPolicy?.(\n immutablePolicySnapshot({\n ...contextBase,\n item: { ...contextBase.item, triageType: item.triageType },\n initialEntry: request.initialEntry ?? false,\n reenter: request.reenter ?? false,\n isHumanTransition: isHumanTransition(request),\n plansAutoApproved,\n planApproved: request.planApproved === true,\n requestedTriageType: undefined,\n }),\n ),\n );\n if (policy?.type === 'reject') {\n return { outcome: 'rejected' as const, code: policy.code, reason: policy.reason };\n }\n const run = phaseRunDecision(board, request.stage, contextBase, {\n initialEntry: request.initialEntry,\n reenter: request.reenter,\n });\n const validated = validateFactoryRuleDecisions(run ? [run] : [], contextBase.causalChain.length).filter(\n decision => {\n assertFactoryDecisionTarget(decision, boards, itemBoard);\n return !(startsRun(decision) && runAlreadyUnderway(request, decision));\n },\n );\n if (humanMove) {\n const message = stageTransitionMessage(fromStage, request.stage);\n const skill = validated.find(decision => decision.type === 'invokeSkill');\n if (skill) {\n skill.precedingMessage = message;\n } else {\n validated.unshift({\n type: 'sendMessage',\n idempotencyKey: `factory-stage:${transitionId}`,\n message,\n priority: 'urgent',\n idleBehavior: 'wake',\n // Parking a card says stop: no seat is right by construction, so\n // the notice goes to whichever session is live — or nobody.\n ...(entersWorking && seatRole !== undefined ? { role: seatRole, prepareBinding: true } : {}),\n });\n }\n }\n return {\n outcome: 'accepted' as const,\n intents: {\n accepted: isHumanTransition(request) && acceptsWork(board, fromStage, request.stage),\n },\n decisions: validateFactoryRuleDecisions(validated) as unknown as Record<string, unknown>[],\n };\n })(),\n this.#timeoutMs,\n );\n } catch (error) {\n const failed =\n error instanceof Error && error.message === 'FACTORY_RULE_TIMEOUT'\n ? { code: 'timeout' as const, reason: 'Factory rule evaluation timed out.' }\n : ruleFailure(error);\n evaluation = { outcome: 'rejected', ...failed };\n }\n return this.#commit(\n request,\n transitionId,\n evaluation,\n evaluation.outcome === 'accepted'\n ? { ...consentEffect(request, entersWorking, humanMove), ...evaluation.intents }\n : {},\n boards,\n );\n }\n\n async #commitRejection(\n request: FactoryTransitionRequest,\n transitionId: string,\n code: FactoryRuleRejectionCode,\n reason: string,\n ): Promise<FactoryTransitionResult> {\n return this.#commit(\n request,\n transitionId,\n { outcome: 'rejected', code, reason: reason.slice(0, MAX_REJECTION_REASON) },\n {},\n undefined,\n );\n }\n\n async #commit(\n request: FactoryTransitionRequest,\n transitionId: string,\n evaluation:\n | { outcome: 'accepted'; decisions: Record<string, unknown>[] }\n | { outcome: 'rejected'; code: string; reason: string },\n options: TransitionConsentOptions,\n // The registry the move was evaluated against; rejected moves never release resources.\n boards: BoardRegistry | undefined,\n ): Promise<FactoryTransitionResult> {\n const committed = await this.#storage.commitTransition({\n autonomy: options.autonomy,\n consentedBy: options.consentedBy,\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n workItemId: request.workItemId,\n expectedRevision: request.expectedRevision,\n destinationStage: request.stage,\n actorId: actorId(request.actor),\n ingress: { identity: request.ingress.identity, triggerType: request.ingress.type, transitionId },\n configVersion: this.#configVersion,\n causalChain: [...(request.causalChain ?? [])],\n evaluation,\n });\n if (committed.status === 'missing') {\n return rejection(transitionId, request.workItemId, 'invalid_transition', 'Work item not found.');\n }\n const result = committed.result as unknown as FactoryTransitionResult;\n if (\n this.#onAccepted &&\n options.accepted &&\n committed.status === 'committed' &&\n result.status === 'accepted' &&\n committed.item\n ) {\n const item = committed.item;\n const onAccepted = this.#onAccepted;\n // Invoke inside the chain so a synchronous throw is isolated the same way an async rejection is.\n void Promise.resolve()\n .then(() =>\n onAccepted({\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n workItemId: request.workItemId,\n item,\n }),\n )\n .catch(error => {\n console.warn(`[factory] acceptance hook failed for work item ${request.workItemId}:`, error);\n });\n }\n // Only an installed board's declaration releases resources; an unknown board or phase never does.\n if (\n this.#onTerminalStage &&\n result.status === 'accepted' &&\n boards?.get(request.board)?.isTerminal(result.stage) === true\n ) {\n let timer: ReturnType<typeof setTimeout> | undefined;\n try {\n const cleanup = Promise.resolve(\n this.#onTerminalStage({\n orgId: request.orgId,\n factoryProjectId: request.factoryProjectId,\n workItemId: request.workItemId,\n stage: result.stage,\n revision: result.revision,\n actor: request.actor,\n }),\n );\n // A late rejection after the timeout wins the race must not surface\n // as an unhandled rejection.\n cleanup.catch(() => {});\n await Promise.race([\n cleanup,\n new Promise<void>(resolve => {\n timer = setTimeout(resolve, this.#terminalCleanupTimeoutMs);\n }),\n ]);\n } catch {\n // Resource release is best-effort — never fail a committed transition.\n } finally {\n clearTimeout(timer);\n }\n }\n return result;\n }\n}\n"],"mappings":"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"}