@mastra/factory 0.27.0-alpha.3 → 0.28.0-alpha.0

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 (169) hide show
  1. package/README.md +6 -0
  2. package/dist/boards/index.js +1 -1
  3. package/dist/boards/project-boards.js +1 -1
  4. package/dist/boards/work.js +1 -1
  5. package/dist/dispatch-wake.d.ts +13 -0
  6. package/dist/dispatch-wake.d.ts.map +1 -0
  7. package/dist/dispatch-wake.js +30 -0
  8. package/dist/dispatch-wake.js.map +1 -0
  9. package/dist/environment/build-runner.d.ts +1 -1
  10. package/dist/environment/build-runner.d.ts.map +1 -1
  11. package/dist/environment/build-runner.js +2 -2
  12. package/dist/environment/build-workflow.d.ts +1 -1
  13. package/dist/environment/build-workflow.d.ts.map +1 -1
  14. package/dist/environment/build-workflow.js +1 -1
  15. package/dist/environment/build.js +1 -1
  16. package/dist/factory.d.ts.map +1 -1
  17. package/dist/factory.js +57 -44
  18. package/dist/factory.js.map +1 -1
  19. package/dist/index.js +9 -9
  20. package/dist/integrations/channel-thread-announcements.d.ts +5 -0
  21. package/dist/integrations/channel-thread-announcements.d.ts.map +1 -1
  22. package/dist/integrations/channel-thread-announcements.js +24 -2
  23. package/dist/integrations/channel-thread-announcements.js.map +1 -1
  24. package/dist/integrations/github/default-rules.js +1 -1
  25. package/dist/integrations/github/integration.js +2 -2
  26. package/dist/integrations/github/routes.d.ts.map +1 -1
  27. package/dist/integrations/github/routes.js +18 -17
  28. package/dist/integrations/github/routes.js.map +1 -1
  29. package/dist/integrations/github/rules.js +4 -4
  30. package/dist/integrations/github/sandbox.js +1 -1
  31. package/dist/integrations/github/session-subscriptions.js +3 -3
  32. package/dist/integrations/github/webhook.js +2 -2
  33. package/dist/integrations/gitlab/integration.js +2 -2
  34. package/dist/integrations/gitlab/issue-reconciler.js +1 -1
  35. package/dist/integrations/gitlab/merge-request-reconciler.js +3 -3
  36. package/dist/integrations/gitlab/routes.js +1 -1
  37. package/dist/integrations/gitlab/rules.js +3 -3
  38. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  39. package/dist/integrations/gitlab/webhook-dispatch.js +1 -1
  40. package/dist/integrations/incidentio/integration.js +3 -3
  41. package/dist/integrations/incidentio/rules.js +2 -2
  42. package/dist/integrations/jira/integration.js +2 -2
  43. package/dist/integrations/jira/routes.js +1 -1
  44. package/dist/integrations/jira/rules.js +2 -2
  45. package/dist/integrations/linear/integration.js +2 -2
  46. package/dist/integrations/linear/routes.d.ts +21 -1
  47. package/dist/integrations/linear/routes.d.ts.map +1 -1
  48. package/dist/integrations/linear/routes.js +20 -2
  49. package/dist/integrations/linear/routes.js.map +1 -1
  50. package/dist/integrations/linear/rules.js +2 -2
  51. package/dist/integrations/platform/github/event-worker.js +1 -1
  52. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  53. package/dist/integrations/platform/github/integration.js +8 -5
  54. package/dist/integrations/platform/github/integration.js.map +1 -1
  55. package/dist/integrations/platform/gitlab/event-worker.js +1 -1
  56. package/dist/integrations/platform/gitlab/integration.js +2 -2
  57. package/dist/integrations/platform/incidentio/integration.js +5 -5
  58. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  59. package/dist/integrations/platform/jira/integration.js +2 -2
  60. package/dist/integrations/platform/jira/routes.js +1 -1
  61. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  62. package/dist/integrations/platform/linear/integration.js +149 -45
  63. package/dist/integrations/platform/linear/integration.js.map +1 -1
  64. package/dist/integrations/slack/chat-tools.d.ts +16 -0
  65. package/dist/integrations/slack/chat-tools.d.ts.map +1 -0
  66. package/dist/integrations/slack/chat-tools.js +215 -0
  67. package/dist/integrations/slack/chat-tools.js.map +1 -0
  68. package/dist/integrations/slack/integration.d.ts +19 -3
  69. package/dist/integrations/slack/integration.d.ts.map +1 -1
  70. package/dist/integrations/slack/integration.js +25 -8
  71. package/dist/integrations/slack/integration.js.map +1 -1
  72. package/dist/integrations/slack/run-error-card.js +1 -1
  73. package/dist/integrations/slack/share-file-tool.d.ts +8 -0
  74. package/dist/integrations/slack/share-file-tool.d.ts.map +1 -1
  75. package/dist/integrations/slack/share-file-tool.js +13 -4
  76. package/dist/integrations/slack/share-file-tool.js.map +1 -1
  77. package/dist/integrations/slack/slack.js +3 -3
  78. package/dist/integrations/slack/tool-settings.d.ts +26 -0
  79. package/dist/integrations/slack/tool-settings.d.ts.map +1 -0
  80. package/dist/integrations/slack/tool-settings.js +35 -0
  81. package/dist/integrations/slack/tool-settings.js.map +1 -0
  82. package/dist/mcp/events.js +1 -1
  83. package/dist/mcp/routes.js +1 -1
  84. package/dist/routes/attention-activity.js +2 -2
  85. package/dist/routes/attention-providers.js +3 -3
  86. package/dist/routes/attention.js +2 -2
  87. package/dist/routes/automation-runs.js +1 -1
  88. package/dist/routes/boards.js +2 -2
  89. package/dist/routes/config.js +4 -4
  90. package/dist/routes/contracts.d.ts +30 -2
  91. package/dist/routes/contracts.d.ts.map +1 -1
  92. package/dist/routes/contracts.js +22 -5
  93. package/dist/routes/contracts.js.map +1 -1
  94. package/dist/routes/fs.js +1 -1
  95. package/dist/routes/intake.js +1 -1
  96. package/dist/routes/projects.d.ts.map +1 -1
  97. package/dist/routes/projects.js +35 -24
  98. package/dist/routes/projects.js.map +1 -1
  99. package/dist/routes/skills.js +2 -2
  100. package/dist/routes/source-control-sessions.js +2 -2
  101. package/dist/routes/surface.js +16 -16
  102. package/dist/routes/telemetry.js +1 -1
  103. package/dist/routes/work-items.js +9 -9
  104. package/dist/rules/decision-applicability.js +2 -2
  105. package/dist/rules/dispatcher.d.ts +14 -0
  106. package/dist/rules/dispatcher.d.ts.map +1 -1
  107. package/dist/rules/dispatcher.js +135 -47
  108. package/dist/rules/dispatcher.js.map +1 -1
  109. package/dist/rules/index.js +1 -1
  110. package/dist/rules/processor.d.ts +2 -0
  111. package/dist/rules/processor.d.ts.map +1 -1
  112. package/dist/rules/processor.js +4 -3
  113. package/dist/rules/processor.js.map +1 -1
  114. package/dist/rules/start-coordinator.js +2 -2
  115. package/dist/rules/terminal-cleanup.js.map +1 -1
  116. package/dist/rules/tools.js +5 -5
  117. package/dist/rules/transition-service.js +5 -5
  118. package/dist/sandbox/session-retirement.js +2 -2
  119. package/dist/sandbox/session-sandbox.js +1 -1
  120. package/dist/session/credential-policy.js +1 -1
  121. package/dist/session/factory-session.js +3 -3
  122. package/dist/session/self-review-gate.js +1 -1
  123. package/dist/session/source-control-tools.js +3 -3
  124. package/dist/storage/domains/audit/domain.js +1 -1
  125. package/dist/storage/domains/comments/base.js +3 -3
  126. package/dist/storage/domains/comments/domain.js +3 -3
  127. package/dist/storage/domains/comments/routes.js +1 -1
  128. package/dist/storage/domains/source-control/base.d.ts +20 -0
  129. package/dist/storage/domains/source-control/base.d.ts.map +1 -1
  130. package/dist/storage/domains/source-control/base.js +42 -0
  131. package/dist/storage/domains/source-control/base.js.map +1 -1
  132. package/dist/storage/domains/source-control/inmemory.d.ts +5 -1
  133. package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -1
  134. package/dist/storage/domains/source-control/inmemory.js +23 -0
  135. package/dist/storage/domains/source-control/inmemory.js.map +1 -1
  136. package/dist/storage/domains/work-items/base.d.ts +21 -6
  137. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  138. package/dist/storage/domains/work-items/base.js +65 -85
  139. package/dist/storage/domains/work-items/base.js.map +1 -1
  140. package/dist/storage/domains/work-items/cards.d.ts +8 -1
  141. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  142. package/dist/storage/domains/work-items/cards.js +10 -4
  143. package/dist/storage/domains/work-items/cards.js.map +1 -1
  144. package/dist/storage/domains/work-items/claimable-work.d.ts +15 -0
  145. package/dist/storage/domains/work-items/claimable-work.d.ts.map +1 -0
  146. package/dist/storage/domains/work-items/claimable-work.js +51 -0
  147. package/dist/storage/domains/work-items/claimable-work.js.map +1 -0
  148. package/dist/tools/index.js +2 -2
  149. package/dist/tools/messaging-tools.js +1 -1
  150. package/dist/tools/read-tools.js +4 -4
  151. package/dist/tools/scope.js +1 -1
  152. package/dist/tools/session-tools.js +9 -9
  153. package/dist/tools/work-item-tools.js +4 -4
  154. package/dist/work-items/create-work-item.d.ts +1 -1
  155. package/dist/work-items/create-work-item.d.ts.map +1 -1
  156. package/dist/work-items/create-work-item.js +66 -28
  157. package/dist/work-items/create-work-item.js.map +1 -1
  158. package/dist/work-items/decision-actions.js +2 -2
  159. package/dist/work-items/providers/gitlab.js +1 -1
  160. package/dist/work-items/providers/incidentio.js +1 -1
  161. package/dist/work-items/providers/index.js +1 -1
  162. package/dist/work-items/providers/jira.js +1 -1
  163. package/dist/work-items/providers/linear.js +1 -1
  164. package/dist/work-items/split-migration.js +2 -2
  165. package/dist/workspace.d.ts +2 -0
  166. package/dist/workspace.d.ts.map +1 -1
  167. package/dist/workspace.js +10 -7
  168. package/dist/workspace.js.map +1 -1
  169. package/package.json +13 -13
@@ -43,7 +43,14 @@ export declare class Cards {
43
43
  findOne(where: CollectionWhere): Promise<WorkItemDbRow | null>;
44
44
  findMany(where: CollectionWhere, options?: CollectionListOptions): Promise<WorkItemDbRow[]>;
45
45
  insertOne(card: CardInsert): Promise<WorkItemDbRow>;
46
- updateAtomic(where: CollectionWhere, updater: (card: WorkItemDbRow) => Partial<WorkItemDbRow> | null | Promise<Partial<WorkItemDbRow> | null>): Promise<WorkItemDbRow | null>;
46
+ updateAtomic(where: CollectionWhere, updater: (card: WorkItemDbRow) => Partial<WorkItemDbRow> | null | Promise<Partial<WorkItemDbRow> | null>,
47
+ /**
48
+ * Moves the board item's `updated_at` forward even when only work or source facts changed,
49
+ * without bumping its revision, so a revision-and-time guarded delete sees the write.
50
+ */
51
+ { touch }?: {
52
+ touch?: boolean;
53
+ }): Promise<WorkItemDbRow | null>;
47
54
  updateMany(where: CollectionWhere, patch: Partial<WorkItemDbRow>): Promise<number>;
48
55
  deleteMany(where: CollectionWhere): Promise<number>;
49
56
  }
@@ -1 +1 @@
1
- {"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/work-items/cards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGtG,OAAO,KAAK,EAA0B,aAAa,EAAE,MAAM,WAAW,CAAC;AASvE,OAAO,KAAK,EAAqB,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAiBzG,MAAM,MAAM,UAAU,GAAG,IAAI,CAC3B,aAAa,EACX,QAAQ,GACR,oBAAoB,GACpB,OAAO,GACP,iBAAiB,GACjB,YAAY,GACZ,qBAAqB,GACrB,OAAO,GACP,QAAQ,GACR,eAAe,GACf,UAAU,GACV,UAAU,GACV,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,CACf,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGpG;AA6DD,2GAA2G;AAC3G,qBAAa,KAAK;;IAEd,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAF7B,YACmB,GAAG,EAAE,iBAAiB,EACtB,UAAU,UAAQ,EACjC;IA0CE,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAMnE;IAEK,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAIhG;IAEK,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAoBxD;IAEK,YAAY,CAChB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,GACvG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmF/B;IAEK,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvF;IAEK,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BxD;CACF"}
1
+ {"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/work-items/cards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGtG,OAAO,KAAK,EAA0B,aAAa,EAAE,MAAM,WAAW,CAAC;AASvE,OAAO,KAAK,EAAqB,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAiBzG,MAAM,MAAM,UAAU,GAAG,IAAI,CAC3B,aAAa,EACX,QAAQ,GACR,oBAAoB,GACpB,OAAO,GACP,iBAAiB,GACjB,YAAY,GACZ,qBAAqB,GACrB,OAAO,GACP,QAAQ,GACR,eAAe,GACf,UAAU,GACV,UAAU,GACV,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,CACf,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGpG;AA6DD,2GAA2G;AAC3G,qBAAa,KAAK;;IAEd,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAF7B,YACmB,GAAG,EAAE,iBAAiB,EACtB,UAAU,UAAQ,EACjC;IA0CE,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAMnE;IAEK,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAIhG;IAEK,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAoBxD;IAEK,YAAY,CAChB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IACxG;;;OAGG;IACH,EAAE,KAAa,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1C,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAsF/B;IAEK,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvF;IAEK,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCxD;CACF"}
@@ -1,5 +1,5 @@
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 "./work-item-schema.js";
2
1
  import { splitLegacyWorkItem } from "../../../work-items/split-migration.js";
2
+ 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 "./work-item-schema.js";
3
3
  import { randomUUID } from "crypto";
4
4
  // src/storage/domains/work-items/cards.ts
5
5
  const BOARD_ITEMS = FACTORY_BOARD_ITEMS_SCHEMA.name;
@@ -152,7 +152,7 @@ var Cards = class {
152
152
  if (rows.source) await this.ops.insertOne(SOURCES, rows.source);
153
153
  return joinCard(await this.ops.insertOne(BOARD_ITEMS, rows.boardItem), work, rows.source ? [rows.source] : []);
154
154
  }
155
- async updateAtomic(where, updater) {
155
+ async updateAtomic(where, updater, { touch = false } = {}) {
156
156
  if (this.legacyMode) return this.ops.updateAtomic(WORK_ITEMS_SCHEMA.name, where, updater);
157
157
  const boardWhere = await this.#where(where);
158
158
  if (!boardWhere) return null;
@@ -215,7 +215,10 @@ var Cards = class {
215
215
  else if (previous) await this.ops.deleteMany(SOURCES, { id: previous.id });
216
216
  }
217
217
  const nativeTitleChanged = !current.external_source && patch.title !== void 0 && patch.title !== current.title;
218
- if (!(nativeTitleChanged || Object.entries(columns).some(([key, value]) => !["revision", "updated_at"].includes(key) && JSON.stringify(row[key]) !== JSON.stringify(value)))) return null;
218
+ if (!(nativeTitleChanged || Object.entries(columns).some(([key, value]) => !["revision", "updated_at"].includes(key) && JSON.stringify(row[key]) !== JSON.stringify(value)))) {
219
+ if (!touch) return null;
220
+ return { updated_at: new Date(Math.max(Date.now(), new Date(row.updated_at).getTime() + 1)) };
221
+ }
219
222
  return {
220
223
  ...columns,
221
224
  ...nativeTitleChanged ? {
@@ -237,6 +240,7 @@ var Cards = class {
237
240
  const boardWhere = await this.#where(where);
238
241
  if (!boardWhere) return 0;
239
242
  const boards = await this.ops.findMany(BOARD_ITEMS, boardWhere, { orderBy: [["id", "asc"]] });
243
+ let deleted = 0;
240
244
  for (const board of boards) {
241
245
  const scope = {
242
246
  org_id: board.org_id,
@@ -247,9 +251,11 @@ var Cards = class {
247
251
  id: board.id
248
252
  });
249
253
  if (!await this.ops.updateAtomic(BOARD_ITEMS, {
254
+ ...boardWhere,
250
255
  ...scope,
251
256
  id: board.id
252
257
  }, () => null)) continue;
258
+ deleted++;
253
259
  await this.ops.updateAtomic(WORK_ITEMS, {
254
260
  ...scope,
255
261
  id: board.work_item_id
@@ -276,7 +282,7 @@ var Cards = class {
276
282
  id: board.id
277
283
  });
278
284
  }
279
- return boards.length;
285
+ return deleted;
280
286
  }
281
287
  };
282
288
  export { Cards, splitCardRows };
@@ -1 +1 @@
1
- {"version":3,"file":"cards.js","names":[],"sources":["../../../../src/storage/domains/work-items/cards.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { CollectionListOptions, CollectionWhere, FactoryStorageOps } from '@mastra/core/storage';\n\nimport { splitLegacyWorkItem } from '../../../work-items/split-migration.js';\nimport type { ExternalWorkItemSource, WorkItemDbRow } from './base.js';\nimport {\n FACTORY_BOARD_ITEMS_SCHEMA,\n FACTORY_WORK_ITEMS_SCHEMA,\n FACTORY_WORK_ITEM_SOURCES_SCHEMA,\n FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA,\n FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA,\n WORK_ITEMS_SCHEMA,\n} from './work-item-schema.js';\nimport type { BoardItemDbRecord, WorkItemDbRecord, WorkItemSourceDbRecord } from './work-item-schema.js';\n\nconst BOARD_ITEMS = FACTORY_BOARD_ITEMS_SCHEMA.name;\nconst WORK_ITEMS = FACTORY_WORK_ITEMS_SCHEMA.name;\nconst SOURCES = FACTORY_WORK_ITEM_SOURCES_SCHEMA.name;\nconst BOARD_COLUMNS = new Set(Object.keys(FACTORY_BOARD_ITEMS_SCHEMA.columns));\nconst PROJECTED_COLUMNS = new Set([\n 'work_item',\n 'work_item_sources',\n 'external_source',\n 'source_key',\n 'title',\n 'comment_count',\n 'feed_activity_at',\n]);\nconst ID_BATCH = 500;\n\nexport type CardInsert = Pick<\n WorkItemDbRow,\n | 'org_id'\n | 'factory_project_id'\n | 'board'\n | 'external_source'\n | 'source_key'\n | 'parent_work_item_id'\n | 'title'\n | 'stages'\n | 'stage_history'\n | 'sessions'\n | 'metadata'\n | 'revision'\n | 'created_by'\n | 'created_at'\n | 'updated_at'\n>;\n\nexport function splitCardRows(card: WorkItemDbRow, options: { workItemId: string; revision?: number }) {\n const rows = splitLegacyWorkItem(card, options);\n return { ...rows, boardItem: { ...rows.boardItem, migrated_from_updated_at: null, migrated_from_hash: null } };\n}\n\nfunction externalSourceOf(source: WorkItemSourceDbRecord | undefined): ExternalWorkItemSource | null {\n if (!source) return null;\n const prefix = `${source.source_type}:${source.workspace_id ? `${source.workspace_id}:` : ''}`;\n return {\n integrationId: source.integration_id,\n type: source.source_type,\n ...(source.workspace_id ? { workspaceId: source.workspace_id } : {}),\n externalId: source.external_id.startsWith(prefix) ? source.external_id.slice(prefix.length) : source.external_id,\n ...(source.url ? { url: source.url } : {}),\n };\n}\n\nfunction joinCard(\n board: BoardItemDbRecord,\n work: WorkItemDbRecord | null,\n sources: WorkItemSourceDbRecord[],\n): WorkItemDbRow {\n if (!work) throw new Error(`Board item ${board.id} has no work item ${board.work_item_id}.`);\n const source = sources[0];\n return {\n work_item: work,\n work_item_sources: sources,\n id: board.id,\n org_id: board.org_id,\n factory_project_id: board.factory_project_id,\n board: board.board,\n external_source: externalSourceOf(source),\n source_key: source?.source_key ?? null,\n claim_key: null,\n parent_work_item_id: board.parent_board_item_id,\n title: work.title,\n stages: board.stages,\n stage_history: board.stage_history as WorkItemDbRow['stage_history'],\n sessions: board.sessions as WorkItemDbRow['sessions'],\n metadata: board.metadata || source?.metadata ? { ...board.metadata, ...source?.metadata } : null,\n triage_type: board.triage_type ?? null,\n autonomy_armed_at: board.autonomy_armed_at ?? null,\n plans_preapproved_at: board.plans_preapproved_at ?? null,\n accepted_at: board.accepted_at ?? null,\n comment_count: board.comment_count ?? 0,\n feed_activity_at: board.feed_activity_at ?? null,\n revision: board.revision,\n created_by: board.created_by,\n created_at: board.created_at,\n updated_at: board.updated_at,\n };\n}\n\nfunction boardColumns(patch: Partial<WorkItemDbRow>, { filter = false } = {}): Partial<BoardItemDbRecord> {\n const columns: Record<string, unknown> = {};\n for (const [column, value] of Object.entries(patch)) {\n if ((column === 'id' && !filter) || column === 'claim_key' || PROJECTED_COLUMNS.has(column)) continue;\n if (column === 'parent_work_item_id') columns.parent_board_item_id = value;\n else if (BOARD_COLUMNS.has(column)) columns[column] = value;\n else throw new Error(`[cards] unknown card column '${column}'.`);\n }\n return columns as Partial<BoardItemDbRecord>;\n}\n\n/** Compatibility row operations over work, source and placement tables. Writes require transaction ops. */\nexport class Cards {\n constructor(\n private readonly ops: FactoryStorageOps,\n private readonly legacyMode = false,\n ) {}\n\n async #where(where: CollectionWhere): Promise<CollectionWhere | null> {\n const { source_key: sourceKey, ...rest } = where;\n const boardWhere = boardColumns(rest as Partial<WorkItemDbRow>, { filter: true }) as CollectionWhere;\n if (sourceKey === undefined) return boardWhere;\n const scope: CollectionWhere = {};\n if (rest.org_id !== undefined) scope.org_id = rest.org_id;\n if (rest.factory_project_id !== undefined) scope.factory_project_id = rest.factory_project_id;\n const sources = await this.ops.findMany<WorkItemSourceDbRecord>(SOURCES, { ...scope, source_key: sourceKey });\n return sources.length ? { ...boardWhere, work_item_id: { in: sources.map(source => source.work_item_id) } } : null;\n }\n\n async #join(boards: readonly BoardItemDbRecord[]): Promise<WorkItemDbRow[]> {\n const ids = [...new Set(boards.map(board => board.work_item_id))];\n const items = new Map<string, WorkItemDbRecord>();\n const sources = new Map<string, WorkItemSourceDbRecord[]>();\n for (let index = 0; index < ids.length; index += ID_BATCH) {\n const pageIds = ids.slice(index, index + ID_BATCH);\n const page = await this.ops.findMany<WorkItemDbRecord>(WORK_ITEMS, { id: { in: pageIds } });\n for (const item of page) items.set(item.id, item);\n const sourcePage = await this.ops.findMany<WorkItemSourceDbRecord>(\n SOURCES,\n { work_item_id: { in: pageIds } },\n {\n orderBy: [\n ['created_at', 'asc'],\n ['id', 'asc'],\n ],\n },\n );\n for (const source of sourcePage) {\n const group = sources.get(source.work_item_id) ?? [];\n group.push(source);\n sources.set(source.work_item_id, group);\n }\n }\n return boards.map(board =>\n joinCard(board, items.get(board.work_item_id) ?? null, sources.get(board.work_item_id) ?? []),\n );\n }\n\n async findOne(where: CollectionWhere): Promise<WorkItemDbRow | null> {\n if (this.legacyMode) return this.ops.findOne(WORK_ITEMS_SCHEMA.name, where);\n const boardWhere = await this.#where(where);\n if (!boardWhere) return null;\n const board = await this.ops.findOne<BoardItemDbRecord>(BOARD_ITEMS, boardWhere);\n return board ? (await this.#join([board]))[0]! : null;\n }\n\n async findMany(where: CollectionWhere, options?: CollectionListOptions): Promise<WorkItemDbRow[]> {\n if (this.legacyMode) return this.ops.findMany(WORK_ITEMS_SCHEMA.name, where, options);\n const boardWhere = await this.#where(where);\n return boardWhere ? this.#join(await this.ops.findMany<BoardItemDbRecord>(BOARD_ITEMS, boardWhere, options)) : [];\n }\n\n async insertOne(card: CardInsert): Promise<WorkItemDbRow> {\n if (this.legacyMode) return this.ops.insertOne<WorkItemDbRow>(WORK_ITEMS_SCHEMA.name, card);\n const rows = splitCardRows(\n {\n claim_key: null,\n triage_type: null,\n autonomy_armed_at: null,\n plans_preapproved_at: null,\n accepted_at: null,\n comment_count: 0,\n feed_activity_at: null,\n ...card,\n id: randomUUID(),\n },\n { workItemId: randomUUID() },\n );\n const work = await this.ops.insertOne<WorkItemDbRecord>(WORK_ITEMS, rows.workItem);\n if (rows.source) await this.ops.insertOne(SOURCES, rows.source);\n const board = await this.ops.insertOne<BoardItemDbRecord>(BOARD_ITEMS, rows.boardItem);\n return joinCard(board, work, rows.source ? [rows.source] : []);\n }\n\n async updateAtomic(\n where: CollectionWhere,\n updater: (card: WorkItemDbRow) => Partial<WorkItemDbRow> | null | Promise<Partial<WorkItemDbRow> | null>,\n ): Promise<WorkItemDbRow | null> {\n if (this.legacyMode) return this.ops.updateAtomic(WORK_ITEMS_SCHEMA.name, where, updater);\n const boardWhere = await this.#where(where);\n if (!boardWhere) return null;\n const board = await this.ops.updateAtomic<BoardItemDbRecord>(BOARD_ITEMS, boardWhere, async row => {\n const joined = (await this.#join([row]))[0]!;\n const matchedSource = joined.work_item_sources?.find(source => source.source_key === where.source_key);\n const current = matchedSource\n ? {\n ...joined,\n external_source: externalSourceOf(matchedSource),\n source_key: matchedSource.source_key,\n metadata: row.metadata || matchedSource.metadata ? { ...row.metadata, ...matchedSource.metadata } : null,\n work_item_sources: [\n matchedSource,\n ...joined.work_item_sources!.filter(source => source.id !== matchedSource.id),\n ],\n }\n : joined;\n const patch = await updater(current);\n if (!patch) return null;\n const columns = boardColumns(patch);\n if (patch.metadata !== undefined) {\n const next = { ...current, ...patch };\n const split = splitCardRows(next, { workItemId: row.work_item_id });\n columns.metadata = split.boardItem.metadata;\n }\n if (patch.title !== undefined && patch.title !== current.title) {\n await this.ops.updateAtomic<WorkItemDbRecord>(WORK_ITEMS, { id: row.work_item_id }, work => ({\n title: patch.title,\n revision: work.revision + 1,\n updated_at: new Date(),\n }));\n }\n if (patch.metadata !== undefined || patch.external_source !== undefined) {\n const next = splitCardRows({ ...current, ...patch }, { workItemId: row.work_item_id }).source;\n const previous = current.work_item_sources?.[0];\n if (next && previous) {\n const before = splitCardRows(current, { workItemId: row.work_item_id }).source;\n const changed = Object.fromEntries(\n Object.entries(next).filter(\n ([key, value]) =>\n !['id', 'revision', 'created_at', 'updated_at', 'synced_at'].includes(key) &&\n JSON.stringify(before?.[key]) !== JSON.stringify(value),\n ),\n );\n if (Object.keys(changed).length)\n await this.ops.updateAtomic<WorkItemSourceDbRecord>(SOURCES, { id: previous.id }, source => {\n const metadata = { ...source.metadata };\n if ('metadata' in changed && next.metadata !== null) {\n for (const key of new Set([...Object.keys(before?.metadata ?? {}), ...Object.keys(next.metadata)])) {\n if (JSON.stringify(before?.metadata?.[key]) === JSON.stringify(next.metadata[key])) continue;\n if (Object.hasOwn(next.metadata, key)) metadata[key] = next.metadata[key];\n else delete metadata[key];\n }\n }\n return {\n ...changed,\n ...('metadata' in changed ? { metadata: next.metadata === null ? null : metadata } : {}),\n revision: source.revision + 1,\n updated_at: new Date(),\n synced_at: new Date(),\n };\n });\n } else if (next) await this.ops.insertOne(SOURCES, next);\n else if (previous) await this.ops.deleteMany(SOURCES, { id: previous.id });\n }\n const nativeTitleChanged = !current.external_source && patch.title !== undefined && patch.title !== current.title;\n const boardChanged =\n nativeTitleChanged ||\n Object.entries(columns).some(\n ([key, value]) =>\n !['revision', 'updated_at'].includes(key) && JSON.stringify(row[key]) !== JSON.stringify(value),\n );\n if (!boardChanged) return null;\n return {\n ...columns,\n ...(nativeTitleChanged\n ? { revision: patch.revision ?? row.revision + 1, updated_at: patch.updated_at ?? new Date() }\n : {}),\n };\n });\n return board ? (await this.#join([board]))[0]! : null;\n }\n\n async updateMany(where: CollectionWhere, patch: Partial<WorkItemDbRow>): Promise<number> {\n if (this.legacyMode) return this.ops.updateMany(WORK_ITEMS_SCHEMA.name, where, patch);\n const boards = await this.findMany(where);\n for (const board of boards) await this.updateAtomic({ id: board.id }, () => patch);\n return boards.length;\n }\n\n async deleteMany(where: CollectionWhere): Promise<number> {\n if (this.legacyMode) return this.ops.deleteMany(WORK_ITEMS_SCHEMA.name, where);\n const boardWhere = await this.#where(where);\n if (!boardWhere) return 0;\n const boards = await this.ops.findMany<BoardItemDbRecord>(BOARD_ITEMS, boardWhere, { orderBy: [['id', 'asc']] });\n for (const board of boards) {\n const scope = { org_id: board.org_id, factory_project_id: board.factory_project_id };\n const guard = await this.ops.updateAtomic(\n FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA.name,\n { id: board.id },\n () => null,\n );\n if (!guard) await this.ops.insertOne(FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA.name, { ...scope, id: board.id });\n const locked = await this.ops.updateAtomic(BOARD_ITEMS, { ...scope, id: board.id }, () => null);\n if (!locked) continue;\n await this.ops.updateAtomic(WORK_ITEMS, { ...scope, id: board.work_item_id }, () => null);\n const sources = await this.ops.findMany<WorkItemSourceDbRecord>(\n SOURCES,\n { ...scope, work_item_id: board.work_item_id },\n { orderBy: [['id', 'asc']] },\n );\n for (const source of sources) await this.ops.updateAtomic(SOURCES, { id: source.id }, () => null);\n await this.ops.deleteMany(SOURCES, { ...scope, work_item_id: board.work_item_id });\n await this.ops.deleteMany(BOARD_ITEMS, { ...scope, id: board.id });\n await this.ops.deleteMany(WORK_ITEMS, { ...scope, id: board.work_item_id });\n await this.ops.upsertOne(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, ['id'], { ...scope, id: board.id });\n }\n return boards.length;\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"cards.js","names":[],"sources":["../../../../src/storage/domains/work-items/cards.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { CollectionListOptions, CollectionWhere, FactoryStorageOps } from '@mastra/core/storage';\n\nimport { splitLegacyWorkItem } from '../../../work-items/split-migration.js';\nimport type { ExternalWorkItemSource, WorkItemDbRow } from './base.js';\nimport {\n FACTORY_BOARD_ITEMS_SCHEMA,\n FACTORY_WORK_ITEMS_SCHEMA,\n FACTORY_WORK_ITEM_SOURCES_SCHEMA,\n FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA,\n FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA,\n WORK_ITEMS_SCHEMA,\n} from './work-item-schema.js';\nimport type { BoardItemDbRecord, WorkItemDbRecord, WorkItemSourceDbRecord } from './work-item-schema.js';\n\nconst BOARD_ITEMS = FACTORY_BOARD_ITEMS_SCHEMA.name;\nconst WORK_ITEMS = FACTORY_WORK_ITEMS_SCHEMA.name;\nconst SOURCES = FACTORY_WORK_ITEM_SOURCES_SCHEMA.name;\nconst BOARD_COLUMNS = new Set(Object.keys(FACTORY_BOARD_ITEMS_SCHEMA.columns));\nconst PROJECTED_COLUMNS = new Set([\n 'work_item',\n 'work_item_sources',\n 'external_source',\n 'source_key',\n 'title',\n 'comment_count',\n 'feed_activity_at',\n]);\nconst ID_BATCH = 500;\n\nexport type CardInsert = Pick<\n WorkItemDbRow,\n | 'org_id'\n | 'factory_project_id'\n | 'board'\n | 'external_source'\n | 'source_key'\n | 'parent_work_item_id'\n | 'title'\n | 'stages'\n | 'stage_history'\n | 'sessions'\n | 'metadata'\n | 'revision'\n | 'created_by'\n | 'created_at'\n | 'updated_at'\n>;\n\nexport function splitCardRows(card: WorkItemDbRow, options: { workItemId: string; revision?: number }) {\n const rows = splitLegacyWorkItem(card, options);\n return { ...rows, boardItem: { ...rows.boardItem, migrated_from_updated_at: null, migrated_from_hash: null } };\n}\n\nfunction externalSourceOf(source: WorkItemSourceDbRecord | undefined): ExternalWorkItemSource | null {\n if (!source) return null;\n const prefix = `${source.source_type}:${source.workspace_id ? `${source.workspace_id}:` : ''}`;\n return {\n integrationId: source.integration_id,\n type: source.source_type,\n ...(source.workspace_id ? { workspaceId: source.workspace_id } : {}),\n externalId: source.external_id.startsWith(prefix) ? source.external_id.slice(prefix.length) : source.external_id,\n ...(source.url ? { url: source.url } : {}),\n };\n}\n\nfunction joinCard(\n board: BoardItemDbRecord,\n work: WorkItemDbRecord | null,\n sources: WorkItemSourceDbRecord[],\n): WorkItemDbRow {\n if (!work) throw new Error(`Board item ${board.id} has no work item ${board.work_item_id}.`);\n const source = sources[0];\n return {\n work_item: work,\n work_item_sources: sources,\n id: board.id,\n org_id: board.org_id,\n factory_project_id: board.factory_project_id,\n board: board.board,\n external_source: externalSourceOf(source),\n source_key: source?.source_key ?? null,\n claim_key: null,\n parent_work_item_id: board.parent_board_item_id,\n title: work.title,\n stages: board.stages,\n stage_history: board.stage_history as WorkItemDbRow['stage_history'],\n sessions: board.sessions as WorkItemDbRow['sessions'],\n metadata: board.metadata || source?.metadata ? { ...board.metadata, ...source?.metadata } : null,\n triage_type: board.triage_type ?? null,\n autonomy_armed_at: board.autonomy_armed_at ?? null,\n plans_preapproved_at: board.plans_preapproved_at ?? null,\n accepted_at: board.accepted_at ?? null,\n comment_count: board.comment_count ?? 0,\n feed_activity_at: board.feed_activity_at ?? null,\n revision: board.revision,\n created_by: board.created_by,\n created_at: board.created_at,\n updated_at: board.updated_at,\n };\n}\n\nfunction boardColumns(patch: Partial<WorkItemDbRow>, { filter = false } = {}): Partial<BoardItemDbRecord> {\n const columns: Record<string, unknown> = {};\n for (const [column, value] of Object.entries(patch)) {\n if ((column === 'id' && !filter) || column === 'claim_key' || PROJECTED_COLUMNS.has(column)) continue;\n if (column === 'parent_work_item_id') columns.parent_board_item_id = value;\n else if (BOARD_COLUMNS.has(column)) columns[column] = value;\n else throw new Error(`[cards] unknown card column '${column}'.`);\n }\n return columns as Partial<BoardItemDbRecord>;\n}\n\n/** Compatibility row operations over work, source and placement tables. Writes require transaction ops. */\nexport class Cards {\n constructor(\n private readonly ops: FactoryStorageOps,\n private readonly legacyMode = false,\n ) {}\n\n async #where(where: CollectionWhere): Promise<CollectionWhere | null> {\n const { source_key: sourceKey, ...rest } = where;\n const boardWhere = boardColumns(rest as Partial<WorkItemDbRow>, { filter: true }) as CollectionWhere;\n if (sourceKey === undefined) return boardWhere;\n const scope: CollectionWhere = {};\n if (rest.org_id !== undefined) scope.org_id = rest.org_id;\n if (rest.factory_project_id !== undefined) scope.factory_project_id = rest.factory_project_id;\n const sources = await this.ops.findMany<WorkItemSourceDbRecord>(SOURCES, { ...scope, source_key: sourceKey });\n return sources.length ? { ...boardWhere, work_item_id: { in: sources.map(source => source.work_item_id) } } : null;\n }\n\n async #join(boards: readonly BoardItemDbRecord[]): Promise<WorkItemDbRow[]> {\n const ids = [...new Set(boards.map(board => board.work_item_id))];\n const items = new Map<string, WorkItemDbRecord>();\n const sources = new Map<string, WorkItemSourceDbRecord[]>();\n for (let index = 0; index < ids.length; index += ID_BATCH) {\n const pageIds = ids.slice(index, index + ID_BATCH);\n const page = await this.ops.findMany<WorkItemDbRecord>(WORK_ITEMS, { id: { in: pageIds } });\n for (const item of page) items.set(item.id, item);\n const sourcePage = await this.ops.findMany<WorkItemSourceDbRecord>(\n SOURCES,\n { work_item_id: { in: pageIds } },\n {\n orderBy: [\n ['created_at', 'asc'],\n ['id', 'asc'],\n ],\n },\n );\n for (const source of sourcePage) {\n const group = sources.get(source.work_item_id) ?? [];\n group.push(source);\n sources.set(source.work_item_id, group);\n }\n }\n return boards.map(board =>\n joinCard(board, items.get(board.work_item_id) ?? null, sources.get(board.work_item_id) ?? []),\n );\n }\n\n async findOne(where: CollectionWhere): Promise<WorkItemDbRow | null> {\n if (this.legacyMode) return this.ops.findOne(WORK_ITEMS_SCHEMA.name, where);\n const boardWhere = await this.#where(where);\n if (!boardWhere) return null;\n const board = await this.ops.findOne<BoardItemDbRecord>(BOARD_ITEMS, boardWhere);\n return board ? (await this.#join([board]))[0]! : null;\n }\n\n async findMany(where: CollectionWhere, options?: CollectionListOptions): Promise<WorkItemDbRow[]> {\n if (this.legacyMode) return this.ops.findMany(WORK_ITEMS_SCHEMA.name, where, options);\n const boardWhere = await this.#where(where);\n return boardWhere ? this.#join(await this.ops.findMany<BoardItemDbRecord>(BOARD_ITEMS, boardWhere, options)) : [];\n }\n\n async insertOne(card: CardInsert): Promise<WorkItemDbRow> {\n if (this.legacyMode) return this.ops.insertOne<WorkItemDbRow>(WORK_ITEMS_SCHEMA.name, card);\n const rows = splitCardRows(\n {\n claim_key: null,\n triage_type: null,\n autonomy_armed_at: null,\n plans_preapproved_at: null,\n accepted_at: null,\n comment_count: 0,\n feed_activity_at: null,\n ...card,\n id: randomUUID(),\n },\n { workItemId: randomUUID() },\n );\n const work = await this.ops.insertOne<WorkItemDbRecord>(WORK_ITEMS, rows.workItem);\n if (rows.source) await this.ops.insertOne(SOURCES, rows.source);\n const board = await this.ops.insertOne<BoardItemDbRecord>(BOARD_ITEMS, rows.boardItem);\n return joinCard(board, work, rows.source ? [rows.source] : []);\n }\n\n async updateAtomic(\n where: CollectionWhere,\n updater: (card: WorkItemDbRow) => Partial<WorkItemDbRow> | null | Promise<Partial<WorkItemDbRow> | null>,\n /**\n * Moves the board item's `updated_at` forward even when only work or source facts changed,\n * without bumping its revision, so a revision-and-time guarded delete sees the write.\n */\n { touch = false }: { touch?: boolean } = {},\n ): Promise<WorkItemDbRow | null> {\n if (this.legacyMode) return this.ops.updateAtomic(WORK_ITEMS_SCHEMA.name, where, updater);\n const boardWhere = await this.#where(where);\n if (!boardWhere) return null;\n const board = await this.ops.updateAtomic<BoardItemDbRecord>(BOARD_ITEMS, boardWhere, async row => {\n const joined = (await this.#join([row]))[0]!;\n const matchedSource = joined.work_item_sources?.find(source => source.source_key === where.source_key);\n const current = matchedSource\n ? {\n ...joined,\n external_source: externalSourceOf(matchedSource),\n source_key: matchedSource.source_key,\n metadata: row.metadata || matchedSource.metadata ? { ...row.metadata, ...matchedSource.metadata } : null,\n work_item_sources: [\n matchedSource,\n ...joined.work_item_sources!.filter(source => source.id !== matchedSource.id),\n ],\n }\n : joined;\n const patch = await updater(current);\n if (!patch) return null;\n const columns = boardColumns(patch);\n if (patch.metadata !== undefined) {\n const next = { ...current, ...patch };\n const split = splitCardRows(next, { workItemId: row.work_item_id });\n columns.metadata = split.boardItem.metadata;\n }\n if (patch.title !== undefined && patch.title !== current.title) {\n await this.ops.updateAtomic<WorkItemDbRecord>(WORK_ITEMS, { id: row.work_item_id }, work => ({\n title: patch.title,\n revision: work.revision + 1,\n updated_at: new Date(),\n }));\n }\n if (patch.metadata !== undefined || patch.external_source !== undefined) {\n const next = splitCardRows({ ...current, ...patch }, { workItemId: row.work_item_id }).source;\n const previous = current.work_item_sources?.[0];\n if (next && previous) {\n const before = splitCardRows(current, { workItemId: row.work_item_id }).source;\n const changed = Object.fromEntries(\n Object.entries(next).filter(\n ([key, value]) =>\n !['id', 'revision', 'created_at', 'updated_at', 'synced_at'].includes(key) &&\n JSON.stringify(before?.[key]) !== JSON.stringify(value),\n ),\n );\n if (Object.keys(changed).length)\n await this.ops.updateAtomic<WorkItemSourceDbRecord>(SOURCES, { id: previous.id }, source => {\n const metadata = { ...source.metadata };\n if ('metadata' in changed && next.metadata !== null) {\n for (const key of new Set([...Object.keys(before?.metadata ?? {}), ...Object.keys(next.metadata)])) {\n if (JSON.stringify(before?.metadata?.[key]) === JSON.stringify(next.metadata[key])) continue;\n if (Object.hasOwn(next.metadata, key)) metadata[key] = next.metadata[key];\n else delete metadata[key];\n }\n }\n return {\n ...changed,\n ...('metadata' in changed ? { metadata: next.metadata === null ? null : metadata } : {}),\n revision: source.revision + 1,\n updated_at: new Date(),\n synced_at: new Date(),\n };\n });\n } else if (next) await this.ops.insertOne(SOURCES, next);\n else if (previous) await this.ops.deleteMany(SOURCES, { id: previous.id });\n }\n const nativeTitleChanged = !current.external_source && patch.title !== undefined && patch.title !== current.title;\n const boardChanged =\n nativeTitleChanged ||\n Object.entries(columns).some(\n ([key, value]) =>\n !['revision', 'updated_at'].includes(key) && JSON.stringify(row[key]) !== JSON.stringify(value),\n );\n if (!boardChanged) {\n if (!touch) return null;\n return { updated_at: new Date(Math.max(Date.now(), new Date(row.updated_at).getTime() + 1)) };\n }\n return {\n ...columns,\n ...(nativeTitleChanged\n ? { revision: patch.revision ?? row.revision + 1, updated_at: patch.updated_at ?? new Date() }\n : {}),\n };\n });\n return board ? (await this.#join([board]))[0]! : null;\n }\n\n async updateMany(where: CollectionWhere, patch: Partial<WorkItemDbRow>): Promise<number> {\n if (this.legacyMode) return this.ops.updateMany(WORK_ITEMS_SCHEMA.name, where, patch);\n const boards = await this.findMany(where);\n for (const board of boards) await this.updateAtomic({ id: board.id }, () => patch);\n return boards.length;\n }\n\n async deleteMany(where: CollectionWhere): Promise<number> {\n if (this.legacyMode) return this.ops.deleteMany(WORK_ITEMS_SCHEMA.name, where);\n const boardWhere = await this.#where(where);\n if (!boardWhere) return 0;\n const boards = await this.ops.findMany<BoardItemDbRecord>(BOARD_ITEMS, boardWhere, { orderBy: [['id', 'asc']] });\n let deleted = 0;\n for (const board of boards) {\n const scope = { org_id: board.org_id, factory_project_id: board.factory_project_id };\n const guard = await this.ops.updateAtomic(\n FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA.name,\n { id: board.id },\n () => null,\n );\n if (!guard) await this.ops.insertOne(FACTORY_WORK_ITEM_SPLIT_LOCKS_SCHEMA.name, { ...scope, id: board.id });\n // Re-check the whole filter under the row lock, so a write that landed since the read\n // above (e.g. a bumped revision) keeps the row.\n const locked = await this.ops.updateAtomic(BOARD_ITEMS, { ...boardWhere, ...scope, id: board.id }, () => null);\n if (!locked) continue;\n deleted++;\n await this.ops.updateAtomic(WORK_ITEMS, { ...scope, id: board.work_item_id }, () => null);\n const sources = await this.ops.findMany<WorkItemSourceDbRecord>(\n SOURCES,\n { ...scope, work_item_id: board.work_item_id },\n { orderBy: [['id', 'asc']] },\n );\n for (const source of sources) await this.ops.updateAtomic(SOURCES, { id: source.id }, () => null);\n await this.ops.deleteMany(SOURCES, { ...scope, work_item_id: board.work_item_id });\n await this.ops.deleteMany(BOARD_ITEMS, { ...scope, id: board.id });\n await this.ops.deleteMany(WORK_ITEMS, { ...scope, id: board.work_item_id });\n await this.ops.upsertOne(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, ['id'], { ...scope, id: board.id });\n }\n return deleted;\n }\n}\n"],"mappings":";;;;AAgBA,MAAM,cAAc,2BAA2B;AAC/C,MAAM,aAAa,0BAA0B;AAC7C,MAAM,UAAU,iCAAiC;AACjD,MAAM,gBAAgB,IAAI,IAAI,OAAO,KAAK,2BAA2B,OAAO,CAAC;AAC7E,MAAM,oCAAoB,IAAI,IAAI;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AACD,MAAM,WAAW;AAqBjB,SAAgB,cAAc,MAAqB,SAAoD;CACrG,MAAM,OAAO,oBAAoB,MAAM,OAAO;CAC9C,OAAO;EAAE,GAAG;EAAM,WAAW;GAAE,GAAG,KAAK;GAAW,0BAA0B;GAAM,oBAAoB;EAAK;CAAE;AAC/G;AAEA,SAAS,iBAAiB,QAA2E;CACnG,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,SAAS,GAAG,OAAO,YAAY,GAAG,OAAO,eAAe,GAAG,OAAO,aAAa,KAAK;CAC1F,OAAO;EACL,eAAe,OAAO;EACtB,MAAM,OAAO;EACb,GAAI,OAAO,eAAe,EAAE,aAAa,OAAO,aAAa,IAAI,CAAC;EAClE,YAAY,OAAO,YAAY,WAAW,MAAM,IAAI,OAAO,YAAY,MAAM,OAAO,MAAM,IAAI,OAAO;EACrG,GAAI,OAAO,MAAM,EAAE,KAAK,OAAO,IAAI,IAAI,CAAC;CAC1C;AACF;AAEA,SAAS,SACP,OACA,MACA,SACe;CACf,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,cAAc,MAAM,GAAG,oBAAoB,MAAM,aAAa,EAAE;CAC3F,MAAM,SAAS,QAAQ;CACvB,OAAO;EACL,WAAW;EACX,mBAAmB;EACnB,IAAI,MAAM;EACV,QAAQ,MAAM;EACd,oBAAoB,MAAM;EAC1B,OAAO,MAAM;EACb,iBAAiB,iBAAiB,MAAM;EACxC,YAAY,QAAQ,cAAc;EAClC,WAAW;EACX,qBAAqB,MAAM;EAC3B,OAAO,KAAK;EACZ,QAAQ,MAAM;EACd,eAAe,MAAM;EACrB,UAAU,MAAM;EAChB,UAAU,MAAM,YAAY,QAAQ,WAAW;GAAE,GAAG,MAAM;GAAU,GAAG,QAAQ;EAAS,IAAI;EAC5F,aAAa,MAAM,eAAe;EAClC,mBAAmB,MAAM,qBAAqB;EAC9C,sBAAsB,MAAM,wBAAwB;EACpD,aAAa,MAAM,eAAe;EAClC,eAAe,MAAM,iBAAiB;EACtC,kBAAkB,MAAM,oBAAoB;EAC5C,UAAU,MAAM;EAChB,YAAY,MAAM;EAClB,YAAY,MAAM;EAClB,YAAY,MAAM;CACpB;AACF;AAEA,SAAS,aAAa,OAA+B,EAAE,SAAS,UAAU,CAAC,GAA+B;CACxG,MAAM,UAAmC,CAAC;CAC1C,KAAK,MAAM,CAAC,QAAQ,UAAU,OAAO,QAAQ,KAAK,GAAG;EACnD,IAAK,WAAW,QAAQ,CAAC,UAAW,WAAW,eAAe,kBAAkB,IAAI,MAAM,GAAG;EAC7F,IAAI,WAAW,uBAAuB,QAAQ,uBAAuB;OAChE,IAAI,cAAc,IAAI,MAAM,GAAG,QAAQ,UAAU;OACjD,MAAM,IAAI,MAAM,gCAAgC,OAAO,GAAG;CACjE;CACA,OAAO;AACT;;AAGA,IAAa,QAAb,MAAmB;CAEE;CACA;CAFnB,YACE,KACA,aAA8B,OAC9B;EAFiB,KAAA,MAAA;EACA,KAAA,aAAA;CAChB;CAEH,MAAM,OAAO,OAAyD;EACpE,MAAM,EAAE,YAAY,WAAW,GAAG,SAAS;EAC3C,MAAM,aAAa,aAAa,MAAgC,EAAE,QAAQ,KAAK,CAAC;EAChF,IAAI,cAAc,KAAA,GAAW,OAAO;EACpC,MAAM,QAAyB,CAAC;EAChC,IAAI,KAAK,WAAW,KAAA,GAAW,MAAM,SAAS,KAAK;EACnD,IAAI,KAAK,uBAAuB,KAAA,GAAW,MAAM,qBAAqB,KAAK;EAC3E,MAAM,UAAU,MAAM,KAAK,IAAI,SAAiC,SAAS;GAAE,GAAG;GAAO,YAAY;EAAU,CAAC;EAC5G,OAAO,QAAQ,SAAS;GAAE,GAAG;GAAY,cAAc,EAAE,IAAI,QAAQ,KAAI,WAAU,OAAO,YAAY,EAAE;EAAE,IAAI;CAChH;CAEA,MAAM,MAAM,QAAgE;EAC1E,MAAM,MAAM,CAAC,GAAG,IAAI,IAAI,OAAO,KAAI,UAAS,MAAM,YAAY,CAAC,CAAC;EAChE,MAAM,wBAAQ,IAAI,IAA8B;EAChD,MAAM,0BAAU,IAAI,IAAsC;EAC1D,KAAK,IAAI,QAAQ,GAAG,QAAQ,IAAI,QAAQ,SAAS,UAAU;GACzD,MAAM,UAAU,IAAI,MAAM,OAAO,QAAQ,QAAQ;GACjD,MAAM,OAAO,MAAM,KAAK,IAAI,SAA2B,YAAY,EAAE,IAAI,EAAE,IAAI,QAAQ,EAAE,CAAC;GAC1F,KAAK,MAAM,QAAQ,MAAM,MAAM,IAAI,KAAK,IAAI,IAAI;GAChD,MAAM,aAAa,MAAM,KAAK,IAAI,SAChC,SACA,EAAE,cAAc,EAAE,IAAI,QAAQ,EAAE,GAChC,EACE,SAAS,CACP,CAAC,cAAc,KAAK,GACpB,CAAC,MAAM,KAAK,CACd,EACF,CACF;GACA,KAAK,MAAM,UAAU,YAAY;IAC/B,MAAM,QAAQ,QAAQ,IAAI,OAAO,YAAY,KAAK,CAAC;IACnD,MAAM,KAAK,MAAM;IACjB,QAAQ,IAAI,OAAO,cAAc,KAAK;GACxC;EACF;EACA,OAAO,OAAO,KAAI,UAChB,SAAS,OAAO,MAAM,IAAI,MAAM,YAAY,KAAK,MAAM,QAAQ,IAAI,MAAM,YAAY,KAAK,CAAC,CAAC,CAC9F;CACF;CAEA,MAAM,QAAQ,OAAuD;EACnE,IAAI,KAAK,YAAY,OAAO,KAAK,IAAI,QAAQ,kBAAkB,MAAM,KAAK;EAC1E,MAAM,aAAa,MAAM,KAAK,OAAO,KAAK;EAC1C,IAAI,CAAC,YAAY,OAAO;EACxB,MAAM,QAAQ,MAAM,KAAK,IAAI,QAA2B,aAAa,UAAU;EAC/E,OAAO,SAAS,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,EAAA,CAAG,KAAM;CACnD;CAEA,MAAM,SAAS,OAAwB,SAA2D;EAChG,IAAI,KAAK,YAAY,OAAO,KAAK,IAAI,SAAS,kBAAkB,MAAM,OAAO,OAAO;EACpF,MAAM,aAAa,MAAM,KAAK,OAAO,KAAK;EAC1C,OAAO,aAAa,KAAK,MAAM,MAAM,KAAK,IAAI,SAA4B,aAAa,YAAY,OAAO,CAAC,IAAI,CAAC;CAClH;CAEA,MAAM,UAAU,MAA0C;EACxD,IAAI,KAAK,YAAY,OAAO,KAAK,IAAI,UAAyB,kBAAkB,MAAM,IAAI;EAC1F,MAAM,OAAO,cACX;GACE,WAAW;GACX,aAAa;GACb,mBAAmB;GACnB,sBAAsB;GACtB,aAAa;GACb,eAAe;GACf,kBAAkB;GAClB,GAAG;GACH,IAAI,WAAW;EACjB,GACA,EAAE,YAAY,WAAW,EAAE,CAC7B;EACA,MAAM,OAAO,MAAM,KAAK,IAAI,UAA4B,YAAY,KAAK,QAAQ;EACjF,IAAI,KAAK,QAAQ,MAAM,KAAK,IAAI,UAAU,SAAS,KAAK,MAAM;EAE9D,OAAO,SAAS,MADI,KAAK,IAAI,UAA6B,aAAa,KAAK,SAAS,GAC9D,MAAM,KAAK,SAAS,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC;CAC/D;CAEA,MAAM,aACJ,OACA,SAKA,EAAE,QAAQ,UAA+B,CAAC,GACX;EAC/B,IAAI,KAAK,YAAY,OAAO,KAAK,IAAI,aAAa,kBAAkB,MAAM,OAAO,OAAO;EACxF,MAAM,aAAa,MAAM,KAAK,OAAO,KAAK;EAC1C,IAAI,CAAC,YAAY,OAAO;EACxB,MAAM,QAAQ,MAAM,KAAK,IAAI,aAAgC,aAAa,YAAY,OAAM,QAAO;GACjG,MAAM,UAAU,MAAM,KAAK,MAAM,CAAC,GAAG,CAAC,EAAA,CAAG;GACzC,MAAM,gBAAgB,OAAO,mBAAmB,MAAK,WAAU,OAAO,eAAe,MAAM,UAAU;GACrG,MAAM,UAAU,gBACZ;IACE,GAAG;IACH,iBAAiB,iBAAiB,aAAa;IAC/C,YAAY,cAAc;IAC1B,UAAU,IAAI,YAAY,cAAc,WAAW;KAAE,GAAG,IAAI;KAAU,GAAG,cAAc;IAAS,IAAI;IACpG,mBAAmB,CACjB,eACA,GAAG,OAAO,kBAAmB,QAAO,WAAU,OAAO,OAAO,cAAc,EAAE,CAC9E;GACF,IACA;GACJ,MAAM,QAAQ,MAAM,QAAQ,OAAO;GACnC,IAAI,CAAC,OAAO,OAAO;GACnB,MAAM,UAAU,aAAa,KAAK;GAClC,IAAI,MAAM,aAAa,KAAA,GAGrB,QAAQ,WADM,cAAc;IADb,GAAG;IAAS,GAAG;GACC,GAAG,EAAE,YAAY,IAAI,aAAa,CAC1C,CAAC,CAAC,UAAU;GAErC,IAAI,MAAM,UAAU,KAAA,KAAa,MAAM,UAAU,QAAQ,OACvD,MAAM,KAAK,IAAI,aAA+B,YAAY,EAAE,IAAI,IAAI,aAAa,IAAG,UAAS;IAC3F,OAAO,MAAM;IACb,UAAU,KAAK,WAAW;IAC1B,4BAAY,IAAI,KAAK;GACvB,EAAE;GAEJ,IAAI,MAAM,aAAa,KAAA,KAAa,MAAM,oBAAoB,KAAA,GAAW;IACvE,MAAM,OAAO,cAAc;KAAE,GAAG;KAAS,GAAG;IAAM,GAAG,EAAE,YAAY,IAAI,aAAa,CAAC,CAAC,CAAC;IACvF,MAAM,WAAW,QAAQ,oBAAoB;IAC7C,IAAI,QAAQ,UAAU;KACpB,MAAM,SAAS,cAAc,SAAS,EAAE,YAAY,IAAI,aAAa,CAAC,CAAC,CAAC;KACxE,MAAM,UAAU,OAAO,YACrB,OAAO,QAAQ,IAAI,CAAC,CAAC,QAClB,CAAC,KAAK,WACL,CAAC;MAAC;MAAM;MAAY;MAAc;MAAc;KAAW,CAAC,CAAC,SAAS,GAAG,KACzE,KAAK,UAAU,SAAS,IAAI,MAAM,KAAK,UAAU,KAAK,CAC1D,CACF;KACA,IAAI,OAAO,KAAK,OAAO,CAAC,CAAC,QACvB,MAAM,KAAK,IAAI,aAAqC,SAAS,EAAE,IAAI,SAAS,GAAG,IAAG,WAAU;MAC1F,MAAM,WAAW,EAAE,GAAG,OAAO,SAAS;MACtC,IAAI,cAAc,WAAW,KAAK,aAAa,MAC7C,KAAK,MAAM,uBAAO,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,QAAQ,YAAY,CAAC,CAAC,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,GAAG;OAClG,IAAI,KAAK,UAAU,QAAQ,WAAW,IAAI,MAAM,KAAK,UAAU,KAAK,SAAS,IAAI,GAAG;OACpF,IAAI,OAAO,OAAO,KAAK,UAAU,GAAG,GAAG,SAAS,OAAO,KAAK,SAAS;YAChE,OAAO,SAAS;MACvB;MAEF,OAAO;OACL,GAAG;OACH,GAAI,cAAc,UAAU,EAAE,UAAU,KAAK,aAAa,OAAO,OAAO,SAAS,IAAI,CAAC;OACtF,UAAU,OAAO,WAAW;OAC5B,4BAAY,IAAI,KAAK;OACrB,2BAAW,IAAI,KAAK;MACtB;KACF,CAAC;IACL,OAAO,IAAI,MAAM,MAAM,KAAK,IAAI,UAAU,SAAS,IAAI;SAClD,IAAI,UAAU,MAAM,KAAK,IAAI,WAAW,SAAS,EAAE,IAAI,SAAS,GAAG,CAAC;GAC3E;GACA,MAAM,qBAAqB,CAAC,QAAQ,mBAAmB,MAAM,UAAU,KAAA,KAAa,MAAM,UAAU,QAAQ;GAO5G,IAAI,EALF,sBACA,OAAO,QAAQ,OAAO,CAAC,CAAC,MACrB,CAAC,KAAK,WACL,CAAC,CAAC,YAAY,YAAY,CAAC,CAAC,SAAS,GAAG,KAAK,KAAK,UAAU,IAAI,IAAI,MAAM,KAAK,UAAU,KAAK,CAClG,IACiB;IACjB,IAAI,CAAC,OAAO,OAAO;IACnB,OAAO,EAAE,YAAY,IAAI,KAAK,KAAK,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,UAAU,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE;GAC9F;GACA,OAAO;IACL,GAAG;IACH,GAAI,qBACA;KAAE,UAAU,MAAM,YAAY,IAAI,WAAW;KAAG,YAAY,MAAM,8BAAc,IAAI,KAAK;IAAE,IAC3F,CAAC;GACP;EACF,CAAC;EACD,OAAO,SAAS,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,EAAA,CAAG,KAAM;CACnD;CAEA,MAAM,WAAW,OAAwB,OAAgD;EACvF,IAAI,KAAK,YAAY,OAAO,KAAK,IAAI,WAAW,kBAAkB,MAAM,OAAO,KAAK;EACpF,MAAM,SAAS,MAAM,KAAK,SAAS,KAAK;EACxC,KAAK,MAAM,SAAS,QAAQ,MAAM,KAAK,aAAa,EAAE,IAAI,MAAM,GAAG,SAAS,KAAK;EACjF,OAAO,OAAO;CAChB;CAEA,MAAM,WAAW,OAAyC;EACxD,IAAI,KAAK,YAAY,OAAO,KAAK,IAAI,WAAW,kBAAkB,MAAM,KAAK;EAC7E,MAAM,aAAa,MAAM,KAAK,OAAO,KAAK;EAC1C,IAAI,CAAC,YAAY,OAAO;EACxB,MAAM,SAAS,MAAM,KAAK,IAAI,SAA4B,aAAa,YAAY,EAAE,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;EAC/G,IAAI,UAAU;EACd,KAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,QAAQ;IAAE,QAAQ,MAAM;IAAQ,oBAAoB,MAAM;GAAmB;GAMnF,IAAI,CAAC,MALe,KAAK,IAAI,aAC3B,qCAAqC,MACrC,EAAE,IAAI,MAAM,GAAG,SACT,IACR,GACY,MAAM,KAAK,IAAI,UAAU,qCAAqC,MAAM;IAAE,GAAG;IAAO,IAAI,MAAM;GAAG,CAAC;GAI1G,IAAI,CAAC,MADgB,KAAK,IAAI,aAAa,aAAa;IAAE,GAAG;IAAY,GAAG;IAAO,IAAI,MAAM;GAAG,SAAS,IAAI,GAChG;GACb;GACA,MAAM,KAAK,IAAI,aAAa,YAAY;IAAE,GAAG;IAAO,IAAI,MAAM;GAAa,SAAS,IAAI;GACxF,MAAM,UAAU,MAAM,KAAK,IAAI,SAC7B,SACA;IAAE,GAAG;IAAO,cAAc,MAAM;GAAa,GAC7C,EAAE,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAC7B;GACA,KAAK,MAAM,UAAU,SAAS,MAAM,KAAK,IAAI,aAAa,SAAS,EAAE,IAAI,OAAO,GAAG,SAAS,IAAI;GAChG,MAAM,KAAK,IAAI,WAAW,SAAS;IAAE,GAAG;IAAO,cAAc,MAAM;GAAa,CAAC;GACjF,MAAM,KAAK,IAAI,WAAW,aAAa;IAAE,GAAG;IAAO,IAAI,MAAM;GAAG,CAAC;GACjE,MAAM,KAAK,IAAI,WAAW,YAAY;IAAE,GAAG;IAAO,IAAI,MAAM;GAAa,CAAC;GAC1E,MAAM,KAAK,IAAI,UAAU,qCAAqC,MAAM,CAAC,IAAI,GAAG;IAAE,GAAG;IAAO,IAAI,MAAM;GAAG,CAAC;EACxG;EACA,OAAO;CACT;AACF"}
@@ -0,0 +1,15 @@
1
+ import type { FactoryStorageOps } from '@mastra/core/storage';
2
+ /** The project a write queued claimable dispatcher work for. */
3
+ export interface FactoryClaimableWorkScope {
4
+ orgId: string;
5
+ factoryProjectId: string;
6
+ }
7
+ export declare const LEASE_TABLES: readonly ['factory_deferred_decisions', 'factory_pending_starts'];
8
+ /**
9
+ * Wrap `ops` so every write that leaves a lease-table row `pending` or `retry` reports its
10
+ * project once the write has resolved. The dispatcher sleeps while nothing is claimable, so
11
+ * this is how new work reaches it; doing it at the ops layer means a new write site can't
12
+ * forget to.
13
+ */
14
+ export declare function trackClaimableWrites(ops: FactoryStorageOps, queued: (scope: FactoryClaimableWorkScope) => void): FactoryStorageOps;
15
+ //# sourceMappingURL=claimable-work.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claimable-work.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/work-items/claimable-work.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,gEAAgE;AAChE,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,YAAY,YAAI,4BAA4B,EAAE,wBAAwB,CAAU,CAAC;AAW9F;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GACjD,iBAAiB,CAuCnB"}
@@ -0,0 +1,51 @@
1
+ // src/storage/domains/work-items/claimable-work.ts
2
+ const LEASE_TABLES = ["factory_deferred_decisions", "factory_pending_starts"];
3
+ const CLAIMABLE_STATUSES = /* @__PURE__ */ new Set(["pending", "retry"]);
4
+ function claimableScope(collection, row) {
5
+ if (!LEASE_TABLES.includes(collection) || !row || typeof row !== "object") return void 0;
6
+ const { status, org_id, factory_project_id } = row;
7
+ if (typeof status !== "string" || !CLAIMABLE_STATUSES.has(status)) return void 0;
8
+ if (typeof org_id !== "string" || typeof factory_project_id !== "string") return void 0;
9
+ return {
10
+ orgId: org_id,
11
+ factoryProjectId: factory_project_id
12
+ };
13
+ }
14
+ /**
15
+ * Wrap `ops` so every write that leaves a lease-table row `pending` or `retry` reports its
16
+ * project once the write has resolved. The dispatcher sleeps while nothing is claimable, so
17
+ * this is how new work reaches it; doing it at the ops layer means a new write site can't
18
+ * forget to.
19
+ */
20
+ function trackClaimableWrites(ops, queued) {
21
+ const report = (collection, row) => {
22
+ const scope = claimableScope(collection, row);
23
+ if (scope) queued(scope);
24
+ };
25
+ return new Proxy(ops, { get(target, property, receiver) {
26
+ const value = Reflect.get(target, property, receiver);
27
+ if (typeof value !== "function") return value;
28
+ switch (property) {
29
+ case "updateAtomic": return async (collection, where, updater, ...args) => {
30
+ let patched = false;
31
+ const row = await value.call(target, collection, where, async (current) => {
32
+ const patch = await updater(current);
33
+ patched = patch != null;
34
+ return patch;
35
+ }, ...args);
36
+ if (patched) report(collection, row);
37
+ return row;
38
+ };
39
+ case "insertOne":
40
+ case "upsertOne": return async (collection, ...args) => {
41
+ const row = await value.call(target, collection, ...args);
42
+ report(collection, row);
43
+ return row;
44
+ };
45
+ default: return value.bind(target);
46
+ }
47
+ } });
48
+ }
49
+ export { LEASE_TABLES, trackClaimableWrites };
50
+
51
+ //# sourceMappingURL=claimable-work.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claimable-work.js","names":[],"sources":["../../../../src/storage/domains/work-items/claimable-work.ts"],"sourcesContent":["import type { FactoryStorageOps } from '@mastra/core/storage';\n\n/** The project a write queued claimable dispatcher work for. */\nexport interface FactoryClaimableWorkScope {\n orgId: string;\n factoryProjectId: string;\n}\n\nexport const LEASE_TABLES = ['factory_deferred_decisions', 'factory_pending_starts'] as const;\nconst CLAIMABLE_STATUSES = new Set(['pending', 'retry']);\n\nfunction claimableScope(collection: string, row: unknown): FactoryClaimableWorkScope | undefined {\n if (!(LEASE_TABLES as readonly string[]).includes(collection) || !row || typeof row !== 'object') return undefined;\n const { status, org_id, factory_project_id } = row as Record<string, unknown>;\n if (typeof status !== 'string' || !CLAIMABLE_STATUSES.has(status)) return undefined;\n if (typeof org_id !== 'string' || typeof factory_project_id !== 'string') return undefined;\n return { orgId: org_id, factoryProjectId: factory_project_id };\n}\n\n/**\n * Wrap `ops` so every write that leaves a lease-table row `pending` or `retry` reports its\n * project once the write has resolved. The dispatcher sleeps while nothing is claimable, so\n * this is how new work reaches it; doing it at the ops layer means a new write site can't\n * forget to.\n */\nexport function trackClaimableWrites(\n ops: FactoryStorageOps,\n queued: (scope: FactoryClaimableWorkScope) => void,\n): FactoryStorageOps {\n const report = (collection: string, row: unknown) => {\n const scope = claimableScope(collection, row);\n if (scope) queued(scope);\n };\n return new Proxy(ops, {\n get(target, property, receiver) {\n const value = Reflect.get(target, property, receiver);\n if (typeof value !== 'function') return value;\n switch (property) {\n case 'updateAtomic':\n return async (collection: string, where: unknown, updater: (row: unknown) => unknown, ...args: unknown[]) => {\n let patched = false;\n const row = await value.call(\n target,\n collection,\n where,\n async (current: unknown) => {\n const patch = await updater(current);\n patched = patch != null;\n return patch;\n },\n ...args,\n );\n if (patched) report(collection, row);\n return row;\n };\n case 'insertOne':\n case 'upsertOne':\n return async (collection: string, ...args: unknown[]) => {\n const row = await value.call(target, collection, ...args);\n report(collection, row);\n return row;\n };\n default:\n return value.bind(target);\n }\n },\n });\n}\n"],"mappings":";AAQA,MAAa,eAAe,CAAC,8BAA8B,wBAAwB;AACnF,MAAM,qCAAqB,IAAI,IAAI,CAAC,WAAW,OAAO,CAAC;AAEvD,SAAS,eAAe,YAAoB,KAAqD;CAC/F,IAAI,CAAE,aAAmC,SAAS,UAAU,KAAK,CAAC,OAAO,OAAO,QAAQ,UAAU,OAAO,KAAA;CACzG,MAAM,EAAE,QAAQ,QAAQ,uBAAuB;CAC/C,IAAI,OAAO,WAAW,YAAY,CAAC,mBAAmB,IAAI,MAAM,GAAG,OAAO,KAAA;CAC1E,IAAI,OAAO,WAAW,YAAY,OAAO,uBAAuB,UAAU,OAAO,KAAA;CACjF,OAAO;EAAE,OAAO;EAAQ,kBAAkB;CAAmB;AAC/D;;;;;;;AAQA,SAAgB,qBACd,KACA,QACmB;CACnB,MAAM,UAAU,YAAoB,QAAiB;EACnD,MAAM,QAAQ,eAAe,YAAY,GAAG;EAC5C,IAAI,OAAO,OAAO,KAAK;CACzB;CACA,OAAO,IAAI,MAAM,KAAK,EACpB,IAAI,QAAQ,UAAU,UAAU;EAC9B,MAAM,QAAQ,QAAQ,IAAI,QAAQ,UAAU,QAAQ;EACpD,IAAI,OAAO,UAAU,YAAY,OAAO;EACxC,QAAQ,UAAR;GACE,KAAK,gBACH,OAAO,OAAO,YAAoB,OAAgB,SAAoC,GAAG,SAAoB;IAC3G,IAAI,UAAU;IACd,MAAM,MAAM,MAAM,MAAM,KACtB,QACA,YACA,OACA,OAAO,YAAqB;KAC1B,MAAM,QAAQ,MAAM,QAAQ,OAAO;KACnC,UAAU,SAAS;KACnB,OAAO;IACT,GACA,GAAG,IACL;IACA,IAAI,SAAS,OAAO,YAAY,GAAG;IACnC,OAAO;GACT;GACF,KAAK;GACL,KAAK,aACH,OAAO,OAAO,YAAoB,GAAG,SAAoB;IACvD,MAAM,MAAM,MAAM,MAAM,KAAK,QAAQ,YAAY,GAAG,IAAI;IACxD,OAAO,YAAY,GAAG;IACtB,OAAO;GACT;GACF,SACE,OAAO,MAAM,KAAK,MAAM;EAC5B;CACF,EACF,CAAC;AACH"}
@@ -1,11 +1,11 @@
1
1
  import { FACTORY_INTERACTIVE_KEY } from "../auth.js";
2
- import { resolveFactoryToolScope } from "./scope.js";
3
2
  import { createFactoryApprovalTools } from "./approval-tools.js";
4
- import { createFactoryReadTools } from "./read-tools.js";
5
3
  import { createFactoryMessagingTools } from "./messaging-tools.js";
4
+ import { createFactoryReadTools } from "./read-tools.js";
6
5
  import { createFactorySessionTools } from "./session-tools.js";
7
6
  import { createFactoryWorkItemTools } from "./work-item-tools.js";
8
7
  import { FACTORY_TOOLS_WITHOUT_APPROVAL, applyFactoryToolPermissions } from "./permissions.js";
8
+ import { resolveFactoryToolScope } from "./scope.js";
9
9
  // src/tools/index.ts
10
10
  /**
11
11
  * The Factory toolset for a resolved scope. Tools take scope and storage by
@@ -1,7 +1,7 @@
1
- import { requirePerson } from "./scope.js";
2
1
  import { FACTORY_SESSION_NOTIFICATION_SOURCE, deliverFactorySessionNotification, resolveSessionThread } from "./deliver.js";
3
2
  import { workItemNumber } from "./read-tools.js";
4
3
  import { reportNotification, workItemReportAttributes, workItemReportRecipients } from "./reports.js";
4
+ import { requirePerson } from "./scope.js";
5
5
  import { listSideSessions, sessionModel } from "./side-sessions.js";
6
6
  import { z } from "zod";
7
7
  import { createTool } from "@mastra/core/tools";
@@ -1,11 +1,11 @@
1
- import { needsApproval } from "../rules/types.js";
2
- import { factoryDispatchFailureMetadata } from "../rules/dispatch-errors.js";
3
- import { boardForWorkItem } from "../boards/semantics.js";
4
1
  import "../boards/index.js";
5
2
  import { toBoardSource } from "../boards/project-boards.js";
6
- import { sessionActivity } from "./deliver.js";
3
+ import { boardForWorkItem } from "../boards/semantics.js";
7
4
  import { factorySessionUrl, factoryWorkItemUrl } from "../links.js";
8
5
  import { decisionRetryable, overtakenDecisionIds } from "../rules/decision-applicability.js";
6
+ import { factoryDispatchFailureMetadata } from "../rules/dispatch-errors.js";
7
+ import { needsApproval } from "../rules/types.js";
8
+ import { sessionActivity } from "./deliver.js";
9
9
  import { z } from "zod";
10
10
  import { createTool } from "@mastra/core/tools";
11
11
  // src/tools/read-tools.ts
@@ -1,6 +1,6 @@
1
1
  import { FACTORY_INTERACTIVE_KEY, factoryUserOrgId, getFactoryAuthUserFromContext, getFactoryAuthUserId } from "../auth.js";
2
- import { auditActorProfile } from "../storage/domains/audit/base.js";
3
2
  import { isWorkerSession } from "../session/session-threads.js";
3
+ import { auditActorProfile } from "../storage/domains/audit/base.js";
4
4
  // src/tools/scope.ts
5
5
  /** Linked Slack sender, separate from the session owner's model-credential identity. */
6
6
  const FACTORY_SLACK_SENDER_KEY = "mastra__factorySlackSender";
@@ -1,21 +1,21 @@
1
1
  import { boardForWorkItem } from "../boards/semantics.js";
2
2
  import "../boards/index.js";
3
- import { toBoardSource } from "../boards/project-boards.js";
4
3
  import { workLaneForRole } from "../boards/legacy-plan-role.js";
5
- import { primeTenantCredentialsForTenant } from "../routes/tenant-credentials.js";
6
- import { effectiveModelScope } from "../storage/domains/projects/base.js";
7
- import { ensureFactorySourceSession, hydrateFactorySession, resolveFactorySessionModel } from "../session/factory-session.js";
8
- import { resolveSessionThread } from "./deliver.js";
4
+ import { toBoardSource } from "../boards/project-boards.js";
9
5
  import { factorySessionUrl, factoryWorkItemUrl } from "../links.js";
10
- import { findWorkItem, workItemNotFound, workItemNumber, workItemRefSchema } from "./read-tools.js";
11
- import { sessionModel } from "./side-sessions.js";
12
- import { resolveFactoryModelPolicy } from "../session/credential-policy.js";
13
6
  import { buildModelCatalog, listSessionScopedCredentials } from "../routes/config.js";
14
7
  import { USER_SESSION_BRANCH_PREFIX } from "../routes/source-control-sessions.js";
15
- import { resolveWorkItemRepository } from "../session/work-item-repository.js";
8
+ import { primeTenantCredentialsForTenant } from "../routes/tenant-credentials.js";
16
9
  import { FactoryStartTransitionError, WorkItemRepositoryError } from "../rules/start-coordinator.js";
10
+ import { resolveFactoryModelPolicy } from "../session/credential-policy.js";
11
+ import { ensureFactorySourceSession, hydrateFactorySession, resolveFactorySessionModel } from "../session/factory-session.js";
17
12
  import { recordSessionRunStart } from "../session/run-audit.js";
13
+ import { resolveWorkItemRepository } from "../session/work-item-repository.js";
14
+ import { effectiveModelScope } from "../storage/domains/projects/base.js";
15
+ import { resolveSessionThread } from "./deliver.js";
16
+ import { findWorkItem, workItemNotFound, workItemNumber, workItemRefSchema } from "./read-tools.js";
18
17
  import { heartbeatOpenRunUntilEnd } from "./run-watch.js";
18
+ import { sessionModel } from "./side-sessions.js";
19
19
  import { RequestContext } from "@mastra/core/request-context";
20
20
  import { z } from "zod";
21
21
  import { createTool } from "@mastra/core/tools";
@@ -1,14 +1,14 @@
1
- import { WorkItemRelationError } from "../storage/domains/work-items/base.js";
2
- import { boardForWorkItem } from "../boards/semantics.js";
3
1
  import "../boards/index.js";
2
+ import { boardForWorkItem } from "../boards/semantics.js";
4
3
  import { toBoardSource } from "../boards/project-boards.js";
5
- import { requirePerson } from "./scope.js";
6
4
  import { factoryWorkItemUrl } from "../links.js";
7
- import { findWorkItem, truncate, workItemNotFound, workItemNumber, workItemRefSchema, workItemStage } from "./read-tools.js";
8
5
  import { transitionBodySchema } from "../routes/contracts.js";
9
6
  import { resolveWorkItemRepository } from "../session/work-item-repository.js";
7
+ import { WorkItemRelationError } from "../storage/domains/work-items/base.js";
10
8
  import { createFactoryWorkItem } from "../work-items/create-work-item.js";
11
9
  import { dismissFactoryDecision, resolveFactoryProposal, retryFactoryDecision } from "../work-items/decision-actions.js";
10
+ import { findWorkItem, truncate, workItemNotFound, workItemNumber, workItemRefSchema, workItemStage } from "./read-tools.js";
11
+ import { requirePerson } from "./scope.js";
12
12
  import { z } from "zod";
13
13
  import { randomUUID } from "crypto";
14
14
  import { createTool } from "@mastra/core/tools";
@@ -25,7 +25,7 @@ export type CreateFactoryWorkItemResult =
25
25
  code: 'invalid_board' | 'governed_transition_required' | 'factory_transitions_unavailable';
26
26
  message: string;
27
27
  }
28
- /** The first phase's entry rules (or the move to an intake route's phase) refused the card; it was removed again. */
28
+ /** The first phase's entry rules (or the move to an intake route's phase) refused the card; it was removed again unless a concurrent create had already reused it. */
29
29
  | {
30
30
  status: 'rejected';
31
31
  code: Extract<TransitionResult, {
@@ -1 +1 @@
1
- {"version":3,"file":"create-work-item.d.ts","sourceRoot":"","sources":["../../src/work-items/create-work-item.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACzG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzG,4GAA4G;AAC5G,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExE,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAEpF,MAAM,MAAM,2BAA2B;AACrC,oEAAoE;AAClE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE;AACnC,wGAAwG;GACtG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAChC;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,eAAe,GAAG,8BAA8B,GAAG,iCAAiC,CAAC;IAC3F,OAAO,EAAE,MAAM,CAAC;CACjB;AACH,qHAAqH;GACnH;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5G,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAC5E,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,sFAAsF;IACtF,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;CACrE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,KAAK,EACL,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,KAAK,EACL,YAAY,EACZ,MAAM,GACP,EAAE,yBAAyB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAwGlE"}
1
+ {"version":3,"file":"create-work-item.d.ts","sourceRoot":"","sources":["../../src/work-items/create-work-item.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACzG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzG,4GAA4G;AAC5G,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExE,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAKpF,MAAM,MAAM,2BAA2B;AACrC,oEAAoE;AAClE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE;AACnC,wGAAwG;GACtG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAChC;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,eAAe,GAAG,8BAA8B,GAAG,iCAAiC,CAAC;IAC3F,OAAO,EAAE,MAAM,CAAC;CACjB;AACH,sKAAsK;GACpK;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5G,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAC5E,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,sFAAsF;IACtF,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;CACrE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,KAAK,EACL,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,KAAK,EACL,YAAY,EACZ,MAAM,GACP,EAAE,yBAAyB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAqJlE"}
@@ -1,11 +1,14 @@
1
- import { cardRuleFacts } from "../boards/card-facts.js";
2
1
  import "../boards/index.js";
3
- import { resolveIntakePlacement } from "../boards/intake-routing.js";
2
+ import { cardRuleFacts } from "../boards/card-facts.js";
3
+ import { INTAKE_ROUTE_METADATA_KEY, resolveIntakePlacement } from "../boards/intake-routing.js";
4
+ import { WorkItemUpdateConflictError } from "../storage/domains/work-items/base.js";
4
5
  // src/work-items/create-work-item.ts
5
6
  /**
6
7
  * Filing a work item, shared by the board's create route and the Factory tools
7
8
  * so a card filed from a session goes through exactly what "New card" does.
8
9
  */
10
+ /** Attempts at each step after the upsert before a card that keeps changing under its creator is left as is. */
11
+ const STEP_ATTEMPTS = 3;
9
12
  /**
10
13
  * Upserts the card into its board's first phase, enters that phase as the
11
14
  * person (rolling the card back if its entry rules refuse it), then audits
@@ -49,31 +52,71 @@ async function createFactoryWorkItem({ workItems, boards, transitionService, aud
49
52
  status: "reused",
50
53
  item: result.item
51
54
  };
52
- const created = placement ? (await workItems.update({
53
- orgId,
54
- id: result.item.id,
55
- userId,
56
- patch: { metadata: { ["intakeRouteId"]: placement.routeId } },
57
- expectedRevision: result.item.revision
58
- }))?.item ?? result.item : result.item;
59
- if (!transitionService) {
55
+ const id = result.item.id;
56
+ let revision = result.item.revision;
57
+ let updatedAt = result.item.updatedAt;
58
+ let contended = false;
59
+ const reread = async () => {
60
+ contended = true;
61
+ revision = (await workItems.getForProject(orgId, factoryProjectId, id))?.revision;
62
+ };
63
+ const rollBack = async () => {
64
+ if (contended || revision === void 0) return;
60
65
  await workItems.delete({
61
66
  orgId,
62
- id: created.id
67
+ id,
68
+ expectedRevision: revision,
69
+ expectedUpdatedAt: updatedAt
63
70
  });
71
+ };
72
+ const notFound = {
73
+ status: "rejected",
74
+ code: "invalid_transition",
75
+ reason: "Work item not found."
76
+ };
77
+ if (placement) {
78
+ for (let attempt = 1; revision !== void 0; attempt++) try {
79
+ const stamped = await workItems.update({
80
+ orgId,
81
+ id,
82
+ userId,
83
+ patch: { metadata: { [INTAKE_ROUTE_METADATA_KEY]: placement.routeId } },
84
+ expectedRevision: revision
85
+ });
86
+ revision = stamped?.item.revision;
87
+ if (stamped) updatedAt = stamped.item.updatedAt;
88
+ break;
89
+ } catch (error) {
90
+ if (!(error instanceof WorkItemUpdateConflictError && error.reason === "revision") || attempt >= STEP_ATTEMPTS) throw error;
91
+ await reread();
92
+ }
93
+ if (revision === void 0) return notFound;
94
+ }
95
+ if (!transitionService) {
96
+ await rollBack();
64
97
  return {
65
98
  status: "refused",
66
99
  code: "factory_transitions_unavailable",
67
100
  message: "Factory stage transitions are not available right now."
68
101
  };
69
102
  }
70
- const entered = await transitionService.transition({
103
+ const transition = async (request) => {
104
+ for (let attempt = 1; revision !== void 0; attempt++) {
105
+ const transitioned = await transitionService.transition({
106
+ ...request,
107
+ expectedRevision: revision
108
+ });
109
+ if (transitioned.status === "accepted") revision = transitioned.revision;
110
+ if (transitioned.status !== "rejected" || transitioned.code !== "stale" || attempt >= STEP_ATTEMPTS) return transitioned;
111
+ await reread();
112
+ }
113
+ };
114
+ const entered = await transition({
71
115
  orgId,
72
116
  factoryProjectId,
73
- workItemId: created.id,
117
+ workItemId: id,
74
118
  board: boardId,
75
119
  stage: board.initialPhase,
76
- expectedRevision: created.revision,
77
120
  actor: {
78
121
  type: "human",
79
122
  id: userId
@@ -81,16 +124,14 @@ async function createFactoryWorkItem({ workItems, boards, transitionService, aud
81
124
  ...origin,
82
125
  ingress: {
83
126
  type: "human",
84
- identity: `work-item:${created.id}:initial-entry`
127
+ identity: `work-item:${id}:initial-entry`
85
128
  },
86
129
  cause: "work_item_created",
87
130
  initialEntry: true
88
131
  });
132
+ if (!entered) return notFound;
89
133
  if (entered.status === "rejected") {
90
- await workItems.delete({
91
- orgId,
92
- id: created.id
93
- });
134
+ await rollBack();
94
135
  return {
95
136
  status: "rejected",
96
137
  code: entered.code,
@@ -98,28 +139,25 @@ async function createFactoryWorkItem({ workItems, boards, transitionService, aud
98
139
  };
99
140
  }
100
141
  if (placement && placement.phase !== board.initialPhase) {
101
- const moved = await transitionService.transition({
142
+ const moved = await transition({
102
143
  orgId,
103
144
  factoryProjectId,
104
- workItemId: created.id,
145
+ workItemId: id,
105
146
  board: boardId,
106
147
  stage: placement.phase,
107
- expectedRevision: entered.revision,
108
148
  actor: {
109
149
  type: "system",
110
150
  id: "factory-intake-route"
111
151
  },
112
152
  ingress: {
113
153
  type: "rule",
114
- identity: `work-item:${created.id}:intake-route`
154
+ identity: `work-item:${id}:intake-route`
115
155
  },
116
156
  cause: "work_item_created"
117
157
  });
158
+ if (!moved) return notFound;
118
159
  if (moved.status === "rejected") {
119
- await workItems.delete({
120
- orgId,
121
- id: created.id
122
- });
160
+ await rollBack();
123
161
  return {
124
162
  status: "rejected",
125
163
  code: moved.code,
@@ -127,7 +165,7 @@ async function createFactoryWorkItem({ workItems, boards, transitionService, aud
127
165
  };
128
166
  }
129
167
  }
130
- const item = await workItems.getForProject(orgId, factoryProjectId, created.id) ?? created;
168
+ const item = await workItems.getForProject(orgId, factoryProjectId, id) ?? result.item;
131
169
  await audit({
132
170
  action: "factory.work_item.created",
133
171
  factoryProjectId,
@@ -1 +1 @@
1
- {"version":3,"file":"create-work-item.js","names":[],"sources":["../../src/work-items/create-work-item.ts"],"sourcesContent":["/**\n * Filing a work item, shared by the board's create route and the Factory tools\n * so a card filed from a session goes through exactly what \"New card\" does.\n */\n\nimport { cardRuleFacts } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport { INTAKE_ROUTE_METADATA_KEY, resolveIntakePlacement } from '../boards/intake-routing.js';\nimport type { IntakeRoutesReader } from '../boards/intake-routing.js';\nimport type { FactoryTransitionRequest, FactoryTransitionService } from '../rules/transition-service.js';\nimport type { EmitAuditInput } from '../storage/domains/audit/domain.js';\nimport type { CreateWorkItemInput, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\n\n/** Records one audit event for the caller; routes bind it to the request, tools to the session's person. */\nexport type FactoryAuditEmit = (input: EmitAuditInput) => Promise<void>;\n\ntype TransitionResult = Awaited<ReturnType<FactoryTransitionService['transition']>>;\n\nexport type CreateFactoryWorkItemResult =\n /** A new card, entered into its board's first phase and audited. */\n | { status: 'created'; item: Card }\n /** The source key matched an existing card, which was updated instead (the caller audits the patch). */\n | { status: 'reused'; item: Card }\n | {\n status: 'refused';\n code: 'invalid_board' | 'governed_transition_required' | 'factory_transitions_unavailable';\n message: string;\n }\n /** The first phase's entry rules (or the move to an intake route's phase) refused the card; it was removed again. */\n | { status: 'rejected'; code: Extract<TransitionResult, { status: 'rejected' }>['code']; reason: string };\n\nexport interface CreateFactoryWorkItemArgs {\n workItems: WorkItemsStorage;\n boards: BoardRegistry;\n transitionService: Pick<FactoryTransitionService, 'transition'> | undefined;\n audit: FactoryAuditEmit;\n orgId: string;\n /** Who files the card; becomes its `created_by` and the human actor of its first phase entry. */\n userId: string;\n factoryProjectId: string;\n input: CreateWorkItemInput;\n /** The project's intake routes; they place a card filed without a board or stages. */\n intakeRoutes?: IntakeRoutesReader;\n /** Where a browser request came from; a session's tool call carries none. */\n origin?: Pick<FactoryTransitionRequest, 'actorProfile' | 'context'>;\n}\n\n/**\n * Upserts the card into its board's first phase, enters that phase as the\n * person (rolling the card back if its entry rules refuse it), then audits\n * `factory.work_item.created`. Throws `WorkItemRelationError` for a bad parent.\n */\nexport async function createFactoryWorkItem({\n workItems,\n boards,\n transitionService,\n audit,\n orgId,\n userId,\n factoryProjectId,\n input,\n intakeRoutes,\n origin,\n}: CreateFactoryWorkItemArgs): Promise<CreateFactoryWorkItemResult> {\n // A card filed without a board or stages goes where the project's intake routes say; one\n // that names either went where the person chose.\n const placement =\n intakeRoutes && input.board === undefined && input.stages === undefined\n ? resolveIntakePlacement(\n await intakeRoutes.listIntakeRoutes({ orgId, factoryProjectId }),\n cardRuleFacts({\n title: input.title,\n metadata: input.metadata ?? null,\n externalSource: input.externalSource ?? null,\n }),\n boards,\n )\n : undefined;\n const boardId = placement?.board ?? input.board ?? 'work';\n const board = boards.get(boardId);\n if (!board) return { status: 'refused', code: 'invalid_board', message: `Board '${boardId}' is not installed.` };\n const initialStages = input.stages ?? [board.initialPhase];\n if (initialStages.length !== 1 || initialStages[0] !== board.initialPhase) {\n return {\n status: 'refused',\n code: 'governed_transition_required',\n message: `New work items must enter through the '${board.initialPhase}' phase of board '${boardId}'.`,\n };\n }\n\n await workItems.ensureReady();\n const result = await workItems.upsert({\n orgId,\n userId,\n factoryProjectId,\n input: {\n ...input,\n board: boardId,\n stages: initialStages,\n },\n reuseMode: 'non-stage',\n });\n // A reused card keeps its own placement, so only a card this call created records the route.\n if (!result.created) return { status: 'reused', item: result.item };\n\n const created = placement\n ? ((\n await workItems.update({\n orgId,\n id: result.item.id,\n userId,\n patch: { metadata: { [INTAKE_ROUTE_METADATA_KEY]: placement.routeId } },\n expectedRevision: result.item.revision,\n })\n )?.item ?? result.item)\n : result.item;\n if (!transitionService) {\n await workItems.delete({ orgId, id: created.id });\n return {\n status: 'refused',\n code: 'factory_transitions_unavailable',\n message: 'Factory stage transitions are not available right now.',\n };\n }\n const entered = await transitionService.transition({\n orgId,\n factoryProjectId,\n workItemId: created.id,\n board: boardId,\n stage: board.initialPhase,\n expectedRevision: created.revision,\n actor: { type: 'human', id: userId },\n ...origin,\n ingress: { type: 'human', identity: `work-item:${created.id}:initial-entry` },\n cause: 'work_item_created',\n initialEntry: true,\n });\n if (entered.status === 'rejected') {\n await workItems.delete({ orgId, id: created.id });\n return { status: 'rejected', code: entered.code, reason: entered.reason };\n }\n if (placement && placement.phase !== board.initialPhase) {\n const moved = await transitionService.transition({\n orgId,\n factoryProjectId,\n workItemId: created.id,\n board: boardId,\n stage: placement.phase,\n expectedRevision: entered.revision,\n // The route moves the card, not the person: a run it starts still needs their consent.\n actor: { type: 'system', id: 'factory-intake-route' },\n ingress: { type: 'rule', identity: `work-item:${created.id}:intake-route` },\n cause: 'work_item_created',\n });\n if (moved.status === 'rejected') {\n await workItems.delete({ orgId, id: created.id });\n return { status: 'rejected', code: moved.code, reason: moved.reason };\n }\n }\n const item = (await workItems.getForProject(orgId, factoryProjectId, created.id)) ?? created;\n await audit({\n action: 'factory.work_item.created',\n factoryProjectId,\n targets: [{ type: 'work_item', id: item.id, name: item.title }],\n metadata: { externalSource: item.externalSource, stages: item.stages },\n });\n return { status: 'created', item };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"create-work-item.js","names":[],"sources":["../../src/work-items/create-work-item.ts"],"sourcesContent":["/**\n * Filing a work item, shared by the board's create route and the Factory tools\n * so a card filed from a session goes through exactly what \"New card\" does.\n */\n\nimport { cardRuleFacts } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport { INTAKE_ROUTE_METADATA_KEY, resolveIntakePlacement } from '../boards/intake-routing.js';\nimport type { IntakeRoutesReader } from '../boards/intake-routing.js';\nimport type { FactoryTransitionRequest, FactoryTransitionService } from '../rules/transition-service.js';\nimport type { EmitAuditInput } from '../storage/domains/audit/domain.js';\nimport { WorkItemUpdateConflictError } from '../storage/domains/work-items/base.js';\nimport type { CreateWorkItemInput, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\n\n/** Records one audit event for the caller; routes bind it to the request, tools to the session's person. */\nexport type FactoryAuditEmit = (input: EmitAuditInput) => Promise<void>;\n\ntype TransitionResult = Awaited<ReturnType<FactoryTransitionService['transition']>>;\n\n/** Attempts at each step after the upsert before a card that keeps changing under its creator is left as is. */\nconst STEP_ATTEMPTS = 3;\n\nexport type CreateFactoryWorkItemResult =\n /** A new card, entered into its board's first phase and audited. */\n | { status: 'created'; item: Card }\n /** The source key matched an existing card, which was updated instead (the caller audits the patch). */\n | { status: 'reused'; item: Card }\n | {\n status: 'refused';\n code: 'invalid_board' | 'governed_transition_required' | 'factory_transitions_unavailable';\n message: string;\n }\n /** The first phase's entry rules (or the move to an intake route's phase) refused the card; it was removed again unless a concurrent create had already reused it. */\n | { status: 'rejected'; code: Extract<TransitionResult, { status: 'rejected' }>['code']; reason: string };\n\nexport interface CreateFactoryWorkItemArgs {\n workItems: WorkItemsStorage;\n boards: BoardRegistry;\n transitionService: Pick<FactoryTransitionService, 'transition'> | undefined;\n audit: FactoryAuditEmit;\n orgId: string;\n /** Who files the card; becomes its `created_by` and the human actor of its first phase entry. */\n userId: string;\n factoryProjectId: string;\n input: CreateWorkItemInput;\n /** The project's intake routes; they place a card filed without a board or stages. */\n intakeRoutes?: IntakeRoutesReader;\n /** Where a browser request came from; a session's tool call carries none. */\n origin?: Pick<FactoryTransitionRequest, 'actorProfile' | 'context'>;\n}\n\n/**\n * Upserts the card into its board's first phase, enters that phase as the\n * person (rolling the card back if its entry rules refuse it), then audits\n * `factory.work_item.created`. Throws `WorkItemRelationError` for a bad parent.\n */\nexport async function createFactoryWorkItem({\n workItems,\n boards,\n transitionService,\n audit,\n orgId,\n userId,\n factoryProjectId,\n input,\n intakeRoutes,\n origin,\n}: CreateFactoryWorkItemArgs): Promise<CreateFactoryWorkItemResult> {\n // A card filed without a board or stages goes where the project's intake routes say; one\n // that names either went where the person chose.\n const placement =\n intakeRoutes && input.board === undefined && input.stages === undefined\n ? resolveIntakePlacement(\n await intakeRoutes.listIntakeRoutes({ orgId, factoryProjectId }),\n cardRuleFacts({\n title: input.title,\n metadata: input.metadata ?? null,\n externalSource: input.externalSource ?? null,\n }),\n boards,\n )\n : undefined;\n const boardId = placement?.board ?? input.board ?? 'work';\n const board = boards.get(boardId);\n if (!board) return { status: 'refused', code: 'invalid_board', message: `Board '${boardId}' is not installed.` };\n const initialStages = input.stages ?? [board.initialPhase];\n if (initialStages.length !== 1 || initialStages[0] !== board.initialPhase) {\n return {\n status: 'refused',\n code: 'governed_transition_required',\n message: `New work items must enter through the '${board.initialPhase}' phase of board '${boardId}'.`,\n };\n }\n\n await workItems.ensureReady();\n const result = await workItems.upsert({\n orgId,\n userId,\n factoryProjectId,\n input: {\n ...input,\n board: boardId,\n stages: initialStages,\n },\n reuseMode: 'non-stage',\n });\n // A reused card keeps its own placement, so only a card this call created records the route.\n if (!result.created) return { status: 'reused', item: result.item };\n\n const id = result.item.id;\n // A concurrent create for the same source can reuse this card at any step below. That caller\n // has already returned it as `reused`, so a step that loses the revision race is retried at the\n // current revision, and the card is never rolled back once anyone else has touched it. A reuse\n // that only refreshes source facts keeps the revision but moves `updatedAt`, so the rollback\n // deletes only while both still match this call's last write.\n let revision: number | undefined = result.item.revision;\n let updatedAt = result.item.updatedAt;\n let contended = false;\n const reread = async () => {\n contended = true;\n revision = (await workItems.getForProject(orgId, factoryProjectId, id))?.revision;\n };\n const rollBack = async () => {\n if (contended || revision === undefined) return;\n await workItems.delete({ orgId, id, expectedRevision: revision, expectedUpdatedAt: updatedAt });\n };\n const notFound = { status: 'rejected', code: 'invalid_transition', reason: 'Work item not found.' } as const;\n\n if (placement) {\n for (let attempt = 1; revision !== undefined; attempt++) {\n try {\n const stamped = await workItems.update({\n orgId,\n id,\n userId,\n patch: { metadata: { [INTAKE_ROUTE_METADATA_KEY]: placement.routeId } },\n expectedRevision: revision,\n });\n revision = stamped?.item.revision;\n if (stamped) updatedAt = stamped.item.updatedAt;\n break;\n } catch (error) {\n const stale = error instanceof WorkItemUpdateConflictError && error.reason === 'revision';\n if (!stale || attempt >= STEP_ATTEMPTS) throw error;\n await reread();\n }\n }\n if (revision === undefined) return notFound;\n }\n if (!transitionService) {\n await rollBack();\n return {\n status: 'refused',\n code: 'factory_transitions_unavailable',\n message: 'Factory stage transitions are not available right now.',\n };\n }\n const transition = async (\n request: Omit<FactoryTransitionRequest, 'expectedRevision'>,\n ): Promise<TransitionResult | undefined> => {\n for (let attempt = 1; revision !== undefined; attempt++) {\n const transitioned = await transitionService.transition({ ...request, expectedRevision: revision });\n // The result carries no timestamp, so `updatedAt` stays at the last write this call saw; the\n // commit has moved the card past it, so a later rollback keeps the card instead of guessing.\n if (transitioned.status === 'accepted') revision = transitioned.revision;\n if (transitioned.status !== 'rejected' || transitioned.code !== 'stale' || attempt >= STEP_ATTEMPTS) {\n return transitioned;\n }\n await reread();\n }\n return undefined;\n };\n\n const entered = await transition({\n orgId,\n factoryProjectId,\n workItemId: id,\n board: boardId,\n stage: board.initialPhase,\n actor: { type: 'human', id: userId },\n ...origin,\n ingress: { type: 'human', identity: `work-item:${id}:initial-entry` },\n cause: 'work_item_created',\n initialEntry: true,\n });\n if (!entered) return notFound;\n if (entered.status === 'rejected') {\n await rollBack();\n return { status: 'rejected', code: entered.code, reason: entered.reason };\n }\n if (placement && placement.phase !== board.initialPhase) {\n const moved = await transition({\n orgId,\n factoryProjectId,\n workItemId: id,\n board: boardId,\n stage: placement.phase,\n // The route moves the card, not the person: a run it starts still needs their consent.\n actor: { type: 'system', id: 'factory-intake-route' },\n ingress: { type: 'rule', identity: `work-item:${id}:intake-route` },\n cause: 'work_item_created',\n });\n if (!moved) return notFound;\n if (moved.status === 'rejected') {\n await rollBack();\n return { status: 'rejected', code: moved.code, reason: moved.reason };\n }\n }\n const item = (await workItems.getForProject(orgId, factoryProjectId, id)) ?? result.item;\n await audit({\n action: 'factory.work_item.created',\n factoryProjectId,\n targets: [{ type: 'work_item', id: item.id, name: item.title }],\n metadata: { externalSource: item.externalSource, stages: item.stages },\n });\n return { status: 'created', item };\n}\n"],"mappings":";;;;;;;;;;AAoBA,MAAM,gBAAgB;;;;;;AAoCtB,eAAsB,sBAAsB,EAC1C,WACA,QACA,mBACA,OACA,OACA,QACA,kBACA,OACA,cACA,UACkE;CAGlE,MAAM,YACJ,gBAAgB,MAAM,UAAU,KAAA,KAAa,MAAM,WAAW,KAAA,IAC1D,uBACE,MAAM,aAAa,iBAAiB;EAAE;EAAO;CAAiB,CAAC,GAC/D,cAAc;EACZ,OAAO,MAAM;EACb,UAAU,MAAM,YAAY;EAC5B,gBAAgB,MAAM,kBAAkB;CAC1C,CAAC,GACD,MACF,IACA,KAAA;CACN,MAAM,UAAU,WAAW,SAAS,MAAM,SAAS;CACnD,MAAM,QAAQ,OAAO,IAAI,OAAO;CAChC,IAAI,CAAC,OAAO,OAAO;EAAE,QAAQ;EAAW,MAAM;EAAiB,SAAS,UAAU,QAAQ;CAAqB;CAC/G,MAAM,gBAAgB,MAAM,UAAU,CAAC,MAAM,YAAY;CACzD,IAAI,cAAc,WAAW,KAAK,cAAc,OAAO,MAAM,cAC3D,OAAO;EACL,QAAQ;EACR,MAAM;EACN,SAAS,0CAA0C,MAAM,aAAa,oBAAoB,QAAQ;CACpG;CAGF,MAAM,UAAU,YAAY;CAC5B,MAAM,SAAS,MAAM,UAAU,OAAO;EACpC;EACA;EACA;EACA,OAAO;GACL,GAAG;GACH,OAAO;GACP,QAAQ;EACV;EACA,WAAW;CACb,CAAC;CAED,IAAI,CAAC,OAAO,SAAS,OAAO;EAAE,QAAQ;EAAU,MAAM,OAAO;CAAK;CAElE,MAAM,KAAK,OAAO,KAAK;CAMvB,IAAI,WAA+B,OAAO,KAAK;CAC/C,IAAI,YAAY,OAAO,KAAK;CAC5B,IAAI,YAAY;CAChB,MAAM,SAAS,YAAY;EACzB,YAAY;EACZ,YAAY,MAAM,UAAU,cAAc,OAAO,kBAAkB,EAAE,EAAA,EAAI;CAC3E;CACA,MAAM,WAAW,YAAY;EAC3B,IAAI,aAAa,aAAa,KAAA,GAAW;EACzC,MAAM,UAAU,OAAO;GAAE;GAAO;GAAI,kBAAkB;GAAU,mBAAmB;EAAU,CAAC;CAChG;CACA,MAAM,WAAW;EAAE,QAAQ;EAAY,MAAM;EAAsB,QAAQ;CAAuB;CAElG,IAAI,WAAW;EACb,KAAK,IAAI,UAAU,GAAG,aAAa,KAAA,GAAW,WAC5C,IAAI;GACF,MAAM,UAAU,MAAM,UAAU,OAAO;IACrC;IACA;IACA;IACA,OAAO,EAAE,UAAU,GAAG,4BAA4B,UAAU,QAAQ,EAAE;IACtE,kBAAkB;GACpB,CAAC;GACD,WAAW,SAAS,KAAK;GACzB,IAAI,SAAS,YAAY,QAAQ,KAAK;GACtC;EACF,SAAS,OAAO;GAEd,IAAI,EADU,iBAAiB,+BAA+B,MAAM,WAAW,eACjE,WAAW,eAAe,MAAM;GAC9C,MAAM,OAAO;EACf;EAEF,IAAI,aAAa,KAAA,GAAW,OAAO;CACrC;CACA,IAAI,CAAC,mBAAmB;EACtB,MAAM,SAAS;EACf,OAAO;GACL,QAAQ;GACR,MAAM;GACN,SAAS;EACX;CACF;CACA,MAAM,aAAa,OACjB,YAC0C;EAC1C,KAAK,IAAI,UAAU,GAAG,aAAa,KAAA,GAAW,WAAW;GACvD,MAAM,eAAe,MAAM,kBAAkB,WAAW;IAAE,GAAG;IAAS,kBAAkB;GAAS,CAAC;GAGlG,IAAI,aAAa,WAAW,YAAY,WAAW,aAAa;GAChE,IAAI,aAAa,WAAW,cAAc,aAAa,SAAS,WAAW,WAAW,eACpF,OAAO;GAET,MAAM,OAAO;EACf;CAEF;CAEA,MAAM,UAAU,MAAM,WAAW;EAC/B;EACA;EACA,YAAY;EACZ,OAAO;EACP,OAAO,MAAM;EACb,OAAO;GAAE,MAAM;GAAS,IAAI;EAAO;EACnC,GAAG;EACH,SAAS;GAAE,MAAM;GAAS,UAAU,aAAa,GAAG;EAAgB;EACpE,OAAO;EACP,cAAc;CAChB,CAAC;CACD,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,QAAQ,WAAW,YAAY;EACjC,MAAM,SAAS;EACf,OAAO;GAAE,QAAQ;GAAY,MAAM,QAAQ;GAAM,QAAQ,QAAQ;EAAO;CAC1E;CACA,IAAI,aAAa,UAAU,UAAU,MAAM,cAAc;EACvD,MAAM,QAAQ,MAAM,WAAW;GAC7B;GACA;GACA,YAAY;GACZ,OAAO;GACP,OAAO,UAAU;GAEjB,OAAO;IAAE,MAAM;IAAU,IAAI;GAAuB;GACpD,SAAS;IAAE,MAAM;IAAQ,UAAU,aAAa,GAAG;GAAe;GAClE,OAAO;EACT,CAAC;EACD,IAAI,CAAC,OAAO,OAAO;EACnB,IAAI,MAAM,WAAW,YAAY;GAC/B,MAAM,SAAS;GACf,OAAO;IAAE,QAAQ;IAAY,MAAM,MAAM;IAAM,QAAQ,MAAM;GAAO;EACtE;CACF;CACA,MAAM,OAAQ,MAAM,UAAU,cAAc,OAAO,kBAAkB,EAAE,KAAM,OAAO;CACpF,MAAM,MAAM;EACV,QAAQ;EACR;EACA,SAAS,CAAC;GAAE,MAAM;GAAa,IAAI,KAAK;GAAI,MAAM,KAAK;EAAM,CAAC;EAC9D,UAAU;GAAE,gBAAgB,KAAK;GAAgB,QAAQ,KAAK;EAAO;CACvE,CAAC;CACD,OAAO;EAAE,QAAQ;EAAW;CAAK;AACnC"}