@storyshelf/core 0.6.2 → 0.7.0

package/dist/capture/modes.mjs

@@ -0,0 +1,107 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/capture/modes.ts
+/** Upper bound on captures (global viewports + modes) per story. */
+const MAX_MODES_PER_STORY = 8;
+const SLUG_STRIP = /[^a-z0-9]+/gu;
+const SLUG_EDGES = /^-+|-+$/gu;
+const HEX_COLOR = /^#(?<hex>[0-9a-fA-F]{3,8})$/u;
+/**
+* Baseline identity for a mode name: lower-case, URL/path-safe, stable under
+* whitespace/case edits. Throws for names with no usable characters.
+*/
+function modeSlug(name) {
+	const slug = name.toLowerCase().replace(SLUG_STRIP, "-").replace(SLUG_EDGES, "");
+	if (slug === "") throw new Error(`Invalid mode name: ${JSON.stringify(name)}`);
+	return slug;
+}
+/**
+* Apply `modes` on top of a story's base viewports. A mode named like an
+* existing viewport replaces it; `disable: true` drops that entry (inherited
+* mode or viewport). Output order: base viewports first, then new modes.
+*/
+function applyModes(modes, base, lookup) {
+	if (!modes) return [...base];
+	const bySlug = new Map(base.map((viewport) => [modeSlug(viewport.name), viewport]));
+	const fallback = base[0] ?? {
+		name: "desktop",
+		width: 1280,
+		height: 720
+	};
+	for (const [name, definition] of Object.entries(modes)) {
+		const slug = modeSlug(name);
+		if (definition.disable === true) bySlug.delete(slug);
+		else bySlug.set(slug, modeViewport(slug, definition, fallback, lookup));
+	}
+	return [...bySlug.values()];
+}
+/** Keep only allow-listed modes; `null`/empty allowlist keeps all. */
+function filterModes(modes, allowlist) {
+	if (!modes || !allowlist || allowlist.length === 0) return modes;
+	const allowed = new Set(allowlist.map((name) => modeSlug(name)));
+	return Object.fromEntries(Object.entries(modes).filter(([name, definition]) => definition.disable === true || allowed.has(modeSlug(name))));
+}
+/** Parse the project's JSON `modesAllowlist` column; `null` when unset/invalid. */
+function parseModesAllowlist(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		return isStringArray(parsed) ? parsed : null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Encode globals for Storybook's `globals` URL arg (`a:b;c.d:e`). Nested
+* objects flatten to dot paths; booleans/null/undefined/hex colors use the
+* `!`-prefixed forms Storybook parses. Plain strings pass through (Storybook
+* only accepts `[a-zA-Z0-9 _-]` and silently drops anything else).
+*/
+function buildGlobalsParam(globals) {
+	return flatten(globals, "").map(([key, value]) => `${key}:${encodeValue(value)}`).join(";");
+}
+function isStringArray(value) {
+	return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function modeViewport(slug, definition, fallback, lookup) {
+	const { viewport, disable: _disable, ...globals } = definition;
+	const size = resolveSize(viewport, fallback, lookup);
+	return {
+		name: slug,
+		width: size.width,
+		height: size.height,
+		...Object.keys(globals).length > 0 ? { globals } : {}
+	};
+}
+function resolveSize(value, fallback, lookup) {
+	if (value === void 0) return fallback;
+	if (typeof value === "number") return {
+		width: Math.round(value),
+		height: fallback.height
+	};
+	if (typeof value === "string") return lookup(value) ?? fallback;
+	return {
+		width: Math.round(value.width),
+		height: Math.round(value.height)
+	};
+}
+function flatten(value, prefix) {
+	return Object.entries(value).flatMap(([key, entry]) => isPlainObject(entry) ? flatten(entry, `${prefix}${key}.`) : [[`${prefix}${key}`, entry]]);
+}
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function encodeValue(value) {
+	if (value === true) return "!true";
+	if (value === false) return "!false";
+	if (value === null) return "!null";
+	if (value === void 0) return "!undefined";
+	const text = typeof value === "string" || typeof value === "number" ? String(value) : JSON.stringify(value) ?? "";
+	const hex = HEX_COLOR.exec(text)?.groups?.["hex"];
+	return hex ? `!hex(${hex})` : text;
+}
+//#endregion
+export { MAX_MODES_PER_STORY, applyModes, buildGlobalsParam, filterModes, modeSlug, parseModesAllowlist };
+
+//# sourceMappingURL=modes.mjs.map

package/dist/capture/modes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.mjs","names":[],"sources":["../../src/capture/modes.ts"],"sourcesContent":["/** Named capture modes: parameters → viewports carrying Storybook globals. */\nimport type { ModeDefinition, ModeMap, ModeViewportValue, Viewport } from \"./adapter.ts\";\n\n/** Upper bound on captures (global viewports + modes) per story. */\nexport const MAX_MODES_PER_STORY = 8;\n\n/** Resolves a Storybook viewport name to dimensions (story config, then builtins). */\nexport type ViewportLookup = (name: string) => Viewport | undefined;\n\nconst SLUG_STRIP = /[^a-z0-9]+/gu;\nconst SLUG_EDGES = /^-+|-+$/gu;\nconst HEX_COLOR = /^#(?<hex>[0-9a-fA-F]{3,8})$/u;\n\n/**\n * Baseline identity for a mode name: lower-case, URL/path-safe, stable under\n * whitespace/case edits. Throws for names with no usable characters.\n */\nexport function modeSlug(name: string): string {\n  const slug = name.toLowerCase().replace(SLUG_STRIP, \"-\").replace(SLUG_EDGES, \"\");\n  if (slug === \"\") {\n    throw new Error(`Invalid mode name: ${JSON.stringify(name)}`);\n  }\n  return slug;\n}\n\n/**\n * Apply `modes` on top of a story's base viewports. A mode named like an\n * existing viewport replaces it; `disable: true` drops that entry (inherited\n * mode or viewport). Output order: base viewports first, then new modes.\n */\nexport function applyModes(\n  modes: ModeMap | undefined,\n  base: Viewport[],\n  lookup: ViewportLookup,\n): Viewport[] {\n  if (!modes) return [...base];\n  const bySlug = new Map<string, Viewport>(\n    base.map((viewport) => [modeSlug(viewport.name), viewport]),\n  );\n  const fallback = base[0] ?? { name: \"desktop\", width: 1280, height: 720 };\n  for (const [name, definition] of Object.entries(modes)) {\n    const slug = modeSlug(name);\n    if (definition.disable === true) {\n      bySlug.delete(slug);\n    } else {\n      bySlug.set(slug, modeViewport(slug, definition, fallback, lookup));\n    }\n  }\n  return [...bySlug.values()];\n}\n\n/** Keep only allow-listed modes; `null`/empty allowlist keeps all. */\nexport function filterModes(\n  modes: ModeMap | undefined,\n  allowlist: readonly string[] | null,\n): ModeMap | undefined {\n  if (!modes || !allowlist || allowlist.length === 0) return modes;\n  const allowed = new Set(allowlist.map((name) => modeSlug(name)));\n  return Object.fromEntries(\n    Object.entries(modes).filter(\n      ([name, definition]) => definition.disable === true || allowed.has(modeSlug(name)),\n    ),\n  );\n}\n\n/** Parse the project's JSON `modesAllowlist` column; `null` when unset/invalid. */\nexport function parseModesAllowlist(raw: string | null | undefined): string[] | null {\n  if (!raw) return null;\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    return isStringArray(parsed) ? parsed : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Encode globals for Storybook's `globals` URL arg (`a:b;c.d:e`). Nested\n * objects flatten to dot paths; booleans/null/undefined/hex colors use the\n * `!`-prefixed forms Storybook parses. Plain strings pass through (Storybook\n * only accepts `[a-zA-Z0-9 _-]` and silently drops anything else).\n */\nexport function buildGlobalsParam(globals: Record<string, unknown>): string {\n  return flatten(globals, \"\")\n    .map(([key, value]) => `${key}:${encodeValue(value)}`)\n    .join(\";\");\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every((item) => typeof item === \"string\");\n}\n\nfunction modeViewport(\n  slug: string,\n  definition: ModeDefinition,\n  fallback: Viewport,\n  lookup: ViewportLookup,\n): Viewport {\n  const { viewport, disable: _disable, ...globals } = definition;\n  const size = resolveSize(viewport, fallback, lookup);\n  return {\n    name: slug,\n    width: size.width,\n    height: size.height,\n    ...(Object.keys(globals).length > 0 ? { globals } : {}),\n  };\n}\n\nfunction resolveSize(\n  value: ModeViewportValue | undefined,\n  fallback: Viewport,\n  lookup: ViewportLookup,\n): { width: number; height: number } {\n  if (value === undefined) return fallback;\n  if (typeof value === \"number\") return { width: Math.round(value), height: fallback.height };\n  if (typeof value === \"string\") return lookup(value) ?? fallback;\n  return { width: Math.round(value.width), height: Math.round(value.height) };\n}\n\nfunction flatten(value: Record<string, unknown>, prefix: string): [string, unknown][] {\n  return Object.entries(value).flatMap(([key, entry]): [string, unknown][] =>\n    isPlainObject(entry) ? flatten(entry, `${prefix}${key}.`) : [[`${prefix}${key}`, entry]],\n  );\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction encodeValue(value: unknown): string {\n  if (value === true) return \"!true\";\n  if (value === false) return \"!false\";\n  if (value === null) return \"!null\";\n  if (value === undefined) return \"!undefined\";\n  const text =\n    typeof value === \"string\" || typeof value === \"number\"\n      ? String(value)\n      : (JSON.stringify(value) ?? \"\");\n  const hex = HEX_COLOR.exec(text)?.groups?.[\"hex\"];\n  return hex ? `!hex(${hex})` : text;\n}\n"],"mappings":"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"}

package/dist/capture/orchestrator.d.mts

@@ -3,13 +3,16 @@ import __tsdown_shims_url from 'node:url';
 import { Viewport } from "./adapter.mjs";
 import { CaptureRunner } from "../adapter/capture-runner.mjs";
 import { DatabaseAdapter } from "../adapter/database.mjs";
+import { DesignProvider } from "../adapter/design.mjs";
 import { StorageAdapter } from "../adapter/storage.mjs";
 import { SecretInput } from "../utils/encrypt.mjs";
 import { BuildTables } from "../models/build.mjs";
 import { AttemptLogRecorder, CaptureAttemptTables } from "../models/capture-attempt.mjs";
 import { CaptureLogTables } from "../models/capture-log.mjs";
 import { ProjectTables } from "../models/project.mjs";
+import { CaptureProgress } from "./progress.mjs";
 import { PipelineTables } from "./pipeline.mjs";
+import { ExtractionLimits } from "./publish/limits.mjs";
 import { Logger } from "pino";
 //#region src/capture/orchestrator.d.ts
 /** Table handles required by the orchestrator. */
@@ -21,12 +24,42 @@ interface CaptureJobOptions {
   storage: StorageAdapter;
   runner: CaptureRunner;
   scratchDir: string;
+  /** Entry and size caps of the zip extraction (`maxZipEntries`, `maxUnzippedBytes`); built-in defaults when unset. */
+  limits?: ExtractionLimits | undefined;
   viewports?: Viewport[];
   logger?: Logger;
   /** Server secret for decrypting webhook secrets at send time. */
   secret?: SecretInput;
+  /** Design providers validating declared design links; none ⇒ links are not extracted. */
+  design?: DesignProvider[];
+  /** The resolved public origin (ADR 0007, decision 6); targets that need a URL wait for it. */
+  publicOrigin?: (() => Promise<string | undefined>) | undefined;
   /** Render budget override (tests use a short fuse). */
   renderTimeoutMs?: number | undefined;
+  /**
+   * Target captures (story x viewport x engine) per shard. Unset turns sharding off; a build of up
+   * to twice this size still runs as one shard, in this process, exactly as without sharding.
+   */
+  shardSize?: number | undefined;
+  /**
+   * Puts a job on the capture queue. Sharding needs it to hand the shards out; without it every
+   * build runs in one piece.
+   */
+  enqueue?: ((job: ShardJob) => Promise<void>) | undefined;
+}
+/** A shard job: the build and the `capture_shards` row to render. */
+interface ShardJob {
+  buildId: string;
+  shard: string;
+  reqId?: string | undefined;
+  traceparent?: string | undefined;
+}
+/** What a capture job reports: counts for the attempt row, and how many shards it handed out. */
+interface CaptureSummary {
+  storyCount: number;
+  failedCount: number;
+  /** Set when the build was split: the shards are still to run and this job did not finish it. */
+  shards?: number;
 }
 /** Pointer to the attempt row owning this run's log history. */
 interface CaptureAttemptRef {
@@ -47,6 +80,8 @@ interface CaptureJobInput {
   attempt?: CaptureAttemptRef;
   /** Recorder mirroring phase logs into the attempt's log history. */
   recordLog?: AttemptLogRecorder;
+  /** Reports render and persist progress to the job's lease, apart from logging. */
+  progress?: CaptureProgress | undefined;
 }
 /**
  * Run the full capture for a build: extract, render, persist, and finalize.
@@ -58,10 +93,7 @@ interface CaptureJobInput {
  * @param options - Adapters, scratch dir, viewports, and logger.
  * @returns Story and blocking-failure counts for the attempt row.
  */
-declare function executeCaptureJob(input: CaptureJobInput, options: CaptureJobOptions): Promise<{
-  storyCount: number;
-  failedCount: number;
-}>;
+declare function executeCaptureJob(input: CaptureJobInput, options: CaptureJobOptions): Promise<CaptureSummary>;
 //#endregion
-export { CaptureAttemptRef, CaptureJobInput, CaptureJobOptions, OrchestratorTables, executeCaptureJob };
+export { CaptureAttemptRef, CaptureJobInput, CaptureJobOptions, CaptureSummary, OrchestratorTables, ShardJob, executeCaptureJob };
 //# sourceMappingURL=orchestrator.d.mts.map

package/dist/capture/orchestrator.mjs

@@ -1,51 +1,34 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-import { DEFAULT_VIEWPORTS, isDisabledStory, isFlakyStory } from "./adapter.mjs";
-import { BuildModel } from "../models/build.mjs";
+import { parseDesignUrl } from "../adapter/design.mjs";
+import { assertSupportedBrowsers, resolveBrowsers } from "./browsers.mjs";
+import { offeredTargets } from "./targets.mjs";
+import { storybookUrlSource } from "./storybook-urls.mjs";
+import { parseModesAllowlist } from "./modes.mjs";
+import { DEFAULT_VIEWPORTS, isDisabledStory } from "./adapter.mjs";
 import { emitAttemptLog } from "../models/capture-attempt.mjs";
-import { ProjectModel } from "../models/project.mjs";
+import { classifyFailures } from "./failure-sets.mjs";
+import { logInvalidDesigns } from "./design.mjs";
+import { StorybookAdapter } from "./storybook.mjs";
+import { runProjectTests } from "./tests.mjs";
+import { BuildModel } from "../models/build.mjs";
 import { parentContext, withSpan } from "../tracing.mjs";
 import { roundedTimings, runWithTimings, timed } from "../utils/timing.mjs";
-import { StorybookAdapter } from "./storybook.mjs";
-import { partitionAffectedStories } from "./affected.mjs";
+import { affectedPathsFor } from "./affected.mjs";
+import { assertModeCaps, enrichStories } from "./enrich.mjs";
+import { captureAcrossBrowsers } from "./matrix.mjs";
 import { resolveViewports } from "./sizing.mjs";
 import { persistCapture } from "./pipeline.mjs";
+import { removeJobScratch } from "./scratch.mjs";
+import { fanOutCapture } from "./shards/fan-out.mjs";
 import { extractStorybookToScratch, persistStorybookStatics } from "./statics.mjs";
+import { loadTarget } from "./target.mjs";
 //#region src/capture/orchestrator.ts
-/** Default budget for one render call before the orchestrator cancels it. */
-const RENDER_TIMEOUT_MS = 9e5;
-/** Failure error text cap (persisted rows and logs stay bounded). */
-const FAILURE_ERROR_MAX = 500;
-/** Cap failure error text so one chatty runner cannot flood rows and logs. */
-function capFailures(result) {
-	return {
-		captures: result.captures,
-		failures: result.failures.map((failure) => ({
-			...failure,
-			error: failure.error.length > FAILURE_ERROR_MAX ? failure.error.slice(0, FAILURE_ERROR_MAX) : failure.error
-		}))
-	};
-}
-/** Render with a timeout; cancels the runner when the budget expires. */
-async function renderWithTimeout(runner, request, timeoutMs) {
-	let timedOut = false;
-	let timer;
-	const timeout = new Promise((_, reject) => {
-		timer = setTimeout(() => {
-			timedOut = true;
-			reject(/* @__PURE__ */ new Error(`Render timed out after ${timeoutMs}ms`));
-		}, timeoutMs);
-	});
-	timer?.unref?.();
-	try {
-		return capFailures(await Promise.race([runner.render(request), timeout]));
-	} catch (error) {
-		if (timedOut) await runner.cancel(request.buildId).catch(() => {});
-		throw error;
-	} finally {
-		clearTimeout(timer);
-	}
+/** Parser over the configured design providers, or undefined when there are none. */
+function designParser(providers) {
+	if (!providers || providers.length === 0) return void 0;
+	return (raw) => parseDesignUrl(providers, raw)?.ref ?? null;
 }
 /**
 * Run the full capture for a build: extract, render, persist, and finalize.
@@ -58,7 +41,7 @@ async function renderWithTimeout(runner, request, timeoutMs) {
 * @returns Story and blocking-failure counts for the attempt row.
 */
 async function executeCaptureJob(input, options) {
-	const builds = new BuildModel(options.db, options.tables);
+	const builds = new BuildModel(options.db, options.tables, options.logger);
 	const { build, project } = await loadTarget(options, input.buildId);
 	return await withSpan("capture.job", async () => {
 		const { result, timings } = await runWithTimings(async () => await runCapturePhases(input, options, builds, build, project));
@@ -80,13 +63,27 @@ async function runCapturePhases(input, options, builds, build, project) {
 		reqId: input.reqId,
 		...input.attempt ? { attemptNo: input.attempt.attemptNo } : {}
 	});
+	if (build.status === "cancelled") {
+		logger?.info("build is cancelled; capture skipped");
+		return {
+			storyCount: 0,
+			failedCount: 0
+		};
+	}
 	await builds.setStatus(build.id, "capturing");
 	const startTime = performance.now();
 	let extractedDir;
+	let scratchPending = true;
+	const cleanScratch = async () => {
+		if (scratchPending) {
+			scratchPending = false;
+			await removeJobScratch(options.scratchDir, project.id, build.id, logger);
+		}
+	};
 	try {
 		const extractStart = performance.now();
 		extractedDir = await timed("capture.extract", async () => await withSpan("capture.extract", async () => {
-			return await extractStorybookToScratch(options.storage, options.scratchDir, project.id, build.id);
+			return await extractStorybookToScratch(options.storage, options.scratchDir, project.id, build.id, void 0, options.limits);
 		}));
 		const extractDuration = performance.now() - extractStart;
 		logger?.info({ durationMs: Math.round(extractDuration) }, "storybook extracted");
@@ -94,69 +91,98 @@ async function runCapturePhases(input, options, builds, build, project) {
 		const storybookDir = extractedDir;
 		const staticsStart = performance.now();
 		await timed("capture.persist-statics", async () => await withSpan("capture.persist-statics", async () => {
-			await persistStorybookStatics(options.storage, storybookDir, project.id, build.id);
+			await persistStorybookStatics(options.storage, storybookDir, project.id, build.id, options.db);
 		}));
 		logger?.info({ durationMs: Math.round(performance.now() - staticsStart) }, "storybook statics persisted");
 		await emitAttemptLog(input.recordLog, logger, "info", "storybook statics persisted", { durationMs: Math.round(performance.now() - staticsStart) });
-		const stories = (await new StorybookAdapter().discover(extractedDir)).filter((s) => !isDisabledStory(s));
+		const discovered = await new StorybookAdapter().discover(extractedDir, { parseDesignUrl: designParser(options.design) });
+		logInvalidDesigns(logger, discovered);
 		const rawViewports = project.viewports;
 		const viewports = resolveViewports(rawViewports, DEFAULT_VIEWPORTS, options.viewports);
-		const browser = project.browser;
-		const partition = await partitionAffectedStories({
-			db: options.db,
-			tables: options.tables,
-			projectId: project.id,
-			branch: build.gitBranch,
-			defaultBranch: project.gitDefaultBranch,
+		const browsers = resolveBrowsers(project);
+		assertSupportedBrowsers(browsers, offeredTargets(options.runner, {
+			publicOrigin: await options.publicOrigin?.(),
+			hasSecret: options.secret !== void 0
+		}));
+		const storybookUrl = storybookUrlSource(options, {
+			build,
+			project
+		});
+		const stories = (await enrichStories({
+			runner: options.runner,
+			buildId: build.id,
+			storybookDir,
+			stories: discovered.filter((s) => !isDisabledStory(s)),
+			target: browsers[0] ?? "chromium",
+			allowlist: parseModesAllowlist(project.modesAllowlist),
+			logger,
+			storybookUrl
+		})).filter((s) => !isDisabledStory(s));
+		assertModeCaps(stories, viewports);
+		const testRun = await runProjectTests({
+			runner: options.runner,
+			builds,
+			build,
+			project,
+			storybookDir,
+			stories: discovered,
+			target: browsers[0] ?? "chromium",
+			storybookUrl,
+			logger,
+			recordLog: input.recordLog
+		});
+		const fanned = await fanOutCapture({
+			options,
+			input,
+			build,
+			project,
 			stories,
 			viewports,
-			affectedPaths: affectedPathsFor(build)
-		});
-		logger?.info({
-			rendered: partition.render.length,
-			inherited: partition.inherited.length,
-			total: stories.length
-		}, "affected capture partitioned");
-		await emitAttemptLog(input.recordLog, logger, "info", "affected capture partitioned", {
-			rendered: partition.render.length,
-			inherited: partition.inherited.length,
-			total: stories.length
+			browsers,
+			logger,
+			testFailed: testRun.blocking
 		});
+		if (fanned) {
+			await cleanScratch();
+			return fanned;
+		}
 		const renderStart = performance.now();
-		const renderTimeoutMs = options.renderTimeoutMs ?? 9e5;
-		const result = await timed("capture.render", async () => await withSpan("capture.render", async () => {
-			if (partition.render.length === 0) return {
-				captures: [],
-				failures: []
-			};
-			return await renderWithTimeout(options.runner, {
-				buildId: build.id,
-				storybookDir,
-				stories: partition.render,
-				viewports,
-				logger,
-				executePlay: project.executePlay ?? false,
-				playTimeoutMs: project.playTimeoutMs ?? 1e4,
-				runA11y: project.runA11y ?? false,
-				browser: browser ?? "chromium"
-			}, renderTimeoutMs);
-		}, { "storyshelf.render_count": partition.render.length }));
+		const matrix = await timed("capture.render", async () => await withSpan("capture.render", async () => await captureAcrossBrowsers({
+			db: options.db,
+			storage: options.storage,
+			tables: options.tables,
+			runner: options.runner,
+			recordLog: input.recordLog,
+			progress: input.progress,
+			build,
+			project,
+			stories,
+			viewports,
+			storybookDir,
+			browsers,
+			affectedPaths: affectedPathsFor(build),
+			renderTimeoutMs: options.renderTimeoutMs,
+			storybookUrl,
+			logger
+		}), { "storyshelf.browsers": browsers.join(",") }));
+		await cleanScratch();
+		const result = {
+			captures: matrix.captures,
+			failures: matrix.failures
+		};
 		const renderDuration = performance.now() - renderStart;
 		logger?.info({
 			durationMs: Math.round(renderDuration),
-			storyCount: stories.length
+			storyCount: stories.length,
+			browsers
 		}, "stories rendered");
 		await emitAttemptLog(input.recordLog, logger, "info", "stories rendered", {
 			durationMs: Math.round(renderDuration),
-			storyCount: stories.length
+			storyCount: stories.length,
+			rendered: matrix.renderCount
 		});
-		const flakyStoryIds = new Set(stories.filter((s) => isFlakyStory(s)).map((s) => s.id));
-		const blockingFailed = /* @__PURE__ */ new Set();
-		const flakyFailed = /* @__PURE__ */ new Set();
-		const a11yFailed = /* @__PURE__ */ new Set();
-		for (const f of result.failures) if (f.error.startsWith("a11y:")) a11yFailed.add(f.storyId);
-		else if (flakyStoryIds.has(f.storyId)) flakyFailed.add(f.storyId);
-		else blockingFailed.add(f.storyId);
+		const { blocking: blockingFailed, flaky: flakyFailed, a11y: a11yFailed } = classifyFailures(stories, result.failures);
+		for (const id of testRun.blocking) blockingFailed.add(id);
 		const persistStart = performance.now();
 		await timed("capture.persist", async () => await withSpan("capture.persist", async () => {
 			await persistCapture({
@@ -167,9 +193,11 @@ async function runCapturePhases(input, options, builds, build, project) {
 				build,
 				viewports,
 				captures: result.captures,
-				inherited: partition.inherited,
+				inherited: matrix.inherited,
+				browsers,
 				logger,
 				recordLog: input.recordLog,
+				progress: input.progress,
 				secret: options.secret
 			}, blockingFailed, flakyFailed, a11yFailed);
 		}));
@@ -184,6 +212,7 @@ async function runCapturePhases(input, options, builds, build, project) {
 			failedCount: blockingFailed.size
 		};
 	} catch (error) {
+		await cleanScratch();
 		const totalDuration = performance.now() - startTime;
 		logger?.error({
 			durationMs: Math.round(totalDuration),
@@ -196,25 +225,7 @@ async function runCapturePhases(input, options, builds, build, project) {
 		throw error;
 	}
 }
-/**
-* Resolve the affected import paths for a build, or `null` for full capture
-* (affected capture disabled, or no computation was posted).
-*/
-function affectedPathsFor(build) {
-	if (!build.affectedOnly) return null;
-	return BuildModel.affectedPaths(build);
-}
-async function loadTarget(options, buildId) {
-	const build = await new BuildModel(options.db, options.tables).get(buildId);
-	if (!build) throw new Error(`Build not found: ${buildId}`);
-	const project = await new ProjectModel(options.db, options.tables).get(build.projectId);
-	if (!project) throw new Error(`Project not found: ${build.projectId}`);
-	return {
-		build,
-		project
-	};
-}
 //#endregion
-export { RENDER_TIMEOUT_MS, executeCaptureJob };
+export { executeCaptureJob };
 
 //# sourceMappingURL=orchestrator.mjs.map

package/dist/capture/orchestrator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.mjs","names":[],"sources":["../../src/capture/orchestrator.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport type { CaptureRunner, RenderResult } from \"../adapters/capture-runner.ts\";\nimport type { BrowserName } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport {\n  emitAttemptLog,\n  type AttemptLogRecorder,\n  type CaptureAttemptTables,\n} from \"../models/capture-attempt.ts\";\nimport type { CaptureLogTables } from \"../models/capture-log.ts\";\nimport { ProjectModel, type ProjectTables } from \"../models/project.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport { parentContext, withSpan } from \"../tracing.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { roundedTimings, runWithTimings, timed } from \"../utils/timing.ts\";\nimport { DEFAULT_VIEWPORTS, isDisabledStory, isFlakyStory } from \"./adapter.ts\";\nimport type { Viewport } from \"./adapter.ts\";\nimport { partitionAffectedStories } from \"./affected.ts\";\nimport { persistCapture, type PipelineTables } from \"./pipeline.ts\";\nimport { resolveViewports } from \"./sizing.ts\";\nimport { extractStorybookToScratch, persistStorybookStatics } from \"./statics.ts\";\nimport { StorybookAdapter } from \"./storybook.ts\";\n\n/** Table handles required by the orchestrator. */\nexport type OrchestratorTables = BuildTables &\n  ProjectTables &\n  PipelineTables &\n  CaptureAttemptTables &\n  CaptureLogTables;\n\n/** Inputs for running a capture job against a Storybook build. */\nexport interface CaptureJobOptions {\n  db: DatabaseAdapter;\n  tables: OrchestratorTables;\n  storage: StorageAdapter;\n  runner: CaptureRunner;\n  scratchDir: string;\n  viewports?: Viewport[];\n  logger?: Logger;\n  /** Server secret for decrypting webhook secrets at send time. */\n  secret?: SecretInput;\n  /** Render budget override (tests use a short fuse). */\n  renderTimeoutMs?: number | undefined;\n}\n\n/** Default budget for one render call before the orchestrator cancels it. */\nexport const RENDER_TIMEOUT_MS = 15 * 60_000;\n\n/** Failure error text cap (persisted rows and logs stay bounded). */\nconst FAILURE_ERROR_MAX = 500;\n\n/** Render input assembled by the orchestrator for one build. */\ninterface RenderRequest {\n  buildId: string;\n  storybookDir: string;\n  stories: Parameters<CaptureRunner[\"render\"]>[0][\"stories\"];\n  viewports: Parameters<CaptureRunner[\"render\"]>[0][\"viewports\"];\n  logger: Logger | undefined;\n  executePlay: boolean;\n  playTimeoutMs: number;\n  runA11y: boolean;\n  browser: BrowserName;\n}\n\n/** Cap failure error text so one chatty runner cannot flood rows and logs. */\nfunction capFailures(result: RenderResult): RenderResult {\n  return {\n    captures: result.captures,\n    failures: result.failures.map((failure) => ({\n      ...failure,\n      error:\n        failure.error.length > FAILURE_ERROR_MAX\n          ? failure.error.slice(0, FAILURE_ERROR_MAX)\n          : failure.error,\n    })),\n  };\n}\n\n/** Render with a timeout; cancels the runner when the budget expires. */\nasync function renderWithTimeout(\n  runner: CaptureRunner,\n  request: RenderRequest,\n  timeoutMs: number,\n): Promise<RenderResult> {\n  let timedOut = false;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<never>((_, reject) => {\n    timer = setTimeout(() => {\n      timedOut = true;\n      reject(new Error(`Render timed out after ${timeoutMs}ms`));\n    }, timeoutMs);\n  });\n  timer?.unref?.();\n  try {\n    return capFailures(await Promise.race([runner.render(request), timeout]));\n  } catch (error) {\n    if (timedOut) {\n      await runner.cancel(request.buildId).catch(() => {});\n    }\n    throw error;\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\n/** Pointer to the attempt row owning this run's log history. */\nexport interface CaptureAttemptRef {\n  id: string;\n  attemptNo: number;\n  projectId: string;\n}\n\n/** Inputs for running a capture job against a Storybook build. */\nexport interface CaptureJobInput {\n  buildId: string;\n  reqId?: string;\n  /**\n   * W3C `traceparent` from the enqueueing request or queue payload.\n   * Continues the inbound trace instead of starting a root span.\n   */\n  traceparent?: string;\n  /** Attempt row owning this run; when omitted no per-attempt logs are stored. */\n  attempt?: CaptureAttemptRef;\n  /** Recorder mirroring phase logs into the attempt's log history. */\n  recordLog?: AttemptLogRecorder;\n}\n/**\n * Run the full capture for a build: extract, render, persist, and finalize.\n *\n * The run executes inside a `capture.job` span (continuing `input.traceparent`\n * when present) with one child span per pipeline phase.\n *\n * @param input - Build id plus the originating request id.\n * @param options - Adapters, scratch dir, viewports, and logger.\n * @returns Story and blocking-failure counts for the attempt row.\n */\nexport async function executeCaptureJob(\n  input: CaptureJobInput,\n  options: CaptureJobOptions,\n): Promise<{ storyCount: number; failedCount: number }> {\n  const builds = new BuildModel(options.db, options.tables);\n  const { build, project } = await loadTarget(options, input.buildId);\n  return await withSpan(\n    \"capture.job\",\n    async () => {\n      const { result, timings } = await runWithTimings(\n        async () => await runCapturePhases(input, options, builds, build, project),\n      );\n      options.logger\n        ?.child({ buildId: build.id, ...(input.reqId ? { reqId: input.reqId } : {}) })\n        ?.info({ timings: roundedTimings(timings) }, \"capture timings\");\n      return result;\n    },\n    {\n      \"storyshelf.build_id\": build.id,\n      ...(input.reqId ? { \"storyshelf.req_id\": input.reqId } : {}),\n      ...(input.attempt ? { \"storyshelf.attempt_no\": input.attempt.attemptNo } : {}),\n    },\n    parentContext(input.traceparent),\n  );\n}\n\n/** Execute the phase pipeline inside the `capture.job` span. */\nasync function runCapturePhases(\n  input: CaptureJobInput,\n  options: CaptureJobOptions,\n  builds: BuildModel,\n  build: Build,\n  project: Project,\n): Promise<{ storyCount: number; failedCount: number }> {\n  const logger = options.logger?.child({\n    buildId: input.buildId,\n    reqId: input.reqId,\n    ...(input.attempt ? { attemptNo: input.attempt.attemptNo } : {}),\n  });\n  await builds.setStatus(build.id, \"capturing\");\n\n  const startTime = performance.now();\n  let extractedDir: string | undefined;\n  try {\n    const extractStart = performance.now();\n    extractedDir = await timed(\n      \"capture.extract\",\n      async () =>\n        await withSpan(\"capture.extract\", async () => {\n          return await extractStorybookToScratch(\n            options.storage,\n            options.scratchDir,\n            project.id,\n            build.id,\n          );\n        }),\n    );\n    const extractDuration = performance.now() - extractStart;\n    logger?.info({ durationMs: Math.round(extractDuration) }, \"storybook extracted\");\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"storybook extracted\", {\n      durationMs: Math.round(extractDuration),\n    });\n\n    // Persist the extracted statics to storage so the published Storybook\n    // (`storybookDir`) can be served after the scratch dir is cleaned up.\n    // Copy to a const: closures below need the narrowed string type.\n    const storybookDir: string = extractedDir;\n    const staticsStart = performance.now();\n    await timed(\n      \"capture.persist-statics\",\n      async () =>\n        await withSpan(\"capture.persist-statics\", async () => {\n          await persistStorybookStatics(options.storage, storybookDir, project.id, build.id);\n        }),\n    );\n    logger?.info(\n      { durationMs: Math.round(performance.now() - staticsStart) },\n      \"storybook statics persisted\",\n    );\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"storybook statics persisted\", {\n      durationMs: Math.round(performance.now() - staticsStart),\n    });\n\n    const adapter = new StorybookAdapter();\n    const discovered = await adapter.discover(extractedDir);\n    const stories = discovered.filter((s) => !isDisabledStory(s));\n    // Resolve viewports via single helper (project JSON → server override → default)\n    const rawViewports = (project as unknown as { viewports?: string | null }).viewports;\n    const viewports = resolveViewports(rawViewports, DEFAULT_VIEWPORTS, options.viewports);\n    const browser = (project as unknown as { browser?: string }).browser as BrowserName | undefined;\n\n    const partition = await partitionAffectedStories({\n      db: options.db,\n      tables: options.tables,\n      projectId: project.id,\n      branch: build.gitBranch,\n      defaultBranch: project.gitDefaultBranch,\n      stories,\n      viewports,\n      affectedPaths: affectedPathsFor(build),\n    });\n    logger?.info(\n      {\n        rendered: partition.render.length,\n        inherited: partition.inherited.length,\n        total: stories.length,\n      },\n      \"affected capture partitioned\",\n    );\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"affected capture partitioned\", {\n      rendered: partition.render.length,\n      inherited: partition.inherited.length,\n      total: stories.length,\n    });\n\n    const renderStart = performance.now();\n    const renderTimeoutMs = options.renderTimeoutMs ?? RENDER_TIMEOUT_MS;\n    const result = await timed(\n      \"capture.render\",\n      async () =>\n        await withSpan(\n          \"capture.render\",\n          async () => {\n            if (partition.render.length === 0) {\n              return { captures: [], failures: [] };\n            }\n            return await renderWithTimeout(\n              options.runner,\n              {\n                buildId: build.id,\n                storybookDir,\n                stories: partition.render,\n                viewports,\n                logger,\n                executePlay: project.executePlay ?? false,\n                playTimeoutMs: project.playTimeoutMs ?? 10_000,\n                runA11y: project.runA11y ?? false,\n                browser: browser ?? \"chromium\",\n              },\n              renderTimeoutMs,\n            );\n          },\n          { \"storyshelf.render_count\": partition.render.length },\n        ),\n    );\n    const renderDuration = performance.now() - renderStart;\n    logger?.info(\n      { durationMs: Math.round(renderDuration), storyCount: stories.length },\n      \"stories rendered\",\n    );\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"stories rendered\", {\n      durationMs: Math.round(renderDuration),\n      storyCount: stories.length,\n    });\n\n    const flakyStoryIds = new Set(stories.filter((s) => isFlakyStory(s)).map((s) => s.id));\n    const blockingFailed = new Set<string>();\n    const flakyFailed = new Set<string>();\n    const a11yFailed = new Set<string>();\n    for (const f of result.failures) {\n      if (f.error.startsWith(\"a11y:\")) a11yFailed.add(f.storyId);\n      else if (flakyStoryIds.has(f.storyId)) flakyFailed.add(f.storyId);\n      else blockingFailed.add(f.storyId);\n    }\n\n    const persistStart = performance.now();\n    await timed(\n      \"capture.persist\",\n      async () =>\n        await withSpan(\"capture.persist\", async () => {\n          await persistCapture(\n            {\n              db: options.db,\n              tables: options.tables,\n              storage: options.storage,\n              project,\n              build,\n              viewports,\n              captures: result.captures,\n              inherited: partition.inherited,\n              logger,\n              recordLog: input.recordLog,\n              secret: options.secret,\n            },\n            blockingFailed,\n            flakyFailed,\n            a11yFailed,\n          );\n        }),\n    );\n    const persistDuration = performance.now() - persistStart;\n    logger?.info({ durationMs: Math.round(persistDuration) }, \"capture persisted\");\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"capture persisted\", {\n      durationMs: Math.round(persistDuration),\n    });\n\n    const totalDuration = performance.now() - startTime;\n    logger?.info({ durationMs: Math.round(totalDuration) }, \"capture completed\");\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"capture completed\", {\n      durationMs: Math.round(totalDuration),\n    });\n    return { storyCount: stories.length, failedCount: blockingFailed.size };\n  } catch (error) {\n    const totalDuration = performance.now() - startTime;\n    logger?.error({ durationMs: Math.round(totalDuration), err: error }, \"capture failed\");\n    await emitAttemptLog(input.recordLog, logger, \"error\", \"capture failed\", {\n      durationMs: Math.round(totalDuration),\n    });\n    await builds.setStatus(build.id, \"failed\").catch((markError: unknown) => {\n      logger?.error({ err: markError }, \"failed to mark build failed after capture error\");\n    });\n    throw error;\n  }\n}\n\n/**\n * Resolve the affected import paths for a build, or `null` for full capture\n * (affected capture disabled, or no computation was posted).\n */\nfunction affectedPathsFor(build: Build): string[] | null {\n  if (!build.affectedOnly) {\n    return null;\n  }\n  return BuildModel.affectedPaths(build);\n}\n\nasync function loadTarget(\n  options: CaptureJobOptions,\n  buildId: string,\n): Promise<{ build: Build; project: Project }> {\n  const build = await new BuildModel(options.db, options.tables).get(buildId);\n  if (!build) {\n    throw new Error(`Build not found: ${buildId}`);\n  }\n  const project = await new ProjectModel(options.db, options.tables).get(build.projectId);\n  if (!project) {\n    throw new Error(`Project not found: ${build.projectId}`);\n  }\n  return { build, project };\n}\n"],"mappings":"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"}
+{"version":3,"file":"orchestrator.mjs","names":[],"sources":["../../src/capture/orchestrator.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport type { CaptureRunner } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { parseDesignUrl, type DesignProvider } from \"../adapters/design.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport {\n  emitAttemptLog,\n  type AttemptLogRecorder,\n  type CaptureAttemptTables,\n} from \"../models/capture-attempt.ts\";\nimport type { CaptureLogTables } from \"../models/capture-log.ts\";\nimport type { ProjectTables } from \"../models/project.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport { parentContext, withSpan } from \"../tracing.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { roundedTimings, runWithTimings, timed } from \"../utils/timing.ts\";\nimport { DEFAULT_VIEWPORTS, isDisabledStory } from \"./adapter.ts\";\nimport type { DiscoverOptions, Viewport } from \"./adapter.ts\";\nimport { affectedPathsFor } from \"./affected.ts\";\nimport { assertSupportedBrowsers, resolveBrowsers } from \"./browsers.ts\";\nimport { logInvalidDesigns } from \"./design.ts\";\nimport { assertModeCaps, enrichStories } from \"./enrich.ts\";\nimport { classifyFailures } from \"./failure-sets.ts\";\nimport { captureAcrossBrowsers } from \"./matrix.ts\";\nimport { parseModesAllowlist } from \"./modes.ts\";\nimport { persistCapture, type PipelineTables } from \"./pipeline.ts\";\nimport type { CaptureProgress } from \"./progress.ts\";\nimport type { ExtractionLimits } from \"./publish/limits.ts\";\nimport { removeJobScratch } from \"./scratch.ts\";\nimport { fanOutCapture } from \"./shards/fan-out.ts\";\nimport { resolveViewports } from \"./sizing.ts\";\nimport { extractStorybookToScratch, persistStorybookStatics } from \"./statics.ts\";\nimport { storybookUrlSource } from \"./storybook-urls.ts\";\nimport { StorybookAdapter } from \"./storybook.ts\";\nimport { loadTarget } from \"./target.ts\";\nimport { offeredTargets } from \"./targets.ts\";\nimport { runProjectTests } from \"./tests.ts\";\n\n/** Table handles required by the orchestrator. */\nexport type OrchestratorTables = BuildTables &\n  ProjectTables &\n  PipelineTables &\n  CaptureAttemptTables &\n  CaptureLogTables;\n\n/** Inputs for running a capture job against a Storybook build. */\nexport interface CaptureJobOptions {\n  db: DatabaseAdapter;\n  tables: OrchestratorTables;\n  storage: StorageAdapter;\n  runner: CaptureRunner;\n  scratchDir: string;\n  /** Entry and size caps of the zip extraction (`maxZipEntries`, `maxUnzippedBytes`); built-in defaults when unset. */\n  limits?: ExtractionLimits | undefined;\n  viewports?: Viewport[];\n  logger?: Logger;\n  /** Server secret for decrypting webhook secrets at send time. */\n  secret?: SecretInput;\n  /** Design providers validating declared design links; none ⇒ links are not extracted. */\n  design?: DesignProvider[];\n  /** The resolved public origin (ADR 0007, decision 6); targets that need a URL wait for it. */\n  publicOrigin?: (() => Promise<string | undefined>) | undefined;\n  /** Render budget override (tests use a short fuse). */\n  renderTimeoutMs?: number | undefined;\n  /**\n   * Target captures (story x viewport x engine) per shard. Unset turns sharding off; a build of up\n   * to twice this size still runs as one shard, in this process, exactly as without sharding.\n   */\n  shardSize?: number | undefined;\n  /**\n   * Puts a job on the capture queue. Sharding needs it to hand the shards out; without it every\n   * build runs in one piece.\n   */\n  enqueue?: ((job: ShardJob) => Promise<void>) | undefined;\n}\n\n/** A shard job: the build and the `capture_shards` row to render. */\nexport interface ShardJob {\n  buildId: string;\n  shard: string;\n  reqId?: string | undefined;\n  traceparent?: string | undefined;\n}\n\n/** Parser over the configured design providers, or undefined when there are none. */\nfunction designParser(providers: DesignProvider[] | undefined): DiscoverOptions[\"parseDesignUrl\"] {\n  if (!providers || providers.length === 0) return undefined;\n  return (raw) => parseDesignUrl(providers, raw)?.ref ?? null;\n}\n\n/** What a capture job reports: counts for the attempt row, and how many shards it handed out. */\nexport interface CaptureSummary {\n  storyCount: number;\n  failedCount: number;\n  /** Set when the build was split: the shards are still to run and this job did not finish it. */\n  shards?: number;\n}\n\n/** Pointer to the attempt row owning this run's log history. */\nexport interface CaptureAttemptRef {\n  id: string;\n  attemptNo: number;\n  projectId: string;\n}\n\n/** Inputs for running a capture job against a Storybook build. */\nexport interface CaptureJobInput {\n  buildId: string;\n  reqId?: string;\n  /**\n   * W3C `traceparent` from the enqueueing request or queue payload.\n   * Continues the inbound trace instead of starting a root span.\n   */\n  traceparent?: string;\n  /** Attempt row owning this run; when omitted no per-attempt logs are stored. */\n  attempt?: CaptureAttemptRef;\n  /** Recorder mirroring phase logs into the attempt's log history. */\n  recordLog?: AttemptLogRecorder;\n  /** Reports render and persist progress to the job's lease, apart from logging. */\n  progress?: CaptureProgress | undefined;\n}\n/**\n * Run the full capture for a build: extract, render, persist, and finalize.\n *\n * The run executes inside a `capture.job` span (continuing `input.traceparent`\n * when present) with one child span per pipeline phase.\n *\n * @param input - Build id plus the originating request id.\n * @param options - Adapters, scratch dir, viewports, and logger.\n * @returns Story and blocking-failure counts for the attempt row.\n */\nexport async function executeCaptureJob(\n  input: CaptureJobInput,\n  options: CaptureJobOptions,\n): Promise<CaptureSummary> {\n  const builds = new BuildModel(options.db, options.tables, options.logger);\n  const { build, project } = await loadTarget(options, input.buildId);\n  return await withSpan(\n    \"capture.job\",\n    async () => {\n      const { result, timings } = await runWithTimings(\n        async () => await runCapturePhases(input, options, builds, build, project),\n      );\n      options.logger\n        ?.child({ buildId: build.id, ...(input.reqId ? { reqId: input.reqId } : {}) })\n        ?.info({ timings: roundedTimings(timings) }, \"capture timings\");\n      return result;\n    },\n    {\n      \"storyshelf.build_id\": build.id,\n      ...(input.reqId ? { \"storyshelf.req_id\": input.reqId } : {}),\n      ...(input.attempt ? { \"storyshelf.attempt_no\": input.attempt.attemptNo } : {}),\n    },\n    parentContext(input.traceparent),\n  );\n}\n\n/** Execute the phase pipeline inside the `capture.job` span. */\nasync function runCapturePhases(\n  input: CaptureJobInput,\n  options: CaptureJobOptions,\n  builds: BuildModel,\n  build: Build,\n  project: Project,\n): Promise<CaptureSummary> {\n  const logger = options.logger?.child({\n    buildId: input.buildId,\n    reqId: input.reqId,\n    ...(input.attempt ? { attemptNo: input.attempt.attemptNo } : {}),\n  });\n  if (build.status === \"cancelled\") {\n    logger?.info(\"build is cancelled; capture skipped\");\n    return { storyCount: 0, failedCount: 0 };\n  }\n  await builds.setStatus(build.id, \"capturing\");\n\n  const startTime = performance.now();\n  let extractedDir: string | undefined;\n  // Statics are persisted to storage once extracted; the copy on disk is only scratch. Removed as\n  // soon as rendering ends (before persist, so no I/O sits between the build's final status and the\n  // status fan-out) or on any failure, whichever comes first.\n  let scratchPending = true;\n  const cleanScratch = async (): Promise<void> => {\n    if (scratchPending) {\n      scratchPending = false;\n      await removeJobScratch(options.scratchDir, project.id, build.id, logger);\n    }\n  };\n  try {\n    const extractStart = performance.now();\n    extractedDir = await timed(\n      \"capture.extract\",\n      async () =>\n        await withSpan(\"capture.extract\", async () => {\n          return await extractStorybookToScratch(\n            options.storage,\n            options.scratchDir,\n            project.id,\n            build.id,\n            undefined,\n            options.limits,\n          );\n        }),\n    );\n    const extractDuration = performance.now() - extractStart;\n    logger?.info({ durationMs: Math.round(extractDuration) }, \"storybook extracted\");\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"storybook extracted\", {\n      durationMs: Math.round(extractDuration),\n    });\n\n    // Persist the extracted statics to storage so the published Storybook\n    // (`storybookDir`) can be served after the scratch dir is cleaned up.\n    // Copy to a const: closures below need the narrowed string type.\n    const storybookDir: string = extractedDir;\n    const staticsStart = performance.now();\n    await timed(\n      \"capture.persist-statics\",\n      async () =>\n        await withSpan(\"capture.persist-statics\", async () => {\n          await persistStorybookStatics(\n            options.storage,\n            storybookDir,\n            project.id,\n            build.id,\n            options.db,\n          );\n        }),\n    );\n    logger?.info(\n      { durationMs: Math.round(performance.now() - staticsStart) },\n      \"storybook statics persisted\",\n    );\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"storybook statics persisted\", {\n      durationMs: Math.round(performance.now() - staticsStart),\n    });\n\n    const adapter = new StorybookAdapter();\n    const discovered = await adapter.discover(extractedDir, {\n      parseDesignUrl: designParser(options.design),\n    });\n    logInvalidDesigns(logger, discovered);\n    // Resolve viewports via single helper (project JSON → server override → default)\n    const rawViewports = (project as unknown as { viewports?: string | null }).viewports;\n    const viewports = resolveViewports(rawViewports, DEFAULT_VIEWPORTS, options.viewports);\n    const browsers = resolveBrowsers(project);\n    assertSupportedBrowsers(\n      browsers,\n      offeredTargets(options.runner, {\n        publicOrigin: await options.publicOrigin?.(),\n        hasSecret: options.secret !== undefined,\n      }),\n    );\n    const storybookUrl = storybookUrlSource(options, { build, project });\n    const enriched = await enrichStories({\n      runner: options.runner,\n      buildId: build.id,\n      storybookDir,\n      stories: discovered.filter((s) => !isDisabledStory(s)),\n      target: browsers[0] ?? \"chromium\",\n      allowlist: parseModesAllowlist(project.modesAllowlist),\n      logger,\n      storybookUrl,\n    });\n    const stories = enriched.filter((s) => !isDisabledStory(s));\n    assertModeCaps(stories, viewports);\n    // Opt-in `.test()` runs: a failing test fails the build like a failing play function.\n    const testRun = await runProjectTests({\n      runner: options.runner,\n      builds,\n      build,\n      project,\n      storybookDir,\n      stories: discovered,\n      target: browsers[0] ?? \"chromium\",\n      storybookUrl,\n      logger,\n      recordLog: input.recordLog,\n    });\n\n    // A big build is planned into shards that other workers render; this job's part ends there.\n    const fanned = await fanOutCapture({\n      options,\n      input,\n      build,\n      project,\n      stories,\n      viewports,\n      browsers,\n      logger,\n      testFailed: testRun.blocking,\n    });\n    if (fanned) {\n      await cleanScratch();\n      return fanned;\n    }\n\n    const renderStart = performance.now();\n    const matrix = await timed(\n      \"capture.render\",\n      async () =>\n        await withSpan(\n          \"capture.render\",\n          async () =>\n            await captureAcrossBrowsers({\n              db: options.db,\n              storage: options.storage,\n              tables: options.tables,\n              runner: options.runner,\n              recordLog: input.recordLog,\n              progress: input.progress,\n              build,\n              project,\n              stories,\n              viewports,\n              storybookDir,\n              browsers,\n              affectedPaths: affectedPathsFor(build),\n              renderTimeoutMs: options.renderTimeoutMs,\n              storybookUrl,\n              logger,\n            }),\n          { \"storyshelf.browsers\": browsers.join(\",\") },\n        ),\n    );\n    await cleanScratch();\n    const result = { captures: matrix.captures, failures: matrix.failures };\n    const renderDuration = performance.now() - renderStart;\n    logger?.info(\n      { durationMs: Math.round(renderDuration), storyCount: stories.length, browsers },\n      \"stories rendered\",\n    );\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"stories rendered\", {\n      durationMs: Math.round(renderDuration),\n      storyCount: stories.length,\n      rendered: matrix.renderCount,\n    });\n\n    const {\n      blocking: blockingFailed,\n      flaky: flakyFailed,\n      a11y: a11yFailed,\n    } = classifyFailures(stories, result.failures);\n    for (const id of testRun.blocking) blockingFailed.add(id);\n\n    const persistStart = performance.now();\n    await timed(\n      \"capture.persist\",\n      async () =>\n        await withSpan(\"capture.persist\", async () => {\n          await persistCapture(\n            {\n              db: options.db,\n              tables: options.tables,\n              storage: options.storage,\n              project,\n              build,\n              viewports,\n              captures: result.captures,\n              inherited: matrix.inherited,\n              browsers,\n              logger,\n              recordLog: input.recordLog,\n              progress: input.progress,\n              secret: options.secret,\n            },\n            blockingFailed,\n            flakyFailed,\n            a11yFailed,\n          );\n        }),\n    );\n    const persistDuration = performance.now() - persistStart;\n    logger?.info({ durationMs: Math.round(persistDuration) }, \"capture persisted\");\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"capture persisted\", {\n      durationMs: Math.round(persistDuration),\n    });\n\n    const totalDuration = performance.now() - startTime;\n    logger?.info({ durationMs: Math.round(totalDuration) }, \"capture completed\");\n    await emitAttemptLog(input.recordLog, logger, \"info\", \"capture completed\", {\n      durationMs: Math.round(totalDuration),\n    });\n    return { storyCount: stories.length, failedCount: blockingFailed.size };\n  } catch (error) {\n    await cleanScratch();\n    const totalDuration = performance.now() - startTime;\n    logger?.error({ durationMs: Math.round(totalDuration), err: error }, \"capture failed\");\n    await emitAttemptLog(input.recordLog, logger, \"error\", \"capture failed\", {\n      durationMs: Math.round(totalDuration),\n    });\n    await builds.setStatus(build.id, \"failed\").catch((markError: unknown) => {\n      logger?.error({ err: markError }, \"failed to mark build failed after capture error\");\n    });\n    throw error;\n  }\n}\n"],"mappings":"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"}

package/dist/capture/pipeline.d.mts

@@ -6,12 +6,13 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { StorageAdapter } from "../adapter/storage.mjs";
 import { SecretInput } from "../utils/encrypt.mjs";
 import { Build } from "../schema/build.mjs";
+import { Project } from "../schema/project.mjs";
 import { BuildTables } from "../models/build.mjs";
 import { AttemptLogRecorder } from "../models/capture-attempt.mjs";
-import { Project } from "../schema/project.mjs";
 import { BaselineTables } from "../models/baseline.mjs";
 import { SnapshotTables } from "../models/snapshot.mjs";
 import { InheritedStory } from "./affected.mjs";
+import { CaptureProgress } from "./progress.mjs";
 import { Logger } from "pino";
 //#region src/capture/pipeline.d.ts
 /**
@@ -27,7 +28,7 @@ import { Logger } from "pino";
  * @param flakyFailedStoryIds - Story ids that failed but are marked flaky
  * (non-blocking). They are logged as warnings and do not block the build.
  */
-declare function persistCapture(ctx: CaptureContext, renderFailedStoryIds?: ReadonlySet<string>, flakyFailedStoryIds?: ReadonlySet<string>, a11yFailedStoryIds?: ReadonlySet<string>): Promise<void>;
+declare function persistCapture(input: CaptureContext, renderFailedStoryIds?: ReadonlySet<string>, flakyFailedStoryIds?: ReadonlySet<string>, a11yFailedStoryIds?: ReadonlySet<string>): Promise<void>;
 /** Table handles required by the capture pipeline. */
 type PipelineTables = BuildTables & BaselineTables & SnapshotTables;
 /** Persistence inputs for a completed capture run. */
@@ -44,6 +45,10 @@ interface CaptureContext {
   build: Build;
   /** Viewports at which stories were captured. */
   viewports: Viewport[];
+  /** Engines captured this run, primary first (default: chromium only). */
+  browsers?: string[];
+  /** Secondary engines with no baselines yet; worked out by `persistCapture`, or fixed up front by a shard plan. */
+  freshBrowsers?: ReadonlySet<string>;
   /** Screenshot buffers produced by the capture renderer. */
   captures: RenderedSnapshot[];
   /** Stories inheriting their baseline without rendering (affected capture). */
@@ -52,6 +57,8 @@ interface CaptureContext {
   logger?: Logger;
   /** Optional per-attempt log recorder (mirrors logger lines into the DB). */
   recordLog?: AttemptLogRecorder;
+  /** Called per snapshot persisted, so the job's lease sees a long diff phase making progress. */
+  progress?: CaptureProgress | undefined;
   /** Server secret for decrypting webhook secrets at send time. */
   secret?: SecretInput;
 }