@storyshelf/core 0.7.0 → 0.9.0-next-d2cc082

package/dist/models.mjs

@@ -4,8 +4,10 @@ import.meta.url;
 import { WebhookModel } from "./models/webhook.mjs";
 import { CaptureAttemptModel, emitAttemptLog } from "./models/capture-attempt.mjs";
 import { BuildModel, isPublicBuild } from "./models/build.mjs";
-import { BaselineModel } from "./models/baseline.mjs";
+import { BaselineWriteConflict } from "./models/baseline-conflict.mjs";
 import { NO_BASELINE, baselineStatus, isBaselineDrifted } from "./models/baseline-status.mjs";
+import { BaselineApprovalConflict } from "./models/baseline-approval.mjs";
+import { BaselineModel } from "./models/baseline.mjs";
 import { SnapshotModel } from "./models/snapshot.mjs";
 import { CaptureShardModel } from "./models/capture-shard.mjs";
 import { ProjectModel } from "./models/project.mjs";
@@ -18,6 +20,7 @@ import { PUBLIC_ORIGIN_KEY, createPublicOriginResolver } from "./models/public-o
 import { CaptureLogModel } from "./models/capture-log.mjs";
 import { BuildComponentModel } from "./models/build-component.mjs";
 import { normalizeImportPath, resolveDesigns } from "./models/design-resolve.mjs";
+import { resolveBaselineOrigin } from "./models/baseline-origin.mjs";
 import { BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineArchiveError } from "./models/baseline-archive.mjs";
 import { BaselineTransferModel } from "./models/baseline-transfer.mjs";
 import { AiBudgetAlertModel } from "./models/ai-budget-alert.mjs";
@@ -31,7 +34,7 @@ import { componentHistory, componentPresence, worstStatus } from "./models/compo
 import { ConnectionModel } from "./models/connections.mjs";
 import { DesignModel } from "./models/design.mjs";
 import { DesignCredentialModel, PROJECT_SCOPE } from "./models/design-credentials.mjs";
-import { DESIGN_TTL_MS, credentialDaysLeft, isDesignStale } from "./models/design-health.mjs";
+import { DESIGN_TTL_MS, credentialDaysLeft, designChange, isDesignStale } from "./models/design-health.mjs";
 import { DesignNodeModel } from "./models/design-nodes.mjs";
 import { LabelModel } from "./models/label.mjs";
 import { PackageUsageModel, matchUpstreamStory } from "./models/usage.mjs";
@@ -42,4 +45,4 @@ import { TokenModel } from "./models/token.mjs";
 import { UserModel } from "./models/user.mjs";
 import { ContentRefModel } from "./models/content-ref.mjs";
 import { probeCredentials, reencryptCredentials } from "./models/credentials.mjs";
-export { AiBudgetAlertModel, AiUsageModel, BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineArchiveError, BaselineModel, BaselineTransferModel, BuildComponentModel, BuildModel, BuildReviewModel, CaptureAttemptModel, CaptureJobModel, CaptureLogModel, CaptureShardModel, CommentModel, ConnectionModel, ContentRefModel, DESIGN_TTL_MS, DesignCredentialModel, DesignModel, DesignNodeModel, InsightModel, LabelModel, MemberModel, NO_BASELINE, NotificationChannelModel, NotificationSubscriptionModel, PROJECT_SCOPE, PUBLIC_ORIGIN_KEY, PackageUsageModel, ProjectGroupMappingModel, ProjectModel, RECENT_BUILDS_FOR_INHERITED_RATIO, SiteSettingsModel, SnapshotModel, TERMINAL_JOB_STATUSES, TokenModel, UserModel, WebhookModel, acceptPendingWithoutWork, attemptRowId, averageInheritedRatio, baselineStatus, changesetOf, componentHistory, componentPresence, computeChangeset, createPublicOriginResolver, credentialDaysLeft, deriveReviewStatus, emitAttemptLog, findChangesetBaseline, isBaselineDrifted, isDesignStale, isPublicBuild, isTerminalJob, latestVerdicts, matchUpstreamStory, normalizeImportPath, parseAttemptRowId, probeCredentials, reencryptCredentials, resolveDesigns, worstStatus };
+export { AiBudgetAlertModel, AiUsageModel, BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineApprovalConflict, BaselineArchiveError, BaselineModel, BaselineTransferModel, BaselineWriteConflict, BuildComponentModel, BuildModel, BuildReviewModel, CaptureAttemptModel, CaptureJobModel, CaptureLogModel, CaptureShardModel, CommentModel, ConnectionModel, ContentRefModel, DESIGN_TTL_MS, DesignCredentialModel, DesignModel, DesignNodeModel, InsightModel, LabelModel, MemberModel, NO_BASELINE, NotificationChannelModel, NotificationSubscriptionModel, PROJECT_SCOPE, PUBLIC_ORIGIN_KEY, PackageUsageModel, ProjectGroupMappingModel, ProjectModel, RECENT_BUILDS_FOR_INHERITED_RATIO, SiteSettingsModel, SnapshotModel, TERMINAL_JOB_STATUSES, TokenModel, UserModel, WebhookModel, acceptPendingWithoutWork, attemptRowId, averageInheritedRatio, baselineStatus, changesetOf, componentHistory, componentPresence, computeChangeset, createPublicOriginResolver, credentialDaysLeft, deriveReviewStatus, designChange, emitAttemptLog, findChangesetBaseline, isBaselineDrifted, isDesignStale, isPublicBuild, isTerminalJob, latestVerdicts, matchUpstreamStory, normalizeImportPath, parseAttemptRowId, probeCredentials, reencryptCredentials, resolveBaselineOrigin, resolveDesigns, worstStatus };

package/dist/options.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ShelfOptions } from "./config.mjs";
-//#region src/options.d.ts
 /** Where capture scratch lives when `config.scratchDir` is not set. */
 declare const DEFAULT_SCRATCH_DIR: string;
 /**
@@ -13,6 +12,5 @@ declare const DEFAULT_SCRATCH_DIR: string;
  *   with or without `testing`.
  */
 declare function resolveShelfOptions(options: ShelfOptions): ShelfOptions;
-//#endregion
 export { DEFAULT_SCRATCH_DIR, resolveShelfOptions };
 //# sourceMappingURL=options.d.mts.map

package/dist/options.mjs

@@ -1,10 +1,9 @@
-import "node:path";
+import { join } from "node:path";
 import "node:url";
 import.meta.url;
 import { notificationsConfigSchema } from "./config.mjs";
 import { tmpdir } from "node:os";
-import { join } from "node:path";
-//#region src/options.ts
+// src/options.ts
 /** Resolves `ShelfOptions` once at boot: validates `testing.compare` and fills the scratch default. */
 /** Where capture scratch lives when `config.scratchDir` is not set. */
 const DEFAULT_SCRATCH_DIR = join(tmpdir(), "storyshelf");
@@ -84,7 +83,6 @@ function assertNotificationsConfig(config) {
 		throw new Error(`Invalid notifications.config: ${issues}`);
 	}
 }
-//#endregion
 export { DEFAULT_SCRATCH_DIR, resolveShelfOptions };
 
 //# sourceMappingURL=options.mjs.map

package/dist/options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.mjs","names":[],"sources":["../src/options.ts"],"sourcesContent":["/** Resolves `ShelfOptions` once at boot: validates `testing.compare` and fills the scratch default. */\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { notificationsConfigSchema, type ShelfOptions } from \"./config.ts\";\n\n/** Where capture scratch lives when `config.scratchDir` is not set. */\nexport const DEFAULT_SCRATCH_DIR: string = join(tmpdir(), \"storyshelf\");\n\n/**\n * Validate and complete the options.\n *\n * - `testing.compare.threads` must be a non-negative integer.\n * - `notifications.config` must match its schema (it used to live in `ShelfConfig`, which validated it).\n * - `config.scratchDir` defaults to {@link DEFAULT_SCRATCH_DIR}: publishing extracts zips there,\n *   with or without `testing`.\n */\nexport function resolveShelfOptions(options: ShelfOptions): ShelfOptions {\n  assertThreads(options.testing?.compare?.threads);\n  assertTestingProcess(options.testing);\n  assertTestingBackable(options);\n  assertNotificationsConfig(options.notifications?.config);\n  if (options.config?.scratchDir !== undefined) {\n    return options;\n  }\n  return { ...options, config: { ...options.config, scratchDir: DEFAULT_SCRATCH_DIR } };\n}\n\n/**\n * A `testing` instance renders here, so it needs a database a long-running server can keep.\n */\nfunction assertTestingBackable(options: ShelfOptions): void {\n  if (options.testing === undefined) {\n    return;\n  }\n  if (options.database.metadata.supportsTesting === false) {\n    throw new Error(\n      `The ${options.database.metadata.name} database cannot back testing: it is reachable only ` +\n        `from a platform that ends the process after each request, so nothing would run capture ` +\n        `jobs. Remove the testing option to host Storybooks only, or use a network database ` +\n        `(Turso, Postgres, MySQL, SQLite on a volume).`,\n    );\n  }\n}\n\nfunction assertTestingProcess(testing: ShelfOptions[\"testing\"]): void {\n  if (testing !== undefined && testing.runner === undefined) {\n    throw new Error(\"testing requires testing.runner\");\n  }\n  if (testing?.workerEntry !== undefined && testing.runner === undefined) {\n    throw new Error(\"testing.workerEntry requires testing.runner (it is the in-process fallback)\");\n  }\n  if (testing?.mode === \"fork\" && testing.workerEntry === undefined) {\n    throw new Error('testing.mode \"fork\" requires testing.workerEntry');\n  }\n  assertShardSize(testing);\n  assertTestingNumbers(testing);\n}\n\n/** Numeric `testing` options: concurrency, retries and the Storybook URL rate limit. */\nfunction assertTestingNumbers(testing: ShelfOptions[\"testing\"]): void {\n  assertConcurrency(testing?.concurrency);\n  assertRetries(testing?.retries);\n  assertLeaseSeconds(testing?.leaseSeconds);\n  assertStorybookUrlRateLimit(testing?.storybookUrlRateLimit);\n}\n\n/** A whole number of requests per minute; `0` would refuse every render. */\nfunction assertStorybookUrlRateLimit(limit: number | undefined): void {\n  if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {\n    throw new Error(\n      `testing.storybookUrlRateLimit must be a positive whole number of requests per minute, got ${String(limit)}`,\n    );\n  }\n}\n\n/** Retries are counted after the first attempt: `0` runs a job once. */\nfunction assertRetries(retries: number | undefined): void {\n  if (retries !== undefined && (!Number.isInteger(retries) || retries < 0)) {\n    throw new Error(`testing.retries must be a non-negative integer, got ${String(retries)}`);\n  }\n}\n\n/** A lease must be a positive length: `0` would expire every job at once. */\nfunction assertLeaseSeconds(seconds: number | undefined): void {\n  if (seconds !== undefined && (!Number.isFinite(seconds) || seconds <= 0)) {\n    throw new Error(\n      `testing.leaseSeconds must be a positive number of seconds, got ${String(seconds)}`,\n    );\n  }\n}\n\n/** `0` would deadlock the consumer. */\nfunction assertConcurrency(concurrency: number | undefined): void {\n  if (concurrency !== undefined && (!Number.isInteger(concurrency) || concurrency < 1)) {\n    throw new Error(`testing.concurrency must be a positive integer, got ${String(concurrency)}`);\n  }\n}\n\nfunction assertShardSize(testing: ShelfOptions[\"testing\"]): void {\n  const size = testing?.shardSize;\n  if (size === undefined) {\n    return;\n  }\n  if (!Number.isInteger(size) || size < 1) {\n    throw new Error(`testing.shardSize must be a positive integer, got ${String(size)}`);\n  }\n  if (testing?.runner === undefined) {\n    throw new Error(\"testing.shardSize requires testing.runner (workers set their own shardSize)\");\n  }\n}\n\nfunction assertThreads(threads: number | undefined): void {\n  if (threads !== undefined && (!Number.isInteger(threads) || threads < 0)) {\n    throw new Error(\n      `testing.compare.threads must be a non-negative integer, got ${String(threads)}`,\n    );\n  }\n}\n\nfunction assertNotificationsConfig(config: unknown): void {\n  if (config === undefined) {\n    return;\n  }\n  const result = notificationsConfigSchema.safeParse(config);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`Invalid notifications.config: ${issues}`);\n  }\n}\n"],"mappings":";;;;;;;;;AAMA,MAAa,sBAA8B,KAAK,OAAO,GAAG,YAAY;;;;;;;;;AAUtE,SAAgB,oBAAoB,SAAqC;CACvE,cAAc,QAAQ,SAAS,SAAS,OAAO;CAC/C,qBAAqB,QAAQ,OAAO;CACpC,sBAAsB,OAAO;CAC7B,0BAA0B,QAAQ,eAAe,MAAM;CACvD,IAAI,QAAQ,QAAQ,eAAe,KAAA,GACjC,OAAO;CAET,OAAO;EAAE,GAAG;EAAS,QAAQ;GAAE,GAAG,QAAQ;GAAQ,YAAY;EAAoB;CAAE;AACtF;;;;AAKA,SAAS,sBAAsB,SAA6B;CAC1D,IAAI,QAAQ,YAAY,KAAA,GACtB;CAEF,IAAI,QAAQ,SAAS,SAAS,oBAAoB,OAChD,MAAM,IAAI,MACR,OAAO,QAAQ,SAAS,SAAS,KAAK,4QAIxC;AAEJ;AAEA,SAAS,qBAAqB,SAAwC;CACpE,IAAI,YAAY,KAAA,KAAa,QAAQ,WAAW,KAAA,GAC9C,MAAM,IAAI,MAAM,iCAAiC;CAEnD,IAAI,SAAS,gBAAgB,KAAA,KAAa,QAAQ,WAAW,KAAA,GAC3D,MAAM,IAAI,MAAM,6EAA6E;CAE/F,IAAI,SAAS,SAAS,UAAU,QAAQ,gBAAgB,KAAA,GACtD,MAAM,IAAI,MAAM,oDAAkD;CAEpE,gBAAgB,OAAO;CACvB,qBAAqB,OAAO;AAC9B;;AAGA,SAAS,qBAAqB,SAAwC;CACpE,kBAAkB,SAAS,WAAW;CACtC,cAAc,SAAS,OAAO;CAC9B,mBAAmB,SAAS,YAAY;CACxC,4BAA4B,SAAS,qBAAqB;AAC5D;;AAGA,SAAS,4BAA4B,OAAiC;CACpE,IAAI,UAAU,KAAA,MAAc,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,IAC9D,MAAM,IAAI,MACR,6FAA6F,OAAO,KAAK,GAC3G;AAEJ;;AAGA,SAAS,cAAc,SAAmC;CACxD,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,IACpE,MAAM,IAAI,MAAM,uDAAuD,OAAO,OAAO,GAAG;AAE5F;;AAGA,SAAS,mBAAmB,SAAmC;CAC7D,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,SAAS,OAAO,KAAK,WAAW,IACpE,MAAM,IAAI,MACR,kEAAkE,OAAO,OAAO,GAClF;AAEJ;;AAGA,SAAS,kBAAkB,aAAuC;CAChE,IAAI,gBAAgB,KAAA,MAAc,CAAC,OAAO,UAAU,WAAW,KAAK,cAAc,IAChF,MAAM,IAAI,MAAM,uDAAuD,OAAO,WAAW,GAAG;AAEhG;AAEA,SAAS,gBAAgB,SAAwC;CAC/D,MAAM,OAAO,SAAS;CACtB,IAAI,SAAS,KAAA,GACX;CAEF,IAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,GACpC,MAAM,IAAI,MAAM,qDAAqD,OAAO,IAAI,GAAG;CAErF,IAAI,SAAS,WAAW,KAAA,GACtB,MAAM,IAAI,MAAM,6EAA6E;AAEjG;AAEA,SAAS,cAAc,SAAmC;CACxD,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,IACpE,MAAM,IAAI,MACR,+DAA+D,OAAO,OAAO,GAC/E;AAEJ;AAEA,SAAS,0BAA0B,QAAuB;CACxD,IAAI,WAAW,KAAA,GACb;CAEF,MAAM,SAAS,0BAA0B,UAAU,MAAM;CACzD,IAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;EAC5F,MAAM,IAAI,MAAM,iCAAiC,QAAQ;CAC3D;AACF"}
+{"version":3,"file":"options.mjs","names":[],"sources":["../src/options.ts"],"sourcesContent":["/** Resolves `ShelfOptions` once at boot: validates `testing.compare` and fills the scratch default. */\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { notificationsConfigSchema, type ShelfOptions } from \"./config.ts\";\n\n/** Where capture scratch lives when `config.scratchDir` is not set. */\nexport const DEFAULT_SCRATCH_DIR: string = join(tmpdir(), \"storyshelf\");\n\n/**\n * Validate and complete the options.\n *\n * - `testing.compare.threads` must be a non-negative integer.\n * - `notifications.config` must match its schema (it used to live in `ShelfConfig`, which validated it).\n * - `config.scratchDir` defaults to {@link DEFAULT_SCRATCH_DIR}: publishing extracts zips there,\n *   with or without `testing`.\n */\nexport function resolveShelfOptions(options: ShelfOptions): ShelfOptions {\n  assertThreads(options.testing?.compare?.threads);\n  assertTestingProcess(options.testing);\n  assertTestingBackable(options);\n  assertNotificationsConfig(options.notifications?.config);\n  if (options.config?.scratchDir !== undefined) {\n    return options;\n  }\n  return { ...options, config: { ...options.config, scratchDir: DEFAULT_SCRATCH_DIR } };\n}\n\n/**\n * A `testing` instance renders here, so it needs a database a long-running server can keep.\n */\nfunction assertTestingBackable(options: ShelfOptions): void {\n  if (options.testing === undefined) {\n    return;\n  }\n  if (options.database.metadata.supportsTesting === false) {\n    throw new Error(\n      `The ${options.database.metadata.name} database cannot back testing: it is reachable only ` +\n        `from a platform that ends the process after each request, so nothing would run capture ` +\n        `jobs. Remove the testing option to host Storybooks only, or use a network database ` +\n        `(Turso, Postgres, MySQL, SQLite on a volume).`,\n    );\n  }\n}\n\nfunction assertTestingProcess(testing: ShelfOptions[\"testing\"]): void {\n  if (testing !== undefined && testing.runner === undefined) {\n    throw new Error(\"testing requires testing.runner\");\n  }\n  if (testing?.workerEntry !== undefined && testing.runner === undefined) {\n    throw new Error(\"testing.workerEntry requires testing.runner (it is the in-process fallback)\");\n  }\n  if (testing?.mode === \"fork\" && testing.workerEntry === undefined) {\n    throw new Error('testing.mode \"fork\" requires testing.workerEntry');\n  }\n  assertShardSize(testing);\n  assertTestingNumbers(testing);\n}\n\n/** Numeric `testing` options: concurrency, retries and the Storybook URL rate limit. */\nfunction assertTestingNumbers(testing: ShelfOptions[\"testing\"]): void {\n  assertConcurrency(testing?.concurrency);\n  assertRetries(testing?.retries);\n  assertLeaseSeconds(testing?.leaseSeconds);\n  assertStorybookUrlRateLimit(testing?.storybookUrlRateLimit);\n}\n\n/** A whole number of requests per minute; `0` would refuse every render. */\nfunction assertStorybookUrlRateLimit(limit: number | undefined): void {\n  if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {\n    throw new Error(\n      `testing.storybookUrlRateLimit must be a positive whole number of requests per minute, got ${String(limit)}`,\n    );\n  }\n}\n\n/** Retries are counted after the first attempt: `0` runs a job once. */\nfunction assertRetries(retries: number | undefined): void {\n  if (retries !== undefined && (!Number.isInteger(retries) || retries < 0)) {\n    throw new Error(`testing.retries must be a non-negative integer, got ${String(retries)}`);\n  }\n}\n\n/** A lease must be a positive length: `0` would expire every job at once. */\nfunction assertLeaseSeconds(seconds: number | undefined): void {\n  if (seconds !== undefined && (!Number.isFinite(seconds) || seconds <= 0)) {\n    throw new Error(\n      `testing.leaseSeconds must be a positive number of seconds, got ${String(seconds)}`,\n    );\n  }\n}\n\n/** `0` would deadlock the consumer. */\nfunction assertConcurrency(concurrency: number | undefined): void {\n  if (concurrency !== undefined && (!Number.isInteger(concurrency) || concurrency < 1)) {\n    throw new Error(`testing.concurrency must be a positive integer, got ${String(concurrency)}`);\n  }\n}\n\nfunction assertShardSize(testing: ShelfOptions[\"testing\"]): void {\n  const size = testing?.shardSize;\n  if (size === undefined) {\n    return;\n  }\n  if (!Number.isInteger(size) || size < 1) {\n    throw new Error(`testing.shardSize must be a positive integer, got ${String(size)}`);\n  }\n  if (testing?.runner === undefined) {\n    throw new Error(\"testing.shardSize requires testing.runner (workers set their own shardSize)\");\n  }\n}\n\nfunction assertThreads(threads: number | undefined): void {\n  if (threads !== undefined && (!Number.isInteger(threads) || threads < 0)) {\n    throw new Error(\n      `testing.compare.threads must be a non-negative integer, got ${String(threads)}`,\n    );\n  }\n}\n\nfunction assertNotificationsConfig(config: unknown): void {\n  if (config === undefined) {\n    return;\n  }\n  const result = notificationsConfigSchema.safeParse(config);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`Invalid notifications.config: ${issues}`);\n  }\n}\n"],"mappings":";;;;;;;;AAMA,MAAa,sBAA8B,KAAK,OAAO,GAAG,YAAY;;;;;;;;;AAUtE,SAAgB,oBAAoB,SAAqC;CACvE,cAAc,QAAQ,SAAS,SAAS,OAAO;CAC/C,qBAAqB,QAAQ,OAAO;CACpC,sBAAsB,OAAO;CAC7B,0BAA0B,QAAQ,eAAe,MAAM;CACvD,IAAI,QAAQ,QAAQ,eAAe,KAAA,GACjC,OAAO;CAET,OAAO;EAAE,GAAG;EAAS,QAAQ;GAAE,GAAG,QAAQ;GAAQ,YAAY;EAAoB;CAAE;AACtF;;;;AAKA,SAAS,sBAAsB,SAA6B;CAC1D,IAAI,QAAQ,YAAY,KAAA,GACtB;CAEF,IAAI,QAAQ,SAAS,SAAS,oBAAoB,OAChD,MAAM,IAAI,MACR,OAAO,QAAQ,SAAS,SAAS,KAAK,4QAIxC;AAEJ;AAEA,SAAS,qBAAqB,SAAwC;CACpE,IAAI,YAAY,KAAA,KAAa,QAAQ,WAAW,KAAA,GAC9C,MAAM,IAAI,MAAM,iCAAiC;CAEnD,IAAI,SAAS,gBAAgB,KAAA,KAAa,QAAQ,WAAW,KAAA,GAC3D,MAAM,IAAI,MAAM,6EAA6E;CAE/F,IAAI,SAAS,SAAS,UAAU,QAAQ,gBAAgB,KAAA,GACtD,MAAM,IAAI,MAAM,oDAAkD;CAEpE,gBAAgB,OAAO;CACvB,qBAAqB,OAAO;AAC9B;;AAGA,SAAS,qBAAqB,SAAwC;CACpE,kBAAkB,SAAS,WAAW;CACtC,cAAc,SAAS,OAAO;CAC9B,mBAAmB,SAAS,YAAY;CACxC,4BAA4B,SAAS,qBAAqB;AAC5D;;AAGA,SAAS,4BAA4B,OAAiC;CACpE,IAAI,UAAU,KAAA,MAAc,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,IAC9D,MAAM,IAAI,MACR,6FAA6F,OAAO,KAAK,GAC3G;AAEJ;;AAGA,SAAS,cAAc,SAAmC;CACxD,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,IACpE,MAAM,IAAI,MAAM,uDAAuD,OAAO,OAAO,GAAG;AAE5F;;AAGA,SAAS,mBAAmB,SAAmC;CAC7D,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,SAAS,OAAO,KAAK,WAAW,IACpE,MAAM,IAAI,MACR,kEAAkE,OAAO,OAAO,GAClF;AAEJ;;AAGA,SAAS,kBAAkB,aAAuC;CAChE,IAAI,gBAAgB,KAAA,MAAc,CAAC,OAAO,UAAU,WAAW,KAAK,cAAc,IAChF,MAAM,IAAI,MAAM,uDAAuD,OAAO,WAAW,GAAG;AAEhG;AAEA,SAAS,gBAAgB,SAAwC;CAC/D,MAAM,OAAO,SAAS;CACtB,IAAI,SAAS,KAAA,GACX;CAEF,IAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,GACpC,MAAM,IAAI,MAAM,qDAAqD,OAAO,IAAI,GAAG;CAErF,IAAI,SAAS,WAAW,KAAA,GACtB,MAAM,IAAI,MAAM,6EAA6E;AAEjG;AAEA,SAAS,cAAc,SAAmC;CACxD,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,IACpE,MAAM,IAAI,MACR,+DAA+D,OAAO,OAAO,GAC/E;AAEJ;AAEA,SAAS,0BAA0B,QAAuB;CACxD,IAAI,WAAW,KAAA,GACb;CAEF,MAAM,SAAS,0BAA0B,UAAU,MAAM;CACzD,IAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;EAC5F,MAAM,IAAI,MAAM,iCAAiC,QAAQ;CAC3D;AACF"}

package/dist/paths.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/utils/paths.d.ts
 /**
  * Path segment for a mode on a given engine. Chromium keeps the bare mode key
  * so pre-multi-browser objects stay addressable; other engines get `~browser`.
@@ -22,10 +21,11 @@ declare function designRenderPath(projectId: string, provider: string, fileKey:
 declare function baselinePath(projectId: string, branch: string, storyId: string, viewport: string, browser?: string): string;
 /** Storage prefix for an extracted published Storybook. */
 declare function storybookDir(projectId: string, buildId: string): string;
+/** Disposable gzip representation of a content-addressed published file. */
+declare function publishedGzipPath(hash: string): string;
 /** Storage path for an uploaded Storybook zip. */
 declare function storybookZipPath(projectId: string, buildId: string): string;
 /** Storage path of a build's persisted catalog (ADR 0006, decision 9), next to its `storybook/` statics. */
 declare function catalogPath(projectId: string, buildId: string): string;
-//#endregion
-export { baselinePath, catalogPath, contentDir, contentPath, designRenderPath, diffPath, isContentPath, modeSegment, screenshotPath, storybookDir, storybookZipPath };
+export { baselinePath, catalogPath, contentDir, contentPath, designRenderPath, diffPath, isContentPath, modeSegment, publishedGzipPath, screenshotPath, storybookDir, storybookZipPath };
 //# sourceMappingURL=paths.d.mts.map

package/dist/paths.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { isSafeSegment } from "./utils/path-security.mjs";
-//#region src/utils/paths.ts
+// src/utils/paths.ts
 /** Storage path builders. Every segment is validated — a third-party
 * capture runner echoing `story.id = "../../x"` must fail here, not in an
 * adapter with its own key-jailing quirks. */
@@ -82,6 +82,11 @@ function storybookDir(projectId, buildId) {
 	assertSegments([projectId, buildId]);
 	return `${projectId}/builds/${buildId}/storybook`;
 }
+/** Disposable gzip representation of a content-addressed published file. */
+function publishedGzipPath(hash) {
+	if (!/^[a-f0-9]{64}$/u.test(hash)) throw new Error("Invalid published content hash");
+	return `derived/published-gzip/${hash}.gz`;
+}
 /** Storage path for an uploaded Storybook zip. */
 function storybookZipPath(projectId, buildId) {
 	assertSegments([projectId, buildId]);
@@ -92,7 +97,6 @@ function catalogPath(projectId, buildId) {
 	assertSegments([projectId, buildId]);
 	return `${projectId}/builds/${buildId}/catalog.json`;
 }
-//#endregion
-export { baselinePath, catalogPath, contentDir, contentPath, designRenderPath, diffPath, isContentPath, modeSegment, screenshotPath, storybookDir, storybookZipPath };
+export { baselinePath, catalogPath, contentDir, contentPath, designRenderPath, diffPath, isContentPath, modeSegment, publishedGzipPath, screenshotPath, storybookDir, storybookZipPath };
 
 //# sourceMappingURL=paths.mjs.map

package/dist/paths.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"paths.mjs","names":[],"sources":["../src/utils/paths.ts"],"sourcesContent":["/** Storage path builders. Every segment is validated — a third-party\n * capture runner echoing `story.id = \"../../x\"` must fail here, not in an\n * adapter with its own key-jailing quirks. */\nimport { isSafeSegment } from \"./path-security.ts\";\n\n/** Throw when any key segment could escape its storage prefix. */\nfunction assertSegments(segments: string[]): void {\n  const bad = segments.filter((segment) => !isSafeSegment(segment) || segment.length === 0);\n  if (bad.length > 0) {\n    throw new Error(`Unsafe storage path segment: ${bad.join(\",\")}`);\n  }\n}\n/**\n * Path segment for a mode on a given engine. Chromium keeps the bare mode key\n * so pre-multi-browser objects stay addressable; other engines get `~browser`.\n */\nexport function modeSegment(viewport: string, browser?: string): string {\n  return browser && browser !== \"chromium\" ? `${viewport}~${browser}` : viewport;\n}\n\n/** Storage path for a captured snapshot screenshot. */\nexport function screenshotPath(\n  projectId: string,\n  buildId: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, buildId, storyId, segment]);\n  return `${projectId}/builds/${buildId}/screenshots/${storyId}/${segment}.png`;\n}\n\n/** Storage prefix of a project's content-addressed screenshots. */\nexport function contentDir(projectId: string): string {\n  assertSegments([projectId]);\n  return `${projectId}/content`;\n}\n\n/** Storage path of a screenshot stored by the SHA-256 of its bytes (shared by builds and baselines). */\nexport function contentPath(projectId: string, hash: string): string {\n  assertSegments([projectId, hash]);\n  return `${contentDir(projectId)}/${hash}.png`;\n}\n\n/** Whether `path` is one of `projectId`'s content-addressed screenshots. */\nexport function isContentPath(projectId: string, path: string): boolean {\n  return path.startsWith(`${contentDir(projectId)}/`) && path.endsWith(\".png\");\n}\n\n/** Storage path for a snapshot diff overlay image. */\nexport function diffPath(\n  projectId: string,\n  buildId: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, buildId, storyId, segment]);\n  return `${projectId}/builds/${buildId}/diffs/${storyId}/${segment}.png`;\n}\n\n/** Storage path for a cached design node render (overwritten in place when the file version moves). */\nexport function designRenderPath(\n  projectId: string,\n  provider: string,\n  fileKey: string,\n  nodeId: string,\n  viewerId = \"\",\n): string {\n  const node = nodeId.replaceAll(\":\", \"-\");\n  assertSegments([projectId, provider, fileKey, node, ...(viewerId ? [viewerId] : [])]);\n  const owner = viewerId ? `user-${viewerId}/` : \"\";\n  return `${projectId}/design/${provider}/${owner}${fileKey}/${node}.png`;\n}\n\n/** Storage path for a branch baseline screenshot. */\nexport function baselinePath(\n  projectId: string,\n  branch: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, branch, storyId, segment]);\n  return `${projectId}/baselines/${branch}/${storyId}/${segment}.png`;\n}\n\n/** Storage prefix for an extracted published Storybook. */\nexport function storybookDir(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/storybook`;\n}\n\n/** Storage path for an uploaded Storybook zip. */\nexport function storybookZipPath(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/storybook.zip`;\n}\n\n/** Storage path of a build's persisted catalog (ADR 0006, decision 9), next to its `storybook/` statics. */\nexport function catalogPath(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/catalog.json`;\n}\n"],"mappings":";;;;;;;;;AAMA,SAAS,eAAe,UAA0B;CAChD,MAAM,MAAM,SAAS,QAAQ,YAAY,CAAC,cAAc,OAAO,KAAK,QAAQ,WAAW,CAAC;CACxF,IAAI,IAAI,SAAS,GACf,MAAM,IAAI,MAAM,gCAAgC,IAAI,KAAK,GAAG,GAAG;AAEnE;;;;;AAKA,SAAgB,YAAY,UAAkB,SAA0B;CACtE,OAAO,WAAW,YAAY,aAAa,GAAG,SAAS,GAAG,YAAY;AACxE;;AAGA,SAAgB,eACd,WACA,SACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAS;EAAS;CAAO,CAAC;CACrD,OAAO,GAAG,UAAU,UAAU,QAAQ,eAAe,QAAQ,GAAG,QAAQ;AAC1E;;AAGA,SAAgB,WAAW,WAA2B;CACpD,eAAe,CAAC,SAAS,CAAC;CAC1B,OAAO,GAAG,UAAU;AACtB;;AAGA,SAAgB,YAAY,WAAmB,MAAsB;CACnE,eAAe,CAAC,WAAW,IAAI,CAAC;CAChC,OAAO,GAAG,WAAW,SAAS,EAAE,GAAG,KAAK;AAC1C;;AAGA,SAAgB,cAAc,WAAmB,MAAuB;CACtE,OAAO,KAAK,WAAW,GAAG,WAAW,SAAS,EAAE,EAAE,KAAK,KAAK,SAAS,MAAM;AAC7E;;AAGA,SAAgB,SACd,WACA,SACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAS;EAAS;CAAO,CAAC;CACrD,OAAO,GAAG,UAAU,UAAU,QAAQ,SAAS,QAAQ,GAAG,QAAQ;AACpE;;AAGA,SAAgB,iBACd,WACA,UACA,SACA,QACA,WAAW,IACH;CACR,MAAM,OAAO,OAAO,WAAW,KAAK,GAAG;CACvC,eAAe;EAAC;EAAW;EAAU;EAAS;EAAM,GAAI,WAAW,CAAC,QAAQ,IAAI,CAAC;CAAE,CAAC;CAEpF,OAAO,GAAG,UAAU,UAAU,SAAS,GADzB,WAAW,QAAQ,SAAS,KAAK,KACG,QAAQ,GAAG,KAAK;AACpE;;AAGA,SAAgB,aACd,WACA,QACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAQ;EAAS;CAAO,CAAC;CACpD,OAAO,GAAG,UAAU,aAAa,OAAO,GAAG,QAAQ,GAAG,QAAQ;AAChE;;AAGA,SAAgB,aAAa,WAAmB,SAAyB;CACvE,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC;;AAGA,SAAgB,iBAAiB,WAAmB,SAAyB;CAC3E,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC;;AAGA,SAAgB,YAAY,WAAmB,SAAyB;CACtE,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC"}
+{"version":3,"file":"paths.mjs","names":[],"sources":["../src/utils/paths.ts"],"sourcesContent":["/** Storage path builders. Every segment is validated — a third-party\n * capture runner echoing `story.id = \"../../x\"` must fail here, not in an\n * adapter with its own key-jailing quirks. */\nimport { isSafeSegment } from \"./path-security.ts\";\n\n/** Throw when any key segment could escape its storage prefix. */\nfunction assertSegments(segments: string[]): void {\n  const bad = segments.filter((segment) => !isSafeSegment(segment) || segment.length === 0);\n  if (bad.length > 0) {\n    throw new Error(`Unsafe storage path segment: ${bad.join(\",\")}`);\n  }\n}\n/**\n * Path segment for a mode on a given engine. Chromium keeps the bare mode key\n * so pre-multi-browser objects stay addressable; other engines get `~browser`.\n */\nexport function modeSegment(viewport: string, browser?: string): string {\n  return browser && browser !== \"chromium\" ? `${viewport}~${browser}` : viewport;\n}\n\n/** Storage path for a captured snapshot screenshot. */\nexport function screenshotPath(\n  projectId: string,\n  buildId: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, buildId, storyId, segment]);\n  return `${projectId}/builds/${buildId}/screenshots/${storyId}/${segment}.png`;\n}\n\n/** Storage prefix of a project's content-addressed screenshots. */\nexport function contentDir(projectId: string): string {\n  assertSegments([projectId]);\n  return `${projectId}/content`;\n}\n\n/** Storage path of a screenshot stored by the SHA-256 of its bytes (shared by builds and baselines). */\nexport function contentPath(projectId: string, hash: string): string {\n  assertSegments([projectId, hash]);\n  return `${contentDir(projectId)}/${hash}.png`;\n}\n\n/** Whether `path` is one of `projectId`'s content-addressed screenshots. */\nexport function isContentPath(projectId: string, path: string): boolean {\n  return path.startsWith(`${contentDir(projectId)}/`) && path.endsWith(\".png\");\n}\n\n/** Storage path for a snapshot diff overlay image. */\nexport function diffPath(\n  projectId: string,\n  buildId: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, buildId, storyId, segment]);\n  return `${projectId}/builds/${buildId}/diffs/${storyId}/${segment}.png`;\n}\n\n/** Storage path for a cached design node render (overwritten in place when the file version moves). */\nexport function designRenderPath(\n  projectId: string,\n  provider: string,\n  fileKey: string,\n  nodeId: string,\n  viewerId = \"\",\n): string {\n  const node = nodeId.replaceAll(\":\", \"-\");\n  assertSegments([projectId, provider, fileKey, node, ...(viewerId ? [viewerId] : [])]);\n  const owner = viewerId ? `user-${viewerId}/` : \"\";\n  return `${projectId}/design/${provider}/${owner}${fileKey}/${node}.png`;\n}\n\n/** Storage path for a branch baseline screenshot. */\nexport function baselinePath(\n  projectId: string,\n  branch: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, branch, storyId, segment]);\n  return `${projectId}/baselines/${branch}/${storyId}/${segment}.png`;\n}\n\n/** Storage prefix for an extracted published Storybook. */\nexport function storybookDir(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/storybook`;\n}\n\n/** Disposable gzip representation of a content-addressed published file. */\nexport function publishedGzipPath(hash: string): string {\n  if (!/^[a-f0-9]{64}$/u.test(hash)) throw new Error(\"Invalid published content hash\");\n  return `derived/published-gzip/${hash}.gz`;\n}\n\n/** Storage path for an uploaded Storybook zip. */\nexport function storybookZipPath(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/storybook.zip`;\n}\n\n/** Storage path of a build's persisted catalog (ADR 0006, decision 9), next to its `storybook/` statics. */\nexport function catalogPath(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/catalog.json`;\n}\n"],"mappings":";;;;;;;;;AAMA,SAAS,eAAe,UAA0B;CAChD,MAAM,MAAM,SAAS,QAAQ,YAAY,CAAC,cAAc,OAAO,KAAK,QAAQ,WAAW,CAAC;CACxF,IAAI,IAAI,SAAS,GACf,MAAM,IAAI,MAAM,gCAAgC,IAAI,KAAK,GAAG,GAAG;AAEnE;;;;;AAKA,SAAgB,YAAY,UAAkB,SAA0B;CACtE,OAAO,WAAW,YAAY,aAAa,GAAG,SAAS,GAAG,YAAY;AACxE;;AAGA,SAAgB,eACd,WACA,SACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAS;EAAS;CAAO,CAAC;CACrD,OAAO,GAAG,UAAU,UAAU,QAAQ,eAAe,QAAQ,GAAG,QAAQ;AAC1E;;AAGA,SAAgB,WAAW,WAA2B;CACpD,eAAe,CAAC,SAAS,CAAC;CAC1B,OAAO,GAAG,UAAU;AACtB;;AAGA,SAAgB,YAAY,WAAmB,MAAsB;CACnE,eAAe,CAAC,WAAW,IAAI,CAAC;CAChC,OAAO,GAAG,WAAW,SAAS,EAAE,GAAG,KAAK;AAC1C;;AAGA,SAAgB,cAAc,WAAmB,MAAuB;CACtE,OAAO,KAAK,WAAW,GAAG,WAAW,SAAS,EAAE,EAAE,KAAK,KAAK,SAAS,MAAM;AAC7E;;AAGA,SAAgB,SACd,WACA,SACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAS;EAAS;CAAO,CAAC;CACrD,OAAO,GAAG,UAAU,UAAU,QAAQ,SAAS,QAAQ,GAAG,QAAQ;AACpE;;AAGA,SAAgB,iBACd,WACA,UACA,SACA,QACA,WAAW,IACH;CACR,MAAM,OAAO,OAAO,WAAW,KAAK,GAAG;CACvC,eAAe;EAAC;EAAW;EAAU;EAAS;EAAM,GAAI,WAAW,CAAC,QAAQ,IAAI,CAAC;CAAE,CAAC;CAEpF,OAAO,GAAG,UAAU,UAAU,SAAS,GADzB,WAAW,QAAQ,SAAS,KAAK,KACG,QAAQ,GAAG,KAAK;AACpE;;AAGA,SAAgB,aACd,WACA,QACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAQ;EAAS;CAAO,CAAC;CACpD,OAAO,GAAG,UAAU,aAAa,OAAO,GAAG,QAAQ,GAAG,QAAQ;AAChE;;AAGA,SAAgB,aAAa,WAAmB,SAAyB;CACvE,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC;;AAGA,SAAgB,kBAAkB,MAAsB;CACtD,IAAI,CAAC,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,MAAM,gCAAgC;CACnF,OAAO,0BAA0B,KAAK;AACxC;;AAGA,SAAgB,iBAAiB,WAAmB,SAAyB;CAC3E,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC;;AAGA,SAAgB,YAAY,WAAmB,SAAyB;CACtE,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC"}

package/dist/retention/ai.d.mts

@@ -1,8 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Logger } from "../logger.mjs";
-//#region src/retention/ai.d.ts
+import { DatabaseAdapter } from "../adapter/database.mjs";
 /** Pending/running rows older than this are marked `interrupted`. */
 declare const STALE_RUN_MS: number;
 /** What one AI retention pass removed. */
@@ -13,6 +12,5 @@ interface AiPurgeResult {
 }
 /** Run one AI retention pass (safe to call from any instance, any time). */
 declare function purgeAiData(db: DatabaseAdapter, now?: Date, logger?: Logger): Promise<AiPurgeResult>;
-//#endregion
 export { AiPurgeResult, STALE_RUN_MS, purgeAiData };
 //# sourceMappingURL=ai.d.mts.map

package/dist/retention/ai.mjs

@@ -17,7 +17,6 @@ async function purgeAiData(db, now = /* @__PURE__ */ new Date(), logger) {
 	if (result.health > 0 || result.usage > 0 || result.interrupted > 0) logger?.info(result, "ai data retention pass complete");
 	return result;
 }
-//#endregion
 export { STALE_RUN_MS, purgeAiData };
 
 //# sourceMappingURL=ai.mjs.map

package/dist/retention/pending.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { BuildModel } from "../models/build.mjs";
 import { BuildReviewModel } from "../models/build-review.mjs";
 import { CommentModel } from "../models/comment.mjs";
-//#region src/retention/pending.ts
+// src/retention/pending.ts
 /**
 * The project's pending builds whose last activity (upload, comment or verdict) is before
 * `cutoff`. `capture_attempts` need no check: a build capture worked on leaves `pending`.
@@ -41,7 +41,6 @@ function stampOf(item) {
 function hasNewerOnBranch(all, build) {
 	return all.some((other) => other.id !== build.id && other.gitBranch === build.gitBranch && other.createdAt > build.createdAt);
 }
-//#endregion
 export { pendingCandidates };
 
 //# sourceMappingURL=pending.mjs.map

package/dist/retention/published-gzip-sweep.mjs

@@ -0,0 +1,28 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/retention/published-gzip-sweep.ts
+const PREFIX = "derived/published-gzip/";
+const MAX_PER_SWEEP = 128;
+const cursors = /* @__PURE__ */ new WeakMap();
+/** Reclaim disposable orphan variants; never delete content or other storage keys. */
+async function sweepPublishedGzip(storage) {
+	const keys = (await storage.list(PREFIX)).filter((key) => /^derived\/published-gzip\/[a-f0-9]{64}\.gz$/u.test(key)).toSorted();
+	if (keys.length === 0) return;
+	const cursor = cursors.get(storage);
+	const next = cursor ? keys.findIndex((key) => key > cursor) : 0;
+	const start = Math.max(0, next);
+	const batch = [...keys.slice(start), ...keys.slice(0, start)].slice(0, MAX_PER_SWEEP);
+	for (const key of batch) await removeOrphan(storage, key);
+	const last = batch.at(-1);
+	if (last) cursors.set(storage, last);
+}
+async function removeOrphan(storage, key) {
+	const hash = key.slice(23, -3);
+	try {
+		if (!await storage.exists(`content/${hash}`)) await storage.delete(key);
+	} catch {}
+}
+export { sweepPublishedGzip };
+
+//# sourceMappingURL=published-gzip-sweep.mjs.map

package/dist/retention/published-gzip-sweep.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"published-gzip-sweep.mjs","names":[],"sources":["../../src/retention/published-gzip-sweep.ts"],"sourcesContent":["import type { StorageAdapter } from \"../adapters/storage.ts\";\n\nconst PREFIX = \"derived/published-gzip/\";\nconst MAX_PER_SWEEP = 128;\nconst cursors = new WeakMap<StorageAdapter, string>();\n\n/** Reclaim disposable orphan variants; never delete content or other storage keys. */\nexport async function sweepPublishedGzip(storage: StorageAdapter): Promise<void> {\n  const keys = (await storage.list(PREFIX))\n    .filter((key) => /^derived\\/published-gzip\\/[a-f0-9]{64}\\.gz$/u.test(key))\n    .toSorted();\n  if (keys.length === 0) return;\n  const cursor = cursors.get(storage);\n  const next = cursor ? keys.findIndex((key) => key > cursor) : 0;\n  const start = Math.max(0, next);\n  const batch = [...keys.slice(start), ...keys.slice(0, start)].slice(0, MAX_PER_SWEEP);\n  for (const key of batch) {\n    // oxlint-disable-next-line eslint/no-await-in-loop -- bounded, sequential storage work\n    await removeOrphan(storage, key);\n  }\n  const last = batch.at(-1);\n  if (last) cursors.set(storage, last);\n}\n\nasync function removeOrphan(storage: StorageAdapter, key: string): Promise<void> {\n  const hash = key.slice(PREFIX.length, -3);\n  try {\n    if (!(await storage.exists(`content/${hash}`))) await storage.delete(key);\n  } catch {\n    // Retention is best effort; a missing variant can always be regenerated.\n  }\n}\n"],"mappings":";;;;AAEA,MAAM,SAAS;AACf,MAAM,gBAAgB;AACtB,MAAM,0BAAU,IAAI,QAAgC;;AAGpD,eAAsB,mBAAmB,SAAwC;CAC/E,MAAM,QAAQ,MAAM,QAAQ,KAAK,MAAM,EAAA,CACpC,QAAQ,QAAQ,+CAA+C,KAAK,GAAG,CAAC,CAAC,CACzE,SAAS;CACZ,IAAI,KAAK,WAAW,GAAG;CACvB,MAAM,SAAS,QAAQ,IAAI,OAAO;CAClC,MAAM,OAAO,SAAS,KAAK,WAAW,QAAQ,MAAM,MAAM,IAAI;CAC9D,MAAM,QAAQ,KAAK,IAAI,GAAG,IAAI;CAC9B,MAAM,QAAQ,CAAC,GAAG,KAAK,MAAM,KAAK,GAAG,GAAG,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,aAAa;CACpF,KAAK,MAAM,OAAO,OAEhB,MAAM,aAAa,SAAS,GAAG;CAEjC,MAAM,OAAO,MAAM,GAAG,EAAE;CACxB,IAAI,MAAM,QAAQ,IAAI,SAAS,IAAI;AACrC;AAEA,eAAe,aAAa,SAAyB,KAA4B;CAC/E,MAAM,OAAO,IAAI,MAAM,IAAe,EAAE;CACxC,IAAI;EACF,IAAI,CAAE,MAAM,QAAQ,OAAO,WAAW,MAAM,GAAI,MAAM,QAAQ,OAAO,GAAG;CAC1E,QAAQ,CAER;AACF"}

package/dist/retention/screenshot-sweep.d.mts

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { StorageAdapter } from "../adapter/storage.mjs";
 import { Logger } from "pino";
 import { Table } from "drizzle-orm";
-//#region src/retention/screenshot-sweep.d.ts
 /** Longest an unreferenced screenshot is kept after the sweep first sees it (default 24 h). */
 declare const SWEEP_GRACE_MS: number;
 /** Tables the sweep reads references and in-flight builds from. */
@@ -46,6 +45,5 @@ declare function sweepScreenshotContent(deps: SweepDeps, projectId: string, opti
   now?: number;
   graceMs?: number;
 }): Promise<SweepResult>;
-//#endregion
 export { SWEEP_GRACE_MS, SweepDeps, SweepResult, SweepTables, sweepScreenshotContent };
 //# sourceMappingURL=screenshot-sweep.d.mts.map

package/dist/retention/screenshot-sweep.mjs

@@ -5,7 +5,7 @@ import { col } from "../models/columns.mjs";
 import { contentDir } from "../paths.mjs";
 import { CLAIMS_DIR } from "../utils/screenshot-store.mjs";
 import { and, eq, gte, inArray, like } from "drizzle-orm";
-//#region src/retention/screenshot-sweep.ts
+// src/retention/screenshot-sweep.ts
 /** Mark-and-sweep for a project's content-addressed screenshots. */
 /** Longest an unreferenced screenshot is kept after the sweep first sees it (default 24 h). */
 const SWEEP_GRACE_MS = 864e5;
@@ -122,7 +122,6 @@ async function readMarker(storage, dir) {
 async function writeMarker(storage, dir, next, previous) {
 	if (JSON.stringify(next) !== JSON.stringify(previous)) await storage.write(`${dir}${MARKER}`, Buffer.from(JSON.stringify(next)));
 }
-//#endregion
 export { SWEEP_GRACE_MS, sweepScreenshotContent };
 
 //# sourceMappingURL=screenshot-sweep.mjs.map

package/dist/retention.d.mts

@@ -7,7 +7,6 @@ import { SWEEP_GRACE_MS, SweepDeps, SweepResult, SweepTables, sweepScreenshotCon
 import { AiPurgeResult, STALE_RUN_MS, purgeAiData } from "./retention/ai.mjs";
 import { Logger } from "pino";
 import { Table } from "drizzle-orm";
-//#region src/retention/purge.d.ts
 /** Table handles for retention queries. */
 interface RetentionTables {
   builds: Table;
@@ -54,6 +53,5 @@ interface BranchGcResult {
   removedBranches: number;
   removedBaselines: number;
 }
-//#endregion
 export { type AiPurgeResult, BranchGcResult, PurgeOptions, PurgeResult, Retention, RetentionTables, STALE_RUN_MS, SWEEP_GRACE_MS, type SweepDeps, type SweepResult, type SweepTables, purgeAiData, sweepScreenshotContent };
 //# sourceMappingURL=retention.d.mts.map

package/dist/retention.mjs

@@ -4,6 +4,7 @@ import.meta.url;
 import { TERMINAL_BUILD_STATUSES } from "./types.mjs";
 import { col } from "./models/columns.mjs";
 import { BuildModel } from "./models/build.mjs";
+import { publishedGzipPath } from "./paths.mjs";
 import { BaselineModel } from "./models/baseline.mjs";
 import { CaptureJobModel } from "./models/capture-job.mjs";
 import { BuildComponentModel } from "./models/build-component.mjs";
@@ -11,10 +12,11 @@ import { InsightModel } from "./models/insight.mjs";
 import { LabelModel } from "./models/label.mjs";
 import { PackageUsageModel } from "./models/usage.mjs";
 import { pendingCandidates } from "./retention/pending.mjs";
+import { sweepPublishedGzip } from "./retention/published-gzip-sweep.mjs";
 import { SWEEP_GRACE_MS, sweepScreenshotContent } from "./retention/screenshot-sweep.mjs";
 import { STALE_RUN_MS, purgeAiData } from "./retention/ai.mjs";
 import { and, desc, eq, inArray, lt } from "drizzle-orm";
-//#region src/retention/purge.ts
+// src/retention/purge.ts
 /** Removes expired transient builds while keeping baselines and persistent builds. */
 var Retention = class {
 	db;
@@ -153,9 +155,11 @@ var Retention = class {
 			const all = await this.db.list(contentRefs);
 			for (const row of all) if (row.refCount === 0 && row.lastSeenAt < cutoff) {
 				await this.storage.delete(`content/${row.hash}`).catch(() => {});
+				if (/^[a-f0-9]{64}$/u.test(row.hash)) await this.storage.delete(publishedGzipPath(row.hash)).catch(() => {});
 				await this.db.remove(contentRefs, row.hash);
 			}
 		} catch {}
+		await sweepPublishedGzip(this.storage).catch(() => {});
 		return files.length;
 	}
 	async purgeStaleBranches(project, ttlDays) {
@@ -196,7 +200,6 @@ function branchLatestAt(rows) {
 	}
 	return latestAt;
 }
-//#endregion
 export { Retention, STALE_RUN_MS, SWEEP_GRACE_MS, purgeAiData, sweepScreenshotContent };
 
 //# sourceMappingURL=retention.mjs.map

package/dist/retention.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"retention.mjs","names":[],"sources":["../src/retention/purge.ts"],"sourcesContent":["import { and, desc, eq, inArray, lt } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { Logger } from \"pino\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { BaselineModel } from \"../models/baseline.ts\";\nimport { BuildComponentModel } from \"../models/build-component.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport { CaptureJobModel } from \"../models/capture-job.ts\";\nimport { InsightModel } from \"../models/insight.ts\";\nimport { LabelModel, type LabelTables } from \"../models/label.ts\";\nimport { PackageUsageModel } from \"../models/usage.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport { TERMINAL_BUILD_STATUSES } from \"../types.ts\";\nimport { pendingCandidates } from \"./pending.ts\";\nimport { sweepScreenshotContent } from \"./screenshot-sweep.ts\";\n\nexport {\n  sweepScreenshotContent,\n  SWEEP_GRACE_MS,\n  type SweepDeps,\n  type SweepResult,\n  type SweepTables,\n} from \"./screenshot-sweep.ts\";\nimport { col } from \"../models/columns.ts\";\nexport { purgeAiData, STALE_RUN_MS, type AiPurgeResult } from \"./ai.ts\";\n\n/** Table handles for retention queries. */\nexport interface RetentionTables {\n  builds: Table;\n  buildLabels: Table;\n  baselines: Table;\n}\n\n/** Removes expired transient builds while keeping baselines and persistent builds. */\nexport class Retention {\n  private readonly db: DatabaseAdapter;\n  private readonly storage: StorageAdapter;\n  private readonly tables: RetentionTables;\n  private readonly logger?: Logger;\n\n  constructor(\n    db: DatabaseAdapter,\n    storage: StorageAdapter,\n    tables: RetentionTables,\n    logger?: Logger,\n  ) {\n    this.db = db;\n    this.storage = storage;\n    this.tables = tables;\n    this.logger = logger;\n  }\n\n  async purge(project: Project, options: PurgeOptions): Promise<PurgeResult> {\n    const cutoff = new Date(Date.now() - options.ttlDays * 86_400_000).toISOString();\n    const { buildIds, pending } = await this.selectBuilds(project, options, cutoff);\n    const results = await Promise.all(\n      buildIds.map(async (buildId) => ({\n        files: await this.deleteBuildFiles(project.id, buildId),\n        removed: await this.removeBuild(buildId),\n      })),\n    );\n    const removedBuilds = results.filter((r: { removed: boolean }) => r.removed).length;\n    const removedFiles = results.reduce((sum: number, r: { files: number }) => sum + r.files, 0);\n    await this.sweepScreenshots(project);\n    const removedJobs = await this.purgeFinishedJobs(cutoff);\n    this.logger?.info(\n      { projectId: project.id, removedBuilds, removedFiles, removedJobs, removedPending: pending },\n      \"build retention purge complete\",\n    );\n    return { removedBuilds, removedFiles };\n  }\n\n  /**\n   * The builds a purge removes: terminal builds past the window (minus the latest per branch when\n   * asked), and pending builds idle past it (ADR 0013, decision 9). Persistent builds stay.\n   */\n  private async selectBuilds(\n    project: Project,\n    options: PurgeOptions,\n    cutoff: string,\n  ): Promise<{ buildIds: string[]; pending: number }> {\n    const candidates = await this.db.list(this.tables.builds, {\n      where: and(\n        eq(col(this.tables.builds, \"projectId\"), project.id),\n        inArray(col(this.tables.builds, \"status\"), [...TERMINAL_BUILD_STATUSES]),\n        lt(col(this.tables.builds, \"updatedAt\"), cutoff),\n      ),\n    });\n    const keep = options.keepLatestPerBranch\n      ? await this.latestPerBranch(project.id)\n      : new Set<string>();\n    const persistent = await new LabelModel(\n      this.db,\n      this.tables as unknown as LabelTables,\n    ).persistentBuildIds(project.id);\n    const terminal = candidates\n      .map((build) => (build as { id: string }).id)\n      .filter((buildId) => !keep.has(buildId));\n    // Pending builds leave on their own clock; \"the latest on a branch\" does not shield them.\n    const pending = (await pendingCandidates(this.db, project.id, cutoff)).map(\n      (candidate) => candidate.buildId,\n    );\n    return {\n      buildIds: [...terminal, ...pending].filter((buildId) => !persistent.has(buildId)),\n      pending: pending.length,\n    };\n  }\n\n  /** Reclaim screenshots no snapshot or baseline references any more; never blocks the purge. */\n  private async sweepScreenshots(project: Project): Promise<void> {\n    try {\n      await sweepScreenshotContent(\n        {\n          db: this.db,\n          storage: this.storage,\n          tables: {\n            snapshots: this.db.tables.snapshots,\n            baselines: this.tables.baselines,\n            builds: this.tables.builds,\n          },\n          logger: this.logger,\n        },\n        project.id,\n      );\n    } catch (error) {\n      this.logger?.warn({ err: error, projectId: project.id }, \"screenshot sweep failed\");\n    }\n  }\n\n  /**\n   * Drop finished queue jobs older than the build cutoff (they have no foreign key to a build, and\n   * a finished job is only history); never blocks the purge. Queued and running jobs are kept.\n   */\n  private async purgeFinishedJobs(cutoff: string): Promise<number> {\n    try {\n      return await new CaptureJobModel(this.db).purgeFinished(cutoff);\n    } catch (error) {\n      this.logger?.warn({ err: error }, \"capture job purge failed\");\n      return 0;\n    }\n  }\n\n  private async removeBuild(buildId: string): Promise<boolean> {\n    await new InsightModel(this.db).removeForBuild(buildId);\n    await new CaptureJobModel(this.db).removeForBuild(buildId);\n    await new BuildComponentModel(this.db).removeForBuild(buildId);\n    await new PackageUsageModel(this.db).removeForBuild(buildId);\n    await new BuildModel(this.db, this.tables as unknown as BuildTables).remove(buildId);\n    return true;\n  }\n\n  private async latestPerBranch(projectId: string): Promise<Set<string>> {\n    const rows = (await this.db.list(this.tables.builds, {\n      where: eq(col(this.tables.builds, \"projectId\"), projectId),\n      orderBy: desc(col(this.tables.builds, \"updatedAt\")),\n    })) as unknown as { gitBranch: string; id: string }[];\n    const latest = new Map<string, string>();\n    for (const row of rows) {\n      const branch = row.gitBranch;\n      const current = latest.get(branch);\n      if (!current) {\n        latest.set(branch, row.id);\n      }\n    }\n    return new Set(latest.values());\n  }\n\n  private async deleteBuildFiles(projectId: string, buildId: string): Promise<number> {\n    const prefix = `${projectId}/builds/${buildId}/`;\n    const manifestPath = `${prefix}storybook/manifest.json`;\n    let manifestFiles: string[] = [];\n    try {\n      if (await this.storage.exists(manifestPath)) {\n        const raw = await this.storage.read(manifestPath);\n        const manifest = JSON.parse(raw.toString(\"utf8\")) as Record<string, string>;\n        manifestFiles = Object.values(manifest);\n      }\n    } catch {\n      // ignore — manifest may not exist for old builds\n    }\n    const files = await this.storage.list(prefix);\n    await Promise.all(\n      files.map(async (file) => {\n        await this.storage.delete(file);\n      }),\n    );\n    // Decrement content refs for this build's manifest\n    for (const hash of manifestFiles) {\n      try {\n        const contentRefs = this.db.tables.contentRefs;\n        const existing = (await this.db.get(contentRefs, hash)) as unknown as {\n          refCount: number;\n        } | null;\n        // oxlint-disable-next-line unicorn/prefer-ternary -- refCount check is clearer as if/else\n        if (existing) {\n          const refCount = existing.refCount;\n          // oxlint-disable-next-line unicorn/prefer-ternary -- grace logic is clearer as if/else\n          if (refCount <= 1) {\n            // Keep for 7-day grace: set refCount 0 and update lastSeenAt, don't delete yet\n            await this.db.update(contentRefs, hash, {\n              refCount: 0,\n              lastSeenAt: new Date().toISOString(),\n            });\n          } else {\n            await this.db.update(contentRefs, hash, {\n              refCount: refCount - 1,\n              lastSeenAt: new Date().toISOString(),\n            });\n          }\n        }\n      } catch {\n        // ignore — content_refs may not exist\n      }\n    }\n    // GC stale content_refs with 7-day grace\n    try {\n      const contentRefs = this.db.tables.contentRefs;\n      const cutoff = new Date(Date.now() - 7 * 86_400_000).toISOString();\n      const all = (await this.db.list(contentRefs)) as unknown as {\n        hash: string;\n        refCount: number;\n        lastSeenAt: string;\n      }[];\n      for (const row of all) {\n        if (row.refCount === 0 && row.lastSeenAt < cutoff) {\n          await this.storage.delete(`content/${row.hash}`).catch(() => {\n            // ignore storage delete failure\n          });\n          await this.db.remove(contentRefs, row.hash);\n        }\n      }\n    } catch {\n      // ignore — content_refs may not exist\n    }\n    return files.length;\n  }\n\n  async purgeStaleBranches(project: Project, ttlDays: number): Promise<BranchGcResult> {\n    if (ttlDays <= 0) {\n      return { removedBranches: 0, removedBaselines: 0 };\n    }\n    const cutoff = new Date(Date.now() - ttlDays * 86_400_000).toISOString();\n    const rows = (await this.db.list(this.tables.builds, {\n      where: eq(col(this.tables.builds, \"projectId\"), project.id),\n    })) as unknown as { gitBranch: string; updatedAt: string }[];\n    const stale = collectStaleBranches(rows, project.gitDefaultBranch, cutoff);\n    if (stale.size === 0) {\n      return { removedBranches: 0, removedBaselines: 0 };\n    }\n    const baselines = new BaselineModel(this.db, this.tables, this.storage);\n    const removedBaselines = await baselines.removeStaleBranches(project.id, stale);\n    await this.sweepScreenshots(project);\n    this.logger?.info(\n      { projectId: project.id, removedBranches: stale.size, removedBaselines },\n      \"branch GC complete\",\n    );\n    return { removedBranches: stale.size, removedBaselines };\n  }\n}\n\n/** Options controlling which builds a retention purge removes. */\nexport interface PurgeOptions {\n  ttlDays: number;\n  keepLatestPerBranch: boolean;\n}\n\n/** Counts of builds and files removed by a retention purge. */\nexport interface PurgeResult {\n  removedBuilds: number;\n  removedFiles: number;\n}\n\n/** Counts of stale branches and baselines removed. */\nexport interface BranchGcResult {\n  removedBranches: number;\n  removedBaselines: number;\n}\n\nfunction collectStaleBranches(\n  rows: { gitBranch: string; updatedAt: string }[],\n  defaultBranch: string,\n  cutoff: string,\n): Set<string> {\n  const latestAt = branchLatestAt(rows);\n  const stale = new Set<string>();\n  for (const [branch, updatedAt] of latestAt) {\n    if (branch !== defaultBranch && updatedAt < cutoff) {\n      stale.add(branch);\n    }\n  }\n  return stale;\n}\n\nfunction branchLatestAt(rows: { gitBranch: string; updatedAt: string }[]): Map<string, string> {\n  const latestAt = new Map<string, string>();\n  for (const row of rows) {\n    const current = latestAt.get(row.gitBranch);\n    if (!current || row.updatedAt > current) {\n      latestAt.set(row.gitBranch, row.updatedAt);\n    }\n  }\n  return latestAt;\n}\n"],"mappings":"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"}
+{"version":3,"file":"retention.mjs","names":[],"sources":["../src/retention/purge.ts"],"sourcesContent":["import { and, desc, eq, inArray, lt } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { Logger } from \"pino\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { BaselineModel } from \"../models/baseline.ts\";\nimport { BuildComponentModel } from \"../models/build-component.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport { CaptureJobModel } from \"../models/capture-job.ts\";\nimport { InsightModel } from \"../models/insight.ts\";\nimport { LabelModel, type LabelTables } from \"../models/label.ts\";\nimport { PackageUsageModel } from \"../models/usage.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport { TERMINAL_BUILD_STATUSES } from \"../types.ts\";\nimport { pendingCandidates } from \"./pending.ts\";\nimport { sweepPublishedGzip } from \"./published-gzip-sweep.ts\";\nimport { sweepScreenshotContent } from \"./screenshot-sweep.ts\";\n\nexport {\n  sweepScreenshotContent,\n  SWEEP_GRACE_MS,\n  type SweepDeps,\n  type SweepResult,\n  type SweepTables,\n} from \"./screenshot-sweep.ts\";\nimport { col } from \"../models/columns.ts\";\nimport { publishedGzipPath } from \"../utils/paths.ts\";\nexport { purgeAiData, STALE_RUN_MS, type AiPurgeResult } from \"./ai.ts\";\n\n/** Table handles for retention queries. */\nexport interface RetentionTables {\n  builds: Table;\n  buildLabels: Table;\n  baselines: Table;\n}\n\n/** Removes expired transient builds while keeping baselines and persistent builds. */\nexport class Retention {\n  private readonly db: DatabaseAdapter;\n  private readonly storage: StorageAdapter;\n  private readonly tables: RetentionTables;\n  private readonly logger?: Logger;\n\n  constructor(\n    db: DatabaseAdapter,\n    storage: StorageAdapter,\n    tables: RetentionTables,\n    logger?: Logger,\n  ) {\n    this.db = db;\n    this.storage = storage;\n    this.tables = tables;\n    this.logger = logger;\n  }\n\n  async purge(project: Project, options: PurgeOptions): Promise<PurgeResult> {\n    const cutoff = new Date(Date.now() - options.ttlDays * 86_400_000).toISOString();\n    const { buildIds, pending } = await this.selectBuilds(project, options, cutoff);\n    const results = await Promise.all(\n      buildIds.map(async (buildId) => ({\n        files: await this.deleteBuildFiles(project.id, buildId),\n        removed: await this.removeBuild(buildId),\n      })),\n    );\n    const removedBuilds = results.filter((r: { removed: boolean }) => r.removed).length;\n    const removedFiles = results.reduce((sum: number, r: { files: number }) => sum + r.files, 0);\n    await this.sweepScreenshots(project);\n    const removedJobs = await this.purgeFinishedJobs(cutoff);\n    this.logger?.info(\n      { projectId: project.id, removedBuilds, removedFiles, removedJobs, removedPending: pending },\n      \"build retention purge complete\",\n    );\n    return { removedBuilds, removedFiles };\n  }\n\n  /**\n   * The builds a purge removes: terminal builds past the window (minus the latest per branch when\n   * asked), and pending builds idle past it (ADR 0013, decision 9). Persistent builds stay.\n   */\n  private async selectBuilds(\n    project: Project,\n    options: PurgeOptions,\n    cutoff: string,\n  ): Promise<{ buildIds: string[]; pending: number }> {\n    const candidates = await this.db.list(this.tables.builds, {\n      where: and(\n        eq(col(this.tables.builds, \"projectId\"), project.id),\n        inArray(col(this.tables.builds, \"status\"), [...TERMINAL_BUILD_STATUSES]),\n        lt(col(this.tables.builds, \"updatedAt\"), cutoff),\n      ),\n    });\n    const keep = options.keepLatestPerBranch\n      ? await this.latestPerBranch(project.id)\n      : new Set<string>();\n    const persistent = await new LabelModel(\n      this.db,\n      this.tables as unknown as LabelTables,\n    ).persistentBuildIds(project.id);\n    const terminal = candidates\n      .map((build) => (build as { id: string }).id)\n      .filter((buildId) => !keep.has(buildId));\n    // Pending builds leave on their own clock; \"the latest on a branch\" does not shield them.\n    const pending = (await pendingCandidates(this.db, project.id, cutoff)).map(\n      (candidate) => candidate.buildId,\n    );\n    return {\n      buildIds: [...terminal, ...pending].filter((buildId) => !persistent.has(buildId)),\n      pending: pending.length,\n    };\n  }\n\n  /** Reclaim screenshots no snapshot or baseline references any more; never blocks the purge. */\n  private async sweepScreenshots(project: Project): Promise<void> {\n    try {\n      await sweepScreenshotContent(\n        {\n          db: this.db,\n          storage: this.storage,\n          tables: {\n            snapshots: this.db.tables.snapshots,\n            baselines: this.tables.baselines,\n            builds: this.tables.builds,\n          },\n          logger: this.logger,\n        },\n        project.id,\n      );\n    } catch (error) {\n      this.logger?.warn({ err: error, projectId: project.id }, \"screenshot sweep failed\");\n    }\n  }\n\n  /**\n   * Drop finished queue jobs older than the build cutoff (they have no foreign key to a build, and\n   * a finished job is only history); never blocks the purge. Queued and running jobs are kept.\n   */\n  private async purgeFinishedJobs(cutoff: string): Promise<number> {\n    try {\n      return await new CaptureJobModel(this.db).purgeFinished(cutoff);\n    } catch (error) {\n      this.logger?.warn({ err: error }, \"capture job purge failed\");\n      return 0;\n    }\n  }\n\n  private async removeBuild(buildId: string): Promise<boolean> {\n    await new InsightModel(this.db).removeForBuild(buildId);\n    await new CaptureJobModel(this.db).removeForBuild(buildId);\n    await new BuildComponentModel(this.db).removeForBuild(buildId);\n    await new PackageUsageModel(this.db).removeForBuild(buildId);\n    await new BuildModel(this.db, this.tables as unknown as BuildTables).remove(buildId);\n    return true;\n  }\n\n  private async latestPerBranch(projectId: string): Promise<Set<string>> {\n    const rows = (await this.db.list(this.tables.builds, {\n      where: eq(col(this.tables.builds, \"projectId\"), projectId),\n      orderBy: desc(col(this.tables.builds, \"updatedAt\")),\n    })) as unknown as { gitBranch: string; id: string }[];\n    const latest = new Map<string, string>();\n    for (const row of rows) {\n      const branch = row.gitBranch;\n      const current = latest.get(branch);\n      if (!current) {\n        latest.set(branch, row.id);\n      }\n    }\n    return new Set(latest.values());\n  }\n\n  private async deleteBuildFiles(projectId: string, buildId: string): Promise<number> {\n    const prefix = `${projectId}/builds/${buildId}/`;\n    const manifestPath = `${prefix}storybook/manifest.json`;\n    let manifestFiles: string[] = [];\n    try {\n      if (await this.storage.exists(manifestPath)) {\n        const raw = await this.storage.read(manifestPath);\n        const manifest = JSON.parse(raw.toString(\"utf8\")) as Record<string, string>;\n        manifestFiles = Object.values(manifest);\n      }\n    } catch {\n      // ignore — manifest may not exist for old builds\n    }\n    const files = await this.storage.list(prefix);\n    await Promise.all(\n      files.map(async (file) => {\n        await this.storage.delete(file);\n      }),\n    );\n    // Decrement content refs for this build's manifest\n    for (const hash of manifestFiles) {\n      try {\n        const contentRefs = this.db.tables.contentRefs;\n        const existing = (await this.db.get(contentRefs, hash)) as unknown as {\n          refCount: number;\n        } | null;\n        // oxlint-disable-next-line unicorn/prefer-ternary -- refCount check is clearer as if/else\n        if (existing) {\n          const refCount = existing.refCount;\n          // oxlint-disable-next-line unicorn/prefer-ternary -- grace logic is clearer as if/else\n          if (refCount <= 1) {\n            // Keep for 7-day grace: set refCount 0 and update lastSeenAt, don't delete yet\n            await this.db.update(contentRefs, hash, {\n              refCount: 0,\n              lastSeenAt: new Date().toISOString(),\n            });\n          } else {\n            await this.db.update(contentRefs, hash, {\n              refCount: refCount - 1,\n              lastSeenAt: new Date().toISOString(),\n            });\n          }\n        }\n      } catch {\n        // ignore — content_refs may not exist\n      }\n    }\n    // GC stale content_refs with 7-day grace\n    try {\n      const contentRefs = this.db.tables.contentRefs;\n      const cutoff = new Date(Date.now() - 7 * 86_400_000).toISOString();\n      const all = (await this.db.list(contentRefs)) as unknown as {\n        hash: string;\n        refCount: number;\n        lastSeenAt: string;\n      }[];\n      for (const row of all) {\n        if (row.refCount === 0 && row.lastSeenAt < cutoff) {\n          await this.storage.delete(`content/${row.hash}`).catch(() => {\n            // ignore storage delete failure\n          });\n          // Variants are disposable; never let their deletion affect authoritative data.\n          if (/^[a-f0-9]{64}$/u.test(row.hash)) {\n            await this.storage.delete(publishedGzipPath(row.hash)).catch(() => {});\n          }\n          await this.db.remove(contentRefs, row.hash);\n        }\n      }\n    } catch {\n      // ignore — content_refs may not exist\n    }\n    await sweepPublishedGzip(this.storage).catch(() => {});\n    return files.length;\n  }\n\n  async purgeStaleBranches(project: Project, ttlDays: number): Promise<BranchGcResult> {\n    if (ttlDays <= 0) {\n      return { removedBranches: 0, removedBaselines: 0 };\n    }\n    const cutoff = new Date(Date.now() - ttlDays * 86_400_000).toISOString();\n    const rows = (await this.db.list(this.tables.builds, {\n      where: eq(col(this.tables.builds, \"projectId\"), project.id),\n    })) as unknown as { gitBranch: string; updatedAt: string }[];\n    const stale = collectStaleBranches(rows, project.gitDefaultBranch, cutoff);\n    if (stale.size === 0) {\n      return { removedBranches: 0, removedBaselines: 0 };\n    }\n    const baselines = new BaselineModel(this.db, this.tables, this.storage);\n    const removedBaselines = await baselines.removeStaleBranches(project.id, stale);\n    await this.sweepScreenshots(project);\n    this.logger?.info(\n      { projectId: project.id, removedBranches: stale.size, removedBaselines },\n      \"branch GC complete\",\n    );\n    return { removedBranches: stale.size, removedBaselines };\n  }\n}\n\n/** Options controlling which builds a retention purge removes. */\nexport interface PurgeOptions {\n  ttlDays: number;\n  keepLatestPerBranch: boolean;\n}\n\n/** Counts of builds and files removed by a retention purge. */\nexport interface PurgeResult {\n  removedBuilds: number;\n  removedFiles: number;\n}\n\n/** Counts of stale branches and baselines removed. */\nexport interface BranchGcResult {\n  removedBranches: number;\n  removedBaselines: number;\n}\n\nfunction collectStaleBranches(\n  rows: { gitBranch: string; updatedAt: string }[],\n  defaultBranch: string,\n  cutoff: string,\n): Set<string> {\n  const latestAt = branchLatestAt(rows);\n  const stale = new Set<string>();\n  for (const [branch, updatedAt] of latestAt) {\n    if (branch !== defaultBranch && updatedAt < cutoff) {\n      stale.add(branch);\n    }\n  }\n  return stale;\n}\n\nfunction branchLatestAt(rows: { gitBranch: string; updatedAt: string }[]): Map<string, string> {\n  const latestAt = new Map<string, string>();\n  for (const row of rows) {\n    const current = latestAt.get(row.gitBranch);\n    if (!current || row.updatedAt > current) {\n      latestAt.set(row.gitBranch, row.updatedAt);\n    }\n  }\n  return latestAt;\n}\n"],"mappings":"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"}

package/dist/schema/baseline.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/baseline.d.ts
 /** A baseline row. */
 interface Baseline {
   id: string;
@@ -9,6 +8,8 @@ interface Baseline {
   viewportName: string;
   branch: string;
   snapshotId: string | null;
+  /** Build that actually rendered this image; null for unknown or imported origins. */
+  sourceBuildId?: string | null;
   screenshotPath: string;
   infraHash: string | null;
   /** JSON `Fingerprint` behind `infraHash`; null on baselines recorded before fingerprints. */
@@ -20,6 +21,5 @@ interface Baseline {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { Baseline };
 //# sourceMappingURL=baseline.d.mts.map

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

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/build-component.d.ts
 /**
  * Row type of `build_components` (ADR 0006, decision 9): one row per component of a published
  * build, written from the build's Storybook index when publishing ends. A component is the
@@ -20,6 +19,5 @@ interface BuildComponent {
   hash: string;
   createdAt: string;
 }
-//#endregion
 export { BuildComponent };
 //# sourceMappingURL=build-component.d.mts.map

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

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ReviewVerdict } from "../types.mjs";
-//#region src/schema/build-review.d.ts
 /** One verdict on one build. */
 interface BuildReview {
   id: string;
@@ -12,6 +11,5 @@ interface BuildReview {
   body: string | null;
   createdAt: string;
 }
-//#endregion
 export { BuildReview };
 //# sourceMappingURL=build-review.d.mts.map

package/dist/schema/build.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { BuildStatus } from "../types.mjs";
-//#region src/schema/build.d.ts
 /** A build row. */
 interface Build {
   id: string;
@@ -36,6 +35,5 @@ interface Build {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { Build };
 //# sourceMappingURL=build.d.mts.map

package/dist/schema/capture-attempt.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { JobStatus } from "../adapter/capture-queue.mjs";
-//#region src/schema/capture-attempt.d.ts
 /** A capture attempt row: one queued run of a build's capture pipeline. */
 interface CaptureAttempt {
   id: string;
@@ -33,6 +32,5 @@ interface CaptureLog {
   fields: string | null;
   createdAt: string;
 }
-//#endregion
 export { CaptureAttempt, CaptureLog, CaptureLogLevel };
 //# sourceMappingURL=capture-attempt.d.mts.map

package/dist/schema/capture-job.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/capture-job.d.ts
 /**
  * Row types of `capture_jobs`, the database queue (ADR 0006, decision 4).
  *
@@ -55,6 +54,5 @@ interface CaptureJobRow {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { CaptureAttemptStatus, CaptureJobEntry, CaptureJobKind, CaptureJobRow, CaptureJobStatus };
 //# sourceMappingURL=capture-job.d.mts.map

package/dist/schema/capture-shard.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/capture-shard.d.ts
 /** What a row of `capture_shards` is: a stage of a sharded capture, or the claim that finalizes it. */
 type CaptureShardKind = "plan" | "render" | "finalize";
 /** Lifecycle of one shard row. */
@@ -30,6 +29,5 @@ interface CaptureShard {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { CaptureShard, CaptureShardKind, CaptureShardStatus };
 //# sourceMappingURL=capture-shard.d.mts.map

package/dist/schema/comment.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/comment.d.ts
 /** A comment row. */
 interface Comment {
   id: string;
@@ -16,6 +15,5 @@ interface Comment {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { Comment };
 //# sourceMappingURL=comment.d.mts.map

package/dist/schema/connection.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/connection.d.ts
 /**
  * A user's own OAuth connection to an external service (`design` providers today,
  * issue trackers later). One per user and service; tokens are encrypted at rest.
@@ -19,6 +18,5 @@ interface UserConnection {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { UserConnection };
 //# sourceMappingURL=connection.d.mts.map

package/dist/schema/content-ref.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/content-ref.d.ts
 /** Content ref row for deduplicated assets. */
 interface ContentRef {
   hash: string;
@@ -8,6 +7,5 @@ interface ContentRef {
   lastSeenAt: string;
   createdAt: string;
 }
-//#endregion
 export { ContentRef };
 //# sourceMappingURL=content-ref.d.mts.map