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

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 (646) hide show
  1. package/README.md +361 -162
  2. package/dist/auth.d.ts.map +1 -1
  3. package/dist/auth.js +12 -6
  4. package/dist/auth.js.map +1 -1
  5. package/dist/boards/board-events.d.ts +23 -3
  6. package/dist/boards/board-events.d.ts.map +1 -1
  7. package/dist/boards/board-events.js +44 -7
  8. package/dist/boards/board-events.js.map +1 -1
  9. package/dist/boards/board-writes.d.ts +2 -2
  10. package/dist/boards/board-writes.d.ts.map +1 -1
  11. package/dist/boards/board-writes.js +23 -9
  12. package/dist/boards/board-writes.js.map +1 -1
  13. package/dist/boards/card-facts.d.ts +3 -1
  14. package/dist/boards/card-facts.d.ts.map +1 -1
  15. package/dist/boards/card-facts.js +30 -4
  16. package/dist/boards/card-facts.js.map +1 -1
  17. package/dist/boards/default-board.d.ts +7 -0
  18. package/dist/boards/default-board.d.ts.map +1 -0
  19. package/dist/boards/default-board.js +10 -0
  20. package/dist/boards/default-board.js.map +1 -0
  21. package/dist/boards/define-board.d.ts +40 -18
  22. package/dist/boards/define-board.d.ts.map +1 -1
  23. package/dist/boards/define-board.js +64 -42
  24. package/dist/boards/define-board.js.map +1 -1
  25. package/dist/boards/index.d.ts +6 -9
  26. package/dist/boards/index.d.ts.map +1 -1
  27. package/dist/boards/index.js +6 -20
  28. package/dist/boards/intake-routing.d.ts +29 -9
  29. package/dist/boards/intake-routing.d.ts.map +1 -1
  30. package/dist/boards/intake-routing.js +72 -20
  31. package/dist/boards/intake-routing.js.map +1 -1
  32. package/dist/boards/legacy-plan-role.d.ts.map +1 -1
  33. package/dist/boards/legacy-plan-role.js +7 -2
  34. package/dist/boards/legacy-plan-role.js.map +1 -1
  35. package/dist/boards/phase-automation.d.ts +7 -0
  36. package/dist/boards/phase-automation.d.ts.map +1 -1
  37. package/dist/boards/phase-automation.js +16 -5
  38. package/dist/boards/phase-automation.js.map +1 -1
  39. package/dist/boards/phase-runner.d.ts +18 -10
  40. package/dist/boards/phase-runner.d.ts.map +1 -1
  41. package/dist/boards/phase-runner.js +39 -34
  42. package/dist/boards/phase-runner.js.map +1 -1
  43. package/dist/boards/project-boards.d.ts +57 -11
  44. package/dist/boards/project-boards.d.ts.map +1 -1
  45. package/dist/boards/project-boards.js +161 -34
  46. package/dist/boards/project-boards.js.map +1 -1
  47. package/dist/boards/registry.d.ts +7 -1
  48. package/dist/boards/registry.d.ts.map +1 -1
  49. package/dist/boards/registry.js +19 -4
  50. package/dist/boards/registry.js.map +1 -1
  51. package/dist/boards/relocate.d.ts +1 -1
  52. package/dist/boards/relocate.d.ts.map +1 -1
  53. package/dist/boards/relocate.js +3 -2
  54. package/dist/boards/relocate.js.map +1 -1
  55. package/dist/boards/review.d.ts +5 -2
  56. package/dist/boards/review.d.ts.map +1 -1
  57. package/dist/boards/review.js +12 -11
  58. package/dist/boards/review.js.map +1 -1
  59. package/dist/boards/semantics.d.ts +160 -20
  60. package/dist/boards/semantics.d.ts.map +1 -1
  61. package/dist/boards/semantics.js +255 -23
  62. package/dist/boards/semantics.js.map +1 -1
  63. package/dist/boards/stored-board.d.ts +32 -18
  64. package/dist/boards/stored-board.d.ts.map +1 -1
  65. package/dist/boards/stored-board.js +31 -97
  66. package/dist/boards/stored-board.js.map +1 -1
  67. package/dist/boards/work-migrations.d.ts +43 -0
  68. package/dist/boards/work-migrations.d.ts.map +1 -0
  69. package/dist/boards/work-migrations.js +353 -0
  70. package/dist/boards/work-migrations.js.map +1 -0
  71. package/dist/boards/work-routes.d.ts +58 -0
  72. package/dist/boards/work-routes.d.ts.map +1 -0
  73. package/dist/boards/work-routes.js +270 -0
  74. package/dist/boards/work-routes.js.map +1 -0
  75. package/dist/boards/work-seeds.d.ts +9 -0
  76. package/dist/boards/work-seeds.d.ts.map +1 -0
  77. package/dist/boards/work-seeds.js +56 -0
  78. package/dist/boards/work-seeds.js.map +1 -0
  79. package/dist/boards/work.d.ts +8 -19
  80. package/dist/boards/work.d.ts.map +1 -1
  81. package/dist/boards/work.js +33 -281
  82. package/dist/boards/work.js.map +1 -1
  83. package/dist/environment/build-runner.d.ts.map +1 -1
  84. package/dist/environment/build-runner.js +2 -2
  85. package/dist/environment/build-runner.js.map +1 -1
  86. package/dist/environment/build-workflow.d.ts.map +1 -1
  87. package/dist/environment/build-workflow.js +6 -5
  88. package/dist/environment/build-workflow.js.map +1 -1
  89. package/dist/environment/build.d.ts +15 -2
  90. package/dist/environment/build.d.ts.map +1 -1
  91. package/dist/environment/build.js +32 -9
  92. package/dist/environment/build.js.map +1 -1
  93. package/dist/factory.d.ts +34 -7
  94. package/dist/factory.d.ts.map +1 -1
  95. package/dist/factory.js +161 -133
  96. package/dist/factory.js.map +1 -1
  97. package/dist/feed-events.d.ts +4 -4
  98. package/dist/feed-events.d.ts.map +1 -1
  99. package/dist/feed-events.js +6 -6
  100. package/dist/feed-events.js.map +1 -1
  101. package/dist/index.d.ts +7 -2
  102. package/dist/index.d.ts.map +1 -1
  103. package/dist/index.js +5 -3
  104. package/dist/integrations/base.d.ts +6 -13
  105. package/dist/integrations/base.d.ts.map +1 -1
  106. package/dist/integrations/closing-references.d.ts +15 -0
  107. package/dist/integrations/closing-references.d.ts.map +1 -0
  108. package/dist/integrations/closing-references.js +69 -0
  109. package/dist/integrations/closing-references.js.map +1 -0
  110. package/dist/integrations/github/default-rules.d.ts +15 -66
  111. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  112. package/dist/integrations/github/default-rules.js +129 -73
  113. package/dist/integrations/github/default-rules.js.map +1 -1
  114. package/dist/integrations/github/integration.d.ts.map +1 -1
  115. package/dist/integrations/github/integration.js +7 -3
  116. package/dist/integrations/github/integration.js.map +1 -1
  117. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  118. package/dist/integrations/github/issue-reconciler.js +5 -3
  119. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  120. package/dist/integrations/github/provenance.js +1 -1
  121. package/dist/integrations/github/provenance.js.map +1 -1
  122. package/dist/integrations/github/pull-request-source.d.ts +8 -0
  123. package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
  124. package/dist/integrations/github/pull-request-source.js +17 -0
  125. package/dist/integrations/github/pull-request-source.js.map +1 -0
  126. package/dist/integrations/github/reconcile-worker.d.ts +5 -1
  127. package/dist/integrations/github/reconcile-worker.d.ts.map +1 -1
  128. package/dist/integrations/github/reconcile-worker.js +39 -6
  129. package/dist/integrations/github/reconcile-worker.js.map +1 -1
  130. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -1
  131. package/dist/integrations/github/review-status-reporter.js +7 -3
  132. package/dist/integrations/github/review-status-reporter.js.map +1 -1
  133. package/dist/integrations/github/routes.d.ts +4 -3
  134. package/dist/integrations/github/routes.d.ts.map +1 -1
  135. package/dist/integrations/github/routes.js +10 -87
  136. package/dist/integrations/github/routes.js.map +1 -1
  137. package/dist/integrations/github/rules.d.ts +79 -7
  138. package/dist/integrations/github/rules.d.ts.map +1 -1
  139. package/dist/integrations/github/rules.js +426 -102
  140. package/dist/integrations/github/rules.js.map +1 -1
  141. package/dist/integrations/github/sandbox.d.ts +10 -2
  142. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  143. package/dist/integrations/github/sandbox.js +20 -4
  144. package/dist/integrations/github/sandbox.js.map +1 -1
  145. package/dist/integrations/github/session-subscriptions.js +2 -2
  146. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  147. package/dist/integrations/github/token-refresh.d.ts +2 -1
  148. package/dist/integrations/github/token-refresh.d.ts.map +1 -1
  149. package/dist/integrations/github/token-refresh.js.map +1 -1
  150. package/dist/integrations/gitlab/agent-tools.js +1 -1
  151. package/dist/integrations/gitlab/default-rules.d.ts +73 -31
  152. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  153. package/dist/integrations/gitlab/default-rules.js +106 -43
  154. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  155. package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
  156. package/dist/integrations/gitlab/issue-reconciler.js +2 -1
  157. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  158. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  159. package/dist/integrations/gitlab/merge-request-reconciler.js +12 -5
  160. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  161. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  162. package/dist/integrations/gitlab/routes.js +1 -3
  163. package/dist/integrations/gitlab/routes.js.map +1 -1
  164. package/dist/integrations/gitlab/rules.d.ts +6 -1
  165. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  166. package/dist/integrations/gitlab/rules.js +119 -30
  167. package/dist/integrations/gitlab/rules.js.map +1 -1
  168. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  169. package/dist/integrations/incidentio/agent-tools.js +6 -6
  170. package/dist/integrations/incidentio/agent-tools.js.map +1 -1
  171. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  172. package/dist/integrations/incidentio/default-rules.js +3 -3
  173. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  174. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  175. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  176. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  177. package/dist/integrations/incidentio/routes.d.ts +2 -2
  178. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  179. package/dist/integrations/incidentio/routes.js +10 -13
  180. package/dist/integrations/incidentio/routes.js.map +1 -1
  181. package/dist/integrations/incidentio/rules.d.ts +4 -4
  182. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  183. package/dist/integrations/incidentio/rules.js +18 -14
  184. package/dist/integrations/incidentio/rules.js.map +1 -1
  185. package/dist/integrations/issue-reconciler.js +1 -1
  186. package/dist/integrations/issue-reconciler.js.map +1 -1
  187. package/dist/integrations/jira/agent-tools.js +1 -1
  188. package/dist/integrations/jira/binding-scope.d.ts +5 -6
  189. package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
  190. package/dist/integrations/jira/binding-scope.js +9 -11
  191. package/dist/integrations/jira/binding-scope.js.map +1 -1
  192. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  193. package/dist/integrations/jira/default-rules.js +3 -3
  194. package/dist/integrations/jira/default-rules.js.map +1 -1
  195. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  196. package/dist/integrations/jira/issue-reconciler.js +2 -1
  197. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  198. package/dist/integrations/jira/routes.d.ts.map +1 -1
  199. package/dist/integrations/jira/routes.js +3 -5
  200. package/dist/integrations/jira/routes.js.map +1 -1
  201. package/dist/integrations/jira/rules.d.ts +4 -4
  202. package/dist/integrations/jira/rules.d.ts.map +1 -1
  203. package/dist/integrations/jira/rules.js +18 -14
  204. package/dist/integrations/jira/rules.js.map +1 -1
  205. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  206. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  207. package/dist/integrations/linear/agent-tools.js +81 -3
  208. package/dist/integrations/linear/agent-tools.js.map +1 -1
  209. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  210. package/dist/integrations/linear/default-rules.js +3 -3
  211. package/dist/integrations/linear/default-rules.js.map +1 -1
  212. package/dist/integrations/linear/integration.d.ts +4 -1
  213. package/dist/integrations/linear/integration.d.ts.map +1 -1
  214. package/dist/integrations/linear/integration.js +21 -1
  215. package/dist/integrations/linear/integration.js.map +1 -1
  216. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  217. package/dist/integrations/linear/issue-reconciler.js +2 -1
  218. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  219. package/dist/integrations/linear/routes.d.ts +2 -1
  220. package/dist/integrations/linear/routes.d.ts.map +1 -1
  221. package/dist/integrations/linear/routes.js +15 -17
  222. package/dist/integrations/linear/routes.js.map +1 -1
  223. package/dist/integrations/linear/rules.d.ts +4 -4
  224. package/dist/integrations/linear/rules.d.ts.map +1 -1
  225. package/dist/integrations/linear/rules.js +16 -15
  226. package/dist/integrations/linear/rules.js.map +1 -1
  227. package/dist/integrations/platform/connect/session-tools.d.ts +5 -0
  228. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
  229. package/dist/integrations/platform/connect/session-tools.js +5 -0
  230. package/dist/integrations/platform/connect/session-tools.js.map +1 -1
  231. package/dist/integrations/platform/github/event-worker.d.ts +4 -1
  232. package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
  233. package/dist/integrations/platform/github/event-worker.js +39 -3
  234. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  235. package/dist/integrations/platform/github/integration.d.ts +8 -0
  236. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  237. package/dist/integrations/platform/github/integration.js +131 -87
  238. package/dist/integrations/platform/github/integration.js.map +1 -1
  239. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  240. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  241. package/dist/integrations/platform/jira/routes.js +3 -5
  242. package/dist/integrations/platform/jira/routes.js.map +1 -1
  243. package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
  244. package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
  245. package/dist/integrations/platform/linear/event-worker.js +1 -1
  246. package/dist/integrations/platform/linear/event-worker.js.map +1 -1
  247. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  248. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  249. package/dist/integrations/platform/linear/integration.js +6 -5
  250. package/dist/integrations/platform/linear/integration.js.map +1 -1
  251. package/dist/integrations/slack/chat-tools.js +1 -1
  252. package/dist/integrations/slack/integration.d.ts +0 -2
  253. package/dist/integrations/slack/integration.d.ts.map +1 -1
  254. package/dist/integrations/slack/integration.js +0 -5
  255. package/dist/integrations/slack/integration.js.map +1 -1
  256. package/dist/integrations/slack/reply-tool.js +1 -1
  257. package/dist/integrations/slack/run-error-card.js +1 -0
  258. package/dist/integrations/slack/run-error-card.js.map +1 -1
  259. package/dist/integrations/slack/share-file-tool.js +1 -1
  260. package/dist/integrations/slack/slack.d.ts +13 -22
  261. package/dist/integrations/slack/slack.d.ts.map +1 -1
  262. package/dist/integrations/slack/slack.js +22 -83
  263. package/dist/integrations/slack/slack.js.map +1 -1
  264. package/dist/links.d.ts +1 -2
  265. package/dist/links.d.ts.map +1 -1
  266. package/dist/links.js +4 -4
  267. package/dist/links.js.map +1 -1
  268. package/dist/mcp/routes.js +3 -3
  269. package/dist/mcp/routes.js.map +1 -1
  270. package/dist/provider-display-name.d.ts.map +1 -1
  271. package/dist/provider-display-name.js +1 -0
  272. package/dist/provider-display-name.js.map +1 -1
  273. package/dist/routes/attention-parked.d.ts +1 -0
  274. package/dist/routes/attention-parked.d.ts.map +1 -1
  275. package/dist/routes/attention-parked.js +2 -2
  276. package/dist/routes/attention-parked.js.map +1 -1
  277. package/dist/routes/attention-providers.d.ts +0 -25
  278. package/dist/routes/attention-providers.d.ts.map +1 -1
  279. package/dist/routes/attention-providers.js +2 -150
  280. package/dist/routes/attention-providers.js.map +1 -1
  281. package/dist/routes/attention.d.ts +0 -2
  282. package/dist/routes/attention.d.ts.map +1 -1
  283. package/dist/routes/attention.js +2 -13
  284. package/dist/routes/attention.js.map +1 -1
  285. package/dist/routes/automation-runs.d.ts +5 -1
  286. package/dist/routes/automation-runs.d.ts.map +1 -1
  287. package/dist/routes/automation-runs.js +15 -0
  288. package/dist/routes/automation-runs.js.map +1 -1
  289. package/dist/routes/board-snapshot.d.ts +15 -0
  290. package/dist/routes/board-snapshot.d.ts.map +1 -0
  291. package/dist/routes/board-snapshot.js +41 -0
  292. package/dist/routes/board-snapshot.js.map +1 -0
  293. package/dist/routes/boards.d.ts +2 -2
  294. package/dist/routes/boards.d.ts.map +1 -1
  295. package/dist/routes/boards.js +1 -17
  296. package/dist/routes/boards.js.map +1 -1
  297. package/dist/routes/config.d.ts +11 -1
  298. package/dist/routes/config.d.ts.map +1 -1
  299. package/dist/routes/config.js +120 -22
  300. package/dist/routes/config.js.map +1 -1
  301. package/dist/routes/contracts.d.ts +251 -51
  302. package/dist/routes/contracts.d.ts.map +1 -1
  303. package/dist/routes/contracts.js +120 -40
  304. package/dist/routes/contracts.js.map +1 -1
  305. package/dist/routes/feed-events.d.ts +15 -0
  306. package/dist/routes/feed-events.d.ts.map +1 -0
  307. package/dist/routes/feed-events.js +68 -0
  308. package/dist/routes/feed-events.js.map +1 -0
  309. package/dist/routes/fs.d.ts +4 -0
  310. package/dist/routes/fs.d.ts.map +1 -1
  311. package/dist/routes/fs.js +8 -4
  312. package/dist/routes/fs.js.map +1 -1
  313. package/dist/routes/intake-routes.d.ts.map +1 -1
  314. package/dist/routes/intake-routes.js +6 -1
  315. package/dist/routes/intake-routes.js.map +1 -1
  316. package/dist/routes/intake.d.ts +0 -23
  317. package/dist/routes/intake.d.ts.map +1 -1
  318. package/dist/routes/intake.js +13 -309
  319. package/dist/routes/intake.js.map +1 -1
  320. package/dist/routes/knowledge.js +1 -1
  321. package/dist/routes/mastra-gateway.d.ts +19 -0
  322. package/dist/routes/mastra-gateway.d.ts.map +1 -0
  323. package/dist/routes/mastra-gateway.js +120 -0
  324. package/dist/routes/mastra-gateway.js.map +1 -0
  325. package/dist/routes/projects.d.ts +1 -1
  326. package/dist/routes/projects.d.ts.map +1 -1
  327. package/dist/routes/projects.js +74 -58
  328. package/dist/routes/projects.js.map +1 -1
  329. package/dist/routes/provider-credentials.d.ts +6 -1
  330. package/dist/routes/provider-credentials.d.ts.map +1 -1
  331. package/dist/routes/provider-credentials.js +42 -7
  332. package/dist/routes/provider-credentials.js.map +1 -1
  333. package/dist/routes/route.d.ts +6 -0
  334. package/dist/routes/route.d.ts.map +1 -1
  335. package/dist/routes/route.js.map +1 -1
  336. package/dist/routes/running-packages.d.ts +13 -0
  337. package/dist/routes/running-packages.d.ts.map +1 -0
  338. package/dist/routes/running-packages.js +45 -0
  339. package/dist/routes/running-packages.js.map +1 -0
  340. package/dist/routes/sandbox-envs.d.ts +26 -0
  341. package/dist/routes/sandbox-envs.d.ts.map +1 -0
  342. package/dist/routes/sandbox-envs.js +180 -0
  343. package/dist/routes/sandbox-envs.js.map +1 -0
  344. package/dist/routes/session-access.d.ts.map +1 -1
  345. package/dist/routes/session-access.js +12 -3
  346. package/dist/routes/session-access.js.map +1 -1
  347. package/dist/routes/surface.d.ts +10 -8
  348. package/dist/routes/surface.d.ts.map +1 -1
  349. package/dist/routes/surface.js +105 -42
  350. package/dist/routes/surface.js.map +1 -1
  351. package/dist/routes/tenant-credentials.d.ts.map +1 -1
  352. package/dist/routes/tenant-credentials.js +5 -1
  353. package/dist/routes/tenant-credentials.js.map +1 -1
  354. package/dist/routes/work-items.d.ts +0 -3
  355. package/dist/routes/work-items.d.ts.map +1 -1
  356. package/dist/routes/work-items.js +38 -10
  357. package/dist/routes/work-items.js.map +1 -1
  358. package/dist/rules/binding-context.d.ts.map +1 -1
  359. package/dist/rules/binding-context.js +1 -0
  360. package/dist/rules/binding-context.js.map +1 -1
  361. package/dist/rules/dispatcher.d.ts +0 -9
  362. package/dist/rules/dispatcher.d.ts.map +1 -1
  363. package/dist/rules/dispatcher.js +362 -69
  364. package/dist/rules/dispatcher.js.map +1 -1
  365. package/dist/rules/event-rules.d.ts +33 -2
  366. package/dist/rules/event-rules.d.ts.map +1 -1
  367. package/dist/rules/event-rules.js +46 -11
  368. package/dist/rules/event-rules.js.map +1 -1
  369. package/dist/rules/index.d.ts +2 -4
  370. package/dist/rules/index.d.ts.map +1 -1
  371. package/dist/rules/index.js +2 -3
  372. package/dist/rules/phase-goal.d.ts +54 -0
  373. package/dist/rules/phase-goal.d.ts.map +1 -0
  374. package/dist/rules/phase-goal.js +70 -0
  375. package/dist/rules/phase-goal.js.map +1 -0
  376. package/dist/rules/phase-tools.d.ts +11 -0
  377. package/dist/rules/phase-tools.d.ts.map +1 -0
  378. package/dist/rules/phase-tools.js +19 -0
  379. package/dist/rules/phase-tools.js.map +1 -0
  380. package/dist/rules/processor.d.ts.map +1 -1
  381. package/dist/rules/processor.js +116 -15
  382. package/dist/rules/processor.js.map +1 -1
  383. package/dist/rules/review-source-tool.d.ts +4 -1
  384. package/dist/rules/review-source-tool.d.ts.map +1 -1
  385. package/dist/rules/review-source-tool.js +24 -4
  386. package/dist/rules/review-source-tool.js.map +1 -1
  387. package/dist/rules/rule-group.d.ts +1 -1
  388. package/dist/rules/rule-group.d.ts.map +1 -1
  389. package/dist/rules/rule-group.js +15 -6
  390. package/dist/rules/rule-group.js.map +1 -1
  391. package/dist/rules/start-coordinator.d.ts +5 -1
  392. package/dist/rules/start-coordinator.d.ts.map +1 -1
  393. package/dist/rules/start-coordinator.js +9 -3
  394. package/dist/rules/start-coordinator.js.map +1 -1
  395. package/dist/rules/tools.d.ts.map +1 -1
  396. package/dist/rules/tools.js +39 -28
  397. package/dist/rules/tools.js.map +1 -1
  398. package/dist/rules/transition-service.d.ts +4 -10
  399. package/dist/rules/transition-service.d.ts.map +1 -1
  400. package/dist/rules/transition-service.js +61 -55
  401. package/dist/rules/transition-service.js.map +1 -1
  402. package/dist/rules/types.d.ts +86 -36
  403. package/dist/rules/types.d.ts.map +1 -1
  404. package/dist/rules/types.js +5 -41
  405. package/dist/rules/types.js.map +1 -1
  406. package/dist/rules/validation.d.ts.map +1 -1
  407. package/dist/rules/validation.js +32 -2
  408. package/dist/rules/validation.js.map +1 -1
  409. package/dist/run-error.d.ts +1 -1
  410. package/dist/run-error.d.ts.map +1 -1
  411. package/dist/run-error.js +38 -5
  412. package/dist/run-error.js.map +1 -1
  413. package/dist/sandbox/sandbox-env-cache.d.ts +33 -0
  414. package/dist/sandbox/sandbox-env-cache.d.ts.map +1 -0
  415. package/dist/sandbox/sandbox-env-cache.js +140 -0
  416. package/dist/sandbox/sandbox-env-cache.js.map +1 -0
  417. package/dist/sandbox/sandbox-env.d.ts +77 -0
  418. package/dist/sandbox/sandbox-env.d.ts.map +1 -0
  419. package/dist/sandbox/sandbox-env.js +130 -0
  420. package/dist/sandbox/sandbox-env.js.map +1 -0
  421. package/dist/secret-encryption.d.ts +21 -0
  422. package/dist/secret-encryption.d.ts.map +1 -1
  423. package/dist/secret-encryption.js +31 -4
  424. package/dist/secret-encryption.js.map +1 -1
  425. package/dist/session/live-sessions.d.ts +11 -4
  426. package/dist/session/live-sessions.d.ts.map +1 -1
  427. package/dist/session/live-sessions.js +31 -10
  428. package/dist/session/live-sessions.js.map +1 -1
  429. package/dist/session/self-review-gate.d.ts +6 -4
  430. package/dist/session/self-review-gate.d.ts.map +1 -1
  431. package/dist/session/self-review-gate.js +9 -12
  432. package/dist/session/self-review-gate.js.map +1 -1
  433. package/dist/session/session-threads.d.ts +2 -3
  434. package/dist/session/session-threads.d.ts.map +1 -1
  435. package/dist/session/session-threads.js.map +1 -1
  436. package/dist/session/source-control-tools.d.ts +39 -13
  437. package/dist/session/source-control-tools.d.ts.map +1 -1
  438. package/dist/session/source-control-tools.js +55 -61
  439. package/dist/session/source-control-tools.js.map +1 -1
  440. package/dist/session/work-item-state-processor.d.ts +24 -0
  441. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  442. package/dist/session/work-item-state-processor.js +275 -0
  443. package/dist/session/work-item-state-processor.js.map +1 -0
  444. package/dist/storage/domains/audit/actions.d.ts +2 -1
  445. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  446. package/dist/storage/domains/audit/actions.js +5 -4
  447. package/dist/storage/domains/audit/actions.js.map +1 -1
  448. package/dist/storage/domains/boards/base.d.ts +85 -32
  449. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  450. package/dist/storage/domains/boards/base.js +120 -131
  451. package/dist/storage/domains/boards/base.js.map +1 -1
  452. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  453. package/dist/storage/domains/boards/schemas.js +12 -0
  454. package/dist/storage/domains/boards/schemas.js.map +1 -1
  455. package/dist/storage/domains/channel-identity/base.d.ts +0 -4
  456. package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
  457. package/dist/storage/domains/channel-identity/base.js +0 -7
  458. package/dist/storage/domains/channel-identity/base.js.map +1 -1
  459. package/dist/storage/domains/intake/base.d.ts +5 -45
  460. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  461. package/dist/storage/domains/intake/base.js +11 -89
  462. package/dist/storage/domains/intake/base.js.map +1 -1
  463. package/dist/storage/domains/projects/base.d.ts +17 -9
  464. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  465. package/dist/storage/domains/projects/base.js +15 -7
  466. package/dist/storage/domains/projects/base.js.map +1 -1
  467. package/dist/storage/domains/sandbox-envs/base.d.ts +70 -0
  468. package/dist/storage/domains/sandbox-envs/base.d.ts.map +1 -0
  469. package/dist/storage/domains/sandbox-envs/base.js +227 -0
  470. package/dist/storage/domains/sandbox-envs/base.js.map +1 -0
  471. package/dist/storage/domains/work-items/base.d.ts +62 -22
  472. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  473. package/dist/storage/domains/work-items/base.js +218 -146
  474. package/dist/storage/domains/work-items/base.js.map +1 -1
  475. package/dist/storage/domains/work-items/board-version.d.ts +6 -2
  476. package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
  477. package/dist/storage/domains/work-items/board-version.js +20 -9
  478. package/dist/storage/domains/work-items/board-version.js.map +1 -1
  479. package/dist/storage/domains/work-items/cards.d.ts +28 -5
  480. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  481. package/dist/storage/domains/work-items/cards.js +156 -23
  482. package/dist/storage/domains/work-items/cards.js.map +1 -1
  483. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  484. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  485. package/dist/storage/domains/work-items/legacy-review.js +109 -0
  486. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  487. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  488. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  489. package/dist/storage/domains/work-items/metrics.js +14 -32
  490. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  491. package/dist/storage/domains/work-items/work-item-schema.d.ts +4 -2
  492. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  493. package/dist/storage/domains/work-items/work-item-schema.js +59 -26
  494. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  495. package/dist/tools/approval-tools.d.ts.map +1 -1
  496. package/dist/tools/approval-tools.js +28 -9
  497. package/dist/tools/approval-tools.js.map +1 -1
  498. package/dist/tools/index.d.ts +1 -1
  499. package/dist/tools/index.js +1 -1
  500. package/dist/tools/index.js.map +1 -1
  501. package/dist/tools/messaging-tools.d.ts +3 -0
  502. package/dist/tools/messaging-tools.d.ts.map +1 -1
  503. package/dist/tools/messaging-tools.js +2 -1
  504. package/dist/tools/messaging-tools.js.map +1 -1
  505. package/dist/tools/read-tools.d.ts +8 -4
  506. package/dist/tools/read-tools.d.ts.map +1 -1
  507. package/dist/tools/read-tools.js +86 -37
  508. package/dist/tools/read-tools.js.map +1 -1
  509. package/dist/tools/reports.d.ts +1 -0
  510. package/dist/tools/reports.d.ts.map +1 -1
  511. package/dist/tools/reports.js +2 -1
  512. package/dist/tools/reports.js.map +1 -1
  513. package/dist/tools/run-watch.d.ts +1 -1
  514. package/dist/tools/run-watch.d.ts.map +1 -1
  515. package/dist/tools/run-watch.js +1 -0
  516. package/dist/tools/run-watch.js.map +1 -1
  517. package/dist/tools/sandbox-tools.js +1 -1
  518. package/dist/tools/session-tools.js +1 -1
  519. package/dist/tools/sessions-state-processor.d.ts +2 -0
  520. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  521. package/dist/tools/sessions-state-processor.js +4 -2
  522. package/dist/tools/sessions-state-processor.js.map +1 -1
  523. package/dist/tools/side-sessions.d.ts +2 -0
  524. package/dist/tools/side-sessions.d.ts.map +1 -1
  525. package/dist/tools/side-sessions.js +2 -1
  526. package/dist/tools/side-sessions.js.map +1 -1
  527. package/dist/tools/work-item-tools.d.ts +0 -3
  528. package/dist/tools/work-item-tools.d.ts.map +1 -1
  529. package/dist/tools/work-item-tools.js +10 -20
  530. package/dist/tools/work-item-tools.js.map +1 -1
  531. package/dist/work-item-branch.d.ts +13 -0
  532. package/dist/work-item-branch.d.ts.map +1 -1
  533. package/dist/work-item-branch.js +16 -1
  534. package/dist/work-item-branch.js.map +1 -1
  535. package/dist/work-items/create-work-item.d.ts +6 -0
  536. package/dist/work-items/create-work-item.d.ts.map +1 -1
  537. package/dist/work-items/create-work-item.js +28 -3
  538. package/dist/work-items/create-work-item.js.map +1 -1
  539. package/dist/work-items/description-context.d.ts +5 -0
  540. package/dist/work-items/description-context.d.ts.map +1 -0
  541. package/dist/work-items/description-context.js +17 -0
  542. package/dist/work-items/description-context.js.map +1 -0
  543. package/dist/work-items/providers/base.d.ts +4 -1
  544. package/dist/work-items/providers/base.d.ts.map +1 -1
  545. package/dist/work-items/providers/base.js +6 -1
  546. package/dist/work-items/providers/base.js.map +1 -1
  547. package/dist/work-items/providers/github.d.ts.map +1 -1
  548. package/dist/work-items/providers/github.js +2 -1
  549. package/dist/work-items/providers/github.js.map +1 -1
  550. package/dist/work-items/providers/gitlab.d.ts.map +1 -1
  551. package/dist/work-items/providers/gitlab.js +2 -1
  552. package/dist/work-items/providers/gitlab.js.map +1 -1
  553. package/dist/work-items/providers/jira.d.ts.map +1 -1
  554. package/dist/work-items/providers/jira.js +3 -2
  555. package/dist/work-items/providers/jira.js.map +1 -1
  556. package/dist/work-items/providers/linear.d.ts.map +1 -1
  557. package/dist/work-items/providers/linear.js +3 -2
  558. package/dist/work-items/providers/linear.js.map +1 -1
  559. package/dist/work-items/providers/types.d.ts +6 -0
  560. package/dist/work-items/providers/types.d.ts.map +1 -1
  561. package/dist/work-items/split-migration.d.ts.map +1 -1
  562. package/dist/work-items/split-migration.js +8 -8
  563. package/dist/work-items/split-migration.js.map +1 -1
  564. package/dist/workspace.d.ts +3 -1
  565. package/dist/workspace.d.ts.map +1 -1
  566. package/dist/workspace.js +116 -32
  567. package/dist/workspace.js.map +1 -1
  568. package/factory-skills/configure-factory-rules/SKILL.md +13 -11
  569. package/factory-skills/factory-build/SKILL.md +64 -0
  570. package/factory-skills/factory-gitlab-rereview/SKILL.md +4 -4
  571. package/factory-skills/factory-gitlab-review/SKILL.md +6 -6
  572. package/factory-skills/factory-plan/SKILL.md +8 -10
  573. package/factory-skills/factory-rereview/SKILL.md +74 -28
  574. package/factory-skills/factory-review/SKILL.md +85 -29
  575. package/factory-skills/factory-self-review/SKILL.md +32 -13
  576. package/factory-skills/factory-triage/SKILL.md +36 -32
  577. package/package.json +12 -12
  578. package/dist/boards/index.js.map +0 -1
  579. package/dist/boards/pull-request-review.d.ts +0 -14
  580. package/dist/boards/pull-request-review.d.ts.map +0 -1
  581. package/dist/boards/pull-request-review.js +0 -81
  582. package/dist/boards/pull-request-review.js.map +0 -1
  583. package/dist/boards/work-tool-rules.d.ts +0 -8
  584. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  585. package/dist/boards/work-tool-rules.js +0 -19
  586. package/dist/boards/work-tool-rules.js.map +0 -1
  587. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
  588. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
  589. package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
  590. package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
  591. package/dist/integrations/slack/emoji.d.ts +0 -3
  592. package/dist/integrations/slack/emoji.d.ts.map +0 -1
  593. package/dist/integrations/slack/emoji.js +0 -11
  594. package/dist/integrations/slack/emoji.js.map +0 -1
  595. package/dist/integrations/slack/feed-publisher.d.ts +0 -26
  596. package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
  597. package/dist/integrations/slack/feed-publisher.js +0 -43
  598. package/dist/integrations/slack/feed-publisher.js.map +0 -1
  599. package/dist/routes/attention-activity.d.ts +0 -23
  600. package/dist/routes/attention-activity.d.ts.map +0 -1
  601. package/dist/routes/attention-activity.js +0 -154
  602. package/dist/routes/attention-activity.js.map +0 -1
  603. package/dist/rules/resolve.d.ts +0 -15
  604. package/dist/rules/resolve.d.ts.map +0 -1
  605. package/dist/rules/resolve.js +0 -22
  606. package/dist/rules/resolve.js.map +0 -1
  607. package/dist/storage/domains/comments/activity.d.ts +0 -40
  608. package/dist/storage/domains/comments/activity.d.ts.map +0 -1
  609. package/dist/storage/domains/comments/activity.js +0 -93
  610. package/dist/storage/domains/comments/activity.js.map +0 -1
  611. package/dist/storage/domains/comments/actor.d.ts +0 -51
  612. package/dist/storage/domains/comments/actor.d.ts.map +0 -1
  613. package/dist/storage/domains/comments/actor.js +0 -37
  614. package/dist/storage/domains/comments/actor.js.map +0 -1
  615. package/dist/storage/domains/comments/base.d.ts +0 -245
  616. package/dist/storage/domains/comments/base.d.ts.map +0 -1
  617. package/dist/storage/domains/comments/base.js +0 -539
  618. package/dist/storage/domains/comments/base.js.map +0 -1
  619. package/dist/storage/domains/comments/domain.d.ts +0 -135
  620. package/dist/storage/domains/comments/domain.d.ts.map +0 -1
  621. package/dist/storage/domains/comments/domain.js +0 -284
  622. package/dist/storage/domains/comments/domain.js.map +0 -1
  623. package/dist/storage/domains/comments/feed-context.d.ts +0 -22
  624. package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
  625. package/dist/storage/domains/comments/feed-context.js +0 -88
  626. package/dist/storage/domains/comments/feed-context.js.map +0 -1
  627. package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
  628. package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
  629. package/dist/storage/domains/comments/feed-sync.js +0 -1
  630. package/dist/storage/domains/comments/parse.d.ts +0 -23
  631. package/dist/storage/domains/comments/parse.d.ts.map +0 -1
  632. package/dist/storage/domains/comments/parse.js +0 -89
  633. package/dist/storage/domains/comments/parse.js.map +0 -1
  634. package/dist/storage/domains/comments/routes.d.ts +0 -24
  635. package/dist/storage/domains/comments/routes.d.ts.map +0 -1
  636. package/dist/storage/domains/comments/routes.js +0 -299
  637. package/dist/storage/domains/comments/routes.js.map +0 -1
  638. package/dist/storage/domains/comments/schema.d.ts +0 -5
  639. package/dist/storage/domains/comments/schema.d.ts.map +0 -1
  640. package/dist/storage/domains/comments/schema.js +0 -178
  641. package/dist/storage/domains/comments/schema.js.map +0 -1
  642. package/dist/storage/domains/comments/wire.d.ts +0 -40
  643. package/dist/storage/domains/comments/wire.d.ts.map +0 -1
  644. package/dist/storage/domains/comments/wire.js +0 -36
  645. package/dist/storage/domains/comments/wire.js.map +0 -1
  646. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -10,11 +10,15 @@ export interface BoardScope {
10
10
  orgId: string;
11
11
  factoryProjectId?: string;
12
12
  }
13
+ /** The tables a card is stored in: a write to one changes the card list, so it bumps the version. */
14
+ export declare const CARD_TABLES: ReadonlySet<string>;
15
+ /** What a board shows beside its cards; a write here moves no card, so the card list stays cached. */
16
+ export declare const DECISION_TABLES: ReadonlySet<string>;
13
17
  /**
14
- * Wrap `ops` so every write to a card table reports the board it changed, once the write has
18
+ * Wrap `ops` so every write to one of `tables` reports the board it changed, once the write has
15
19
  * resolved. Writes outside any tenant (`dangerouslyClearAll`) report nothing.
16
20
  */
17
- export declare function trackBoardWrites(ops: FactoryStorageOps, changed: (scope: BoardScope) => void | Promise<void>): FactoryStorageOps;
21
+ export declare function trackBoardWrites(ops: FactoryStorageOps, tables: ReadonlySet<string>, changed: (scope: BoardScope) => void | Promise<void>): FactoryStorageOps;
18
22
  /** Collects the boards a transaction changed so they can be bumped once it has committed. */
19
23
  export declare class BoardScopes {
20
24
  #private;
@@ -1 +1 @@
1
- {"version":3,"file":"board-version.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/work-items/board-version.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAQjG;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,gBAU3C,CAAC;AAEF,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA6BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnD,iBAAiB,CA6CnB;AAED,6FAA6F;AAC7F,qBAAa,WAAW;;IAGtB,GAAG,UAAW,UAAU,KAAG,IAAI,CAE7B;IAEF,MAAM,IAAI,UAAU,EAAE,CAErB;CACF;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5G;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM7B"}
1
+ {"version":3,"file":"board-version.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/work-items/board-version.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAQjG;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,gBAU3C,CAAC;AAEF,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qGAAqG;AACrG,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAK1C,CAAC;AAIH,sGAAsG;AACtG,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAAwB,CAAC;AA2BzE;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnD,iBAAiB,CAgDnB;AAED,6FAA6F;AAC7F,qBAAa,WAAW;;IAGtB,GAAG,UAAW,UAAU,KAAG,IAAI,CAE7B;IAEF,MAAM,IAAI,UAAU,EAAE,CAErB;CACF;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5G;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM7B"}
@@ -20,15 +20,23 @@ const FACTORY_BOARD_VERSIONS_SCHEMA = {
20
20
  columns: ["org_id", "factory_project_id"]
21
21
  }]
22
22
  };
23
- /** The tables a card is stored in. */
23
+ /** The tables a card is stored in: a write to one changes the card list, so it bumps the version. */
24
24
  const CARD_TABLES = /* @__PURE__ */ new Set([
25
25
  FACTORY_BOARD_ITEMS_SCHEMA.name,
26
26
  FACTORY_WORK_ITEMS_SCHEMA.name,
27
27
  FACTORY_WORK_ITEM_SOURCES_SCHEMA.name,
28
28
  "work_items"
29
29
  ]);
30
- function isCardTable(collection) {
31
- return CARD_TABLES.has(collection);
30
+ const DECISIONS = "factory_deferred_decisions";
31
+ /** What a board shows beside its cards; a write here moves no card, so the card list stays cached. */
32
+ const DECISION_TABLES = /* @__PURE__ */ new Set([DECISIONS]);
33
+ /**
34
+ * A decision that stays leased shows the same everywhere: only its lease moved. Renewing that lease
35
+ * every few seconds therefore reports nothing; every other decision write does.
36
+ */
37
+ function isLeased(collection, row) {
38
+ if (collection !== DECISIONS || typeof row !== "object" || row === null || !("status" in row)) return false;
39
+ return row.status === "leased";
32
40
  }
33
41
  const scopeKey = (scope) => `${scope.orgId}\u0000${scope.factoryProjectId ?? ""}`;
34
42
  function scopeOfRow(row) {
@@ -46,10 +54,10 @@ function scopeOfWhere(where) {
46
54
  } : { orgId: where.org_id };
47
55
  }
48
56
  /**
49
- * Wrap `ops` so every write to a card table reports the board it changed, once the write has
57
+ * Wrap `ops` so every write to one of `tables` reports the board it changed, once the write has
50
58
  * resolved. Writes outside any tenant (`dangerouslyClearAll`) report nothing.
51
59
  */
52
- function trackBoardWrites(ops, changed) {
60
+ function trackBoardWrites(ops, tables, changed) {
53
61
  const report = async (scope) => {
54
62
  if (scope) await changed(scope);
55
63
  };
@@ -59,24 +67,27 @@ function trackBoardWrites(ops, changed) {
59
67
  switch (property) {
60
68
  case "updateAtomic": return async (collection, where, updater, ...args) => {
61
69
  let patched = false;
70
+ let wasLeased = false;
62
71
  const row = await value.call(target, collection, where, async (current) => {
72
+ wasLeased = isLeased(collection, current);
63
73
  const patch = await updater(current);
64
74
  patched = patch != null;
65
75
  return patch;
66
76
  }, ...args);
67
- if (isCardTable(collection) && patched) await report(scopeOfRow(row));
77
+ const leaseOnly = wasLeased && isLeased(collection, row);
78
+ if (tables.has(collection) && patched && !leaseOnly) await report(scopeOfRow(row));
68
79
  return row;
69
80
  };
70
81
  case "insertOne":
71
82
  case "upsertOne": return async (collection, ...args) => {
72
83
  const row = await value.call(target, collection, ...args);
73
- if (isCardTable(collection)) await report(scopeOfRow(row));
84
+ if (tables.has(collection)) await report(scopeOfRow(row));
74
85
  return row;
75
86
  };
76
87
  case "updateMany":
77
88
  case "deleteMany": return async (collection, where, ...args) => {
78
89
  const count = await value.call(target, collection, where, ...args);
79
- if (isCardTable(collection) && count > 0) await report(scopeOfWhere(where));
90
+ if (tables.has(collection) && count > 0) await report(scopeOfWhere(where));
80
91
  return count;
81
92
  };
82
93
  default: return value.bind(target);
@@ -115,6 +126,6 @@ async function readBoardVersion(ops, orgId, factoryProjectId) {
115
126
  factory_project_id: factoryProjectId
116
127
  }))?.version;
117
128
  }
118
- export { BoardScopes, FACTORY_BOARD_VERSIONS_SCHEMA, bumpBoardVersions, readBoardVersion, trackBoardWrites };
129
+ export { BoardScopes, CARD_TABLES, DECISION_TABLES, FACTORY_BOARD_VERSIONS_SCHEMA, bumpBoardVersions, readBoardVersion, trackBoardWrites };
119
130
 
120
131
  //# sourceMappingURL=board-version.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"board-version.js","names":[],"sources":["../../../../src/storage/domains/work-items/board-version.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { CollectionSchema, CollectionWhere, FactoryStorageOps } from '@mastra/core/storage';\n\nimport {\n FACTORY_BOARD_ITEMS_SCHEMA,\n FACTORY_WORK_ITEMS_SCHEMA,\n FACTORY_WORK_ITEM_SOURCES_SCHEMA,\n} from './work-item-schema.js';\n\n/**\n * One row per project whose `version` is replaced after every committed write to that project's\n * cards (board items and work items). Readers of the full card list compare it against the version their snapshot was\n * taken at, so an unchanged board costs one indexed row read instead of every card.\n */\nexport const FACTORY_BOARD_VERSIONS_SCHEMA: CollectionSchema = {\n name: 'factory_board_versions',\n columns: {\n id: { type: 'uuid-pk' },\n org_id: { type: 'text' },\n factory_project_id: { type: 'text' },\n version: { type: 'text' },\n updated_at: { type: 'timestamp' },\n },\n uniqueIndexes: [{ name: 'factory_board_versions_scope_unique', columns: ['org_id', 'factory_project_id'] }],\n};\n\n/** A project, or every project in an org when a write's filter only names the org. */\nexport interface BoardScope {\n orgId: string;\n factoryProjectId?: string;\n}\n\n/** The tables a card is stored in. */\nconst CARD_TABLES = new Set([\n FACTORY_BOARD_ITEMS_SCHEMA.name,\n FACTORY_WORK_ITEMS_SCHEMA.name,\n FACTORY_WORK_ITEM_SOURCES_SCHEMA.name,\n 'work_items',\n]);\nfunction isCardTable(collection: string): boolean {\n return CARD_TABLES.has(collection);\n}\n\nconst scopeKey = (scope: BoardScope) => `${scope.orgId}\\u0000${scope.factoryProjectId ?? ''}`;\n\nfunction scopeOfRow(row: Record<string, unknown> | null): BoardScope | undefined {\n if (!row || typeof row.org_id !== 'string') return undefined;\n return typeof row.factory_project_id === 'string'\n ? { orgId: row.org_id, factoryProjectId: row.factory_project_id }\n : { orgId: row.org_id };\n}\n\nfunction scopeOfWhere(where: CollectionWhere): BoardScope | undefined {\n if (typeof where.org_id !== 'string') return undefined;\n return typeof where.factory_project_id === 'string'\n ? { orgId: where.org_id, factoryProjectId: where.factory_project_id }\n : { orgId: where.org_id };\n}\n\n/**\n * Wrap `ops` so every write to a card table reports the board it changed, once the write has\n * resolved. Writes outside any tenant (`dangerouslyClearAll`) report nothing.\n */\nexport function trackBoardWrites(\n ops: FactoryStorageOps,\n changed: (scope: BoardScope) => void | Promise<void>,\n): FactoryStorageOps {\n const report = async (scope: BoardScope | undefined) => {\n if (scope) await changed(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 (isCardTable(collection) && patched) await report(scopeOfRow(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 if (isCardTable(collection)) await report(scopeOfRow(row));\n return row;\n };\n case 'updateMany':\n case 'deleteMany':\n return async (collection: string, where: CollectionWhere, ...args: unknown[]) => {\n const count: number = await value.call(target, collection, where, ...args);\n if (isCardTable(collection) && count > 0) await report(scopeOfWhere(where));\n return count;\n };\n default:\n return value.bind(target);\n }\n },\n });\n}\n\n/** Collects the boards a transaction changed so they can be bumped once it has committed. */\nexport class BoardScopes {\n readonly #scopes = new Map<string, BoardScope>();\n\n add = (scope: BoardScope): void => {\n this.#scopes.set(scopeKey(scope), scope);\n };\n\n values(): BoardScope[] {\n return [...this.#scopes.values()];\n }\n}\n\nexport async function bumpBoardVersions(ops: FactoryStorageOps, scopes: readonly BoardScope[]): Promise<void> {\n for (const scope of scopes) {\n const version = randomUUID();\n const updated_at = new Date();\n if (scope.factoryProjectId) {\n await ops.upsertOne(FACTORY_BOARD_VERSIONS_SCHEMA.name, ['org_id', 'factory_project_id'], {\n org_id: scope.orgId,\n factory_project_id: scope.factoryProjectId,\n version,\n updated_at,\n });\n } else {\n // Projects without a row yet have no version, which never matches a snapshot.\n await ops.updateMany(FACTORY_BOARD_VERSIONS_SCHEMA.name, { org_id: scope.orgId }, { version, updated_at });\n }\n }\n}\n\nexport async function readBoardVersion(\n ops: FactoryStorageOps,\n orgId: string,\n factoryProjectId: string,\n): Promise<string | undefined> {\n const row = await ops.findOne<{ version: string }>(FACTORY_BOARD_VERSIONS_SCHEMA.name, {\n org_id: orgId,\n factory_project_id: factoryProjectId,\n });\n return row?.version;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"board-version.js","names":[],"sources":["../../../../src/storage/domains/work-items/board-version.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { CollectionSchema, CollectionWhere, FactoryStorageOps } from '@mastra/core/storage';\n\nimport {\n FACTORY_BOARD_ITEMS_SCHEMA,\n FACTORY_WORK_ITEMS_SCHEMA,\n FACTORY_WORK_ITEM_SOURCES_SCHEMA,\n} from './work-item-schema.js';\n\n/**\n * One row per project whose `version` is replaced after every committed write to that project's\n * cards (board items and work items). Readers of the full card list compare it against the version their snapshot was\n * taken at, so an unchanged board costs one indexed row read instead of every card.\n */\nexport const FACTORY_BOARD_VERSIONS_SCHEMA: CollectionSchema = {\n name: 'factory_board_versions',\n columns: {\n id: { type: 'uuid-pk' },\n org_id: { type: 'text' },\n factory_project_id: { type: 'text' },\n version: { type: 'text' },\n updated_at: { type: 'timestamp' },\n },\n uniqueIndexes: [{ name: 'factory_board_versions_scope_unique', columns: ['org_id', 'factory_project_id'] }],\n};\n\n/** A project, or every project in an org when a write's filter only names the org. */\nexport interface BoardScope {\n orgId: string;\n factoryProjectId?: string;\n}\n\n/** The tables a card is stored in: a write to one changes the card list, so it bumps the version. */\nexport const CARD_TABLES: ReadonlySet<string> = new Set([\n FACTORY_BOARD_ITEMS_SCHEMA.name,\n FACTORY_WORK_ITEMS_SCHEMA.name,\n FACTORY_WORK_ITEM_SOURCES_SCHEMA.name,\n 'work_items',\n]);\n\nconst DECISIONS = 'factory_deferred_decisions';\n\n/** What a board shows beside its cards; a write here moves no card, so the card list stays cached. */\nexport const DECISION_TABLES: ReadonlySet<string> = new Set([DECISIONS]);\n\n/**\n * A decision that stays leased shows the same everywhere: only its lease moved. Renewing that lease\n * every few seconds therefore reports nothing; every other decision write does.\n */\nfunction isLeased(collection: string, row: unknown): boolean {\n if (collection !== DECISIONS || typeof row !== 'object' || row === null || !('status' in row)) return false;\n return row.status === 'leased';\n}\n\nconst scopeKey = (scope: BoardScope) => `${scope.orgId}\\u0000${scope.factoryProjectId ?? ''}`;\n\nfunction scopeOfRow(row: Record<string, unknown> | null): BoardScope | undefined {\n if (!row || typeof row.org_id !== 'string') return undefined;\n return typeof row.factory_project_id === 'string'\n ? { orgId: row.org_id, factoryProjectId: row.factory_project_id }\n : { orgId: row.org_id };\n}\n\nfunction scopeOfWhere(where: CollectionWhere): BoardScope | undefined {\n if (typeof where.org_id !== 'string') return undefined;\n return typeof where.factory_project_id === 'string'\n ? { orgId: where.org_id, factoryProjectId: where.factory_project_id }\n : { orgId: where.org_id };\n}\n\n/**\n * Wrap `ops` so every write to one of `tables` reports the board it changed, once the write has\n * resolved. Writes outside any tenant (`dangerouslyClearAll`) report nothing.\n */\nexport function trackBoardWrites(\n ops: FactoryStorageOps,\n tables: ReadonlySet<string>,\n changed: (scope: BoardScope) => void | Promise<void>,\n): FactoryStorageOps {\n const report = async (scope: BoardScope | undefined) => {\n if (scope) await changed(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 let wasLeased = false;\n const row = await value.call(\n target,\n collection,\n where,\n async (current: unknown) => {\n wasLeased = isLeased(collection, current);\n const patch = await updater(current);\n patched = patch != null;\n return patch;\n },\n ...args,\n );\n const leaseOnly = wasLeased && isLeased(collection, row);\n if (tables.has(collection) && patched && !leaseOnly) await report(scopeOfRow(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 if (tables.has(collection)) await report(scopeOfRow(row));\n return row;\n };\n case 'updateMany':\n case 'deleteMany':\n return async (collection: string, where: CollectionWhere, ...args: unknown[]) => {\n const count: number = await value.call(target, collection, where, ...args);\n if (tables.has(collection) && count > 0) await report(scopeOfWhere(where));\n return count;\n };\n default:\n return value.bind(target);\n }\n },\n });\n}\n\n/** Collects the boards a transaction changed so they can be bumped once it has committed. */\nexport class BoardScopes {\n readonly #scopes = new Map<string, BoardScope>();\n\n add = (scope: BoardScope): void => {\n this.#scopes.set(scopeKey(scope), scope);\n };\n\n values(): BoardScope[] {\n return [...this.#scopes.values()];\n }\n}\n\nexport async function bumpBoardVersions(ops: FactoryStorageOps, scopes: readonly BoardScope[]): Promise<void> {\n for (const scope of scopes) {\n const version = randomUUID();\n const updated_at = new Date();\n if (scope.factoryProjectId) {\n await ops.upsertOne(FACTORY_BOARD_VERSIONS_SCHEMA.name, ['org_id', 'factory_project_id'], {\n org_id: scope.orgId,\n factory_project_id: scope.factoryProjectId,\n version,\n updated_at,\n });\n } else {\n // Projects without a row yet have no version, which never matches a snapshot.\n await ops.updateMany(FACTORY_BOARD_VERSIONS_SCHEMA.name, { org_id: scope.orgId }, { version, updated_at });\n }\n }\n}\n\nexport async function readBoardVersion(\n ops: FactoryStorageOps,\n orgId: string,\n factoryProjectId: string,\n): Promise<string | undefined> {\n const row = await ops.findOne<{ version: string }>(FACTORY_BOARD_VERSIONS_SCHEMA.name, {\n org_id: orgId,\n factory_project_id: factoryProjectId,\n });\n return row?.version;\n}\n"],"mappings":"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"}
@@ -1,11 +1,14 @@
1
1
  import type { CollectionListOptions, CollectionWhere, FactoryStorageOps } from '@mastra/core/storage';
2
- import type { WorkItemDbRow } from './base.js';
2
+ import type { ExternalWorkItemSource, WorkItemDbRow } from './base.js';
3
+ import type { ReviewBoardInUse } from './legacy-review.js';
3
4
  import type { WorkItemDbRecord, WorkItemSourceDbRecord } from './work-item-schema.js';
4
5
  /** Copies legacy cards that have no split rows yet; only supplied while the split backfill is pending. */
5
6
  export interface LegacyCardCopier {
6
7
  copy(rows: readonly WorkItemDbRow[]): Promise<void>;
7
8
  }
8
- export type CardInsert = Pick<WorkItemDbRow, 'org_id' | 'factory_project_id' | 'board' | 'external_source' | 'source_key' | 'parent_work_item_id' | 'title' | 'stages' | 'stage_history' | 'sessions' | 'metadata' | 'revision' | 'created_by' | 'created_at' | 'updated_at'>;
9
+ export type CardInsert = Pick<WorkItemDbRow, 'org_id' | 'factory_project_id' | 'board' | 'external_source' | 'source_key' | 'parent_work_item_id' | 'title' | 'stages' | 'stage_history' | 'sessions' | 'metadata' | 'revision' | 'created_by' | 'created_at' | 'updated_at'> & {
10
+ description?: string | null;
11
+ };
9
12
  export declare function splitCardRows(card: WorkItemDbRow, options: {
10
13
  workItemId: string;
11
14
  revision?: number;
@@ -28,12 +31,11 @@ export declare function splitCardRows(card: WorkItemDbRow, options: {
28
31
  stage_history: unknown[];
29
32
  sessions: Record<string, unknown>;
30
33
  metadata: Record<string, unknown> | null;
31
- comment_count: number;
32
- feed_activity_at: Date | null;
33
34
  revision: number;
34
35
  created_by: string;
35
36
  created_at: Date;
36
37
  updated_at: Date;
38
+ changed_at?: Date | null;
37
39
  migrated_from_updated_at: null;
38
40
  migrated_from_hash: null;
39
41
  };
@@ -44,7 +46,8 @@ export declare class Cards {
44
46
  private readonly ops;
45
47
  private readonly legacyMode;
46
48
  private readonly copier?;
47
- constructor(ops: FactoryStorageOps, legacyMode?: boolean, copier?: LegacyCardCopier | undefined);
49
+ private readonly reviewInUse;
50
+ constructor(ops: FactoryStorageOps, legacyMode?: boolean, copier?: LegacyCardCopier | undefined, reviewInUse?: ReviewBoardInUse);
48
51
  findOne(where: CollectionWhere): Promise<WorkItemDbRow | null>;
49
52
  findMany(where: CollectionWhere, options?: CollectionListOptions): Promise<WorkItemDbRow[]>;
50
53
  insertOne(card: CardInsert): Promise<WorkItemDbRow>;
@@ -56,6 +59,26 @@ export declare class Cards {
56
59
  { touch }?: {
57
60
  touch?: boolean;
58
61
  }): Promise<WorkItemDbRow | null>;
62
+ /**
63
+ * Add one more source to an existing card's work item. The new source is stored
64
+ * as `attached`, so it sorts after the card's origin source and never becomes the
65
+ * card's primary source, whatever its timestamp. Only
66
+ * the source's provider facts are stored; Factory-owned keys in `metadata`
67
+ * (trust stamps, process state) belong to the card and are ignored here.
68
+ */
69
+ attachSource(where: {
70
+ org_id: string;
71
+ id: string;
72
+ }, source: {
73
+ external_source: ExternalWorkItemSource;
74
+ metadata: Record<string, unknown> | null;
75
+ now: Date;
76
+ }, expectedRevision?: number): Promise<{
77
+ row: WorkItemDbRow;
78
+ attached: boolean;
79
+ ownerWorkItemId?: string;
80
+ revisionConflict?: true;
81
+ } | null>;
59
82
  updateMany(where: CollectionWhere, patch: Partial<WorkItemDbRow>): Promise<number>;
60
83
  deleteMany(where: CollectionWhere): Promise<number>;
61
84
  }
@@ -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;AAmBzG,0GAA0G;AAC1G,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,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;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAH1B,YACmB,GAAG,EAAE,iBAAiB,EACtB,UAAU,UAAQ,EAClB,MAAM,CAAC,EAAE,gBAAgB,YAAA,EACxC;IAsFE,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAInE;IASK,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAMhG;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,CAuF/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,CAkCxD;CACF"}
1
+ {"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/work-items/cards.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,5 @@
1
1
  import { splitLegacyWorkItem } from "../../../work-items/split-migration.js";
2
+ import { LEGACY_REVIEW_BOARD, isLegacyReviewPlacement, normalizeLegacyReviewColumns, readLegacyReviewRow, readReviewBoardInUse, widenLegacyReviewBoardFilter } from "./legacy-review.js";
2
3
  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
4
  import { randomUUID } from "crypto";
4
5
  // src/storage/domains/work-items/cards.ts
@@ -12,8 +13,7 @@ const PROJECTED_COLUMNS = /* @__PURE__ */ new Set([
12
13
  "external_source",
13
14
  "source_key",
14
15
  "title",
15
- "comment_count",
16
- "feed_activity_at"
16
+ "description"
17
17
  ]);
18
18
  const ID_BATCH = 500;
19
19
  const LEGACY = WORK_ITEMS_SCHEMA.name;
@@ -45,10 +45,18 @@ function externalSourceOf(source) {
45
45
  ...source.url ? { url: source.url } : {}
46
46
  };
47
47
  }
48
- function joinCard(board, work, sources) {
48
+ /** A source row written before `role` existed is its work item's only source, so it is the origin. */
49
+ function isOriginSource(source) {
50
+ return source.role !== "attached";
51
+ }
52
+ /** The origin source first, then attached ones, each keeping the order they were read in. */
53
+ function originFirst(sources) {
54
+ return [...sources.filter(isOriginSource), ...sources.filter((source) => !isOriginSource(source))];
55
+ }
56
+ function joinCard(board, work, sources, reviewInUse = false) {
49
57
  if (!work) throw new Error(`Board item ${board.id} has no work item ${board.work_item_id}.`);
50
- const source = sources[0];
51
- return {
58
+ const source = sources.find(isOriginSource) ?? sources[0];
59
+ return readLegacyReviewRow({
52
60
  work_item: work,
53
61
  work_item_sources: sources,
54
62
  id: board.id,
@@ -60,6 +68,7 @@ function joinCard(board, work, sources) {
60
68
  claim_key: null,
61
69
  parent_work_item_id: board.parent_board_item_id,
62
70
  title: work.title,
71
+ description: work.description ?? null,
63
72
  stages: board.stages,
64
73
  stage_history: board.stage_history,
65
74
  sessions: board.sessions,
@@ -71,13 +80,22 @@ function joinCard(board, work, sources) {
71
80
  autonomy_armed_at: board.autonomy_armed_at ?? null,
72
81
  plans_preapproved_at: board.plans_preapproved_at ?? null,
73
82
  accepted_at: board.accepted_at ?? null,
74
- comment_count: board.comment_count ?? 0,
75
- feed_activity_at: board.feed_activity_at ?? null,
76
83
  revision: board.revision,
77
84
  created_by: board.created_by,
78
85
  created_at: board.created_at,
79
86
  updated_at: board.updated_at
80
- };
87
+ }, reviewInUse);
88
+ }
89
+ /** A board filter that leaves Review out: a widened query's rows a project keeping Review holds there. */
90
+ function excludesReview(filter) {
91
+ if (filter === "review") return false;
92
+ if (filter && typeof filter === "object" && "in" in filter && Array.isArray(filter.in)) return !filter.in.includes(LEGACY_REVIEW_BOARD);
93
+ return true;
94
+ }
95
+ /** Strictly after the row's last change, so two writes in one millisecond still both read as changes. */
96
+ function nextChangedAt(row) {
97
+ const previous = row.changed_at ? new Date(row.changed_at).getTime() : 0;
98
+ return new Date(Math.max(Date.now(), previous + 1));
81
99
  }
82
100
  function boardColumns(patch, { filter = false } = {}) {
83
101
  const columns = {};
@@ -94,10 +112,31 @@ var Cards = class {
94
112
  ops;
95
113
  legacyMode;
96
114
  copier;
97
- constructor(ops, legacyMode = false, copier) {
115
+ reviewInUse;
116
+ constructor(ops, legacyMode = false, copier, reviewInUse = readReviewBoardInUse) {
98
117
  this.ops = ops;
99
118
  this.legacyMode = legacyMode;
100
119
  this.copier = copier;
120
+ this.reviewInUse = reviewInUse;
121
+ }
122
+ #reviewInUse = /* @__PURE__ */ new Map();
123
+ /** The projects among `boards` that still use the Review board, asked once per project per operation. */
124
+ async #projectsUsingReview(boards) {
125
+ const using = /* @__PURE__ */ new Set();
126
+ for (const board of boards) {
127
+ if (board.board !== "review") continue;
128
+ const key = `${board.org_id}\0${board.factory_project_id}`;
129
+ let inUse = this.#reviewInUse.get(key);
130
+ if (!inUse) {
131
+ inUse = this.reviewInUse(this.ops, {
132
+ orgId: board.org_id,
133
+ factoryProjectId: board.factory_project_id
134
+ });
135
+ this.#reviewInUse.set(key, inUse);
136
+ }
137
+ if (await inUse) using.add(key);
138
+ }
139
+ return using;
101
140
  }
102
141
  /**
103
142
  * Copies the legacy cards a lookup by id or source addresses that have no split rows and no
@@ -126,6 +165,7 @@ var Cards = class {
126
165
  async #where(where) {
127
166
  const { source_key: sourceKey, ...rest } = where;
128
167
  const boardWhere = boardColumns(rest, { filter: true });
168
+ if (boardWhere.board !== void 0) boardWhere.board = widenLegacyReviewBoardFilter(boardWhere.board);
129
169
  if (sourceKey === void 0) return boardWhere;
130
170
  const scope = {};
131
171
  if (rest.org_id !== void 0) scope.org_id = rest.org_id;
@@ -155,7 +195,8 @@ var Cards = class {
155
195
  }
156
196
  }
157
197
  const deletedMidRead = await this.#deletedBoardIds(boards.filter((board) => !items.has(board.work_item_id)));
158
- return boards.filter((board) => !deletedMidRead.has(board.id)).map((board) => joinCard(board, items.get(board.work_item_id) ?? null, sources.get(board.work_item_id) ?? []));
198
+ const usingReview = await this.#projectsUsingReview(boards);
199
+ return boards.filter((board) => !deletedMidRead.has(board.id)).map((board) => joinCard(board, items.get(board.work_item_id) ?? null, originFirst(sources.get(board.work_item_id) ?? []), usingReview.has(`${board.org_id}\0${board.factory_project_id}`)));
159
200
  }
160
201
  async #deletedBoardIds(boards) {
161
202
  const deleted = new Set(boards.map((board) => board.id));
@@ -174,14 +215,19 @@ var Cards = class {
174
215
  async #findOne(where) {
175
216
  const boardWhere = await this.#where(where);
176
217
  if (!boardWhere) return null;
218
+ if (where.board !== void 0 && excludesReview(where.board)) return (await this.#findMany(where, boardWhere))[0] ?? null;
177
219
  const board = await this.ops.findOne(BOARD_ITEMS, boardWhere);
178
220
  return board ? (await this.#join([board]))[0] ?? null : null;
179
221
  }
222
+ async #findMany(where, boardWhere, options) {
223
+ const rows = await this.#join(await this.ops.findMany(BOARD_ITEMS, boardWhere, options));
224
+ return where.board !== void 0 && excludesReview(where.board) ? rows.filter((row) => row.board !== LEGACY_REVIEW_BOARD) : rows;
225
+ }
180
226
  async findMany(where, options) {
181
227
  if (this.legacyMode) return this.ops.findMany(WORK_ITEMS_SCHEMA.name, where, options);
182
228
  await this.#copyLegacy(where);
183
229
  const boardWhere = await this.#where(where);
184
- return boardWhere ? this.#join(await this.ops.findMany(BOARD_ITEMS, boardWhere, options)) : [];
230
+ return boardWhere ? this.#findMany(where, boardWhere, options) : [];
185
231
  }
186
232
  async insertOne(card) {
187
233
  if (this.legacyMode) return this.ops.insertOne(WORK_ITEMS_SCHEMA.name, card);
@@ -191,14 +237,18 @@ var Cards = class {
191
237
  autonomy_armed_at: null,
192
238
  plans_preapproved_at: null,
193
239
  accepted_at: null,
194
- comment_count: 0,
195
- feed_activity_at: null,
240
+ description: null,
196
241
  ...card,
197
242
  id: randomUUID()
198
243
  }, { workItemId: randomUUID() });
199
244
  const work = await this.ops.insertOne(WORK_ITEMS, rows.workItem);
200
245
  if (rows.source) await this.ops.insertOne(SOURCES, rows.source);
201
- return joinCard(await this.ops.insertOne(BOARD_ITEMS, rows.boardItem), work, rows.source ? [rows.source] : []);
246
+ const board = await this.ops.insertOne(BOARD_ITEMS, {
247
+ ...rows.boardItem,
248
+ changed_at: /* @__PURE__ */ new Date()
249
+ });
250
+ const reviewInUse = (await this.#projectsUsingReview([board])).size > 0;
251
+ return joinCard(board, work, rows.source ? [rows.source] : [], reviewInUse);
202
252
  }
203
253
  async updateAtomic(where, updater, { touch = false } = {}) {
204
254
  if (this.legacyMode) return this.ops.updateAtomic(WORK_ITEMS_SCHEMA.name, where, updater);
@@ -225,8 +275,12 @@ var Cards = class {
225
275
  ...current,
226
276
  ...patch
227
277
  }, { workItemId: row.work_item_id }).boardItem.metadata;
228
- if (patch.title !== void 0 && patch.title !== current.title) await this.ops.updateAtomic(WORK_ITEMS, { id: row.work_item_id }, (work) => ({
229
- title: patch.title,
278
+ let wroteCard = false;
279
+ const titleChanged = patch.title !== void 0 && patch.title !== current.title;
280
+ const descriptionChanged = patch.description !== void 0 && patch.description !== current.description;
281
+ if (titleChanged || descriptionChanged) await this.ops.updateAtomic(WORK_ITEMS, { id: row.work_item_id }, (work) => ({
282
+ ...titleChanged ? { title: patch.title } : {},
283
+ ...descriptionChanged ? { description: patch.description } : {},
230
284
  revision: work.revision + 1,
231
285
  updated_at: /* @__PURE__ */ new Date()
232
286
  }));
@@ -245,6 +299,7 @@ var Cards = class {
245
299
  "updated_at",
246
300
  "synced_at"
247
301
  ].includes(key) && JSON.stringify(before?.[key]) !== JSON.stringify(value)));
302
+ wroteCard ||= Object.keys(changed).length > 0;
248
303
  if (Object.keys(changed).length) await this.ops.updateAtomic(SOURCES, { id: previous.id }, (source) => {
249
304
  const metadata = { ...source.metadata };
250
305
  if ("metadata" in changed && next.metadata !== null) for (const key of /* @__PURE__ */ new Set([...Object.keys(before?.metadata ?? {}), ...Object.keys(next.metadata)])) {
@@ -260,16 +315,28 @@ var Cards = class {
260
315
  synced_at: /* @__PURE__ */ new Date()
261
316
  };
262
317
  });
263
- } else if (next) await this.ops.insertOne(SOURCES, next);
264
- else if (previous) await this.ops.deleteMany(SOURCES, { id: previous.id });
318
+ } else if (next) {
319
+ await this.ops.insertOne(SOURCES, next);
320
+ wroteCard = true;
321
+ } else if (previous) {
322
+ await this.ops.deleteMany(SOURCES, { id: previous.id });
323
+ wroteCard = true;
324
+ }
265
325
  }
266
- const nativeTitleChanged = !current.external_source && patch.title !== void 0 && patch.title !== current.title;
267
- if (!(nativeTitleChanged || Object.entries(columns).some(([key, value]) => !["revision", "updated_at"].includes(key) && JSON.stringify(row[key]) !== JSON.stringify(value)))) {
268
- if (!touch) return null;
269
- return { updated_at: new Date(Math.max(Date.now(), new Date(row.updated_at).getTime() + 1)) };
326
+ const nativeTitleChanged = !current.external_source && titleChanged;
327
+ const boardChanged = nativeTitleChanged || descriptionChanged || Object.entries(columns).some(([key, value]) => !["revision", "updated_at"].includes(key) && JSON.stringify(row[key]) !== JSON.stringify(value));
328
+ const changedAt = nextChangedAt(row);
329
+ if (!boardChanged) {
330
+ if (!touch && !wroteCard) return null;
331
+ return {
332
+ changed_at: changedAt,
333
+ ...touch ? { updated_at: new Date(Math.max(Date.now(), new Date(row.updated_at).getTime() + 1)) } : {}
334
+ };
270
335
  }
336
+ if (isLegacyReviewPlacement(row.board, joined.work_item_sources?.[0]?.source_type) && joined.board !== "review") Object.assign(columns, normalizeLegacyReviewColumns(row, columns));
271
337
  return {
272
338
  ...columns,
339
+ changed_at: changedAt,
273
340
  ...nativeTitleChanged ? {
274
341
  revision: patch.revision ?? row.revision + 1,
275
342
  updated_at: patch.updated_at ?? /* @__PURE__ */ new Date()
@@ -278,6 +345,71 @@ var Cards = class {
278
345
  });
279
346
  return board ? (await this.#join([board]))[0] ?? null : null;
280
347
  }
348
+ /**
349
+ * Add one more source to an existing card's work item. The new source is stored
350
+ * as `attached`, so it sorts after the card's origin source and never becomes the
351
+ * card's primary source, whatever its timestamp. Only
352
+ * the source's provider facts are stored; Factory-owned keys in `metadata`
353
+ * (trust stamps, process state) belong to the card and are ignored here.
354
+ */
355
+ async attachSource(where, source, expectedRevision) {
356
+ if (this.legacyMode) throw new Error("[cards] attaching a source needs the split work item tables.");
357
+ const board = await this.ops.findOne(BOARD_ITEMS, where);
358
+ if (!board) return null;
359
+ const [joined] = await this.#join([board]);
360
+ if (!joined) return null;
361
+ const next = splitCardRows({
362
+ ...joined,
363
+ external_source: source.external_source,
364
+ metadata: source.metadata
365
+ }, { workItemId: board.work_item_id }).source;
366
+ if (!next) throw new Error("[cards] an attached source must carry provider facts.");
367
+ const existing = await this.ops.findOne(SOURCES, {
368
+ org_id: board.org_id,
369
+ factory_project_id: board.factory_project_id,
370
+ provider: next.provider,
371
+ external_id: next.external_id
372
+ });
373
+ if (existing) return existing.work_item_id === board.work_item_id ? {
374
+ row: joined,
375
+ attached: false
376
+ } : {
377
+ row: joined,
378
+ attached: false,
379
+ ownerWorkItemId: existing.work_item_id
380
+ };
381
+ let stale = false;
382
+ const bumped = await this.ops.updateAtomic(BOARD_ITEMS, { id: board.id }, (row) => {
383
+ if (expectedRevision !== void 0 && row.revision !== expectedRevision) {
384
+ stale = true;
385
+ return null;
386
+ }
387
+ return {
388
+ revision: row.revision + 1,
389
+ updated_at: source.now,
390
+ changed_at: nextChangedAt(row),
391
+ ...isLegacyReviewPlacement(row.board, joined.work_item_sources?.[0]?.source_type) && joined.board !== "review" ? normalizeLegacyReviewColumns(row, {}) : {}
392
+ };
393
+ });
394
+ if (!bumped || stale) return {
395
+ row: joined,
396
+ attached: false,
397
+ revisionConflict: true
398
+ };
399
+ await this.ops.insertOne(SOURCES, {
400
+ ...next,
401
+ id: randomUUID(),
402
+ role: "attached",
403
+ created_at: source.now,
404
+ updated_at: source.now,
405
+ synced_at: source.now
406
+ });
407
+ const [attached] = await this.#join([bumped]);
408
+ return attached ? {
409
+ row: attached,
410
+ attached: true
411
+ } : null;
412
+ }
281
413
  async updateMany(where, patch) {
282
414
  if (this.legacyMode) return this.ops.updateMany(WORK_ITEMS_SCHEMA.name, where, patch);
283
415
  const boards = await this.findMany(where);
@@ -329,7 +461,8 @@ var Cards = class {
329
461
  });
330
462
  await this.ops.upsertOne(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, ["id"], {
331
463
  ...scope,
332
- id: board.id
464
+ id: board.id,
465
+ deleted_at: /* @__PURE__ */ new Date()
333
466
  });
334
467
  }
335
468
  return deleted;