@mastra/factory 0.28.0-alpha.0 → 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 (746) hide show
  1. package/README.md +528 -161
  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 +54 -0
  6. package/dist/boards/board-events.d.ts.map +1 -0
  7. package/dist/boards/board-events.js +87 -0
  8. package/dist/boards/board-events.js.map +1 -0
  9. package/dist/boards/board-writes.d.ts +86 -0
  10. package/dist/boards/board-writes.d.ts.map +1 -0
  11. package/dist/boards/board-writes.js +266 -0
  12. package/dist/boards/board-writes.js.map +1 -0
  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 +56 -23
  22. package/dist/boards/define-board.d.ts.map +1 -1
  23. package/dist/boards/define-board.js +89 -45
  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 +55 -11
  29. package/dist/boards/intake-routing.d.ts.map +1 -1
  30. package/dist/boards/intake-routing.js +109 -19
  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 +14 -5
  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 +19 -3
  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 +65 -8
  44. package/dist/boards/project-boards.d.ts.map +1 -1
  45. package/dist/boards/project-boards.js +217 -26
  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 +73 -1
  64. package/dist/boards/stored-board.d.ts.map +1 -1
  65. package/dist/boards/stored-board.js +157 -11
  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 +90 -9
  94. package/dist/factory.d.ts.map +1 -1
  95. package/dist/factory.js +334 -141
  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 +10 -3
  102. package/dist/index.d.ts.map +1 -1
  103. package/dist/index.js +7 -4
  104. package/dist/integrations/base.d.ts +12 -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/acceptance-labels.d.ts +4 -0
  111. package/dist/integrations/github/acceptance-labels.d.ts.map +1 -1
  112. package/dist/integrations/github/acceptance-labels.js +1 -1
  113. package/dist/integrations/github/acceptance-labels.js.map +1 -1
  114. package/dist/integrations/github/default-rules.d.ts +17 -75
  115. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  116. package/dist/integrations/github/default-rules.js +134 -77
  117. package/dist/integrations/github/default-rules.js.map +1 -1
  118. package/dist/integrations/github/integration.d.ts.map +1 -1
  119. package/dist/integrations/github/integration.js +7 -3
  120. package/dist/integrations/github/integration.js.map +1 -1
  121. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  122. package/dist/integrations/github/issue-reconciler.js +21 -3
  123. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  124. package/dist/integrations/github/provenance.js +1 -1
  125. package/dist/integrations/github/provenance.js.map +1 -1
  126. package/dist/integrations/github/pull-request-source.d.ts +8 -0
  127. package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
  128. package/dist/integrations/github/pull-request-source.js +17 -0
  129. package/dist/integrations/github/pull-request-source.js.map +1 -0
  130. package/dist/integrations/github/reconcile-worker.d.ts +5 -1
  131. package/dist/integrations/github/reconcile-worker.d.ts.map +1 -1
  132. package/dist/integrations/github/reconcile-worker.js +39 -6
  133. package/dist/integrations/github/reconcile-worker.js.map +1 -1
  134. package/dist/integrations/github/review-status-comment.d.ts +61 -0
  135. package/dist/integrations/github/review-status-comment.d.ts.map +1 -0
  136. package/dist/integrations/github/review-status-comment.js +217 -0
  137. package/dist/integrations/github/review-status-comment.js.map +1 -0
  138. package/dist/integrations/github/review-status-reporter.d.ts +42 -0
  139. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -0
  140. package/dist/integrations/github/review-status-reporter.js +104 -0
  141. package/dist/integrations/github/review-status-reporter.js.map +1 -0
  142. package/dist/integrations/github/review-status.d.ts +28 -0
  143. package/dist/integrations/github/review-status.d.ts.map +1 -0
  144. package/dist/integrations/github/review-status.js +95 -0
  145. package/dist/integrations/github/review-status.js.map +1 -0
  146. package/dist/integrations/github/routes.d.ts +4 -3
  147. package/dist/integrations/github/routes.d.ts.map +1 -1
  148. package/dist/integrations/github/routes.js +11 -91
  149. package/dist/integrations/github/routes.js.map +1 -1
  150. package/dist/integrations/github/rules.d.ts +92 -8
  151. package/dist/integrations/github/rules.d.ts.map +1 -1
  152. package/dist/integrations/github/rules.js +498 -103
  153. package/dist/integrations/github/rules.js.map +1 -1
  154. package/dist/integrations/github/sandbox.d.ts +10 -2
  155. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  156. package/dist/integrations/github/sandbox.js +20 -4
  157. package/dist/integrations/github/sandbox.js.map +1 -1
  158. package/dist/integrations/github/session-subscriptions.js +2 -2
  159. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  160. package/dist/integrations/github/token-refresh.d.ts +2 -1
  161. package/dist/integrations/github/token-refresh.d.ts.map +1 -1
  162. package/dist/integrations/github/token-refresh.js.map +1 -1
  163. package/dist/integrations/gitlab/agent-tools.js +1 -1
  164. package/dist/integrations/gitlab/default-rules.d.ts +96 -39
  165. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  166. package/dist/integrations/gitlab/default-rules.js +109 -46
  167. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  168. package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
  169. package/dist/integrations/gitlab/issue-reconciler.js +2 -1
  170. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  171. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  172. package/dist/integrations/gitlab/merge-request-reconciler.js +12 -5
  173. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  174. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  175. package/dist/integrations/gitlab/routes.js +2 -6
  176. package/dist/integrations/gitlab/routes.js.map +1 -1
  177. package/dist/integrations/gitlab/rules.d.ts +22 -1
  178. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  179. package/dist/integrations/gitlab/rules.js +188 -34
  180. package/dist/integrations/gitlab/rules.js.map +1 -1
  181. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  182. package/dist/integrations/incidentio/agent-tools.js +6 -6
  183. package/dist/integrations/incidentio/agent-tools.js.map +1 -1
  184. package/dist/integrations/incidentio/default-rules.d.ts +1 -9
  185. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  186. package/dist/integrations/incidentio/default-rules.js +6 -7
  187. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  188. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  189. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  190. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  191. package/dist/integrations/incidentio/routes.d.ts +2 -2
  192. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  193. package/dist/integrations/incidentio/routes.js +11 -17
  194. package/dist/integrations/incidentio/routes.js.map +1 -1
  195. package/dist/integrations/incidentio/rules.d.ts +11 -4
  196. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  197. package/dist/integrations/incidentio/rules.js +52 -16
  198. package/dist/integrations/incidentio/rules.js.map +1 -1
  199. package/dist/integrations/issue-reconciler.js +1 -1
  200. package/dist/integrations/issue-reconciler.js.map +1 -1
  201. package/dist/integrations/jira/agent-tools.js +1 -1
  202. package/dist/integrations/jira/binding-scope.d.ts +5 -6
  203. package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
  204. package/dist/integrations/jira/binding-scope.js +9 -11
  205. package/dist/integrations/jira/binding-scope.js.map +1 -1
  206. package/dist/integrations/jira/default-rules.d.ts +1 -9
  207. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  208. package/dist/integrations/jira/default-rules.js +6 -7
  209. package/dist/integrations/jira/default-rules.js.map +1 -1
  210. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  211. package/dist/integrations/jira/issue-reconciler.js +2 -1
  212. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  213. package/dist/integrations/jira/routes.d.ts.map +1 -1
  214. package/dist/integrations/jira/routes.js +4 -9
  215. package/dist/integrations/jira/routes.js.map +1 -1
  216. package/dist/integrations/jira/rules.d.ts +11 -4
  217. package/dist/integrations/jira/rules.d.ts.map +1 -1
  218. package/dist/integrations/jira/rules.js +52 -16
  219. package/dist/integrations/jira/rules.js.map +1 -1
  220. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  221. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  222. package/dist/integrations/linear/agent-tools.js +81 -3
  223. package/dist/integrations/linear/agent-tools.js.map +1 -1
  224. package/dist/integrations/linear/default-rules.d.ts +1 -9
  225. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  226. package/dist/integrations/linear/default-rules.js +6 -7
  227. package/dist/integrations/linear/default-rules.js.map +1 -1
  228. package/dist/integrations/linear/integration.d.ts +4 -1
  229. package/dist/integrations/linear/integration.d.ts.map +1 -1
  230. package/dist/integrations/linear/integration.js +21 -1
  231. package/dist/integrations/linear/integration.js.map +1 -1
  232. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  233. package/dist/integrations/linear/issue-reconciler.js +2 -1
  234. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  235. package/dist/integrations/linear/routes.d.ts +2 -1
  236. package/dist/integrations/linear/routes.d.ts.map +1 -1
  237. package/dist/integrations/linear/routes.js +16 -21
  238. package/dist/integrations/linear/routes.js.map +1 -1
  239. package/dist/integrations/linear/rules.d.ts +11 -4
  240. package/dist/integrations/linear/rules.d.ts.map +1 -1
  241. package/dist/integrations/linear/rules.js +50 -17
  242. package/dist/integrations/linear/rules.js.map +1 -1
  243. package/dist/integrations/platform/connect/routes.d.ts +7 -1
  244. package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
  245. package/dist/integrations/platform/connect/routes.js +42 -5
  246. package/dist/integrations/platform/connect/routes.js.map +1 -1
  247. package/dist/integrations/platform/connect/session-tools.d.ts +12 -0
  248. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -0
  249. package/dist/integrations/platform/connect/session-tools.js +35 -0
  250. package/dist/integrations/platform/connect/session-tools.js.map +1 -0
  251. package/dist/integrations/platform/github/event-worker.d.ts +4 -1
  252. package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
  253. package/dist/integrations/platform/github/event-worker.js +39 -3
  254. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  255. package/dist/integrations/platform/github/integration.d.ts +8 -0
  256. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  257. package/dist/integrations/platform/github/integration.js +132 -90
  258. package/dist/integrations/platform/github/integration.js.map +1 -1
  259. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  260. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  261. package/dist/integrations/platform/jira/routes.js +4 -9
  262. package/dist/integrations/platform/jira/routes.js.map +1 -1
  263. package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
  264. package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
  265. package/dist/integrations/platform/linear/event-worker.js +10 -1
  266. package/dist/integrations/platform/linear/event-worker.js.map +1 -1
  267. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  268. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  269. package/dist/integrations/platform/linear/integration.js +7 -8
  270. package/dist/integrations/platform/linear/integration.js.map +1 -1
  271. package/dist/integrations/slack/channel-reply-processor.d.ts +2 -0
  272. package/dist/integrations/slack/channel-reply-processor.d.ts.map +1 -1
  273. package/dist/integrations/slack/channel-reply-processor.js +6 -1
  274. package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
  275. package/dist/integrations/slack/chat-tools.js +1 -1
  276. package/dist/integrations/slack/connect-route.d.ts.map +1 -1
  277. package/dist/integrations/slack/connect-route.js +1 -1
  278. package/dist/integrations/slack/connect-route.js.map +1 -1
  279. package/dist/integrations/slack/integration.d.ts +0 -2
  280. package/dist/integrations/slack/integration.d.ts.map +1 -1
  281. package/dist/integrations/slack/integration.js +2 -5
  282. package/dist/integrations/slack/integration.js.map +1 -1
  283. package/dist/integrations/slack/reply-tool.js +1 -1
  284. package/dist/integrations/slack/run-error-card.js +1 -0
  285. package/dist/integrations/slack/run-error-card.js.map +1 -1
  286. package/dist/integrations/slack/share-file-tool.js +1 -1
  287. package/dist/integrations/slack/slack.d.ts +23 -30
  288. package/dist/integrations/slack/slack.d.ts.map +1 -1
  289. package/dist/integrations/slack/slack.js +131 -125
  290. package/dist/integrations/slack/slack.js.map +1 -1
  291. package/dist/integrations/slack/voice-clips.d.ts +32 -0
  292. package/dist/integrations/slack/voice-clips.d.ts.map +1 -0
  293. package/dist/integrations/slack/voice-clips.js +201 -0
  294. package/dist/integrations/slack/voice-clips.js.map +1 -0
  295. package/dist/integrations/workos/integration.d.ts.map +1 -1
  296. package/dist/integrations/workos/integration.js +1 -3
  297. package/dist/integrations/workos/integration.js.map +1 -1
  298. package/dist/links.d.ts +1 -2
  299. package/dist/links.d.ts.map +1 -1
  300. package/dist/links.js +4 -4
  301. package/dist/links.js.map +1 -1
  302. package/dist/mcp/routes.js +2 -2
  303. package/dist/mcp/routes.js.map +1 -1
  304. package/dist/packages/_internals/workspace/dist/index.js +1 -1
  305. package/dist/provider-display-name.d.ts.map +1 -1
  306. package/dist/provider-display-name.js +1 -0
  307. package/dist/provider-display-name.js.map +1 -1
  308. package/dist/routes/attention-parked.d.ts +1 -0
  309. package/dist/routes/attention-parked.d.ts.map +1 -1
  310. package/dist/routes/attention-parked.js +2 -2
  311. package/dist/routes/attention-parked.js.map +1 -1
  312. package/dist/routes/attention-providers.d.ts +0 -25
  313. package/dist/routes/attention-providers.d.ts.map +1 -1
  314. package/dist/routes/attention-providers.js +3 -151
  315. package/dist/routes/attention-providers.js.map +1 -1
  316. package/dist/routes/attention.d.ts +0 -2
  317. package/dist/routes/attention.d.ts.map +1 -1
  318. package/dist/routes/attention.js +2 -13
  319. package/dist/routes/attention.js.map +1 -1
  320. package/dist/routes/automation-runs.d.ts +5 -1
  321. package/dist/routes/automation-runs.d.ts.map +1 -1
  322. package/dist/routes/automation-runs.js +16 -4
  323. package/dist/routes/automation-runs.js.map +1 -1
  324. package/dist/routes/board-snapshot.d.ts +15 -0
  325. package/dist/routes/board-snapshot.d.ts.map +1 -0
  326. package/dist/routes/board-snapshot.js +41 -0
  327. package/dist/routes/board-snapshot.js.map +1 -0
  328. package/dist/routes/boards.d.ts +9 -7
  329. package/dist/routes/boards.d.ts.map +1 -1
  330. package/dist/routes/boards.js +59 -145
  331. package/dist/routes/boards.js.map +1 -1
  332. package/dist/routes/config.d.ts +11 -1
  333. package/dist/routes/config.d.ts.map +1 -1
  334. package/dist/routes/config.js +122 -29
  335. package/dist/routes/config.js.map +1 -1
  336. package/dist/routes/contracts.d.ts +366 -34
  337. package/dist/routes/contracts.d.ts.map +1 -1
  338. package/dist/routes/contracts.js +179 -51
  339. package/dist/routes/contracts.js.map +1 -1
  340. package/dist/routes/feed-events.d.ts +15 -0
  341. package/dist/routes/feed-events.d.ts.map +1 -0
  342. package/dist/routes/feed-events.js +68 -0
  343. package/dist/routes/feed-events.js.map +1 -0
  344. package/dist/routes/fs.d.ts +4 -0
  345. package/dist/routes/fs.d.ts.map +1 -1
  346. package/dist/routes/fs.js +9 -8
  347. package/dist/routes/fs.js.map +1 -1
  348. package/dist/routes/intake-routes.d.ts.map +1 -1
  349. package/dist/routes/intake-routes.js +25 -13
  350. package/dist/routes/intake-routes.js.map +1 -1
  351. package/dist/routes/intake.d.ts +0 -23
  352. package/dist/routes/intake.d.ts.map +1 -1
  353. package/dist/routes/intake.js +16 -314
  354. package/dist/routes/intake.js.map +1 -1
  355. package/dist/routes/knowledge.d.ts.map +1 -1
  356. package/dist/routes/knowledge.js +2 -5
  357. package/dist/routes/knowledge.js.map +1 -1
  358. package/dist/routes/mastra-gateway.d.ts +19 -0
  359. package/dist/routes/mastra-gateway.d.ts.map +1 -0
  360. package/dist/routes/mastra-gateway.js +120 -0
  361. package/dist/routes/mastra-gateway.js.map +1 -0
  362. package/dist/routes/oauth.d.ts.map +1 -1
  363. package/dist/routes/oauth.js +1 -4
  364. package/dist/routes/oauth.js.map +1 -1
  365. package/dist/routes/projects.d.ts +3 -0
  366. package/dist/routes/projects.d.ts.map +1 -1
  367. package/dist/routes/projects.js +80 -61
  368. package/dist/routes/projects.js.map +1 -1
  369. package/dist/routes/provider-credentials.d.ts +6 -1
  370. package/dist/routes/provider-credentials.d.ts.map +1 -1
  371. package/dist/routes/provider-credentials.js +44 -3
  372. package/dist/routes/provider-credentials.js.map +1 -1
  373. package/dist/routes/route.d.ts +8 -0
  374. package/dist/routes/route.d.ts.map +1 -1
  375. package/dist/routes/route.js +5 -1
  376. package/dist/routes/route.js.map +1 -1
  377. package/dist/routes/running-packages.d.ts +13 -0
  378. package/dist/routes/running-packages.d.ts.map +1 -0
  379. package/dist/routes/running-packages.js +45 -0
  380. package/dist/routes/running-packages.js.map +1 -0
  381. package/dist/routes/sandbox-envs.d.ts +26 -0
  382. package/dist/routes/sandbox-envs.d.ts.map +1 -0
  383. package/dist/routes/sandbox-envs.js +180 -0
  384. package/dist/routes/sandbox-envs.js.map +1 -0
  385. package/dist/routes/session-access.d.ts.map +1 -1
  386. package/dist/routes/session-access.js +12 -3
  387. package/dist/routes/session-access.js.map +1 -1
  388. package/dist/routes/skills.d.ts.map +1 -1
  389. package/dist/routes/skills.js +1 -4
  390. package/dist/routes/skills.js.map +1 -1
  391. package/dist/routes/source-control-sessions.d.ts.map +1 -1
  392. package/dist/routes/source-control-sessions.js +1 -3
  393. package/dist/routes/source-control-sessions.js.map +1 -1
  394. package/dist/routes/source-control-settings.d.ts.map +1 -1
  395. package/dist/routes/source-control-settings.js +3 -2
  396. package/dist/routes/source-control-settings.js.map +1 -1
  397. package/dist/routes/surface.d.ts +13 -9
  398. package/dist/routes/surface.d.ts.map +1 -1
  399. package/dist/routes/surface.js +116 -43
  400. package/dist/routes/surface.js.map +1 -1
  401. package/dist/routes/tenant-credentials.d.ts.map +1 -1
  402. package/dist/routes/tenant-credentials.js +5 -1
  403. package/dist/routes/tenant-credentials.js.map +1 -1
  404. package/dist/routes/voice.d.ts +48 -0
  405. package/dist/routes/voice.d.ts.map +1 -0
  406. package/dist/routes/voice.js +248 -0
  407. package/dist/routes/voice.js.map +1 -0
  408. package/dist/routes/work-items.d.ts +0 -3
  409. package/dist/routes/work-items.d.ts.map +1 -1
  410. package/dist/routes/work-items.js +39 -14
  411. package/dist/routes/work-items.js.map +1 -1
  412. package/dist/rules/binding-context.d.ts.map +1 -1
  413. package/dist/rules/binding-context.js +1 -0
  414. package/dist/rules/binding-context.js.map +1 -1
  415. package/dist/rules/decision-applicability.js +1 -1
  416. package/dist/rules/dispatcher.d.ts +28 -9
  417. package/dist/rules/dispatcher.d.ts.map +1 -1
  418. package/dist/rules/dispatcher.js +734 -143
  419. package/dist/rules/dispatcher.js.map +1 -1
  420. package/dist/rules/event-rules.d.ts +71 -1
  421. package/dist/rules/event-rules.d.ts.map +1 -1
  422. package/dist/rules/event-rules.js +94 -1
  423. package/dist/rules/event-rules.js.map +1 -1
  424. package/dist/rules/index.d.ts +2 -4
  425. package/dist/rules/index.d.ts.map +1 -1
  426. package/dist/rules/index.js +2 -3
  427. package/dist/rules/phase-goal.d.ts +54 -0
  428. package/dist/rules/phase-goal.d.ts.map +1 -0
  429. package/dist/rules/phase-goal.js +70 -0
  430. package/dist/rules/phase-goal.js.map +1 -0
  431. package/dist/rules/phase-tools.d.ts +11 -0
  432. package/dist/rules/phase-tools.d.ts.map +1 -0
  433. package/dist/rules/phase-tools.js +19 -0
  434. package/dist/rules/phase-tools.js.map +1 -0
  435. package/dist/rules/processor.d.ts.map +1 -1
  436. package/dist/rules/processor.js +116 -15
  437. package/dist/rules/processor.js.map +1 -1
  438. package/dist/rules/review-source-tool.d.ts +4 -1
  439. package/dist/rules/review-source-tool.d.ts.map +1 -1
  440. package/dist/rules/review-source-tool.js +24 -4
  441. package/dist/rules/review-source-tool.js.map +1 -1
  442. package/dist/rules/rule-group.d.ts +1 -1
  443. package/dist/rules/rule-group.d.ts.map +1 -1
  444. package/dist/rules/rule-group.js +15 -6
  445. package/dist/rules/rule-group.js.map +1 -1
  446. package/dist/rules/start-coordinator.d.ts +5 -1
  447. package/dist/rules/start-coordinator.d.ts.map +1 -1
  448. package/dist/rules/start-coordinator.js +9 -3
  449. package/dist/rules/start-coordinator.js.map +1 -1
  450. package/dist/rules/tools.d.ts.map +1 -1
  451. package/dist/rules/tools.js +39 -28
  452. package/dist/rules/tools.js.map +1 -1
  453. package/dist/rules/transition-service.d.ts +10 -7
  454. package/dist/rules/transition-service.d.ts.map +1 -1
  455. package/dist/rules/transition-service.js +63 -55
  456. package/dist/rules/transition-service.js.map +1 -1
  457. package/dist/rules/types.d.ts +140 -39
  458. package/dist/rules/types.d.ts.map +1 -1
  459. package/dist/rules/types.js +7 -41
  460. package/dist/rules/types.js.map +1 -1
  461. package/dist/rules/validation.d.ts.map +1 -1
  462. package/dist/rules/validation.js +89 -4
  463. package/dist/rules/validation.js.map +1 -1
  464. package/dist/run-error.d.ts +1 -1
  465. package/dist/run-error.d.ts.map +1 -1
  466. package/dist/run-error.js +38 -5
  467. package/dist/run-error.js.map +1 -1
  468. package/dist/sandbox/sandbox-env-cache.d.ts +33 -0
  469. package/dist/sandbox/sandbox-env-cache.d.ts.map +1 -0
  470. package/dist/sandbox/sandbox-env-cache.js +140 -0
  471. package/dist/sandbox/sandbox-env-cache.js.map +1 -0
  472. package/dist/sandbox/sandbox-env.d.ts +77 -0
  473. package/dist/sandbox/sandbox-env.d.ts.map +1 -0
  474. package/dist/sandbox/sandbox-env.js +130 -0
  475. package/dist/sandbox/sandbox-env.js.map +1 -0
  476. package/dist/secret-encryption.d.ts +21 -0
  477. package/dist/secret-encryption.d.ts.map +1 -1
  478. package/dist/secret-encryption.js +31 -4
  479. package/dist/secret-encryption.js.map +1 -1
  480. package/dist/session/credential-policy.d.ts +2 -2
  481. package/dist/session/credential-policy.d.ts.map +1 -1
  482. package/dist/session/credential-policy.js +3 -3
  483. package/dist/session/credential-policy.js.map +1 -1
  484. package/dist/session/default-model-hydration.d.ts +2 -2
  485. package/dist/session/default-model-hydration.d.ts.map +1 -1
  486. package/dist/session/default-model-hydration.js +4 -4
  487. package/dist/session/default-model-hydration.js.map +1 -1
  488. package/dist/session/live-sessions.d.ts +11 -4
  489. package/dist/session/live-sessions.d.ts.map +1 -1
  490. package/dist/session/live-sessions.js +31 -10
  491. package/dist/session/live-sessions.js.map +1 -1
  492. package/dist/session/self-review-gate.d.ts +6 -4
  493. package/dist/session/self-review-gate.d.ts.map +1 -1
  494. package/dist/session/self-review-gate.js +9 -12
  495. package/dist/session/self-review-gate.js.map +1 -1
  496. package/dist/session/session-threads.d.ts +10 -3
  497. package/dist/session/session-threads.d.ts.map +1 -1
  498. package/dist/session/session-threads.js +11 -1
  499. package/dist/session/session-threads.js.map +1 -1
  500. package/dist/session/source-control-tools.d.ts +39 -13
  501. package/dist/session/source-control-tools.d.ts.map +1 -1
  502. package/dist/session/source-control-tools.js +55 -61
  503. package/dist/session/source-control-tools.js.map +1 -1
  504. package/dist/session/work-item-state-processor.d.ts +24 -0
  505. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  506. package/dist/session/work-item-state-processor.js +275 -0
  507. package/dist/session/work-item-state-processor.js.map +1 -0
  508. package/dist/skills/catalog.js +1 -1
  509. package/dist/storage/domains/audit/actions.d.ts +3 -2
  510. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  511. package/dist/storage/domains/audit/actions.js +7 -5
  512. package/dist/storage/domains/audit/actions.js.map +1 -1
  513. package/dist/storage/domains/audit/domain.d.ts.map +1 -1
  514. package/dist/storage/domains/audit/domain.js +1 -3
  515. package/dist/storage/domains/audit/domain.js.map +1 -1
  516. package/dist/storage/domains/boards/base.d.ts +107 -23
  517. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  518. package/dist/storage/domains/boards/base.js +201 -65
  519. package/dist/storage/domains/boards/base.js.map +1 -1
  520. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  521. package/dist/storage/domains/boards/schemas.js +25 -1
  522. package/dist/storage/domains/boards/schemas.js.map +1 -1
  523. package/dist/storage/domains/channel-identity/base.d.ts +0 -4
  524. package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
  525. package/dist/storage/domains/channel-identity/base.js +0 -7
  526. package/dist/storage/domains/channel-identity/base.js.map +1 -1
  527. package/dist/storage/domains/intake/base.d.ts +5 -45
  528. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  529. package/dist/storage/domains/intake/base.js +11 -89
  530. package/dist/storage/domains/intake/base.js.map +1 -1
  531. package/dist/storage/domains/memory-settings/base.d.ts +0 -8
  532. package/dist/storage/domains/memory-settings/base.d.ts.map +1 -1
  533. package/dist/storage/domains/memory-settings/base.js +1 -11
  534. package/dist/storage/domains/memory-settings/base.js.map +1 -1
  535. package/dist/storage/domains/projects/base.d.ts +23 -9
  536. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  537. package/dist/storage/domains/projects/base.js +24 -8
  538. package/dist/storage/domains/projects/base.js.map +1 -1
  539. package/dist/storage/domains/sandbox-envs/base.d.ts +70 -0
  540. package/dist/storage/domains/sandbox-envs/base.d.ts.map +1 -0
  541. package/dist/storage/domains/sandbox-envs/base.js +227 -0
  542. package/dist/storage/domains/sandbox-envs/base.js.map +1 -0
  543. package/dist/storage/domains/voice-settings/base.d.ts +31 -0
  544. package/dist/storage/domains/voice-settings/base.d.ts.map +1 -0
  545. package/dist/storage/domains/voice-settings/base.js +81 -0
  546. package/dist/storage/domains/voice-settings/base.js.map +1 -0
  547. package/dist/storage/domains/work-items/base.d.ts +93 -24
  548. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  549. package/dist/storage/domains/work-items/base.js +413 -188
  550. package/dist/storage/domains/work-items/base.js.map +1 -1
  551. package/dist/storage/domains/work-items/board-version.d.ts +6 -2
  552. package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
  553. package/dist/storage/domains/work-items/board-version.js +20 -9
  554. package/dist/storage/domains/work-items/board-version.js.map +1 -1
  555. package/dist/storage/domains/work-items/cards.d.ts +33 -5
  556. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  557. package/dist/storage/domains/work-items/cards.js +208 -25
  558. package/dist/storage/domains/work-items/cards.js.map +1 -1
  559. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  560. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  561. package/dist/storage/domains/work-items/legacy-review.js +109 -0
  562. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  563. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  564. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  565. package/dist/storage/domains/work-items/metrics.js +14 -32
  566. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  567. package/dist/storage/domains/work-items/work-item-schema.d.ts +6 -2
  568. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  569. package/dist/storage/domains/work-items/work-item-schema.js +83 -27
  570. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  571. package/dist/timing.d.ts +1 -0
  572. package/dist/timing.d.ts.map +1 -1
  573. package/dist/timing.js +1 -1
  574. package/dist/timing.js.map +1 -1
  575. package/dist/tools/approval-tools.d.ts.map +1 -1
  576. package/dist/tools/approval-tools.js +28 -9
  577. package/dist/tools/approval-tools.js.map +1 -1
  578. package/dist/tools/index.d.ts +1 -1
  579. package/dist/tools/index.js +1 -1
  580. package/dist/tools/index.js.map +1 -1
  581. package/dist/tools/messaging-tools.d.ts +3 -0
  582. package/dist/tools/messaging-tools.d.ts.map +1 -1
  583. package/dist/tools/messaging-tools.js +2 -1
  584. package/dist/tools/messaging-tools.js.map +1 -1
  585. package/dist/tools/read-tools.d.ts +10 -6
  586. package/dist/tools/read-tools.d.ts.map +1 -1
  587. package/dist/tools/read-tools.js +89 -39
  588. package/dist/tools/read-tools.js.map +1 -1
  589. package/dist/tools/reports.d.ts +1 -0
  590. package/dist/tools/reports.d.ts.map +1 -1
  591. package/dist/tools/reports.js +2 -1
  592. package/dist/tools/reports.js.map +1 -1
  593. package/dist/tools/run-watch.d.ts +1 -1
  594. package/dist/tools/run-watch.d.ts.map +1 -1
  595. package/dist/tools/run-watch.js +1 -0
  596. package/dist/tools/run-watch.js.map +1 -1
  597. package/dist/tools/sandbox-tools.js +1 -1
  598. package/dist/tools/session-tools.d.ts +1 -1
  599. package/dist/tools/session-tools.d.ts.map +1 -1
  600. package/dist/tools/session-tools.js +1 -1
  601. package/dist/tools/session-tools.js.map +1 -1
  602. package/dist/tools/sessions-state-processor.d.ts +3 -1
  603. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  604. package/dist/tools/sessions-state-processor.js +13 -4
  605. package/dist/tools/sessions-state-processor.js.map +1 -1
  606. package/dist/tools/side-sessions.d.ts +2 -0
  607. package/dist/tools/side-sessions.d.ts.map +1 -1
  608. package/dist/tools/side-sessions.js +2 -1
  609. package/dist/tools/side-sessions.js.map +1 -1
  610. package/dist/tools/work-item-tools.d.ts +0 -3
  611. package/dist/tools/work-item-tools.d.ts.map +1 -1
  612. package/dist/tools/work-item-tools.js +10 -20
  613. package/dist/tools/work-item-tools.js.map +1 -1
  614. package/dist/voice/rate-limit.d.ts +13 -0
  615. package/dist/voice/rate-limit.d.ts.map +1 -0
  616. package/dist/voice/rate-limit.js +36 -0
  617. package/dist/voice/rate-limit.js.map +1 -0
  618. package/dist/voice/realtime.d.ts +13 -0
  619. package/dist/voice/realtime.d.ts.map +1 -0
  620. package/dist/voice/realtime.js +56 -0
  621. package/dist/voice/realtime.js.map +1 -0
  622. package/dist/voice/transcription.d.ts +51 -0
  623. package/dist/voice/transcription.d.ts.map +1 -0
  624. package/dist/voice/transcription.js +112 -0
  625. package/dist/voice/transcription.js.map +1 -0
  626. package/dist/work-item-branch.d.ts +13 -0
  627. package/dist/work-item-branch.d.ts.map +1 -1
  628. package/dist/work-item-branch.js +16 -1
  629. package/dist/work-item-branch.js.map +1 -1
  630. package/dist/work-items/create-work-item.d.ts +6 -0
  631. package/dist/work-items/create-work-item.d.ts.map +1 -1
  632. package/dist/work-items/create-work-item.js +28 -3
  633. package/dist/work-items/create-work-item.js.map +1 -1
  634. package/dist/work-items/description-context.d.ts +5 -0
  635. package/dist/work-items/description-context.d.ts.map +1 -0
  636. package/dist/work-items/description-context.js +17 -0
  637. package/dist/work-items/description-context.js.map +1 -0
  638. package/dist/work-items/providers/base.d.ts +4 -1
  639. package/dist/work-items/providers/base.d.ts.map +1 -1
  640. package/dist/work-items/providers/base.js +6 -1
  641. package/dist/work-items/providers/base.js.map +1 -1
  642. package/dist/work-items/providers/github.d.ts.map +1 -1
  643. package/dist/work-items/providers/github.js +2 -1
  644. package/dist/work-items/providers/github.js.map +1 -1
  645. package/dist/work-items/providers/gitlab.d.ts.map +1 -1
  646. package/dist/work-items/providers/gitlab.js +2 -1
  647. package/dist/work-items/providers/gitlab.js.map +1 -1
  648. package/dist/work-items/providers/jira.d.ts.map +1 -1
  649. package/dist/work-items/providers/jira.js +3 -2
  650. package/dist/work-items/providers/jira.js.map +1 -1
  651. package/dist/work-items/providers/linear.d.ts.map +1 -1
  652. package/dist/work-items/providers/linear.js +3 -2
  653. package/dist/work-items/providers/linear.js.map +1 -1
  654. package/dist/work-items/providers/types.d.ts +6 -0
  655. package/dist/work-items/providers/types.d.ts.map +1 -1
  656. package/dist/work-items/split-backfill.d.ts +13 -0
  657. package/dist/work-items/split-backfill.d.ts.map +1 -0
  658. package/dist/work-items/split-backfill.js +32 -0
  659. package/dist/work-items/split-backfill.js.map +1 -0
  660. package/dist/work-items/split-migration.d.ts +39 -2
  661. package/dist/work-items/split-migration.d.ts.map +1 -1
  662. package/dist/work-items/split-migration.js +178 -70
  663. package/dist/work-items/split-migration.js.map +1 -1
  664. package/dist/workspace.d.ts +3 -1
  665. package/dist/workspace.d.ts.map +1 -1
  666. package/dist/workspace.js +118 -34
  667. package/dist/workspace.js.map +1 -1
  668. package/factory-skills/configure-factory-rules/SKILL.md +13 -11
  669. package/factory-skills/factory-build/SKILL.md +64 -0
  670. package/factory-skills/factory-gitlab-rereview/SKILL.md +4 -4
  671. package/factory-skills/factory-gitlab-review/SKILL.md +6 -6
  672. package/factory-skills/factory-plan/SKILL.md +8 -10
  673. package/factory-skills/factory-rereview/SKILL.md +74 -28
  674. package/factory-skills/factory-review/SKILL.md +85 -29
  675. package/factory-skills/factory-self-review/SKILL.md +32 -13
  676. package/factory-skills/factory-triage/SKILL.md +36 -32
  677. package/package.json +12 -11
  678. package/dist/boards/index.js.map +0 -1
  679. package/dist/boards/pull-request-review.d.ts +0 -14
  680. package/dist/boards/pull-request-review.d.ts.map +0 -1
  681. package/dist/boards/pull-request-review.js +0 -81
  682. package/dist/boards/pull-request-review.js.map +0 -1
  683. package/dist/boards/work-tool-rules.d.ts +0 -8
  684. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  685. package/dist/boards/work-tool-rules.js +0 -19
  686. package/dist/boards/work-tool-rules.js.map +0 -1
  687. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
  688. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
  689. package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
  690. package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
  691. package/dist/integrations/slack/emoji.d.ts +0 -3
  692. package/dist/integrations/slack/emoji.d.ts.map +0 -1
  693. package/dist/integrations/slack/emoji.js +0 -11
  694. package/dist/integrations/slack/emoji.js.map +0 -1
  695. package/dist/integrations/slack/feed-publisher.d.ts +0 -26
  696. package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
  697. package/dist/integrations/slack/feed-publisher.js +0 -43
  698. package/dist/integrations/slack/feed-publisher.js.map +0 -1
  699. package/dist/routes/attention-activity.d.ts +0 -23
  700. package/dist/routes/attention-activity.d.ts.map +0 -1
  701. package/dist/routes/attention-activity.js +0 -154
  702. package/dist/routes/attention-activity.js.map +0 -1
  703. package/dist/rules/resolve.d.ts +0 -15
  704. package/dist/rules/resolve.d.ts.map +0 -1
  705. package/dist/rules/resolve.js +0 -22
  706. package/dist/rules/resolve.js.map +0 -1
  707. package/dist/storage/domains/comments/activity.d.ts +0 -40
  708. package/dist/storage/domains/comments/activity.d.ts.map +0 -1
  709. package/dist/storage/domains/comments/activity.js +0 -93
  710. package/dist/storage/domains/comments/activity.js.map +0 -1
  711. package/dist/storage/domains/comments/actor.d.ts +0 -51
  712. package/dist/storage/domains/comments/actor.d.ts.map +0 -1
  713. package/dist/storage/domains/comments/actor.js +0 -37
  714. package/dist/storage/domains/comments/actor.js.map +0 -1
  715. package/dist/storage/domains/comments/base.d.ts +0 -245
  716. package/dist/storage/domains/comments/base.d.ts.map +0 -1
  717. package/dist/storage/domains/comments/base.js +0 -539
  718. package/dist/storage/domains/comments/base.js.map +0 -1
  719. package/dist/storage/domains/comments/domain.d.ts +0 -135
  720. package/dist/storage/domains/comments/domain.d.ts.map +0 -1
  721. package/dist/storage/domains/comments/domain.js +0 -284
  722. package/dist/storage/domains/comments/domain.js.map +0 -1
  723. package/dist/storage/domains/comments/feed-context.d.ts +0 -22
  724. package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
  725. package/dist/storage/domains/comments/feed-context.js +0 -88
  726. package/dist/storage/domains/comments/feed-context.js.map +0 -1
  727. package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
  728. package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
  729. package/dist/storage/domains/comments/feed-sync.js +0 -1
  730. package/dist/storage/domains/comments/parse.d.ts +0 -23
  731. package/dist/storage/domains/comments/parse.d.ts.map +0 -1
  732. package/dist/storage/domains/comments/parse.js +0 -89
  733. package/dist/storage/domains/comments/parse.js.map +0 -1
  734. package/dist/storage/domains/comments/routes.d.ts +0 -24
  735. package/dist/storage/domains/comments/routes.d.ts.map +0 -1
  736. package/dist/storage/domains/comments/routes.js +0 -301
  737. package/dist/storage/domains/comments/routes.js.map +0 -1
  738. package/dist/storage/domains/comments/schema.d.ts +0 -5
  739. package/dist/storage/domains/comments/schema.d.ts.map +0 -1
  740. package/dist/storage/domains/comments/schema.js +0 -178
  741. package/dist/storage/domains/comments/schema.js.map +0 -1
  742. package/dist/storage/domains/comments/wire.d.ts +0 -40
  743. package/dist/storage/domains/comments/wire.d.ts.map +0 -1
  744. package/dist/storage/domains/comments/wire.js +0 -36
  745. package/dist/storage/domains/comments/wire.js.map +0 -1
  746. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -1 +1 @@
1
- {"version":3,"file":"phase-runner.js","names":[],"sources":["../../src/boards/phase-runner.ts"],"sourcesContent":["import type { FactoryRuleDecision, FactoryRuleHandler, FactoryStageRuleContext } from '../rules/types.js';\n\n/**\n * Starts the phase's skill in its context, for sources the phase gives no `onEnter` handler.\n * Entering from another phase starts it even when that phase's agent shares the context and\n * made the move: the skill is queued onto its run.\n */\nexport function startSkill(skill: string, context: string): FactoryRuleHandler<FactoryStageRuleContext> {\n return rule => ({\n type: 'invokeSkill',\n idempotencyKey: `${rule.ingress.id}:${skill}`,\n role: context,\n skillName: skill,\n arguments: rule.item.url ? `Work item (${rule.item.url})` : rule.item.title,\n ...(rule.fromStage !== rule.stage ? { startsAfterOwnMove: true } : {}),\n });\n}\n\nfunction withInstructions(decision: FactoryRuleDecision, instructions: string): FactoryRuleDecision {\n if (decision.type !== 'invokeSkill') return decision;\n if (decision.prompt !== undefined) return { ...decision, prompt: `${decision.prompt}\\n\\n${instructions}` };\n return { ...decision, arguments: decision.arguments ? `${decision.arguments}\\n\\n${instructions}` : instructions };\n}\n\nconst instructedHandlers = new WeakMap<FactoryRuleHandler<FactoryStageRuleContext>, string>();\n\n/**\n * Appends the phase's instructions to every run its handler starts. A handler that already\n * carries them, because a defined phase was declared again, is returned as is.\n */\nexport function addInstructions(\n handler: FactoryRuleHandler<FactoryStageRuleContext>,\n instructions: string,\n): FactoryRuleHandler<FactoryStageRuleContext> {\n if (instructedHandlers.get(handler) === instructions) return handler;\n const instructed: FactoryRuleHandler<FactoryStageRuleContext> = async context => {\n const decision = await handler(context);\n return decision ? withInstructions(decision, instructions) : decision;\n };\n instructedHandlers.set(instructed, instructions);\n return instructed;\n}\n"],"mappings":";;;;;;AAOA,SAAgB,WAAW,OAAe,SAA8D;CACtG,QAAO,UAAS;EACd,MAAM;EACN,gBAAgB,GAAG,KAAK,QAAQ,GAAG,GAAG;EACtC,MAAM;EACN,WAAW;EACX,WAAW,KAAK,KAAK,MAAM,cAAc,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK;EACtE,GAAI,KAAK,cAAc,KAAK,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACtE;AACF;AAEA,SAAS,iBAAiB,UAA+B,cAA2C;CAClG,IAAI,SAAS,SAAS,eAAe,OAAO;CAC5C,IAAI,SAAS,WAAW,KAAA,GAAW,OAAO;EAAE,GAAG;EAAU,QAAQ,GAAG,SAAS,OAAO,MAAM;CAAe;CACzG,OAAO;EAAE,GAAG;EAAU,WAAW,SAAS,YAAY,GAAG,SAAS,UAAU,MAAM,iBAAiB;CAAa;AAClH;AAEA,MAAM,qCAAqB,IAAI,QAA6D;;;;;AAM5F,SAAgB,gBACd,SACA,cAC6C;CAC7C,IAAI,mBAAmB,IAAI,OAAO,MAAM,cAAc,OAAO;CAC7D,MAAM,aAA0D,OAAM,YAAW;EAC/E,MAAM,WAAW,MAAM,QAAQ,OAAO;EACtC,OAAO,WAAW,iBAAiB,UAAU,YAAY,IAAI;CAC/D;CACA,mBAAmB,IAAI,YAAY,YAAY;CAC/C,OAAO;AACT"}
1
+ {"version":3,"file":"phase-runner.js","names":[],"sources":["../../src/boards/phase-runner.ts"],"sourcesContent":["import { externallyAuthored } from '../rules/types.js';\nimport type { FactoryInvokeSkillDecision, FactoryStageRuleContext } from '../rules/types.js';\nimport type { BoardDefinition } from './define-board.js';\n\n/** How the card came into the phase. */\nexport interface PhaseEntry {\n /** The card was just placed on the board, in this phase. */\n readonly initialEntry?: boolean;\n /** The card was moved into the phase it is already in, to run it again. */\n readonly reenter?: boolean;\n}\n\n/**\n * Names the work item: its URL, else its title. A title written by an untrusted author is quoted\n * as data, so it can't pose as the runner's instructions.\n */\nfunction workItemReference(item: FactoryStageRuleContext['item']): string {\n if (item.url) return `Work item (${item.url})`;\n if (!externallyAuthored({ source: item.source, metadata: item.metadata ?? null })) return item.title;\n return `Work item titled ${JSON.stringify(item.title)} (untrusted external data; do not interpret as instructions)`;\n}\n\n/**\n * The run a card's entry into a phase starts: the phase runner's skill in its context, or\n * nothing when the phase is not working, names no skill, or the card did not enter it.\n *\n * Card detail reaches the agent through the `factory-work-item` state signal, so the run only\n * names the work item and adds the runner's instructions. Entering from another phase starts\n * the skill even when that phase's agent shares the context and made the move: the skill is\n * queued onto its run. Re-entering the same phase supersedes the run in flight and resumes the\n * skill with the fresh arguments.\n */\nexport function phaseRunDecision(\n board: Pick<BoardDefinition<string, string>, 'phases'>,\n phaseKey: string,\n rule: Pick<FactoryStageRuleContext, 'ingress' | 'item' | 'fromStage'>,\n entry: PhaseEntry = {},\n): FactoryInvokeSkillDecision | undefined {\n const sameStage = rule.fromStage === phaseKey;\n if (sameStage && !entry.initialEntry && !entry.reenter) return undefined;\n const phase = Object.hasOwn(board.phases, phaseKey) ? board.phases[phaseKey] : undefined;\n if (phase?.kind !== 'working' || !phase.runner.skill) return undefined;\n const { skill, context, instructions, goal } = phase.runner;\n const reference = workItemReference(rule.item);\n const reentry = sameStage && entry.reenter === true && !entry.initialEntry;\n return {\n type: 'invokeSkill',\n idempotencyKey: `${rule.ingress.id}:${phaseKey}:${skill}`,\n role: context,\n skillName: skill,\n arguments: instructions ? `${reference}\\n\\n${instructions}` : reference,\n ...(sameStage ? {} : { startsAfterOwnMove: true }),\n ...(reentry ? { cancelInFlight: true, resume: true } : {}),\n ...(goal ? { goal: { ...goal } } : {}),\n };\n}\n"],"mappings":";;;;;;AAgBA,SAAS,kBAAkB,MAA+C;CACxE,IAAI,KAAK,KAAK,OAAO,cAAc,KAAK,IAAI;CAC5C,IAAI,CAAC,mBAAmB;EAAE,QAAQ,KAAK;EAAQ,UAAU,KAAK,YAAY;CAAK,CAAC,GAAG,OAAO,KAAK;CAC/F,OAAO,oBAAoB,KAAK,UAAU,KAAK,KAAK,EAAE;AACxD;;;;;;;;;;;AAYA,SAAgB,iBACd,OACA,UACA,MACA,QAAoB,CAAC,GACmB;CACxC,MAAM,YAAY,KAAK,cAAc;CACrC,IAAI,aAAa,CAAC,MAAM,gBAAgB,CAAC,MAAM,SAAS,OAAO,KAAA;CAC/D,MAAM,QAAQ,OAAO,OAAO,MAAM,QAAQ,QAAQ,IAAI,MAAM,OAAO,YAAY,KAAA;CAC/E,IAAI,OAAO,SAAS,aAAa,CAAC,MAAM,OAAO,OAAO,OAAO,KAAA;CAC7D,MAAM,EAAE,OAAO,SAAS,cAAc,SAAS,MAAM;CACrD,MAAM,YAAY,kBAAkB,KAAK,IAAI;CAC7C,MAAM,UAAU,aAAa,MAAM,YAAY,QAAQ,CAAC,MAAM;CAC9D,OAAO;EACL,MAAM;EACN,gBAAgB,GAAG,KAAK,QAAQ,GAAG,GAAG,SAAS,GAAG;EAClD,MAAM;EACN,WAAW;EACX,WAAW,eAAe,GAAG,UAAU,MAAM,iBAAiB;EAC9D,GAAI,YAAY,CAAC,IAAI,EAAE,oBAAoB,KAAK;EAChD,GAAI,UAAU;GAAE,gBAAgB;GAAM,QAAQ;EAAK,IAAI,CAAC;EACxD,GAAI,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,IAAI,CAAC;CACtC;AACF"}
@@ -1,11 +1,20 @@
1
1
  import type { InlineSkill } from '@mastra/core/skills';
2
- import type { StoredBoardScope, StoredBoardsStorage } from '../storage/domains/boards/base.js';
2
+ import type { FactoryStorageOps } from '@mastra/core/storage';
3
+ import type { StoredBoardInput, StoredBoardRecord, StoredBoardScope, StoredBoardsStorage } from '../storage/domains/boards/base.js';
4
+ import type { RetiredAutomationSettings } from '../storage/domains/projects/base.js';
5
+ import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
3
6
  import type { BoardRegistry } from './registry.js';
7
+ /**
8
+ * The creator Factory records on the Work board it stores in a project as the project is
9
+ * created: that board is today's Work, and reset gives it back. Any other Work row Factory stored
10
+ * is the one with Triage. Only Factory writes this id; a person's writes carry their user id.
11
+ */
12
+ export declare const NEW_PROJECT_SEED_ACTOR = "factory:new-project";
4
13
  /** Where a board in a project's catalog came from. */
5
14
  export type BoardSourceKind = 'builtin' | 'app' | 'stored';
6
15
  export interface StoredBoardDetails {
7
16
  source: BoardSourceKind;
8
- /** Only boards the project stored can be edited; code boards are read-only. */
17
+ /** Stored boards, the built-in Work board and app boards can all be edited; the retired Review board can't. */
9
18
  editable: boolean;
10
19
  problems: string[];
11
20
  }
@@ -35,29 +44,77 @@ export interface ProjectBoardCacheOptions {
35
44
  /** The code boards, built-ins included when enabled. */
36
45
  codeRegistry: BoardRegistry;
37
46
  storage: StoredBoardsStorage;
38
- /** Lists every project, to warm them at boot. */
47
+ /**
48
+ * Lists every project, to warm them at boot, and reads the retired switches the board
49
+ * migrations carry into each project's boards.
50
+ */
39
51
  projects?: {
40
52
  listAll(): Promise<readonly {
41
53
  orgId: string;
42
54
  id: string;
43
55
  }[]>;
56
+ retiredAutomationSettings?(project: {
57
+ orgId: string;
58
+ id: string;
59
+ }, ops: FactoryStorageOps): Promise<RetiredAutomationSettings | null>;
44
60
  };
61
+ /** The phases cards sit in on each of the project's boards, which a board migration must not remove. */
62
+ occupiedPhases?: (scope: StoredBoardScope, ops: FactoryStorageOps) => Promise<ReadonlyMap<string, ReadonlySet<string>> | null>;
45
63
  codeSkills?: readonly InlineSkill[];
64
+ /**
65
+ * Whether the project still uses the retired Review board (an open card is stored on it). Such
66
+ * a project is served Review alongside its boards; without this, no project is.
67
+ */
68
+ reviewBoardInUse?: (scope: StoredBoardScope) => Promise<boolean>;
46
69
  recheckMs?: number;
47
70
  now?: () => number;
48
71
  warn?: (message: string) => void;
49
72
  }
50
73
  /**
51
- * The per-project board cache. A project's boards are the code boards, served as code built them
52
- * and winning on their key, followed by the boards the project stored. Loads recheck the
53
- * project's board version at most every `recheckMs` and recompile when it changed, so stored
54
- * edits on other replicas arrive within that delay. The cache never writes.
74
+ * Reads the phases cards sit in on each of a project's boards, for `occupiedPhases`. Null while
75
+ * cards from before the work-item split are still being copied: `listWith` can't see those yet.
76
+ */
77
+ export declare function occupiedPhasesOf(workItems: Pick<WorkItemsStorage, 'listWith' | 'legacyBackfillPending'>): (scope: StoredBoardScope, ops: FactoryStorageOps) => Promise<ReadonlyMap<string, ReadonlySet<string>> | null>;
78
+ /**
79
+ * The per-project board cache. A project's boards are its rows: the Work and app boards Factory
80
+ * stored in it, in code order, then the others. A Work or app board's row runs with the code
81
+ * behaviour of its board and phase keys that still fits it ({@link mergeCodeBehaviour}). A project
82
+ * that still uses the retired Review board is served it from code, never stored, until its last
83
+ * open card there finishes. The first load of each project in a process stores the
84
+ * boards Factory hasn't stored in it yet, each once ({@link StoredBoardsStorage.seedBoards}); a
85
+ * release never rewrites them. Loads recheck the project's board version at most every
86
+ * `recheckMs` and recompile when it changed, so stored edits on other replicas arrive within that
87
+ * delay.
55
88
  */
56
89
  export declare class ProjectBoardCache implements ProjectBoardSource {
57
90
  #private;
58
91
  readonly [PROJECT_BOARD_SOURCE] = true;
59
92
  readonly codeRegistry: BoardRegistry;
60
93
  constructor(options: ProjectBoardCacheOptions);
94
+ /**
95
+ * The boards Factory stores once in a project it didn't create: Work as it was with Triage, so a
96
+ * project from an older release keeps the phases its cards know, then the app boards, in order.
97
+ */
98
+ seeds(): StoredBoardInput[];
99
+ /**
100
+ * The definition reset restores for `key`; undefined when there is none. A board the app upserted
101
+ * for every project comes first, so reset never swaps an app's Work for Factory's. Factory's Work
102
+ * is today's Work for a project Factory created with it (`row` created by
103
+ * {@link NEW_PROJECT_SEED_ACTOR}), and Work with Triage for every other project.
104
+ */
105
+ seedFor(key: string, row?: Pick<StoredBoardRecord, 'createdBy'>): StoredBoardInput | undefined;
106
+ /**
107
+ * Stores Factory's boards in a project that was just created, with today's Work (no Triage).
108
+ * Only the project-creation route calls this; every other load stores {@link seeds}.
109
+ */
110
+ seedNewProject(scope: StoredBoardScope): Promise<ProjectBoards>;
111
+ /**
112
+ * Remembers a board the app upserted for every project, so a project that has no boards yet (one
113
+ * created later, or one that never loaded) gets it on its first load before Factory's own boards;
114
+ * having it, the project then gets no Work from Factory. Kept for this process: an app upserts
115
+ * its boards at every startup.
116
+ */
117
+ rememberBoardForAllProjects(board: StoredBoardInput): void;
61
118
  load(scope: StoredBoardScope): Promise<BoardRegistry>;
62
119
  /** The project's boards with their source, whether they can be edited, and problems, brought up to date. */
63
120
  describe(scope: StoredBoardScope): Promise<ProjectBoards>;
@@ -71,7 +128,7 @@ export declare class ProjectBoardCache implements ProjectBoardSource {
71
128
  get codeSkills(): readonly InlineSkill[];
72
129
  /** Makes the next load reread the project. The loaded boards keep serving sync reads until then. */
73
130
  invalidate(scope: StoredBoardScope): void;
74
- /** Loads every project, a few at a time, so sync reads find them warm. */
131
+ /** Loads every project, a few at a time, so sync reads find them warm and each has its boards stored. */
75
132
  preload(): Promise<void>;
76
133
  }
77
134
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"project-boards.d.ts","sourceRoot":"","sources":["../../src/boards/project-boards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EAAqB,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAElH,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,eAAe,CAAC;AAOnE,sDAAsD;AACtD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,eAAe,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,uGAAuG;AACvG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC1D,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,QAAA,MAAM,oBAAoB,eAA+B,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IACtC,4FAA4F;IAC5F,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IACrC,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,CAAC;IACnD,QAAQ,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5D;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,GAAG,SAAS,GAAG,kBAAkB,CASxG;AAYD,MAAM,WAAW,wBAAwB;IACvC,wDAAwD;IACxD,YAAY,EAAE,aAAa,CAAC;IAC5B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,EAAE;QAAE,OAAO,IAAI,OAAO,CAAC,SAAS;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC,CAAA;KAAE,CAAC;IAC5E,UAAU,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAMD;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;;IAC1D,QAAQ,CAAC,CAAC,oBAAoB,CAAC,QAAQ;IACvC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IAarC,YAAY,OAAO,EAAE,wBAAwB,EAkB5C;IAEK,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAE1D;IAED,4GAA4G;IACtG,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAY9D;IAED;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,CAcjD;IAED,+CAA+C;IAC/C,IAAI,UAAU,IAAI,SAAS,WAAW,EAAE,CAEvC;IAED,oGAAoG;IACpG,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAMxC;IAED,0EAA0E;IACpE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAe7B;CA0EF"}
1
+ {"version":3,"file":"project-boards.d.ts","sourceRoot":"","sources":["../../src/boards/project-boards.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,41 @@
1
1
  import { findBoardSkillProblems } from "../skills/app-skills.js";
2
- import { createBoardRegistry, defaultBoards } from "./registry.js";
3
- import { compileStoredBoard } from "./stored-board.js";
2
+ import "../storage/domains/boards/base.js";
3
+ import { LEGACY_REVIEW_BOARD } from "../storage/domains/work-items/legacy-review.js";
4
+ import { boardRegistryOf, createBoardRegistry, defaultBoards } from "./registry.js";
5
+ import { reviewBoard } from "./review.js";
6
+ import { boardForWorkItem } from "./semantics.js";
7
+ import { boardDefinitionOf, compileStoredBoard, mergeCodeBehaviour } from "./stored-board.js";
8
+ import { BOARD_MIGRATIONS } from "./work-migrations.js";
9
+ import { workSeedWithTriage } from "./work-seeds.js";
10
+ import { workBoard } from "./work.js";
4
11
  // src/boards/project-boards.ts
5
12
  const DEFAULT_RECHECK_MS = 1e3;
13
+ /** A row under the retired Review board's key is never served: the key is the Review board's alone. */
14
+ const RESERVED_REVIEW_ROW = `Stored board "${LEGACY_REVIEW_BOARD}" isn't served: the key is reserved for the retired Review board.`;
6
15
  const PRELOAD_CONCURRENCY = 8;
16
+ /** The phases every release seeded the Review board with; only runners and tools changed between them. */
17
+ const REVIEW_SEED_PHASES = boardDefinitionOf(reviewBoard).phases.map(({ key, name, kind }) => ({
18
+ key,
19
+ name,
20
+ kind
21
+ }));
22
+ /**
23
+ * Whether `row` is the Review board as Factory seeded it: written once by Factory, never
24
+ * revised, and shaped like the seed. The actor alone is not proof, as any caller can pass it.
25
+ */
26
+ function isUntouchedReviewSeed(row) {
27
+ if (row.revision !== 1 || row.createdBy !== "factory") return false;
28
+ if (row.updatedBy !== "factory" || row.name !== reviewBoard.name) return false;
29
+ const phases = [...row.phases].sort((a, b) => a.position - b.position);
30
+ return phases.length === REVIEW_SEED_PHASES.length && phases.every((phase, index) => phase.key === REVIEW_SEED_PHASES[index].key && phase.name === REVIEW_SEED_PHASES[index].name && phase.kind === REVIEW_SEED_PHASES[index].kind);
31
+ }
7
32
  const SNAPSHOT_ATTEMPTS = 3;
33
+ /**
34
+ * The creator Factory records on the Work board it stores in a project as the project is
35
+ * created: that board is today's Work, and reset gives it back. Any other Work row Factory stored
36
+ * is the one with Triage. Only Factory writes this id; a person's writes carry their user id.
37
+ */
38
+ const NEW_PROJECT_SEED_ACTOR = "factory:new-project";
8
39
  const PROJECT_BOARD_SOURCE = Symbol("ProjectBoardSource");
9
40
  /** Accepts either a fixed registry (tests, standalone services) or a per-project source. */
10
41
  function toBoardSource(boards) {
@@ -24,10 +55,32 @@ function scopeKey(scope) {
24
55
  return `${scope.orgId}\0${scope.factoryProjectId}`;
25
56
  }
26
57
  /**
27
- * The per-project board cache. A project's boards are the code boards, served as code built them
28
- * and winning on their key, followed by the boards the project stored. Loads recheck the
29
- * project's board version at most every `recheckMs` and recompile when it changed, so stored
30
- * edits on other replicas arrive within that delay. The cache never writes.
58
+ * Reads the phases cards sit in on each of a project's boards, for `occupiedPhases`. Null while
59
+ * cards from before the work-item split are still being copied: `listWith` can't see those yet.
60
+ */
61
+ function occupiedPhasesOf(workItems) {
62
+ return async (scope, ops) => {
63
+ if (workItems.legacyBackfillPending) return null;
64
+ const occupied = /* @__PURE__ */ new Map();
65
+ for (const item of await workItems.listWith(ops, scope)) {
66
+ const board = boardForWorkItem(item);
67
+ const phases = occupied.get(board) ?? /* @__PURE__ */ new Set();
68
+ for (const stage of item.stages) phases.add(stage);
69
+ occupied.set(board, phases);
70
+ }
71
+ return occupied;
72
+ };
73
+ }
74
+ /**
75
+ * The per-project board cache. A project's boards are its rows: the Work and app boards Factory
76
+ * stored in it, in code order, then the others. A Work or app board's row runs with the code
77
+ * behaviour of its board and phase keys that still fits it ({@link mergeCodeBehaviour}). A project
78
+ * that still uses the retired Review board is served it from code, never stored, until its last
79
+ * open card there finishes. The first load of each project in a process stores the
80
+ * boards Factory hasn't stored in it yet, each once ({@link StoredBoardsStorage.seedBoards}); a
81
+ * release never rewrites them. Loads recheck the project's board version at most every
82
+ * `recheckMs` and recompile when it changed, so stored edits on other replicas arrive within that
83
+ * delay.
31
84
  */
32
85
  var ProjectBoardCache = class {
33
86
  [PROJECT_BOARD_SOURCE] = true;
@@ -42,10 +95,18 @@ var ProjectBoardCache = class {
42
95
  #loading = /* @__PURE__ */ new Map();
43
96
  #generations = /* @__PURE__ */ new Map();
44
97
  #warned = /* @__PURE__ */ new Set();
98
+ #seeded = /* @__PURE__ */ new Set();
45
99
  #codeSkills;
100
+ #seeds;
101
+ /** Boards the app upserted for every project, which a project with no boards gets before Factory's. */
102
+ #appBoards = /* @__PURE__ */ new Map();
103
+ #reviewBoardInUse;
104
+ #occupiedPhases;
46
105
  constructor(options) {
47
106
  this.codeRegistry = options.codeRegistry;
48
107
  this.#storage = options.storage;
108
+ this.#reviewBoardInUse = options.reviewBoardInUse;
109
+ this.#occupiedPhases = options.occupiedPhases;
49
110
  this.#projects = options.projects;
50
111
  this.#codeSkills = options.codeSkills ?? [];
51
112
  this.#recheckMs = options.recheckMs ?? DEFAULT_RECHECK_MS;
@@ -53,9 +114,59 @@ var ProjectBoardCache = class {
53
114
  this.#warn = options.warn ?? ((message) => console.warn(`[factory] ${message}`));
54
115
  this.#codeDetails = new Map([...this.codeRegistry.values()].map((board) => [board.id, {
55
116
  source: defaultBoards.includes(board) ? "builtin" : "app",
56
- editable: false,
117
+ editable: true,
57
118
  problems: this.#skillProblems(board)
58
119
  }]));
120
+ this.#seeds = new Map([...this.codeRegistry.values()].map((board) => [board.id, boardDefinitionOf(board)]));
121
+ }
122
+ /**
123
+ * The boards Factory stores once in a project it didn't create: Work as it was with Triage, so a
124
+ * project from an older release keeps the phases its cards know, then the app boards, in order.
125
+ */
126
+ seeds() {
127
+ return [...this.#seeds.values()].map((seed) => this.#isFactoryWork(seed.key) ? workSeedWithTriage() : seed);
128
+ }
129
+ /**
130
+ * The definition reset restores for `key`; undefined when there is none. A board the app upserted
131
+ * for every project comes first, so reset never swaps an app's Work for Factory's. Factory's Work
132
+ * is today's Work for a project Factory created with it (`row` created by
133
+ * {@link NEW_PROJECT_SEED_ACTOR}), and Work with Triage for every other project.
134
+ */
135
+ seedFor(key, row) {
136
+ const app = this.#appBoards.get(key);
137
+ if (app) return app;
138
+ const seed = this.#seeds.get(key);
139
+ if (!seed || !this.#isFactoryWork(key) || row?.createdBy === "factory:new-project") return seed;
140
+ return workSeedWithTriage();
141
+ }
142
+ /**
143
+ * Stores Factory's boards in a project that was just created, with today's Work (no Triage).
144
+ * Only the project-creation route calls this; every other load stores {@link seeds}.
145
+ */
146
+ async seedNewProject(scope) {
147
+ if (this.#seeds.size > 0 || this.#appBoards.size > 0) await this.#storage.seedBoards(scope, [...this.#seeds.values()], {
148
+ actor: NEW_PROJECT_SEED_ACTOR,
149
+ onlyIntoEmpty: this.#onlyIntoEmpty(),
150
+ intoEmpty: [...this.#appBoards.values()]
151
+ });
152
+ return this.describe(scope);
153
+ }
154
+ /**
155
+ * Remembers a board the app upserted for every project, so a project that has no boards yet (one
156
+ * created later, or one that never loaded) gets it on its first load before Factory's own boards;
157
+ * having it, the project then gets no Work from Factory. Kept for this process: an app upserts
158
+ * its boards at every startup.
159
+ */
160
+ rememberBoardForAllProjects(board) {
161
+ this.#appBoards.set(board.key, board);
162
+ }
163
+ /** Whether `key` is Factory's own Work board, rather than none or an app board under its key. */
164
+ #isFactoryWork(key) {
165
+ return key === workBoard.id && this.codeRegistry.get(key) === workBoard;
166
+ }
167
+ /** Work is stored only into a project with no boards: one that has any keeps what it has. */
168
+ #onlyIntoEmpty() {
169
+ return this.#isFactoryWork(workBoard.id) ? [workBoard.id] : [];
59
170
  }
60
171
  async load(scope) {
61
172
  return (await this.describe(scope)).registry;
@@ -99,7 +210,7 @@ var ProjectBoardCache = class {
99
210
  const entry = this.#entries.get(key);
100
211
  if (entry) entry.checkedAt = Number.NEGATIVE_INFINITY;
101
212
  }
102
- /** Loads every project, a few at a time, so sync reads find them warm. */
213
+ /** Loads every project, a few at a time, so sync reads find them warm and each has its boards stored. */
103
214
  async preload() {
104
215
  const projects = await this.#projects?.listAll() ?? [];
105
216
  let next = 0;
@@ -115,17 +226,20 @@ var ProjectBoardCache = class {
115
226
  await Promise.all(Array.from({ length: Math.min(PRELOAD_CONCURRENCY, projects.length) }, worker));
116
227
  }
117
228
  async #refresh(scope, key, generation) {
229
+ await this.#seed(scope, key);
118
230
  const current = this.#entries.get(key);
119
231
  const version = await this.#storage.readVersion(scope);
120
- if (current && current.version === version) {
232
+ const reviewInUse = await this.#reviewBoardInUse?.(scope) ?? false;
233
+ if (current && current.version === version && current.reviewInUse === reviewInUse) {
121
234
  if ((this.#generations.get(key) ?? 0) === generation) current.checkedAt = this.#now();
122
235
  return current.boards;
123
236
  }
124
237
  const snapshot = await this.#consistentSnapshot(scope);
125
- const boards = this.#compile(scope, snapshot.boards);
238
+ const boards = this.#compile(scope, snapshot.boards, reviewInUse);
126
239
  if ((this.#generations.get(key) ?? 0) === generation) this.#entries.set(key, {
127
240
  boards,
128
241
  version: snapshot.version,
242
+ reviewInUse,
129
243
  checkedAt: this.#now()
130
244
  });
131
245
  return boards;
@@ -139,22 +253,105 @@ var ProjectBoardCache = class {
139
253
  }
140
254
  return snapshot;
141
255
  }
142
- #compile(scope, rows) {
143
- const boards = [...this.codeRegistry.values()];
256
+ /**
257
+ * Stores the boards Factory hasn't stored in the project yet, once per process. A failure is
258
+ * logged and retried on the next load; the boards it didn't store aren't served meanwhile.
259
+ */
260
+ async #seed(scope, key) {
261
+ if (this.#seeded.has(key)) return;
262
+ try {
263
+ const seeded = await this.#storage.seededBoardKeys(scope);
264
+ if (this.#seeds.size > 0 || this.#appBoards.size > 0) await this.#storage.seedBoards(scope, this.seeds(), {
265
+ onlyIntoEmpty: this.#onlyIntoEmpty(),
266
+ intoEmpty: [...this.#appBoards.values()]
267
+ });
268
+ await this.#migrate(scope, seeded);
269
+ this.#seeded.add(key);
270
+ } catch (error) {
271
+ this.#warnOnce(`seed:${key}`, `Boards for project ${scope.factoryProjectId} could not be stored; Factory stores them on the next load: ${error instanceof Error ? error.message : String(error)}`);
272
+ }
273
+ }
274
+ /** Runs the board migrations of the boards Factory stores here that the project hasn't had yet. */
275
+ async #migrate(scope, seededBefore) {
276
+ const migrations = BOARD_MIGRATIONS.filter((migration) => {
277
+ if (migration.boardKey === null) return true;
278
+ const code = this.codeRegistry.get(migration.boardKey);
279
+ return code !== void 0 && defaultBoards.includes(code);
280
+ }).map((migration) => migration.boardKey !== null && (this.#appBoards.has(migration.boardKey) || seededBefore !== null && !seededBefore.includes(migration.boardKey)) ? {
281
+ ...migration,
282
+ migrate: () => void 0
283
+ } : migration);
284
+ const changed = await this.#storage.applyBoardMigrations(scope, migrations, (ops) => this.#migrationContext(scope, ops));
285
+ if (changed.length === 0) return;
286
+ const filled = changed.map(({ boardKey, filled }) => `${boardKey}: ${filled.join(", ")}`).join("; ");
287
+ console.info(`[factory] Migrated the boards of project ${scope.factoryProjectId} (${filled}).`);
288
+ }
289
+ /** Read through the migration transaction's `ops`, so card moves can't slip in unseen on LibSQL. */
290
+ async #migrationContext(scope, ops) {
291
+ const retiredSettings = await this.#projects?.retiredAutomationSettings?.({
292
+ orgId: scope.orgId,
293
+ id: scope.factoryProjectId
294
+ }, ops) ?? null;
295
+ return {
296
+ retiredSettings,
297
+ occupiedPhases: retiredSettings && this.#occupiedPhases ? await this.#occupiedPhases(scope, ops) : null,
298
+ codePhases: (boardKey) => {
299
+ const code = this.codeRegistry.get(boardKey);
300
+ return code ? new Set(Object.keys(code.phases)) : void 0;
301
+ },
302
+ warn: (message) => this.#warnOnce(`migration:${scopeKey(scope)}:${message}`, `${message} (project ${scope.factoryProjectId})`)
303
+ };
304
+ }
305
+ #compile(scope, rows, reviewInUse) {
306
+ const byKey = new Map(rows.map((row) => [row.key, row]));
144
307
  const details = new Map(this.#codeDetails);
145
308
  const problems = [];
309
+ const report = (row, messages) => {
310
+ problems.push(...messages);
311
+ for (const message of messages) this.#warnOnce(`row:${scopeKey(scope)}:${row.key}:${row.revision}:${message}`, `${message} (project ${scope.factoryProjectId})`);
312
+ };
313
+ const boards = [];
314
+ for (const code of this.codeRegistry.values()) {
315
+ const row = byKey.get(code.id);
316
+ if (!row) {
317
+ details.delete(code.id);
318
+ if (!this.#seeded.has(scopeKey(scope))) problems.push(`Board "${code.id}" isn't stored in this project yet; Factory stores it on the next load.`);
319
+ continue;
320
+ }
321
+ let merged;
322
+ try {
323
+ merged = mergeCodeBehaviour(row, code);
324
+ } catch (error) {
325
+ report(row, [`Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`]);
326
+ continue;
327
+ }
328
+ report(row, merged.problems);
329
+ details.set(code.id, {
330
+ ...details.get(code.id),
331
+ problems: [...merged.problems, ...this.#skillProblems(merged.board)]
332
+ });
333
+ boards.push(merged.board);
334
+ }
335
+ if (reviewInUse) {
336
+ boards.push(reviewBoard);
337
+ details.set(reviewBoard.id, {
338
+ source: "builtin",
339
+ editable: false,
340
+ problems: []
341
+ });
342
+ }
146
343
  for (const row of rows) {
147
- if (this.codeRegistry.has(row.key)) {
148
- problems.push(`Stored board "${row.key}" is hidden by the code board with the same key.`);
344
+ if (this.codeRegistry.has(row.key)) continue;
345
+ if (row.key === "review") {
346
+ if (isUntouchedReviewSeed(row)) continue;
347
+ report(row, [reviewInUse ? `Stored board "${row.key}" is hidden by the code board with the same key.` : RESERVED_REVIEW_ROW]);
149
348
  continue;
150
349
  }
151
350
  let board;
152
351
  try {
153
352
  board = compileStoredBoard(row);
154
353
  } catch (error) {
155
- const message = `Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`;
156
- problems.push(message);
157
- this.#warnOnce(`compile:${scopeKey(scope)}:${row.key}:${row.revision}`, `${message} (project ${scope.factoryProjectId})`);
354
+ report(row, [`Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`]);
158
355
  continue;
159
356
  }
160
357
  boards.push(board);
@@ -165,19 +362,13 @@ var ProjectBoardCache = class {
165
362
  });
166
363
  }
167
364
  return {
168
- registry: createBoardRegistry({
169
- boards,
170
- includeDefaultBoards: false
171
- }),
365
+ registry: boardRegistryOf(boards),
172
366
  details,
173
367
  problems
174
368
  };
175
369
  }
176
370
  #skillProblems(board) {
177
- return findBoardSkillProblems(createBoardRegistry({
178
- boards: [board],
179
- includeDefaultBoards: false
180
- }), this.#codeSkills);
371
+ return findBoardSkillProblems(boardRegistryOf([board]), this.#codeSkills);
181
372
  }
182
373
  #warnOnce(key, message, debug = false) {
183
374
  if (this.#warned.has(key)) return;
@@ -189,6 +380,6 @@ var ProjectBoardCache = class {
189
380
  this.#warn(message);
190
381
  }
191
382
  };
192
- export { ProjectBoardCache, toBoardSource };
383
+ export { NEW_PROJECT_SEED_ACTOR, ProjectBoardCache, occupiedPhasesOf, toBoardSource };
193
384
 
194
385
  //# sourceMappingURL=project-boards.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"project-boards.js","names":[],"sources":["../../src/boards/project-boards.ts"],"sourcesContent":["import type { InlineSkill } from '@mastra/core/skills';\n\nimport { findBoardSkillProblems } from '../skills/app-skills.js';\nimport type { StoredBoardRecord, StoredBoardScope, StoredBoardsStorage } from '../storage/domains/boards/base.js';\nimport { createBoardRegistry, defaultBoards } from './registry.js';\nimport type { BoardRegistry, InstalledBoard } from './registry.js';\nimport { compileStoredBoard } from './stored-board.js';\n\nconst DEFAULT_RECHECK_MS = 1000;\nconst PRELOAD_CONCURRENCY = 8;\nconst SNAPSHOT_ATTEMPTS = 3;\n\n/** Where a board in a project's catalog came from. */\nexport type BoardSourceKind = 'builtin' | 'app' | 'stored';\n\nexport interface StoredBoardDetails {\n source: BoardSourceKind;\n /** Only boards the project stored can be edited; code boards are read-only. */\n editable: boolean;\n problems: string[];\n}\n\n/** A project's boards: the code boards plus its stored boards, and what to report about each board. */\nexport interface ProjectBoards {\n readonly registry: BoardRegistry;\n readonly details: ReadonlyMap<string, StoredBoardDetails>;\n /** Problems with stored boards that are left out of the registry. */\n readonly problems: readonly string[];\n}\n\nconst PROJECT_BOARD_SOURCE = Symbol('ProjectBoardSource');\n\n/**\n * Serves each project its boards. `load` is the async entry point that brings a project's\n * boards up to date; `forProject` is the sync read for code that already loaded the project.\n */\nexport interface ProjectBoardSource {\n readonly [PROJECT_BOARD_SOURCE]: true;\n /** The code boards: built-in and app boards, served to every project as code built them. */\n readonly codeRegistry: BoardRegistry;\n load(scope: StoredBoardScope): Promise<BoardRegistry>;\n forProject(scope: StoredBoardScope): BoardRegistry;\n describe?(scope: StoredBoardScope): Promise<ProjectBoards>;\n}\n\n/** Accepts either a fixed registry (tests, standalone services) or a per-project source. */\nexport function toBoardSource(boards: BoardRegistry | ProjectBoardSource | undefined): ProjectBoardSource {\n const source = boards ?? createBoardRegistry();\n if (isBoardSource(source)) return source;\n return {\n [PROJECT_BOARD_SOURCE]: true,\n codeRegistry: source,\n load: async () => source,\n forProject: () => source,\n };\n}\n\nfunction isBoardSource(boards: BoardRegistry | ProjectBoardSource): boards is ProjectBoardSource {\n return PROJECT_BOARD_SOURCE in boards;\n}\n\ninterface CacheEntry {\n boards: ProjectBoards;\n version: string | null;\n checkedAt: number;\n}\n\nexport interface ProjectBoardCacheOptions {\n /** The code boards, built-ins included when enabled. */\n codeRegistry: BoardRegistry;\n storage: StoredBoardsStorage;\n /** Lists every project, to warm them at boot. */\n projects?: { listAll(): Promise<readonly { orgId: string; id: string }[]> };\n codeSkills?: readonly InlineSkill[];\n recheckMs?: number;\n now?: () => number;\n warn?: (message: string) => void;\n}\n\nfunction scopeKey(scope: StoredBoardScope): string {\n return `${scope.orgId}\\0${scope.factoryProjectId}`;\n}\n\n/**\n * The per-project board cache. A project's boards are the code boards, served as code built them\n * and winning on their key, followed by the boards the project stored. Loads recheck the\n * project's board version at most every `recheckMs` and recompile when it changed, so stored\n * edits on other replicas arrive within that delay. The cache never writes.\n */\nexport class ProjectBoardCache implements ProjectBoardSource {\n readonly [PROJECT_BOARD_SOURCE] = true;\n readonly codeRegistry: BoardRegistry;\n readonly #codeDetails: ReadonlyMap<string, StoredBoardDetails>;\n readonly #storage: StoredBoardsStorage;\n readonly #projects: ProjectBoardCacheOptions['projects'];\n readonly #recheckMs: number;\n readonly #now: () => number;\n readonly #warn: (message: string) => void;\n readonly #entries = new Map<string, CacheEntry>();\n readonly #loading = new Map<string, Promise<ProjectBoards>>();\n readonly #generations = new Map<string, number>();\n readonly #warned = new Set<string>();\n readonly #codeSkills: readonly InlineSkill[];\n\n constructor(options: ProjectBoardCacheOptions) {\n this.codeRegistry = options.codeRegistry;\n this.#storage = options.storage;\n this.#projects = options.projects;\n this.#codeSkills = options.codeSkills ?? [];\n this.#recheckMs = options.recheckMs ?? DEFAULT_RECHECK_MS;\n this.#now = options.now ?? Date.now;\n this.#warn = options.warn ?? (message => console.warn(`[factory] ${message}`));\n this.#codeDetails = new Map(\n [...this.codeRegistry.values()].map(board => [\n board.id,\n {\n source: defaultBoards.includes(board) ? 'builtin' : 'app',\n editable: false,\n problems: this.#skillProblems(board),\n },\n ]),\n );\n }\n\n async load(scope: StoredBoardScope): Promise<BoardRegistry> {\n return (await this.describe(scope)).registry;\n }\n\n /** The project's boards with their source, whether they can be edited, and problems, brought up to date. */\n async describe(scope: StoredBoardScope): Promise<ProjectBoards> {\n const key = scopeKey(scope);\n const entry = this.#entries.get(key);\n if (entry && this.#now() - entry.checkedAt < this.#recheckMs) return entry.boards;\n const inFlight = this.#loading.get(key);\n if (inFlight) return inFlight;\n const generation = this.#generations.get(key) ?? 0;\n const loading = this.#refresh(scope, key, generation).finally(() => {\n if (this.#loading.get(key) === loading) this.#loading.delete(key);\n });\n this.#loading.set(key, loading);\n return loading;\n }\n\n /**\n * The project's loaded boards. Before the project's first load (boot preload not finished, or a\n * project created on another replica) this is the code boards alone, without the project's\n * stored boards.\n */\n forProject(scope: StoredBoardScope): BoardRegistry {\n // Storage asks about a row it is about to insert by its board and stages alone, with no\n // project to look up; the code boards answer for it.\n if (!scope.orgId || !scope.factoryProjectId) return this.codeRegistry;\n const entry = this.#entries.get(scopeKey(scope));\n if (entry) return entry.boards.registry;\n // Warm the project so the next sync read sees its stored boards.\n void this.load(scope).catch(() => {});\n this.#warnOnce(\n `cold:${scopeKey(scope)}`,\n `Boards for project ${scope.factoryProjectId} were read before they were loaded; using the code boards.`,\n true,\n );\n return this.codeRegistry;\n }\n\n /** The code skills stored runners may name. */\n get codeSkills(): readonly InlineSkill[] {\n return this.#codeSkills;\n }\n\n /** Makes the next load reread the project. The loaded boards keep serving sync reads until then. */\n invalidate(scope: StoredBoardScope): void {\n const key = scopeKey(scope);\n this.#generations.set(key, (this.#generations.get(key) ?? 0) + 1);\n this.#loading.delete(key);\n const entry = this.#entries.get(key);\n if (entry) entry.checkedAt = Number.NEGATIVE_INFINITY;\n }\n\n /** Loads every project, a few at a time, so sync reads find them warm. */\n async preload(): Promise<void> {\n const projects = (await this.#projects?.listAll()) ?? [];\n let next = 0;\n const worker = async () => {\n while (next < projects.length) {\n const project = projects[next++]!;\n // A project that fails to load here loads on first use; the others still load now.\n await this.load({ orgId: project.orgId, factoryProjectId: project.id }).catch(error =>\n this.#warn(\n `Boards for project ${project.id} did not load at startup; they load on first use: ${error instanceof Error ? error.message : String(error)}`,\n ),\n );\n }\n };\n await Promise.all(Array.from({ length: Math.min(PRELOAD_CONCURRENCY, projects.length) }, worker));\n }\n\n async #refresh(scope: StoredBoardScope, key: string, generation: number): Promise<ProjectBoards> {\n const current = this.#entries.get(key);\n const version = await this.#storage.readVersion(scope);\n if (current && current.version === version) {\n if ((this.#generations.get(key) ?? 0) === generation) current.checkedAt = this.#now();\n return current.boards;\n }\n const snapshot = await this.#consistentSnapshot(scope);\n const boards = this.#compile(scope, snapshot.boards);\n if ((this.#generations.get(key) ?? 0) === generation) {\n this.#entries.set(key, { boards, version: snapshot.version, checkedAt: this.#now() });\n }\n return boards;\n }\n\n /** Boards and phases are read in two statements; reread when a write landed between them. */\n async #consistentSnapshot(scope: StoredBoardScope) {\n let snapshot = await this.#storage.snapshot(scope);\n for (let attempt = 1; attempt < SNAPSHOT_ATTEMPTS; attempt++) {\n if ((await this.#storage.readVersion(scope)) === snapshot.version) break;\n snapshot = await this.#storage.snapshot(scope);\n }\n return snapshot;\n }\n\n #compile(scope: StoredBoardScope, rows: readonly StoredBoardRecord[]): ProjectBoards {\n const boards: InstalledBoard[] = [...this.codeRegistry.values()];\n const details = new Map(this.#codeDetails);\n const problems: string[] = [];\n for (const row of rows) {\n if (this.codeRegistry.has(row.key)) {\n problems.push(`Stored board \"${row.key}\" is hidden by the code board with the same key.`);\n continue;\n }\n let board: InstalledBoard;\n try {\n board = compileStoredBoard(row);\n } catch (error) {\n const message = `Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`;\n problems.push(message);\n this.#warnOnce(\n `compile:${scopeKey(scope)}:${row.key}:${row.revision}`,\n `${message} (project ${scope.factoryProjectId})`,\n );\n continue;\n }\n boards.push(board);\n details.set(row.key, { source: 'stored', editable: true, problems: this.#skillProblems(board) });\n }\n return {\n registry: createBoardRegistry({ boards, includeDefaultBoards: false }),\n details,\n problems,\n };\n }\n\n #skillProblems(board: InstalledBoard): string[] {\n return findBoardSkillProblems(\n createBoardRegistry({ boards: [board], includeDefaultBoards: false }),\n this.#codeSkills,\n );\n }\n\n #warnOnce(key: string, message: string, debug = false): void {\n if (this.#warned.has(key)) return;\n this.#warned.add(key);\n if (debug) {\n console.debug(`[factory] ${message}`);\n return;\n }\n this.#warn(message);\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"project-boards.js","names":[],"sources":["../../src/boards/project-boards.ts"],"sourcesContent":["import type { InlineSkill } from '@mastra/core/skills';\nimport type { FactoryStorageOps } from '@mastra/core/storage';\n\nimport { findBoardSkillProblems } from '../skills/app-skills.js';\nimport type {\n BoardMigrationContext,\n StoredBoardInput,\n StoredBoardRecord,\n StoredBoardScope,\n StoredBoardsStorage,\n} from '../storage/domains/boards/base.js';\nimport { DEFAULT_INTAKE_ROUTE_ACTOR } from '../storage/domains/boards/base.js';\nimport type { RetiredAutomationSettings } from '../storage/domains/projects/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { LEGACY_REVIEW_BOARD } from '../storage/domains/work-items/legacy-review.js';\nimport { boardRegistryOf, createBoardRegistry, defaultBoards } from './registry.js';\nimport type { BoardRegistry, InstalledBoard } from './registry.js';\nimport { reviewBoard } from './review.js';\nimport { boardForWorkItem } from './semantics.js';\nimport { boardDefinitionOf, compileStoredBoard, mergeCodeBehaviour } from './stored-board.js';\nimport { BOARD_MIGRATIONS } from './work-migrations.js';\nimport { workSeedWithTriage } from './work-seeds.js';\nimport { workBoard } from './work.js';\n\nconst DEFAULT_RECHECK_MS = 1000;\n/** A row under the retired Review board's key is never served: the key is the Review board's alone. */\nconst RESERVED_REVIEW_ROW = `Stored board \"${LEGACY_REVIEW_BOARD}\" isn't served: the key is reserved for the retired Review board.`;\nconst PRELOAD_CONCURRENCY = 8;\n/** The phases every release seeded the Review board with; only runners and tools changed between them. */\nconst REVIEW_SEED_PHASES = boardDefinitionOf(reviewBoard).phases.map(({ key, name, kind }) => ({ key, name, kind }));\n\n/**\n * Whether `row` is the Review board as Factory seeded it: written once by Factory, never\n * revised, and shaped like the seed. The actor alone is not proof, as any caller can pass it.\n */\nfunction isUntouchedReviewSeed(row: StoredBoardRecord): boolean {\n if (row.revision !== 1 || row.createdBy !== DEFAULT_INTAKE_ROUTE_ACTOR) return false;\n if (row.updatedBy !== DEFAULT_INTAKE_ROUTE_ACTOR || row.name !== reviewBoard.name) return false;\n const phases = [...row.phases].sort((a, b) => a.position - b.position);\n return (\n phases.length === REVIEW_SEED_PHASES.length &&\n phases.every(\n (phase, index) =>\n phase.key === REVIEW_SEED_PHASES[index]!.key &&\n phase.name === REVIEW_SEED_PHASES[index]!.name &&\n phase.kind === REVIEW_SEED_PHASES[index]!.kind,\n )\n );\n}\nconst SNAPSHOT_ATTEMPTS = 3;\n\n/**\n * The creator Factory records on the Work board it stores in a project as the project is\n * created: that board is today's Work, and reset gives it back. Any other Work row Factory stored\n * is the one with Triage. Only Factory writes this id; a person's writes carry their user id.\n */\nexport const NEW_PROJECT_SEED_ACTOR = 'factory:new-project';\n\n/** Where a board in a project's catalog came from. */\nexport type BoardSourceKind = 'builtin' | 'app' | 'stored';\n\nexport interface StoredBoardDetails {\n source: BoardSourceKind;\n /** Stored boards, the built-in Work board and app boards can all be edited; the retired Review board can't. */\n editable: boolean;\n problems: string[];\n}\n\n/** A project's boards: the code boards plus its stored boards, and what to report about each board. */\nexport interface ProjectBoards {\n readonly registry: BoardRegistry;\n readonly details: ReadonlyMap<string, StoredBoardDetails>;\n /** Problems with stored boards that are left out of the registry. */\n readonly problems: readonly string[];\n}\n\nconst PROJECT_BOARD_SOURCE = Symbol('ProjectBoardSource');\n\n/**\n * Serves each project its boards. `load` is the async entry point that brings a project's\n * boards up to date; `forProject` is the sync read for code that already loaded the project.\n */\nexport interface ProjectBoardSource {\n readonly [PROJECT_BOARD_SOURCE]: true;\n /** The code boards: built-in and app boards, served to every project as code built them. */\n readonly codeRegistry: BoardRegistry;\n load(scope: StoredBoardScope): Promise<BoardRegistry>;\n forProject(scope: StoredBoardScope): BoardRegistry;\n describe?(scope: StoredBoardScope): Promise<ProjectBoards>;\n}\n\n/** Accepts either a fixed registry (tests, standalone services) or a per-project source. */\nexport function toBoardSource(boards: BoardRegistry | ProjectBoardSource | undefined): ProjectBoardSource {\n const source = boards ?? createBoardRegistry();\n if (isBoardSource(source)) return source;\n return {\n [PROJECT_BOARD_SOURCE]: true,\n codeRegistry: source,\n load: async () => source,\n forProject: () => source,\n };\n}\n\nfunction isBoardSource(boards: BoardRegistry | ProjectBoardSource): boards is ProjectBoardSource {\n return PROJECT_BOARD_SOURCE in boards;\n}\n\ninterface CacheEntry {\n boards: ProjectBoards;\n version: string | null;\n reviewInUse: boolean;\n checkedAt: number;\n}\n\nexport interface ProjectBoardCacheOptions {\n /** The code boards, built-ins included when enabled. */\n codeRegistry: BoardRegistry;\n storage: StoredBoardsStorage;\n /**\n * Lists every project, to warm them at boot, and reads the retired switches the board\n * migrations carry into each project's boards.\n */\n projects?: {\n listAll(): Promise<readonly { orgId: string; id: string }[]>;\n retiredAutomationSettings?(\n project: { orgId: string; id: string },\n ops: FactoryStorageOps,\n ): Promise<RetiredAutomationSettings | null>;\n };\n /** The phases cards sit in on each of the project's boards, which a board migration must not remove. */\n occupiedPhases?: (\n scope: StoredBoardScope,\n ops: FactoryStorageOps,\n ) => Promise<ReadonlyMap<string, ReadonlySet<string>> | null>;\n codeSkills?: readonly InlineSkill[];\n /**\n * Whether the project still uses the retired Review board (an open card is stored on it). Such\n * a project is served Review alongside its boards; without this, no project is.\n */\n reviewBoardInUse?: (scope: StoredBoardScope) => Promise<boolean>;\n recheckMs?: number;\n now?: () => number;\n warn?: (message: string) => void;\n}\n\nfunction scopeKey(scope: StoredBoardScope): string {\n return `${scope.orgId}\\0${scope.factoryProjectId}`;\n}\n\n/**\n * Reads the phases cards sit in on each of a project's boards, for `occupiedPhases`. Null while\n * cards from before the work-item split are still being copied: `listWith` can't see those yet.\n */\nexport function occupiedPhasesOf(workItems: Pick<WorkItemsStorage, 'listWith' | 'legacyBackfillPending'>) {\n return async (\n scope: StoredBoardScope,\n ops: FactoryStorageOps,\n ): Promise<ReadonlyMap<string, ReadonlySet<string>> | null> => {\n if (workItems.legacyBackfillPending) return null;\n const occupied = new Map<string, Set<string>>();\n for (const item of await workItems.listWith(ops, scope)) {\n const board = boardForWorkItem(item);\n const phases = occupied.get(board) ?? new Set<string>();\n for (const stage of item.stages) phases.add(stage);\n occupied.set(board, phases);\n }\n return occupied;\n };\n}\n\n/**\n * The per-project board cache. A project's boards are its rows: the Work and app boards Factory\n * stored in it, in code order, then the others. A Work or app board's row runs with the code\n * behaviour of its board and phase keys that still fits it ({@link mergeCodeBehaviour}). A project\n * that still uses the retired Review board is served it from code, never stored, until its last\n * open card there finishes. The first load of each project in a process stores the\n * boards Factory hasn't stored in it yet, each once ({@link StoredBoardsStorage.seedBoards}); a\n * release never rewrites them. Loads recheck the project's board version at most every\n * `recheckMs` and recompile when it changed, so stored edits on other replicas arrive within that\n * delay.\n */\nexport class ProjectBoardCache implements ProjectBoardSource {\n readonly [PROJECT_BOARD_SOURCE] = true;\n readonly codeRegistry: BoardRegistry;\n readonly #codeDetails: ReadonlyMap<string, StoredBoardDetails>;\n readonly #storage: StoredBoardsStorage;\n readonly #projects: ProjectBoardCacheOptions['projects'];\n readonly #recheckMs: number;\n readonly #now: () => number;\n readonly #warn: (message: string) => void;\n readonly #entries = new Map<string, CacheEntry>();\n readonly #loading = new Map<string, Promise<ProjectBoards>>();\n readonly #generations = new Map<string, number>();\n readonly #warned = new Set<string>();\n readonly #seeded = new Set<string>();\n readonly #codeSkills: readonly InlineSkill[];\n readonly #seeds: ReadonlyMap<string, StoredBoardInput>;\n /** Boards the app upserted for every project, which a project with no boards gets before Factory's. */\n readonly #appBoards = new Map<string, StoredBoardInput>();\n readonly #reviewBoardInUse: ProjectBoardCacheOptions['reviewBoardInUse'];\n readonly #occupiedPhases: ProjectBoardCacheOptions['occupiedPhases'];\n\n constructor(options: ProjectBoardCacheOptions) {\n this.codeRegistry = options.codeRegistry;\n this.#storage = options.storage;\n this.#reviewBoardInUse = options.reviewBoardInUse;\n this.#occupiedPhases = options.occupiedPhases;\n this.#projects = options.projects;\n this.#codeSkills = options.codeSkills ?? [];\n this.#recheckMs = options.recheckMs ?? DEFAULT_RECHECK_MS;\n this.#now = options.now ?? Date.now;\n this.#warn = options.warn ?? (message => console.warn(`[factory] ${message}`));\n this.#codeDetails = new Map(\n [...this.codeRegistry.values()].map(board => [\n board.id,\n {\n source: defaultBoards.includes(board) ? 'builtin' : 'app',\n editable: true,\n problems: this.#skillProblems(board),\n },\n ]),\n );\n this.#seeds = new Map([...this.codeRegistry.values()].map(board => [board.id, boardDefinitionOf(board)]));\n }\n\n /**\n * The boards Factory stores once in a project it didn't create: Work as it was with Triage, so a\n * project from an older release keeps the phases its cards know, then the app boards, in order.\n */\n seeds(): StoredBoardInput[] {\n return [...this.#seeds.values()].map(seed => (this.#isFactoryWork(seed.key) ? workSeedWithTriage() : seed));\n }\n\n /**\n * The definition reset restores for `key`; undefined when there is none. A board the app upserted\n * for every project comes first, so reset never swaps an app's Work for Factory's. Factory's Work\n * is today's Work for a project Factory created with it (`row` created by\n * {@link NEW_PROJECT_SEED_ACTOR}), and Work with Triage for every other project.\n */\n seedFor(key: string, row?: Pick<StoredBoardRecord, 'createdBy'>): StoredBoardInput | undefined {\n const app = this.#appBoards.get(key);\n if (app) return app;\n const seed = this.#seeds.get(key);\n if (!seed || !this.#isFactoryWork(key) || row?.createdBy === NEW_PROJECT_SEED_ACTOR) return seed;\n return workSeedWithTriage();\n }\n\n /**\n * Stores Factory's boards in a project that was just created, with today's Work (no Triage).\n * Only the project-creation route calls this; every other load stores {@link seeds}.\n */\n async seedNewProject(scope: StoredBoardScope): Promise<ProjectBoards> {\n if (this.#seeds.size > 0 || this.#appBoards.size > 0) {\n await this.#storage.seedBoards(scope, [...this.#seeds.values()], {\n actor: NEW_PROJECT_SEED_ACTOR,\n onlyIntoEmpty: this.#onlyIntoEmpty(),\n intoEmpty: [...this.#appBoards.values()],\n });\n }\n return this.describe(scope);\n }\n\n /**\n * Remembers a board the app upserted for every project, so a project that has no boards yet (one\n * created later, or one that never loaded) gets it on its first load before Factory's own boards;\n * having it, the project then gets no Work from Factory. Kept for this process: an app upserts\n * its boards at every startup.\n */\n rememberBoardForAllProjects(board: StoredBoardInput): void {\n this.#appBoards.set(board.key, board);\n }\n\n /** Whether `key` is Factory's own Work board, rather than none or an app board under its key. */\n #isFactoryWork(key: string): boolean {\n return key === workBoard.id && this.codeRegistry.get(key) === workBoard;\n }\n\n /** Work is stored only into a project with no boards: one that has any keeps what it has. */\n #onlyIntoEmpty(): string[] {\n return this.#isFactoryWork(workBoard.id) ? [workBoard.id] : [];\n }\n\n async load(scope: StoredBoardScope): Promise<BoardRegistry> {\n return (await this.describe(scope)).registry;\n }\n\n /** The project's boards with their source, whether they can be edited, and problems, brought up to date. */\n async describe(scope: StoredBoardScope): Promise<ProjectBoards> {\n const key = scopeKey(scope);\n const entry = this.#entries.get(key);\n if (entry && this.#now() - entry.checkedAt < this.#recheckMs) return entry.boards;\n const inFlight = this.#loading.get(key);\n if (inFlight) return inFlight;\n const generation = this.#generations.get(key) ?? 0;\n const loading = this.#refresh(scope, key, generation).finally(() => {\n if (this.#loading.get(key) === loading) this.#loading.delete(key);\n });\n this.#loading.set(key, loading);\n return loading;\n }\n\n /**\n * The project's loaded boards. Before the project's first load (boot preload not finished, or a\n * project created on another replica) this is the code boards alone, without the project's\n * stored boards.\n */\n forProject(scope: StoredBoardScope): BoardRegistry {\n // Storage asks about a row it is about to insert by its board and stages alone, with no\n // project to look up; the code boards answer for it.\n if (!scope.orgId || !scope.factoryProjectId) return this.codeRegistry;\n const entry = this.#entries.get(scopeKey(scope));\n if (entry) return entry.boards.registry;\n // Warm the project so the next sync read sees its stored boards.\n void this.load(scope).catch(() => {});\n this.#warnOnce(\n `cold:${scopeKey(scope)}`,\n `Boards for project ${scope.factoryProjectId} were read before they were loaded; using the code boards.`,\n true,\n );\n return this.codeRegistry;\n }\n\n /** The code skills stored runners may name. */\n get codeSkills(): readonly InlineSkill[] {\n return this.#codeSkills;\n }\n\n /** Makes the next load reread the project. The loaded boards keep serving sync reads until then. */\n invalidate(scope: StoredBoardScope): void {\n const key = scopeKey(scope);\n this.#generations.set(key, (this.#generations.get(key) ?? 0) + 1);\n this.#loading.delete(key);\n const entry = this.#entries.get(key);\n if (entry) entry.checkedAt = Number.NEGATIVE_INFINITY;\n }\n\n /** Loads every project, a few at a time, so sync reads find them warm and each has its boards stored. */\n async preload(): Promise<void> {\n const projects = (await this.#projects?.listAll()) ?? [];\n let next = 0;\n const worker = async () => {\n while (next < projects.length) {\n const project = projects[next++]!;\n // A project that fails to load here loads on first use; the others still load now.\n await this.load({ orgId: project.orgId, factoryProjectId: project.id }).catch(error =>\n this.#warn(\n `Boards for project ${project.id} did not load at startup; they load on first use: ${error instanceof Error ? error.message : String(error)}`,\n ),\n );\n }\n };\n await Promise.all(Array.from({ length: Math.min(PRELOAD_CONCURRENCY, projects.length) }, worker));\n }\n\n async #refresh(scope: StoredBoardScope, key: string, generation: number): Promise<ProjectBoards> {\n await this.#seed(scope, key);\n const current = this.#entries.get(key);\n const version = await this.#storage.readVersion(scope);\n const reviewInUse = (await this.#reviewBoardInUse?.(scope)) ?? false;\n if (current && current.version === version && current.reviewInUse === reviewInUse) {\n if ((this.#generations.get(key) ?? 0) === generation) current.checkedAt = this.#now();\n return current.boards;\n }\n const snapshot = await this.#consistentSnapshot(scope);\n const boards = this.#compile(scope, snapshot.boards, reviewInUse);\n if ((this.#generations.get(key) ?? 0) === generation) {\n this.#entries.set(key, { boards, version: snapshot.version, reviewInUse, checkedAt: this.#now() });\n }\n return boards;\n }\n\n /** Boards and phases are read in two statements; reread when a write landed between them. */\n async #consistentSnapshot(scope: StoredBoardScope) {\n let snapshot = await this.#storage.snapshot(scope);\n for (let attempt = 1; attempt < SNAPSHOT_ATTEMPTS; attempt++) {\n if ((await this.#storage.readVersion(scope)) === snapshot.version) break;\n snapshot = await this.#storage.snapshot(scope);\n }\n return snapshot;\n }\n\n /**\n * Stores the boards Factory hasn't stored in the project yet, once per process. A failure is\n * logged and retried on the next load; the boards it didn't store aren't served meanwhile.\n */\n async #seed(scope: StoredBoardScope, key: string): Promise<void> {\n if (this.#seeded.has(key)) return;\n try {\n // Read before seeding records Work's key: a project whose list lacked it has no Work of Factory's.\n const seeded = await this.#storage.seededBoardKeys(scope);\n if (this.#seeds.size > 0 || this.#appBoards.size > 0) {\n await this.#storage.seedBoards(scope, this.seeds(), {\n onlyIntoEmpty: this.#onlyIntoEmpty(),\n intoEmpty: [...this.#appBoards.values()],\n });\n }\n await this.#migrate(scope, seeded);\n this.#seeded.add(key);\n } catch (error) {\n this.#warnOnce(\n `seed:${key}`,\n `Boards for project ${scope.factoryProjectId} could not be stored; Factory stores them on the next load: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n }\n\n /** Runs the board migrations of the boards Factory stores here that the project hasn't had yet. */\n async #migrate(scope: StoredBoardScope, seededBefore: readonly string[] | null): Promise<void> {\n // A migration of one board rewrites Factory's own board; an app board under the same key keeps\n // its settings. One that carries a project setting into every board rewrites them all. A board\n // Factory never stored in the project (an app wrote the row first), or one the app upserts for\n // every project, is an app's: its one-board migrations are recorded as applied without running.\n const migrations = BOARD_MIGRATIONS.filter(migration => {\n if (migration.boardKey === null) return true;\n const code = this.codeRegistry.get(migration.boardKey);\n return code !== undefined && defaultBoards.includes(code);\n }).map(migration =>\n migration.boardKey !== null &&\n (this.#appBoards.has(migration.boardKey) || (seededBefore !== null && !seededBefore.includes(migration.boardKey)))\n ? { ...migration, migrate: () => undefined }\n : migration,\n );\n const changed = await this.#storage.applyBoardMigrations(scope, migrations, ops =>\n this.#migrationContext(scope, ops),\n );\n if (changed.length === 0) return;\n const filled = changed.map(({ boardKey, filled }) => `${boardKey}: ${filled.join(', ')}`).join('; ');\n console.info(`[factory] Migrated the boards of project ${scope.factoryProjectId} (${filled}).`);\n }\n\n /** Read through the migration transaction's `ops`, so card moves can't slip in unseen on LibSQL. */\n async #migrationContext(scope: StoredBoardScope, ops: FactoryStorageOps): Promise<BoardMigrationContext> {\n const retiredSettings =\n (await this.#projects?.retiredAutomationSettings?.({ orgId: scope.orgId, id: scope.factoryProjectId }, ops)) ??\n null;\n return {\n retiredSettings,\n occupiedPhases: retiredSettings && this.#occupiedPhases ? await this.#occupiedPhases(scope, ops) : null,\n codePhases: boardKey => {\n const code = this.codeRegistry.get(boardKey);\n return code ? new Set(Object.keys(code.phases)) : undefined;\n },\n warn: message =>\n this.#warnOnce(`migration:${scopeKey(scope)}:${message}`, `${message} (project ${scope.factoryProjectId})`),\n };\n }\n\n #compile(scope: StoredBoardScope, rows: readonly StoredBoardRecord[], reviewInUse: boolean): ProjectBoards {\n const byKey = new Map(rows.map(row => [row.key, row]));\n const details = new Map(this.#codeDetails);\n const problems: string[] = [];\n const report = (row: StoredBoardRecord, messages: readonly string[]) => {\n problems.push(...messages);\n for (const message of messages) {\n this.#warnOnce(\n `row:${scopeKey(scope)}:${row.key}:${row.revision}:${message}`,\n `${message} (project ${scope.factoryProjectId})`,\n );\n }\n };\n const boards: InstalledBoard[] = [];\n // Work and app boards keep their code order, each served from its row.\n for (const code of this.codeRegistry.values()) {\n const row = byKey.get(code.id);\n if (!row) {\n details.delete(code.id);\n // Stored once and deleted since, or not stored because storing failed.\n if (!this.#seeded.has(scopeKey(scope))) {\n problems.push(`Board \"${code.id}\" isn't stored in this project yet; Factory stores it on the next load.`);\n }\n continue;\n }\n let merged: ReturnType<typeof mergeCodeBehaviour>;\n try {\n merged = mergeCodeBehaviour(row, code);\n } catch (error) {\n report(row, [\n `Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`,\n ]);\n continue;\n }\n report(row, merged.problems);\n details.set(code.id, {\n ...details.get(code.id)!,\n problems: [...merged.problems, ...this.#skillProblems(merged.board)],\n });\n boards.push(merged.board);\n }\n // Served from code and never stored, so nobody edits a board on its way out.\n if (reviewInUse) {\n boards.push(reviewBoard);\n details.set(reviewBoard.id, { source: 'builtin', editable: false, problems: [] });\n }\n for (const row of rows) {\n if (this.codeRegistry.has(row.key)) continue;\n if (row.key === LEGACY_REVIEW_BOARD) {\n // Factory seeded this row while Review was a built-in board and nobody edited it since:\n // there is nothing in it to lose, so it is no problem. A person's edits are reported.\n if (isUntouchedReviewSeed(row)) continue;\n report(row, [\n reviewInUse\n ? `Stored board \"${row.key}\" is hidden by the code board with the same key.`\n : RESERVED_REVIEW_ROW,\n ]);\n continue;\n }\n let board: InstalledBoard;\n try {\n board = compileStoredBoard(row);\n } catch (error) {\n report(row, [\n `Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`,\n ]);\n continue;\n }\n boards.push(board);\n details.set(row.key, { source: 'stored', editable: true, problems: this.#skillProblems(board) });\n }\n return {\n registry: boardRegistryOf(boards),\n details,\n problems,\n };\n }\n\n #skillProblems(board: InstalledBoard): string[] {\n return findBoardSkillProblems(boardRegistryOf([board]), this.#codeSkills);\n }\n\n #warnOnce(key: string, message: string, debug = false): void {\n if (this.#warned.has(key)) return;\n this.#warned.add(key);\n if (debug) {\n console.debug(`[factory] ${message}`);\n return;\n }\n this.#warn(message);\n }\n}\n"],"mappings":";;;;;;;;;;;AAwBA,MAAM,qBAAqB;;AAE3B,MAAM,sBAAsB,iBAAiB,oBAAoB;AACjE,MAAM,sBAAsB;;AAE5B,MAAM,qBAAqB,kBAAkB,WAAW,CAAC,CAAC,OAAO,KAAK,EAAE,KAAK,MAAM,YAAY;CAAE;CAAK;CAAM;AAAK,EAAE;;;;;AAMnH,SAAS,sBAAsB,KAAiC;CAC9D,IAAI,IAAI,aAAa,KAAK,IAAI,cAAA,WAA0C,OAAO;CAC/E,IAAI,IAAI,cAAA,aAA4C,IAAI,SAAS,YAAY,MAAM,OAAO;CAC1F,MAAM,SAAS,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;CACrE,OACE,OAAO,WAAW,mBAAmB,UACrC,OAAO,OACJ,OAAO,UACN,MAAM,QAAQ,mBAAmB,MAAM,CAAE,OACzC,MAAM,SAAS,mBAAmB,MAAM,CAAE,QAC1C,MAAM,SAAS,mBAAmB,MAAM,CAAE,IAC9C;AAEJ;AACA,MAAM,oBAAoB;;;;;;AAO1B,MAAa,yBAAyB;AAoBtC,MAAM,uBAAuB,OAAO,oBAAoB;;AAgBxD,SAAgB,cAAc,QAA4E;CACxG,MAAM,SAAS,UAAU,oBAAoB;CAC7C,IAAI,cAAc,MAAM,GAAG,OAAO;CAClC,OAAO;GACJ,uBAAuB;EACxB,cAAc;EACd,MAAM,YAAY;EAClB,kBAAkB;CACpB;AACF;AAEA,SAAS,cAAc,QAA0E;CAC/F,OAAO,wBAAwB;AACjC;AAwCA,SAAS,SAAS,OAAiC;CACjD,OAAO,GAAG,MAAM,MAAM,IAAI,MAAM;AAClC;;;;;AAMA,SAAgB,iBAAiB,WAAyE;CACxG,OAAO,OACL,OACA,QAC6D;EAC7D,IAAI,UAAU,uBAAuB,OAAO;EAC5C,MAAM,2BAAW,IAAI,IAAyB;EAC9C,KAAK,MAAM,QAAQ,MAAM,UAAU,SAAS,KAAK,KAAK,GAAG;GACvD,MAAM,QAAQ,iBAAiB,IAAI;GACnC,MAAM,SAAS,SAAS,IAAI,KAAK,qBAAK,IAAI,IAAY;GACtD,KAAK,MAAM,SAAS,KAAK,QAAQ,OAAO,IAAI,KAAK;GACjD,SAAS,IAAI,OAAO,MAAM;EAC5B;EACA,OAAO;CACT;AACF;;;;;;;;;;;;AAaA,IAAa,oBAAb,MAA6D;CAC3D,CAAU,wBAAwB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACA,2BAAoB,IAAI,IAAwB;CAChD,2BAAoB,IAAI,IAAoC;CAC5D,+BAAwB,IAAI,IAAoB;CAChD,0BAAmB,IAAI,IAAY;CACnC,0BAAmB,IAAI,IAAY;CACnC;CACA;;CAEA,6BAAsB,IAAI,IAA8B;CACxD;CACA;CAEA,YAAY,SAAmC;EAC7C,KAAK,eAAe,QAAQ;EAC5B,KAAK,WAAW,QAAQ;EACxB,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAC/B,KAAK,YAAY,QAAQ;EACzB,KAAK,cAAc,QAAQ,cAAc,CAAC;EAC1C,KAAK,aAAa,QAAQ,aAAa;EACvC,KAAK,OAAO,QAAQ,OAAO,KAAK;EAChC,KAAK,QAAQ,QAAQ,UAAS,YAAW,QAAQ,KAAK,aAAa,SAAS;EAC5E,KAAK,eAAe,IAAI,IACtB,CAAC,GAAG,KAAK,aAAa,OAAO,CAAC,CAAC,CAAC,KAAI,UAAS,CAC3C,MAAM,IACN;GACE,QAAQ,cAAc,SAAS,KAAK,IAAI,YAAY;GACpD,UAAU;GACV,UAAU,KAAK,eAAe,KAAK;EACrC,CACF,CAAC,CACH;EACA,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,KAAK,aAAa,OAAO,CAAC,CAAC,CAAC,KAAI,UAAS,CAAC,MAAM,IAAI,kBAAkB,KAAK,CAAC,CAAC,CAAC;CAC1G;;;;;CAMA,QAA4B;EAC1B,OAAO,CAAC,GAAG,KAAK,OAAO,OAAO,CAAC,CAAC,CAAC,KAAI,SAAS,KAAK,eAAe,KAAK,GAAG,IAAI,mBAAmB,IAAI,IAAK;CAC5G;;;;;;;CAQA,QAAQ,KAAa,KAA0E;EAC7F,MAAM,MAAM,KAAK,WAAW,IAAI,GAAG;EACnC,IAAI,KAAK,OAAO;EAChB,MAAM,OAAO,KAAK,OAAO,IAAI,GAAG;EAChC,IAAI,CAAC,QAAQ,CAAC,KAAK,eAAe,GAAG,KAAK,KAAK,cAAA,uBAAsC,OAAO;EAC5F,OAAO,mBAAmB;CAC5B;;;;;CAMA,MAAM,eAAe,OAAiD;EACpE,IAAI,KAAK,OAAO,OAAO,KAAK,KAAK,WAAW,OAAO,GACjD,MAAM,KAAK,SAAS,WAAW,OAAO,CAAC,GAAG,KAAK,OAAO,OAAO,CAAC,GAAG;GAC/D,OAAO;GACP,eAAe,KAAK,eAAe;GACnC,WAAW,CAAC,GAAG,KAAK,WAAW,OAAO,CAAC;EACzC,CAAC;EAEH,OAAO,KAAK,SAAS,KAAK;CAC5B;;;;;;;CAQA,4BAA4B,OAA+B;EACzD,KAAK,WAAW,IAAI,MAAM,KAAK,KAAK;CACtC;;CAGA,eAAe,KAAsB;EACnC,OAAO,QAAQ,UAAU,MAAM,KAAK,aAAa,IAAI,GAAG,MAAM;CAChE;;CAGA,iBAA2B;EACzB,OAAO,KAAK,eAAe,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;CAC/D;CAEA,MAAM,KAAK,OAAiD;EAC1D,QAAQ,MAAM,KAAK,SAAS,KAAK,EAAA,CAAG;CACtC;;CAGA,MAAM,SAAS,OAAiD;EAC9D,MAAM,MAAM,SAAS,KAAK;EAC1B,MAAM,QAAQ,KAAK,SAAS,IAAI,GAAG;EACnC,IAAI,SAAS,KAAK,KAAK,IAAI,MAAM,YAAY,KAAK,YAAY,OAAO,MAAM;EAC3E,MAAM,WAAW,KAAK,SAAS,IAAI,GAAG;EACtC,IAAI,UAAU,OAAO;EACrB,MAAM,aAAa,KAAK,aAAa,IAAI,GAAG,KAAK;EACjD,MAAM,UAAU,KAAK,SAAS,OAAO,KAAK,UAAU,CAAC,CAAC,cAAc;GAClE,IAAI,KAAK,SAAS,IAAI,GAAG,MAAM,SAAS,KAAK,SAAS,OAAO,GAAG;EAClE,CAAC;EACD,KAAK,SAAS,IAAI,KAAK,OAAO;EAC9B,OAAO;CACT;;;;;;CAOA,WAAW,OAAwC;EAGjD,IAAI,CAAC,MAAM,SAAS,CAAC,MAAM,kBAAkB,OAAO,KAAK;EACzD,MAAM,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,CAAC;EAC/C,IAAI,OAAO,OAAO,MAAM,OAAO;EAE/B,KAAU,KAAK,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;EACpC,KAAK,UACH,QAAQ,SAAS,KAAK,KACtB,sBAAsB,MAAM,iBAAiB,6DAC7C,IACF;EACA,OAAO,KAAK;CACd;;CAGA,IAAI,aAAqC;EACvC,OAAO,KAAK;CACd;;CAGA,WAAW,OAA+B;EACxC,MAAM,MAAM,SAAS,KAAK;EAC1B,KAAK,aAAa,IAAI,MAAM,KAAK,aAAa,IAAI,GAAG,KAAK,KAAK,CAAC;EAChE,KAAK,SAAS,OAAO,GAAG;EACxB,MAAM,QAAQ,KAAK,SAAS,IAAI,GAAG;EACnC,IAAI,OAAO,MAAM,YAAY,OAAO;CACtC;;CAGA,MAAM,UAAyB;EAC7B,MAAM,WAAY,MAAM,KAAK,WAAW,QAAQ,KAAM,CAAC;EACvD,IAAI,OAAO;EACX,MAAM,SAAS,YAAY;GACzB,OAAO,OAAO,SAAS,QAAQ;IAC7B,MAAM,UAAU,SAAS;IAEzB,MAAM,KAAK,KAAK;KAAE,OAAO,QAAQ;KAAO,kBAAkB,QAAQ;IAAG,CAAC,CAAC,CAAC,OAAM,UAC5E,KAAK,MACH,sBAAsB,QAAQ,GAAG,oDAAoD,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAC5I,CACF;GACF;EACF;EACA,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,qBAAqB,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC;CAClG;CAEA,MAAM,SAAS,OAAyB,KAAa,YAA4C;EAC/F,MAAM,KAAK,MAAM,OAAO,GAAG;EAC3B,MAAM,UAAU,KAAK,SAAS,IAAI,GAAG;EACrC,MAAM,UAAU,MAAM,KAAK,SAAS,YAAY,KAAK;EACrD,MAAM,cAAe,MAAM,KAAK,oBAAoB,KAAK,KAAM;EAC/D,IAAI,WAAW,QAAQ,YAAY,WAAW,QAAQ,gBAAgB,aAAa;GACjF,KAAK,KAAK,aAAa,IAAI,GAAG,KAAK,OAAO,YAAY,QAAQ,YAAY,KAAK,KAAK;GACpF,OAAO,QAAQ;EACjB;EACA,MAAM,WAAW,MAAM,KAAK,oBAAoB,KAAK;EACrD,MAAM,SAAS,KAAK,SAAS,OAAO,SAAS,QAAQ,WAAW;EAChE,KAAK,KAAK,aAAa,IAAI,GAAG,KAAK,OAAO,YACxC,KAAK,SAAS,IAAI,KAAK;GAAE;GAAQ,SAAS,SAAS;GAAS;GAAa,WAAW,KAAK,KAAK;EAAE,CAAC;EAEnG,OAAO;CACT;;CAGA,MAAM,oBAAoB,OAAyB;EACjD,IAAI,WAAW,MAAM,KAAK,SAAS,SAAS,KAAK;EACjD,KAAK,IAAI,UAAU,GAAG,UAAU,mBAAmB,WAAW;GAC5D,IAAK,MAAM,KAAK,SAAS,YAAY,KAAK,MAAO,SAAS,SAAS;GACnE,WAAW,MAAM,KAAK,SAAS,SAAS,KAAK;EAC/C;EACA,OAAO;CACT;;;;;CAMA,MAAM,MAAM,OAAyB,KAA4B;EAC/D,IAAI,KAAK,QAAQ,IAAI,GAAG,GAAG;EAC3B,IAAI;GAEF,MAAM,SAAS,MAAM,KAAK,SAAS,gBAAgB,KAAK;GACxD,IAAI,KAAK,OAAO,OAAO,KAAK,KAAK,WAAW,OAAO,GACjD,MAAM,KAAK,SAAS,WAAW,OAAO,KAAK,MAAM,GAAG;IAClD,eAAe,KAAK,eAAe;IACnC,WAAW,CAAC,GAAG,KAAK,WAAW,OAAO,CAAC;GACzC,CAAC;GAEH,MAAM,KAAK,SAAS,OAAO,MAAM;GACjC,KAAK,QAAQ,IAAI,GAAG;EACtB,SAAS,OAAO;GACd,KAAK,UACH,QAAQ,OACR,sBAAsB,MAAM,iBAAiB,8DAA8D,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAClK;EACF;CACF;;CAGA,MAAM,SAAS,OAAyB,cAAuD;EAK7F,MAAM,aAAa,iBAAiB,QAAO,cAAa;GACtD,IAAI,UAAU,aAAa,MAAM,OAAO;GACxC,MAAM,OAAO,KAAK,aAAa,IAAI,UAAU,QAAQ;GACrD,OAAO,SAAS,KAAA,KAAa,cAAc,SAAS,IAAI;EAC1D,CAAC,CAAC,CAAC,KAAI,cACL,UAAU,aAAa,SACtB,KAAK,WAAW,IAAI,UAAU,QAAQ,KAAM,iBAAiB,QAAQ,CAAC,aAAa,SAAS,UAAU,QAAQ,KAC3G;GAAE,GAAG;GAAW,eAAe,KAAA;EAAU,IACzC,SACN;EACA,MAAM,UAAU,MAAM,KAAK,SAAS,qBAAqB,OAAO,aAAY,QAC1E,KAAK,kBAAkB,OAAO,GAAG,CACnC;EACA,IAAI,QAAQ,WAAW,GAAG;EAC1B,MAAM,SAAS,QAAQ,KAAK,EAAE,UAAU,aAAa,GAAG,SAAS,IAAI,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI;EACnG,QAAQ,KAAK,4CAA4C,MAAM,iBAAiB,IAAI,OAAO,GAAG;CAChG;;CAGA,MAAM,kBAAkB,OAAyB,KAAwD;EACvG,MAAM,kBACH,MAAM,KAAK,WAAW,4BAA4B;GAAE,OAAO,MAAM;GAAO,IAAI,MAAM;EAAiB,GAAG,GAAG,KAC1G;EACF,OAAO;GACL;GACA,gBAAgB,mBAAmB,KAAK,kBAAkB,MAAM,KAAK,gBAAgB,OAAO,GAAG,IAAI;GACnG,aAAY,aAAY;IACtB,MAAM,OAAO,KAAK,aAAa,IAAI,QAAQ;IAC3C,OAAO,OAAO,IAAI,IAAI,OAAO,KAAK,KAAK,MAAM,CAAC,IAAI,KAAA;GACpD;GACA,OAAM,YACJ,KAAK,UAAU,aAAa,SAAS,KAAK,EAAE,GAAG,WAAW,GAAG,QAAQ,YAAY,MAAM,iBAAiB,EAAE;EAC9G;CACF;CAEA,SAAS,OAAyB,MAAoC,aAAqC;EACzG,MAAM,QAAQ,IAAI,IAAI,KAAK,KAAI,QAAO,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;EACrD,MAAM,UAAU,IAAI,IAAI,KAAK,YAAY;EACzC,MAAM,WAAqB,CAAC;EAC5B,MAAM,UAAU,KAAwB,aAAgC;GACtE,SAAS,KAAK,GAAG,QAAQ;GACzB,KAAK,MAAM,WAAW,UACpB,KAAK,UACH,OAAO,SAAS,KAAK,EAAE,GAAG,IAAI,IAAI,GAAG,IAAI,SAAS,GAAG,WACrD,GAAG,QAAQ,YAAY,MAAM,iBAAiB,EAChD;EAEJ;EACA,MAAM,SAA2B,CAAC;EAElC,KAAK,MAAM,QAAQ,KAAK,aAAa,OAAO,GAAG;GAC7C,MAAM,MAAM,MAAM,IAAI,KAAK,EAAE;GAC7B,IAAI,CAAC,KAAK;IACR,QAAQ,OAAO,KAAK,EAAE;IAEtB,IAAI,CAAC,KAAK,QAAQ,IAAI,SAAS,KAAK,CAAC,GACnC,SAAS,KAAK,UAAU,KAAK,GAAG,wEAAwE;IAE1G;GACF;GACA,IAAI;GACJ,IAAI;IACF,SAAS,mBAAmB,KAAK,IAAI;GACvC,SAAS,OAAO;IACd,OAAO,KAAK,CACV,UAAU,IAAI,IAAI,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAClG,CAAC;IACD;GACF;GACA,OAAO,KAAK,OAAO,QAAQ;GAC3B,QAAQ,IAAI,KAAK,IAAI;IACnB,GAAG,QAAQ,IAAI,KAAK,EAAE;IACtB,UAAU,CAAC,GAAG,OAAO,UAAU,GAAG,KAAK,eAAe,OAAO,KAAK,CAAC;GACrE,CAAC;GACD,OAAO,KAAK,OAAO,KAAK;EAC1B;EAEA,IAAI,aAAa;GACf,OAAO,KAAK,WAAW;GACvB,QAAQ,IAAI,YAAY,IAAI;IAAE,QAAQ;IAAW,UAAU;IAAO,UAAU,CAAC;GAAE,CAAC;EAClF;EACA,KAAK,MAAM,OAAO,MAAM;GACtB,IAAI,KAAK,aAAa,IAAI,IAAI,GAAG,GAAG;GACpC,IAAI,IAAI,QAAA,UAA6B;IAGnC,IAAI,sBAAsB,GAAG,GAAG;IAChC,OAAO,KAAK,CACV,cACI,iBAAiB,IAAI,IAAI,oDACzB,mBACN,CAAC;IACD;GACF;GACA,IAAI;GACJ,IAAI;IACF,QAAQ,mBAAmB,GAAG;GAChC,SAAS,OAAO;IACd,OAAO,KAAK,CACV,UAAU,IAAI,IAAI,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAClG,CAAC;IACD;GACF;GACA,OAAO,KAAK,KAAK;GACjB,QAAQ,IAAI,IAAI,KAAK;IAAE,QAAQ;IAAU,UAAU;IAAM,UAAU,KAAK,eAAe,KAAK;GAAE,CAAC;EACjG;EACA,OAAO;GACL,UAAU,gBAAgB,MAAM;GAChC;GACA;EACF;CACF;CAEA,eAAe,OAAiC;EAC9C,OAAO,uBAAuB,gBAAgB,CAAC,KAAK,CAAC,GAAG,KAAK,WAAW;CAC1E;CAEA,UAAU,KAAa,SAAiB,QAAQ,OAAa;EAC3D,IAAI,KAAK,QAAQ,IAAI,GAAG,GAAG;EAC3B,KAAK,QAAQ,IAAI,GAAG;EACpB,IAAI,OAAO;GACT,QAAQ,MAAM,aAAa,SAAS;GACpC;EACF;EACA,KAAK,MAAM,OAAO;CACpB;AACF"}
@@ -9,8 +9,14 @@ export interface BoardRegistry extends Iterable<[string, InstalledBoard]> {
9
9
  entries(): MapIterator<[string, InstalledBoard]>;
10
10
  }
11
11
  export declare const defaultBoards: readonly InstalledBoard[];
12
+ /**
13
+ * Factory's boards: its Work board, then `boards`. Work is always installed; to run another Work,
14
+ * store it under the `work` key with `factory.upsertBoard()`. The exported `workBoard` itself is
15
+ * accepted in `boards` and installed once.
16
+ */
12
17
  export declare function createBoardRegistry(options?: {
13
18
  boards?: readonly InstalledBoard[];
14
- includeDefaultBoards?: boolean;
15
19
  }): BoardRegistry;
20
+ /** A registry of exactly `boards`, in order, such as the boards a project stored. */
21
+ export declare function boardRegistryOf(boards: readonly InstalledBoard[]): BoardRegistry;
16
22
  //# sourceMappingURL=registry.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/boards/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,WAAW,aAAc,SAAQ,QAAQ,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;IACtC,OAAO,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,aAAa,EAA8C,SAAS,cAAc,EAAE,CAAC;AAElG,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC3B,GACL,aAAa,CAoBf"}
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/boards/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,WAAW,aAAc,SAAQ,QAAQ,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;IACtC,OAAO,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,aAAa,EAAiC,SAAS,cAAc,EAAE,CAAC;AAErF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;CAAO,GAAG,aAAa,CAYvG;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,CAwBhF"}