@mastra/factory 0.29.0-alpha.4 → 0.29.0-alpha.6

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 (401) hide show
  1. package/README.md +172 -89
  2. package/dist/boards/board-events.d.ts +89 -9
  3. package/dist/boards/board-events.d.ts.map +1 -1
  4. package/dist/boards/board-events.js +176 -13
  5. package/dist/boards/board-events.js.map +1 -1
  6. package/dist/boards/board-writes.d.ts.map +1 -1
  7. package/dist/boards/board-writes.js +14 -1
  8. package/dist/boards/board-writes.js.map +1 -1
  9. package/dist/boards/busy-card.d.ts +11 -0
  10. package/dist/boards/busy-card.d.ts.map +1 -0
  11. package/dist/boards/busy-card.js +15 -0
  12. package/dist/boards/busy-card.js.map +1 -0
  13. package/dist/boards/card-facts.d.ts.map +1 -1
  14. package/dist/boards/card-facts.js +18 -4
  15. package/dist/boards/card-facts.js.map +1 -1
  16. package/dist/boards/index.d.ts +2 -1
  17. package/dist/boards/index.d.ts.map +1 -1
  18. package/dist/boards/index.js +3 -2
  19. package/dist/boards/intake-dry-run.d.ts +109 -0
  20. package/dist/boards/intake-dry-run.d.ts.map +1 -0
  21. package/dist/boards/intake-dry-run.js +158 -0
  22. package/dist/boards/intake-dry-run.js.map +1 -0
  23. package/dist/boards/intake-lookup.d.ts +32 -0
  24. package/dist/boards/intake-lookup.d.ts.map +1 -0
  25. package/dist/boards/intake-lookup.js +12 -0
  26. package/dist/boards/intake-lookup.js.map +1 -0
  27. package/dist/boards/intake-order.d.ts +32 -0
  28. package/dist/boards/intake-order.d.ts.map +1 -0
  29. package/dist/boards/intake-order.js +60 -0
  30. package/dist/boards/intake-order.js.map +1 -0
  31. package/dist/boards/intake-routing.d.ts +246 -35
  32. package/dist/boards/intake-routing.d.ts.map +1 -1
  33. package/dist/boards/intake-routing.js +437 -52
  34. package/dist/boards/intake-routing.js.map +1 -1
  35. package/dist/boards/reroute.d.ts +7 -3
  36. package/dist/boards/reroute.d.ts.map +1 -1
  37. package/dist/boards/reroute.js +21 -4
  38. package/dist/boards/reroute.js.map +1 -1
  39. package/dist/boards/semantics.d.ts +8 -28
  40. package/dist/boards/semantics.d.ts.map +1 -1
  41. package/dist/boards/semantics.js +14 -40
  42. package/dist/boards/semantics.js.map +1 -1
  43. package/dist/boards/work-routes.d.ts +31 -11
  44. package/dist/boards/work-routes.d.ts.map +1 -1
  45. package/dist/boards/work-routes.js +104 -20
  46. package/dist/boards/work-routes.js.map +1 -1
  47. package/dist/factory.d.ts +37 -1
  48. package/dist/factory.d.ts.map +1 -1
  49. package/dist/factory.js +127 -48
  50. package/dist/factory.js.map +1 -1
  51. package/dist/integrations/base.d.ts +9 -0
  52. package/dist/integrations/base.d.ts.map +1 -1
  53. package/dist/integrations/dependabot/rules.js +1 -1
  54. package/dist/integrations/dependabot/rules.js.map +1 -1
  55. package/dist/integrations/github/default-rules.d.ts +22 -1
  56. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  57. package/dist/integrations/github/default-rules.js +23 -5
  58. package/dist/integrations/github/default-rules.js.map +1 -1
  59. package/dist/integrations/github/intake-lookup.d.ts +16 -0
  60. package/dist/integrations/github/intake-lookup.d.ts.map +1 -0
  61. package/dist/integrations/github/intake-lookup.js +76 -0
  62. package/dist/integrations/github/intake-lookup.js.map +1 -0
  63. package/dist/integrations/github/integration.d.ts +19 -5
  64. package/dist/integrations/github/integration.d.ts.map +1 -1
  65. package/dist/integrations/github/integration.js +21 -6
  66. package/dist/integrations/github/integration.js.map +1 -1
  67. package/dist/integrations/github/issue-intake.d.ts +15 -0
  68. package/dist/integrations/github/issue-intake.d.ts.map +1 -0
  69. package/dist/integrations/github/issue-intake.js +50 -0
  70. package/dist/integrations/github/issue-intake.js.map +1 -0
  71. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  72. package/dist/integrations/github/issue-reconciler.js +10 -1
  73. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  74. package/dist/integrations/github/review-status-reporter.js +1 -1
  75. package/dist/integrations/github/routes.d.ts.map +1 -1
  76. package/dist/integrations/github/routes.js +14 -2
  77. package/dist/integrations/github/routes.js.map +1 -1
  78. package/dist/integrations/github/rules.d.ts +14 -1
  79. package/dist/integrations/github/rules.d.ts.map +1 -1
  80. package/dist/integrations/github/rules.js +221 -30
  81. package/dist/integrations/github/rules.js.map +1 -1
  82. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  83. package/dist/integrations/github/sandbox.js +30 -4
  84. package/dist/integrations/github/sandbox.js.map +1 -1
  85. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  86. package/dist/integrations/gitlab/default-rules.js +19 -3
  87. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  88. package/dist/integrations/gitlab/intake-lookup.d.ts +17 -0
  89. package/dist/integrations/gitlab/intake-lookup.d.ts.map +1 -0
  90. package/dist/integrations/gitlab/intake-lookup.js +85 -0
  91. package/dist/integrations/gitlab/intake-lookup.js.map +1 -0
  92. package/dist/integrations/gitlab/integration.d.ts +5 -0
  93. package/dist/integrations/gitlab/integration.d.ts.map +1 -1
  94. package/dist/integrations/gitlab/integration.js +21 -1
  95. package/dist/integrations/gitlab/integration.js.map +1 -1
  96. package/dist/integrations/gitlab/rules.d.ts +20 -0
  97. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  98. package/dist/integrations/gitlab/rules.js +108 -12
  99. package/dist/integrations/gitlab/rules.js.map +1 -1
  100. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  101. package/dist/integrations/incidentio/rules.js +14 -4
  102. package/dist/integrations/incidentio/rules.js.map +1 -1
  103. package/dist/integrations/jira/rules.d.ts.map +1 -1
  104. package/dist/integrations/jira/rules.js +12 -2
  105. package/dist/integrations/jira/rules.js.map +1 -1
  106. package/dist/integrations/linear/rules.d.ts.map +1 -1
  107. package/dist/integrations/linear/rules.js +13 -2
  108. package/dist/integrations/linear/rules.js.map +1 -1
  109. package/dist/integrations/platform/connect/routes.d.ts +43 -1
  110. package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
  111. package/dist/integrations/platform/connect/routes.js +82 -7
  112. package/dist/integrations/platform/connect/routes.js.map +1 -1
  113. package/dist/integrations/platform/connect/session-tools.d.ts +12 -0
  114. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
  115. package/dist/integrations/platform/connect/session-tools.js +28 -10
  116. package/dist/integrations/platform/connect/session-tools.js.map +1 -1
  117. package/dist/integrations/platform/github/event-worker.js +9 -1
  118. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  119. package/dist/integrations/platform/github/integration.d.ts +6 -6
  120. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  121. package/dist/integrations/platform/github/integration.js +22 -3
  122. package/dist/integrations/platform/github/integration.js.map +1 -1
  123. package/dist/integrations/platform/vanta/integration.d.ts.map +1 -1
  124. package/dist/integrations/platform/vanta/integration.js +3 -3
  125. package/dist/integrations/platform/vanta/integration.js.map +1 -1
  126. package/dist/integrations/pull-request-head.d.ts +1 -1
  127. package/dist/integrations/pull-request-head.d.ts.map +1 -1
  128. package/dist/integrations/pull-request-head.js +5 -0
  129. package/dist/integrations/pull-request-head.js.map +1 -1
  130. package/dist/integrations/vanta/rules.js +1 -1
  131. package/dist/integrations/vanta/rules.js.map +1 -1
  132. package/dist/integrations/vanta/sync.d.ts +9 -0
  133. package/dist/integrations/vanta/sync.d.ts.map +1 -1
  134. package/dist/integrations/vanta/sync.js +10 -1
  135. package/dist/integrations/vanta/sync.js.map +1 -1
  136. package/dist/routes/board-snapshot.d.ts +13 -6
  137. package/dist/routes/board-snapshot.d.ts.map +1 -1
  138. package/dist/routes/board-snapshot.js +42 -20
  139. package/dist/routes/board-snapshot.js.map +1 -1
  140. package/dist/routes/boards.js.map +1 -1
  141. package/dist/routes/config.d.ts +17 -2
  142. package/dist/routes/config.d.ts.map +1 -1
  143. package/dist/routes/config.js +247 -77
  144. package/dist/routes/config.js.map +1 -1
  145. package/dist/routes/contracts.d.ts +1294 -7
  146. package/dist/routes/contracts.d.ts.map +1 -1
  147. package/dist/routes/contracts.js +603 -20
  148. package/dist/routes/contracts.js.map +1 -1
  149. package/dist/routes/custom-endpoint-url.d.ts +8 -0
  150. package/dist/routes/custom-endpoint-url.d.ts.map +1 -0
  151. package/dist/routes/custom-endpoint-url.js +45 -0
  152. package/dist/routes/custom-endpoint-url.js.map +1 -0
  153. package/dist/routes/custom-provider-source.d.ts +24 -8
  154. package/dist/routes/custom-provider-source.d.ts.map +1 -1
  155. package/dist/routes/custom-provider-source.js +93 -43
  156. package/dist/routes/custom-provider-source.js.map +1 -1
  157. package/dist/routes/intake-check.d.ts +92 -0
  158. package/dist/routes/intake-check.d.ts.map +1 -0
  159. package/dist/routes/intake-check.js +322 -0
  160. package/dist/routes/intake-check.js.map +1 -0
  161. package/dist/routes/intake-routes.d.ts +10 -2
  162. package/dist/routes/intake-routes.d.ts.map +1 -1
  163. package/dist/routes/intake-routes.js +292 -11
  164. package/dist/routes/intake-routes.js.map +1 -1
  165. package/dist/routes/intake.d.ts +6 -0
  166. package/dist/routes/intake.d.ts.map +1 -1
  167. package/dist/routes/intake.js +20 -0
  168. package/dist/routes/intake.js.map +1 -1
  169. package/dist/routes/mastra-gateway.d.ts.map +1 -1
  170. package/dist/routes/mastra-gateway.js +3 -2
  171. package/dist/routes/mastra-gateway.js.map +1 -1
  172. package/dist/routes/project-sessions.d.ts +61 -0
  173. package/dist/routes/project-sessions.d.ts.map +1 -0
  174. package/dist/routes/project-sessions.js +135 -0
  175. package/dist/routes/project-sessions.js.map +1 -0
  176. package/dist/routes/projects.d.ts +6 -1
  177. package/dist/routes/projects.d.ts.map +1 -1
  178. package/dist/routes/projects.js +19 -3
  179. package/dist/routes/projects.js.map +1 -1
  180. package/dist/routes/provider-credentials.d.ts +10 -1
  181. package/dist/routes/provider-credentials.d.ts.map +1 -1
  182. package/dist/routes/provider-credentials.js +13 -16
  183. package/dist/routes/provider-credentials.js.map +1 -1
  184. package/dist/routes/run-queue.d.ts +6 -6
  185. package/dist/routes/run-queue.d.ts.map +1 -1
  186. package/dist/routes/run-queue.js +28 -8
  187. package/dist/routes/run-queue.js.map +1 -1
  188. package/dist/routes/session-rows.d.ts +30 -0
  189. package/dist/routes/session-rows.d.ts.map +1 -0
  190. package/dist/routes/session-rows.js +94 -0
  191. package/dist/routes/session-rows.js.map +1 -0
  192. package/dist/routes/source-control-sessions.d.ts +4 -5
  193. package/dist/routes/source-control-sessions.d.ts.map +1 -1
  194. package/dist/routes/source-control-sessions.js +8 -87
  195. package/dist/routes/source-control-sessions.js.map +1 -1
  196. package/dist/routes/surface.d.ts +16 -1
  197. package/dist/routes/surface.d.ts.map +1 -1
  198. package/dist/routes/surface.js +41 -30
  199. package/dist/routes/surface.js.map +1 -1
  200. package/dist/routes/tenant-credentials.d.ts.map +1 -1
  201. package/dist/routes/tenant-credentials.js +4 -4
  202. package/dist/routes/tenant-credentials.js.map +1 -1
  203. package/dist/routes/work-item-starters.d.ts +1 -0
  204. package/dist/routes/work-item-starters.d.ts.map +1 -1
  205. package/dist/routes/work-item-starters.js +14 -2
  206. package/dist/routes/work-item-starters.js.map +1 -1
  207. package/dist/routes/work-items.d.ts +22 -3
  208. package/dist/routes/work-items.d.ts.map +1 -1
  209. package/dist/routes/work-items.js +124 -48
  210. package/dist/routes/work-items.js.map +1 -1
  211. package/dist/rules/binding-context.d.ts +5 -0
  212. package/dist/rules/binding-context.d.ts.map +1 -1
  213. package/dist/rules/binding-context.js +51 -5
  214. package/dist/rules/binding-context.js.map +1 -1
  215. package/dist/rules/dispatch-errors.js +1 -1
  216. package/dist/rules/dispatch-errors.js.map +1 -1
  217. package/dist/rules/dispatcher.d.ts +39 -7
  218. package/dist/rules/dispatcher.d.ts.map +1 -1
  219. package/dist/rules/dispatcher.js +363 -123
  220. package/dist/rules/dispatcher.js.map +1 -1
  221. package/dist/rules/event-rules.d.ts +69 -1
  222. package/dist/rules/event-rules.d.ts.map +1 -1
  223. package/dist/rules/event-rules.js +151 -5
  224. package/dist/rules/event-rules.js.map +1 -1
  225. package/dist/rules/review-source-tool.js +1 -1
  226. package/dist/rules/rule-group.d.ts +18 -1
  227. package/dist/rules/rule-group.d.ts.map +1 -1
  228. package/dist/rules/rule-group.js +52 -8
  229. package/dist/rules/rule-group.js.map +1 -1
  230. package/dist/rules/run-bearing.d.ts +8 -0
  231. package/dist/rules/run-bearing.d.ts.map +1 -0
  232. package/dist/rules/run-bearing.js +11 -0
  233. package/dist/rules/run-bearing.js.map +1 -0
  234. package/dist/rules/start-coordinator.d.ts +2 -3
  235. package/dist/rules/start-coordinator.d.ts.map +1 -1
  236. package/dist/rules/start-coordinator.js +25 -38
  237. package/dist/rules/start-coordinator.js.map +1 -1
  238. package/dist/rules/tools.js +2 -1
  239. package/dist/rules/tools.js.map +1 -1
  240. package/dist/rules/transition-service.d.ts +16 -0
  241. package/dist/rules/transition-service.d.ts.map +1 -1
  242. package/dist/rules/transition-service.js +34 -10
  243. package/dist/rules/transition-service.js.map +1 -1
  244. package/dist/rules/types.d.ts +18 -5
  245. package/dist/rules/types.d.ts.map +1 -1
  246. package/dist/rules/types.js +2 -1
  247. package/dist/rules/types.js.map +1 -1
  248. package/dist/rules/update-fold.d.ts +32 -0
  249. package/dist/rules/update-fold.d.ts.map +1 -0
  250. package/dist/rules/update-fold.js +60 -0
  251. package/dist/rules/update-fold.js.map +1 -0
  252. package/dist/rules/validation.d.ts.map +1 -1
  253. package/dist/rules/validation.js +54 -6
  254. package/dist/rules/validation.js.map +1 -1
  255. package/dist/sandbox/session-retirement.d.ts +6 -0
  256. package/dist/sandbox/session-retirement.d.ts.map +1 -1
  257. package/dist/sandbox/session-retirement.js +17 -0
  258. package/dist/sandbox/session-retirement.js.map +1 -1
  259. package/dist/session/factory-session.d.ts.map +1 -1
  260. package/dist/session/factory-session.js +2 -1
  261. package/dist/session/factory-session.js.map +1 -1
  262. package/dist/session/live-sessions.d.ts +6 -1
  263. package/dist/session/live-sessions.d.ts.map +1 -1
  264. package/dist/session/live-sessions.js +4 -0
  265. package/dist/session/live-sessions.js.map +1 -1
  266. package/dist/session/resource-migration.d.ts.map +1 -1
  267. package/dist/session/resource-migration.js +2 -3
  268. package/dist/session/resource-migration.js.map +1 -1
  269. package/dist/session/run-audit.d.ts +10 -1
  270. package/dist/session/run-audit.d.ts.map +1 -1
  271. package/dist/session/run-audit.js +9 -1
  272. package/dist/session/run-audit.js.map +1 -1
  273. package/dist/session/self-review-gate.d.ts +26 -2
  274. package/dist/session/self-review-gate.d.ts.map +1 -1
  275. package/dist/session/self-review-gate.js +60 -10
  276. package/dist/session/self-review-gate.js.map +1 -1
  277. package/dist/session/session-row-query.d.ts +25 -0
  278. package/dist/session/session-row-query.d.ts.map +1 -0
  279. package/dist/session/session-row-query.js +47 -0
  280. package/dist/session/session-row-query.js.map +1 -0
  281. package/dist/session/session-row-status.d.ts +16 -0
  282. package/dist/session/session-row-status.d.ts.map +1 -0
  283. package/dist/session/session-row-status.js +14 -0
  284. package/dist/session/session-row-status.js.map +1 -0
  285. package/dist/session/session-row-view.d.ts +13 -0
  286. package/dist/session/session-row-view.d.ts.map +1 -0
  287. package/dist/session/session-row-view.js +118 -0
  288. package/dist/session/session-row-view.js.map +1 -0
  289. package/dist/session/session-rows.d.ts +60 -0
  290. package/dist/session/session-rows.d.ts.map +1 -0
  291. package/dist/session/session-rows.js +307 -0
  292. package/dist/session/session-rows.js.map +1 -0
  293. package/dist/session/session-threads.d.ts.map +1 -1
  294. package/dist/session/session-threads.js +1 -0
  295. package/dist/session/session-threads.js.map +1 -1
  296. package/dist/session/session-unloader.d.ts +101 -0
  297. package/dist/session/session-unloader.d.ts.map +1 -0
  298. package/dist/session/session-unloader.js +278 -0
  299. package/dist/session/session-unloader.js.map +1 -0
  300. package/dist/session/source-control-tools.d.ts +14 -7
  301. package/dist/session/source-control-tools.d.ts.map +1 -1
  302. package/dist/session/source-control-tools.js +10 -2
  303. package/dist/session/source-control-tools.js.map +1 -1
  304. package/dist/session/work-item-repository.d.ts +49 -1
  305. package/dist/session/work-item-repository.d.ts.map +1 -1
  306. package/dist/session/work-item-repository.js +118 -15
  307. package/dist/session/work-item-repository.js.map +1 -1
  308. package/dist/session/work-item-state-processor.d.ts.map +1 -1
  309. package/dist/session/work-item-state-processor.js +44 -8
  310. package/dist/session/work-item-state-processor.js.map +1 -1
  311. package/dist/session-list-changes.d.ts +9 -0
  312. package/dist/session-list-changes.d.ts.map +1 -0
  313. package/dist/session-list-changes.js +54 -0
  314. package/dist/session-list-changes.js.map +1 -0
  315. package/dist/storage/announced-lists.d.ts +14 -0
  316. package/dist/storage/announced-lists.d.ts.map +1 -0
  317. package/dist/storage/announced-lists.js +78 -0
  318. package/dist/storage/announced-lists.js.map +1 -0
  319. package/dist/storage/domains/audit/actions.d.ts +2 -1
  320. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  321. package/dist/storage/domains/audit/actions.js +3 -1
  322. package/dist/storage/domains/audit/actions.js.map +1 -1
  323. package/dist/storage/domains/boards/base.d.ts +163 -15
  324. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  325. package/dist/storage/domains/boards/base.js +440 -48
  326. package/dist/storage/domains/boards/base.js.map +1 -1
  327. package/dist/storage/domains/boards/schemas.d.ts +6 -0
  328. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  329. package/dist/storage/domains/boards/schemas.js +95 -1
  330. package/dist/storage/domains/boards/schemas.js.map +1 -1
  331. package/dist/storage/domains/custom-providers/base.d.ts +62 -19
  332. package/dist/storage/domains/custom-providers/base.d.ts.map +1 -1
  333. package/dist/storage/domains/custom-providers/base.js +131 -100
  334. package/dist/storage/domains/custom-providers/base.js.map +1 -1
  335. package/dist/storage/domains/intake/base.d.ts +25 -7
  336. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  337. package/dist/storage/domains/intake/base.js +83 -19
  338. package/dist/storage/domains/intake/base.js.map +1 -1
  339. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  340. package/dist/storage/domains/projects/base.js +19 -10
  341. package/dist/storage/domains/projects/base.js.map +1 -1
  342. package/dist/storage/domains/source-control/base.d.ts +8 -0
  343. package/dist/storage/domains/source-control/base.d.ts.map +1 -1
  344. package/dist/storage/domains/source-control/base.js +110 -61
  345. package/dist/storage/domains/source-control/base.js.map +1 -1
  346. package/dist/storage/domains/source-control/inmemory.d.ts +4 -0
  347. package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -1
  348. package/dist/storage/domains/source-control/inmemory.js +8 -5
  349. package/dist/storage/domains/source-control/inmemory.js.map +1 -1
  350. package/dist/storage/domains/work-items/base.d.ts +57 -18
  351. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  352. package/dist/storage/domains/work-items/base.js +168 -83
  353. package/dist/storage/domains/work-items/base.js.map +1 -1
  354. package/dist/storage/domains/work-items/cards.d.ts +3 -2
  355. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  356. package/dist/storage/domains/work-items/cards.js +4 -2
  357. package/dist/storage/domains/work-items/cards.js.map +1 -1
  358. package/dist/tools/audit-events-tool.d.ts +2 -2
  359. package/dist/tools/read-tools.d.ts +9 -5
  360. package/dist/tools/read-tools.d.ts.map +1 -1
  361. package/dist/tools/read-tools.js +61 -54
  362. package/dist/tools/read-tools.js.map +1 -1
  363. package/dist/tools/session-tools.d.ts +0 -13
  364. package/dist/tools/session-tools.d.ts.map +1 -1
  365. package/dist/tools/session-tools.js +128 -341
  366. package/dist/tools/session-tools.js.map +1 -1
  367. package/dist/tools/work-item-tools.d.ts +3 -0
  368. package/dist/tools/work-item-tools.d.ts.map +1 -1
  369. package/dist/tools/work-item-tools.js +99 -27
  370. package/dist/tools/work-item-tools.js.map +1 -1
  371. package/dist/work-item-branch.d.ts +4 -0
  372. package/dist/work-item-branch.d.ts.map +1 -1
  373. package/dist/work-item-branch.js +7 -1
  374. package/dist/work-item-branch.js.map +1 -1
  375. package/dist/work-items/card-context-sessions.d.ts +50 -0
  376. package/dist/work-items/card-context-sessions.d.ts.map +1 -0
  377. package/dist/work-items/card-context-sessions.js +84 -0
  378. package/dist/work-items/card-context-sessions.js.map +1 -0
  379. package/dist/work-items/card-reference.d.ts +21 -0
  380. package/dist/work-items/card-reference.d.ts.map +1 -0
  381. package/dist/work-items/card-reference.js +58 -0
  382. package/dist/work-items/card-reference.js.map +1 -0
  383. package/dist/work-items/change-requests.d.ts +87 -0
  384. package/dist/work-items/change-requests.d.ts.map +1 -0
  385. package/dist/work-items/change-requests.js +134 -0
  386. package/dist/work-items/change-requests.js.map +1 -0
  387. package/dist/work-items/create-work-item.d.ts +7 -2
  388. package/dist/work-items/create-work-item.d.ts.map +1 -1
  389. package/dist/work-items/create-work-item.js +44 -13
  390. package/dist/work-items/create-work-item.js.map +1 -1
  391. package/dist/work-items/list-related-cards.d.ts.map +1 -1
  392. package/dist/work-items/list-related-cards.js +1 -1
  393. package/dist/work-items/list-related-cards.js.map +1 -1
  394. package/dist/work-items/providers/github.d.ts.map +1 -1
  395. package/dist/work-items/providers/github.js +1 -0
  396. package/dist/work-items/providers/github.js.map +1 -1
  397. package/factory-skills/factory-build/SKILL.md +1 -1
  398. package/factory-skills/factory-plan/SKILL.md +5 -3
  399. package/factory-skills/factory-self-review/SKILL.md +2 -0
  400. package/factory-skills/factory-triage/SKILL.md +1 -1
  401. package/package.json +10 -10
@@ -1,5 +1,5 @@
1
1
  import type { BoardEventFacts, PullRequestEvent } from '../boards/board-events.js';
2
- import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
2
+ import type { Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';
3
3
  import type { FactoryRouteEventDecision, FactoryRuleHandler, FactoryTransitionDecision } from './types.js';
4
4
  type EventRuleTable<E extends string, TContext> = Readonly<Record<E, FactoryRuleHandler<TContext> | null>>;
5
5
  type BoardEventRuleMap<E extends string, TContext> = Readonly<Partial<Record<E, FactoryRuleHandler<TContext> | null>>>;
@@ -31,6 +31,7 @@ export declare function hasExplicitRuleOverride(rules: object, event: string): b
31
31
  * A decision that carries a work item's status event (a close, a reopen) for the card's routes.
32
32
  * Those overtake one another, so the source's last word wins. Pull request events don't: a merge,
33
33
  * a close or a push each concerns its own pull request, and the default rules already decided it.
34
+ * Neither do updates: a label change never cancels a close or a reopen, nor is cancelled by one.
34
35
  */
35
36
  export declare const isStatusEventDecision: (decision: Record<string, unknown>) => boolean;
36
37
  /**
@@ -52,6 +53,68 @@ export declare function routeEventDecision(context: {
52
53
  orgId: string;
53
54
  factoryProjectId: string;
54
55
  }): Promise<FactoryRouteEventDecision | undefined>;
56
+ /**
57
+ * The decision handing a label or assignee change to the card's routes. A change the card's own
58
+ * session made (`fromCardSession`) is held until its run ends.
59
+ */
60
+ export declare function cardUpdateDecision(ingressId: string, event: BoardEventFacts, fromCardSession: boolean): FactoryRouteEventDecision;
61
+ /**
62
+ * Commits a label or assignee change on a card as an update event for the card's routes. Nothing
63
+ * is committed when nothing changed. `fromCardSession` marks a change Factory made itself, which
64
+ * the dispatcher holds until the card's run ends. The change has already been written to the card,
65
+ * so a stale revision only means another write landed; re-read and commit against it.
66
+ */
67
+ /**
68
+ * How handing an update to the card's routes went: queued (or already queued), nothing to hand
69
+ * over, or not queued (the card is gone or kept changing), in which case the caller must not
70
+ * record the change as seen, so a redelivery or the next sighting hands it over again.
71
+ */
72
+ export type CardUpdateStatus = 'committed' | 'replayed' | 'unchanged' | 'ignored';
73
+ export declare function commitCardUpdate(storage: Pick<WorkItemsStorage, 'commitRuleEvaluation' | 'get'>, input: {
74
+ orgId: string;
75
+ factoryProjectId: string;
76
+ item: {
77
+ id: string;
78
+ revision: number;
79
+ };
80
+ ingress: {
81
+ identity: string;
82
+ };
83
+ actor: Record<string, unknown>;
84
+ event: BoardEventFacts | undefined;
85
+ fromCardSession: boolean;
86
+ now?: Date;
87
+ }): Promise<CardUpdateStatus>;
88
+ /**
89
+ * For a provider that only reports "the item changed" (Linear, Jira, incident.io are polled):
90
+ * diffs the item's labels and assignee against the ones the last sighting recorded, records the
91
+ * new ones, and hands the change to the card's routes as a `work_item.updated` event. The first
92
+ * sighting only records them, so cards filed before this existed don't all fire at once. Polling
93
+ * cannot tell who made the change, so it is never held for the card's run.
94
+ */
95
+ export declare function commitObservedChange(storage: Pick<WorkItemsStorage, 'commitRuleEvaluation' | 'get' | 'syncCard'>, input: {
96
+ orgId: string;
97
+ factoryProjectId: string;
98
+ item: Pick<Card, 'id' | 'revision' | 'metadata' | 'workItem'>;
99
+ ingressId: string;
100
+ actor: Record<string, unknown>;
101
+ labels: readonly string[];
102
+ assignee: string | null;
103
+ /** When the provider last changed the item, as it reported it: older sightings are ignored. */
104
+ observedAt: string;
105
+ /** Provider-specific metadata to record next to the labels and assignees. */
106
+ metadata?: Record<string, unknown>;
107
+ }): Promise<CardUpdateStatus>;
108
+ /**
109
+ * Tells whether a delivery's item was turned away by intake (Not routed): it has no card, but an
110
+ * update to it should run intake again. Storage that keeps Not routed records provides it.
111
+ */
112
+ export interface NotRoutedLookup {
113
+ isNotRouted(scope: {
114
+ orgId: string;
115
+ factoryProjectId: string;
116
+ }, sourceKey: string): Promise<boolean>;
117
+ }
55
118
  /** A pull or merge request's own card on a board with no pull request loop: Factory doesn't review it there. */
56
119
  export declare function unreviewedPullRequestCard(context: {
57
120
  item?: {
@@ -84,6 +147,11 @@ export declare function closedByRoutes<T extends Omit<FactoryTransitionDecision,
84
147
  * (its message, its re-entry).
85
148
  */
86
149
  export declare function pullRequestMoveByRoutes<T extends Omit<FactoryTransitionDecision, 'type' | 'event'>>(event: PullRequestEvent, move: T): FactoryTransitionDecision;
150
+ /**
151
+ * A decision carrying a pull request event, tagged with whether that pull request's author has
152
+ * write access (or is Factory): what a route's `pullRequest.trusted` tests.
153
+ */
154
+ export declare function withPullRequestTrust(entry: Record<string, unknown>, trusted: boolean): Record<string, unknown>;
87
155
  /**
88
156
  * A decision the deployment's own handler returned stays its answer: a stock close move it
89
157
  * wrapped or reused loses the event tag that would hand it to the project's intake routes.
@@ -1 +1 @@
1
- {"version":3,"file":"event-rules.d.ts","sourceRoot":"","sources":["../../src/rules/event-rules.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"event-rules.d.ts","sourceRoot":"","sources":["../../src/rules/event-rules.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,6 @@
1
- import { closeReason, eventMovesCard, isPullRequestEvent } from "../boards/board-events.js";
2
- import { isPullRequestCard } from "../boards/semantics.js";
1
+ import { closeReason, eventMovesCard, isPullRequestEvent, isUpdateEvent, listChange, updateEventFacts } from "../boards/board-events.js";
2
+ import { WorkItemUpdateConflictError } from "../storage/domains/work-items/base.js";
3
+ import { isPullRequestCard } from "../work-items/change-requests.js";
3
4
  // src/rules/event-rules.ts
4
5
  const explicitOverrides = /* @__PURE__ */ new WeakMap();
5
6
  /**
@@ -54,11 +55,12 @@ function isPromiseLike(value) {
54
55
  * A decision that carries a work item's status event (a close, a reopen) for the card's routes.
55
56
  * Those overtake one another, so the source's last word wins. Pull request events don't: a merge,
56
57
  * a close or a push each concerns its own pull request, and the default rules already decided it.
58
+ * Neither do updates: a label change never cancels a close or a reopen, nor is cancelled by one.
57
59
  */
58
60
  const isStatusEventDecision = (decision) => {
59
61
  if (decision.type !== "routeEvent" && decision.type !== "transition") return false;
60
62
  const event = decision.event;
61
- return event !== void 0 && !isPullRequestEvent(event.type);
63
+ return event !== void 0 && !isPullRequestEvent(event.type) && !isUpdateEvent(event.type);
62
64
  };
63
65
  const QUEUED_STATUSES = [
64
66
  "pending",
@@ -71,7 +73,7 @@ const QUEUED_STATUSES = [
71
73
  */
72
74
  async function routeEventDecision(context, storage, scope) {
73
75
  const event = context.boardEvent;
74
- if (!context.item || !event || event.type === "work_item.created") return void 0;
76
+ if (!context.item || !event || event.type === "work_item.opened") return void 0;
75
77
  const decision = routeEvent(context.ingress.id, event);
76
78
  if (eventMovesCard(event.type, context.phase?.kind === "terminal")) return decision;
77
79
  return (await storage.listDeferredDecisions(scope.orgId, scope.factoryProjectId, {
@@ -86,6 +88,134 @@ function routeEvent(ingressId, event) {
86
88
  event
87
89
  };
88
90
  }
91
+ /**
92
+ * The decision handing a label or assignee change to the card's routes. A change the card's own
93
+ * session made (`fromCardSession`) is held until its run ends.
94
+ */
95
+ function cardUpdateDecision(ingressId, event, fromCardSession) {
96
+ return {
97
+ ...routeEvent(ingressId, event),
98
+ ...fromCardSession ? { fromCardSession: true } : {}
99
+ };
100
+ }
101
+ async function commitCardUpdate(storage, input) {
102
+ if (!input.event) return "unchanged";
103
+ const decision = cardUpdateDecision(input.ingress.identity, input.event, input.fromCardSession);
104
+ let revision = input.item.revision;
105
+ for (let attempt = 1; attempt <= 3; attempt++) {
106
+ const committed = await storage.commitRuleEvaluation({
107
+ orgId: input.orgId,
108
+ factoryProjectId: input.factoryProjectId,
109
+ workItemId: input.item.id,
110
+ ingress: input.ingress,
111
+ expectedRevision: revision,
112
+ actor: input.actor,
113
+ outcome: { status: "accepted" },
114
+ decisions: [{ ...decision }],
115
+ causalChain: [],
116
+ now: input.now ?? /* @__PURE__ */ new Date()
117
+ });
118
+ if (committed.status === "committed" || committed.status === "replayed") return committed.status;
119
+ if (committed.status === "missing") return "ignored";
120
+ const current = await storage.get({
121
+ orgId: input.orgId,
122
+ id: input.item.id
123
+ });
124
+ if (!current) return "ignored";
125
+ revision = current.revision;
126
+ }
127
+ return "ignored";
128
+ }
129
+ /** The labels and assignees a polled provider last reported for a card's item. */
130
+ const OBSERVED_ITEM_METADATA_KEY = "observedItem";
131
+ function observedItem(item) {
132
+ const value = item.metadata?.[OBSERVED_ITEM_METADATA_KEY] ?? item.workItem.metadata?.[OBSERVED_ITEM_METADATA_KEY];
133
+ if (!value || typeof value !== "object") return void 0;
134
+ const list = (entry) => Array.isArray(entry) ? entry.filter((name) => typeof name === "string") : [];
135
+ const record = value;
136
+ const observedAt = typeof record.observedAt === "string" ? Date.parse(record.observedAt) : NaN;
137
+ return {
138
+ labels: list(record.labels),
139
+ assignees: list(record.assignees),
140
+ observedAt: Number.isNaN(observedAt) ? void 0 : observedAt
141
+ };
142
+ }
143
+ /**
144
+ * For a provider that only reports "the item changed" (Linear, Jira, incident.io are polled):
145
+ * diffs the item's labels and assignee against the ones the last sighting recorded, records the
146
+ * new ones, and hands the change to the card's routes as a `work_item.updated` event. The first
147
+ * sighting only records them, so cards filed before this existed don't all fire at once. Polling
148
+ * cannot tell who made the change, so it is never held for the card's run.
149
+ */
150
+ async function commitObservedChange(storage, input) {
151
+ const assignees = input.assignee ? [input.assignee] : [];
152
+ const observedAt = Date.parse(input.observedAt);
153
+ const metadata = {
154
+ ...input.metadata,
155
+ labels: [...input.labels],
156
+ assignees,
157
+ assignee: input.assignee,
158
+ [OBSERVED_ITEM_METADATA_KEY]: {
159
+ labels: [...input.labels],
160
+ assignees,
161
+ observedAt: input.observedAt
162
+ }
163
+ };
164
+ let item = input.item;
165
+ for (let attempt = 1; attempt <= 3; attempt++) {
166
+ const seen = observedItem(item);
167
+ if (seen?.observedAt !== void 0 && observedAt < seen.observedAt) return "unchanged";
168
+ if (seen?.observedAt === observedAt && sameNames(seen.labels, input.labels) && sameNames(seen.assignees, assignees)) return "unchanged";
169
+ const event = seen && updateEventFacts("work_item.updated", {
170
+ labels: listChange(seen.labels, input.labels),
171
+ assignees: listChange(seen.assignees, assignees)
172
+ });
173
+ if (!event) try {
174
+ await storage.syncCard({
175
+ orgId: input.orgId,
176
+ id: item.id,
177
+ userId: CARD_SYNC_USER_ID,
178
+ patch: { metadata },
179
+ expectedRevision: item.revision
180
+ });
181
+ return "unchanged";
182
+ } catch (error) {
183
+ if (!(error instanceof WorkItemUpdateConflictError)) throw error;
184
+ }
185
+ else {
186
+ const identity = `${input.ingressId}:update`;
187
+ const committed = await storage.commitRuleEvaluation({
188
+ orgId: input.orgId,
189
+ factoryProjectId: input.factoryProjectId,
190
+ workItemId: item.id,
191
+ ingress: { identity },
192
+ expectedRevision: item.revision,
193
+ actor: input.actor,
194
+ outcome: { status: "accepted" },
195
+ decisions: [{ ...cardUpdateDecision(identity, event, false) }],
196
+ causalChain: [],
197
+ now: /* @__PURE__ */ new Date(),
198
+ cardMetadata: {
199
+ userId: CARD_SYNC_USER_ID,
200
+ metadata
201
+ }
202
+ });
203
+ if (committed.status === "committed" || committed.status === "replayed") return committed.status;
204
+ if (committed.status === "missing") return "ignored";
205
+ }
206
+ const current = await storage.get({
207
+ orgId: input.orgId,
208
+ id: item.id
209
+ });
210
+ if (!current) return "ignored";
211
+ item = current;
212
+ }
213
+ return "ignored";
214
+ }
215
+ const CARD_SYNC_USER_ID = "factory-rule-dispatcher";
216
+ function sameNames(a, b) {
217
+ return a.length === b.length && a.every((name, index) => name === b[index]);
218
+ }
89
219
  /** A pull or merge request's own card on a board with no pull request loop: Factory doesn't review it there. */
90
220
  function unreviewedPullRequestCard(context) {
91
221
  return context.item !== void 0 && isPullRequestCard(context.item) && context.flow?.pullRequestReview === void 0;
@@ -125,6 +255,22 @@ function pullRequestMoveByRoutes(event, move) {
125
255
  };
126
256
  }
127
257
  /**
258
+ * A decision carrying a pull request event, tagged with whether that pull request's author has
259
+ * write access (or is Factory): what a route's `pullRequest.trusted` tests.
260
+ */
261
+ function withPullRequestTrust(entry, trusted) {
262
+ if (entry.type !== "transition" && entry.type !== "routeEvent") return entry;
263
+ const event = entry.event;
264
+ if (!event || !isPullRequestEvent(event.type)) return entry;
265
+ return {
266
+ ...entry,
267
+ event: {
268
+ ...event,
269
+ pullRequestTrusted: trusted
270
+ }
271
+ };
272
+ }
273
+ /**
128
274
  * A decision the deployment's own handler returned stays its answer: a stock close move it
129
275
  * wrapped or reused loses the event tag that would hand it to the project's intake routes.
130
276
  */
@@ -133,6 +279,6 @@ function withoutRouteEvent(entry) {
133
279
  const { event: _event, ...move } = entry;
134
280
  return move;
135
281
  }
136
- export { closedByRoutes, composeEventRule, deploymentOwnsEvent, hasExplicitRuleOverride, isStatusEventDecision, pullRequestMoveByRoutes, recordExplicitRuleOverrides, routeEventDecision, routedOnly, selectEventRule, unreviewedPullRequestCard, withoutRouteEvent };
282
+ export { cardUpdateDecision, closedByRoutes, commitCardUpdate, commitObservedChange, composeEventRule, deploymentOwnsEvent, hasExplicitRuleOverride, isStatusEventDecision, pullRequestMoveByRoutes, recordExplicitRuleOverrides, routeEventDecision, routedOnly, selectEventRule, unreviewedPullRequestCard, withPullRequestTrust, withoutRouteEvent };
137
283
 
138
284
  //# sourceMappingURL=event-rules.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"event-rules.js","names":[],"sources":["../../src/rules/event-rules.ts"],"sourcesContent":["import type { BoardEventFacts, PullRequestEvent } from '../boards/board-events.js';\nimport { closeReason, eventMovesCard, isPullRequestEvent } from '../boards/board-events.js';\nimport { isPullRequestCard } from '../boards/semantics.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport type { FactoryRouteEventDecision, FactoryRuleHandler, FactoryTransitionDecision } from './types.js';\n\ntype EventRuleTable<E extends string, TContext> = Readonly<Record<E, FactoryRuleHandler<TContext> | null>>;\ntype BoardEventRuleMap<E extends string, TContext> = Readonly<Partial<Record<E, FactoryRuleHandler<TContext> | null>>>;\n\nconst explicitOverrides = new WeakMap<object, ReadonlySet<string>>();\n\n/**\n * Records which events a deployment set explicitly on an integration's `rules`. Those handlers keep\n * precedence over board event handlers, so integration-level wrappers behave exactly as before.\n */\nexport function recordExplicitRuleOverrides<T extends object>(\n rules: T,\n overrides: Readonly<Record<string, unknown>> | undefined,\n): T {\n const keys = Object.entries(overrides ?? {})\n .filter(([, handler]) => handler !== undefined)\n .map(([event]) => event);\n explicitOverrides.set(rules, Object.freeze(new Set(keys)));\n return rules;\n}\n\n/**\n * Runs a board event handler ahead of the integration default. A board handler that returns no\n * decision leaves the default in force, so card-independent defaults (filing a new card,\n * dismissing stale reviews) keep running on every board; `null` switches the default off.\n */\nexport function composeEventRule<TContext>(\n boardRule: FactoryRuleHandler<TContext> | null | undefined,\n base: FactoryRuleHandler<TContext> | null,\n): FactoryRuleHandler<TContext> | null {\n if (boardRule === null) return null;\n if (!boardRule) return base;\n if (!base) return boardRule;\n return context => {\n const decision = boardRule(context);\n if (isPromiseLike(decision)) return Promise.resolve(decision).then(resolved => resolved ?? base(context));\n return decision ?? base(context);\n };\n}\n\n/**\n * Handler that answers one integration event: a handler the deployment set explicitly on the\n * integration, else the card's board handler composed over the integration default.\n */\nexport function selectEventRule<E extends string, TContext>(\n rules: EventRuleTable<E, TContext>,\n boardRules: BoardEventRuleMap<E, TContext> | undefined,\n event: E,\n): FactoryRuleHandler<TContext> | null {\n const base = rules[event];\n if (hasExplicitRuleOverride(rules, event)) return base;\n return composeEventRule(boardRules?.[event], base);\n}\n\n/**\n * Whether the deployment answers the event itself: with a handler or `null` set explicitly on the\n * integration's `rules`, or with `null` on the card's board handlers. Intake routes then stay out\n * of it, so an override that moves nothing really moves nothing.\n */\nexport function deploymentOwnsEvent<E extends string, TContext>(\n rules: EventRuleTable<E, TContext>,\n boardRules: BoardEventRuleMap<E, TContext> | undefined,\n event: E,\n): boolean {\n return hasExplicitRuleOverride(rules, event) || boardRules?.[event] === null;\n}\n\n/** Whether the deployment set this event explicitly on the integration's `rules`. */\nexport function hasExplicitRuleOverride(rules: object, event: string): boolean {\n return explicitOverrides.get(rules)?.has(event) ?? false;\n}\n\nfunction isPromiseLike<T>(value: T | PromiseLike<T>): value is PromiseLike<T> {\n return typeof (value as { then?: unknown } | null | undefined)?.then === 'function';\n}\n\n/**\n * A decision that carries a work item's status event (a close, a reopen) for the card's routes.\n * Those overtake one another, so the source's last word wins. Pull request events don't: a merge,\n * a close or a push each concerns its own pull request, and the default rules already decided it.\n */\nexport const isStatusEventDecision = (decision: Record<string, unknown>): boolean => {\n if (decision.type !== 'routeEvent' && decision.type !== 'transition') return false;\n const event = decision.event as BoardEventFacts | undefined;\n return event !== undefined && !isPullRequestEvent(event.type);\n};\n\nconst QUEUED_STATUSES = ['pending', 'retry', 'leased'] as const;\n\n/**\n * The decision that hands a delivery's status event to the project's intake routes, when no rule\n * decided anything for it. Only an existing card is moved; new cards are placed when filed.\n */\nexport async function routeEventDecision(\n context: {\n item?: { id: string };\n phase?: { kind: string };\n boardEvent?: BoardEventFacts;\n ingress: { id: string };\n },\n storage: Pick<WorkItemsStorage, 'listDeferredDecisions'>,\n scope: { orgId: string; factoryProjectId: string },\n): Promise<FactoryRouteEventDecision | undefined> {\n const event = context.boardEvent;\n if (!context.item || !event || event.type === 'work_item.created') return undefined;\n const decision = routeEvent(context.ingress.id, event);\n // A close moves only an unfinished card and a reopen only a finished one, unless an earlier\n // status event is still queued for the card: this one overtakes it, so the last one wins.\n if (eventMovesCard(event.type, context.phase?.kind === 'terminal')) return decision;\n const queued = await storage.listDeferredDecisions(scope.orgId, scope.factoryProjectId, {\n workItemId: context.item.id,\n statuses: QUEUED_STATUSES,\n });\n return queued.some(record => isStatusEventDecision(record.decision)) ? decision : undefined;\n}\n\nfunction routeEvent(ingressId: string, event: BoardEventFacts): FactoryRouteEventDecision {\n return { type: 'routeEvent', idempotencyKey: `${ingressId}:event-route`, event };\n}\n\n/** A pull or merge request's own card on a board with no pull request loop: Factory doesn't review it there. */\nexport function unreviewedPullRequestCard(context: {\n item?: { readonly source: string };\n flow?: { pullRequestReview?: string };\n}): boolean {\n return context.item !== undefined && isPullRequestCard(context.item) && context.flow?.pullRequestReview === undefined;\n}\n\n/**\n * A merge or close on a board with no pull request loop moves the card only where a route on its\n * board says; there is no move of Factory's own to fall back on.\n */\nexport function routedOnly(\n context: { phase?: { kind: string }; ingress: { id: string } },\n event: 'pull_request.merged' | 'pull_request.closed',\n): FactoryRouteEventDecision | undefined {\n if (context.phase?.kind === 'terminal') return undefined;\n return routeEvent(context.ingress.id, { type: event });\n}\n\n/**\n * A default close handler's answer: the board's `sourceClosed` move, which the project's intake\n * routes replace when a route on the card's board handles closes.\n */\nexport function closedByRoutes<T extends Omit<FactoryTransitionDecision, 'type' | 'event'>>(\n canceled: boolean,\n move: T,\n): FactoryTransitionDecision {\n return { type: 'transition', ...move, event: { type: 'work_item.closed', reason: closeReason(canceled) } };\n}\n\n/**\n * A default pull request handler's answer: the move it decided on, which a route on the card's\n * board naming the event sends elsewhere. A route to the same phase keeps the move as it is\n * (its message, its re-entry).\n */\nexport function pullRequestMoveByRoutes<T extends Omit<FactoryTransitionDecision, 'type' | 'event'>>(\n event: PullRequestEvent,\n move: T,\n): FactoryTransitionDecision {\n return { type: 'transition', ...move, event: { type: event } };\n}\n\n/**\n * A decision the deployment's own handler returned stays its answer: a stock close move it\n * wrapped or reused loses the event tag that would hand it to the project's intake routes.\n */\nexport function withoutRouteEvent(entry: Record<string, unknown>): Record<string, unknown> {\n if (entry.type !== 'transition' || entry.event === undefined) return entry;\n const { event: _event, ...move } = entry;\n return move;\n}\n"],"mappings":";;;AASA,MAAM,oCAAoB,IAAI,QAAqC;;;;;AAMnE,SAAgB,4BACd,OACA,WACG;CACH,MAAM,OAAO,OAAO,QAAQ,aAAa,CAAC,CAAC,CAAC,CACzC,QAAQ,GAAG,aAAa,YAAY,KAAA,CAAS,CAAC,CAC9C,KAAK,CAAC,WAAW,KAAK;CACzB,kBAAkB,IAAI,OAAO,OAAO,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC;CACzD,OAAO;AACT;;;;;;AAOA,SAAgB,iBACd,WACA,MACqC;CACrC,IAAI,cAAc,MAAM,OAAO;CAC/B,IAAI,CAAC,WAAW,OAAO;CACvB,IAAI,CAAC,MAAM,OAAO;CAClB,QAAO,YAAW;EAChB,MAAM,WAAW,UAAU,OAAO;EAClC,IAAI,cAAc,QAAQ,GAAG,OAAO,QAAQ,QAAQ,QAAQ,CAAC,CAAC,MAAK,aAAY,YAAY,KAAK,OAAO,CAAC;EACxG,OAAO,YAAY,KAAK,OAAO;CACjC;AACF;;;;;AAMA,SAAgB,gBACd,OACA,YACA,OACqC;CACrC,MAAM,OAAO,MAAM;CACnB,IAAI,wBAAwB,OAAO,KAAK,GAAG,OAAO;CAClD,OAAO,iBAAiB,aAAa,QAAQ,IAAI;AACnD;;;;;;AAOA,SAAgB,oBACd,OACA,YACA,OACS;CACT,OAAO,wBAAwB,OAAO,KAAK,KAAK,aAAa,WAAW;AAC1E;;AAGA,SAAgB,wBAAwB,OAAe,OAAwB;CAC7E,OAAO,kBAAkB,IAAI,KAAK,CAAC,EAAE,IAAI,KAAK,KAAK;AACrD;AAEA,SAAS,cAAiB,OAAoD;CAC5E,OAAO,OAAQ,OAAiD,SAAS;AAC3E;;;;;;AAOA,MAAa,yBAAyB,aAA+C;CACnF,IAAI,SAAS,SAAS,gBAAgB,SAAS,SAAS,cAAc,OAAO;CAC7E,MAAM,QAAQ,SAAS;CACvB,OAAO,UAAU,KAAA,KAAa,CAAC,mBAAmB,MAAM,IAAI;AAC9D;AAEA,MAAM,kBAAkB;CAAC;CAAW;CAAS;AAAQ;;;;;AAMrD,eAAsB,mBACpB,SAMA,SACA,OACgD;CAChD,MAAM,QAAQ,QAAQ;CACtB,IAAI,CAAC,QAAQ,QAAQ,CAAC,SAAS,MAAM,SAAS,qBAAqB,OAAO,KAAA;CAC1E,MAAM,WAAW,WAAW,QAAQ,QAAQ,IAAI,KAAK;CAGrD,IAAI,eAAe,MAAM,MAAM,QAAQ,OAAO,SAAS,UAAU,GAAG,OAAO;CAK3E,QAAO,MAJc,QAAQ,sBAAsB,MAAM,OAAO,MAAM,kBAAkB;EACtF,YAAY,QAAQ,KAAK;EACzB,UAAU;CACZ,CAAC,EAAA,CACa,MAAK,WAAU,sBAAsB,OAAO,QAAQ,CAAC,IAAI,WAAW,KAAA;AACpF;AAEA,SAAS,WAAW,WAAmB,OAAmD;CACxF,OAAO;EAAE,MAAM;EAAc,gBAAgB,GAAG,UAAU;EAAe;CAAM;AACjF;;AAGA,SAAgB,0BAA0B,SAG9B;CACV,OAAO,QAAQ,SAAS,KAAA,KAAa,kBAAkB,QAAQ,IAAI,KAAK,QAAQ,MAAM,sBAAsB,KAAA;AAC9G;;;;;AAMA,SAAgB,WACd,SACA,OACuC;CACvC,IAAI,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAA;CAC/C,OAAO,WAAW,QAAQ,QAAQ,IAAI,EAAE,MAAM,MAAM,CAAC;AACvD;;;;;AAMA,SAAgB,eACd,UACA,MAC2B;CAC3B,OAAO;EAAE,MAAM;EAAc,GAAG;EAAM,OAAO;GAAE,MAAM;GAAoB,QAAQ,YAAY,QAAQ;EAAE;CAAE;AAC3G;;;;;;AAOA,SAAgB,wBACd,OACA,MAC2B;CAC3B,OAAO;EAAE,MAAM;EAAc,GAAG;EAAM,OAAO,EAAE,MAAM,MAAM;CAAE;AAC/D;;;;;AAMA,SAAgB,kBAAkB,OAAyD;CACzF,IAAI,MAAM,SAAS,gBAAgB,MAAM,UAAU,KAAA,GAAW,OAAO;CACrE,MAAM,EAAE,OAAO,QAAQ,GAAG,SAAS;CACnC,OAAO;AACT"}
1
+ {"version":3,"file":"event-rules.js","names":[],"sources":["../../src/rules/event-rules.ts"],"sourcesContent":["import type { BoardEventFacts, PullRequestEvent } from '../boards/board-events.js';\nimport {\n closeReason,\n eventMovesCard,\n isPullRequestEvent,\n isUpdateEvent,\n listChange,\n updateEventFacts,\n} from '../boards/board-events.js';\nimport { WorkItemUpdateConflictError } from '../storage/domains/work-items/base.js';\nimport type { Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { isPullRequestCard } from '../work-items/change-requests.js';\nimport type { FactoryRouteEventDecision, FactoryRuleHandler, FactoryTransitionDecision } from './types.js';\n\ntype EventRuleTable<E extends string, TContext> = Readonly<Record<E, FactoryRuleHandler<TContext> | null>>;\ntype BoardEventRuleMap<E extends string, TContext> = Readonly<Partial<Record<E, FactoryRuleHandler<TContext> | null>>>;\n\nconst explicitOverrides = new WeakMap<object, ReadonlySet<string>>();\n\n/**\n * Records which events a deployment set explicitly on an integration's `rules`. Those handlers keep\n * precedence over board event handlers, so integration-level wrappers behave exactly as before.\n */\nexport function recordExplicitRuleOverrides<T extends object>(\n rules: T,\n overrides: Readonly<Record<string, unknown>> | undefined,\n): T {\n const keys = Object.entries(overrides ?? {})\n .filter(([, handler]) => handler !== undefined)\n .map(([event]) => event);\n explicitOverrides.set(rules, Object.freeze(new Set(keys)));\n return rules;\n}\n\n/**\n * Runs a board event handler ahead of the integration default. A board handler that returns no\n * decision leaves the default in force, so card-independent defaults (filing a new card,\n * dismissing stale reviews) keep running on every board; `null` switches the default off.\n */\nexport function composeEventRule<TContext>(\n boardRule: FactoryRuleHandler<TContext> | null | undefined,\n base: FactoryRuleHandler<TContext> | null,\n): FactoryRuleHandler<TContext> | null {\n if (boardRule === null) return null;\n if (!boardRule) return base;\n if (!base) return boardRule;\n return context => {\n const decision = boardRule(context);\n if (isPromiseLike(decision)) return Promise.resolve(decision).then(resolved => resolved ?? base(context));\n return decision ?? base(context);\n };\n}\n\n/**\n * Handler that answers one integration event: a handler the deployment set explicitly on the\n * integration, else the card's board handler composed over the integration default.\n */\nexport function selectEventRule<E extends string, TContext>(\n rules: EventRuleTable<E, TContext>,\n boardRules: BoardEventRuleMap<E, TContext> | undefined,\n event: E,\n): FactoryRuleHandler<TContext> | null {\n const base = rules[event];\n if (hasExplicitRuleOverride(rules, event)) return base;\n return composeEventRule(boardRules?.[event], base);\n}\n\n/**\n * Whether the deployment answers the event itself: with a handler or `null` set explicitly on the\n * integration's `rules`, or with `null` on the card's board handlers. Intake routes then stay out\n * of it, so an override that moves nothing really moves nothing.\n */\nexport function deploymentOwnsEvent<E extends string, TContext>(\n rules: EventRuleTable<E, TContext>,\n boardRules: BoardEventRuleMap<E, TContext> | undefined,\n event: E,\n): boolean {\n return hasExplicitRuleOverride(rules, event) || boardRules?.[event] === null;\n}\n\n/** Whether the deployment set this event explicitly on the integration's `rules`. */\nexport function hasExplicitRuleOverride(rules: object, event: string): boolean {\n return explicitOverrides.get(rules)?.has(event) ?? false;\n}\n\nfunction isPromiseLike<T>(value: T | PromiseLike<T>): value is PromiseLike<T> {\n return typeof (value as { then?: unknown } | null | undefined)?.then === 'function';\n}\n\n/**\n * A decision that carries a work item's status event (a close, a reopen) for the card's routes.\n * Those overtake one another, so the source's last word wins. Pull request events don't: a merge,\n * a close or a push each concerns its own pull request, and the default rules already decided it.\n * Neither do updates: a label change never cancels a close or a reopen, nor is cancelled by one.\n */\nexport const isStatusEventDecision = (decision: Record<string, unknown>): boolean => {\n if (decision.type !== 'routeEvent' && decision.type !== 'transition') return false;\n const event = decision.event as BoardEventFacts | undefined;\n return event !== undefined && !isPullRequestEvent(event.type) && !isUpdateEvent(event.type);\n};\n\nconst QUEUED_STATUSES = ['pending', 'retry', 'leased'] as const;\n\n/**\n * The decision that hands a delivery's status event to the project's intake routes, when no rule\n * decided anything for it. Only an existing card is moved; new cards are placed when filed.\n */\nexport async function routeEventDecision(\n context: {\n item?: { id: string };\n phase?: { kind: string };\n boardEvent?: BoardEventFacts;\n ingress: { id: string };\n },\n storage: Pick<WorkItemsStorage, 'listDeferredDecisions'>,\n scope: { orgId: string; factoryProjectId: string },\n): Promise<FactoryRouteEventDecision | undefined> {\n const event = context.boardEvent;\n if (!context.item || !event || event.type === 'work_item.opened') return undefined;\n const decision = routeEvent(context.ingress.id, event);\n // A close moves only an unfinished card and a reopen only a finished one, unless an earlier\n // status event is still queued for the card: this one overtakes it, so the last one wins.\n if (eventMovesCard(event.type, context.phase?.kind === 'terminal')) return decision;\n const queued = await storage.listDeferredDecisions(scope.orgId, scope.factoryProjectId, {\n workItemId: context.item.id,\n statuses: QUEUED_STATUSES,\n });\n return queued.some(record => isStatusEventDecision(record.decision)) ? decision : undefined;\n}\n\nfunction routeEvent(ingressId: string, event: BoardEventFacts): FactoryRouteEventDecision {\n return { type: 'routeEvent', idempotencyKey: `${ingressId}:event-route`, event };\n}\n\n/**\n * The decision handing a label or assignee change to the card's routes. A change the card's own\n * session made (`fromCardSession`) is held until its run ends.\n */\nexport function cardUpdateDecision(\n ingressId: string,\n event: BoardEventFacts,\n fromCardSession: boolean,\n): FactoryRouteEventDecision {\n return { ...routeEvent(ingressId, event), ...(fromCardSession ? { fromCardSession: true as const } : {}) };\n}\n\n/**\n * Commits a label or assignee change on a card as an update event for the card's routes. Nothing\n * is committed when nothing changed. `fromCardSession` marks a change Factory made itself, which\n * the dispatcher holds until the card's run ends. The change has already been written to the card,\n * so a stale revision only means another write landed; re-read and commit against it.\n */\n/**\n * How handing an update to the card's routes went: queued (or already queued), nothing to hand\n * over, or not queued (the card is gone or kept changing), in which case the caller must not\n * record the change as seen, so a redelivery or the next sighting hands it over again.\n */\nexport type CardUpdateStatus = 'committed' | 'replayed' | 'unchanged' | 'ignored';\n\nexport async function commitCardUpdate(\n storage: Pick<WorkItemsStorage, 'commitRuleEvaluation' | 'get'>,\n input: {\n orgId: string;\n factoryProjectId: string;\n item: { id: string; revision: number };\n ingress: { identity: string };\n actor: Record<string, unknown>;\n event: BoardEventFacts | undefined;\n fromCardSession: boolean;\n now?: Date;\n },\n): Promise<CardUpdateStatus> {\n if (!input.event) return 'unchanged';\n const decision = cardUpdateDecision(input.ingress.identity, input.event, input.fromCardSession);\n let revision = input.item.revision;\n for (let attempt = 1; attempt <= 3; attempt++) {\n const committed = await storage.commitRuleEvaluation({\n orgId: input.orgId,\n factoryProjectId: input.factoryProjectId,\n workItemId: input.item.id,\n ingress: input.ingress,\n expectedRevision: revision,\n actor: input.actor,\n outcome: { status: 'accepted' },\n decisions: [{ ...decision }],\n causalChain: [],\n now: input.now ?? new Date(),\n });\n if (committed.status === 'committed' || committed.status === 'replayed') return committed.status;\n if (committed.status === 'missing') return 'ignored';\n const current = await storage.get({ orgId: input.orgId, id: input.item.id });\n if (!current) return 'ignored';\n revision = current.revision;\n }\n return 'ignored';\n}\n\n/** The labels and assignees a polled provider last reported for a card's item. */\nconst OBSERVED_ITEM_METADATA_KEY = 'observedItem';\n\nfunction observedItem(\n item: Pick<Card, 'metadata' | 'workItem'>,\n): { labels: string[]; assignees: string[]; observedAt: number | undefined } | undefined {\n const value = item.metadata?.[OBSERVED_ITEM_METADATA_KEY] ?? item.workItem.metadata?.[OBSERVED_ITEM_METADATA_KEY];\n if (!value || typeof value !== 'object') return undefined;\n const list = (entry: unknown) =>\n Array.isArray(entry) ? entry.filter((name): name is string => typeof name === 'string') : [];\n const record = value as Record<string, unknown>;\n const observedAt = typeof record.observedAt === 'string' ? Date.parse(record.observedAt) : Number.NaN;\n return {\n labels: list(record.labels),\n assignees: list(record.assignees),\n observedAt: Number.isNaN(observedAt) ? undefined : observedAt,\n };\n}\n\n/**\n * For a provider that only reports \"the item changed\" (Linear, Jira, incident.io are polled):\n * diffs the item's labels and assignee against the ones the last sighting recorded, records the\n * new ones, and hands the change to the card's routes as a `work_item.updated` event. The first\n * sighting only records them, so cards filed before this existed don't all fire at once. Polling\n * cannot tell who made the change, so it is never held for the card's run.\n */\nexport async function commitObservedChange(\n storage: Pick<WorkItemsStorage, 'commitRuleEvaluation' | 'get' | 'syncCard'>,\n input: {\n orgId: string;\n factoryProjectId: string;\n item: Pick<Card, 'id' | 'revision' | 'metadata' | 'workItem'>;\n ingressId: string;\n actor: Record<string, unknown>;\n labels: readonly string[];\n assignee: string | null;\n /** When the provider last changed the item, as it reported it: older sightings are ignored. */\n observedAt: string;\n /** Provider-specific metadata to record next to the labels and assignees. */\n metadata?: Record<string, unknown>;\n },\n): Promise<CardUpdateStatus> {\n const assignees = input.assignee ? [input.assignee] : [];\n const observedAt = Date.parse(input.observedAt);\n const metadata = {\n ...input.metadata,\n labels: [...input.labels],\n assignees,\n assignee: input.assignee,\n [OBSERVED_ITEM_METADATA_KEY]: { labels: [...input.labels], assignees, observedAt: input.observedAt },\n };\n let item = input.item;\n for (let attempt = 1; attempt <= 3; attempt++) {\n const seen = observedItem(item);\n // A late or replayed sighting older than the one recorded would report its change in reverse.\n if (seen?.observedAt !== undefined && observedAt < seen.observedAt) return 'unchanged';\n // The sighting already recorded: nothing to hand over, nothing new to record.\n if (\n seen?.observedAt === observedAt &&\n sameNames(seen.labels, input.labels) &&\n sameNames(seen.assignees, assignees)\n ) {\n return 'unchanged';\n }\n const event =\n seen &&\n updateEventFacts('work_item.updated', {\n labels: listChange(seen.labels, input.labels),\n assignees: listChange(seen.assignees, assignees),\n });\n // Both writes hold only while the card is at the revision this diff was worked out against,\n // so a concurrent sighting can't record over (or report against) what this one saw.\n if (!event) {\n // Nothing to hand over, but the sighting is still recorded, so an older one arriving later is ignored.\n try {\n await storage.syncCard({\n orgId: input.orgId,\n id: item.id,\n userId: CARD_SYNC_USER_ID,\n patch: { metadata },\n expectedRevision: item.revision,\n });\n return 'unchanged';\n } catch (error) {\n if (!(error instanceof WorkItemUpdateConflictError)) throw error;\n }\n } else {\n // Queued and recorded as seen in one write: a failure leaves neither, so the next sighting hands it over.\n const identity = `${input.ingressId}:update`;\n const committed = await storage.commitRuleEvaluation({\n orgId: input.orgId,\n factoryProjectId: input.factoryProjectId,\n workItemId: item.id,\n ingress: { identity },\n expectedRevision: item.revision,\n actor: input.actor,\n outcome: { status: 'accepted' },\n decisions: [{ ...cardUpdateDecision(identity, event, false) }],\n causalChain: [],\n now: new Date(),\n cardMetadata: { userId: CARD_SYNC_USER_ID, metadata },\n });\n if (committed.status === 'committed' || committed.status === 'replayed') return committed.status;\n if (committed.status === 'missing') return 'ignored';\n }\n // Another write moved the card: diff again against what it left.\n const current = await storage.get({ orgId: input.orgId, id: item.id });\n if (!current) return 'ignored';\n item = current;\n }\n return 'ignored';\n}\n\nconst CARD_SYNC_USER_ID = 'factory-rule-dispatcher';\n\nfunction sameNames(a: readonly string[], b: readonly string[]): boolean {\n return a.length === b.length && a.every((name, index) => name === b[index]);\n}\n\n/**\n * Tells whether a delivery's item was turned away by intake (Not routed): it has no card, but an\n * update to it should run intake again. Storage that keeps Not routed records provides it.\n */\nexport interface NotRoutedLookup {\n isNotRouted(scope: { orgId: string; factoryProjectId: string }, sourceKey: string): Promise<boolean>;\n}\n\n/** A pull or merge request's own card on a board with no pull request loop: Factory doesn't review it there. */\nexport function unreviewedPullRequestCard(context: {\n item?: { readonly source: string };\n flow?: { pullRequestReview?: string };\n}): boolean {\n return context.item !== undefined && isPullRequestCard(context.item) && context.flow?.pullRequestReview === undefined;\n}\n\n/**\n * A merge or close on a board with no pull request loop moves the card only where a route on its\n * board says; there is no move of Factory's own to fall back on.\n */\nexport function routedOnly(\n context: { phase?: { kind: string }; ingress: { id: string } },\n event: 'pull_request.merged' | 'pull_request.closed',\n): FactoryRouteEventDecision | undefined {\n if (context.phase?.kind === 'terminal') return undefined;\n return routeEvent(context.ingress.id, { type: event });\n}\n\n/**\n * A default close handler's answer: the board's `sourceClosed` move, which the project's intake\n * routes replace when a route on the card's board handles closes.\n */\nexport function closedByRoutes<T extends Omit<FactoryTransitionDecision, 'type' | 'event'>>(\n canceled: boolean,\n move: T,\n): FactoryTransitionDecision {\n return { type: 'transition', ...move, event: { type: 'work_item.closed', reason: closeReason(canceled) } };\n}\n\n/**\n * A default pull request handler's answer: the move it decided on, which a route on the card's\n * board naming the event sends elsewhere. A route to the same phase keeps the move as it is\n * (its message, its re-entry).\n */\nexport function pullRequestMoveByRoutes<T extends Omit<FactoryTransitionDecision, 'type' | 'event'>>(\n event: PullRequestEvent,\n move: T,\n): FactoryTransitionDecision {\n return { type: 'transition', ...move, event: { type: event } };\n}\n\n/**\n * A decision carrying a pull request event, tagged with whether that pull request's author has\n * write access (or is Factory): what a route's `pullRequest.trusted` tests.\n */\nexport function withPullRequestTrust(entry: Record<string, unknown>, trusted: boolean): Record<string, unknown> {\n if (entry.type !== 'transition' && entry.type !== 'routeEvent') return entry;\n const event = entry.event as BoardEventFacts | undefined;\n if (!event || !isPullRequestEvent(event.type)) return entry;\n return { ...entry, event: { ...event, pullRequestTrusted: trusted } };\n}\n\n/**\n * A decision the deployment's own handler returned stays its answer: a stock close move it\n * wrapped or reused loses the event tag that would hand it to the project's intake routes.\n */\nexport function withoutRouteEvent(entry: Record<string, unknown>): Record<string, unknown> {\n if (entry.type !== 'transition' || entry.event === undefined) return entry;\n const { event: _event, ...move } = entry;\n return move;\n}\n"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
+ import { reviewedPullRequest } from "../work-items/change-requests.js";
1
2
  import { sourceExternalId } from "../work-items/source-external-id.js";
2
- import { reviewedPullRequest } from "../boards/semantics.js";
3
3
  import "../boards/index.js";
4
4
  import { resolveFactorySessionAddress } from "./binding-context.js";
5
5
  import { phaseGrantsTool } from "./phase-tools.js";
@@ -9,7 +9,9 @@ export declare const RULE_OPERATORS: readonly ['equals', 'not_equals', 'contains
9
9
  export type RuleOperator = (typeof RULE_OPERATORS)[number];
10
10
  export declare const MAX_RULE_GROUP_DEPTH = 3;
11
11
  /** Facts a phase condition can test about a card (see `cardRuleFacts`). */
12
- export declare const CARD_RULE_FIELDS: readonly ['item.labels', 'item.title', 'item.author', 'item.key', 'item.state', 'item.assignees', 'author.trusted', 'source.kind', 'source.integration', 'source.provider', 'source.repository', 'item.pullRequest'];
12
+ export declare const CARD_RULE_FIELDS: readonly ['item.labels', 'item.title', 'item.author', 'item.key', 'item.state', 'item.assignees', 'item.trusted', 'pullRequest.trusted', 'source.kind', 'source.integration', 'source.provider', 'source.repository', 'item.pullRequest', 'item.hasPullRequest', 'item.hasIssue'];
13
+ /** A stored group as it reads today: conditions saved under a renamed field name the new one. */
14
+ export declare function currentRuleGroup<T extends RuleGroup | null | undefined>(group: T): T;
13
15
  export type RuleValue = string | number | boolean | Array<string | number | boolean>;
14
16
  export interface RuleCondition {
15
17
  field: string;
@@ -24,6 +26,21 @@ export type RuleFacts = Readonly<Record<string, unknown>>;
24
26
  /** Zod schema for a rule group whose leaves may only name `fields`. Depth is capped at {@link MAX_RULE_GROUP_DEPTH}. */
25
27
  export declare function ruleGroupSchema(fields: readonly [string, ...string[]]): z.ZodType<RuleGroup>;
26
28
  export declare const cardRuleGroupSchema: z.ZodType<RuleGroup, unknown, z.core.$ZodTypeInternals<RuleGroup, unknown>>;
29
+ /** A condition a rule group failed on, with the fact it read (`null` when the item has none). */
30
+ export interface FailedRuleCondition extends RuleCondition {
31
+ actual: unknown;
32
+ }
33
+ export interface RuleGroupExplanation {
34
+ matched: boolean;
35
+ /** The conditions that made the group fail: every failing one of an AND, every branch of an OR. Empty on a match. */
36
+ failed: FailedRuleCondition[];
37
+ }
38
+ /**
39
+ * Whether `facts` satisfy `group`, and the conditions it failed on when they don't.
40
+ * {@link evaluateRuleGroup} is this without the reasons, so anything that explains a rule
41
+ * decides exactly as the rule does.
42
+ */
43
+ export declare function explainRuleGroup(group: RuleGroup | null | undefined, facts: RuleFacts): RuleGroupExplanation;
27
44
  /** True when `facts` satisfy `group`. A `null`/absent group matches everything (an unconditional phase). */
28
45
  export declare function evaluateRuleGroup(group: RuleGroup | null | undefined, facts: RuleFacts): boolean;
29
46
  //# sourceMappingURL=rule-group.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"rule-group.d.ts","sourceRoot":"","sources":["../../src/rules/rule-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,cAAc,YACzB,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,cAAc,EACd,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,oBAAoB,CACZ,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,YAC3B,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,CACV,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AA4C1D,wHAAwH;AACxH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAa5F;AAED,eAAO,MAAM,mBAAmB,6EAAoC,CAAC;AAgErE,4GAA4G;AAC5G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAMhG"}
1
+ {"version":3,"file":"rule-group.d.ts","sourceRoot":"","sources":["../../src/rules/rule-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,cAAc,YACzB,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,cAAc,EACd,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,oBAAoB,CACZ,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,YAC3B,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,CACP,CAAC;AAUX,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAQpF;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAgD1D,wHAAwH;AACxH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAa5F;AAED,eAAO,MAAM,mBAAmB,6EAAoC,CAAC;AAgErE,iGAAiG;AACjG,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,qHAAqH;IACrH,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,oBAAoB,CAW5G;AAED,4GAA4G;AAC5G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAEhG"}
@@ -31,13 +31,33 @@ const CARD_RULE_FIELDS = [
31
31
  "item.key",
32
32
  "item.state",
33
33
  "item.assignees",
34
- "author.trusted",
34
+ "item.trusted",
35
+ "pullRequest.trusted",
35
36
  "source.kind",
36
37
  "source.integration",
37
38
  "source.provider",
38
39
  "source.repository",
39
- "item.pullRequest"
40
+ "item.pullRequest",
41
+ "item.hasPullRequest",
42
+ "item.hasIssue"
40
43
  ];
44
+ /**
45
+ * Fields renamed since conditions were first saved, by their old name. A stored condition naming
46
+ * one reads, and is tested, as the new field: `author.trusted` became `item.trusted`.
47
+ */
48
+ const RENAMED_FIELDS = { "author.trusted": "item.trusted" };
49
+ const currentField = (field) => RENAMED_FIELDS[field] ?? field;
50
+ /** A stored group as it reads today: conditions saved under a renamed field name the new one. */
51
+ function currentRuleGroup(group) {
52
+ if (!group) return group;
53
+ return {
54
+ ...group,
55
+ conditions: group.conditions.map((member) => "conditions" in member ? currentRuleGroup(member) : {
56
+ ...member,
57
+ field: currentField(member.field)
58
+ })
59
+ };
60
+ }
41
61
  const scalarSchema = z.union([
42
62
  z.string().max(MAX_STRING_VALUE_LENGTH),
43
63
  z.number().finite(),
@@ -54,7 +74,7 @@ const ORDERED = /* @__PURE__ */ new Set([
54
74
  ]);
55
75
  function conditionSchema(fields) {
56
76
  return z.object({
57
- field: z.enum(fields),
77
+ field: z.preprocess((field) => typeof field === "string" ? currentField(field) : field, z.enum(fields)),
58
78
  operator: z.enum(RULE_OPERATORS),
59
79
  value: valueSchema.optional()
60
80
  }).strict().superRefine((condition, ctx) => {
@@ -122,7 +142,7 @@ const matches = (actual, expected) => Array.isArray(actual) ? actual.some((entry
122
142
  * `not_contains` and `not_in`.
123
143
  */
124
144
  function evaluateCondition(condition, facts) {
125
- const actual = facts[condition.field];
145
+ const actual = facts[currentField(condition.field)];
126
146
  const present = actual !== void 0 && actual !== null && !(Array.isArray(actual) && actual.length === 0);
127
147
  const expected = condition.value;
128
148
  switch (condition.operator) {
@@ -140,12 +160,36 @@ function evaluateCondition(condition, facts) {
140
160
  case "less_than_or_equal": return compare(actual, expected, (left, right) => left <= right);
141
161
  }
142
162
  }
163
+ /**
164
+ * Whether `facts` satisfy `group`, and the conditions it failed on when they don't.
165
+ * {@link evaluateRuleGroup} is this without the reasons, so anything that explains a rule
166
+ * decides exactly as the rule does.
167
+ */
168
+ function explainRuleGroup(group, facts) {
169
+ if (!group) return {
170
+ matched: true,
171
+ failed: []
172
+ };
173
+ const results = group.conditions.map((member) => isGroup(member) ? explainRuleGroup(member, facts) : evaluateCondition(member, facts) ? {
174
+ matched: true,
175
+ failed: []
176
+ } : {
177
+ matched: false,
178
+ failed: [{
179
+ ...member,
180
+ actual: facts[currentField(member.field)] ?? null
181
+ }]
182
+ });
183
+ const matched = group.operator === "AND" ? results.every((r) => r.matched) : results.some((r) => r.matched);
184
+ return {
185
+ matched,
186
+ failed: matched ? [] : results.flatMap((r) => r.failed)
187
+ };
188
+ }
143
189
  /** True when `facts` satisfy `group`. A `null`/absent group matches everything (an unconditional phase). */
144
190
  function evaluateRuleGroup(group, facts) {
145
- if (!group) return true;
146
- const results = group.conditions.map((member) => isGroup(member) ? evaluateRuleGroup(member, facts) : evaluateCondition(member, facts));
147
- return group.operator === "AND" ? results.every(Boolean) : results.some(Boolean);
191
+ return explainRuleGroup(group, facts).matched;
148
192
  }
149
- export { CARD_RULE_FIELDS, MAX_RULE_GROUP_DEPTH, RULE_OPERATORS, cardRuleGroupSchema, evaluateRuleGroup, ruleGroupSchema };
193
+ export { CARD_RULE_FIELDS, MAX_RULE_GROUP_DEPTH, RULE_OPERATORS, cardRuleGroupSchema, currentRuleGroup, evaluateRuleGroup, explainRuleGroup, ruleGroupSchema };
150
194
 
151
195
  //# sourceMappingURL=rule-group.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"rule-group.js","names":[],"sources":["../../src/rules/rule-group.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Conditions a board phase tests against a card, such as when it starts on its own or\n * when its exit tool is approved without a person. The shape mirrors the editor's rule\n * groups (`{field, operator, value}` leaves inside AND/OR groups), but Factory owns\n * the types and evaluator; nothing is shared with `@mastra/editor` or `@mastra/server`.\n */\nexport const RULE_OPERATORS = [\n 'equals',\n 'not_equals',\n 'contains',\n 'not_contains',\n 'in',\n 'not_in',\n 'exists',\n 'not_exists',\n 'greater_than',\n 'less_than',\n 'greater_than_or_equal',\n 'less_than_or_equal',\n] as const;\nexport type RuleOperator = (typeof RULE_OPERATORS)[number];\n\nexport const MAX_RULE_GROUP_DEPTH = 3;\nconst MAX_CONDITIONS_PER_GROUP = 20;\nconst MAX_STRING_VALUE_LENGTH = 500;\n\n/** Facts a phase condition can test about a card (see `cardRuleFacts`). */\nexport const CARD_RULE_FIELDS = [\n 'item.labels',\n 'item.title',\n 'item.author',\n 'item.key',\n 'item.state',\n 'item.assignees',\n 'author.trusted',\n 'source.kind',\n 'source.integration',\n 'source.provider',\n 'source.repository',\n 'item.pullRequest',\n] as const;\n\nexport type RuleValue = string | number | boolean | Array<string | number | boolean>;\n\nexport interface RuleCondition {\n field: string;\n operator: RuleOperator;\n value?: RuleValue;\n}\n\nexport interface RuleGroup {\n operator: 'AND' | 'OR';\n conditions: Array<RuleCondition | RuleGroup>;\n}\n\nexport type RuleFacts = Readonly<Record<string, unknown>>;\n\nconst scalarSchema = z.union([z.string().max(MAX_STRING_VALUE_LENGTH), z.number().finite(), z.boolean()]);\nconst valueSchema = z.union([scalarSchema, z.array(scalarSchema).max(100)]);\n\nconst VALUELESS: ReadonlySet<RuleOperator> = new Set(['exists', 'not_exists']);\nconst LIST_VALUE: ReadonlySet<RuleOperator> = new Set(['in', 'not_in']);\nconst ORDERED: ReadonlySet<RuleOperator> = new Set([\n 'greater_than',\n 'less_than',\n 'greater_than_or_equal',\n 'less_than_or_equal',\n]);\n\nfunction conditionSchema(fields: readonly [string, ...string[]]) {\n return z\n .object({ field: z.enum(fields), operator: z.enum(RULE_OPERATORS), value: valueSchema.optional() })\n .strict()\n .superRefine((condition, ctx) => {\n if (VALUELESS.has(condition.operator)) {\n if (condition.value !== undefined) {\n ctx.addIssue({ code: 'custom', path: ['value'], message: `'${condition.operator}' takes no value.` });\n }\n return;\n }\n if (condition.value === undefined) {\n ctx.addIssue({ code: 'custom', path: ['value'], message: `'${condition.operator}' needs a value.` });\n return;\n }\n if (LIST_VALUE.has(condition.operator) !== Array.isArray(condition.value)) {\n ctx.addIssue({\n code: 'custom',\n path: ['value'],\n message: LIST_VALUE.has(condition.operator)\n ? `'${condition.operator}' needs a list value.`\n : `'${condition.operator}' needs a single value.`,\n });\n }\n if (ORDERED.has(condition.operator) && typeof condition.value !== 'number') {\n ctx.addIssue({ code: 'custom', path: ['value'], message: `'${condition.operator}' needs a number.` });\n }\n });\n}\n\n/** Zod schema for a rule group whose leaves may only name `fields`. Depth is capped at {@link MAX_RULE_GROUP_DEPTH}. */\nexport function ruleGroupSchema(fields: readonly [string, ...string[]]): z.ZodType<RuleGroup> {\n const leaf = conditionSchema(fields);\n const groupAt = (depth: number): z.ZodType<RuleGroup> => {\n const member: z.ZodType<RuleCondition | RuleGroup> =\n depth < MAX_RULE_GROUP_DEPTH ? z.union([leaf, z.lazy(() => groupAt(depth + 1))]) : leaf;\n return z\n .object({\n operator: z.enum(['AND', 'OR']),\n conditions: z.array(member).min(1).max(MAX_CONDITIONS_PER_GROUP),\n })\n .strict() as z.ZodType<RuleGroup>;\n };\n return groupAt(1);\n}\n\nexport const cardRuleGroupSchema = ruleGroupSchema(CARD_RULE_FIELDS);\n\nfunction isGroup(member: RuleCondition | RuleGroup): member is RuleGroup {\n return 'conditions' in member;\n}\n\nconst normalize = (value: unknown) => (typeof value === 'string' ? value.trim().toLowerCase() : value);\nconst same = (left: unknown, right: unknown) => normalize(left) === normalize(right);\n\nfunction contains(actual: unknown, expected: unknown): boolean {\n if (Array.isArray(actual)) return actual.some(entry => same(entry, expected));\n if (typeof actual === 'string' && typeof expected === 'string') {\n return actual.toLowerCase().includes(expected.toLowerCase());\n }\n return false;\n}\n\nfunction compare(actual: unknown, expected: unknown, test: (left: number, right: number) => boolean): boolean {\n return typeof actual === 'number' && typeof expected === 'number' && test(actual, expected);\n}\n\n/** Whether `actual` is `expected`; a list fact (labels, assignees) is when one of its members is. */\nconst matches = (actual: unknown, expected: unknown) =>\n Array.isArray(actual) ? actual.some(entry => same(entry, expected)) : same(actual, expected);\n\n/**\n * Evaluate one condition. Strings compare case-insensitively (labels and\n * repository slugs are case-insensitive on every provider Factory reads). A\n * list fact is tested by its members, and an empty list counts as missing. A\n * missing fact fails every operator except `not_exists`, `not_equals`,\n * `not_contains` and `not_in`.\n */\nfunction evaluateCondition(condition: RuleCondition, facts: RuleFacts): boolean {\n const actual = facts[condition.field];\n const present = actual !== undefined && actual !== null && !(Array.isArray(actual) && actual.length === 0);\n const expected = condition.value;\n switch (condition.operator) {\n case 'exists':\n return present;\n case 'not_exists':\n return !present;\n case 'equals':\n return present && matches(actual, expected);\n case 'not_equals':\n return !present || !matches(actual, expected);\n case 'contains':\n return present && contains(actual, expected);\n case 'not_contains':\n return !present || !contains(actual, expected);\n case 'in':\n return present && Array.isArray(expected) && expected.some(candidate => matches(actual, candidate));\n case 'not_in':\n return !present || !Array.isArray(expected) || !expected.some(candidate => matches(actual, candidate));\n case 'greater_than':\n return compare(actual, expected, (left, right) => left > right);\n case 'less_than':\n return compare(actual, expected, (left, right) => left < right);\n case 'greater_than_or_equal':\n return compare(actual, expected, (left, right) => left >= right);\n case 'less_than_or_equal':\n return compare(actual, expected, (left, right) => left <= right);\n }\n}\n\n/** True when `facts` satisfy `group`. A `null`/absent group matches everything (an unconditional phase). */\nexport function evaluateRuleGroup(group: RuleGroup | null | undefined, facts: RuleFacts): boolean {\n if (!group) return true;\n const results = group.conditions.map(member =>\n isGroup(member) ? evaluateRuleGroup(member, facts) : evaluateCondition(member, facts),\n );\n return group.operator === 'AND' ? results.every(Boolean) : results.some(Boolean);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"rule-group.js","names":[],"sources":["../../src/rules/rule-group.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Conditions a board phase tests against a card, such as when it starts on its own or\n * when its exit tool is approved without a person. The shape mirrors the editor's rule\n * groups (`{field, operator, value}` leaves inside AND/OR groups), but Factory owns\n * the types and evaluator; nothing is shared with `@mastra/editor` or `@mastra/server`.\n */\nexport const RULE_OPERATORS = [\n 'equals',\n 'not_equals',\n 'contains',\n 'not_contains',\n 'in',\n 'not_in',\n 'exists',\n 'not_exists',\n 'greater_than',\n 'less_than',\n 'greater_than_or_equal',\n 'less_than_or_equal',\n] as const;\nexport type RuleOperator = (typeof RULE_OPERATORS)[number];\n\nexport const MAX_RULE_GROUP_DEPTH = 3;\nconst MAX_CONDITIONS_PER_GROUP = 20;\nconst MAX_STRING_VALUE_LENGTH = 500;\n\n/** Facts a phase condition can test about a card (see `cardRuleFacts`). */\nexport const CARD_RULE_FIELDS = [\n 'item.labels',\n 'item.title',\n 'item.author',\n 'item.key',\n 'item.state',\n 'item.assignees',\n 'item.trusted',\n 'pullRequest.trusted',\n 'source.kind',\n 'source.integration',\n 'source.provider',\n 'source.repository',\n 'item.pullRequest',\n 'item.hasPullRequest',\n 'item.hasIssue',\n] as const;\n\n/**\n * Fields renamed since conditions were first saved, by their old name. A stored condition naming\n * one reads, and is tested, as the new field: `author.trusted` became `item.trusted`.\n */\nconst RENAMED_FIELDS: Readonly<Record<string, string>> = { 'author.trusted': 'item.trusted' };\n\nconst currentField = (field: string) => RENAMED_FIELDS[field] ?? field;\n\n/** A stored group as it reads today: conditions saved under a renamed field name the new one. */\nexport function currentRuleGroup<T extends RuleGroup | null | undefined>(group: T): T {\n if (!group) return group;\n return {\n ...group,\n conditions: group.conditions.map(member =>\n 'conditions' in member ? currentRuleGroup(member) : { ...member, field: currentField(member.field) },\n ),\n } as T;\n}\n\nexport type RuleValue = string | number | boolean | Array<string | number | boolean>;\n\nexport interface RuleCondition {\n field: string;\n operator: RuleOperator;\n value?: RuleValue;\n}\n\nexport interface RuleGroup {\n operator: 'AND' | 'OR';\n conditions: Array<RuleCondition | RuleGroup>;\n}\n\nexport type RuleFacts = Readonly<Record<string, unknown>>;\n\nconst scalarSchema = z.union([z.string().max(MAX_STRING_VALUE_LENGTH), z.number().finite(), z.boolean()]);\nconst valueSchema = z.union([scalarSchema, z.array(scalarSchema).max(100)]);\n\nconst VALUELESS: ReadonlySet<RuleOperator> = new Set(['exists', 'not_exists']);\nconst LIST_VALUE: ReadonlySet<RuleOperator> = new Set(['in', 'not_in']);\nconst ORDERED: ReadonlySet<RuleOperator> = new Set([\n 'greater_than',\n 'less_than',\n 'greater_than_or_equal',\n 'less_than_or_equal',\n]);\n\nfunction conditionSchema(fields: readonly [string, ...string[]]) {\n return z\n .object({\n field: z.preprocess(field => (typeof field === 'string' ? currentField(field) : field), z.enum(fields)),\n operator: z.enum(RULE_OPERATORS),\n value: valueSchema.optional(),\n })\n .strict()\n .superRefine((condition, ctx) => {\n if (VALUELESS.has(condition.operator)) {\n if (condition.value !== undefined) {\n ctx.addIssue({ code: 'custom', path: ['value'], message: `'${condition.operator}' takes no value.` });\n }\n return;\n }\n if (condition.value === undefined) {\n ctx.addIssue({ code: 'custom', path: ['value'], message: `'${condition.operator}' needs a value.` });\n return;\n }\n if (LIST_VALUE.has(condition.operator) !== Array.isArray(condition.value)) {\n ctx.addIssue({\n code: 'custom',\n path: ['value'],\n message: LIST_VALUE.has(condition.operator)\n ? `'${condition.operator}' needs a list value.`\n : `'${condition.operator}' needs a single value.`,\n });\n }\n if (ORDERED.has(condition.operator) && typeof condition.value !== 'number') {\n ctx.addIssue({ code: 'custom', path: ['value'], message: `'${condition.operator}' needs a number.` });\n }\n });\n}\n\n/** Zod schema for a rule group whose leaves may only name `fields`. Depth is capped at {@link MAX_RULE_GROUP_DEPTH}. */\nexport function ruleGroupSchema(fields: readonly [string, ...string[]]): z.ZodType<RuleGroup> {\n const leaf = conditionSchema(fields);\n const groupAt = (depth: number): z.ZodType<RuleGroup> => {\n const member: z.ZodType<RuleCondition | RuleGroup> =\n depth < MAX_RULE_GROUP_DEPTH ? z.union([leaf, z.lazy(() => groupAt(depth + 1))]) : leaf;\n return z\n .object({\n operator: z.enum(['AND', 'OR']),\n conditions: z.array(member).min(1).max(MAX_CONDITIONS_PER_GROUP),\n })\n .strict() as z.ZodType<RuleGroup>;\n };\n return groupAt(1);\n}\n\nexport const cardRuleGroupSchema = ruleGroupSchema(CARD_RULE_FIELDS);\n\nfunction isGroup(member: RuleCondition | RuleGroup): member is RuleGroup {\n return 'conditions' in member;\n}\n\nconst normalize = (value: unknown) => (typeof value === 'string' ? value.trim().toLowerCase() : value);\nconst same = (left: unknown, right: unknown) => normalize(left) === normalize(right);\n\nfunction contains(actual: unknown, expected: unknown): boolean {\n if (Array.isArray(actual)) return actual.some(entry => same(entry, expected));\n if (typeof actual === 'string' && typeof expected === 'string') {\n return actual.toLowerCase().includes(expected.toLowerCase());\n }\n return false;\n}\n\nfunction compare(actual: unknown, expected: unknown, test: (left: number, right: number) => boolean): boolean {\n return typeof actual === 'number' && typeof expected === 'number' && test(actual, expected);\n}\n\n/** Whether `actual` is `expected`; a list fact (labels, assignees) is when one of its members is. */\nconst matches = (actual: unknown, expected: unknown) =>\n Array.isArray(actual) ? actual.some(entry => same(entry, expected)) : same(actual, expected);\n\n/**\n * Evaluate one condition. Strings compare case-insensitively (labels and\n * repository slugs are case-insensitive on every provider Factory reads). A\n * list fact is tested by its members, and an empty list counts as missing. A\n * missing fact fails every operator except `not_exists`, `not_equals`,\n * `not_contains` and `not_in`.\n */\nfunction evaluateCondition(condition: RuleCondition, facts: RuleFacts): boolean {\n const actual = facts[currentField(condition.field)];\n const present = actual !== undefined && actual !== null && !(Array.isArray(actual) && actual.length === 0);\n const expected = condition.value;\n switch (condition.operator) {\n case 'exists':\n return present;\n case 'not_exists':\n return !present;\n case 'equals':\n return present && matches(actual, expected);\n case 'not_equals':\n return !present || !matches(actual, expected);\n case 'contains':\n return present && contains(actual, expected);\n case 'not_contains':\n return !present || !contains(actual, expected);\n case 'in':\n return present && Array.isArray(expected) && expected.some(candidate => matches(actual, candidate));\n case 'not_in':\n return !present || !Array.isArray(expected) || !expected.some(candidate => matches(actual, candidate));\n case 'greater_than':\n return compare(actual, expected, (left, right) => left > right);\n case 'less_than':\n return compare(actual, expected, (left, right) => left < right);\n case 'greater_than_or_equal':\n return compare(actual, expected, (left, right) => left >= right);\n case 'less_than_or_equal':\n return compare(actual, expected, (left, right) => left <= right);\n }\n}\n\n/** A condition a rule group failed on, with the fact it read (`null` when the item has none). */\nexport interface FailedRuleCondition extends RuleCondition {\n actual: unknown;\n}\n\nexport interface RuleGroupExplanation {\n matched: boolean;\n /** The conditions that made the group fail: every failing one of an AND, every branch of an OR. Empty on a match. */\n failed: FailedRuleCondition[];\n}\n\n/**\n * Whether `facts` satisfy `group`, and the conditions it failed on when they don't.\n * {@link evaluateRuleGroup} is this without the reasons, so anything that explains a rule\n * decides exactly as the rule does.\n */\nexport function explainRuleGroup(group: RuleGroup | null | undefined, facts: RuleFacts): RuleGroupExplanation {\n if (!group) return { matched: true, failed: [] };\n const results = group.conditions.map(member =>\n isGroup(member)\n ? explainRuleGroup(member, facts)\n : evaluateCondition(member, facts)\n ? { matched: true, failed: [] }\n : { matched: false, failed: [{ ...member, actual: facts[currentField(member.field)] ?? null }] },\n );\n const matched = group.operator === 'AND' ? results.every(r => r.matched) : results.some(r => r.matched);\n return { matched, failed: matched ? [] : results.flatMap(r => r.failed) };\n}\n\n/** True when `facts` satisfy `group`. A `null`/absent group matches everything (an unconditional phase). */\nexport function evaluateRuleGroup(group: RuleGroup | null | undefined, facts: RuleFacts): boolean {\n return explainRuleGroup(group, facts).matched;\n}\n"],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Decisions that may start or wake an agent run, or wait for one to end, and so
3
+ * hold a run slot. A transition's message is queued as a separate sendMessage,
4
+ * so a transition stays bookkeeping, and so does a status event's route move:
5
+ * it never waits for a run inline, it hands itself back until the run ends.
6
+ */
7
+ export declare const isRunBearingDecision: (decision: Record<string, unknown>) => boolean;
8
+ //# sourceMappingURL=run-bearing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-bearing.d.ts","sourceRoot":"","sources":["../../src/rules/run-bearing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,aAAc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OACiC,CAAC"}
@@ -0,0 +1,11 @@
1
+ // src/rules/run-bearing.ts
2
+ /**
3
+ * Decisions that may start or wake an agent run, or wait for one to end, and so
4
+ * hold a run slot. A transition's message is queued as a separate sendMessage,
5
+ * so a transition stays bookkeeping, and so does a status event's route move:
6
+ * it never waits for a run inline, it hands itself back until the run ends.
7
+ */
8
+ const isRunBearingDecision = (decision) => decision.type === "invokeSkill" || decision.type === "sendMessage" || decision.type === "signalActivity";
9
+ export { isRunBearingDecision };
10
+
11
+ //# sourceMappingURL=run-bearing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-bearing.js","names":[],"sources":["../../src/rules/run-bearing.ts"],"sourcesContent":["/**\n * Decisions that may start or wake an agent run, or wait for one to end, and so\n * hold a run slot. A transition's message is queued as a separate sendMessage,\n * so a transition stays bookkeeping, and so does a status event's route move:\n * it never waits for a run inline, it hands itself back until the run ends.\n */\nexport const isRunBearingDecision = (decision: Record<string, unknown>): boolean =>\n decision.type === 'invokeSkill' || decision.type === 'sendMessage' || decision.type === 'signalActivity';\n"],"mappings":";;;;;;;AAMA,MAAa,wBAAwB,aACnC,SAAS,SAAS,iBAAiB,SAAS,SAAS,iBAAiB,SAAS,SAAS"}