@mastra/factory 0.28.0-alpha.14 → 0.28.0-alpha.15

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 (43) hide show
  1. package/README.md +12 -10
  2. package/dist/boards/board-writes.d.ts +3 -3
  3. package/dist/boards/board-writes.d.ts.map +1 -1
  4. package/dist/boards/board-writes.js +24 -20
  5. package/dist/boards/board-writes.js.map +1 -1
  6. package/dist/boards/project-boards.d.ts +20 -0
  7. package/dist/boards/project-boards.d.ts.map +1 -1
  8. package/dist/boards/project-boards.js +35 -11
  9. package/dist/boards/project-boards.js.map +1 -1
  10. package/dist/boards/registry.d.ts.map +1 -1
  11. package/dist/boards/registry.js +0 -3
  12. package/dist/boards/registry.js.map +1 -1
  13. package/dist/factory.d.ts +5 -2
  14. package/dist/factory.d.ts.map +1 -1
  15. package/dist/factory.js +8 -3
  16. package/dist/factory.js.map +1 -1
  17. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  18. package/dist/integrations/platform/github/integration.js +24 -12
  19. package/dist/integrations/platform/github/integration.js.map +1 -1
  20. package/dist/integrations/platform/jira/integration.d.ts.map +1 -1
  21. package/dist/integrations/platform/jira/integration.js +5 -1
  22. package/dist/integrations/platform/jira/integration.js.map +1 -1
  23. package/dist/routes/boards.d.ts +2 -3
  24. package/dist/routes/boards.d.ts.map +1 -1
  25. package/dist/routes/boards.js.map +1 -1
  26. package/dist/rules/dispatcher.d.ts.map +1 -1
  27. package/dist/rules/dispatcher.js +49 -14
  28. package/dist/rules/dispatcher.js.map +1 -1
  29. package/dist/storage/domains/boards/base.d.ts +25 -5
  30. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  31. package/dist/storage/domains/boards/base.js +57 -20
  32. package/dist/storage/domains/boards/base.js.map +1 -1
  33. package/dist/storage/domains/work-items/base.d.ts +17 -4
  34. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  35. package/dist/storage/domains/work-items/base.js +24 -4
  36. package/dist/storage/domains/work-items/base.js.map +1 -1
  37. package/dist/storage/domains/work-items/legacy-review.d.ts +19 -1
  38. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -1
  39. package/dist/storage/domains/work-items/legacy-review.js +47 -2
  40. package/dist/storage/domains/work-items/legacy-review.js.map +1 -1
  41. package/dist/tools/sessions-state-processor.js +1 -1
  42. package/dist/tools/sessions-state-processor.js.map +1 -1
  43. package/package.json +10 -10
@@ -164,6 +164,8 @@ export declare class StoredBoardError extends Error {
164
164
  name: string;
165
165
  constructor(code: StoredBoardErrorCode, message: string);
166
166
  }
167
+ /** Runs inside a board write's transaction, before the board is written. */
168
+ export type BoardWriteStep = (ops: FactoryStorageOps) => Promise<void>;
167
169
  /**
168
170
  * Each project's boards and their ordered phases. Every write runs in one transaction that also
169
171
  * replaces the project's row in `factory_board_definition_versions`, so caches on other
@@ -185,12 +187,17 @@ export declare class StoredBoardsStorage extends FactoryStorageDomain {
185
187
  */
186
188
  snapshot(scope: StoredBoardScope): Promise<StoredBoardSnapshot>;
187
189
  get(scope: StoredBoardScope, key: string): Promise<StoredBoardRecord | null>;
188
- /** Creates a board through the API. */
189
- create(scope: StoredBoardScope, input: StoredBoardInput, actor: string): Promise<StoredBoardRecord>;
190
+ /**
191
+ * Creates a board through the API. `before` runs in the same transaction, once the key is known
192
+ * to be free. A row under the key that `over` accepts does not hold it: the board is written
193
+ * over that row.
194
+ */
195
+ create(scope: StoredBoardScope, input: StoredBoardInput, actor: string, before?: BoardWriteStep, over?: (row: StoredBoardRecord) => boolean): Promise<StoredBoardRecord>;
190
196
  /** Replaces a board's name, description and phases. The board key never changes. */
191
197
  replace(scope: StoredBoardScope, key: string, input: Omit<StoredBoardInput, 'key'>, options: {
192
198
  expectedRevision: number;
193
199
  actor: string;
200
+ before?: BoardWriteStep;
194
201
  }): Promise<StoredBoardRecord>;
195
202
  /**
196
203
  * Stores Factory's boards (Work, app and seed boards) in the project, each key once: a key the
@@ -204,21 +211,32 @@ export declare class StoredBoardsStorage extends FactoryStorageDomain {
204
211
  * deleted: that project chose its boards, and Work is never added beside or after them. The
205
212
  * `intoEmpty` boards (an app's, for every project) go first into a project with no boards, so
206
213
  * Factory's own under the same key, or in `onlyIntoEmpty`, then stay out. `actor` is recorded
207
- * as the inserted boards' creator.
214
+ * as the inserted boards' creator. `before` runs in the same
215
+ * transaction ahead of each board it inserts.
208
216
  */
209
217
  seedBoards(scope: StoredBoardScope, boards: readonly StoredBoardInput[], options?: {
210
218
  actor?: string;
211
219
  onlyIntoEmpty?: readonly string[];
212
220
  intoEmpty?: readonly StoredBoardInput[];
221
+ before?: (ops: FactoryStorageOps, key: string) => Promise<void>;
213
222
  }): Promise<string[]>;
214
223
  /** The keys of the boards Factory stored in the project; null before it kept the list. */
215
224
  seededBoardKeys(scope: StoredBoardScope): Promise<string[] | null>;
225
+ /**
226
+ * Rewrites the board stored under `seed.key` to `seed` at its next revision when `when` says the
227
+ * row is nobody's: one an earlier release seeded for a board Factory no longer has, under a key
228
+ * the app now defines. `before` runs in the same transaction. Returns whether it rewrote the row.
229
+ */
230
+ adoptSeed(scope: StoredBoardScope, seed: StoredBoardInput, options: {
231
+ when: (row: StoredBoardRecord) => boolean;
232
+ before?: BoardWriteStep;
233
+ }): Promise<boolean>;
216
234
  /**
217
235
  * Inserts a board into the project unless one is stored under its key, and records the key as
218
236
  * stored, so seeding never adds it again. Unlike seeding, it inserts a key the project deleted.
219
- * Returns whether it inserted the board.
237
+ * Returns whether it inserted the board. `before` runs in the same transaction when it does.
220
238
  */
221
- insertIfMissing(scope: StoredBoardScope, board: StoredBoardInput, actor: string): Promise<boolean>;
239
+ insertIfMissing(scope: StoredBoardScope, board: StoredBoardInput, actor: string, before?: BoardWriteStep): Promise<boolean>;
222
240
  /**
223
241
  * Runs each migration the project hasn't had yet, once: the keys applied are recorded on the
224
242
  * project's version row in the same transaction as the board writes, and the compare-and-set on
@@ -262,4 +280,6 @@ export declare class StoredBoardsStorage extends FactoryStorageDomain {
262
280
  /** Puts the project's routes in the order of `ids`, which must name every route exactly once. */
263
281
  reorderIntakeRoutes(scope: StoredBoardScope, ids: string[], actor: string): Promise<StoredIntakeRouteRecord[]>;
264
282
  }
283
+ /** The project's board under `key`, read through `ops` so a caller inside a transaction reads within it. */
284
+ export declare function readStoredBoard(ops: FactoryStorageOps, scope: StoredBoardScope, key: string): Promise<StoredBoardRecord | null>;
265
285
  //# sourceMappingURL=base.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/boards/base.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/boards/base.ts"],"names":[],"mappings":"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"}
@@ -122,25 +122,25 @@ var StoredBoardsStorage = class extends FactoryStorageDomain {
122
122
  boards: await this.list(scope)
123
123
  };
124
124
  }
125
- async get(scope, key) {
126
- const row = await this.ops.findOne(BOARDS, {
127
- ...scopeWhere(scope),
128
- board_key: key
129
- });
130
- if (!row) return null;
131
- return toRecord(row, await this.ops.findMany(PHASES, {
132
- ...scopeWhere(scope),
133
- board_key: key
134
- }));
125
+ get(scope, key) {
126
+ return readStoredBoard(this.ops, scope, key);
135
127
  }
136
- /** Creates a board through the API. */
137
- async create(scope, input, actor) {
128
+ /**
129
+ * Creates a board through the API. `before` runs in the same transaction, once the key is known
130
+ * to be free. A row under the key that `over` accepts does not hold it: the board is written
131
+ * over that row.
132
+ */
133
+ async create(scope, input, actor, before, over) {
138
134
  await ensureVersionRow(this.ops, scope);
139
135
  try {
140
136
  return await this.#write(scope, async (ops) => {
141
137
  const rows = await ops.findMany(BOARDS, scopeWhere(scope));
142
- if (rows.some((row) => row.board_key === input.key)) throw new StoredBoardError("board_exists", `Board "${input.key}" already exists in this project.`);
143
- await insertBoard(ops, scope, input, {
138
+ const taken = rows.find((row) => row.board_key === input.key);
139
+ const stored = taken && over ? await readStoredBoard(ops, scope, input.key) : null;
140
+ if (taken && !(stored && over?.(stored))) throw new StoredBoardError("board_exists", `Board "${input.key}" already exists in this project.`);
141
+ await before?.(ops);
142
+ if (taken) await writeBoard(ops, scope, taken, input, actor);
143
+ else await insertBoard(ops, scope, input, {
144
144
  position: nextPosition(rows),
145
145
  actor
146
146
  });
@@ -159,6 +159,7 @@ var StoredBoardsStorage = class extends FactoryStorageDomain {
159
159
  await this.#write(scope, async (ops) => {
160
160
  const row = await findBoard(ops, scope, key);
161
161
  checkRevision(row, key, options.expectedRevision);
162
+ await options.before?.(ops);
162
163
  await writeBoard(ops, scope, row, {
163
164
  key,
164
165
  ...input
@@ -182,7 +183,8 @@ var StoredBoardsStorage = class extends FactoryStorageDomain {
182
183
  * deleted: that project chose its boards, and Work is never added beside or after them. The
183
184
  * `intoEmpty` boards (an app's, for every project) go first into a project with no boards, so
184
185
  * Factory's own under the same key, or in `onlyIntoEmpty`, then stay out. `actor` is recorded
185
- * as the inserted boards' creator.
186
+ * as the inserted boards' creator. `before` runs in the same
187
+ * transaction ahead of each board it inserts.
186
188
  */
187
189
  async seedBoards(scope, boards, options = {}) {
188
190
  const marker = await this.ops.findOne(VERSIONS, scopeWhere(scope));
@@ -191,7 +193,8 @@ var StoredBoardsStorage = class extends FactoryStorageDomain {
191
193
  actor: options.actor ?? "factory",
192
194
  skipSeeded: true,
193
195
  onlyIntoEmpty: options.onlyIntoEmpty ?? [],
194
- intoEmpty: options.intoEmpty ?? []
196
+ intoEmpty: options.intoEmpty ?? [],
197
+ before: options.before
195
198
  });
196
199
  }
197
200
  /** The keys of the boards Factory stored in the project; null before it kept the list. */
@@ -199,14 +202,35 @@ var StoredBoardsStorage = class extends FactoryStorageDomain {
199
202
  return (await this.ops.findOne(VERSIONS, scopeWhere(scope)))?.seeded_boards ?? null;
200
203
  }
201
204
  /**
205
+ * Rewrites the board stored under `seed.key` to `seed` at its next revision when `when` says the
206
+ * row is nobody's: one an earlier release seeded for a board Factory no longer has, under a key
207
+ * the app now defines. `before` runs in the same transaction. Returns whether it rewrote the row.
208
+ */
209
+ async adoptSeed(scope, seed, options) {
210
+ return this.#write(scope, async (ops) => {
211
+ const stored = await readStoredBoard(ops, scope, seed.key);
212
+ if (!stored || !options.when(stored)) return {
213
+ result: false,
214
+ changed: false
215
+ };
216
+ await options.before?.(ops);
217
+ await writeBoard(ops, scope, await findBoard(ops, scope, seed.key), seed, DEFAULT_INTAKE_ROUTE_ACTOR);
218
+ return {
219
+ result: true,
220
+ changed: true
221
+ };
222
+ });
223
+ }
224
+ /**
202
225
  * Inserts a board into the project unless one is stored under its key, and records the key as
203
226
  * stored, so seeding never adds it again. Unlike seeding, it inserts a key the project deleted.
204
- * Returns whether it inserted the board.
227
+ * Returns whether it inserted the board. `before` runs in the same transaction when it does.
205
228
  */
206
- async insertIfMissing(scope, board, actor) {
229
+ async insertIfMissing(scope, board, actor, before) {
207
230
  return (await this.#insertOnce(scope, [board], {
208
231
  actor,
209
- skipSeeded: false
232
+ skipSeeded: false,
233
+ before
210
234
  })).length > 0;
211
235
  }
212
236
  async #insertOnce(scope, boards, options) {
@@ -222,6 +246,7 @@ var StoredBoardsStorage = class extends FactoryStorageDomain {
222
246
  for (const board of candidates) {
223
247
  if (present.has(board.key) || options.skipSeeded && seeded.has(board.key)) continue;
224
248
  if (present.size > 0 && options.onlyIntoEmpty?.includes(board.key)) continue;
249
+ await options.before?.(ops, board.key);
225
250
  await insertBoard(ops, scope, board, {
226
251
  position: position++,
227
252
  actor: options.actor
@@ -485,6 +510,18 @@ var StoredBoardsStorage = class extends FactoryStorageDomain {
485
510
  async function readVersion(ops, scope) {
486
511
  return (await ops.findOne(VERSIONS, scopeWhere(scope)))?.version ?? null;
487
512
  }
513
+ /** The project's board under `key`, read through `ops` so a caller inside a transaction reads within it. */
514
+ async function readStoredBoard(ops, scope, key) {
515
+ const row = await ops.findOne(BOARDS, {
516
+ ...scopeWhere(scope),
517
+ board_key: key
518
+ });
519
+ if (!row) return null;
520
+ return toRecord(row, await ops.findMany(PHASES, {
521
+ ...scopeWhere(scope),
522
+ board_key: key
523
+ }));
524
+ }
488
525
  async function readBoards(ops, scope) {
489
526
  const [rows, phases] = await Promise.all([ops.findMany(BOARDS, scopeWhere(scope)), ops.findMany(PHASES, scopeWhere(scope))]);
490
527
  const byBoard = /* @__PURE__ */ new Map();
@@ -707,6 +744,6 @@ async function placeIntakeRoutes(ops, rows, actor) {
707
744
  revision
708
745
  }, { position }) !== 1) throw new ConcurrentBoardWrite();
709
746
  }
710
- export { CATCH_ALL_INTAKE_ROUTE, CLOSED_CANCELED_ROUTE, CLOSED_COMPLETED_ROUTE, CLOSES_ISSUE_INTAKE_ROUTE, DEFAULT_INTAKE_ROUTE, DEFAULT_INTAKE_ROUTES, DEFAULT_INTAKE_ROUTE_ACTOR, MAX_INTAKE_ROUTES, PULL_REQUEST_CLOSED_ISSUE_ROUTE, PULL_REQUEST_CLOSED_ROUTE, PULL_REQUEST_INTAKE_ROUTE, PULL_REQUEST_MERGED_ROUTE, PULL_REQUEST_REVIEW_REQUESTED_ROUTE, PULL_REQUEST_UPDATED_ROUTE, REOPENED_ROUTE, StoredBoardError, StoredBoardsStorage };
747
+ export { CATCH_ALL_INTAKE_ROUTE, CLOSED_CANCELED_ROUTE, CLOSED_COMPLETED_ROUTE, CLOSES_ISSUE_INTAKE_ROUTE, DEFAULT_INTAKE_ROUTE, DEFAULT_INTAKE_ROUTES, DEFAULT_INTAKE_ROUTE_ACTOR, MAX_INTAKE_ROUTES, PULL_REQUEST_CLOSED_ISSUE_ROUTE, PULL_REQUEST_CLOSED_ROUTE, PULL_REQUEST_INTAKE_ROUTE, PULL_REQUEST_MERGED_ROUTE, PULL_REQUEST_REVIEW_REQUESTED_ROUTE, PULL_REQUEST_UPDATED_ROUTE, REOPENED_ROUTE, StoredBoardError, StoredBoardsStorage, readStoredBoard };
711
748
 
712
749
  //# sourceMappingURL=base.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"base.js","names":[],"sources":["../../../../src/storage/domains/boards/base.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { FactoryStorageDomain, UniqueViolationError } from '@mastra/core/storage';\nimport type { FactoryStorageOps } from '@mastra/core/storage';\n\nimport { DEFAULT_ROUTE_EVENTS, routeEventsProblem } from '../../../boards/board-events.js';\nimport type { StatusEvent } from '../../../boards/board-events.js';\nimport type { FactoryPhaseTool } from '../../../boards/define-board.js';\nimport { DEFAULT_INTAKE_ROUTES } from '../../../boards/work-routes.js';\nimport type { RuleGroup } from '../../../rules/rule-group.js';\nimport type { RetiredAutomationSettings } from '../projects/base.js';\nimport {\n FACTORY_BOARD_DEFINITION_VERSIONS_SCHEMA,\n FACTORY_BOARD_PHASES_SCHEMA,\n FACTORY_BOARDS_SCHEMA,\n FACTORY_INTAKE_ROUTE_LOCKS_SCHEMA,\n FACTORY_INTAKE_ROUTES_SCHEMA,\n} from './schemas.js';\n\n/** The project a board belongs to. */\nexport interface StoredBoardScope {\n orgId: string;\n factoryProjectId: string;\n}\n\nexport type StoredPhaseKind = 'resting' | 'working' | 'terminal';\n\n/** Who runs a working phase. Factory runs every phase with its code agent. */\nexport interface StoredPhaseRunner {\n skill?: string;\n context?: string;\n instructions?: string;\n /** The objective the phase's runs pursue as a goal. */\n goal?: { objective: string; maxRuns?: number };\n}\n\nexport interface StoredPhaseExitTool {\n id: string;\n autoApprove?: boolean;\n autoApproveWhen?: RuleGroup;\n}\n\n/** A phase as it is written. `key` is the stage id cards sit in. */\nexport interface StoredPhaseInput {\n key: string;\n name: string;\n description?: string | null;\n kind: StoredPhaseKind;\n runner?: StoredPhaseRunner | null;\n /** Unset or `null` on a resting or working phase means every other phase; `[]` means none. */\n nextPhases?: string[] | null;\n autoStart?: boolean;\n autoStartWhen?: RuleGroup | null;\n exitTool?: StoredPhaseExitTool | null;\n /** Factory tools the phase grants the session working the card there. */\n tools?: FactoryPhaseTool[] | null;\n}\n\n/** A board as it is written. Phase order is significant: the first phase is where cards start. */\nexport interface StoredBoardInput {\n key: string;\n name: string;\n description?: string | null;\n phases: StoredPhaseInput[];\n}\n\nexport interface StoredPhaseRecord {\n key: string;\n position: number;\n name: string;\n description: string | null;\n kind: StoredPhaseKind;\n runner: StoredPhaseRunner | null;\n nextPhases: string[] | null;\n autoStart: boolean;\n autoStartWhen: RuleGroup | null;\n exitTool: StoredPhaseExitTool | null;\n tools: FactoryPhaseTool[] | null;\n}\n\nexport interface StoredBoardRecord {\n id: string;\n orgId: string;\n factoryProjectId: string;\n key: string;\n name: string;\n description: string | null;\n position: number;\n revision: number;\n createdBy: string;\n createdAt: Date;\n updatedBy: string;\n updatedAt: Date;\n phases: StoredPhaseRecord[];\n}\n\n/** What a board migration may know about the project besides the board it rewrites. */\nexport interface BoardMigrationContext {\n /** The project switches the boards replaced, as the project last stored them; null when unknown. */\n readonly retiredSettings: RetiredAutomationSettings | null;\n /** The phases of each board that cards sit in, by board key; null when the cards can't be read. */\n readonly occupiedPhases: ReadonlyMap<string, ReadonlySet<string>> | null;\n /**\n * The phases the code board under this key declares; undefined for a board only the project\n * stores. A row that drops one runs without its code rules (`mergeCodeBehaviour`).\n */\n codePhases(boardKey: string): ReadonlySet<string> | undefined;\n /** Tells the operator about a board a migration left as it is. */\n warn(message: string): void;\n}\n\n/** A one-time rewrite of a stored board, keyed so each project gets it once. */\nexport interface StoredBoardMigration {\n key: string;\n /** The board it rewrites; `null` rewrites every board the project stores. */\n boardKey: string | null;\n /** The board to write instead, with what changed; undefined leaves it as it is. */\n migrate(\n board: StoredBoardRecord,\n context: BoardMigrationContext,\n ): { board: Omit<StoredBoardInput, 'key'>; filled: string[] } | undefined;\n}\n\nconst EMPTY_MIGRATION_CONTEXT: BoardMigrationContext = {\n retiredSettings: null,\n occupiedPhases: new Map(),\n codePhases: () => undefined,\n warn: () => {},\n};\n\nexport interface AppliedBoardMigration {\n key: string;\n boardKey: string;\n filled: string[];\n}\n\nexport interface StoredBoardSnapshot {\n version: string | null;\n boards: StoredBoardRecord[];\n}\n\nexport interface IntakeRouteTarget {\n boardKey: string;\n /**\n * Unset lands the card in the board's first phase. On a route that joins a closed issue's\n * card, the phase that card moves to when its board allows it; unset leaves it where it is.\n */\n phaseKey?: string | null;\n /**\n * Files a pull request on the card of the issue it closes, which must be on `boardKey`, as one\n * more source instead of a card of its own. The route doesn't match any other arrival.\n */\n joinClosedIssue?: boolean;\n}\n\n/** An intake route as it is written. */\nexport interface StoredIntakeRouteInput {\n name: string;\n enabled?: boolean;\n /** Null matches every card. */\n when?: RuleGroup | null;\n target: IntakeRouteTarget;\n /** The status events the route handles; unset handles new cards (`work_item.created`). */\n on?: StatusEvent[];\n}\n\nexport interface StoredIntakeRouteRecord {\n id: string;\n orgId: string;\n factoryProjectId: string;\n name: string;\n enabled: boolean;\n position: number;\n when: RuleGroup | null;\n target: { boardKey: string; phaseKey: string | null; joinClosedIssue: boolean };\n on: StatusEvent[];\n revision: number;\n createdBy: string;\n createdAt: Date;\n updatedBy: string;\n updatedAt: Date;\n}\n\nexport type StoredBoardErrorCode =\n | 'board_exists'\n | 'board_not_found'\n | 'revision_mismatch'\n | 'intake_route_not_found'\n | 'intake_route_set_mismatch'\n | 'intake_route_limit'\n | 'invalid_intake_route';\n\n/** A project's most intake routes; a reorder names every one of them. */\nexport const MAX_INTAKE_ROUTES = 100;\n\n// Work's routes are its seed data, kept with the board they target.\nexport {\n DEFAULT_INTAKE_ROUTE,\n PULL_REQUEST_INTAKE_ROUTE,\n CLOSED_COMPLETED_ROUTE,\n CLOSED_CANCELED_ROUTE,\n REOPENED_ROUTE,\n PULL_REQUEST_MERGED_ROUTE,\n PULL_REQUEST_CLOSED_ROUTE,\n PULL_REQUEST_CLOSED_ISSUE_ROUTE,\n PULL_REQUEST_UPDATED_ROUTE,\n PULL_REQUEST_REVIEW_REQUESTED_ROUTE,\n CLOSES_ISSUE_INTAKE_ROUTE,\n CATCH_ALL_INTAKE_ROUTE,\n DEFAULT_INTAKE_ROUTES,\n} from '../../../boards/work-routes.js';\n\n/** The defaults a project whose lock row predates `seeded_defaults` was set up with. */\nconst ORIGINAL_DEFAULT_KEYS = ['outside-authors'];\n\n/** Who the default intake routes are created and last updated by. */\nexport const DEFAULT_INTAKE_ROUTE_ACTOR = 'factory';\n\nexport class StoredBoardError extends Error {\n override name = 'StoredBoardError';\n constructor(\n readonly code: StoredBoardErrorCode,\n message: string,\n ) {\n super(message);\n }\n}\n\ninterface BoardRow extends Record<string, unknown> {\n id: string;\n org_id: string;\n factory_project_id: string;\n board_key: string;\n name: string;\n description: string | null;\n position: number;\n revision: number;\n created_by: string;\n created_at: Date;\n updated_by: string;\n updated_at: Date;\n}\n\ninterface VersionRow extends Record<string, unknown> {\n version: string;\n /** Keys of the boards Factory stored in the project; null on rows written before the list. */\n seeded_boards: string[] | null;\n /** Keys of the board migrations applied to the project; null before the first one. */\n applied_migrations: string[] | null;\n}\n\ninterface PhaseRow extends Record<string, unknown> {\n id: string;\n org_id: string;\n factory_project_id: string;\n board_key: string;\n phase_key: string;\n position: number;\n name: string;\n description: string | null;\n kind: StoredPhaseKind;\n runner: StoredPhaseRunner | null;\n next_phases: string[] | null;\n auto_start: boolean;\n auto_start_when: RuleGroup | null;\n exit_tool: StoredPhaseExitTool | null;\n tools: FactoryPhaseTool[] | null;\n}\n\ninterface IntakeRouteRow extends Record<string, unknown> {\n id: string;\n org_id: string;\n factory_project_id: string;\n name: string;\n enabled: boolean;\n position: number;\n when_condition: RuleGroup | null;\n board_key: string;\n phase_key: string | null;\n /** Null on rows written before routes named events: they place new cards. */\n on_events: StatusEvent[] | null;\n join_closed_issue: boolean | null;\n revision: number;\n created_by: string;\n created_at: Date;\n updated_by: string;\n updated_at: Date;\n}\n\ninterface IntakeRouteLockRow extends Record<string, unknown> {\n /** Keys of the `DEFAULT_INTAKE_ROUTES` added to the project; null on rows written before the list. */\n seeded_defaults: string[] | null;\n}\n\nfunction seededDefaults(lock: IntakeRouteLockRow): string[] {\n return lock.seeded_defaults ?? ORIGINAL_DEFAULT_KEYS;\n}\n\nfunction missingDefaults(lock: IntakeRouteLockRow): (typeof DEFAULT_INTAKE_ROUTES)[number][] {\n const seeded = new Set(seededDefaults(lock));\n return DEFAULT_INTAKE_ROUTES.filter(({ key }) => !seeded.has(key));\n}\n\nconst BOARDS = 'factory_boards';\nconst PHASES = 'factory_board_phases';\nconst VERSIONS = 'factory_board_definition_versions';\nconst INTAKE_ROUTES = 'factory_intake_routes';\nconst INTAKE_ROUTE_LOCKS = 'factory_intake_route_locks';\nconst MAX_WRITE_ATTEMPTS = 3;\nconst MIGRATION_ACTOR = 'factory';\n\nfunction scopeWhere({ orgId, factoryProjectId }: StoredBoardScope) {\n return { org_id: orgId, factory_project_id: factoryProjectId };\n}\n\nfunction toPhaseRecord(row: PhaseRow): StoredPhaseRecord {\n return {\n key: row.phase_key,\n position: row.position,\n name: row.name,\n description: row.description,\n kind: row.kind,\n runner: row.runner,\n nextPhases: row.next_phases,\n autoStart: row.auto_start,\n autoStartWhen: row.auto_start_when,\n exitTool: row.exit_tool,\n tools: row.tools ?? null,\n };\n}\n\nfunction toRecord(row: BoardRow, phases: PhaseRow[]): StoredBoardRecord {\n return {\n id: row.id,\n orgId: row.org_id,\n factoryProjectId: row.factory_project_id,\n key: row.board_key,\n name: row.name,\n description: row.description,\n position: row.position,\n revision: row.revision,\n createdBy: row.created_by,\n createdAt: row.created_at,\n updatedBy: row.updated_by,\n updatedAt: row.updated_at,\n phases: phases.sort((left, right) => left.position - right.position).map(toPhaseRecord),\n };\n}\n\n/** A compare-and-set inside a write lost to a concurrent writer; the write is retried from fresh reads. */\nclass ConcurrentBoardWrite extends Error {}\n\n/**\n * Each project's boards and their ordered phases. Every write runs in one transaction that also\n * replaces the project's row in `factory_board_definition_versions`, so caches on other\n * replicas can detect it.\n */\nexport class StoredBoardsStorage extends FactoryStorageDomain {\n constructor() {\n super('boards');\n }\n\n async init(): Promise<void> {\n await this.ensureCollections([\n FACTORY_BOARDS_SCHEMA,\n FACTORY_BOARD_PHASES_SCHEMA,\n FACTORY_BOARD_DEFINITION_VERSIONS_SCHEMA,\n FACTORY_INTAKE_ROUTES_SCHEMA,\n FACTORY_INTAKE_ROUTE_LOCKS_SCHEMA,\n ]);\n }\n\n async dangerouslyClearAll(): Promise<void> {\n await this.ops.deleteMany(PHASES, {});\n await this.ops.deleteMany(BOARDS, {});\n await this.ops.deleteMany(VERSIONS, {});\n await this.ops.deleteMany(INTAKE_ROUTES, {});\n await this.ops.deleteMany(INTAKE_ROUTE_LOCKS, {});\n }\n\n /** The project's current definition version; null before its first board write. */\n async readVersion(scope: StoredBoardScope): Promise<string | null> {\n return readVersion(this.ops, scope);\n }\n\n /** The project's boards in order. */\n async list(scope: StoredBoardScope): Promise<StoredBoardRecord[]> {\n return readBoards(this.ops, scope);\n }\n\n /**\n * The version and the boards, read in that order: a write landing between the two reads leaves a\n * version older than the rows, so a cache keyed on it rereads on its next check instead of\n * keeping the stale rows.\n */\n async snapshot(scope: StoredBoardScope): Promise<StoredBoardSnapshot> {\n const version = await readVersion(this.ops, scope);\n return { version, boards: await this.list(scope) };\n }\n\n async get(scope: StoredBoardScope, key: string): Promise<StoredBoardRecord | null> {\n const row = await this.ops.findOne<BoardRow>(BOARDS, { ...scopeWhere(scope), board_key: key });\n if (!row) return null;\n const phases = await this.ops.findMany<PhaseRow>(PHASES, { ...scopeWhere(scope), board_key: key });\n return toRecord(row, phases);\n }\n\n /** Creates a board through the API. */\n async create(scope: StoredBoardScope, input: StoredBoardInput, actor: string): Promise<StoredBoardRecord> {\n await ensureVersionRow(this.ops, scope);\n try {\n return await this.#write(scope, async ops => {\n const rows = await ops.findMany<BoardRow>(BOARDS, scopeWhere(scope));\n if (rows.some(row => row.board_key === input.key)) {\n throw new StoredBoardError('board_exists', `Board \"${input.key}\" already exists in this project.`);\n }\n await insertBoard(ops, scope, input, { position: nextPosition(rows), actor });\n return { result: undefined, changed: true };\n }).then(async () => (await this.get(scope, input.key))!);\n } catch (error) {\n // Only the board key's index means the board exists; a lost race on another table is not that.\n if (error instanceof UniqueViolationError && error.collection === BOARDS) {\n throw new StoredBoardError('board_exists', `Board \"${input.key}\" already exists in this project.`);\n }\n throw error;\n }\n }\n\n /** Replaces a board's name, description and phases. The board key never changes. */\n async replace(\n scope: StoredBoardScope,\n key: string,\n input: Omit<StoredBoardInput, 'key'>,\n options: { expectedRevision: number; actor: string },\n ): Promise<StoredBoardRecord> {\n await this.#write(scope, async ops => {\n const row = await findBoard(ops, scope, key);\n checkRevision(row, key, options.expectedRevision);\n await writeBoard(ops, scope, row, { key, ...input }, options.actor);\n return { result: undefined, changed: true };\n });\n return (await this.get(scope, key))!;\n }\n\n /**\n * Stores Factory's boards (Work, app and seed boards) in the project, each key once: a key the\n * project has had before is skipped even if its board was deleted since, and a stored board is\n * never rewritten. A project stored before the list was kept counts the boards it has as stored.\n * Reads one row when every key was stored before. Returns the keys it inserted.\n *\n * A key in `onlyIntoEmpty` is inserted only into a project that has no boards at all: one that\n * already has any board, such as one an app stored under that key, is left as it is. The key\n * is still recorded as stored, so it never goes in later, even after the project's boards are\n * deleted: that project chose its boards, and Work is never added beside or after them. The\n * `intoEmpty` boards (an app's, for every project) go first into a project with no boards, so\n * Factory's own under the same key, or in `onlyIntoEmpty`, then stay out. `actor` is recorded\n * as the inserted boards' creator.\n */\n async seedBoards(\n scope: StoredBoardScope,\n boards: readonly StoredBoardInput[],\n options: { actor?: string; onlyIntoEmpty?: readonly string[]; intoEmpty?: readonly StoredBoardInput[] } = {},\n ): Promise<string[]> {\n const marker = await this.ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope));\n if (marker?.seeded_boards && boards.every(board => marker.seeded_boards!.includes(board.key))) return [];\n return this.#insertOnce(scope, boards, {\n actor: options.actor ?? DEFAULT_INTAKE_ROUTE_ACTOR,\n skipSeeded: true,\n onlyIntoEmpty: options.onlyIntoEmpty ?? [],\n intoEmpty: options.intoEmpty ?? [],\n });\n }\n\n /** The keys of the boards Factory stored in the project; null before it kept the list. */\n async seededBoardKeys(scope: StoredBoardScope): Promise<string[] | null> {\n return (await this.ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope)))?.seeded_boards ?? null;\n }\n\n /**\n * Inserts a board into the project unless one is stored under its key, and records the key as\n * stored, so seeding never adds it again. Unlike seeding, it inserts a key the project deleted.\n * Returns whether it inserted the board.\n */\n async insertIfMissing(scope: StoredBoardScope, board: StoredBoardInput, actor: string): Promise<boolean> {\n return (await this.#insertOnce(scope, [board], { actor, skipSeeded: false })).length > 0;\n }\n\n async #insertOnce(\n scope: StoredBoardScope,\n boards: readonly StoredBoardInput[],\n options: {\n actor: string;\n skipSeeded: boolean;\n onlyIntoEmpty?: readonly string[];\n intoEmpty?: readonly StoredBoardInput[];\n },\n ): Promise<string[]> {\n await ensureVersionRow(this.ops, scope);\n return this.#transact(async ops => {\n const marker = (await ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope)))!;\n const rows = await ops.findMany<BoardRow>(BOARDS, scopeWhere(scope));\n const present = new Set(rows.map(row => row.board_key));\n const seeded = new Set(marker.seeded_boards ?? present);\n // The `intoEmpty` boards go into a project with no boards, first; `onlyIntoEmpty` keys then\n // go in only when nothing is stored yet, so a project holding them gets no default beside them.\n const candidates = [...(rows.length === 0 ? (options.intoEmpty ?? []) : []), ...boards];\n let position = nextPosition(rows);\n const inserted: string[] = [];\n for (const board of candidates) {\n if (present.has(board.key) || (options.skipSeeded && seeded.has(board.key))) continue;\n if (present.size > 0 && options.onlyIntoEmpty?.includes(board.key)) continue;\n await insertBoard(ops, scope, board, { position: position++, actor: options.actor });\n present.add(board.key);\n inserted.push(board.key);\n }\n const next = [...new Set([...seeded, ...candidates.map(board => board.key)])];\n const unchanged = marker.seeded_boards !== null && next.length === marker.seeded_boards.length;\n if (inserted.length === 0 && unchanged) return inserted;\n // Compare-and-set on the version, and every marker write takes a new one: two replicas\n // recording different keys can't both match the version they read, so neither key is lost.\n const updated = await ops.updateMany(\n VERSIONS,\n { ...scopeWhere(scope), version: marker.version },\n {\n seeded_boards: next,\n version: randomUUID(),\n updated_at: new Date(),\n },\n );\n if (updated !== 1) throw new ConcurrentBoardWrite();\n return inserted;\n });\n }\n\n /**\n * Runs each migration the project hasn't had yet, once: the keys applied are recorded on the\n * project's version row in the same transaction as the board writes, and the compare-and-set on\n * its version makes a concurrent first load retry from fresh reads, where it finds them applied.\n * A migration whose board the project doesn't have is recorded without running, and the version\n * only changes when a board was rewritten. Reads one row\n * when every key was applied before. Returns what each migration that rewrote a board filled.\n */\n async applyBoardMigrations(\n scope: StoredBoardScope,\n migrations: readonly StoredBoardMigration[],\n /**\n * Read through the transaction's `ops`, again on every retry, and only when a migration is still\n * pending, so what it reports is as fresh as the boards the migrations rewrite.\n */\n context: (ops: FactoryStorageOps) => Promise<BoardMigrationContext> = async () => EMPTY_MIGRATION_CONTEXT,\n ): Promise<AppliedBoardMigration[]> {\n if (migrations.length === 0) return [];\n const marker = await this.ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope));\n if (marker?.applied_migrations && migrations.every(({ key }) => marker.applied_migrations!.includes(key))) {\n return [];\n }\n await ensureVersionRow(this.ops, scope);\n return this.#transact(async ops => {\n const current = (await ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope)))!;\n const applied = current.applied_migrations ?? [];\n const pending = migrations.filter(({ key }) => !applied.includes(key));\n if (pending.length === 0) return [];\n const project = await context(ops);\n const changed: AppliedBoardMigration[] = [];\n for (const migration of pending) {\n const rows =\n migration.boardKey === null\n ? await ops.findMany<BoardRow>(BOARDS, scopeWhere(scope))\n : await ops.findMany<BoardRow>(BOARDS, { ...scopeWhere(scope), board_key: migration.boardKey });\n for (const row of rows) {\n const phases = await ops.findMany<PhaseRow>(PHASES, { ...scopeWhere(scope), board_key: row.board_key });\n const result = migration.migrate(toRecord(row, phases), project);\n if (!result) continue;\n await writeBoard(ops, scope, row, { ...result.board, key: row.board_key }, MIGRATION_ACTOR);\n changed.push({ key: migration.key, boardKey: row.board_key, filled: result.filled });\n }\n }\n const updated = await ops.updateMany(\n VERSIONS,\n { ...scopeWhere(scope), version: current.version },\n {\n applied_migrations: [...applied, ...pending.map(({ key }) => key)],\n // Only a rewritten board is news to the other replicas' caches.\n version: changed.length > 0 ? randomUUID() : current.version,\n updated_at: new Date(),\n },\n );\n if (updated !== 1) throw new ConcurrentBoardWrite();\n return changed;\n });\n }\n\n /** Rewrites a board to `definition` (Factory's current one for its key), raising its revision. */\n async resetTo(\n scope: StoredBoardScope,\n key: string,\n definition: StoredBoardInput,\n options: { expectedRevision: number; actor: string },\n ): Promise<StoredBoardRecord> {\n await this.#write(scope, async ops => {\n const row = await findBoard(ops, scope, key);\n checkRevision(row, key, options.expectedRevision);\n await writeBoard(ops, scope, row, { ...definition, key }, options.actor);\n return { result: undefined, changed: true };\n });\n return (await this.get(scope, key))!;\n }\n\n /** Deletes a board and its phases. */\n async delete(scope: StoredBoardScope, key: string, options: { expectedRevision: number }): Promise<void> {\n await this.#write(scope, async ops => {\n const row = await findBoard(ops, scope, key);\n checkRevision(row, key, options.expectedRevision);\n if ((await ops.deleteMany(BOARDS, { id: row.id, revision: row.revision })) === 0)\n throw new ConcurrentBoardWrite();\n await ops.deleteMany(PHASES, { ...scopeWhere(scope), board_key: key });\n return { result: undefined, changed: true };\n });\n }\n\n /** The project's intake routes in the order they are tried; Factory's `DEFAULT_INTAKE_ROUTES` are added once each. */\n async listIntakeRoutes(scope: StoredBoardScope): Promise<StoredIntakeRouteRecord[]> {\n await this.#ensureIntakeRoutes(scope);\n return (await readIntakeRoutes(this.ops, scope)).map(toIntakeRouteRecord);\n }\n\n async getIntakeRoute(scope: StoredBoardScope, id: string): Promise<StoredIntakeRouteRecord | null> {\n const row = await this.ops.findOne<IntakeRouteRow>(INTAKE_ROUTES, { ...scopeWhere(scope), id });\n return row ? toIntakeRouteRecord(row) : null;\n }\n\n /**\n * Adds a route after the project's last one. A route that places new cards goes just ahead of the\n * first route that takes every new card instead, since after it it would never place one.\n */\n async createIntakeRoute(\n scope: StoredBoardScope,\n input: StoredIntakeRouteInput,\n actor: string,\n ): Promise<StoredIntakeRouteRecord> {\n const id = randomUUID();\n checkRouteEvents(input.on ?? DEFAULT_ROUTE_EVENTS, input.when ?? null);\n await this.#ensureIntakeRoutes(scope);\n await this.#transact(async ops => {\n const rows = await lockIntakeRoutes(ops, scope);\n if (rows.length >= MAX_INTAKE_ROUTES) {\n throw new StoredBoardError(\n 'intake_route_limit',\n `A project can have at most ${MAX_INTAKE_ROUTES} intake routes; delete one first.`,\n );\n }\n const position = rows.reduce((max, row) => Math.max(max, row.position), -1) + 1;\n await insertIntakeRoute(ops, scope, { id, input, position, actor });\n const ahead = (input.on ?? DEFAULT_ROUTE_EVENTS).includes('work_item.created')\n ? rows.findIndex(catchesEveryNewCard)\n : -1;\n if (ahead >= 0) {\n const added = (await readIntakeRoutes(ops, scope)).find(row => row.id === id)!;\n await placeIntakeRoutes(ops, rows.toSpliced(ahead, 0, added), actor);\n }\n });\n return (await this.getIntakeRoute(scope, id))!;\n }\n\n /** Changes the fields `patch` names; the route keeps its place in the order. */\n async updateIntakeRoute(\n scope: StoredBoardScope,\n id: string,\n patch: Partial<StoredIntakeRouteInput>,\n options: { expectedRevision: number; actor: string },\n ): Promise<StoredIntakeRouteRecord> {\n await this.#transact(async ops => {\n const row = await findIntakeRoute(ops, scope, id);\n checkIntakeRouteRevision(row, options.expectedRevision);\n checkRouteEvents(patch.on ?? routeEvents(row), patch.when !== undefined ? patch.when : row.when_condition);\n await updateIntakeRouteRow(ops, row, {\n ...(patch.on !== undefined && { on_events: patch.on }),\n ...(patch.name !== undefined && { name: patch.name }),\n ...(patch.enabled !== undefined && { enabled: patch.enabled }),\n ...(patch.when !== undefined && { when_condition: patch.when }),\n ...(patch.target !== undefined && {\n board_key: patch.target.boardKey,\n phase_key: patch.target.phaseKey ?? null,\n join_closed_issue: patch.target.joinClosedIssue ?? false,\n }),\n updated_by: options.actor,\n });\n });\n return (await this.getIntakeRoute(scope, id))!;\n }\n\n /** Deletes a route; the routes after it move up one place. */\n async deleteIntakeRoute(scope: StoredBoardScope, id: string, options: { expectedRevision: number }): Promise<void> {\n await this.#ensureIntakeRoutes(scope);\n await this.#transact(async ops => {\n const rows = await lockIntakeRoutes(ops, scope);\n const row = rows.find(route => route.id === id);\n if (!row) throw intakeRouteNotFound(id);\n checkIntakeRouteRevision(row, options.expectedRevision);\n if ((await ops.deleteMany(INTAKE_ROUTES, { id: row.id, revision: row.revision })) === 0) {\n throw new ConcurrentBoardWrite();\n }\n await placeIntakeRoutes(\n ops,\n rows.filter(route => route.id !== row.id),\n );\n });\n }\n\n /** Puts the project's routes in the order of `ids`, which must name every route exactly once. */\n async reorderIntakeRoutes(scope: StoredBoardScope, ids: string[], actor: string): Promise<StoredIntakeRouteRecord[]> {\n await this.#ensureIntakeRoutes(scope);\n await this.#transact(async ops => {\n const rows = await lockIntakeRoutes(ops, scope);\n const byId = new Map(rows.map(row => [row.id, row]));\n if (ids.length !== rows.length || new Set(ids).size !== ids.length || ids.some(id => !byId.has(id))) {\n throw new StoredBoardError(\n 'intake_route_set_mismatch',\n 'The order must list every intake route of the project exactly once; reload the routes and try again.',\n );\n }\n await placeIntakeRoutes(\n ops,\n ids.map(id => byId.get(id)!),\n actor,\n );\n });\n return this.listIntakeRoutes(scope);\n }\n\n /**\n * Creates the project's route lock row (see `FACTORY_INTAKE_ROUTE_LOCKS_SCHEMA`) and adds each of\n * `DEFAULT_INTAKE_ROUTES` the row doesn't list as added yet, after the project's routes. The row\n * records every default it added, so a project whose admin deleted one doesn't get it back. Runs\n * before, never inside, a write's transaction: the lock taken there must always be an update.\n */\n async #ensureIntakeRoutes(scope: StoredBoardScope): Promise<void> {\n const lock = await this.ops.findOne<IntakeRouteLockRow>(INTAKE_ROUTE_LOCKS, scopeWhere(scope));\n if (lock && missingDefaults(lock).length === 0) return;\n await this.#transact(async ops => {\n if (await ops.findOne(INTAKE_ROUTE_LOCKS, scopeWhere(scope))) await lockIntakeRoutes(ops, scope);\n // A racing first read inserted the lock row first: this one fails on the unique index and\n // retries, taking the lock above.\n else\n await ops.insertOne(INTAKE_ROUTE_LOCKS, { ...scopeWhere(scope), locked_at: new Date(), seeded_defaults: [] });\n // Read under the lock: a racing seeder that committed first already added what it listed.\n const current = (await ops.findOne<IntakeRouteLockRow>(INTAKE_ROUTE_LOCKS, scopeWhere(scope)))!;\n const missing = missingDefaults(current);\n if (missing.length === 0) return;\n const rows = await readIntakeRoutes(ops, scope);\n let position = rows.reduce((max, row) => Math.max(max, row.position), -1) + 1;\n const first: string[] = [];\n for (const { route, first: leads } of missing) {\n // A project at the limit keeps its own routes; the default counts as added all the same.\n if (position >= MAX_INTAKE_ROUTES) break;\n const id = randomUUID();\n await insertIntakeRoute(ops, scope, {\n id,\n input: route,\n position: position++,\n actor: DEFAULT_INTAKE_ROUTE_ACTOR,\n });\n if (leads) first.push(id);\n }\n // A project that had routes before gets a leading default ahead of them.\n if (first.length > 0 && rows.length > 0) {\n const placed = await readIntakeRoutes(ops, scope);\n const leading = new Set(first);\n await placeIntakeRoutes(ops, [\n ...first.map(id => placed.find(row => row.id === id)!),\n ...placed.filter(row => !leading.has(row.id)),\n ]);\n }\n await ops.updateMany(INTAKE_ROUTE_LOCKS, scopeWhere(scope), {\n seeded_defaults: [...seededDefaults(current), ...missing.map(({ key }) => key)],\n });\n });\n }\n\n /**\n * Runs `fn` in a transaction and replaces the project's version when it changed anything.\n * Lost races (a compare-and-set miss, or a concurrent write that inserted the same board or the\n * project's first version row) retry from fresh reads.\n */\n async #write<T>(\n scope: StoredBoardScope,\n fn: (ops: FactoryStorageOps) => Promise<{ result: T; changed: boolean }>,\n ): Promise<T> {\n return this.#transact(async ops => {\n const { result, changed } = await fn(ops);\n if (changed) await bumpVersion(ops, scope);\n return result;\n });\n }\n\n /**\n * Runs `fn` in a transaction, retrying lost races from fresh reads. Intake route writes use it\n * directly: routes are read uncached, so they leave the board definition version alone.\n */\n async #transact<T>(fn: (ops: FactoryStorageOps) => Promise<T>): Promise<T> {\n for (let attempt = 1; ; attempt++) {\n try {\n // Read committed is enough: every row change is a compare-and-set on `revision` and every\n // insert meets the unique index. Serializable isolation would also fail writes to\n // unrelated projects that replicas run side by side.\n return await this.storage.withTransaction(fn);\n } catch (error) {\n const retryable = error instanceof ConcurrentBoardWrite || error instanceof UniqueViolationError;\n if (!retryable || attempt >= MAX_WRITE_ATTEMPTS) throw error;\n }\n }\n }\n}\n\nasync function readVersion(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<string | null> {\n const row = await ops.findOne<{ version: string }>(VERSIONS, scopeWhere(scope));\n return row?.version ?? null;\n}\n\nasync function readBoards(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<StoredBoardRecord[]> {\n const [rows, phases] = await Promise.all([\n ops.findMany<BoardRow>(BOARDS, scopeWhere(scope)),\n ops.findMany<PhaseRow>(PHASES, scopeWhere(scope)),\n ]);\n const byBoard = new Map<string, PhaseRow[]>();\n for (const phase of phases) {\n const list = byBoard.get(phase.board_key) ?? [];\n list.push(phase);\n byBoard.set(phase.board_key, list);\n }\n return rows\n .sort((left, right) => left.position - right.position || left.board_key.localeCompare(right.board_key))\n .map(row => toRecord(row, byBoard.get(row.board_key) ?? []));\n}\n\n/**\n * Inserts the project's version row if it has none. This runs outside the write transaction: on\n * Postgres, two transactions racing to insert it would leave the loser's transaction aborted, so\n * the version bump inside a write must always be an update.\n */\nasync function ensureVersionRow(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<void> {\n if (await ops.findOne(VERSIONS, scopeWhere(scope))) return;\n try {\n await ops.insertOne(VERSIONS, { ...scopeWhere(scope), version: randomUUID(), updated_at: new Date() });\n } catch (error) {\n if (!(error instanceof UniqueViolationError)) throw error;\n }\n}\n\nasync function bumpVersion(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<void> {\n await ops.upsertOne(VERSIONS, ['org_id', 'factory_project_id'], {\n ...scopeWhere(scope),\n version: randomUUID(),\n updated_at: new Date(),\n });\n}\n\nasync function findBoard(ops: FactoryStorageOps, scope: StoredBoardScope, key: string): Promise<BoardRow> {\n const row = await ops.findOne<BoardRow>(BOARDS, { ...scopeWhere(scope), board_key: key });\n if (!row) {\n throw new StoredBoardError('board_not_found', `Board \"${key}\" does not exist in this project.`);\n }\n return row;\n}\n\nfunction checkRevision(row: BoardRow, key: string, expectedRevision: number): void {\n if (row.revision !== expectedRevision) {\n throw new StoredBoardError(\n 'revision_mismatch',\n `Board \"${key}\" is at revision ${row.revision}, not ${expectedRevision}; reload it and try again.`,\n );\n }\n}\n\nfunction nextPosition(rows: BoardRow[]): number {\n return rows.reduce((max, row) => Math.max(max, row.position), -1) + 1;\n}\n\n/** Sets columns on a board row and raises its revision, unless another writer changed it first. */\nasync function updateRow(ops: FactoryStorageOps, row: BoardRow, set: Partial<BoardRow>): Promise<void> {\n const updated = await ops.updateMany(\n BOARDS,\n { id: row.id, revision: row.revision },\n { ...set, revision: row.revision + 1, updated_at: new Date() },\n );\n if (updated !== 1) throw new ConcurrentBoardWrite();\n}\n\nasync function insertPhases(ops: FactoryStorageOps, scope: StoredBoardScope, input: StoredBoardInput): Promise<void> {\n for (const [position, phase] of input.phases.entries()) {\n await ops.insertOne<PhaseRow>(PHASES, {\n ...scopeWhere(scope),\n board_key: input.key,\n phase_key: phase.key,\n position,\n name: phase.name,\n description: phase.description ?? null,\n kind: phase.kind,\n runner: phase.runner ?? null,\n next_phases: phase.nextPhases ?? null,\n auto_start: phase.autoStart ?? false,\n auto_start_when: phase.autoStartWhen ?? null,\n exit_tool: phase.exitTool ?? null,\n tools: phase.tools?.length ? phase.tools : null,\n });\n }\n}\n\nasync function insertBoard(\n ops: FactoryStorageOps,\n scope: StoredBoardScope,\n input: StoredBoardInput,\n options: { position: number; actor: string },\n): Promise<void> {\n const now = new Date();\n await ops.insertOne<BoardRow>(BOARDS, {\n ...scopeWhere(scope),\n board_key: input.key,\n name: input.name,\n description: input.description ?? null,\n position: options.position,\n revision: 1,\n created_by: options.actor,\n created_at: now,\n updated_by: options.actor,\n updated_at: now,\n });\n await insertPhases(ops, scope, input);\n}\n\n/** Replaces a board's definition and phases in place, keeping its key, position and history. */\nasync function writeBoard(\n ops: FactoryStorageOps,\n scope: StoredBoardScope,\n row: BoardRow,\n input: StoredBoardInput,\n actor: string,\n): Promise<void> {\n await updateRow(ops, row, { name: input.name, description: input.description ?? null, updated_by: actor });\n await ops.deleteMany(PHASES, { ...scopeWhere(scope), board_key: row.board_key });\n await insertPhases(ops, scope, { ...input, key: row.board_key });\n}\n\nfunction routeEvents(row: IntakeRouteRow): StatusEvent[] {\n return row.on_events ?? [...DEFAULT_ROUTE_EVENTS];\n}\n\nfunction checkRouteEvents(on: readonly string[], when: RuleGroup | null): void {\n const problem = routeEventsProblem(on, when);\n if (problem) throw new StoredBoardError('invalid_intake_route', problem);\n}\n\nfunction toIntakeRouteRecord(row: IntakeRouteRow): StoredIntakeRouteRecord {\n return {\n id: row.id,\n orgId: row.org_id,\n factoryProjectId: row.factory_project_id,\n name: row.name,\n enabled: row.enabled,\n position: row.position,\n when: row.when_condition,\n target: { boardKey: row.board_key, phaseKey: row.phase_key, joinClosedIssue: row.join_closed_issue === true },\n on: routeEvents(row),\n revision: row.revision,\n createdBy: row.created_by,\n createdAt: row.created_at,\n updatedBy: row.updated_by,\n updatedAt: row.updated_at,\n };\n}\n\n/** Whether `row` places every new card that reaches it, as the seeded \"Everything else\" route does. */\nfunction catchesEveryNewCard(row: IntakeRouteRow): boolean {\n return (\n row.enabled &&\n row.when_condition === null &&\n (row.on_events ?? DEFAULT_ROUTE_EVENTS).includes('work_item.created') &&\n !row.join_closed_issue\n );\n}\n\nasync function readIntakeRoutes(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<IntakeRouteRow[]> {\n const rows = await ops.findMany<IntakeRouteRow>(INTAKE_ROUTES, scopeWhere(scope));\n return rows.sort((left, right) => left.position - right.position);\n}\n\nasync function findIntakeRoute(ops: FactoryStorageOps, scope: StoredBoardScope, id: string): Promise<IntakeRouteRow> {\n const row = await ops.findOne<IntakeRouteRow>(INTAKE_ROUTES, { ...scopeWhere(scope), id });\n if (!row) throw intakeRouteNotFound(id);\n return row;\n}\n\nfunction intakeRouteNotFound(id: string): StoredBoardError {\n return new StoredBoardError('intake_route_not_found', `Intake route \"${id}\" does not exist in this project.`);\n}\n\nfunction checkIntakeRouteRevision(row: IntakeRouteRow, expectedRevision: number): void {\n if (row.revision !== expectedRevision) {\n throw new StoredBoardError(\n 'revision_mismatch',\n `Intake route \"${row.name}\" is at revision ${row.revision}, not ${expectedRevision}; reload it and try again.`,\n );\n }\n}\n\n/** Sets columns on a route row and raises its revision, unless another writer changed it first. */\nasync function updateIntakeRouteRow(\n ops: FactoryStorageOps,\n row: IntakeRouteRow,\n set: Partial<IntakeRouteRow>,\n): Promise<number> {\n const revision = row.revision + 1;\n const updated = await ops.updateMany(\n INTAKE_ROUTES,\n { id: row.id, revision: row.revision },\n { ...set, revision, updated_at: new Date() },\n );\n if (updated !== 1) throw new ConcurrentBoardWrite();\n return revision;\n}\n\nasync function insertIntakeRoute(\n ops: FactoryStorageOps,\n scope: StoredBoardScope,\n route: { id: string; input: StoredIntakeRouteInput; position: number; actor: string },\n): Promise<void> {\n const now = new Date();\n await ops.insertOne<IntakeRouteRow>(INTAKE_ROUTES, {\n id: route.id,\n ...scopeWhere(scope),\n name: route.input.name,\n enabled: route.input.enabled ?? true,\n position: route.position,\n when_condition: route.input.when ?? null,\n board_key: route.input.target.boardKey,\n phase_key: route.input.target.phaseKey ?? null,\n on_events: route.input.on ?? null,\n join_closed_issue: route.input.target.joinClosedIssue ?? false,\n revision: 1,\n created_by: route.actor,\n created_at: now,\n updated_by: route.actor,\n updated_at: now,\n });\n}\n\n/**\n * Takes the project's route lock and reads the routes. Writes that add, delete or move routes\n * call this first, so they run one after another and each reads what the one before committed.\n */\nasync function lockIntakeRoutes(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<IntakeRouteRow[]> {\n if ((await ops.updateMany(INTAKE_ROUTE_LOCKS, scopeWhere(scope), { locked_at: new Date() })) !== 1) {\n throw new ConcurrentBoardWrite();\n }\n return readIntakeRoutes(ops, scope);\n}\n\n/** Moves routes, read under the project's route lock, to the positions of their order in `rows`. */\nasync function placeIntakeRoutes(ops: FactoryStorageOps, rows: IntakeRouteRow[], actor?: string): Promise<void> {\n const moving = rows.flatMap((row, position) => (row.position === position ? [] : [{ row, position }]));\n const parked = [];\n for (const [index, { row, position }] of moving.entries()) {\n const revision = await updateIntakeRouteRow(ops, row, {\n position: -(index + 1),\n ...(actor !== undefined && { updated_by: actor }),\n });\n parked.push({ id: row.id, revision, position });\n }\n for (const { id, revision, position } of parked) {\n if ((await ops.updateMany(INTAKE_ROUTES, { id, revision }, { position })) !== 1) throw new ConcurrentBoardWrite();\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"base.js","names":[],"sources":["../../../../src/storage/domains/boards/base.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { FactoryStorageDomain, UniqueViolationError } from '@mastra/core/storage';\nimport type { FactoryStorageOps } from '@mastra/core/storage';\n\nimport { DEFAULT_ROUTE_EVENTS, routeEventsProblem } from '../../../boards/board-events.js';\nimport type { StatusEvent } from '../../../boards/board-events.js';\nimport type { FactoryPhaseTool } from '../../../boards/define-board.js';\nimport { DEFAULT_INTAKE_ROUTES } from '../../../boards/work-routes.js';\nimport type { RuleGroup } from '../../../rules/rule-group.js';\nimport type { RetiredAutomationSettings } from '../projects/base.js';\nimport {\n FACTORY_BOARD_DEFINITION_VERSIONS_SCHEMA,\n FACTORY_BOARD_PHASES_SCHEMA,\n FACTORY_BOARDS_SCHEMA,\n FACTORY_INTAKE_ROUTE_LOCKS_SCHEMA,\n FACTORY_INTAKE_ROUTES_SCHEMA,\n} from './schemas.js';\n\n/** The project a board belongs to. */\nexport interface StoredBoardScope {\n orgId: string;\n factoryProjectId: string;\n}\n\nexport type StoredPhaseKind = 'resting' | 'working' | 'terminal';\n\n/** Who runs a working phase. Factory runs every phase with its code agent. */\nexport interface StoredPhaseRunner {\n skill?: string;\n context?: string;\n instructions?: string;\n /** The objective the phase's runs pursue as a goal. */\n goal?: { objective: string; maxRuns?: number };\n}\n\nexport interface StoredPhaseExitTool {\n id: string;\n autoApprove?: boolean;\n autoApproveWhen?: RuleGroup;\n}\n\n/** A phase as it is written. `key` is the stage id cards sit in. */\nexport interface StoredPhaseInput {\n key: string;\n name: string;\n description?: string | null;\n kind: StoredPhaseKind;\n runner?: StoredPhaseRunner | null;\n /** Unset or `null` on a resting or working phase means every other phase; `[]` means none. */\n nextPhases?: string[] | null;\n autoStart?: boolean;\n autoStartWhen?: RuleGroup | null;\n exitTool?: StoredPhaseExitTool | null;\n /** Factory tools the phase grants the session working the card there. */\n tools?: FactoryPhaseTool[] | null;\n}\n\n/** A board as it is written. Phase order is significant: the first phase is where cards start. */\nexport interface StoredBoardInput {\n key: string;\n name: string;\n description?: string | null;\n phases: StoredPhaseInput[];\n}\n\nexport interface StoredPhaseRecord {\n key: string;\n position: number;\n name: string;\n description: string | null;\n kind: StoredPhaseKind;\n runner: StoredPhaseRunner | null;\n nextPhases: string[] | null;\n autoStart: boolean;\n autoStartWhen: RuleGroup | null;\n exitTool: StoredPhaseExitTool | null;\n tools: FactoryPhaseTool[] | null;\n}\n\nexport interface StoredBoardRecord {\n id: string;\n orgId: string;\n factoryProjectId: string;\n key: string;\n name: string;\n description: string | null;\n position: number;\n revision: number;\n createdBy: string;\n createdAt: Date;\n updatedBy: string;\n updatedAt: Date;\n phases: StoredPhaseRecord[];\n}\n\n/** What a board migration may know about the project besides the board it rewrites. */\nexport interface BoardMigrationContext {\n /** The project switches the boards replaced, as the project last stored them; null when unknown. */\n readonly retiredSettings: RetiredAutomationSettings | null;\n /** The phases of each board that cards sit in, by board key; null when the cards can't be read. */\n readonly occupiedPhases: ReadonlyMap<string, ReadonlySet<string>> | null;\n /**\n * The phases the code board under this key declares; undefined for a board only the project\n * stores. A row that drops one runs without its code rules (`mergeCodeBehaviour`).\n */\n codePhases(boardKey: string): ReadonlySet<string> | undefined;\n /** Tells the operator about a board a migration left as it is. */\n warn(message: string): void;\n}\n\n/** A one-time rewrite of a stored board, keyed so each project gets it once. */\nexport interface StoredBoardMigration {\n key: string;\n /** The board it rewrites; `null` rewrites every board the project stores. */\n boardKey: string | null;\n /** The board to write instead, with what changed; undefined leaves it as it is. */\n migrate(\n board: StoredBoardRecord,\n context: BoardMigrationContext,\n ): { board: Omit<StoredBoardInput, 'key'>; filled: string[] } | undefined;\n}\n\nconst EMPTY_MIGRATION_CONTEXT: BoardMigrationContext = {\n retiredSettings: null,\n occupiedPhases: new Map(),\n codePhases: () => undefined,\n warn: () => {},\n};\n\nexport interface AppliedBoardMigration {\n key: string;\n boardKey: string;\n filled: string[];\n}\n\nexport interface StoredBoardSnapshot {\n version: string | null;\n boards: StoredBoardRecord[];\n}\n\nexport interface IntakeRouteTarget {\n boardKey: string;\n /**\n * Unset lands the card in the board's first phase. On a route that joins a closed issue's\n * card, the phase that card moves to when its board allows it; unset leaves it where it is.\n */\n phaseKey?: string | null;\n /**\n * Files a pull request on the card of the issue it closes, which must be on `boardKey`, as one\n * more source instead of a card of its own. The route doesn't match any other arrival.\n */\n joinClosedIssue?: boolean;\n}\n\n/** An intake route as it is written. */\nexport interface StoredIntakeRouteInput {\n name: string;\n enabled?: boolean;\n /** Null matches every card. */\n when?: RuleGroup | null;\n target: IntakeRouteTarget;\n /** The status events the route handles; unset handles new cards (`work_item.created`). */\n on?: StatusEvent[];\n}\n\nexport interface StoredIntakeRouteRecord {\n id: string;\n orgId: string;\n factoryProjectId: string;\n name: string;\n enabled: boolean;\n position: number;\n when: RuleGroup | null;\n target: { boardKey: string; phaseKey: string | null; joinClosedIssue: boolean };\n on: StatusEvent[];\n revision: number;\n createdBy: string;\n createdAt: Date;\n updatedBy: string;\n updatedAt: Date;\n}\n\nexport type StoredBoardErrorCode =\n | 'board_exists'\n | 'board_not_found'\n | 'revision_mismatch'\n | 'intake_route_not_found'\n | 'intake_route_set_mismatch'\n | 'intake_route_limit'\n | 'invalid_intake_route';\n\n/** A project's most intake routes; a reorder names every one of them. */\nexport const MAX_INTAKE_ROUTES = 100;\n\n// Work's routes are its seed data, kept with the board they target.\nexport {\n DEFAULT_INTAKE_ROUTE,\n PULL_REQUEST_INTAKE_ROUTE,\n CLOSED_COMPLETED_ROUTE,\n CLOSED_CANCELED_ROUTE,\n REOPENED_ROUTE,\n PULL_REQUEST_MERGED_ROUTE,\n PULL_REQUEST_CLOSED_ROUTE,\n PULL_REQUEST_CLOSED_ISSUE_ROUTE,\n PULL_REQUEST_UPDATED_ROUTE,\n PULL_REQUEST_REVIEW_REQUESTED_ROUTE,\n CLOSES_ISSUE_INTAKE_ROUTE,\n CATCH_ALL_INTAKE_ROUTE,\n DEFAULT_INTAKE_ROUTES,\n} from '../../../boards/work-routes.js';\n\n/** The defaults a project whose lock row predates `seeded_defaults` was set up with. */\nconst ORIGINAL_DEFAULT_KEYS = ['outside-authors'];\n\n/** Who the default intake routes are created and last updated by. */\nexport const DEFAULT_INTAKE_ROUTE_ACTOR = 'factory';\n\nexport class StoredBoardError extends Error {\n override name = 'StoredBoardError';\n constructor(\n readonly code: StoredBoardErrorCode,\n message: string,\n ) {\n super(message);\n }\n}\n\ninterface BoardRow extends Record<string, unknown> {\n id: string;\n org_id: string;\n factory_project_id: string;\n board_key: string;\n name: string;\n description: string | null;\n position: number;\n revision: number;\n created_by: string;\n created_at: Date;\n updated_by: string;\n updated_at: Date;\n}\n\ninterface VersionRow extends Record<string, unknown> {\n version: string;\n /** Keys of the boards Factory stored in the project; null on rows written before the list. */\n seeded_boards: string[] | null;\n /** Keys of the board migrations applied to the project; null before the first one. */\n applied_migrations: string[] | null;\n}\n\ninterface PhaseRow extends Record<string, unknown> {\n id: string;\n org_id: string;\n factory_project_id: string;\n board_key: string;\n phase_key: string;\n position: number;\n name: string;\n description: string | null;\n kind: StoredPhaseKind;\n runner: StoredPhaseRunner | null;\n next_phases: string[] | null;\n auto_start: boolean;\n auto_start_when: RuleGroup | null;\n exit_tool: StoredPhaseExitTool | null;\n tools: FactoryPhaseTool[] | null;\n}\n\ninterface IntakeRouteRow extends Record<string, unknown> {\n id: string;\n org_id: string;\n factory_project_id: string;\n name: string;\n enabled: boolean;\n position: number;\n when_condition: RuleGroup | null;\n board_key: string;\n phase_key: string | null;\n /** Null on rows written before routes named events: they place new cards. */\n on_events: StatusEvent[] | null;\n join_closed_issue: boolean | null;\n revision: number;\n created_by: string;\n created_at: Date;\n updated_by: string;\n updated_at: Date;\n}\n\ninterface IntakeRouteLockRow extends Record<string, unknown> {\n /** Keys of the `DEFAULT_INTAKE_ROUTES` added to the project; null on rows written before the list. */\n seeded_defaults: string[] | null;\n}\n\nfunction seededDefaults(lock: IntakeRouteLockRow): string[] {\n return lock.seeded_defaults ?? ORIGINAL_DEFAULT_KEYS;\n}\n\nfunction missingDefaults(lock: IntakeRouteLockRow): (typeof DEFAULT_INTAKE_ROUTES)[number][] {\n const seeded = new Set(seededDefaults(lock));\n return DEFAULT_INTAKE_ROUTES.filter(({ key }) => !seeded.has(key));\n}\n\nconst BOARDS = 'factory_boards';\nconst PHASES = 'factory_board_phases';\nconst VERSIONS = 'factory_board_definition_versions';\nconst INTAKE_ROUTES = 'factory_intake_routes';\nconst INTAKE_ROUTE_LOCKS = 'factory_intake_route_locks';\nconst MAX_WRITE_ATTEMPTS = 3;\nconst MIGRATION_ACTOR = 'factory';\n\nfunction scopeWhere({ orgId, factoryProjectId }: StoredBoardScope) {\n return { org_id: orgId, factory_project_id: factoryProjectId };\n}\n\nfunction toPhaseRecord(row: PhaseRow): StoredPhaseRecord {\n return {\n key: row.phase_key,\n position: row.position,\n name: row.name,\n description: row.description,\n kind: row.kind,\n runner: row.runner,\n nextPhases: row.next_phases,\n autoStart: row.auto_start,\n autoStartWhen: row.auto_start_when,\n exitTool: row.exit_tool,\n tools: row.tools ?? null,\n };\n}\n\nfunction toRecord(row: BoardRow, phases: PhaseRow[]): StoredBoardRecord {\n return {\n id: row.id,\n orgId: row.org_id,\n factoryProjectId: row.factory_project_id,\n key: row.board_key,\n name: row.name,\n description: row.description,\n position: row.position,\n revision: row.revision,\n createdBy: row.created_by,\n createdAt: row.created_at,\n updatedBy: row.updated_by,\n updatedAt: row.updated_at,\n phases: phases.sort((left, right) => left.position - right.position).map(toPhaseRecord),\n };\n}\n\n/** Runs inside a board write's transaction, before the board is written. */\nexport type BoardWriteStep = (ops: FactoryStorageOps) => Promise<void>;\n\n/** A compare-and-set inside a write lost to a concurrent writer; the write is retried from fresh reads. */\nclass ConcurrentBoardWrite extends Error {}\n\n/**\n * Each project's boards and their ordered phases. Every write runs in one transaction that also\n * replaces the project's row in `factory_board_definition_versions`, so caches on other\n * replicas can detect it.\n */\nexport class StoredBoardsStorage extends FactoryStorageDomain {\n constructor() {\n super('boards');\n }\n\n async init(): Promise<void> {\n await this.ensureCollections([\n FACTORY_BOARDS_SCHEMA,\n FACTORY_BOARD_PHASES_SCHEMA,\n FACTORY_BOARD_DEFINITION_VERSIONS_SCHEMA,\n FACTORY_INTAKE_ROUTES_SCHEMA,\n FACTORY_INTAKE_ROUTE_LOCKS_SCHEMA,\n ]);\n }\n\n async dangerouslyClearAll(): Promise<void> {\n await this.ops.deleteMany(PHASES, {});\n await this.ops.deleteMany(BOARDS, {});\n await this.ops.deleteMany(VERSIONS, {});\n await this.ops.deleteMany(INTAKE_ROUTES, {});\n await this.ops.deleteMany(INTAKE_ROUTE_LOCKS, {});\n }\n\n /** The project's current definition version; null before its first board write. */\n async readVersion(scope: StoredBoardScope): Promise<string | null> {\n return readVersion(this.ops, scope);\n }\n\n /** The project's boards in order. */\n async list(scope: StoredBoardScope): Promise<StoredBoardRecord[]> {\n return readBoards(this.ops, scope);\n }\n\n /**\n * The version and the boards, read in that order: a write landing between the two reads leaves a\n * version older than the rows, so a cache keyed on it rereads on its next check instead of\n * keeping the stale rows.\n */\n async snapshot(scope: StoredBoardScope): Promise<StoredBoardSnapshot> {\n const version = await readVersion(this.ops, scope);\n return { version, boards: await this.list(scope) };\n }\n\n get(scope: StoredBoardScope, key: string): Promise<StoredBoardRecord | null> {\n return readStoredBoard(this.ops, scope, key);\n }\n\n /**\n * Creates a board through the API. `before` runs in the same transaction, once the key is known\n * to be free. A row under the key that `over` accepts does not hold it: the board is written\n * over that row.\n */\n async create(\n scope: StoredBoardScope,\n input: StoredBoardInput,\n actor: string,\n before?: BoardWriteStep,\n over?: (row: StoredBoardRecord) => boolean,\n ): Promise<StoredBoardRecord> {\n await ensureVersionRow(this.ops, scope);\n try {\n return await this.#write(scope, async ops => {\n const rows = await ops.findMany<BoardRow>(BOARDS, scopeWhere(scope));\n const taken = rows.find(row => row.board_key === input.key);\n const stored = taken && over ? await readStoredBoard(ops, scope, input.key) : null;\n if (taken && !(stored && over?.(stored))) {\n throw new StoredBoardError('board_exists', `Board \"${input.key}\" already exists in this project.`);\n }\n await before?.(ops);\n if (taken) await writeBoard(ops, scope, taken, input, actor);\n else await insertBoard(ops, scope, input, { position: nextPosition(rows), actor });\n return { result: undefined, changed: true };\n }).then(async () => (await this.get(scope, input.key))!);\n } catch (error) {\n // Only the board key's index means the board exists; a lost race on another table is not that.\n if (error instanceof UniqueViolationError && error.collection === BOARDS) {\n throw new StoredBoardError('board_exists', `Board \"${input.key}\" already exists in this project.`);\n }\n throw error;\n }\n }\n\n /** Replaces a board's name, description and phases. The board key never changes. */\n async replace(\n scope: StoredBoardScope,\n key: string,\n input: Omit<StoredBoardInput, 'key'>,\n options: { expectedRevision: number; actor: string; before?: BoardWriteStep },\n ): Promise<StoredBoardRecord> {\n await this.#write(scope, async ops => {\n const row = await findBoard(ops, scope, key);\n checkRevision(row, key, options.expectedRevision);\n await options.before?.(ops);\n await writeBoard(ops, scope, row, { key, ...input }, options.actor);\n return { result: undefined, changed: true };\n });\n return (await this.get(scope, key))!;\n }\n\n /**\n * Stores Factory's boards (Work, app and seed boards) in the project, each key once: a key the\n * project has had before is skipped even if its board was deleted since, and a stored board is\n * never rewritten. A project stored before the list was kept counts the boards it has as stored.\n * Reads one row when every key was stored before. Returns the keys it inserted.\n *\n * A key in `onlyIntoEmpty` is inserted only into a project that has no boards at all: one that\n * already has any board, such as one an app stored under that key, is left as it is. The key\n * is still recorded as stored, so it never goes in later, even after the project's boards are\n * deleted: that project chose its boards, and Work is never added beside or after them. The\n * `intoEmpty` boards (an app's, for every project) go first into a project with no boards, so\n * Factory's own under the same key, or in `onlyIntoEmpty`, then stay out. `actor` is recorded\n * as the inserted boards' creator. `before` runs in the same\n * transaction ahead of each board it inserts.\n */\n async seedBoards(\n scope: StoredBoardScope,\n boards: readonly StoredBoardInput[],\n options: {\n actor?: string;\n onlyIntoEmpty?: readonly string[];\n intoEmpty?: readonly StoredBoardInput[];\n before?: (ops: FactoryStorageOps, key: string) => Promise<void>;\n } = {},\n ): Promise<string[]> {\n const marker = await this.ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope));\n if (marker?.seeded_boards && boards.every(board => marker.seeded_boards!.includes(board.key))) return [];\n return this.#insertOnce(scope, boards, {\n actor: options.actor ?? DEFAULT_INTAKE_ROUTE_ACTOR,\n skipSeeded: true,\n onlyIntoEmpty: options.onlyIntoEmpty ?? [],\n intoEmpty: options.intoEmpty ?? [],\n before: options.before,\n });\n }\n\n /** The keys of the boards Factory stored in the project; null before it kept the list. */\n async seededBoardKeys(scope: StoredBoardScope): Promise<string[] | null> {\n return (await this.ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope)))?.seeded_boards ?? null;\n }\n\n /**\n * Rewrites the board stored under `seed.key` to `seed` at its next revision when `when` says the\n * row is nobody's: one an earlier release seeded for a board Factory no longer has, under a key\n * the app now defines. `before` runs in the same transaction. Returns whether it rewrote the row.\n */\n async adoptSeed(\n scope: StoredBoardScope,\n seed: StoredBoardInput,\n options: { when: (row: StoredBoardRecord) => boolean; before?: BoardWriteStep },\n ): Promise<boolean> {\n return this.#write(scope, async ops => {\n const stored = await readStoredBoard(ops, scope, seed.key);\n if (!stored || !options.when(stored)) return { result: false, changed: false };\n await options.before?.(ops);\n await writeBoard(ops, scope, await findBoard(ops, scope, seed.key), seed, DEFAULT_INTAKE_ROUTE_ACTOR);\n return { result: true, changed: true };\n });\n }\n\n /**\n * Inserts a board into the project unless one is stored under its key, and records the key as\n * stored, so seeding never adds it again. Unlike seeding, it inserts a key the project deleted.\n * Returns whether it inserted the board. `before` runs in the same transaction when it does.\n */\n async insertIfMissing(\n scope: StoredBoardScope,\n board: StoredBoardInput,\n actor: string,\n before?: BoardWriteStep,\n ): Promise<boolean> {\n return (await this.#insertOnce(scope, [board], { actor, skipSeeded: false, before })).length > 0;\n }\n\n async #insertOnce(\n scope: StoredBoardScope,\n boards: readonly StoredBoardInput[],\n options: {\n actor: string;\n skipSeeded: boolean;\n onlyIntoEmpty?: readonly string[];\n intoEmpty?: readonly StoredBoardInput[];\n before?: (ops: FactoryStorageOps, key: string) => Promise<void>;\n },\n ): Promise<string[]> {\n await ensureVersionRow(this.ops, scope);\n return this.#transact(async ops => {\n const marker = (await ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope)))!;\n const rows = await ops.findMany<BoardRow>(BOARDS, scopeWhere(scope));\n const present = new Set(rows.map(row => row.board_key));\n const seeded = new Set(marker.seeded_boards ?? present);\n // The `intoEmpty` boards go into a project with no boards, first; `onlyIntoEmpty` keys then\n // go in only when nothing is stored yet, so a project holding them gets no default beside them.\n const candidates = [...(rows.length === 0 ? (options.intoEmpty ?? []) : []), ...boards];\n let position = nextPosition(rows);\n const inserted: string[] = [];\n for (const board of candidates) {\n if (present.has(board.key) || (options.skipSeeded && seeded.has(board.key))) continue;\n if (present.size > 0 && options.onlyIntoEmpty?.includes(board.key)) continue;\n await options.before?.(ops, board.key);\n await insertBoard(ops, scope, board, { position: position++, actor: options.actor });\n present.add(board.key);\n inserted.push(board.key);\n }\n const next = [...new Set([...seeded, ...candidates.map(board => board.key)])];\n const unchanged = marker.seeded_boards !== null && next.length === marker.seeded_boards.length;\n if (inserted.length === 0 && unchanged) return inserted;\n // Compare-and-set on the version, and every marker write takes a new one: two replicas\n // recording different keys can't both match the version they read, so neither key is lost.\n const updated = await ops.updateMany(\n VERSIONS,\n { ...scopeWhere(scope), version: marker.version },\n {\n seeded_boards: next,\n version: randomUUID(),\n updated_at: new Date(),\n },\n );\n if (updated !== 1) throw new ConcurrentBoardWrite();\n return inserted;\n });\n }\n\n /**\n * Runs each migration the project hasn't had yet, once: the keys applied are recorded on the\n * project's version row in the same transaction as the board writes, and the compare-and-set on\n * its version makes a concurrent first load retry from fresh reads, where it finds them applied.\n * A migration whose board the project doesn't have is recorded without running, and the version\n * only changes when a board was rewritten. Reads one row\n * when every key was applied before. Returns what each migration that rewrote a board filled.\n */\n async applyBoardMigrations(\n scope: StoredBoardScope,\n migrations: readonly StoredBoardMigration[],\n /**\n * Read through the transaction's `ops`, again on every retry, and only when a migration is still\n * pending, so what it reports is as fresh as the boards the migrations rewrite.\n */\n context: (ops: FactoryStorageOps) => Promise<BoardMigrationContext> = async () => EMPTY_MIGRATION_CONTEXT,\n ): Promise<AppliedBoardMigration[]> {\n if (migrations.length === 0) return [];\n const marker = await this.ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope));\n if (marker?.applied_migrations && migrations.every(({ key }) => marker.applied_migrations!.includes(key))) {\n return [];\n }\n await ensureVersionRow(this.ops, scope);\n return this.#transact(async ops => {\n const current = (await ops.findOne<VersionRow>(VERSIONS, scopeWhere(scope)))!;\n const applied = current.applied_migrations ?? [];\n const pending = migrations.filter(({ key }) => !applied.includes(key));\n if (pending.length === 0) return [];\n const project = await context(ops);\n const changed: AppliedBoardMigration[] = [];\n for (const migration of pending) {\n const rows =\n migration.boardKey === null\n ? await ops.findMany<BoardRow>(BOARDS, scopeWhere(scope))\n : await ops.findMany<BoardRow>(BOARDS, { ...scopeWhere(scope), board_key: migration.boardKey });\n for (const row of rows) {\n const phases = await ops.findMany<PhaseRow>(PHASES, { ...scopeWhere(scope), board_key: row.board_key });\n const result = migration.migrate(toRecord(row, phases), project);\n if (!result) continue;\n await writeBoard(ops, scope, row, { ...result.board, key: row.board_key }, MIGRATION_ACTOR);\n changed.push({ key: migration.key, boardKey: row.board_key, filled: result.filled });\n }\n }\n const updated = await ops.updateMany(\n VERSIONS,\n { ...scopeWhere(scope), version: current.version },\n {\n applied_migrations: [...applied, ...pending.map(({ key }) => key)],\n // Only a rewritten board is news to the other replicas' caches.\n version: changed.length > 0 ? randomUUID() : current.version,\n updated_at: new Date(),\n },\n );\n if (updated !== 1) throw new ConcurrentBoardWrite();\n return changed;\n });\n }\n\n /** Rewrites a board to `definition` (Factory's current one for its key), raising its revision. */\n async resetTo(\n scope: StoredBoardScope,\n key: string,\n definition: StoredBoardInput,\n options: { expectedRevision: number; actor: string },\n ): Promise<StoredBoardRecord> {\n await this.#write(scope, async ops => {\n const row = await findBoard(ops, scope, key);\n checkRevision(row, key, options.expectedRevision);\n await writeBoard(ops, scope, row, { ...definition, key }, options.actor);\n return { result: undefined, changed: true };\n });\n return (await this.get(scope, key))!;\n }\n\n /** Deletes a board and its phases. */\n async delete(scope: StoredBoardScope, key: string, options: { expectedRevision: number }): Promise<void> {\n await this.#write(scope, async ops => {\n const row = await findBoard(ops, scope, key);\n checkRevision(row, key, options.expectedRevision);\n if ((await ops.deleteMany(BOARDS, { id: row.id, revision: row.revision })) === 0)\n throw new ConcurrentBoardWrite();\n await ops.deleteMany(PHASES, { ...scopeWhere(scope), board_key: key });\n return { result: undefined, changed: true };\n });\n }\n\n /** The project's intake routes in the order they are tried; Factory's `DEFAULT_INTAKE_ROUTES` are added once each. */\n async listIntakeRoutes(scope: StoredBoardScope): Promise<StoredIntakeRouteRecord[]> {\n await this.#ensureIntakeRoutes(scope);\n return (await readIntakeRoutes(this.ops, scope)).map(toIntakeRouteRecord);\n }\n\n async getIntakeRoute(scope: StoredBoardScope, id: string): Promise<StoredIntakeRouteRecord | null> {\n const row = await this.ops.findOne<IntakeRouteRow>(INTAKE_ROUTES, { ...scopeWhere(scope), id });\n return row ? toIntakeRouteRecord(row) : null;\n }\n\n /**\n * Adds a route after the project's last one. A route that places new cards goes just ahead of the\n * first route that takes every new card instead, since after it it would never place one.\n */\n async createIntakeRoute(\n scope: StoredBoardScope,\n input: StoredIntakeRouteInput,\n actor: string,\n ): Promise<StoredIntakeRouteRecord> {\n const id = randomUUID();\n checkRouteEvents(input.on ?? DEFAULT_ROUTE_EVENTS, input.when ?? null);\n await this.#ensureIntakeRoutes(scope);\n await this.#transact(async ops => {\n const rows = await lockIntakeRoutes(ops, scope);\n if (rows.length >= MAX_INTAKE_ROUTES) {\n throw new StoredBoardError(\n 'intake_route_limit',\n `A project can have at most ${MAX_INTAKE_ROUTES} intake routes; delete one first.`,\n );\n }\n const position = rows.reduce((max, row) => Math.max(max, row.position), -1) + 1;\n await insertIntakeRoute(ops, scope, { id, input, position, actor });\n const ahead = (input.on ?? DEFAULT_ROUTE_EVENTS).includes('work_item.created')\n ? rows.findIndex(catchesEveryNewCard)\n : -1;\n if (ahead >= 0) {\n const added = (await readIntakeRoutes(ops, scope)).find(row => row.id === id)!;\n await placeIntakeRoutes(ops, rows.toSpliced(ahead, 0, added), actor);\n }\n });\n return (await this.getIntakeRoute(scope, id))!;\n }\n\n /** Changes the fields `patch` names; the route keeps its place in the order. */\n async updateIntakeRoute(\n scope: StoredBoardScope,\n id: string,\n patch: Partial<StoredIntakeRouteInput>,\n options: { expectedRevision: number; actor: string },\n ): Promise<StoredIntakeRouteRecord> {\n await this.#transact(async ops => {\n const row = await findIntakeRoute(ops, scope, id);\n checkIntakeRouteRevision(row, options.expectedRevision);\n checkRouteEvents(patch.on ?? routeEvents(row), patch.when !== undefined ? patch.when : row.when_condition);\n await updateIntakeRouteRow(ops, row, {\n ...(patch.on !== undefined && { on_events: patch.on }),\n ...(patch.name !== undefined && { name: patch.name }),\n ...(patch.enabled !== undefined && { enabled: patch.enabled }),\n ...(patch.when !== undefined && { when_condition: patch.when }),\n ...(patch.target !== undefined && {\n board_key: patch.target.boardKey,\n phase_key: patch.target.phaseKey ?? null,\n join_closed_issue: patch.target.joinClosedIssue ?? false,\n }),\n updated_by: options.actor,\n });\n });\n return (await this.getIntakeRoute(scope, id))!;\n }\n\n /** Deletes a route; the routes after it move up one place. */\n async deleteIntakeRoute(scope: StoredBoardScope, id: string, options: { expectedRevision: number }): Promise<void> {\n await this.#ensureIntakeRoutes(scope);\n await this.#transact(async ops => {\n const rows = await lockIntakeRoutes(ops, scope);\n const row = rows.find(route => route.id === id);\n if (!row) throw intakeRouteNotFound(id);\n checkIntakeRouteRevision(row, options.expectedRevision);\n if ((await ops.deleteMany(INTAKE_ROUTES, { id: row.id, revision: row.revision })) === 0) {\n throw new ConcurrentBoardWrite();\n }\n await placeIntakeRoutes(\n ops,\n rows.filter(route => route.id !== row.id),\n );\n });\n }\n\n /** Puts the project's routes in the order of `ids`, which must name every route exactly once. */\n async reorderIntakeRoutes(scope: StoredBoardScope, ids: string[], actor: string): Promise<StoredIntakeRouteRecord[]> {\n await this.#ensureIntakeRoutes(scope);\n await this.#transact(async ops => {\n const rows = await lockIntakeRoutes(ops, scope);\n const byId = new Map(rows.map(row => [row.id, row]));\n if (ids.length !== rows.length || new Set(ids).size !== ids.length || ids.some(id => !byId.has(id))) {\n throw new StoredBoardError(\n 'intake_route_set_mismatch',\n 'The order must list every intake route of the project exactly once; reload the routes and try again.',\n );\n }\n await placeIntakeRoutes(\n ops,\n ids.map(id => byId.get(id)!),\n actor,\n );\n });\n return this.listIntakeRoutes(scope);\n }\n\n /**\n * Creates the project's route lock row (see `FACTORY_INTAKE_ROUTE_LOCKS_SCHEMA`) and adds each of\n * `DEFAULT_INTAKE_ROUTES` the row doesn't list as added yet, after the project's routes. The row\n * records every default it added, so a project whose admin deleted one doesn't get it back. Runs\n * before, never inside, a write's transaction: the lock taken there must always be an update.\n */\n async #ensureIntakeRoutes(scope: StoredBoardScope): Promise<void> {\n const lock = await this.ops.findOne<IntakeRouteLockRow>(INTAKE_ROUTE_LOCKS, scopeWhere(scope));\n if (lock && missingDefaults(lock).length === 0) return;\n await this.#transact(async ops => {\n if (await ops.findOne(INTAKE_ROUTE_LOCKS, scopeWhere(scope))) await lockIntakeRoutes(ops, scope);\n // A racing first read inserted the lock row first: this one fails on the unique index and\n // retries, taking the lock above.\n else\n await ops.insertOne(INTAKE_ROUTE_LOCKS, { ...scopeWhere(scope), locked_at: new Date(), seeded_defaults: [] });\n // Read under the lock: a racing seeder that committed first already added what it listed.\n const current = (await ops.findOne<IntakeRouteLockRow>(INTAKE_ROUTE_LOCKS, scopeWhere(scope)))!;\n const missing = missingDefaults(current);\n if (missing.length === 0) return;\n const rows = await readIntakeRoutes(ops, scope);\n let position = rows.reduce((max, row) => Math.max(max, row.position), -1) + 1;\n const first: string[] = [];\n for (const { route, first: leads } of missing) {\n // A project at the limit keeps its own routes; the default counts as added all the same.\n if (position >= MAX_INTAKE_ROUTES) break;\n const id = randomUUID();\n await insertIntakeRoute(ops, scope, {\n id,\n input: route,\n position: position++,\n actor: DEFAULT_INTAKE_ROUTE_ACTOR,\n });\n if (leads) first.push(id);\n }\n // A project that had routes before gets a leading default ahead of them.\n if (first.length > 0 && rows.length > 0) {\n const placed = await readIntakeRoutes(ops, scope);\n const leading = new Set(first);\n await placeIntakeRoutes(ops, [\n ...first.map(id => placed.find(row => row.id === id)!),\n ...placed.filter(row => !leading.has(row.id)),\n ]);\n }\n await ops.updateMany(INTAKE_ROUTE_LOCKS, scopeWhere(scope), {\n seeded_defaults: [...seededDefaults(current), ...missing.map(({ key }) => key)],\n });\n });\n }\n\n /**\n * Runs `fn` in a transaction and replaces the project's version when it changed anything.\n * Lost races (a compare-and-set miss, or a concurrent write that inserted the same board or the\n * project's first version row) retry from fresh reads.\n */\n async #write<T>(\n scope: StoredBoardScope,\n fn: (ops: FactoryStorageOps) => Promise<{ result: T; changed: boolean }>,\n ): Promise<T> {\n return this.#transact(async ops => {\n const { result, changed } = await fn(ops);\n if (changed) await bumpVersion(ops, scope);\n return result;\n });\n }\n\n /**\n * Runs `fn` in a transaction, retrying lost races from fresh reads. Intake route writes use it\n * directly: routes are read uncached, so they leave the board definition version alone.\n */\n async #transact<T>(fn: (ops: FactoryStorageOps) => Promise<T>): Promise<T> {\n for (let attempt = 1; ; attempt++) {\n try {\n // Read committed is enough: every row change is a compare-and-set on `revision` and every\n // insert meets the unique index. Serializable isolation would also fail writes to\n // unrelated projects that replicas run side by side.\n return await this.storage.withTransaction(fn);\n } catch (error) {\n const retryable = error instanceof ConcurrentBoardWrite || error instanceof UniqueViolationError;\n if (!retryable || attempt >= MAX_WRITE_ATTEMPTS) throw error;\n }\n }\n }\n}\n\nasync function readVersion(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<string | null> {\n const row = await ops.findOne<{ version: string }>(VERSIONS, scopeWhere(scope));\n return row?.version ?? null;\n}\n\n/** The project's board under `key`, read through `ops` so a caller inside a transaction reads within it. */\nexport async function readStoredBoard(\n ops: FactoryStorageOps,\n scope: StoredBoardScope,\n key: string,\n): Promise<StoredBoardRecord | null> {\n const row = await ops.findOne<BoardRow>(BOARDS, { ...scopeWhere(scope), board_key: key });\n if (!row) return null;\n const phases = await ops.findMany<PhaseRow>(PHASES, { ...scopeWhere(scope), board_key: key });\n return toRecord(row, phases);\n}\n\nasync function readBoards(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<StoredBoardRecord[]> {\n const [rows, phases] = await Promise.all([\n ops.findMany<BoardRow>(BOARDS, scopeWhere(scope)),\n ops.findMany<PhaseRow>(PHASES, scopeWhere(scope)),\n ]);\n const byBoard = new Map<string, PhaseRow[]>();\n for (const phase of phases) {\n const list = byBoard.get(phase.board_key) ?? [];\n list.push(phase);\n byBoard.set(phase.board_key, list);\n }\n return rows\n .sort((left, right) => left.position - right.position || left.board_key.localeCompare(right.board_key))\n .map(row => toRecord(row, byBoard.get(row.board_key) ?? []));\n}\n\n/**\n * Inserts the project's version row if it has none. This runs outside the write transaction: on\n * Postgres, two transactions racing to insert it would leave the loser's transaction aborted, so\n * the version bump inside a write must always be an update.\n */\nasync function ensureVersionRow(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<void> {\n if (await ops.findOne(VERSIONS, scopeWhere(scope))) return;\n try {\n await ops.insertOne(VERSIONS, { ...scopeWhere(scope), version: randomUUID(), updated_at: new Date() });\n } catch (error) {\n if (!(error instanceof UniqueViolationError)) throw error;\n }\n}\n\nasync function bumpVersion(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<void> {\n await ops.upsertOne(VERSIONS, ['org_id', 'factory_project_id'], {\n ...scopeWhere(scope),\n version: randomUUID(),\n updated_at: new Date(),\n });\n}\n\nasync function findBoard(ops: FactoryStorageOps, scope: StoredBoardScope, key: string): Promise<BoardRow> {\n const row = await ops.findOne<BoardRow>(BOARDS, { ...scopeWhere(scope), board_key: key });\n if (!row) {\n throw new StoredBoardError('board_not_found', `Board \"${key}\" does not exist in this project.`);\n }\n return row;\n}\n\nfunction checkRevision(row: BoardRow, key: string, expectedRevision: number): void {\n if (row.revision !== expectedRevision) {\n throw new StoredBoardError(\n 'revision_mismatch',\n `Board \"${key}\" is at revision ${row.revision}, not ${expectedRevision}; reload it and try again.`,\n );\n }\n}\n\nfunction nextPosition(rows: BoardRow[]): number {\n return rows.reduce((max, row) => Math.max(max, row.position), -1) + 1;\n}\n\n/** Sets columns on a board row and raises its revision, unless another writer changed it first. */\nasync function updateRow(ops: FactoryStorageOps, row: BoardRow, set: Partial<BoardRow>): Promise<void> {\n const updated = await ops.updateMany(\n BOARDS,\n { id: row.id, revision: row.revision },\n { ...set, revision: row.revision + 1, updated_at: new Date() },\n );\n if (updated !== 1) throw new ConcurrentBoardWrite();\n}\n\nasync function insertPhases(ops: FactoryStorageOps, scope: StoredBoardScope, input: StoredBoardInput): Promise<void> {\n for (const [position, phase] of input.phases.entries()) {\n await ops.insertOne<PhaseRow>(PHASES, {\n ...scopeWhere(scope),\n board_key: input.key,\n phase_key: phase.key,\n position,\n name: phase.name,\n description: phase.description ?? null,\n kind: phase.kind,\n runner: phase.runner ?? null,\n next_phases: phase.nextPhases ?? null,\n auto_start: phase.autoStart ?? false,\n auto_start_when: phase.autoStartWhen ?? null,\n exit_tool: phase.exitTool ?? null,\n tools: phase.tools?.length ? phase.tools : null,\n });\n }\n}\n\nasync function insertBoard(\n ops: FactoryStorageOps,\n scope: StoredBoardScope,\n input: StoredBoardInput,\n options: { position: number; actor: string },\n): Promise<void> {\n const now = new Date();\n await ops.insertOne<BoardRow>(BOARDS, {\n ...scopeWhere(scope),\n board_key: input.key,\n name: input.name,\n description: input.description ?? null,\n position: options.position,\n revision: 1,\n created_by: options.actor,\n created_at: now,\n updated_by: options.actor,\n updated_at: now,\n });\n await insertPhases(ops, scope, input);\n}\n\n/** Replaces a board's definition and phases in place, keeping its key, position and history. */\nasync function writeBoard(\n ops: FactoryStorageOps,\n scope: StoredBoardScope,\n row: BoardRow,\n input: StoredBoardInput,\n actor: string,\n): Promise<void> {\n await updateRow(ops, row, { name: input.name, description: input.description ?? null, updated_by: actor });\n await ops.deleteMany(PHASES, { ...scopeWhere(scope), board_key: row.board_key });\n await insertPhases(ops, scope, { ...input, key: row.board_key });\n}\n\nfunction routeEvents(row: IntakeRouteRow): StatusEvent[] {\n return row.on_events ?? [...DEFAULT_ROUTE_EVENTS];\n}\n\nfunction checkRouteEvents(on: readonly string[], when: RuleGroup | null): void {\n const problem = routeEventsProblem(on, when);\n if (problem) throw new StoredBoardError('invalid_intake_route', problem);\n}\n\nfunction toIntakeRouteRecord(row: IntakeRouteRow): StoredIntakeRouteRecord {\n return {\n id: row.id,\n orgId: row.org_id,\n factoryProjectId: row.factory_project_id,\n name: row.name,\n enabled: row.enabled,\n position: row.position,\n when: row.when_condition,\n target: { boardKey: row.board_key, phaseKey: row.phase_key, joinClosedIssue: row.join_closed_issue === true },\n on: routeEvents(row),\n revision: row.revision,\n createdBy: row.created_by,\n createdAt: row.created_at,\n updatedBy: row.updated_by,\n updatedAt: row.updated_at,\n };\n}\n\n/** Whether `row` places every new card that reaches it, as the seeded \"Everything else\" route does. */\nfunction catchesEveryNewCard(row: IntakeRouteRow): boolean {\n return (\n row.enabled &&\n row.when_condition === null &&\n (row.on_events ?? DEFAULT_ROUTE_EVENTS).includes('work_item.created') &&\n !row.join_closed_issue\n );\n}\n\nasync function readIntakeRoutes(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<IntakeRouteRow[]> {\n const rows = await ops.findMany<IntakeRouteRow>(INTAKE_ROUTES, scopeWhere(scope));\n return rows.sort((left, right) => left.position - right.position);\n}\n\nasync function findIntakeRoute(ops: FactoryStorageOps, scope: StoredBoardScope, id: string): Promise<IntakeRouteRow> {\n const row = await ops.findOne<IntakeRouteRow>(INTAKE_ROUTES, { ...scopeWhere(scope), id });\n if (!row) throw intakeRouteNotFound(id);\n return row;\n}\n\nfunction intakeRouteNotFound(id: string): StoredBoardError {\n return new StoredBoardError('intake_route_not_found', `Intake route \"${id}\" does not exist in this project.`);\n}\n\nfunction checkIntakeRouteRevision(row: IntakeRouteRow, expectedRevision: number): void {\n if (row.revision !== expectedRevision) {\n throw new StoredBoardError(\n 'revision_mismatch',\n `Intake route \"${row.name}\" is at revision ${row.revision}, not ${expectedRevision}; reload it and try again.`,\n );\n }\n}\n\n/** Sets columns on a route row and raises its revision, unless another writer changed it first. */\nasync function updateIntakeRouteRow(\n ops: FactoryStorageOps,\n row: IntakeRouteRow,\n set: Partial<IntakeRouteRow>,\n): Promise<number> {\n const revision = row.revision + 1;\n const updated = await ops.updateMany(\n INTAKE_ROUTES,\n { id: row.id, revision: row.revision },\n { ...set, revision, updated_at: new Date() },\n );\n if (updated !== 1) throw new ConcurrentBoardWrite();\n return revision;\n}\n\nasync function insertIntakeRoute(\n ops: FactoryStorageOps,\n scope: StoredBoardScope,\n route: { id: string; input: StoredIntakeRouteInput; position: number; actor: string },\n): Promise<void> {\n const now = new Date();\n await ops.insertOne<IntakeRouteRow>(INTAKE_ROUTES, {\n id: route.id,\n ...scopeWhere(scope),\n name: route.input.name,\n enabled: route.input.enabled ?? true,\n position: route.position,\n when_condition: route.input.when ?? null,\n board_key: route.input.target.boardKey,\n phase_key: route.input.target.phaseKey ?? null,\n on_events: route.input.on ?? null,\n join_closed_issue: route.input.target.joinClosedIssue ?? false,\n revision: 1,\n created_by: route.actor,\n created_at: now,\n updated_by: route.actor,\n updated_at: now,\n });\n}\n\n/**\n * Takes the project's route lock and reads the routes. Writes that add, delete or move routes\n * call this first, so they run one after another and each reads what the one before committed.\n */\nasync function lockIntakeRoutes(ops: FactoryStorageOps, scope: StoredBoardScope): Promise<IntakeRouteRow[]> {\n if ((await ops.updateMany(INTAKE_ROUTE_LOCKS, scopeWhere(scope), { locked_at: new Date() })) !== 1) {\n throw new ConcurrentBoardWrite();\n }\n return readIntakeRoutes(ops, scope);\n}\n\n/** Moves routes, read under the project's route lock, to the positions of their order in `rows`. */\nasync function placeIntakeRoutes(ops: FactoryStorageOps, rows: IntakeRouteRow[], actor?: string): Promise<void> {\n const moving = rows.flatMap((row, position) => (row.position === position ? [] : [{ row, position }]));\n const parked = [];\n for (const [index, { row, position }] of moving.entries()) {\n const revision = await updateIntakeRouteRow(ops, row, {\n position: -(index + 1),\n ...(actor !== undefined && { updated_by: actor }),\n });\n parked.push({ id: row.id, revision, position });\n }\n for (const { id, revision, position } of parked) {\n if ((await ops.updateMany(INTAKE_ROUTES, { id, revision }, { position })) !== 1) throw new ConcurrentBoardWrite();\n }\n}\n"],"mappings":"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"}
@@ -13,7 +13,7 @@ import type { FactoryTriageType } from '../../../rules/types.js';
13
13
  import type { WorkItemSplitReport } from '../../../work-items/split-migration.js';
14
14
  import type { BoardScope } from './board-version.js';
15
15
  import type { FactoryClaimableWorkScope } from './claimable-work.js';
16
- import type { ReviewBoardScope } from './legacy-review.js';
16
+ import type { ReviewBoardInUse, ReviewBoardScope } from './legacy-review.js';
17
17
  import type { WorkItemRow as ProviderWorkItemRow, WorkItemDbRecord, WorkItemSourceDbRecord, WorkItemSourceRow } from './work-item-schema.js';
18
18
  export type { FactoryClaimableWorkScope } from './claimable-work.js';
19
19
  export type WorkItemStage = string;
@@ -544,11 +544,24 @@ export declare class WorkItemsStorage extends FactoryStorageDomain {
544
544
  get legacyMode(): boolean;
545
545
  get legacyBackfillPending(): boolean;
546
546
  /**
547
- * Whether the project still uses the retired Review board: it holds a card stored on Review
548
- * that isn't Done or Canceled. Such a project keeps the board and its cards stay on it; in any
549
- * other project Review is redundant and its cards read as Work.
547
+ * Tells cards apart from the retired Review board's: where `owned` answers true the project has
548
+ * a board of its own under `review`, and the cards stored on it are that board's.
549
+ */
550
+ useOwnReviewBoard(owned: ReviewBoardInUse): void;
551
+ /**
552
+ * Whether cards stored on `review` stay there: the project has a board of its own under that
553
+ * key, or still uses the retired Review board (it holds a card stored on Review that isn't Done
554
+ * or Canceled) and keeps it. In any other project Review is redundant and its cards read as Work.
550
555
  */
551
556
  reviewBoardInUse(scope: ReviewBoardScope): Promise<boolean>;
557
+ /**
558
+ * Leaves `review` to a board about to take it: stores the Work placement of the cards the
559
+ * retired Review board left there, through `ops`, so it happens in the board write's
560
+ * transaction. See {@link releaseLegacyReviewCards} for `open`.
561
+ */
562
+ releaseReviewCards(ops: FactoryStorageOps, scope: ReviewBoardScope, { open }: {
563
+ open: 'refuse' | 'move';
564
+ }): Promise<void>;
552
565
  constructor();
553
566
  /**
554
567
  * Wired once at boot. Fires after a committed write changes what a board shows of a card