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

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 (455) hide show
  1. package/README.md +329 -154
  2. package/dist/boards/board-events.d.ts +23 -3
  3. package/dist/boards/board-events.d.ts.map +1 -1
  4. package/dist/boards/board-events.js +44 -7
  5. package/dist/boards/board-events.js.map +1 -1
  6. package/dist/boards/board-writes.d.ts +1 -1
  7. package/dist/boards/board-writes.d.ts.map +1 -1
  8. package/dist/boards/board-writes.js +16 -1
  9. package/dist/boards/board-writes.js.map +1 -1
  10. package/dist/boards/card-facts.d.ts +3 -1
  11. package/dist/boards/card-facts.d.ts.map +1 -1
  12. package/dist/boards/card-facts.js +30 -4
  13. package/dist/boards/card-facts.js.map +1 -1
  14. package/dist/boards/default-board.d.ts +7 -0
  15. package/dist/boards/default-board.d.ts.map +1 -0
  16. package/dist/boards/default-board.js +10 -0
  17. package/dist/boards/default-board.js.map +1 -0
  18. package/dist/boards/define-board.d.ts +40 -18
  19. package/dist/boards/define-board.d.ts.map +1 -1
  20. package/dist/boards/define-board.js +64 -42
  21. package/dist/boards/define-board.js.map +1 -1
  22. package/dist/boards/index.d.ts +5 -8
  23. package/dist/boards/index.d.ts.map +1 -1
  24. package/dist/boards/index.js +5 -19
  25. package/dist/boards/intake-routing.d.ts +29 -9
  26. package/dist/boards/intake-routing.d.ts.map +1 -1
  27. package/dist/boards/intake-routing.js +72 -20
  28. package/dist/boards/intake-routing.js.map +1 -1
  29. package/dist/boards/legacy-plan-role.d.ts.map +1 -1
  30. package/dist/boards/legacy-plan-role.js +7 -2
  31. package/dist/boards/legacy-plan-role.js.map +1 -1
  32. package/dist/boards/phase-automation.d.ts +7 -0
  33. package/dist/boards/phase-automation.d.ts.map +1 -1
  34. package/dist/boards/phase-automation.js +16 -5
  35. package/dist/boards/phase-automation.js.map +1 -1
  36. package/dist/boards/phase-runner.d.ts +18 -10
  37. package/dist/boards/phase-runner.d.ts.map +1 -1
  38. package/dist/boards/phase-runner.js +39 -34
  39. package/dist/boards/phase-runner.js.map +1 -1
  40. package/dist/boards/project-boards.d.ts +27 -7
  41. package/dist/boards/project-boards.d.ts.map +1 -1
  42. package/dist/boards/project-boards.js +94 -19
  43. package/dist/boards/project-boards.js.map +1 -1
  44. package/dist/boards/registry.d.ts.map +1 -1
  45. package/dist/boards/registry.js +3 -1
  46. package/dist/boards/registry.js.map +1 -1
  47. package/dist/boards/relocate.d.ts +1 -1
  48. package/dist/boards/relocate.d.ts.map +1 -1
  49. package/dist/boards/relocate.js +3 -2
  50. package/dist/boards/relocate.js.map +1 -1
  51. package/dist/boards/review.d.ts +5 -2
  52. package/dist/boards/review.d.ts.map +1 -1
  53. package/dist/boards/review.js +12 -11
  54. package/dist/boards/review.js.map +1 -1
  55. package/dist/boards/semantics.d.ts +159 -20
  56. package/dist/boards/semantics.d.ts.map +1 -1
  57. package/dist/boards/semantics.js +254 -23
  58. package/dist/boards/semantics.js.map +1 -1
  59. package/dist/boards/stored-board.d.ts +32 -18
  60. package/dist/boards/stored-board.d.ts.map +1 -1
  61. package/dist/boards/stored-board.js +31 -97
  62. package/dist/boards/stored-board.js.map +1 -1
  63. package/dist/boards/work-migrations.d.ts +42 -0
  64. package/dist/boards/work-migrations.d.ts.map +1 -0
  65. package/dist/boards/work-migrations.js +352 -0
  66. package/dist/boards/work-migrations.js.map +1 -0
  67. package/dist/boards/work-routes.d.ts +58 -0
  68. package/dist/boards/work-routes.d.ts.map +1 -0
  69. package/dist/boards/work-routes.js +270 -0
  70. package/dist/boards/work-routes.js.map +1 -0
  71. package/dist/boards/work.d.ts +8 -19
  72. package/dist/boards/work.d.ts.map +1 -1
  73. package/dist/boards/work.js +38 -270
  74. package/dist/boards/work.js.map +1 -1
  75. package/dist/factory.d.ts +26 -3
  76. package/dist/factory.d.ts.map +1 -1
  77. package/dist/factory.js +105 -62
  78. package/dist/factory.js.map +1 -1
  79. package/dist/index.d.ts +5 -2
  80. package/dist/index.d.ts.map +1 -1
  81. package/dist/index.js +3 -3
  82. package/dist/integrations/base.d.ts +6 -2
  83. package/dist/integrations/base.d.ts.map +1 -1
  84. package/dist/integrations/closing-references.d.ts +15 -0
  85. package/dist/integrations/closing-references.d.ts.map +1 -0
  86. package/dist/integrations/closing-references.js +69 -0
  87. package/dist/integrations/closing-references.js.map +1 -0
  88. package/dist/integrations/github/default-rules.d.ts +15 -66
  89. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  90. package/dist/integrations/github/default-rules.js +129 -73
  91. package/dist/integrations/github/default-rules.js.map +1 -1
  92. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  93. package/dist/integrations/github/issue-reconciler.js +3 -1
  94. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  95. package/dist/integrations/github/pull-request-source.d.ts +8 -0
  96. package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
  97. package/dist/integrations/github/pull-request-source.js +17 -0
  98. package/dist/integrations/github/pull-request-source.js.map +1 -0
  99. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -1
  100. package/dist/integrations/github/review-status-reporter.js +7 -3
  101. package/dist/integrations/github/review-status-reporter.js.map +1 -1
  102. package/dist/integrations/github/routes.js +1 -1
  103. package/dist/integrations/github/rules.d.ts +12 -7
  104. package/dist/integrations/github/rules.d.ts.map +1 -1
  105. package/dist/integrations/github/rules.js +214 -93
  106. package/dist/integrations/github/rules.js.map +1 -1
  107. package/dist/integrations/github/session-subscriptions.js +2 -2
  108. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  109. package/dist/integrations/github/token-refresh.d.ts +2 -1
  110. package/dist/integrations/github/token-refresh.d.ts.map +1 -1
  111. package/dist/integrations/github/token-refresh.js.map +1 -1
  112. package/dist/integrations/gitlab/agent-tools.js +1 -1
  113. package/dist/integrations/gitlab/default-rules.d.ts +73 -31
  114. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  115. package/dist/integrations/gitlab/default-rules.js +106 -43
  116. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  117. package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
  118. package/dist/integrations/gitlab/issue-reconciler.js +2 -1
  119. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  120. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  121. package/dist/integrations/gitlab/merge-request-reconciler.js +11 -4
  122. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  123. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  124. package/dist/integrations/gitlab/routes.js +1 -3
  125. package/dist/integrations/gitlab/routes.js.map +1 -1
  126. package/dist/integrations/gitlab/rules.d.ts +6 -1
  127. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  128. package/dist/integrations/gitlab/rules.js +115 -27
  129. package/dist/integrations/gitlab/rules.js.map +1 -1
  130. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  131. package/dist/integrations/incidentio/agent-tools.js +6 -6
  132. package/dist/integrations/incidentio/agent-tools.js.map +1 -1
  133. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  134. package/dist/integrations/incidentio/default-rules.js +3 -3
  135. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  136. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  137. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  138. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  139. package/dist/integrations/incidentio/routes.d.ts +2 -2
  140. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  141. package/dist/integrations/incidentio/routes.js +10 -13
  142. package/dist/integrations/incidentio/routes.js.map +1 -1
  143. package/dist/integrations/incidentio/rules.d.ts +4 -4
  144. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  145. package/dist/integrations/incidentio/rules.js +13 -12
  146. package/dist/integrations/incidentio/rules.js.map +1 -1
  147. package/dist/integrations/jira/agent-tools.js +1 -1
  148. package/dist/integrations/jira/binding-scope.d.ts +5 -6
  149. package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
  150. package/dist/integrations/jira/binding-scope.js +9 -11
  151. package/dist/integrations/jira/binding-scope.js.map +1 -1
  152. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  153. package/dist/integrations/jira/default-rules.js +3 -3
  154. package/dist/integrations/jira/default-rules.js.map +1 -1
  155. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  156. package/dist/integrations/jira/issue-reconciler.js +2 -1
  157. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  158. package/dist/integrations/jira/routes.d.ts.map +1 -1
  159. package/dist/integrations/jira/routes.js +3 -5
  160. package/dist/integrations/jira/routes.js.map +1 -1
  161. package/dist/integrations/jira/rules.d.ts +4 -4
  162. package/dist/integrations/jira/rules.d.ts.map +1 -1
  163. package/dist/integrations/jira/rules.js +13 -12
  164. package/dist/integrations/jira/rules.js.map +1 -1
  165. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  166. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  167. package/dist/integrations/linear/agent-tools.js +80 -2
  168. package/dist/integrations/linear/agent-tools.js.map +1 -1
  169. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  170. package/dist/integrations/linear/default-rules.js +3 -3
  171. package/dist/integrations/linear/default-rules.js.map +1 -1
  172. package/dist/integrations/linear/integration.d.ts +4 -1
  173. package/dist/integrations/linear/integration.d.ts.map +1 -1
  174. package/dist/integrations/linear/integration.js +21 -1
  175. package/dist/integrations/linear/integration.js.map +1 -1
  176. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  177. package/dist/integrations/linear/issue-reconciler.js +2 -1
  178. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  179. package/dist/integrations/linear/routes.d.ts +2 -1
  180. package/dist/integrations/linear/routes.d.ts.map +1 -1
  181. package/dist/integrations/linear/routes.js +15 -17
  182. package/dist/integrations/linear/routes.js.map +1 -1
  183. package/dist/integrations/linear/rules.d.ts +4 -4
  184. package/dist/integrations/linear/rules.d.ts.map +1 -1
  185. package/dist/integrations/linear/rules.js +14 -13
  186. package/dist/integrations/linear/rules.js.map +1 -1
  187. package/dist/integrations/platform/connect/session-tools.d.ts +5 -0
  188. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
  189. package/dist/integrations/platform/connect/session-tools.js +5 -0
  190. package/dist/integrations/platform/connect/session-tools.js.map +1 -1
  191. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  192. package/dist/integrations/platform/github/integration.js +33 -21
  193. package/dist/integrations/platform/github/integration.js.map +1 -1
  194. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  195. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  196. package/dist/integrations/platform/jira/routes.js +3 -5
  197. package/dist/integrations/platform/jira/routes.js.map +1 -1
  198. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  199. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  200. package/dist/integrations/platform/linear/integration.js +6 -5
  201. package/dist/integrations/platform/linear/integration.js.map +1 -1
  202. package/dist/integrations/slack/chat-tools.js +1 -1
  203. package/dist/integrations/slack/reply-tool.js +1 -1
  204. package/dist/integrations/slack/share-file-tool.js +1 -1
  205. package/dist/integrations/slack/slack.d.ts +10 -4
  206. package/dist/integrations/slack/slack.d.ts.map +1 -1
  207. package/dist/integrations/slack/slack.js +19 -9
  208. package/dist/integrations/slack/slack.js.map +1 -1
  209. package/dist/links.d.ts.map +1 -1
  210. package/dist/links.js +3 -2
  211. package/dist/links.js.map +1 -1
  212. package/dist/mcp/routes.js +2 -2
  213. package/dist/routes/attention-parked.d.ts +1 -0
  214. package/dist/routes/attention-parked.d.ts.map +1 -1
  215. package/dist/routes/attention-parked.js +1 -1
  216. package/dist/routes/attention-parked.js.map +1 -1
  217. package/dist/routes/automation-runs.d.ts +5 -1
  218. package/dist/routes/automation-runs.d.ts.map +1 -1
  219. package/dist/routes/automation-runs.js +15 -0
  220. package/dist/routes/automation-runs.js.map +1 -1
  221. package/dist/routes/boards.d.ts +1 -1
  222. package/dist/routes/boards.d.ts.map +1 -1
  223. package/dist/routes/boards.js +1 -17
  224. package/dist/routes/boards.js.map +1 -1
  225. package/dist/routes/config.d.ts +4 -0
  226. package/dist/routes/config.d.ts.map +1 -1
  227. package/dist/routes/config.js +15 -0
  228. package/dist/routes/config.js.map +1 -1
  229. package/dist/routes/contracts.d.ts +128 -24
  230. package/dist/routes/contracts.d.ts.map +1 -1
  231. package/dist/routes/contracts.js +45 -24
  232. package/dist/routes/contracts.js.map +1 -1
  233. package/dist/routes/fs.d.ts +4 -0
  234. package/dist/routes/fs.d.ts.map +1 -1
  235. package/dist/routes/fs.js +8 -4
  236. package/dist/routes/fs.js.map +1 -1
  237. package/dist/routes/intake-routes.d.ts.map +1 -1
  238. package/dist/routes/intake-routes.js +6 -1
  239. package/dist/routes/intake-routes.js.map +1 -1
  240. package/dist/routes/intake.d.ts +0 -23
  241. package/dist/routes/intake.d.ts.map +1 -1
  242. package/dist/routes/intake.js +13 -309
  243. package/dist/routes/intake.js.map +1 -1
  244. package/dist/routes/projects.d.ts.map +1 -1
  245. package/dist/routes/projects.js +9 -3
  246. package/dist/routes/projects.js.map +1 -1
  247. package/dist/routes/provider-credentials.d.ts.map +1 -1
  248. package/dist/routes/provider-credentials.js +10 -5
  249. package/dist/routes/provider-credentials.js.map +1 -1
  250. package/dist/routes/running-packages.d.ts +13 -0
  251. package/dist/routes/running-packages.d.ts.map +1 -0
  252. package/dist/routes/running-packages.js +45 -0
  253. package/dist/routes/running-packages.js.map +1 -0
  254. package/dist/routes/surface.d.ts +10 -1
  255. package/dist/routes/surface.d.ts.map +1 -1
  256. package/dist/routes/surface.js +104 -37
  257. package/dist/routes/surface.js.map +1 -1
  258. package/dist/routes/work-items.d.ts.map +1 -1
  259. package/dist/routes/work-items.js +23 -3
  260. package/dist/routes/work-items.js.map +1 -1
  261. package/dist/rules/binding-context.d.ts.map +1 -1
  262. package/dist/rules/binding-context.js +1 -0
  263. package/dist/rules/binding-context.js.map +1 -1
  264. package/dist/rules/dispatcher.d.ts +0 -6
  265. package/dist/rules/dispatcher.d.ts.map +1 -1
  266. package/dist/rules/dispatcher.js +354 -60
  267. package/dist/rules/dispatcher.js.map +1 -1
  268. package/dist/rules/event-rules.d.ts +33 -2
  269. package/dist/rules/event-rules.d.ts.map +1 -1
  270. package/dist/rules/event-rules.js +46 -11
  271. package/dist/rules/event-rules.js.map +1 -1
  272. package/dist/rules/index.d.ts +2 -4
  273. package/dist/rules/index.d.ts.map +1 -1
  274. package/dist/rules/index.js +2 -3
  275. package/dist/rules/phase-goal.d.ts +54 -0
  276. package/dist/rules/phase-goal.d.ts.map +1 -0
  277. package/dist/rules/phase-goal.js +70 -0
  278. package/dist/rules/phase-goal.js.map +1 -0
  279. package/dist/rules/phase-tools.d.ts +11 -0
  280. package/dist/rules/phase-tools.d.ts.map +1 -0
  281. package/dist/rules/phase-tools.js +19 -0
  282. package/dist/rules/phase-tools.js.map +1 -0
  283. package/dist/rules/processor.d.ts.map +1 -1
  284. package/dist/rules/processor.js +112 -11
  285. package/dist/rules/processor.js.map +1 -1
  286. package/dist/rules/review-source-tool.d.ts +4 -1
  287. package/dist/rules/review-source-tool.d.ts.map +1 -1
  288. package/dist/rules/review-source-tool.js +24 -4
  289. package/dist/rules/review-source-tool.js.map +1 -1
  290. package/dist/rules/rule-group.d.ts +1 -1
  291. package/dist/rules/rule-group.d.ts.map +1 -1
  292. package/dist/rules/rule-group.js +15 -6
  293. package/dist/rules/rule-group.js.map +1 -1
  294. package/dist/rules/start-coordinator.d.ts +5 -1
  295. package/dist/rules/start-coordinator.d.ts.map +1 -1
  296. package/dist/rules/start-coordinator.js +9 -3
  297. package/dist/rules/start-coordinator.js.map +1 -1
  298. package/dist/rules/tools.d.ts.map +1 -1
  299. package/dist/rules/tools.js +39 -28
  300. package/dist/rules/tools.js.map +1 -1
  301. package/dist/rules/transition-service.d.ts +4 -10
  302. package/dist/rules/transition-service.d.ts.map +1 -1
  303. package/dist/rules/transition-service.js +61 -55
  304. package/dist/rules/transition-service.js.map +1 -1
  305. package/dist/rules/types.d.ts +86 -36
  306. package/dist/rules/types.d.ts.map +1 -1
  307. package/dist/rules/types.js +5 -41
  308. package/dist/rules/types.js.map +1 -1
  309. package/dist/rules/validation.d.ts.map +1 -1
  310. package/dist/rules/validation.js +32 -2
  311. package/dist/rules/validation.js.map +1 -1
  312. package/dist/secret-encryption.d.ts +21 -0
  313. package/dist/secret-encryption.d.ts.map +1 -1
  314. package/dist/secret-encryption.js +31 -4
  315. package/dist/secret-encryption.js.map +1 -1
  316. package/dist/session/self-review-gate.d.ts +6 -4
  317. package/dist/session/self-review-gate.d.ts.map +1 -1
  318. package/dist/session/self-review-gate.js +9 -12
  319. package/dist/session/self-review-gate.js.map +1 -1
  320. package/dist/session/session-threads.d.ts +2 -3
  321. package/dist/session/session-threads.d.ts.map +1 -1
  322. package/dist/session/session-threads.js.map +1 -1
  323. package/dist/session/source-control-tools.d.ts +39 -13
  324. package/dist/session/source-control-tools.d.ts.map +1 -1
  325. package/dist/session/source-control-tools.js +55 -61
  326. package/dist/session/source-control-tools.js.map +1 -1
  327. package/dist/session/work-item-state-processor.d.ts +24 -0
  328. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  329. package/dist/session/work-item-state-processor.js +275 -0
  330. package/dist/session/work-item-state-processor.js.map +1 -0
  331. package/dist/storage/domains/boards/base.d.ts +70 -31
  332. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  333. package/dist/storage/domains/boards/base.js +99 -126
  334. package/dist/storage/domains/boards/base.js.map +1 -1
  335. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  336. package/dist/storage/domains/boards/schemas.js +12 -0
  337. package/dist/storage/domains/boards/schemas.js.map +1 -1
  338. package/dist/storage/domains/intake/base.d.ts +5 -45
  339. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  340. package/dist/storage/domains/intake/base.js +11 -89
  341. package/dist/storage/domains/intake/base.js.map +1 -1
  342. package/dist/storage/domains/projects/base.d.ts +17 -9
  343. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  344. package/dist/storage/domains/projects/base.js +15 -7
  345. package/dist/storage/domains/projects/base.js.map +1 -1
  346. package/dist/storage/domains/work-items/base.d.ts +39 -4
  347. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  348. package/dist/storage/domains/work-items/base.js +113 -26
  349. package/dist/storage/domains/work-items/base.js.map +1 -1
  350. package/dist/storage/domains/work-items/cards.d.ts +24 -2
  351. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  352. package/dist/storage/domains/work-items/cards.js +118 -8
  353. package/dist/storage/domains/work-items/cards.js.map +1 -1
  354. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  355. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  356. package/dist/storage/domains/work-items/legacy-review.js +95 -0
  357. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  358. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  359. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  360. package/dist/storage/domains/work-items/metrics.js +14 -32
  361. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  362. package/dist/storage/domains/work-items/work-item-schema.d.ts +2 -0
  363. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  364. package/dist/storage/domains/work-items/work-item-schema.js +5 -0
  365. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  366. package/dist/tools/approval-tools.d.ts.map +1 -1
  367. package/dist/tools/approval-tools.js +28 -9
  368. package/dist/tools/approval-tools.js.map +1 -1
  369. package/dist/tools/index.d.ts +1 -1
  370. package/dist/tools/index.js +1 -1
  371. package/dist/tools/index.js.map +1 -1
  372. package/dist/tools/messaging-tools.d.ts +3 -0
  373. package/dist/tools/messaging-tools.d.ts.map +1 -1
  374. package/dist/tools/messaging-tools.js +2 -1
  375. package/dist/tools/messaging-tools.js.map +1 -1
  376. package/dist/tools/read-tools.d.ts +8 -2
  377. package/dist/tools/read-tools.d.ts.map +1 -1
  378. package/dist/tools/read-tools.js +83 -23
  379. package/dist/tools/read-tools.js.map +1 -1
  380. package/dist/tools/reports.d.ts +1 -0
  381. package/dist/tools/reports.d.ts.map +1 -1
  382. package/dist/tools/reports.js +2 -1
  383. package/dist/tools/reports.js.map +1 -1
  384. package/dist/tools/run-watch.d.ts +1 -1
  385. package/dist/tools/run-watch.d.ts.map +1 -1
  386. package/dist/tools/run-watch.js +1 -0
  387. package/dist/tools/run-watch.js.map +1 -1
  388. package/dist/tools/sandbox-tools.js +1 -1
  389. package/dist/tools/session-tools.js +1 -1
  390. package/dist/tools/sessions-state-processor.d.ts +2 -0
  391. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  392. package/dist/tools/sessions-state-processor.js +4 -2
  393. package/dist/tools/sessions-state-processor.js.map +1 -1
  394. package/dist/tools/side-sessions.d.ts +2 -0
  395. package/dist/tools/side-sessions.d.ts.map +1 -1
  396. package/dist/tools/side-sessions.js +2 -1
  397. package/dist/tools/side-sessions.js.map +1 -1
  398. package/dist/tools/work-item-tools.js +3 -3
  399. package/dist/tools/work-item-tools.js.map +1 -1
  400. package/dist/work-item-branch.d.ts +13 -0
  401. package/dist/work-item-branch.d.ts.map +1 -1
  402. package/dist/work-item-branch.js +16 -1
  403. package/dist/work-item-branch.js.map +1 -1
  404. package/dist/work-items/create-work-item.d.ts +6 -0
  405. package/dist/work-items/create-work-item.d.ts.map +1 -1
  406. package/dist/work-items/create-work-item.js +25 -1
  407. package/dist/work-items/create-work-item.js.map +1 -1
  408. package/dist/work-items/providers/base.d.ts +4 -1
  409. package/dist/work-items/providers/base.d.ts.map +1 -1
  410. package/dist/work-items/providers/base.js +6 -1
  411. package/dist/work-items/providers/base.js.map +1 -1
  412. package/dist/work-items/providers/github.d.ts.map +1 -1
  413. package/dist/work-items/providers/github.js +2 -1
  414. package/dist/work-items/providers/github.js.map +1 -1
  415. package/dist/work-items/providers/gitlab.d.ts.map +1 -1
  416. package/dist/work-items/providers/gitlab.js +2 -1
  417. package/dist/work-items/providers/gitlab.js.map +1 -1
  418. package/dist/work-items/providers/jira.d.ts.map +1 -1
  419. package/dist/work-items/providers/jira.js +3 -2
  420. package/dist/work-items/providers/jira.js.map +1 -1
  421. package/dist/work-items/providers/linear.d.ts.map +1 -1
  422. package/dist/work-items/providers/linear.js +3 -2
  423. package/dist/work-items/providers/linear.js.map +1 -1
  424. package/dist/work-items/providers/types.d.ts +6 -0
  425. package/dist/work-items/providers/types.d.ts.map +1 -1
  426. package/dist/work-items/split-migration.d.ts.map +1 -1
  427. package/dist/work-items/split-migration.js +1 -0
  428. package/dist/work-items/split-migration.js.map +1 -1
  429. package/dist/workspace.d.ts.map +1 -1
  430. package/dist/workspace.js +53 -10
  431. package/dist/workspace.js.map +1 -1
  432. package/factory-skills/configure-factory-rules/SKILL.md +12 -10
  433. package/factory-skills/factory-build/SKILL.md +64 -0
  434. package/factory-skills/factory-gitlab-rereview/SKILL.md +2 -2
  435. package/factory-skills/factory-gitlab-review/SKILL.md +3 -3
  436. package/factory-skills/factory-plan/SKILL.md +8 -10
  437. package/factory-skills/factory-rereview/SKILL.md +5 -5
  438. package/factory-skills/factory-review/SKILL.md +16 -6
  439. package/factory-skills/factory-self-review/SKILL.md +31 -11
  440. package/factory-skills/factory-triage/SKILL.md +25 -10
  441. package/package.json +11 -11
  442. package/dist/boards/index.js.map +0 -1
  443. package/dist/boards/pull-request-review.d.ts +0 -14
  444. package/dist/boards/pull-request-review.d.ts.map +0 -1
  445. package/dist/boards/pull-request-review.js +0 -81
  446. package/dist/boards/pull-request-review.js.map +0 -1
  447. package/dist/boards/work-tool-rules.d.ts +0 -8
  448. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  449. package/dist/boards/work-tool-rules.js +0 -19
  450. package/dist/boards/work-tool-rules.js.map +0 -1
  451. package/dist/rules/resolve.d.ts +0 -15
  452. package/dist/rules/resolve.d.ts.map +0 -1
  453. package/dist/rules/resolve.js +0 -22
  454. package/dist/rules/resolve.js.map +0 -1
  455. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -0,0 +1,42 @@
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.
4
+ * Only projects stored before then hold the old defaults it replaces, and their rows still have
5
+ * that phase, so they get its runner rather than today's seed, which has no such phase.
6
+ */
7
+ export declare function workSeedWithSelfReview(): StoredBoardInput;
8
+ export declare function migrateWorkPhaseRunners(board: StoredBoardRecord, seed?: StoredBoardInput): {
9
+ board: {
10
+ name: string;
11
+ description: string | null;
12
+ phases: StoredPhaseInput[];
13
+ };
14
+ filled: string[];
15
+ } | undefined;
16
+ export declare const WORK_PHASE_RUNNERS_MIGRATION: StoredBoardMigration;
17
+ /**
18
+ * Carries a project's retired self-review switch into its boards: with the switch off, a card went
19
+ * past any board's self-review phase, so the phase goes, with every move into it. A board is left
20
+ * as it is, with a warning, when its code board declares the phase (without it the board would run
21
+ * without its code rules), when cards sit in the phase (removing it would strand them), when its
22
+ * build phase could only reach the pull request review through it, or when it is another phase's
23
+ * only move.
24
+ */
25
+ export declare function migrateSelfReviewSwitch(board: StoredBoardRecord, context: BoardMigrationContext): {
26
+ board: Omit<StoredBoardInput, 'key'>;
27
+ filled: string[];
28
+ } | undefined;
29
+ /**
30
+ * Carries a project's retired auto-run switch into its boards: with it on, every run started
31
+ * without a person, so every working phase starts on its own, for every card (`autoStartWhen`
32
+ * cleared). With it off a run started on its own only where the phase said so, as it does now.
33
+ */
34
+ export declare function migrateAutoRunSwitch(board: StoredBoardRecord, context: BoardMigrationContext): {
35
+ board: Omit<StoredBoardInput, 'key'>;
36
+ filled: string[];
37
+ } | undefined;
38
+ export declare const SELF_REVIEW_MIGRATION: StoredBoardMigration;
39
+ export declare const AUTO_RUN_MIGRATION: StoredBoardMigration;
40
+ /** The board migrations each project gets once, in order. */
41
+ export declare const BOARD_MIGRATIONS: readonly StoredBoardMigration[];
42
+ //# 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;;;;GAIG;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"}
@@ -0,0 +1,352 @@
1
+ import "./define-board.js";
2
+ import { boardDefinitionOf } from "./stored-board.js";
3
+ import { OWN_CARD_HAND_OFF, workBoard } from "./work.js";
4
+ // src/boards/work-migrations.ts
5
+ const MIGRATED_FIELDS = [
6
+ "runner",
7
+ "exitTool",
8
+ "tools",
9
+ "autoStart",
10
+ "autoStartWhen",
11
+ "nextPhases"
12
+ ];
13
+ const PHASE_DEFAULTS = {
14
+ exitTool: [null],
15
+ tools: [null],
16
+ autoStart: [null],
17
+ autoStartWhen: [null]
18
+ };
19
+ /**
20
+ * What Factory stored for Work's working phases before they had runners: the seed of #29317, and
21
+ * #29346's for the `nextPhases` it changed. Frozen: a value listed here is one a project can only
22
+ * hold because Factory wrote it, so the migration may replace it.
23
+ */
24
+ const OLD_WORK_SEED = {
25
+ triage: {
26
+ ...PHASE_DEFAULTS,
27
+ runner: [{ context: "triage" }],
28
+ nextPhases: [[
29
+ "intake",
30
+ "planning",
31
+ "done",
32
+ "canceled"
33
+ ]]
34
+ },
35
+ planning: {
36
+ ...PHASE_DEFAULTS,
37
+ runner: [{ context: "work" }],
38
+ exitTool: [{
39
+ id: "submit_plan",
40
+ autoApprove: false
41
+ }],
42
+ nextPhases: [[
43
+ "execute",
44
+ "triage",
45
+ "intake",
46
+ "done",
47
+ "canceled"
48
+ ]]
49
+ },
50
+ execute: {
51
+ ...PHASE_DEFAULTS,
52
+ runner: [{ context: "work" }],
53
+ nextPhases: [[
54
+ "review",
55
+ "planning",
56
+ "done",
57
+ "canceled"
58
+ ]]
59
+ },
60
+ review: {
61
+ ...PHASE_DEFAULTS,
62
+ runner: [{ context: "work" }],
63
+ nextPhases: [[
64
+ "execute",
65
+ "intake",
66
+ "done",
67
+ "canceled"
68
+ ], [
69
+ "execute",
70
+ "intake",
71
+ "pr-review",
72
+ "done",
73
+ "canceled"
74
+ ]]
75
+ },
76
+ "pr-review": {
77
+ ...PHASE_DEFAULTS,
78
+ runner: [{ context: "work" }],
79
+ nextPhases: [[
80
+ "intake",
81
+ "done",
82
+ "canceled"
83
+ ], [
84
+ "intake",
85
+ "planning",
86
+ "execute",
87
+ "done",
88
+ "canceled"
89
+ ]]
90
+ }
91
+ };
92
+ /** Building's goal while Work still had its self-review phase. */
93
+ const SELF_REVIEW_BUILD_OBJECTIVE = "Build the plan approved in Planning for this work item. Done when every step of that plan is implemented on the work branch; the plan's verification gates (the tests, typecheck and lint it names, else the narrowest relevant ones) were run on the final head and passed; the branch is pushed; and the card was moved on with factory_transition_work_item out of Building (to Review or PR review as the builder's hand-off says, or back to Planning if the plan proved wrong); the builder's latest message names the move and the pushed head. " + OWN_CARD_HAND_OFF + " Continue while any of that is missing. Waiting only when the agent asked a person a question it cannot answer from the repository.";
94
+ /**
95
+ * The Work seed this migration fills from: Work as it was while it had its self-review phase.
96
+ * Only projects stored before then hold the old defaults it replaces, and their rows still have
97
+ * that phase, so they get its runner rather than today's seed, which has no such phase.
98
+ */
99
+ function workSeedWithSelfReview() {
100
+ const seed = boardDefinitionOf(workBoard);
101
+ const phases = seed.phases.flatMap((phase) => {
102
+ if (phase.key !== "execute") return [phase];
103
+ const goal = phase.runner?.goal && {
104
+ ...phase.runner.goal,
105
+ objective: SELF_REVIEW_BUILD_OBJECTIVE
106
+ };
107
+ return [{
108
+ ...phase,
109
+ runner: {
110
+ ...phase.runner,
111
+ ...goal ? { goal } : {}
112
+ },
113
+ nextPhases: [
114
+ "review",
115
+ "pr-review",
116
+ "planning",
117
+ "done",
118
+ "canceled"
119
+ ]
120
+ }, {
121
+ key: "review",
122
+ name: "Review",
123
+ kind: "working",
124
+ runner: {
125
+ skill: "factory-self-review",
126
+ context: "review"
127
+ },
128
+ autoStart: true,
129
+ autoStartWhen: {
130
+ operator: "AND",
131
+ conditions: [{
132
+ field: "item.pullRequest",
133
+ operator: "not_exists"
134
+ }]
135
+ },
136
+ tools: ["factory_record_review_verdict"],
137
+ nextPhases: [
138
+ "execute",
139
+ "intake",
140
+ "pr-review",
141
+ "done",
142
+ "canceled"
143
+ ]
144
+ }];
145
+ });
146
+ return {
147
+ ...seed,
148
+ phases
149
+ };
150
+ }
151
+ /** Stable JSON with sorted keys; an unset field, `null`, `false` and no tools all read the same. */
152
+ function canonical(field, value) {
153
+ if (value === void 0 || value === null || value === false) return "null";
154
+ if (field === "tools" && Array.isArray(value) && value.length === 0) return "null";
155
+ return JSON.stringify(sorted(value));
156
+ }
157
+ function sorted(value) {
158
+ if (Array.isArray(value)) return value.map(sorted);
159
+ if (value === null || typeof value !== "object") return value;
160
+ return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== void 0).sort(([left], [right]) => left.localeCompare(right)).map(([key, entry]) => [key, sorted(entry)]));
161
+ }
162
+ function toInput({ position: _position, ...phase }) {
163
+ return phase;
164
+ }
165
+ /** Whether Factory may write the new value over the stored one: the stored one is still an old default. */
166
+ function stillOldDefault(phaseKey, field, stored) {
167
+ const old = OLD_WORK_SEED[phaseKey]?.[field] ?? [];
168
+ const current = canonical(field, stored);
169
+ return old.some((value) => canonical(field, value) === current);
170
+ }
171
+ /**
172
+ * The seed's runner parts a stored runner still lacks or holds at the old default: `context` when
173
+ * it is the old seed's, `skill` and `goal` when unset (the old seed set neither). Instructions and
174
+ * any part a person set stay as they are.
175
+ */
176
+ function migrateRunner(phaseKey, stored, target) {
177
+ if (!target) return void 0;
178
+ const value = { ...stored ?? {} };
179
+ const filled = [];
180
+ const oldContexts = (OLD_WORK_SEED[phaseKey]?.runner ?? []).map((old) => old.context);
181
+ if (target.context !== void 0 && value.context !== target.context && (value.context === void 0 || oldContexts.includes(value.context))) {
182
+ value.context = target.context;
183
+ filled.push("context");
184
+ }
185
+ if (target.skill !== void 0 && value.skill === void 0) {
186
+ value.skill = target.skill;
187
+ filled.push("skill");
188
+ }
189
+ if (target.goal !== void 0 && value.goal === void 0) {
190
+ value.goal = target.goal;
191
+ filled.push("goal");
192
+ }
193
+ return filled.length > 0 ? {
194
+ value,
195
+ filled
196
+ } : void 0;
197
+ }
198
+ function migrateWorkPhaseRunners(board, seed = workSeedWithSelfReview()) {
199
+ const phaseKeys = new Set(board.phases.map((phase) => phase.key));
200
+ const filled = [];
201
+ const phases = board.phases.map((record) => {
202
+ const phase = toInput(record);
203
+ const target = seed.phases.find((candidate) => candidate.key === phase.key);
204
+ if (!target || target.kind !== phase.kind || !OLD_WORK_SEED[phase.key]) return phase;
205
+ const next = { ...phase };
206
+ const runner = migrateRunner(phase.key, phase.runner, target.runner);
207
+ if (runner) {
208
+ next.runner = runner.value;
209
+ filled.push(...runner.filled.map((part) => `${phase.key}.runner.${part}`));
210
+ }
211
+ for (const field of MIGRATED_FIELDS) {
212
+ if (field === "runner") continue;
213
+ const value = target[field] ?? null;
214
+ if (canonical(field, value) === canonical(field, phase[field])) continue;
215
+ if (!stillOldDefault(phase.key, field, phase[field])) continue;
216
+ if (field === "nextPhases" && !value.every((key) => phaseKeys.has(key))) continue;
217
+ Object.assign(next, { [field]: value });
218
+ filled.push(`${phase.key}.${field}`);
219
+ }
220
+ const moves = next.nextPhases ?? [...phaseKeys].filter((key) => key !== phase.key);
221
+ const revert = (field) => {
222
+ if (!filled.includes(`${phase.key}.${field}`)) return;
223
+ Object.assign(next, { [field]: phase[field] });
224
+ filled.splice(filled.indexOf(`${phase.key}.${field}`), 1);
225
+ };
226
+ const seedMoves = (target.nextPhases ?? []).filter((key) => phaseKeys.has(key));
227
+ if (filled.includes(`${phase.key}.runner.goal`) && next.runner?.goal && !seedMoves.every((key) => moves.includes(key))) {
228
+ const { goal: _goal, ...runner } = next.runner;
229
+ next.runner = runner;
230
+ }
231
+ if (next.runner?.skill !== target.runner?.skill || next.runner?.context !== target.runner?.context) for (const field of [
232
+ "tools",
233
+ "autoStart",
234
+ "autoStartWhen"
235
+ ]) revert(field);
236
+ if (filled.includes(`${phase.key}.runner.goal`) && !next.runner?.goal) filled.splice(filled.indexOf(`${phase.key}.runner.goal`), 1);
237
+ return next;
238
+ });
239
+ if (filled.length === 0) return void 0;
240
+ return {
241
+ board: {
242
+ name: board.name,
243
+ description: board.description,
244
+ phases
245
+ },
246
+ filled
247
+ };
248
+ }
249
+ const WORK_PHASE_RUNNERS_MIGRATION = {
250
+ key: "work-phase-runners-v1",
251
+ boardKey: workBoard.id,
252
+ migrate: (board) => migrateWorkPhaseRunners(board)
253
+ };
254
+ /**
255
+ * The board's review phases as {@link boardFlow} finds them: `pullRequestReview` is the first
256
+ * review-seat phase granting `factory_review_source`; `selfReview` the first other one granting
257
+ * `factory_record_review_verdict` and not `factory_review_source`; `build` the last other working
258
+ * phase that moves into self-review.
259
+ */
260
+ function reviewPhases(board) {
261
+ const grants = (phase, tool) => phase.kind === "working" && phase.runner?.context === "review" && (phase.tools ?? []).includes(tool);
262
+ const pullRequestReview = board.phases.find((phase) => grants(phase, "factory_review_source"));
263
+ const selfReview = board.phases.find((phase) => phase !== pullRequestReview && grants(phase, "factory_record_review_verdict") && !grants(phase, "factory_review_source"));
264
+ return {
265
+ pullRequestReview,
266
+ selfReview,
267
+ build: selfReview ? board.phases.findLast((phase) => phase.kind === "working" && phase !== pullRequestReview && phase !== selfReview && (phase.nextPhases ?? []).includes(selfReview.key)) : void 0
268
+ };
269
+ }
270
+ /**
271
+ * Carries a project's retired self-review switch into its boards: with the switch off, a card went
272
+ * past any board's self-review phase, so the phase goes, with every move into it. A board is left
273
+ * as it is, with a warning, when its code board declares the phase (without it the board would run
274
+ * without its code rules), when cards sit in the phase (removing it would strand them), when its
275
+ * build phase could only reach the pull request review through it, or when it is another phase's
276
+ * only move.
277
+ */
278
+ function migrateSelfReviewSwitch(board, context) {
279
+ if (!context.retiredSettings || context.retiredSettings.selfReviewEnabled) return void 0;
280
+ const { pullRequestReview, selfReview, build } = reviewPhases(board);
281
+ if (!selfReview) return void 0;
282
+ const phase = selfReview.key;
283
+ const keep = (reason) => {
284
+ context.warn(`Board "${board.key}" keeps its self-review phase "${phase}": ${reason}. The project's self-review setting was off; remove the phase to keep skipping self-review.`);
285
+ };
286
+ if (context.codePhases(board.key)?.has(phase)) return keep("its code declares it, so remove it in code first");
287
+ if (!context.occupiedPhases) throw new Error("the project's cards can't be read yet");
288
+ if (context.occupiedPhases.get(board.key)?.has(phase)) return keep("cards sit in it, move them first");
289
+ if (build && !(pullRequestReview && (build.nextPhases ?? []).includes(pullRequestReview.key))) return keep(`"${build.key}" can't move to a pull request review without it, add that move first`);
290
+ const stranded = board.phases.find((record) => record.key !== phase && record.nextPhases?.length && record.nextPhases.every((key) => key === phase));
291
+ if (stranded) return keep(`it is the only move out of "${stranded.key}", give that phase another move first`);
292
+ const phases = board.phases.filter((record) => record.key !== phase).map((record) => {
293
+ const next = toInput(record);
294
+ if (next.nextPhases) next.nextPhases = next.nextPhases.filter((key) => key !== phase);
295
+ return next;
296
+ });
297
+ return {
298
+ board: {
299
+ name: board.name,
300
+ description: board.description,
301
+ phases
302
+ },
303
+ filled: [`${phase} removed`]
304
+ };
305
+ }
306
+ /**
307
+ * Carries a project's retired auto-run switch into its boards: with it on, every run started
308
+ * without a person, so every working phase starts on its own, for every card (`autoStartWhen`
309
+ * cleared). With it off a run started on its own only where the phase said so, as it does now.
310
+ */
311
+ function migrateAutoRunSwitch(board, context) {
312
+ if (!context.retiredSettings?.autoRunEnabled) return void 0;
313
+ const filled = [];
314
+ const phases = board.phases.map((record) => {
315
+ const phase = toInput(record);
316
+ if (phase.kind !== "working" || phase.autoStart && !phase.autoStartWhen) return phase;
317
+ filled.push(`${phase.key}.autoStart`);
318
+ return {
319
+ ...phase,
320
+ autoStart: true,
321
+ autoStartWhen: null
322
+ };
323
+ });
324
+ if (filled.length === 0) return void 0;
325
+ return {
326
+ board: {
327
+ name: board.name,
328
+ description: board.description,
329
+ phases
330
+ },
331
+ filled
332
+ };
333
+ }
334
+ const SELF_REVIEW_MIGRATION = {
335
+ key: "self-review-switch-v1",
336
+ boardKey: null,
337
+ migrate: migrateSelfReviewSwitch
338
+ };
339
+ const AUTO_RUN_MIGRATION = {
340
+ key: "auto-run-switch-v1",
341
+ boardKey: null,
342
+ migrate: migrateAutoRunSwitch
343
+ };
344
+ /** The board migrations each project gets once, in order. */
345
+ const BOARD_MIGRATIONS = [
346
+ WORK_PHASE_RUNNERS_MIGRATION,
347
+ SELF_REVIEW_MIGRATION,
348
+ AUTO_RUN_MIGRATION
349
+ ];
350
+ export { AUTO_RUN_MIGRATION, BOARD_MIGRATIONS, SELF_REVIEW_MIGRATION, WORK_PHASE_RUNNERS_MIGRATION, migrateAutoRunSwitch, migrateSelfReviewSwitch, migrateWorkPhaseRunners, workSeedWithSelfReview };
351
+
352
+ //# sourceMappingURL=work-migrations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"work-migrations.js","names":[],"sources":["../../src/boards/work-migrations.ts"],"sourcesContent":["import type {\n BoardMigrationContext,\n StoredBoardInput,\n StoredBoardMigration,\n StoredBoardRecord,\n StoredPhaseInput,\n StoredPhaseRecord,\n} from '../storage/domains/boards/base.js';\nimport { REVIEW_CONTEXT } from './define-board.js';\nimport type { FactoryPhaseTool } from './define-board.js';\nimport { boardDefinitionOf } from './stored-board.js';\nimport { OWN_CARD_HAND_OFF, workBoard } from './work.js';\n\nconst MIGRATED_FIELDS = ['runner', 'exitTool', 'tools', 'autoStart', 'autoStartWhen', 'nextPhases'] as const;\ntype MigratedField = (typeof MIGRATED_FIELDS)[number];\n\nconst PHASE_DEFAULTS = { exitTool: [null], tools: [null], autoStart: [null], autoStartWhen: [null] } as const;\n\n/**\n * What Factory stored for Work's working phases before they had runners: the seed of #29317, and\n * #29346's for the `nextPhases` it changed. Frozen: a value listed here is one a project can only\n * hold because Factory wrote it, so the migration may replace it.\n */\nconst OLD_WORK_SEED: Readonly<Record<string, Readonly<Record<MigratedField, readonly unknown[]>>>> = {\n triage: {\n ...PHASE_DEFAULTS,\n runner: [{ context: 'triage' }],\n nextPhases: [['intake', 'planning', 'done', 'canceled']],\n },\n planning: {\n ...PHASE_DEFAULTS,\n runner: [{ context: 'work' }],\n exitTool: [{ id: 'submit_plan', autoApprove: false }],\n nextPhases: [['execute', 'triage', 'intake', 'done', 'canceled']],\n },\n execute: {\n ...PHASE_DEFAULTS,\n runner: [{ context: 'work' }],\n nextPhases: [['review', 'planning', 'done', 'canceled']],\n },\n review: {\n ...PHASE_DEFAULTS,\n runner: [{ context: 'work' }],\n nextPhases: [\n ['execute', 'intake', 'done', 'canceled'],\n ['execute', 'intake', 'pr-review', 'done', 'canceled'],\n ],\n },\n 'pr-review': {\n ...PHASE_DEFAULTS,\n runner: [{ context: 'work' }],\n nextPhases: [\n ['intake', 'done', 'canceled'],\n ['intake', 'planning', 'execute', 'done', 'canceled'],\n ],\n },\n};\n\n/** Building's goal while Work still had its self-review phase. */\nconst SELF_REVIEW_BUILD_OBJECTIVE =\n 'Build the plan approved in Planning for this work item. Done when every step of that plan is implemented on ' +\n \"the work branch; the plan's verification gates (the tests, typecheck and lint it names, else the narrowest \" +\n 'relevant ones) were run on the final head and passed; the branch is pushed; and the card was moved on with ' +\n \"factory_transition_work_item out of Building (to Review or PR review as the builder's hand-off says, or back to \" +\n \"Planning if the plan proved wrong); the builder's latest message names the move and the pushed head. \" +\n OWN_CARD_HAND_OFF +\n ' Continue while any of that is missing. Waiting only when the agent asked a person a question it cannot ' +\n 'answer from the repository.';\n\n/**\n * The Work seed this migration fills from: Work as it was while it had its self-review phase.\n * Only projects stored before then hold the old defaults it replaces, and their rows still have\n * that phase, so they get its runner rather than today's seed, which has no such phase.\n */\nexport function workSeedWithSelfReview(): StoredBoardInput {\n const seed = boardDefinitionOf(workBoard);\n const phases = seed.phases.flatMap((phase): StoredPhaseInput[] => {\n if (phase.key !== 'execute') return [phase];\n const goal = phase.runner?.goal && { ...phase.runner.goal, objective: SELF_REVIEW_BUILD_OBJECTIVE };\n return [\n {\n ...phase,\n runner: { ...phase.runner, ...(goal ? { goal } : {}) },\n nextPhases: ['review', 'pr-review', 'planning', 'done', 'canceled'],\n },\n {\n key: 'review',\n name: 'Review',\n kind: 'working',\n runner: { skill: 'factory-self-review', context: 'review' },\n autoStart: true,\n autoStartWhen: { operator: 'AND', conditions: [{ field: 'item.pullRequest', operator: 'not_exists' }] },\n tools: ['factory_record_review_verdict'],\n nextPhases: ['execute', 'intake', 'pr-review', 'done', 'canceled'],\n },\n ];\n });\n return { ...seed, phases };\n}\n\n/** Stable JSON with sorted keys; an unset field, `null`, `false` and no tools all read the same. */\nfunction canonical(field: MigratedField, value: unknown): string {\n if (value === undefined || value === null || value === false) return 'null';\n if (field === 'tools' && Array.isArray(value) && value.length === 0) return 'null';\n return JSON.stringify(sorted(value));\n}\n\nfunction sorted(value: unknown): unknown {\n if (Array.isArray(value)) return value.map(sorted);\n if (value === null || typeof value !== 'object') return value;\n return Object.fromEntries(\n Object.entries(value)\n .filter(([, entry]) => entry !== undefined)\n .sort(([left], [right]) => left.localeCompare(right))\n .map(([key, entry]) => [key, sorted(entry)]),\n );\n}\n\nfunction toInput({ position: _position, ...phase }: StoredPhaseRecord): StoredPhaseInput {\n return phase;\n}\n\n/** Whether Factory may write the new value over the stored one: the stored one is still an old default. */\nfunction stillOldDefault(phaseKey: string, field: MigratedField, stored: unknown): boolean {\n const old = OLD_WORK_SEED[phaseKey]?.[field] ?? [];\n const current = canonical(field, stored);\n return old.some(value => canonical(field, value) === current);\n}\n\n/**\n * Gives a project's stored Work board the phase runners, goal, automatic starts and phase tools\n * of Factory's Work seed, field by field: only a field that still holds the value Factory\n * stored before is filled, so every field a person edited stays as they left it. A phase the\n * row lacks, or holds as another kind, is left alone, as is a move to a phase the row lacks.\n */\ntype StoredRunner = StoredPhaseInput['runner'];\n\n/**\n * The seed's runner parts a stored runner still lacks or holds at the old default: `context` when\n * it is the old seed's, `skill` and `goal` when unset (the old seed set neither). Instructions and\n * any part a person set stay as they are.\n */\nfunction migrateRunner(\n phaseKey: string,\n stored: StoredRunner,\n target: StoredRunner,\n): { value: NonNullable<StoredRunner>; filled: string[] } | undefined {\n if (!target) return undefined;\n const value: NonNullable<StoredRunner> = { ...(stored ?? {}) };\n const filled: string[] = [];\n const oldContexts = (OLD_WORK_SEED[phaseKey]?.runner ?? []).map(old => (old as { context?: string }).context);\n if (\n target.context !== undefined &&\n value.context !== target.context &&\n (value.context === undefined || oldContexts.includes(value.context))\n ) {\n value.context = target.context;\n filled.push('context');\n }\n if (target.skill !== undefined && value.skill === undefined) {\n value.skill = target.skill;\n filled.push('skill');\n }\n if (target.goal !== undefined && value.goal === undefined) {\n value.goal = target.goal;\n filled.push('goal');\n }\n return filled.length > 0 ? { value, filled } : undefined;\n}\n\nexport function migrateWorkPhaseRunners(\n board: StoredBoardRecord,\n seed = workSeedWithSelfReview(),\n): { board: { name: string; description: string | null; phases: StoredPhaseInput[] }; filled: string[] } | undefined {\n const phaseKeys = new Set(board.phases.map(phase => phase.key));\n const filled: string[] = [];\n const phases = board.phases.map(record => {\n const phase = toInput(record);\n const target = seed.phases.find(candidate => candidate.key === phase.key);\n if (!target || target.kind !== phase.kind || !OLD_WORK_SEED[phase.key]) return phase;\n const next: StoredPhaseInput = { ...phase };\n // The runner is migrated part by part: a person who only wrote instructions (the one part the\n // old seed left editable) still gets the skill, goal and context, and keeps the instructions.\n const runner = migrateRunner(phase.key, phase.runner, target.runner);\n if (runner) {\n next.runner = runner.value;\n filled.push(...runner.filled.map(part => `${phase.key}.runner.${part}`));\n }\n for (const field of MIGRATED_FIELDS) {\n if (field === 'runner') continue;\n const value = target[field] ?? null;\n if (canonical(field, value) === canonical(field, phase[field])) continue;\n if (!stillOldDefault(phase.key, field, phase[field])) continue;\n if (field === 'nextPhases' && !(value as string[]).every(key => phaseKeys.has(key))) continue;\n Object.assign(next, { [field]: value });\n filled.push(`${phase.key}.${field}`);\n }\n const moves = next.nextPhases ?? [...phaseKeys].filter(key => key !== phase.key);\n const revert = (field: MigratedField) => {\n if (!filled.includes(`${phase.key}.${field}`)) return;\n Object.assign(next, { [field]: phase[field] });\n filled.splice(filled.indexOf(`${phase.key}.${field}`), 1);\n };\n // The seed's goal is done only once the card moved on along the seed's moves (Building to PR\n // review, say): a phase whose moves a person narrowed runs the skill without the goal, rather\n // than judging a goal it may never meet.\n const seedMoves = (target.nextPhases ?? []).filter(key => phaseKeys.has(key));\n if (\n filled.includes(`${phase.key}.runner.goal`) &&\n next.runner?.goal &&\n !seedMoves.every(key => moves.includes(key))\n ) {\n const { goal: _goal, ...runner } = next.runner;\n next.runner = runner;\n }\n // Auto-start and Factory tools serve the seed's skill; a phase running another skill keeps its own.\n if (next.runner?.skill !== target.runner?.skill || next.runner?.context !== target.runner?.context) {\n for (const field of ['tools', 'autoStart', 'autoStartWhen'] as const) revert(field);\n }\n if (filled.includes(`${phase.key}.runner.goal`) && !next.runner?.goal) {\n filled.splice(filled.indexOf(`${phase.key}.runner.goal`), 1);\n }\n return next;\n });\n if (filled.length === 0) return undefined;\n return { board: { name: board.name, description: board.description, phases }, filled };\n}\n\nexport const WORK_PHASE_RUNNERS_MIGRATION: StoredBoardMigration = {\n key: 'work-phase-runners-v1',\n boardKey: workBoard.id,\n migrate: board => migrateWorkPhaseRunners(board),\n};\n\n/**\n * The board's review phases as {@link boardFlow} finds them: `pullRequestReview` is the first\n * review-seat phase granting `factory_review_source`; `selfReview` the first other one granting\n * `factory_record_review_verdict` and not `factory_review_source`; `build` the last other working\n * phase that moves into self-review.\n */\nfunction reviewPhases(board: StoredBoardRecord) {\n const grants = (phase: StoredPhaseRecord, tool: FactoryPhaseTool) =>\n phase.kind === 'working' && phase.runner?.context === REVIEW_CONTEXT && (phase.tools ?? []).includes(tool);\n const pullRequestReview = board.phases.find(phase => grants(phase, 'factory_review_source'));\n const selfReview = board.phases.find(\n phase =>\n phase !== pullRequestReview &&\n grants(phase, 'factory_record_review_verdict') &&\n !grants(phase, 'factory_review_source'),\n );\n const build = selfReview\n ? board.phases.findLast(\n phase =>\n phase.kind === 'working' &&\n phase !== pullRequestReview &&\n phase !== selfReview &&\n (phase.nextPhases ?? []).includes(selfReview.key),\n )\n : undefined;\n return { pullRequestReview, selfReview, build };\n}\n\n/**\n * Carries a project's retired self-review switch into its boards: with the switch off, a card went\n * past any board's self-review phase, so the phase goes, with every move into it. A board is left\n * as it is, with a warning, when its code board declares the phase (without it the board would run\n * without its code rules), when cards sit in the phase (removing it would strand them), when its\n * build phase could only reach the pull request review through it, or when it is another phase's\n * only move.\n */\nexport function migrateSelfReviewSwitch(\n board: StoredBoardRecord,\n context: BoardMigrationContext,\n): { board: Omit<StoredBoardInput, 'key'>; filled: string[] } | undefined {\n if (!context.retiredSettings || context.retiredSettings.selfReviewEnabled) return undefined;\n const { pullRequestReview, selfReview, build } = reviewPhases(board);\n if (!selfReview) return undefined;\n const phase = selfReview.key;\n const keep = (reason: string) => {\n context.warn(\n `Board \"${board.key}\" keeps its self-review phase \"${phase}\": ${reason}. The project's self-review ` +\n 'setting was off; remove the phase to keep skipping self-review.',\n );\n return undefined;\n };\n if (context.codePhases(board.key)?.has(phase)) return keep('its code declares it, so remove it in code first');\n // Without the cards it could strand some in the phase: the project's next load runs it again.\n if (!context.occupiedPhases) throw new Error(\"the project's cards can't be read yet\");\n if (context.occupiedPhases.get(board.key)?.has(phase)) return keep('cards sit in it, move them first');\n if (build && !(pullRequestReview && (build.nextPhases ?? []).includes(pullRequestReview.key))) {\n return keep(`\"${build.key}\" can't move to a pull request review without it, add that move first`);\n }\n const stranded = board.phases.find(\n record => record.key !== phase && record.nextPhases?.length && record.nextPhases.every(key => key === phase),\n );\n if (stranded) return keep(`it is the only move out of \"${stranded.key}\", give that phase another move first`);\n const phases = board.phases\n .filter(record => record.key !== phase)\n .map(record => {\n const next = toInput(record);\n if (next.nextPhases) next.nextPhases = next.nextPhases.filter(key => key !== phase);\n return next;\n });\n return { board: { name: board.name, description: board.description, phases }, filled: [`${phase} removed`] };\n}\n\n/**\n * Carries a project's retired auto-run switch into its boards: with it on, every run started\n * without a person, so every working phase starts on its own, for every card (`autoStartWhen`\n * cleared). With it off a run started on its own only where the phase said so, as it does now.\n */\nexport function migrateAutoRunSwitch(\n board: StoredBoardRecord,\n context: BoardMigrationContext,\n): { board: Omit<StoredBoardInput, 'key'>; filled: string[] } | undefined {\n if (!context.retiredSettings?.autoRunEnabled) return undefined;\n const filled: string[] = [];\n const phases = board.phases.map(record => {\n const phase = toInput(record);\n if (phase.kind !== 'working' || (phase.autoStart && !phase.autoStartWhen)) return phase;\n filled.push(`${phase.key}.autoStart`);\n return { ...phase, autoStart: true, autoStartWhen: null };\n });\n if (filled.length === 0) return undefined;\n return { board: { name: board.name, description: board.description, phases }, filled };\n}\n\nexport const SELF_REVIEW_MIGRATION: StoredBoardMigration = {\n key: 'self-review-switch-v1',\n boardKey: null,\n migrate: migrateSelfReviewSwitch,\n};\n\nexport const AUTO_RUN_MIGRATION: StoredBoardMigration = {\n key: 'auto-run-switch-v1',\n boardKey: null,\n migrate: migrateAutoRunSwitch,\n};\n\n/** The board migrations each project gets once, in order. */\nexport const BOARD_MIGRATIONS: readonly StoredBoardMigration[] = [\n WORK_PHASE_RUNNERS_MIGRATION,\n SELF_REVIEW_MIGRATION,\n AUTO_RUN_MIGRATION,\n];\n"],"mappings":"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"}
@@ -0,0 +1,58 @@
1
+ import type { StoredIntakeRouteInput } from '../storage/domains/boards/base.js';
2
+ /**
3
+ * The route every project starts with: a GitHub or GitLab card whose author is outside the
4
+ * write-access circle lands in Work › Intake, where nothing starts until a person moves it.
5
+ * It is a stored route like any other, so admins can see, edit, disable or delete it.
6
+ */
7
+ export declare const DEFAULT_INTAKE_ROUTE: StoredIntakeRouteInput;
8
+ /**
9
+ * Pull requests are reviewed in Work › Review. It comes after `DEFAULT_INTAKE_ROUTE`, so a
10
+ * pull request from outside the write-access circle still waits in Intake for a person.
11
+ */
12
+ export declare const PULL_REQUEST_INTAKE_ROUTE: StoredIntakeRouteInput;
13
+ /** A Work card whose issue was closed as done goes to Done. */
14
+ export declare const CLOSED_COMPLETED_ROUTE: StoredIntakeRouteInput;
15
+ /** A Work card whose issue was closed as not planned, or as a duplicate, goes to Canceled. */
16
+ export declare const CLOSED_CANCELED_ROUTE: StoredIntakeRouteInput;
17
+ /** A finished Work card whose issue was reopened goes back to Intake, where a person picks it up again. */
18
+ export declare const REOPENED_ROUTE: StoredIntakeRouteInput;
19
+ /**
20
+ * A merged pull request finishes its Work card: the pull request's own card, or the issue card
21
+ * whose session opened it (unless that card still has another pull request out).
22
+ */
23
+ export declare const PULL_REQUEST_MERGED_ROUTE: StoredIntakeRouteInput;
24
+ /** A pull request's own Work card goes to Canceled when the pull request is closed unmerged. */
25
+ export declare const PULL_REQUEST_CLOSED_ROUTE: StoredIntakeRouteInput;
26
+ /**
27
+ * An issue card in Review whose last open pull request was closed unmerged goes back to
28
+ * Intake: the issue is still open.
29
+ */
30
+ export declare const PULL_REQUEST_CLOSED_ISSUE_ROUTE: StoredIntakeRouteInput;
31
+ /** A push to a pull request in review restarts its review in Review. */
32
+ export declare const PULL_REQUEST_UPDATED_ROUTE: StoredIntakeRouteInput;
33
+ /** A maintainer asking Factory to review a pull request again sends it to Review. */
34
+ export declare const PULL_REQUEST_REVIEW_REQUESTED_ROUTE: StoredIntakeRouteInput;
35
+ /**
36
+ * A pull request from someone with write access that closes an issue nobody has started work on
37
+ * joins that issue's card, which goes to Review. Once the issue has left Intake, the pull request
38
+ * gets its own card in Review instead; projects can widen the phases. Its condition stands on its
39
+ * own, so it is tried first.
40
+ */
41
+ export declare const CLOSES_ISSUE_INTAKE_ROUTE: StoredIntakeRouteInput;
42
+ /**
43
+ * Every new card no route before it placed lands in Work › Intake. It is the project's default
44
+ * board as a stored route: point it at another board to send new cards there instead.
45
+ */
46
+ export declare const CATCH_ALL_INTAKE_ROUTE: StoredIntakeRouteInput;
47
+ /**
48
+ * The routes Factory adds to a project, in order, each under a key that never changes. A project
49
+ * gets each one once: a new project gets them all, a project set up earlier gets a route added
50
+ * since at the end of its list (or at the start, for a `first` one), and a route an admin deleted
51
+ * stays deleted. The catch-all stays last: a default added after it would never place a new card.
52
+ */
53
+ export declare const DEFAULT_INTAKE_ROUTES: readonly {
54
+ key: string;
55
+ route: StoredIntakeRouteInput;
56
+ first?: true;
57
+ }[];
58
+ //# sourceMappingURL=work-routes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"work-routes.d.ts","sourceRoot":"","sources":["../../src/boards/work-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAKhF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,sBAUlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,sBAIvC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,EAAE,sBAKpC,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,EAAE,sBAKnC,CAAC;AAEF,2GAA2G;AAC3G,eAAO,MAAM,cAAc,EAAE,sBAI5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,sBAIvC,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,yBAAyB,EAAE,sBAKvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,sBAK7C,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,EAAE,sBAIxC,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,mCAAmC,EAAE,sBAIjD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,sBAavC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,sBAIpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAC;IAAC,KAAK,CAAC,EAAE,IAAI,CAAA;CAAE,EAaxG,CAAC"}