@mastra/factory 0.28.0-alpha.2 → 0.28.0-alpha.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (455) hide show
  1. package/README.md +329 -154
  2. package/dist/boards/board-events.d.ts +23 -3
  3. package/dist/boards/board-events.d.ts.map +1 -1
  4. package/dist/boards/board-events.js +44 -7
  5. package/dist/boards/board-events.js.map +1 -1
  6. package/dist/boards/board-writes.d.ts +1 -1
  7. package/dist/boards/board-writes.d.ts.map +1 -1
  8. package/dist/boards/board-writes.js +16 -1
  9. package/dist/boards/board-writes.js.map +1 -1
  10. package/dist/boards/card-facts.d.ts +3 -1
  11. package/dist/boards/card-facts.d.ts.map +1 -1
  12. package/dist/boards/card-facts.js +30 -4
  13. package/dist/boards/card-facts.js.map +1 -1
  14. package/dist/boards/default-board.d.ts +7 -0
  15. package/dist/boards/default-board.d.ts.map +1 -0
  16. package/dist/boards/default-board.js +10 -0
  17. package/dist/boards/default-board.js.map +1 -0
  18. package/dist/boards/define-board.d.ts +40 -18
  19. package/dist/boards/define-board.d.ts.map +1 -1
  20. package/dist/boards/define-board.js +64 -42
  21. package/dist/boards/define-board.js.map +1 -1
  22. package/dist/boards/index.d.ts +5 -8
  23. package/dist/boards/index.d.ts.map +1 -1
  24. package/dist/boards/index.js +5 -19
  25. package/dist/boards/intake-routing.d.ts +29 -9
  26. package/dist/boards/intake-routing.d.ts.map +1 -1
  27. package/dist/boards/intake-routing.js +72 -20
  28. package/dist/boards/intake-routing.js.map +1 -1
  29. package/dist/boards/legacy-plan-role.d.ts.map +1 -1
  30. package/dist/boards/legacy-plan-role.js +7 -2
  31. package/dist/boards/legacy-plan-role.js.map +1 -1
  32. package/dist/boards/phase-automation.d.ts +7 -0
  33. package/dist/boards/phase-automation.d.ts.map +1 -1
  34. package/dist/boards/phase-automation.js +16 -5
  35. package/dist/boards/phase-automation.js.map +1 -1
  36. package/dist/boards/phase-runner.d.ts +18 -10
  37. package/dist/boards/phase-runner.d.ts.map +1 -1
  38. package/dist/boards/phase-runner.js +39 -34
  39. package/dist/boards/phase-runner.js.map +1 -1
  40. package/dist/boards/project-boards.d.ts +27 -7
  41. package/dist/boards/project-boards.d.ts.map +1 -1
  42. package/dist/boards/project-boards.js +94 -19
  43. package/dist/boards/project-boards.js.map +1 -1
  44. package/dist/boards/registry.d.ts.map +1 -1
  45. package/dist/boards/registry.js +3 -1
  46. package/dist/boards/registry.js.map +1 -1
  47. package/dist/boards/relocate.d.ts +1 -1
  48. package/dist/boards/relocate.d.ts.map +1 -1
  49. package/dist/boards/relocate.js +3 -2
  50. package/dist/boards/relocate.js.map +1 -1
  51. package/dist/boards/review.d.ts +5 -2
  52. package/dist/boards/review.d.ts.map +1 -1
  53. package/dist/boards/review.js +12 -11
  54. package/dist/boards/review.js.map +1 -1
  55. package/dist/boards/semantics.d.ts +159 -20
  56. package/dist/boards/semantics.d.ts.map +1 -1
  57. package/dist/boards/semantics.js +254 -23
  58. package/dist/boards/semantics.js.map +1 -1
  59. package/dist/boards/stored-board.d.ts +32 -18
  60. package/dist/boards/stored-board.d.ts.map +1 -1
  61. package/dist/boards/stored-board.js +31 -97
  62. package/dist/boards/stored-board.js.map +1 -1
  63. package/dist/boards/work-migrations.d.ts +42 -0
  64. package/dist/boards/work-migrations.d.ts.map +1 -0
  65. package/dist/boards/work-migrations.js +352 -0
  66. package/dist/boards/work-migrations.js.map +1 -0
  67. package/dist/boards/work-routes.d.ts +58 -0
  68. package/dist/boards/work-routes.d.ts.map +1 -0
  69. package/dist/boards/work-routes.js +270 -0
  70. package/dist/boards/work-routes.js.map +1 -0
  71. package/dist/boards/work.d.ts +8 -19
  72. package/dist/boards/work.d.ts.map +1 -1
  73. package/dist/boards/work.js +38 -270
  74. package/dist/boards/work.js.map +1 -1
  75. package/dist/factory.d.ts +26 -3
  76. package/dist/factory.d.ts.map +1 -1
  77. package/dist/factory.js +105 -62
  78. package/dist/factory.js.map +1 -1
  79. package/dist/index.d.ts +5 -2
  80. package/dist/index.d.ts.map +1 -1
  81. package/dist/index.js +3 -3
  82. package/dist/integrations/base.d.ts +6 -2
  83. package/dist/integrations/base.d.ts.map +1 -1
  84. package/dist/integrations/closing-references.d.ts +15 -0
  85. package/dist/integrations/closing-references.d.ts.map +1 -0
  86. package/dist/integrations/closing-references.js +69 -0
  87. package/dist/integrations/closing-references.js.map +1 -0
  88. package/dist/integrations/github/default-rules.d.ts +15 -66
  89. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  90. package/dist/integrations/github/default-rules.js +129 -73
  91. package/dist/integrations/github/default-rules.js.map +1 -1
  92. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  93. package/dist/integrations/github/issue-reconciler.js +3 -1
  94. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  95. package/dist/integrations/github/pull-request-source.d.ts +8 -0
  96. package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
  97. package/dist/integrations/github/pull-request-source.js +17 -0
  98. package/dist/integrations/github/pull-request-source.js.map +1 -0
  99. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -1
  100. package/dist/integrations/github/review-status-reporter.js +7 -3
  101. package/dist/integrations/github/review-status-reporter.js.map +1 -1
  102. package/dist/integrations/github/routes.js +1 -1
  103. package/dist/integrations/github/rules.d.ts +12 -7
  104. package/dist/integrations/github/rules.d.ts.map +1 -1
  105. package/dist/integrations/github/rules.js +214 -93
  106. package/dist/integrations/github/rules.js.map +1 -1
  107. package/dist/integrations/github/session-subscriptions.js +2 -2
  108. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  109. package/dist/integrations/github/token-refresh.d.ts +2 -1
  110. package/dist/integrations/github/token-refresh.d.ts.map +1 -1
  111. package/dist/integrations/github/token-refresh.js.map +1 -1
  112. package/dist/integrations/gitlab/agent-tools.js +1 -1
  113. package/dist/integrations/gitlab/default-rules.d.ts +73 -31
  114. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  115. package/dist/integrations/gitlab/default-rules.js +106 -43
  116. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  117. package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
  118. package/dist/integrations/gitlab/issue-reconciler.js +2 -1
  119. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  120. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  121. package/dist/integrations/gitlab/merge-request-reconciler.js +11 -4
  122. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  123. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  124. package/dist/integrations/gitlab/routes.js +1 -3
  125. package/dist/integrations/gitlab/routes.js.map +1 -1
  126. package/dist/integrations/gitlab/rules.d.ts +6 -1
  127. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  128. package/dist/integrations/gitlab/rules.js +115 -27
  129. package/dist/integrations/gitlab/rules.js.map +1 -1
  130. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  131. package/dist/integrations/incidentio/agent-tools.js +6 -6
  132. package/dist/integrations/incidentio/agent-tools.js.map +1 -1
  133. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  134. package/dist/integrations/incidentio/default-rules.js +3 -3
  135. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  136. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  137. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  138. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  139. package/dist/integrations/incidentio/routes.d.ts +2 -2
  140. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  141. package/dist/integrations/incidentio/routes.js +10 -13
  142. package/dist/integrations/incidentio/routes.js.map +1 -1
  143. package/dist/integrations/incidentio/rules.d.ts +4 -4
  144. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  145. package/dist/integrations/incidentio/rules.js +13 -12
  146. package/dist/integrations/incidentio/rules.js.map +1 -1
  147. package/dist/integrations/jira/agent-tools.js +1 -1
  148. package/dist/integrations/jira/binding-scope.d.ts +5 -6
  149. package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
  150. package/dist/integrations/jira/binding-scope.js +9 -11
  151. package/dist/integrations/jira/binding-scope.js.map +1 -1
  152. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  153. package/dist/integrations/jira/default-rules.js +3 -3
  154. package/dist/integrations/jira/default-rules.js.map +1 -1
  155. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  156. package/dist/integrations/jira/issue-reconciler.js +2 -1
  157. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  158. package/dist/integrations/jira/routes.d.ts.map +1 -1
  159. package/dist/integrations/jira/routes.js +3 -5
  160. package/dist/integrations/jira/routes.js.map +1 -1
  161. package/dist/integrations/jira/rules.d.ts +4 -4
  162. package/dist/integrations/jira/rules.d.ts.map +1 -1
  163. package/dist/integrations/jira/rules.js +13 -12
  164. package/dist/integrations/jira/rules.js.map +1 -1
  165. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  166. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  167. package/dist/integrations/linear/agent-tools.js +80 -2
  168. package/dist/integrations/linear/agent-tools.js.map +1 -1
  169. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  170. package/dist/integrations/linear/default-rules.js +3 -3
  171. package/dist/integrations/linear/default-rules.js.map +1 -1
  172. package/dist/integrations/linear/integration.d.ts +4 -1
  173. package/dist/integrations/linear/integration.d.ts.map +1 -1
  174. package/dist/integrations/linear/integration.js +21 -1
  175. package/dist/integrations/linear/integration.js.map +1 -1
  176. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  177. package/dist/integrations/linear/issue-reconciler.js +2 -1
  178. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  179. package/dist/integrations/linear/routes.d.ts +2 -1
  180. package/dist/integrations/linear/routes.d.ts.map +1 -1
  181. package/dist/integrations/linear/routes.js +15 -17
  182. package/dist/integrations/linear/routes.js.map +1 -1
  183. package/dist/integrations/linear/rules.d.ts +4 -4
  184. package/dist/integrations/linear/rules.d.ts.map +1 -1
  185. package/dist/integrations/linear/rules.js +14 -13
  186. package/dist/integrations/linear/rules.js.map +1 -1
  187. package/dist/integrations/platform/connect/session-tools.d.ts +5 -0
  188. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
  189. package/dist/integrations/platform/connect/session-tools.js +5 -0
  190. package/dist/integrations/platform/connect/session-tools.js.map +1 -1
  191. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  192. package/dist/integrations/platform/github/integration.js +33 -21
  193. package/dist/integrations/platform/github/integration.js.map +1 -1
  194. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  195. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  196. package/dist/integrations/platform/jira/routes.js +3 -5
  197. package/dist/integrations/platform/jira/routes.js.map +1 -1
  198. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  199. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  200. package/dist/integrations/platform/linear/integration.js +6 -5
  201. package/dist/integrations/platform/linear/integration.js.map +1 -1
  202. package/dist/integrations/slack/chat-tools.js +1 -1
  203. package/dist/integrations/slack/reply-tool.js +1 -1
  204. package/dist/integrations/slack/share-file-tool.js +1 -1
  205. package/dist/integrations/slack/slack.d.ts +10 -4
  206. package/dist/integrations/slack/slack.d.ts.map +1 -1
  207. package/dist/integrations/slack/slack.js +19 -9
  208. package/dist/integrations/slack/slack.js.map +1 -1
  209. package/dist/links.d.ts.map +1 -1
  210. package/dist/links.js +3 -2
  211. package/dist/links.js.map +1 -1
  212. package/dist/mcp/routes.js +2 -2
  213. package/dist/routes/attention-parked.d.ts +1 -0
  214. package/dist/routes/attention-parked.d.ts.map +1 -1
  215. package/dist/routes/attention-parked.js +1 -1
  216. package/dist/routes/attention-parked.js.map +1 -1
  217. package/dist/routes/automation-runs.d.ts +5 -1
  218. package/dist/routes/automation-runs.d.ts.map +1 -1
  219. package/dist/routes/automation-runs.js +15 -0
  220. package/dist/routes/automation-runs.js.map +1 -1
  221. package/dist/routes/boards.d.ts +1 -1
  222. package/dist/routes/boards.d.ts.map +1 -1
  223. package/dist/routes/boards.js +1 -17
  224. package/dist/routes/boards.js.map +1 -1
  225. package/dist/routes/config.d.ts +4 -0
  226. package/dist/routes/config.d.ts.map +1 -1
  227. package/dist/routes/config.js +15 -0
  228. package/dist/routes/config.js.map +1 -1
  229. package/dist/routes/contracts.d.ts +128 -24
  230. package/dist/routes/contracts.d.ts.map +1 -1
  231. package/dist/routes/contracts.js +45 -24
  232. package/dist/routes/contracts.js.map +1 -1
  233. package/dist/routes/fs.d.ts +4 -0
  234. package/dist/routes/fs.d.ts.map +1 -1
  235. package/dist/routes/fs.js +8 -4
  236. package/dist/routes/fs.js.map +1 -1
  237. package/dist/routes/intake-routes.d.ts.map +1 -1
  238. package/dist/routes/intake-routes.js +6 -1
  239. package/dist/routes/intake-routes.js.map +1 -1
  240. package/dist/routes/intake.d.ts +0 -23
  241. package/dist/routes/intake.d.ts.map +1 -1
  242. package/dist/routes/intake.js +13 -309
  243. package/dist/routes/intake.js.map +1 -1
  244. package/dist/routes/projects.d.ts.map +1 -1
  245. package/dist/routes/projects.js +9 -3
  246. package/dist/routes/projects.js.map +1 -1
  247. package/dist/routes/provider-credentials.d.ts.map +1 -1
  248. package/dist/routes/provider-credentials.js +10 -5
  249. package/dist/routes/provider-credentials.js.map +1 -1
  250. package/dist/routes/running-packages.d.ts +13 -0
  251. package/dist/routes/running-packages.d.ts.map +1 -0
  252. package/dist/routes/running-packages.js +45 -0
  253. package/dist/routes/running-packages.js.map +1 -0
  254. package/dist/routes/surface.d.ts +10 -1
  255. package/dist/routes/surface.d.ts.map +1 -1
  256. package/dist/routes/surface.js +104 -37
  257. package/dist/routes/surface.js.map +1 -1
  258. package/dist/routes/work-items.d.ts.map +1 -1
  259. package/dist/routes/work-items.js +23 -3
  260. package/dist/routes/work-items.js.map +1 -1
  261. package/dist/rules/binding-context.d.ts.map +1 -1
  262. package/dist/rules/binding-context.js +1 -0
  263. package/dist/rules/binding-context.js.map +1 -1
  264. package/dist/rules/dispatcher.d.ts +0 -6
  265. package/dist/rules/dispatcher.d.ts.map +1 -1
  266. package/dist/rules/dispatcher.js +354 -60
  267. package/dist/rules/dispatcher.js.map +1 -1
  268. package/dist/rules/event-rules.d.ts +33 -2
  269. package/dist/rules/event-rules.d.ts.map +1 -1
  270. package/dist/rules/event-rules.js +46 -11
  271. package/dist/rules/event-rules.js.map +1 -1
  272. package/dist/rules/index.d.ts +2 -4
  273. package/dist/rules/index.d.ts.map +1 -1
  274. package/dist/rules/index.js +2 -3
  275. package/dist/rules/phase-goal.d.ts +54 -0
  276. package/dist/rules/phase-goal.d.ts.map +1 -0
  277. package/dist/rules/phase-goal.js +70 -0
  278. package/dist/rules/phase-goal.js.map +1 -0
  279. package/dist/rules/phase-tools.d.ts +11 -0
  280. package/dist/rules/phase-tools.d.ts.map +1 -0
  281. package/dist/rules/phase-tools.js +19 -0
  282. package/dist/rules/phase-tools.js.map +1 -0
  283. package/dist/rules/processor.d.ts.map +1 -1
  284. package/dist/rules/processor.js +112 -11
  285. package/dist/rules/processor.js.map +1 -1
  286. package/dist/rules/review-source-tool.d.ts +4 -1
  287. package/dist/rules/review-source-tool.d.ts.map +1 -1
  288. package/dist/rules/review-source-tool.js +24 -4
  289. package/dist/rules/review-source-tool.js.map +1 -1
  290. package/dist/rules/rule-group.d.ts +1 -1
  291. package/dist/rules/rule-group.d.ts.map +1 -1
  292. package/dist/rules/rule-group.js +15 -6
  293. package/dist/rules/rule-group.js.map +1 -1
  294. package/dist/rules/start-coordinator.d.ts +5 -1
  295. package/dist/rules/start-coordinator.d.ts.map +1 -1
  296. package/dist/rules/start-coordinator.js +9 -3
  297. package/dist/rules/start-coordinator.js.map +1 -1
  298. package/dist/rules/tools.d.ts.map +1 -1
  299. package/dist/rules/tools.js +39 -28
  300. package/dist/rules/tools.js.map +1 -1
  301. package/dist/rules/transition-service.d.ts +4 -10
  302. package/dist/rules/transition-service.d.ts.map +1 -1
  303. package/dist/rules/transition-service.js +61 -55
  304. package/dist/rules/transition-service.js.map +1 -1
  305. package/dist/rules/types.d.ts +86 -36
  306. package/dist/rules/types.d.ts.map +1 -1
  307. package/dist/rules/types.js +5 -41
  308. package/dist/rules/types.js.map +1 -1
  309. package/dist/rules/validation.d.ts.map +1 -1
  310. package/dist/rules/validation.js +32 -2
  311. package/dist/rules/validation.js.map +1 -1
  312. package/dist/secret-encryption.d.ts +21 -0
  313. package/dist/secret-encryption.d.ts.map +1 -1
  314. package/dist/secret-encryption.js +31 -4
  315. package/dist/secret-encryption.js.map +1 -1
  316. package/dist/session/self-review-gate.d.ts +6 -4
  317. package/dist/session/self-review-gate.d.ts.map +1 -1
  318. package/dist/session/self-review-gate.js +9 -12
  319. package/dist/session/self-review-gate.js.map +1 -1
  320. package/dist/session/session-threads.d.ts +2 -3
  321. package/dist/session/session-threads.d.ts.map +1 -1
  322. package/dist/session/session-threads.js.map +1 -1
  323. package/dist/session/source-control-tools.d.ts +39 -13
  324. package/dist/session/source-control-tools.d.ts.map +1 -1
  325. package/dist/session/source-control-tools.js +55 -61
  326. package/dist/session/source-control-tools.js.map +1 -1
  327. package/dist/session/work-item-state-processor.d.ts +24 -0
  328. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  329. package/dist/session/work-item-state-processor.js +275 -0
  330. package/dist/session/work-item-state-processor.js.map +1 -0
  331. package/dist/storage/domains/boards/base.d.ts +70 -31
  332. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  333. package/dist/storage/domains/boards/base.js +99 -126
  334. package/dist/storage/domains/boards/base.js.map +1 -1
  335. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  336. package/dist/storage/domains/boards/schemas.js +12 -0
  337. package/dist/storage/domains/boards/schemas.js.map +1 -1
  338. package/dist/storage/domains/intake/base.d.ts +5 -45
  339. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  340. package/dist/storage/domains/intake/base.js +11 -89
  341. package/dist/storage/domains/intake/base.js.map +1 -1
  342. package/dist/storage/domains/projects/base.d.ts +17 -9
  343. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  344. package/dist/storage/domains/projects/base.js +15 -7
  345. package/dist/storage/domains/projects/base.js.map +1 -1
  346. package/dist/storage/domains/work-items/base.d.ts +39 -4
  347. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  348. package/dist/storage/domains/work-items/base.js +113 -26
  349. package/dist/storage/domains/work-items/base.js.map +1 -1
  350. package/dist/storage/domains/work-items/cards.d.ts +24 -2
  351. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  352. package/dist/storage/domains/work-items/cards.js +118 -8
  353. package/dist/storage/domains/work-items/cards.js.map +1 -1
  354. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  355. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  356. package/dist/storage/domains/work-items/legacy-review.js +95 -0
  357. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  358. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  359. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  360. package/dist/storage/domains/work-items/metrics.js +14 -32
  361. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  362. package/dist/storage/domains/work-items/work-item-schema.d.ts +2 -0
  363. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  364. package/dist/storage/domains/work-items/work-item-schema.js +5 -0
  365. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  366. package/dist/tools/approval-tools.d.ts.map +1 -1
  367. package/dist/tools/approval-tools.js +28 -9
  368. package/dist/tools/approval-tools.js.map +1 -1
  369. package/dist/tools/index.d.ts +1 -1
  370. package/dist/tools/index.js +1 -1
  371. package/dist/tools/index.js.map +1 -1
  372. package/dist/tools/messaging-tools.d.ts +3 -0
  373. package/dist/tools/messaging-tools.d.ts.map +1 -1
  374. package/dist/tools/messaging-tools.js +2 -1
  375. package/dist/tools/messaging-tools.js.map +1 -1
  376. package/dist/tools/read-tools.d.ts +8 -2
  377. package/dist/tools/read-tools.d.ts.map +1 -1
  378. package/dist/tools/read-tools.js +83 -23
  379. package/dist/tools/read-tools.js.map +1 -1
  380. package/dist/tools/reports.d.ts +1 -0
  381. package/dist/tools/reports.d.ts.map +1 -1
  382. package/dist/tools/reports.js +2 -1
  383. package/dist/tools/reports.js.map +1 -1
  384. package/dist/tools/run-watch.d.ts +1 -1
  385. package/dist/tools/run-watch.d.ts.map +1 -1
  386. package/dist/tools/run-watch.js +1 -0
  387. package/dist/tools/run-watch.js.map +1 -1
  388. package/dist/tools/sandbox-tools.js +1 -1
  389. package/dist/tools/session-tools.js +1 -1
  390. package/dist/tools/sessions-state-processor.d.ts +2 -0
  391. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  392. package/dist/tools/sessions-state-processor.js +4 -2
  393. package/dist/tools/sessions-state-processor.js.map +1 -1
  394. package/dist/tools/side-sessions.d.ts +2 -0
  395. package/dist/tools/side-sessions.d.ts.map +1 -1
  396. package/dist/tools/side-sessions.js +2 -1
  397. package/dist/tools/side-sessions.js.map +1 -1
  398. package/dist/tools/work-item-tools.js +3 -3
  399. package/dist/tools/work-item-tools.js.map +1 -1
  400. package/dist/work-item-branch.d.ts +13 -0
  401. package/dist/work-item-branch.d.ts.map +1 -1
  402. package/dist/work-item-branch.js +16 -1
  403. package/dist/work-item-branch.js.map +1 -1
  404. package/dist/work-items/create-work-item.d.ts +6 -0
  405. package/dist/work-items/create-work-item.d.ts.map +1 -1
  406. package/dist/work-items/create-work-item.js +25 -1
  407. package/dist/work-items/create-work-item.js.map +1 -1
  408. package/dist/work-items/providers/base.d.ts +4 -1
  409. package/dist/work-items/providers/base.d.ts.map +1 -1
  410. package/dist/work-items/providers/base.js +6 -1
  411. package/dist/work-items/providers/base.js.map +1 -1
  412. package/dist/work-items/providers/github.d.ts.map +1 -1
  413. package/dist/work-items/providers/github.js +2 -1
  414. package/dist/work-items/providers/github.js.map +1 -1
  415. package/dist/work-items/providers/gitlab.d.ts.map +1 -1
  416. package/dist/work-items/providers/gitlab.js +2 -1
  417. package/dist/work-items/providers/gitlab.js.map +1 -1
  418. package/dist/work-items/providers/jira.d.ts.map +1 -1
  419. package/dist/work-items/providers/jira.js +3 -2
  420. package/dist/work-items/providers/jira.js.map +1 -1
  421. package/dist/work-items/providers/linear.d.ts.map +1 -1
  422. package/dist/work-items/providers/linear.js +3 -2
  423. package/dist/work-items/providers/linear.js.map +1 -1
  424. package/dist/work-items/providers/types.d.ts +6 -0
  425. package/dist/work-items/providers/types.d.ts.map +1 -1
  426. package/dist/work-items/split-migration.d.ts.map +1 -1
  427. package/dist/work-items/split-migration.js +1 -0
  428. package/dist/work-items/split-migration.js.map +1 -1
  429. package/dist/workspace.d.ts.map +1 -1
  430. package/dist/workspace.js +53 -10
  431. package/dist/workspace.js.map +1 -1
  432. package/factory-skills/configure-factory-rules/SKILL.md +12 -10
  433. package/factory-skills/factory-build/SKILL.md +64 -0
  434. package/factory-skills/factory-gitlab-rereview/SKILL.md +2 -2
  435. package/factory-skills/factory-gitlab-review/SKILL.md +3 -3
  436. package/factory-skills/factory-plan/SKILL.md +8 -10
  437. package/factory-skills/factory-rereview/SKILL.md +5 -5
  438. package/factory-skills/factory-review/SKILL.md +16 -6
  439. package/factory-skills/factory-self-review/SKILL.md +31 -11
  440. package/factory-skills/factory-triage/SKILL.md +25 -10
  441. package/package.json +11 -11
  442. package/dist/boards/index.js.map +0 -1
  443. package/dist/boards/pull-request-review.d.ts +0 -14
  444. package/dist/boards/pull-request-review.d.ts.map +0 -1
  445. package/dist/boards/pull-request-review.js +0 -81
  446. package/dist/boards/pull-request-review.js.map +0 -1
  447. package/dist/boards/work-tool-rules.d.ts +0 -8
  448. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  449. package/dist/boards/work-tool-rules.js +0 -19
  450. package/dist/boards/work-tool-rules.js.map +0 -1
  451. package/dist/rules/resolve.d.ts +0 -15
  452. package/dist/rules/resolve.d.ts.map +0 -1
  453. package/dist/rules/resolve.js +0 -22
  454. package/dist/rules/resolve.js.map +0 -1
  455. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -1,6 +1,8 @@
1
+ import { eventMovesCard, isPullRequestEvent } from "../boards/board-events.js";
1
2
  import "../boards/index.js";
2
- import { INTAKE_ROUTE_METADATA_KEY, landingPhase, placedByIntakeRoute, resolveEventRoute, resolveIntakePlacement, routesHandleEvent } from "../boards/intake-routing.js";
3
- import { boardForWorkItem, isPullRequestCard, isTerminalWorkItem, pullRequestReviewPhase, resolvePhaseSemantics, reviewsPullRequest, workItemPhaseSemantics } from "../boards/semantics.js";
3
+ import { INTAKE_ROUTE_METADATA_KEY, closedIssueRuleFacts, landingPhase, placedByIntakeRoute, resolveEventRoute, resolveIntakePlacement, resolveIntakeRoute, routesHandleEvent } from "../boards/intake-routing.js";
4
+ import "../boards/define-board.js";
5
+ import { boardFlow, boardForWorkItem, cardBoardFlow, hasPullRequest, intakeTarget, isPullRequestCard, isTerminalWorkItem, resolvePhaseSemantics, reviewsPullRequest, workItemPhaseSemantics } from "../boards/semantics.js";
4
6
  import { autoApprovedExitTool, startsInAutoPhase } from "../boards/phase-automation.js";
5
7
  import { toBoardSource } from "../boards/project-boards.js";
6
8
  import { moveCardToBoard } from "../boards/relocate.js";
@@ -9,12 +11,13 @@ import { FACTORY_OPEN_RUN_STALE_MS, heartbeatSessionOpenRun, isOpenRunLiveElsewh
9
11
  import { resolvePromptInvocation, resolveSkillInvocation, resolveSkillResumeInvocation } from "../skills/service.js";
10
12
  import { isHumanActorId } from "../storage/domains/audit/actors.js";
11
13
  import { withWorkItemFeed } from "../storage/domains/comments/feed-context.js";
12
- import { FACTORY_RULE_MATERIALIZATION_KEY } from "../storage/domains/work-items/base.js";
14
+ import { FACTORY_RULE_MATERIALIZATION_KEY, WorkItemSourceConflictError, WorkItemUpdateConflictError, externalSourceKey } from "../storage/domains/work-items/base.js";
13
15
  import { workItemProviderAdapter } from "../work-items/providers/index.js";
14
16
  import { decisionOvertaken } from "./decision-applicability.js";
15
17
  import { FactoryDispatchError, factoryDispatchFailureCode, factoryDispatchFailureMetadata } from "./dispatch-errors.js";
16
18
  import { isStatusEventDecision } from "./event-rules.js";
17
- import { FACTORY_RULE_STAGES, externalSourceForWorkItem, workItemSource } from "./types.js";
19
+ import { PHASE_GOAL_METADATA_KEY, endPhaseGoal, phaseGoalOf, startPhaseGoal } from "./phase-goal.js";
20
+ import { authorTrusted, externalSourceForWorkItem, workItemSource } from "./types.js";
18
21
  import { assertFactoryDecisionTarget, validateFactoryRuleDecision } from "./validation.js";
19
22
  import { RequestContext } from "@mastra/core/request-context";
20
23
  import { PROVIDER_CALL_ERROR_NAME, classifyProviderError } from "@mastra/core/error";
@@ -78,11 +81,11 @@ function runErrorFailure(label, error) {
78
81
  if (!cause) return new RunEndedInError("run_failed", `${label} ended in error.`);
79
82
  return new RunEndedInError(runErrorCode(error, cause), `${label} ended in error: ${cause}`);
80
83
  }
81
- /** A pull request review run: the only runs that keep a status comment on the pull request. */
82
- function isReviewRun(decision) {
83
- if (!decision || typeof decision !== "object") return false;
84
+ /** A run in the review seat: a pull request review, unless it is the card's board's self-review. */
85
+ function reviewSeatSkill(decision) {
86
+ if (!decision || typeof decision !== "object") return void 0;
84
87
  const value = decision;
85
- return value.type === "invokeSkill" && value.role === "review";
88
+ return value.type === "invokeSkill" && value.role === "review" ? value : void 0;
86
89
  }
87
90
  function isTerminalFailure(attempts, failureCode) {
88
91
  return attempts >= MAX_ATTEMPTS || !factoryDispatchFailureMetadata(failureCode).canRetry;
@@ -267,12 +270,18 @@ function requestsConsent(boards, record, decision) {
267
270
  if (decision.type !== "transition" || !externalActor(record.actor)) return false;
268
271
  return (resolvePhaseSemantics(boards, decision.board, decision.stage)?.kind ?? "working") === "working";
269
272
  }
270
- function reviewsFactoryAuthoredCode(item, decision) {
273
+ function reviewsFactoryAuthoredCode(boards, item, decision) {
271
274
  if (item.metadata?.factoryAuthored !== true) return false;
272
- if (decision.type === "transition") return decision.stage === pullRequestReviewPhase(decision.board) && reviewsPullRequest({
273
- board: decision.board,
274
- item: { source: workItemSource(item.externalSource) }
275
- });
275
+ if (decision.type === "transition") {
276
+ const flow = boardFlow(boards.get(decision.board));
277
+ return decision.stage === flow.pullRequestReview && reviewsPullRequest({
278
+ flow,
279
+ item: {
280
+ source: workItemSource(item.externalSource),
281
+ workItem: item.workItem
282
+ }
283
+ });
284
+ }
276
285
  return decision.type === "invokeSkill" && decision.role === "review";
277
286
  }
278
287
  function leaseIdentity(record, ownerId) {
@@ -312,7 +321,6 @@ var FactoryDecisionDispatcher = class {
312
321
  #intakeRoutes;
313
322
  #storage;
314
323
  #ownerId;
315
- #isAutoRunEnabled;
316
324
  #reconcileToolResults;
317
325
  #prepareBinding;
318
326
  #primeCredentials;
@@ -367,7 +375,6 @@ var FactoryDecisionDispatcher = class {
367
375
  this.#intakeRoutes = options.intakeRoutes;
368
376
  this.#storage = options.storage;
369
377
  this.#ownerId = options.ownerId ?? `factory-dispatcher:${globalThis.crypto.randomUUID()}`;
370
- this.#isAutoRunEnabled = options.isAutoRunEnabled;
371
378
  this.#reconcileToolResults = options.reconcileToolResults;
372
379
  this.#prepareBinding = options.prepareBinding;
373
380
  this.#primeCredentials = options.primeCredentials;
@@ -652,7 +659,7 @@ var FactoryDecisionDispatcher = class {
652
659
  * registering there can still be live in this process, so wait it out too.
653
660
  */
654
661
  async #replayLanded(record, decision, session, runStillActive) {
655
- if (!isReviewRun(decision)) return;
662
+ if (!await this.#isReviewRun(record, decision)) return;
656
663
  if (runStillActive()) {
657
664
  const run = watchRun(session, {
658
665
  timeoutMs: this.#skillCompletionObservationTimeoutMs,
@@ -668,6 +675,110 @@ var FactoryDecisionDispatcher = class {
668
675
  }
669
676
  this.#reviewReplayed.add(record);
670
677
  }
678
+ /**
679
+ * Holds the goal a phase's run pursues on the session's thread, and names it on the card so
680
+ * leaving the phase ends it. Keyed on the decision: a retry finds the goal already held.
681
+ */
682
+ async #setPhaseGoal(record, goal, session, binding) {
683
+ const item = record.workItemId ? await this.#storage.get({
684
+ orgId: record.orgId,
685
+ id: record.workItemId
686
+ }) : null;
687
+ const phaseKey = item?.stages.length === 1 ? item.stages[0] : void 0;
688
+ const objective = await startPhaseGoal(session.machinery.getAgent(), {
689
+ threadId: binding.threadId,
690
+ resourceId: binding.resourceId,
691
+ goalId: record.id,
692
+ objective: goal.objective,
693
+ maxRuns: goal.maxRuns,
694
+ judgeModelId: session.model.get() || void 0
695
+ });
696
+ if (!objective) throw new FactoryDispatchError("run_configuration_invalid", "The Factory session has no storage to hold a goal.");
697
+ if (!item || !phaseKey) return objective;
698
+ const stamp = {
699
+ phaseKey,
700
+ goalId: record.id,
701
+ threadId: binding.threadId,
702
+ sessionId: binding.sessionId
703
+ };
704
+ if (phaseGoalOf(item.metadata)?.goalId !== record.id) await this.#storage.update({
705
+ orgId: record.orgId,
706
+ id: item.id,
707
+ userId: "factory",
708
+ patch: { metadata: { [PHASE_GOAL_METADATA_KEY]: stamp } }
709
+ });
710
+ const after = await this.#storage.get({
711
+ orgId: record.orgId,
712
+ id: item.id
713
+ });
714
+ if (after?.stages.length !== 1 || after.stages[0] !== phaseKey) {
715
+ await endPhaseGoal(stamp, {
716
+ agentFor: async () => session.machinery.getAgent(),
717
+ store: async () => void 0
718
+ });
719
+ throw new FactoryDecisionSuperseded();
720
+ }
721
+ return objective;
722
+ }
723
+ /**
724
+ * Shows the goal in the thread once its run has the kickoff. A goal whose reminder never landed
725
+ * is paused rather than left judging a run nobody was told about; the retry resumes it.
726
+ */
727
+ async #remindPhaseGoal(record, goal, session, binding, requestContext) {
728
+ const reminderId = `${record.id}:goal`;
729
+ if ((await session.thread.listActiveMessages()).some((message) => message.id === reminderId)) return;
730
+ const agent = session.machinery.getAgent();
731
+ if (goal.status === "paused") await agent.updateObjectiveOptions({
732
+ threadId: binding.threadId,
733
+ status: "active"
734
+ });
735
+ try {
736
+ const settled = await session.sendSignal({
737
+ id: reminderId,
738
+ type: "system-reminder",
739
+ contents: goal.objective,
740
+ attributes: { type: "goal" },
741
+ metadata: {
742
+ goalId: goal.id,
743
+ goalMaxTurns: goal.maxRuns,
744
+ judgeModelId: goal.judgeModelId
745
+ }
746
+ }, {
747
+ requestContext,
748
+ requireDelivery: true
749
+ }).accepted;
750
+ if (settled.action !== "wake" && settled.action !== "deliver") throw new FactoryDispatchError("notification_delivery_failed", `Factory goal reminder did not reach the agent (${String(settled.action)}).`);
751
+ } catch (error) {
752
+ await agent.updateObjectiveOptions({
753
+ threadId: binding.threadId,
754
+ status: "paused"
755
+ });
756
+ throw error;
757
+ }
758
+ }
759
+ /** A retried decision whose kickoff already landed: make sure its goal is held and shown. */
760
+ async #startPhaseGoal(record, goal, session, binding, requestContext) {
761
+ const objective = await this.#setPhaseGoal(record, goal, session, binding);
762
+ await this.#remindPhaseGoal(record, objective, session, binding, requestContext);
763
+ }
764
+ /**
765
+ * A pull request review run: the only runs that keep a status comment on the pull request. A
766
+ * review-seat run of the skill the card's board self-reviews with checks the builder's own work
767
+ * and reviews no pull request, even on a card that carries one.
768
+ */
769
+ async #isReviewRun(record, decision) {
770
+ const run = reviewSeatSkill(decision);
771
+ if (!run) return false;
772
+ const item = record.workItemId ? await this.#storage.get({
773
+ orgId: record.orgId,
774
+ id: record.workItemId
775
+ }) : null;
776
+ if (!item) return true;
777
+ const board = (await this.#boards.load(record)).get(boardForWorkItem(item));
778
+ const selfReview = boardFlow(board).selfReview;
779
+ const phase = selfReview === void 0 ? void 0 : board?.phases[selfReview];
780
+ return phase?.kind !== "working" || phase.runner.skill !== run.skillName;
781
+ }
671
782
  async #reviewQueuedOnce(record, decision) {
672
783
  if (this.#reviewQueued.has(record)) return;
673
784
  this.#reviewQueued.add(record);
@@ -676,7 +787,13 @@ var FactoryDecisionDispatcher = class {
676
787
  /** Best-effort: a status comment is never worth failing or delaying the review it describes. */
677
788
  async #reviewStatus(record, decision, step) {
678
789
  const report = this.#reportReviewStatus;
679
- if (!report || !record.workItemId || !isReviewRun(decision)) return;
790
+ if (!report || !record.workItemId) return;
791
+ try {
792
+ if (!await this.#isReviewRun(record, decision)) return;
793
+ } catch (error) {
794
+ console.warn("Factory review status update failed", sanitizeDispatchError(error));
795
+ return;
796
+ }
680
797
  const event = {
681
798
  orgId: record.orgId,
682
799
  factoryProjectId: record.factoryProjectId,
@@ -770,13 +887,10 @@ var FactoryDecisionDispatcher = class {
770
887
  orgId: record.orgId,
771
888
  id: record.workItemId
772
889
  }) : null;
773
- if (item?.autonomyArmedAt != null) return false;
774
- if (item && reviewsFactoryAuthoredCode(item, decision)) return false;
775
- if (item && startsInAutoPhase(boards, item, decision)) return false;
776
- return !await this.#isAutoRunEnabled({
777
- orgId: record.orgId,
778
- factoryProjectId: record.factoryProjectId
779
- });
890
+ if (!item) return true;
891
+ if (item.autonomyArmedAt != null) return false;
892
+ if (reviewsFactoryAuthoredCode(boards, item, decision)) return false;
893
+ return !startsInAutoPhase(boards, item, decision);
780
894
  }
781
895
  async #executeDecision(record, decision) {
782
896
  const nextChain = [...record.causalChain, {
@@ -836,7 +950,10 @@ var FactoryDecisionDispatcher = class {
836
950
  await this.#waitForOpenRun(session, binding, "Factory skill run");
837
951
  if (await this.#roleSuperseded(record, decision.role)) throw new FactoryDecisionSuperseded();
838
952
  if ((await this.#requireBinding(record, decision.role)).id !== binding.id) throw new FactoryDispatchError("session_unavailable", `Factory binding ${binding.id} changed while waiting for its open run to end.`);
839
- if (await kickoffLanded()) return this.#replayLanded(record, decision, session, runStillActive);
953
+ if (await kickoffLanded()) {
954
+ if (decision.goal) await this.#startPhaseGoal(record, decision.goal, session, binding, requestContext);
955
+ return this.#replayLanded(record, decision, session, runStillActive);
956
+ }
840
957
  if (await kickoffStale()) throw new FactoryDecisionSuperseded();
841
958
  const kickoffContents = await withWorkItemFeed(this.#feedReader, {
842
959
  orgId: record.orgId,
@@ -851,7 +968,10 @@ var FactoryDecisionDispatcher = class {
851
968
  type: "user",
852
969
  tagName: "user"
853
970
  };
854
- if (await kickoffLanded()) return this.#replayLanded(record, decision, session, runStillActive);
971
+ if (await kickoffLanded()) {
972
+ if (decision.goal) await this.#startPhaseGoal(record, decision.goal, session, binding, requestContext);
973
+ return this.#replayLanded(record, decision, session, runStillActive);
974
+ }
855
975
  if (await kickoffStale()) throw new FactoryDecisionSuperseded();
856
976
  await this.#reviewQueuedOnce(record, decision);
857
977
  if (decision.cancelInFlight && session.stream.isActive()) session.abort();
@@ -872,6 +992,7 @@ var FactoryDecisionDispatcher = class {
872
992
  }));
873
993
  if (await kickoffStale()) throw new FactoryDecisionSuperseded();
874
994
  }
995
+ const goal = decision.goal ? await this.#setPhaseGoal(record, decision.goal, session, binding) : void 0;
875
996
  const since = /* @__PURE__ */ new Date();
876
997
  const run = watchRun(session, {
877
998
  timeoutMs: this.#skillCompletionObservationTimeoutMs,
@@ -903,6 +1024,7 @@ var FactoryDecisionDispatcher = class {
903
1024
  run.arm();
904
1025
  settled = await sendKickoff();
905
1026
  }
1027
+ if (goal) await this.#remindPhaseGoal(record, goal, session, binding, requestContext);
906
1028
  await this.#recordRunStart(session, binding, deliveryId, record.approvedBy ?? void 0, run.endReason, item?.title);
907
1029
  this.#reviewWatched.add(record);
908
1030
  await this.#reviewStatus(record, decision, {
@@ -981,7 +1103,22 @@ var FactoryDecisionDispatcher = class {
981
1103
  return;
982
1104
  case "notify": {
983
1105
  const binding = await this.#requireBinding(record);
1106
+ const startedBy = (record.workItemId ? await this.#storage.get({
1107
+ orgId: record.orgId,
1108
+ id: record.workItemId
1109
+ }) : null)?.sessions[binding.role]?.startedBy;
1110
+ if (!startedBy) throw new Error(`Factory binding ${binding.id} has no authenticated session owner.`);
1111
+ await this.#primeCredentials?.({
1112
+ orgId: record.orgId,
1113
+ userId: startedBy
1114
+ });
984
1115
  const session = await this.#requireSession(binding);
1116
+ const requestContext = factoryRequestContext({
1117
+ session,
1118
+ binding,
1119
+ userId: startedBy,
1120
+ orgId: record.orgId
1121
+ });
985
1122
  await awaitNotification(() => session.sendNotificationSignal({
986
1123
  source: "factory",
987
1124
  kind: "rule-notification",
@@ -992,7 +1129,7 @@ var FactoryDecisionDispatcher = class {
992
1129
  },
993
1130
  sourceId: record.id,
994
1131
  dedupeKey: record.idempotencyKey
995
- }));
1132
+ }, { requestContext }));
996
1133
  }
997
1134
  }
998
1135
  }
@@ -1019,6 +1156,29 @@ var FactoryDecisionDispatcher = class {
1019
1156
  factoryProjectId: record.factoryProjectId,
1020
1157
  source: externalSourceForDecision(requested)
1021
1158
  });
1159
+ if (existing && externalSourceKey(existing.externalSource) !== externalSourceKey(externalSourceForDecision(requested))) {
1160
+ const source = externalSourceForDecision(requested);
1161
+ const facts = workItemProviderAdapter(source).toSource(source, requested.metadata ?? null);
1162
+ if (facts?.state === "open") await this.#storage.syncWorkItemSource({
1163
+ orgId: record.orgId,
1164
+ factoryProjectId: record.factoryProjectId,
1165
+ provider: facts.provider,
1166
+ externalId: facts.externalId,
1167
+ patch: (current) => current.state === "closed" || current.state === "merged" ? {
1168
+ state: facts.state,
1169
+ metadata: {
1170
+ ...current.metadata,
1171
+ ...facts.metadata
1172
+ }
1173
+ } : null
1174
+ });
1175
+ return;
1176
+ }
1177
+ if (!existing && requested.attachTo) {
1178
+ const attachBoards = await this.#boards.load(record);
1179
+ if (await this.#attachLinkedItem(record, requested, requested.attachTo.workItemId, causalChain, (card) => cardBoardFlow(attachBoards, card).pullRequestReview !== void 0 ? { phase: null } : void 0)) return;
1180
+ }
1181
+ if (!existing && requested.closesIssue && await this.#joinClosedIssue(record, requested, causalChain)) return;
1022
1182
  const materializedHere = existing?.metadata?.[FACTORY_RULE_MATERIALIZATION_KEY] === record.idempotencyKey;
1023
1183
  if (materializedHere && requested.skipRules === true) return;
1024
1184
  const boards = await this.#boards.load(record);
@@ -1066,7 +1226,10 @@ var FactoryDecisionDispatcher = class {
1066
1226
  reuseMode: "preserve"
1067
1227
  });
1068
1228
  const itemBoard = boardForWorkItem(result.item);
1069
- const board = itemBoard === "review" && decision.board === "work" && isPullRequestCard({ source: workItemSource(result.item.externalSource) }) ? itemBoard : decision.board;
1229
+ const itemFlow = itemBoard === decision.board ? void 0 : boardFlow(boards.get(itemBoard));
1230
+ const keptReview = isPullRequestCard({ source: workItemSource(result.item.externalSource) }) ? itemFlow?.pullRequestReview : void 0;
1231
+ const board = keptReview === void 0 ? decision.board : itemBoard;
1232
+ const placeStage = keptReview !== void 0 && decision.stage === boardFlow(definition).pullRequestReview ? keptReview : decision.stage;
1070
1233
  if (!skipRules && itemBoard !== board) throw new Error(`The work item belongs to board "${itemBoard}", not "${board}".`);
1071
1234
  if (!result.item.parentWorkItemId && parentWorkItemId && parentWorkItemId !== result.item.id) {
1072
1235
  const item = await this.#storage.setParentWorkItemIfMissing({
@@ -1098,14 +1261,22 @@ var FactoryDecisionDispatcher = class {
1098
1261
  }
1099
1262
  }
1100
1263
  if (skipRules) {
1101
- if (!result.created) await moveCardToBoard({
1102
- workItems: this.#storage,
1103
- boardRegistry: boards,
1104
- userId: "factory-rule-dispatcher",
1105
- item: result.item,
1106
- targetBoard: board,
1107
- targetStage: decision.stage
1108
- });
1264
+ let item = result.created ? null : result.item;
1265
+ for (let attempt = 0; item && attempt < 3; attempt += 1) {
1266
+ if (await moveCardToBoard({
1267
+ workItems: this.#storage,
1268
+ boardRegistry: boards,
1269
+ userId: "factory-rule-dispatcher",
1270
+ item,
1271
+ targetBoard: board,
1272
+ targetStage: placeStage
1273
+ }) !== "skipped") break;
1274
+ const fresh = await this.#storage.get({
1275
+ orgId: record.orgId,
1276
+ id: item.id
1277
+ });
1278
+ item = fresh && fresh.revision !== item.revision ? fresh : null;
1279
+ }
1109
1280
  return;
1110
1281
  }
1111
1282
  const materializedByDecision = result.item.metadata?.[FACTORY_RULE_MATERIALIZATION_KEY] === record.idempotencyKey;
@@ -1160,26 +1331,134 @@ var FactoryDecisionDispatcher = class {
1160
1331
  if (moved.status === "rejected") throw new Error(`${moved.code}: ${moved.reason}`);
1161
1332
  }
1162
1333
  /**
1163
- * Applies the project's intake routes to an arrival: a decision filing the card at its
1164
- * board's initial phase. A decision naming a later phase (a maintainer's review request)
1165
- * or placing the card outright (`skipRules`) already chose where the card goes.
1334
+ * Files a pull or merge request on the existing card `workItemId`, as one more source, when
1335
+ * `admit` takes the card as it is now; the card then moves to the phase `admit` names when its
1336
+ * board allows it. Returns false when the card can't take it (gone, finished, a pull request's
1337
+ * own card, refused by `admit`, or another card took the record first), so the caller files the
1338
+ * record as usual. `admit` runs again on a fresh read whenever the card changed in between.
1166
1339
  */
1167
- async #routeArrival(record, decision, boards) {
1168
- if (!this.#intakeRoutes || decision.skipRules === true) return decision;
1169
- if (decision.stage !== boards.get(decision.board)?.initialPhase) return decision;
1170
- if (record.workItemId !== null) return decision;
1340
+ async #attachLinkedItem(record, decision, workItemId, causalChain, admit) {
1341
+ if (this.#storage.legacyMode) return false;
1342
+ const boards = await this.#boards.load(record);
1343
+ let attached;
1344
+ for (let attempt = 0; attempt < 3 && !attached; attempt++) {
1345
+ const card = await this.#storage.get({
1346
+ orgId: record.orgId,
1347
+ id: workItemId
1348
+ });
1349
+ if (!card || card.factoryProjectId !== record.factoryProjectId || isTerminalWorkItem(boards, card) || isPullRequestCard({ source: workItemSource(card.externalSource) })) return false;
1350
+ const admitted = admit(card);
1351
+ if (!admitted) return false;
1352
+ try {
1353
+ const result = await this.#storage.attachSource({
1354
+ orgId: record.orgId,
1355
+ id: card.id,
1356
+ source: externalSourceForDecision(decision),
1357
+ metadata: decision.metadata ?? null,
1358
+ expectedRevision: card.revision
1359
+ });
1360
+ if (!result) return false;
1361
+ attached = {
1362
+ card: result.item,
1363
+ phase: admitted.phase
1364
+ };
1365
+ } catch (error) {
1366
+ if (error instanceof WorkItemSourceConflictError) return false;
1367
+ if (error instanceof WorkItemUpdateConflictError) continue;
1368
+ throw error;
1369
+ }
1370
+ }
1371
+ if (!attached) return false;
1372
+ const { card, phase } = attached;
1373
+ const stage = card.stages.length === 1 ? card.stages[0] : void 0;
1374
+ const board = boards.get(boardForWorkItem(card));
1375
+ if (!phase || !stage || stage === phase) return true;
1376
+ if (!board?.allowsTransition(stage, phase)) {
1377
+ console.warn(`[factory] attached a pull request to ${card.id}, which stays in ${stage}: its board has no move to ${phase}`);
1378
+ return true;
1379
+ }
1380
+ const moved = await this.#transitionService.transition({
1381
+ orgId: record.orgId,
1382
+ factoryProjectId: record.factoryProjectId,
1383
+ workItemId: card.id,
1384
+ board: board.id,
1385
+ stage: phase,
1386
+ expectedRevision: card.revision,
1387
+ actor: {
1388
+ type: "system",
1389
+ id: "factory-rule-dispatcher"
1390
+ },
1391
+ ingress: {
1392
+ type: "rule",
1393
+ identity: `decision:${record.idempotencyKey}:${card.id}:attach`
1394
+ },
1395
+ cause: "linked_item_attached",
1396
+ causalChain
1397
+ });
1398
+ if (moved.status === "rejected") console.warn(`[factory] attached a pull request to ${card.id} but could not move it to ${phase}: ${moved.code}: ${moved.reason}`);
1399
+ return true;
1400
+ }
1401
+ /**
1402
+ * Joins a pull or merge request to the card of the issue it closes when the project's intake
1403
+ * routes say so: the first route matching the arrival, with the facts of that card as it is now,
1404
+ * is a joining one. Only an arrival the routes would place qualifies, and only from an author
1405
+ * with write access: no route can put an outsider's pull request on someone else's card.
1406
+ */
1407
+ async #joinClosedIssue(record, decision, causalChain) {
1408
+ if (!authorTrusted(decision.metadata) || !this.#intakeRoutes || decision.skipRules === true) return false;
1409
+ if (record.workItemId !== null) return false;
1410
+ const boards = await this.#boards.load(record);
1171
1411
  const routes = await this.#intakeRoutes.listIntakeRoutes({
1172
1412
  orgId: record.orgId,
1173
1413
  factoryProjectId: record.factoryProjectId
1174
1414
  });
1175
- if (routes.length === 0) return decision;
1176
- const facts = cardRuleFacts({
1415
+ if (routes.length === 0) return false;
1416
+ const arrival = cardRuleFacts({
1177
1417
  title: decision.title,
1178
1418
  metadata: decision.metadata ?? {},
1179
1419
  externalSource: externalSourceForDecision(decision)
1180
1420
  });
1421
+ return this.#attachLinkedItem(record, decision, decision.closesIssue.workItemId, causalChain, (card) => {
1422
+ const route = resolveIntakeRoute(routes, {
1423
+ ...arrival,
1424
+ ...closedIssueRuleFacts(card)
1425
+ }, boards, card);
1426
+ return route?.type === "join" ? { phase: route.phase } : void 0;
1427
+ });
1428
+ }
1429
+ /**
1430
+ * Places an arrival where the project's intake routes say: the first enabled route matching it,
1431
+ * else the default board's first phase. The board and phase an integration's rule named don't
1432
+ * count; only a decision placing the card outright (`skipRules`) keeps its own.
1433
+ */
1434
+ async #routeArrival(record, decision, boards) {
1435
+ if (!this.#intakeRoutes || decision.skipRules === true) return decision;
1436
+ if (record.workItemId !== null) return decision;
1437
+ const routes = await this.#intakeRoutes.listIntakeRoutes({
1438
+ orgId: record.orgId,
1439
+ factoryProjectId: record.factoryProjectId
1440
+ });
1441
+ const closedIssue = decision.closesIssue ? await this.#storage.get({
1442
+ orgId: record.orgId,
1443
+ id: decision.closesIssue.workItemId
1444
+ }) : null;
1445
+ const facts = {
1446
+ ...cardRuleFacts({
1447
+ title: decision.title,
1448
+ metadata: decision.metadata ?? {},
1449
+ externalSource: externalSourceForDecision(decision)
1450
+ }),
1451
+ ...decision.closesIssue ? closedIssueRuleFacts(closedIssue && closedIssue.factoryProjectId === record.factoryProjectId && !isTerminalWorkItem(boards, closedIssue) ? closedIssue : void 0) : {}
1452
+ };
1181
1453
  const placement = resolveIntakePlacement(routes, facts, boards);
1182
- if (!placement) return decision;
1454
+ if (!placement) {
1455
+ const fallback = intakeTarget(boards);
1456
+ return fallback ? {
1457
+ ...decision,
1458
+ board: fallback.board,
1459
+ stage: fallback.initialPhase
1460
+ } : decision;
1461
+ }
1183
1462
  return {
1184
1463
  ...decision,
1185
1464
  board: placement.board,
@@ -1192,7 +1471,7 @@ var FactoryDecisionDispatcher = class {
1192
1471
  }
1193
1472
  /**
1194
1473
  * A card an intake route placed stays on the route's board when its source is filed again
1195
- * (a reconcile replaying "opened" with today's label route or binding): the decision lands
1474
+ * (a reconcile replaying "opened"): the decision lands
1196
1475
  * on the card's board at its first phase, so it only backfills facts and moves nothing.
1197
1476
  * An explicit placement (`skipRules`) still wins.
1198
1477
  */
@@ -1318,7 +1597,7 @@ var FactoryDecisionDispatcher = class {
1318
1597
  if (!board) return void 0;
1319
1598
  const stage = item.stages.length === 1 ? item.stages[0] : void 0;
1320
1599
  const finished = stage !== void 0 && board.isTerminal(stage);
1321
- if (event.type === "work_item.closed" ? finished : !finished) return void 0;
1600
+ if (!eventMovesCard(event.type, finished)) return void 0;
1322
1601
  const routes = this.#intakeRoutes ? await this.#intakeRoutes.listIntakeRoutes({
1323
1602
  orgId: record.orgId,
1324
1603
  factoryProjectId: record.factoryProjectId
@@ -1328,8 +1607,18 @@ var FactoryDecisionDispatcher = class {
1328
1607
  board,
1329
1608
  fallback: true
1330
1609
  };
1331
- const route = resolveEventRoute(routes, event, cardRuleFacts(item), board);
1332
- if (!route || stage === route.phase) return void 0;
1610
+ const route = resolveEventRoute(routes, event, cardRuleFacts(item), board, hasPullRequest(item));
1611
+ if (!route) return fallback && isPullRequestEvent(event.type) ? {
1612
+ item,
1613
+ board,
1614
+ fallback: true
1615
+ } : void 0;
1616
+ if (fallback && isPullRequestEvent(event.type) && route.phase === fallback.stage) return {
1617
+ item,
1618
+ board,
1619
+ fallback: true
1620
+ };
1621
+ if (stage === route.phase) return void 0;
1333
1622
  return {
1334
1623
  item,
1335
1624
  board,
@@ -1365,10 +1654,7 @@ var FactoryDecisionDispatcher = class {
1365
1654
  },
1366
1655
  cause: "event_route",
1367
1656
  causalChain,
1368
- eventRoute: {
1369
- routeId: route.routeId,
1370
- allowWorkingPhase: route.allowWorkingPhase
1371
- }
1657
+ eventRoute: { routeId: route.routeId }
1372
1658
  });
1373
1659
  if (result.status === "rejected" && result.code === "stale") throw new Error(`${result.code}: ${result.reason}`);
1374
1660
  }
@@ -1378,7 +1664,7 @@ var FactoryDecisionDispatcher = class {
1378
1664
  * millisecond, the one with the greatest id is the last; one already settled had its turn.
1379
1665
  */
1380
1666
  async #statusEventOvertaken(record) {
1381
- if (!record.workItemId) return false;
1667
+ if (!record.workItemId || !isStatusEventDecision(record.decision)) return false;
1382
1668
  return (await this.#storage.listDeferredDecisions(record.orgId, record.factoryProjectId, { workItemId: record.workItemId })).some((other) => other.id !== record.id && isStatusEventDecision(other.decision) && (other.createdAt.getTime() > record.createdAt.getTime() || other.createdAt.getTime() === record.createdAt.getTime() && other.completedAt === null && other.id > record.id));
1383
1669
  }
1384
1670
  async #requireItem(record) {
@@ -1392,9 +1678,18 @@ var FactoryDecisionDispatcher = class {
1392
1678
  }
1393
1679
  async #findBinding(record, role) {
1394
1680
  if (!record.workItemId) throw new Error("Factory decision is not linked to a work item.");
1395
- return (await this.#storage.listRunBindings(record.orgId, record.factoryProjectId, record.workItemId)).filter((candidate) => candidate.status === "active" && (role === void 0 || candidate.role === role)).sort((left, right) => {
1396
- if (role === void 0 && left.role === "work" && right.role !== "work") return -1;
1397
- if (role === void 0 && right.role === "work" && left.role !== "work") return 1;
1681
+ const active = (await this.#storage.listRunBindings(record.orgId, record.factoryProjectId, record.workItemId)).filter((candidate) => candidate.status === "active" && (role === void 0 || candidate.role === role));
1682
+ let builder;
1683
+ if (role === void 0 && active.length > 1) {
1684
+ const item = await this.#storage.get({
1685
+ orgId: record.orgId,
1686
+ id: record.workItemId
1687
+ });
1688
+ builder = item ? cardBoardFlow(await this.#boards.load(record), item).buildRole : void 0;
1689
+ }
1690
+ return active.sort((left, right) => {
1691
+ if (builder !== void 0 && left.role === builder && right.role !== builder) return -1;
1692
+ if (builder !== void 0 && right.role === builder && left.role !== builder) return 1;
1398
1693
  return right.createdAt.getTime() - left.createdAt.getTime() || left.id.localeCompare(right.id);
1399
1694
  })[0];
1400
1695
  }
@@ -1760,8 +2055,7 @@ const FACTORY_DISPATCH_CONSTANTS = {
1760
2055
  runRegistryHeartbeatMs: RUN_REGISTRY_HEARTBEAT_MS,
1761
2056
  openRunStaleMs: FACTORY_OPEN_RUN_STALE_MS,
1762
2057
  maxInFlight: MAX_IN_FLIGHT,
1763
- reviewStatusTimeoutMs: REVIEW_STATUS_TIMEOUT_MS,
1764
- stages: FACTORY_RULE_STAGES
2058
+ reviewStatusTimeoutMs: REVIEW_STATUS_TIMEOUT_MS
1765
2059
  };
1766
2060
  export { FACTORY_DISPATCH_CONSTANTS, FactoryDecisionDispatcher };
1767
2061