@mastra/factory 0.27.0-alpha.1 → 0.27.0-alpha.3

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 (309) hide show
  1. package/README.md +181 -52
  2. package/dist/boards/card-facts.d.ts +5 -3
  3. package/dist/boards/card-facts.d.ts.map +1 -1
  4. package/dist/boards/card-facts.js +9 -4
  5. package/dist/boards/card-facts.js.map +1 -1
  6. package/dist/boards/define-board.d.ts +2 -0
  7. package/dist/boards/define-board.d.ts.map +1 -1
  8. package/dist/boards/define-board.js +1 -0
  9. package/dist/boards/define-board.js.map +1 -1
  10. package/dist/boards/index.d.ts +2 -2
  11. package/dist/boards/index.d.ts.map +1 -1
  12. package/dist/boards/index.js +2 -2
  13. package/dist/boards/index.js.map +1 -1
  14. package/dist/boards/intake-routing.d.ts +37 -0
  15. package/dist/boards/intake-routing.d.ts.map +1 -0
  16. package/dist/boards/intake-routing.js +70 -0
  17. package/dist/boards/intake-routing.js.map +1 -0
  18. package/dist/boards/phase-automation.d.ts +4 -4
  19. package/dist/boards/phase-automation.d.ts.map +1 -1
  20. package/dist/boards/phase-automation.js.map +1 -1
  21. package/dist/boards/pull-request-review.d.ts +14 -0
  22. package/dist/boards/pull-request-review.d.ts.map +1 -0
  23. package/dist/boards/pull-request-review.js +81 -0
  24. package/dist/boards/pull-request-review.js.map +1 -0
  25. package/dist/boards/relocate.d.ts +4 -4
  26. package/dist/boards/relocate.d.ts.map +1 -1
  27. package/dist/boards/relocate.js +1 -1
  28. package/dist/boards/relocate.js.map +1 -1
  29. package/dist/boards/review.d.ts +0 -2
  30. package/dist/boards/review.d.ts.map +1 -1
  31. package/dist/boards/review.js +2 -77
  32. package/dist/boards/review.js.map +1 -1
  33. package/dist/boards/semantics.d.ts +28 -8
  34. package/dist/boards/semantics.d.ts.map +1 -1
  35. package/dist/boards/semantics.js +21 -1
  36. package/dist/boards/semantics.js.map +1 -1
  37. package/dist/boards/transition-policy.d.ts +7 -0
  38. package/dist/boards/transition-policy.d.ts.map +1 -1
  39. package/dist/boards/transition-policy.js.map +1 -1
  40. package/dist/boards/work.d.ts +8 -2
  41. package/dist/boards/work.d.ts.map +1 -1
  42. package/dist/boards/work.js +81 -23
  43. package/dist/boards/work.js.map +1 -1
  44. package/dist/factory.d.ts +4 -2
  45. package/dist/factory.d.ts.map +1 -1
  46. package/dist/factory.js +24 -42
  47. package/dist/factory.js.map +1 -1
  48. package/dist/index.d.ts +3 -1
  49. package/dist/index.d.ts.map +1 -1
  50. package/dist/index.js +3 -2
  51. package/dist/integrations/github/acceptance-labels.d.ts +2 -2
  52. package/dist/integrations/github/acceptance-labels.d.ts.map +1 -1
  53. package/dist/integrations/github/acceptance-labels.js +2 -2
  54. package/dist/integrations/github/acceptance-labels.js.map +1 -1
  55. package/dist/integrations/github/default-rules.d.ts +19 -25
  56. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  57. package/dist/integrations/github/default-rules.js +40 -41
  58. package/dist/integrations/github/default-rules.js.map +1 -1
  59. package/dist/integrations/github/issue-reconciler.js +6 -4
  60. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  61. package/dist/integrations/github/provenance.d.ts +2 -2
  62. package/dist/integrations/github/provenance.d.ts.map +1 -1
  63. package/dist/integrations/github/provenance.js.map +1 -1
  64. package/dist/integrations/github/routes.d.ts.map +1 -1
  65. package/dist/integrations/github/routes.js +46 -1
  66. package/dist/integrations/github/routes.js.map +1 -1
  67. package/dist/integrations/github/rules.d.ts +3 -3
  68. package/dist/integrations/github/rules.d.ts.map +1 -1
  69. package/dist/integrations/github/rules.js +45 -39
  70. package/dist/integrations/github/rules.js.map +1 -1
  71. package/dist/integrations/gitlab/default-rules.d.ts +9 -16
  72. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  73. package/dist/integrations/gitlab/default-rules.js +29 -32
  74. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  75. package/dist/integrations/gitlab/issue-reconciler.js +2 -2
  76. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  77. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  78. package/dist/integrations/gitlab/merge-request-reconciler.js +11 -11
  79. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  80. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  81. package/dist/integrations/gitlab/rules.js +2 -1
  82. package/dist/integrations/gitlab/rules.js.map +1 -1
  83. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  84. package/dist/integrations/incidentio/rules.js +1 -0
  85. package/dist/integrations/incidentio/rules.js.map +1 -1
  86. package/dist/integrations/issue-reconciler.d.ts +7 -7
  87. package/dist/integrations/issue-reconciler.d.ts.map +1 -1
  88. package/dist/integrations/issue-reconciler.js +11 -14
  89. package/dist/integrations/issue-reconciler.js.map +1 -1
  90. package/dist/integrations/jira/rules.d.ts.map +1 -1
  91. package/dist/integrations/jira/rules.js +1 -0
  92. package/dist/integrations/jira/rules.js.map +1 -1
  93. package/dist/integrations/linear/issue-reconciler.js +2 -2
  94. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  95. package/dist/integrations/linear/routes.d.ts.map +1 -1
  96. package/dist/integrations/linear/routes.js +1 -1
  97. package/dist/integrations/linear/routes.js.map +1 -1
  98. package/dist/integrations/linear/rules.d.ts.map +1 -1
  99. package/dist/integrations/linear/rules.js +2 -1
  100. package/dist/integrations/linear/rules.js.map +1 -1
  101. package/dist/integrations/slack/feed-publisher.d.ts +2 -2
  102. package/dist/integrations/slack/feed-publisher.d.ts.map +1 -1
  103. package/dist/integrations/slack/feed-publisher.js.map +1 -1
  104. package/dist/integrations/slack/slack.d.ts.map +1 -1
  105. package/dist/integrations/slack/slack.js.map +1 -1
  106. package/dist/packages/_internals/workspace/dist/index.js +1 -1
  107. package/dist/packages/_internals/workspace/dist/index.js.map +1 -1
  108. package/dist/routes/attention-activity.js +1 -1
  109. package/dist/routes/attention-activity.js.map +1 -1
  110. package/dist/routes/attention-parked.js.map +1 -1
  111. package/dist/routes/attention-providers.d.ts +4 -4
  112. package/dist/routes/attention-providers.d.ts.map +1 -1
  113. package/dist/routes/attention-providers.js +2 -2
  114. package/dist/routes/attention-providers.js.map +1 -1
  115. package/dist/routes/boards.js +1 -1
  116. package/dist/routes/config.d.ts +4 -4
  117. package/dist/routes/config.d.ts.map +1 -1
  118. package/dist/routes/config.js +6 -5
  119. package/dist/routes/config.js.map +1 -1
  120. package/dist/routes/contracts.d.ts +228 -5
  121. package/dist/routes/contracts.d.ts.map +1 -1
  122. package/dist/routes/contracts.js +118 -5
  123. package/dist/routes/contracts.js.map +1 -1
  124. package/dist/routes/intake-routes.d.ts +28 -0
  125. package/dist/routes/intake-routes.d.ts.map +1 -0
  126. package/dist/routes/intake-routes.js +199 -0
  127. package/dist/routes/intake-routes.js.map +1 -0
  128. package/dist/routes/intake.d.ts.map +1 -1
  129. package/dist/routes/intake.js +10 -1
  130. package/dist/routes/intake.js.map +1 -1
  131. package/dist/routes/projects.js +3 -2
  132. package/dist/routes/projects.js.map +1 -1
  133. package/dist/routes/surface.d.ts.map +1 -1
  134. package/dist/routes/surface.js +18 -7
  135. package/dist/routes/surface.js.map +1 -1
  136. package/dist/routes/work-items.d.ts +3 -0
  137. package/dist/routes/work-items.d.ts.map +1 -1
  138. package/dist/routes/work-items.js +10 -3
  139. package/dist/routes/work-items.js.map +1 -1
  140. package/dist/rules/binding-context.js +1 -1
  141. package/dist/rules/binding-context.js.map +1 -1
  142. package/dist/rules/decision-applicability.d.ts +2 -2
  143. package/dist/rules/decision-applicability.d.ts.map +1 -1
  144. package/dist/rules/decision-applicability.js +1 -1
  145. package/dist/rules/decision-applicability.js.map +1 -1
  146. package/dist/rules/dispatcher.d.ts +6 -8
  147. package/dist/rules/dispatcher.d.ts.map +1 -1
  148. package/dist/rules/dispatcher.js +109 -34
  149. package/dist/rules/dispatcher.js.map +1 -1
  150. package/dist/rules/processor.d.ts +2 -2
  151. package/dist/rules/processor.d.ts.map +1 -1
  152. package/dist/rules/processor.js +9 -4
  153. package/dist/rules/processor.js.map +1 -1
  154. package/dist/rules/review-source-tool.d.ts.map +1 -1
  155. package/dist/rules/review-source-tool.js +2 -4
  156. package/dist/rules/review-source-tool.js.map +1 -1
  157. package/dist/rules/rule-group.d.ts +1 -1
  158. package/dist/rules/rule-group.d.ts.map +1 -1
  159. package/dist/rules/rule-group.js +1 -0
  160. package/dist/rules/rule-group.js.map +1 -1
  161. package/dist/rules/start-coordinator.d.ts.map +1 -1
  162. package/dist/rules/start-coordinator.js +5 -2
  163. package/dist/rules/start-coordinator.js.map +1 -1
  164. package/dist/rules/tools.d.ts.map +1 -1
  165. package/dist/rules/tools.js +17 -14
  166. package/dist/rules/tools.js.map +1 -1
  167. package/dist/rules/transition-service.d.ts +8 -16
  168. package/dist/rules/transition-service.d.ts.map +1 -1
  169. package/dist/rules/transition-service.js +21 -28
  170. package/dist/rules/transition-service.js.map +1 -1
  171. package/dist/rules/types.d.ts +12 -4
  172. package/dist/rules/types.d.ts.map +1 -1
  173. package/dist/rules/types.js +9 -5
  174. package/dist/rules/types.js.map +1 -1
  175. package/dist/session/resource-migration.d.ts +3 -3
  176. package/dist/session/resource-migration.d.ts.map +1 -1
  177. package/dist/session/resource-migration.js.map +1 -1
  178. package/dist/session/self-review-gate.d.ts +13 -0
  179. package/dist/session/self-review-gate.d.ts.map +1 -0
  180. package/dist/session/self-review-gate.js +37 -0
  181. package/dist/session/self-review-gate.js.map +1 -0
  182. package/dist/session/work-item-repository.d.ts +4 -2
  183. package/dist/session/work-item-repository.d.ts.map +1 -1
  184. package/dist/session/work-item-repository.js +2 -2
  185. package/dist/session/work-item-repository.js.map +1 -1
  186. package/dist/skills/catalog.js +1 -1
  187. package/dist/storage/domains/audit/actions.d.ts +1 -0
  188. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  189. package/dist/storage/domains/audit/actions.js +7 -1
  190. package/dist/storage/domains/audit/actions.js.map +1 -1
  191. package/dist/storage/domains/boards/base.d.ts +72 -1
  192. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  193. package/dist/storage/domains/boards/base.js +292 -8
  194. package/dist/storage/domains/boards/base.js.map +1 -1
  195. package/dist/storage/domains/boards/schemas.d.ts +8 -0
  196. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  197. package/dist/storage/domains/boards/schemas.js +64 -1
  198. package/dist/storage/domains/boards/schemas.js.map +1 -1
  199. package/dist/storage/domains/comments/base.d.ts.map +1 -1
  200. package/dist/storage/domains/comments/base.js +15 -8
  201. package/dist/storage/domains/comments/base.js.map +1 -1
  202. package/dist/storage/domains/comments/domain.d.ts +2 -2
  203. package/dist/storage/domains/comments/domain.d.ts.map +1 -1
  204. package/dist/storage/domains/comments/domain.js +1 -1
  205. package/dist/storage/domains/comments/domain.js.map +1 -1
  206. package/dist/storage/domains/comments/feed-sync.d.ts +2 -2
  207. package/dist/storage/domains/comments/feed-sync.d.ts.map +1 -1
  208. package/dist/storage/domains/projects/base.d.ts +0 -3
  209. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  210. package/dist/storage/domains/projects/base.js +0 -3
  211. package/dist/storage/domains/projects/base.js.map +1 -1
  212. package/dist/storage/domains/work-items/base.d.ts +94 -34
  213. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  214. package/dist/storage/domains/work-items/base.js +313 -161
  215. package/dist/storage/domains/work-items/base.js.map +1 -1
  216. package/dist/storage/domains/work-items/board-version.d.ts +2 -2
  217. package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
  218. package/dist/storage/domains/work-items/board-version.js +16 -5
  219. package/dist/storage/domains/work-items/board-version.js.map +1 -1
  220. package/dist/storage/domains/work-items/cards.d.ts +50 -0
  221. package/dist/storage/domains/work-items/cards.d.ts.map +1 -0
  222. package/dist/storage/domains/work-items/cards.js +284 -0
  223. package/dist/storage/domains/work-items/cards.js.map +1 -0
  224. package/dist/storage/domains/work-items/metrics.d.ts +2 -2
  225. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  226. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  227. package/dist/storage/domains/work-items/work-item-schema.d.ts +117 -0
  228. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -0
  229. package/dist/storage/domains/work-items/work-item-schema.js +300 -0
  230. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -0
  231. package/dist/tools/permissions.d.ts.map +1 -1
  232. package/dist/tools/permissions.js +2 -1
  233. package/dist/tools/permissions.js.map +1 -1
  234. package/dist/tools/read-tools.d.ts +4 -4
  235. package/dist/tools/read-tools.d.ts.map +1 -1
  236. package/dist/tools/read-tools.js +19 -9
  237. package/dist/tools/read-tools.js.map +1 -1
  238. package/dist/tools/sandbox-tools.d.ts +5 -0
  239. package/dist/tools/sandbox-tools.d.ts.map +1 -1
  240. package/dist/tools/sandbox-tools.js +68 -30
  241. package/dist/tools/sandbox-tools.js.map +1 -1
  242. package/dist/tools/session-tools.d.ts.map +1 -1
  243. package/dist/tools/session-tools.js.map +1 -1
  244. package/dist/tools/side-sessions.d.ts +2 -2
  245. package/dist/tools/side-sessions.d.ts.map +1 -1
  246. package/dist/tools/side-sessions.js.map +1 -1
  247. package/dist/tools/work-item-tools.d.ts +3 -0
  248. package/dist/tools/work-item-tools.d.ts.map +1 -1
  249. package/dist/tools/work-item-tools.js +14 -18
  250. package/dist/tools/work-item-tools.js.map +1 -1
  251. package/dist/work-items/create-work-item.d.ts +8 -5
  252. package/dist/work-items/create-work-item.d.ts.map +1 -1
  253. package/dist/work-items/create-work-item.js +54 -3
  254. package/dist/work-items/create-work-item.js.map +1 -1
  255. package/dist/work-items/providers/base.d.ts +22 -0
  256. package/dist/work-items/providers/base.d.ts.map +1 -0
  257. package/dist/work-items/providers/base.js +44 -0
  258. package/dist/work-items/providers/base.js.map +1 -0
  259. package/dist/work-items/providers/factory.d.ts +4 -0
  260. package/dist/work-items/providers/factory.d.ts.map +1 -0
  261. package/dist/work-items/providers/factory.js +13 -0
  262. package/dist/work-items/providers/factory.js.map +1 -0
  263. package/dist/work-items/providers/github.d.ts +3 -0
  264. package/dist/work-items/providers/github.d.ts.map +1 -0
  265. package/dist/work-items/providers/github.js +30 -0
  266. package/dist/work-items/providers/github.js.map +1 -0
  267. package/dist/work-items/providers/gitlab.d.ts +3 -0
  268. package/dist/work-items/providers/gitlab.d.ts.map +1 -0
  269. package/dist/work-items/providers/gitlab.js +35 -0
  270. package/dist/work-items/providers/gitlab.js.map +1 -0
  271. package/dist/work-items/providers/incidentio.d.ts +3 -0
  272. package/dist/work-items/providers/incidentio.d.ts.map +1 -0
  273. package/dist/work-items/providers/incidentio.js +23 -0
  274. package/dist/work-items/providers/incidentio.js.map +1 -0
  275. package/dist/work-items/providers/index.d.ts +8 -0
  276. package/dist/work-items/providers/index.d.ts.map +1 -0
  277. package/dist/work-items/providers/index.js +34 -0
  278. package/dist/work-items/providers/index.js.map +1 -0
  279. package/dist/work-items/providers/jira.d.ts +3 -0
  280. package/dist/work-items/providers/jira.d.ts.map +1 -0
  281. package/dist/work-items/providers/jira.js +16 -0
  282. package/dist/work-items/providers/jira.js.map +1 -0
  283. package/dist/work-items/providers/linear.d.ts +3 -0
  284. package/dist/work-items/providers/linear.d.ts.map +1 -0
  285. package/dist/work-items/providers/linear.js +24 -0
  286. package/dist/work-items/providers/linear.js.map +1 -0
  287. package/dist/work-items/providers/metadata-keys.d.ts +24 -0
  288. package/dist/work-items/providers/metadata-keys.d.ts.map +1 -0
  289. package/dist/work-items/providers/metadata-keys.js +84 -0
  290. package/dist/work-items/providers/metadata-keys.js.map +1 -0
  291. package/dist/work-items/providers/slack.d.ts +6 -0
  292. package/dist/work-items/providers/slack.d.ts.map +1 -0
  293. package/dist/work-items/providers/slack.js +15 -0
  294. package/dist/work-items/providers/slack.js.map +1 -0
  295. package/dist/work-items/providers/types.d.ts +23 -0
  296. package/dist/work-items/providers/types.d.ts.map +1 -0
  297. package/dist/work-items/providers/types.js +1 -0
  298. package/dist/work-items/split-migration.d.ts +51 -0
  299. package/dist/work-items/split-migration.d.ts.map +1 -0
  300. package/dist/work-items/split-migration.js +293 -0
  301. package/dist/work-items/split-migration.js.map +1 -0
  302. package/factory-skills/configure-factory-rules/SKILL.md +13 -17
  303. package/factory-skills/factory-self-review/SKILL.md +1 -1
  304. package/factory-skills/factory-triage/SKILL.md +3 -3
  305. package/package.json +12 -12
  306. package/dist/boards/work-transition-policy.d.ts +0 -3
  307. package/dist/boards/work-transition-policy.d.ts.map +0 -1
  308. package/dist/boards/work-transition-policy.js +0 -56
  309. package/dist/boards/work-transition-policy.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"binding-context.js","names":[],"sources":["../../src/rules/binding-context.ts"],"sourcesContent":["import type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport type { RequestContext } from '@mastra/core/request-context';\n\nimport { getFactoryAuthOrgId, getFactoryAuthUserFromContext } from '../auth.js';\nimport type {\n FactoryRunBindingAddress,\n FactoryRunBindingRecord,\n FactoryRunBindingSessionAddress,\n WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\n\ninterface FactorySessionState {\n factoryProjectId?: string;\n factoryOrgId?: string;\n projectRepositoryId?: string;\n untrustedCheckout?: boolean;\n baseRef?: string;\n}\n\ntype FactorySessionControllerContext = AgentControllerRequestContext<FactorySessionState>;\n\n/** Minimal source-control session lookup used to heal recovered session state. */\nexport interface FactorySessionSourceLookup {\n getBySessionId(\n sessionId: string,\n ): Promise<{ orgId: string; projectRepositoryId: string | null; baseBranch: string } | null>;\n}\n\nexport function getFactorySessionCoordinates(\n requestContext: RequestContext | undefined,\n): FactoryRunBindingSessionAddress | null {\n if (!requestContext || typeof requestContext.get !== 'function') return null;\n const context = requestContext.get('controller') as FactorySessionControllerContext | undefined;\n const factoryProjectId = context?.getState().factoryProjectId;\n if (!context?.threadId || !context.resourceId || !context.sessionId || !factoryProjectId) return null;\n return {\n factoryProjectId,\n threadId: context.threadId,\n resourceId: context.resourceId,\n sessionId: context.sessionId,\n };\n}\n\nexport function getFactorySessionAddress(requestContext: RequestContext | undefined): FactoryRunBindingAddress | null {\n const coordinates = getFactorySessionCoordinates(requestContext);\n if (!coordinates || !requestContext || typeof requestContext.get !== 'function') return null;\n const user = getFactoryAuthUserFromContext(requestContext);\n const orgId = getFactoryAuthOrgId(user);\n if (!orgId) return null;\n return { orgId, ...coordinates };\n}\n\n/**\n * Read the session's factory scoping off controller state: the project whose\n * shared settings row applies to its runs, plus the org rung that row is keyed\n * by (`factoryOrgId` is seeded at session start and is authoritative for\n * downstream identity reads — the owner id is a user, never an org).\n */\nexport function readFactorySessionScope(\n requestContext: RequestContext | undefined,\n): { factoryProjectId: string; factoryOrgId?: string } | null {\n if (!requestContext || typeof requestContext.get !== 'function') return null;\n const context = requestContext.get('controller') as FactorySessionControllerContext | undefined;\n const state = context?.getState();\n const factoryProjectId = state?.factoryProjectId;\n if (typeof factoryProjectId !== 'string' || factoryProjectId.length === 0) return null;\n const factoryOrgId = state?.factoryOrgId;\n return {\n factoryProjectId,\n ...(typeof factoryOrgId === 'string' && factoryOrgId.length > 0 ? { factoryOrgId } : {}),\n };\n}\n\n/**\n * Read the active run binding for this session when controller state has lost\n * `factoryProjectId` — a crash-recovered session (\"Continue\") is recreated with\n * empty state, so the binding table is the only remaining source of the project\n * whose shared settings row applies to the run. Read-only, unlike\n * `resolveFactorySessionAddress`: it neither heals state nor touches source\n * control, so input processors can call it before any tool has run.\n */\nexport async function findSessionRunBinding(\n requestContext: RequestContext | undefined,\n storage: Pick<WorkItemsStorage, 'findActiveRunBindingByThread'>,\n): Promise<FactoryRunBindingRecord | null> {\n if (!requestContext || typeof requestContext.get !== 'function') return null;\n const context = requestContext.get('controller') as FactorySessionControllerContext | undefined;\n if (!context?.threadId || !context.resourceId || !context.sessionId) return null;\n const orgId = getFactoryAuthOrgId(getFactoryAuthUserFromContext(requestContext));\n if (!orgId) return null;\n return storage.findActiveRunBindingByThread({\n orgId,\n threadId: context.threadId,\n resourceId: context.resourceId,\n sessionId: context.sessionId,\n });\n}\n\nexport interface FactorySessionAddressResolution {\n address: FactoryRunBindingAddress;\n /** Present only when the address was recovered from the binding table. */\n binding?: FactoryRunBindingRecord;\n}\n\n/**\n * Resolve the bound session address, falling back to the active binding row\n * when the in-memory session state is missing `factoryProjectId` — a server\n * crash drops controller sessions, and a resumed session (\"Continue\") is\n * recreated with empty state, which silently unregistered the transition\n * tool. On recovery the lost state is healed back onto the session (including\n * the `untrustedCheckout`/`baseRef` security posture the start coordinator\n * originally seeded) so later reads resolve directly.\n */\nexport async function resolveFactorySessionAddress(options: {\n requestContext: RequestContext | undefined;\n storage: Pick<WorkItemsStorage, 'findActiveRunBindingByThread' | 'get'>;\n sessions?: FactorySessionSourceLookup;\n /**\n * Resolve through the binding table even when state already carries\n * `factoryProjectId`, so the row heals the rest of the session state. Prompt\n * creation uses this: a partially persisted state can keep the project id\n * while the untrusted-checkout posture is gone, and the direct short-circuit\n * would take that id as proof the session is intact.\n */\n forceBindingLookup?: boolean;\n}): Promise<FactorySessionAddressResolution | null> {\n const direct = options.forceBindingLookup ? null : getFactorySessionAddress(options.requestContext);\n if (direct) return { address: direct };\n\n const requestContext = options.requestContext;\n if (!requestContext || typeof requestContext.get !== 'function') return null;\n const context = requestContext.get('controller') as FactorySessionControllerContext | undefined;\n if (!context?.threadId || !context.resourceId || !context.sessionId) return null;\n const user = getFactoryAuthUserFromContext(requestContext);\n const orgId = getFactoryAuthOrgId(user);\n if (!orgId) return null;\n\n const binding = await options.storage.findActiveRunBindingByThread({\n orgId,\n threadId: context.threadId,\n resourceId: context.resourceId,\n sessionId: context.sessionId,\n });\n if (!binding) return null;\n\n await healRecoveredSessionState({ context, binding, storage: options.storage, sessions: options.sessions });\n\n return {\n address: {\n orgId,\n factoryProjectId: binding.factoryProjectId,\n threadId: context.threadId,\n resourceId: context.resourceId,\n sessionId: context.sessionId,\n },\n binding,\n };\n}\n\nasync function healRecoveredSessionState(options: {\n context: FactorySessionControllerContext;\n binding: FactoryRunBindingRecord;\n storage: Pick<WorkItemsStorage, 'get'>;\n sessions?: FactorySessionSourceLookup;\n}): Promise<void> {\n const { binding } = options;\n // `factoryOrgId` mirrors the start coordinator's seed: the binding row holds\n // the authoritative org id, so crash-recovered sessions heal it for free.\n const updates: FactorySessionState = { factoryProjectId: binding.factoryProjectId, factoryOrgId: binding.orgId };\n // Security posture first, from the binding row alone (no I/O): review-bound\n // sessions run against attacker-writable checkouts, so `untrustedCheckout`\n // must survive even if the enrichment lookups below fail transiently.\n if (binding.role === 'review') {\n updates.untrustedCheckout = true;\n }\n // Best-effort enrichment mirroring the start coordinator's original seed:\n // PR-sourced work items are untrusted regardless of role, and `baseRef`\n // restores the trusted instruction source for untrusted checkouts.\n try {\n const item = await options.storage.get({ orgId: binding.orgId, id: binding.workItemId });\n const foundSession = (await options.sessions?.getBySessionId(binding.sessionId)) ?? null;\n const sourceSession = foundSession?.orgId === binding.orgId ? foundSession : null;\n if (sourceSession?.projectRepositoryId) {\n updates.projectRepositoryId = sourceSession.projectRepositoryId;\n }\n const untrusted = updates.untrustedCheckout === true || item?.externalSource?.type === 'pull-request';\n if (untrusted) {\n updates.untrustedCheckout = true;\n const metadataBaseBranch = item?.metadata?.baseBranch;\n const baseRef =\n sourceSession?.baseBranch ||\n (typeof metadataBaseBranch === 'string' && metadataBaseBranch ? metadataBaseBranch : undefined);\n if (baseRef) updates.baseRef = baseRef;\n } else {\n // Record the trusted verdict explicitly so a healed session carries every\n // trust field; the prompt-time recovery check treats a missing flag as\n // \"not yet verified\" and would otherwise re-run on every prompt. Left\n // unset when enrichment fails so the next prompt retries the lookup.\n updates.untrustedCheckout = false;\n }\n } catch {\n // Enrichment is best-effort; the address itself only needs the binding.\n }\n try {\n await options.context.setState(updates);\n } catch {\n // State healing must never block tool registration on the recovered address.\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"binding-context.js","names":[],"sources":["../../src/rules/binding-context.ts"],"sourcesContent":["import type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport type { RequestContext } from '@mastra/core/request-context';\n\nimport { getFactoryAuthOrgId, getFactoryAuthUserFromContext } from '../auth.js';\nimport type {\n FactoryRunBindingAddress,\n FactoryRunBindingRecord,\n FactoryRunBindingSessionAddress,\n WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\n\ninterface FactorySessionState {\n factoryProjectId?: string;\n factoryOrgId?: string;\n projectRepositoryId?: string;\n untrustedCheckout?: boolean;\n baseRef?: string;\n}\n\ntype FactorySessionControllerContext = AgentControllerRequestContext<FactorySessionState>;\n\n/** Minimal source-control session lookup used to heal recovered session state. */\nexport interface FactorySessionSourceLookup {\n getBySessionId(\n sessionId: string,\n ): Promise<{ orgId: string; projectRepositoryId: string | null; baseBranch: string } | null>;\n}\n\nexport function getFactorySessionCoordinates(\n requestContext: RequestContext | undefined,\n): FactoryRunBindingSessionAddress | null {\n if (!requestContext || typeof requestContext.get !== 'function') return null;\n const context = requestContext.get('controller') as FactorySessionControllerContext | undefined;\n const factoryProjectId = context?.getState().factoryProjectId;\n if (!context?.threadId || !context.resourceId || !context.sessionId || !factoryProjectId) return null;\n return {\n factoryProjectId,\n threadId: context.threadId,\n resourceId: context.resourceId,\n sessionId: context.sessionId,\n };\n}\n\nexport function getFactorySessionAddress(requestContext: RequestContext | undefined): FactoryRunBindingAddress | null {\n const coordinates = getFactorySessionCoordinates(requestContext);\n if (!coordinates || !requestContext || typeof requestContext.get !== 'function') return null;\n const user = getFactoryAuthUserFromContext(requestContext);\n const orgId = getFactoryAuthOrgId(user);\n if (!orgId) return null;\n return { orgId, ...coordinates };\n}\n\n/**\n * Read the session's factory scoping off controller state: the project whose\n * shared settings row applies to its runs, plus the org rung that row is keyed\n * by (`factoryOrgId` is seeded at session start and is authoritative for\n * downstream identity reads — the owner id is a user, never an org).\n */\nexport function readFactorySessionScope(\n requestContext: RequestContext | undefined,\n): { factoryProjectId: string; factoryOrgId?: string } | null {\n if (!requestContext || typeof requestContext.get !== 'function') return null;\n const context = requestContext.get('controller') as FactorySessionControllerContext | undefined;\n const state = context?.getState();\n const factoryProjectId = state?.factoryProjectId;\n if (typeof factoryProjectId !== 'string' || factoryProjectId.length === 0) return null;\n const factoryOrgId = state?.factoryOrgId;\n return {\n factoryProjectId,\n ...(typeof factoryOrgId === 'string' && factoryOrgId.length > 0 ? { factoryOrgId } : {}),\n };\n}\n\n/**\n * Read the active run binding for this session when controller state has lost\n * `factoryProjectId` — a crash-recovered session (\"Continue\") is recreated with\n * empty state, so the binding table is the only remaining source of the project\n * whose shared settings row applies to the run. Read-only, unlike\n * `resolveFactorySessionAddress`: it neither heals state nor touches source\n * control, so input processors can call it before any tool has run.\n */\nexport async function findSessionRunBinding(\n requestContext: RequestContext | undefined,\n storage: Pick<WorkItemsStorage, 'findActiveRunBindingByThread'>,\n): Promise<FactoryRunBindingRecord | null> {\n if (!requestContext || typeof requestContext.get !== 'function') return null;\n const context = requestContext.get('controller') as FactorySessionControllerContext | undefined;\n if (!context?.threadId || !context.resourceId || !context.sessionId) return null;\n const orgId = getFactoryAuthOrgId(getFactoryAuthUserFromContext(requestContext));\n if (!orgId) return null;\n return storage.findActiveRunBindingByThread({\n orgId,\n threadId: context.threadId,\n resourceId: context.resourceId,\n sessionId: context.sessionId,\n });\n}\n\nexport interface FactorySessionAddressResolution {\n address: FactoryRunBindingAddress;\n /** Present only when the address was recovered from the binding table. */\n binding?: FactoryRunBindingRecord;\n}\n\n/**\n * Resolve the bound session address, falling back to the active binding row\n * when the in-memory session state is missing `factoryProjectId` — a server\n * crash drops controller sessions, and a resumed session (\"Continue\") is\n * recreated with empty state, which silently unregistered the transition\n * tool. On recovery the lost state is healed back onto the session (including\n * the `untrustedCheckout`/`baseRef` security posture the start coordinator\n * originally seeded) so later reads resolve directly.\n */\nexport async function resolveFactorySessionAddress(options: {\n requestContext: RequestContext | undefined;\n storage: Pick<WorkItemsStorage, 'findActiveRunBindingByThread' | 'get'>;\n sessions?: FactorySessionSourceLookup;\n /**\n * Resolve through the binding table even when state already carries\n * `factoryProjectId`, so the row heals the rest of the session state. Prompt\n * creation uses this: a partially persisted state can keep the project id\n * while the untrusted-checkout posture is gone, and the direct short-circuit\n * would take that id as proof the session is intact.\n */\n forceBindingLookup?: boolean;\n}): Promise<FactorySessionAddressResolution | null> {\n const direct = options.forceBindingLookup ? null : getFactorySessionAddress(options.requestContext);\n if (direct) return { address: direct };\n\n const requestContext = options.requestContext;\n if (!requestContext || typeof requestContext.get !== 'function') return null;\n const context = requestContext.get('controller') as FactorySessionControllerContext | undefined;\n if (!context?.threadId || !context.resourceId || !context.sessionId) return null;\n const user = getFactoryAuthUserFromContext(requestContext);\n const orgId = getFactoryAuthOrgId(user);\n if (!orgId) return null;\n\n const binding = await options.storage.findActiveRunBindingByThread({\n orgId,\n threadId: context.threadId,\n resourceId: context.resourceId,\n sessionId: context.sessionId,\n });\n if (!binding) return null;\n\n await healRecoveredSessionState({ context, binding, storage: options.storage, sessions: options.sessions });\n\n return {\n address: {\n orgId,\n factoryProjectId: binding.factoryProjectId,\n threadId: context.threadId,\n resourceId: context.resourceId,\n sessionId: context.sessionId,\n },\n binding,\n };\n}\n\nasync function healRecoveredSessionState(options: {\n context: FactorySessionControllerContext;\n binding: FactoryRunBindingRecord;\n storage: Pick<WorkItemsStorage, 'get'>;\n sessions?: FactorySessionSourceLookup;\n}): Promise<void> {\n const { binding } = options;\n // `factoryOrgId` mirrors the start coordinator's seed: the binding row holds\n // the authoritative org id, so crash-recovered sessions heal it for free.\n const updates: FactorySessionState = { factoryProjectId: binding.factoryProjectId, factoryOrgId: binding.orgId };\n // Security posture first, from the binding row alone (no I/O): review-bound\n // sessions run against attacker-writable checkouts, so `untrustedCheckout`\n // must survive even if the enrichment lookups below fail transiently.\n if (binding.role === 'review') {\n updates.untrustedCheckout = true;\n }\n // Best-effort enrichment mirroring the start coordinator's original seed:\n // PR-sourced work items are untrusted regardless of role, and `baseRef`\n // restores the trusted instruction source for untrusted checkouts.\n try {\n const item = await options.storage.get({ orgId: binding.orgId, id: binding.workItemId });\n const foundSession = (await options.sessions?.getBySessionId(binding.sessionId)) ?? null;\n const sourceSession = foundSession?.orgId === binding.orgId ? foundSession : null;\n if (sourceSession?.projectRepositoryId) {\n updates.projectRepositoryId = sourceSession.projectRepositoryId;\n }\n const untrusted = updates.untrustedCheckout === true || item?.externalSource?.type === 'pull-request';\n if (untrusted) {\n updates.untrustedCheckout = true;\n const metadataBaseBranch = item?.workItem.metadata?.baseBranch;\n const baseRef =\n sourceSession?.baseBranch ||\n (typeof metadataBaseBranch === 'string' && metadataBaseBranch ? metadataBaseBranch : undefined);\n if (baseRef) updates.baseRef = baseRef;\n } else {\n // Record the trusted verdict explicitly so a healed session carries every\n // trust field; the prompt-time recovery check treats a missing flag as\n // \"not yet verified\" and would otherwise re-run on every prompt. Left\n // unset when enrichment fails so the next prompt retries the lookup.\n updates.untrustedCheckout = false;\n }\n } catch {\n // Enrichment is best-effort; the address itself only needs the binding.\n }\n try {\n await options.context.setState(updates);\n } catch {\n // State healing must never block tool registration on the recovered address.\n }\n}\n"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import type { BoardRegistry } from '../boards/index.js';
2
- import type { FactoryDeferredDecisionRecord, WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';
2
+ import type { FactoryDeferredDecisionRecord, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';
3
3
  type ApplicabilityRecord = Pick<FactoryDeferredDecisionRecord, 'id' | 'evaluationId' | 'createdAt' | 'decision'>;
4
4
  /** The seat a skill run needs; other decision types are not tied to one phase. */
5
5
  export declare function skillDecisionRole(record: Pick<FactoryDeferredDecisionRecord, 'decision'>): string | undefined;
@@ -17,7 +17,7 @@ export declare function decisionRetryable(record: Pick<FactoryDeferredDecisionRe
17
17
  */
18
18
  export declare function decisionOvertaken(input: {
19
19
  boards: BoardRegistry;
20
- item: WorkItemRow | null;
20
+ item: Card | null;
21
21
  record: ApplicabilityRecord;
22
22
  role: string;
23
23
  /** Decisions from the same rule evaluation as `record`. */
@@ -1 +1 @@
1
- {"version":3,"file":"decision-applicability.d.ts","sourceRoot":"","sources":["../../src/rules/decision-applicability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EACV,6BAA6B,EAC7B,WAAW,EACX,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAG/C,KAAK,mBAAmB,GAAG,IAAI,CAAC,6BAA6B,EAAE,IAAI,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC;AAEjH,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,6BAA6B,EAAE,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CAG7G;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,6BAA6B,EAAE,QAAQ,GAAG,aAAa,CAAC,EACrE,SAAS,EAAE,OAAO,GACjB,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,GAAG,OAAO,CA+BV;AAED,qFAAqF;AACrF,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,6BAA6B,CAAC,EAC9E,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,EAClD,OAAO,EAAE,6BAA6B,EAAE,GACvC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAyBtB"}
1
+ {"version":3,"file":"decision-applicability.d.ts","sourceRoot":"","sources":["../../src/rules/decision-applicability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,6BAA6B,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAGnH,KAAK,mBAAmB,GAAG,IAAI,CAAC,6BAA6B,EAAE,IAAI,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC;AAEjH,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,6BAA6B,EAAE,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CAG7G;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,6BAA6B,EAAE,QAAQ,GAAG,aAAa,CAAC,EACrE,SAAS,EAAE,OAAO,GACjB,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,GAAG,OAAO,CA+BV;AAED,qFAAqF;AACrF,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,6BAA6B,CAAC,EAC9E,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,EAClD,OAAO,EAAE,6BAA6B,EAAE,GACvC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAyBtB"}
@@ -1,6 +1,6 @@
1
+ import { factoryDispatchFailureMetadata } from "./dispatch-errors.js";
1
2
  import { boardForWorkItem, resolvePhaseSemantics } from "../boards/semantics.js";
2
3
  import "../boards/index.js";
3
- import { factoryDispatchFailureMetadata } from "./dispatch-errors.js";
4
4
  import { workStageCarries } from "../boards/legacy-plan-role.js";
5
5
  // src/rules/decision-applicability.ts
6
6
  /** The seat a skill run needs; other decision types are not tied to one phase. */
@@ -1 +1 @@
1
- {"version":3,"file":"decision-applicability.js","names":[],"sources":["../../src/rules/decision-applicability.ts"],"sourcesContent":["import { boardForWorkItem, resolvePhaseSemantics } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport { workStageCarries } from '../boards/legacy-plan-role.js';\nimport type {\n FactoryDeferredDecisionRecord,\n WorkItemRow,\n WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\nimport { factoryDispatchFailureMetadata } from './dispatch-errors.js';\n\ntype ApplicabilityRecord = Pick<FactoryDeferredDecisionRecord, 'id' | 'evaluationId' | 'createdAt' | 'decision'>;\n\n/** The seat a skill run needs; other decision types are not tied to one phase. */\nexport function skillDecisionRole(record: Pick<FactoryDeferredDecisionRecord, 'decision'>): string | undefined {\n const { type, role } = record.decision;\n return type === 'invokeSkill' && typeof role === 'string' ? role : undefined;\n}\n\n/**\n * Whether a person may retry this decision: it failed, its failure is one a rerun\n * can fix, and the card has not left the phase it was decided for. Overtaken is\n * resolved by the caller (see `overtakenDecisionIds`) because it needs the card.\n */\nexport function decisionRetryable(\n record: Pick<FactoryDeferredDecisionRecord, 'status' | 'failureCode'>,\n overtaken: boolean,\n): boolean {\n return record.status === 'failed' && !overtaken && factoryDispatchFailureMetadata(record.failureCode).canRetry;\n}\n\n/**\n * Whether the card has moved on from the phase a run was decided for: any stage it\n * now sits in was entered after the decision. Anchored on the decision rather than\n * an attempt, so a retry after the move is still recognised as stale, and a card\n * that left and came back to the same role is a new phase entry.\n */\nexport function decisionOvertaken(input: {\n boards: BoardRegistry;\n item: WorkItemRow | null;\n record: ApplicabilityRecord;\n role: string;\n /** Decisions from the same rule evaluation as `record`. */\n siblings: ApplicabilityRecord[];\n}): boolean {\n const { boards, item, record, role } = input;\n if (item === null) return true;\n const decidedAt = record.createdAt.getTime();\n const enteredSince = item.stageHistory.filter(\n entry => entry.exitedAt === undefined && new Date(entry.enteredAt).getTime() > decidedAt,\n );\n // A run decided while the card sat outside its seat's stages (a held\n // triage in Intake) is fulfilled, not overtaken, when the card first\n // enters a stage that seat carries — e.g. the Investigate click.\n const board = boardForWorkItem(item);\n const contextOf = (stage: string) => resolvePhaseSemantics(boards, board, stage)?.role;\n // Work's phases share a context, so its lanes also follow the decision's skill and the old `plan` role.\n const carriesRole = (stage: string) =>\n workStageCarries(boards.get(board), stage, role, record.decision.skillName) ?? contextOf(stage) === role;\n const decidedOutsideRole = !item.stageHistory.some(\n entry =>\n new Date(entry.enteredAt).getTime() <= decidedAt &&\n (entry.exitedAt === undefined || new Date(entry.exitedAt).getTime() > decidedAt) &&\n carriesRole(entry.stage),\n );\n const movedOn = decidedOutsideRole ? enteredSince.filter(entry => !carriesRole(entry.stage)) : enteredSince;\n if (movedOn.length === 0) return false;\n // A transition from the same rule evaluation lands after this decision\n // was created; entering that stage is part of this run's intent.\n const siblingStages = new Set(\n input.siblings\n .filter(sibling => sibling.evaluationId === record.evaluationId && sibling.decision.type === 'transition')\n .map(sibling => sibling.decision.stage),\n );\n return movedOn.some(entry => !siblingStages.has(entry.stage));\n}\n\n/** Ids of the given skill-run decisions whose card has moved on from their phase. */\nexport async function overtakenDecisionIds(\n workItems: Pick<WorkItemsStorage, 'listByIds' | 'listDecisionsForEvaluations'>,\n boards: BoardRegistry,\n scope: { orgId: string; factoryProjectId: string },\n records: FactoryDeferredDecisionRecord[],\n): Promise<Set<string>> {\n const candidates = records.filter(record => record.workItemId !== null && skillDecisionRole(record) !== undefined);\n if (candidates.length === 0) return new Set();\n const [items, siblings] = await Promise.all([\n workItems.listByIds({ ...scope, ids: [...new Set(candidates.map(record => record.workItemId!))] }),\n workItems.listDecisionsForEvaluations(\n scope.orgId,\n scope.factoryProjectId,\n candidates.map(record => record.evaluationId),\n ),\n ]);\n const itemsById = new Map(items.map(item => [item.id, item]));\n return new Set(\n candidates\n .filter(record =>\n decisionOvertaken({\n boards,\n item: itemsById.get(record.workItemId!) ?? null,\n record,\n role: skillDecisionRole(record)!,\n siblings,\n }),\n )\n .map(record => record.id),\n );\n}\n"],"mappings":";;;;;;AAaA,SAAgB,kBAAkB,QAA6E;CAC7G,MAAM,EAAE,MAAM,SAAS,OAAO;CAC9B,OAAO,SAAS,iBAAiB,OAAO,SAAS,WAAW,OAAO,KAAA;AACrE;;;;;;AAOA,SAAgB,kBACd,QACA,WACS;CACT,OAAO,OAAO,WAAW,YAAY,CAAC,aAAa,+BAA+B,OAAO,WAAW,CAAC,CAAC;AACxG;;;;;;;AAQA,SAAgB,kBAAkB,OAOtB;CACV,MAAM,EAAE,QAAQ,MAAM,QAAQ,SAAS;CACvC,IAAI,SAAS,MAAM,OAAO;CAC1B,MAAM,YAAY,OAAO,UAAU,QAAQ;CAC3C,MAAM,eAAe,KAAK,aAAa,QACrC,UAAS,MAAM,aAAa,KAAA,KAAa,IAAI,KAAK,MAAM,SAAS,CAAC,CAAC,QAAQ,IAAI,SACjF;CAIA,MAAM,QAAQ,iBAAiB,IAAI;CACnC,MAAM,aAAa,UAAkB,sBAAsB,QAAQ,OAAO,KAAK,CAAC,EAAE;CAElF,MAAM,eAAe,UACnB,iBAAiB,OAAO,IAAI,KAAK,GAAG,OAAO,MAAM,OAAO,SAAS,SAAS,KAAK,UAAU,KAAK,MAAM;CAOtG,MAAM,UAAU,CANY,KAAK,aAAa,MAC5C,UACE,IAAI,KAAK,MAAM,SAAS,CAAC,CAAC,QAAQ,KAAK,cACtC,MAAM,aAAa,KAAA,KAAa,IAAI,KAAK,MAAM,QAAQ,CAAC,CAAC,QAAQ,IAAI,cACtE,YAAY,MAAM,KAAK,CAC3B,IACqC,aAAa,QAAO,UAAS,CAAC,YAAY,MAAM,KAAK,CAAC,IAAI;CAC/F,IAAI,QAAQ,WAAW,GAAG,OAAO;CAGjC,MAAM,gBAAgB,IAAI,IACxB,MAAM,SACH,QAAO,YAAW,QAAQ,iBAAiB,OAAO,gBAAgB,QAAQ,SAAS,SAAS,YAAY,CAAC,CACzG,KAAI,YAAW,QAAQ,SAAS,KAAK,CAC1C;CACA,OAAO,QAAQ,MAAK,UAAS,CAAC,cAAc,IAAI,MAAM,KAAK,CAAC;AAC9D;;AAGA,eAAsB,qBACpB,WACA,QACA,OACA,SACsB;CACtB,MAAM,aAAa,QAAQ,QAAO,WAAU,OAAO,eAAe,QAAQ,kBAAkB,MAAM,MAAM,KAAA,CAAS;CACjH,IAAI,WAAW,WAAW,GAAG,uBAAO,IAAI,IAAI;CAC5C,MAAM,CAAC,OAAO,YAAY,MAAM,QAAQ,IAAI,CAC1C,UAAU,UAAU;EAAE,GAAG;EAAO,KAAK,CAAC,GAAG,IAAI,IAAI,WAAW,KAAI,WAAU,OAAO,UAAW,CAAC,CAAC;CAAE,CAAC,GACjG,UAAU,4BACR,MAAM,OACN,MAAM,kBACN,WAAW,KAAI,WAAU,OAAO,YAAY,CAC9C,CACF,CAAC;CACD,MAAM,YAAY,IAAI,IAAI,MAAM,KAAI,SAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;CAC5D,OAAO,IAAI,IACT,WACG,QAAO,WACN,kBAAkB;EAChB;EACA,MAAM,UAAU,IAAI,OAAO,UAAW,KAAK;EAC3C;EACA,MAAM,kBAAkB,MAAM;EAC9B;CACF,CAAC,CACH,CAAC,CACA,KAAI,WAAU,OAAO,EAAE,CAC5B;AACF"}
1
+ {"version":3,"file":"decision-applicability.js","names":[],"sources":["../../src/rules/decision-applicability.ts"],"sourcesContent":["import { boardForWorkItem, resolvePhaseSemantics } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport { workStageCarries } from '../boards/legacy-plan-role.js';\nimport type { FactoryDeferredDecisionRecord, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { factoryDispatchFailureMetadata } from './dispatch-errors.js';\n\ntype ApplicabilityRecord = Pick<FactoryDeferredDecisionRecord, 'id' | 'evaluationId' | 'createdAt' | 'decision'>;\n\n/** The seat a skill run needs; other decision types are not tied to one phase. */\nexport function skillDecisionRole(record: Pick<FactoryDeferredDecisionRecord, 'decision'>): string | undefined {\n const { type, role } = record.decision;\n return type === 'invokeSkill' && typeof role === 'string' ? role : undefined;\n}\n\n/**\n * Whether a person may retry this decision: it failed, its failure is one a rerun\n * can fix, and the card has not left the phase it was decided for. Overtaken is\n * resolved by the caller (see `overtakenDecisionIds`) because it needs the card.\n */\nexport function decisionRetryable(\n record: Pick<FactoryDeferredDecisionRecord, 'status' | 'failureCode'>,\n overtaken: boolean,\n): boolean {\n return record.status === 'failed' && !overtaken && factoryDispatchFailureMetadata(record.failureCode).canRetry;\n}\n\n/**\n * Whether the card has moved on from the phase a run was decided for: any stage it\n * now sits in was entered after the decision. Anchored on the decision rather than\n * an attempt, so a retry after the move is still recognised as stale, and a card\n * that left and came back to the same role is a new phase entry.\n */\nexport function decisionOvertaken(input: {\n boards: BoardRegistry;\n item: Card | null;\n record: ApplicabilityRecord;\n role: string;\n /** Decisions from the same rule evaluation as `record`. */\n siblings: ApplicabilityRecord[];\n}): boolean {\n const { boards, item, record, role } = input;\n if (item === null) return true;\n const decidedAt = record.createdAt.getTime();\n const enteredSince = item.stageHistory.filter(\n entry => entry.exitedAt === undefined && new Date(entry.enteredAt).getTime() > decidedAt,\n );\n // A run decided while the card sat outside its seat's stages (a held\n // triage in Intake) is fulfilled, not overtaken, when the card first\n // enters a stage that seat carries — e.g. the Investigate click.\n const board = boardForWorkItem(item);\n const contextOf = (stage: string) => resolvePhaseSemantics(boards, board, stage)?.role;\n // Work's phases share a context, so its lanes also follow the decision's skill and the old `plan` role.\n const carriesRole = (stage: string) =>\n workStageCarries(boards.get(board), stage, role, record.decision.skillName) ?? contextOf(stage) === role;\n const decidedOutsideRole = !item.stageHistory.some(\n entry =>\n new Date(entry.enteredAt).getTime() <= decidedAt &&\n (entry.exitedAt === undefined || new Date(entry.exitedAt).getTime() > decidedAt) &&\n carriesRole(entry.stage),\n );\n const movedOn = decidedOutsideRole ? enteredSince.filter(entry => !carriesRole(entry.stage)) : enteredSince;\n if (movedOn.length === 0) return false;\n // A transition from the same rule evaluation lands after this decision\n // was created; entering that stage is part of this run's intent.\n const siblingStages = new Set(\n input.siblings\n .filter(sibling => sibling.evaluationId === record.evaluationId && sibling.decision.type === 'transition')\n .map(sibling => sibling.decision.stage),\n );\n return movedOn.some(entry => !siblingStages.has(entry.stage));\n}\n\n/** Ids of the given skill-run decisions whose card has moved on from their phase. */\nexport async function overtakenDecisionIds(\n workItems: Pick<WorkItemsStorage, 'listByIds' | 'listDecisionsForEvaluations'>,\n boards: BoardRegistry,\n scope: { orgId: string; factoryProjectId: string },\n records: FactoryDeferredDecisionRecord[],\n): Promise<Set<string>> {\n const candidates = records.filter(record => record.workItemId !== null && skillDecisionRole(record) !== undefined);\n if (candidates.length === 0) return new Set();\n const [items, siblings] = await Promise.all([\n workItems.listByIds({ ...scope, ids: [...new Set(candidates.map(record => record.workItemId!))] }),\n workItems.listDecisionsForEvaluations(\n scope.orgId,\n scope.factoryProjectId,\n candidates.map(record => record.evaluationId),\n ),\n ]);\n const itemsById = new Map(items.map(item => [item.id, item]));\n return new Set(\n candidates\n .filter(record =>\n decisionOvertaken({\n boards,\n item: itemsById.get(record.workItemId!) ?? null,\n record,\n role: skillDecisionRole(record)!,\n siblings,\n }),\n )\n .map(record => record.id),\n );\n}\n"],"mappings":";;;;;;AASA,SAAgB,kBAAkB,QAA6E;CAC7G,MAAM,EAAE,MAAM,SAAS,OAAO;CAC9B,OAAO,SAAS,iBAAiB,OAAO,SAAS,WAAW,OAAO,KAAA;AACrE;;;;;;AAOA,SAAgB,kBACd,QACA,WACS;CACT,OAAO,OAAO,WAAW,YAAY,CAAC,aAAa,+BAA+B,OAAO,WAAW,CAAC,CAAC;AACxG;;;;;;;AAQA,SAAgB,kBAAkB,OAOtB;CACV,MAAM,EAAE,QAAQ,MAAM,QAAQ,SAAS;CACvC,IAAI,SAAS,MAAM,OAAO;CAC1B,MAAM,YAAY,OAAO,UAAU,QAAQ;CAC3C,MAAM,eAAe,KAAK,aAAa,QACrC,UAAS,MAAM,aAAa,KAAA,KAAa,IAAI,KAAK,MAAM,SAAS,CAAC,CAAC,QAAQ,IAAI,SACjF;CAIA,MAAM,QAAQ,iBAAiB,IAAI;CACnC,MAAM,aAAa,UAAkB,sBAAsB,QAAQ,OAAO,KAAK,CAAC,EAAE;CAElF,MAAM,eAAe,UACnB,iBAAiB,OAAO,IAAI,KAAK,GAAG,OAAO,MAAM,OAAO,SAAS,SAAS,KAAK,UAAU,KAAK,MAAM;CAOtG,MAAM,UAAU,CANY,KAAK,aAAa,MAC5C,UACE,IAAI,KAAK,MAAM,SAAS,CAAC,CAAC,QAAQ,KAAK,cACtC,MAAM,aAAa,KAAA,KAAa,IAAI,KAAK,MAAM,QAAQ,CAAC,CAAC,QAAQ,IAAI,cACtE,YAAY,MAAM,KAAK,CAC3B,IACqC,aAAa,QAAO,UAAS,CAAC,YAAY,MAAM,KAAK,CAAC,IAAI;CAC/F,IAAI,QAAQ,WAAW,GAAG,OAAO;CAGjC,MAAM,gBAAgB,IAAI,IACxB,MAAM,SACH,QAAO,YAAW,QAAQ,iBAAiB,OAAO,gBAAgB,QAAQ,SAAS,SAAS,YAAY,CAAC,CACzG,KAAI,YAAW,QAAQ,SAAS,KAAK,CAC1C;CACA,OAAO,QAAQ,MAAK,UAAS,CAAC,cAAc,IAAI,MAAM,KAAK,CAAC;AAC9D;;AAGA,eAAsB,qBACpB,WACA,QACA,OACA,SACsB;CACtB,MAAM,aAAa,QAAQ,QAAO,WAAU,OAAO,eAAe,QAAQ,kBAAkB,MAAM,MAAM,KAAA,CAAS;CACjH,IAAI,WAAW,WAAW,GAAG,uBAAO,IAAI,IAAI;CAC5C,MAAM,CAAC,OAAO,YAAY,MAAM,QAAQ,IAAI,CAC1C,UAAU,UAAU;EAAE,GAAG;EAAO,KAAK,CAAC,GAAG,IAAI,IAAI,WAAW,KAAI,WAAU,OAAO,UAAW,CAAC,CAAC;CAAE,CAAC,GACjG,UAAU,4BACR,MAAM,OACN,MAAM,kBACN,WAAW,KAAI,WAAU,OAAO,YAAY,CAC9C,CACF,CAAC;CACD,MAAM,YAAY,IAAI,IAAI,MAAM,KAAI,SAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;CAC5D,OAAO,IAAI,IACT,WACG,QAAO,WACN,kBAAkB;EAChB;EACA,MAAM,UAAU,IAAI,OAAO,UAAW,KAAK;EAC3C;EACA,MAAM,kBAAkB,MAAM;EAC9B;CACF,CAAC,CACH,CAAC,CACA,KAAI,WAAU,OAAO,EAAE,CAC5B;AACF"}
@@ -1,17 +1,18 @@
1
1
  import type { MastraCodeState } from '@mastra/code-sdk/schema';
2
2
  import type { AgentController } from '@mastra/core/agent-controller';
3
3
  import type { BoardRegistry } from '../boards/index.js';
4
+ import type { IntakeRoutesReader } from '../boards/intake-routing.js';
4
5
  import type { ProjectBoardSource } from '../boards/project-boards.js';
5
6
  import type { AuditRecorder } from '../storage/domains/audit/domain.js';
6
7
  import type { FactoryFeedReader } from '../storage/domains/comments/feed-context.js';
7
- import type { FactoryDeferredDecisionRecord, WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';
8
+ import type { FactoryDeferredDecisionRecord, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';
8
9
  import type { FactoryRunEndReporter } from '../tools/reports.js';
9
10
  import type { FactoryTransitionService } from './transition-service.js';
10
11
  import type { FactoryCommitDecision } from './types.js';
11
12
  type FactoryController = Pick<AgentController<MastraCodeState>, 'getSession' | 'listActiveThreadRuns'>;
12
13
  export interface FactoryBindingPreparationInput {
13
14
  record: FactoryDeferredDecisionRecord;
14
- item: WorkItemRow;
15
+ item: Card;
15
16
  role: string;
16
17
  }
17
18
  export interface FactoryDecisionDispatcherOptions {
@@ -21,17 +22,14 @@ export interface FactoryDecisionDispatcherOptions {
21
22
  storage: WorkItemsStorage;
22
23
  /** Installed boards; defaults to the built-in Work and Review boards. */
23
24
  boards?: BoardRegistry | ProjectBoardSource;
25
+ /** The project's intake routes, which place newly filed linked cards. Without it, decisions place cards as they say. */
26
+ intakeRoutes?: IntakeRoutesReader;
24
27
  ownerId?: string;
25
28
  /** `false` parks `invokeSkill` effects as `proposed`; every other effect still runs. */
26
29
  isAutoRunEnabled: (tenant: {
27
30
  orgId: string;
28
31
  factoryProjectId: string;
29
32
  }) => Promise<boolean>;
30
- /** `true` lets the dispatcher answer a run's plan itself, so started work carries to Done. */
31
- autoApprovePlans?: (tenant: {
32
- orgId: string;
33
- factoryProjectId: string;
34
- }) => Promise<boolean>;
35
33
  reconcileToolResults?: () => Promise<void>;
36
34
  prepareBinding?: (input: FactoryBindingPreparationInput) => Promise<void>;
37
35
  primeCredentials?: (tenant: {
@@ -93,7 +91,7 @@ export declare const FACTORY_DISPATCH_CONSTANTS: {
93
91
  readonly runRegistryHeartbeatMs: number;
94
92
  readonly openRunStaleMs: 30000;
95
93
  readonly maxInFlight: 25;
96
- readonly stages: readonly ["intake", "triage", "planning", "execute", "review", "done", "canceled"];
94
+ readonly stages: readonly ["intake", "triage", "planning", "execute", "review", "pr-review", "done", "canceled"];
97
95
  };
98
96
  export {};
99
97
  //# sourceMappingURL=dispatcher.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/rules/dispatcher.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/rules/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAyC,MAAM,+BAA+B,CAAC;AAe5G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAatE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,KAAK,EACV,6BAA6B,EAI7B,IAAI,EACJ,gBAAgB,EAEjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAA4C,MAAM,YAAY,CAAC;AAkTlG,KAAK,iBAAiB,GAAG,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,YAAY,GAAG,sBAAsB,CAAC,CAAC;AA4BvG,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,6BAA6B,CAAC;IACtC,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;IAClF,OAAO,EAAE,gBAAgB,CAAC;IAC1B,yEAAyE;IACzE,MAAM,CAAC,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAC5C,wHAAwH;IACxH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,gBAAgB,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF;;;;OAIG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE;QAAE,IAAI,EAAE,qBAAqB,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnH,6BAA6B,CAAC,EAAE,CAAC,KAAK,EAAE;QACtC,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE;YAAE,IAAI,EAAE,sBAAsB,CAAA;SAAE,CAAC,CAAC;KAC5E,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7B,mHAAmH;IACnH,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,mCAAmC,CAAC,EAAE,MAAM,CAAC;CAC9C;AAoKD,qBAAa,yBAAyB;;IAmCpC,YAAY,OAAO,EAAE,gCAAgC,EA6BpD;IAED,KAAK,IAAI,IAAI,CAKZ;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1B;IAEK,OAAO,CAAC,GAAG,OAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7C;CA6yCF;AAED,eAAO,MAAM,0BAA0B;aACrC,OAAO;aACP,MAAM;aACN,SAAS;aACT,WAAW;aACX,cAAc;aACd,YAAY;aACZ,mCAAmC;aACnC,sBAAsB;aACtB,cAAc;aACd,WAAW;aACX,MAAM;CACE,CAAC"}
@@ -1,10 +1,13 @@
1
- import { FACTORY_RULE_STAGES, externalSourceForWorkItem, externallyAuthoredWorkItem } from "./types.js";
1
+ import { FACTORY_RULE_STAGES, externalSourceForWorkItem, workItemSource } from "./types.js";
2
2
  import { assertFactoryDecisionTarget, validateFactoryRuleDecision } from "./validation.js";
3
- import { boardForWorkItem, isTerminalWorkItem, resolvePhaseSemantics, workItemPhaseSemantics } from "../boards/semantics.js";
4
- import "../boards/index.js";
5
- import { toBoardSource } from "../boards/project-boards.js";
6
3
  import { FactoryDispatchError, factoryDispatchFailureCode, factoryDispatchFailureMetadata } from "./dispatch-errors.js";
7
4
  import { FACTORY_RULE_MATERIALIZATION_KEY } from "../storage/domains/work-items/base.js";
5
+ import { workItemProviderAdapter } from "../work-items/providers/index.js";
6
+ import { cardRuleFacts } from "../boards/card-facts.js";
7
+ import { boardForWorkItem, isPullRequestCard, isTerminalWorkItem, pullRequestReviewPhase, resolvePhaseSemantics, reviewsPullRequest, workItemPhaseSemantics } from "../boards/semantics.js";
8
+ import "../boards/index.js";
9
+ import { toBoardSource } from "../boards/project-boards.js";
10
+ import { INTAKE_ROUTE_METADATA_KEY, landingPhase, placedByIntakeRoute, resolveIntakePlacement } from "../boards/intake-routing.js";
8
11
  import { moveCardToBoard } from "../boards/relocate.js";
9
12
  import { decisionOvertaken } from "./decision-applicability.js";
10
13
  import { FACTORY_OPEN_RUN_STALE_MS, heartbeatSessionOpenRun, isOpenRunLiveElsewhere, listSessionOpenRuns, recordSessionRunStart, waitForSessionRunAudit } from "../session/run-audit.js";
@@ -251,7 +254,10 @@ function requestsConsent(boards, record, decision) {
251
254
  }
252
255
  function reviewsFactoryAuthoredCode(item, decision) {
253
256
  if (item.metadata?.factoryAuthored !== true) return false;
254
- if (decision.type === "transition") return decision.board === "review" && decision.stage === "review";
257
+ if (decision.type === "transition") return decision.stage === pullRequestReviewPhase(decision.board) && reviewsPullRequest({
258
+ board: decision.board,
259
+ item: { source: workItemSource(item.externalSource) }
260
+ });
255
261
  return decision.type === "invokeSkill" && decision.role === "review";
256
262
  }
257
263
  function leaseIdentity(record, ownerId) {
@@ -288,10 +294,10 @@ var FactoryDecisionDispatcher = class {
288
294
  #controller;
289
295
  #transitionService;
290
296
  #boards;
297
+ #intakeRoutes;
291
298
  #storage;
292
299
  #ownerId;
293
300
  #isAutoRunEnabled;
294
- #autoApprovePlans;
295
301
  #reconcileToolResults;
296
302
  #prepareBinding;
297
303
  #primeCredentials;
@@ -322,10 +328,10 @@ var FactoryDecisionDispatcher = class {
322
328
  this.#controller = options.controller;
323
329
  this.#transitionService = options.transitionService;
324
330
  this.#boards = toBoardSource(options.boards);
331
+ this.#intakeRoutes = options.intakeRoutes;
325
332
  this.#storage = options.storage;
326
333
  this.#ownerId = options.ownerId ?? `factory-dispatcher:${globalThis.crypto.randomUUID()}`;
327
334
  this.#isAutoRunEnabled = options.isAutoRunEnabled;
328
- this.#autoApprovePlans = options.autoApprovePlans;
329
335
  this.#reconcileToolResults = options.reconcileToolResults;
330
336
  this.#prepareBinding = options.prepareBinding;
331
337
  this.#primeCredentials = options.primeCredentials;
@@ -552,7 +558,6 @@ var FactoryDecisionDispatcher = class {
552
558
  orgId: record.orgId,
553
559
  id: record.workItemId
554
560
  }) : null;
555
- if (item && externallyAuthoredWorkItem(item)) return true;
556
561
  if (item?.autonomyArmedAt != null) return false;
557
562
  if (item && reviewsFactoryAuthoredCode(item, decision)) return false;
558
563
  if (item && startsInAutoPhase(boards, item, decision)) return false;
@@ -843,10 +848,10 @@ var FactoryDecisionDispatcher = class {
843
848
  const cards = (await this.#storage.list({
844
849
  orgId: record.orgId,
845
850
  factoryProjectId: record.factoryProjectId
846
- })).filter((item) => item.externalSource?.integrationId === "linear" && item.metadata?.linearIssueId === issueId);
851
+ })).filter((item) => item.externalSource?.integrationId === "linear" && item.workItem.metadata?.linearIssueId === issueId);
847
852
  return cards.find((item) => !isTerminalWorkItem(boards, item)) ?? cards[0] ?? null;
848
853
  }
849
- async #upsertLinkedItem(record, decision, causalChain) {
854
+ async #upsertLinkedItem(record, requested, causalChain) {
850
855
  if (this.#factoryProjectExists && !await this.#factoryProjectExists({
851
856
  orgId: record.orgId,
852
857
  factoryProjectId: record.factoryProjectId
@@ -854,16 +859,18 @@ var FactoryDecisionDispatcher = class {
854
859
  const existing = await this.#storage.getByProjectSource({
855
860
  orgId: record.orgId,
856
861
  factoryProjectId: record.factoryProjectId,
857
- source: externalSourceForDecision(decision)
862
+ source: externalSourceForDecision(requested)
858
863
  });
859
- if (existing?.metadata?.["factoryRuleMaterializationKey"] === record.idempotencyKey) {
860
- if (decision.skipRules === true) return;
861
- for (const suffix of ["destination", "initial-entry"]) {
862
- const replay = await this.#storage.getTransitionResultByIngress(record.orgId, record.factoryProjectId, `decision:${record.idempotencyKey}:${existing.id}:${suffix}`);
863
- if (replay?.status === "accepted" && replay.stage === decision.stage) return;
864
- }
865
- }
864
+ const materializedHere = existing?.metadata?.[FACTORY_RULE_MATERIALIZATION_KEY] === record.idempotencyKey;
865
+ if (materializedHere && requested.skipRules === true) return;
866
866
  const boards = await this.#boards.load(record);
867
+ const renamed = existing ? null : await this.#linearCardByIssueId(record, requested, boards);
868
+ const current = existing ?? renamed;
869
+ const decision = !current ? await this.#routeArrival(record, requested, boards) : materializedHere ? await this.#resumeRoutedCard(record, current, requested, boards) : this.#keepRoutedCard(current, requested, boards);
870
+ if (materializedHere) for (const suffix of ["destination", "initial-entry"]) {
871
+ const replay = await this.#storage.getTransitionResultByIngress(record.orgId, record.factoryProjectId, `decision:${record.idempotencyKey}:${existing.id}:${suffix}`);
872
+ if (replay?.status === "accepted" && replay.stage === decision.stage) return;
873
+ }
867
874
  assertFactoryDecisionTarget(decision, boards);
868
875
  const definition = boards.get(decision.board);
869
876
  if (!definition) throw new Error("Factory decision target board is not installed.");
@@ -875,7 +882,6 @@ var FactoryDecisionDispatcher = class {
875
882
  factoryProjectId: record.factoryProjectId,
876
883
  decision
877
884
  }) ?? null;
878
- const renamed = existing ? null : await this.#linearCardByIssueId(record, decision, boards);
879
885
  let result = renamed ? {
880
886
  created: false,
881
887
  item: renamed,
@@ -902,7 +908,8 @@ var FactoryDecisionDispatcher = class {
902
908
  reuseMode: "preserve"
903
909
  });
904
910
  const itemBoard = boardForWorkItem(result.item);
905
- if (!skipRules && itemBoard !== decision.board) throw new Error(`The work item belongs to board "${itemBoard}", not "${decision.board}".`);
911
+ const board = itemBoard === "review" && decision.board === "work" && isPullRequestCard({ source: workItemSource(result.item.externalSource) }) ? itemBoard : decision.board;
912
+ if (!skipRules && itemBoard !== board) throw new Error(`The work item belongs to board "${itemBoard}", not "${board}".`);
906
913
  if (!result.item.parentWorkItemId && parentWorkItemId && parentWorkItemId !== result.item.id) {
907
914
  const item = await this.#storage.setParentWorkItemIfMissing({
908
915
  orgId: record.orgId,
@@ -916,13 +923,15 @@ var FactoryDecisionDispatcher = class {
916
923
  };
917
924
  }
918
925
  if (!result.created && !skipRules) {
919
- const missing = Object.fromEntries(Object.entries(decision.metadata ?? {}).filter(([key]) => key !== "factoryRuleMaterializationKey" && result.item.metadata?.[key] === void 0));
926
+ const providerKeys = workItemProviderAdapter(result.item.externalSource).providerMetadataKeys;
927
+ const missing = Object.fromEntries(Object.entries(decision.metadata ?? {}).filter(([key]) => key !== "factoryRuleMaterializationKey" && (providerKeys.includes(key) ? result.item.workItem.metadata?.[key] : result.item.metadata?.[key]) === void 0));
920
928
  if (Object.keys(missing).length > 0) {
921
- const filled = await this.#storage.update({
929
+ const filled = await this.#storage.syncCard({
922
930
  orgId: record.orgId,
923
931
  id: result.item.id,
924
932
  userId: "factory-rule-dispatcher",
925
- patch: { metadata: missing }
933
+ patch: { metadata: missing },
934
+ fillOnly: true
926
935
  });
927
936
  if (filled) result = {
928
937
  ...result,
@@ -936,14 +945,13 @@ var FactoryDecisionDispatcher = class {
936
945
  boardRegistry: boards,
937
946
  userId: "factory-rule-dispatcher",
938
947
  item: result.item,
939
- targetBoard: decision.board,
948
+ targetBoard: board,
940
949
  targetStage: decision.stage
941
950
  });
942
951
  return;
943
952
  }
944
953
  const materializedByDecision = result.item.metadata?.[FACTORY_RULE_MATERIALIZATION_KEY] === record.idempotencyKey;
945
954
  if (!materializedByDecision && (decision.stage === initialPhase || !result.item.stages.includes(initialPhase))) return;
946
- const board = decision.board;
947
955
  let expectedRevision = result.item.revision;
948
956
  if (materializedByDecision) {
949
957
  const initial = await this.#transitionService.transition({
@@ -993,6 +1001,78 @@ var FactoryDecisionDispatcher = class {
993
1001
  });
994
1002
  if (moved.status === "rejected") throw new Error(`${moved.code}: ${moved.reason}`);
995
1003
  }
1004
+ /**
1005
+ * Applies the project's intake routes to an arrival: a decision filing the card at its
1006
+ * board's initial phase. A decision naming a later phase (a maintainer's review request)
1007
+ * or placing the card outright (`skipRules`) already chose where the card goes.
1008
+ */
1009
+ async #routeArrival(record, decision, boards) {
1010
+ if (!this.#intakeRoutes || decision.skipRules === true) return decision;
1011
+ if (decision.stage !== boards.get(decision.board)?.initialPhase) return decision;
1012
+ if (record.workItemId !== null) return decision;
1013
+ const routes = await this.#intakeRoutes.listIntakeRoutes({
1014
+ orgId: record.orgId,
1015
+ factoryProjectId: record.factoryProjectId
1016
+ });
1017
+ if (routes.length === 0) return decision;
1018
+ const facts = cardRuleFacts({
1019
+ title: decision.title,
1020
+ metadata: decision.metadata ?? {},
1021
+ externalSource: externalSourceForDecision(decision)
1022
+ });
1023
+ const placement = resolveIntakePlacement(routes, facts, boards);
1024
+ if (!placement) return decision;
1025
+ return {
1026
+ ...decision,
1027
+ board: placement.board,
1028
+ stage: placement.phase,
1029
+ metadata: {
1030
+ ...decision.metadata,
1031
+ [INTAKE_ROUTE_METADATA_KEY]: placement.routeId
1032
+ }
1033
+ };
1034
+ }
1035
+ /**
1036
+ * A card an intake route placed stays on the route's board when its source is filed again
1037
+ * (a reconcile replaying "opened" with today's label route or binding): the decision lands
1038
+ * on the card's board at its first phase, so it only backfills facts and moves nothing.
1039
+ * An explicit placement (`skipRules`) still wins.
1040
+ */
1041
+ /**
1042
+ * A retry of the decision that filed `existing` finishes the filing where it started: on the
1043
+ * card's board, at the phase its route names now, or the board's first phase when the route was
1044
+ * deleted, disabled or re-pointed since. Routes are not re-run, so an edit cannot send the card
1045
+ * to a board it isn't on.
1046
+ */
1047
+ async #resumeRoutedCard(record, existing, decision, boards) {
1048
+ const routeId = existing.metadata?.[INTAKE_ROUTE_METADATA_KEY];
1049
+ if (typeof routeId !== "string") return decision;
1050
+ const board = boards.get(boardForWorkItem(existing));
1051
+ if (!board) return decision;
1052
+ const route = (this.#intakeRoutes ? await this.#intakeRoutes.listIntakeRoutes({
1053
+ orgId: record.orgId,
1054
+ factoryProjectId: record.factoryProjectId
1055
+ }) : []).find((entry) => entry.id === routeId && entry.enabled && entry.target.boardKey === board.id);
1056
+ return {
1057
+ ...decision,
1058
+ board: board.id,
1059
+ stage: landingPhase(board, route?.target.phaseKey),
1060
+ metadata: {
1061
+ ...decision.metadata,
1062
+ [INTAKE_ROUTE_METADATA_KEY]: routeId
1063
+ }
1064
+ };
1065
+ }
1066
+ #keepRoutedCard(existing, decision, boards) {
1067
+ if (decision.skipRules === true || !placedByIntakeRoute(existing)) return decision;
1068
+ const board = boards.get(boardForWorkItem(existing));
1069
+ if (!board || board.id === decision.board) return decision;
1070
+ return {
1071
+ ...decision,
1072
+ board: board.id,
1073
+ stage: board.initialPhase
1074
+ };
1075
+ }
996
1076
  async #requireItem(record) {
997
1077
  if (!record.workItemId) throw new Error("Factory decision is not linked to a work item.");
998
1078
  const item = await this.#storage.get({
@@ -1078,23 +1158,18 @@ var FactoryDecisionDispatcher = class {
1078
1158
  return session;
1079
1159
  }
1080
1160
  /**
1081
- * Whether the run answers its plan approvals itself: the project says so, or the card's phase
1082
- * ends with an auto-approved `submit_plan`. Unset means off: a plan nobody asked us to answer is
1083
- * a plan someone should see.
1161
+ * Whether the run answers its plan approvals itself: the card's phase ends with an auto-approved
1162
+ * `submit_plan`. Otherwise a plan waits for a person.
1084
1163
  */
1085
1164
  async #plansAreAutoApproved({ orgId, factoryProjectId, workItemId }) {
1086
1165
  const item = workItemId ? await this.#storage.get({
1087
1166
  orgId,
1088
1167
  id: workItemId
1089
1168
  }) : null;
1090
- if (item && autoApprovedExitTool(await this.#boards.load({
1091
- orgId,
1092
- factoryProjectId
1093
- }), item) === "submit_plan") return true;
1094
- return this.#autoApprovePlans ? await this.#autoApprovePlans({
1169
+ return item !== null && autoApprovedExitTool(await this.#boards.load({
1095
1170
  orgId,
1096
1171
  factoryProjectId
1097
- }) : false;
1172
+ }), item) === "submit_plan";
1098
1173
  }
1099
1174
  async #requireSession(binding) {
1100
1175
  const session = await this.#findSession(binding);