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

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 (399) hide show
  1. package/README.md +244 -123
  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 +1 -1
  11. package/dist/boards/card-facts.d.ts.map +1 -1
  12. package/dist/boards/card-facts.js +4 -0
  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 +39 -17
  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 +27 -5
  26. package/dist/boards/intake-routing.d.ts.map +1 -1
  27. package/dist/boards/intake-routing.js +69 -16
  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 +9 -6
  41. package/dist/boards/project-boards.d.ts.map +1 -1
  42. package/dist/boards/project-boards.js +56 -18
  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 +256 -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 +19 -0
  64. package/dist/boards/work-migrations.d.ts.map +1 -0
  65. package/dist/boards/work-migrations.js +257 -0
  66. package/dist/boards/work-migrations.js.map +1 -0
  67. package/dist/boards/work-routes.d.ts +53 -0
  68. package/dist/boards/work-routes.d.ts.map +1 -0
  69. package/dist/boards/work-routes.js +256 -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 +3 -3
  76. package/dist/factory.d.ts.map +1 -1
  77. package/dist/factory.js +58 -30
  78. package/dist/factory.js.map +1 -1
  79. package/dist/index.d.ts +2 -2
  80. package/dist/index.d.ts.map +1 -1
  81. package/dist/index.js +2 -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 -71
  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 +13 -2
  104. package/dist/integrations/github/rules.d.ts.map +1 -1
  105. package/dist/integrations/github/rules.js +202 -34
  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/rules.d.ts +6 -1
  124. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  125. package/dist/integrations/gitlab/rules.js +116 -23
  126. package/dist/integrations/gitlab/rules.js.map +1 -1
  127. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  128. package/dist/integrations/incidentio/agent-tools.js +1 -1
  129. package/dist/integrations/incidentio/default-rules.js +3 -3
  130. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  131. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  132. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  133. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  134. package/dist/integrations/incidentio/rules.d.ts +3 -1
  135. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  136. package/dist/integrations/incidentio/rules.js +14 -11
  137. package/dist/integrations/incidentio/rules.js.map +1 -1
  138. package/dist/integrations/jira/agent-tools.js +1 -1
  139. package/dist/integrations/jira/default-rules.js +3 -3
  140. package/dist/integrations/jira/default-rules.js.map +1 -1
  141. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  142. package/dist/integrations/jira/issue-reconciler.js +2 -1
  143. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  144. package/dist/integrations/jira/rules.d.ts +3 -1
  145. package/dist/integrations/jira/rules.d.ts.map +1 -1
  146. package/dist/integrations/jira/rules.js +14 -11
  147. package/dist/integrations/jira/rules.js.map +1 -1
  148. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  149. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  150. package/dist/integrations/linear/agent-tools.js +80 -2
  151. package/dist/integrations/linear/agent-tools.js.map +1 -1
  152. package/dist/integrations/linear/default-rules.js +3 -3
  153. package/dist/integrations/linear/default-rules.js.map +1 -1
  154. package/dist/integrations/linear/integration.d.ts +4 -1
  155. package/dist/integrations/linear/integration.d.ts.map +1 -1
  156. package/dist/integrations/linear/integration.js +21 -1
  157. package/dist/integrations/linear/integration.js.map +1 -1
  158. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  159. package/dist/integrations/linear/issue-reconciler.js +2 -1
  160. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  161. package/dist/integrations/linear/routes.d.ts +2 -1
  162. package/dist/integrations/linear/routes.d.ts.map +1 -1
  163. package/dist/integrations/linear/routes.js +4 -3
  164. package/dist/integrations/linear/routes.js.map +1 -1
  165. package/dist/integrations/linear/rules.d.ts +3 -1
  166. package/dist/integrations/linear/rules.d.ts.map +1 -1
  167. package/dist/integrations/linear/rules.js +15 -12
  168. package/dist/integrations/linear/rules.js.map +1 -1
  169. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  170. package/dist/integrations/platform/github/integration.js +33 -21
  171. package/dist/integrations/platform/github/integration.js.map +1 -1
  172. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  173. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  174. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  175. package/dist/integrations/platform/linear/integration.js +6 -5
  176. package/dist/integrations/platform/linear/integration.js.map +1 -1
  177. package/dist/integrations/slack/chat-tools.js +1 -1
  178. package/dist/integrations/slack/reply-tool.js +1 -1
  179. package/dist/integrations/slack/share-file-tool.js +1 -1
  180. package/dist/integrations/slack/slack.d.ts +10 -4
  181. package/dist/integrations/slack/slack.d.ts.map +1 -1
  182. package/dist/integrations/slack/slack.js +19 -9
  183. package/dist/integrations/slack/slack.js.map +1 -1
  184. package/dist/links.d.ts.map +1 -1
  185. package/dist/links.js +3 -2
  186. package/dist/links.js.map +1 -1
  187. package/dist/mcp/routes.js +2 -2
  188. package/dist/routes/attention-parked.d.ts +1 -0
  189. package/dist/routes/attention-parked.d.ts.map +1 -1
  190. package/dist/routes/attention-parked.js +1 -1
  191. package/dist/routes/attention-parked.js.map +1 -1
  192. package/dist/routes/automation-runs.d.ts +4 -0
  193. package/dist/routes/automation-runs.d.ts.map +1 -1
  194. package/dist/routes/automation-runs.js +15 -0
  195. package/dist/routes/automation-runs.js.map +1 -1
  196. package/dist/routes/boards.d.ts +1 -1
  197. package/dist/routes/boards.d.ts.map +1 -1
  198. package/dist/routes/boards.js +1 -17
  199. package/dist/routes/boards.js.map +1 -1
  200. package/dist/routes/config.d.ts +4 -0
  201. package/dist/routes/config.d.ts.map +1 -1
  202. package/dist/routes/config.js +15 -0
  203. package/dist/routes/config.js.map +1 -1
  204. package/dist/routes/contracts.d.ts +125 -14
  205. package/dist/routes/contracts.d.ts.map +1 -1
  206. package/dist/routes/contracts.js +34 -15
  207. package/dist/routes/contracts.js.map +1 -1
  208. package/dist/routes/fs.d.ts +4 -0
  209. package/dist/routes/fs.d.ts.map +1 -1
  210. package/dist/routes/fs.js +8 -4
  211. package/dist/routes/fs.js.map +1 -1
  212. package/dist/routes/intake-routes.d.ts.map +1 -1
  213. package/dist/routes/intake-routes.js.map +1 -1
  214. package/dist/routes/intake.d.ts.map +1 -1
  215. package/dist/routes/intake.js +1 -0
  216. package/dist/routes/intake.js.map +1 -1
  217. package/dist/routes/projects.d.ts.map +1 -1
  218. package/dist/routes/projects.js +8 -2
  219. package/dist/routes/projects.js.map +1 -1
  220. package/dist/routes/provider-credentials.d.ts.map +1 -1
  221. package/dist/routes/provider-credentials.js +10 -5
  222. package/dist/routes/provider-credentials.js.map +1 -1
  223. package/dist/routes/running-packages.d.ts +13 -0
  224. package/dist/routes/running-packages.d.ts.map +1 -0
  225. package/dist/routes/running-packages.js +45 -0
  226. package/dist/routes/running-packages.js.map +1 -0
  227. package/dist/routes/surface.d.ts +10 -1
  228. package/dist/routes/surface.d.ts.map +1 -1
  229. package/dist/routes/surface.js +104 -35
  230. package/dist/routes/surface.js.map +1 -1
  231. package/dist/routes/work-items.d.ts.map +1 -1
  232. package/dist/routes/work-items.js +23 -3
  233. package/dist/routes/work-items.js.map +1 -1
  234. package/dist/rules/binding-context.d.ts.map +1 -1
  235. package/dist/rules/binding-context.js +1 -0
  236. package/dist/rules/binding-context.js.map +1 -1
  237. package/dist/rules/dispatcher.d.ts +0 -1
  238. package/dist/rules/dispatcher.d.ts.map +1 -1
  239. package/dist/rules/dispatcher.js +340 -42
  240. package/dist/rules/dispatcher.js.map +1 -1
  241. package/dist/rules/event-rules.d.ts +33 -2
  242. package/dist/rules/event-rules.d.ts.map +1 -1
  243. package/dist/rules/event-rules.js +46 -11
  244. package/dist/rules/event-rules.js.map +1 -1
  245. package/dist/rules/index.d.ts +2 -4
  246. package/dist/rules/index.d.ts.map +1 -1
  247. package/dist/rules/index.js +2 -3
  248. package/dist/rules/phase-goal.d.ts +54 -0
  249. package/dist/rules/phase-goal.d.ts.map +1 -0
  250. package/dist/rules/phase-goal.js +70 -0
  251. package/dist/rules/phase-goal.js.map +1 -0
  252. package/dist/rules/phase-tools.d.ts +11 -0
  253. package/dist/rules/phase-tools.d.ts.map +1 -0
  254. package/dist/rules/phase-tools.js +19 -0
  255. package/dist/rules/phase-tools.js.map +1 -0
  256. package/dist/rules/processor.d.ts.map +1 -1
  257. package/dist/rules/processor.js +112 -11
  258. package/dist/rules/processor.js.map +1 -1
  259. package/dist/rules/review-source-tool.d.ts +4 -1
  260. package/dist/rules/review-source-tool.d.ts.map +1 -1
  261. package/dist/rules/review-source-tool.js +24 -4
  262. package/dist/rules/review-source-tool.js.map +1 -1
  263. package/dist/rules/rule-group.d.ts +1 -1
  264. package/dist/rules/rule-group.d.ts.map +1 -1
  265. package/dist/rules/rule-group.js +2 -1
  266. package/dist/rules/rule-group.js.map +1 -1
  267. package/dist/rules/start-coordinator.d.ts +5 -1
  268. package/dist/rules/start-coordinator.d.ts.map +1 -1
  269. package/dist/rules/start-coordinator.js +9 -3
  270. package/dist/rules/start-coordinator.js.map +1 -1
  271. package/dist/rules/tools.d.ts.map +1 -1
  272. package/dist/rules/tools.js +39 -28
  273. package/dist/rules/tools.js.map +1 -1
  274. package/dist/rules/transition-service.d.ts +2 -7
  275. package/dist/rules/transition-service.d.ts.map +1 -1
  276. package/dist/rules/transition-service.js +61 -54
  277. package/dist/rules/transition-service.js.map +1 -1
  278. package/dist/rules/types.d.ts +83 -29
  279. package/dist/rules/types.d.ts.map +1 -1
  280. package/dist/rules/types.js +5 -41
  281. package/dist/rules/types.js.map +1 -1
  282. package/dist/rules/validation.d.ts.map +1 -1
  283. package/dist/rules/validation.js +32 -2
  284. package/dist/rules/validation.js.map +1 -1
  285. package/dist/secret-encryption.d.ts +21 -0
  286. package/dist/secret-encryption.d.ts.map +1 -1
  287. package/dist/secret-encryption.js +31 -4
  288. package/dist/secret-encryption.js.map +1 -1
  289. package/dist/session/self-review-gate.d.ts +6 -2
  290. package/dist/session/self-review-gate.d.ts.map +1 -1
  291. package/dist/session/self-review-gate.js +8 -4
  292. package/dist/session/self-review-gate.js.map +1 -1
  293. package/dist/session/session-threads.d.ts +2 -3
  294. package/dist/session/session-threads.d.ts.map +1 -1
  295. package/dist/session/session-threads.js.map +1 -1
  296. package/dist/session/source-control-tools.js +1 -1
  297. package/dist/session/work-item-state-processor.d.ts +27 -0
  298. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  299. package/dist/session/work-item-state-processor.js +288 -0
  300. package/dist/session/work-item-state-processor.js.map +1 -0
  301. package/dist/storage/domains/boards/base.d.ts +44 -27
  302. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  303. package/dist/storage/domains/boards/base.js +76 -121
  304. package/dist/storage/domains/boards/base.js.map +1 -1
  305. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  306. package/dist/storage/domains/boards/schemas.js +12 -0
  307. package/dist/storage/domains/boards/schemas.js.map +1 -1
  308. package/dist/storage/domains/work-items/base.d.ts +32 -2
  309. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  310. package/dist/storage/domains/work-items/base.js +109 -26
  311. package/dist/storage/domains/work-items/base.js.map +1 -1
  312. package/dist/storage/domains/work-items/cards.d.ts +24 -2
  313. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  314. package/dist/storage/domains/work-items/cards.js +118 -8
  315. package/dist/storage/domains/work-items/cards.js.map +1 -1
  316. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  317. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  318. package/dist/storage/domains/work-items/legacy-review.js +95 -0
  319. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  320. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  321. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  322. package/dist/storage/domains/work-items/metrics.js +14 -32
  323. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  324. package/dist/storage/domains/work-items/work-item-schema.d.ts +2 -0
  325. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  326. package/dist/storage/domains/work-items/work-item-schema.js +5 -0
  327. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  328. package/dist/tools/approval-tools.d.ts.map +1 -1
  329. package/dist/tools/approval-tools.js +28 -9
  330. package/dist/tools/approval-tools.js.map +1 -1
  331. package/dist/tools/index.d.ts +1 -1
  332. package/dist/tools/index.js +1 -1
  333. package/dist/tools/index.js.map +1 -1
  334. package/dist/tools/messaging-tools.d.ts +3 -0
  335. package/dist/tools/messaging-tools.d.ts.map +1 -1
  336. package/dist/tools/messaging-tools.js +2 -1
  337. package/dist/tools/messaging-tools.js.map +1 -1
  338. package/dist/tools/read-tools.d.ts +8 -2
  339. package/dist/tools/read-tools.d.ts.map +1 -1
  340. package/dist/tools/read-tools.js +83 -23
  341. package/dist/tools/read-tools.js.map +1 -1
  342. package/dist/tools/reports.d.ts +1 -0
  343. package/dist/tools/reports.d.ts.map +1 -1
  344. package/dist/tools/reports.js +2 -1
  345. package/dist/tools/reports.js.map +1 -1
  346. package/dist/tools/run-watch.d.ts +1 -1
  347. package/dist/tools/run-watch.d.ts.map +1 -1
  348. package/dist/tools/run-watch.js +1 -0
  349. package/dist/tools/run-watch.js.map +1 -1
  350. package/dist/tools/sandbox-tools.js +1 -1
  351. package/dist/tools/session-tools.js +1 -1
  352. package/dist/tools/sessions-state-processor.d.ts +2 -0
  353. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  354. package/dist/tools/sessions-state-processor.js +4 -2
  355. package/dist/tools/sessions-state-processor.js.map +1 -1
  356. package/dist/tools/side-sessions.d.ts +2 -0
  357. package/dist/tools/side-sessions.d.ts.map +1 -1
  358. package/dist/tools/side-sessions.js +2 -1
  359. package/dist/tools/side-sessions.js.map +1 -1
  360. package/dist/tools/work-item-tools.js +3 -3
  361. package/dist/tools/work-item-tools.js.map +1 -1
  362. package/dist/work-item-branch.d.ts +13 -0
  363. package/dist/work-item-branch.d.ts.map +1 -1
  364. package/dist/work-item-branch.js +16 -1
  365. package/dist/work-item-branch.js.map +1 -1
  366. package/dist/work-items/create-work-item.d.ts +6 -0
  367. package/dist/work-items/create-work-item.d.ts.map +1 -1
  368. package/dist/work-items/create-work-item.js +25 -1
  369. package/dist/work-items/create-work-item.js.map +1 -1
  370. package/dist/work-items/split-migration.d.ts.map +1 -1
  371. package/dist/work-items/split-migration.js +1 -0
  372. package/dist/work-items/split-migration.js.map +1 -1
  373. package/dist/workspace.d.ts.map +1 -1
  374. package/dist/workspace.js +53 -10
  375. package/dist/workspace.js.map +1 -1
  376. package/factory-skills/configure-factory-rules/SKILL.md +11 -9
  377. package/factory-skills/factory-build/SKILL.md +64 -0
  378. package/factory-skills/factory-gitlab-rereview/SKILL.md +1 -1
  379. package/factory-skills/factory-gitlab-review/SKILL.md +2 -2
  380. package/factory-skills/factory-plan/SKILL.md +8 -10
  381. package/factory-skills/factory-rereview/SKILL.md +3 -3
  382. package/factory-skills/factory-review/SKILL.md +14 -4
  383. package/factory-skills/factory-self-review/SKILL.md +31 -11
  384. package/factory-skills/factory-triage/SKILL.md +25 -10
  385. package/package.json +9 -9
  386. package/dist/boards/index.js.map +0 -1
  387. package/dist/boards/pull-request-review.d.ts +0 -14
  388. package/dist/boards/pull-request-review.d.ts.map +0 -1
  389. package/dist/boards/pull-request-review.js +0 -81
  390. package/dist/boards/pull-request-review.js.map +0 -1
  391. package/dist/boards/work-tool-rules.d.ts +0 -8
  392. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  393. package/dist/boards/work-tool-rules.js +0 -19
  394. package/dist/boards/work-tool-rules.js.map +0 -1
  395. package/dist/rules/resolve.d.ts +0 -15
  396. package/dist/rules/resolve.d.ts.map +0 -1
  397. package/dist/rules/resolve.js +0 -22
  398. package/dist/rules/resolve.js.map +0 -1
  399. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -1,7 +1,9 @@
1
- import type { FactoryRuleBoardClosure, FactoryRulePhaseContext } from '../rules/types.js';
1
+ import type { FactoryRuleBoardClosure, FactoryRuleBoardFlow, FactoryRuleIntakeTarget, FactoryRulePhaseContext } from '../rules/types.js';
2
2
  import type { Card } from '../storage/domains/work-items/base.js';
3
+ import type { MetricsPhaseOutcomes } from '../storage/domains/work-items/metrics.js';
4
+ import type { WorkItemSourceRow } from '../storage/domains/work-items/work-item-schema.js';
3
5
  import type { BoardEventIntegration, BoardEventRules, BoardPhaseKind, BoardToolResultRuleHandler } from './define-board.js';
4
- import type { BoardRegistry } from './registry.js';
6
+ import type { BoardRegistry, InstalledBoard } from './registry.js';
5
7
  export interface PhaseSemantics {
6
8
  readonly kind: BoardPhaseKind;
7
9
  /** Seat that carries a working phase; absent for resting and terminal phases. */
@@ -9,30 +11,154 @@ export interface PhaseSemantics {
9
11
  }
10
12
  /**
11
13
  * Board that owns a work item. Rows created before boards were persisted carry no `board`;
12
- * they belong to Review when they track a pull request and to Work otherwise, matching the
13
- * legacy assignment the transition service performs on their next move.
14
+ * they belong to the default board. (Pull requests used to default to the retired Review board;
15
+ * storage reads those rows as the default board, and keeps cards stored on Review there only in a
16
+ * project that still uses it.)
14
17
  */
15
- export declare function boardForWorkItem(item: Pick<Card, 'board' | 'externalSource'>): string;
18
+ export declare function boardForWorkItem(item: Pick<Card, 'board'>): string;
16
19
  /**
17
- * A card that tracks a pull or merge request itself, as opposed to the card whose work opened it.
18
- * Both can sit on Work, so rules tell them apart by source rather than by board.
20
+ * The phases a board's pull request loop runs through, read from what each phase declares
21
+ * rather than from its key:
22
+ *
23
+ * Only phases running in the {@link REVIEW_CONTEXT} seat count as reviews: it is the only seat
24
+ * that records verdicts.
25
+ *
26
+ * - `pullRequestReview`: the first phase that grants `factory_review_source`. It takes pull
27
+ * requests: a pull request's own card is reviewed there, an attached pull request is reviewed
28
+ * there, verdicts on pull requests are recorded there, and a push or review request re-enters it.
29
+ * - `selfReview`: the first working phase that grants `factory_record_review_verdict` without
30
+ * `factory_review_source`: an independent review of the builder's branch before a pull request.
31
+ * - `triage`: on a board with a `build` phase, the first working phase that neither builds (runs
32
+ * in `buildRole`) nor reviews: it sorts new cards before anyone accepts them. A board that
33
+ * builds nothing has no triage phase.
34
+ * - `build`: the last working phase, in declaration order, that is neither of those and can move
35
+ * into the review that follows it (`selfReview`, else `pullRequestReview`). Self-review sends
36
+ * requested changes back here, and its seat (`buildRole`) is woken by pull request feedback.
37
+ *
38
+ * A board without a `factory_review_source` phase has no pull request loop.
39
+ */
40
+ export declare function boardFlow(board: InstalledBoard | undefined): FactoryRuleBoardFlow;
41
+ /**
42
+ * Where new items land on `board`, else on the project's default board when `board` is not
43
+ * installed. Undefined when neither is.
44
+ */
45
+ export declare function intakeTarget(boards: Pick<BoardRegistry, 'get'>, board?: InstalledBoard): FactoryRuleIntakeTarget | undefined;
46
+ /** {@link intakeTarget} as a rule context field. */
47
+ export declare function withIntakeTarget(boards: Pick<BoardRegistry, 'get'>, board?: InstalledBoard): {
48
+ intake?: FactoryRuleIntakeTarget;
49
+ };
50
+ /** {@link boardFlow} of the board a card sits on. */
51
+ export declare function cardBoardFlow(boards: Pick<BoardRegistry, 'get'>, item: Pick<Card, 'board'> | undefined): FactoryRuleBoardFlow;
52
+ /**
53
+ * Whether a card in `stage` is still waiting for someone to accept it: it rests, or it is being
54
+ * triaged. Approval labels hold only such cards.
55
+ */
56
+ export declare function awaitsAcceptance(board: InstalledBoard | undefined, stage: string): boolean;
57
+ /** Whether `stage` is the phase where the board reviews pull requests. */
58
+ export declare function isPullRequestReviewPhase(board: InstalledBoard | undefined, stage: string | undefined): boolean;
59
+ /**
60
+ * Why a move breaks the shape of a card on a board with a pull request loop, or undefined when it
61
+ * does not: a pull request's own card is only reviewed, so it enters no other working phase, and
62
+ * the pull request review phase holds only cards that carry a pull request (their own, or one
63
+ * attached to their issue). `nextPhases` cannot say this: a resting phase may lead to both, and
64
+ * which one fits depends on the card.
65
+ */
66
+ export declare function pullRequestCardRejection(board: InstalledBoard, card: {
67
+ readonly standalonePullRequest: boolean;
68
+ readonly hasPullRequest: boolean;
69
+ }, toStage: string): string | undefined;
70
+ /** `{ flow }` for spreading into an integration rule context, or `{}` for an unbound evaluation. */
71
+ export declare function withBoardFlow(boards: Pick<BoardRegistry, 'get'>, item: Pick<Card, 'board'> | undefined): {
72
+ flow?: FactoryRuleBoardFlow;
73
+ };
74
+ interface SourcedItem {
75
+ readonly workItem?: {
76
+ readonly sources?: readonly WorkItemSourceRow[];
77
+ } | null;
78
+ }
79
+ /**
80
+ * A card whose own primary source is a pull or merge request: an outside contributor's
81
+ * PR filed on its own card, or a PR card filed before PRs attached to their issue's card.
82
+ * An issue card with an attached PR is not one; see {@link hasPullRequest}.
19
83
  */
20
84
  export declare function isPullRequestCard(item: {
21
85
  readonly source: string;
22
86
  }): boolean;
23
- /** Whether the rule's card is the change request's own card, which the reviewer reviews. */
87
+ /** Every pull or merge request source on a card, oldest first. */
88
+ export declare function pullRequestSources(item: SourcedItem): WorkItemSourceRow[];
89
+ /** Whether a card carries a pull or merge request: its own, or one attached to its issue. */
90
+ export declare function hasPullRequest(item: SourcedItem & {
91
+ readonly source?: string;
92
+ }): boolean;
93
+ /** A source row's external id without the type/workspace scope storage prefixes it with. */
94
+ export declare function sourceExternalId(source: Pick<WorkItemSourceRow, 'sourceType' | 'workspaceId' | 'externalId'>): string;
95
+ /** The provider number (GitHub PR number, GitLab MR IID) a pull request source names. */
96
+ export declare function pullRequestSourceNumber(source: Pick<WorkItemSourceRow, 'metadata'>): number | undefined;
97
+ /**
98
+ * The pull request a PR review pass on this card reviews: the one the card's
99
+ * `openPullRequestNumber` names, else the newest open one, else the newest one.
100
+ */
101
+ export declare function reviewedPullRequest(item: SourcedItem & {
102
+ readonly metadata?: Record<string, unknown> | null;
103
+ }): WorkItemSourceRow | undefined;
104
+ /** The newest still-open pull request on a card other than `except`, for re-pointing `openPullRequestNumber`. */
105
+ export declare function newestOpenPullRequestNumber(item: SourcedItem, except?: number): number | null;
106
+ interface SessionedItem {
107
+ readonly sessions: Readonly<Record<string, {
108
+ readonly branch?: string | null;
109
+ } | undefined>>;
110
+ }
111
+ type BranchedItem = Pick<Card, 'id' | 'externalSource'> & {
112
+ readonly workItem: Pick<Card['workItem'], 'metadata'>;
113
+ };
114
+ /**
115
+ * Whether a pull request from `headBranch` was opened by the card's own sessions: the head is
116
+ * one of its session branches, or the branch Factory builds the card on (stable even after its
117
+ * session is deleted).
118
+ */
119
+ export declare function cardOwnsBranch(item: SessionedItem & BranchedItem, headBranch: string | undefined): boolean;
120
+ /** The newest open pull request the card's own sessions opened, other than `except`. */
121
+ export declare function newestOwnedOpenPullRequestNumber(item: SourcedItem & SessionedItem & BranchedItem, except?: number): number | null;
122
+ /** The pull or merge request a card's PR review covers, whichever card shape carries it. */
123
+ export interface ReviewedChangeRequest {
124
+ readonly provider: 'github' | 'gitlab';
125
+ readonly number: number | undefined;
126
+ readonly url: string | null;
127
+ readonly headBranch: string | undefined;
128
+ /** The card is the change request's own card rather than an issue card it is attached to. */
129
+ readonly standalone: boolean;
130
+ }
131
+ /**
132
+ * What a PR review on this card reviews: the card's own change request when the card is one,
133
+ * otherwise the attached one {@link reviewedPullRequest} picks. Undefined for a card with none.
134
+ */
135
+ export declare function reviewedChangeRequest(item: {
136
+ readonly source: string;
137
+ readonly url?: string | null;
138
+ readonly metadata?: Record<string, unknown> | null;
139
+ readonly workItem: {
140
+ readonly url?: string | null;
141
+ readonly metadata?: Record<string, unknown> | null;
142
+ readonly sources?: readonly WorkItemSourceRow[];
143
+ };
144
+ }): ReviewedChangeRequest | undefined;
145
+ /**
146
+ * Whether a pass already recorded a verdict on `change`. An issue card can carry
147
+ * several pull requests, so a verdict stamped for another one doesn't count; a
148
+ * verdict with no number (a standalone card, or one stamped before verdicts named
149
+ * their pull request) covers the card.
150
+ */
151
+ export declare function hasRecordedVerdict(item: Parameters<typeof reviewedChangeRequest>[0], change?: Pick<ReviewedChangeRequest, 'number'> | undefined): boolean;
152
+ /**
153
+ * Whether the rule's card carries a change request its board reviews: the card has one, and its
154
+ * board has a phase that takes pull requests ({@link boardFlow}).
155
+ */
24
156
  export declare function reviewsPullRequest(context: {
25
- readonly board?: string;
26
- readonly item?: {
157
+ readonly flow?: Pick<FactoryRuleBoardFlow, 'pullRequestReview'>;
158
+ readonly item?: SourcedItem & {
27
159
  readonly source: string;
28
160
  };
29
161
  }): boolean;
30
- /**
31
- * The phase a pull or merge request's own card is reviewed in: Work's `pr-review`, or Review's
32
- * `review` for cards filed on the Review board before pull requests moved to Work. Work's own
33
- * `review` phase is the builder's self-review, which a pull request card never enters.
34
- */
35
- export declare function pullRequestReviewPhase(board: string | undefined): 'review' | 'pr-review';
36
162
  /**
37
163
  * What the installed board says `phase` means. Returns undefined when the board is not
38
164
  * installed or does not declare the phase; callers must fail closed on undefined rather
@@ -63,14 +189,21 @@ export declare function eventBoardId(context: {
63
189
  /** What a card's single current phase means on its installed board, for integration rule contexts. */
64
190
  export declare function rulePhaseContext(boards: Pick<BoardRegistry, 'get'>, item: Pick<Card, 'board' | 'externalSource' | 'stages'>): FactoryRulePhaseContext | undefined;
65
191
  /**
66
- * Whether a persisted card has finished, judged by the board it sits on: the installed
67
- * board's phase kind first, then the built-in Work and Review names for rows whose board is
68
- * not installed. Unknown boards or phases are never terminal, so a card is only ever
69
- * released from ownership on the board's own say-so.
192
+ * Whether a persisted card has finished, judged by the board it sits on: the installed board's
193
+ * phase kind first, then, for rows whose board is not installed, the phase kinds of the default
194
+ * board Factory seeds or of the retired Review board. Unknown boards or phases are never terminal,
195
+ * so a card is only ever released from ownership on the board's own say-so.
70
196
  */
71
197
  export declare function isTerminalWorkItem(boards: BoardRegistry, item: Pick<Card, 'board' | 'externalSource' | 'stages'>): boolean;
72
198
  /** Semantics of the single stage a work item currently occupies; undefined for multi-stage rows. */
73
199
  export declare function workItemPhaseSemantics(boards: BoardRegistry, item: Pick<Card, 'board' | 'externalSource' | 'stages'>): PhaseSemantics | undefined;
200
+ /**
201
+ * Flow-metric outcomes of each board's phases: the phase the board closes completed sources into
202
+ * (else its first terminal phase) completes a card, other terminal phases cancel it, resting
203
+ * phases queue it, and anything else (working, or a phase the board no longer declares) is in
204
+ * flight.
205
+ */
206
+ export declare function boardPhaseOutcomes(boards: Pick<BoardRegistry, 'get'>): MetricsPhaseOutcomes;
74
207
  /**
75
208
  * Where source-closed rules send a persisted card: the `sourceClosed` mapping its installed
76
209
  * board declares, plus whether the card already sits in a terminal phase. Undefined when the
@@ -85,4 +218,10 @@ export declare function withBoardClosure(boards: BoardRegistry, item: Pick<Card,
85
218
  export declare function rulePhaseField(boards: Pick<BoardRegistry, 'get'>, item: Pick<Card, 'board' | 'externalSource' | 'stages'>): {
86
219
  readonly phase?: FactoryRulePhaseContext;
87
220
  };
221
+ /**
222
+ * The change request a review session on this card may publish checks for: the card's own one,
223
+ * or, for an issue card in its board's pull request review phase, the pull request attached to it.
224
+ */
225
+ export declare function boundChangeRequestNumber(boards: Pick<BoardRegistry, 'get'>, item: Card): string | undefined;
226
+ export {};
88
227
  //# sourceMappingURL=semantics.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../../src/boards/semantics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAClE,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,GAAG,MAAM,CAErF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE5E;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C,GAAG,OAAO,CAGV;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAExF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,SAAS,CAM5B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,0BAA0B,GAAG,SAAS,CAExC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,qBAAqB,EAChE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAClC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,CAAC,GACb,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAEhC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC,GAAG,MAAM,GAAG,SAAS,CAErB;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAClC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GACtD,uBAAuB,GAAG,SAAS,CAerC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GACtD,OAAO,CAOT;AAED,oGAAoG;AACpG,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GACtD,cAAc,GAAG,SAAS,CAI5B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GACtD,uBAAuB,GAAG,SAAS,CAUrC;AAED,oGAAoG;AACpG,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GACtD;IAAE,YAAY,CAAC,EAAE,uBAAuB,CAAA;CAAE,CAG5C;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAC5B,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAClC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GACtD;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAA;CAAE,CAG9C"}
1
+ {"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../../src/boards/semantics.ts"],"names":[],"mappings":"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"}
@@ -1,31 +1,235 @@
1
+ import { workItemBranch, workItemBranchSource } from "../work-item-branch.js";
2
+ import "./default-board.js";
3
+ import "./define-board.js";
4
+ import { reviewBoard } from "./review.js";
5
+ import { workBoard } from "./work.js";
1
6
  // src/boards/semantics.ts
2
7
  /**
3
8
  * Board that owns a work item. Rows created before boards were persisted carry no `board`;
4
- * they belong to Review when they track a pull request and to Work otherwise, matching the
5
- * legacy assignment the transition service performs on their next move.
9
+ * they belong to the default board. (Pull requests used to default to the retired Review board;
10
+ * storage reads those rows as the default board, and keeps cards stored on Review there only in a
11
+ * project that still uses it.)
6
12
  */
7
13
  function boardForWorkItem(item) {
8
- return item.board ?? (item.externalSource?.type === "pull-request" ? "review" : "work");
14
+ return item.board ?? "work";
9
15
  }
16
+ const flows = /* @__PURE__ */ new WeakMap();
10
17
  /**
11
- * A card that tracks a pull or merge request itself, as opposed to the card whose work opened it.
12
- * Both can sit on Work, so rules tell them apart by source rather than by board.
18
+ * The phases a board's pull request loop runs through, read from what each phase declares
19
+ * rather than from its key:
20
+ *
21
+ * Only phases running in the {@link REVIEW_CONTEXT} seat count as reviews: it is the only seat
22
+ * that records verdicts.
23
+ *
24
+ * - `pullRequestReview`: the first phase that grants `factory_review_source`. It takes pull
25
+ * requests: a pull request's own card is reviewed there, an attached pull request is reviewed
26
+ * there, verdicts on pull requests are recorded there, and a push or review request re-enters it.
27
+ * - `selfReview`: the first working phase that grants `factory_record_review_verdict` without
28
+ * `factory_review_source`: an independent review of the builder's branch before a pull request.
29
+ * - `triage`: on a board with a `build` phase, the first working phase that neither builds (runs
30
+ * in `buildRole`) nor reviews: it sorts new cards before anyone accepts them. A board that
31
+ * builds nothing has no triage phase.
32
+ * - `build`: the last working phase, in declaration order, that is neither of those and can move
33
+ * into the review that follows it (`selfReview`, else `pullRequestReview`). Self-review sends
34
+ * requested changes back here, and its seat (`buildRole`) is woken by pull request feedback.
35
+ *
36
+ * A board without a `factory_review_source` phase has no pull request loop.
37
+ */
38
+ function boardFlow(board) {
39
+ if (!board) return Object.freeze({});
40
+ const cached = flows.get(board);
41
+ if (cached) return cached;
42
+ const entries = Object.entries(board.phases);
43
+ const grants = (phase, tool) => phase.kind === "working" && phase.runner.context === "review" && (phase.tools ?? []).some((granted) => granted === tool);
44
+ const pullRequestReview = entries.find(([, phase]) => grants(phase, "factory_review_source"))?.[0];
45
+ const selfReview = entries.find(([key, phase]) => key !== pullRequestReview && grants(phase, "factory_record_review_verdict") && !grants(phase, "factory_review_source"))?.[0];
46
+ const handoff = selfReview ?? pullRequestReview;
47
+ const build = handoff ? entries.findLast(([key, phase]) => phase.kind === "working" && key !== pullRequestReview && key !== selfReview && board.allowsTransition(key, handoff))?.[0] : void 0;
48
+ const buildRole = build ? board.roleForPhase(build) : void 0;
49
+ const triage = build ? entries.find(([key, phase]) => phase.kind === "working" && key !== build && phase.runner.context !== "review" && phase.runner.context !== buildRole)?.[0] : void 0;
50
+ const terminals = entries.filter(([, phase]) => phase.kind === "terminal").map(([key]) => key);
51
+ const completed = board.sourceClosed?.completed ?? terminals[0];
52
+ const canceled = board.sourceClosed?.canceled ?? terminals.find((key) => key !== completed) ?? completed;
53
+ const ref = (phase) => Object.freeze({
54
+ phase,
55
+ title: board.phases[phase].name
56
+ });
57
+ const flow = Object.freeze({
58
+ initialPhase: board.initialPhase,
59
+ ...completed ? { completed: ref(completed) } : {},
60
+ ...canceled ? { canceled: ref(canceled) } : {},
61
+ ...triage ? { triage } : {},
62
+ ...pullRequestReview ? { pullRequestReview } : {},
63
+ ...selfReview ? { selfReview } : {},
64
+ ...build ? { build } : {},
65
+ ...buildRole ? { buildRole } : {}
66
+ });
67
+ flows.set(board, flow);
68
+ return flow;
69
+ }
70
+ /**
71
+ * Where new items land on `board`, else on the project's default board when `board` is not
72
+ * installed. Undefined when neither is.
73
+ */
74
+ function intakeTarget(boards, board) {
75
+ const target = board ?? boards.get("work");
76
+ if (!target) return void 0;
77
+ const { pullRequestReview } = boardFlow(target);
78
+ return Object.freeze({
79
+ board: target.id,
80
+ initialPhase: target.initialPhase,
81
+ ...pullRequestReview ? { pullRequestReview } : {}
82
+ });
83
+ }
84
+ /** {@link intakeTarget} as a rule context field. */
85
+ function withIntakeTarget(boards, board) {
86
+ const intake = intakeTarget(boards, board);
87
+ return intake ? { intake } : {};
88
+ }
89
+ /** {@link boardFlow} of the board a card sits on. */
90
+ function cardBoardFlow(boards, item) {
91
+ return item ? boardFlow(boards.get(boardForWorkItem(item))) : Object.freeze({});
92
+ }
93
+ /**
94
+ * Whether a card in `stage` is still waiting for someone to accept it: it rests, or it is being
95
+ * triaged. Approval labels hold only such cards.
96
+ */
97
+ function awaitsAcceptance(board, stage) {
98
+ if (!board) return false;
99
+ return board.phaseKind(stage) === "resting" || stage === boardFlow(board).triage;
100
+ }
101
+ /** Whether `stage` is the phase where the board reviews pull requests. */
102
+ function isPullRequestReviewPhase(board, stage) {
103
+ const phase = boardFlow(board).pullRequestReview;
104
+ return phase !== void 0 && phase === stage;
105
+ }
106
+ /**
107
+ * Why a move breaks the shape of a card on a board with a pull request loop, or undefined when it
108
+ * does not: a pull request's own card is only reviewed, so it enters no other working phase, and
109
+ * the pull request review phase holds only cards that carry a pull request (their own, or one
110
+ * attached to their issue). `nextPhases` cannot say this: a resting phase may lead to both, and
111
+ * which one fits depends on the card.
112
+ */
113
+ function pullRequestCardRejection(board, card, toStage) {
114
+ const review = boardFlow(board).pullRequestReview;
115
+ if (!review) return void 0;
116
+ const reviewName = board.phases[review]?.name ?? review;
117
+ if (!card.hasPullRequest && toStage === review) return `${reviewName} holds only cards with a pull request; this work item enters it once a pull request is attached to it.`;
118
+ if (!card.standalonePullRequest || toStage === review || !board.isWorking(toStage)) return void 0;
119
+ const exits = [review, ...Object.keys(board.phases).filter((key) => board.isTerminal(key))];
120
+ return `A pull request card is only reviewed on the ${board.name} board; it cannot enter ${toStage}. Move it to ${exits.join(", ")}.`;
121
+ }
122
+ /** `{ flow }` for spreading into an integration rule context, or `{}` for an unbound evaluation. */
123
+ function withBoardFlow(boards, item) {
124
+ return item ? { flow: cardBoardFlow(boards, item) } : {};
125
+ }
126
+ /**
127
+ * A card whose own primary source is a pull or merge request: an outside contributor's
128
+ * PR filed on its own card, or a PR card filed before PRs attached to their issue's card.
129
+ * An issue card with an attached PR is not one; see {@link hasPullRequest}.
13
130
  */
14
131
  function isPullRequestCard(item) {
15
132
  return item.source === "github-pr" || item.source === "gitlab-pr";
16
133
  }
17
- /** Whether the rule's card is the change request's own card, which the reviewer reviews. */
18
- function reviewsPullRequest(context) {
19
- if (context.board === "review") return true;
20
- return context.board === "work" && context.item !== void 0 && isPullRequestCard(context.item);
134
+ /** Every pull or merge request source on a card, oldest first. */
135
+ function pullRequestSources(item) {
136
+ return (item.workItem?.sources ?? []).filter((source) => source.sourceType === "pull-request");
137
+ }
138
+ /** Whether a card carries a pull or merge request: its own, or one attached to its issue. */
139
+ function hasPullRequest(item) {
140
+ return item.source !== void 0 && isPullRequestCard({ source: item.source }) || pullRequestSources(item).length > 0;
141
+ }
142
+ /** A source row's external id without the type/workspace scope storage prefixes it with. */
143
+ function sourceExternalId(source) {
144
+ const prefix = `${source.sourceType}:${source.workspaceId ? `${source.workspaceId}:` : ""}`;
145
+ return source.externalId.startsWith(prefix) ? source.externalId.slice(prefix.length) : source.externalId;
146
+ }
147
+ /** The provider number (GitHub PR number, GitLab MR IID) a pull request source names. */
148
+ function pullRequestSourceNumber(source) {
149
+ const metadata = source.metadata ?? {};
150
+ const value = metadata.githubPullRequestNumber ?? metadata.gitlabMergeRequestIid ?? metadata.number;
151
+ return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : void 0;
152
+ }
153
+ function openSource(source) {
154
+ const state = source.state ?? source.metadata?.state;
155
+ return state !== "closed" && state !== "merged" && source.metadata?.merged !== true;
21
156
  }
22
157
  /**
23
- * The phase a pull or merge request's own card is reviewed in: Work's `pr-review`, or Review's
24
- * `review` for cards filed on the Review board before pull requests moved to Work. Work's own
25
- * `review` phase is the builder's self-review, which a pull request card never enters.
158
+ * The pull request a PR review pass on this card reviews: the one the card's
159
+ * `openPullRequestNumber` names, else the newest open one, else the newest one.
26
160
  */
27
- function pullRequestReviewPhase(board) {
28
- return board === "review" ? "review" : "pr-review";
161
+ function reviewedPullRequest(item) {
162
+ const sources = pullRequestSources(item);
163
+ const pointer = item.metadata?.openPullRequestNumber;
164
+ return (typeof pointer === "number" ? sources.find((source) => pullRequestSourceNumber(source) === pointer) : void 0) ?? sources.findLast(openSource) ?? sources.at(-1);
165
+ }
166
+ /** The newest still-open pull request on a card other than `except`, for re-pointing `openPullRequestNumber`. */
167
+ function newestOpenPullRequestNumber(item, except) {
168
+ const open = pullRequestSources(item).filter((source) => openSource(source) && pullRequestSourceNumber(source) !== except);
169
+ return (open.length ? pullRequestSourceNumber(open.at(-1)) : void 0) ?? null;
170
+ }
171
+ /**
172
+ * Whether a pull request from `headBranch` was opened by the card's own sessions: the head is
173
+ * one of its session branches, or the branch Factory builds the card on (stable even after its
174
+ * session is deleted).
175
+ */
176
+ function cardOwnsBranch(item, headBranch) {
177
+ if (!headBranch) return false;
178
+ return workItemBranch({
179
+ id: item.id,
180
+ source: workItemBranchSource(item.externalSource),
181
+ metadata: item.workItem.metadata
182
+ }) === headBranch || Object.values(item.sessions).some((session) => session?.branch === headBranch);
183
+ }
184
+ /** The newest open pull request the card's own sessions opened, other than `except`. */
185
+ function newestOwnedOpenPullRequestNumber(item, except) {
186
+ const open = pullRequestSources(item).filter((source) => openSource(source) && pullRequestSourceNumber(source) !== except && typeof source.metadata?.headBranch === "string" && cardOwnsBranch(item, source.metadata.headBranch));
187
+ return (open.length ? pullRequestSourceNumber(open.at(-1)) : void 0) ?? null;
188
+ }
189
+ /**
190
+ * What a PR review on this card reviews: the card's own change request when the card is one,
191
+ * otherwise the attached one {@link reviewedPullRequest} picks. Undefined for a card with none.
192
+ */
193
+ function reviewedChangeRequest(item) {
194
+ if (isPullRequestCard(item)) {
195
+ const metadata = item.workItem.metadata ?? {};
196
+ const gitlab = item.source === "gitlab-pr";
197
+ const value = (gitlab ? metadata.gitlabMergeRequestIid : metadata.githubPullRequestNumber) ?? metadata.number;
198
+ return {
199
+ provider: gitlab ? "gitlab" : "github",
200
+ number: typeof value === "number" && Number.isInteger(value) && value > 0 ? value : void 0,
201
+ url: item.url ?? item.workItem.url ?? null,
202
+ headBranch: typeof metadata.headBranch === "string" ? metadata.headBranch : void 0,
203
+ standalone: true
204
+ };
205
+ }
206
+ const source = reviewedPullRequest(item);
207
+ if (!source) return void 0;
208
+ return {
209
+ provider: source.integrationId === "gitlab" ? "gitlab" : "github",
210
+ number: pullRequestSourceNumber(source),
211
+ url: source.url ?? null,
212
+ headBranch: typeof source.metadata?.headBranch === "string" ? source.metadata.headBranch : void 0,
213
+ standalone: false
214
+ };
215
+ }
216
+ /**
217
+ * Whether a pass already recorded a verdict on `change`. An issue card can carry
218
+ * several pull requests, so a verdict stamped for another one doesn't count; a
219
+ * verdict with no number (a standalone card, or one stamped before verdicts named
220
+ * their pull request) covers the card.
221
+ */
222
+ function hasRecordedVerdict(item, change = reviewedChangeRequest(item)) {
223
+ const covered = item.metadata?.reviewedPullRequestNumber;
224
+ const reviewedAnother = typeof covered === "number" && change?.number !== void 0 && covered !== change.number;
225
+ return typeof item.metadata?.reviewVerdict === "string" && !reviewedAnother;
226
+ }
227
+ /**
228
+ * Whether the rule's card carries a change request its board reviews: the card has one, and its
229
+ * board has a phase that takes pull requests ({@link boardFlow}).
230
+ */
231
+ function reviewsPullRequest(context) {
232
+ return context.flow?.pullRequestReview !== void 0 && context.item !== void 0 && hasPullRequest(context.item);
29
233
  }
30
234
  /**
31
235
  * What the installed board says `phase` means. Returns undefined when the board is not
@@ -81,23 +285,23 @@ function rulePhaseContext(boards, item) {
81
285
  context,
82
286
  role: context
83
287
  },
84
- nextPhases: Object.freeze([...phase?.nextPhases ?? []]),
85
- outcomes: Object.freeze(Object.keys(phase?.outcomes ?? {}))
288
+ nextPhases: Object.freeze([...phase?.nextPhases ?? []])
86
289
  });
87
290
  }
88
291
  /**
89
- * Whether a persisted card has finished, judged by the board it sits on: the installed
90
- * board's phase kind first, then the built-in Work and Review names for rows whose board is
91
- * not installed. Unknown boards or phases are never terminal, so a card is only ever
92
- * released from ownership on the board's own say-so.
292
+ * Whether a persisted card has finished, judged by the board it sits on: the installed board's
293
+ * phase kind first, then, for rows whose board is not installed, the phase kinds of the default
294
+ * board Factory seeds or of the retired Review board. Unknown boards or phases are never terminal,
295
+ * so a card is only ever released from ownership on the board's own say-so.
93
296
  */
94
297
  function isTerminalWorkItem(boards, item) {
95
298
  const semantics = workItemPhaseSemantics(boards, item);
96
299
  if (semantics) return semantics.kind === "terminal";
97
300
  const board = boardForWorkItem(item);
98
- if (board !== "work" && board !== "review") return false;
301
+ if (boards.has(board)) return false;
302
+ const seed = board === "work" ? workBoard : board === reviewBoard.id ? reviewBoard : void 0;
99
303
  const stage = item.stages.length === 1 ? item.stages[0] : void 0;
100
- return stage === "done" || stage === "canceled";
304
+ return stage !== void 0 && seed !== void 0 && seed.isTerminal(stage);
101
305
  }
102
306
  /** Semantics of the single stage a work item currently occupies; undefined for multi-stage rows. */
103
307
  function workItemPhaseSemantics(boards, item) {
@@ -106,6 +310,21 @@ function workItemPhaseSemantics(boards, item) {
106
310
  return resolvePhaseSemantics(boards, boardForWorkItem(item), stage);
107
311
  }
108
312
  /**
313
+ * Flow-metric outcomes of each board's phases: the phase the board closes completed sources into
314
+ * (else its first terminal phase) completes a card, other terminal phases cancel it, resting
315
+ * phases queue it, and anything else (working, or a phase the board no longer declares) is in
316
+ * flight.
317
+ */
318
+ function boardPhaseOutcomes(boards) {
319
+ return (item, stage) => {
320
+ const board = boards.get(boardForWorkItem(item));
321
+ const kind = board?.phaseKind(stage);
322
+ if (!board || kind === void 0 || kind === "working") return "pipeline";
323
+ if (kind === "resting") return "queued";
324
+ return stage === (board.sourceClosed?.completed ?? Object.keys(board.phases).find((key) => board.isTerminal(key))) ? "completed" : "canceled";
325
+ };
326
+ }
327
+ /**
109
328
  * Where source-closed rules send a persisted card: the `sourceClosed` mapping its installed
110
329
  * board declares, plus whether the card already sits in a terminal phase. Undefined when the
111
330
  * board is not installed or declares no mapping, so closing the source leaves the card alone.
@@ -137,6 +356,20 @@ function rulePhaseField(boards, item) {
137
356
  const phase = rulePhaseContext(boards, item);
138
357
  return phase ? { phase } : {};
139
358
  }
140
- export { boardEventHandlers, boardForWorkItem, eventBoardId, isPullRequestCard, isTerminalWorkItem, pullRequestReviewPhase, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, reviewsPullRequest, rulePhaseContext, rulePhaseField, withBoardClosure, workItemPhaseSemantics };
359
+ /**
360
+ * The change request a review session on this card may publish checks for: the card's own one,
361
+ * or, for an issue card in its board's pull request review phase, the pull request attached to it.
362
+ */
363
+ function boundChangeRequestNumber(boards, item) {
364
+ const source = workItemBranchSource(item.externalSource);
365
+ if (!isPullRequestCard({ source }) && (item.stages.length !== 1 || cardBoardFlow(boards, item).pullRequestReview !== item.stages[0])) return;
366
+ const number = reviewedChangeRequest({
367
+ ...item,
368
+ source
369
+ })?.number;
370
+ if (number !== void 0) return String(number);
371
+ return source === "github-pr" ? /(\d+)$/.exec(item.externalSource?.externalId ?? "")?.[1] : void 0;
372
+ }
373
+ export { awaitsAcceptance, boardEventHandlers, boardFlow, boardForWorkItem, boardPhaseOutcomes, boundChangeRequestNumber, cardBoardFlow, cardOwnsBranch, eventBoardId, hasPullRequest, hasRecordedVerdict, intakeTarget, isPullRequestCard, isPullRequestReviewPhase, isTerminalWorkItem, newestOpenPullRequestNumber, newestOwnedOpenPullRequestNumber, pullRequestCardRejection, pullRequestSourceNumber, pullRequestSources, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, reviewedChangeRequest, reviewedPullRequest, reviewsPullRequest, rulePhaseContext, rulePhaseField, sourceExternalId, withBoardClosure, withBoardFlow, withIntakeTarget, workItemPhaseSemantics };
141
374
 
142
375
  //# sourceMappingURL=semantics.js.map