@storyshelf/app 0.6.2 → 0.8.0

package/dist/retention-timer.mjs

@@ -2,8 +2,8 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { ProjectModel } from "@storyshelf/core/models";
-import { Retention } from "@storyshelf/core/retention";
-//#region src/retention-timer.ts
+import { Retention, purgeAiData } from "@storyshelf/core/retention";
+// src/retention-timer.ts
 const DEFAULT_BRANCH_TTL_DAYS = 30;
 const DEFAULT_BRANCH_GC_INTERVAL_MS = 864e5;
 /**
@@ -17,16 +17,20 @@ const DEFAULT_BRANCH_GC_INTERVAL_MS = 864e5;
 * @param logger - Structured logger for sweep diagnostics
 * @returns Timer handle with `stop()`, or `null` if GC is disabled
 */
-function startBranchGcTimer(db, storage, config, logger) {
+function startBranchGcTimer(db, storage, config, logger, testing = false) {
 	const ttlDays = config.branchTtlDays ?? DEFAULT_BRANCH_TTL_DAYS;
 	if (ttlDays === null) return null;
 	const intervalMs = config.branchGcIntervalMs ?? DEFAULT_BRANCH_GC_INTERVAL_MS;
 	if (intervalMs <= 0) return null;
-	return scheduleBranchGc(createBranchGcRunner(db, storage, logger, ttlDays), intervalMs);
+	return scheduleBranchGc(createBranchGcRunner(db, storage, logger, ttlDays, testing), intervalMs);
 }
-function createBranchGcRunner(db, storage, logger, ttlDays) {
+function createBranchGcRunner(db, storage, logger, ttlDays, testing) {
 	return async () => {
 		try {
+			if (testing) {
+				await purgeAiData(db, /* @__PURE__ */ new Date(), logger);
+				return;
+			}
 			const projects = await new ProjectModel(db).list();
 			const retention = new Retention(db, storage, {
 				builds: db.tables.builds,
@@ -36,6 +40,7 @@ function createBranchGcRunner(db, storage, logger, ttlDays) {
 			const results = await Promise.all(projects.map((project) => retention.purgeStaleBranches(project, ttlDays)));
 			const totalBranches = results.reduce((sum, r) => sum + r.removedBranches, 0);
 			const totalBaselines = results.reduce((sum, r) => sum + r.removedBaselines, 0);
+			await purgeAiData(db, /* @__PURE__ */ new Date(), logger);
 			if (totalBranches > 0 || totalBaselines > 0) logger.info({
 				totalBranches,
 				totalBaselines
@@ -46,20 +51,15 @@ function createBranchGcRunner(db, storage, logger, ttlDays) {
 	};
 }
 function scheduleBranchGc(run, intervalMs) {
-	const timeout = setTimeout(() => {
-		run();
-	}, Math.min(36e5, intervalMs));
+	const timeout = setTimeout(() => run(), Math.min(36e5, intervalMs));
 	timeout.unref?.();
-	const interval = setInterval(() => {
-		run();
-	}, intervalMs);
+	const interval = setInterval(() => run(), intervalMs);
 	interval.unref?.();
 	return { stop: () => {
 		clearTimeout(timeout);
 		clearInterval(interval);
 	} };
 }
-//#endregion
 export { startBranchGcTimer };
 
 //# sourceMappingURL=retention-timer.mjs.map

package/dist/retention-timer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"retention-timer.mjs","names":[],"sources":["../src/retention-timer.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"@storyshelf/core/adapter/database\";\nimport type { StorageAdapter } from \"@storyshelf/core/adapter/storage\";\nimport type { ShelfConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\n/* oxlint-disable typescript/promise-function-async -- interval helpers return promise factories */\nimport { ProjectModel } from \"@storyshelf/core/models\";\nimport { Retention } from \"@storyshelf/core/retention\";\n\nconst DEFAULT_BRANCH_TTL_DAYS = 30;\nconst DEFAULT_BRANCH_GC_INTERVAL_MS = 86_400_000;\n\n/** Handle for the background branch-GC interval; call `stop()` on server shutdown. */\nexport interface BranchGcTimer {\n  stop(): void;\n}\n\n/**\n * Start a daily sweep that removes baselines for branches that have not\n * been updated within `branchTtlDays`. Returns a timer handle or `null`\n * when GC is disabled (`branchTtlDays: null` or non-positive interval).\n *\n * @param db - Database adapter to list projects\n * @param storage - Storage adapter for baseline cleanup\n * @param config - Shelf config supplying `branchTtlDays` and `branchGcIntervalMs`\n * @param logger - Structured logger for sweep diagnostics\n * @returns Timer handle with `stop()`, or `null` if GC is disabled\n */\nexport function startBranchGcTimer(\n  db: DatabaseAdapter,\n  storage: StorageAdapter,\n  config: ShelfConfig,\n  logger: Logger,\n): BranchGcTimer | null {\n  const ttlDays = config.branchTtlDays ?? DEFAULT_BRANCH_TTL_DAYS;\n  if (ttlDays === null) {\n    return null;\n  }\n  const intervalMs = config.branchGcIntervalMs ?? DEFAULT_BRANCH_GC_INTERVAL_MS;\n  if (intervalMs <= 0) {\n    return null;\n  }\n  const run = createBranchGcRunner(db, storage, logger, ttlDays);\n  return scheduleBranchGc(run, intervalMs);\n}\n\n// oxlint-disable-next-line typescript/promise-function-async\nfunction createBranchGcRunner(\n  db: DatabaseAdapter,\n  storage: StorageAdapter,\n  logger: Logger,\n  ttlDays: number,\n): () => Promise<void> {\n  return async (): Promise<void> => {\n    try {\n      const projects = await new ProjectModel(db).list();\n      const retention = new Retention(\n        db,\n        storage,\n        {\n          builds: db.tables.builds,\n          buildLabels: db.tables.buildLabels,\n          baselines: db.tables.baselines,\n        },\n        logger,\n      );\n      const results = await Promise.all(\n        projects.map((project) => retention.purgeStaleBranches(project, ttlDays)),\n      );\n      const totalBranches = results.reduce(\n        (sum: number, r: { removedBranches: number }) => sum + r.removedBranches,\n        0,\n      );\n      const totalBaselines = results.reduce(\n        (sum: number, r: { removedBaselines: number }) => sum + r.removedBaselines,\n        0,\n      );\n      if (totalBranches > 0 || totalBaselines > 0) {\n        logger.info({ totalBranches, totalBaselines }, \"branch GC daily sweep complete\");\n      }\n    } catch (error) {\n      logger.error({ err: error }, \"branch GC sweep failed\");\n    }\n  };\n}\n\nfunction scheduleBranchGc(run: () => Promise<void>, intervalMs: number): BranchGcTimer {\n  const firstDelay = Math.min(3_600_000, intervalMs);\n  const timeout = setTimeout(() => {\n    // oxlint-disable-next-line no-void -- fire-and-forget interval task\n    void run();\n  }, firstDelay);\n  timeout.unref?.();\n\n  const interval = setInterval(() => {\n    // oxlint-disable-next-line no-void -- fire-and-forget interval task\n    void run();\n  }, intervalMs);\n  interval.unref?.();\n\n  return {\n    stop: () => {\n      clearTimeout(timeout);\n      clearInterval(interval);\n    },\n  };\n}\n"],"mappings":";;;;;;AAQA,MAAM,0BAA0B;AAChC,MAAM,gCAAgC;;;;;;;;;;;;AAkBtC,SAAgB,mBACd,IACA,SACA,QACA,QACsB;CACtB,MAAM,UAAU,OAAO,iBAAiB;CACxC,IAAI,YAAY,MACd,OAAO;CAET,MAAM,aAAa,OAAO,sBAAsB;CAChD,IAAI,cAAc,GAChB,OAAO;CAGT,OAAO,iBADK,qBAAqB,IAAI,SAAS,QAAQ,OAC5B,GAAG,UAAU;AACzC;AAGA,SAAS,qBACP,IACA,SACA,QACA,SACqB;CACrB,OAAO,YAA2B;EAChC,IAAI;GACF,MAAM,WAAW,MAAM,IAAI,aAAa,EAAE,CAAC,CAAC,KAAK;GACjD,MAAM,YAAY,IAAI,UACpB,IACA,SACA;IACE,QAAQ,GAAG,OAAO;IAClB,aAAa,GAAG,OAAO;IACvB,WAAW,GAAG,OAAO;GACvB,GACA,MACF;GACA,MAAM,UAAU,MAAM,QAAQ,IAC5B,SAAS,KAAK,YAAY,UAAU,mBAAmB,SAAS,OAAO,CAAC,CAC1E;GACA,MAAM,gBAAgB,QAAQ,QAC3B,KAAa,MAAmC,MAAM,EAAE,iBACzD,CACF;GACA,MAAM,iBAAiB,QAAQ,QAC5B,KAAa,MAAoC,MAAM,EAAE,kBAC1D,CACF;GACA,IAAI,gBAAgB,KAAK,iBAAiB,GACxC,OAAO,KAAK;IAAE;IAAe;GAAe,GAAG,gCAAgC;EAEnF,SAAS,OAAO;GACd,OAAO,MAAM,EAAE,KAAK,MAAM,GAAG,wBAAwB;EACvD;CACF;AACF;AAEA,SAAS,iBAAiB,KAA0B,YAAmC;CAErF,MAAM,UAAU,iBAAiB;EAE/B,IAAS;CACX,GAJmB,KAAK,IAAI,MAAW,UAI3B,CAAC;CACb,QAAQ,QAAQ;CAEhB,MAAM,WAAW,kBAAkB;EAEjC,IAAS;CACX,GAAG,UAAU;CACb,SAAS,QAAQ;CAEjB,OAAO,EACL,YAAY;EACV,aAAa,OAAO;EACpB,cAAc,QAAQ;CACxB,EACF;AACF"}
+{"version":3,"file":"retention-timer.mjs","names":[],"sources":["../src/retention-timer.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"@storyshelf/core/adapter/database\";\nimport type { StorageAdapter } from \"@storyshelf/core/adapter/storage\";\nimport type { ShelfConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\n/* oxlint-disable typescript/promise-function-async -- interval helpers return promise factories */\nimport { ProjectModel } from \"@storyshelf/core/models\";\nimport { Retention, purgeAiData } from \"@storyshelf/core/retention\";\n\nconst DEFAULT_BRANCH_TTL_DAYS = 30;\nconst DEFAULT_BRANCH_GC_INTERVAL_MS = 86_400_000;\n\n/** Handle for the background branch-GC interval; call `stop()` on server shutdown. */\nexport interface BranchGcTimer {\n  stop(): void;\n}\n\n/**\n * Start a daily sweep that removes baselines for branches that have not\n * been updated within `branchTtlDays`. Returns a timer handle or `null`\n * when GC is disabled (`branchTtlDays: null` or non-positive interval).\n *\n * @param db - Database adapter to list projects\n * @param storage - Storage adapter for baseline cleanup\n * @param config - Shelf config supplying `branchTtlDays` and `branchGcIntervalMs`\n * @param logger - Structured logger for sweep diagnostics\n * @returns Timer handle with `stop()`, or `null` if GC is disabled\n */\nexport function startBranchGcTimer(\n  db: DatabaseAdapter,\n  storage: StorageAdapter,\n  config: ShelfConfig,\n  logger: Logger,\n  testing = false,\n): BranchGcTimer | null {\n  const ttlDays = config.branchTtlDays ?? DEFAULT_BRANCH_TTL_DAYS;\n  if (ttlDays === null) {\n    return null;\n  }\n  const intervalMs = config.branchGcIntervalMs ?? DEFAULT_BRANCH_GC_INTERVAL_MS;\n  if (intervalMs <= 0) {\n    return null;\n  }\n  const run = createBranchGcRunner(db, storage, logger, ttlDays, testing);\n  return scheduleBranchGc(run, intervalMs);\n}\n\n// oxlint-disable-next-line typescript/promise-function-async\nfunction createBranchGcRunner(\n  db: DatabaseAdapter,\n  storage: StorageAdapter,\n  logger: Logger,\n  ttlDays: number,\n  testing: boolean,\n): () => Promise<void> {\n  // oxlint-disable-next-line eslint/max-statements -- the sweep and its error boundary are kept together\n  return async (): Promise<void> => {\n    try {\n      // Baseline removal must be coordinated with references before testing deployments can GC.\n      // Keep independent AI-data cleanup running even while branch GC is disabled.\n      if (testing) {\n        await purgeAiData(db, new Date(), logger);\n        return;\n      }\n      const projects = await new ProjectModel(db).list();\n      const retention = new Retention(\n        db,\n        storage,\n        {\n          builds: db.tables.builds,\n          buildLabels: db.tables.buildLabels,\n          baselines: db.tables.baselines,\n        },\n        logger,\n      );\n      const results = await Promise.all(\n        projects.map((project) => retention.purgeStaleBranches(project, ttlDays)),\n      );\n      const totalBranches = results.reduce(\n        (sum: number, r: { removedBranches: number }) => sum + r.removedBranches,\n        0,\n      );\n      const totalBaselines = results.reduce(\n        (sum: number, r: { removedBaselines: number }) => sum + r.removedBaselines,\n        0,\n      );\n      await purgeAiData(db, new Date(), logger);\n      if (totalBranches > 0 || totalBaselines > 0) {\n        logger.info({ totalBranches, totalBaselines }, \"branch GC daily sweep complete\");\n      }\n    } catch (error) {\n      logger.error({ err: error }, \"branch GC sweep failed\");\n    }\n  };\n}\n\nfunction scheduleBranchGc(run: () => Promise<void>, intervalMs: number): BranchGcTimer {\n  const firstDelay = Math.min(3_600_000, intervalMs);\n  // oxlint-disable-next-line typescript/no-misused-promises, typescript/strict-void-return -- run catches failures; returning it allows deterministic completion in tests\n  const timeout = setTimeout(() => run(), firstDelay);\n  timeout.unref?.();\n\n  // oxlint-disable-next-line typescript/no-misused-promises, typescript/strict-void-return -- run catches failures\n  const interval = setInterval(() => run(), intervalMs);\n  interval.unref?.();\n\n  return {\n    stop: () => {\n      clearTimeout(timeout);\n      clearInterval(interval);\n    },\n  };\n}\n"],"mappings":";;;;;;AAQA,MAAM,0BAA0B;AAChC,MAAM,gCAAgC;;;;;;;;;;;;AAkBtC,SAAgB,mBACd,IACA,SACA,QACA,QACA,UAAU,OACY;CACtB,MAAM,UAAU,OAAO,iBAAiB;CACxC,IAAI,YAAY,MACd,OAAO;CAET,MAAM,aAAa,OAAO,sBAAsB;CAChD,IAAI,cAAc,GAChB,OAAO;CAGT,OAAO,iBADK,qBAAqB,IAAI,SAAS,QAAQ,SAAS,OACrC,GAAG,UAAU;AACzC;AAGA,SAAS,qBACP,IACA,SACA,QACA,SACA,SACqB;CAErB,OAAO,YAA2B;EAChC,IAAI;GAGF,IAAI,SAAS;IACX,MAAM,YAAY,oBAAI,IAAI,KAAK,GAAG,MAAM;IACxC;GACF;GACA,MAAM,WAAW,MAAM,IAAI,aAAa,EAAE,CAAC,CAAC,KAAK;GACjD,MAAM,YAAY,IAAI,UACpB,IACA,SACA;IACE,QAAQ,GAAG,OAAO;IAClB,aAAa,GAAG,OAAO;IACvB,WAAW,GAAG,OAAO;GACvB,GACA,MACF;GACA,MAAM,UAAU,MAAM,QAAQ,IAC5B,SAAS,KAAK,YAAY,UAAU,mBAAmB,SAAS,OAAO,CAAC,CAC1E;GACA,MAAM,gBAAgB,QAAQ,QAC3B,KAAa,MAAmC,MAAM,EAAE,iBACzD,CACF;GACA,MAAM,iBAAiB,QAAQ,QAC5B,KAAa,MAAoC,MAAM,EAAE,kBAC1D,CACF;GACA,MAAM,YAAY,oBAAI,IAAI,KAAK,GAAG,MAAM;GACxC,IAAI,gBAAgB,KAAK,iBAAiB,GACxC,OAAO,KAAK;IAAE;IAAe;GAAe,GAAG,gCAAgC;EAEnF,SAAS,OAAO;GACd,OAAO,MAAM,EAAE,KAAK,MAAM,GAAG,wBAAwB;EACvD;CACF;AACF;AAEA,SAAS,iBAAiB,KAA0B,YAAmC;CAGrF,MAAM,UAAU,iBAAiB,IAAI,GAFlB,KAAK,IAAI,MAAW,UAEU,CAAC;CAClD,QAAQ,QAAQ;CAGhB,MAAM,WAAW,kBAAkB,IAAI,GAAG,UAAU;CACpD,SAAS,QAAQ;CAEjB,OAAO,EACL,YAAY;EACV,aAAa,OAAO;EACpB,cAAc,QAAQ;CACxB,EACF;AACF"}

package/dist/review-events.mjs

@@ -0,0 +1,47 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { credentialKeys } from "./credential-keys.mjs";
+import { getStore } from "./store.mjs";
+import { notifyProjectWith } from "./notify.mjs";
+import { emitWebhookEvent } from "@storyshelf/core/adapter/webhook-events";
+// src/review-events.ts
+/**
+* Review events (ADR 0013, decisions 4 and 10; ADR 0014, decision 10). They ride the existing
+* paths: signed webhooks to the project's subscribers and the notification fan-out (stored
+* channels plus per-user subscriptions). There is no new transport.
+*
+* - `review:requested`: a build is waiting for a verdict. Default-on for the project's approvers
+*   and admins (see `notify.ts`).
+* - `review:comment`: a build or story comment (snapshot comments keep `comment:created`).
+* - `review:verdict`: a reviewer approved or rejected a build.
+*/
+/** Event names of the review topics. */
+const REVIEW_EVENTS = {
+	requested: "review:requested",
+	comment: "review:comment",
+	verdict: "review:verdict"
+};
+/** Webhook and notification fan-out for one review event, from explicit dependencies. */
+async function announceReviewWith(deps, project, event, data, buildId) {
+	await emitWebhookEvent(deps.db, { webhooks: deps.db.tables.webhooks }, project.id, event, data, credentialKeys(deps.config), deps.logger);
+	await notifyProjectWith(deps, project, event, data, `/builds/${buildId}`);
+}
+/** {@link announceReviewWith} inside a request. */
+async function announceReview(project, event, data, buildId) {
+	await announceReviewWith(getStore(), project, event, data, buildId);
+}
+/** What `review:requested` carries: the build to look at. */
+function reviewRequestedData(build) {
+	return {
+		buildId: build.id,
+		gitSha: build.gitSha,
+		gitBranch: build.gitBranch,
+		authorName: build.authorName,
+		authorEmail: build.authorEmail,
+		message: build.message
+	};
+}
+export { REVIEW_EVENTS, announceReview, announceReviewWith, reviewRequestedData };
+
+//# sourceMappingURL=review-events.mjs.map

package/dist/review-events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-events.mjs","names":[],"sources":["../src/review-events.ts"],"sourcesContent":["/**\n * Review events (ADR 0013, decisions 4 and 10; ADR 0014, decision 10). They ride the existing\n * paths: signed webhooks to the project's subscribers and the notification fan-out (stored\n * channels plus per-user subscriptions). There is no new transport.\n *\n * - `review:requested`: a build is waiting for a verdict. Default-on for the project's approvers\n *   and admins (see `notify.ts`).\n * - `review:comment`: a build or story comment (snapshot comments keep `comment:created`).\n * - `review:verdict`: a reviewer approved or rejected a build.\n */\nimport { emitWebhookEvent } from \"@storyshelf/core/adapter/webhook-events\";\nimport type { Build, Project } from \"@storyshelf/core/schema\";\nimport { credentialKeys } from \"./credential-keys.ts\";\nimport { notifyProjectWith, type NotifyDeps } from \"./notify.ts\";\nimport { getStore } from \"./store.ts\";\n\n/** Event names of the review topics. */\nexport const REVIEW_EVENTS = {\n  requested: \"review:requested\",\n  comment: \"review:comment\",\n  verdict: \"review:verdict\",\n} as const;\n\n/** Webhook and notification fan-out for one review event, from explicit dependencies. */\nexport async function announceReviewWith(\n  deps: NotifyDeps,\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: (typeof REVIEW_EVENTS)[keyof typeof REVIEW_EVENTS],\n  data: Record<string, unknown>,\n  buildId: string,\n): Promise<void> {\n  await emitWebhookEvent(\n    deps.db,\n    { webhooks: deps.db.tables.webhooks },\n    project.id,\n    event,\n    data,\n    credentialKeys(deps.config),\n    deps.logger,\n  );\n  await notifyProjectWith(deps, project, event, data, `/builds/${buildId}`);\n}\n\n/** {@link announceReviewWith} inside a request. */\nexport async function announceReview(\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: (typeof REVIEW_EVENTS)[keyof typeof REVIEW_EVENTS],\n  data: Record<string, unknown>,\n  buildId: string,\n): Promise<void> {\n  await announceReviewWith(getStore(), project, event, data, buildId);\n}\n\n/** What `review:requested` carries: the build to look at. */\nexport function reviewRequestedData(build: Build): Record<string, unknown> {\n  return {\n    buildId: build.id,\n    gitSha: build.gitSha,\n    gitBranch: build.gitBranch,\n    authorName: build.authorName,\n    authorEmail: build.authorEmail,\n    message: build.message,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,MAAa,gBAAgB;CAC3B,WAAW;CACX,SAAS;CACT,SAAS;AACX;;AAGA,eAAsB,mBACpB,MACA,SACA,OACA,MACA,SACe;CACf,MAAM,iBACJ,KAAK,IACL,EAAE,UAAU,KAAK,GAAG,OAAO,SAAS,GACpC,QAAQ,IACR,OACA,MACA,eAAe,KAAK,MAAM,GAC1B,KAAK,MACP;CACA,MAAM,kBAAkB,MAAM,SAAS,OAAO,MAAM,WAAW,SAAS;AAC1E;;AAGA,eAAsB,eACpB,SACA,OACA,MACA,SACe;CACf,MAAM,mBAAmB,SAAS,GAAG,SAAS,OAAO,MAAM,OAAO;AACpE;;AAGA,SAAgB,oBAAoB,OAAuC;CACzE,OAAO;EACL,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,WAAW,MAAM;EACjB,YAAY,MAAM;EAClB,aAAa,MAAM;EACnB,SAAS,MAAM;CACjB;AACF"}

package/dist/routers/admin-pages.mjs

@@ -2,18 +2,25 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { getStore } from "../store.mjs";
+import { notificationsPaused } from "../notifications-pause.mjs";
 import { loadCredentialProbe, reencryptWithCurrent } from "../credentials.mjs";
+import { countHiddenSnapshots } from "../hidden-data.mjs";
+import { requireSiteAdmin } from "./helpers.mjs";
+import { insightDepsFromStore } from "../insights/deps.mjs";
+import { buildUsageReport } from "../insights/usage-report.mjs";
+import { renderAdminAiPage } from "../pages/admin-ai.mjs";
+import { runnerTargets } from "../targets.mjs";
 import { renderAdminSystemPage } from "../pages/admin-system.mjs";
 import { hxRedirect } from "./htmx.mjs";
 import { flash } from "./flash.mjs";
 import { collectHealthReport } from "./health-report.mjs";
-import { requireSiteAdmin } from "./helpers.mjs";
-//#region src/routers/admin-pages.ts
+import { describeCaptureHost } from "@storyshelf/core/utils";
+// src/routers/admin-pages.ts
 /** Register the site-admin System page (adapter inventory + in-depth health). */
 function registerAdminPages(app, deps, auth) {
 	app.get("/admin", async (c) => {
 		requireSiteAdmin(c);
-		const { authEnabled, config, db } = getStore();
+		const { authEnabled, config, db, capturesHere, captureConcurrency, testing } = getStore();
 		const credentials = await loadCredentialProbe(db, config);
 		const report = await collectHealthReport(deps.sources, deps.getSettled(), deps.bootTimeMs, deps.version, credentials);
 		const authMethods = auth?.loginMethods().map((method) => method.label);
@@ -23,9 +30,21 @@ function registerAdminPages(app, deps, auth) {
 			authEnabled,
 			config,
 			authMethods,
-			credentials
+			credentials,
+			aiEnabled: getStore().ai !== void 0,
+			testing,
+			hiddenSnapshots: testing ? 0 : await countHiddenSnapshots(db),
+			...await captureView(),
+			capture: capturesHere === true ? describeCaptureHost(captureConcurrency) : null
 		}));
 	});
+	app.get("/admin/ai", async (c) => {
+		requireSiteAdmin(c);
+		const aiDeps = insightDepsFromStore();
+		if (!aiDeps) return c.notFound();
+		c.header("Cache-Control", "no-store");
+		return c.html(renderAdminAiPage(await buildUsageReport(aiDeps)));
+	});
 	app.post("/admin/credentials/reencrypt", async (c) => {
 		requireSiteAdmin(c);
 		const { db, config } = getStore();
@@ -42,7 +61,29 @@ function reencryptMessage(result) {
 	const base = `Re-encrypted ${result.reencrypted} credential(s)`;
 	return result.failed > 0 ? `${base}; ${result.failed} failed — see server logs` : base;
 }
-//#endregion
+/** Whether the System page warns that notifications are paused. */
+async function pausedView() {
+	const store = getStore();
+	return store.notifiers.length > 0 && await notificationsPaused(store);
+}
+/** The System page's capture browsers and public origin (ADR 0007). */
+async function captureView() {
+	return {
+		targets: await runnerTargets(),
+		publicOrigin: await publicOriginView(),
+		notificationsPaused: await pausedView()
+	};
+}
+/** What the System page shows about the public origin: what resolves (confirmed), and what a browser reported. */
+async function publicOriginView() {
+	const { publicOrigin, authEnabled } = getStore();
+	if (publicOrigin === void 0) return;
+	return {
+		resolved: await publicOrigin.resolve(),
+		stored: await publicOrigin.stored(),
+		learns: authEnabled
+	};
+}
 export { registerAdminPages };
 
 //# sourceMappingURL=admin-pages.mjs.map

package/dist/routers/admin-pages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"admin-pages.mjs","names":[],"sources":["../../src/routers/admin-pages.ts"],"sourcesContent":["import type { Auth } from \"@storyshelf/core/auth\";\nimport type { AdapterSetupResult, AdapterSetupSources } from \"@storyshelf/core/adapter/setup\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { loadCredentialProbe, reencryptWithCurrent } from \"../credentials.ts\";\nimport { renderAdminSystemPage } from \"../pages/admin-system.tsx\";\nimport { getStore } from \"../store.ts\";\nimport { flash } from \"./flash.ts\";\nimport { collectHealthReport } from \"./health-report.ts\";\nimport { requireSiteAdmin } from \"./helpers.ts\";\nimport { hxRedirect } from \"./htmx.ts\";\n\n/** Dependencies for the admin System page (same probing inputs as deep health). */\nexport interface AdminPageDeps {\n  sources: AdapterSetupSources;\n  getSettled: () => AdapterSetupResult | null;\n  bootTimeMs: number;\n  version: string;\n}\n\n/** Register the site-admin System page (adapter inventory + in-depth health). */\nexport function registerAdminPages(app: ShelfRouter, deps: AdminPageDeps, auth?: Auth): void {\n  app.get(\"/admin\", async (c) => {\n    requireSiteAdmin(c);\n    const { authEnabled, config, db } = getStore();\n    const credentials = await loadCredentialProbe(db, config);\n    const report = await collectHealthReport(\n      deps.sources,\n      deps.getSettled(),\n      deps.bootTimeMs,\n      deps.version,\n      credentials,\n    );\n    const authMethods = auth?.loginMethods().map((method) => method.label);\n    c.header(\"Cache-Control\", \"no-store\");\n    return c.html(renderAdminSystemPage({ report, authEnabled, config, authMethods, credentials }));\n  });\n\n  app.post(\"/admin/credentials/reencrypt\", async (c) => {\n    requireSiteAdmin(c);\n    const { db, config } = getStore();\n    if (!config.previousSecret) {\n      flash(c, \"No previous secret is configured\", \"warning\");\n      return hxRedirect(c, \"/admin\");\n    }\n    const result = await reencryptWithCurrent(db, config);\n    flash(c, reencryptMessage(result), result.failed > 0 ? \"warning\" : \"success\");\n    return hxRedirect(c, \"/admin\");\n  });\n}\n\nfunction reencryptMessage(result: { reencrypted: number; failed: number }): string {\n  const base = `Re-encrypted ${result.reencrypted} credential(s)`;\n  return result.failed > 0 ? `${base}; ${result.failed} failed — see server logs` : base;\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,SAAgB,mBAAmB,KAAkB,MAAqB,MAAmB;CAC3F,IAAI,IAAI,UAAU,OAAO,MAAM;EAC7B,iBAAiB,CAAC;EAClB,MAAM,EAAE,aAAa,QAAQ,OAAO,SAAS;EAC7C,MAAM,cAAc,MAAM,oBAAoB,IAAI,MAAM;EACxD,MAAM,SAAS,MAAM,oBACnB,KAAK,SACL,KAAK,WAAW,GAChB,KAAK,YACL,KAAK,SACL,WACF;EACA,MAAM,cAAc,MAAM,aAAa,CAAC,CAAC,KAAK,WAAW,OAAO,KAAK;EACrE,EAAE,OAAO,iBAAiB,UAAU;EACpC,OAAO,EAAE,KAAK,sBAAsB;GAAE;GAAQ;GAAa;GAAQ;GAAa;EAAY,CAAC,CAAC;CAChG,CAAC;CAED,IAAI,KAAK,gCAAgC,OAAO,MAAM;EACpD,iBAAiB,CAAC;EAClB,MAAM,EAAE,IAAI,WAAW,SAAS;EAChC,IAAI,CAAC,OAAO,gBAAgB;GAC1B,MAAM,GAAG,oCAAoC,SAAS;GACtD,OAAO,WAAW,GAAG,QAAQ;EAC/B;EACA,MAAM,SAAS,MAAM,qBAAqB,IAAI,MAAM;EACpD,MAAM,GAAG,iBAAiB,MAAM,GAAG,OAAO,SAAS,IAAI,YAAY,SAAS;EAC5E,OAAO,WAAW,GAAG,QAAQ;CAC/B,CAAC;AACH;AAEA,SAAS,iBAAiB,QAAyD;CACjF,MAAM,OAAO,gBAAgB,OAAO,YAAY;CAChD,OAAO,OAAO,SAAS,IAAI,GAAG,KAAK,IAAI,OAAO,OAAO,6BAA6B;AACpF"}
+{"version":3,"file":"admin-pages.mjs","names":[],"sources":["../../src/routers/admin-pages.ts"],"sourcesContent":["import type { AdapterSetupResult, AdapterSetupSources } from \"@storyshelf/core/adapter/setup\";\nimport type { Auth } from \"@storyshelf/core/auth\";\nimport { describeCaptureHost } from \"@storyshelf/core/utils\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { loadCredentialProbe, reencryptWithCurrent } from \"../credentials.ts\";\nimport { countHiddenSnapshots } from \"../hidden-data.ts\";\nimport { insightDepsFromStore } from \"../insights/deps.ts\";\nimport { buildUsageReport } from \"../insights/usage-report.ts\";\nimport { notificationsPaused } from \"../notifications-pause.ts\";\nimport { renderAdminAiPage } from \"../pages/admin-ai.tsx\";\nimport { renderAdminSystemPage, type AdminSystemData } from \"../pages/admin-system.tsx\";\nimport { getStore } from \"../store.ts\";\nimport { runnerTargets } from \"../targets.ts\";\nimport { flash } from \"./flash.ts\";\nimport { collectHealthReport } from \"./health-report.ts\";\nimport { requireSiteAdmin } from \"./helpers.ts\";\nimport { hxRedirect } from \"./htmx.ts\";\n\n/** Dependencies for the admin System page (same probing inputs as deep health). */\nexport interface AdminPageDeps {\n  sources: AdapterSetupSources;\n  getSettled: () => AdapterSetupResult | null;\n  bootTimeMs: number;\n  version: string;\n}\n\n/** Register the site-admin System page (adapter inventory + in-depth health). */\nexport function registerAdminPages(app: ShelfRouter, deps: AdminPageDeps, auth?: Auth): void {\n  app.get(\"/admin\", async (c) => {\n    requireSiteAdmin(c);\n    const { authEnabled, config, db, capturesHere, captureConcurrency, testing } = getStore();\n    const credentials = await loadCredentialProbe(db, config);\n    const report = await collectHealthReport(\n      deps.sources,\n      deps.getSettled(),\n      deps.bootTimeMs,\n      deps.version,\n      credentials,\n    );\n    const authMethods = auth?.loginMethods().map((method) => method.label);\n    c.header(\"Cache-Control\", \"no-store\");\n    return c.html(\n      renderAdminSystemPage({\n        report,\n        authEnabled,\n        config,\n        authMethods,\n        credentials,\n        aiEnabled: getStore().ai !== undefined,\n        testing,\n        hiddenSnapshots: testing ? 0 : await countHiddenSnapshots(db),\n        ...(await captureView()),\n        // Only a host that runs capture jobs (one with `testing`) is sized here.\n        capture: capturesHere === true ? describeCaptureHost(captureConcurrency) : null,\n      }),\n    );\n  });\n\n  app.get(\"/admin/ai\", async (c) => {\n    requireSiteAdmin(c);\n    const aiDeps = insightDepsFromStore();\n    if (!aiDeps) {\n      return c.notFound();\n    }\n    c.header(\"Cache-Control\", \"no-store\");\n    return c.html(renderAdminAiPage(await buildUsageReport(aiDeps)));\n  });\n\n  app.post(\"/admin/credentials/reencrypt\", async (c) => {\n    requireSiteAdmin(c);\n    const { db, config } = getStore();\n    if (!config.previousSecret) {\n      flash(c, \"No previous secret is configured\", \"warning\");\n      return hxRedirect(c, \"/admin\");\n    }\n    const result = await reencryptWithCurrent(db, config);\n    flash(c, reencryptMessage(result), result.failed > 0 ? \"warning\" : \"success\");\n    return hxRedirect(c, \"/admin\");\n  });\n}\n\nfunction reencryptMessage(result: { reencrypted: number; failed: number }): string {\n  const base = `Re-encrypted ${result.reencrypted} credential(s)`;\n  return result.failed > 0 ? `${base}; ${result.failed} failed — see server logs` : base;\n}\n\n/** Whether the System page warns that notifications are paused. */\nasync function pausedView(): Promise<boolean> {\n  const store = getStore();\n  return store.notifiers.length > 0 && (await notificationsPaused(store));\n}\n\n/** The System page's capture browsers and public origin (ADR 0007). */\nasync function captureView(): Promise<\n  Pick<AdminSystemData, \"targets\" | \"publicOrigin\" | \"notificationsPaused\">\n> {\n  return {\n    targets: await runnerTargets(),\n    publicOrigin: await publicOriginView(),\n    notificationsPaused: await pausedView(),\n  };\n}\n\n/** What the System page shows about the public origin: what resolves (confirmed), and what a browser reported. */\nasync function publicOriginView(): Promise<AdminSystemData[\"publicOrigin\"]> {\n  const { publicOrigin, authEnabled } = getStore();\n  if (publicOrigin === undefined) {\n    return undefined;\n  }\n  return {\n    resolved: await publicOrigin.resolve(),\n    stored: await publicOrigin.stored(),\n    // Only a deployment with admins can learn an origin from one.\n    learns: authEnabled,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,mBAAmB,KAAkB,MAAqB,MAAmB;CAC3F,IAAI,IAAI,UAAU,OAAO,MAAM;EAC7B,iBAAiB,CAAC;EAClB,MAAM,EAAE,aAAa,QAAQ,IAAI,cAAc,oBAAoB,YAAY,SAAS;EACxF,MAAM,cAAc,MAAM,oBAAoB,IAAI,MAAM;EACxD,MAAM,SAAS,MAAM,oBACnB,KAAK,SACL,KAAK,WAAW,GAChB,KAAK,YACL,KAAK,SACL,WACF;EACA,MAAM,cAAc,MAAM,aAAa,CAAC,CAAC,KAAK,WAAW,OAAO,KAAK;EACrE,EAAE,OAAO,iBAAiB,UAAU;EACpC,OAAO,EAAE,KACP,sBAAsB;GACpB;GACA;GACA;GACA;GACA;GACA,WAAW,SAAS,CAAC,CAAC,OAAO,KAAA;GAC7B;GACA,iBAAiB,UAAU,IAAI,MAAM,qBAAqB,EAAE;GAC5D,GAAI,MAAM,YAAY;GAEtB,SAAS,iBAAiB,OAAO,oBAAoB,kBAAkB,IAAI;EAC7E,CAAC,CACH;CACF,CAAC;CAED,IAAI,IAAI,aAAa,OAAO,MAAM;EAChC,iBAAiB,CAAC;EAClB,MAAM,SAAS,qBAAqB;EACpC,IAAI,CAAC,QACH,OAAO,EAAE,SAAS;EAEpB,EAAE,OAAO,iBAAiB,UAAU;EACpC,OAAO,EAAE,KAAK,kBAAkB,MAAM,iBAAiB,MAAM,CAAC,CAAC;CACjE,CAAC;CAED,IAAI,KAAK,gCAAgC,OAAO,MAAM;EACpD,iBAAiB,CAAC;EAClB,MAAM,EAAE,IAAI,WAAW,SAAS;EAChC,IAAI,CAAC,OAAO,gBAAgB;GAC1B,MAAM,GAAG,oCAAoC,SAAS;GACtD,OAAO,WAAW,GAAG,QAAQ;EAC/B;EACA,MAAM,SAAS,MAAM,qBAAqB,IAAI,MAAM;EACpD,MAAM,GAAG,iBAAiB,MAAM,GAAG,OAAO,SAAS,IAAI,YAAY,SAAS;EAC5E,OAAO,WAAW,GAAG,QAAQ;CAC/B,CAAC;AACH;AAEA,SAAS,iBAAiB,QAAyD;CACjF,MAAM,OAAO,gBAAgB,OAAO,YAAY;CAChD,OAAO,OAAO,SAAS,IAAI,GAAG,KAAK,IAAI,OAAO,OAAO,6BAA6B;AACpF;;AAGA,eAAe,aAA+B;CAC5C,MAAM,QAAQ,SAAS;CACvB,OAAO,MAAM,UAAU,SAAS,KAAM,MAAM,oBAAoB,KAAK;AACvE;;AAGA,eAAe,cAEb;CACA,OAAO;EACL,SAAS,MAAM,cAAc;EAC7B,cAAc,MAAM,iBAAiB;EACrC,qBAAqB,MAAM,WAAW;CACxC;AACF;;AAGA,eAAe,mBAA6D;CAC1E,MAAM,EAAE,cAAc,gBAAgB,SAAS;CAC/C,IAAI,iBAAiB,KAAA,GACnB;CAEF,OAAO;EACL,UAAU,MAAM,aAAa,QAAQ;EACrC,QAAQ,MAAM,aAAa,OAAO;EAElC,QAAQ;CACV;AACF"}

package/dist/routers/admin-public-origin.mjs

@@ -0,0 +1,92 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { getStore } from "../store.mjs";
+import { requireSiteAdmin } from "./helpers.mjs";
+import { hxRedirect } from "./htmx.mjs";
+import { flash } from "./flash.mjs";
+import { requestOpenBuildStatesNow } from "../git-status.mjs";
+import { normalizeOrigin } from "@storyshelf/core/utils";
+import { HTTPException } from "hono/http-exception";
+// src/routers/admin-public-origin.ts
+/**
+* The public origin, learnt from an admin's browser (ADR 0007, decision 6): the System page reports
+* `location.origin`, an admin confirms or replaces it, and background jobs read it from the database.
+* Site-admin and CSRF protected; with authentication off there is no admin, so nothing is learnt.
+*/
+/** Register the public-origin routes of the System page. */
+function registerPublicOriginRoutes(app) {
+	app.post("/admin/public-origin/report", handleReport);
+	app.post("/admin/public-origin", handleSet);
+	app.post("/admin/public-origin/clear", handleClear);
+}
+/** What an admin is told when the origin is not theirs to set. */
+const FIXED_ORIGIN_MESSAGE = "The public origin comes from PUBLIC_BASE_URL or the hosting platform, so there is nothing to confirm";
+/** Whether the configuration or the platform answers: an origin an admin cannot confirm or replace. */
+async function isFixed() {
+	const source = (await getStore().publicOrigin?.resolve())?.source;
+	return source === "config" || source === "platform";
+}
+/** The origin a report names, once it matches what the browser says it used; throws 400 otherwise. */
+async function reportedOrigin(c) {
+	const body = await c.req.json().catch(() => null);
+	const reported = typeof body?.origin === "string" ? normalizeOrigin(body.origin) : void 0;
+	if (reported === void 0 || c.req.header("origin") !== reported) throw new HTTPException(400, { message: "Origin does not match the request" });
+	return reported;
+}
+/** The page reports the origin it was loaded from; the first report is kept. */
+async function handleReport(c) {
+	requireSiteAdmin(c);
+	const { authEnabled, publicOrigin, user } = getStore();
+	if (!authEnabled || publicOrigin === void 0 || await isFixed()) return c.body(null, 204);
+	const reported = await reportedOrigin(c);
+	const before = await publicOrigin.stored();
+	const wasResolved = await publicOrigin.url() !== void 0;
+	const stored = await publicOrigin.report(reported, user?.id);
+	await resumeIfResolved(wasResolved);
+	return c.json(stored, before === null ? 201 : 200);
+}
+/**
+* Notifications were paused and an origin now resolves (an admin confirmed one; a mere report
+* resolves nothing): re-request the state of open builds.
+*/
+async function resumeIfResolved(wasResolved) {
+	if (!wasResolved && await getStore().publicOrigin?.url() !== void 0) requestOpenBuildStatesNow().catch(() => 0);
+}
+/** Store what an admin typed; the message says why not when it is no origin. */
+async function storeTyped(c) {
+	if (await isFixed()) return FIXED_ORIGIN_MESSAGE;
+	const { publicOrigin, user } = getStore();
+	const origin = (await c.req.formData()).get("origin");
+	try {
+		const wasResolved = await publicOrigin?.url() !== void 0;
+		await publicOrigin?.set(typeof origin === "string" ? origin : "", user?.id);
+		await resumeIfResolved(wasResolved);
+		return "Public origin saved";
+	} catch (error) {
+		return error instanceof Error ? error.message : "Invalid origin";
+	}
+}
+/** An admin confirmed the detected origin or entered another. */
+async function handleSet(c) {
+	requireSiteAdmin(c);
+	const { authEnabled, publicOrigin } = getStore();
+	if (!authEnabled || publicOrigin === void 0) {
+		flash(c, "The public origin is learnt from an admin's browser, which needs authentication", "warning");
+		return hxRedirect(c, "/admin");
+	}
+	const message = await storeTyped(c);
+	flash(c, message, message === "Public origin saved" ? "success" : "warning");
+	return hxRedirect(c, "/admin");
+}
+/** An admin dropped the stored origin; the next admin visit reports a fresh one. */
+async function handleClear(c) {
+	requireSiteAdmin(c);
+	const { publicOrigin } = getStore();
+	await publicOrigin?.clear();
+	flash(c, "Stored public origin removed");
+	return hxRedirect(c, "/admin");
+}
+export { registerPublicOriginRoutes };
+
+//# sourceMappingURL=admin-public-origin.mjs.map

package/dist/routers/admin-public-origin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-public-origin.mjs","names":[],"sources":["../../src/routers/admin-public-origin.ts"],"sourcesContent":["/**\n * The public origin, learnt from an admin's browser (ADR 0007, decision 6): the System page reports\n * `location.origin`, an admin confirms or replaces it, and background jobs read it from the database.\n * Site-admin and CSRF protected; with authentication off there is no admin, so nothing is learnt.\n */\nimport { normalizeOrigin } from \"@storyshelf/core/utils\";\nimport type { Context } from \"hono\";\nimport { HTTPException } from \"hono/http-exception\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { requestOpenBuildStatesNow } from \"../git-status.ts\";\nimport { getStore } from \"../store.ts\";\nimport { flash } from \"./flash.ts\";\nimport { requireSiteAdmin } from \"./helpers.ts\";\nimport { hxRedirect } from \"./htmx.ts\";\n\n/** Register the public-origin routes of the System page. */\nexport function registerPublicOriginRoutes(app: ShelfRouter): void {\n  app.post(\"/admin/public-origin/report\", handleReport);\n  app.post(\"/admin/public-origin\", handleSet);\n  app.post(\"/admin/public-origin/clear\", handleClear);\n}\n\n/** What an admin is told when the origin is not theirs to set. */\nconst FIXED_ORIGIN_MESSAGE =\n  \"The public origin comes from PUBLIC_BASE_URL or the hosting platform, so there is nothing to confirm\";\n\n/** Whether the configuration or the platform answers: an origin an admin cannot confirm or replace. */\nasync function isFixed(): Promise<boolean> {\n  const source = (await getStore().publicOrigin?.resolve())?.source;\n  return source === \"config\" || source === \"platform\";\n}\n\n/** The origin a report names, once it matches what the browser says it used; throws 400 otherwise. */\nasync function reportedOrigin(c: Context): Promise<string> {\n  const body = (await c.req.json().catch(() => null)) as { origin?: unknown } | null;\n  const reported = typeof body?.origin === \"string\" ? normalizeOrigin(body.origin) : undefined;\n  // The browser states the origin it used itself; a report that disagrees is not one.\n  if (reported === undefined || c.req.header(\"origin\") !== reported) {\n    throw new HTTPException(400, { message: \"Origin does not match the request\" });\n  }\n  return reported;\n}\n\n/** The page reports the origin it was loaded from; the first report is kept. */\nasync function handleReport(c: Context): Promise<Response> {\n  requireSiteAdmin(c);\n  const { authEnabled, publicOrigin, user } = getStore();\n  if (!authEnabled || publicOrigin === undefined || (await isFixed())) {\n    return c.body(null, 204);\n  }\n  const reported = await reportedOrigin(c);\n  const before = await publicOrigin.stored();\n  const wasResolved = (await publicOrigin.url()) !== undefined;\n  const stored = await publicOrigin.report(reported, user?.id);\n  await resumeIfResolved(wasResolved);\n  return c.json(stored, before === null ? 201 : 200);\n}\n\n/**\n * Notifications were paused and an origin now resolves (an admin confirmed one; a mere report\n * resolves nothing): re-request the state of open builds.\n */\nasync function resumeIfResolved(wasResolved: boolean): Promise<void> {\n  if (!wasResolved && (await getStore().publicOrigin?.url()) !== undefined) {\n    requestOpenBuildStatesNow().catch(() => 0);\n  }\n}\n\n/** Store what an admin typed; the message says why not when it is no origin. */\nasync function storeTyped(c: Context): Promise<string> {\n  if (await isFixed()) {\n    return FIXED_ORIGIN_MESSAGE;\n  }\n  const { publicOrigin, user } = getStore();\n  const origin = (await c.req.formData()).get(\"origin\");\n  try {\n    const wasResolved = (await publicOrigin?.url()) !== undefined;\n    await publicOrigin?.set(typeof origin === \"string\" ? origin : \"\", user?.id);\n    await resumeIfResolved(wasResolved);\n    return \"Public origin saved\";\n  } catch (error) {\n    return error instanceof Error ? error.message : \"Invalid origin\";\n  }\n}\n\n/** An admin confirmed the detected origin or entered another. */\nasync function handleSet(c: Context): Promise<Response> {\n  requireSiteAdmin(c);\n  const { authEnabled, publicOrigin } = getStore();\n  if (!authEnabled || publicOrigin === undefined) {\n    flash(\n      c,\n      \"The public origin is learnt from an admin's browser, which needs authentication\",\n      \"warning\",\n    );\n    return hxRedirect(c, \"/admin\");\n  }\n  const message = await storeTyped(c);\n  flash(c, message, message === \"Public origin saved\" ? \"success\" : \"warning\");\n  return hxRedirect(c, \"/admin\");\n}\n\n/** An admin dropped the stored origin; the next admin visit reports a fresh one. */\nasync function handleClear(c: Context): Promise<Response> {\n  requireSiteAdmin(c);\n  const { publicOrigin } = getStore();\n  await publicOrigin?.clear();\n  flash(c, \"Stored public origin removed\");\n  return hxRedirect(c, \"/admin\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,SAAgB,2BAA2B,KAAwB;CACjE,IAAI,KAAK,+BAA+B,YAAY;CACpD,IAAI,KAAK,wBAAwB,SAAS;CAC1C,IAAI,KAAK,8BAA8B,WAAW;AACpD;;AAGA,MAAM,uBACJ;;AAGF,eAAe,UAA4B;CACzC,MAAM,UAAU,MAAM,SAAS,CAAC,CAAC,cAAc,QAAQ,EAAA,EAAI;CAC3D,OAAO,WAAW,YAAY,WAAW;AAC3C;;AAGA,eAAe,eAAe,GAA6B;CACzD,MAAM,OAAQ,MAAM,EAAE,IAAI,KAAK,CAAC,CAAC,YAAY,IAAI;CACjD,MAAM,WAAW,OAAO,MAAM,WAAW,WAAW,gBAAgB,KAAK,MAAM,IAAI,KAAA;CAEnF,IAAI,aAAa,KAAA,KAAa,EAAE,IAAI,OAAO,QAAQ,MAAM,UACvD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,oCAAoC,CAAC;CAE/E,OAAO;AACT;;AAGA,eAAe,aAAa,GAA+B;CACzD,iBAAiB,CAAC;CAClB,MAAM,EAAE,aAAa,cAAc,SAAS,SAAS;CACrD,IAAI,CAAC,eAAe,iBAAiB,KAAA,KAAc,MAAM,QAAQ,GAC/D,OAAO,EAAE,KAAK,MAAM,GAAG;CAEzB,MAAM,WAAW,MAAM,eAAe,CAAC;CACvC,MAAM,SAAS,MAAM,aAAa,OAAO;CACzC,MAAM,cAAe,MAAM,aAAa,IAAI,MAAO,KAAA;CACnD,MAAM,SAAS,MAAM,aAAa,OAAO,UAAU,MAAM,EAAE;CAC3D,MAAM,iBAAiB,WAAW;CAClC,OAAO,EAAE,KAAK,QAAQ,WAAW,OAAO,MAAM,GAAG;AACnD;;;;;AAMA,eAAe,iBAAiB,aAAqC;CACnE,IAAI,CAAC,eAAgB,MAAM,SAAS,CAAC,CAAC,cAAc,IAAI,MAAO,KAAA,GAC7D,0BAA0B,CAAC,CAAC,YAAY,CAAC;AAE7C;;AAGA,eAAe,WAAW,GAA6B;CACrD,IAAI,MAAM,QAAQ,GAChB,OAAO;CAET,MAAM,EAAE,cAAc,SAAS,SAAS;CACxC,MAAM,UAAU,MAAM,EAAE,IAAI,SAAS,EAAA,CAAG,IAAI,QAAQ;CACpD,IAAI;EACF,MAAM,cAAe,MAAM,cAAc,IAAI,MAAO,KAAA;EACpD,MAAM,cAAc,IAAI,OAAO,WAAW,WAAW,SAAS,IAAI,MAAM,EAAE;EAC1E,MAAM,iBAAiB,WAAW;EAClC,OAAO;CACT,SAAS,OAAO;EACd,OAAO,iBAAiB,QAAQ,MAAM,UAAU;CAClD;AACF;;AAGA,eAAe,UAAU,GAA+B;CACtD,iBAAiB,CAAC;CAClB,MAAM,EAAE,aAAa,iBAAiB,SAAS;CAC/C,IAAI,CAAC,eAAe,iBAAiB,KAAA,GAAW;EAC9C,MACE,GACA,mFACA,SACF;EACA,OAAO,WAAW,GAAG,QAAQ;CAC/B;CACA,MAAM,UAAU,MAAM,WAAW,CAAC;CAClC,MAAM,GAAG,SAAS,YAAY,wBAAwB,YAAY,SAAS;CAC3E,OAAO,WAAW,GAAG,QAAQ;AAC/B;;AAGA,eAAe,YAAY,GAA+B;CACxD,iBAAiB,CAAC;CAClB,MAAM,EAAE,iBAAiB,SAAS;CAClC,MAAM,cAAc,MAAM;CAC1B,MAAM,GAAG,8BAA8B;CACvC,OAAO,WAAW,GAAG,QAAQ;AAC/B"}

package/dist/routers/admin.mjs

@@ -5,11 +5,11 @@ import { getStore } from "../store.mjs";
 import { notifySystem } from "../notify.mjs";
 import { reencryptWithCurrent } from "../credentials.mjs";
 import { requireSiteAdmin } from "./helpers.mjs";
-import { forbidden, purgeInputSchema, purgeSchema } from "./schemas.mjs";
+import { errorSchema, forbidden, purgeInputSchema, purgeSchema } from "./schemas.mjs";
 import { createRoute, z } from "@hono/zod-openapi";
 import { ProjectModel } from "@storyshelf/core/models";
 import { Retention } from "@storyshelf/core/retention";
-//#region src/routers/admin.ts
+// src/routers/admin.ts
 const purgeRoute = createRoute({
 	method: "post",
 	tags: ["Admin"],
@@ -21,6 +21,10 @@ const purgeRoute = createRoute({
 			content: { "application/json": { schema: purgeSchema } },
 			description: "Retention purge run"
 		},
+		503: {
+			content: { "application/json": { schema: errorSchema } },
+			description: "Testing retention requires atomic build lifecycle support"
+		},
 		...forbidden
 	}
 });
@@ -61,6 +65,7 @@ function registerAdmin(app) {
 	});
 	app.openapi(purgeRoute, async (c) => {
 		requireSiteAdmin(c);
+		if (getStore().testing) return c.json({ message: "Build purge is unavailable for testing deployments until the database adapter supports safe baseline retention. Builds are retained; contact your administrator." }, 503);
 		const ttlDays = c.req.valid("json").ttlDays ?? getStore().config.purgeTtlDays ?? 30;
 		const removedBuilds = await purgeBuilds(ttlDays);
 		const branch = await purgeBranches();
@@ -74,7 +79,7 @@ function registerAdmin(app) {
 			removedBuilds,
 			removedBranches: branch.removedBranches,
 			removedBaselines: branch.removedBaselines
-		});
+		}, 200);
 	});
 }
 async function purgeBuilds(ttlDays) {
@@ -107,7 +112,6 @@ async function purgeBranches() {
 		removedBaselines: results.reduce((sum, r) => sum + r.removedBaselines, 0)
 	};
 }
-//#endregion
 export { registerAdmin };
 
 //# sourceMappingURL=admin.mjs.map

package/dist/routers/admin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"admin.mjs","names":["forbiddenResponse"],"sources":["../../src/routers/admin.ts"],"sourcesContent":["/* oxlint-disable typescript/promise-function-async -- admin helpers are async by design */\nimport { createRoute, z } from \"@hono/zod-openapi\";\nimport { ProjectModel } from \"@storyshelf/core/models\";\nimport { Retention } from \"@storyshelf/core/retention\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { reencryptWithCurrent } from \"../credentials.ts\";\nimport { notifySystem } from \"../notify.ts\";\nimport { getStore } from \"../store.ts\";\nimport { requireSiteAdmin } from \"./helpers.ts\";\nimport { forbidden as forbiddenResponse, purgeInputSchema, purgeSchema } from \"./schemas.ts\";\nconst purgeRoute = createRoute({\n  method: \"post\",\n  tags: [\"Admin\"],\n  summary: \"Run the retention purge\",\n  path: \"/api/v1/admin/purge\",\n  request: { body: { content: { \"application/json\": { schema: purgeInputSchema } } } },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: purgeSchema } },\n      description: \"Retention purge run\",\n    },\n    ...forbiddenResponse,\n  },\n});\n\nconst reencryptSchema = z.object({\n  reencrypted: z.number().int(),\n  failed: z.number().int(),\n  unreadable: z.number().int(),\n});\n\nconst reencryptRoute = createRoute({\n  method: \"post\",\n  path: \"/api/v1/admin/credentials/reencrypt\",\n  tags: [\"Admin\"],\n  summary: \"Re-encrypt stored credentials with the current secret\",\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: reencryptSchema } },\n      description: \"Credentials re-encrypted with the current secret\",\n    },\n    409: {\n      content: { \"application/json\": { schema: z.object({ error: z.string() }) } },\n      description: \"No previousSecret configured\",\n    },\n    ...forbiddenResponse,\n  },\n});\n\n/** Register the site-admin endpoints: retention purge and credential re-encryption. */\nexport function registerAdmin(app: ShelfRouter): void {\n  app.openapi(reencryptRoute, async (c) => {\n    requireSiteAdmin(c);\n    const { db, config } = getStore();\n    if (!config.previousSecret) {\n      return c.json({ error: \"No previousSecret is configured; nothing to re-encrypt\" }, 409);\n    }\n    const result = await reencryptWithCurrent(db, config);\n    return c.json(\n      {\n        reencrypted: result.reencrypted,\n        failed: result.failed,\n        unreadable: result.unreadable.length,\n      },\n      200,\n    );\n  });\n\n  app.openapi(purgeRoute, async (c) => {\n    requireSiteAdmin(c);\n    const body = c.req.valid(\"json\");\n    const ttlDays = body.ttlDays ?? getStore().config.purgeTtlDays ?? 30;\n    const removedBuilds = await purgeBuilds(ttlDays);\n    const branch = await purgeBranches();\n    await notifySystem(\"sys:purge-completed\", {\n      removedBuilds,\n      removedBranches: branch.removedBranches,\n      removedBaselines: branch.removedBaselines,\n      ttlDays,\n    });\n    return c.json({\n      removedBuilds,\n      removedBranches: branch.removedBranches,\n      removedBaselines: branch.removedBaselines,\n    });\n  });\n}\n\n// oxlint-disable-next-line typescript/promise-function-async\nasync function purgeBuilds(ttlDays: number): Promise<number> {\n  const projects = await new ProjectModel(getStore().db).list();\n  const retention = new Retention(\n    getStore().db,\n    getStore().storage,\n    {\n      builds: getStore().db.tables.builds,\n      buildLabels: getStore().db.tables.buildLabels,\n      baselines: getStore().db.tables.baselines,\n    },\n    getStore().logger,\n  );\n  const results = await Promise.all(\n    projects.map((project) => retention.purge(project, { ttlDays, keepLatestPerBranch: true })),\n  );\n  return results.reduce((sum, result) => sum + result.removedBuilds, 0);\n}\n\n// oxlint-disable-next-line typescript/promise-function-async\nasync function purgeBranches(): Promise<{ removedBranches: number; removedBaselines: number }> {\n  const branchTtl = getStore().config.branchTtlDays ?? 30;\n  if (branchTtl === null) {\n    return { removedBranches: 0, removedBaselines: 0 };\n  }\n  const projects = await new ProjectModel(getStore().db).list();\n  const retention = new Retention(\n    getStore().db,\n    getStore().storage,\n    {\n      builds: getStore().db.tables.builds,\n      buildLabels: getStore().db.tables.buildLabels,\n      baselines: getStore().db.tables.baselines,\n    },\n    getStore().logger,\n  );\n  const results = await Promise.all(\n    projects.map((project) => retention.purgeStaleBranches(project, branchTtl)),\n  );\n  const removedBranches = results.reduce(\n    (sum: number, r: { removedBranches: number }) => sum + r.removedBranches,\n    0,\n  );\n  const removedBaselines = results.reduce(\n    (sum: number, r: { removedBaselines: number }) => sum + r.removedBaselines,\n    0,\n  );\n  return { removedBranches, removedBaselines };\n}\n"],"mappings":"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"}
+{"version":3,"file":"admin.mjs","names":["forbiddenResponse"],"sources":["../../src/routers/admin.ts"],"sourcesContent":["/* oxlint-disable typescript/promise-function-async -- admin helpers are async by design */\nimport { createRoute, z } from \"@hono/zod-openapi\";\nimport { ProjectModel } from \"@storyshelf/core/models\";\nimport { Retention } from \"@storyshelf/core/retention\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { reencryptWithCurrent } from \"../credentials.ts\";\nimport { notifySystem } from \"../notify.ts\";\nimport { getStore } from \"../store.ts\";\nimport { requireSiteAdmin } from \"./helpers.ts\";\nimport {\n  errorSchema,\n  forbidden as forbiddenResponse,\n  purgeInputSchema,\n  purgeSchema,\n} from \"./schemas.ts\";\nconst purgeRoute = createRoute({\n  method: \"post\",\n  tags: [\"Admin\"],\n  summary: \"Run the retention purge\",\n  path: \"/api/v1/admin/purge\",\n  request: { body: { content: { \"application/json\": { schema: purgeInputSchema } } } },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: purgeSchema } },\n      description: \"Retention purge run\",\n    },\n    503: {\n      content: { \"application/json\": { schema: errorSchema } },\n      description: \"Testing retention requires atomic build lifecycle support\",\n    },\n    ...forbiddenResponse,\n  },\n});\n\nconst reencryptSchema = z.object({\n  reencrypted: z.number().int(),\n  failed: z.number().int(),\n  unreadable: z.number().int(),\n});\n\nconst reencryptRoute = createRoute({\n  method: \"post\",\n  path: \"/api/v1/admin/credentials/reencrypt\",\n  tags: [\"Admin\"],\n  summary: \"Re-encrypt stored credentials with the current secret\",\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: reencryptSchema } },\n      description: \"Credentials re-encrypted with the current secret\",\n    },\n    409: {\n      content: { \"application/json\": { schema: z.object({ error: z.string() }) } },\n      description: \"No previousSecret configured\",\n    },\n    ...forbiddenResponse,\n  },\n});\n\n/** Register the site-admin endpoints: retention purge and credential re-encryption. */\nexport function registerAdmin(app: ShelfRouter): void {\n  app.openapi(reencryptRoute, async (c) => {\n    requireSiteAdmin(c);\n    const { db, config } = getStore();\n    if (!config.previousSecret) {\n      return c.json({ error: \"No previousSecret is configured; nothing to re-encrypt\" }, 409);\n    }\n    const result = await reencryptWithCurrent(db, config);\n    return c.json(\n      {\n        reencrypted: result.reencrypted,\n        failed: result.failed,\n        unreadable: result.unreadable.length,\n      },\n      200,\n    );\n  });\n\n  app.openapi(purgeRoute, async (c) => {\n    requireSiteAdmin(c);\n    // Until the database provides atomic reference admission and tombstones, deletion in a\n    // testing deployment can race a baseline promotion. Do not expose unsafe purge.\n    if (getStore().testing) {\n      return c.json(\n        {\n          message:\n            \"Build purge is unavailable for testing deployments until the database adapter supports safe baseline retention. Builds are retained; contact your administrator.\",\n        },\n        503,\n      );\n    }\n    const body = c.req.valid(\"json\");\n    const ttlDays = body.ttlDays ?? getStore().config.purgeTtlDays ?? 30;\n    const removedBuilds = await purgeBuilds(ttlDays);\n    const branch = await purgeBranches();\n    await notifySystem(\"sys:purge-completed\", {\n      removedBuilds,\n      removedBranches: branch.removedBranches,\n      removedBaselines: branch.removedBaselines,\n      ttlDays,\n    });\n    return c.json(\n      {\n        removedBuilds,\n        removedBranches: branch.removedBranches,\n        removedBaselines: branch.removedBaselines,\n      },\n      200,\n    );\n  });\n}\n\n// oxlint-disable-next-line typescript/promise-function-async\nasync function purgeBuilds(ttlDays: number): Promise<number> {\n  const projects = await new ProjectModel(getStore().db).list();\n  const retention = new Retention(\n    getStore().db,\n    getStore().storage,\n    {\n      builds: getStore().db.tables.builds,\n      buildLabels: getStore().db.tables.buildLabels,\n      baselines: getStore().db.tables.baselines,\n    },\n    getStore().logger,\n  );\n  const results = await Promise.all(\n    projects.map((project) => retention.purge(project, { ttlDays, keepLatestPerBranch: true })),\n  );\n  return results.reduce((sum, result) => sum + result.removedBuilds, 0);\n}\n\n// oxlint-disable-next-line typescript/promise-function-async\nasync function purgeBranches(): Promise<{ removedBranches: number; removedBaselines: number }> {\n  const branchTtl = getStore().config.branchTtlDays ?? 30;\n  if (branchTtl === null) {\n    return { removedBranches: 0, removedBaselines: 0 };\n  }\n  const projects = await new ProjectModel(getStore().db).list();\n  const retention = new Retention(\n    getStore().db,\n    getStore().storage,\n    {\n      builds: getStore().db.tables.builds,\n      buildLabels: getStore().db.tables.buildLabels,\n      baselines: getStore().db.tables.baselines,\n    },\n    getStore().logger,\n  );\n  const results = await Promise.all(\n    projects.map((project) => retention.purgeStaleBranches(project, branchTtl)),\n  );\n  const removedBranches = results.reduce(\n    (sum: number, r: { removedBranches: number }) => sum + r.removedBranches,\n    0,\n  );\n  const removedBaselines = results.reduce(\n    (sum: number, r: { removedBaselines: number }) => sum + r.removedBaselines,\n    0,\n  );\n  return { removedBranches, removedBaselines };\n}\n"],"mappings":"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"}

package/dist/routers/assets.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { assetManifest } from "../asset-manifest.mjs";
-//#region src/routers/assets.ts
+// src/routers/assets.ts
 const IMMUTABLE = "public, max-age=31536000, immutable";
 /**
 * Serve a content-addressed asset. A matching hash is cacheable forever and
@@ -26,9 +26,9 @@ function serveHashed(c, asset, requestedHash) {
 		etag
 	});
 }
-/** Register the static-asset routes (HTMX bundle and icon sprite). */
+/** Register the static-asset routes (HTMX bundle, shell script, icon sprite and mark). */
 function registerAssets(app) {
-	const { htmx, icons, mark } = assetManifest;
+	const { client, htmx, icons, mark } = assetManifest;
 	app.get(String.raw`/assets/:file{htmx-[a-f0-9]+\.js}`, (c) => {
 		const hash = (c.req.param("file") ?? "").replaceAll(/^htmx-|\.js$/gu, "");
 		return serveHashed(c, {
@@ -36,6 +36,13 @@ function registerAssets(app) {
 			contentType: "application/javascript"
 		}, hash);
 	});
+	app.get(String.raw`/assets/:file{client-[a-f0-9]+\.js}`, (c) => {
+		const hash = (c.req.param("file") ?? "").replaceAll(/^client-|\.js$/gu, "");
+		return serveHashed(c, {
+			...client,
+			contentType: "application/javascript"
+		}, hash);
+	});
 	app.get(String.raw`/assets/:file{icons-[a-f0-9]+\.svg}`, (c) => {
 		const hash = (c.req.param("file") ?? "").replaceAll(/^icons-|\.svg$/gu, "");
 		return serveHashed(c, {
@@ -58,7 +65,6 @@ function registerAssets(app) {
 		});
 	});
 }
-//#endregion
 export { registerAssets };
 
 //# sourceMappingURL=assets.mjs.map

package/dist/routers/assets.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"assets.mjs","names":[],"sources":["../../src/routers/assets.ts"],"sourcesContent":["import type { Context } from \"hono\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { assetManifest } from \"../asset-manifest.ts\";\n\nconst IMMUTABLE = \"public, max-age=31536000, immutable\";\n\ninterface Asset {\n  source: string;\n  hash: string;\n  contentType: string;\n}\n\n/**\n * Serve a content-addressed asset. A matching hash is cacheable forever and\n * answers conditional requests with 304; a stale hash (an old page still\n * open after an upgrade) gets the current content but is never cached under\n * the old URL.\n */\nfunction serveHashed(c: Context, asset: Asset, requestedHash: string): Response {\n  const etag = `\"${asset.hash}\"`;\n  if (requestedHash !== asset.hash) {\n    return c.body(asset.source, 200, {\n      \"content-type\": asset.contentType,\n      \"cache-control\": \"no-store\",\n    });\n  }\n  if (c.req.header(\"if-none-match\") === etag) {\n    return c.body(null, 304, { etag, \"cache-control\": IMMUTABLE });\n  }\n  return c.body(asset.source, 200, {\n    \"content-type\": asset.contentType,\n    \"cache-control\": IMMUTABLE,\n    etag,\n  });\n}\n\n/** Register the static-asset routes (HTMX bundle and icon sprite). */\nexport function registerAssets(app: ShelfRouter): void {\n  const { htmx, icons, mark } = assetManifest;\n  app.get(String.raw`/assets/:file{htmx-[a-f0-9]+\\.js}`, (c) => {\n    const hash = (c.req.param(\"file\") ?? \"\").replaceAll(/^htmx-|\\.js$/gu, \"\");\n    return serveHashed(c, { ...htmx, contentType: \"application/javascript\" }, hash);\n  });\n  app.get(String.raw`/assets/:file{icons-[a-f0-9]+\\.svg}`, (c) => {\n    const hash = (c.req.param(\"file\") ?? \"\").replaceAll(/^icons-|\\.svg$/gu, \"\");\n    return serveHashed(c, { ...icons, contentType: \"image/svg+xml\" }, hash);\n  });\n  app.get(String.raw`/assets/:file{mark-[a-f0-9]+\\.svg}`, (c) => {\n    const hash = (c.req.param(\"file\") ?? \"\").replaceAll(/^mark-|\\.svg$/gu, \"\");\n    return serveHashed(c, { ...mark, contentType: \"image/svg+xml\" }, hash);\n  });\n  // Legacy unversioned URL: kept for old pages and external embeds, but\n  // revalidated (never immutable) because its content can change.\n  app.get(\"/assets/htmx.js\", (c) => {\n    return c.body(htmx.source, 200, {\n      \"content-type\": \"application/javascript\",\n      \"cache-control\": \"no-cache\",\n      etag: `\"${htmx.hash}\"`,\n    });\n  });\n}\n"],"mappings":";;;;;AAIA,MAAM,YAAY;;;;;;;AAclB,SAAS,YAAY,GAAY,OAAc,eAAiC;CAC9E,MAAM,OAAO,IAAI,MAAM,KAAK;CAC5B,IAAI,kBAAkB,MAAM,MAC1B,OAAO,EAAE,KAAK,MAAM,QAAQ,KAAK;EAC/B,gBAAgB,MAAM;EACtB,iBAAiB;CACnB,CAAC;CAEH,IAAI,EAAE,IAAI,OAAO,eAAe,MAAM,MACpC,OAAO,EAAE,KAAK,MAAM,KAAK;EAAE;EAAM,iBAAiB;CAAU,CAAC;CAE/D,OAAO,EAAE,KAAK,MAAM,QAAQ,KAAK;EAC/B,gBAAgB,MAAM;EACtB,iBAAiB;EACjB;CACF,CAAC;AACH;;AAGA,SAAgB,eAAe,KAAwB;CACrD,MAAM,EAAE,MAAM,OAAO,SAAS;CAC9B,IAAI,IAAI,OAAO,GAAG,sCAAsC,MAAM;EAC5D,MAAM,QAAQ,EAAE,IAAI,MAAM,MAAM,KAAK,GAAA,CAAI,WAAW,kBAAkB,EAAE;EACxE,OAAO,YAAY,GAAG;GAAE,GAAG;GAAM,aAAa;EAAyB,GAAG,IAAI;CAChF,CAAC;CACD,IAAI,IAAI,OAAO,GAAG,wCAAwC,MAAM;EAC9D,MAAM,QAAQ,EAAE,IAAI,MAAM,MAAM,KAAK,GAAA,CAAI,WAAW,oBAAoB,EAAE;EAC1E,OAAO,YAAY,GAAG;GAAE,GAAG;GAAO,aAAa;EAAgB,GAAG,IAAI;CACxE,CAAC;CACD,IAAI,IAAI,OAAO,GAAG,uCAAuC,MAAM;EAC7D,MAAM,QAAQ,EAAE,IAAI,MAAM,MAAM,KAAK,GAAA,CAAI,WAAW,mBAAmB,EAAE;EACzE,OAAO,YAAY,GAAG;GAAE,GAAG;GAAM,aAAa;EAAgB,GAAG,IAAI;CACvE,CAAC;CAGD,IAAI,IAAI,oBAAoB,MAAM;EAChC,OAAO,EAAE,KAAK,KAAK,QAAQ,KAAK;GAC9B,gBAAgB;GAChB,iBAAiB;GACjB,MAAM,IAAI,KAAK,KAAK;EACtB,CAAC;CACH,CAAC;AACH"}
+{"version":3,"file":"assets.mjs","names":[],"sources":["../../src/routers/assets.ts"],"sourcesContent":["import type { Context } from \"hono\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { assetManifest } from \"../asset-manifest.ts\";\n\nconst IMMUTABLE = \"public, max-age=31536000, immutable\";\n\ninterface Asset {\n  source: string;\n  hash: string;\n  contentType: string;\n}\n\n/**\n * Serve a content-addressed asset. A matching hash is cacheable forever and\n * answers conditional requests with 304; a stale hash (an old page still\n * open after an upgrade) gets the current content but is never cached under\n * the old URL.\n */\nfunction serveHashed(c: Context, asset: Asset, requestedHash: string): Response {\n  const etag = `\"${asset.hash}\"`;\n  if (requestedHash !== asset.hash) {\n    return c.body(asset.source, 200, {\n      \"content-type\": asset.contentType,\n      \"cache-control\": \"no-store\",\n    });\n  }\n  if (c.req.header(\"if-none-match\") === etag) {\n    return c.body(null, 304, { etag, \"cache-control\": IMMUTABLE });\n  }\n  return c.body(asset.source, 200, {\n    \"content-type\": asset.contentType,\n    \"cache-control\": IMMUTABLE,\n    etag,\n  });\n}\n\n/** Register the static-asset routes (HTMX bundle, shell script, icon sprite and mark). */\nexport function registerAssets(app: ShelfRouter): void {\n  const { client, htmx, icons, mark } = assetManifest;\n  app.get(String.raw`/assets/:file{htmx-[a-f0-9]+\\.js}`, (c) => {\n    const hash = (c.req.param(\"file\") ?? \"\").replaceAll(/^htmx-|\\.js$/gu, \"\");\n    return serveHashed(c, { ...htmx, contentType: \"application/javascript\" }, hash);\n  });\n  app.get(String.raw`/assets/:file{client-[a-f0-9]+\\.js}`, (c) => {\n    const hash = (c.req.param(\"file\") ?? \"\").replaceAll(/^client-|\\.js$/gu, \"\");\n    return serveHashed(c, { ...client, contentType: \"application/javascript\" }, hash);\n  });\n  app.get(String.raw`/assets/:file{icons-[a-f0-9]+\\.svg}`, (c) => {\n    const hash = (c.req.param(\"file\") ?? \"\").replaceAll(/^icons-|\\.svg$/gu, \"\");\n    return serveHashed(c, { ...icons, contentType: \"image/svg+xml\" }, hash);\n  });\n  app.get(String.raw`/assets/:file{mark-[a-f0-9]+\\.svg}`, (c) => {\n    const hash = (c.req.param(\"file\") ?? \"\").replaceAll(/^mark-|\\.svg$/gu, \"\");\n    return serveHashed(c, { ...mark, contentType: \"image/svg+xml\" }, hash);\n  });\n  // Legacy unversioned URL: kept for old pages and external embeds, but\n  // revalidated (never immutable) because its content can change.\n  app.get(\"/assets/htmx.js\", (c) => {\n    return c.body(htmx.source, 200, {\n      \"content-type\": \"application/javascript\",\n      \"cache-control\": \"no-cache\",\n      etag: `\"${htmx.hash}\"`,\n    });\n  });\n}\n"],"mappings":";;;;;AAIA,MAAM,YAAY;;;;;;;AAclB,SAAS,YAAY,GAAY,OAAc,eAAiC;CAC9E,MAAM,OAAO,IAAI,MAAM,KAAK;CAC5B,IAAI,kBAAkB,MAAM,MAC1B,OAAO,EAAE,KAAK,MAAM,QAAQ,KAAK;EAC/B,gBAAgB,MAAM;EACtB,iBAAiB;CACnB,CAAC;CAEH,IAAI,EAAE,IAAI,OAAO,eAAe,MAAM,MACpC,OAAO,EAAE,KAAK,MAAM,KAAK;EAAE;EAAM,iBAAiB;CAAU,CAAC;CAE/D,OAAO,EAAE,KAAK,MAAM,QAAQ,KAAK;EAC/B,gBAAgB,MAAM;EACtB,iBAAiB;EACjB;CACF,CAAC;AACH;;AAGA,SAAgB,eAAe,KAAwB;CACrD,MAAM,EAAE,QAAQ,MAAM,OAAO,SAAS;CACtC,IAAI,IAAI,OAAO,GAAG,sCAAsC,MAAM;EAC5D,MAAM,QAAQ,EAAE,IAAI,MAAM,MAAM,KAAK,GAAA,CAAI,WAAW,kBAAkB,EAAE;EACxE,OAAO,YAAY,GAAG;GAAE,GAAG;GAAM,aAAa;EAAyB,GAAG,IAAI;CAChF,CAAC;CACD,IAAI,IAAI,OAAO,GAAG,wCAAwC,MAAM;EAC9D,MAAM,QAAQ,EAAE,IAAI,MAAM,MAAM,KAAK,GAAA,CAAI,WAAW,oBAAoB,EAAE;EAC1E,OAAO,YAAY,GAAG;GAAE,GAAG;GAAQ,aAAa;EAAyB,GAAG,IAAI;CAClF,CAAC;CACD,IAAI,IAAI,OAAO,GAAG,wCAAwC,MAAM;EAC9D,MAAM,QAAQ,EAAE,IAAI,MAAM,MAAM,KAAK,GAAA,CAAI,WAAW,oBAAoB,EAAE;EAC1E,OAAO,YAAY,GAAG;GAAE,GAAG;GAAO,aAAa;EAAgB,GAAG,IAAI;CACxE,CAAC;CACD,IAAI,IAAI,OAAO,GAAG,uCAAuC,MAAM;EAC7D,MAAM,QAAQ,EAAE,IAAI,MAAM,MAAM,KAAK,GAAA,CAAI,WAAW,mBAAmB,EAAE;EACzE,OAAO,YAAY,GAAG;GAAE,GAAG;GAAM,aAAa;EAAgB,GAAG,IAAI;CACvE,CAAC;CAGD,IAAI,IAAI,oBAAoB,MAAM;EAChC,OAAO,EAAE,KAAK,KAAK,QAAQ,KAAK;GAC9B,gBAAgB;GAChB,iBAAiB;GACjB,MAAM,IAAI,KAAK,KAAK;EACtB,CAAC;CACH,CAAC;AACH"}

package/dist/routers/attempts.mjs

@@ -7,7 +7,7 @@ import { attemptLogSchema, attemptSchema, notFound as notFound$1, unauthorized }
 import { VIEW_ROLES, buildForProject } from "./builds.handlers.mjs";
 import { createRoute, z } from "@hono/zod-openapi";
 import { CaptureAttemptModel, CaptureLogModel } from "@storyshelf/core/models";
-//#region src/routers/attempts.ts
+// src/routers/attempts.ts
 /** Register the capture-attempt history and per-attempt log endpoints. */
 function registerAttempts(app) {
 	app.openapi(listAttemptsRoute, async (c) => {
@@ -90,7 +90,6 @@ async function attemptForBuild(build, attemptNo) {
 	if (!attempt) notFound("Attempt not found");
 	return attempt;
 }
-//#endregion
 export { registerAttempts };
 
 //# sourceMappingURL=attempts.mjs.map

package/dist/routers/auth-sync.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { MemberModel, ProjectGroupMappingModel, ProjectModel, UserModel } from "@storyshelf/core/models";
-//#region src/routers/auth-sync.ts
+// src/routers/auth-sync.ts
 const ROLE_RANK = {
 	viewer: 0,
 	developer: 1,
@@ -58,7 +58,6 @@ async function syncProjectMembership(members, mappings, projectId, userId, group
 	const existing = await members.get(projectId, userId);
 	if (!existing || existing.role !== top.role || existing.source !== `oidc:${top.groupName}`) await members.set(projectId, userId, top.role, `oidc:${top.groupName}`);
 }
-//#endregion
 export { syncLoginMemberships };
 
 //# sourceMappingURL=auth-sync.mjs.map

package/dist/routers/auth.mjs

@@ -8,10 +8,10 @@ import { renderInviteInvalidPage, renderInvitePage } from "../pages/invite.mjs";
 import { renderLoginPage } from "../pages/login.mjs";
 import { syncLoginMemberships } from "./auth-sync.mjs";
 import { UserModel } from "@storyshelf/core/models";
-import { SESSION_COOKIE } from "@storyshelf/core/types";
 import { HTTPException } from "hono/http-exception";
+import { SESSION_COOKIE } from "@storyshelf/core/types";
 import { MIN_PASSWORD_LENGTH } from "@storyshelf/core/auth";
-//#region src/routers/auth.ts
+// src/routers/auth.ts
 /** Provider ids are URL path segments: strict charset, bounded length. */
 function validProviderId(value) {
 	return /^[a-zA-Z0-9_-]{1,64}$/u.test(value);
@@ -232,7 +232,6 @@ function registerEngineAuth(app, engine) {
 		return hxRedirect(c, "/auth/login");
 	});
 }
-//#endregion
 export { forwardToEngine, registerEngineAuth };
 
 //# sourceMappingURL=auth.mjs.map

package/dist/routers/baseline-guard.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { getStore } from "../store.mjs";
 import { BaselineModel, baselineStatus, isBaselineDrifted } from "@storyshelf/core/models";
 import { HTTPException } from "hono/http-exception";
-//#region src/routers/baseline-guard.ts
+// src/routers/baseline-guard.ts
 /** Refuse to promote a screenshot over a baseline the reviewer has not seen. */
 /** Whether a snapshot is awaiting a review decision. */
 function isOpenSnapshot(snapshot) {
@@ -12,7 +12,7 @@ function isOpenSnapshot(snapshot) {
 }
 /** Compare a snapshot's recorded baseline with the baseline that applies to it now. */
 async function snapshotBaselineStatus(project, build, snapshot) {
-	const current = await new BaselineModel(getStore().db).resolve(project.id, snapshot.storyId, snapshot.viewportName, build.gitBranch, project.gitDefaultBranch);
+	const current = await new BaselineModel(getStore().db).resolve(project.id, snapshot.storyId, snapshot.viewportName, build.gitBranch, project.gitDefaultBranch, snapshot.browser);
 	return baselineStatus(snapshot, current);
 }
 /** Open snapshots whose diff no longer matches the current baseline. */
@@ -63,7 +63,7 @@ async function loadBaselineView(project, build, snapshots) {
 	const entries = await Promise.all(snapshots.map(async (snapshot) => {
 		return {
 			snapshot,
-			current: await baselines.resolve(project.id, snapshot.storyId, snapshot.viewportName, build.gitBranch, project.gitDefaultBranch)
+			current: await baselines.resolve(project.id, snapshot.storyId, snapshot.viewportName, build.gitBranch, project.gitDefaultBranch, snapshot.browser)
 		};
 	}));
 	const view = {
@@ -71,13 +71,12 @@ async function loadBaselineView(project, build, snapshots) {
 		drifted: {}
 	};
 	for (const { snapshot, current } of entries) {
-		view.hasBaseline[snapshot.id] = Boolean(current);
+		view.hasBaseline[snapshot.id] = Boolean(snapshot.comparisonImagePath ?? current);
 		const status = baselineStatus(snapshot, current);
 		if (!build.isDefault && isOpenSnapshot(snapshot) && (status === "stale" || status === "removed")) view.drifted[snapshot.id] = status;
 	}
 	return view;
 }
-//#endregion
 export { assertBaselineCurrent, baselineChanged, findDriftedSnapshots, isBaselineChanged, isOpenSnapshot, loadBaselineView, snapshotBaselineStatus };
 
 //# sourceMappingURL=baseline-guard.mjs.map