@mastra/factory 0.29.0-alpha.3 → 0.29.0-alpha.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (399) hide show
  1. package/README.md +123 -64
  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 +7 -39
  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 +27 -1
  48. package/dist/factory.d.ts.map +1 -1
  49. package/dist/factory.js +32 -18
  50. package/dist/factory.js.map +1 -1
  51. package/dist/index.d.ts +0 -1
  52. package/dist/index.d.ts.map +1 -1
  53. package/dist/index.js +1 -2
  54. package/dist/integrations/base.d.ts +9 -0
  55. package/dist/integrations/base.d.ts.map +1 -1
  56. package/dist/integrations/dependabot/rules.d.ts.map +1 -1
  57. package/dist/integrations/dependabot/rules.js +2 -6
  58. package/dist/integrations/dependabot/rules.js.map +1 -1
  59. package/dist/integrations/github/commits.d.ts +0 -21
  60. package/dist/integrations/github/commits.d.ts.map +1 -1
  61. package/dist/integrations/github/commits.js +1 -24
  62. package/dist/integrations/github/commits.js.map +1 -1
  63. package/dist/integrations/github/default-rules.d.ts +22 -1
  64. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  65. package/dist/integrations/github/default-rules.js +23 -5
  66. package/dist/integrations/github/default-rules.js.map +1 -1
  67. package/dist/integrations/github/intake-lookup.d.ts +16 -0
  68. package/dist/integrations/github/intake-lookup.d.ts.map +1 -0
  69. package/dist/integrations/github/intake-lookup.js +76 -0
  70. package/dist/integrations/github/intake-lookup.js.map +1 -0
  71. package/dist/integrations/github/integration.d.ts +20 -6
  72. package/dist/integrations/github/integration.d.ts.map +1 -1
  73. package/dist/integrations/github/integration.js +23 -12
  74. package/dist/integrations/github/integration.js.map +1 -1
  75. package/dist/integrations/github/review-status-reporter.js +1 -1
  76. package/dist/integrations/github/routes.d.ts +1 -11
  77. package/dist/integrations/github/routes.d.ts.map +1 -1
  78. package/dist/integrations/github/routes.js +20 -517
  79. package/dist/integrations/github/routes.js.map +1 -1
  80. package/dist/integrations/github/rules.d.ts +12 -1
  81. package/dist/integrations/github/rules.d.ts.map +1 -1
  82. package/dist/integrations/github/rules.js +275 -38
  83. package/dist/integrations/github/rules.js.map +1 -1
  84. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  85. package/dist/integrations/github/sandbox.js +30 -4
  86. package/dist/integrations/github/sandbox.js.map +1 -1
  87. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  88. package/dist/integrations/gitlab/default-rules.js +19 -3
  89. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  90. package/dist/integrations/gitlab/discovery.d.ts +1 -1
  91. package/dist/integrations/gitlab/discovery.js +1 -1
  92. package/dist/integrations/gitlab/discovery.js.map +1 -1
  93. package/dist/integrations/gitlab/intake-lookup.d.ts +17 -0
  94. package/dist/integrations/gitlab/intake-lookup.d.ts.map +1 -0
  95. package/dist/integrations/gitlab/intake-lookup.js +85 -0
  96. package/dist/integrations/gitlab/intake-lookup.js.map +1 -0
  97. package/dist/integrations/gitlab/integration.d.ts +5 -0
  98. package/dist/integrations/gitlab/integration.d.ts.map +1 -1
  99. package/dist/integrations/gitlab/integration.js +21 -2
  100. package/dist/integrations/gitlab/integration.js.map +1 -1
  101. package/dist/integrations/gitlab/routes.d.ts +0 -2
  102. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  103. package/dist/integrations/gitlab/routes.js +49 -165
  104. package/dist/integrations/gitlab/routes.js.map +1 -1
  105. package/dist/integrations/gitlab/rules.d.ts +20 -0
  106. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  107. package/dist/integrations/gitlab/rules.js +128 -19
  108. package/dist/integrations/gitlab/rules.js.map +1 -1
  109. package/dist/integrations/incidentio/routes.d.ts +5 -5
  110. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  111. package/dist/integrations/incidentio/routes.js +3 -59
  112. package/dist/integrations/incidentio/routes.js.map +1 -1
  113. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  114. package/dist/integrations/incidentio/rules.js +15 -9
  115. package/dist/integrations/incidentio/rules.js.map +1 -1
  116. package/dist/integrations/jira/issue-reconciler.d.ts +1 -1
  117. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  118. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  119. package/dist/integrations/jira/routes.d.ts +2 -2
  120. package/dist/integrations/jira/routes.d.ts.map +1 -1
  121. package/dist/integrations/jira/routes.js +0 -68
  122. package/dist/integrations/jira/routes.js.map +1 -1
  123. package/dist/integrations/jira/rules.d.ts.map +1 -1
  124. package/dist/integrations/jira/rules.js +13 -7
  125. package/dist/integrations/jira/rules.js.map +1 -1
  126. package/dist/integrations/linear/routes.d.ts +2 -2
  127. package/dist/integrations/linear/routes.d.ts.map +1 -1
  128. package/dist/integrations/linear/routes.js +0 -83
  129. package/dist/integrations/linear/routes.js.map +1 -1
  130. package/dist/integrations/linear/rules.d.ts.map +1 -1
  131. package/dist/integrations/linear/rules.js +14 -7
  132. package/dist/integrations/linear/rules.js.map +1 -1
  133. package/dist/integrations/platform/github/event-worker.js +9 -1
  134. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  135. package/dist/integrations/platform/github/integration.d.ts +6 -6
  136. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  137. package/dist/integrations/platform/github/integration.js +23 -6
  138. package/dist/integrations/platform/github/integration.js.map +1 -1
  139. package/dist/integrations/platform/jira/routes.d.ts +2 -2
  140. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  141. package/dist/integrations/platform/jira/routes.js +0 -69
  142. package/dist/integrations/platform/jira/routes.js.map +1 -1
  143. package/dist/integrations/pull-request-head.d.ts +1 -1
  144. package/dist/integrations/pull-request-head.d.ts.map +1 -1
  145. package/dist/integrations/pull-request-head.js +5 -0
  146. package/dist/integrations/pull-request-head.js.map +1 -1
  147. package/dist/integrations/vanta/rules.d.ts.map +1 -1
  148. package/dist/integrations/vanta/rules.js +2 -6
  149. package/dist/integrations/vanta/rules.js.map +1 -1
  150. package/dist/packages/_internals/workspace/dist/index.js.map +1 -1
  151. package/dist/routes/automation-runs.d.ts +0 -2
  152. package/dist/routes/automation-runs.d.ts.map +1 -1
  153. package/dist/routes/automation-runs.js +2 -6
  154. package/dist/routes/automation-runs.js.map +1 -1
  155. package/dist/routes/board-snapshot.d.ts +8 -1
  156. package/dist/routes/board-snapshot.d.ts.map +1 -1
  157. package/dist/routes/board-snapshot.js +33 -7
  158. package/dist/routes/board-snapshot.js.map +1 -1
  159. package/dist/routes/boards.js.map +1 -1
  160. package/dist/routes/config.d.ts +6 -0
  161. package/dist/routes/config.d.ts.map +1 -1
  162. package/dist/routes/config.js +5 -2
  163. package/dist/routes/config.js.map +1 -1
  164. package/dist/routes/contracts.d.ts +1258 -5
  165. package/dist/routes/contracts.d.ts.map +1 -1
  166. package/dist/routes/contracts.js +588 -17
  167. package/dist/routes/contracts.js.map +1 -1
  168. package/dist/routes/fs.d.ts +10 -0
  169. package/dist/routes/fs.d.ts.map +1 -1
  170. package/dist/routes/fs.js +184 -11
  171. package/dist/routes/fs.js.map +1 -1
  172. package/dist/routes/intake-check.d.ts +92 -0
  173. package/dist/routes/intake-check.d.ts.map +1 -0
  174. package/dist/routes/intake-check.js +322 -0
  175. package/dist/routes/intake-check.js.map +1 -0
  176. package/dist/routes/intake-routes.d.ts +10 -2
  177. package/dist/routes/intake-routes.d.ts.map +1 -1
  178. package/dist/routes/intake-routes.js +292 -11
  179. package/dist/routes/intake-routes.js.map +1 -1
  180. package/dist/routes/mastra-gateway.d.ts.map +1 -1
  181. package/dist/routes/mastra-gateway.js +3 -2
  182. package/dist/routes/mastra-gateway.js.map +1 -1
  183. package/dist/routes/project-sessions.d.ts +49 -0
  184. package/dist/routes/project-sessions.d.ts.map +1 -0
  185. package/dist/routes/project-sessions.js +93 -0
  186. package/dist/routes/project-sessions.js.map +1 -0
  187. package/dist/routes/projects.d.ts.map +1 -1
  188. package/dist/routes/projects.js +4 -17
  189. package/dist/routes/projects.js.map +1 -1
  190. package/dist/routes/run-queue.d.ts +6 -6
  191. package/dist/routes/run-queue.d.ts.map +1 -1
  192. package/dist/routes/run-queue.js +28 -8
  193. package/dist/routes/run-queue.js.map +1 -1
  194. package/dist/routes/session-rows.d.ts +30 -0
  195. package/dist/routes/session-rows.d.ts.map +1 -0
  196. package/dist/routes/session-rows.js +98 -0
  197. package/dist/routes/session-rows.js.map +1 -0
  198. package/dist/routes/source-control-sessions.d.ts +4 -8
  199. package/dist/routes/source-control-sessions.d.ts.map +1 -1
  200. package/dist/routes/source-control-sessions.js +8 -106
  201. package/dist/routes/source-control-sessions.js.map +1 -1
  202. package/dist/routes/surface.d.ts +13 -3
  203. package/dist/routes/surface.d.ts.map +1 -1
  204. package/dist/routes/surface.js +25 -38
  205. package/dist/routes/surface.js.map +1 -1
  206. package/dist/routes/work-item-starters.d.ts +1 -0
  207. package/dist/routes/work-item-starters.d.ts.map +1 -1
  208. package/dist/routes/work-item-starters.js +14 -2
  209. package/dist/routes/work-item-starters.js.map +1 -1
  210. package/dist/routes/work-items.d.ts +13 -0
  211. package/dist/routes/work-items.d.ts.map +1 -1
  212. package/dist/routes/work-items.js +87 -34
  213. package/dist/routes/work-items.js.map +1 -1
  214. package/dist/rules/dispatch-errors.js +1 -1
  215. package/dist/rules/dispatch-errors.js.map +1 -1
  216. package/dist/rules/dispatcher.d.ts +39 -7
  217. package/dist/rules/dispatcher.d.ts.map +1 -1
  218. package/dist/rules/dispatcher.js +362 -127
  219. package/dist/rules/dispatcher.js.map +1 -1
  220. package/dist/rules/event-rules.d.ts +69 -1
  221. package/dist/rules/event-rules.d.ts.map +1 -1
  222. package/dist/rules/event-rules.js +151 -5
  223. package/dist/rules/event-rules.js.map +1 -1
  224. package/dist/rules/processor.d.ts.map +1 -1
  225. package/dist/rules/processor.js +1 -6
  226. package/dist/rules/processor.js.map +1 -1
  227. package/dist/rules/review-source-tool.js +1 -1
  228. package/dist/rules/rule-group.d.ts +18 -1
  229. package/dist/rules/rule-group.d.ts.map +1 -1
  230. package/dist/rules/rule-group.js +52 -8
  231. package/dist/rules/rule-group.js.map +1 -1
  232. package/dist/rules/run-bearing.d.ts +8 -0
  233. package/dist/rules/run-bearing.d.ts.map +1 -0
  234. package/dist/rules/run-bearing.js +11 -0
  235. package/dist/rules/run-bearing.js.map +1 -0
  236. package/dist/rules/start-coordinator.d.ts +2 -3
  237. package/dist/rules/start-coordinator.d.ts.map +1 -1
  238. package/dist/rules/start-coordinator.js +27 -35
  239. package/dist/rules/start-coordinator.js.map +1 -1
  240. package/dist/rules/tools.js +2 -1
  241. package/dist/rules/tools.js.map +1 -1
  242. package/dist/rules/transition-service.d.ts +16 -0
  243. package/dist/rules/transition-service.d.ts.map +1 -1
  244. package/dist/rules/transition-service.js +34 -12
  245. package/dist/rules/transition-service.js.map +1 -1
  246. package/dist/rules/types.d.ts +18 -5
  247. package/dist/rules/types.d.ts.map +1 -1
  248. package/dist/rules/types.js +2 -1
  249. package/dist/rules/types.js.map +1 -1
  250. package/dist/rules/update-fold.d.ts +32 -0
  251. package/dist/rules/update-fold.d.ts.map +1 -0
  252. package/dist/rules/update-fold.js +60 -0
  253. package/dist/rules/update-fold.js.map +1 -0
  254. package/dist/rules/validation.d.ts.map +1 -1
  255. package/dist/rules/validation.js +54 -6
  256. package/dist/rules/validation.js.map +1 -1
  257. package/dist/session/resource-migration.d.ts.map +1 -1
  258. package/dist/session/resource-migration.js +2 -3
  259. package/dist/session/resource-migration.js.map +1 -1
  260. package/dist/session/run-audit.d.ts +9 -0
  261. package/dist/session/run-audit.d.ts.map +1 -1
  262. package/dist/session/run-audit.js +9 -1
  263. package/dist/session/run-audit.js.map +1 -1
  264. package/dist/session/self-review-gate.d.ts +26 -2
  265. package/dist/session/self-review-gate.d.ts.map +1 -1
  266. package/dist/session/self-review-gate.js +60 -10
  267. package/dist/session/self-review-gate.js.map +1 -1
  268. package/dist/session/session-row-query.d.ts +25 -0
  269. package/dist/session/session-row-query.d.ts.map +1 -0
  270. package/dist/session/session-row-query.js +47 -0
  271. package/dist/session/session-row-query.js.map +1 -0
  272. package/dist/session/session-row-status.d.ts +16 -0
  273. package/dist/session/session-row-status.d.ts.map +1 -0
  274. package/dist/session/session-row-status.js +14 -0
  275. package/dist/session/session-row-status.js.map +1 -0
  276. package/dist/session/session-row-view.d.ts +14 -0
  277. package/dist/session/session-row-view.d.ts.map +1 -0
  278. package/dist/session/session-row-view.js +125 -0
  279. package/dist/session/session-row-view.js.map +1 -0
  280. package/dist/session/session-rows.d.ts +46 -0
  281. package/dist/session/session-rows.d.ts.map +1 -0
  282. package/dist/session/session-rows.js +232 -0
  283. package/dist/session/session-rows.js.map +1 -0
  284. package/dist/session/session-threads.d.ts.map +1 -1
  285. package/dist/session/session-threads.js +1 -0
  286. package/dist/session/session-threads.js.map +1 -1
  287. package/dist/session/source-control-tools.d.ts +14 -7
  288. package/dist/session/source-control-tools.d.ts.map +1 -1
  289. package/dist/session/source-control-tools.js +10 -2
  290. package/dist/session/source-control-tools.js.map +1 -1
  291. package/dist/session/work-item-repository.d.ts +44 -0
  292. package/dist/session/work-item-repository.d.ts.map +1 -1
  293. package/dist/session/work-item-repository.js +80 -1
  294. package/dist/session/work-item-repository.js.map +1 -1
  295. package/dist/session/work-item-state-processor.d.ts.map +1 -1
  296. package/dist/session/work-item-state-processor.js +44 -8
  297. package/dist/session/work-item-state-processor.js.map +1 -1
  298. package/dist/storage/domains/audit/actions.d.ts +2 -1
  299. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  300. package/dist/storage/domains/audit/actions.js +3 -1
  301. package/dist/storage/domains/audit/actions.js.map +1 -1
  302. package/dist/storage/domains/boards/base.d.ts +162 -14
  303. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  304. package/dist/storage/domains/boards/base.js +415 -41
  305. package/dist/storage/domains/boards/base.js.map +1 -1
  306. package/dist/storage/domains/boards/schemas.d.ts +6 -0
  307. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  308. package/dist/storage/domains/boards/schemas.js +93 -3
  309. package/dist/storage/domains/boards/schemas.js.map +1 -1
  310. package/dist/storage/domains/intake/base.d.ts +11 -10
  311. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  312. package/dist/storage/domains/intake/base.js +30 -65
  313. package/dist/storage/domains/intake/base.js.map +1 -1
  314. package/dist/storage/domains/integrations/base.d.ts +0 -2
  315. package/dist/storage/domains/integrations/base.d.ts.map +1 -1
  316. package/dist/storage/domains/integrations/base.js +0 -6
  317. package/dist/storage/domains/integrations/base.js.map +1 -1
  318. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  319. package/dist/storage/domains/projects/base.js +19 -22
  320. package/dist/storage/domains/projects/base.js.map +1 -1
  321. package/dist/storage/domains/source-control/base.d.ts +0 -10
  322. package/dist/storage/domains/source-control/base.d.ts.map +1 -1
  323. package/dist/storage/domains/source-control/base.js +6 -21
  324. package/dist/storage/domains/source-control/base.js.map +1 -1
  325. package/dist/storage/domains/source-control/inmemory.d.ts +1 -1
  326. package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -1
  327. package/dist/storage/domains/source-control/inmemory.js +1 -6
  328. package/dist/storage/domains/source-control/inmemory.js.map +1 -1
  329. package/dist/storage/domains/work-items/base.d.ts +49 -53
  330. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  331. package/dist/storage/domains/work-items/base.js +152 -156
  332. package/dist/storage/domains/work-items/base.js.map +1 -1
  333. package/dist/storage/domains/work-items/cards.d.ts +3 -2
  334. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  335. package/dist/storage/domains/work-items/cards.js +4 -2
  336. package/dist/storage/domains/work-items/cards.js.map +1 -1
  337. package/dist/storage/domains/work-items/work-item-schema.d.ts +12 -3
  338. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  339. package/dist/storage/domains/work-items/work-item-schema.js +12 -3
  340. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  341. package/dist/storage/legacy-collections.d.ts +9 -0
  342. package/dist/storage/legacy-collections.d.ts.map +1 -0
  343. package/dist/storage/legacy-collections.js +17 -0
  344. package/dist/storage/legacy-collections.js.map +1 -0
  345. package/dist/storage/probed-list.d.ts +11 -0
  346. package/dist/storage/probed-list.d.ts.map +1 -0
  347. package/dist/storage/probed-list.js +52 -0
  348. package/dist/storage/probed-list.js.map +1 -0
  349. package/dist/tools/audit-events-tool.d.ts +2 -2
  350. package/dist/tools/read-tools.d.ts +0 -3
  351. package/dist/tools/read-tools.d.ts.map +1 -1
  352. package/dist/tools/read-tools.js +4 -42
  353. package/dist/tools/read-tools.js.map +1 -1
  354. package/dist/tools/session-tools.d.ts.map +1 -1
  355. package/dist/tools/session-tools.js +5 -9
  356. package/dist/tools/session-tools.js.map +1 -1
  357. package/dist/tools/work-item-tools.d.ts +3 -0
  358. package/dist/tools/work-item-tools.d.ts.map +1 -1
  359. package/dist/tools/work-item-tools.js +8 -4
  360. package/dist/tools/work-item-tools.js.map +1 -1
  361. package/dist/work-item-branch.d.ts +4 -0
  362. package/dist/work-item-branch.d.ts.map +1 -1
  363. package/dist/work-item-branch.js +7 -1
  364. package/dist/work-item-branch.js.map +1 -1
  365. package/dist/work-items/card-context-sessions.d.ts +50 -0
  366. package/dist/work-items/card-context-sessions.d.ts.map +1 -0
  367. package/dist/work-items/card-context-sessions.js +84 -0
  368. package/dist/work-items/card-context-sessions.js.map +1 -0
  369. package/dist/work-items/change-requests.d.ts +87 -0
  370. package/dist/work-items/change-requests.d.ts.map +1 -0
  371. package/dist/work-items/change-requests.js +134 -0
  372. package/dist/work-items/change-requests.js.map +1 -0
  373. package/dist/work-items/create-work-item.d.ts +7 -2
  374. package/dist/work-items/create-work-item.d.ts.map +1 -1
  375. package/dist/work-items/create-work-item.js +44 -13
  376. package/dist/work-items/create-work-item.js.map +1 -1
  377. package/dist/work-items/list-related-cards.d.ts.map +1 -1
  378. package/dist/work-items/list-related-cards.js +1 -1
  379. package/dist/work-items/list-related-cards.js.map +1 -1
  380. package/dist/work-items/providers/github.d.ts.map +1 -1
  381. package/dist/work-items/providers/github.js +1 -0
  382. package/dist/work-items/providers/github.js.map +1 -1
  383. package/dist/workspace.d.ts.map +1 -1
  384. package/dist/workspace.js +1 -3
  385. package/dist/workspace.js.map +1 -1
  386. package/factory-skills/configure-factory-rules/SKILL.md +2 -2
  387. package/factory-skills/factory-build/SKILL.md +1 -1
  388. package/factory-skills/factory-plan/SKILL.md +5 -3
  389. package/factory-skills/factory-self-review/SKILL.md +2 -0
  390. package/factory-skills/factory-triage/SKILL.md +1 -1
  391. package/package.json +10 -10
  392. package/dist/session/filesystem-capture.d.ts +0 -50
  393. package/dist/session/filesystem-capture.d.ts.map +0 -1
  394. package/dist/session/filesystem-capture.js +0 -229
  395. package/dist/session/filesystem-capture.js.map +0 -1
  396. package/dist/storage/domains/filesystem/base.d.ts +0 -30
  397. package/dist/storage/domains/filesystem/base.d.ts.map +0 -1
  398. package/dist/storage/domains/filesystem/base.js +0 -78
  399. package/dist/storage/domains/filesystem/base.js.map +0 -1
@@ -0,0 +1,11 @@
1
+ import type { BoardPhaseKind } from './define-board.js';
2
+ /**
3
+ * The one rule for moving a busy card, shared by the server's transition service and the board UI:
4
+ * while a run is in flight on the card, or queued for it, a person may not move it into a phase that
5
+ * may start another run. Resting and terminal phases start nothing, so closing or parking a busy card
6
+ * stays allowed.
7
+ */
8
+ export declare const BUSY_CARD_MOVE_REFUSAL = "Another run can't start while this card is busy.";
9
+ /** An unknown phase may start a run, so it is held to the busy rule. */
10
+ export declare function phaseMayStartRun(kind: BoardPhaseKind | undefined): boolean;
11
+ //# sourceMappingURL=busy-card.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"busy-card.d.ts","sourceRoot":"","sources":["../../src/boards/busy-card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,qDAAqD,CAAC;AAEzF,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAE1E"}
@@ -0,0 +1,15 @@
1
+ // src/boards/busy-card.ts
2
+ /**
3
+ * The one rule for moving a busy card, shared by the server's transition service and the board UI:
4
+ * while a run is in flight on the card, or queued for it, a person may not move it into a phase that
5
+ * may start another run. Resting and terminal phases start nothing, so closing or parking a busy card
6
+ * stays allowed.
7
+ */
8
+ const BUSY_CARD_MOVE_REFUSAL = "Another run can't start while this card is busy.";
9
+ /** An unknown phase may start a run, so it is held to the busy rule. */
10
+ function phaseMayStartRun(kind) {
11
+ return kind !== "resting" && kind !== "terminal";
12
+ }
13
+ export { BUSY_CARD_MOVE_REFUSAL, phaseMayStartRun };
14
+
15
+ //# sourceMappingURL=busy-card.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"busy-card.js","names":[],"sources":["../../src/boards/busy-card.ts"],"sourcesContent":["import type { BoardPhaseKind } from './define-board.js';\n\n/**\n * The one rule for moving a busy card, shared by the server's transition service and the board UI:\n * while a run is in flight on the card, or queued for it, a person may not move it into a phase that\n * may start another run. Resting and terminal phases start nothing, so closing or parking a busy card\n * stays allowed.\n */\nexport const BUSY_CARD_MOVE_REFUSAL = \"Another run can't start while this card is busy.\";\n\n/** An unknown phase may start a run, so it is held to the busy rule. */\nexport function phaseMayStartRun(kind: BoardPhaseKind | undefined): boolean {\n return kind !== 'resting' && kind !== 'terminal';\n}\n"],"mappings":";;;;;;;AAQA,MAAa,yBAAyB;;AAGtC,SAAgB,iBAAiB,MAA2C;CAC1E,OAAO,SAAS,aAAa,SAAS;AACxC"}
@@ -1 +1 @@
1
- {"version":3,"file":"card-facts.d.ts","sourceRoot":"","sources":["../../src/boards/card-facts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAKlE,KAAK,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC9D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC;AAUzF,sHAAsH;AACtH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,gBAAgB,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,aAAa,CAAA;CAAE,GACvF,SAAS,CA4CX"}
1
+ {"version":3,"file":"card-facts.d.ts","sourceRoot":"","sources":["../../src/boards/card-facts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAYlE,KAAK,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC9D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC;AAUzF,sHAAsH;AACtH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,gBAAgB,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,aAAa,CAAA;CAAE,GACvF,SAAS,CAiFX"}
@@ -1,7 +1,7 @@
1
1
  import { authorTrusted } from "../rules/types.js";
2
+ import { isOpenPullRequestSource, pointedPullRequest, pullRequestSourceNumber, pullRequestSources, trustedPullRequestSource, workingPullRequest } from "../work-items/change-requests.js";
2
3
  import { workItemProviderAdapter } from "../work-items/providers/index.js";
3
4
  import { stringList, stringValue } from "../work-items/providers/metadata-keys.js";
4
- import { newestOpenPullRequestNumber } from "./semantics.js";
5
5
  // src/boards/card-facts.ts
6
6
  /** Who an item is assigned to, as the provider reports it: a list, or the one assignee. */
7
7
  function assignees(metadata) {
@@ -18,8 +18,15 @@ function cardRuleFacts(item) {
18
18
  const normalized = source ? adapter.toSource(source, metadata) : null;
19
19
  const stored = item.workItem;
20
20
  const labels = source ? (stored ?? normalized)?.labels ?? [] : Array.isArray(metadata.labels) ? metadata.labels.filter((label) => typeof label === "string") : [];
21
- const pointer = metadata.openPullRequestNumber;
22
- const pullRequest = typeof pointer === "number" ? pointer : newestOpenPullRequestNumber({ workItem: item.workItem ?? null });
21
+ const sourced = {
22
+ ...item,
23
+ workItem: item.workItem ?? null
24
+ };
25
+ const working = source?.type === "pull-request" ? void 0 : workingPullRequest(sourced);
26
+ const pointer = pointedPullRequest(sourced);
27
+ const pullRequest = typeof pointer === "number" ? pointer : working && isOpenPullRequestSource(working) ? pullRequestSourceNumber(working) ?? null : null;
28
+ const sessionOpened = typeof pointer === "number" && (!working || pullRequestSourceNumber(working) !== pointer);
29
+ const pullRequestTrusted = source?.type === "pull-request" ? authorTrusted(item.metadata) : sessionOpened ? true : working ? trustedPullRequestSource(item, working) : void 0;
23
30
  const author = source ? (stored ?? normalized)?.author ?? null : typeof metadata.author === "string" ? metadata.author : null;
24
31
  const key = stored?.key ?? normalized?.key ?? null;
25
32
  const state = stored?.state ?? normalized?.state ?? null;
@@ -28,6 +35,10 @@ function cardRuleFacts(item) {
28
35
  key,
29
36
  metadata: providerMetadata
30
37
  }) ?? null;
38
+ const sources = item.workItem?.sources ?? [];
39
+ const ownPullRequest = source?.type === "pull-request";
40
+ const attachedOpenPullRequest = typeof pointer === "number" && !ownPullRequest || (ownPullRequest ? pullRequestSources({ workItem: { sources: sources.slice(1) } }).some((entry) => isOpenPullRequestSource(entry) && pullRequestSourceNumber(entry) !== void 0) : pullRequest !== null);
41
+ const linksIssue = pullRequestSources({ workItem: item.workItem ?? null }).length > 0 && sources.some((entry) => entry.sourceType !== "pull-request");
31
42
  return {
32
43
  "item.labels": labels,
33
44
  "item.title": item.title,
@@ -35,8 +46,11 @@ function cardRuleFacts(item) {
35
46
  ...key !== null ? { "item.key": key } : {},
36
47
  ...state !== null ? { "item.state": state } : {},
37
48
  "item.assignees": assignees(source ? providerMetadata : metadata),
38
- "author.trusted": authorTrusted(item.metadata),
49
+ "item.trusted": authorTrusted(item.metadata),
50
+ ...pullRequestTrusted !== void 0 ? { "pullRequest.trusted": pullRequestTrusted } : {},
39
51
  ...pullRequest !== null ? { "item.pullRequest": pullRequest } : {},
52
+ "item.hasPullRequest": attachedOpenPullRequest,
53
+ "item.hasIssue": linksIssue,
40
54
  ...source ? {
41
55
  "source.kind": source.type === "pull-request" ? "pull_request" : source.type,
42
56
  "source.integration": source.integrationId,
@@ -1 +1 @@
1
- {"version":3,"file":"card-facts.js","names":[],"sources":["../../src/boards/card-facts.ts"],"sourcesContent":["import type { RuleFacts } from '../rules/rule-group.js';\nimport { authorTrusted } from '../rules/types.js';\nimport type { Card } from '../storage/domains/work-items/base.js';\nimport { workItemProviderAdapter } from '../work-items/providers/index.js';\nimport { stringList, stringValue } from '../work-items/providers/metadata-keys.js';\nimport { newestOpenPullRequestNumber } from './semantics.js';\n\ntype WorkItemFacts = Pick<Card['workItem'], 'labels' | 'author'> &\n Partial<Pick<Card['workItem'], 'sources' | 'provider' | 'key' | 'state' | 'metadata'>>;\n\n/** Who an item is assigned to, as the provider reports it: a list, or the one assignee. */\nfunction assignees(metadata: Record<string, unknown> | null): string[] {\n const listed = stringList(metadata?.assignees);\n if (listed.length > 0) return listed;\n const one = stringValue(metadata?.assignee);\n return one ? [one] : [];\n}\n\n/** What a condition (`autoStartWhen`, `exitTool.autoApproveWhen`, an intake route's `when`) can test about a card. */\nexport function cardRuleFacts(\n item: Pick<Card, 'title' | 'metadata' | 'externalSource'> & { workItem?: WorkItemFacts },\n): RuleFacts {\n const source = item.externalSource;\n const metadata = item.metadata ?? {};\n const adapter = source ? workItemProviderAdapter(source) : null;\n // A card's work item holds what its provider reported; an arrival not filed yet is normalized\n // from its source and metadata the way its work item will be.\n const normalized = source ? adapter!.toSource(source, metadata) : null;\n const stored = item.workItem;\n const labels = source\n ? ((stored ?? normalized)?.labels ?? [])\n : Array.isArray(metadata.labels)\n ? metadata.labels.filter((label): label is string => typeof label === 'string')\n : [];\n const pointer = metadata.openPullRequestNumber;\n const pullRequest =\n typeof pointer === 'number' ? pointer : newestOpenPullRequestNumber({ workItem: item.workItem ?? null });\n const author = source\n ? ((stored ?? normalized)?.author ?? null)\n : typeof metadata.author === 'string'\n ? metadata.author\n : null;\n const key = stored?.key ?? normalized?.key ?? null;\n const state = stored?.state ?? normalized?.state ?? null;\n const providerMetadata = stored?.metadata ?? normalized?.metadata ?? null;\n const repository = adapter?.repository?.({ key, metadata: providerMetadata }) ?? null;\n return {\n 'item.labels': labels,\n 'item.title': item.title,\n ...(author !== null ? { 'item.author': author } : {}),\n ...(key !== null ? { 'item.key': key } : {}),\n ...(state !== null ? { 'item.state': state } : {}),\n 'item.assignees': assignees(source ? providerMetadata : metadata),\n 'author.trusted': authorTrusted(item.metadata),\n // The open change request: the one Factory opened for the card, else its own or an attached open one.\n ...(pullRequest !== null ? { 'item.pullRequest': pullRequest } : {}),\n ...(source\n ? {\n 'source.kind': source.type === 'pull-request' ? 'pull_request' : source.type,\n 'source.integration': source.integrationId,\n 'source.provider': stored?.provider ?? normalized?.provider ?? source.integrationId,\n ...(repository !== null ? { 'source.repository': repository } : {}),\n }\n : {}),\n };\n}\n"],"mappings":";;;;;;AAWA,SAAS,UAAU,UAAoD;CACrE,MAAM,SAAS,WAAW,UAAU,SAAS;CAC7C,IAAI,OAAO,SAAS,GAAG,OAAO;CAC9B,MAAM,MAAM,YAAY,UAAU,QAAQ;CAC1C,OAAO,MAAM,CAAC,GAAG,IAAI,CAAC;AACxB;;AAGA,SAAgB,cACd,MACW;CACX,MAAM,SAAS,KAAK;CACpB,MAAM,WAAW,KAAK,YAAY,CAAC;CACnC,MAAM,UAAU,SAAS,wBAAwB,MAAM,IAAI;CAG3D,MAAM,aAAa,SAAS,QAAS,SAAS,QAAQ,QAAQ,IAAI;CAClE,MAAM,SAAS,KAAK;CACpB,MAAM,SAAS,UACT,UAAU,WAAA,EAAa,UAAU,CAAC,IACpC,MAAM,QAAQ,SAAS,MAAM,IAC3B,SAAS,OAAO,QAAQ,UAA2B,OAAO,UAAU,QAAQ,IAC5E,CAAC;CACP,MAAM,UAAU,SAAS;CACzB,MAAM,cACJ,OAAO,YAAY,WAAW,UAAU,4BAA4B,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC;CACzG,MAAM,SAAS,UACT,UAAU,WAAA,EAAa,UAAU,OACnC,OAAO,SAAS,WAAW,WACzB,SAAS,SACT;CACN,MAAM,MAAM,QAAQ,OAAO,YAAY,OAAO;CAC9C,MAAM,QAAQ,QAAQ,SAAS,YAAY,SAAS;CACpD,MAAM,mBAAmB,QAAQ,YAAY,YAAY,YAAY;CACrE,MAAM,aAAa,SAAS,aAAa;EAAE;EAAK,UAAU;CAAiB,CAAC,KAAK;CACjF,OAAO;EACL,eAAe;EACf,cAAc,KAAK;EACnB,GAAI,WAAW,OAAO,EAAE,eAAe,OAAO,IAAI,CAAC;EACnD,GAAI,QAAQ,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;EAC1C,GAAI,UAAU,OAAO,EAAE,cAAc,MAAM,IAAI,CAAC;EAChD,kBAAkB,UAAU,SAAS,mBAAmB,QAAQ;EAChE,kBAAkB,cAAc,KAAK,QAAQ;EAE7C,GAAI,gBAAgB,OAAO,EAAE,oBAAoB,YAAY,IAAI,CAAC;EAClE,GAAI,SACA;GACE,eAAe,OAAO,SAAS,iBAAiB,iBAAiB,OAAO;GACxE,sBAAsB,OAAO;GAC7B,mBAAmB,QAAQ,YAAY,YAAY,YAAY,OAAO;GACtE,GAAI,eAAe,OAAO,EAAE,qBAAqB,WAAW,IAAI,CAAC;EACnE,IACA,CAAC;CACP;AACF"}
1
+ {"version":3,"file":"card-facts.js","names":[],"sources":["../../src/boards/card-facts.ts"],"sourcesContent":["import type { RuleFacts } from '../rules/rule-group.js';\nimport { authorTrusted } from '../rules/types.js';\nimport type { Card } from '../storage/domains/work-items/base.js';\nimport {\n isOpenPullRequestSource,\n pointedPullRequest,\n pullRequestSourceNumber,\n pullRequestSources,\n trustedPullRequestSource,\n workingPullRequest,\n} from '../work-items/change-requests.js';\nimport { workItemProviderAdapter } from '../work-items/providers/index.js';\nimport { stringList, stringValue } from '../work-items/providers/metadata-keys.js';\n\ntype WorkItemFacts = Pick<Card['workItem'], 'labels' | 'author'> &\n Partial<Pick<Card['workItem'], 'sources' | 'provider' | 'key' | 'state' | 'metadata'>>;\n\n/** Who an item is assigned to, as the provider reports it: a list, or the one assignee. */\nfunction assignees(metadata: Record<string, unknown> | null): string[] {\n const listed = stringList(metadata?.assignees);\n if (listed.length > 0) return listed;\n const one = stringValue(metadata?.assignee);\n return one ? [one] : [];\n}\n\n/** What a condition (`autoStartWhen`, `exitTool.autoApproveWhen`, an intake route's `when`) can test about a card. */\nexport function cardRuleFacts(\n item: Pick<Card, 'title' | 'metadata' | 'externalSource'> & { workItem?: WorkItemFacts },\n): RuleFacts {\n const source = item.externalSource;\n const metadata = item.metadata ?? {};\n const adapter = source ? workItemProviderAdapter(source) : null;\n // A card's work item holds what its provider reported; an arrival not filed yet is normalized\n // from its source and metadata the way its work item will be.\n const normalized = source ? adapter!.toSource(source, metadata) : null;\n const stored = item.workItem;\n const labels = source\n ? ((stored ?? normalized)?.labels ?? [])\n : Array.isArray(metadata.labels)\n ? metadata.labels.filter((label): label is string => typeof label === 'string')\n : [];\n // The card's working pull request: a pull request's own card is its own; an issue card's is\n // the attached one it works on, and trusted unless a person picked an outsider's.\n const sourced = { ...item, workItem: item.workItem ?? null };\n const working = source?.type === 'pull-request' ? undefined : workingPullRequest(sourced);\n // Number, trust and presence all describe the working pull request: a pointer to a linked one\n // that closed unmerged gives way to it.\n const pointer = pointedPullRequest(sourced);\n const pullRequest =\n typeof pointer === 'number'\n ? pointer\n : working && isOpenPullRequestSource(working)\n ? (pullRequestSourceNumber(working) ?? null)\n : null;\n // A pointer the card has no source for is the pull request its session opened: Factory's own.\n const sessionOpened = typeof pointer === 'number' && (!working || pullRequestSourceNumber(working) !== pointer);\n const pullRequestTrusted =\n source?.type === 'pull-request'\n ? authorTrusted(item.metadata)\n : sessionOpened\n ? true\n : working\n ? trustedPullRequestSource(item, working)\n : undefined;\n const author = source\n ? ((stored ?? normalized)?.author ?? null)\n : typeof metadata.author === 'string'\n ? metadata.author\n : null;\n const key = stored?.key ?? normalized?.key ?? null;\n const state = stored?.state ?? normalized?.state ?? null;\n const providerMetadata = stored?.metadata ?? normalized?.metadata ?? null;\n const repository = adapter?.repository?.({ key, metadata: providerMetadata }) ?? null;\n const sources = item.workItem?.sources ?? [];\n // A pull request's own card is the pull request: only one attached alongside its own source counts.\n const ownPullRequest = source?.type === 'pull-request';\n const attachedOpenPullRequest =\n (typeof pointer === 'number' && !ownPullRequest) ||\n (ownPullRequest\n ? pullRequestSources({ workItem: { sources: sources.slice(1) } }).some(\n entry => isOpenPullRequestSource(entry) && pullRequestSourceNumber(entry) !== undefined,\n )\n : pullRequest !== null);\n // A pull request linked to an issue: the card holds both a pull request and an issue source.\n const linksIssue =\n pullRequestSources({ workItem: item.workItem ?? null }).length > 0 &&\n sources.some(entry => entry.sourceType !== 'pull-request');\n return {\n 'item.labels': labels,\n 'item.title': item.title,\n ...(author !== null ? { 'item.author': author } : {}),\n ...(key !== null ? { 'item.key': key } : {}),\n ...(state !== null ? { 'item.state': state } : {}),\n 'item.assignees': assignees(source ? providerMetadata : metadata),\n 'item.trusted': authorTrusted(item.metadata),\n ...(pullRequestTrusted !== undefined ? { 'pullRequest.trusted': pullRequestTrusted } : {}),\n // The open change request: the one Factory opened for the card, else its own or an attached open one.\n ...(pullRequest !== null ? { 'item.pullRequest': pullRequest } : {}),\n 'item.hasPullRequest': attachedOpenPullRequest,\n 'item.hasIssue': linksIssue,\n ...(source\n ? {\n 'source.kind': source.type === 'pull-request' ? 'pull_request' : source.type,\n 'source.integration': source.integrationId,\n 'source.provider': stored?.provider ?? normalized?.provider ?? source.integrationId,\n ...(repository !== null ? { 'source.repository': repository } : {}),\n }\n : {}),\n };\n}\n"],"mappings":";;;;;;AAkBA,SAAS,UAAU,UAAoD;CACrE,MAAM,SAAS,WAAW,UAAU,SAAS;CAC7C,IAAI,OAAO,SAAS,GAAG,OAAO;CAC9B,MAAM,MAAM,YAAY,UAAU,QAAQ;CAC1C,OAAO,MAAM,CAAC,GAAG,IAAI,CAAC;AACxB;;AAGA,SAAgB,cACd,MACW;CACX,MAAM,SAAS,KAAK;CACpB,MAAM,WAAW,KAAK,YAAY,CAAC;CACnC,MAAM,UAAU,SAAS,wBAAwB,MAAM,IAAI;CAG3D,MAAM,aAAa,SAAS,QAAS,SAAS,QAAQ,QAAQ,IAAI;CAClE,MAAM,SAAS,KAAK;CACpB,MAAM,SAAS,UACT,UAAU,WAAA,EAAa,UAAU,CAAC,IACpC,MAAM,QAAQ,SAAS,MAAM,IAC3B,SAAS,OAAO,QAAQ,UAA2B,OAAO,UAAU,QAAQ,IAC5E,CAAC;CAGP,MAAM,UAAU;EAAE,GAAG;EAAM,UAAU,KAAK,YAAY;CAAK;CAC3D,MAAM,UAAU,QAAQ,SAAS,iBAAiB,KAAA,IAAY,mBAAmB,OAAO;CAGxF,MAAM,UAAU,mBAAmB,OAAO;CAC1C,MAAM,cACJ,OAAO,YAAY,WACf,UACA,WAAW,wBAAwB,OAAO,IACvC,wBAAwB,OAAO,KAAK,OACrC;CAER,MAAM,gBAAgB,OAAO,YAAY,aAAa,CAAC,WAAW,wBAAwB,OAAO,MAAM;CACvG,MAAM,qBACJ,QAAQ,SAAS,iBACb,cAAc,KAAK,QAAQ,IAC3B,gBACE,OACA,UACE,yBAAyB,MAAM,OAAO,IACtC,KAAA;CACV,MAAM,SAAS,UACT,UAAU,WAAA,EAAa,UAAU,OACnC,OAAO,SAAS,WAAW,WACzB,SAAS,SACT;CACN,MAAM,MAAM,QAAQ,OAAO,YAAY,OAAO;CAC9C,MAAM,QAAQ,QAAQ,SAAS,YAAY,SAAS;CACpD,MAAM,mBAAmB,QAAQ,YAAY,YAAY,YAAY;CACrE,MAAM,aAAa,SAAS,aAAa;EAAE;EAAK,UAAU;CAAiB,CAAC,KAAK;CACjF,MAAM,UAAU,KAAK,UAAU,WAAW,CAAC;CAE3C,MAAM,iBAAiB,QAAQ,SAAS;CACxC,MAAM,0BACH,OAAO,YAAY,YAAY,CAAC,mBAChC,iBACG,mBAAmB,EAAE,UAAU,EAAE,SAAS,QAAQ,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAC9D,UAAS,wBAAwB,KAAK,KAAK,wBAAwB,KAAK,MAAM,KAAA,CAChF,IACA,gBAAgB;CAEtB,MAAM,aACJ,mBAAmB,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,KACjE,QAAQ,MAAK,UAAS,MAAM,eAAe,cAAc;CAC3D,OAAO;EACL,eAAe;EACf,cAAc,KAAK;EACnB,GAAI,WAAW,OAAO,EAAE,eAAe,OAAO,IAAI,CAAC;EACnD,GAAI,QAAQ,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;EAC1C,GAAI,UAAU,OAAO,EAAE,cAAc,MAAM,IAAI,CAAC;EAChD,kBAAkB,UAAU,SAAS,mBAAmB,QAAQ;EAChE,gBAAgB,cAAc,KAAK,QAAQ;EAC3C,GAAI,uBAAuB,KAAA,IAAY,EAAE,uBAAuB,mBAAmB,IAAI,CAAC;EAExF,GAAI,gBAAgB,OAAO,EAAE,oBAAoB,YAAY,IAAI,CAAC;EAClE,uBAAuB;EACvB,iBAAiB;EACjB,GAAI,SACA;GACE,eAAe,OAAO,SAAS,iBAAiB,iBAAiB,OAAO;GACxE,sBAAsB,OAAO;GAC7B,mBAAmB,QAAQ,YAAY,YAAY,YAAY,OAAO;GACtE,GAAI,eAAe,OAAO,EAAE,qBAAqB,WAAW,IAAI,CAAC;EACnE,IACA,CAAC;CACP;AACF"}
@@ -2,8 +2,9 @@ export { BoardDefinitionError, DEFAULT_PHASE_CONTEXT, defineBoard, FACTORY_AGENT
2
2
  export { DEFAULT_BOARD_ID } from './default-board.js';
3
3
  export { cardRuleFacts } from './card-facts.js';
4
4
  export type { BoardDefinition, BoardEventIntegration, BoardEventRules, BoardPhase, BoardPhaseDefinition, BoardPhaseExitTool, BoardPhaseKind, BoardPhaseGoal, BoardPhaseRunner, FactoryPhaseTool, BoardSourceClosed, BoardToolResultRuleHandler, BoardToolRule, BoardToolRules, BoardTransition, } from './define-board.js';
5
- export { boardEventHandlers, awaitsAcceptance, boardFlow, boardPhaseOutcomes, boardForWorkItem, cardBoardFlow, boundChangeRequestNumber, eventBoardId, cardOwnsBranch, hasPullRequest, isPullRequestCard, isPullRequestReviewPhase, isTerminalWorkItem, newestOpenPullRequestNumber, newestOwnedOpenPullRequestNumber, pullRequestSourceNumber, pullRequestSources, resolveBoardClosure, reviewedChangeRequest, reviewedPullRequest, sourceExternalId, reviewsPullRequest, resolveBoardToolRule, rulePhaseContext, rulePhaseField, resolvePhaseSemantics, withBoardClosure, withBoardFlow, intakeTarget, withIntakeTarget, workItemPhaseSemantics, } from './semantics.js';
5
+ export { boardEventHandlers, awaitsAcceptance, boardFlow, boardPhaseOutcomes, boardForWorkItem, cardBoardFlow, boundChangeRequestNumber, eventBoardId, cardOwnsBranch, hasPullRequest, isPullRequestReviewPhase, isTerminalWorkItem, newestOwnedOpenPullRequestNumber, resolveBoardClosure, reviewedChangeRequest, sourceExternalId, reviewsPullRequest, resolveBoardToolRule, rulePhaseContext, rulePhaseField, resolvePhaseSemantics, withBoardClosure, withBoardFlow, intakeTarget, withIntakeTarget, workItemPhaseSemantics, } from './semantics.js';
6
6
  export type { PhaseSemantics, ReviewedChangeRequest } from './semantics.js';
7
+ export { isOpenPullRequestSource, isPullRequestCard, pullRequestSourceNumber, pullRequestSources, pullRequestTrustKey, reviewedPullRequest, trustedPullRequestSource, UNTRUSTED_PULL_REQUESTS_KEY, workingPullRequest, } from '../work-items/change-requests.js';
7
8
  export type { BoardTransitionPolicy, BoardTransitionPolicyContext, BoardTransitionPolicyResult, } from './transition-policy.js';
8
9
  export { boardRegistryOf, createBoardRegistry, defaultBoards } from './registry.js';
9
10
  export type { BoardRegistry, InstalledBoard } from './registry.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,2BAA2B,EAC3B,gCAAgC,EAChC,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,gCAAgC,EAChC,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}
@@ -1,8 +1,9 @@
1
1
  import { BoardDefinitionError, DEFAULT_PHASE_CONTEXT, FACTORY_AGENT_ID, REVIEW_CONTEXT, defineBoard } from "./define-board.js";
2
2
  import { DEFAULT_BOARD_ID } from "./default-board.js";
3
3
  import { cardRuleFacts } from "./card-facts.js";
4
- import { awaitsAcceptance, boardEventHandlers, boardFlow, boardForWorkItem, boardPhaseOutcomes, boundChangeRequestNumber, cardBoardFlow, cardOwnsBranch, eventBoardId, hasPullRequest, intakeTarget, isPullRequestCard, isPullRequestReviewPhase, isTerminalWorkItem, newestOpenPullRequestNumber, newestOwnedOpenPullRequestNumber, pullRequestSourceNumber, pullRequestSources, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, reviewedChangeRequest, reviewedPullRequest, reviewsPullRequest, rulePhaseContext, rulePhaseField, withBoardClosure, withBoardFlow, withIntakeTarget, workItemPhaseSemantics } from "./semantics.js";
4
+ import { awaitsAcceptance, boardEventHandlers, boardFlow, boardForWorkItem, boardPhaseOutcomes, boundChangeRequestNumber, cardBoardFlow, cardOwnsBranch, eventBoardId, hasPullRequest, intakeTarget, isPullRequestReviewPhase, isTerminalWorkItem, newestOwnedOpenPullRequestNumber, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, reviewedChangeRequest, reviewsPullRequest, rulePhaseContext, rulePhaseField, withBoardClosure, withBoardFlow, withIntakeTarget, workItemPhaseSemantics } from "./semantics.js";
5
+ import { UNTRUSTED_PULL_REQUESTS_KEY, isOpenPullRequestSource, isPullRequestCard, pullRequestSourceNumber, pullRequestSources, pullRequestTrustKey, reviewedPullRequest, trustedPullRequestSource, workingPullRequest } from "../work-items/change-requests.js";
5
6
  import { sourceExternalId } from "../work-items/source-external-id.js";
6
7
  import { boardRegistryOf, createBoardRegistry, defaultBoards } from "./registry.js";
7
8
  import { workBoard } from "./work.js";
8
- export { BoardDefinitionError, DEFAULT_BOARD_ID, DEFAULT_PHASE_CONTEXT, FACTORY_AGENT_ID, REVIEW_CONTEXT, awaitsAcceptance, boardEventHandlers, boardFlow, boardForWorkItem, boardPhaseOutcomes, boardRegistryOf, boundChangeRequestNumber, cardBoardFlow, cardOwnsBranch, cardRuleFacts, createBoardRegistry, defaultBoards, defineBoard, eventBoardId, hasPullRequest, intakeTarget, isPullRequestCard, isPullRequestReviewPhase, isTerminalWorkItem, newestOpenPullRequestNumber, newestOwnedOpenPullRequestNumber, pullRequestSourceNumber, pullRequestSources, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, reviewedChangeRequest, reviewedPullRequest, reviewsPullRequest, rulePhaseContext, rulePhaseField, sourceExternalId, withBoardClosure, withBoardFlow, withIntakeTarget, workBoard, workItemPhaseSemantics };
9
+ export { BoardDefinitionError, DEFAULT_BOARD_ID, DEFAULT_PHASE_CONTEXT, FACTORY_AGENT_ID, REVIEW_CONTEXT, UNTRUSTED_PULL_REQUESTS_KEY, awaitsAcceptance, boardEventHandlers, boardFlow, boardForWorkItem, boardPhaseOutcomes, boardRegistryOf, boundChangeRequestNumber, cardBoardFlow, cardOwnsBranch, cardRuleFacts, createBoardRegistry, defaultBoards, defineBoard, eventBoardId, hasPullRequest, intakeTarget, isOpenPullRequestSource, isPullRequestCard, isPullRequestReviewPhase, isTerminalWorkItem, newestOwnedOpenPullRequestNumber, pullRequestSourceNumber, pullRequestSources, pullRequestTrustKey, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, reviewedChangeRequest, reviewedPullRequest, reviewsPullRequest, rulePhaseContext, rulePhaseField, sourceExternalId, trustedPullRequestSource, withBoardClosure, withBoardFlow, withIntakeTarget, workBoard, workItemPhaseSemantics, workingPullRequest };
@@ -0,0 +1,109 @@
1
+ /**
2
+ * The intake dry run: today's rules, or edits not saved yet, run over the project's recent items
3
+ * from their stored facts. Nothing is fetched and nothing is written. Each item is decided by
4
+ * {@link traceIntakeOrder}, the intake order evaluator's own code, so the dry run shows what filing
5
+ * under `intake-order` would do. A project still on `route-list` files differently.
6
+ */
7
+ import type { RuleFacts } from '../rules/rule-group.js';
8
+ import type { StoredIntakeDecisionRecord, StoredIntakeRouteRecord } from '../storage/domains/boards/base.js';
9
+ import type { Card } from '../storage/domains/work-items/base.js';
10
+ import type { BoardRegistry } from './registry.js';
11
+ type IntakeRoute = Pick<StoredIntakeRouteRecord, 'id' | 'enabled' | 'when' | 'target' | 'on'> & Partial<Pick<StoredIntakeRouteRecord, 'name'>>;
12
+ /** One recent item the dry run decides: a card from outside, or an item no board took. */
13
+ export interface IntakeSampleItem {
14
+ /** The item's source key, unique among the sample. */
15
+ key: string;
16
+ /** The card's id, or the Not routed decision's. */
17
+ id: string;
18
+ kind: 'card' | 'not_routed';
19
+ title: string;
20
+ url: string | null;
21
+ /** When it arrived. */
22
+ at: Date;
23
+ facts: RuleFacts;
24
+ }
25
+ /**
26
+ * The project's newest {@link INTAKE_ORDER_SAMPLE} items from outside: cards filed from a source,
27
+ * and items no board took. Cards read as stored, so a pull request card lacks the closed-issue facts
28
+ * it was filed with; a Not routed item keeps its whole arrival and reads them as Route again does.
29
+ */
30
+ export declare function intakeSample(context: {
31
+ cards: readonly Card[];
32
+ notRouted: readonly StoredIntakeDecisionRecord[];
33
+ factoryProjectId: string;
34
+ registry: BoardRegistry;
35
+ card(id: string): Promise<Card | null>;
36
+ }): Promise<IntakeSampleItem[]>;
37
+ export interface IntakeDryRunPlacement {
38
+ boardKey: string;
39
+ routeId: string;
40
+ phase: string;
41
+ }
42
+ export interface IntakeDryRunItem {
43
+ key: string;
44
+ id: string;
45
+ kind: IntakeSampleItem['kind'];
46
+ title: string;
47
+ url: string | null;
48
+ /** Where it would land; null when no board takes it. */
49
+ placement: IntakeDryRunPlacement | null;
50
+ /** Every rule that matched and could take it, in the order intake asked them; the first won. */
51
+ matched: {
52
+ boardKey: string;
53
+ routeId: string;
54
+ }[];
55
+ /** With a baseline: where today's saved rules and order put it. */
56
+ before?: IntakeDryRunPlacement | null;
57
+ }
58
+ export interface IntakeDryRunRule {
59
+ routeId: string;
60
+ name: string | null;
61
+ enabled: boolean;
62
+ /** Keys of the items it would take. */
63
+ takes: string[];
64
+ /** Items it matched but an earlier rule took, by the board that took them. */
65
+ lost: {
66
+ boardKey: string;
67
+ keys: string[];
68
+ }[];
69
+ /** Cards it actually filed in the last 30 days, from the decision log; set when asked for. */
70
+ filed?: number;
71
+ }
72
+ export interface IntakeDryRunBoard {
73
+ boardKey: string;
74
+ name: string;
75
+ /** Keys of the items the board would take. */
76
+ takes: string[];
77
+ /** Items one of its rules matched that another board took first, by that board. */
78
+ lostTo: {
79
+ boardKey: string;
80
+ keys: string[];
81
+ }[];
82
+ rules: IntakeDryRunRule[];
83
+ }
84
+ export interface IntakeDryRunResult {
85
+ /** How many recent items were decided. */
86
+ sampled: number;
87
+ boards: IntakeDryRunBoard[];
88
+ /** Keys of the items no board would take. */
89
+ notRouted: string[];
90
+ /** With a baseline: how many items land on another board or phase than today's rules put them. */
91
+ changed?: number;
92
+ items: IntakeDryRunItem[];
93
+ }
94
+ export interface IntakeDryRunQuery {
95
+ routes: readonly IntakeRoute[];
96
+ order: readonly string[];
97
+ registry: BoardRegistry;
98
+ items: readonly IntakeSampleItem[];
99
+ /** Today's saved rules and order, to report what the edit changes. */
100
+ baseline?: {
101
+ routes: readonly IntakeRoute[];
102
+ order: readonly string[];
103
+ };
104
+ /** Cards each rule filed in the last 30 days. */
105
+ filed?: Record<string, number>;
106
+ }
107
+ export declare function dryRunIntake(query: IntakeDryRunQuery): IntakeDryRunResult;
108
+ export {};
109
+ //# sourceMappingURL=intake-dry-run.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intake-dry-run.d.ts","sourceRoot":"","sources":["../../src/boards/intake-dry-run.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,158 @@
1
+ import { cardRuleFacts } from "./card-facts.js";
2
+ import { arrivalRuleFacts, traceIntakeOrder } from "./intake-routing.js";
3
+ // src/boards/intake-dry-run.ts
4
+ /**
5
+ * The project's newest {@link INTAKE_ORDER_SAMPLE} items from outside: cards filed from a source,
6
+ * and items no board took. Cards read as stored, so a pull request card lacks the closed-issue facts
7
+ * it was filed with; a Not routed item keeps its whole arrival and reads them as Route again does.
8
+ */
9
+ async function intakeSample(context) {
10
+ const items = [];
11
+ for (const card of context.cards) {
12
+ if (!card.externalSource) continue;
13
+ items.push({
14
+ key: card.externalSource.externalId,
15
+ id: card.id,
16
+ kind: "card",
17
+ title: card.title,
18
+ url: card.externalSource.url ?? null,
19
+ at: card.createdAt,
20
+ facts: cardRuleFacts(card)
21
+ });
22
+ }
23
+ for (const decision of context.notRouted) {
24
+ if (!decision.arrival || !decision.sourceKey) continue;
25
+ items.push({
26
+ key: decision.sourceKey,
27
+ id: decision.id,
28
+ kind: "not_routed",
29
+ title: decision.title,
30
+ url: decision.url,
31
+ at: decision.decidedAt,
32
+ facts: await arrivalRuleFacts(decision.arrival, context)
33
+ });
34
+ }
35
+ items.sort((left, right) => right.at.getTime() - left.at.getTime());
36
+ const seen = /* @__PURE__ */ new Set();
37
+ return items.filter((item) => {
38
+ if (seen.has(item.key)) return false;
39
+ seen.add(item.key);
40
+ return true;
41
+ }).slice(0, 200);
42
+ }
43
+ function placementOf(trace) {
44
+ const { resolution } = trace;
45
+ if (resolution.outcome !== "placed" || resolution.routeId === null) return null;
46
+ return {
47
+ boardKey: resolution.board,
48
+ routeId: resolution.routeId,
49
+ phase: resolution.phase
50
+ };
51
+ }
52
+ /** Whether both land in the same place; which rule put it there doesn't matter. */
53
+ function sameLanding(left, right) {
54
+ return left?.boardKey === right?.boardKey && left?.phase === right?.phase;
55
+ }
56
+ function pushKey(groups, boardKey, key) {
57
+ const group = groups.find((entry) => entry.boardKey === boardKey);
58
+ if (group) group.keys.push(key);
59
+ else groups.push({
60
+ boardKey,
61
+ keys: [key]
62
+ });
63
+ }
64
+ function dryRunIntake(query) {
65
+ const { routes, order, registry, items, baseline, filed } = query;
66
+ const boards = /* @__PURE__ */ new Map();
67
+ const rules = /* @__PURE__ */ new Map();
68
+ for (const boardTrace of traceIntakeOrder({
69
+ routes,
70
+ order,
71
+ facts: {},
72
+ registry
73
+ }, { full: true }).boards) {
74
+ const board = {
75
+ boardKey: boardTrace.boardKey,
76
+ name: boardTrace.name,
77
+ takes: [],
78
+ lostTo: [],
79
+ rules: []
80
+ };
81
+ boards.set(board.boardKey, board);
82
+ for (const ruleTrace of boardTrace.rules) {
83
+ const rule = {
84
+ routeId: ruleTrace.routeId,
85
+ name: ruleTrace.name,
86
+ enabled: ruleTrace.outcome !== "disabled",
87
+ takes: [],
88
+ lost: [],
89
+ ...filed && { filed: filed[ruleTrace.routeId] ?? 0 }
90
+ };
91
+ rules.set(rule.routeId, rule);
92
+ board.rules.push(rule);
93
+ }
94
+ }
95
+ const notRouted = [];
96
+ const decided = [];
97
+ let changed = 0;
98
+ for (const item of items) {
99
+ const trace = traceIntakeOrder({
100
+ routes,
101
+ order,
102
+ facts: item.facts,
103
+ registry
104
+ }, { full: true });
105
+ const placement = placementOf(trace);
106
+ const matched = [];
107
+ for (const boardTrace of trace.boards) {
108
+ const board = boards.get(boardTrace.boardKey);
109
+ let lostToAnother = false;
110
+ for (const ruleTrace of boardTrace.rules) {
111
+ const rule = rules.get(ruleTrace.routeId);
112
+ if (ruleTrace.outcome === "took") {
113
+ rule.takes.push(item.key);
114
+ board.takes.push(item.key);
115
+ } else if (ruleTrace.outcome === "lost") {
116
+ pushKey(rule.lost, ruleTrace.to.boardKey, item.key);
117
+ if (ruleTrace.to.boardKey !== board.boardKey) lostToAnother = true;
118
+ } else continue;
119
+ matched.push({
120
+ boardKey: board.boardKey,
121
+ routeId: rule.routeId
122
+ });
123
+ }
124
+ if (lostToAnother && placement) pushKey(board.lostTo, placement.boardKey, item.key);
125
+ }
126
+ if (!placement) notRouted.push(item.key);
127
+ const entry = {
128
+ key: item.key,
129
+ id: item.id,
130
+ kind: item.kind,
131
+ title: item.title,
132
+ url: item.url,
133
+ placement,
134
+ matched
135
+ };
136
+ if (baseline) {
137
+ const before = placementOf(traceIntakeOrder({
138
+ routes: baseline.routes,
139
+ order: baseline.order,
140
+ facts: item.facts,
141
+ registry
142
+ }));
143
+ entry.before = before;
144
+ if (!sameLanding(before, placement)) changed += 1;
145
+ }
146
+ decided.push(entry);
147
+ }
148
+ return {
149
+ sampled: items.length,
150
+ boards: [...boards.values()],
151
+ notRouted,
152
+ ...baseline && { changed },
153
+ items: decided
154
+ };
155
+ }
156
+ export { dryRunIntake, intakeSample };
157
+
158
+ //# sourceMappingURL=intake-dry-run.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intake-dry-run.js","names":[],"sources":["../../src/boards/intake-dry-run.ts"],"sourcesContent":["/**\n * The intake dry run: today's rules, or edits not saved yet, run over the project's recent items\n * from their stored facts. Nothing is fetched and nothing is written. Each item is decided by\n * {@link traceIntakeOrder}, the intake order evaluator's own code, so the dry run shows what filing\n * under `intake-order` would do. A project still on `route-list` files differently.\n */\n\nimport type { RuleFacts } from '../rules/rule-group.js';\nimport type { FactoryCommitDecision } from '../rules/types.js';\nimport type { StoredIntakeDecisionRecord, StoredIntakeRouteRecord } from '../storage/domains/boards/base.js';\nimport type { Card } from '../storage/domains/work-items/base.js';\nimport { cardRuleFacts } from './card-facts.js';\nimport { arrivalRuleFacts, INTAKE_ORDER_SAMPLE, traceIntakeOrder } from './intake-routing.js';\nimport type { IntakeTrace } from './intake-routing.js';\nimport type { BoardRegistry } from './registry.js';\n\ntype IntakeRoute = Pick<StoredIntakeRouteRecord, 'id' | 'enabled' | 'when' | 'target' | 'on'> &\n Partial<Pick<StoredIntakeRouteRecord, 'name'>>;\n\n/** One recent item the dry run decides: a card from outside, or an item no board took. */\nexport interface IntakeSampleItem {\n /** The item's source key, unique among the sample. */\n key: string;\n /** The card's id, or the Not routed decision's. */\n id: string;\n kind: 'card' | 'not_routed';\n title: string;\n url: string | null;\n /** When it arrived. */\n at: Date;\n facts: RuleFacts;\n}\n\n/**\n * The project's newest {@link INTAKE_ORDER_SAMPLE} items from outside: cards filed from a source,\n * and items no board took. Cards read as stored, so a pull request card lacks the closed-issue facts\n * it was filed with; a Not routed item keeps its whole arrival and reads them as Route again does.\n */\nexport async function intakeSample(context: {\n cards: readonly Card[];\n notRouted: readonly StoredIntakeDecisionRecord[];\n factoryProjectId: string;\n registry: BoardRegistry;\n card(id: string): Promise<Card | null>;\n}): Promise<IntakeSampleItem[]> {\n const items: IntakeSampleItem[] = [];\n for (const card of context.cards) {\n if (!card.externalSource) continue;\n items.push({\n key: card.externalSource.externalId,\n id: card.id,\n kind: 'card',\n title: card.title,\n url: card.externalSource.url ?? null,\n at: card.createdAt,\n facts: cardRuleFacts(card),\n });\n }\n for (const decision of context.notRouted) {\n if (!decision.arrival || !decision.sourceKey) continue;\n items.push({\n key: decision.sourceKey,\n id: decision.id,\n kind: 'not_routed',\n title: decision.title,\n url: decision.url,\n at: decision.decidedAt,\n facts: await arrivalRuleFacts(decision.arrival as unknown as LinkedDecision, context),\n });\n }\n items.sort((left, right) => right.at.getTime() - left.at.getTime());\n const seen = new Set<string>();\n return items\n .filter(item => {\n if (seen.has(item.key)) return false;\n seen.add(item.key);\n return true;\n })\n .slice(0, INTAKE_ORDER_SAMPLE);\n}\n\ntype LinkedDecision = Extract<FactoryCommitDecision, { type: 'upsertLinkedWorkItem' }>;\n\nexport interface IntakeDryRunPlacement {\n boardKey: string;\n routeId: string;\n phase: string;\n}\n\nexport interface IntakeDryRunItem {\n key: string;\n id: string;\n kind: IntakeSampleItem['kind'];\n title: string;\n url: string | null;\n /** Where it would land; null when no board takes it. */\n placement: IntakeDryRunPlacement | null;\n /** Every rule that matched and could take it, in the order intake asked them; the first won. */\n matched: { boardKey: string; routeId: string }[];\n /** With a baseline: where today's saved rules and order put it. */\n before?: IntakeDryRunPlacement | null;\n}\n\nexport interface IntakeDryRunRule {\n routeId: string;\n name: string | null;\n enabled: boolean;\n /** Keys of the items it would take. */\n takes: string[];\n /** Items it matched but an earlier rule took, by the board that took them. */\n lost: { boardKey: string; keys: string[] }[];\n /** Cards it actually filed in the last 30 days, from the decision log; set when asked for. */\n filed?: number;\n}\n\nexport interface IntakeDryRunBoard {\n boardKey: string;\n name: string;\n /** Keys of the items the board would take. */\n takes: string[];\n /** Items one of its rules matched that another board took first, by that board. */\n lostTo: { boardKey: string; keys: string[] }[];\n rules: IntakeDryRunRule[];\n}\n\nexport interface IntakeDryRunResult {\n /** How many recent items were decided. */\n sampled: number;\n boards: IntakeDryRunBoard[];\n /** Keys of the items no board would take. */\n notRouted: string[];\n /** With a baseline: how many items land on another board or phase than today's rules put them. */\n changed?: number;\n items: IntakeDryRunItem[];\n}\n\nexport interface IntakeDryRunQuery {\n routes: readonly IntakeRoute[];\n order: readonly string[];\n registry: BoardRegistry;\n items: readonly IntakeSampleItem[];\n /** Today's saved rules and order, to report what the edit changes. */\n baseline?: { routes: readonly IntakeRoute[]; order: readonly string[] };\n /** Cards each rule filed in the last 30 days. */\n filed?: Record<string, number>;\n}\n\nfunction placementOf(trace: IntakeTrace): IntakeDryRunPlacement | null {\n const { resolution } = trace;\n if (resolution.outcome !== 'placed' || resolution.routeId === null) return null;\n return { boardKey: resolution.board, routeId: resolution.routeId, phase: resolution.phase };\n}\n\n/** Whether both land in the same place; which rule put it there doesn't matter. */\nfunction sameLanding(left: IntakeDryRunPlacement | null, right: IntakeDryRunPlacement | null): boolean {\n return left?.boardKey === right?.boardKey && left?.phase === right?.phase;\n}\n\nfunction pushKey(groups: { boardKey: string; keys: string[] }[], boardKey: string, key: string) {\n const group = groups.find(entry => entry.boardKey === boardKey);\n if (group) group.keys.push(key);\n else groups.push({ boardKey, keys: [key] });\n}\n\nexport function dryRunIntake(query: IntakeDryRunQuery): IntakeDryRunResult {\n const { routes, order, registry, items, baseline, filed } = query;\n // Every board and placing rule shows, in intake order, even one no item reaches.\n const boards = new Map<string, IntakeDryRunBoard>();\n const rules = new Map<string, IntakeDryRunRule>();\n for (const boardTrace of traceIntakeOrder({ routes, order, facts: {}, registry }, { full: true }).boards) {\n const board: IntakeDryRunBoard = {\n boardKey: boardTrace.boardKey,\n name: boardTrace.name,\n takes: [],\n lostTo: [],\n rules: [],\n };\n boards.set(board.boardKey, board);\n for (const ruleTrace of boardTrace.rules) {\n const rule: IntakeDryRunRule = {\n routeId: ruleTrace.routeId,\n name: ruleTrace.name,\n enabled: ruleTrace.outcome !== 'disabled',\n takes: [],\n lost: [],\n ...(filed && { filed: filed[ruleTrace.routeId] ?? 0 }),\n };\n rules.set(rule.routeId, rule);\n board.rules.push(rule);\n }\n }\n\n const notRouted: string[] = [];\n const decided: IntakeDryRunItem[] = [];\n let changed = 0;\n for (const item of items) {\n const trace = traceIntakeOrder({ routes, order, facts: item.facts, registry }, { full: true });\n const placement = placementOf(trace);\n const matched: IntakeDryRunItem['matched'] = [];\n for (const boardTrace of trace.boards) {\n const board = boards.get(boardTrace.boardKey)!;\n let lostToAnother = false;\n for (const ruleTrace of boardTrace.rules) {\n const rule = rules.get(ruleTrace.routeId)!;\n if (ruleTrace.outcome === 'took') {\n rule.takes.push(item.key);\n board.takes.push(item.key);\n } else if (ruleTrace.outcome === 'lost') {\n pushKey(rule.lost, ruleTrace.to.boardKey, item.key);\n if (ruleTrace.to.boardKey !== board.boardKey) lostToAnother = true;\n } else {\n continue;\n }\n matched.push({ boardKey: board.boardKey, routeId: rule.routeId });\n }\n if (lostToAnother && placement) pushKey(board.lostTo, placement.boardKey, item.key);\n }\n if (!placement) notRouted.push(item.key);\n\n const entry: IntakeDryRunItem = {\n key: item.key,\n id: item.id,\n kind: item.kind,\n title: item.title,\n url: item.url,\n placement,\n matched,\n };\n if (baseline) {\n const before = placementOf(\n traceIntakeOrder({ routes: baseline.routes, order: baseline.order, facts: item.facts, registry }),\n );\n entry.before = before;\n if (!sameLanding(before, placement)) changed += 1;\n }\n decided.push(entry);\n }\n\n return {\n sampled: items.length,\n boards: [...boards.values()],\n notRouted,\n ...(baseline && { changed }),\n items: decided,\n };\n}\n"],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import type { RuleFacts } from '../rules/rule-group.js';
2
+ import type { StoredBoardScope } from '../storage/domains/boards/base.js';
3
+ /** What one provider's lookup found for a URL. */
4
+ export type IntakeLookupResult =
5
+ /** Read once from the provider: the facts intake would test of it had it just arrived. */
6
+ {
7
+ status: 'found';
8
+ title: string;
9
+ url: string;
10
+ facts: RuleFacts;
11
+ }
12
+ /** The URL is this provider's, but names a repository or team not linked to the project. Nothing was fetched. */
13
+ | {
14
+ status: 'not_linked';
15
+ }
16
+ /** The linked source has no such item, or it couldn't be read. */
17
+ | {
18
+ status: 'not_found';
19
+ };
20
+ /**
21
+ * Reads one issue or pull request by URL from a source linked to the project, with the project's
22
+ * own credentials, for the intake tester. Never writes, never records anything.
23
+ */
24
+ export interface IntakeItemLookup {
25
+ /** Undefined when the URL isn't this provider's. */
26
+ lookup(scope: StoredBoardScope, url: string): Promise<IntakeLookupResult | undefined>;
27
+ }
28
+ /** Asks each lookup in turn; `unsupported` when none knows the URL. */
29
+ export declare function lookupIntakeItem(lookups: readonly IntakeItemLookup[], scope: StoredBoardScope, url: string): Promise<IntakeLookupResult | {
30
+ status: 'unsupported';
31
+ }>;
32
+ //# sourceMappingURL=intake-lookup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intake-lookup.d.ts","sourceRoot":"","sources":["../../src/boards/intake-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,kDAAkD;AAClD,MAAM,MAAM,kBAAkB;AAC5B,0FAA0F;AACxF;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE;AACnE,iHAAiH;GAC/G;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE;AAC1B,kEAAkE;GAChE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;CACvF;AAED,uEAAuE;AACvE,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,kBAAkB,GAAG;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAMzD"}
@@ -0,0 +1,12 @@
1
+ // src/boards/intake-lookup.ts
2
+ /** Asks each lookup in turn; `unsupported` when none knows the URL. */
3
+ async function lookupIntakeItem(lookups, scope, url) {
4
+ for (const lookup of lookups) {
5
+ const result = await lookup.lookup(scope, url);
6
+ if (result) return result;
7
+ }
8
+ return { status: "unsupported" };
9
+ }
10
+ export { lookupIntakeItem };
11
+
12
+ //# sourceMappingURL=intake-lookup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intake-lookup.js","names":[],"sources":["../../src/boards/intake-lookup.ts"],"sourcesContent":["import type { RuleFacts } from '../rules/rule-group.js';\nimport type { StoredBoardScope } from '../storage/domains/boards/base.js';\n\n/** What one provider's lookup found for a URL. */\nexport type IntakeLookupResult =\n /** Read once from the provider: the facts intake would test of it had it just arrived. */\n | { status: 'found'; title: string; url: string; facts: RuleFacts }\n /** The URL is this provider's, but names a repository or team not linked to the project. Nothing was fetched. */\n | { status: 'not_linked' }\n /** The linked source has no such item, or it couldn't be read. */\n | { status: 'not_found' };\n\n/**\n * Reads one issue or pull request by URL from a source linked to the project, with the project's\n * own credentials, for the intake tester. Never writes, never records anything.\n */\nexport interface IntakeItemLookup {\n /** Undefined when the URL isn't this provider's. */\n lookup(scope: StoredBoardScope, url: string): Promise<IntakeLookupResult | undefined>;\n}\n\n/** Asks each lookup in turn; `unsupported` when none knows the URL. */\nexport async function lookupIntakeItem(\n lookups: readonly IntakeItemLookup[],\n scope: StoredBoardScope,\n url: string,\n): Promise<IntakeLookupResult | { status: 'unsupported' }> {\n for (const lookup of lookups) {\n const result = await lookup.lookup(scope, url);\n if (result) return result;\n }\n return { status: 'unsupported' };\n}\n"],"mappings":";;AAsBA,eAAsB,iBACpB,SACA,OACA,KACyD;CACzD,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,SAAS,MAAM,OAAO,OAAO,OAAO,GAAG;EAC7C,IAAI,QAAQ,OAAO;CACrB;CACA,OAAO,EAAE,QAAQ,cAAc;AACjC"}
@@ -0,0 +1,32 @@
1
+ import type { StoredIntakeRouteRecord } from '../storage/domains/boards/base.js';
2
+ import type { RouteArrivals } from './board-events.js';
3
+ type OrderRoute = Pick<StoredIntakeRouteRecord, 'enabled' | 'when' | 'on' | 'pullRequestOpenedMovesOnly'> & {
4
+ target: Pick<StoredIntakeRouteRecord['target'], 'boardKey' | 'joinClosedIssue'>;
5
+ };
6
+ /** Whether the route can place a new card: enabled, handling arrivals, and not joining a closed issue's card. */
7
+ export declare function placesArrivals(route: OrderRoute): boolean;
8
+ /**
9
+ * The kinds of new card a placing route takes whatever they are: every kind it handles when it has
10
+ * no condition, or the one kind its condition names when that is all it tests (`source.kind equals
11
+ * pull_request` on a pull request route, so as a card move it leaves issues' cards alone).
12
+ */
13
+ export declare function kindsTakenWhole(route: Pick<OrderRoute, 'when'> & RouteArrivals): string[];
14
+ /**
15
+ * Whether the board's intake list takes every new card that reaches it: rules that test nothing
16
+ * but the card's kind file both issues and pull requests, in one rule or two.
17
+ */
18
+ export declare function endsInCatchAll(routes: readonly OrderRoute[], boardKey: string): boolean;
19
+ /**
20
+ * The intake order an existing project starts with: boards by the position of their first enabled
21
+ * placing route in the route list (`routes`, in list order), then boards with none, in sidebar
22
+ * order (`boardKeys`). Contiguous route lists route exactly as before under it.
23
+ */
24
+ export declare function deriveIntakeOrder(routes: readonly OrderRoute[], boardKeys: readonly string[]): string[];
25
+ /**
26
+ * The stored order brought up to date with the project's boards: deleted boards leave it, and a
27
+ * board missing from it (one created since) goes just above the first board whose list ends in an
28
+ * enabled catch-all, so it is reachable; last when no board has one.
29
+ */
30
+ export declare function reconcileIntakeOrder(stored: readonly string[], boardKeys: readonly string[], routes: readonly OrderRoute[]): string[];
31
+ export {};
32
+ //# sourceMappingURL=intake-order.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intake-order.d.ts","sourceRoot":"","sources":["../../src/boards/intake-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAEjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,KAAK,UAAU,GAAG,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,4BAA4B,CAAC,GAAG;IAC1G,MAAM,EAAE,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,iBAAiB,CAAC,CAAC;CACjF,CAAC;AAEF,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,aAAa,GAAG,MAAM,EAAE,CAQzF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOvF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAQvG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,EAAE,SAAS,UAAU,EAAE,GAC5B,MAAM,EAAE,CAUV"}
@@ -0,0 +1,60 @@
1
+ import { arrivalKinds } from "./board-events.js";
2
+ // src/boards/intake-order.ts
3
+ /** Whether the route can place a new card: enabled, handling arrivals, and not joining a closed issue's card. */
4
+ function placesArrivals(route) {
5
+ return route.enabled && arrivalKinds(route).size > 0 && !route.target.joinClosedIssue;
6
+ }
7
+ /**
8
+ * The kinds of new card a placing route takes whatever they are: every kind it handles when it has
9
+ * no condition, or the one kind its condition names when that is all it tests (`source.kind equals
10
+ * pull_request` on a pull request route, so as a card move it leaves issues' cards alone).
11
+ */
12
+ function kindsTakenWhole(route) {
13
+ const kinds = [...arrivalKinds(route)];
14
+ if (route.when === null) return kinds;
15
+ const { operator, conditions } = route.when;
16
+ if (operator !== "AND" || conditions.length !== 1) return [];
17
+ const [only] = conditions;
18
+ if (!only || !("field" in only) || only.field !== "source.kind" || only.operator !== "equals") return [];
19
+ return kinds.filter((kind) => kind === only.value);
20
+ }
21
+ /**
22
+ * Whether the board's intake list takes every new card that reaches it: rules that test nothing
23
+ * but the card's kind file both issues and pull requests, in one rule or two.
24
+ */
25
+ function endsInCatchAll(routes, boardKey) {
26
+ return new Set(routes.filter((route) => route.target.boardKey === boardKey && placesArrivals(route)).flatMap((route) => kindsTakenWhole(route))).size === 2;
27
+ }
28
+ /**
29
+ * The intake order an existing project starts with: boards by the position of their first enabled
30
+ * placing route in the route list (`routes`, in list order), then boards with none, in sidebar
31
+ * order (`boardKeys`). Contiguous route lists route exactly as before under it.
32
+ */
33
+ function deriveIntakeOrder(routes, boardKeys) {
34
+ const known = new Set(boardKeys);
35
+ const order = [];
36
+ for (const route of routes) {
37
+ const key = route.target.boardKey;
38
+ if (placesArrivals(route) && known.has(key) && !order.includes(key)) order.push(key);
39
+ }
40
+ return [...order, ...boardKeys.filter((key) => !order.includes(key))];
41
+ }
42
+ /**
43
+ * The stored order brought up to date with the project's boards: deleted boards leave it, and a
44
+ * board missing from it (one created since) goes just above the first board whose list ends in an
45
+ * enabled catch-all, so it is reachable; last when no board has one.
46
+ */
47
+ function reconcileIntakeOrder(stored, boardKeys, routes) {
48
+ const known = new Set(boardKeys);
49
+ const order = stored.filter((key, index) => known.has(key) && stored.indexOf(key) === index);
50
+ for (const key of boardKeys) {
51
+ if (order.includes(key)) continue;
52
+ const catchAll = order.findIndex((other) => endsInCatchAll(routes, other));
53
+ if (catchAll >= 0) order.splice(catchAll, 0, key);
54
+ else order.push(key);
55
+ }
56
+ return order;
57
+ }
58
+ export { deriveIntakeOrder, endsInCatchAll, kindsTakenWhole, placesArrivals, reconcileIntakeOrder };
59
+
60
+ //# sourceMappingURL=intake-order.js.map