@storyshelf/core 0.6.2 → 0.7.0

package/dist/models/baseline.d.mts

@@ -7,27 +7,54 @@ import { WebhookTables } from "./webhook.mjs";
 import { Baseline } from "../schema/baseline.mjs";
 import { Table } from "drizzle-orm";
 //#region src/models/baseline.d.ts
+/** Extra identity/metadata for {@link BaselineModel.upsert}. */
+interface BaselineUpsertOptions {
+  /** Engine the baseline belongs to (default chromium). */
+  browser?: string;
+  /** Resolved mode definition as JSON (display only). */
+  mode?: string | null;
+  /** JSON `Fingerprint` behind the `infraHash` being written. */
+  fingerprint?: string | null;
+}
 /** Tables required by {@link BaselineModel}. */
 interface BaselineTables {
   baselines: Table;
 }
 /** Data operations for baseline screenshots. */
 declare class BaselineModel {
-  private readonly db;
+  #private;
   private readonly tables;
   private readonly storage;
   private readonly secret?;
   private readonly webhookTables?;
+  private readonly db;
   constructor(db: DatabaseAdapter, tables?: BaselineTables, storage?: StorageAdapter, secret?: SecretInput, webhookTables?: WebhookTables);
-  getFor(projectId: string, storyId: string, viewport: string, branch: string): Promise<Baseline | null>;
-  resolve(projectId: string, storyId: string, viewport: string, branch: string, defaultBranch: string): Promise<Baseline | null>;
+  getFor(projectId: string, storyId: string, viewport: string, branch: string, browser?: string): Promise<Baseline | null>;
+  resolve(projectId: string, storyId: string, viewport: string, branch: string, defaultBranch: string, browser?: string): Promise<Baseline | null>;
+  /** Whether the project has any baseline captured on this engine. */
+  hasAny(projectId: string, browser: string): Promise<boolean>;
+  /**
+   * Record the fingerprint of a baseline that predates fingerprints, without touching its
+   * screenshot. Lets the next environment change be detected instead of diffing as a regression.
+   */
+  backfillFingerprint(baseline: Baseline, infraHash: string, fingerprint: string): Promise<void>;
+  /**
+   * The content-addressed object a baseline should point at. A source that already is one is
+   * reused as is (no copy); a legacy per-build path is stored once by content.
+   */
+  private contentFor;
   read(baseline: Baseline): Promise<Buffer>;
-  upsert(projectId: string, storyId: string, viewport: string, branch: string, snapshotId: string, sourcePath: string, infraHash?: string | null): Promise<Baseline>;
+  upsert(projectId: string, storyId: string, viewport: string, branch: string, snapshotId: string, sourcePath: string, infraHash?: string | null, options?: BaselineUpsertOptions): Promise<Baseline>;
   list(projectId: string): Promise<Baseline[]>;
+  /**
+   * Delete a baseline's own file. A content-addressed screenshot is shared with snapshots and other
+   * baselines, so it is left for the retention sweep instead.
+   */
+  private discardFile;
   removeOrphans(projectId: string, validStoryIds: Set<string>): Promise<number>;
   removeForBranch(projectId: string, branch: string): Promise<number>;
   removeStaleBranches(projectId: string, staleBranches: ReadonlySet<string>): Promise<number>;
 }
 //#endregion
-export { BaselineModel, BaselineTables };
+export { BaselineModel, BaselineTables, BaselineUpsertOptions };
 //# sourceMappingURL=baseline.d.mts.map

package/dist/models/baseline.mjs

@@ -1,19 +1,22 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { DEFAULT_BROWSER } from "../adapters/capture-target.mjs";
 import { ulid } from "../utils/ulid.mjs";
+import { col } from "./columns.mjs";
 import { emitWebhookEvent } from "../adapter/webhook-events.mjs";
-import { baselinePath } from "../paths.mjs";
-import { and, eq, getTableColumns } from "drizzle-orm";
+import { isContentPath } from "../paths.mjs";
+import { storeScreenshot, withContentClaim } from "../utils/screenshot-store.mjs";
+import { and, eq } from "drizzle-orm";
 //#region src/models/baseline.ts
 /** Per-branch baseline screenshots with default-branch fallback. */
 /** Data operations for baseline screenshots. */
 var BaselineModel = class {
-	db;
 	tables;
 	storage;
 	secret;
 	webhookTables;
+	db;
 	constructor(db, tables, storage, secret, webhookTables) {
 		this.db = db;
 		this.tables = tables ?? { baselines: db.tables.baselines };
@@ -21,39 +24,70 @@ var BaselineModel = class {
 		this.secret = secret;
 		this.webhookTables = webhookTables;
 	}
-	async getFor(projectId, storyId, viewport, branch) {
+	async getFor(projectId, storyId, viewport, branch, browser = DEFAULT_BROWSER) {
 		return (await this.db.list(this.tables.baselines, {
-			where: and(eq(getTableColumns(this.tables.baselines)["projectId"], projectId), eq(getTableColumns(this.tables.baselines)["storyId"], storyId), eq(getTableColumns(this.tables.baselines)["viewportName"], viewport), eq(getTableColumns(this.tables.baselines)["branch"], branch)),
+			where: and(eq(col(this.tables.baselines, "projectId"), projectId), eq(col(this.tables.baselines, "storyId"), storyId), eq(col(this.tables.baselines, "viewportName"), viewport), eq(col(this.tables.baselines, "branch"), branch), eq(col(this.tables.baselines, "browser"), browser)),
 			limit: 1
 		}))[0] ?? null;
 	}
-	async resolve(projectId, storyId, viewport, branch, defaultBranch) {
+	async resolve(projectId, storyId, viewport, branch, defaultBranch, browser = DEFAULT_BROWSER) {
 		if (branch !== defaultBranch) {
-			const own = await this.getFor(projectId, storyId, viewport, branch);
+			const own = await this.getFor(projectId, storyId, viewport, branch, browser);
 			if (own) return own;
 		}
-		return this.getFor(projectId, storyId, viewport, defaultBranch);
+		return this.getFor(projectId, storyId, viewport, defaultBranch, browser);
+	}
+	/** Whether the project has any baseline captured on this engine. */
+	async hasAny(projectId, browser) {
+		return (await this.db.list(this.tables.baselines, {
+			where: and(eq(col(this.tables.baselines, "projectId"), projectId), eq(col(this.tables.baselines, "browser"), browser)),
+			limit: 1
+		})).length > 0;
+	}
+	/**
+	* Record the fingerprint of a baseline that predates fingerprints, without touching its
+	* screenshot. Lets the next environment change be detected instead of diffing as a regression.
+	*/
+	async backfillFingerprint(baseline, infraHash, fingerprint) {
+		await this.db.update(this.tables.baselines, baseline.id, {
+			infraHash,
+			fingerprint
+		});
+	}
+	/**
+	* The content-addressed object a baseline should point at. A source that already is one is
+	* reused as is (no copy); a legacy per-build path is stored once by content.
+	*/
+	async contentFor(projectId, sourcePath) {
+		if (isContentPath(projectId, sourcePath)) return sourcePath;
+		return await storeScreenshot(this.storage, projectId, await this.storage.read(sourcePath));
 	}
 	async read(baseline) {
 		return await this.storage.read(baseline.screenshotPath);
 	}
-	async upsert(projectId, storyId, viewport, branch, snapshotId, sourcePath, infraHash) {
-		const screenshotPath = baselinePath(projectId, branch, storyId, viewport);
-		const source = await this.storage.read(sourcePath);
-		await this.storage.write(screenshotPath, source);
-		const existing = await this.getFor(projectId, storyId, viewport, branch);
+	async upsert(projectId, storyId, viewport, branch, snapshotId, sourcePath, infraHash, options = {}) {
+		const write = async () => await this.#upsertAt(projectId, storyId, viewport, branch, snapshotId, await this.contentFor(projectId, sourcePath), infraHash, options);
+		return isContentPath(projectId, sourcePath) ? await write() : await withContentClaim(this.storage, projectId, write);
+	}
+	async #upsertAt(projectId, storyId, viewport, branch, snapshotId, screenshotPath, infraHash, options) {
+		const browser = options.browser ?? "chromium";
+		const existing = await this.getFor(projectId, storyId, viewport, branch, browser);
 		let baseline;
 		if (existing) {
 			baseline = await this.db.update(this.tables.baselines, existing.id, {
 				snapshotId,
 				screenshotPath,
 				infraHash: infraHash ?? existing.infraHash ?? null,
+				fingerprint: options.fingerprint ?? existing.fingerprint ?? null,
+				mode: options.mode ?? existing.mode ?? null,
 				updatedAt: (/* @__PURE__ */ new Date()).toISOString()
 			});
 			if (this.webhookTables) await emitWebhookEvent(this.db, this.webhookTables, projectId, "baseline:updated", {
 				baselineId: baseline.id,
 				storyId,
 				viewport,
+				browser,
+				mode: options.mode ?? null,
 				branch,
 				snapshotId
 			}, this.secret);
@@ -68,6 +102,9 @@ var BaselineModel = class {
 				snapshotId,
 				screenshotPath,
 				infraHash: infraHash ?? null,
+				fingerprint: options.fingerprint ?? null,
+				mode: options.mode ?? null,
+				browser,
 				createdAt: now,
 				updatedAt: now
 			});
@@ -75,6 +112,8 @@ var BaselineModel = class {
 				baselineId: baseline.id,
 				storyId,
 				viewport,
+				browser,
+				mode: options.mode ?? null,
 				branch,
 				snapshotId
 			}, this.secret);
@@ -82,14 +121,22 @@ var BaselineModel = class {
 		return baseline;
 	}
 	async list(projectId) {
-		return await this.db.list(this.tables.baselines, { where: eq(getTableColumns(this.tables.baselines)["projectId"], projectId) });
+		return await this.db.list(this.tables.baselines, { where: eq(col(this.tables.baselines, "projectId"), projectId) });
+	}
+	/**
+	* Delete a baseline's own file. A content-addressed screenshot is shared with snapshots and other
+	* baselines, so it is left for the retention sweep instead.
+	*/
+	async discardFile(baseline) {
+		if (isContentPath(baseline.projectId, baseline.screenshotPath)) return;
+		try {
+			await this.storage.delete(baseline.screenshotPath);
+		} catch {}
 	}
 	async removeOrphans(projectId, validStoryIds) {
 		const toRemove = (await this.list(projectId)).filter((baseline) => !validStoryIds.has(baseline.storyId));
 		await Promise.all(toRemove.map(async (baseline) => {
-			try {
-				await this.storage.delete(baseline.screenshotPath);
-			} catch {}
+			await this.discardFile(baseline);
 			await this.db.remove(this.tables.baselines, baseline.id);
 		}));
 		return toRemove.length;
@@ -97,9 +144,7 @@ var BaselineModel = class {
 	async removeForBranch(projectId, branch) {
 		const toRemove = (await this.list(projectId)).filter((baseline) => baseline.branch === branch);
 		await Promise.all(toRemove.map(async (baseline) => {
-			try {
-				await this.storage.delete(baseline.screenshotPath);
-			} catch {}
+			await this.discardFile(baseline);
 			await this.db.remove(this.tables.baselines, baseline.id);
 		}));
 		return toRemove.length;

package/dist/models/baseline.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"baseline.mjs","names":[],"sources":["../../src/models/baseline.ts"],"sourcesContent":["/* oxlint-disable typescript/promise-function-async -- map callbacks return promises from async helpers */\n/** Per-branch baseline screenshots with default-branch fallback. */\nimport { and, eq, getTableColumns } from \"drizzle-orm\";\nimport type { SQLWrapper, Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { emitWebhookEvent } from \"../adapters/webhook-events.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { baselinePath } from \"../utils/paths.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport type { WebhookTables } from \"./webhook.ts\";\n\n/** Tables required by {@link BaselineModel}. */\nexport interface BaselineTables {\n  baselines: Table;\n}\n\n/** Data operations for baseline screenshots. */\nexport class BaselineModel {\n  private readonly tables: BaselineTables;\n  private readonly storage: StorageAdapter;\n  private readonly secret?: SecretInput;\n  private readonly webhookTables?: WebhookTables;\n  constructor(\n    private readonly db: DatabaseAdapter,\n    tables?: BaselineTables,\n    storage?: StorageAdapter,\n    secret?: SecretInput,\n    webhookTables?: WebhookTables,\n  ) {\n    this.tables = tables ?? { baselines: db.tables.baselines };\n    this.storage = storage as StorageAdapter;\n    this.secret = secret;\n    this.webhookTables = webhookTables;\n  }\n\n  async getFor(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n  ): Promise<Baseline | null> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(getTableColumns(this.tables.baselines)[\"projectId\"] as unknown as SQLWrapper, projectId),\n        eq(getTableColumns(this.tables.baselines)[\"storyId\"] as unknown as SQLWrapper, storyId),\n        eq(\n          getTableColumns(this.tables.baselines)[\"viewportName\"] as unknown as SQLWrapper,\n          viewport,\n        ),\n        eq(getTableColumns(this.tables.baselines)[\"branch\"] as unknown as SQLWrapper, branch),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows[0] ?? null;\n  }\n\n  async resolve(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    defaultBranch: string,\n  ): Promise<Baseline | null> {\n    if (branch !== defaultBranch) {\n      const own = await this.getFor(projectId, storyId, viewport, branch);\n      if (own) {\n        return own;\n      }\n    }\n    return this.getFor(projectId, storyId, viewport, defaultBranch);\n  }\n\n  async read(baseline: Baseline): Promise<Buffer> {\n    return await this.storage.read(baseline.screenshotPath);\n  }\n\n  async upsert(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    sourcePath: string,\n    infraHash?: string | null,\n  ): Promise<Baseline> {\n    const screenshotPath = baselinePath(projectId, branch, storyId, viewport);\n    const source = await this.storage.read(sourcePath);\n    await this.storage.write(screenshotPath, source);\n\n    const existing = await this.getFor(projectId, storyId, viewport, branch);\n    let baseline: Baseline;\n    if (existing) {\n      baseline = (await this.db.update(this.tables.baselines, existing.id, {\n        snapshotId,\n        screenshotPath,\n        infraHash: infraHash ?? existing.infraHash ?? null,\n        updatedAt: new Date().toISOString(),\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:updated\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    } else {\n      const now = new Date().toISOString();\n      baseline = (await this.db.insert(this.tables.baselines, {\n        id: ulid(),\n        projectId,\n        storyId,\n        viewportName: viewport,\n        branch,\n        snapshotId,\n        screenshotPath,\n        infraHash: infraHash ?? null,\n        createdAt: now,\n        updatedAt: now,\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:created\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    }\n    return baseline;\n  }\n\n  async list(projectId: string): Promise<Baseline[]> {\n    return (await this.db.list(this.tables.baselines, {\n      where: eq(\n        getTableColumns(this.tables.baselines)[\"projectId\"] as unknown as SQLWrapper,\n        projectId,\n      ),\n    })) as unknown as Baseline[];\n  }\n\n  async removeOrphans(projectId: string, validStoryIds: Set<string>): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => !validStoryIds.has(baseline.storyId));\n    await Promise.all(\n      toRemove.map(async (baseline) => {\n        try {\n          await this.storage.delete(baseline.screenshotPath);\n        } catch {\n          // ignore missing file\n        }\n        await this.db.remove(this.tables.baselines, baseline.id);\n      }),\n    );\n    return toRemove.length;\n  }\n\n  async removeForBranch(projectId: string, branch: string): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => baseline.branch === branch);\n    await Promise.all(\n      toRemove.map(async (baseline) => {\n        try {\n          await this.storage.delete(baseline.screenshotPath);\n        } catch {\n          // ignore missing file\n        }\n        await this.db.remove(this.tables.baselines, baseline.id);\n      }),\n    );\n    return toRemove.length;\n  }\n\n  // oxlint-disable-next-line eslint/require-await -- delegates to async removeForBranch via Promise.all\n  async removeStaleBranches(\n    projectId: string,\n    staleBranches: ReadonlySet<string>,\n  ): Promise<number> {\n    if (staleBranches.size === 0) {\n      return 0;\n    }\n    const results = await Promise.all(\n      [...staleBranches].map((branch) => this.removeForBranch(projectId, branch)),\n    );\n    return results.reduce((sum, count) => sum + count, 0);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"baseline.mjs","names":[],"sources":["../../src/models/baseline.ts"],"sourcesContent":["/* oxlint-disable typescript/promise-function-async -- map callbacks return promises from async helpers */\n/** Per-branch baseline screenshots with default-branch fallback. */\nimport { and, eq } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport { DEFAULT_BROWSER } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { emitWebhookEvent } from \"../adapters/webhook-events.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { isContentPath } from \"../utils/paths.ts\";\nimport { storeScreenshot, withContentClaim } from \"../utils/screenshot-store.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\nimport type { WebhookTables } from \"./webhook.ts\";\n\n/** Extra identity/metadata for {@link BaselineModel.upsert}. */\nexport interface BaselineUpsertOptions {\n  /** Engine the baseline belongs to (default chromium). */\n  browser?: string;\n  /** Resolved mode definition as JSON (display only). */\n  mode?: string | null;\n  /** JSON `Fingerprint` behind the `infraHash` being written. */\n  fingerprint?: string | null;\n}\n\n/** Tables required by {@link BaselineModel}. */\nexport interface BaselineTables {\n  baselines: Table;\n}\n\n/** Data operations for baseline screenshots. */\nexport class BaselineModel {\n  private readonly tables: BaselineTables;\n  private readonly storage: StorageAdapter;\n  private readonly secret?: SecretInput;\n  private readonly webhookTables?: WebhookTables;\n  private readonly db: DatabaseAdapter;\n\n  constructor(\n    db: DatabaseAdapter,\n    tables?: BaselineTables,\n    storage?: StorageAdapter,\n    secret?: SecretInput,\n    webhookTables?: WebhookTables,\n  ) {\n    this.db = db;\n    this.tables = tables ?? { baselines: db.tables.baselines };\n    this.storage = storage as StorageAdapter;\n    this.secret = secret;\n    this.webhookTables = webhookTables;\n  }\n\n  async getFor(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<Baseline | null> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(col(this.tables.baselines, \"projectId\"), projectId),\n        eq(col(this.tables.baselines, \"storyId\"), storyId),\n        eq(col(this.tables.baselines, \"viewportName\"), viewport),\n        eq(col(this.tables.baselines, \"branch\"), branch),\n        eq(col(this.tables.baselines, \"browser\"), browser),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows[0] ?? null;\n  }\n\n  async resolve(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    defaultBranch: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<Baseline | null> {\n    if (branch !== defaultBranch) {\n      const own = await this.getFor(projectId, storyId, viewport, branch, browser);\n      if (own) {\n        return own;\n      }\n    }\n    return this.getFor(projectId, storyId, viewport, defaultBranch, browser);\n  }\n\n  /** Whether the project has any baseline captured on this engine. */\n  async hasAny(projectId: string, browser: string): Promise<boolean> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(col(this.tables.baselines, \"projectId\"), projectId),\n        eq(col(this.tables.baselines, \"browser\"), browser),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows.length > 0;\n  }\n\n  /**\n   * Record the fingerprint of a baseline that predates fingerprints, without touching its\n   * screenshot. Lets the next environment change be detected instead of diffing as a regression.\n   */\n  async backfillFingerprint(\n    baseline: Baseline,\n    infraHash: string,\n    fingerprint: string,\n  ): Promise<void> {\n    await this.db.update(this.tables.baselines, baseline.id, { infraHash, fingerprint });\n  }\n\n  /**\n   * The content-addressed object a baseline should point at. A source that already is one is\n   * reused as is (no copy); a legacy per-build path is stored once by content.\n   */\n  private async contentFor(projectId: string, sourcePath: string): Promise<string> {\n    if (isContentPath(projectId, sourcePath)) {\n      return sourcePath;\n    }\n    return await storeScreenshot(this.storage, projectId, await this.storage.read(sourcePath));\n  }\n\n  async read(baseline: Baseline): Promise<Buffer> {\n    return await this.storage.read(baseline.screenshotPath);\n  }\n\n  async upsert(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    sourcePath: string,\n    infraHash?: string | null,\n    options: BaselineUpsertOptions = {},\n  ): Promise<Baseline> {\n    const write = async (): Promise<Baseline> =>\n      await this.#upsertAt(\n        projectId,\n        storyId,\n        viewport,\n        branch,\n        snapshotId,\n        await this.contentFor(projectId, sourcePath),\n        infraHash,\n        options,\n      );\n    // Storing a legacy source may reuse an object the sweep is about to delete: claim it until the\n    // row points at it. A content source is already referenced by its snapshot row.\n    return isContentPath(projectId, sourcePath)\n      ? await write()\n      : await withContentClaim(this.storage, projectId, write);\n  }\n\n  async #upsertAt(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    screenshotPath: string,\n    infraHash: string | null | undefined,\n    options: BaselineUpsertOptions,\n  ): Promise<Baseline> {\n    const browser = options.browser ?? DEFAULT_BROWSER;\n\n    const existing = await this.getFor(projectId, storyId, viewport, branch, browser);\n    let baseline: Baseline;\n    if (existing) {\n      baseline = (await this.db.update(this.tables.baselines, existing.id, {\n        snapshotId,\n        screenshotPath,\n        infraHash: infraHash ?? existing.infraHash ?? null,\n        fingerprint: options.fingerprint ?? existing.fingerprint ?? null,\n        mode: options.mode ?? existing.mode ?? null,\n        updatedAt: new Date().toISOString(),\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:updated\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    } else {\n      const now = new Date().toISOString();\n      baseline = (await this.db.insert(this.tables.baselines, {\n        id: ulid(),\n        projectId,\n        storyId,\n        viewportName: viewport,\n        branch,\n        snapshotId,\n        screenshotPath,\n        infraHash: infraHash ?? null,\n        fingerprint: options.fingerprint ?? null,\n        mode: options.mode ?? null,\n        browser,\n        createdAt: now,\n        updatedAt: now,\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:created\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    }\n    return baseline;\n  }\n\n  async list(projectId: string): Promise<Baseline[]> {\n    return (await this.db.list(this.tables.baselines, {\n      where: eq(col(this.tables.baselines, \"projectId\"), projectId),\n    })) as unknown as Baseline[];\n  }\n\n  /**\n   * Delete a baseline's own file. A content-addressed screenshot is shared with snapshots and other\n   * baselines, so it is left for the retention sweep instead.\n   */\n  private async discardFile(baseline: Baseline): Promise<void> {\n    if (isContentPath(baseline.projectId, baseline.screenshotPath)) {\n      return;\n    }\n    try {\n      await this.storage.delete(baseline.screenshotPath);\n    } catch {\n      // ignore missing file\n    }\n  }\n\n  async removeOrphans(projectId: string, validStoryIds: Set<string>): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => !validStoryIds.has(baseline.storyId));\n    await Promise.all(\n      toRemove.map(async (baseline) => {\n        await this.discardFile(baseline);\n        await this.db.remove(this.tables.baselines, baseline.id);\n      }),\n    );\n    return toRemove.length;\n  }\n\n  async removeForBranch(projectId: string, branch: string): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => baseline.branch === branch);\n    await Promise.all(\n      toRemove.map(async (baseline) => {\n        await this.discardFile(baseline);\n        await this.db.remove(this.tables.baselines, baseline.id);\n      }),\n    );\n    return toRemove.length;\n  }\n\n  // oxlint-disable-next-line eslint/require-await -- delegates to async removeForBranch via Promise.all\n  async removeStaleBranches(\n    projectId: string,\n    staleBranches: ReadonlySet<string>,\n  ): Promise<number> {\n    if (staleBranches.size === 0) {\n      return 0;\n    }\n    const results = await Promise.all(\n      [...staleBranches].map((branch) => this.removeForBranch(projectId, branch)),\n    );\n    return results.reduce((sum, count) => sum + count, 0);\n  }\n}\n"],"mappings":"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"}

package/dist/models/build-component.d.mts

@@ -0,0 +1,28 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "../adapter/database.mjs";
+import { BuildComponent } from "../schema/build-component.mjs";
+import { Table } from "drizzle-orm";
+//#region src/models/build-component.d.ts
+/** Tables required by {@link BuildComponentModel}. */
+interface BuildComponentTables {
+  buildComponents: Table;
+}
+/** What a build records of one component. */
+type BuildComponentInput = Pick<BuildComponent, "importPath" | "title" | "storyCount" | "hash">;
+/** Data operations for the components each published build holds. */
+declare class BuildComponentModel {
+  #private;
+  constructor(db: DatabaseAdapter, tables?: BuildComponentTables);
+  /** Components of one build, ordered by title then file. */
+  listByBuild(buildId: string): Promise<BuildComponent[]>;
+  /** Rows of one story file across the project's builds, newest first: "which builds contain it". */
+  listByImportPath(projectId: string, importPath: string): Promise<BuildComponent[]>;
+  /** Replace a build's rows with `components`; repeating a publish never duplicates. */
+  replaceForBuild(projectId: string, buildId: string, components: readonly BuildComponentInput[]): Promise<void>;
+  /** Forget a build's rows (the foreign key cascades too; stub tables have none). */
+  removeForBuild(buildId: string): Promise<number>;
+}
+//#endregion
+export { BuildComponentInput, BuildComponentModel, BuildComponentTables };
+//# sourceMappingURL=build-component.d.mts.map

package/dist/models/build-component.mjs

@@ -0,0 +1,55 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { ulid } from "../utils/ulid.mjs";
+import { col } from "./columns.mjs";
+import { and, asc, desc, eq } from "drizzle-orm";
+//#region src/models/build-component.ts
+/** Component rows of published builds (`build_components`, ADR 0006 decision 9). */
+/** Data operations for the components each published build holds. */
+var BuildComponentModel = class {
+	#db;
+	#table;
+	constructor(db, tables) {
+		this.#db = db;
+		this.#table = (tables ?? { buildComponents: db.tables.buildComponents }).buildComponents;
+	}
+	/** Components of one build, ordered by title then file. */
+	async listByBuild(buildId) {
+		return (await this.#db.list(this.#table, {
+			where: eq(col(this.#table, "buildId"), buildId),
+			orderBy: asc(col(this.#table, "title"))
+		})).toSorted((a, b) => a.title.localeCompare(b.title) || a.importPath.localeCompare(b.importPath));
+	}
+	/** Rows of one story file across the project's builds, newest first: "which builds contain it". */
+	async listByImportPath(projectId, importPath) {
+		return await this.#db.list(this.#table, {
+			where: and(eq(col(this.#table, "projectId"), projectId), eq(col(this.#table, "importPath"), importPath)),
+			orderBy: desc(col(this.#table, "createdAt"))
+		});
+	}
+	/** Replace a build's rows with `components`; repeating a publish never duplicates. */
+	async replaceForBuild(projectId, buildId, components) {
+		await this.removeForBuild(buildId);
+		const createdAt = (/* @__PURE__ */ new Date()).toISOString();
+		for (const component of components) await this.#db.insert(this.#table, {
+			id: ulid(),
+			projectId,
+			buildId,
+			createdAt,
+			...component
+		});
+	}
+	/** Forget a build's rows (the foreign key cascades too; stub tables have none). */
+	async removeForBuild(buildId) {
+		const rows = await this.#db.list(this.#table, { where: eq(col(this.#table, "buildId"), buildId) });
+		await Promise.all(rows.map(async (row) => {
+			await this.#db.remove(this.#table, row.id);
+		}));
+		return rows.length;
+	}
+};
+//#endregion
+export { BuildComponentModel };
+
+//# sourceMappingURL=build-component.mjs.map

package/dist/models/build-component.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-component.mjs","names":[],"sources":["../../src/models/build-component.ts"],"sourcesContent":["/** Component rows of published builds (`build_components`, ADR 0006 decision 9). */\nimport { and, asc, desc, eq } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { BuildComponent } from \"../schema/build-component.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link BuildComponentModel}. */\nexport interface BuildComponentTables {\n  buildComponents: Table;\n}\n\n/** What a build records of one component. */\nexport type BuildComponentInput = Pick<\n  BuildComponent,\n  \"importPath\" | \"title\" | \"storyCount\" | \"hash\"\n>;\n\n/** Data operations for the components each published build holds. */\nexport class BuildComponentModel {\n  readonly #db: DatabaseAdapter;\n  readonly #table: Table;\n\n  constructor(db: DatabaseAdapter, tables?: BuildComponentTables) {\n    this.#db = db;\n    this.#table = (tables ?? { buildComponents: db.tables.buildComponents }).buildComponents;\n  }\n\n  /** Components of one build, ordered by title then file. */\n  async listByBuild(buildId: string): Promise<BuildComponent[]> {\n    const rows = (await this.#db.list(this.#table, {\n      where: eq(col(this.#table, \"buildId\"), buildId),\n      orderBy: asc(col(this.#table, \"title\")),\n    })) as unknown as BuildComponent[];\n    return rows.toSorted(\n      (a, b) => a.title.localeCompare(b.title) || a.importPath.localeCompare(b.importPath),\n    );\n  }\n\n  /** Rows of one story file across the project's builds, newest first: \"which builds contain it\". */\n  async listByImportPath(projectId: string, importPath: string): Promise<BuildComponent[]> {\n    const rows = (await this.#db.list(this.#table, {\n      where: and(\n        eq(col(this.#table, \"projectId\"), projectId),\n        eq(col(this.#table, \"importPath\"), importPath),\n      ),\n      orderBy: desc(col(this.#table, \"createdAt\")),\n    })) as unknown as BuildComponent[];\n    return rows;\n  }\n\n  /** Replace a build's rows with `components`; repeating a publish never duplicates. */\n  async replaceForBuild(\n    projectId: string,\n    buildId: string,\n    components: readonly BuildComponentInput[],\n  ): Promise<void> {\n    await this.removeForBuild(buildId);\n    const createdAt = new Date().toISOString();\n    for (const component of components) {\n      // eslint-disable-next-line no-await-in-loop -- rows are few; sequential inserts keep ids ordered\n      await this.#db.insert(this.#table, {\n        id: ulid(),\n        projectId,\n        buildId,\n        createdAt,\n        ...component,\n      });\n    }\n  }\n\n  /** Forget a build's rows (the foreign key cascades too; stub tables have none). */\n  async removeForBuild(buildId: string): Promise<number> {\n    const rows = (await this.#db.list(this.#table, {\n      where: eq(col(this.#table, \"buildId\"), buildId),\n    })) as unknown as BuildComponent[];\n    await Promise.all(\n      rows.map(async (row) => {\n        await this.#db.remove(this.#table, row.id);\n      }),\n    );\n    return rows.length;\n  }\n}\n"],"mappings":";;;;;;;;;AAoBA,IAAa,sBAAb,MAAiC;CAC/B;CACA;CAEA,YAAY,IAAqB,QAA+B;EAC9D,KAAK,MAAM;EACX,KAAK,UAAU,UAAU,EAAE,iBAAiB,GAAG,OAAO,gBAAgB,EAAA,CAAG;CAC3E;;CAGA,MAAM,YAAY,SAA4C;EAK5D,QAAO,MAJa,KAAK,IAAI,KAAK,KAAK,QAAQ;GAC7C,OAAO,GAAG,IAAI,KAAK,QAAQ,SAAS,GAAG,OAAO;GAC9C,SAAS,IAAI,IAAI,KAAK,QAAQ,OAAO,CAAC;EACxC,CAAC,EAAA,CACW,UACT,GAAG,MAAM,EAAE,MAAM,cAAc,EAAE,KAAK,KAAK,EAAE,WAAW,cAAc,EAAE,UAAU,CACrF;CACF;;CAGA,MAAM,iBAAiB,WAAmB,YAA+C;EAQvF,OAAO,MAPa,KAAK,IAAI,KAAK,KAAK,QAAQ;GAC7C,OAAO,IACL,GAAG,IAAI,KAAK,QAAQ,WAAW,GAAG,SAAS,GAC3C,GAAG,IAAI,KAAK,QAAQ,YAAY,GAAG,UAAU,CAC/C;GACA,SAAS,KAAK,IAAI,KAAK,QAAQ,WAAW,CAAC;EAC7C,CAAC;CAEH;;CAGA,MAAM,gBACJ,WACA,SACA,YACe;EACf,MAAM,KAAK,eAAe,OAAO;EACjC,MAAM,6BAAY,IAAI,KAAK,EAAA,CAAE,YAAY;EACzC,KAAK,MAAM,aAAa,YAEtB,MAAM,KAAK,IAAI,OAAO,KAAK,QAAQ;GACjC,IAAI,KAAK;GACT;GACA;GACA;GACA,GAAG;EACL,CAAC;CAEL;;CAGA,MAAM,eAAe,SAAkC;EACrD,MAAM,OAAQ,MAAM,KAAK,IAAI,KAAK,KAAK,QAAQ,EAC7C,OAAO,GAAG,IAAI,KAAK,QAAQ,SAAS,GAAG,OAAO,EAChD,CAAC;EACD,MAAM,QAAQ,IACZ,KAAK,IAAI,OAAO,QAAQ;GACtB,MAAM,KAAK,IAAI,OAAO,KAAK,QAAQ,IAAI,EAAE;EAC3C,CAAC,CACH;EACA,OAAO,KAAK;CACd;AACF"}

package/dist/models/build-review-status.d.mts

@@ -0,0 +1,29 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BuildReview } from "../schema/build-review.mjs";
+//#region src/models/build-review-status.d.ts
+/** What {@link deriveReviewStatus} depends on. */
+interface ReviewStatusInput {
+  /** `testing` is on: the snapshot rollup decides and verdicts never gate. */
+  testing: boolean;
+  /** The project's review switch. */
+  review: boolean;
+  /** `projects.review_approvals`: approvals a build needs (at least 1). */
+  approvalsRequired: number;
+  /** Every verdict given to the build, in any order; see {@link latestVerdicts}. */
+  reviews: readonly Pick<BuildReview, "id" | "userId" | "verdict" | "createdAt">[];
+}
+/**
+ * The status the verdicts give the build, or `null` when they do not decide it (`testing` is on,
+ * or review is off and the build was accepted when it was published).
+ *
+ * - `rejected` when any reviewer's latest verdict is `rejected`;
+ * - `approved` once the required approvals are present among the latest verdicts;
+ * - `pending` otherwise.
+ */
+declare function deriveReviewStatus(input: ReviewStatusInput): "approved" | "rejected" | "pending" | null;
+/** Each reviewer's latest verdict (newest `createdAt`, then newest id), oldest reviewer first. */
+declare function latestVerdicts<T extends Pick<BuildReview, "id" | "userId" | "createdAt">>(reviews: readonly T[]): T[];
+//#endregion
+export { ReviewStatusInput, deriveReviewStatus, latestVerdicts };
+//# sourceMappingURL=build-review-status.d.mts.map

package/dist/models/build-review-status.mjs

@@ -0,0 +1,37 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/models/build-review-status.ts
+/** Reviewer key standing for verdicts without a user (auth off or an admin token): one reviewer. */
+const ANONYMOUS_REVIEWER = "";
+/**
+* The status the verdicts give the build, or `null` when they do not decide it (`testing` is on,
+* or review is off and the build was accepted when it was published).
+*
+* - `rejected` when any reviewer's latest verdict is `rejected`;
+* - `approved` once the required approvals are present among the latest verdicts;
+* - `pending` otherwise.
+*/
+function deriveReviewStatus(input) {
+	if (input.testing || !input.review) return null;
+	const latest = latestVerdicts(input.reviews);
+	if (latest.some((review) => review.verdict === "rejected")) return "rejected";
+	return latest.filter((review) => review.verdict === "approved").length >= Math.max(1, input.approvalsRequired) ? "approved" : "pending";
+}
+/** Each reviewer's latest verdict (newest `createdAt`, then newest id), oldest reviewer first. */
+function latestVerdicts(reviews) {
+	const latest = /* @__PURE__ */ new Map();
+	for (const review of reviews) {
+		const key = review.userId ?? ANONYMOUS_REVIEWER;
+		const current = latest.get(key);
+		if (current === void 0 || isNewer(review, current)) latest.set(key, review);
+	}
+	return [...latest.values()].toSorted((a, b) => isNewer(b, a) ? -1 : 1);
+}
+function isNewer(a, b) {
+	return a.createdAt === b.createdAt ? a.id > b.id : a.createdAt > b.createdAt;
+}
+//#endregion
+export { deriveReviewStatus, latestVerdicts };
+
+//# sourceMappingURL=build-review-status.mjs.map

package/dist/models/build-review-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-review-status.mjs","names":[],"sources":["../../src/models/build-review-status.ts"],"sourcesContent":["/**\n * What the build-level verdicts make of a build (ADR 0013, decision 3). Pure: callers read the\n * reviews and the project, apply the result, and stay free of branching.\n */\nimport type { BuildReview } from \"../schema/build-review.ts\";\n\n/** What {@link deriveReviewStatus} depends on. */\nexport interface ReviewStatusInput {\n  /** `testing` is on: the snapshot rollup decides and verdicts never gate. */\n  testing: boolean;\n  /** The project's review switch. */\n  review: boolean;\n  /** `projects.review_approvals`: approvals a build needs (at least 1). */\n  approvalsRequired: number;\n  /** Every verdict given to the build, in any order; see {@link latestVerdicts}. */\n  reviews: readonly Pick<BuildReview, \"id\" | \"userId\" | \"verdict\" | \"createdAt\">[];\n}\n\n/** Reviewer key standing for verdicts without a user (auth off or an admin token): one reviewer. */\nconst ANONYMOUS_REVIEWER = \"\";\n\n/**\n * The status the verdicts give the build, or `null` when they do not decide it (`testing` is on,\n * or review is off and the build was accepted when it was published).\n *\n * - `rejected` when any reviewer's latest verdict is `rejected`;\n * - `approved` once the required approvals are present among the latest verdicts;\n * - `pending` otherwise.\n */\nexport function deriveReviewStatus(\n  input: ReviewStatusInput,\n): \"approved\" | \"rejected\" | \"pending\" | null {\n  if (input.testing || !input.review) {\n    return null;\n  }\n  const latest = latestVerdicts(input.reviews);\n  if (latest.some((review) => review.verdict === \"rejected\")) {\n    return \"rejected\";\n  }\n  const approvals = latest.filter((review) => review.verdict === \"approved\").length;\n  return approvals >= Math.max(1, input.approvalsRequired) ? \"approved\" : \"pending\";\n}\n\n/** Each reviewer's latest verdict (newest `createdAt`, then newest id), oldest reviewer first. */\nexport function latestVerdicts<T extends Pick<BuildReview, \"id\" | \"userId\" | \"createdAt\">>(\n  reviews: readonly T[],\n): T[] {\n  const latest = new Map<string, T>();\n  for (const review of reviews) {\n    const key = review.userId ?? ANONYMOUS_REVIEWER;\n    const current = latest.get(key);\n    if (current === undefined || isNewer(review, current)) {\n      latest.set(key, review);\n    }\n  }\n  return [...latest.values()].toSorted((a, b) => (isNewer(b, a) ? -1 : 1));\n}\n\nfunction isNewer(\n  a: Pick<BuildReview, \"id\" | \"createdAt\">,\n  b: Pick<BuildReview, \"id\" | \"createdAt\">,\n): boolean {\n  return a.createdAt === b.createdAt ? a.id > b.id : a.createdAt > b.createdAt;\n}\n"],"mappings":";;;;;AAmBA,MAAM,qBAAqB;;;;;;;;;AAU3B,SAAgB,mBACd,OAC4C;CAC5C,IAAI,MAAM,WAAW,CAAC,MAAM,QAC1B,OAAO;CAET,MAAM,SAAS,eAAe,MAAM,OAAO;CAC3C,IAAI,OAAO,MAAM,WAAW,OAAO,YAAY,UAAU,GACvD,OAAO;CAGT,OADkB,OAAO,QAAQ,WAAW,OAAO,YAAY,UAAU,CAAC,CAAC,UACvD,KAAK,IAAI,GAAG,MAAM,iBAAiB,IAAI,aAAa;AAC1E;;AAGA,SAAgB,eACd,SACK;CACL,MAAM,yBAAS,IAAI,IAAe;CAClC,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,MAAM,OAAO,UAAU;EAC7B,MAAM,UAAU,OAAO,IAAI,GAAG;EAC9B,IAAI,YAAY,KAAA,KAAa,QAAQ,QAAQ,OAAO,GAClD,OAAO,IAAI,KAAK,MAAM;CAE1B;CACA,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG,MAAO,QAAQ,GAAG,CAAC,IAAI,KAAK,CAAE;AACzE;AAEA,SAAS,QACP,GACA,GACS;CACT,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE;AACrE"}

package/dist/models/build-review.d.mts

@@ -0,0 +1,28 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "../adapter/database.mjs";
+import { ReviewVerdict } from "../types.mjs";
+import { BuildReview } from "../schema/build-review.mjs";
+import { Table } from "drizzle-orm";
+//#region src/models/build-review.d.ts
+/** Tables required by {@link BuildReviewModel}. */
+interface BuildReviewTables {
+  buildReviews: Table;
+}
+/** Data operations for the verdicts reviewers give a build. */
+declare class BuildReviewModel {
+  #private;
+  constructor(db: DatabaseAdapter, tables?: BuildReviewTables);
+  /**
+   * Record a verdict. A reviewer rewrites theirs by adding another row; the newest row counts.
+   * `createdAt` is strictly increasing within a build, so "newest" never ties.
+   */
+  add(buildId: string, userId: string | null, verdict: ReviewVerdict, body?: string): Promise<BuildReview>;
+  /** Every verdict of a build, oldest first. */
+  listByBuild(buildId: string): Promise<BuildReview[]>;
+  /** Each reviewer's latest verdict on a build. */
+  latestByBuild(buildId: string): Promise<BuildReview[]>;
+}
+//#endregion
+export { BuildReviewModel, BuildReviewTables };
+//# sourceMappingURL=build-review.d.mts.map

package/dist/models/build-review.mjs

@@ -0,0 +1,54 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { ulid } from "../utils/ulid.mjs";
+import { col } from "./columns.mjs";
+import { latestVerdicts } from "./build-review-status.mjs";
+import { asc, eq } from "drizzle-orm";
+//#region src/models/build-review.ts
+/** Build-level review verdicts (ADR 0013, decision 3). */
+/** Data operations for the verdicts reviewers give a build. */
+var BuildReviewModel = class {
+	#db;
+	#table;
+	constructor(db, tables) {
+		this.#db = db;
+		this.#table = (tables ?? { buildReviews: db.tables.buildReviews }).buildReviews;
+	}
+	/**
+	* Record a verdict. A reviewer rewrites theirs by adding another row; the newest row counts.
+	* `createdAt` is strictly increasing within a build, so "newest" never ties.
+	*/
+	async add(buildId, userId, verdict, body) {
+		const newest = (await this.listByBuild(buildId)).at(-1)?.createdAt;
+		return await this.#db.insert(this.#table, {
+			id: ulid(),
+			buildId,
+			userId,
+			verdict,
+			body: body === void 0 || body.length === 0 ? null : body,
+			createdAt: after(newest)
+		});
+	}
+	/** Every verdict of a build, oldest first. */
+	async listByBuild(buildId) {
+		return (await this.#db.list(this.#table, {
+			where: eq(col(this.#table, "buildId"), buildId),
+			orderBy: asc(col(this.#table, "createdAt"))
+		})).toSorted((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+	}
+	/** Each reviewer's latest verdict on a build. */
+	async latestByBuild(buildId) {
+		return latestVerdicts(await this.listByBuild(buildId));
+	}
+};
+/** Now, or one millisecond past `newest` when the clock has not moved on. */
+function after(newest) {
+	const now = Date.now();
+	const floor = newest === void 0 ? Number.NEGATIVE_INFINITY : Date.parse(newest) + 1;
+	return new Date(Math.max(now, floor)).toISOString();
+}
+//#endregion
+export { BuildReviewModel };
+
+//# sourceMappingURL=build-review.mjs.map

package/dist/models/build-review.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-review.mjs","names":[],"sources":["../../src/models/build-review.ts"],"sourcesContent":["/** Build-level review verdicts (ADR 0013, decision 3). */\nimport { asc, eq } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { BuildReview } from \"../schema/build-review.ts\";\nimport type { ReviewVerdict } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { latestVerdicts } from \"./build-review-status.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link BuildReviewModel}. */\nexport interface BuildReviewTables {\n  buildReviews: Table;\n}\n\n/** Data operations for the verdicts reviewers give a build. */\nexport class BuildReviewModel {\n  readonly #db: DatabaseAdapter;\n  readonly #table: Table;\n\n  constructor(db: DatabaseAdapter, tables?: BuildReviewTables) {\n    this.#db = db;\n    this.#table = (tables ?? { buildReviews: db.tables.buildReviews }).buildReviews;\n  }\n\n  /**\n   * Record a verdict. A reviewer rewrites theirs by adding another row; the newest row counts.\n   * `createdAt` is strictly increasing within a build, so \"newest\" never ties.\n   */\n  async add(\n    buildId: string,\n    userId: string | null,\n    verdict: ReviewVerdict,\n    body?: string,\n  ): Promise<BuildReview> {\n    const newest = (await this.listByBuild(buildId)).at(-1)?.createdAt;\n    return (await this.#db.insert(this.#table, {\n      id: ulid(),\n      buildId,\n      userId,\n      verdict,\n      body: body === undefined || body.length === 0 ? null : body,\n      createdAt: after(newest),\n    })) as unknown as BuildReview;\n  }\n\n  /** Every verdict of a build, oldest first. */\n  async listByBuild(buildId: string): Promise<BuildReview[]> {\n    const rows = (await this.#db.list(this.#table, {\n      where: eq(col(this.#table, \"buildId\"), buildId),\n      orderBy: asc(col(this.#table, \"createdAt\")),\n    })) as unknown as BuildReview[];\n    return rows.toSorted(\n      (a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id),\n    );\n  }\n\n  /** Each reviewer's latest verdict on a build. */\n  async latestByBuild(buildId: string): Promise<BuildReview[]> {\n    return latestVerdicts(await this.listByBuild(buildId));\n  }\n}\n\n/** Now, or one millisecond past `newest` when the clock has not moved on. */\nfunction after(newest: string | undefined): string {\n  const now = Date.now();\n  const floor = newest === undefined ? Number.NEGATIVE_INFINITY : Date.parse(newest) + 1;\n  return new Date(Math.max(now, floor)).toISOString();\n}\n"],"mappings":";;;;;;;;;;AAgBA,IAAa,mBAAb,MAA8B;CAC5B;CACA;CAEA,YAAY,IAAqB,QAA4B;EAC3D,KAAK,MAAM;EACX,KAAK,UAAU,UAAU,EAAE,cAAc,GAAG,OAAO,aAAa,EAAA,CAAG;CACrE;;;;;CAMA,MAAM,IACJ,SACA,QACA,SACA,MACsB;EACtB,MAAM,UAAU,MAAM,KAAK,YAAY,OAAO,EAAA,CAAG,GAAG,EAAE,CAAC,EAAE;EACzD,OAAQ,MAAM,KAAK,IAAI,OAAO,KAAK,QAAQ;GACzC,IAAI,KAAK;GACT;GACA;GACA;GACA,MAAM,SAAS,KAAA,KAAa,KAAK,WAAW,IAAI,OAAO;GACvD,WAAW,MAAM,MAAM;EACzB,CAAC;CACH;;CAGA,MAAM,YAAY,SAAyC;EAKzD,QAAO,MAJa,KAAK,IAAI,KAAK,KAAK,QAAQ;GAC7C,OAAO,GAAG,IAAI,KAAK,QAAQ,SAAS,GAAG,OAAO;GAC9C,SAAS,IAAI,IAAI,KAAK,QAAQ,WAAW,CAAC;EAC5C,CAAC,EAAA,CACW,UACT,GAAG,MAAM,EAAE,UAAU,cAAc,EAAE,SAAS,KAAK,EAAE,GAAG,cAAc,EAAE,EAAE,CAC7E;CACF;;CAGA,MAAM,cAAc,SAAyC;EAC3D,OAAO,eAAe,MAAM,KAAK,YAAY,OAAO,CAAC;CACvD;AACF;;AAGA,SAAS,MAAM,QAAoC;CACjD,MAAM,MAAM,KAAK,IAAI;CACrB,MAAM,QAAQ,WAAW,KAAA,IAAY,OAAO,oBAAoB,KAAK,MAAM,MAAM,IAAI;CACrF,OAAO,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY;AACpD"}

package/dist/models/build.d.mts

@@ -1,6 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
+import { Logger } from "../logger.mjs";
 import { BuildStatus } from "../types.mjs";
 import { Build } from "../schema/build.mjs";
 import { Table } from "drizzle-orm";
@@ -13,9 +14,11 @@ interface BuildTables {
 }
 /** Data operations for build records. */
 declare class BuildModel {
-  private readonly db;
   private readonly tables;
-  constructor(db: DatabaseAdapter, tables?: BuildTables);
+  private readonly db;
+  private readonly logger;
+  /** `logger` only reports a status write refused by a `cancelled` build, at debug. */
+  constructor(db: DatabaseAdapter, tables?: BuildTables, logger?: Logger);
   create(projectId: string, input: BuildCreateInput): Promise<Build>;
   get(id: string): Promise<Build | null>;
   list(projectId: string, filter?: BuildListFilter): Promise<Build[]>;
@@ -30,13 +33,30 @@ declare class BuildModel {
     id: string;
     gitDefaultBranch: string;
   }): Promise<Build | null>;
-  update(id: string, patch: Partial<Pick<Build, "status" | "public" | "message" | "authorEmail" | "authorName">>): Promise<Build>;
+  /**
+   * Patch a build. A `cancelled` build is terminal (ADR 0006): a patch that carries another status
+   * is refused, the row is returned as it is, so a capture that ends after a cancel cannot move
+   * the build. Only {@link BuildModel.resetStatus} leaves `cancelled`.
+   */
+  update(id: string, patch: Partial<Pick<Build, "status" | "public" | "message" | "authorEmail" | "authorName">>, options?: {
+    reset?: boolean;
+  }): Promise<Build>;
   setStatus(id: string, status: BuildStatus): Promise<Build>;
+  /**
+   * Put a finished build back to `status` for a retry. The one write that leaves `cancelled`
+   * (a user chose it), so it skips the terminal guard of {@link BuildModel.update}.
+   */
+  resetStatus(id: string, status: BuildStatus): Promise<Build>;
   /**
    * Record the affected-capture computation for a build. Idempotent: the CLI
    * posts this once after creating the build and before uploading the bundle.
    */
   setAffected(id: string, input: AffectedComputation): Promise<Build>;
+  /**
+   * Store the results of the build's `.test()` entries (`TestResult[]`, as JSON), or clear them
+   * with null. Written once per capture run, by the run that ran the tests.
+   */
+  setTestResults(id: string, results: readonly unknown[] | null): Promise<Build>;
   /**
    * Parse a build's affected import paths. Returns `null` for full capture
    * (no computation, or an unreadable payload) — callers render everything.
@@ -81,6 +101,8 @@ interface BuildListFilter {
   branch?: string;
   labelKey?: string;
   labelValue?: string;
+  /** Newest builds to return at most. */
+  limit?: number;
 }
 //#endregion
 export { AffectedComputation, BuildCreateInput, BuildListFilter, BuildModel, BuildTables, isPublicBuild };