@mastra/factory 0.28.0-alpha.0 → 0.28.0-alpha.2

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 (335) hide show
  1. package/README.md +210 -42
  2. package/dist/boards/board-events.d.ts +34 -0
  3. package/dist/boards/board-events.d.ts.map +1 -0
  4. package/dist/boards/board-events.js +50 -0
  5. package/dist/boards/board-events.js.map +1 -0
  6. package/dist/boards/board-writes.d.ts +86 -0
  7. package/dist/boards/board-writes.d.ts.map +1 -0
  8. package/dist/boards/board-writes.js +252 -0
  9. package/dist/boards/board-writes.js.map +1 -0
  10. package/dist/boards/define-board.d.ts +16 -5
  11. package/dist/boards/define-board.d.ts.map +1 -1
  12. package/dist/boards/define-board.js +30 -8
  13. package/dist/boards/define-board.js.map +1 -1
  14. package/dist/boards/intake-routing.d.ts +30 -6
  15. package/dist/boards/intake-routing.d.ts.map +1 -1
  16. package/dist/boards/intake-routing.js +43 -5
  17. package/dist/boards/intake-routing.js.map +1 -1
  18. package/dist/boards/legacy-plan-role.d.ts.map +1 -1
  19. package/dist/boards/legacy-plan-role.js +8 -4
  20. package/dist/boards/legacy-plan-role.js.map +1 -1
  21. package/dist/boards/phase-automation.d.ts.map +1 -1
  22. package/dist/boards/phase-automation.js +7 -2
  23. package/dist/boards/phase-automation.js.map +1 -1
  24. package/dist/boards/project-boards.d.ts +18 -7
  25. package/dist/boards/project-boards.d.ts.map +1 -1
  26. package/dist/boards/project-boards.js +78 -14
  27. package/dist/boards/project-boards.js.map +1 -1
  28. package/dist/boards/stored-board.d.ts +59 -1
  29. package/dist/boards/stored-board.d.ts.map +1 -1
  30. package/dist/boards/stored-board.js +219 -7
  31. package/dist/boards/stored-board.js.map +1 -1
  32. package/dist/factory.d.ts +63 -9
  33. package/dist/factory.d.ts.map +1 -1
  34. package/dist/factory.js +187 -22
  35. package/dist/factory.js.map +1 -1
  36. package/dist/index.d.ts +3 -1
  37. package/dist/index.d.ts.map +1 -1
  38. package/dist/index.js +4 -3
  39. package/dist/integrations/base.d.ts +6 -0
  40. package/dist/integrations/base.d.ts.map +1 -1
  41. package/dist/integrations/github/acceptance-labels.d.ts +4 -0
  42. package/dist/integrations/github/acceptance-labels.d.ts.map +1 -1
  43. package/dist/integrations/github/acceptance-labels.js +1 -1
  44. package/dist/integrations/github/acceptance-labels.js.map +1 -1
  45. package/dist/integrations/github/default-rules.d.ts +2 -9
  46. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  47. package/dist/integrations/github/default-rules.js +7 -6
  48. package/dist/integrations/github/default-rules.js.map +1 -1
  49. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  50. package/dist/integrations/github/issue-reconciler.js +17 -1
  51. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  52. package/dist/integrations/github/review-status-comment.d.ts +61 -0
  53. package/dist/integrations/github/review-status-comment.d.ts.map +1 -0
  54. package/dist/integrations/github/review-status-comment.js +217 -0
  55. package/dist/integrations/github/review-status-comment.js.map +1 -0
  56. package/dist/integrations/github/review-status-reporter.d.ts +42 -0
  57. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -0
  58. package/dist/integrations/github/review-status-reporter.js +100 -0
  59. package/dist/integrations/github/review-status-reporter.js.map +1 -0
  60. package/dist/integrations/github/review-status.d.ts +28 -0
  61. package/dist/integrations/github/review-status.d.ts.map +1 -0
  62. package/dist/integrations/github/review-status.js +95 -0
  63. package/dist/integrations/github/review-status.js.map +1 -0
  64. package/dist/integrations/github/routes.d.ts.map +1 -1
  65. package/dist/integrations/github/routes.js +2 -5
  66. package/dist/integrations/github/routes.js.map +1 -1
  67. package/dist/integrations/github/rules.d.ts +13 -1
  68. package/dist/integrations/github/rules.d.ts.map +1 -1
  69. package/dist/integrations/github/rules.js +77 -6
  70. package/dist/integrations/github/rules.js.map +1 -1
  71. package/dist/integrations/gitlab/default-rules.d.ts +24 -9
  72. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  73. package/dist/integrations/gitlab/default-rules.js +4 -4
  74. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  75. package/dist/integrations/gitlab/merge-request-reconciler.js +1 -1
  76. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  77. package/dist/integrations/gitlab/routes.js +1 -3
  78. package/dist/integrations/gitlab/routes.js.map +1 -1
  79. package/dist/integrations/gitlab/rules.d.ts +16 -0
  80. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  81. package/dist/integrations/gitlab/rules.js +69 -4
  82. package/dist/integrations/gitlab/rules.js.map +1 -1
  83. package/dist/integrations/incidentio/default-rules.d.ts +1 -9
  84. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  85. package/dist/integrations/incidentio/default-rules.js +3 -4
  86. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  87. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  88. package/dist/integrations/incidentio/routes.js +1 -4
  89. package/dist/integrations/incidentio/routes.js.map +1 -1
  90. package/dist/integrations/incidentio/rules.d.ts +7 -0
  91. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  92. package/dist/integrations/incidentio/rules.js +35 -3
  93. package/dist/integrations/incidentio/rules.js.map +1 -1
  94. package/dist/integrations/jira/default-rules.d.ts +1 -9
  95. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  96. package/dist/integrations/jira/default-rules.js +3 -4
  97. package/dist/integrations/jira/default-rules.js.map +1 -1
  98. package/dist/integrations/jira/routes.d.ts.map +1 -1
  99. package/dist/integrations/jira/routes.js +1 -4
  100. package/dist/integrations/jira/routes.js.map +1 -1
  101. package/dist/integrations/jira/rules.d.ts +7 -0
  102. package/dist/integrations/jira/rules.d.ts.map +1 -1
  103. package/dist/integrations/jira/rules.js +35 -3
  104. package/dist/integrations/jira/rules.js.map +1 -1
  105. package/dist/integrations/linear/default-rules.d.ts +1 -9
  106. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  107. package/dist/integrations/linear/default-rules.js +3 -4
  108. package/dist/integrations/linear/default-rules.js.map +1 -1
  109. package/dist/integrations/linear/routes.d.ts.map +1 -1
  110. package/dist/integrations/linear/routes.js +1 -4
  111. package/dist/integrations/linear/routes.js.map +1 -1
  112. package/dist/integrations/linear/rules.d.ts +7 -0
  113. package/dist/integrations/linear/rules.d.ts.map +1 -1
  114. package/dist/integrations/linear/rules.js +35 -3
  115. package/dist/integrations/linear/rules.js.map +1 -1
  116. package/dist/integrations/platform/connect/routes.d.ts +7 -1
  117. package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
  118. package/dist/integrations/platform/connect/routes.js +42 -5
  119. package/dist/integrations/platform/connect/routes.js.map +1 -1
  120. package/dist/integrations/platform/connect/session-tools.d.ts +7 -0
  121. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -0
  122. package/dist/integrations/platform/connect/session-tools.js +30 -0
  123. package/dist/integrations/platform/connect/session-tools.js.map +1 -0
  124. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  125. package/dist/integrations/platform/github/integration.js +1 -3
  126. package/dist/integrations/platform/github/integration.js.map +1 -1
  127. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  128. package/dist/integrations/platform/jira/routes.js +1 -4
  129. package/dist/integrations/platform/jira/routes.js.map +1 -1
  130. package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
  131. package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
  132. package/dist/integrations/platform/linear/event-worker.js +9 -0
  133. package/dist/integrations/platform/linear/event-worker.js.map +1 -1
  134. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  135. package/dist/integrations/platform/linear/integration.js +1 -3
  136. package/dist/integrations/platform/linear/integration.js.map +1 -1
  137. package/dist/integrations/slack/channel-reply-processor.d.ts +2 -0
  138. package/dist/integrations/slack/channel-reply-processor.d.ts.map +1 -1
  139. package/dist/integrations/slack/channel-reply-processor.js +6 -1
  140. package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
  141. package/dist/integrations/slack/connect-route.d.ts.map +1 -1
  142. package/dist/integrations/slack/connect-route.js +1 -1
  143. package/dist/integrations/slack/connect-route.js.map +1 -1
  144. package/dist/integrations/slack/integration.d.ts.map +1 -1
  145. package/dist/integrations/slack/integration.js +2 -0
  146. package/dist/integrations/slack/integration.js.map +1 -1
  147. package/dist/integrations/slack/slack.d.ts +12 -10
  148. package/dist/integrations/slack/slack.d.ts.map +1 -1
  149. package/dist/integrations/slack/slack.js +110 -43
  150. package/dist/integrations/slack/slack.js.map +1 -1
  151. package/dist/integrations/slack/voice-clips.d.ts +32 -0
  152. package/dist/integrations/slack/voice-clips.d.ts.map +1 -0
  153. package/dist/integrations/slack/voice-clips.js +201 -0
  154. package/dist/integrations/slack/voice-clips.js.map +1 -0
  155. package/dist/integrations/workos/integration.d.ts.map +1 -1
  156. package/dist/integrations/workos/integration.js +1 -3
  157. package/dist/integrations/workos/integration.js.map +1 -1
  158. package/dist/mcp/routes.js +1 -1
  159. package/dist/packages/_internals/workspace/dist/index.js +1 -1
  160. package/dist/routes/attention-activity.js +1 -1
  161. package/dist/routes/attention-providers.js +1 -1
  162. package/dist/routes/automation-runs.d.ts.map +1 -1
  163. package/dist/routes/automation-runs.js +1 -4
  164. package/dist/routes/automation-runs.js.map +1 -1
  165. package/dist/routes/boards.d.ts +8 -6
  166. package/dist/routes/boards.d.ts.map +1 -1
  167. package/dist/routes/boards.js +73 -143
  168. package/dist/routes/boards.js.map +1 -1
  169. package/dist/routes/config.d.ts.map +1 -1
  170. package/dist/routes/config.js +3 -8
  171. package/dist/routes/config.js.map +1 -1
  172. package/dist/routes/contracts.d.ts +132 -0
  173. package/dist/routes/contracts.d.ts.map +1 -1
  174. package/dist/routes/contracts.js +77 -29
  175. package/dist/routes/contracts.js.map +1 -1
  176. package/dist/routes/fs.d.ts.map +1 -1
  177. package/dist/routes/fs.js +1 -4
  178. package/dist/routes/fs.js.map +1 -1
  179. package/dist/routes/intake-routes.d.ts.map +1 -1
  180. package/dist/routes/intake-routes.js +19 -12
  181. package/dist/routes/intake-routes.js.map +1 -1
  182. package/dist/routes/intake.d.ts.map +1 -1
  183. package/dist/routes/intake.js +3 -5
  184. package/dist/routes/intake.js.map +1 -1
  185. package/dist/routes/knowledge.d.ts.map +1 -1
  186. package/dist/routes/knowledge.js +1 -4
  187. package/dist/routes/knowledge.js.map +1 -1
  188. package/dist/routes/oauth.d.ts.map +1 -1
  189. package/dist/routes/oauth.js +1 -4
  190. package/dist/routes/oauth.js.map +1 -1
  191. package/dist/routes/projects.d.ts +3 -0
  192. package/dist/routes/projects.d.ts.map +1 -1
  193. package/dist/routes/projects.js +7 -4
  194. package/dist/routes/projects.js.map +1 -1
  195. package/dist/routes/provider-credentials.d.ts.map +1 -1
  196. package/dist/routes/provider-credentials.js +6 -0
  197. package/dist/routes/provider-credentials.js.map +1 -1
  198. package/dist/routes/route.d.ts +2 -0
  199. package/dist/routes/route.d.ts.map +1 -1
  200. package/dist/routes/route.js +5 -1
  201. package/dist/routes/route.js.map +1 -1
  202. package/dist/routes/skills.d.ts.map +1 -1
  203. package/dist/routes/skills.js +1 -4
  204. package/dist/routes/skills.js.map +1 -1
  205. package/dist/routes/source-control-sessions.d.ts.map +1 -1
  206. package/dist/routes/source-control-sessions.js +1 -3
  207. package/dist/routes/source-control-sessions.js.map +1 -1
  208. package/dist/routes/source-control-settings.d.ts.map +1 -1
  209. package/dist/routes/source-control-settings.js +3 -2
  210. package/dist/routes/source-control-settings.js.map +1 -1
  211. package/dist/routes/surface.d.ts +3 -1
  212. package/dist/routes/surface.d.ts.map +1 -1
  213. package/dist/routes/surface.js +11 -1
  214. package/dist/routes/surface.js.map +1 -1
  215. package/dist/routes/voice.d.ts +48 -0
  216. package/dist/routes/voice.d.ts.map +1 -0
  217. package/dist/routes/voice.js +248 -0
  218. package/dist/routes/voice.js.map +1 -0
  219. package/dist/routes/work-items.d.ts.map +1 -1
  220. package/dist/routes/work-items.js +1 -4
  221. package/dist/routes/work-items.js.map +1 -1
  222. package/dist/rules/decision-applicability.js +1 -1
  223. package/dist/rules/dispatcher.d.ts +28 -0
  224. package/dist/rules/dispatcher.d.ts.map +1 -1
  225. package/dist/rules/dispatcher.js +391 -93
  226. package/dist/rules/dispatcher.js.map +1 -1
  227. package/dist/rules/event-rules.d.ts +40 -1
  228. package/dist/rules/event-rules.d.ts.map +1 -1
  229. package/dist/rules/event-rules.js +59 -1
  230. package/dist/rules/event-rules.js.map +1 -1
  231. package/dist/rules/processor.js +1 -1
  232. package/dist/rules/processor.js.map +1 -1
  233. package/dist/rules/transition-service.d.ts +9 -0
  234. package/dist/rules/transition-service.d.ts.map +1 -1
  235. package/dist/rules/transition-service.js +4 -2
  236. package/dist/rules/transition-service.js.map +1 -1
  237. package/dist/rules/types.d.ts +54 -3
  238. package/dist/rules/types.d.ts.map +1 -1
  239. package/dist/rules/types.js +2 -0
  240. package/dist/rules/types.js.map +1 -1
  241. package/dist/rules/validation.d.ts.map +1 -1
  242. package/dist/rules/validation.js +57 -2
  243. package/dist/rules/validation.js.map +1 -1
  244. package/dist/session/credential-policy.d.ts +2 -2
  245. package/dist/session/credential-policy.d.ts.map +1 -1
  246. package/dist/session/credential-policy.js +3 -3
  247. package/dist/session/credential-policy.js.map +1 -1
  248. package/dist/session/default-model-hydration.d.ts +2 -2
  249. package/dist/session/default-model-hydration.d.ts.map +1 -1
  250. package/dist/session/default-model-hydration.js +4 -4
  251. package/dist/session/default-model-hydration.js.map +1 -1
  252. package/dist/session/session-threads.d.ts +8 -0
  253. package/dist/session/session-threads.d.ts.map +1 -1
  254. package/dist/session/session-threads.js +11 -1
  255. package/dist/session/session-threads.js.map +1 -1
  256. package/dist/skills/catalog.js +1 -1
  257. package/dist/storage/domains/audit/actions.d.ts +1 -1
  258. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  259. package/dist/storage/domains/audit/actions.js +2 -1
  260. package/dist/storage/domains/audit/actions.js.map +1 -1
  261. package/dist/storage/domains/audit/domain.d.ts.map +1 -1
  262. package/dist/storage/domains/audit/domain.js +1 -3
  263. package/dist/storage/domains/audit/domain.js.map +1 -1
  264. package/dist/storage/domains/boards/base.d.ts +32 -1
  265. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  266. package/dist/storage/domains/boards/base.js +155 -8
  267. package/dist/storage/domains/boards/base.js.map +1 -1
  268. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  269. package/dist/storage/domains/boards/schemas.js +13 -1
  270. package/dist/storage/domains/boards/schemas.js.map +1 -1
  271. package/dist/storage/domains/comments/routes.d.ts.map +1 -1
  272. package/dist/storage/domains/comments/routes.js +1 -3
  273. package/dist/storage/domains/comments/routes.js.map +1 -1
  274. package/dist/storage/domains/memory-settings/base.d.ts +0 -8
  275. package/dist/storage/domains/memory-settings/base.d.ts.map +1 -1
  276. package/dist/storage/domains/memory-settings/base.js +1 -11
  277. package/dist/storage/domains/memory-settings/base.js.map +1 -1
  278. package/dist/storage/domains/projects/base.d.ts +6 -0
  279. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  280. package/dist/storage/domains/projects/base.js +9 -1
  281. package/dist/storage/domains/projects/base.js.map +1 -1
  282. package/dist/storage/domains/voice-settings/base.d.ts +31 -0
  283. package/dist/storage/domains/voice-settings/base.d.ts.map +1 -0
  284. package/dist/storage/domains/voice-settings/base.js +81 -0
  285. package/dist/storage/domains/voice-settings/base.js.map +1 -0
  286. package/dist/storage/domains/work-items/base.d.ts +31 -2
  287. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  288. package/dist/storage/domains/work-items/base.js +197 -44
  289. package/dist/storage/domains/work-items/base.js.map +1 -1
  290. package/dist/storage/domains/work-items/cards.d.ts +6 -1
  291. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  292. package/dist/storage/domains/work-items/cards.js +54 -4
  293. package/dist/storage/domains/work-items/cards.js.map +1 -1
  294. package/dist/storage/domains/work-items/work-item-schema.d.ts +2 -0
  295. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  296. package/dist/storage/domains/work-items/work-item-schema.js +24 -1
  297. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  298. package/dist/timing.d.ts +1 -0
  299. package/dist/timing.d.ts.map +1 -1
  300. package/dist/timing.js +1 -1
  301. package/dist/timing.js.map +1 -1
  302. package/dist/tools/read-tools.d.ts +2 -2
  303. package/dist/tools/read-tools.d.ts.map +1 -1
  304. package/dist/tools/read-tools.js +7 -6
  305. package/dist/tools/read-tools.js.map +1 -1
  306. package/dist/tools/session-tools.d.ts +1 -1
  307. package/dist/tools/session-tools.d.ts.map +1 -1
  308. package/dist/tools/session-tools.js.map +1 -1
  309. package/dist/tools/sessions-state-processor.d.ts +1 -1
  310. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  311. package/dist/tools/sessions-state-processor.js +9 -2
  312. package/dist/tools/sessions-state-processor.js.map +1 -1
  313. package/dist/tools/work-item-tools.js +2 -2
  314. package/dist/voice/rate-limit.d.ts +13 -0
  315. package/dist/voice/rate-limit.d.ts.map +1 -0
  316. package/dist/voice/rate-limit.js +36 -0
  317. package/dist/voice/rate-limit.js.map +1 -0
  318. package/dist/voice/realtime.d.ts +13 -0
  319. package/dist/voice/realtime.d.ts.map +1 -0
  320. package/dist/voice/realtime.js +56 -0
  321. package/dist/voice/realtime.js.map +1 -0
  322. package/dist/voice/transcription.d.ts +51 -0
  323. package/dist/voice/transcription.d.ts.map +1 -0
  324. package/dist/voice/transcription.js +112 -0
  325. package/dist/voice/transcription.js.map +1 -0
  326. package/dist/work-items/split-backfill.d.ts +13 -0
  327. package/dist/work-items/split-backfill.d.ts.map +1 -0
  328. package/dist/work-items/split-backfill.js +32 -0
  329. package/dist/work-items/split-backfill.js.map +1 -0
  330. package/dist/work-items/split-migration.d.ts +39 -2
  331. package/dist/work-items/split-migration.d.ts.map +1 -1
  332. package/dist/work-items/split-migration.js +170 -62
  333. package/dist/work-items/split-migration.js.map +1 -1
  334. package/dist/workspace.js +2 -2
  335. package/package.json +12 -11
@@ -1,10 +1,19 @@
1
1
  import { findBoardSkillProblems } from "../skills/app-skills.js";
2
+ import { codeBoardOf } from "./define-board.js";
2
3
  import { createBoardRegistry, defaultBoards } from "./registry.js";
3
- import { compileStoredBoard } from "./stored-board.js";
4
+ import { reviewBoard } from "./review.js";
5
+ import { boardDefinitionOf, compileStoredBoard, mergeCodeBehaviour } from "./stored-board.js";
4
6
  // src/boards/project-boards.ts
5
7
  const DEFAULT_RECHECK_MS = 1e3;
6
8
  const PRELOAD_CONCURRENCY = 8;
7
9
  const SNAPSHOT_ATTEMPTS = 3;
10
+ /**
11
+ * Code boards Factory stores in each project: every code board except the legacy Review board,
12
+ * which is being retired and is served from code.
13
+ */
14
+ function isEditableCodeBoard(board) {
15
+ return codeBoardOf(board) !== reviewBoard;
16
+ }
8
17
  const PROJECT_BOARD_SOURCE = Symbol("ProjectBoardSource");
9
18
  /** Accepts either a fixed registry (tests, standalone services) or a per-project source. */
10
19
  function toBoardSource(boards) {
@@ -24,10 +33,14 @@ function scopeKey(scope) {
24
33
  return `${scope.orgId}\0${scope.factoryProjectId}`;
25
34
  }
26
35
  /**
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.
36
+ * The per-project board cache. A project's boards are its rows: the Work and app boards Factory
37
+ * stored in it, in code order, then the others. A Work or app board's row runs with the code
38
+ * behaviour of its board and phase keys that still fits it ({@link mergeCodeBehaviour}); only the
39
+ * legacy Review board is served from code. The first load of each project in a process stores the
40
+ * boards Factory hasn't stored in it yet, each once ({@link StoredBoardsStorage.seedBoards}); a
41
+ * release never rewrites them. Loads recheck the project's board version at most every
42
+ * `recheckMs` and recompile when it changed, so stored edits on other replicas arrive within that
43
+ * delay.
31
44
  */
32
45
  var ProjectBoardCache = class {
33
46
  [PROJECT_BOARD_SOURCE] = true;
@@ -42,7 +55,9 @@ var ProjectBoardCache = class {
42
55
  #loading = /* @__PURE__ */ new Map();
43
56
  #generations = /* @__PURE__ */ new Map();
44
57
  #warned = /* @__PURE__ */ new Set();
58
+ #seeded = /* @__PURE__ */ new Set();
45
59
  #codeSkills;
60
+ #seeds;
46
61
  constructor(options) {
47
62
  this.codeRegistry = options.codeRegistry;
48
63
  this.#storage = options.storage;
@@ -53,9 +68,18 @@ var ProjectBoardCache = class {
53
68
  this.#warn = options.warn ?? ((message) => console.warn(`[factory] ${message}`));
54
69
  this.#codeDetails = new Map([...this.codeRegistry.values()].map((board) => [board.id, {
55
70
  source: defaultBoards.includes(board) ? "builtin" : "app",
56
- editable: false,
71
+ editable: isEditableCodeBoard(board),
57
72
  problems: this.#skillProblems(board)
58
73
  }]));
74
+ this.#seeds = new Map([...this.codeRegistry.values()].filter(isEditableCodeBoard).map((board) => [board.id, boardDefinitionOf(board)]));
75
+ }
76
+ /** The boards Factory stores in each project once, in order. */
77
+ seeds() {
78
+ return [...this.#seeds.values()];
79
+ }
80
+ /** Factory's current definition for `key`, which reset restores; undefined when Factory has none. */
81
+ seedFor(key) {
82
+ return this.#seeds.get(key);
59
83
  }
60
84
  async load(scope) {
61
85
  return (await this.describe(scope)).registry;
@@ -99,7 +123,7 @@ var ProjectBoardCache = class {
99
123
  const entry = this.#entries.get(key);
100
124
  if (entry) entry.checkedAt = Number.NEGATIVE_INFINITY;
101
125
  }
102
- /** Loads every project, a few at a time, so sync reads find them warm. */
126
+ /** Loads every project, a few at a time, so sync reads find them warm and each has its boards stored. */
103
127
  async preload() {
104
128
  const projects = await this.#projects?.listAll() ?? [];
105
129
  let next = 0;
@@ -115,6 +139,7 @@ var ProjectBoardCache = class {
115
139
  await Promise.all(Array.from({ length: Math.min(PRELOAD_CONCURRENCY, projects.length) }, worker));
116
140
  }
117
141
  async #refresh(scope, key, generation) {
142
+ await this.#seed(scope, key);
118
143
  const current = this.#entries.get(key);
119
144
  const version = await this.#storage.readVersion(scope);
120
145
  if (current && current.version === version) {
@@ -139,22 +164,61 @@ var ProjectBoardCache = class {
139
164
  }
140
165
  return snapshot;
141
166
  }
167
+ /**
168
+ * Stores the boards Factory hasn't stored in the project yet, once per process. A failure is
169
+ * logged and retried on the next load; the boards it didn't store aren't served meanwhile.
170
+ */
171
+ async #seed(scope, key) {
172
+ if (this.#seeded.has(key)) return;
173
+ try {
174
+ if (this.#seeds.size > 0) await this.#storage.seedBoards(scope, this.seeds());
175
+ this.#seeded.add(key);
176
+ } catch (error) {
177
+ 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)}`);
178
+ }
179
+ }
142
180
  #compile(scope, rows) {
143
- const boards = [...this.codeRegistry.values()];
181
+ const byKey = new Map(rows.map((row) => [row.key, row]));
144
182
  const details = new Map(this.#codeDetails);
145
183
  const problems = [];
146
- 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.`);
184
+ const report = (row, messages) => {
185
+ problems.push(...messages);
186
+ for (const message of messages) this.#warnOnce(`row:${scopeKey(scope)}:${row.key}:${row.revision}:${message}`, `${message} (project ${scope.factoryProjectId})`);
187
+ };
188
+ const boards = [];
189
+ for (const code of this.codeRegistry.values()) {
190
+ const row = byKey.get(code.id);
191
+ if (!this.#seeds.has(code.id)) {
192
+ if (row) problems.push(`Stored board "${row.key}" is hidden by the code board with the same key.`);
193
+ boards.push(code);
194
+ continue;
195
+ }
196
+ if (!row) {
197
+ details.delete(code.id);
198
+ 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.`);
199
+ continue;
200
+ }
201
+ let merged;
202
+ try {
203
+ merged = mergeCodeBehaviour(row, code);
204
+ } catch (error) {
205
+ report(row, [`Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`]);
149
206
  continue;
150
207
  }
208
+ report(row, merged.problems);
209
+ details.set(code.id, {
210
+ ...details.get(code.id),
211
+ problems: [...merged.problems, ...this.#skillProblems(merged.board)]
212
+ });
213
+ boards.push(merged.board);
214
+ }
215
+ for (const row of rows) {
216
+ if (this.codeRegistry.has(row.key)) continue;
151
217
  let board;
152
218
  try {
153
219
  board = compileStoredBoard(row);
154
220
  } 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})`);
221
+ report(row, [`Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`]);
158
222
  continue;
159
223
  }
160
224
  boards.push(board);
@@ -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';\n\nimport { findBoardSkillProblems } from '../skills/app-skills.js';\nimport type {\n StoredBoardInput,\n StoredBoardRecord,\n StoredBoardScope,\n StoredBoardsStorage,\n} from '../storage/domains/boards/base.js';\nimport { codeBoardOf } from './define-board.js';\nimport { createBoardRegistry, defaultBoards } from './registry.js';\nimport type { BoardRegistry, InstalledBoard } from './registry.js';\nimport { reviewBoard } from './review.js';\nimport { boardDefinitionOf, compileStoredBoard, mergeCodeBehaviour } 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 /**\n * Stored boards, the built-in Work board and app boards can be edited; the legacy Review board,\n * which is being retired, stays read-only.\n */\n editable: boolean;\n problems: string[];\n}\n\n/**\n * Code boards Factory stores in each project: every code board except the legacy Review board,\n * which is being retired and is served from code.\n */\nfunction isEditableCodeBoard(board: InstalledBoard): boolean {\n return codeBoardOf(board) !== reviewBoard;\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 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}); only the\n * legacy Review board is served from code. 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\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: isEditableCodeBoard(board),\n problems: this.#skillProblems(board),\n },\n ]),\n );\n this.#seeds = new Map(\n [...this.codeRegistry.values()].filter(isEditableCodeBoard).map(board => [board.id, boardDefinitionOf(board)]),\n );\n }\n\n /** The boards Factory stores in each project once, in order. */\n seeds(): StoredBoardInput[] {\n return [...this.#seeds.values()];\n }\n\n /** Factory's current definition for `key`, which reset restores; undefined when Factory has none. */\n seedFor(key: string): StoredBoardInput | undefined {\n return this.#seeds.get(key);\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 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 /**\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 if (this.#seeds.size > 0) await this.#storage.seedBoards(scope, this.seeds());\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 #compile(scope: StoredBoardScope, rows: readonly StoredBoardRecord[]): 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 (!this.#seeds.has(code.id)) {\n if (row) problems.push(`Stored board \"${row.key}\" is hidden by the code board with the same key.`);\n boards.push(code);\n continue;\n }\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 for (const row of rows) {\n if (this.codeRegistry.has(row.key)) continue;\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: 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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"}
@@ -91,11 +91,69 @@ export declare const storedBoardInputSchema: z.ZodObject<{
91
91
  /**
92
92
  * Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where
93
93
  * cards start.
94
+ *
95
+ * With `code`, the board is a project's edit of that code board: its fields come from the stored
96
+ * definition and its behaviour from the code declaration, by phase key (`onEnter`, `onExit`,
97
+ * `outcomes`) and for the board (`tools`, `events`, `sourceClosed`, `transitionPolicy`). The board
98
+ * is rebuilt from the declaration, so the stored runner reaches the declared handlers. An edit code
99
+ * behaviour can't honour ({@link codeBehaviourConflicts}) is refused.
94
100
  */
95
- export declare function compileStoredBoard(board: StoredBoardInput): InstalledBoard;
101
+ export declare function compileStoredBoard(board: StoredBoardInput, code?: InstalledBoard): InstalledBoard;
102
+ /** A board served from a stored row, and what of its code board's behaviour it runs without. */
103
+ interface MergedStoredBoard {
104
+ board: InstalledBoard;
105
+ /** One per piece of code behaviour the row can't run with; empty when it runs with all of it. */
106
+ problems: string[];
107
+ }
108
+ /**
109
+ * Serves a stored row of a code board's key with the code behaviour that still fits it. Unlike
110
+ * {@link compileStoredBoard}, nothing is refused: a row that fell out of step with its code (an
111
+ * edit from before a release added a phase or a code move, a row older than editable code boards)
112
+ * still runs as stored.
113
+ *
114
+ * - A phase's `onEnter`, `onExit` and `outcomes` attach only when the row keeps the phase in the
115
+ * shape they depend on: the same kind and, on phases with code handlers, the same runner context
116
+ * and skill, the declared exit tool and no other. Outcomes whose target the row lacks or doesn't
117
+ * allow are dropped.
118
+ * - The board's `tools` always attach: they hold the exit-tool approval that keeps anyone but a
119
+ * person from moving a card past an unapproved exit tool. If the row lacks a code phase, the
120
+ * moves they make to it are refused, and that is reported.
121
+ * - The board's `events` and `transitionPolicy` attach only when the row has every code phase,
122
+ * since their handlers may move cards to any of them; `sourceClosed` when both of its phases are
123
+ * stored and terminal.
124
+ * - A move code makes that the row's `nextPhases` don't allow is reported; code making it is refused.
125
+ * - If the board still fails to compile with that behaviour, it runs without any.
126
+ *
127
+ * The result links to `code` as its code board either way. Throws only when the row itself is
128
+ * invalid.
129
+ */
130
+ export declare function mergeCodeBehaviour(row: StoredBoardInput, code: InstalledBoard): MergedStoredBoard;
131
+ /** What a code board's behaviour holds fixed on each of its phases; the rest of the phase is editable. */
132
+ interface CodePhaseBehaviour {
133
+ /** Code handlers run on entering or leaving it, so its runner context and skill are fixed. */
134
+ handlers: boolean;
135
+ /** The exit tool its code behaviour waits for, if any. */
136
+ exitToolId: string | null;
137
+ /** Phases code moves cards to from it; they stay in its nextPhases. */
138
+ requiredNextPhases: string[];
139
+ }
140
+ /** The per-phase locks `codeBehaviourConflicts` enforces, for clients that show them. */
141
+ export declare function codeBehaviourOf(code: InstalledBoard): Record<string, CodePhaseBehaviour>;
142
+ /**
143
+ * Why a stored definition of a code board's key can't run with that board's code behaviour, one
144
+ * reason per locked change; empty when it can. Code handlers and checks name the board's phases,
145
+ * its first phase, the context, skill and exit tool of phases with handlers, and the moves code
146
+ * makes between phases (tool and event rules, `sourceClosed`, integrations, handler prompts), so
147
+ * those stay as code declares them. Names, descriptions, added moves, start and approval
148
+ * conditions, runner instructions and new phases are free.
149
+ */
150
+ export declare function codeBehaviourConflicts(board: StoredBoardInput, code: InstalledBoard): string[];
151
+ /** Whether two storable definitions describe the same board once unset fields and defaults are resolved. */
152
+ export declare function sameBoardDefinition(a: StoredBoardInput, b: StoredBoardInput): boolean;
96
153
  /**
97
154
  * A board's storable definition, in the shape the boards API reads and writes. The initial phase
98
155
  * comes first and every phase's resolved `nextPhases` is written out.
99
156
  */
100
157
  export declare function boardDefinitionOf(board: InstalledBoard): StoredBoardInput;
158
+ export {};
101
159
  //# sourceMappingURL=stored-board.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"stored-board.d.ts","sourceRoot":"","sources":["../../src/boards/stored-board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,mCAAmC,CAAC;AAG5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAkBpD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;kBAYxB,CAAC;AAUZ;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAU/B,CAAC;AASL;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,CA4B1E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAQzE"}
1
+ {"version":3,"file":"stored-board.d.ts","sourceRoot":"","sources":["../../src/boards/stored-board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,mCAAmC,CAAC;AAG5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAkBpD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;kBAYxB,CAAC;AAUZ;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAU/B,CAAC;AASL;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,CAoBjG;AAED,gGAAgG;AAChG,UAAU,iBAAiB;IACzB,KAAK,EAAE,cAAc,CAAC;IACtB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,iBAAiB,CAiGjG;AAsED,0GAA0G;AAC1G,UAAU,kBAAkB;IAC1B,8FAA8F;IAC9F,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uEAAuE;IACvE,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAYxF;AAMD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CA6B9F;AAsCD,4GAA4G;AAC5G,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAIrF;AAaD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAQzE"}
@@ -1,5 +1,5 @@
1
1
  import { cardRuleGroupSchema } from "../rules/rule-group.js";
2
- import { BoardDefinitionError, compileBoardDefinition } from "./define-board.js";
2
+ import { BoardDefinitionError, 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({
@@ -67,8 +67,142 @@ function storedNextPhases(phase, phases) {
67
67
  /**
68
68
  * Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where
69
69
  * cards start.
70
+ *
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.
70
76
  */
71
- function compileStoredBoard(board) {
77
+ function compileStoredBoard(board, code) {
78
+ if (!code) return compileBoardDefinition(storedBoardConfig(board));
79
+ const conflicts = codeBehaviourConflicts(board, code);
80
+ if (conflicts.length > 0) throw new BoardDefinitionError(conflicts.join(" "));
81
+ 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
+ return compileBoardDefinition(storedBoardConfig(board, {
92
+ phases,
93
+ tools: declaration.tools,
94
+ events: declaration.events,
95
+ transitionPolicy: declaration.transitionPolicy,
96
+ sourceClosed: declaration.sourceClosed
97
+ }), code);
98
+ }
99
+ /**
100
+ * Serves a stored row of a code board's key with the code behaviour that still fits it. Unlike
101
+ * {@link compileStoredBoard}, nothing is refused: a row that fell out of step with its code (an
102
+ * edit from before a release added a phase or a code move, a row older than editable code boards)
103
+ * still runs as stored.
104
+ *
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
+ * - The board's `tools` always attach: they hold the exit-tool approval that keeps anyone but a
110
+ * person from moving a card past an unapproved exit tool. If the row lacks a code phase, the
111
+ * moves they make to it are refused, and that is reported.
112
+ * - The board's `events` and `transitionPolicy` attach only when the row has every code phase,
113
+ * since their handlers may move cards to any of them; `sourceClosed` when both of its phases are
114
+ * stored and terminal.
115
+ * - A move code makes that the row's `nextPhases` don't allow is reported; code making it is refused.
116
+ * - If the board still fails to compile with that behaviour, it runs without any.
117
+ *
118
+ * The result links to `code` as its code board either way. Throws only when the row itself is
119
+ * invalid.
120
+ */
121
+ function mergeCodeBehaviour(row, code) {
122
+ const declaration = codeDeclaration(code);
123
+ const stored = new Map(row.phases.map((phase) => [phase.key, phase]));
124
+ const problems = [];
125
+ const phases = {};
126
+ for (const [key, phase] of Object.entries(code.phases)) {
127
+ const declared = declaration.phases[key];
128
+ const outcomes = Object.entries(declared?.outcomes ?? {});
129
+ 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
+ }
145
+ 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
+ };
155
+ }
156
+ const board = { phases };
157
+ const missing = Object.keys(code.phases).filter((key) => !stored.has(key));
158
+ const unfit = missing.length > 0 ? missingPhases(missing) : void 0;
159
+ const tools = Object.keys(declaration.tools ?? {});
160
+ if (tools.length > 0) {
161
+ board.tools = declaration.tools;
162
+ if (unfit) problems.push(`Board "${row.key}" keeps its code tool rules (${tools.join(", ")}), but can't move cards where they lead: ${unfit}`);
163
+ }
164
+ const events = Object.keys(declaration.events ?? {});
165
+ if (events.length > 0) {
166
+ if (unfit) problems.push(`Board "${row.key}" runs without its code event rules (${events.join(", ")}): ${unfit}`);
167
+ else board.events = declaration.events;
168
+ }
169
+ if (declaration.transitionPolicy) {
170
+ if (unfit) problems.push(`Board "${row.key}" runs without its code transition policy: ${unfit}`);
171
+ else board.transitionPolicy = declaration.transitionPolicy;
172
+ }
173
+ const sourceClosed = declaration.sourceClosed;
174
+ if (sourceClosed) {
175
+ const closed = [sourceClosed.completed, sourceClosed.canceled];
176
+ const closedMissing = closed.filter((key) => !stored.has(key));
177
+ const closedOpen = closed.filter((key) => stored.has(key) && stored.get(key).kind !== "terminal");
178
+ if (closedMissing.length > 0) problems.push(`Board "${row.key}" doesn't move cards when their source closes: ${missingPhases(closedMissing)}`);
179
+ else if (closedOpen.length > 0) problems.push(`Board "${row.key}" doesn't move cards when their source closes: ${closedOpen.length === 1 ? `phase "${closedOpen[0]}" isn't terminal.` : `phases ${closedOpen.map((key) => `"${key}"`).join(", ")} aren't terminal.`}`);
180
+ else board.sourceClosed = sourceClosed;
181
+ }
182
+ try {
183
+ return {
184
+ board: compileBoardDefinition(storedBoardConfig(row, board), code),
185
+ problems
186
+ };
187
+ } catch (error) {
188
+ if (!(error instanceof BoardDefinitionError)) throw error;
189
+ return {
190
+ board: compileBoardDefinition(storedBoardConfig(row), code),
191
+ problems: [...problems, `Board "${row.key}" runs without its code behaviour: ${error.message}`]
192
+ };
193
+ }
194
+ }
195
+ function missingPhases(keys) {
196
+ return keys.length === 1 ? `phase "${keys[0]}" isn't stored.` : `phases ${keys.map((key) => `"${key}"`).join(", ")} aren't stored.`;
197
+ }
198
+ function codeDeclaration(code) {
199
+ return declarationOf(code) ?? code;
200
+ }
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
+ */
205
+ function storedBoardConfig(board, behaviour) {
72
206
  const [initial] = board.phases;
73
207
  if (!initial) throw new BoardDefinitionError("A board must define at least one phase.");
74
208
  const phases = {};
@@ -76,6 +210,7 @@ function compileStoredBoard(board) {
76
210
  if (Object.hasOwn(phases, phase.key)) throw new BoardDefinitionError(`Board "${board.key}" declares phase "${phase.key}" more than once.`);
77
211
  const runner = phase.runner ? withoutUndefined(phase.runner) : void 0;
78
212
  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;
79
214
  phases[phase.key] = withoutUndefined({
80
215
  name: phase.name,
81
216
  description: phase.description ?? void 0,
@@ -84,16 +219,93 @@ function compileStoredBoard(board) {
84
219
  runner,
85
220
  autoStart: phase.autoStart ? true : void 0,
86
221
  autoStartWhen: phase.autoStartWhen ?? void 0,
87
- exitTool
222
+ exitTool,
223
+ outcomes: declared?.outcomes,
224
+ onEnter: declared?.onEnter,
225
+ onExit: declared?.onExit
88
226
  });
89
227
  }
90
- return compileBoardDefinition({
228
+ return {
91
229
  id: board.key,
92
230
  name: board.name,
93
231
  ...board.description != null ? { description: board.description } : {},
94
232
  initialPhase: initial.key,
95
- phases
96
- });
233
+ phases,
234
+ ...behaviour?.tools ? { tools: behaviour.tools } : {},
235
+ ...behaviour?.events ? { events: behaviour.events } : {},
236
+ ...behaviour?.transitionPolicy ? { transitionPolicy: behaviour.transitionPolicy } : {},
237
+ ...behaviour?.sourceClosed ? { sourceClosed: behaviour.sourceClosed } : {}
238
+ };
239
+ }
240
+ /** The per-phase locks `codeBehaviourConflicts` enforces, for clients that show them. */
241
+ 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;
251
+ }
252
+ /**
253
+ * 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.
259
+ */
260
+ function codeBehaviourConflicts(board, code) {
261
+ const declaration = declarationOf(code) ?? code;
262
+ const stored = new Map(board.phases.map((phase) => [phase.key, phase]));
263
+ const conflicts = [];
264
+ if (board.phases[0]?.key !== code.initialPhase) conflicts.push(`Cards on board "${code.id}" start in "${code.initialPhase}"; keep it the first phase.`);
265
+ for (const [key, phase] of Object.entries(code.phases)) {
266
+ const edited = stored.get(key);
267
+ const label = `Phase "${key}"`;
268
+ if (!edited) {
269
+ conflicts.push(`${label} has code behaviour on board "${code.id}"; it can't be removed.`);
270
+ continue;
271
+ }
272
+ conflicts.push(...phaseShapeConflicts(key, phase, declaration.phases[key], edited));
273
+ if (edited.kind !== phase.kind) continue;
274
+ const nextPhases = storedNextPhases(edited, board.phases);
275
+ const outcomes = new Map(Object.entries(phase.outcomes ?? {}).map(([outcome, target]) => [target, outcome]));
276
+ for (const target of phase.nextPhases) {
277
+ 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.`);
280
+ }
281
+ }
282
+ return conflicts;
283
+ }
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
+ /** Whether two storable definitions describe the same board once unset fields and defaults are resolved. */
302
+ function sameBoardDefinition(a, b) {
303
+ return canonicalJson(boardDefinitionOf(compileStoredBoard(a))) === canonicalJson(boardDefinitionOf(compileStoredBoard(b)));
304
+ }
305
+ function canonicalJson(value) {
306
+ if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
307
+ if (value !== null && typeof value === "object") return `{${Object.entries(value).filter(([, entry]) => entry !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson(entry)}`).join(",")}}`;
308
+ return JSON.stringify(value);
97
309
  }
98
310
  /**
99
311
  * A board's storable definition, in the shape the boards API reads and writes. The initial phase
@@ -134,6 +346,6 @@ function storedPhase(key, phase) {
134
346
  function withoutUndefined(value) {
135
347
  return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== void 0));
136
348
  }
137
- export { boardDefinitionOf, compileStoredBoard, storedBoardDefinitionSchema, storedBoardInputSchema, storedPhaseInputSchema };
349
+ export { boardDefinitionOf, codeBehaviourConflicts, codeBehaviourOf, compileStoredBoard, mergeCodeBehaviour, sameBoardDefinition, storedBoardDefinitionSchema, storedBoardInputSchema, storedPhaseInputSchema };
138
350
 
139
351
  //# sourceMappingURL=stored-board.js.map