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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (646) hide show
  1. package/README.md +361 -162
  2. package/dist/auth.d.ts.map +1 -1
  3. package/dist/auth.js +12 -6
  4. package/dist/auth.js.map +1 -1
  5. package/dist/boards/board-events.d.ts +23 -3
  6. package/dist/boards/board-events.d.ts.map +1 -1
  7. package/dist/boards/board-events.js +44 -7
  8. package/dist/boards/board-events.js.map +1 -1
  9. package/dist/boards/board-writes.d.ts +2 -2
  10. package/dist/boards/board-writes.d.ts.map +1 -1
  11. package/dist/boards/board-writes.js +23 -9
  12. package/dist/boards/board-writes.js.map +1 -1
  13. package/dist/boards/card-facts.d.ts +3 -1
  14. package/dist/boards/card-facts.d.ts.map +1 -1
  15. package/dist/boards/card-facts.js +30 -4
  16. package/dist/boards/card-facts.js.map +1 -1
  17. package/dist/boards/default-board.d.ts +7 -0
  18. package/dist/boards/default-board.d.ts.map +1 -0
  19. package/dist/boards/default-board.js +10 -0
  20. package/dist/boards/default-board.js.map +1 -0
  21. package/dist/boards/define-board.d.ts +40 -18
  22. package/dist/boards/define-board.d.ts.map +1 -1
  23. package/dist/boards/define-board.js +64 -42
  24. package/dist/boards/define-board.js.map +1 -1
  25. package/dist/boards/index.d.ts +6 -9
  26. package/dist/boards/index.d.ts.map +1 -1
  27. package/dist/boards/index.js +6 -20
  28. package/dist/boards/intake-routing.d.ts +29 -9
  29. package/dist/boards/intake-routing.d.ts.map +1 -1
  30. package/dist/boards/intake-routing.js +72 -20
  31. package/dist/boards/intake-routing.js.map +1 -1
  32. package/dist/boards/legacy-plan-role.d.ts.map +1 -1
  33. package/dist/boards/legacy-plan-role.js +7 -2
  34. package/dist/boards/legacy-plan-role.js.map +1 -1
  35. package/dist/boards/phase-automation.d.ts +7 -0
  36. package/dist/boards/phase-automation.d.ts.map +1 -1
  37. package/dist/boards/phase-automation.js +16 -5
  38. package/dist/boards/phase-automation.js.map +1 -1
  39. package/dist/boards/phase-runner.d.ts +18 -10
  40. package/dist/boards/phase-runner.d.ts.map +1 -1
  41. package/dist/boards/phase-runner.js +39 -34
  42. package/dist/boards/phase-runner.js.map +1 -1
  43. package/dist/boards/project-boards.d.ts +57 -11
  44. package/dist/boards/project-boards.d.ts.map +1 -1
  45. package/dist/boards/project-boards.js +161 -34
  46. package/dist/boards/project-boards.js.map +1 -1
  47. package/dist/boards/registry.d.ts +7 -1
  48. package/dist/boards/registry.d.ts.map +1 -1
  49. package/dist/boards/registry.js +19 -4
  50. package/dist/boards/registry.js.map +1 -1
  51. package/dist/boards/relocate.d.ts +1 -1
  52. package/dist/boards/relocate.d.ts.map +1 -1
  53. package/dist/boards/relocate.js +3 -2
  54. package/dist/boards/relocate.js.map +1 -1
  55. package/dist/boards/review.d.ts +5 -2
  56. package/dist/boards/review.d.ts.map +1 -1
  57. package/dist/boards/review.js +12 -11
  58. package/dist/boards/review.js.map +1 -1
  59. package/dist/boards/semantics.d.ts +160 -20
  60. package/dist/boards/semantics.d.ts.map +1 -1
  61. package/dist/boards/semantics.js +255 -23
  62. package/dist/boards/semantics.js.map +1 -1
  63. package/dist/boards/stored-board.d.ts +32 -18
  64. package/dist/boards/stored-board.d.ts.map +1 -1
  65. package/dist/boards/stored-board.js +31 -97
  66. package/dist/boards/stored-board.js.map +1 -1
  67. package/dist/boards/work-migrations.d.ts +43 -0
  68. package/dist/boards/work-migrations.d.ts.map +1 -0
  69. package/dist/boards/work-migrations.js +353 -0
  70. package/dist/boards/work-migrations.js.map +1 -0
  71. package/dist/boards/work-routes.d.ts +58 -0
  72. package/dist/boards/work-routes.d.ts.map +1 -0
  73. package/dist/boards/work-routes.js +270 -0
  74. package/dist/boards/work-routes.js.map +1 -0
  75. package/dist/boards/work-seeds.d.ts +9 -0
  76. package/dist/boards/work-seeds.d.ts.map +1 -0
  77. package/dist/boards/work-seeds.js +56 -0
  78. package/dist/boards/work-seeds.js.map +1 -0
  79. package/dist/boards/work.d.ts +8 -19
  80. package/dist/boards/work.d.ts.map +1 -1
  81. package/dist/boards/work.js +33 -281
  82. package/dist/boards/work.js.map +1 -1
  83. package/dist/environment/build-runner.d.ts.map +1 -1
  84. package/dist/environment/build-runner.js +2 -2
  85. package/dist/environment/build-runner.js.map +1 -1
  86. package/dist/environment/build-workflow.d.ts.map +1 -1
  87. package/dist/environment/build-workflow.js +6 -5
  88. package/dist/environment/build-workflow.js.map +1 -1
  89. package/dist/environment/build.d.ts +15 -2
  90. package/dist/environment/build.d.ts.map +1 -1
  91. package/dist/environment/build.js +32 -9
  92. package/dist/environment/build.js.map +1 -1
  93. package/dist/factory.d.ts +34 -7
  94. package/dist/factory.d.ts.map +1 -1
  95. package/dist/factory.js +161 -133
  96. package/dist/factory.js.map +1 -1
  97. package/dist/feed-events.d.ts +4 -4
  98. package/dist/feed-events.d.ts.map +1 -1
  99. package/dist/feed-events.js +6 -6
  100. package/dist/feed-events.js.map +1 -1
  101. package/dist/index.d.ts +7 -2
  102. package/dist/index.d.ts.map +1 -1
  103. package/dist/index.js +5 -3
  104. package/dist/integrations/base.d.ts +6 -13
  105. package/dist/integrations/base.d.ts.map +1 -1
  106. package/dist/integrations/closing-references.d.ts +15 -0
  107. package/dist/integrations/closing-references.d.ts.map +1 -0
  108. package/dist/integrations/closing-references.js +69 -0
  109. package/dist/integrations/closing-references.js.map +1 -0
  110. package/dist/integrations/github/default-rules.d.ts +15 -66
  111. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  112. package/dist/integrations/github/default-rules.js +129 -73
  113. package/dist/integrations/github/default-rules.js.map +1 -1
  114. package/dist/integrations/github/integration.d.ts.map +1 -1
  115. package/dist/integrations/github/integration.js +7 -3
  116. package/dist/integrations/github/integration.js.map +1 -1
  117. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  118. package/dist/integrations/github/issue-reconciler.js +5 -3
  119. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  120. package/dist/integrations/github/provenance.js +1 -1
  121. package/dist/integrations/github/provenance.js.map +1 -1
  122. package/dist/integrations/github/pull-request-source.d.ts +8 -0
  123. package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
  124. package/dist/integrations/github/pull-request-source.js +17 -0
  125. package/dist/integrations/github/pull-request-source.js.map +1 -0
  126. package/dist/integrations/github/reconcile-worker.d.ts +5 -1
  127. package/dist/integrations/github/reconcile-worker.d.ts.map +1 -1
  128. package/dist/integrations/github/reconcile-worker.js +39 -6
  129. package/dist/integrations/github/reconcile-worker.js.map +1 -1
  130. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -1
  131. package/dist/integrations/github/review-status-reporter.js +7 -3
  132. package/dist/integrations/github/review-status-reporter.js.map +1 -1
  133. package/dist/integrations/github/routes.d.ts +4 -3
  134. package/dist/integrations/github/routes.d.ts.map +1 -1
  135. package/dist/integrations/github/routes.js +10 -87
  136. package/dist/integrations/github/routes.js.map +1 -1
  137. package/dist/integrations/github/rules.d.ts +79 -7
  138. package/dist/integrations/github/rules.d.ts.map +1 -1
  139. package/dist/integrations/github/rules.js +426 -102
  140. package/dist/integrations/github/rules.js.map +1 -1
  141. package/dist/integrations/github/sandbox.d.ts +10 -2
  142. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  143. package/dist/integrations/github/sandbox.js +20 -4
  144. package/dist/integrations/github/sandbox.js.map +1 -1
  145. package/dist/integrations/github/session-subscriptions.js +2 -2
  146. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  147. package/dist/integrations/github/token-refresh.d.ts +2 -1
  148. package/dist/integrations/github/token-refresh.d.ts.map +1 -1
  149. package/dist/integrations/github/token-refresh.js.map +1 -1
  150. package/dist/integrations/gitlab/agent-tools.js +1 -1
  151. package/dist/integrations/gitlab/default-rules.d.ts +73 -31
  152. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  153. package/dist/integrations/gitlab/default-rules.js +106 -43
  154. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  155. package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
  156. package/dist/integrations/gitlab/issue-reconciler.js +2 -1
  157. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  158. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  159. package/dist/integrations/gitlab/merge-request-reconciler.js +12 -5
  160. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  161. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  162. package/dist/integrations/gitlab/routes.js +1 -3
  163. package/dist/integrations/gitlab/routes.js.map +1 -1
  164. package/dist/integrations/gitlab/rules.d.ts +6 -1
  165. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  166. package/dist/integrations/gitlab/rules.js +119 -30
  167. package/dist/integrations/gitlab/rules.js.map +1 -1
  168. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  169. package/dist/integrations/incidentio/agent-tools.js +6 -6
  170. package/dist/integrations/incidentio/agent-tools.js.map +1 -1
  171. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  172. package/dist/integrations/incidentio/default-rules.js +3 -3
  173. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  174. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  175. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  176. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  177. package/dist/integrations/incidentio/routes.d.ts +2 -2
  178. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  179. package/dist/integrations/incidentio/routes.js +10 -13
  180. package/dist/integrations/incidentio/routes.js.map +1 -1
  181. package/dist/integrations/incidentio/rules.d.ts +4 -4
  182. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  183. package/dist/integrations/incidentio/rules.js +18 -14
  184. package/dist/integrations/incidentio/rules.js.map +1 -1
  185. package/dist/integrations/issue-reconciler.js +1 -1
  186. package/dist/integrations/issue-reconciler.js.map +1 -1
  187. package/dist/integrations/jira/agent-tools.js +1 -1
  188. package/dist/integrations/jira/binding-scope.d.ts +5 -6
  189. package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
  190. package/dist/integrations/jira/binding-scope.js +9 -11
  191. package/dist/integrations/jira/binding-scope.js.map +1 -1
  192. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  193. package/dist/integrations/jira/default-rules.js +3 -3
  194. package/dist/integrations/jira/default-rules.js.map +1 -1
  195. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  196. package/dist/integrations/jira/issue-reconciler.js +2 -1
  197. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  198. package/dist/integrations/jira/routes.d.ts.map +1 -1
  199. package/dist/integrations/jira/routes.js +3 -5
  200. package/dist/integrations/jira/routes.js.map +1 -1
  201. package/dist/integrations/jira/rules.d.ts +4 -4
  202. package/dist/integrations/jira/rules.d.ts.map +1 -1
  203. package/dist/integrations/jira/rules.js +18 -14
  204. package/dist/integrations/jira/rules.js.map +1 -1
  205. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  206. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  207. package/dist/integrations/linear/agent-tools.js +81 -3
  208. package/dist/integrations/linear/agent-tools.js.map +1 -1
  209. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  210. package/dist/integrations/linear/default-rules.js +3 -3
  211. package/dist/integrations/linear/default-rules.js.map +1 -1
  212. package/dist/integrations/linear/integration.d.ts +4 -1
  213. package/dist/integrations/linear/integration.d.ts.map +1 -1
  214. package/dist/integrations/linear/integration.js +21 -1
  215. package/dist/integrations/linear/integration.js.map +1 -1
  216. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  217. package/dist/integrations/linear/issue-reconciler.js +2 -1
  218. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  219. package/dist/integrations/linear/routes.d.ts +2 -1
  220. package/dist/integrations/linear/routes.d.ts.map +1 -1
  221. package/dist/integrations/linear/routes.js +15 -17
  222. package/dist/integrations/linear/routes.js.map +1 -1
  223. package/dist/integrations/linear/rules.d.ts +4 -4
  224. package/dist/integrations/linear/rules.d.ts.map +1 -1
  225. package/dist/integrations/linear/rules.js +16 -15
  226. package/dist/integrations/linear/rules.js.map +1 -1
  227. package/dist/integrations/platform/connect/session-tools.d.ts +5 -0
  228. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
  229. package/dist/integrations/platform/connect/session-tools.js +5 -0
  230. package/dist/integrations/platform/connect/session-tools.js.map +1 -1
  231. package/dist/integrations/platform/github/event-worker.d.ts +4 -1
  232. package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
  233. package/dist/integrations/platform/github/event-worker.js +39 -3
  234. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  235. package/dist/integrations/platform/github/integration.d.ts +8 -0
  236. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  237. package/dist/integrations/platform/github/integration.js +131 -87
  238. package/dist/integrations/platform/github/integration.js.map +1 -1
  239. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  240. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  241. package/dist/integrations/platform/jira/routes.js +3 -5
  242. package/dist/integrations/platform/jira/routes.js.map +1 -1
  243. package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
  244. package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
  245. package/dist/integrations/platform/linear/event-worker.js +1 -1
  246. package/dist/integrations/platform/linear/event-worker.js.map +1 -1
  247. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  248. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  249. package/dist/integrations/platform/linear/integration.js +6 -5
  250. package/dist/integrations/platform/linear/integration.js.map +1 -1
  251. package/dist/integrations/slack/chat-tools.js +1 -1
  252. package/dist/integrations/slack/integration.d.ts +0 -2
  253. package/dist/integrations/slack/integration.d.ts.map +1 -1
  254. package/dist/integrations/slack/integration.js +0 -5
  255. package/dist/integrations/slack/integration.js.map +1 -1
  256. package/dist/integrations/slack/reply-tool.js +1 -1
  257. package/dist/integrations/slack/run-error-card.js +1 -0
  258. package/dist/integrations/slack/run-error-card.js.map +1 -1
  259. package/dist/integrations/slack/share-file-tool.js +1 -1
  260. package/dist/integrations/slack/slack.d.ts +13 -22
  261. package/dist/integrations/slack/slack.d.ts.map +1 -1
  262. package/dist/integrations/slack/slack.js +22 -83
  263. package/dist/integrations/slack/slack.js.map +1 -1
  264. package/dist/links.d.ts +1 -2
  265. package/dist/links.d.ts.map +1 -1
  266. package/dist/links.js +4 -4
  267. package/dist/links.js.map +1 -1
  268. package/dist/mcp/routes.js +3 -3
  269. package/dist/mcp/routes.js.map +1 -1
  270. package/dist/provider-display-name.d.ts.map +1 -1
  271. package/dist/provider-display-name.js +1 -0
  272. package/dist/provider-display-name.js.map +1 -1
  273. package/dist/routes/attention-parked.d.ts +1 -0
  274. package/dist/routes/attention-parked.d.ts.map +1 -1
  275. package/dist/routes/attention-parked.js +2 -2
  276. package/dist/routes/attention-parked.js.map +1 -1
  277. package/dist/routes/attention-providers.d.ts +0 -25
  278. package/dist/routes/attention-providers.d.ts.map +1 -1
  279. package/dist/routes/attention-providers.js +2 -150
  280. package/dist/routes/attention-providers.js.map +1 -1
  281. package/dist/routes/attention.d.ts +0 -2
  282. package/dist/routes/attention.d.ts.map +1 -1
  283. package/dist/routes/attention.js +2 -13
  284. package/dist/routes/attention.js.map +1 -1
  285. package/dist/routes/automation-runs.d.ts +5 -1
  286. package/dist/routes/automation-runs.d.ts.map +1 -1
  287. package/dist/routes/automation-runs.js +15 -0
  288. package/dist/routes/automation-runs.js.map +1 -1
  289. package/dist/routes/board-snapshot.d.ts +15 -0
  290. package/dist/routes/board-snapshot.d.ts.map +1 -0
  291. package/dist/routes/board-snapshot.js +41 -0
  292. package/dist/routes/board-snapshot.js.map +1 -0
  293. package/dist/routes/boards.d.ts +2 -2
  294. package/dist/routes/boards.d.ts.map +1 -1
  295. package/dist/routes/boards.js +1 -17
  296. package/dist/routes/boards.js.map +1 -1
  297. package/dist/routes/config.d.ts +11 -1
  298. package/dist/routes/config.d.ts.map +1 -1
  299. package/dist/routes/config.js +120 -22
  300. package/dist/routes/config.js.map +1 -1
  301. package/dist/routes/contracts.d.ts +251 -51
  302. package/dist/routes/contracts.d.ts.map +1 -1
  303. package/dist/routes/contracts.js +120 -40
  304. package/dist/routes/contracts.js.map +1 -1
  305. package/dist/routes/feed-events.d.ts +15 -0
  306. package/dist/routes/feed-events.d.ts.map +1 -0
  307. package/dist/routes/feed-events.js +68 -0
  308. package/dist/routes/feed-events.js.map +1 -0
  309. package/dist/routes/fs.d.ts +4 -0
  310. package/dist/routes/fs.d.ts.map +1 -1
  311. package/dist/routes/fs.js +8 -4
  312. package/dist/routes/fs.js.map +1 -1
  313. package/dist/routes/intake-routes.d.ts.map +1 -1
  314. package/dist/routes/intake-routes.js +6 -1
  315. package/dist/routes/intake-routes.js.map +1 -1
  316. package/dist/routes/intake.d.ts +0 -23
  317. package/dist/routes/intake.d.ts.map +1 -1
  318. package/dist/routes/intake.js +13 -309
  319. package/dist/routes/intake.js.map +1 -1
  320. package/dist/routes/knowledge.js +1 -1
  321. package/dist/routes/mastra-gateway.d.ts +19 -0
  322. package/dist/routes/mastra-gateway.d.ts.map +1 -0
  323. package/dist/routes/mastra-gateway.js +120 -0
  324. package/dist/routes/mastra-gateway.js.map +1 -0
  325. package/dist/routes/projects.d.ts +1 -1
  326. package/dist/routes/projects.d.ts.map +1 -1
  327. package/dist/routes/projects.js +74 -58
  328. package/dist/routes/projects.js.map +1 -1
  329. package/dist/routes/provider-credentials.d.ts +6 -1
  330. package/dist/routes/provider-credentials.d.ts.map +1 -1
  331. package/dist/routes/provider-credentials.js +42 -7
  332. package/dist/routes/provider-credentials.js.map +1 -1
  333. package/dist/routes/route.d.ts +6 -0
  334. package/dist/routes/route.d.ts.map +1 -1
  335. package/dist/routes/route.js.map +1 -1
  336. package/dist/routes/running-packages.d.ts +13 -0
  337. package/dist/routes/running-packages.d.ts.map +1 -0
  338. package/dist/routes/running-packages.js +45 -0
  339. package/dist/routes/running-packages.js.map +1 -0
  340. package/dist/routes/sandbox-envs.d.ts +26 -0
  341. package/dist/routes/sandbox-envs.d.ts.map +1 -0
  342. package/dist/routes/sandbox-envs.js +180 -0
  343. package/dist/routes/sandbox-envs.js.map +1 -0
  344. package/dist/routes/session-access.d.ts.map +1 -1
  345. package/dist/routes/session-access.js +12 -3
  346. package/dist/routes/session-access.js.map +1 -1
  347. package/dist/routes/surface.d.ts +10 -8
  348. package/dist/routes/surface.d.ts.map +1 -1
  349. package/dist/routes/surface.js +105 -42
  350. package/dist/routes/surface.js.map +1 -1
  351. package/dist/routes/tenant-credentials.d.ts.map +1 -1
  352. package/dist/routes/tenant-credentials.js +5 -1
  353. package/dist/routes/tenant-credentials.js.map +1 -1
  354. package/dist/routes/work-items.d.ts +0 -3
  355. package/dist/routes/work-items.d.ts.map +1 -1
  356. package/dist/routes/work-items.js +38 -10
  357. package/dist/routes/work-items.js.map +1 -1
  358. package/dist/rules/binding-context.d.ts.map +1 -1
  359. package/dist/rules/binding-context.js +1 -0
  360. package/dist/rules/binding-context.js.map +1 -1
  361. package/dist/rules/dispatcher.d.ts +0 -9
  362. package/dist/rules/dispatcher.d.ts.map +1 -1
  363. package/dist/rules/dispatcher.js +362 -69
  364. package/dist/rules/dispatcher.js.map +1 -1
  365. package/dist/rules/event-rules.d.ts +33 -2
  366. package/dist/rules/event-rules.d.ts.map +1 -1
  367. package/dist/rules/event-rules.js +46 -11
  368. package/dist/rules/event-rules.js.map +1 -1
  369. package/dist/rules/index.d.ts +2 -4
  370. package/dist/rules/index.d.ts.map +1 -1
  371. package/dist/rules/index.js +2 -3
  372. package/dist/rules/phase-goal.d.ts +54 -0
  373. package/dist/rules/phase-goal.d.ts.map +1 -0
  374. package/dist/rules/phase-goal.js +70 -0
  375. package/dist/rules/phase-goal.js.map +1 -0
  376. package/dist/rules/phase-tools.d.ts +11 -0
  377. package/dist/rules/phase-tools.d.ts.map +1 -0
  378. package/dist/rules/phase-tools.js +19 -0
  379. package/dist/rules/phase-tools.js.map +1 -0
  380. package/dist/rules/processor.d.ts.map +1 -1
  381. package/dist/rules/processor.js +116 -15
  382. package/dist/rules/processor.js.map +1 -1
  383. package/dist/rules/review-source-tool.d.ts +4 -1
  384. package/dist/rules/review-source-tool.d.ts.map +1 -1
  385. package/dist/rules/review-source-tool.js +24 -4
  386. package/dist/rules/review-source-tool.js.map +1 -1
  387. package/dist/rules/rule-group.d.ts +1 -1
  388. package/dist/rules/rule-group.d.ts.map +1 -1
  389. package/dist/rules/rule-group.js +15 -6
  390. package/dist/rules/rule-group.js.map +1 -1
  391. package/dist/rules/start-coordinator.d.ts +5 -1
  392. package/dist/rules/start-coordinator.d.ts.map +1 -1
  393. package/dist/rules/start-coordinator.js +9 -3
  394. package/dist/rules/start-coordinator.js.map +1 -1
  395. package/dist/rules/tools.d.ts.map +1 -1
  396. package/dist/rules/tools.js +39 -28
  397. package/dist/rules/tools.js.map +1 -1
  398. package/dist/rules/transition-service.d.ts +4 -10
  399. package/dist/rules/transition-service.d.ts.map +1 -1
  400. package/dist/rules/transition-service.js +61 -55
  401. package/dist/rules/transition-service.js.map +1 -1
  402. package/dist/rules/types.d.ts +86 -36
  403. package/dist/rules/types.d.ts.map +1 -1
  404. package/dist/rules/types.js +5 -41
  405. package/dist/rules/types.js.map +1 -1
  406. package/dist/rules/validation.d.ts.map +1 -1
  407. package/dist/rules/validation.js +32 -2
  408. package/dist/rules/validation.js.map +1 -1
  409. package/dist/run-error.d.ts +1 -1
  410. package/dist/run-error.d.ts.map +1 -1
  411. package/dist/run-error.js +38 -5
  412. package/dist/run-error.js.map +1 -1
  413. package/dist/sandbox/sandbox-env-cache.d.ts +33 -0
  414. package/dist/sandbox/sandbox-env-cache.d.ts.map +1 -0
  415. package/dist/sandbox/sandbox-env-cache.js +140 -0
  416. package/dist/sandbox/sandbox-env-cache.js.map +1 -0
  417. package/dist/sandbox/sandbox-env.d.ts +77 -0
  418. package/dist/sandbox/sandbox-env.d.ts.map +1 -0
  419. package/dist/sandbox/sandbox-env.js +130 -0
  420. package/dist/sandbox/sandbox-env.js.map +1 -0
  421. package/dist/secret-encryption.d.ts +21 -0
  422. package/dist/secret-encryption.d.ts.map +1 -1
  423. package/dist/secret-encryption.js +31 -4
  424. package/dist/secret-encryption.js.map +1 -1
  425. package/dist/session/live-sessions.d.ts +11 -4
  426. package/dist/session/live-sessions.d.ts.map +1 -1
  427. package/dist/session/live-sessions.js +31 -10
  428. package/dist/session/live-sessions.js.map +1 -1
  429. package/dist/session/self-review-gate.d.ts +6 -4
  430. package/dist/session/self-review-gate.d.ts.map +1 -1
  431. package/dist/session/self-review-gate.js +9 -12
  432. package/dist/session/self-review-gate.js.map +1 -1
  433. package/dist/session/session-threads.d.ts +2 -3
  434. package/dist/session/session-threads.d.ts.map +1 -1
  435. package/dist/session/session-threads.js.map +1 -1
  436. package/dist/session/source-control-tools.d.ts +39 -13
  437. package/dist/session/source-control-tools.d.ts.map +1 -1
  438. package/dist/session/source-control-tools.js +55 -61
  439. package/dist/session/source-control-tools.js.map +1 -1
  440. package/dist/session/work-item-state-processor.d.ts +24 -0
  441. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  442. package/dist/session/work-item-state-processor.js +275 -0
  443. package/dist/session/work-item-state-processor.js.map +1 -0
  444. package/dist/storage/domains/audit/actions.d.ts +2 -1
  445. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  446. package/dist/storage/domains/audit/actions.js +5 -4
  447. package/dist/storage/domains/audit/actions.js.map +1 -1
  448. package/dist/storage/domains/boards/base.d.ts +85 -32
  449. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  450. package/dist/storage/domains/boards/base.js +120 -131
  451. package/dist/storage/domains/boards/base.js.map +1 -1
  452. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  453. package/dist/storage/domains/boards/schemas.js +12 -0
  454. package/dist/storage/domains/boards/schemas.js.map +1 -1
  455. package/dist/storage/domains/channel-identity/base.d.ts +0 -4
  456. package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
  457. package/dist/storage/domains/channel-identity/base.js +0 -7
  458. package/dist/storage/domains/channel-identity/base.js.map +1 -1
  459. package/dist/storage/domains/intake/base.d.ts +5 -45
  460. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  461. package/dist/storage/domains/intake/base.js +11 -89
  462. package/dist/storage/domains/intake/base.js.map +1 -1
  463. package/dist/storage/domains/projects/base.d.ts +17 -9
  464. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  465. package/dist/storage/domains/projects/base.js +15 -7
  466. package/dist/storage/domains/projects/base.js.map +1 -1
  467. package/dist/storage/domains/sandbox-envs/base.d.ts +70 -0
  468. package/dist/storage/domains/sandbox-envs/base.d.ts.map +1 -0
  469. package/dist/storage/domains/sandbox-envs/base.js +227 -0
  470. package/dist/storage/domains/sandbox-envs/base.js.map +1 -0
  471. package/dist/storage/domains/work-items/base.d.ts +62 -22
  472. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  473. package/dist/storage/domains/work-items/base.js +218 -146
  474. package/dist/storage/domains/work-items/base.js.map +1 -1
  475. package/dist/storage/domains/work-items/board-version.d.ts +6 -2
  476. package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
  477. package/dist/storage/domains/work-items/board-version.js +20 -9
  478. package/dist/storage/domains/work-items/board-version.js.map +1 -1
  479. package/dist/storage/domains/work-items/cards.d.ts +28 -5
  480. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  481. package/dist/storage/domains/work-items/cards.js +156 -23
  482. package/dist/storage/domains/work-items/cards.js.map +1 -1
  483. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  484. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  485. package/dist/storage/domains/work-items/legacy-review.js +109 -0
  486. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  487. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  488. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  489. package/dist/storage/domains/work-items/metrics.js +14 -32
  490. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  491. package/dist/storage/domains/work-items/work-item-schema.d.ts +4 -2
  492. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  493. package/dist/storage/domains/work-items/work-item-schema.js +59 -26
  494. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  495. package/dist/tools/approval-tools.d.ts.map +1 -1
  496. package/dist/tools/approval-tools.js +28 -9
  497. package/dist/tools/approval-tools.js.map +1 -1
  498. package/dist/tools/index.d.ts +1 -1
  499. package/dist/tools/index.js +1 -1
  500. package/dist/tools/index.js.map +1 -1
  501. package/dist/tools/messaging-tools.d.ts +3 -0
  502. package/dist/tools/messaging-tools.d.ts.map +1 -1
  503. package/dist/tools/messaging-tools.js +2 -1
  504. package/dist/tools/messaging-tools.js.map +1 -1
  505. package/dist/tools/read-tools.d.ts +8 -4
  506. package/dist/tools/read-tools.d.ts.map +1 -1
  507. package/dist/tools/read-tools.js +86 -37
  508. package/dist/tools/read-tools.js.map +1 -1
  509. package/dist/tools/reports.d.ts +1 -0
  510. package/dist/tools/reports.d.ts.map +1 -1
  511. package/dist/tools/reports.js +2 -1
  512. package/dist/tools/reports.js.map +1 -1
  513. package/dist/tools/run-watch.d.ts +1 -1
  514. package/dist/tools/run-watch.d.ts.map +1 -1
  515. package/dist/tools/run-watch.js +1 -0
  516. package/dist/tools/run-watch.js.map +1 -1
  517. package/dist/tools/sandbox-tools.js +1 -1
  518. package/dist/tools/session-tools.js +1 -1
  519. package/dist/tools/sessions-state-processor.d.ts +2 -0
  520. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  521. package/dist/tools/sessions-state-processor.js +4 -2
  522. package/dist/tools/sessions-state-processor.js.map +1 -1
  523. package/dist/tools/side-sessions.d.ts +2 -0
  524. package/dist/tools/side-sessions.d.ts.map +1 -1
  525. package/dist/tools/side-sessions.js +2 -1
  526. package/dist/tools/side-sessions.js.map +1 -1
  527. package/dist/tools/work-item-tools.d.ts +0 -3
  528. package/dist/tools/work-item-tools.d.ts.map +1 -1
  529. package/dist/tools/work-item-tools.js +10 -20
  530. package/dist/tools/work-item-tools.js.map +1 -1
  531. package/dist/work-item-branch.d.ts +13 -0
  532. package/dist/work-item-branch.d.ts.map +1 -1
  533. package/dist/work-item-branch.js +16 -1
  534. package/dist/work-item-branch.js.map +1 -1
  535. package/dist/work-items/create-work-item.d.ts +6 -0
  536. package/dist/work-items/create-work-item.d.ts.map +1 -1
  537. package/dist/work-items/create-work-item.js +28 -3
  538. package/dist/work-items/create-work-item.js.map +1 -1
  539. package/dist/work-items/description-context.d.ts +5 -0
  540. package/dist/work-items/description-context.d.ts.map +1 -0
  541. package/dist/work-items/description-context.js +17 -0
  542. package/dist/work-items/description-context.js.map +1 -0
  543. package/dist/work-items/providers/base.d.ts +4 -1
  544. package/dist/work-items/providers/base.d.ts.map +1 -1
  545. package/dist/work-items/providers/base.js +6 -1
  546. package/dist/work-items/providers/base.js.map +1 -1
  547. package/dist/work-items/providers/github.d.ts.map +1 -1
  548. package/dist/work-items/providers/github.js +2 -1
  549. package/dist/work-items/providers/github.js.map +1 -1
  550. package/dist/work-items/providers/gitlab.d.ts.map +1 -1
  551. package/dist/work-items/providers/gitlab.js +2 -1
  552. package/dist/work-items/providers/gitlab.js.map +1 -1
  553. package/dist/work-items/providers/jira.d.ts.map +1 -1
  554. package/dist/work-items/providers/jira.js +3 -2
  555. package/dist/work-items/providers/jira.js.map +1 -1
  556. package/dist/work-items/providers/linear.d.ts.map +1 -1
  557. package/dist/work-items/providers/linear.js +3 -2
  558. package/dist/work-items/providers/linear.js.map +1 -1
  559. package/dist/work-items/providers/types.d.ts +6 -0
  560. package/dist/work-items/providers/types.d.ts.map +1 -1
  561. package/dist/work-items/split-migration.d.ts.map +1 -1
  562. package/dist/work-items/split-migration.js +8 -8
  563. package/dist/work-items/split-migration.js.map +1 -1
  564. package/dist/workspace.d.ts +3 -1
  565. package/dist/workspace.d.ts.map +1 -1
  566. package/dist/workspace.js +116 -32
  567. package/dist/workspace.js.map +1 -1
  568. package/factory-skills/configure-factory-rules/SKILL.md +13 -11
  569. package/factory-skills/factory-build/SKILL.md +64 -0
  570. package/factory-skills/factory-gitlab-rereview/SKILL.md +4 -4
  571. package/factory-skills/factory-gitlab-review/SKILL.md +6 -6
  572. package/factory-skills/factory-plan/SKILL.md +8 -10
  573. package/factory-skills/factory-rereview/SKILL.md +74 -28
  574. package/factory-skills/factory-review/SKILL.md +85 -29
  575. package/factory-skills/factory-self-review/SKILL.md +32 -13
  576. package/factory-skills/factory-triage/SKILL.md +36 -32
  577. package/package.json +12 -12
  578. package/dist/boards/index.js.map +0 -1
  579. package/dist/boards/pull-request-review.d.ts +0 -14
  580. package/dist/boards/pull-request-review.d.ts.map +0 -1
  581. package/dist/boards/pull-request-review.js +0 -81
  582. package/dist/boards/pull-request-review.js.map +0 -1
  583. package/dist/boards/work-tool-rules.d.ts +0 -8
  584. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  585. package/dist/boards/work-tool-rules.js +0 -19
  586. package/dist/boards/work-tool-rules.js.map +0 -1
  587. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
  588. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
  589. package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
  590. package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
  591. package/dist/integrations/slack/emoji.d.ts +0 -3
  592. package/dist/integrations/slack/emoji.d.ts.map +0 -1
  593. package/dist/integrations/slack/emoji.js +0 -11
  594. package/dist/integrations/slack/emoji.js.map +0 -1
  595. package/dist/integrations/slack/feed-publisher.d.ts +0 -26
  596. package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
  597. package/dist/integrations/slack/feed-publisher.js +0 -43
  598. package/dist/integrations/slack/feed-publisher.js.map +0 -1
  599. package/dist/routes/attention-activity.d.ts +0 -23
  600. package/dist/routes/attention-activity.d.ts.map +0 -1
  601. package/dist/routes/attention-activity.js +0 -154
  602. package/dist/routes/attention-activity.js.map +0 -1
  603. package/dist/rules/resolve.d.ts +0 -15
  604. package/dist/rules/resolve.d.ts.map +0 -1
  605. package/dist/rules/resolve.js +0 -22
  606. package/dist/rules/resolve.js.map +0 -1
  607. package/dist/storage/domains/comments/activity.d.ts +0 -40
  608. package/dist/storage/domains/comments/activity.d.ts.map +0 -1
  609. package/dist/storage/domains/comments/activity.js +0 -93
  610. package/dist/storage/domains/comments/activity.js.map +0 -1
  611. package/dist/storage/domains/comments/actor.d.ts +0 -51
  612. package/dist/storage/domains/comments/actor.d.ts.map +0 -1
  613. package/dist/storage/domains/comments/actor.js +0 -37
  614. package/dist/storage/domains/comments/actor.js.map +0 -1
  615. package/dist/storage/domains/comments/base.d.ts +0 -245
  616. package/dist/storage/domains/comments/base.d.ts.map +0 -1
  617. package/dist/storage/domains/comments/base.js +0 -539
  618. package/dist/storage/domains/comments/base.js.map +0 -1
  619. package/dist/storage/domains/comments/domain.d.ts +0 -135
  620. package/dist/storage/domains/comments/domain.d.ts.map +0 -1
  621. package/dist/storage/domains/comments/domain.js +0 -284
  622. package/dist/storage/domains/comments/domain.js.map +0 -1
  623. package/dist/storage/domains/comments/feed-context.d.ts +0 -22
  624. package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
  625. package/dist/storage/domains/comments/feed-context.js +0 -88
  626. package/dist/storage/domains/comments/feed-context.js.map +0 -1
  627. package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
  628. package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
  629. package/dist/storage/domains/comments/feed-sync.js +0 -1
  630. package/dist/storage/domains/comments/parse.d.ts +0 -23
  631. package/dist/storage/domains/comments/parse.d.ts.map +0 -1
  632. package/dist/storage/domains/comments/parse.js +0 -89
  633. package/dist/storage/domains/comments/parse.js.map +0 -1
  634. package/dist/storage/domains/comments/routes.d.ts +0 -24
  635. package/dist/storage/domains/comments/routes.d.ts.map +0 -1
  636. package/dist/storage/domains/comments/routes.js +0 -299
  637. package/dist/storage/domains/comments/routes.js.map +0 -1
  638. package/dist/storage/domains/comments/schema.d.ts +0 -5
  639. package/dist/storage/domains/comments/schema.d.ts.map +0 -1
  640. package/dist/storage/domains/comments/schema.js +0 -178
  641. package/dist/storage/domains/comments/schema.js.map +0 -1
  642. package/dist/storage/domains/comments/wire.d.ts +0 -40
  643. package/dist/storage/domains/comments/wire.d.ts.map +0 -1
  644. package/dist/storage/domains/comments/wire.js +0 -36
  645. package/dist/storage/domains/comments/wire.js.map +0 -1
  646. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -1,11 +1,15 @@
1
1
  import { cardRuleGroupSchema } from "../rules/rule-group.js";
2
- import { BoardDefinitionError, compileBoardDefinition, declarationOf } from "./define-board.js";
2
+ import { BoardDefinitionError, FACTORY_PHASE_TOOLS, compileBoardDefinition, declarationOf } from "./define-board.js";
3
3
  import { z } from "zod";
4
4
  // src/boards/stored-board.ts
5
5
  const storedRunnerSchema = z.object({
6
6
  skill: z.string().optional(),
7
7
  context: z.string().optional(),
8
- instructions: z.string().optional()
8
+ instructions: z.string().optional(),
9
+ goal: z.object({
10
+ objective: z.string(),
11
+ maxRuns: z.number().optional()
12
+ }).strict().optional()
9
13
  }).strict();
10
14
  const storedExitToolSchema = z.object({
11
15
  id: z.string(),
@@ -25,7 +29,8 @@ const storedPhaseInputSchema = z.object({
25
29
  nextPhases: z.array(z.string()).nullish(),
26
30
  autoStart: z.boolean().optional(),
27
31
  autoStartWhen: cardRuleGroupSchema.nullish(),
28
- exitTool: storedExitToolSchema.nullish()
32
+ exitTool: storedExitToolSchema.nullish(),
33
+ tools: z.array(z.enum(FACTORY_PHASE_TOOLS)).nullish()
29
34
  }).strict();
30
35
  function storedBoardFields() {
31
36
  return {
@@ -68,28 +73,17 @@ function storedNextPhases(phase, phases) {
68
73
  * Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where
69
74
  * cards start.
70
75
  *
71
- * With `code`, the board is a project's edit of that code board: its fields come from the stored
72
- * definition and its behaviour from the code declaration, by phase key (`onEnter`, `onExit`,
73
- * `outcomes`) and for the board (`tools`, `events`, `sourceClosed`, `transitionPolicy`). The board
74
- * is rebuilt from the declaration, so the stored runner reaches the declared handlers. An edit code
75
- * behaviour can't honour ({@link codeBehaviourConflicts}) is refused.
76
+ * With `code`, the board is a project's edit of that code board: its phases come from the stored
77
+ * definition and the board-level behaviour from the code declaration (`tools`, `events`,
78
+ * `sourceClosed`, `transitionPolicy`). An edit that behaviour can't honour
79
+ * ({@link codeBehaviourConflicts}) is refused.
76
80
  */
77
81
  function compileStoredBoard(board, code) {
78
82
  if (!code) return compileBoardDefinition(storedBoardConfig(board));
79
83
  const conflicts = codeBehaviourConflicts(board, code);
80
84
  if (conflicts.length > 0) throw new BoardDefinitionError(conflicts.join(" "));
81
85
  const declaration = codeDeclaration(code);
82
- const phases = {};
83
- for (const key of Object.keys(declaration.phases)) {
84
- const { outcomes, onEnter, onExit } = declaration.phases[key];
85
- phases[key] = {
86
- outcomes,
87
- onEnter,
88
- onExit
89
- };
90
- }
91
86
  return compileBoardDefinition(storedBoardConfig(board, {
92
- phases,
93
87
  tools: declaration.tools,
94
88
  events: declaration.events,
95
89
  transitionPolicy: declaration.transitionPolicy,
@@ -102,10 +96,6 @@ function compileStoredBoard(board, code) {
102
96
  * edit from before a release added a phase or a code move, a row older than editable code boards)
103
97
  * still runs as stored.
104
98
  *
105
- * - A phase's `onEnter`, `onExit` and `outcomes` attach only when the row keeps the phase in the
106
- * shape they depend on: the same kind and, on phases with code handlers, the same runner context
107
- * and skill, the declared exit tool and no other. Outcomes whose target the row lacks or doesn't
108
- * allow are dropped.
109
99
  * - The board's `tools` always attach: they hold the exit-tool approval that keeps anyone but a
110
100
  * person from moving a card past an unapproved exit tool. If the row lacks a code phase, the
111
101
  * moves they make to it are refused, and that is reported.
@@ -122,38 +112,13 @@ function mergeCodeBehaviour(row, code) {
122
112
  const declaration = codeDeclaration(code);
123
113
  const stored = new Map(row.phases.map((phase) => [phase.key, phase]));
124
114
  const problems = [];
125
- const phases = {};
126
115
  for (const [key, phase] of Object.entries(code.phases)) {
127
- const declared = declaration.phases[key];
128
- const outcomes = Object.entries(declared?.outcomes ?? {});
129
116
  const edited = stored.get(key);
130
- const conflicts = edited ? phaseShapeConflicts(key, phase, declared, edited) : [];
131
- if (edited && edited.kind === phase.kind) {
132
- const allowed = storedNextPhases(edited, row.phases);
133
- const outcomeTargets = new Set(outcomes.map(([, target]) => target));
134
- for (const target of phase.nextPhases) if (stored.has(target) && !allowed.includes(target) && !outcomeTargets.has(target)) problems.push(`Board "${row.key}" doesn't let phase "${key}" move cards to "${target}", so Factory's code can't make that move.`);
135
- }
136
- if (!hasHandlers(declared) && outcomes.length === 0) continue;
137
- if (!edited) {
138
- problems.push(`Phase "${key}" isn't on stored board "${row.key}", so its code behaviour doesn't run.`);
139
- continue;
140
- }
141
- if (conflicts.length > 0) {
142
- problems.push(...conflicts.map((conflict) => `Phase "${key}" runs without its code behaviour: ${conflict}`));
143
- continue;
144
- }
117
+ if (!edited || edited.kind !== phase.kind) continue;
145
118
  const allowed = storedNextPhases(edited, row.phases);
146
- const kept = {};
147
- for (const [outcome, target] of outcomes) if (!stored.has(target)) problems.push(`Phase "${key}" runs without its code outcome "${outcome}": phase "${target}" isn't stored.`);
148
- else if (!allowed.includes(target)) problems.push(`Phase "${key}" runs without its code outcome "${outcome}": the board doesn't let it move cards to "${target}".`);
149
- else kept[outcome] = target;
150
- phases[key] = {
151
- onEnter: declared?.onEnter,
152
- onExit: declared?.onExit,
153
- outcomes: Object.keys(kept).length > 0 ? kept : void 0
154
- };
119
+ for (const target of phase.nextPhases) if (stored.has(target) && !allowed.includes(target)) problems.push(`Board "${row.key}" doesn't let phase "${key}" move cards to "${target}", so Factory's code can't make that move.`);
155
120
  }
156
- const board = { phases };
121
+ const board = {};
157
122
  const missing = Object.keys(code.phases).filter((key) => !stored.has(key));
158
123
  const unfit = missing.length > 0 ? missingPhases(missing) : void 0;
159
124
  const tools = Object.keys(declaration.tools ?? {});
@@ -198,10 +163,7 @@ function missingPhases(keys) {
198
163
  function codeDeclaration(code) {
199
164
  return declarationOf(code) ?? code;
200
165
  }
201
- /**
202
- * The board config a stored definition declares, with the given code behaviour. The board is
203
- * rebuilt from the declaration's handlers, so the stored runner reaches them.
204
- */
166
+ /** The board config a stored definition declares, with the given code behaviour. */
205
167
  function storedBoardConfig(board, behaviour) {
206
168
  const [initial] = board.phases;
207
169
  if (!initial) throw new BoardDefinitionError("A board must define at least one phase.");
@@ -210,7 +172,6 @@ function storedBoardConfig(board, behaviour) {
210
172
  if (Object.hasOwn(phases, phase.key)) throw new BoardDefinitionError(`Board "${board.key}" declares phase "${phase.key}" more than once.`);
211
173
  const runner = phase.runner ? withoutUndefined(phase.runner) : void 0;
212
174
  const exitTool = phase.exitTool ? withoutUndefined(phase.exitTool) : void 0;
213
- const declared = behaviour && Object.hasOwn(behaviour.phases, phase.key) ? behaviour.phases[phase.key] : void 0;
214
175
  phases[phase.key] = withoutUndefined({
215
176
  name: phase.name,
216
177
  description: phase.description ?? void 0,
@@ -220,9 +181,7 @@ function storedBoardConfig(board, behaviour) {
220
181
  autoStart: phase.autoStart ? true : void 0,
221
182
  autoStartWhen: phase.autoStartWhen ?? void 0,
222
183
  exitTool,
223
- outcomes: declared?.outcomes,
224
- onEnter: declared?.onEnter,
225
- onExit: declared?.onExit
184
+ tools: phase.tools?.length ? phase.tools : void 0
226
185
  });
227
186
  }
228
187
  return {
@@ -239,26 +198,16 @@ function storedBoardConfig(board, behaviour) {
239
198
  }
240
199
  /** The per-phase locks `codeBehaviourConflicts` enforces, for clients that show them. */
241
200
  function codeBehaviourOf(code) {
242
- const declaration = declarationOf(code) ?? code;
243
- return Object.fromEntries(Object.entries(code.phases).map(([key, phase]) => [key, {
244
- handlers: phase.kind === "working" && hasHandlers(declaration.phases[key]),
245
- exitToolId: phase.kind === "working" ? phase.exitTool?.id ?? null : null,
246
- requiredNextPhases: [...phase.nextPhases]
247
- }]));
248
- }
249
- function hasHandlers(phase) {
250
- return Object.keys(phase?.onEnter ?? {}).length > 0 || Object.keys(phase?.onExit ?? {}).length > 0;
201
+ return Object.fromEntries(Object.entries(code.phases).map(([key, phase]) => [key, { requiredNextPhases: [...phase.nextPhases] }]));
251
202
  }
252
203
  /**
253
204
  * Why a stored definition of a code board's key can't run with that board's code behaviour, one
254
- * reason per locked change; empty when it can. Code handlers and checks name the board's phases,
255
- * its first phase, the context, skill and exit tool of phases with handlers, and the moves code
256
- * makes between phases (tool and event rules, `sourceClosed`, integrations, handler prompts), so
257
- * those stay as code declares them. Names, descriptions, added moves, start and approval
258
- * conditions, runner instructions and new phases are free.
205
+ * reason per locked change; empty when it can. Code (tool and event rules, `sourceClosed`,
206
+ * integrations) names the board's phases, its first phase, each phase's kind and the moves it
207
+ * makes between phases, so those stay as code declares them. Names, descriptions, runners, exit
208
+ * tools, phase tools, added moves, start and approval conditions and new phases are free.
259
209
  */
260
210
  function codeBehaviourConflicts(board, code) {
261
- const declaration = declarationOf(code) ?? code;
262
211
  const stored = new Map(board.phases.map((phase) => [phase.key, phase]));
263
212
  const conflicts = [];
264
213
  if (board.phases[0]?.key !== code.initialPhase) conflicts.push(`Cards on board "${code.id}" start in "${code.initialPhase}"; keep it the first phase.`);
@@ -269,35 +218,18 @@ function codeBehaviourConflicts(board, code) {
269
218
  conflicts.push(`${label} has code behaviour on board "${code.id}"; it can't be removed.`);
270
219
  continue;
271
220
  }
272
- conflicts.push(...phaseShapeConflicts(key, phase, declaration.phases[key], edited));
273
- if (edited.kind !== phase.kind) continue;
221
+ if (edited.kind !== phase.kind) {
222
+ conflicts.push(`${label} must stay ${phase.kind}; its code behaviour depends on it.`);
223
+ continue;
224
+ }
274
225
  const nextPhases = storedNextPhases(edited, board.phases);
275
- const outcomes = new Map(Object.entries(phase.outcomes ?? {}).map(([outcome, target]) => [target, outcome]));
276
226
  for (const target of phase.nextPhases) {
277
227
  if (nextPhases.includes(target)) continue;
278
- const outcome = outcomes.get(target);
279
- conflicts.push(outcome ? `${label} outcome "${outcome}" moves cards to "${target}"; keep it in nextPhases.` : `${label}: Factory's code moves cards from it to "${target}"; keep it in nextPhases.`);
228
+ conflicts.push(`${label}: Factory's code moves cards from it to "${target}"; keep it in nextPhases.`);
280
229
  }
281
230
  }
282
231
  return conflicts;
283
232
  }
284
- /**
285
- * Why a stored phase isn't in the shape its code behaviour depends on: its kind and, on a working
286
- * phase, the runner context and skill its code handlers run with and the exit tool they wait for.
287
- */
288
- function phaseShapeConflicts(key, phase, declared, edited) {
289
- const label = `Phase "${key}"`;
290
- if (edited.kind !== phase.kind) return [`${label} must stay ${phase.kind}; its code behaviour depends on it.`];
291
- if (phase.kind !== "working") return [];
292
- const conflicts = [];
293
- if (hasHandlers(declared)) {
294
- if ((edited.runner?.context ?? "work") !== phase.runner.context) conflicts.push(`${label} runs its code handlers in the "${phase.runner.context}" context; keep runner.context.`);
295
- if (edited.runner?.skill !== phase.runner.skill) conflicts.push(phase.runner.skill ? `${label} code handlers run with skill "${phase.runner.skill}"; keep runner.skill.` : `${label} code handlers choose the skill; leave runner.skill unset.`);
296
- }
297
- if (phase.exitTool && edited.exitTool?.id !== phase.exitTool.id) conflicts.push(`${label} code behaviour waits for exit tool "${phase.exitTool.id}"; keep exitTool.id.`);
298
- else if (!phase.exitTool && edited.exitTool && hasHandlers(declared)) conflicts.push(`${label} code handlers move cards on without an exit tool; leave exitTool unset.`);
299
- return conflicts;
300
- }
301
233
  /** Whether two storable definitions describe the same board once unset fields and defaults are resolved. */
302
234
  function sameBoardDefinition(a, b) {
303
235
  return canonicalJson(boardDefinitionOf(compileStoredBoard(a))) === canonicalJson(boardDefinitionOf(compileStoredBoard(b)));
@@ -331,7 +263,8 @@ function storedPhase(key, phase) {
331
263
  runner: withoutUndefined({
332
264
  skill: phase.runner.skill,
333
265
  context: phase.runner.context,
334
- instructions: phase.runner.instructions
266
+ instructions: phase.runner.instructions,
267
+ goal: phase.runner.goal ? { ...phase.runner.goal } : void 0
335
268
  }),
336
269
  autoStart: phase.autoStart ? true : void 0,
337
270
  autoStartWhen: phase.autoStartWhen,
@@ -339,7 +272,8 @@ function storedPhase(key, phase) {
339
272
  id: phase.exitTool.id,
340
273
  autoApprove: phase.exitTool.autoApprove,
341
274
  autoApproveWhen: phase.exitTool.autoApproveWhen
342
- }) : void 0
275
+ }) : void 0,
276
+ tools: phase.tools ? [...phase.tools] : void 0
343
277
  } : {}
344
278
  });
345
279
  }
@@ -1 +1 @@
1
- {"version":3,"file":"stored-board.js","names":[],"sources":["../../src/boards/stored-board.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { cardRuleGroupSchema } from '../rules/rule-group.js';\nimport type { StoredBoardInput, StoredPhaseInput } from '../storage/domains/boards/base.js';\nimport { BoardDefinitionError, compileBoardDefinition, declarationOf, DEFAULT_PHASE_CONTEXT } from './define-board.js';\nimport type { AnyBoardConfig, BoardPhase, BoardPhaseDefinition } from './define-board.js';\nimport type { InstalledBoard } from './registry.js';\n\nconst storedRunnerSchema = z\n .object({\n skill: z.string().optional(),\n context: z.string().optional(),\n instructions: z.string().optional(),\n })\n .strict();\n\nconst storedExitToolSchema = z\n .object({\n id: z.string(),\n autoApprove: z.boolean().optional(),\n autoApproveWhen: cardRuleGroupSchema.optional(),\n })\n .strict();\n\nexport const storedPhaseInputSchema = z\n .object({\n key: z.string(),\n name: z.string(),\n description: z.string().nullish(),\n kind: z.enum(['resting', 'working', 'terminal']),\n runner: storedRunnerSchema.nullish(),\n nextPhases: z.array(z.string()).nullish(),\n autoStart: z.boolean().optional(),\n autoStartWhen: cardRuleGroupSchema.nullish(),\n exitTool: storedExitToolSchema.nullish(),\n })\n .strict();\n\nfunction storedBoardFields() {\n return {\n name: z.string(),\n description: z.string().nullish(),\n phases: z.array(storedPhaseInputSchema).min(1, 'A board must define at least one phase.'),\n };\n}\n\n/**\n * A board's editable fields without its key, the shape of a replace. Only the shape: the board\n * rules run once the key is known, through {@link storedBoardInputSchema}.\n */\nexport const storedBoardDefinitionSchema = z.object(storedBoardFields()).strict();\n\n/**\n * A board as the API accepts it. Beyond the shape, it holds every rule `defineBoard()` enforces\n * (identifiers, lengths, phase kinds, runners, exit tools, conditions, targets), reported with\n * the same messages.\n */\nexport const storedBoardInputSchema = z\n .object({ key: z.string(), ...storedBoardFields() })\n .strict()\n .superRefine((input, context) => {\n try {\n compileStoredBoard(input);\n } catch (error) {\n if (!(error instanceof BoardDefinitionError)) throw error;\n context.addIssue({ code: 'custom', message: error.message });\n }\n });\n\n/** Phases a stored phase may move to: unset on a resting or working phase means every other phase. */\nfunction storedNextPhases(phase: StoredPhaseInput, phases: readonly StoredPhaseInput[]): string[] {\n if (phase.nextPhases != null) return phase.nextPhases;\n if (phase.kind === 'terminal') return [];\n return phases.filter(other => other.key !== phase.key).map(other => other.key);\n}\n\n/**\n * Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where\n * cards start.\n *\n * With `code`, the board is a project's edit of that code board: its fields come from the stored\n * definition and its behaviour from the code declaration, by phase key (`onEnter`, `onExit`,\n * `outcomes`) and for the board (`tools`, `events`, `sourceClosed`, `transitionPolicy`). The board\n * is rebuilt from the declaration, so the stored runner reaches the declared handlers. An edit code\n * behaviour can't honour ({@link codeBehaviourConflicts}) is refused.\n */\nexport function compileStoredBoard(board: StoredBoardInput, code?: InstalledBoard): InstalledBoard {\n if (!code) return compileBoardDefinition(storedBoardConfig(board));\n const conflicts = codeBehaviourConflicts(board, code);\n if (conflicts.length > 0) throw new BoardDefinitionError(conflicts.join(' '));\n const declaration = codeDeclaration(code);\n const phases: Record<string, PhaseBehaviour> = {};\n for (const key of Object.keys(declaration.phases)) {\n const { outcomes, onEnter, onExit } = declaration.phases[key]!;\n phases[key] = { outcomes, onEnter, onExit };\n }\n return compileBoardDefinition(\n storedBoardConfig(board, {\n phases,\n tools: declaration.tools,\n events: declaration.events,\n transitionPolicy: declaration.transitionPolicy,\n sourceClosed: declaration.sourceClosed,\n }),\n code,\n );\n}\n\n/** A board served from a stored row, and what of its code board's behaviour it runs without. */\ninterface MergedStoredBoard {\n board: InstalledBoard;\n /** One per piece of code behaviour the row can't run with; empty when it runs with all of it. */\n problems: string[];\n}\n\n/**\n * Serves a stored row of a code board's key with the code behaviour that still fits it. Unlike\n * {@link compileStoredBoard}, nothing is refused: a row that fell out of step with its code (an\n * edit from before a release added a phase or a code move, a row older than editable code boards)\n * still runs as stored.\n *\n * - A phase's `onEnter`, `onExit` and `outcomes` attach only when the row keeps the phase in the\n * shape they depend on: the same kind and, on phases with code handlers, the same runner context\n * and skill, the declared exit tool and no other. Outcomes whose target the row lacks or doesn't\n * allow are dropped.\n * - The board's `tools` always attach: they hold the exit-tool approval that keeps anyone but a\n * person from moving a card past an unapproved exit tool. If the row lacks a code phase, the\n * moves they make to it are refused, and that is reported.\n * - The board's `events` and `transitionPolicy` attach only when the row has every code phase,\n * since their handlers may move cards to any of them; `sourceClosed` when both of its phases are\n * stored and terminal.\n * - A move code makes that the row's `nextPhases` don't allow is reported; code making it is refused.\n * - If the board still fails to compile with that behaviour, it runs without any.\n *\n * The result links to `code` as its code board either way. Throws only when the row itself is\n * invalid.\n */\nexport function mergeCodeBehaviour(row: StoredBoardInput, code: InstalledBoard): MergedStoredBoard {\n const declaration = codeDeclaration(code);\n const stored = new Map(row.phases.map(phase => [phase.key, phase]));\n const problems: string[] = [];\n const phases: Record<string, PhaseBehaviour> = {};\n for (const [key, phase] of Object.entries(code.phases) as [string, BoardPhase<string>][]) {\n const declared = declaration.phases[key];\n const outcomes = Object.entries(declared?.outcomes ?? {});\n const edited = stored.get(key);\n const conflicts = edited ? phaseShapeConflicts(key, phase, declared, edited) : [];\n if (edited && edited.kind === phase.kind) {\n // A move code makes that the row doesn't allow is refused when code makes it.\n const allowed = storedNextPhases(edited, row.phases);\n const outcomeTargets = new Set(outcomes.map(([, target]) => target));\n for (const target of phase.nextPhases) {\n if (stored.has(target) && !allowed.includes(target) && !outcomeTargets.has(target)) {\n problems.push(\n `Board \"${row.key}\" doesn't let phase \"${key}\" move cards to \"${target}\", so Factory's code can't make that move.`,\n );\n }\n }\n }\n if (!hasHandlers(declared) && outcomes.length === 0) continue;\n if (!edited) {\n problems.push(`Phase \"${key}\" isn't on stored board \"${row.key}\", so its code behaviour doesn't run.`);\n continue;\n }\n if (conflicts.length > 0) {\n problems.push(...conflicts.map(conflict => `Phase \"${key}\" runs without its code behaviour: ${conflict}`));\n continue;\n }\n const allowed = storedNextPhases(edited, row.phases);\n const kept: Record<string, string> = {};\n for (const [outcome, target] of outcomes) {\n if (!stored.has(target)) {\n problems.push(`Phase \"${key}\" runs without its code outcome \"${outcome}\": phase \"${target}\" isn't stored.`);\n } else if (!allowed.includes(target)) {\n problems.push(\n `Phase \"${key}\" runs without its code outcome \"${outcome}\": the board doesn't let it move cards to \"${target}\".`,\n );\n } else kept[outcome] = target;\n }\n phases[key] = {\n onEnter: declared?.onEnter,\n onExit: declared?.onExit,\n outcomes: Object.keys(kept).length > 0 ? kept : undefined,\n };\n }\n\n const board: BoardBehaviour = { phases };\n const missing = Object.keys(code.phases).filter(key => !stored.has(key));\n const unfit = missing.length > 0 ? missingPhases(missing) : undefined;\n const tools = Object.keys(declaration.tools ?? {});\n if (tools.length > 0) {\n board.tools = declaration.tools;\n if (unfit) {\n problems.push(\n `Board \"${row.key}\" keeps its code tool rules (${tools.join(', ')}), but can't move cards where they lead: ${unfit}`,\n );\n }\n }\n const events = Object.keys(declaration.events ?? {});\n if (events.length > 0) {\n if (unfit) problems.push(`Board \"${row.key}\" runs without its code event rules (${events.join(', ')}): ${unfit}`);\n else board.events = declaration.events;\n }\n if (declaration.transitionPolicy) {\n if (unfit) problems.push(`Board \"${row.key}\" runs without its code transition policy: ${unfit}`);\n else board.transitionPolicy = declaration.transitionPolicy;\n }\n const sourceClosed = declaration.sourceClosed;\n if (sourceClosed) {\n const closed = [sourceClosed.completed, sourceClosed.canceled];\n const closedMissing = closed.filter(key => !stored.has(key));\n const closedOpen = closed.filter(key => stored.has(key) && stored.get(key)!.kind !== 'terminal');\n if (closedMissing.length > 0) {\n problems.push(`Board \"${row.key}\" doesn't move cards when their source closes: ${missingPhases(closedMissing)}`);\n } else if (closedOpen.length > 0) {\n problems.push(\n `Board \"${row.key}\" doesn't move cards when their source closes: ${\n closedOpen.length === 1\n ? `phase \"${closedOpen[0]}\" isn't terminal.`\n : `phases ${closedOpen.map(key => `\"${key}\"`).join(', ')} aren't terminal.`\n }`,\n );\n } else board.sourceClosed = sourceClosed;\n }\n\n try {\n return { board: compileBoardDefinition(storedBoardConfig(row, board), code), problems };\n } catch (error) {\n if (!(error instanceof BoardDefinitionError)) throw error;\n return {\n board: compileBoardDefinition(storedBoardConfig(row), code),\n problems: [...problems, `Board \"${row.key}\" runs without its code behaviour: ${error.message}`],\n };\n }\n}\n\nfunction missingPhases(keys: string[]): string {\n return keys.length === 1\n ? `phase \"${keys[0]}\" isn't stored.`\n : `phases ${keys.map(key => `\"${key}\"`).join(', ')} aren't stored.`;\n}\n\n/** The code behaviour one stored phase runs with. */\ninterface PhaseBehaviour {\n outcomes?: Readonly<Record<string, string>>;\n onEnter?: BoardPhaseDefinition<string>['onEnter'];\n onExit?: BoardPhaseDefinition<string>['onExit'];\n}\n\n/** The code behaviour a stored board runs with, by phase key and for the board. */\ninterface BoardBehaviour {\n phases: Record<string, PhaseBehaviour>;\n tools?: AnyBoardConfig['tools'];\n events?: AnyBoardConfig['events'];\n transitionPolicy?: AnyBoardConfig['transitionPolicy'];\n sourceClosed?: AnyBoardConfig['sourceClosed'];\n}\n\nfunction codeDeclaration(code: InstalledBoard): AnyBoardConfig {\n return declarationOf(code) ?? code;\n}\n\n/**\n * The board config a stored definition declares, with the given code behaviour. The board is\n * rebuilt from the declaration's handlers, so the stored runner reaches them.\n */\nfunction storedBoardConfig(board: StoredBoardInput, behaviour?: BoardBehaviour): AnyBoardConfig {\n const [initial] = board.phases;\n if (!initial) throw new BoardDefinitionError('A board must define at least one phase.');\n const phases: Record<string, BoardPhaseDefinition<string>> = {};\n for (const phase of board.phases) {\n if (Object.hasOwn(phases, phase.key)) {\n throw new BoardDefinitionError(`Board \"${board.key}\" declares phase \"${phase.key}\" more than once.`);\n }\n const runner = phase.runner ? withoutUndefined(phase.runner) : undefined;\n const exitTool = phase.exitTool ? withoutUndefined(phase.exitTool) : undefined;\n const declared = behaviour && Object.hasOwn(behaviour.phases, phase.key) ? behaviour.phases[phase.key] : undefined;\n phases[phase.key] = withoutUndefined({\n name: phase.name,\n description: phase.description ?? undefined,\n kind: phase.kind,\n nextPhases: storedNextPhases(phase, board.phases),\n runner,\n autoStart: phase.autoStart ? true : undefined,\n autoStartWhen: phase.autoStartWhen ?? undefined,\n exitTool,\n outcomes: declared?.outcomes,\n onEnter: declared?.onEnter,\n onExit: declared?.onExit,\n }) as BoardPhaseDefinition<string>;\n }\n return {\n id: board.key,\n name: board.name,\n ...(board.description != null ? { description: board.description } : {}),\n initialPhase: initial.key,\n phases,\n ...(behaviour?.tools ? { tools: behaviour.tools } : {}),\n ...(behaviour?.events ? { events: behaviour.events } : {}),\n ...(behaviour?.transitionPolicy ? { transitionPolicy: behaviour.transitionPolicy } : {}),\n ...(behaviour?.sourceClosed ? { sourceClosed: behaviour.sourceClosed } : {}),\n };\n}\n\n/** What a code board's behaviour holds fixed on each of its phases; the rest of the phase is editable. */\ninterface CodePhaseBehaviour {\n /** Code handlers run on entering or leaving it, so its runner context and skill are fixed. */\n handlers: boolean;\n /** The exit tool its code behaviour waits for, if any. */\n exitToolId: string | null;\n /** Phases code moves cards to from it; they stay in its nextPhases. */\n requiredNextPhases: string[];\n}\n\n/** The per-phase locks `codeBehaviourConflicts` enforces, for clients that show them. */\nexport function codeBehaviourOf(code: InstalledBoard): Record<string, CodePhaseBehaviour> {\n const declaration: AnyBoardConfig = declarationOf(code) ?? code;\n return Object.fromEntries(\n (Object.entries(code.phases) as [string, BoardPhase<string>][]).map(([key, phase]) => [\n key,\n {\n handlers: phase.kind === 'working' && hasHandlers(declaration.phases[key]),\n exitToolId: phase.kind === 'working' ? (phase.exitTool?.id ?? null) : null,\n requiredNextPhases: [...phase.nextPhases],\n },\n ]),\n );\n}\n\nfunction hasHandlers(phase: BoardPhaseDefinition<string> | undefined): boolean {\n return Object.keys(phase?.onEnter ?? {}).length > 0 || Object.keys(phase?.onExit ?? {}).length > 0;\n}\n\n/**\n * Why a stored definition of a code board's key can't run with that board's code behaviour, one\n * reason per locked change; empty when it can. Code handlers and checks name the board's phases,\n * its first phase, the context, skill and exit tool of phases with handlers, and the moves code\n * makes between phases (tool and event rules, `sourceClosed`, integrations, handler prompts), so\n * those stay as code declares them. Names, descriptions, added moves, start and approval\n * conditions, runner instructions and new phases are free.\n */\nexport function codeBehaviourConflicts(board: StoredBoardInput, code: InstalledBoard): string[] {\n const declaration: AnyBoardConfig = declarationOf(code) ?? code;\n const stored = new Map(board.phases.map(phase => [phase.key, phase]));\n const conflicts: string[] = [];\n if (board.phases[0]?.key !== code.initialPhase) {\n conflicts.push(`Cards on board \"${code.id}\" start in \"${code.initialPhase}\"; keep it the first phase.`);\n }\n for (const [key, phase] of Object.entries(code.phases) as [string, BoardPhase<string>][]) {\n const edited = stored.get(key);\n const label = `Phase \"${key}\"`;\n if (!edited) {\n conflicts.push(`${label} has code behaviour on board \"${code.id}\"; it can't be removed.`);\n continue;\n }\n conflicts.push(...phaseShapeConflicts(key, phase, declaration.phases[key], edited));\n if (edited.kind !== phase.kind) continue;\n const nextPhases = storedNextPhases(edited, board.phases);\n const outcomes = new Map(Object.entries(phase.outcomes ?? {}).map(([outcome, target]) => [target, outcome]));\n for (const target of phase.nextPhases) {\n if (nextPhases.includes(target)) continue;\n const outcome = outcomes.get(target);\n conflicts.push(\n outcome\n ? `${label} outcome \"${outcome}\" moves cards to \"${target}\"; keep it in nextPhases.`\n : `${label}: Factory's code moves cards from it to \"${target}\"; keep it in nextPhases.`,\n );\n }\n }\n return conflicts;\n}\n\n/**\n * Why a stored phase isn't in the shape its code behaviour depends on: its kind and, on a working\n * phase, the runner context and skill its code handlers run with and the exit tool they wait for.\n */\nfunction phaseShapeConflicts(\n key: string,\n phase: BoardPhase<string>,\n declared: BoardPhaseDefinition<string> | undefined,\n edited: StoredPhaseInput,\n): string[] {\n const label = `Phase \"${key}\"`;\n if (edited.kind !== phase.kind) return [`${label} must stay ${phase.kind}; its code behaviour depends on it.`];\n if (phase.kind !== 'working') return [];\n const conflicts: string[] = [];\n if (hasHandlers(declared)) {\n const context = edited.runner?.context ?? DEFAULT_PHASE_CONTEXT;\n if (context !== phase.runner.context) {\n conflicts.push(`${label} runs its code handlers in the \"${phase.runner.context}\" context; keep runner.context.`);\n }\n if (edited.runner?.skill !== phase.runner.skill) {\n conflicts.push(\n phase.runner.skill\n ? `${label} code handlers run with skill \"${phase.runner.skill}\"; keep runner.skill.`\n : `${label} code handlers choose the skill; leave runner.skill unset.`,\n );\n }\n }\n if (phase.exitTool && edited.exitTool?.id !== phase.exitTool.id) {\n conflicts.push(`${label} code behaviour waits for exit tool \"${phase.exitTool.id}\"; keep exitTool.id.`);\n } else if (!phase.exitTool && edited.exitTool && hasHandlers(declared)) {\n // An exit tool gates every move out of the phase, including the ones its code handlers make.\n conflicts.push(`${label} code handlers move cards on without an exit tool; leave exitTool unset.`);\n }\n return conflicts;\n}\n\n/** Whether two storable definitions describe the same board once unset fields and defaults are resolved. */\nexport function sameBoardDefinition(a: StoredBoardInput, b: StoredBoardInput): boolean {\n return (\n canonicalJson(boardDefinitionOf(compileStoredBoard(a))) === canonicalJson(boardDefinitionOf(compileStoredBoard(b)))\n );\n}\n\nfunction canonicalJson(value: unknown): string {\n if (Array.isArray(value)) return `[${value.map(canonicalJson).join(',')}]`;\n if (value !== null && typeof value === 'object') {\n const entries = Object.entries(value)\n .filter(([, entry]) => entry !== undefined)\n .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));\n return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson(entry)}`).join(',')}}`;\n }\n return JSON.stringify(value);\n}\n\n/**\n * A board's storable definition, in the shape the boards API reads and writes. The initial phase\n * comes first and every phase's resolved `nextPhases` is written out.\n */\nexport function boardDefinitionOf(board: InstalledBoard): StoredBoardInput {\n const order = [board.initialPhase, ...Object.keys(board.phases).filter(key => key !== board.initialPhase)];\n return {\n key: board.id,\n name: board.name,\n ...(board.description !== undefined ? { description: board.description } : {}),\n phases: order.map(key => storedPhase(key, board.phases[key]!)),\n };\n}\n\nfunction storedPhase(key: string, phase: BoardPhase<string>): StoredPhaseInput {\n return withoutUndefined({\n key,\n name: phase.name,\n description: phase.description,\n kind: phase.kind,\n nextPhases: [...phase.nextPhases],\n ...(phase.kind === 'working'\n ? {\n runner: withoutUndefined({\n skill: phase.runner.skill,\n context: phase.runner.context,\n instructions: phase.runner.instructions,\n }),\n autoStart: phase.autoStart ? true : undefined,\n autoStartWhen: phase.autoStartWhen,\n exitTool: phase.exitTool\n ? withoutUndefined({\n id: phase.exitTool.id,\n autoApprove: phase.exitTool.autoApprove,\n autoApproveWhen: phase.exitTool.autoApproveWhen,\n })\n : undefined,\n }\n : {}),\n });\n}\n\nfunction withoutUndefined<T extends object>(value: T): T {\n return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined)) as T;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"stored-board.js","names":[],"sources":["../../src/boards/stored-board.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { cardRuleGroupSchema } from '../rules/rule-group.js';\nimport type { StoredBoardInput, StoredPhaseInput } from '../storage/domains/boards/base.js';\nimport { BoardDefinitionError, compileBoardDefinition, declarationOf, FACTORY_PHASE_TOOLS } from './define-board.js';\nimport type { AnyBoardConfig, BoardPhase, BoardPhaseDefinition } from './define-board.js';\nimport type { InstalledBoard } from './registry.js';\n\nconst storedRunnerSchema = z\n .object({\n skill: z.string().optional(),\n context: z.string().optional(),\n instructions: z.string().optional(),\n goal: z.object({ objective: z.string(), maxRuns: z.number().optional() }).strict().optional(),\n })\n .strict();\n\nconst storedExitToolSchema = z\n .object({\n id: z.string(),\n autoApprove: z.boolean().optional(),\n autoApproveWhen: cardRuleGroupSchema.optional(),\n })\n .strict();\n\nexport const storedPhaseInputSchema = z\n .object({\n key: z.string(),\n name: z.string(),\n description: z.string().nullish(),\n kind: z.enum(['resting', 'working', 'terminal']),\n runner: storedRunnerSchema.nullish(),\n nextPhases: z.array(z.string()).nullish(),\n autoStart: z.boolean().optional(),\n autoStartWhen: cardRuleGroupSchema.nullish(),\n exitTool: storedExitToolSchema.nullish(),\n tools: z.array(z.enum(FACTORY_PHASE_TOOLS)).nullish(),\n })\n .strict();\n\nfunction storedBoardFields() {\n return {\n name: z.string(),\n description: z.string().nullish(),\n phases: z.array(storedPhaseInputSchema).min(1, 'A board must define at least one phase.'),\n };\n}\n\n/**\n * A board's editable fields without its key, the shape of a replace. Only the shape: the board\n * rules run once the key is known, through {@link storedBoardInputSchema}.\n */\nexport const storedBoardDefinitionSchema = z.object(storedBoardFields()).strict();\n\n/**\n * A board as the API accepts it. Beyond the shape, it holds every rule `defineBoard()` enforces\n * (identifiers, lengths, phase kinds, runners, exit tools, conditions, targets), reported with\n * the same messages.\n */\nexport const storedBoardInputSchema = z\n .object({ key: z.string(), ...storedBoardFields() })\n .strict()\n .superRefine((input, context) => {\n try {\n compileStoredBoard(input);\n } catch (error) {\n if (!(error instanceof BoardDefinitionError)) throw error;\n context.addIssue({ code: 'custom', message: error.message });\n }\n });\n\n/** Phases a stored phase may move to: unset on a resting or working phase means every other phase. */\nfunction storedNextPhases(phase: StoredPhaseInput, phases: readonly StoredPhaseInput[]): string[] {\n if (phase.nextPhases != null) return phase.nextPhases;\n if (phase.kind === 'terminal') return [];\n return phases.filter(other => other.key !== phase.key).map(other => other.key);\n}\n\n/**\n * Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where\n * cards start.\n *\n * With `code`, the board is a project's edit of that code board: its phases come from the stored\n * definition and the board-level behaviour from the code declaration (`tools`, `events`,\n * `sourceClosed`, `transitionPolicy`). An edit that behaviour can't honour\n * ({@link codeBehaviourConflicts}) is refused.\n */\nexport function compileStoredBoard(board: StoredBoardInput, code?: InstalledBoard): InstalledBoard {\n if (!code) return compileBoardDefinition(storedBoardConfig(board));\n const conflicts = codeBehaviourConflicts(board, code);\n if (conflicts.length > 0) throw new BoardDefinitionError(conflicts.join(' '));\n const declaration = codeDeclaration(code);\n return compileBoardDefinition(\n storedBoardConfig(board, {\n tools: declaration.tools,\n events: declaration.events,\n transitionPolicy: declaration.transitionPolicy,\n sourceClosed: declaration.sourceClosed,\n }),\n code,\n );\n}\n\n/** A board served from a stored row, and what of its code board's behaviour it runs without. */\ninterface MergedStoredBoard {\n board: InstalledBoard;\n /** One per piece of code behaviour the row can't run with; empty when it runs with all of it. */\n problems: string[];\n}\n\n/**\n * Serves a stored row of a code board's key with the code behaviour that still fits it. Unlike\n * {@link compileStoredBoard}, nothing is refused: a row that fell out of step with its code (an\n * edit from before a release added a phase or a code move, a row older than editable code boards)\n * still runs as stored.\n *\n * - The board's `tools` always attach: they hold the exit-tool approval that keeps anyone but a\n * person from moving a card past an unapproved exit tool. If the row lacks a code phase, the\n * moves they make to it are refused, and that is reported.\n * - The board's `events` and `transitionPolicy` attach only when the row has every code phase,\n * since their handlers may move cards to any of them; `sourceClosed` when both of its phases are\n * stored and terminal.\n * - A move code makes that the row's `nextPhases` don't allow is reported; code making it is refused.\n * - If the board still fails to compile with that behaviour, it runs without any.\n *\n * The result links to `code` as its code board either way. Throws only when the row itself is\n * invalid.\n */\nexport function mergeCodeBehaviour(row: StoredBoardInput, code: InstalledBoard): MergedStoredBoard {\n const declaration = codeDeclaration(code);\n const stored = new Map(row.phases.map(phase => [phase.key, phase]));\n const problems: string[] = [];\n for (const [key, phase] of Object.entries(code.phases) as [string, BoardPhase<string>][]) {\n const edited = stored.get(key);\n if (!edited || edited.kind !== phase.kind) continue;\n // A move code makes that the row doesn't allow is refused when code makes it.\n const allowed = storedNextPhases(edited, row.phases);\n for (const target of phase.nextPhases) {\n if (stored.has(target) && !allowed.includes(target)) {\n problems.push(\n `Board \"${row.key}\" doesn't let phase \"${key}\" move cards to \"${target}\", so Factory's code can't make that move.`,\n );\n }\n }\n }\n\n const board: BoardBehaviour = {};\n const missing = Object.keys(code.phases).filter(key => !stored.has(key));\n const unfit = missing.length > 0 ? missingPhases(missing) : undefined;\n const tools = Object.keys(declaration.tools ?? {});\n if (tools.length > 0) {\n board.tools = declaration.tools;\n if (unfit) {\n problems.push(\n `Board \"${row.key}\" keeps its code tool rules (${tools.join(', ')}), but can't move cards where they lead: ${unfit}`,\n );\n }\n }\n const events = Object.keys(declaration.events ?? {});\n if (events.length > 0) {\n if (unfit) problems.push(`Board \"${row.key}\" runs without its code event rules (${events.join(', ')}): ${unfit}`);\n else board.events = declaration.events;\n }\n if (declaration.transitionPolicy) {\n if (unfit) problems.push(`Board \"${row.key}\" runs without its code transition policy: ${unfit}`);\n else board.transitionPolicy = declaration.transitionPolicy;\n }\n const sourceClosed = declaration.sourceClosed;\n if (sourceClosed) {\n const closed = [sourceClosed.completed, sourceClosed.canceled];\n const closedMissing = closed.filter(key => !stored.has(key));\n const closedOpen = closed.filter(key => stored.has(key) && stored.get(key)!.kind !== 'terminal');\n if (closedMissing.length > 0) {\n problems.push(`Board \"${row.key}\" doesn't move cards when their source closes: ${missingPhases(closedMissing)}`);\n } else if (closedOpen.length > 0) {\n problems.push(\n `Board \"${row.key}\" doesn't move cards when their source closes: ${\n closedOpen.length === 1\n ? `phase \"${closedOpen[0]}\" isn't terminal.`\n : `phases ${closedOpen.map(key => `\"${key}\"`).join(', ')} aren't terminal.`\n }`,\n );\n } else board.sourceClosed = sourceClosed;\n }\n\n try {\n return { board: compileBoardDefinition(storedBoardConfig(row, board), code), problems };\n } catch (error) {\n if (!(error instanceof BoardDefinitionError)) throw error;\n return {\n board: compileBoardDefinition(storedBoardConfig(row), code),\n problems: [...problems, `Board \"${row.key}\" runs without its code behaviour: ${error.message}`],\n };\n }\n}\n\nfunction missingPhases(keys: string[]): string {\n return keys.length === 1\n ? `phase \"${keys[0]}\" isn't stored.`\n : `phases ${keys.map(key => `\"${key}\"`).join(', ')} aren't stored.`;\n}\n\n/** The code behaviour a stored board runs with. */\ninterface BoardBehaviour {\n tools?: AnyBoardConfig['tools'];\n events?: AnyBoardConfig['events'];\n transitionPolicy?: AnyBoardConfig['transitionPolicy'];\n sourceClosed?: AnyBoardConfig['sourceClosed'];\n}\n\nfunction codeDeclaration(code: InstalledBoard): AnyBoardConfig {\n return declarationOf(code) ?? code;\n}\n\n/** The board config a stored definition declares, with the given code behaviour. */\nfunction storedBoardConfig(board: StoredBoardInput, behaviour?: BoardBehaviour): AnyBoardConfig {\n const [initial] = board.phases;\n if (!initial) throw new BoardDefinitionError('A board must define at least one phase.');\n const phases: Record<string, BoardPhaseDefinition<string>> = {};\n for (const phase of board.phases) {\n if (Object.hasOwn(phases, phase.key)) {\n throw new BoardDefinitionError(`Board \"${board.key}\" declares phase \"${phase.key}\" more than once.`);\n }\n const runner = phase.runner ? withoutUndefined(phase.runner) : undefined;\n const exitTool = phase.exitTool ? withoutUndefined(phase.exitTool) : undefined;\n phases[phase.key] = withoutUndefined({\n name: phase.name,\n description: phase.description ?? undefined,\n kind: phase.kind,\n nextPhases: storedNextPhases(phase, board.phases),\n runner,\n autoStart: phase.autoStart ? true : undefined,\n autoStartWhen: phase.autoStartWhen ?? undefined,\n exitTool,\n tools: phase.tools?.length ? phase.tools : undefined,\n }) as BoardPhaseDefinition<string>;\n }\n return {\n id: board.key,\n name: board.name,\n ...(board.description != null ? { description: board.description } : {}),\n initialPhase: initial.key,\n phases,\n ...(behaviour?.tools ? { tools: behaviour.tools } : {}),\n ...(behaviour?.events ? { events: behaviour.events } : {}),\n ...(behaviour?.transitionPolicy ? { transitionPolicy: behaviour.transitionPolicy } : {}),\n ...(behaviour?.sourceClosed ? { sourceClosed: behaviour.sourceClosed } : {}),\n };\n}\n\n/** What a code board's behaviour holds fixed on each of its phases; the rest of the phase is editable. */\ninterface CodePhaseBehaviour {\n /** Phases code moves cards to from it; they stay in its nextPhases. */\n requiredNextPhases: string[];\n}\n\n/** The per-phase locks `codeBehaviourConflicts` enforces, for clients that show them. */\nexport function codeBehaviourOf(code: InstalledBoard): Record<string, CodePhaseBehaviour> {\n return Object.fromEntries(\n (Object.entries(code.phases) as [string, BoardPhase<string>][]).map(([key, phase]) => [\n key,\n { requiredNextPhases: [...phase.nextPhases] },\n ]),\n );\n}\n\n/**\n * Why a stored definition of a code board's key can't run with that board's code behaviour, one\n * reason per locked change; empty when it can. Code (tool and event rules, `sourceClosed`,\n * integrations) names the board's phases, its first phase, each phase's kind and the moves it\n * makes between phases, so those stay as code declares them. Names, descriptions, runners, exit\n * tools, phase tools, added moves, start and approval conditions and new phases are free.\n */\nexport function codeBehaviourConflicts(board: StoredBoardInput, code: InstalledBoard): string[] {\n const stored = new Map(board.phases.map(phase => [phase.key, phase]));\n const conflicts: string[] = [];\n if (board.phases[0]?.key !== code.initialPhase) {\n conflicts.push(`Cards on board \"${code.id}\" start in \"${code.initialPhase}\"; keep it the first phase.`);\n }\n for (const [key, phase] of Object.entries(code.phases) as [string, BoardPhase<string>][]) {\n const edited = stored.get(key);\n const label = `Phase \"${key}\"`;\n if (!edited) {\n conflicts.push(`${label} has code behaviour on board \"${code.id}\"; it can't be removed.`);\n continue;\n }\n if (edited.kind !== phase.kind) {\n conflicts.push(`${label} must stay ${phase.kind}; its code behaviour depends on it.`);\n continue;\n }\n const nextPhases = storedNextPhases(edited, board.phases);\n for (const target of phase.nextPhases) {\n if (nextPhases.includes(target)) continue;\n conflicts.push(`${label}: Factory's code moves cards from it to \"${target}\"; keep it in nextPhases.`);\n }\n }\n return conflicts;\n}\n\n/** Whether two storable definitions describe the same board once unset fields and defaults are resolved. */\nexport function sameBoardDefinition(a: StoredBoardInput, b: StoredBoardInput): boolean {\n return (\n canonicalJson(boardDefinitionOf(compileStoredBoard(a))) === canonicalJson(boardDefinitionOf(compileStoredBoard(b)))\n );\n}\n\nfunction canonicalJson(value: unknown): string {\n if (Array.isArray(value)) return `[${value.map(canonicalJson).join(',')}]`;\n if (value !== null && typeof value === 'object') {\n const entries = Object.entries(value)\n .filter(([, entry]) => entry !== undefined)\n .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));\n return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson(entry)}`).join(',')}}`;\n }\n return JSON.stringify(value);\n}\n\n/**\n * A board's storable definition, in the shape the boards API reads and writes. The initial phase\n * comes first and every phase's resolved `nextPhases` is written out.\n */\nexport function boardDefinitionOf(board: InstalledBoard): StoredBoardInput {\n const order = [board.initialPhase, ...Object.keys(board.phases).filter(key => key !== board.initialPhase)];\n return {\n key: board.id,\n name: board.name,\n ...(board.description !== undefined ? { description: board.description } : {}),\n phases: order.map(key => storedPhase(key, board.phases[key]!)),\n };\n}\n\nfunction storedPhase(key: string, phase: BoardPhase<string>): StoredPhaseInput {\n return withoutUndefined({\n key,\n name: phase.name,\n description: phase.description,\n kind: phase.kind,\n nextPhases: [...phase.nextPhases],\n ...(phase.kind === 'working'\n ? {\n runner: withoutUndefined({\n skill: phase.runner.skill,\n context: phase.runner.context,\n instructions: phase.runner.instructions,\n goal: phase.runner.goal ? { ...phase.runner.goal } : undefined,\n }),\n autoStart: phase.autoStart ? true : undefined,\n autoStartWhen: phase.autoStartWhen,\n exitTool: phase.exitTool\n ? withoutUndefined({\n id: phase.exitTool.id,\n autoApprove: phase.exitTool.autoApprove,\n autoApproveWhen: phase.exitTool.autoApproveWhen,\n })\n : undefined,\n tools: phase.tools ? [...phase.tools] : undefined,\n }\n : {}),\n });\n}\n\nfunction withoutUndefined<T extends object>(value: T): T {\n return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined)) as T;\n}\n"],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ import type { BoardMigrationContext, StoredBoardInput, StoredBoardMigration, StoredBoardRecord, StoredPhaseInput } from '../storage/domains/boards/base.js';
2
+ /**
3
+ * The Work seed this migration fills from: Work as it was while it had its self-review phase and
4
+ * Triage. Only projects stored before then hold the old defaults it replaces, and their rows still
5
+ * have those phases, so they get their runners (and keep their moves into Triage) rather than
6
+ * today's seed, which has neither.
7
+ */
8
+ export declare function workSeedWithSelfReview(): StoredBoardInput;
9
+ export declare function migrateWorkPhaseRunners(board: StoredBoardRecord, seed?: StoredBoardInput): {
10
+ board: {
11
+ name: string;
12
+ description: string | null;
13
+ phases: StoredPhaseInput[];
14
+ };
15
+ filled: string[];
16
+ } | undefined;
17
+ export declare const WORK_PHASE_RUNNERS_MIGRATION: StoredBoardMigration;
18
+ /**
19
+ * Carries a project's retired self-review switch into its boards: with the switch off, a card went
20
+ * past any board's self-review phase, so the phase goes, with every move into it. A board is left
21
+ * as it is, with a warning, when its code board declares the phase (without it the board would run
22
+ * without its code rules), when cards sit in the phase (removing it would strand them), when its
23
+ * build phase could only reach the pull request review through it, or when it is another phase's
24
+ * only move.
25
+ */
26
+ export declare function migrateSelfReviewSwitch(board: StoredBoardRecord, context: BoardMigrationContext): {
27
+ board: Omit<StoredBoardInput, 'key'>;
28
+ filled: string[];
29
+ } | undefined;
30
+ /**
31
+ * Carries a project's retired auto-run switch into its boards: with it on, every run started
32
+ * without a person, so every working phase starts on its own, for every card (`autoStartWhen`
33
+ * cleared). With it off a run started on its own only where the phase said so, as it does now.
34
+ */
35
+ export declare function migrateAutoRunSwitch(board: StoredBoardRecord, context: BoardMigrationContext): {
36
+ board: Omit<StoredBoardInput, 'key'>;
37
+ filled: string[];
38
+ } | undefined;
39
+ export declare const SELF_REVIEW_MIGRATION: StoredBoardMigration;
40
+ export declare const AUTO_RUN_MIGRATION: StoredBoardMigration;
41
+ /** The board migrations each project gets once, in order. */
42
+ export declare const BOARD_MIGRATIONS: readonly StoredBoardMigration[];
43
+ //# sourceMappingURL=work-migrations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"work-migrations.d.ts","sourceRoot":"","sources":["../../src/boards/work-migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,mCAAmC,CAAC;AA8D3C;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAwBzD;AAwED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,IAAI,mBAA2B,GAC9B;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAqDnH;AAED,eAAO,MAAM,4BAA4B,EAAE,oBAI1C,CAAC;AA8BF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,qBAAqB,GAC7B;IAAE,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CA+BxE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,qBAAqB,GAC7B;IAAE,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAWxE;AAED,eAAO,MAAM,qBAAqB,EAAE,oBAInC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,oBAIhC,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,EAAE,SAAS,oBAAoB,EAI3D,CAAC"}