@storyshelf/core 0.6.1 → 0.7.0

package/dist/capture/pipeline.mjs

@@ -1,16 +1,18 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-import { BuildModel } from "../models/build.mjs";
+import { DEFAULT_BROWSER } from "../adapters/capture-target.mjs";
 import { emitAttemptLog } from "../models/capture-attempt.mjs";
-import { diffPath, screenshotPath } from "../paths.mjs";
+import { BuildModel } from "../models/build.mjs";
+import { diffPath } from "../paths.mjs";
+import { storeScreenshot } from "../utils/screenshot-store.mjs";
 import { BaselineModel } from "../models/baseline.mjs";
+import { assertScreenshotBuffer } from "./guards.mjs";
 import { NO_BASELINE } from "../models/baseline-status.mjs";
 import { SnapshotModel } from "../models/snapshot.mjs";
+import { mapLimit } from "../utils/map-limit.mjs";
 import { diffStoredScreenshots, writeDiffOverlay } from "./diff-record.mjs";
-import { assertScreenshotBuffer } from "./guards.mjs";
-import { SIZING_DEFAULTS, infraHashFor } from "./sizing.mjs";
-//#region src/capture/pipeline.ts
+import { buildFingerprint, changedFields, fingerprintHash, mergeFingerprint, parseFingerprint } from "./fingerprint.mjs";
 /**
 * Persist a completed capture run: write screenshots, diff against the branch
 * baseline, create snapshots, and finalize the build.
@@ -24,13 +26,24 @@ import { SIZING_DEFAULTS, infraHashFor } from "./sizing.mjs";
 * @param flakyFailedStoryIds - Story ids that failed but are marked flaky
 * (non-blocking). They are logged as warnings and do not block the build.
 */
-async function persistCapture(ctx, renderFailedStoryIds = /* @__PURE__ */ new Set(), flakyFailedStoryIds = /* @__PURE__ */ new Set(), a11yFailedStoryIds = /* @__PURE__ */ new Set()) {
+async function persistCapture(input, renderFailedStoryIds = /* @__PURE__ */ new Set(), flakyFailedStoryIds = /* @__PURE__ */ new Set(), a11yFailedStoryIds = /* @__PURE__ */ new Set()) {
+	const sets = await persistRendered(input, renderFailedStoryIds, flakyFailedStoryIds, a11yFailedStoryIds);
+	for (const id of await persistInherited(input)) sets.failed.add(id);
+	await finalizeBuild(input, allStoryIds(input), sets.failed, sets.flaky, sets.a11y);
+}
+/**
+* Persist the rendered captures only: screenshots, diffs and snapshot rows, without the
+* inherited snapshots or the build finalize. A sharded capture runs this once per shard.
+*/
+async function persistRendered(input, renderFailedStoryIds = /* @__PURE__ */ new Set(), flakyFailedStoryIds = /* @__PURE__ */ new Set(), a11yFailedStoryIds = /* @__PURE__ */ new Set()) {
+	const ctx = await withFreshBrowsers(input);
 	const failedStoryIds = new Set(renderFailedStoryIds);
 	const flakyIds = new Set(flakyFailedStoryIds);
 	const a11yIds = new Set(a11yFailedStoryIds);
-	await Promise.all(ctx.captures.map(async (capture) => {
+	for (const group of capturesByPhase(ctx)) await mapLimit(group, 4, async (capture) => {
 		try {
 			await persistSnapshot(ctx, capture);
+			ctx.progress?.();
 		} catch (error) {
 			if (flakyIds.has(capture.story.id) || a11yIds.has(capture.story.id)) {
 				if (flakyIds.has(capture.story.id)) flakyIds.add(capture.story.id);
@@ -55,7 +68,7 @@ async function persistCapture(ctx, renderFailedStoryIds = /* @__PURE__ */ new Se
 				viewport: capture.viewportName
 			});
 		}
-	}));
+	});
 	for (const id of flakyIds) if (!failedStoryIds.has(id)) {
 		ctx.logger?.warn({ storyId: id }, "flaky story failed (non-blocking)");
 		await emitAttemptLog(ctx.recordLog, ctx.logger, "warn", "flaky story failed (non-blocking)", { storyId: id });
@@ -64,8 +77,62 @@ async function persistCapture(ctx, renderFailedStoryIds = /* @__PURE__ */ new Se
 		ctx.logger?.warn({ storyId: id }, "a11y violations found (non-blocking)");
 		await emitAttemptLog(ctx.recordLog, ctx.logger, "warn", "a11y violations found (non-blocking)", { storyId: id });
 	}
-	for (const id of await persistInherited(ctx)) failedStoryIds.add(id);
-	await finalize(ctx, allStoryIds(ctx), failedStoryIds, flakyIds, a11yIds);
+	return {
+		failed: failedStoryIds,
+		flaky: flakyIds,
+		a11y: a11yIds
+	};
+}
+/** Engines of this run, primary (first) first. */
+function runBrowsers(ctx) {
+	const listed = ctx.browsers && ctx.browsers.length > 0 ? ctx.browsers : [DEFAULT_BROWSER];
+	return [...new Set(listed)];
+}
+function primaryBrowser(ctx) {
+	return runBrowsers(ctx)[0] ?? "chromium";
+}
+/** The capture's axe violation texts as the JSON stored on the snapshot; null when there are none. */
+function a11yJsonOf(capture) {
+	return capture.a11y && capture.a11y.length > 0 ? JSON.stringify(capture.a11y) : null;
+}
+function browserOf(capture) {
+	return capture.browser ?? "chromium";
+}
+/** Captures split into the primary engine's, then everyone else's. */
+function capturesByPhase(ctx) {
+	const primary = primaryBrowser(ctx);
+	const first = ctx.captures.filter((capture) => browserOf(capture) === primary);
+	const rest = ctx.captures.filter((capture) => browserOf(capture) !== primary);
+	return rest.length > 0 ? [first, rest] : [first];
+}
+/** Secondary engines with no baseline yet (their first snapshots bootstrap from the primary). */
+async function freshBrowsersOf(ctx) {
+	const primary = primaryBrowser(ctx);
+	const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);
+	const secondary = runBrowsers(ctx).filter((browser) => browser !== primary);
+	const checks = await Promise.all(secondary.map(async (browser) => ({
+		browser,
+		fresh: !await baselines.hasAny(ctx.project.id, browser)
+	})));
+	return new Set(checks.filter((check) => check.fresh).map((check) => check.browser));
+}
+/** Mark secondary engines with no baseline yet: their first snapshots bootstrap. */
+async function withFreshBrowsers(ctx) {
+	return ctx.freshBrowsers ? ctx : {
+		...ctx,
+		freshBrowsers: await freshBrowsersOf(ctx)
+	};
+}
+/**
+* A newly enabled engine accepts a story/mode's first snapshot when the
+* primary engine's snapshot of it is clean (Chromatic's "auto-accepted where
+* the primary browser was accepted"); anything else goes to review as `new`.
+*/
+async function bootstrapAccepts(ctx, capture) {
+	const browser = browserOf(capture);
+	if (!ctx.freshBrowsers?.has(browser)) return false;
+	const primary = primaryBrowser(ctx);
+	return (await new SnapshotModel(ctx.db, ctx.tables).listByBuild(ctx.build.id)).some((snapshot) => snapshot.storyId === capture.story.id && snapshot.viewportName === capture.viewportName && (snapshot.browser ?? "chromium") === primary && (snapshot.status === "approved" || snapshot.status === "unchanged"));
 }
 /** Persist one inherited snapshot; returns the story id on failure. */
 async function tryPersistInherited(ctx, inherited) {
@@ -86,24 +153,33 @@ async function tryPersistInherited(ctx, inherited) {
 	}
 }
 /** Persist inherited snapshots; a failure marks the story failed. */
+/** Persist the inherited snapshots (stories reusing their baseline); returns the story ids that failed. */
 async function persistInherited(ctx) {
-	const outcomes = await Promise.all((ctx.inherited ?? []).map(async (inherited) => await tryPersistInherited(ctx, inherited)));
+	const outcomes = await mapLimit(ctx.inherited ?? [], 4, async (inherited) => {
+		const failed = await tryPersistInherited(ctx, inherited);
+		ctx.progress?.();
+		return failed;
+	});
 	return new Set(outcomes.filter((id) => id !== null));
 }
 /** Create an unchanged snapshot reusing the baseline screenshot. */
 async function persistInheritedSnapshot(ctx, inherited) {
-	const infraHash = infraHashFor(ctx.project.browser ?? "chromium", ctx.viewports, SIZING_DEFAULTS);
+	const browser = browserOf(inherited);
+	const infraHash = inherited.baseline.infraHash;
 	const snapshots = new SnapshotModel(ctx.db, ctx.tables);
 	const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {
+		browser,
 		storyId: inherited.story.id,
 		storyName: inherited.story.name,
 		storyTitle: inherited.story.title,
 		storyImportPath: inherited.story.importPath ?? "",
+		designUrl: inherited.story.designUrl ?? null,
 		viewportName: inherited.viewport.name,
 		viewportWidth: inherited.viewport.width,
 		viewportHeight: inherited.viewport.height,
 		screenshotPath: inherited.baseline.screenshotPath,
 		infraHash,
+		mode: modeJsonOf(inherited.viewport),
 		inherited: true,
 		baselineId: inherited.baseline.id,
 		baselineVersion: inherited.baseline.updatedAt
@@ -123,6 +199,10 @@ function allStoryIds(ctx) {
 	for (const inherited of ctx.inherited ?? []) ids.add(inherited.story.id);
 	return ids;
 }
+/** JSON for the snapshot `mode` column: the globals a mode applied (null for plain viewports). */
+function modeJsonOf(viewport) {
+	return viewport?.globals ? JSON.stringify(viewport.globals) : null;
+}
 function viewportByName(ctx, name) {
 	return ctx.viewports.find((v) => v.name === name) ?? {
 		name,
@@ -130,77 +210,194 @@ function viewportByName(ctx, name) {
 		height: 0
 	};
 }
-async function persistSnapshot(ctx, capture) {
+/** Where the capture's screenshot lives: already stored by the orchestrator, or stored now. */
+async function screenshotLocation(ctx, capture) {
+	if (capture.storedPath) return capture.storedPath;
 	assertScreenshotBuffer(capture.screenshot);
+	return await storeScreenshot(ctx.storage, ctx.project.id, capture.screenshot);
+}
+async function persistSnapshot(ctx, capture) {
 	const viewport = capture.viewport ?? viewportByName(ctx, capture.viewportName);
-	const screenshot = screenshotPath(ctx.project.id, ctx.build.id, capture.story.id, capture.viewportName);
-	await ctx.storage.write(screenshot, capture.screenshot);
-	const baseline = await resolveBaseline(ctx, capture.story.id, capture.viewportName);
+	const browser = browserOf(capture);
+	const screenshot = await screenshotLocation(ctx, capture);
+	const baseline = await resolveBaseline(ctx, capture.story.id, capture.viewportName, browser);
 	if (!baseline) {
 		await createWithoutBaseline(ctx, capture, viewport, screenshot);
 		return;
 	}
 	await createWithBaseline(ctx, capture, viewport, screenshot, baseline);
 }
-async function resolveBaseline(ctx, storyId, viewport) {
-	return await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).resolve(ctx.project.id, storyId, viewport, ctx.build.gitBranch, ctx.project.gitDefaultBranch);
+async function resolveBaseline(ctx, storyId, viewport, browser) {
+	return await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).resolve(ctx.project.id, storyId, viewport, ctx.build.gitBranch, ctx.project.gitDefaultBranch, browser);
 }
 async function createWithoutBaseline(ctx, capture, viewport, screenshot) {
 	const snapshots = new SnapshotModel(ctx.db, ctx.tables);
-	const status = ctx.build.isDefault ? "approved" : "new";
-	const infraHash = infraHashFor(ctx.project.browser ?? "chromium", ctx.viewports, SIZING_DEFAULTS);
+	const browser = browserOf(capture);
+	const accepted = ctx.build.isDefault || await bootstrapAccepts(ctx, capture);
+	const status = accepted ? "approved" : "new";
+	const now = fingerprintOf(capture, viewport);
 	const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {
+		browser,
+		durationMs: capture.durationMs ?? null,
+		a11yViolations: a11yJsonOf(capture),
 		storyId: capture.story.id,
 		storyName: capture.story.name,
 		storyTitle: capture.story.title,
 		storyImportPath: capture.story.importPath ?? "",
+		designUrl: capture.story.designUrl ?? null,
 		viewportName: capture.viewportName,
 		viewportWidth: viewport.width,
 		viewportHeight: viewport.height,
 		screenshotPath: screenshot,
-		infraHash,
+		infraHash: now.infraHash,
+		mode: modeJsonOf(viewport),
 		baselineVersion: NO_BASELINE
 	});
 	await snapshots.setStatus(snapshot.id, status);
-	if (ctx.build.isDefault) await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).upsert(ctx.project.id, capture.story.id, capture.viewportName, ctx.build.gitBranch, snapshot.id, screenshot, infraHash);
+	if (accepted) await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).upsert(ctx.project.id, capture.story.id, capture.viewportName, ctx.build.gitBranch, snapshot.id, screenshot, now.infraHash, {
+		mode: modeJsonOf(viewport),
+		browser,
+		fingerprint: now.json
+	});
 }
+function fingerprintOf(capture, viewport) {
+	return captureFingerprintOf(buildFingerprint(browserOf(capture), viewport, capture.environment));
+}
+/** A fingerprint as stored: its hash (the `infraHash`) and JSON. */
+function captureFingerprintOf(fingerprint) {
+	return {
+		fingerprint,
+		infraHash: fingerprintHash(fingerprint),
+		json: JSON.stringify(fingerprint)
+	};
+}
+/**
+* What changed in the capture environment since the baseline was recorded, or null when nothing
+* did. Compared component by component, only where both sides report a value: a capture with no
+* environment (spooled before a browser crash) is unknown, not a change. A baseline from before
+* fingerprints cannot be compared, so it is never reported as changed; it is backfilled instead.
+*/
+function environmentChange(baseline, now) {
+	const from = parseFingerprint(baseline.fingerprint);
+	if (!from) return null;
+	const changed = changedFields(from, now.fingerprint);
+	return changed.length > 0 ? {
+		changed,
+		from,
+		to: now.fingerprint
+	} : null;
+}
+/**
+* A changed environment migrates the baseline without a diff only on the default branch, which is
+* authoritative and auto-approves its own changes anyway. A feature branch still diffs: a real
+* change is reported as `changed` with the environment change attached, never auto-accepted.
+*/
 async function createWithBaseline(ctx, capture, viewport, screenshot, baseline) {
-	const result = await diffStoredScreenshots(ctx.storage, ctx.project, baseline.screenshotPath, screenshot, capture.story.parameters?.diffThreshold);
-	const infraHash = infraHashFor(ctx.project.browser ?? "chromium", ctx.viewports, SIZING_DEFAULTS);
-	const snapshots = new SnapshotModel(ctx.db, ctx.tables);
-	const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {
+	const now = fingerprintOf(capture, viewport);
+	const change = environmentChange(baseline, now);
+	const input = {
+		ctx,
+		capture,
+		viewport,
+		screenshot,
+		baseline,
+		now,
+		change
+	};
+	if (change && ctx.build.isDefault) await persistMigration(input, change);
+	else await persistDiff(input);
+}
+/** The fingerprint to write on the baseline: the capture's, keeping components it did not report. */
+function baselineFingerprintOf(input) {
+	const earlier = parseFingerprint(input.baseline.fingerprint);
+	return captureFingerprintOf(mergeFingerprint(earlier, input.now.fingerprint));
+}
+function snapshotInput(input) {
+	const { capture, viewport, screenshot, baseline, now } = input;
+	return {
+		browser: browserOf(capture),
+		durationMs: capture.durationMs ?? null,
+		a11yViolations: a11yJsonOf(capture),
 		storyId: capture.story.id,
 		storyName: capture.story.name,
 		storyTitle: capture.story.title,
 		storyImportPath: capture.story.importPath ?? "",
+		designUrl: capture.story.designUrl ?? null,
 		viewportName: capture.viewportName,
 		viewportWidth: viewport.width,
 		viewportHeight: viewport.height,
 		screenshotPath: screenshot,
-		infraHash,
+		infraHash: now.infraHash,
+		mode: modeJsonOf(viewport),
 		baselineId: baseline.id,
 		baselineVersion: baseline.updatedAt
+	};
+}
+/**
+* The default branch's capture environment changed (browser build, fonts, platform, scale): pixels
+* would differ with no code change, so no diff is computed. The snapshot is accepted, records what
+* changed, and the new screenshot becomes the baseline.
+*/
+async function persistMigration(input, change) {
+	const { ctx, capture, viewport, screenshot, now } = input;
+	const snapshots = new SnapshotModel(ctx.db, ctx.tables);
+	const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {
+		...snapshotInput(input),
+		envChange: JSON.stringify(change)
 	});
-	const shouldAutomigrate = result.sizeChanged && !result.passed && ctx.project.automigrate && baseline.infraHash !== null && baseline.infraHash !== infraHash;
-	const status = shouldAutomigrate ? "unchanged" : diffStatus(result.passed, ctx.build.isDefault);
-	const diff = diffPath(ctx.project.id, ctx.build.id, capture.story.id, capture.viewportName);
-	const passed = shouldAutomigrate ? true : result.passed;
-	const pixels = shouldAutomigrate ? 0 : result.diffPixels;
-	const ratio = shouldAutomigrate ? 0 : result.diffRatio;
-	const overlay = await writeDiffOverlay(ctx.storage, diff, result, passed);
 	await snapshots.update(snapshot.id, {
-		status,
+		status: "unchanged",
+		diffPath: null,
+		diffPixels: 0,
+		diffRatio: 0,
+		diffPassed: true,
+		infraHash: now.infraHash
+	});
+	await upsertDefaultBaseline(ctx, snapshot.id, capture, screenshot, baselineFingerprintOf(input));
+	ctx.logger?.debug({
+		storyId: capture.story.id,
+		viewport: viewport.name,
+		changed: change.changed
+	}, "capture environment changed; accepted without a diff");
+}
+/** Diff against the baseline; a feature-branch environment change rides along as `envChange`. */
+async function persistDiff(input) {
+	const { ctx, capture, screenshot, baseline, now, change } = input;
+	const result = await diffStoredScreenshots(ctx.storage, ctx.project, baseline.screenshotPath, screenshot, capture.story.parameters?.diffThreshold);
+	const snapshots = new SnapshotModel(ctx.db, ctx.tables);
+	const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {
+		...snapshotInput(input),
+		...change ? { envChange: JSON.stringify(change) } : {}
+	});
+	const diff = diffPath(ctx.project.id, ctx.build.id, capture.story.id, capture.viewportName, browserOf(capture));
+	const overlay = await writeDiffOverlay(ctx.storage, diff, result, result.passed);
+	await snapshots.update(snapshot.id, {
+		status: diffStatus(result.passed, ctx.build.isDefault),
 		diffPath: overlay,
-		diffPixels: pixels,
-		diffRatio: ratio,
-		diffPassed: passed,
-		infraHash
+		diffPixels: result.diffPixels,
+		diffRatio: result.diffRatio,
+		diffPassed: result.passed,
+		infraHash: now.infraHash
 	});
-	if (ctx.build.isDefault && (shouldAutomigrate || !passed)) await upsertDefaultBaseline(ctx, snapshot.id, capture, screenshot, infraHash);
+	if (ctx.build.isDefault) await refreshDefaultBaseline(input, snapshot.id, result.passed);
+}
+/**
+* After a default-branch diff: a failed diff moves the baseline to the new screenshot; a passing
+* one backfills the fingerprint when it was missing or had components the capture now reports.
+*/
+async function refreshDefaultBaseline(input, snapshotId, passed) {
+	const { ctx, capture, screenshot, baseline } = input;
+	const target = baselineFingerprintOf(input);
+	if (!passed) await upsertDefaultBaseline(ctx, snapshotId, capture, screenshot, target);
+	else if (!baseline.fingerprint || baseline.infraHash !== target.infraHash) await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).backfillFingerprint(baseline, target.infraHash, target.json);
 }
 /** Default-branch builds are authoritative: the captured screenshot becomes the baseline. */
-async function upsertDefaultBaseline(ctx, snapshotId, capture, screenshot, infraHash) {
-	await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).upsert(ctx.project.id, capture.story.id, capture.viewportName, ctx.build.gitBranch, snapshotId, screenshot, infraHash);
+async function upsertDefaultBaseline(ctx, snapshotId, capture, screenshot, now) {
+	await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).upsert(ctx.project.id, capture.story.id, capture.viewportName, ctx.build.gitBranch, snapshotId, screenshot, now.infraHash, {
+		mode: modeJsonOf(capture.viewport),
+		browser: browserOf(capture),
+		fingerprint: now.json
+	});
 }
 /** Snapshot status after diffing: default-branch changes are auto-approved, not queued for review. */
 function diffStatus(passed, isDefault) {
@@ -213,8 +410,16 @@ function finalBuildStatus(isDefault, failedCount, hasCaptures, build) {
 	if (isDefault || hasCaptures && build.changedCount === 0) return "approved";
 	return "reviewing";
 }
-async function finalize(ctx, storyIds, failedStoryIds, flakyFailedStoryIds = /* @__PURE__ */ new Set(), a11yFailedStoryIds = /* @__PURE__ */ new Set()) {
-	const builds = new BuildModel(ctx.db, ctx.tables);
+/**
+* Close out a capture: roll the snapshot counts up, set the build's final status from the failed
+* story ids, and (on the default branch) drop baselines of stories that no longer exist.
+*/
+async function finalizeBuild(ctx, storyIds, failedStoryIds, flakyFailedStoryIds = /* @__PURE__ */ new Set(), a11yFailedStoryIds = /* @__PURE__ */ new Set()) {
+	const builds = new BuildModel(ctx.db, ctx.tables, ctx.logger);
+	if ((await builds.get(ctx.build.id))?.status === "cancelled") {
+		ctx.logger?.debug({ buildId: ctx.build.id }, "build is cancelled; finalize skipped");
+		return;
+	}
 	const build = await builds.updateCounts(ctx.build.id);
 	const hasCaptures = storyIds.size > 0;
 	const status = finalBuildStatus(ctx.build.isDefault, failedStoryIds.size, hasCaptures, build);
@@ -230,6 +435,6 @@ async function finalize(ctx, storyIds, failedStoryIds, flakyFailedStoryIds = /*
 	if (ctx.build.isDefault && hasCaptures) await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).removeOrphans(ctx.project.id, new Set(storyIds));
 }
 //#endregion
-export { diffStatus, persistCapture };
+export { diffStatus, finalizeBuild, freshBrowsersOf, persistCapture, persistInherited, persistRendered };
 
 //# sourceMappingURL=pipeline.mjs.map

package/dist/capture/pipeline.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.mjs","names":[],"sources":["../../src/capture/pipeline.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport type { RenderedSnapshot } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { NO_BASELINE } from \"../models/baseline-status.ts\";\nimport { BaselineModel, type BaselineTables } from \"../models/baseline.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport { emitAttemptLog, type AttemptLogRecorder } from \"../models/capture-attempt.ts\";\nimport { SnapshotModel, type SnapshotTables } from \"../models/snapshot.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport type { BuildStatus, SnapshotStatus } from \"../types.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { diffPath, screenshotPath } from \"../utils/paths.ts\";\nimport type { Viewport } from \"./adapter.ts\";\nimport type { InheritedStory } from \"./affected.ts\";\nimport { diffStoredScreenshots, writeDiffOverlay } from \"./diff-record.ts\";\nimport { assertScreenshotBuffer } from \"./guards.ts\";\nimport { infraHashFor, SIZING_DEFAULTS } from \"./sizing.ts\";\n\n/**\n * Persist a completed capture run: write screenshots, diff against the branch\n * baseline, create snapshots, and finalize the build.\n *\n * Rendering is performed by a pure `CaptureRunner`; this function owns only\n * storage writes and record keeping, so it can run against any renderer.\n *\n * @param ctx - Capture context.\n * @param renderFailedStoryIds - Story ids that the renderer could not capture\n * (blocking failures). They force the build to `failed`.\n * @param flakyFailedStoryIds - Story ids that failed but are marked flaky\n * (non-blocking). They are logged as warnings and do not block the build.\n */\nexport async function persistCapture(\n  ctx: CaptureContext,\n  renderFailedStoryIds: ReadonlySet<string> = new Set(),\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<void> {\n  const failedStoryIds = new Set(renderFailedStoryIds);\n  const flakyIds = new Set(flakyFailedStoryIds);\n  const a11yIds = new Set(a11yFailedStoryIds);\n  await Promise.all(\n    ctx.captures.map(async (capture) => {\n      try {\n        await persistSnapshot(ctx, capture);\n      } catch (error) {\n        // A failure in one story/viewport must not abort the other persists.\n        // Flaky and a11y stories remain non-blocking even on persist failure.\n        if (flakyIds.has(capture.story.id) || a11yIds.has(capture.story.id)) {\n          if (flakyIds.has(capture.story.id)) flakyIds.add(capture.story.id);\n          if (a11yIds.has(capture.story.id)) a11yIds.add(capture.story.id);\n          ctx.logger?.warn(\n            { storyId: capture.story.id, viewport: capture.viewportName, err: error },\n            \"capture failed for flaky/a11y story (non-blocking)\",\n          );\n          await emitAttemptLog(\n            ctx.recordLog,\n            ctx.logger,\n            \"warn\",\n            \"capture failed for flaky/a11y story (non-blocking)\",\n            {\n              storyId: capture.story.id,\n              viewport: capture.viewportName,\n            },\n          );\n        } else {\n          failedStoryIds.add(capture.story.id);\n        }\n        ctx.logger?.error(\n          { storyId: capture.story.id, viewport: capture.viewportName, err: error },\n          \"capture failed for story\",\n        );\n        await emitAttemptLog(ctx.recordLog, ctx.logger, \"error\", \"capture failed for story\", {\n          storyId: capture.story.id,\n          viewport: capture.viewportName,\n        });\n      }\n    }),\n  );\n  // Also log flaky and a11y render failures as warnings\n  for (const id of flakyIds) {\n    if (!failedStoryIds.has(id)) {\n      ctx.logger?.warn({ storyId: id }, \"flaky story failed (non-blocking)\");\n      await emitAttemptLog(ctx.recordLog, ctx.logger, \"warn\", \"flaky story failed (non-blocking)\", {\n        storyId: id,\n      });\n    }\n  }\n  for (const id of a11yIds) {\n    if (!failedStoryIds.has(id) && !flakyIds.has(id)) {\n      ctx.logger?.warn({ storyId: id }, \"a11y violations found (non-blocking)\");\n      await emitAttemptLog(\n        ctx.recordLog,\n        ctx.logger,\n        \"warn\",\n        \"a11y violations found (non-blocking)\",\n        {\n          storyId: id,\n        },\n      );\n    }\n  }\n  for (const id of await persistInherited(ctx)) {\n    failedStoryIds.add(id);\n  }\n  await finalize(ctx, allStoryIds(ctx), failedStoryIds, flakyIds, a11yIds);\n}\n\n/** Persist one inherited snapshot; returns the story id on failure. */\nasync function tryPersistInherited(\n  ctx: CaptureContext,\n  inherited: InheritedStory,\n): Promise<string | null> {\n  try {\n    await persistInheritedSnapshot(ctx, inherited);\n    return null;\n  } catch (error) {\n    ctx.logger?.error(\n      { storyId: inherited.story.id, viewport: inherited.viewport.name, err: error },\n      \"inherit failed for story\",\n    );\n    await emitAttemptLog(ctx.recordLog, ctx.logger, \"error\", \"inherit failed for story\", {\n      storyId: inherited.story.id,\n      viewport: inherited.viewport.name,\n    });\n    return inherited.story.id;\n  }\n}\n\n/** Persist inherited snapshots; a failure marks the story failed. */\nasync function persistInherited(ctx: CaptureContext): Promise<ReadonlySet<string>> {\n  const outcomes = await Promise.all(\n    (ctx.inherited ?? []).map(async (inherited) => await tryPersistInherited(ctx, inherited)),\n  );\n  return new Set(outcomes.filter((id): id is string => id !== null));\n}\n\n/** Create an unchanged snapshot reusing the baseline screenshot. */\nasync function persistInheritedSnapshot(\n  ctx: CaptureContext,\n  inherited: InheritedStory,\n): Promise<void> {\n  const infraHash = infraHashFor(ctx.project.browser ?? \"chromium\", ctx.viewports, SIZING_DEFAULTS);\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    storyId: inherited.story.id,\n    storyName: inherited.story.name,\n    storyTitle: inherited.story.title,\n    storyImportPath: inherited.story.importPath ?? \"\",\n    viewportName: inherited.viewport.name,\n    viewportWidth: inherited.viewport.width,\n    viewportHeight: inherited.viewport.height,\n    screenshotPath: inherited.baseline.screenshotPath,\n    infraHash,\n    inherited: true,\n    baselineId: inherited.baseline.id,\n    baselineVersion: inherited.baseline.updatedAt,\n  });\n  await snapshots.update(snapshot.id, {\n    status: \"unchanged\",\n    diffPixels: 0,\n    diffRatio: 0,\n    diffPassed: true,\n    diffPath: null,\n    infraHash,\n  });\n}\n\n/** Every story covered by a capture run, rendered or inherited. */\nfunction allStoryIds(ctx: CaptureContext): ReadonlySet<string> {\n  const ids = new Set(ctx.captures.map((capture) => capture.story.id));\n  for (const inherited of ctx.inherited ?? []) {\n    ids.add(inherited.story.id);\n  }\n  return ids;\n}\n\n/** Table handles required by the capture pipeline. */\nexport type PipelineTables = BuildTables & BaselineTables & SnapshotTables;\n\n/** Persistence inputs for a completed capture run. */\nexport interface CaptureContext {\n  /** Database adapter. */\n  db: DatabaseAdapter;\n  /** Table handles. */\n  tables: PipelineTables;\n  /** Storage adapter. */\n  storage: StorageAdapter;\n  /** The project being captured. */\n  project: Project;\n  /** The build being captured. */\n  build: Build;\n  /** Viewports at which stories were captured. */\n  viewports: Viewport[];\n  /** Screenshot buffers produced by the capture renderer. */\n  captures: RenderedSnapshot[];\n  /** Stories inheriting their baseline without rendering (affected capture). */\n  inherited?: InheritedStory[];\n  /** Optional logger for capture diagnostics. */\n  logger?: Logger;\n  /** Optional per-attempt log recorder (mirrors logger lines into the DB). */\n  recordLog?: AttemptLogRecorder;\n  /** Server secret for decrypting webhook secrets at send time. */\n  secret?: SecretInput;\n}\n\nfunction viewportByName(ctx: CaptureContext, name: string): Viewport {\n  return ctx.viewports.find((v) => v.name === name) ?? { name, width: 0, height: 0 };\n}\n\nasync function persistSnapshot(ctx: CaptureContext, capture: RenderedSnapshot): Promise<void> {\n  assertScreenshotBuffer(capture.screenshot);\n  const viewport = capture.viewport ?? viewportByName(ctx, capture.viewportName);\n  const screenshot = screenshotPath(\n    ctx.project.id,\n    ctx.build.id,\n    capture.story.id,\n    capture.viewportName,\n  );\n  await ctx.storage.write(screenshot, capture.screenshot);\n\n  const baseline = await resolveBaseline(ctx, capture.story.id, capture.viewportName);\n  if (!baseline) {\n    await createWithoutBaseline(ctx, capture, viewport, screenshot);\n    return;\n  }\n  await createWithBaseline(ctx, capture, viewport, screenshot, baseline);\n}\n\nasync function resolveBaseline(\n  ctx: CaptureContext,\n  storyId: string,\n  viewport: string,\n): Promise<Baseline | null> {\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  return await baselines.resolve(\n    ctx.project.id,\n    storyId,\n    viewport,\n    ctx.build.gitBranch,\n    ctx.project.gitDefaultBranch,\n  );\n}\n\nasync function createWithoutBaseline(\n  ctx: CaptureContext,\n  capture: RenderedSnapshot,\n  viewport: Viewport,\n  screenshot: string,\n): Promise<void> {\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const status = ctx.build.isDefault ? \"approved\" : \"new\";\n  const infraHash = infraHashFor(ctx.project.browser ?? \"chromium\", ctx.viewports, SIZING_DEFAULTS);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n    infraHash,\n    baselineVersion: NO_BASELINE,\n  });\n  await snapshots.setStatus(snapshot.id, status);\n\n  if (ctx.build.isDefault) {\n    const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n    await baselines.upsert(\n      ctx.project.id,\n      capture.story.id,\n      capture.viewportName,\n      ctx.build.gitBranch,\n      snapshot.id,\n      screenshot,\n      infraHash,\n    );\n  }\n}\n\nasync function createWithBaseline(\n  ctx: CaptureContext,\n  capture: RenderedSnapshot,\n  viewport: Viewport,\n  screenshot: string,\n  baseline: Baseline,\n): Promise<void> {\n  const result = await diffStoredScreenshots(\n    ctx.storage,\n    ctx.project,\n    baseline.screenshotPath,\n    screenshot,\n    capture.story.parameters?.diffThreshold,\n  );\n\n  const infraHash = infraHashFor(ctx.project.browser ?? \"chromium\", ctx.viewports, SIZING_DEFAULTS);\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n    infraHash,\n    baselineId: baseline.id,\n    baselineVersion: baseline.updatedAt,\n  });\n\n  // Automigrate: infra-induced size change with project.automigrate enabled\n  const shouldAutomigrate =\n    result.sizeChanged &&\n    !result.passed &&\n    (ctx.project as unknown as { automigrate?: boolean }).automigrate &&\n    baseline.infraHash !== null &&\n    baseline.infraHash !== infraHash;\n\n  const status = shouldAutomigrate ? \"unchanged\" : diffStatus(result.passed, ctx.build.isDefault);\n  const diff = diffPath(ctx.project.id, ctx.build.id, capture.story.id, capture.viewportName);\n  const passed = shouldAutomigrate ? true : result.passed;\n  const pixels = shouldAutomigrate ? 0 : result.diffPixels;\n  const ratio = shouldAutomigrate ? 0 : result.diffRatio;\n  const overlay = await writeDiffOverlay(ctx.storage, diff, result, passed);\n  await snapshots.update(snapshot.id, {\n    status,\n    diffPath: overlay,\n    diffPixels: pixels,\n    diffRatio: ratio,\n    diffPassed: passed,\n    infraHash,\n  });\n  if (ctx.build.isDefault && (shouldAutomigrate || !passed)) {\n    await upsertDefaultBaseline(ctx, snapshot.id, capture, screenshot, infraHash);\n  }\n}\n\n/** Default-branch builds are authoritative: the captured screenshot becomes the baseline. */\nasync function upsertDefaultBaseline(\n  ctx: CaptureContext,\n  snapshotId: string,\n  capture: RenderedSnapshot,\n  screenshot: string,\n  infraHash: string,\n): Promise<void> {\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  await baselines.upsert(\n    ctx.project.id,\n    capture.story.id,\n    capture.viewportName,\n    ctx.build.gitBranch,\n    snapshotId,\n    screenshot,\n    infraHash,\n  );\n}\n\n/** Snapshot status after diffing: default-branch changes are auto-approved, not queued for review. */\nexport function diffStatus(passed: boolean, isDefault: boolean): SnapshotStatus {\n  if (passed) {\n    return \"unchanged\";\n  }\n  return isDefault ? \"approved\" : \"changed\";\n}\n\n/** A failed capture fails the build; default-branch builds otherwise auto-approve. */\nfunction finalBuildStatus(\n  isDefault: boolean,\n  failedCount: number,\n  hasCaptures: boolean,\n  build: { changedCount: number },\n): BuildStatus {\n  if (failedCount > 0) {\n    return \"failed\";\n  }\n  if (isDefault || (hasCaptures && build.changedCount === 0)) {\n    return \"approved\";\n  }\n  return \"reviewing\";\n}\n\nasync function finalize(\n  ctx: CaptureContext,\n  storyIds: ReadonlySet<string>,\n  failedStoryIds: ReadonlySet<string>,\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<void> {\n  const builds = new BuildModel(ctx.db, ctx.tables);\n  const build = await builds.updateCounts(ctx.build.id);\n  const hasCaptures = storyIds.size > 0;\n  const status = finalBuildStatus(ctx.build.isDefault, failedStoryIds.size, hasCaptures, build);\n  // Flaky and a11y failures do not block: log warning if any failed non-blocking\n  if (flakyFailedStoryIds.size > 0 && failedStoryIds.size === 0) {\n    ctx.logger?.warn(\n      { flakyStoryIds: [...flakyFailedStoryIds] },\n      \"flaky stories failed (non-blocking)\",\n    );\n    await emitAttemptLog(ctx.recordLog, ctx.logger, \"warn\", \"flaky stories failed (non-blocking)\", {\n      flakyStoryIds: [...flakyFailedStoryIds],\n    });\n  }\n  if (a11yFailedStoryIds.size > 0 && failedStoryIds.size === 0) {\n    ctx.logger?.warn(\n      { a11yStoryIds: [...a11yFailedStoryIds] },\n      \"a11y violations found (non-blocking)\",\n    );\n    await emitAttemptLog(\n      ctx.recordLog,\n      ctx.logger,\n      \"warn\",\n      \"a11y violations found (non-blocking)\",\n      {\n        a11yStoryIds: [...a11yFailedStoryIds],\n      },\n    );\n  }\n  await builds.setStatus(ctx.build.id, status);\n\n  if (ctx.build.isDefault && hasCaptures) {\n    const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n    await baselines.removeOrphans(ctx.project.id, new Set(storyIds));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"pipeline.mjs","names":[],"sources":["../../src/capture/pipeline.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { DEFAULT_BROWSER, type RenderedSnapshot } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { NO_BASELINE } from \"../models/baseline-status.ts\";\nimport { BaselineModel, type BaselineTables } from \"../models/baseline.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport { emitAttemptLog, type AttemptLogRecorder } from \"../models/capture-attempt.ts\";\nimport { SnapshotModel, type SnapshotTables } from \"../models/snapshot.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport type { BuildStatus, SnapshotStatus } from \"../types.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { mapLimit } from \"../utils/map-limit.ts\";\nimport { diffPath } from \"../utils/paths.ts\";\nimport { storeScreenshot } from \"../utils/screenshot-store.ts\";\nimport type { Viewport } from \"./adapter.ts\";\nimport type { InheritedStory } from \"./affected.ts\";\nimport { diffStoredScreenshots, writeDiffOverlay } from \"./diff-record.ts\";\nimport {\n  buildFingerprint,\n  changedFields,\n  fingerprintHash,\n  mergeFingerprint,\n  parseFingerprint,\n  type EnvironmentChange,\n  type Fingerprint,\n} from \"./fingerprint.ts\";\nimport { assertScreenshotBuffer } from \"./guards.ts\";\nimport type { CaptureProgress } from \"./progress.ts\";\n\n/** Snapshots persisted at once: each decodes two PNGs for the diff, so unbounded fan-out spikes memory. */\nexport const PERSIST_CONCURRENCY = 4;\n\n/**\n * Persist a completed capture run: write screenshots, diff against the branch\n * baseline, create snapshots, and finalize the build.\n *\n * Rendering is performed by a pure `CaptureRunner`; this function owns only\n * storage writes and record keeping, so it can run against any renderer.\n *\n * @param ctx - Capture context.\n * @param renderFailedStoryIds - Story ids that the renderer could not capture\n * (blocking failures). They force the build to `failed`.\n * @param flakyFailedStoryIds - Story ids that failed but are marked flaky\n * (non-blocking). They are logged as warnings and do not block the build.\n */\nexport async function persistCapture(\n  input: CaptureContext,\n  renderFailedStoryIds: ReadonlySet<string> = new Set(),\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<void> {\n  const sets = await persistRendered(\n    input,\n    renderFailedStoryIds,\n    flakyFailedStoryIds,\n    a11yFailedStoryIds,\n  );\n  for (const id of await persistInherited(input)) {\n    sets.failed.add(id);\n  }\n  await finalizeBuild(input, allStoryIds(input), sets.failed, sets.flaky, sets.a11y);\n}\n\n/** Blocking, flaky and a11y story ids a persist run ended with. */\nexport interface PersistedSets {\n  failed: Set<string>;\n  flaky: Set<string>;\n  a11y: Set<string>;\n}\n\n/**\n * Persist the rendered captures only: screenshots, diffs and snapshot rows, without the\n * inherited snapshots or the build finalize. A sharded capture runs this once per shard.\n */\nexport async function persistRendered(\n  input: CaptureContext,\n  renderFailedStoryIds: ReadonlySet<string> = new Set(),\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<PersistedSets> {\n  const ctx = await withFreshBrowsers(input);\n  const failedStoryIds = new Set(renderFailedStoryIds);\n  const flakyIds = new Set(flakyFailedStoryIds);\n  const a11yIds = new Set(a11yFailedStoryIds);\n  // Primary engine first: a newly enabled engine bootstraps from its counterpart.\n  for (const group of capturesByPhase(ctx)) {\n    // oxlint-disable-next-line no-await-in-loop -- phases must run in order\n    await mapLimit(group, PERSIST_CONCURRENCY, async (capture) => {\n      try {\n        await persistSnapshot(ctx, capture);\n        // Each diff is progress: a long, healthy persist phase must not read as a hung job.\n        ctx.progress?.();\n      } catch (error) {\n        // A failure in one story/viewport must not abort the other persists.\n        // Flaky and a11y stories remain non-blocking even on persist failure.\n        if (flakyIds.has(capture.story.id) || a11yIds.has(capture.story.id)) {\n          if (flakyIds.has(capture.story.id)) flakyIds.add(capture.story.id);\n          if (a11yIds.has(capture.story.id)) a11yIds.add(capture.story.id);\n          ctx.logger?.warn(\n            { storyId: capture.story.id, viewport: capture.viewportName, err: error },\n            \"capture failed for flaky/a11y story (non-blocking)\",\n          );\n          await emitAttemptLog(\n            ctx.recordLog,\n            ctx.logger,\n            \"warn\",\n            \"capture failed for flaky/a11y story (non-blocking)\",\n            {\n              storyId: capture.story.id,\n              viewport: capture.viewportName,\n            },\n          );\n        } else {\n          failedStoryIds.add(capture.story.id);\n        }\n        ctx.logger?.error(\n          { storyId: capture.story.id, viewport: capture.viewportName, err: error },\n          \"capture failed for story\",\n        );\n        await emitAttemptLog(ctx.recordLog, ctx.logger, \"error\", \"capture failed for story\", {\n          storyId: capture.story.id,\n          viewport: capture.viewportName,\n        });\n      }\n    });\n  }\n  // Also log flaky and a11y render failures as warnings\n  for (const id of flakyIds) {\n    if (!failedStoryIds.has(id)) {\n      ctx.logger?.warn({ storyId: id }, \"flaky story failed (non-blocking)\");\n      await emitAttemptLog(ctx.recordLog, ctx.logger, \"warn\", \"flaky story failed (non-blocking)\", {\n        storyId: id,\n      });\n    }\n  }\n  for (const id of a11yIds) {\n    if (!failedStoryIds.has(id) && !flakyIds.has(id)) {\n      ctx.logger?.warn({ storyId: id }, \"a11y violations found (non-blocking)\");\n      await emitAttemptLog(\n        ctx.recordLog,\n        ctx.logger,\n        \"warn\",\n        \"a11y violations found (non-blocking)\",\n        {\n          storyId: id,\n        },\n      );\n    }\n  }\n  return { failed: failedStoryIds, flaky: flakyIds, a11y: a11yIds };\n}\n\n/** Engines of this run, primary (first) first. */\nfunction runBrowsers(ctx: CaptureContext): string[] {\n  const listed = ctx.browsers && ctx.browsers.length > 0 ? ctx.browsers : [DEFAULT_BROWSER];\n  return [...new Set(listed)];\n}\n\nfunction primaryBrowser(ctx: CaptureContext): string {\n  return runBrowsers(ctx)[0] ?? DEFAULT_BROWSER;\n}\n\n/** The capture's axe violation texts as the JSON stored on the snapshot; null when there are none. */\nfunction a11yJsonOf(capture: { a11y?: string[] }): string | null {\n  return capture.a11y && capture.a11y.length > 0 ? JSON.stringify(capture.a11y) : null;\n}\n\nfunction browserOf(capture: { browser?: string }): string {\n  return capture.browser ?? DEFAULT_BROWSER;\n}\n\n/** Captures split into the primary engine's, then everyone else's. */\nfunction capturesByPhase(ctx: CaptureContext): RenderedSnapshot[][] {\n  const primary = primaryBrowser(ctx);\n  const first = ctx.captures.filter((capture) => browserOf(capture) === primary);\n  const rest = ctx.captures.filter((capture) => browserOf(capture) !== primary);\n  return rest.length > 0 ? [first, rest] : [first];\n}\n\n/** Secondary engines with no baseline yet (their first snapshots bootstrap from the primary). */\nexport async function freshBrowsersOf(ctx: CaptureContext): Promise<Set<string>> {\n  const primary = primaryBrowser(ctx);\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  const secondary = runBrowsers(ctx).filter((browser) => browser !== primary);\n  const checks = await Promise.all(\n    secondary.map(async (browser) => ({\n      browser,\n      fresh: !(await baselines.hasAny(ctx.project.id, browser)),\n    })),\n  );\n  return new Set(checks.filter((check) => check.fresh).map((check) => check.browser));\n}\n\n/** Mark secondary engines with no baseline yet: their first snapshots bootstrap. */\nasync function withFreshBrowsers(ctx: CaptureContext): Promise<CaptureContext> {\n  return ctx.freshBrowsers ? ctx : { ...ctx, freshBrowsers: await freshBrowsersOf(ctx) };\n}\n\n/**\n * A newly enabled engine accepts a story/mode's first snapshot when the\n * primary engine's snapshot of it is clean (Chromatic's \"auto-accepted where\n * the primary browser was accepted\"); anything else goes to review as `new`.\n */\nasync function bootstrapAccepts(ctx: CaptureContext, capture: RenderedSnapshot): Promise<boolean> {\n  const browser = browserOf(capture);\n  if (!ctx.freshBrowsers?.has(browser)) return false;\n  const primary = primaryBrowser(ctx);\n  const siblings = await new SnapshotModel(ctx.db, ctx.tables).listByBuild(ctx.build.id);\n  return siblings.some(\n    (snapshot) =>\n      snapshot.storyId === capture.story.id &&\n      snapshot.viewportName === capture.viewportName &&\n      (snapshot.browser ?? DEFAULT_BROWSER) === primary &&\n      (snapshot.status === \"approved\" || snapshot.status === \"unchanged\"),\n  );\n}\n\n/** Persist one inherited snapshot; returns the story id on failure. */\nasync function tryPersistInherited(\n  ctx: CaptureContext,\n  inherited: InheritedStory,\n): Promise<string | null> {\n  try {\n    await persistInheritedSnapshot(ctx, inherited);\n    return null;\n  } catch (error) {\n    ctx.logger?.error(\n      { storyId: inherited.story.id, viewport: inherited.viewport.name, err: error },\n      \"inherit failed for story\",\n    );\n    await emitAttemptLog(ctx.recordLog, ctx.logger, \"error\", \"inherit failed for story\", {\n      storyId: inherited.story.id,\n      viewport: inherited.viewport.name,\n    });\n    return inherited.story.id;\n  }\n}\n\n/** Persist inherited snapshots; a failure marks the story failed. */\n/** Persist the inherited snapshots (stories reusing their baseline); returns the story ids that failed. */\nexport async function persistInherited(ctx: CaptureContext): Promise<ReadonlySet<string>> {\n  const outcomes = await mapLimit(ctx.inherited ?? [], PERSIST_CONCURRENCY, async (inherited) => {\n    const failed = await tryPersistInherited(ctx, inherited);\n    ctx.progress?.();\n    return failed;\n  });\n  return new Set(outcomes.filter((id): id is string => id !== null));\n}\n\n/** Create an unchanged snapshot reusing the baseline screenshot. */\nasync function persistInheritedSnapshot(\n  ctx: CaptureContext,\n  inherited: InheritedStory,\n): Promise<void> {\n  const browser = browserOf(inherited);\n  // Nothing rendered, so there is no new fingerprint: the snapshot carries the baseline's.\n  const infraHash = inherited.baseline.infraHash;\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    browser,\n    storyId: inherited.story.id,\n    storyName: inherited.story.name,\n    storyTitle: inherited.story.title,\n    storyImportPath: inherited.story.importPath ?? \"\",\n    designUrl: inherited.story.designUrl ?? null,\n    viewportName: inherited.viewport.name,\n    viewportWidth: inherited.viewport.width,\n    viewportHeight: inherited.viewport.height,\n    screenshotPath: inherited.baseline.screenshotPath,\n    infraHash,\n    mode: modeJsonOf(inherited.viewport),\n    inherited: true,\n    baselineId: inherited.baseline.id,\n    baselineVersion: inherited.baseline.updatedAt,\n  });\n  await snapshots.update(snapshot.id, {\n    status: \"unchanged\",\n    diffPixels: 0,\n    diffRatio: 0,\n    diffPassed: true,\n    diffPath: null,\n    infraHash,\n  });\n}\n\n/** Every story covered by a capture run, rendered or inherited. */\nfunction allStoryIds(ctx: CaptureContext): ReadonlySet<string> {\n  const ids = new Set(ctx.captures.map((capture) => capture.story.id));\n  for (const inherited of ctx.inherited ?? []) {\n    ids.add(inherited.story.id);\n  }\n  return ids;\n}\n\n/** Table handles required by the capture pipeline. */\nexport type PipelineTables = BuildTables & BaselineTables & SnapshotTables;\n\n/** Persistence inputs for a completed capture run. */\nexport interface CaptureContext {\n  /** Database adapter. */\n  db: DatabaseAdapter;\n  /** Table handles. */\n  tables: PipelineTables;\n  /** Storage adapter. */\n  storage: StorageAdapter;\n  /** The project being captured. */\n  project: Project;\n  /** The build being captured. */\n  build: Build;\n  /** Viewports at which stories were captured. */\n  viewports: Viewport[];\n  /** Engines captured this run, primary first (default: chromium only). */\n  browsers?: string[];\n  /** Secondary engines with no baselines yet; worked out by `persistCapture`, or fixed up front by a shard plan. */\n  freshBrowsers?: ReadonlySet<string>;\n  /** Screenshot buffers produced by the capture renderer. */\n  captures: RenderedSnapshot[];\n  /** Stories inheriting their baseline without rendering (affected capture). */\n  inherited?: InheritedStory[];\n  /** Optional logger for capture diagnostics. */\n  logger?: Logger;\n  /** Optional per-attempt log recorder (mirrors logger lines into the DB). */\n  recordLog?: AttemptLogRecorder;\n  /** Called per snapshot persisted, so the job's lease sees a long diff phase making progress. */\n  progress?: CaptureProgress | undefined;\n  /** Server secret for decrypting webhook secrets at send time. */\n  secret?: SecretInput;\n}\n\n/** JSON for the snapshot `mode` column: the globals a mode applied (null for plain viewports). */\nfunction modeJsonOf(viewport: Viewport | undefined): string | null {\n  return viewport?.globals ? JSON.stringify(viewport.globals) : null;\n}\n\nfunction viewportByName(ctx: CaptureContext, name: string): Viewport {\n  return ctx.viewports.find((v) => v.name === name) ?? { name, width: 0, height: 0 };\n}\n\n/** Where the capture's screenshot lives: already stored by the orchestrator, or stored now. */\nasync function screenshotLocation(ctx: CaptureContext, capture: RenderedSnapshot): Promise<string> {\n  if (capture.storedPath) {\n    return capture.storedPath;\n  }\n  assertScreenshotBuffer(capture.screenshot);\n  return await storeScreenshot(ctx.storage, ctx.project.id, capture.screenshot);\n}\n\nasync function persistSnapshot(ctx: CaptureContext, capture: RenderedSnapshot): Promise<void> {\n  const viewport = capture.viewport ?? viewportByName(ctx, capture.viewportName);\n  const browser = browserOf(capture);\n  const screenshot = await screenshotLocation(ctx, capture);\n\n  const baseline = await resolveBaseline(ctx, capture.story.id, capture.viewportName, browser);\n  if (!baseline) {\n    await createWithoutBaseline(ctx, capture, viewport, screenshot);\n    return;\n  }\n  await createWithBaseline(ctx, capture, viewport, screenshot, baseline);\n}\n\nasync function resolveBaseline(\n  ctx: CaptureContext,\n  storyId: string,\n  viewport: string,\n  browser: string,\n): Promise<Baseline | null> {\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  return await baselines.resolve(\n    ctx.project.id,\n    storyId,\n    viewport,\n    ctx.build.gitBranch,\n    ctx.project.gitDefaultBranch,\n    browser,\n  );\n}\n\nasync function createWithoutBaseline(\n  ctx: CaptureContext,\n  capture: RenderedSnapshot,\n  viewport: Viewport,\n  screenshot: string,\n): Promise<void> {\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const browser = browserOf(capture);\n  const accepted = ctx.build.isDefault || (await bootstrapAccepts(ctx, capture));\n  const status = accepted ? \"approved\" : \"new\";\n  const now = fingerprintOf(capture, viewport);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    browser,\n    durationMs: capture.durationMs ?? null,\n    a11yViolations: a11yJsonOf(capture),\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    designUrl: capture.story.designUrl ?? null,\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n    infraHash: now.infraHash,\n    mode: modeJsonOf(viewport),\n    baselineVersion: NO_BASELINE,\n  });\n  await snapshots.setStatus(snapshot.id, status);\n\n  if (accepted) {\n    const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n    await baselines.upsert(\n      ctx.project.id,\n      capture.story.id,\n      capture.viewportName,\n      ctx.build.gitBranch,\n      snapshot.id,\n      screenshot,\n      now.infraHash,\n      { mode: modeJsonOf(viewport), browser, fingerprint: now.json },\n    );\n  }\n}\n\n/** A capture's fingerprint: its components, their hash (stored as `infraHash`), and the stored JSON. */\ninterface CaptureFingerprint {\n  fingerprint: Fingerprint;\n  infraHash: string;\n  json: string;\n}\n\nfunction fingerprintOf(capture: RenderedSnapshot, viewport: Viewport): CaptureFingerprint {\n  return captureFingerprintOf(buildFingerprint(browserOf(capture), viewport, capture.environment));\n}\n\n/** A fingerprint as stored: its hash (the `infraHash`) and JSON. */\nfunction captureFingerprintOf(fingerprint: Fingerprint): CaptureFingerprint {\n  return {\n    fingerprint,\n    infraHash: fingerprintHash(fingerprint),\n    json: JSON.stringify(fingerprint),\n  };\n}\n\n/**\n * What changed in the capture environment since the baseline was recorded, or null when nothing\n * did. Compared component by component, only where both sides report a value: a capture with no\n * environment (spooled before a browser crash) is unknown, not a change. A baseline from before\n * fingerprints cannot be compared, so it is never reported as changed; it is backfilled instead.\n */\nfunction environmentChange(baseline: Baseline, now: CaptureFingerprint): EnvironmentChange | null {\n  const from = parseFingerprint(baseline.fingerprint);\n  if (!from) {\n    return null;\n  }\n  const changed = changedFields(from, now.fingerprint);\n  return changed.length > 0 ? { changed, from, to: now.fingerprint } : null;\n}\n\n/**\n * A changed environment migrates the baseline without a diff only on the default branch, which is\n * authoritative and auto-approves its own changes anyway. A feature branch still diffs: a real\n * change is reported as `changed` with the environment change attached, never auto-accepted.\n */\nasync function createWithBaseline(\n  ctx: CaptureContext,\n  capture: RenderedSnapshot,\n  viewport: Viewport,\n  screenshot: string,\n  baseline: Baseline,\n): Promise<void> {\n  const now = fingerprintOf(capture, viewport);\n  const change = environmentChange(baseline, now);\n  const input = { ctx, capture, viewport, screenshot, baseline, now, change };\n  if (change && ctx.build.isDefault) {\n    await persistMigration(input, change);\n  } else {\n    await persistDiff(input);\n  }\n}\n\ninterface BaselineCapture {\n  ctx: CaptureContext;\n  capture: RenderedSnapshot;\n  viewport: Viewport;\n  screenshot: string;\n  baseline: Baseline;\n  now: CaptureFingerprint;\n  change: EnvironmentChange | null;\n}\n\n/** The fingerprint to write on the baseline: the capture's, keeping components it did not report. */\nfunction baselineFingerprintOf(input: BaselineCapture): CaptureFingerprint {\n  const earlier = parseFingerprint(input.baseline.fingerprint);\n  return captureFingerprintOf(mergeFingerprint(earlier, input.now.fingerprint));\n}\n\nfunction snapshotInput(input: BaselineCapture): Parameters<SnapshotModel[\"create\"]>[2] {\n  const { capture, viewport, screenshot, baseline, now } = input;\n  return {\n    browser: browserOf(capture),\n    durationMs: capture.durationMs ?? null,\n    a11yViolations: a11yJsonOf(capture),\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    designUrl: capture.story.designUrl ?? null,\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n    infraHash: now.infraHash,\n    mode: modeJsonOf(viewport),\n    baselineId: baseline.id,\n    baselineVersion: baseline.updatedAt,\n  };\n}\n\n/**\n * The default branch's capture environment changed (browser build, fonts, platform, scale): pixels\n * would differ with no code change, so no diff is computed. The snapshot is accepted, records what\n * changed, and the new screenshot becomes the baseline.\n */\nasync function persistMigration(input: BaselineCapture, change: EnvironmentChange): Promise<void> {\n  const { ctx, capture, viewport, screenshot, now } = input;\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    ...snapshotInput(input),\n    envChange: JSON.stringify(change),\n  });\n  await snapshots.update(snapshot.id, {\n    status: \"unchanged\",\n    diffPath: null,\n    diffPixels: 0,\n    diffRatio: 0,\n    diffPassed: true,\n    infraHash: now.infraHash,\n  });\n  await upsertDefaultBaseline(ctx, snapshot.id, capture, screenshot, baselineFingerprintOf(input));\n  ctx.logger?.debug(\n    { storyId: capture.story.id, viewport: viewport.name, changed: change.changed },\n    \"capture environment changed; accepted without a diff\",\n  );\n}\n\n/** Diff against the baseline; a feature-branch environment change rides along as `envChange`. */\nasync function persistDiff(input: BaselineCapture): Promise<void> {\n  const { ctx, capture, screenshot, baseline, now, change } = input;\n  const result = await diffStoredScreenshots(\n    ctx.storage,\n    ctx.project,\n    baseline.screenshotPath,\n    screenshot,\n    capture.story.parameters?.diffThreshold,\n  );\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    ...snapshotInput(input),\n    ...(change ? { envChange: JSON.stringify(change) } : {}),\n  });\n  const diff = diffPath(\n    ctx.project.id,\n    ctx.build.id,\n    capture.story.id,\n    capture.viewportName,\n    browserOf(capture),\n  );\n  const overlay = await writeDiffOverlay(ctx.storage, diff, result, result.passed);\n  await snapshots.update(snapshot.id, {\n    status: diffStatus(result.passed, ctx.build.isDefault),\n    diffPath: overlay,\n    diffPixels: result.diffPixels,\n    diffRatio: result.diffRatio,\n    diffPassed: result.passed,\n    infraHash: now.infraHash,\n  });\n  if (ctx.build.isDefault) {\n    await refreshDefaultBaseline(input, snapshot.id, result.passed);\n  }\n}\n\n/**\n * After a default-branch diff: a failed diff moves the baseline to the new screenshot; a passing\n * one backfills the fingerprint when it was missing or had components the capture now reports.\n */\nasync function refreshDefaultBaseline(\n  input: BaselineCapture,\n  snapshotId: string,\n  passed: boolean,\n): Promise<void> {\n  const { ctx, capture, screenshot, baseline } = input;\n  const target = baselineFingerprintOf(input);\n  if (!passed) {\n    await upsertDefaultBaseline(ctx, snapshotId, capture, screenshot, target);\n  } else if (!baseline.fingerprint || baseline.infraHash !== target.infraHash) {\n    await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).backfillFingerprint(\n      baseline,\n      target.infraHash,\n      target.json,\n    );\n  }\n}\n\n/** Default-branch builds are authoritative: the captured screenshot becomes the baseline. */\nasync function upsertDefaultBaseline(\n  ctx: CaptureContext,\n  snapshotId: string,\n  capture: RenderedSnapshot,\n  screenshot: string,\n  now: CaptureFingerprint,\n): Promise<void> {\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  await baselines.upsert(\n    ctx.project.id,\n    capture.story.id,\n    capture.viewportName,\n    ctx.build.gitBranch,\n    snapshotId,\n    screenshot,\n    now.infraHash,\n    { mode: modeJsonOf(capture.viewport), browser: browserOf(capture), fingerprint: now.json },\n  );\n}\n\n/** Snapshot status after diffing: default-branch changes are auto-approved, not queued for review. */\nexport function diffStatus(passed: boolean, isDefault: boolean): SnapshotStatus {\n  if (passed) {\n    return \"unchanged\";\n  }\n  return isDefault ? \"approved\" : \"changed\";\n}\n\n/** A failed capture fails the build; default-branch builds otherwise auto-approve. */\nfunction finalBuildStatus(\n  isDefault: boolean,\n  failedCount: number,\n  hasCaptures: boolean,\n  build: { changedCount: number },\n): BuildStatus {\n  if (failedCount > 0) {\n    return \"failed\";\n  }\n  if (isDefault || (hasCaptures && build.changedCount === 0)) {\n    return \"approved\";\n  }\n  return \"reviewing\";\n}\n\n/**\n * Close out a capture: roll the snapshot counts up, set the build's final status from the failed\n * story ids, and (on the default branch) drop baselines of stories that no longer exist.\n */\nexport async function finalizeBuild(\n  ctx: CaptureContext,\n  storyIds: ReadonlySet<string>,\n  failedStoryIds: ReadonlySet<string>,\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<void> {\n  const builds = new BuildModel(ctx.db, ctx.tables, ctx.logger);\n  if ((await builds.get(ctx.build.id))?.status === \"cancelled\") {\n    ctx.logger?.debug({ buildId: ctx.build.id }, \"build is cancelled; finalize skipped\");\n    return;\n  }\n  const build = await builds.updateCounts(ctx.build.id);\n  const hasCaptures = storyIds.size > 0;\n  const status = finalBuildStatus(ctx.build.isDefault, failedStoryIds.size, hasCaptures, build);\n  // Flaky and a11y failures do not block: log warning if any failed non-blocking\n  if (flakyFailedStoryIds.size > 0 && failedStoryIds.size === 0) {\n    ctx.logger?.warn(\n      { flakyStoryIds: [...flakyFailedStoryIds] },\n      \"flaky stories failed (non-blocking)\",\n    );\n    await emitAttemptLog(ctx.recordLog, ctx.logger, \"warn\", \"flaky stories failed (non-blocking)\", {\n      flakyStoryIds: [...flakyFailedStoryIds],\n    });\n  }\n  if (a11yFailedStoryIds.size > 0 && failedStoryIds.size === 0) {\n    ctx.logger?.warn(\n      { a11yStoryIds: [...a11yFailedStoryIds] },\n      \"a11y violations found (non-blocking)\",\n    );\n    await emitAttemptLog(\n      ctx.recordLog,\n      ctx.logger,\n      \"warn\",\n      \"a11y violations found (non-blocking)\",\n      {\n        a11yStoryIds: [...a11yFailedStoryIds],\n      },\n    );\n  }\n  await builds.setStatus(ctx.build.id, status);\n\n  if (ctx.build.isDefault && hasCaptures) {\n    const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n    await baselines.removeOrphans(ctx.project.id, new Set(storyIds));\n  }\n}\n"],"mappings":"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"}

package/dist/capture/progress.d.mts

@@ -0,0 +1,11 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/capture/progress.d.ts
+/**
+ * Called by a capture as it moves: a screenshot taken, a snapshot persisted, a stage done. Cheap
+ * and synchronous, so the hot loops of render and persist can call it on every item.
+ */
+type CaptureProgress = () => void;
+//#endregion
+export { CaptureProgress };
+//# sourceMappingURL=progress.d.mts.map

package/dist/capture/progress.mjs

@@ -0,0 +1,28 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/capture/progress.ts
+/** Shortest gap between two lease touches: a forked child sends one IPC message per touch. */
+const PROGRESS_THROTTLE_MS = 1e3;
+/**
+* The progress callback for a job: touches its lease, at most once per `everyMs`. The first call
+* always goes through. Undefined without a lease, so callers skip the work entirely.
+*
+* Liveness comes from the job reporting work done rather than from a timer, so a hung render or
+* diff still lets the lease expire (see {@link JobLease}).
+*/
+function leaseProgress(lease, everyMs = PROGRESS_THROTTLE_MS, now = Date.now) {
+	if (!lease) return;
+	let last = Number.NEGATIVE_INFINITY;
+	return () => {
+		const at = now();
+		if (at - last >= everyMs) {
+			last = at;
+			lease.touch();
+		}
+	};
+}
+//#endregion
+export { PROGRESS_THROTTLE_MS, leaseProgress };
+
+//# sourceMappingURL=progress.mjs.map

package/dist/capture/progress.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.mjs","names":[],"sources":["../../src/capture/progress.ts"],"sourcesContent":["/** Progress reporting for a running capture job, kept apart from its logging. */\nimport type { JobLease } from \"./job-lease.ts\";\n\n/**\n * Called by a capture as it moves: a screenshot taken, a snapshot persisted, a stage done. Cheap\n * and synchronous, so the hot loops of render and persist can call it on every item.\n */\nexport type CaptureProgress = () => void;\n\n/** Shortest gap between two lease touches: a forked child sends one IPC message per touch. */\nexport const PROGRESS_THROTTLE_MS = 1000;\n\n/**\n * The progress callback for a job: touches its lease, at most once per `everyMs`. The first call\n * always goes through. Undefined without a lease, so callers skip the work entirely.\n *\n * Liveness comes from the job reporting work done rather than from a timer, so a hung render or\n * diff still lets the lease expire (see {@link JobLease}).\n */\nexport function leaseProgress(\n  lease?: JobLease,\n  everyMs: number = PROGRESS_THROTTLE_MS,\n  now: () => number = Date.now,\n): CaptureProgress | undefined {\n  if (!lease) {\n    return undefined;\n  }\n  let last = Number.NEGATIVE_INFINITY;\n  return () => {\n    const at = now();\n    if (at - last >= everyMs) {\n      last = at;\n      lease.touch();\n    }\n  };\n}\n"],"mappings":";;;;;AAUA,MAAa,uBAAuB;;;;;;;;AASpC,SAAgB,cACd,OACA,UAAkB,sBAClB,MAAoB,KAAK,KACI;CAC7B,IAAI,CAAC,OACH;CAEF,IAAI,OAAO,OAAO;CAClB,aAAa;EACX,MAAM,KAAK,IAAI;EACf,IAAI,KAAK,QAAQ,SAAS;GACxB,OAAO;GACP,MAAM,MAAM;EACd;CACF;AACF"}