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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (309) hide show
  1. package/README.md +181 -52
  2. package/dist/boards/card-facts.d.ts +5 -3
  3. package/dist/boards/card-facts.d.ts.map +1 -1
  4. package/dist/boards/card-facts.js +9 -4
  5. package/dist/boards/card-facts.js.map +1 -1
  6. package/dist/boards/define-board.d.ts +2 -0
  7. package/dist/boards/define-board.d.ts.map +1 -1
  8. package/dist/boards/define-board.js +1 -0
  9. package/dist/boards/define-board.js.map +1 -1
  10. package/dist/boards/index.d.ts +2 -2
  11. package/dist/boards/index.d.ts.map +1 -1
  12. package/dist/boards/index.js +2 -2
  13. package/dist/boards/index.js.map +1 -1
  14. package/dist/boards/intake-routing.d.ts +37 -0
  15. package/dist/boards/intake-routing.d.ts.map +1 -0
  16. package/dist/boards/intake-routing.js +70 -0
  17. package/dist/boards/intake-routing.js.map +1 -0
  18. package/dist/boards/phase-automation.d.ts +4 -4
  19. package/dist/boards/phase-automation.d.ts.map +1 -1
  20. package/dist/boards/phase-automation.js.map +1 -1
  21. package/dist/boards/pull-request-review.d.ts +14 -0
  22. package/dist/boards/pull-request-review.d.ts.map +1 -0
  23. package/dist/boards/pull-request-review.js +81 -0
  24. package/dist/boards/pull-request-review.js.map +1 -0
  25. package/dist/boards/relocate.d.ts +4 -4
  26. package/dist/boards/relocate.d.ts.map +1 -1
  27. package/dist/boards/relocate.js +1 -1
  28. package/dist/boards/relocate.js.map +1 -1
  29. package/dist/boards/review.d.ts +0 -2
  30. package/dist/boards/review.d.ts.map +1 -1
  31. package/dist/boards/review.js +2 -77
  32. package/dist/boards/review.js.map +1 -1
  33. package/dist/boards/semantics.d.ts +28 -8
  34. package/dist/boards/semantics.d.ts.map +1 -1
  35. package/dist/boards/semantics.js +21 -1
  36. package/dist/boards/semantics.js.map +1 -1
  37. package/dist/boards/transition-policy.d.ts +7 -0
  38. package/dist/boards/transition-policy.d.ts.map +1 -1
  39. package/dist/boards/transition-policy.js.map +1 -1
  40. package/dist/boards/work.d.ts +8 -2
  41. package/dist/boards/work.d.ts.map +1 -1
  42. package/dist/boards/work.js +81 -23
  43. package/dist/boards/work.js.map +1 -1
  44. package/dist/factory.d.ts +4 -2
  45. package/dist/factory.d.ts.map +1 -1
  46. package/dist/factory.js +24 -42
  47. package/dist/factory.js.map +1 -1
  48. package/dist/index.d.ts +3 -1
  49. package/dist/index.d.ts.map +1 -1
  50. package/dist/index.js +3 -2
  51. package/dist/integrations/github/acceptance-labels.d.ts +2 -2
  52. package/dist/integrations/github/acceptance-labels.d.ts.map +1 -1
  53. package/dist/integrations/github/acceptance-labels.js +2 -2
  54. package/dist/integrations/github/acceptance-labels.js.map +1 -1
  55. package/dist/integrations/github/default-rules.d.ts +19 -25
  56. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  57. package/dist/integrations/github/default-rules.js +40 -41
  58. package/dist/integrations/github/default-rules.js.map +1 -1
  59. package/dist/integrations/github/issue-reconciler.js +6 -4
  60. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  61. package/dist/integrations/github/provenance.d.ts +2 -2
  62. package/dist/integrations/github/provenance.d.ts.map +1 -1
  63. package/dist/integrations/github/provenance.js.map +1 -1
  64. package/dist/integrations/github/routes.d.ts.map +1 -1
  65. package/dist/integrations/github/routes.js +46 -1
  66. package/dist/integrations/github/routes.js.map +1 -1
  67. package/dist/integrations/github/rules.d.ts +3 -3
  68. package/dist/integrations/github/rules.d.ts.map +1 -1
  69. package/dist/integrations/github/rules.js +45 -39
  70. package/dist/integrations/github/rules.js.map +1 -1
  71. package/dist/integrations/gitlab/default-rules.d.ts +9 -16
  72. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  73. package/dist/integrations/gitlab/default-rules.js +29 -32
  74. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  75. package/dist/integrations/gitlab/issue-reconciler.js +2 -2
  76. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  77. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  78. package/dist/integrations/gitlab/merge-request-reconciler.js +11 -11
  79. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  80. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  81. package/dist/integrations/gitlab/rules.js +2 -1
  82. package/dist/integrations/gitlab/rules.js.map +1 -1
  83. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  84. package/dist/integrations/incidentio/rules.js +1 -0
  85. package/dist/integrations/incidentio/rules.js.map +1 -1
  86. package/dist/integrations/issue-reconciler.d.ts +7 -7
  87. package/dist/integrations/issue-reconciler.d.ts.map +1 -1
  88. package/dist/integrations/issue-reconciler.js +11 -14
  89. package/dist/integrations/issue-reconciler.js.map +1 -1
  90. package/dist/integrations/jira/rules.d.ts.map +1 -1
  91. package/dist/integrations/jira/rules.js +1 -0
  92. package/dist/integrations/jira/rules.js.map +1 -1
  93. package/dist/integrations/linear/issue-reconciler.js +2 -2
  94. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  95. package/dist/integrations/linear/routes.d.ts.map +1 -1
  96. package/dist/integrations/linear/routes.js +1 -1
  97. package/dist/integrations/linear/routes.js.map +1 -1
  98. package/dist/integrations/linear/rules.d.ts.map +1 -1
  99. package/dist/integrations/linear/rules.js +2 -1
  100. package/dist/integrations/linear/rules.js.map +1 -1
  101. package/dist/integrations/slack/feed-publisher.d.ts +2 -2
  102. package/dist/integrations/slack/feed-publisher.d.ts.map +1 -1
  103. package/dist/integrations/slack/feed-publisher.js.map +1 -1
  104. package/dist/integrations/slack/slack.d.ts.map +1 -1
  105. package/dist/integrations/slack/slack.js.map +1 -1
  106. package/dist/packages/_internals/workspace/dist/index.js +1 -1
  107. package/dist/packages/_internals/workspace/dist/index.js.map +1 -1
  108. package/dist/routes/attention-activity.js +1 -1
  109. package/dist/routes/attention-activity.js.map +1 -1
  110. package/dist/routes/attention-parked.js.map +1 -1
  111. package/dist/routes/attention-providers.d.ts +4 -4
  112. package/dist/routes/attention-providers.d.ts.map +1 -1
  113. package/dist/routes/attention-providers.js +2 -2
  114. package/dist/routes/attention-providers.js.map +1 -1
  115. package/dist/routes/boards.js +1 -1
  116. package/dist/routes/config.d.ts +4 -4
  117. package/dist/routes/config.d.ts.map +1 -1
  118. package/dist/routes/config.js +6 -5
  119. package/dist/routes/config.js.map +1 -1
  120. package/dist/routes/contracts.d.ts +228 -5
  121. package/dist/routes/contracts.d.ts.map +1 -1
  122. package/dist/routes/contracts.js +118 -5
  123. package/dist/routes/contracts.js.map +1 -1
  124. package/dist/routes/intake-routes.d.ts +28 -0
  125. package/dist/routes/intake-routes.d.ts.map +1 -0
  126. package/dist/routes/intake-routes.js +199 -0
  127. package/dist/routes/intake-routes.js.map +1 -0
  128. package/dist/routes/intake.d.ts.map +1 -1
  129. package/dist/routes/intake.js +10 -1
  130. package/dist/routes/intake.js.map +1 -1
  131. package/dist/routes/projects.js +3 -2
  132. package/dist/routes/projects.js.map +1 -1
  133. package/dist/routes/surface.d.ts.map +1 -1
  134. package/dist/routes/surface.js +18 -7
  135. package/dist/routes/surface.js.map +1 -1
  136. package/dist/routes/work-items.d.ts +3 -0
  137. package/dist/routes/work-items.d.ts.map +1 -1
  138. package/dist/routes/work-items.js +10 -3
  139. package/dist/routes/work-items.js.map +1 -1
  140. package/dist/rules/binding-context.js +1 -1
  141. package/dist/rules/binding-context.js.map +1 -1
  142. package/dist/rules/decision-applicability.d.ts +2 -2
  143. package/dist/rules/decision-applicability.d.ts.map +1 -1
  144. package/dist/rules/decision-applicability.js +1 -1
  145. package/dist/rules/decision-applicability.js.map +1 -1
  146. package/dist/rules/dispatcher.d.ts +6 -8
  147. package/dist/rules/dispatcher.d.ts.map +1 -1
  148. package/dist/rules/dispatcher.js +109 -34
  149. package/dist/rules/dispatcher.js.map +1 -1
  150. package/dist/rules/processor.d.ts +2 -2
  151. package/dist/rules/processor.d.ts.map +1 -1
  152. package/dist/rules/processor.js +9 -4
  153. package/dist/rules/processor.js.map +1 -1
  154. package/dist/rules/review-source-tool.d.ts.map +1 -1
  155. package/dist/rules/review-source-tool.js +2 -4
  156. package/dist/rules/review-source-tool.js.map +1 -1
  157. package/dist/rules/rule-group.d.ts +1 -1
  158. package/dist/rules/rule-group.d.ts.map +1 -1
  159. package/dist/rules/rule-group.js +1 -0
  160. package/dist/rules/rule-group.js.map +1 -1
  161. package/dist/rules/start-coordinator.d.ts.map +1 -1
  162. package/dist/rules/start-coordinator.js +5 -2
  163. package/dist/rules/start-coordinator.js.map +1 -1
  164. package/dist/rules/tools.d.ts.map +1 -1
  165. package/dist/rules/tools.js +17 -14
  166. package/dist/rules/tools.js.map +1 -1
  167. package/dist/rules/transition-service.d.ts +8 -16
  168. package/dist/rules/transition-service.d.ts.map +1 -1
  169. package/dist/rules/transition-service.js +21 -28
  170. package/dist/rules/transition-service.js.map +1 -1
  171. package/dist/rules/types.d.ts +12 -4
  172. package/dist/rules/types.d.ts.map +1 -1
  173. package/dist/rules/types.js +9 -5
  174. package/dist/rules/types.js.map +1 -1
  175. package/dist/session/resource-migration.d.ts +3 -3
  176. package/dist/session/resource-migration.d.ts.map +1 -1
  177. package/dist/session/resource-migration.js.map +1 -1
  178. package/dist/session/self-review-gate.d.ts +13 -0
  179. package/dist/session/self-review-gate.d.ts.map +1 -0
  180. package/dist/session/self-review-gate.js +37 -0
  181. package/dist/session/self-review-gate.js.map +1 -0
  182. package/dist/session/work-item-repository.d.ts +4 -2
  183. package/dist/session/work-item-repository.d.ts.map +1 -1
  184. package/dist/session/work-item-repository.js +2 -2
  185. package/dist/session/work-item-repository.js.map +1 -1
  186. package/dist/skills/catalog.js +1 -1
  187. package/dist/storage/domains/audit/actions.d.ts +1 -0
  188. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  189. package/dist/storage/domains/audit/actions.js +7 -1
  190. package/dist/storage/domains/audit/actions.js.map +1 -1
  191. package/dist/storage/domains/boards/base.d.ts +72 -1
  192. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  193. package/dist/storage/domains/boards/base.js +292 -8
  194. package/dist/storage/domains/boards/base.js.map +1 -1
  195. package/dist/storage/domains/boards/schemas.d.ts +8 -0
  196. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  197. package/dist/storage/domains/boards/schemas.js +64 -1
  198. package/dist/storage/domains/boards/schemas.js.map +1 -1
  199. package/dist/storage/domains/comments/base.d.ts.map +1 -1
  200. package/dist/storage/domains/comments/base.js +15 -8
  201. package/dist/storage/domains/comments/base.js.map +1 -1
  202. package/dist/storage/domains/comments/domain.d.ts +2 -2
  203. package/dist/storage/domains/comments/domain.d.ts.map +1 -1
  204. package/dist/storage/domains/comments/domain.js +1 -1
  205. package/dist/storage/domains/comments/domain.js.map +1 -1
  206. package/dist/storage/domains/comments/feed-sync.d.ts +2 -2
  207. package/dist/storage/domains/comments/feed-sync.d.ts.map +1 -1
  208. package/dist/storage/domains/projects/base.d.ts +0 -3
  209. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  210. package/dist/storage/domains/projects/base.js +0 -3
  211. package/dist/storage/domains/projects/base.js.map +1 -1
  212. package/dist/storage/domains/work-items/base.d.ts +94 -34
  213. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  214. package/dist/storage/domains/work-items/base.js +313 -161
  215. package/dist/storage/domains/work-items/base.js.map +1 -1
  216. package/dist/storage/domains/work-items/board-version.d.ts +2 -2
  217. package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
  218. package/dist/storage/domains/work-items/board-version.js +16 -5
  219. package/dist/storage/domains/work-items/board-version.js.map +1 -1
  220. package/dist/storage/domains/work-items/cards.d.ts +50 -0
  221. package/dist/storage/domains/work-items/cards.d.ts.map +1 -0
  222. package/dist/storage/domains/work-items/cards.js +284 -0
  223. package/dist/storage/domains/work-items/cards.js.map +1 -0
  224. package/dist/storage/domains/work-items/metrics.d.ts +2 -2
  225. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  226. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  227. package/dist/storage/domains/work-items/work-item-schema.d.ts +117 -0
  228. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -0
  229. package/dist/storage/domains/work-items/work-item-schema.js +300 -0
  230. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -0
  231. package/dist/tools/permissions.d.ts.map +1 -1
  232. package/dist/tools/permissions.js +2 -1
  233. package/dist/tools/permissions.js.map +1 -1
  234. package/dist/tools/read-tools.d.ts +4 -4
  235. package/dist/tools/read-tools.d.ts.map +1 -1
  236. package/dist/tools/read-tools.js +19 -9
  237. package/dist/tools/read-tools.js.map +1 -1
  238. package/dist/tools/sandbox-tools.d.ts +5 -0
  239. package/dist/tools/sandbox-tools.d.ts.map +1 -1
  240. package/dist/tools/sandbox-tools.js +68 -30
  241. package/dist/tools/sandbox-tools.js.map +1 -1
  242. package/dist/tools/session-tools.d.ts.map +1 -1
  243. package/dist/tools/session-tools.js.map +1 -1
  244. package/dist/tools/side-sessions.d.ts +2 -2
  245. package/dist/tools/side-sessions.d.ts.map +1 -1
  246. package/dist/tools/side-sessions.js.map +1 -1
  247. package/dist/tools/work-item-tools.d.ts +3 -0
  248. package/dist/tools/work-item-tools.d.ts.map +1 -1
  249. package/dist/tools/work-item-tools.js +14 -18
  250. package/dist/tools/work-item-tools.js.map +1 -1
  251. package/dist/work-items/create-work-item.d.ts +8 -5
  252. package/dist/work-items/create-work-item.d.ts.map +1 -1
  253. package/dist/work-items/create-work-item.js +54 -3
  254. package/dist/work-items/create-work-item.js.map +1 -1
  255. package/dist/work-items/providers/base.d.ts +22 -0
  256. package/dist/work-items/providers/base.d.ts.map +1 -0
  257. package/dist/work-items/providers/base.js +44 -0
  258. package/dist/work-items/providers/base.js.map +1 -0
  259. package/dist/work-items/providers/factory.d.ts +4 -0
  260. package/dist/work-items/providers/factory.d.ts.map +1 -0
  261. package/dist/work-items/providers/factory.js +13 -0
  262. package/dist/work-items/providers/factory.js.map +1 -0
  263. package/dist/work-items/providers/github.d.ts +3 -0
  264. package/dist/work-items/providers/github.d.ts.map +1 -0
  265. package/dist/work-items/providers/github.js +30 -0
  266. package/dist/work-items/providers/github.js.map +1 -0
  267. package/dist/work-items/providers/gitlab.d.ts +3 -0
  268. package/dist/work-items/providers/gitlab.d.ts.map +1 -0
  269. package/dist/work-items/providers/gitlab.js +35 -0
  270. package/dist/work-items/providers/gitlab.js.map +1 -0
  271. package/dist/work-items/providers/incidentio.d.ts +3 -0
  272. package/dist/work-items/providers/incidentio.d.ts.map +1 -0
  273. package/dist/work-items/providers/incidentio.js +23 -0
  274. package/dist/work-items/providers/incidentio.js.map +1 -0
  275. package/dist/work-items/providers/index.d.ts +8 -0
  276. package/dist/work-items/providers/index.d.ts.map +1 -0
  277. package/dist/work-items/providers/index.js +34 -0
  278. package/dist/work-items/providers/index.js.map +1 -0
  279. package/dist/work-items/providers/jira.d.ts +3 -0
  280. package/dist/work-items/providers/jira.d.ts.map +1 -0
  281. package/dist/work-items/providers/jira.js +16 -0
  282. package/dist/work-items/providers/jira.js.map +1 -0
  283. package/dist/work-items/providers/linear.d.ts +3 -0
  284. package/dist/work-items/providers/linear.d.ts.map +1 -0
  285. package/dist/work-items/providers/linear.js +24 -0
  286. package/dist/work-items/providers/linear.js.map +1 -0
  287. package/dist/work-items/providers/metadata-keys.d.ts +24 -0
  288. package/dist/work-items/providers/metadata-keys.d.ts.map +1 -0
  289. package/dist/work-items/providers/metadata-keys.js +84 -0
  290. package/dist/work-items/providers/metadata-keys.js.map +1 -0
  291. package/dist/work-items/providers/slack.d.ts +6 -0
  292. package/dist/work-items/providers/slack.d.ts.map +1 -0
  293. package/dist/work-items/providers/slack.js +15 -0
  294. package/dist/work-items/providers/slack.js.map +1 -0
  295. package/dist/work-items/providers/types.d.ts +23 -0
  296. package/dist/work-items/providers/types.d.ts.map +1 -0
  297. package/dist/work-items/providers/types.js +1 -0
  298. package/dist/work-items/split-migration.d.ts +51 -0
  299. package/dist/work-items/split-migration.d.ts.map +1 -0
  300. package/dist/work-items/split-migration.js +293 -0
  301. package/dist/work-items/split-migration.js.map +1 -0
  302. package/factory-skills/configure-factory-rules/SKILL.md +13 -17
  303. package/factory-skills/factory-self-review/SKILL.md +1 -1
  304. package/factory-skills/factory-triage/SKILL.md +3 -3
  305. package/package.json +12 -12
  306. package/dist/boards/work-transition-policy.d.ts +0 -3
  307. package/dist/boards/work-transition-policy.d.ts.map +0 -1
  308. package/dist/boards/work-transition-policy.js +0 -56
  309. package/dist/boards/work-transition-policy.js.map +0 -1
@@ -0,0 +1,293 @@
1
+ import { FACTORY_BOARD_ITEMS_SCHEMA, FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA, FACTORY_WORK_ITEMS_SCHEMA, FACTORY_WORK_ITEM_SOURCES_SCHEMA, FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA, WORK_ITEMS_SCHEMA } from "../storage/domains/work-items/work-item-schema.js";
2
+ import { bumpBoardVersions } from "../storage/domains/work-items/board-version.js";
3
+ import { factoryDecisionHash } from "../storage/domains/work-items/base.js";
4
+ import { splitCardMetadata } from "./providers/metadata-keys.js";
5
+ import { workItemProviderAdapter } from "./providers/index.js";
6
+ import { randomUUID } from "crypto";
7
+ import { UniqueViolationError } from "@mastra/core/storage";
8
+ // src/work-items/split-migration.ts
9
+ const LEGACY = WORK_ITEMS_SCHEMA.name;
10
+ const WORK_ITEMS = FACTORY_WORK_ITEMS_SCHEMA.name;
11
+ const SOURCES = FACTORY_WORK_ITEM_SOURCES_SCHEMA.name;
12
+ const BOARD_ITEMS = FACTORY_BOARD_ITEMS_SCHEMA.name;
13
+ const PAGE_SIZE = 200;
14
+ function time(value) {
15
+ return value ? new Date(value).getTime() : Number.NEGATIVE_INFINITY;
16
+ }
17
+ function legacyHash(row) {
18
+ const copied = {
19
+ id: row.id,
20
+ org_id: row.org_id,
21
+ factory_project_id: row.factory_project_id,
22
+ board: row.board,
23
+ external_source: row.external_source,
24
+ parent_work_item_id: row.parent_work_item_id,
25
+ title: row.title,
26
+ stages: row.stages,
27
+ stage_history: row.stage_history,
28
+ sessions: row.sessions,
29
+ metadata: row.metadata,
30
+ triage_type: row.triage_type,
31
+ accepted_at: row.accepted_at,
32
+ autonomy_armed_at: row.autonomy_armed_at,
33
+ plans_preapproved_at: row.plans_preapproved_at,
34
+ revision: row.revision,
35
+ created_by: row.created_by,
36
+ created_at: row.created_at,
37
+ updated_at: row.updated_at
38
+ };
39
+ return factoryDecisionHash(JSON.parse(JSON.stringify(copied)));
40
+ }
41
+ function splitLegacyWorkItem(row, { workItemId, revision }) {
42
+ const adapter = workItemProviderAdapter(row.external_source ?? null);
43
+ const provider = adapter.toSource(row.external_source ?? null, row.metadata);
44
+ const metadata = splitCardMetadata(row.metadata, adapter.providerMetadataKeys);
45
+ return {
46
+ workItem: {
47
+ id: workItemId,
48
+ org_id: row.org_id,
49
+ factory_project_id: String(row.factory_project_id),
50
+ title: row.title,
51
+ parent_work_item_id: null,
52
+ revision: 1,
53
+ created_at: row.created_at,
54
+ updated_at: row.updated_at
55
+ },
56
+ source: provider ? {
57
+ id: workItemId,
58
+ org_id: row.org_id,
59
+ factory_project_id: String(row.factory_project_id),
60
+ work_item_id: workItemId,
61
+ provider: provider.provider,
62
+ integration_id: provider.integrationId,
63
+ source_type: provider.sourceType,
64
+ workspace_id: provider.workspaceId,
65
+ external_id: provider.externalId,
66
+ source_key: provider.sourceKey,
67
+ url: provider.url,
68
+ key: provider.key,
69
+ state: provider.state,
70
+ labels: provider.labels,
71
+ author: provider.author,
72
+ metadata: metadata.provider,
73
+ revision: 1,
74
+ synced_at: null,
75
+ created_at: row.created_at,
76
+ updated_at: row.updated_at
77
+ } : null,
78
+ boardItem: {
79
+ id: row.id,
80
+ org_id: row.org_id,
81
+ factory_project_id: String(row.factory_project_id),
82
+ work_item_id: workItemId,
83
+ board: row.board ?? null,
84
+ parent_board_item_id: row.parent_work_item_id ?? null,
85
+ stages: row.stages,
86
+ stage_history: row.stage_history,
87
+ sessions: row.sessions,
88
+ metadata: metadata.board,
89
+ triage_type: row.triage_type ?? null,
90
+ accepted_at: row.accepted_at ?? null,
91
+ autonomy_armed_at: row.autonomy_armed_at ?? null,
92
+ plans_preapproved_at: row.plans_preapproved_at ?? null,
93
+ comment_count: row.comment_count ?? 0,
94
+ feed_activity_at: null,
95
+ revision: revision ?? row.revision,
96
+ created_by: row.created_by,
97
+ created_at: row.created_at,
98
+ updated_at: row.updated_at,
99
+ migrated_from_updated_at: row.updated_at,
100
+ migrated_from_hash: legacyHash(row)
101
+ }
102
+ };
103
+ }
104
+ function planWorkItemSplit(rows, migrated = /* @__PURE__ */ new Map(), newId = randomUUID) {
105
+ const plan = {
106
+ inserts: [],
107
+ recopies: [],
108
+ unchanged: 0,
109
+ skipped: []
110
+ };
111
+ for (const row of rows) {
112
+ const existing = migrated.get(row.id);
113
+ if (existing?.migratedFromHash === legacyHash(row)) {
114
+ plan.unchanged += 1;
115
+ continue;
116
+ }
117
+ if (existing && time(existing.updatedAt) > time(existing.migratedFromUpdatedAt)) {
118
+ plan.skipped.push({
119
+ id: row.id,
120
+ reason: "Split board item changed after migration"
121
+ });
122
+ continue;
123
+ }
124
+ try {
125
+ const card = splitLegacyWorkItem(row, {
126
+ workItemId: existing?.workItemId ?? newId(),
127
+ ...existing ? { revision: Math.max(existing.revision, row.revision) + 1 } : {}
128
+ });
129
+ if (existing) card.previousHash = existing.migratedFromHash;
130
+ (existing ? plan.recopies : plan.inserts).push(card);
131
+ } catch (error) {
132
+ plan.skipped.push({
133
+ id: row.id,
134
+ reason: error instanceof Error ? error.message : String(error)
135
+ });
136
+ }
137
+ }
138
+ return plan;
139
+ }
140
+ async function migratedBoardItems(ops, ids) {
141
+ if (!ids.length) return /* @__PURE__ */ new Map();
142
+ const rows = await ops.findMany(BOARD_ITEMS, { id: { in: [...ids] } });
143
+ return new Map(rows.map((row) => [row.id, {
144
+ workItemId: row.work_item_id,
145
+ revision: row.revision,
146
+ updatedAt: row.updated_at,
147
+ migratedFromUpdatedAt: row.migrated_from_updated_at,
148
+ migratedFromHash: row.migrated_from_hash
149
+ }]));
150
+ }
151
+ var MigrationConflict = class extends Error {};
152
+ async function writeCard(ops, card, recopy) {
153
+ if (!recopy) {
154
+ if (!await ops.updateAtomic(FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA.name, { id: card.boardItem.id }, () => null)) await ops.insertOne(FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA.name, {
155
+ id: card.boardItem.id,
156
+ org_id: card.boardItem.org_id,
157
+ factory_project_id: card.boardItem.factory_project_id
158
+ });
159
+ if (await ops.findOne(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, { id: card.boardItem.id })) return false;
160
+ const existing = await ops.findOne(BOARD_ITEMS, { id: card.boardItem.id });
161
+ if (existing) {
162
+ if (existing.migrated_from_hash === card.boardItem.migrated_from_hash) return false;
163
+ throw new MigrationConflict("Migration baseline changed since planning");
164
+ }
165
+ await ops.insertOne(WORK_ITEMS, card.workItem);
166
+ if (card.source) await ops.insertOne(SOURCES, card.source);
167
+ await ops.insertOne(BOARD_ITEMS, card.boardItem);
168
+ return true;
169
+ }
170
+ let unchanged = false;
171
+ let baseline = Number.NEGATIVE_INFINITY;
172
+ const board = await ops.updateAtomic(BOARD_ITEMS, { id: card.boardItem.id }, (current) => {
173
+ if (current.migrated_from_hash === card.boardItem.migrated_from_hash) {
174
+ unchanged = true;
175
+ return null;
176
+ }
177
+ if (current.migrated_from_hash !== card.previousHash) throw new MigrationConflict("Migration baseline changed since planning");
178
+ if (time(current.updated_at) > time(current.migrated_from_updated_at)) throw new MigrationConflict("Split board item changed after migration");
179
+ baseline = time(current.migrated_from_updated_at);
180
+ return {
181
+ ...card.boardItem,
182
+ ...current.feed_activity_at ? {
183
+ comment_count: current.comment_count,
184
+ feed_activity_at: current.feed_activity_at
185
+ } : {},
186
+ revision: Math.max(current.revision, card.boardItem.revision) + 1
187
+ };
188
+ });
189
+ if (unchanged) return false;
190
+ if (!board) throw new MigrationConflict("Split board item disappeared during migration");
191
+ await ops.updateAtomic(WORK_ITEMS, { id: card.workItem.id }, (current) => {
192
+ if (time(current.updated_at) > baseline) throw new MigrationConflict("Split work item changed after migration");
193
+ return {
194
+ ...card.workItem,
195
+ revision: current.revision + 1
196
+ };
197
+ });
198
+ const sources = await ops.findMany(SOURCES, { work_item_id: card.workItem.id });
199
+ if (sources.some((source) => source.id !== card.workItem.id)) throw new MigrationConflict("Split source set changed after migration");
200
+ for (const source of sources) await ops.updateAtomic(SOURCES, { id: source.id }, (current) => {
201
+ if (current.synced_at != null || time(current.updated_at) > baseline) throw new MigrationConflict("Split source changed after migration");
202
+ return null;
203
+ });
204
+ if (sources.length) await ops.deleteMany(SOURCES, { id: { in: sources.map((source) => source.id) } });
205
+ if (card.source) await ops.insertOne(SOURCES, card.source);
206
+ return true;
207
+ }
208
+ /** Legacy rows are read-only; each card and all its split rows land atomically. */
209
+ async function migrateWorkItemSplit(storage, { dryRun = false, ops = storage.ops, log } = {}) {
210
+ const report = {
211
+ dryRun,
212
+ projects: 0,
213
+ cards: 0,
214
+ workItems: 0,
215
+ sources: 0,
216
+ boardItems: 0,
217
+ recopied: 0,
218
+ unchanged: 0,
219
+ skipped: []
220
+ };
221
+ const projects = /* @__PURE__ */ new Set();
222
+ const written = /* @__PURE__ */ new Map();
223
+ let cursor;
224
+ while (true) {
225
+ const page = await ops.findMany(LEGACY, {}, {
226
+ orderBy: [
227
+ ["org_id", "asc"],
228
+ ["factory_project_id", "asc"],
229
+ ["created_at", "asc"],
230
+ ["id", "asc"]
231
+ ],
232
+ limit: PAGE_SIZE,
233
+ ...cursor ? { cursor: { values: [
234
+ cursor.org_id,
235
+ cursor.factory_project_id,
236
+ cursor.created_at,
237
+ cursor.id
238
+ ] } } : {}
239
+ });
240
+ if (!page.length) break;
241
+ cursor = page[page.length - 1];
242
+ const rows = page;
243
+ report.cards += rows.length;
244
+ for (const row of rows) projects.add(`${row.org_id}\u0000${row.factory_project_id}`);
245
+ const tombstones = await ops.findMany(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, { id: { in: rows.map((row) => row.id) } });
246
+ const deleted = new Set(tombstones.map((row) => row.id));
247
+ report.unchanged += deleted.size;
248
+ const plan = planWorkItemSplit(rows.filter((row) => !deleted.has(row.id)), await migratedBoardItems(ops, rows.map((row) => row.id)));
249
+ report.unchanged += plan.unchanged;
250
+ report.skipped.push(...plan.skipped);
251
+ for (const { card, recopy } of [...plan.inserts.map((card) => ({
252
+ card,
253
+ recopy: false
254
+ })), ...plan.recopies.map((card) => ({
255
+ card,
256
+ recopy: true
257
+ }))]) {
258
+ if (!dryRun) try {
259
+ if (!await storage.withTransaction((tx) => writeCard(tx, card, recopy))) {
260
+ report.unchanged += 1;
261
+ continue;
262
+ }
263
+ } catch (error) {
264
+ if (!(error instanceof UniqueViolationError) && !(error instanceof MigrationConflict)) throw error;
265
+ if ((await migratedBoardItems(ops, [card.boardItem.id])).get(card.boardItem.id)?.migratedFromHash === card.boardItem.migrated_from_hash) report.unchanged += 1;
266
+ else {
267
+ const reason = error instanceof UniqueViolationError && (error.collection === SOURCES || error.collection === BOARD_ITEMS) ? `Conflicting source: ${error.message}` : error.message;
268
+ report.skipped.push({
269
+ id: card.boardItem.id,
270
+ reason
271
+ });
272
+ }
273
+ continue;
274
+ }
275
+ report.workItems += 1;
276
+ report.sources += card.source ? 1 : 0;
277
+ report.boardItems += 1;
278
+ if (recopy) report.recopied += 1;
279
+ written.set(`${card.boardItem.org_id}\u0000${card.boardItem.factory_project_id}`, {
280
+ orgId: card.boardItem.org_id,
281
+ factoryProjectId: card.boardItem.factory_project_id
282
+ });
283
+ }
284
+ if (page.length < PAGE_SIZE) break;
285
+ }
286
+ report.projects = projects.size;
287
+ if (!dryRun && written.size) await bumpBoardVersions(ops, [...written.values()]);
288
+ if (report.workItems || report.skipped.length || dryRun) log?.(dryRun ? "Factory work item split (dry run)" : "Factory work item split", { ...report });
289
+ return report;
290
+ }
291
+ export { migrateWorkItemSplit, planWorkItemSplit, splitLegacyWorkItem };
292
+
293
+ //# sourceMappingURL=split-migration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"split-migration.js","names":[],"sources":["../../src/work-items/split-migration.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { UniqueViolationError } from '@mastra/core/storage';\nimport type { FactoryStorage, FactoryStorageOps } from '@mastra/core/storage';\n\nimport { factoryDecisionHash } from '../storage/domains/work-items/base.js';\nimport type { WorkItemDbRow } from '../storage/domains/work-items/base.js';\nimport { bumpBoardVersions } from '../storage/domains/work-items/board-version.js';\nimport type { BoardScope } from '../storage/domains/work-items/board-version.js';\nimport {\n WORK_ITEMS_SCHEMA,\n FACTORY_BOARD_ITEMS_SCHEMA,\n FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA,\n FACTORY_WORK_ITEMS_SCHEMA,\n FACTORY_WORK_ITEM_SOURCES_SCHEMA,\n FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA,\n} from '../storage/domains/work-items/work-item-schema.js';\nimport type {\n BoardItemDbRecord,\n WorkItemDbRecord,\n WorkItemSourceDbRecord,\n} from '../storage/domains/work-items/work-item-schema.js';\nimport { splitCardMetadata, workItemProviderAdapter } from './providers/index.js';\n\nconst LEGACY = WORK_ITEMS_SCHEMA.name;\nconst WORK_ITEMS = FACTORY_WORK_ITEMS_SCHEMA.name;\nconst SOURCES = FACTORY_WORK_ITEM_SOURCES_SCHEMA.name;\nconst BOARD_ITEMS = FACTORY_BOARD_ITEMS_SCHEMA.name;\nconst PAGE_SIZE = 200;\n\nexport interface MigratedBoardItem {\n workItemId: string;\n revision: number;\n updatedAt: Date;\n migratedFromUpdatedAt: Date | null;\n migratedFromHash: string | null;\n}\n\nexport interface WorkItemSplitCard {\n /** Fingerprint observed when planning; rejects a stale migration plan under the row lock. */\n previousHash?: string | null;\n workItem: WorkItemDbRecord;\n source: WorkItemSourceDbRecord | null;\n boardItem: BoardItemDbRecord;\n}\n\nexport interface WorkItemSplitSkip {\n id: string;\n reason: string;\n}\n\nexport interface WorkItemSplitPlan {\n inserts: WorkItemSplitCard[];\n recopies: WorkItemSplitCard[];\n unchanged: number;\n skipped: WorkItemSplitSkip[];\n}\n\nexport interface WorkItemSplitReport {\n dryRun: boolean;\n projects: number;\n cards: number;\n workItems: number;\n sources: number;\n boardItems: number;\n recopied: number;\n unchanged: number;\n skipped: WorkItemSplitSkip[];\n}\n\nfunction time(value: Date | string | null | undefined): number {\n return value ? new Date(value).getTime() : Number.NEGATIVE_INFINITY;\n}\n\nfunction legacyHash(row: WorkItemDbRow): string {\n const copied = {\n id: row.id,\n org_id: row.org_id,\n factory_project_id: row.factory_project_id,\n board: row.board,\n external_source: row.external_source,\n parent_work_item_id: row.parent_work_item_id,\n title: row.title,\n stages: row.stages,\n stage_history: row.stage_history,\n sessions: row.sessions,\n metadata: row.metadata,\n triage_type: row.triage_type,\n accepted_at: row.accepted_at,\n autonomy_armed_at: row.autonomy_armed_at,\n plans_preapproved_at: row.plans_preapproved_at,\n revision: row.revision,\n created_by: row.created_by,\n created_at: row.created_at,\n updated_at: row.updated_at,\n };\n // stableJson does not invoke Date.toJSON; normalize before hashing.\n return factoryDecisionHash(JSON.parse(JSON.stringify(copied)));\n}\n\nexport function splitLegacyWorkItem(\n row: WorkItemDbRow,\n { workItemId, revision }: { workItemId: string; revision?: number },\n): WorkItemSplitCard {\n const adapter = workItemProviderAdapter(row.external_source ?? null);\n const provider = adapter.toSource(row.external_source ?? null, row.metadata);\n const metadata = splitCardMetadata(row.metadata, adapter.providerMetadataKeys);\n return {\n workItem: {\n id: workItemId,\n org_id: row.org_id,\n factory_project_id: String(row.factory_project_id),\n title: row.title,\n parent_work_item_id: null,\n revision: 1,\n created_at: row.created_at,\n updated_at: row.updated_at,\n },\n source: provider\n ? {\n id: workItemId,\n org_id: row.org_id,\n factory_project_id: String(row.factory_project_id),\n work_item_id: workItemId,\n provider: provider.provider,\n integration_id: provider.integrationId,\n source_type: provider.sourceType,\n workspace_id: provider.workspaceId,\n external_id: provider.externalId,\n source_key: provider.sourceKey,\n url: provider.url,\n key: provider.key,\n state: provider.state,\n labels: provider.labels,\n author: provider.author,\n metadata: metadata.provider,\n revision: 1,\n synced_at: null,\n created_at: row.created_at,\n updated_at: row.updated_at,\n }\n : null,\n boardItem: {\n id: row.id,\n org_id: row.org_id,\n factory_project_id: String(row.factory_project_id),\n work_item_id: workItemId,\n board: row.board ?? null,\n parent_board_item_id: row.parent_work_item_id ?? null,\n stages: row.stages,\n stage_history: row.stage_history,\n sessions: row.sessions,\n metadata: metadata.board,\n triage_type: row.triage_type ?? null,\n accepted_at: row.accepted_at ?? null,\n autonomy_armed_at: row.autonomy_armed_at ?? null,\n plans_preapproved_at: row.plans_preapproved_at ?? null,\n comment_count: row.comment_count ?? 0,\n // The first recount must be able to correct a copied legacy count.\n feed_activity_at: null,\n revision: revision ?? row.revision,\n created_by: row.created_by,\n created_at: row.created_at,\n updated_at: row.updated_at,\n migrated_from_updated_at: row.updated_at,\n migrated_from_hash: legacyHash(row),\n },\n };\n}\n\nexport function planWorkItemSplit(\n rows: readonly WorkItemDbRow[],\n migrated: ReadonlyMap<string, MigratedBoardItem> = new Map(),\n newId: () => string = randomUUID,\n): WorkItemSplitPlan {\n const plan: WorkItemSplitPlan = { inserts: [], recopies: [], unchanged: 0, skipped: [] };\n for (const row of rows) {\n const existing = migrated.get(row.id);\n if (existing?.migratedFromHash === legacyHash(row)) {\n plan.unchanged += 1;\n continue;\n }\n if (existing && time(existing.updatedAt) > time(existing.migratedFromUpdatedAt)) {\n plan.skipped.push({ id: row.id, reason: 'Split board item changed after migration' });\n continue;\n }\n try {\n const card = splitLegacyWorkItem(row, {\n workItemId: existing?.workItemId ?? newId(),\n ...(existing ? { revision: Math.max(existing.revision, row.revision) + 1 } : {}),\n });\n if (existing) card.previousHash = existing.migratedFromHash;\n (existing ? plan.recopies : plan.inserts).push(card);\n } catch (error) {\n plan.skipped.push({ id: row.id, reason: error instanceof Error ? error.message : String(error) });\n }\n }\n return plan;\n}\n\nasync function migratedBoardItems(\n ops: FactoryStorageOps,\n ids: readonly string[],\n): Promise<Map<string, MigratedBoardItem>> {\n if (!ids.length) return new Map();\n const rows = await ops.findMany<BoardItemDbRecord>(BOARD_ITEMS, { id: { in: [...ids] } });\n return new Map(\n rows.map(row => [\n row.id,\n {\n workItemId: row.work_item_id,\n revision: row.revision,\n updatedAt: row.updated_at,\n migratedFromUpdatedAt: row.migrated_from_updated_at,\n migratedFromHash: row.migrated_from_hash,\n },\n ]),\n );\n}\n\nclass MigrationConflict extends Error {}\n\nasync function writeCard(ops: FactoryStorageOps, card: WorkItemSplitCard, recopy: boolean): Promise<boolean> {\n if (!recopy) {\n // Both paths take this card-specific lock before any card rows. A project-wide\n // lock here would invert the row-lock order of parent/child and bulk deletions.\n const guard = await ops.updateAtomic(\n FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA.name,\n { id: card.boardItem.id },\n () => null,\n );\n if (!guard)\n await ops.insertOne(FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA.name, {\n id: card.boardItem.id,\n org_id: card.boardItem.org_id,\n factory_project_id: card.boardItem.factory_project_id,\n });\n if (await ops.findOne(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, { id: card.boardItem.id })) return false;\n const existing = await ops.findOne<BoardItemDbRecord>(BOARD_ITEMS, { id: card.boardItem.id });\n if (existing) {\n if (existing.migrated_from_hash === card.boardItem.migrated_from_hash) return false;\n throw new MigrationConflict('Migration baseline changed since planning');\n }\n await ops.insertOne<WorkItemDbRecord>(WORK_ITEMS, card.workItem);\n if (card.source) await ops.insertOne<WorkItemSourceDbRecord>(SOURCES, card.source);\n await ops.insertOne<BoardItemDbRecord>(BOARD_ITEMS, card.boardItem);\n return true;\n }\n // updateAtomic locks the board row until this transaction commits, so a new\n // transition cannot land between the overwrite guard and the copy.\n let unchanged = false;\n let baseline = Number.NEGATIVE_INFINITY;\n const board = await ops.updateAtomic<BoardItemDbRecord>(BOARD_ITEMS, { id: card.boardItem.id }, current => {\n if (current.migrated_from_hash === card.boardItem.migrated_from_hash) {\n unchanged = true;\n return null;\n }\n if (current.migrated_from_hash !== card.previousHash) {\n throw new MigrationConflict('Migration baseline changed since planning');\n }\n if (time(current.updated_at) > time(current.migrated_from_updated_at)) {\n throw new MigrationConflict('Split board item changed after migration');\n }\n baseline = time(current.migrated_from_updated_at);\n return {\n ...card.boardItem,\n ...(current.feed_activity_at\n ? { comment_count: current.comment_count, feed_activity_at: current.feed_activity_at }\n : {}),\n revision: Math.max(current.revision, card.boardItem.revision) + 1,\n };\n });\n if (unchanged) return false;\n if (!board) throw new MigrationConflict('Split board item disappeared during migration');\n await ops.updateAtomic<WorkItemDbRecord>(WORK_ITEMS, { id: card.workItem.id }, current => {\n if (time(current.updated_at) > baseline) {\n throw new MigrationConflict('Split work item changed after migration');\n }\n return { ...card.workItem, revision: current.revision + 1 };\n });\n const sources = await ops.findMany<WorkItemSourceDbRecord>(SOURCES, { work_item_id: card.workItem.id });\n if (sources.some(source => source.id !== card.workItem.id)) {\n throw new MigrationConflict('Split source set changed after migration');\n }\n for (const source of sources) {\n await ops.updateAtomic<WorkItemSourceDbRecord>(SOURCES, { id: source.id }, current => {\n if (current.synced_at != null || time(current.updated_at) > baseline) {\n throw new MigrationConflict('Split source changed after migration');\n }\n return null;\n });\n }\n if (sources.length) await ops.deleteMany(SOURCES, { id: { in: sources.map(source => source.id) } });\n if (card.source) await ops.insertOne<WorkItemSourceDbRecord>(SOURCES, card.source);\n return true;\n}\n\nexport interface MigrateWorkItemSplitOptions {\n dryRun?: boolean;\n ops?: FactoryStorageOps;\n log?: (message: string, details?: Record<string, unknown>) => void;\n}\n\n/** Legacy rows are read-only; each card and all its split rows land atomically. */\nexport async function migrateWorkItemSplit(\n storage: Pick<FactoryStorage, 'ops' | 'withTransaction'>,\n { dryRun = false, ops = storage.ops, log }: MigrateWorkItemSplitOptions = {},\n): Promise<WorkItemSplitReport> {\n const report: WorkItemSplitReport = {\n dryRun,\n projects: 0,\n cards: 0,\n workItems: 0,\n sources: 0,\n boardItems: 0,\n recopied: 0,\n unchanged: 0,\n skipped: [],\n };\n const projects = new Set<string>();\n const written = new Map<string, BoardScope>();\n let cursor: WorkItemDbRow | undefined;\n while (true) {\n const page = await ops.findMany<WorkItemDbRow>(\n LEGACY,\n {},\n {\n orderBy: [\n ['org_id', 'asc'],\n ['factory_project_id', 'asc'],\n ['created_at', 'asc'],\n ['id', 'asc'],\n ],\n limit: PAGE_SIZE,\n ...(cursor\n ? { cursor: { values: [cursor.org_id, cursor.factory_project_id, cursor.created_at, cursor.id] } }\n : {}),\n },\n );\n if (!page.length) break;\n cursor = page[page.length - 1];\n const rows = page;\n report.cards += rows.length;\n for (const row of rows) projects.add(`${row.org_id}\\u0000${row.factory_project_id}`);\n const tombstones = await ops.findMany<{ id: string }>(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, {\n id: { in: rows.map(row => row.id) },\n });\n const deleted = new Set(tombstones.map(row => row.id));\n report.unchanged += deleted.size;\n const plan = planWorkItemSplit(\n rows.filter(row => !deleted.has(row.id)),\n await migratedBoardItems(\n ops,\n rows.map(row => row.id),\n ),\n );\n report.unchanged += plan.unchanged;\n report.skipped.push(...plan.skipped);\n for (const { card, recopy } of [\n ...plan.inserts.map(card => ({ card, recopy: false })),\n ...plan.recopies.map(card => ({ card, recopy: true })),\n ]) {\n if (!dryRun) {\n try {\n const changed = await storage.withTransaction(tx => writeCard(tx, card, recopy));\n if (!changed) {\n report.unchanged += 1;\n continue;\n }\n } catch (error) {\n if (!(error instanceof UniqueViolationError) && !(error instanceof MigrationConflict)) throw error;\n const raced = (await migratedBoardItems(ops, [card.boardItem.id])).get(card.boardItem.id);\n if (raced?.migratedFromHash === card.boardItem.migrated_from_hash) report.unchanged += 1;\n else {\n const reason =\n error instanceof UniqueViolationError &&\n (error.collection === SOURCES || error.collection === BOARD_ITEMS)\n ? `Conflicting source: ${error.message}`\n : error.message;\n report.skipped.push({ id: card.boardItem.id, reason });\n }\n continue;\n }\n }\n report.workItems += 1;\n report.sources += card.source ? 1 : 0;\n report.boardItems += 1;\n if (recopy) report.recopied += 1;\n written.set(`${card.boardItem.org_id}\\u0000${card.boardItem.factory_project_id}`, {\n orgId: card.boardItem.org_id,\n factoryProjectId: card.boardItem.factory_project_id,\n });\n }\n if (page.length < PAGE_SIZE) break;\n }\n report.projects = projects.size;\n if (!dryRun && written.size) await bumpBoardVersions(ops, [...written.values()]);\n if (report.workItems || report.skipped.length || dryRun) {\n log?.(dryRun ? 'Factory work item split (dry run)' : 'Factory work item split', { ...report });\n }\n return report;\n}\n"],"mappings":"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"}
@@ -39,30 +39,26 @@ GitHub and Linear integrations exclusively own their event handlers; configure t
39
39
 
40
40
  Do not create an `actions` config or execute authoritative policy in React. Each handler returns one typed `FactoryRuleDecision` or `undefined`.
41
41
 
42
- Work and Review cards move independently. Never mirror their stages or mark Work Done only because a pull request merged.
42
+ A pull request's own card and the Work card that authored it move independently, whether the pull request card sits on Work or on the legacy Review board. Never mirror their stages or mark Work Done only because a pull request merged.
43
43
 
44
- ## Configure board transition policy
44
+ ## Restrict where cards move
45
45
 
46
- Search the installed `defineBoard()` definition for `transitionPolicy`. Read `src/boards/transition-policy.ts` for the public contract and `src/boards/work-transition-policy.ts` for Work's automatic classification, approval, and acceptance policy. Review has no additional policy. Custom boards without a policy do not inherit Work's classification or acceptance behavior through phase or role names.
47
-
48
- Topology declares allowed moves; transition policy adds business restrictions; lifecycle handlers return effects. Add custom restrictions to the board definition, not the generic transition service or global rules:
46
+ Topology (`nextPhases`) declares the moves that exist, for everyone: people dragging cards, agents and board rules (lifecycle, tool-result and integration handlers). To keep a move from happening, leave it out of the source phase's `nextPhases`. Do not add restrictions to the generic transition service or global rules.
49
47
 
50
48
  ```typescript
51
- import type { BoardTransitionPolicy } from '@mastra/factory/boards';
52
-
53
- const transitionPolicy: BoardTransitionPolicy = context => {
54
- if (context.toStage === 'shipped' && !context.isHumanTransition) {
55
- return { type: 'reject', code: 'approval_required', reason: 'A person must approve this release.' };
56
- }
57
- };
58
- // Pass transitionPolicy to the installed custom defineBoard() definition.
49
+ backlog: {
50
+ name: 'Backlog',
51
+ kind: 'resting',
52
+ // Cards are built before they ship; nobody closes a card straight from the backlog.
53
+ nextPhases: ['build', 'canceled'],
54
+ },
59
55
  ```
60
56
 
61
- The policy receives a deeply readonly snapshot with ISO-string dates. Return `undefined`, `{ type: 'allow', triageType?, accept?: true }`, or `{ type: 'reject', code, reason }`, never skill calls, transitions, consent overrides, or patches. Classification intents require the existing triage-agent path and must match its requested classification. Acceptance requires both human actor and human ingress. Runtime validates results and commits intents atomically only after successful lifecycle evaluation.
57
+ Read `src/boards/work.ts` for Work's topology (no skipping Planning, Building only through an approved plan, self-review returns to Building or parks in Intake) and `src/boards/review.ts` for Review. Whether work is finished is the agent's instructions, not the board's: say when to move a card to Done in the phase's skill or `runner.instructions`.
62
58
 
63
- Policies must be side-effect-free and share the lifecycle timeout budget. Initial entry, reentry, and same-stage requests evaluate policy; completed replay does not. Concurrent attempts may evaluate more than once, and timing out does not cancel work started by a callback. Do not access storage or integrations from a policy.
59
+ A working phase whose `exitTool` has a board tool rule (`tools[exitTool.id]`) leaves through that tool: anyone but a person asking to move the card on to another working phase is rejected unless the exit tool is auto-approved for the card. Work's Planning uses `submit_plan` with `autoApprove: false`, so every plan waits for a person. To approve plans without a person on your own board, set `exitTool.autoApprove` (optionally with `autoApproveWhen`); there is no project setting.
64
60
 
65
- Policy allowance cannot bypass topology, board ownership, ingress authorization, external-author safety, revision checks, replay, or decision validation. Phase meaning is declared on the phase (`kind`), not in the policy. Do not invent built-in replacement APIs.
61
+ `transitionPolicy` is deprecated: it still runs for boards that set it and logs one warning per board. Do not add new policies; express the flow with `nextPhases` and `exitTool`. Factory no longer records triage classification or acceptance: Work's triage agent sends open non-bugs back to Intake, and a person moving the card on is the approval. Custom boards inherit none of Work's rules through phase or role names.
66
62
 
67
63
  ## Configure board phase semantics
68
64
 
@@ -80,7 +76,7 @@ A `transition` decision stays on the item's assigned board. An `upsertLinkedWork
80
76
 
81
77
  Working roles identify bindings on the shared Code Agent, not separately configured agents. There is no per-role agent registration option. Declare `invokeSkill` decisions with the working role and a board-owned prompt (or an available skill); do not invent an `agents` configuration. For automatic session preparation, verify the deployment's GitHub integration, project connection and linked repository, sandbox, organization model credentials, and project automatic-run setting. Enter a working phase through the public transition route as an authorized human when approval is required.
82
78
 
83
- Verify the actual journey: initial entry, lifecycle kickoff, the declared role's phase signal and binding, a bound transition tool, role handoff, completed tool-result ingestion, deferred transition, and terminal cleanup. Polling and persisted-message ingestion resolve the single current phase through the installed board. Live binding, reassignment, revision, topology, approval, and external-author checks still apply. Custom roles named `triage` do not inherit Work classification requirements. A tool-result handler receives normalized `result.status` and `result.value`; it does not receive raw tool arguments. Check the result payload needed by the board's policy rather than treating every completed tool call as business success.
79
+ Verify the actual journey: initial entry, lifecycle kickoff, the declared role's phase signal and binding, a bound transition tool, role handoff, completed tool-result ingestion, deferred transition, and terminal cleanup. Polling and persisted-message ingestion resolve the single current phase through the installed board. Live binding, reassignment, revision, topology, approval, and external-author checks still apply. Custom roles named `triage` inherit nothing from Work. A tool-result handler receives normalized `result.status` and `result.value`; it does not receive raw tool arguments. Check the result payload the board's rules need rather than treating every completed tool call as business success.
84
80
 
85
81
  Keep the remaining limits explicit: `factory-ui` still uses built-in stages and roles, completion metrics still use Work's `done` phase, and `held-waiting` is Work-specific. Existing integration defaults do not automatically route events to a custom board.
86
82
 
@@ -41,6 +41,6 @@ Write the findings argument of the verdict call as Markdown the builder (on requ
41
41
 
42
42
  ## Verdict
43
43
 
44
- Call `factory_record_review_verdict` with `verdict` (`approve` or `request changes`), `reviewedHeadSha` (the head you tested), and `findings` (the report). Approve keeps the card in Review and wakes the builder to open the change request from that exact head. Request changes sends it back to Building with your report. After the round limit in the factory-phase arguments, a further request changes parks the card for a human, so make each round's requests complete.
44
+ Call `factory_record_review_verdict` with `verdict` (`approve` or `request changes`), `reviewedHeadSha` (the head you tested), and `findings` (the report). Approve keeps the card in Review and wakes the builder to open the change request from that exact head. Request changes sends it back to Building with your report. After the round limit in the factory-phase arguments, a further request changes parks the card for a human, so make each round's requests complete. Never move the card to Done yourself: an approving verdict hands it back to the builder, which opens the change request, and the merge finishes it.
45
45
 
46
46
  Then post the report as your final conversation message and stop.
@@ -149,7 +149,7 @@ Write one concise **handoff** for whoever plans the fix. It must begin with the
149
149
  Fill the placeholders as follows:
150
150
 
151
151
  - Write the summary for a maintainer skimming their notifications. Say what breaks for the user, not how the code breaks; no file names, function names, or internal ids — those go under Root cause.
152
- - `<Type>` is one of: bug, feature request, docs, question/support, maintenance, duplicate, resolved, invalid, spam, out-of-scope, other, capitalized for display; pass the lowercase value as `triageType`. `<Severity>` and `<level>` are the lowercase ratings from the guides below. `<Route>` is one of: Plan fix, Await approval, Ask author for info, Close as duplicate/resolved/invalid/spam/out-of-scope, Answer provided / close, No transition / refresh, Other.
152
+ - `<Type>` is one of: bug, feature request, docs, question/support, maintenance, duplicate, resolved, invalid, spam, out-of-scope, other, capitalized for display. `<Severity>` and `<level>` are the lowercase ratings from the guides below. `<Route>` is one of: Plan fix, Await approval, Ask author for info, Close as duplicate/resolved/invalid/spam/out-of-scope, Answer provided / close, No transition / refresh, Other.
153
153
  - `<dots>` shows the rating at a glance. Severity uses four dots: `●○○○` low, `●●○○` medium, `●●●○` high, `●●●●` critical. Confidence, effort, and impact use three: `●○○` low, `●●○` medium, `●●●` high. Always follow the dots with the word.
154
154
  - Each rating reason is at most 12 words.
155
155
  - Keep the collapsed sections collapsed. Only the ratings table, the summary, the next step, and open questions stay visible.
@@ -213,9 +213,9 @@ For non-GitHub sources, use the same structured handoff without attempting GitHu
213
213
 
214
214
  Post the same handoff as your final conversation message. Take the current stage and `expectedRevision` from the `factory-phase` signal.
215
215
 
216
- - When the current stage is **Intake** or **Triage**, make the terminal `factory_transition_work_item` call with `triageType` set to the exact `Type` from the handoff.
216
+ - When the current stage is **Intake** or **Triage**, make the terminal `factory_transition_work_item` call and start its `rationale` with the exact `Type` from the handoff. Factory does not record a classification; never pass a `triageType` argument.
217
217
  - Confirmed bugs with `Route: Plan fix` request `stage: "planning"`. Issues that should be closed request `stage: "done"` with the close rationale.
218
- - Features and every other non-bug classification use `Route: Await approval` and request their current Intake/Triage stage. This records the classification without advancing; stop until a maintainer moves the card or starts the next run from the Factory UI.
218
+ - Features and every other open non-bug classification use `Route: Await approval` and request `stage: "intake"`. The card rests in Intake until a maintainer moves it on; that move is the approval. Stop after the transition.
219
219
  - When the item is already in **Planning** or a later stage, this is a webhook-driven refresh: use `Route: No transition / refresh`, update the source-specific handoff, but do **not** request a stage transition. Report the updated verdict and stop.
220
220
 
221
221
  `rationale` (max 1000 chars) — the triage verdict and headline understanding in a few sentences (e.g. "Genuine regression from <commit>; root cause understood; ready to plan a fix").
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/factory",
3
- "version": "0.27.0-alpha.1",
3
+ "version": "0.27.0-alpha.3",
4
4
  "description": "Mastra Software Factory module: the server core behind the Mastra Software Factory — storage domains, integrations, and surfaces for agent-powered software delivery",
5
5
  "type": "module",
6
6
  "publishConfig": {
@@ -53,32 +53,32 @@
53
53
  "dependencies": {
54
54
  "@octokit/auth-app": "^8.3.1",
55
55
  "@octokit/rest": "^22.0.1",
56
- "chat": "^4.43.0",
56
+ "chat": "^4.44.0",
57
57
  "fetch-to-node": "^2.1.0",
58
58
  "hono": "^4.13.13",
59
59
  "posthog-node": "^5.57.1",
60
60
  "zod": "^4.6.7",
61
61
  "@mastra/auth-studio": "1.3.11",
62
62
  "@mastra/auth-workos": "1.6.8",
63
- "@mastra/code-sdk": "1.18.0-alpha.1",
64
- "@mastra/core": "1.82.0-alpha.1",
65
- "@mastra/mcp": "2.8.0-alpha.0",
66
- "@mastra/platform-workspace": "1.11.1-alpha.0",
67
- "@mastra/slack": "1.8.0"
63
+ "@mastra/code-sdk": "1.18.0-alpha.3",
64
+ "@mastra/core": "1.82.0-alpha.3",
65
+ "@mastra/mcp": "2.8.0-alpha.2",
66
+ "@mastra/platform-workspace": "1.12.0-alpha.1",
67
+ "@mastra/slack": "1.8.1-alpha.0"
68
68
  },
69
69
  "devDependencies": {
70
70
  "@types/node": "22.19.15",
71
71
  "msw": "^2.12.11",
72
72
  "tsdown": "0.23.1",
73
73
  "typescript": "^6.0.3",
74
- "vitest": "4.1.12",
74
+ "vitest": "5.1.0",
75
75
  "@internal/lint": "0.0.147",
76
76
  "@internal/types-builder": "0.0.122",
77
77
  "@internal/workspace": "0.0.19",
78
- "@mastra/deployer": "1.82.0-alpha.1",
79
- "@mastra/libsql": "1.29.0-alpha.0",
80
- "@mastra/pg": "1.35.0-alpha.1",
81
- "@mastra/server": "1.82.0-alpha.1"
78
+ "@mastra/deployer": "1.82.0-alpha.3",
79
+ "@mastra/libsql": "1.29.0-alpha.2",
80
+ "@mastra/pg": "1.35.0-alpha.3",
81
+ "@mastra/server": "1.82.0-alpha.3"
82
82
  },
83
83
  "engines": {
84
84
  "node": ">=22.19.0"
@@ -1,3 +0,0 @@
1
- import type { BoardTransitionPolicy } from './transition-policy.js';
2
- export declare const workTransitionPolicy: BoardTransitionPolicy;
3
- //# sourceMappingURL=work-transition-policy.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"work-transition-policy.d.ts","sourceRoot":"","sources":["../../src/boards/work-transition-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,eAAO,MAAM,oBAAoB,EAAE,qBAgGlC,CAAC"}
@@ -1,56 +0,0 @@
1
- // src/boards/work-transition-policy.ts
2
- const workTransitionPolicy = (context) => {
3
- const { item, requestedTriageType, actor, fromStage, toStage, isHumanTransition, plansAutoApproved, planApproved } = context;
4
- const triageAgent = actor.type === "agent" && actor.role === "triage";
5
- if (triageAgent && requestedTriageType === void 0) return {
6
- type: "reject",
7
- code: "invalid_transition",
8
- reason: "Triage transitions must report a structured triage classification."
9
- };
10
- if (item.triageType && requestedTriageType && item.triageType !== requestedTriageType) return {
11
- type: "reject",
12
- code: "forbidden",
13
- reason: "The persisted triage classification cannot be changed by a later transition."
14
- };
15
- const skipsPlanning = (fromStage === "intake" || fromStage === "triage") && actor.type === "agent";
16
- if ((fromStage === "planning" || skipsPlanning) && toStage === "execute" && actor.type !== "human" && !plansAutoApproved && !planApproved) return {
17
- type: "reject",
18
- code: "approval_required",
19
- reason: "Auto-approve plans is off, so a person has to approve this plan. Ask them to say so in a chat they are signed in to (Slack, terminal, web); that turn can move the card into Building with factory_transition_work_item."
20
- };
21
- if (toStage === "done" && actor.type === "agent" && item.metadata?.reviewVerdict === "request changes") return {
22
- type: "reject",
23
- code: "invalid_transition",
24
- reason: "The latest Factory review requested changes on this pull request. Address them and push; the re-review updates the verdict. A merge or a maintainer can still close the work."
25
- };
26
- if (toStage === "done" && actor.type === "agent" && typeof item.metadata?.openPullRequestNumber === "number") return {
27
- type: "reject",
28
- code: "invalid_transition",
29
- reason: `Pull request #${item.metadata.openPullRequestNumber} is still open. The card moves to Done when it merges; a maintainer can still close the work.`
30
- };
31
- if (fromStage === "intake" && actor.type === "agent" && item.metadata?.selfReviewNeedsHuman === true) return {
32
- type: "reject",
33
- code: "approval_required",
34
- reason: "Self-review requested changes too many times and parked this work item for a person. Ask them to decide in a chat they are signed in to; that turn can move the card on with factory_transition_work_item."
35
- };
36
- if (fromStage === "review" && toStage === "done" && actor.type === "agent" && typeof item.metadata?.openPullRequestNumber !== "number" && item.metadata?.reviewVerdict === void 0 && item.metadata?.selfReviewVerdict !== "approve") return {
37
- type: "reject",
38
- code: "invalid_transition",
39
- reason: "This work item is in self-review and has no open change request yet. Record a self-review verdict instead; a maintainer can still close the work."
40
- };
41
- const triageType = item.triageType ?? requestedTriageType;
42
- const entersWork = toStage === "planning" || toStage === "execute";
43
- if (triageType != null && triageType !== "bug" && entersWork && !isHumanTransition && !item.acceptedAt) return {
44
- type: "reject",
45
- code: "approval_required",
46
- reason: "A person must accept this non-bug work item before it enters Planning or Execute. Ask them to say so in a chat they are signed in to; that turn can move the card with factory_transition_work_item."
47
- };
48
- return {
49
- type: "allow",
50
- ...triageAgent && requestedTriageType ? { triageType: requestedTriageType } : {},
51
- ...isHumanTransition && entersWork && !item.acceptedAt ? { accept: true } : {}
52
- };
53
- };
54
- export { workTransitionPolicy };
55
-
56
- //# sourceMappingURL=work-transition-policy.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"work-transition-policy.js","names":[],"sources":["../../src/boards/work-transition-policy.ts"],"sourcesContent":["import type { BoardTransitionPolicy } from './transition-policy.js';\n\nexport const workTransitionPolicy: BoardTransitionPolicy = context => {\n const { item, requestedTriageType, actor, fromStage, toStage, isHumanTransition, plansAutoApproved, planApproved } =\n context;\n const triageAgent = actor.type === 'agent' && actor.role === 'triage';\n if (triageAgent && requestedTriageType === undefined) {\n return {\n type: 'reject',\n code: 'invalid_transition',\n reason: 'Triage transitions must report a structured triage classification.',\n };\n }\n if (item.triageType && requestedTriageType && item.triageType !== requestedTriageType) {\n return {\n type: 'reject',\n code: 'forbidden',\n reason: 'The persisted triage classification cannot be changed by a later transition.',\n };\n }\n // Planning is the approval boundary. When project auto-approval is off, only a\n // person or a successfully approved `submit_plan` result may move the card into Building.\n // An agent cannot skip Planning from Intake or Triage either; maintainer-configured\n // system rules may still route cards there.\n const skipsPlanning = (fromStage === 'intake' || fromStage === 'triage') && actor.type === 'agent';\n if (\n (fromStage === 'planning' || skipsPlanning) &&\n toStage === 'execute' &&\n actor.type !== 'human' &&\n !plansAutoApproved &&\n !planApproved\n ) {\n return {\n type: 'reject',\n code: 'approval_required',\n reason:\n 'Auto-approve plans is off, so a person has to approve this plan. Ask them to say so in a chat they are signed in to (Slack, terminal, web); that turn can move the card into Building with factory_transition_work_item.',\n };\n }\n // A Factory review requested changes on this item's pull request. Closing the\n // work now would bury the finding; the next push re-reviews and updates it.\n if (toStage === 'done' && actor.type === 'agent' && item.metadata?.reviewVerdict === 'request changes') {\n return {\n type: 'reject',\n code: 'invalid_transition',\n reason:\n 'The latest Factory review requested changes on this pull request. Address them and push; the re-review updates the verdict. A merge or a maintainer can still close the work.',\n };\n }\n // The work ships when its pull request merges, and the merge closes the card.\n if (toStage === 'done' && actor.type === 'agent' && typeof item.metadata?.openPullRequestNumber === 'number') {\n return {\n type: 'reject',\n code: 'invalid_transition',\n reason: `Pull request #${item.metadata.openPullRequestNumber} is still open. The card moves to Done when it merges; a maintainer can still close the work.`,\n };\n }\n // Self-review hit its round limit and parked the card for a person.\n if (fromStage === 'intake' && actor.type === 'agent' && item.metadata?.selfReviewNeedsHuman === true) {\n return {\n type: 'reject',\n code: 'approval_required',\n reason:\n 'Self-review requested changes too many times and parked this work item for a person. Ask them to decide in a chat they are signed in to; that turn can move the card on with factory_transition_work_item.',\n };\n }\n // In Review without a change request, the card is waiting on self-review; an agent cannot close it from there.\n if (\n fromStage === 'review' &&\n toStage === 'done' &&\n actor.type === 'agent' &&\n typeof item.metadata?.openPullRequestNumber !== 'number' &&\n item.metadata?.reviewVerdict === undefined &&\n item.metadata?.selfReviewVerdict !== 'approve'\n ) {\n return {\n type: 'reject',\n code: 'invalid_transition',\n reason:\n 'This work item is in self-review and has no open change request yet. Record a self-review verdict instead; a maintainer can still close the work.',\n };\n }\n const triageType = item.triageType ?? requestedTriageType;\n const entersWork = toStage === 'planning' || toStage === 'execute';\n // An intermediate phase is not evidence of human approval.\n if (triageType != null && triageType !== 'bug' && entersWork && !isHumanTransition && !item.acceptedAt) {\n return {\n type: 'reject',\n code: 'approval_required',\n reason:\n 'A person must accept this non-bug work item before it enters Planning or Execute. Ask them to say so in a chat they are signed in to; that turn can move the card with factory_transition_work_item.',\n };\n }\n return {\n type: 'allow',\n ...(triageAgent && requestedTriageType ? { triageType: requestedTriageType } : {}),\n ...(isHumanTransition && entersWork && !item.acceptedAt ? { accept: true as const } : {}),\n };\n};\n"],"mappings":";AAEA,MAAa,wBAA8C,YAAW;CACpE,MAAM,EAAE,MAAM,qBAAqB,OAAO,WAAW,SAAS,mBAAmB,mBAAmB,iBAClG;CACF,MAAM,cAAc,MAAM,SAAS,WAAW,MAAM,SAAS;CAC7D,IAAI,eAAe,wBAAwB,KAAA,GACzC,OAAO;EACL,MAAM;EACN,MAAM;EACN,QAAQ;CACV;CAEF,IAAI,KAAK,cAAc,uBAAuB,KAAK,eAAe,qBAChE,OAAO;EACL,MAAM;EACN,MAAM;EACN,QAAQ;CACV;CAMF,MAAM,iBAAiB,cAAc,YAAY,cAAc,aAAa,MAAM,SAAS;CAC3F,KACG,cAAc,cAAc,kBAC7B,YAAY,aACZ,MAAM,SAAS,WACf,CAAC,qBACD,CAAC,cAED,OAAO;EACL,MAAM;EACN,MAAM;EACN,QACE;CACJ;CAIF,IAAI,YAAY,UAAU,MAAM,SAAS,WAAW,KAAK,UAAU,kBAAkB,mBACnF,OAAO;EACL,MAAM;EACN,MAAM;EACN,QACE;CACJ;CAGF,IAAI,YAAY,UAAU,MAAM,SAAS,WAAW,OAAO,KAAK,UAAU,0BAA0B,UAClG,OAAO;EACL,MAAM;EACN,MAAM;EACN,QAAQ,iBAAiB,KAAK,SAAS,sBAAsB;CAC/D;CAGF,IAAI,cAAc,YAAY,MAAM,SAAS,WAAW,KAAK,UAAU,yBAAyB,MAC9F,OAAO;EACL,MAAM;EACN,MAAM;EACN,QACE;CACJ;CAGF,IACE,cAAc,YACd,YAAY,UACZ,MAAM,SAAS,WACf,OAAO,KAAK,UAAU,0BAA0B,YAChD,KAAK,UAAU,kBAAkB,KAAA,KACjC,KAAK,UAAU,sBAAsB,WAErC,OAAO;EACL,MAAM;EACN,MAAM;EACN,QACE;CACJ;CAEF,MAAM,aAAa,KAAK,cAAc;CACtC,MAAM,aAAa,YAAY,cAAc,YAAY;CAEzD,IAAI,cAAc,QAAQ,eAAe,SAAS,cAAc,CAAC,qBAAqB,CAAC,KAAK,YAC1F,OAAO;EACL,MAAM;EACN,MAAM;EACN,QACE;CACJ;CAEF,OAAO;EACL,MAAM;EACN,GAAI,eAAe,sBAAsB,EAAE,YAAY,oBAAoB,IAAI,CAAC;EAChF,GAAI,qBAAqB,cAAc,CAAC,KAAK,aAAa,EAAE,QAAQ,KAAc,IAAI,CAAC;CACzF;AACF"}