@storyshelf/app 0.6.2 → 0.7.0

package/dist/notify.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"notify.mjs","names":[],"sources":["../src/notify.ts"],"sourcesContent":["/**\n * Notification fan-out for routers: loads stored channels and subscriber\n * emails, then delegates to the wired notifier providers. Best-effort and\n * non-fatal — failures are logged inside the emitters, never thrown here.\n */\nimport type { DatabaseAdapter } from \"@storyshelf/core/adapter/database\";\nimport type { NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport {\n  emitNotifications,\n  emitSystemNotification,\n  type NotificationBrand,\n  type NotificationChannel,\n  type SystemEventName,\n} from \"@storyshelf/core/adapter/notifier\";\nimport type { ShelfConfig, UIConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport {\n  NotificationChannelModel,\n  NotificationSubscriptionModel,\n  UserModel,\n} from \"@storyshelf/core/models\";\nimport type { NotificationSubscriptionRow } from \"@storyshelf/core/schema\";\nimport type { NotificationChannelRow } from \"@storyshelf/core/schema\";\nimport type { Project } from \"@storyshelf/core/schema\";\nimport { credentialKeys } from \"./credential-keys.ts\";\nimport { getStore } from \"./store.ts\";\n\n/** Explicit dependencies for background fan-out (no request scope). */\nexport interface NotifyDeps {\n  db: DatabaseAdapter;\n  config: ShelfConfig;\n  ui: UIConfig;\n  logger: Logger;\n  notifiers: NotifierProvider[];\n}\n\n/** Review URL for a project page (absolute when `publicBaseUrl` is set). */\nexport function reviewUrlFor(slug: string, suffix: string): string | undefined {\n  return reviewUrlForWith(getStore().config.publicBaseUrl, slug, suffix);\n}\n\n/** Review URL from an explicit base URL (background use). */\nfunction reviewUrlForWith(\n  publicBaseUrl: string | undefined,\n  slug: string,\n  suffix: string,\n): string | undefined {\n  const base = publicBaseUrl?.replace(/\\/+$/u, \"\");\n  if (!base) {\n    return undefined;\n  }\n  return `${base}/projects/${slug}${suffix}`;\n}\n\n/** Brand inputs from UI config plus server notification defaults. */\nfunction brandFor(ui: UIConfig, config: ShelfConfig, reviewUrl?: string): NotificationBrand {\n  return {\n    name: ui.name,\n    logo: ui.logo,\n    reviewUrl,\n    fromEmail: config.notifications?.fromEmail,\n    fromName: config.notifications?.fromName ?? ui.name,\n    footerText: config.notifications?.footerText,\n  };\n}\n\n/** Convert a stored row to a send-ready view (null when undecryptable). */\nfunction toView(\n  row: NotificationChannelRow,\n  model: NotificationChannelModel,\n): NotificationChannel | null {\n  let secret: string | undefined;\n  try {\n    secret = row.secretEncrypted ? model.decryptSecret(row) : undefined;\n  } catch {\n    return null;\n  }\n  return {\n    id: row.id,\n    projectId: row.projectId,\n    provider: row.provider,\n    config: NotificationChannelModel.configOf(row),\n    secret,\n    events: NotificationChannelModel.eventsOf(row),\n    enabled: row.enabled,\n  };\n}\n\n/** Load stored channels as send-ready views (skips undecryptable secrets). */\nasync function loadChannels(\n  deps: Pick<NotifyDeps, \"db\" | \"config\">,\n  projectId: string | null,\n): Promise<NotificationChannel[]> {\n  const model = new NotificationChannelModel(deps.db, undefined, credentialKeys(deps.config));\n  const rows = projectId === null ? await model.listSystem() : await model.list(projectId);\n  return rows.filter((row) => row.enabled).flatMap((row) => toView(row, model) ?? []);\n}\n\n/** Subscriptions matching an event (enabled + allowlist). */\nfunction matchingSubs(\n  rows: NotificationSubscriptionRow[],\n  event: string,\n): NotificationSubscriptionRow[] {\n  return rows.filter((row) => {\n    if (!row.enabled) {\n      return false;\n    }\n    const events = NotificationSubscriptionModel.eventsOf(row);\n    return events.length === 0 || events.includes(event);\n  });\n}\n\n/** Per-subscriber targets for one subscription (wired kinds only). */\nasync function targetsForSub(\n  db: DatabaseAdapter,\n  sub: NotificationSubscriptionRow,\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  const user = await new UserModel(db).get(sub.userId);\n  if (!user || user.disabled) {\n    return [];\n  }\n  const kinds = NotificationSubscriptionModel.viaOf(sub);\n  const wants = kinds.length > 0 ? kinds : [\"email\"];\n  return wants\n    .filter((kind) => wired.has(kind))\n    .map((kind) => ({\n      id: `sub:${sub.id}:${kind}`,\n      projectId: sub.projectId,\n      provider: kind,\n      config: { to: user.email },\n      events: [],\n      enabled: true,\n    }));\n}\n\n/** Per-subscriber targets for an event (only kinds that are wired). */\nasync function subscriberTargets(\n  db: DatabaseAdapter,\n  projectId: string,\n  event: string,\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  const rows = await new NotificationSubscriptionModel(db).list(projectId);\n  const nested = await Promise.all(\n    matchingSubs(rows, event).map(async (sub) => await targetsForSub(db, sub, wired)),\n  );\n  return nested.flat();\n}\n\n/**\n * Fan out a project event to stored channels plus opted-in subscribers.\n * Runs alongside (never instead of) webhook delivery.\n */\nexport async function notifyProjectWith(\n  deps: NotifyDeps,\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: string,\n  data: Record<string, unknown>,\n  reviewSuffix?: string,\n): Promise<void> {\n  if (deps.notifiers.length === 0) {\n    return;\n  }\n  const reviewUrl = reviewSuffix\n    ? reviewUrlForWith(deps.config.publicBaseUrl, project.slug, reviewSuffix)\n    : undefined;\n  const wired = new Set(deps.notifiers.map((candidate) => candidate.metadata.kind));\n  const channels = await loadChannels(deps, project.id);\n  const targets = await subscriberTargets(deps.db, project.id, event, wired);\n  await emitNotifications(\n    { event, projectId: project.id, projectSlug: project.slug, data, timestamp: now() },\n    {\n      notifiers: deps.notifiers,\n      channels: [...channels, ...targets],\n      brand: brandFor(deps.ui, deps.config, reviewUrl),\n      logger: deps.logger,\n    },\n  );\n}\n\n/**\n * Fan out a project event to stored channels plus opted-in subscribers.\n * Runs alongside (never instead of) webhook delivery.\n */\nexport async function notifyProject(\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: string,\n  data: Record<string, unknown>,\n  reviewSuffix?: string,\n): Promise<void> {\n  await notifyProjectWith(getStore(), project, event, data, reviewSuffix);\n}\n\n/** Fan out a site-wide admin alert to project-less channels. */\nexport async function notifySystemWith(\n  deps: NotifyDeps,\n  event: SystemEventName,\n  data: Record<string, unknown>,\n): Promise<void> {\n  if (deps.notifiers.length === 0) {\n    return;\n  }\n  await emitSystemNotification(\n    { event, data, timestamp: now() },\n    {\n      notifiers: deps.notifiers,\n      channels: await loadChannels(deps, null),\n      brand: brandFor(deps.ui, deps.config),\n      logger: deps.logger,\n    },\n  );\n}\n\n/** Fan out a site-wide admin alert to project-less channels. */\nexport async function notifySystem(\n  event: SystemEventName,\n  data: Record<string, unknown>,\n): Promise<void> {\n  await notifySystemWith(getStore(), event, data);\n}\n\n/**\n * Host hook for the auth engine (`onAuthSystemEvent`): fans `sys:*` auth\n * events out to admin channels. Safe to call anywhere — outside a request\n * scope (e.g. boot) it resolves to a no-op instead of throwing.\n */\nexport function createAuthSystemHook(): (\n  event: \"sys:user-created\" | \"sys:invite-issued\",\n  data: Record<string, unknown>,\n) => Promise<void> {\n  return async (event, data): Promise<void> => {\n    await notifySystem(event, data).catch(() => {\n      // Intentionally empty — best-effort fan-out must never break auth\n    });\n  };\n}\n\n/** Current timestamp for notification envelopes. */\nfunction now(): string {\n  return new Date().toISOString();\n}\n"],"mappings":"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"}
+{"version":3,"file":"notify.mjs","names":[],"sources":["../src/notify.ts"],"sourcesContent":["/**\n * Notification fan-out for routers: loads stored channels and subscriber\n * emails, then delegates to the wired notifier providers. Best-effort and\n * non-fatal — failures are logged inside the emitters, never thrown here.\n */\nimport type { DatabaseAdapter } from \"@storyshelf/core/adapter/database\";\nimport type { NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport {\n  emitNotifications,\n  emitSystemNotification,\n  type ChannelOutcome,\n  type NotificationBrand,\n  type NotificationChannel,\n  type SystemEventName,\n} from \"@storyshelf/core/adapter/notifier\";\nimport type { NotificationsConfig, ShelfConfig, UIConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport {\n  MemberModel,\n  NotificationChannelModel,\n  NotificationSubscriptionModel,\n  UserModel,\n  type PublicOriginResolver,\n} from \"@storyshelf/core/models\";\nimport type { NotificationSubscriptionRow } from \"@storyshelf/core/schema\";\nimport type { Project } from \"@storyshelf/core/schema\";\nimport { credentialKeys } from \"./credential-keys.ts\";\nimport { clearPaused, notificationOrigin, warnPaused } from \"./notifications-pause.ts\";\nimport { getStore } from \"./store.ts\";\n\n/** Explicit dependencies for background fan-out (no request scope). */\nexport interface NotifyDeps {\n  db: DatabaseAdapter;\n  config: ShelfConfig;\n  ui: UIConfig;\n  logger: Logger;\n  notifiers: NotifierProvider[];\n  /** Brand/sender settings (`notifications.config`). */\n  notificationsConfig?: NotificationsConfig;\n  /** The public origin resolver; absent ⇒ `config.publicBaseUrl` only. */\n  publicOrigin?: Pick<PublicOriginResolver, \"url\"> | undefined;\n}\n\n/** Absolute review URL for a project page under the resolved public origin. */\nfunction reviewUrlFor(origin: string, slug: string, suffix: string): string {\n  return `${origin}/projects/${slug}${suffix}`;\n}\n\n/**\n * The origin notifications link to; `undefined` (after one log line per pause) while none is\n * resolved, which pauses every notification (ADR 0014, decision 11).\n */\nasync function originOrPause(\n  deps: Pick<NotifyDeps, \"config\" | \"publicOrigin\" | \"logger\">,\n  event: string,\n): Promise<string | undefined> {\n  const origin = await notificationOrigin(deps);\n  if (origin === undefined) {\n    warnPaused(deps.logger, event);\n  } else {\n    clearPaused(deps.logger);\n  }\n  return origin;\n}\n\n/** Brand inputs from UI config plus the notification sender settings. */\nfunction brandFor(\n  ui: UIConfig,\n  settings: NotificationsConfig | undefined,\n  reviewUrl?: string,\n): NotificationBrand {\n  return {\n    name: ui.name,\n    logo: ui.logo,\n    reviewUrl,\n    fromEmail: settings?.fromEmail,\n    fromName: settings?.fromName ?? ui.name,\n    footerText: settings?.footerText,\n  };\n}\n\n/** Load stored channels as send-ready views (skips undecryptable secrets). */\nasync function loadChannels(\n  deps: Pick<NotifyDeps, \"db\" | \"config\">,\n  projectId: string | null,\n): Promise<NotificationChannel[]> {\n  const model = channelModel(deps);\n  const rows = projectId === null ? await model.listSystem() : await model.list(projectId);\n  return rows.filter((row) => row.enabled).flatMap((row) => model.toView(row) ?? []);\n}\n\n/** The channel model bound to the server secret. */\nfunction channelModel(deps: Pick<NotifyDeps, \"db\" | \"config\">): NotificationChannelModel {\n  return new NotificationChannelModel(deps.db, undefined, credentialKeys(deps.config));\n}\n\n/** Record each delivery outcome on its channel row (the last error shown in settings). */\nfunction recordOutcomes(\n  deps: Pick<NotifyDeps, \"db\" | \"config\" | \"logger\">,\n): (outcome: ChannelOutcome) => Promise<void> {\n  const model = channelModel(deps);\n  return async (outcome) => {\n    if (outcome.channelId.startsWith(\"sub:\") || outcome.channelId.startsWith(\"default:\")) {\n      return;\n    }\n    await model.recordOutcome(outcome.channelId, outcome.error).catch((error: unknown) => {\n      deps.logger.warn({ err: error, channelId: outcome.channelId }, \"failed to record outcome\");\n    });\n  };\n}\n\n/** Subscriptions matching an event (enabled + allowlist). */\nfunction matchingSubs(\n  rows: NotificationSubscriptionRow[],\n  event: string,\n): NotificationSubscriptionRow[] {\n  return rows.filter((row) => {\n    if (!row.enabled) {\n      return false;\n    }\n    const events = NotificationSubscriptionModel.eventsOf(row);\n    return events.length === 0 || events.includes(event);\n  });\n}\n\n/** Per-subscriber targets for one subscription (wired kinds only). */\nasync function targetsForSub(\n  db: DatabaseAdapter,\n  sub: NotificationSubscriptionRow,\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  const user = await new UserModel(db).get(sub.userId);\n  if (!user || user.disabled) {\n    return [];\n  }\n  const kinds = NotificationSubscriptionModel.viaOf(sub);\n  const wants = kinds.length > 0 ? kinds : [\"email\"];\n  return wants\n    .filter((kind) => wired.has(kind))\n    .map((kind) => ({\n      id: `sub:${sub.id}:${kind}`,\n      projectId: sub.projectId,\n      provider: kind,\n      config: { to: user.email },\n      events: [],\n      enabled: true,\n    }));\n}\n\n/** Topics that reach a project's approvers and admins unless they opted out (ADR 0013, decision 4). */\nconst DEFAULT_ON_EVENTS: ReadonlySet<string> = new Set([\"review:requested\"]);\n\n/** Roles that review builds: the default recipients of {@link DEFAULT_ON_EVENTS}. */\nconst REVIEWER_ROLES: ReadonlySet<string> = new Set([\"approver\", \"admin\"]);\n\n/**\n * Reviewers with no subscription row for the project: a default-on topic reaches them by email.\n * Anyone with a row decides for themselves (`enabled` off or a topic list without the event opts\n * out), so a row never adds a second message here.\n */\nasync function defaultTargets(\n  db: DatabaseAdapter,\n  projectId: string,\n  rows: NotificationSubscriptionRow[],\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  if (!wired.has(\"email\")) {\n    return [];\n  }\n  const subscribed = new Set(rows.map((row) => row.userId));\n  const members = (await new MemberModel(db).list(projectId)).filter(\n    (member) => REVIEWER_ROLES.has(member.role) && !subscribed.has(member.userId),\n  );\n  const targets = await Promise.all(\n    members.map(async (member): Promise<NotificationChannel[]> => {\n      const user = await new UserModel(db).get(member.userId);\n      return !user || user.disabled\n        ? []\n        : [\n            {\n              id: `default:${projectId}:${member.userId}`,\n              projectId,\n              provider: \"email\",\n              config: { to: user.email },\n              events: [],\n              enabled: true,\n            },\n          ];\n    }),\n  );\n  return targets.flat();\n}\n\n/** Per-subscriber targets for an event (only kinds that are wired). */\nasync function subscriberTargets(\n  db: DatabaseAdapter,\n  projectId: string,\n  event: string,\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  const rows = await new NotificationSubscriptionModel(db).list(projectId);\n  const nested = await Promise.all(\n    matchingSubs(rows, event).map(async (sub) => await targetsForSub(db, sub, wired)),\n  );\n  const defaults = DEFAULT_ON_EVENTS.has(event)\n    ? await defaultTargets(db, projectId, rows, wired)\n    : [];\n  return [...nested.flat(), ...defaults];\n}\n\n/**\n * Fan out a project event to stored channels plus opted-in subscribers.\n * Runs alongside (never instead of) webhook delivery.\n */\nexport async function notifyProjectWith(\n  deps: NotifyDeps,\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: string,\n  data: Record<string, unknown>,\n  reviewSuffix?: string,\n): Promise<void> {\n  if (deps.notifiers.length === 0) {\n    return;\n  }\n  const origin = await originOrPause(deps, event);\n  if (origin === undefined) {\n    return;\n  }\n  const reviewUrl = reviewSuffix ? reviewUrlFor(origin, project.slug, reviewSuffix) : undefined;\n  const wired = new Set(deps.notifiers.map((candidate) => candidate.metadata.kind));\n  const channels = await loadChannels(deps, project.id);\n  const targets = await subscriberTargets(deps.db, project.id, event, wired);\n  await emitNotifications(\n    { event, projectId: project.id, projectSlug: project.slug, data, timestamp: now() },\n    {\n      notifiers: deps.notifiers,\n      channels: [...channels, ...targets],\n      brand: brandFor(deps.ui, deps.notificationsConfig, reviewUrl),\n      logger: deps.logger,\n      onOutcome: recordOutcomes(deps),\n    },\n  );\n}\n\n/**\n * Fan out a project event to stored channels plus opted-in subscribers.\n * Runs alongside (never instead of) webhook delivery.\n */\nexport async function notifyProject(\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: string,\n  data: Record<string, unknown>,\n  reviewSuffix?: string,\n): Promise<void> {\n  await notifyProjectWith(getStore(), project, event, data, reviewSuffix);\n}\n\n/** Fan out a site-wide admin alert to project-less channels. */\nexport async function notifySystemWith(\n  deps: NotifyDeps,\n  event: SystemEventName,\n  data: Record<string, unknown>,\n): Promise<void> {\n  if (deps.notifiers.length === 0 || (await originOrPause(deps, event)) === undefined) {\n    return;\n  }\n  await emitSystemNotification(\n    { event, data, timestamp: now() },\n    {\n      notifiers: deps.notifiers,\n      channels: await loadChannels(deps, null),\n      brand: brandFor(deps.ui, deps.notificationsConfig),\n      logger: deps.logger,\n      onOutcome: recordOutcomes(deps),\n    },\n  );\n}\n\n/** Fan out a site-wide admin alert to project-less channels. */\nexport async function notifySystem(\n  event: SystemEventName,\n  data: Record<string, unknown>,\n): Promise<void> {\n  await notifySystemWith(getStore(), event, data);\n}\n\n/**\n * Host hook for the auth engine (`onAuthSystemEvent`): fans `sys:*` auth\n * events out to admin channels. Safe to call anywhere — outside a request\n * scope (e.g. boot) it resolves to a no-op instead of throwing.\n */\nexport function createAuthSystemHook(): (\n  event: \"sys:user-created\" | \"sys:invite-issued\",\n  data: Record<string, unknown>,\n) => Promise<void> {\n  return async (event, data): Promise<void> => {\n    await notifySystem(event, data).catch(() => {\n      // Intentionally empty — best-effort fan-out must never break auth\n    });\n  };\n}\n\n/** Current timestamp for notification envelopes. */\nfunction now(): string {\n  return new Date().toISOString();\n}\n"],"mappings":"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"}

package/dist/pages/a11y-violations.mjs

@@ -0,0 +1,116 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { Alert, Badge, Meta } from "../ui/feedback.mjs";
+import { jsx, jsxs } from "hono/jsx/jsx-runtime";
+//#region src/pages/a11y-violations.tsx
+/** The axe violation texts stored on a snapshot (`rule (impact): help [selector] n node(s)`); empty when none. */
+function a11yViolationsOf(snapshot) {
+	if (!snapshot.a11yViolations) return [];
+	try {
+		const parsed = JSON.parse(snapshot.a11yViolations);
+		return Array.isArray(parsed) ? parsed.filter((entry) => typeof entry === "string") : [];
+	} catch {
+		return [];
+	}
+}
+const UNAVAILABLE_PREFIX = "axe unavailable: ";
+/**
+* Whether a stored entry is the marker a runner writes when axe could not run
+* (`axe unavailable: <reason>`). It is a note about the run, never a finding: the one place that
+* knows the marker's shape.
+*/
+function isAxeUnavailable(text) {
+	return text.startsWith(UNAVAILABLE_PREFIX);
+}
+/** The entries of a snapshot that are findings (the `axe unavailable` markers left out). */
+function a11yFindingsOf(snapshot) {
+	return a11yViolationsOf(snapshot).filter((text) => !isAxeUnavailable(text));
+}
+/** The reason axe did not run on a snapshot, or `undefined` when it ran (or nothing is recorded). */
+function a11yUnavailableReasonOf(snapshot) {
+	return a11yViolationsOf(snapshot).find((text) => isAxeUnavailable(text))?.slice(17);
+}
+/**
+* The snapshot that carries the axe findings of a story across its browser targets: axe runs on the
+* primary target only, so the findings sit on one sibling. The given snapshot first, else the first
+* sibling with findings, else whichever carries an `axe unavailable` note, else the given one.
+*/
+function a11yCarrierOf(snapshot, siblings) {
+	const found = (candidate) => a11yFindingsOf(candidate).length > 0;
+	const unavailable = (candidate) => a11yUnavailableReasonOf(candidate) !== void 0;
+	if (found(snapshot)) return snapshot;
+	return siblings.find((sibling) => found(sibling)) ?? (unavailable(snapshot) ? snapshot : siblings.find((sibling) => unavailable(sibling))) ?? snapshot;
+}
+const OVERFLOW_LINE = /^…and (\d+) more$/u;
+/** Violations behind a stored list: its overflow line `…and N more` stands for N omitted violations. */
+function a11yCountOf(snapshot) {
+	let count = 0;
+	for (const text of a11yFindingsOf(snapshot)) {
+		const omitted = OVERFLOW_LINE.exec(text)?.[1];
+		count += omitted === void 0 ? 1 : Number(omitted);
+	}
+	return count;
+}
+/** The build-level totals of the findings stored on `snapshots`. */
+function a11ySummaryOf(snapshots) {
+	const counts = snapshots.map((snapshot) => a11yCountOf(snapshot));
+	return {
+		findings: counts.reduce((sum, count) => sum + count, 0),
+		snapshots: counts.filter((count) => count > 0).length,
+		unavailable: snapshots.filter((snapshot) => a11yUnavailableReasonOf(snapshot) !== void 0).length
+	};
+}
+/**
+* The line under the build-level total. A snapshot stores nothing when axe found nothing and when it
+* did not run (a11y off, capture unfinished), so a zero never claims "none found".
+*/
+function a11ySummaryNote(summary) {
+	const base = summary.findings > 0 ? `On ${summary.snapshots} ${summary.snapshots === 1 ? "snapshot" : "snapshots"}. Information only; they never change the status.` : "No findings recorded. Information only.";
+	return summary.unavailable > 0 ? `${base} ${a11yUnavailableNote(summary.unavailable)}` : base;
+}
+/** The neutral line for runs where axe did not run; the reason sits on each snapshot. */
+function a11yUnavailableNote(count) {
+	return `axe did not run on ${count} ${count === 1 ? "snapshot" : "snapshots"}.`;
+}
+/** " on <target>" for the findings of a snapshot: axe runs on the primary target only, so say which. */
+function onTarget(snapshot) {
+	return snapshot.browser ? ` on ${snapshot.browser}` : "";
+}
+/** Review-page note above the viewer: what axe found on this snapshot. It never blocks the build. */
+function A11yViolationsNotice(props) {
+	const violations = a11yFindingsOf(props.snapshot);
+	const unavailable = a11yUnavailableReasonOf(props.snapshot);
+	if (violations.length === 0) return unavailable === void 0 ? null : /* @__PURE__ */ jsx(Alert, {
+		tone: "info",
+		title: `Accessibility: axe did not run${onTarget(props.snapshot)}`,
+		children: /* @__PURE__ */ jsx("code", { children: unavailable })
+	});
+	return /* @__PURE__ */ jsx(Alert, {
+		tone: "warning",
+		title: `Accessibility: ${a11yCountOf(props.snapshot)} found${onTarget(props.snapshot)} (does not block)`,
+		children: /* @__PURE__ */ jsx("ul", { children: violations.map((text) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("code", { children: text }) }, text)) })
+	});
+}
+/** Compact card version: a badge with the count and the findings behind a disclosure. */
+function A11yViolationsDetails(props) {
+	const violations = a11yFindingsOf(props.snapshot);
+	const unavailable = a11yUnavailableReasonOf(props.snapshot);
+	if (violations.length === 0) return unavailable === void 0 ? null : /* @__PURE__ */ jsxs("details", { children: [/* @__PURE__ */ jsx("summary", { children: /* @__PURE__ */ jsxs(Badge, {
+		tone: "neutral",
+		children: ["axe did not run", onTarget(props.snapshot)]
+	}) }), /* @__PURE__ */ jsx(Meta, { children: /* @__PURE__ */ jsx("code", { children: unavailable }) })] });
+	return /* @__PURE__ */ jsxs("details", { children: [/* @__PURE__ */ jsx("summary", { children: /* @__PURE__ */ jsxs(Badge, {
+		tone: "warning",
+		icon: true,
+		children: [
+			"a11y ",
+			a11yCountOf(props.snapshot),
+			onTarget(props.snapshot)
+		]
+	}) }), violations.map((text) => /* @__PURE__ */ jsx(Meta, { children: /* @__PURE__ */ jsx("code", { children: text }) }, text))] });
+}
+//#endregion
+export { A11yViolationsDetails, A11yViolationsNotice, a11yCarrierOf, a11yCountOf, a11yFindingsOf, a11ySummaryNote, a11ySummaryOf, a11yUnavailableNote, a11yUnavailableReasonOf, a11yViolationsOf, isAxeUnavailable };
+
+//# sourceMappingURL=a11y-violations.mjs.map

package/dist/pages/a11y-violations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-violations.mjs","names":[],"sources":["../../src/pages/a11y-violations.tsx"],"sourcesContent":["import type { Snapshot } from \"@storyshelf/core/schema\";\nimport type { HtmlEscapedString } from \"hono/utils/html\";\nimport { Alert, Badge, Meta } from \"../ui/components.tsx\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\ntype Rendered = HtmlEscapedString | Promise<HtmlEscapedString>;\n\n/** The axe violation texts stored on a snapshot (`rule (impact): help [selector] n node(s)`); empty when none. */\nexport function a11yViolationsOf(snapshot: Pick<Snapshot, \"a11yViolations\">): string[] {\n  if (!snapshot.a11yViolations) {\n    return [];\n  }\n  try {\n    const parsed: unknown = JSON.parse(snapshot.a11yViolations);\n    return Array.isArray(parsed)\n      ? parsed.filter((entry): entry is string => typeof entry === \"string\")\n      : [];\n  } catch {\n    return [];\n  }\n}\n\nconst UNAVAILABLE_PREFIX = \"axe unavailable: \";\n\n/**\n * Whether a stored entry is the marker a runner writes when axe could not run\n * (`axe unavailable: <reason>`). It is a note about the run, never a finding: the one place that\n * knows the marker's shape.\n */\nexport function isAxeUnavailable(text: string): boolean {\n  return text.startsWith(UNAVAILABLE_PREFIX);\n}\n\n/** The entries of a snapshot that are findings (the `axe unavailable` markers left out). */\nexport function a11yFindingsOf(snapshot: Pick<Snapshot, \"a11yViolations\">): string[] {\n  return a11yViolationsOf(snapshot).filter((text) => !isAxeUnavailable(text));\n}\n\n/** The reason axe did not run on a snapshot, or `undefined` when it ran (or nothing is recorded). */\nexport function a11yUnavailableReasonOf(\n  snapshot: Pick<Snapshot, \"a11yViolations\">,\n): string | undefined {\n  const marker = a11yViolationsOf(snapshot).find((text) => isAxeUnavailable(text));\n  return marker?.slice(UNAVAILABLE_PREFIX.length);\n}\n\n/**\n * The snapshot that carries the axe findings of a story across its browser targets: axe runs on the\n * primary target only, so the findings sit on one sibling. The given snapshot first, else the first\n * sibling with findings, else whichever carries an `axe unavailable` note, else the given one.\n */\nexport function a11yCarrierOf<T extends Pick<Snapshot, \"a11yViolations\">>(\n  snapshot: T,\n  siblings: readonly T[],\n): T {\n  const found = (candidate: T): boolean => a11yFindingsOf(candidate).length > 0;\n  const unavailable = (candidate: T): boolean => a11yUnavailableReasonOf(candidate) !== undefined;\n  if (found(snapshot)) {\n    return snapshot;\n  }\n  // Findings win over an `axe unavailable` note, which only shows when nothing found anything.\n  return (\n    siblings.find((sibling) => found(sibling)) ??\n    (unavailable(snapshot) ? snapshot : siblings.find((sibling) => unavailable(sibling))) ??\n    snapshot\n  );\n}\n\n/** What axe found across a build, for its summary: information only, never part of a status. */\nexport interface A11ySummary {\n  /** Findings summed over every snapshot (axe runs on the primary target only, so none repeat). */\n  findings: number;\n  /** Snapshots that carry at least one finding. */\n  snapshots: number;\n  /** Snapshots on which axe did not run (`axe unavailable`); never counted as findings. */\n  unavailable: number;\n}\n\nconst OVERFLOW_LINE = /^…and (\\d+) more$/u;\n\n/** Violations behind a stored list: its overflow line `…and N more` stands for N omitted violations. */\nexport function a11yCountOf(snapshot: Pick<Snapshot, \"a11yViolations\">): number {\n  let count = 0;\n  for (const text of a11yFindingsOf(snapshot)) {\n    const omitted = OVERFLOW_LINE.exec(text)?.[1];\n    count += omitted === undefined ? 1 : Number(omitted);\n  }\n  return count;\n}\n\n/** The build-level totals of the findings stored on `snapshots`. */\nexport function a11ySummaryOf(snapshots: readonly Pick<Snapshot, \"a11yViolations\">[]): A11ySummary {\n  const counts = snapshots.map((snapshot) => a11yCountOf(snapshot));\n  return {\n    findings: counts.reduce((sum, count) => sum + count, 0),\n    snapshots: counts.filter((count) => count > 0).length,\n    unavailable: snapshots.filter((snapshot) => a11yUnavailableReasonOf(snapshot) !== undefined)\n      .length,\n  };\n}\n\n/**\n * The line under the build-level total. A snapshot stores nothing when axe found nothing and when it\n * did not run (a11y off, capture unfinished), so a zero never claims \"none found\".\n */\nexport function a11ySummaryNote(summary: A11ySummary): string {\n  const base =\n    summary.findings > 0\n      ? `On ${summary.snapshots} ${summary.snapshots === 1 ? \"snapshot\" : \"snapshots\"}. Information only; they never change the status.`\n      : \"No findings recorded. Information only.\";\n  return summary.unavailable > 0 ? `${base} ${a11yUnavailableNote(summary.unavailable)}` : base;\n}\n\n/** The neutral line for runs where axe did not run; the reason sits on each snapshot. */\nexport function a11yUnavailableNote(count: number): string {\n  return `axe did not run on ${count} ${count === 1 ? \"snapshot\" : \"snapshots\"}.`;\n}\n\n/** \" on <target>\" for the findings of a snapshot: axe runs on the primary target only, so say which. */\nfunction onTarget(snapshot: Pick<Snapshot, \"browser\">): string {\n  return snapshot.browser ? ` on ${snapshot.browser}` : \"\";\n}\n\n/** Review-page note above the viewer: what axe found on this snapshot. It never blocks the build. */\nexport function A11yViolationsNotice(props: {\n  snapshot: Pick<Snapshot, \"a11yViolations\" | \"browser\">;\n}): Rendered | null {\n  const violations = a11yFindingsOf(props.snapshot);\n  const unavailable = a11yUnavailableReasonOf(props.snapshot);\n  if (violations.length === 0) {\n    return unavailable === undefined ? null : (\n      <Alert tone=\"info\" title={`Accessibility: axe did not run${onTarget(props.snapshot)}`}>\n        <code>{unavailable}</code>\n      </Alert>\n    );\n  }\n  return (\n    <Alert\n      tone=\"warning\"\n      title={`Accessibility: ${a11yCountOf(props.snapshot)} found${onTarget(props.snapshot)} (does not block)`}\n    >\n      <ul>\n        {violations.map((text) => (\n          <li key={text}>\n            <code>{text}</code>\n          </li>\n        ))}\n      </ul>\n    </Alert>\n  );\n}\n\n/** Compact card version: a badge with the count and the findings behind a disclosure. */\nexport function A11yViolationsDetails(props: {\n  snapshot: Pick<Snapshot, \"a11yViolations\" | \"browser\">;\n}): Rendered | null {\n  const violations = a11yFindingsOf(props.snapshot);\n  const unavailable = a11yUnavailableReasonOf(props.snapshot);\n  if (violations.length === 0) {\n    return unavailable === undefined ? null : (\n      <details>\n        <summary>\n          <Badge tone=\"neutral\">axe did not run{onTarget(props.snapshot)}</Badge>\n        </summary>\n        <Meta>\n          <code>{unavailable}</code>\n        </Meta>\n      </details>\n    );\n  }\n  return (\n    <details>\n      <summary>\n        <Badge tone=\"warning\" icon>\n          a11y {a11yCountOf(props.snapshot)}\n          {onTarget(props.snapshot)}\n        </Badge>\n      </summary>\n      {violations.map((text) => (\n        <Meta key={text}>\n          <code>{text}</code>\n        </Meta>\n      ))}\n    </details>\n  );\n}\n"],"mappings":"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"}

package/dist/pages/admin-ai.mjs

@@ -0,0 +1,78 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { EmptyState, Meta, Stat } from "../ui/feedback.mjs";
+import { Card, PageHeader, SectionTitle } from "../ui/layout.mjs";
+import { Table } from "../ui/table.mjs";
+import { DocumentLayout } from "../ui/document.mjs";
+import { Fragment, jsx, jsxs } from "hono/jsx/jsx-runtime";
+//#region src/pages/admin-ai.tsx
+function DaysTable(props) {
+	return /* @__PURE__ */ jsx(Table, {
+		dense: true,
+		children: /* @__PURE__ */ jsxs("table", { children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
+			/* @__PURE__ */ jsx("th", { children: "Day" }),
+			/* @__PURE__ */ jsx("th", { children: "Tokens" }),
+			/* @__PURE__ */ jsx("th", { children: "Calls" }),
+			/* @__PURE__ */ jsx("th", { children: "Failed" })
+		] }) }), /* @__PURE__ */ jsx("tbody", { children: props.days.map((day) => /* @__PURE__ */ jsxs("tr", { children: [
+			/* @__PURE__ */ jsx("td", { children: day.day }),
+			/* @__PURE__ */ jsx("td", { children: day.tokens }),
+			/* @__PURE__ */ jsx("td", { children: day.calls }),
+			/* @__PURE__ */ jsx("td", { children: day.failed })
+		] })) })] })
+	});
+}
+function ProfilesTable(props) {
+	return /* @__PURE__ */ jsx(Table, {
+		dense: true,
+		children: /* @__PURE__ */ jsxs("table", { children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
+			/* @__PURE__ */ jsx("th", { children: "Profile" }),
+			/* @__PURE__ */ jsx("th", { children: "Tokens" }),
+			/* @__PURE__ */ jsx("th", { children: "Calls" })
+		] }) }), /* @__PURE__ */ jsx("tbody", { children: props.profiles.map((profile) => /* @__PURE__ */ jsxs("tr", { children: [
+			/* @__PURE__ */ jsx("td", { children: profile.profile }),
+			/* @__PURE__ */ jsx("td", { children: profile.tokens }),
+			/* @__PURE__ */ jsx("td", { children: profile.calls })
+		] })) })] })
+	});
+}
+/** Site-admin AI usage page: today's budget position and the last days by profile. */
+function renderAdminAiPage(report) {
+	const cap = report.dailyTokens;
+	const today = cap === null ? `${report.todayTokens} tokens` : `${report.todayTokens} / ${cap} tokens`;
+	return /* @__PURE__ */ jsxs(DocumentLayout, {
+		title: "AI usage",
+		nav: { active: "admin" },
+		children: [
+			/* @__PURE__ */ jsx(PageHeader, {
+				title: "AI usage",
+				description: "Tokens counted toward the daily budget (UTC days). Visible to site admins only."
+			}),
+			/* @__PURE__ */ jsx(Card, { children: /* @__PURE__ */ jsx(Stat, {
+				label: "Today",
+				value: today
+			}) }),
+			report.days.length === 0 ? /* @__PURE__ */ jsx(EmptyState, {
+				title: "No usage yet",
+				description: "AI calls appear here after the first insight runs."
+			}) : /* @__PURE__ */ jsxs(Fragment, { children: [
+				/* @__PURE__ */ jsx(SectionTitle, {
+					level: 3,
+					children: "By day"
+				}),
+				/* @__PURE__ */ jsx(DaysTable, { days: report.days }),
+				/* @__PURE__ */ jsx(SectionTitle, {
+					level: 3,
+					children: "By profile"
+				}),
+				/* @__PURE__ */ jsx(ProfilesTable, { profiles: report.profiles }),
+				/* @__PURE__ */ jsx(Meta, { children: "Rows older than 90 days are purged. Failed calls the provider billed still count." })
+			] })
+		]
+	});
+}
+//#endregion
+export { renderAdminAiPage };
+
+//# sourceMappingURL=admin-ai.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admin-ai.mjs","names":[],"sources":["../../src/pages/admin-ai.tsx"],"sourcesContent":["import type { HtmlEscapedString } from \"hono/utils/html\";\nimport type { UsageReport } from \"../insights/usage-report.ts\";\nimport {\n  Card,\n  EmptyState,\n  Meta,\n  PageHeader,\n  SectionTitle,\n  Stat,\n  Table,\n} from \"../ui/components.tsx\";\nimport { DocumentLayout, type RenderedContent } from \"../ui/document.tsx\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\nfunction DaysTable(props: {\n  days: UsageReport[\"days\"];\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  return (\n    <Table dense>\n      <table>\n        <thead>\n          <tr>\n            <th>Day</th>\n            <th>Tokens</th>\n            <th>Calls</th>\n            <th>Failed</th>\n          </tr>\n        </thead>\n        <tbody>\n          {props.days.map((day) => (\n            <tr>\n              <td>{day.day}</td>\n              <td>{day.tokens}</td>\n              <td>{day.calls}</td>\n              <td>{day.failed}</td>\n            </tr>\n          ))}\n        </tbody>\n      </table>\n    </Table>\n  );\n}\n\nfunction ProfilesTable(props: {\n  profiles: UsageReport[\"profiles\"];\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  return (\n    <Table dense>\n      <table>\n        <thead>\n          <tr>\n            <th>Profile</th>\n            <th>Tokens</th>\n            <th>Calls</th>\n          </tr>\n        </thead>\n        <tbody>\n          {props.profiles.map((profile) => (\n            <tr>\n              <td>{profile.profile}</td>\n              <td>{profile.tokens}</td>\n              <td>{profile.calls}</td>\n            </tr>\n          ))}\n        </tbody>\n      </table>\n    </Table>\n  );\n}\n\n/** Site-admin AI usage page: today's budget position and the last days by profile. */\nexport function renderAdminAiPage(report: UsageReport): RenderedContent {\n  const cap = report.dailyTokens;\n  const today =\n    cap === null ? `${report.todayTokens} tokens` : `${report.todayTokens} / ${cap} tokens`;\n  return (\n    <DocumentLayout title=\"AI usage\" nav={{ active: \"admin\" }}>\n      <PageHeader\n        title=\"AI usage\"\n        description=\"Tokens counted toward the daily budget (UTC days). Visible to site admins only.\"\n      />\n      <Card>\n        <Stat label=\"Today\" value={today} />\n      </Card>\n      {report.days.length === 0 ? (\n        <EmptyState\n          title=\"No usage yet\"\n          description=\"AI calls appear here after the first insight runs.\"\n        />\n      ) : (\n        <>\n          <SectionTitle level={3}>By day</SectionTitle>\n          <DaysTable days={report.days} />\n          <SectionTitle level={3}>By profile</SectionTitle>\n          <ProfilesTable profiles={report.profiles} />\n          <Meta>\n            Rows older than 90 days are purged. Failed calls the provider billed still count.\n          </Meta>\n        </>\n      )}\n    </DocumentLayout>\n  );\n}\n"],"mappings":";;;;;;;;;AAeA,SAAS,UAAU,OAEgC;CACjD,OACE,oBAAC,OAAD;EAAO,OAAA;EACL,UAAA,qBAAC,SAAD,EAAA,UAAA,CACE,oBAAC,SAAD,EAAA,UACE,qBAAC,MAAD,EAAA,UAAA;GACE,oBAAC,MAAD,EAAA,UAAI,MAAO,CAAA;GACX,oBAAC,MAAD,EAAA,UAAI,SAAU,CAAA;GACd,oBAAC,MAAD,EAAA,UAAI,QAAS,CAAA;GACb,oBAAC,MAAD,EAAA,UAAI,SAAU,CAAA;EACZ,EAAA,CAAA,EACC,CAAA,GACP,oBAAC,SAAD,EAAA,UACG,MAAM,KAAK,KAAK,QACf,qBAAC,MAAD,EAAA,UAAA;GACE,oBAAC,MAAD,EAAA,UAAK,IAAI,IAAQ,CAAA;GACjB,oBAAC,MAAD,EAAA,UAAK,IAAI,OAAW,CAAA;GACpB,oBAAC,MAAD,EAAA,UAAK,IAAI,MAAU,CAAA;GACnB,oBAAC,MAAD,EAAA,UAAK,IAAI,OAAW,CAAA;EAClB,EAAA,CAAA,CACL,EACI,CAAA,CACF,EAAA,CAAA;CACF,CAAA;AAEX;AAEA,SAAS,cAAc,OAE4B;CACjD,OACE,oBAAC,OAAD;EAAO,OAAA;EACL,UAAA,qBAAC,SAAD,EAAA,UAAA,CACE,oBAAC,SAAD,EAAA,UACE,qBAAC,MAAD,EAAA,UAAA;GACE,oBAAC,MAAD,EAAA,UAAI,UAAW,CAAA;GACf,oBAAC,MAAD,EAAA,UAAI,SAAU,CAAA;GACd,oBAAC,MAAD,EAAA,UAAI,QAAS,CAAA;EACX,EAAA,CAAA,EACC,CAAA,GACP,oBAAC,SAAD,EAAA,UACG,MAAM,SAAS,KAAK,YACnB,qBAAC,MAAD,EAAA,UAAA;GACE,oBAAC,MAAD,EAAA,UAAK,QAAQ,QAAY,CAAA;GACzB,oBAAC,MAAD,EAAA,UAAK,QAAQ,OAAW,CAAA;GACxB,oBAAC,MAAD,EAAA,UAAK,QAAQ,MAAU,CAAA;EACrB,EAAA,CAAA,CACL,EACI,CAAA,CACF,EAAA,CAAA;CACF,CAAA;AAEX;;AAGA,SAAgB,kBAAkB,QAAsC;CACtE,MAAM,MAAM,OAAO;CACnB,MAAM,QACJ,QAAQ,OAAO,GAAG,OAAO,YAAY,WAAW,GAAG,OAAO,YAAY,KAAK,IAAI;CACjF,OACE,qBAAC,gBAAD;EAAgB,OAAM;EAAW,KAAK,EAAE,QAAQ,QAAQ;EAAxD,UAAA;GACE,oBAAC,YAAD;IACE,OAAM;IACN,aAAY;GACb,CAAA;GACD,oBAAC,MAAD,EAAA,UACE,oBAAC,MAAD;IAAM,OAAM;IAAQ,OAAO;GAAQ,CAAA,EAC/B,CAAA;GACL,OAAO,KAAK,WAAW,IACtB,oBAAC,YAAD;IACE,OAAM;IACN,aAAY;GACb,CAAA,IAED,qBAAA,UAAA,EAAA,UAAA;IACE,oBAAC,cAAD;KAAc,OAAO;KAAG,UAAA;IAAoB,CAAA;IAC5C,oBAAC,WAAD,EAAW,MAAM,OAAO,KAAO,CAAA;IAC/B,oBAAC,cAAD;KAAc,OAAO;KAAG,UAAA;IAAwB,CAAA;IAChD,oBAAC,eAAD,EAAe,UAAU,OAAO,SAAW,CAAA;IAC3C,oBAAC,MAAD,EAAA,UAAM,oFAEA,CAAA;GACN,EAAA,CAAA;EAEU;;AAEpB"}

package/dist/pages/admin-system-origin.mjs

@@ -0,0 +1,123 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { Button } from "../ui/buttons.mjs";
+import { Alert, Badge, Meta } from "../ui/feedback.mjs";
+import { Field, FormActions } from "../ui/forms.mjs";
+import { Card, SectionTitle } from "../ui/layout.mjs";
+import { HStack } from "../ui/stacks.mjs";
+import { csrfField } from "../ui/csrf-field.mjs";
+import { Fragment, jsx, jsxs } from "hono/jsx/jsx-runtime";
+//#region src/pages/admin-system-origin.tsx
+const SOURCE_LABELS = {
+	config: "configured (PUBLIC_BASE_URL)",
+	platform: "detected from the hosting platform",
+	admin: "confirmed by an admin"
+};
+/** Where absolute links in emails, commit statuses and signed Storybook URLs point (ADR 0007). */
+function PublicOriginCard(props) {
+	const { resolved, stored, learns } = props.origin;
+	const reports = learns && (resolved === null || resolved.source === "admin");
+	return /* @__PURE__ */ jsxs(Card, { children: [
+		/* @__PURE__ */ jsx(SectionTitle, { children: "Public origin" }),
+		/* @__PURE__ */ jsxs(Meta, { children: [
+			"The address links in emails, commit statuses and signed Storybook URLs use. It comes from",
+			" ",
+			/* @__PURE__ */ jsx("code", { children: "PUBLIC_BASE_URL" }),
+			", then the hosting platform, then an address an admin confirmed here. An address detected from a browser is used for none of these until it is confirmed; sign-in (OAuth redirects) may use the address of the request itself."
+		] }),
+		resolved === null ? /* @__PURE__ */ jsx(NothingResolved, {
+			learns,
+			stored
+		}) : /* @__PURE__ */ jsx(Resolved, { resolved }),
+		reports ? /* @__PURE__ */ jsx("div", { "data-report-origin": "/admin/public-origin/report" }) : null,
+		learns && stored !== null ? /* @__PURE__ */ jsx(StoredForm, { stored }) : null,
+		learns && stored === null ? /* @__PURE__ */ jsx(EnterForm, {}) : null
+	] });
+}
+function NothingResolved(props) {
+	if (props.stored !== null && !props.stored.confirmed) return /* @__PURE__ */ jsxs(Alert, {
+		tone: "warning",
+		title: "Public origin detected, not confirmed",
+		children: [/* @__PURE__ */ jsx("code", { children: props.stored.origin }), " was detected from your browser. Confirm it to enable notifications and signed Storybook URLs: until then no commit status or email is sent, and browsers that reach the Storybook by URL stay unavailable."]
+	});
+	return /* @__PURE__ */ jsxs(Alert, {
+		tone: "warning",
+		title: "No public origin is known",
+		children: [
+			"Notifications are paused, and browsers that reach the Storybook by URL stay unavailable.",
+			" ",
+			props.learns ? "Reload this page: it reports the address you opened it with, for you to confirm." : "Set PUBLIC_BASE_URL, or turn authentication on so an admin's browser can report it."
+		]
+	});
+}
+function Resolved(props) {
+	const { resolved } = props;
+	return /* @__PURE__ */ jsxs(HStack, { children: [/* @__PURE__ */ jsx("code", { children: resolved.url }), /* @__PURE__ */ jsx(Badge, {
+		tone: "success",
+		children: SOURCE_LABELS[resolved.source]
+	})] });
+}
+/** Confirm the detected origin, replace it, or drop it. */
+function StoredForm(props) {
+	const { stored } = props;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs("form", {
+		method: "post",
+		action: "/admin/public-origin",
+		"hx-post": "/admin/public-origin",
+		"hx-target": "body",
+		children: [
+			csrfField(),
+			/* @__PURE__ */ jsx(Field, {
+				label: "Stored origin",
+				name: "origin",
+				value: stored.origin,
+				hint: stored.confirmed ? "Confirmed. Change it if this is not the address people use." : "Detected from your browser. Confirm it, or enter the address people use."
+			}),
+			/* @__PURE__ */ jsx(FormActions, { children: /* @__PURE__ */ jsx(Button, {
+				type: "submit",
+				variant: "secondary",
+				size: "sm",
+				children: stored.confirmed ? "Save" : "Confirm"
+			}) })
+		]
+	}), /* @__PURE__ */ jsxs("form", {
+		method: "post",
+		action: "/admin/public-origin/clear",
+		"hx-post": "/admin/public-origin/clear",
+		"hx-target": "body",
+		children: [csrfField(), /* @__PURE__ */ jsx(Button, {
+			type: "submit",
+			variant: "secondary",
+			size: "sm",
+			children: "Forget stored origin"
+		})]
+	})] });
+}
+/** Enter an origin by hand when none was reported. */
+function EnterForm() {
+	return /* @__PURE__ */ jsxs("form", {
+		method: "post",
+		action: "/admin/public-origin",
+		"hx-post": "/admin/public-origin",
+		"hx-target": "body",
+		children: [
+			csrfField(),
+			/* @__PURE__ */ jsx(Field, {
+				label: "Origin",
+				name: "origin",
+				placeholder: "https://shelf.example.com"
+			}),
+			/* @__PURE__ */ jsx(FormActions, { children: /* @__PURE__ */ jsx(Button, {
+				type: "submit",
+				variant: "secondary",
+				size: "sm",
+				children: "Save"
+			}) })
+		]
+	});
+}
+//#endregion
+export { PublicOriginCard };
+
+//# sourceMappingURL=admin-system-origin.mjs.map

package/dist/pages/admin-system-origin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-system-origin.mjs","names":[],"sources":["../../src/pages/admin-system-origin.tsx"],"sourcesContent":["import type { ResolvedPublicOrigin, StoredPublicOrigin } from \"@storyshelf/core/models\";\nimport type { HtmlEscapedString } from \"hono/utils/html\";\nimport {\n  Alert,\n  Badge,\n  Button,\n  Card,\n  Field,\n  FormActions,\n  HStack,\n  Meta,\n  SectionTitle,\n} from \"../ui/components.tsx\";\nimport { csrfField } from \"../ui/csrf-field.tsx\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\n/** What the System page knows about the public origin. */\nexport interface PublicOriginView {\n  /** What background jobs use now (configured, platform or confirmed); `null` when nothing is confirmed. */\n  resolved: ResolvedPublicOrigin | null;\n  /** The origin an admin's browser reported; `null` when none did. */\n  stored: StoredPublicOrigin | null;\n  /** Whether this deployment can learn an origin from an admin's browser (authentication is on). */\n  learns: boolean;\n}\n\nconst SOURCE_LABELS = {\n  config: \"configured (PUBLIC_BASE_URL)\",\n  platform: \"detected from the hosting platform\",\n  admin: \"confirmed by an admin\",\n} as const;\n\n/** Where absolute links in emails, commit statuses and signed Storybook URLs point (ADR 0007). */\nexport function PublicOriginCard(props: {\n  origin: PublicOriginView;\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  const { resolved, stored, learns } = props.origin;\n  // A configured or platform origin outranks what a browser reports, so there is nothing to learn.\n  const reports = learns && (resolved === null || resolved.source === \"admin\");\n  return (\n    <Card>\n      <SectionTitle>Public origin</SectionTitle>\n      <Meta>\n        The address links in emails, commit statuses and signed Storybook URLs use. It comes from{\" \"}\n        <code>PUBLIC_BASE_URL</code>, then the hosting platform, then an address an admin confirmed\n        here. An address detected from a browser is used for none of these until it is confirmed;\n        sign-in (OAuth redirects) may use the address of the request itself.\n      </Meta>\n      {resolved === null ? (\n        <NothingResolved learns={learns} stored={stored} />\n      ) : (\n        <Resolved resolved={resolved} />\n      )}\n      {reports ? <div data-report-origin=\"/admin/public-origin/report\" /> : null}\n      {learns && stored !== null ? <StoredForm stored={stored} /> : null}\n      {learns && stored === null ? <EnterForm /> : null}\n    </Card>\n  );\n}\n\nfunction NothingResolved(props: {\n  learns: boolean;\n  stored: StoredPublicOrigin | null;\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  if (props.stored !== null && !props.stored.confirmed) {\n    return (\n      <Alert tone=\"warning\" title=\"Public origin detected, not confirmed\">\n        <code>{props.stored.origin}</code> was detected from your browser. Confirm it to enable\n        notifications and signed Storybook URLs: until then no commit status or email is sent, and\n        browsers that reach the Storybook by URL stay unavailable.\n      </Alert>\n    );\n  }\n  return (\n    <Alert tone=\"warning\" title=\"No public origin is known\">\n      Notifications are paused, and browsers that reach the Storybook by URL stay unavailable.{\" \"}\n      {props.learns\n        ? \"Reload this page: it reports the address you opened it with, for you to confirm.\"\n        : \"Set PUBLIC_BASE_URL, or turn authentication on so an admin's browser can report it.\"}\n    </Alert>\n  );\n}\n\nfunction Resolved(props: {\n  resolved: ResolvedPublicOrigin;\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  const { resolved } = props;\n  return (\n    <HStack>\n      <code>{resolved.url}</code>\n      <Badge tone=\"success\">{SOURCE_LABELS[resolved.source]}</Badge>\n    </HStack>\n  );\n}\n\n/** Confirm the detected origin, replace it, or drop it. */\nfunction StoredForm(props: {\n  stored: StoredPublicOrigin;\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  const { stored } = props;\n  return (\n    <>\n      <form\n        method=\"post\"\n        action=\"/admin/public-origin\"\n        hx-post=\"/admin/public-origin\"\n        hx-target=\"body\"\n      >\n        {csrfField()}\n        <Field\n          label=\"Stored origin\"\n          name=\"origin\"\n          value={stored.origin}\n          hint={\n            stored.confirmed\n              ? \"Confirmed. Change it if this is not the address people use.\"\n              : \"Detected from your browser. Confirm it, or enter the address people use.\"\n          }\n        />\n        <FormActions>\n          <Button type=\"submit\" variant=\"secondary\" size=\"sm\">\n            {stored.confirmed ? \"Save\" : \"Confirm\"}\n          </Button>\n        </FormActions>\n      </form>\n      <form\n        method=\"post\"\n        action=\"/admin/public-origin/clear\"\n        hx-post=\"/admin/public-origin/clear\"\n        hx-target=\"body\"\n      >\n        {csrfField()}\n        <Button type=\"submit\" variant=\"secondary\" size=\"sm\">\n          Forget stored origin\n        </Button>\n      </form>\n    </>\n  );\n}\n\n/** Enter an origin by hand when none was reported. */\nfunction EnterForm(): HtmlEscapedString | Promise<HtmlEscapedString> {\n  return (\n    <form\n      method=\"post\"\n      action=\"/admin/public-origin\"\n      hx-post=\"/admin/public-origin\"\n      hx-target=\"body\"\n    >\n      {csrfField()}\n      <Field label=\"Origin\" name=\"origin\" placeholder=\"https://shelf.example.com\" />\n      <FormActions>\n        <Button type=\"submit\" variant=\"secondary\" size=\"sm\">\n          Save\n        </Button>\n      </FormActions>\n    </form>\n  );\n}\n"],"mappings":";;;;;;;;;;;AA2BA,MAAM,gBAAgB;CACpB,QAAQ;CACR,UAAU;CACV,OAAO;AACT;;AAGA,SAAgB,iBAAiB,OAEkB;CACjD,MAAM,EAAE,UAAU,QAAQ,WAAW,MAAM;CAE3C,MAAM,UAAU,WAAW,aAAa,QAAQ,SAAS,WAAW;CACpE,OACE,qBAAC,MAAD,EAAA,UAAA;EACE,oBAAC,cAAD,EAAA,UAAc,gBAA2B,CAAA;EACzC,qBAAC,MAAD,EAAA,UAAA;GAAM;GACsF;GAC1F,oBAAC,QAAD,EAAA,UAAM,kBAAqB,CAAA;GAAC;EAGxB,EAAA,CAAA;EACL,aAAa,OACZ,oBAAC,iBAAD;GAAyB;GAAgB;EAAS,CAAA,IAElD,oBAAC,UAAD,EAAoB,SAAW,CAAA;EAEhC,UAAU,oBAAC,OAAD,EAAK,sBAAmB,8BAA+B,CAAA,IAAI;EACrE,UAAU,WAAW,OAAO,oBAAC,YAAD,EAAoB,OAAS,CAAA,IAAI;EAC7D,UAAU,WAAW,OAAO,oBAAC,WAAD,CAAY,CAAA,IAAI;CACzC,EAAA,CAAA;AAEV;AAEA,SAAS,gBAAgB,OAG0B;CACjD,IAAI,MAAM,WAAW,QAAQ,CAAC,MAAM,OAAO,WACzC,OACE,qBAAC,OAAD;EAAO,MAAK;EAAU,OAAM;EAA5B,UAAA,CACE,oBAAC,QAAD,EAAA,UAAO,MAAM,OAAO,OAAa,CAAA,GAAC,6MAG7B;;CAGX,OACE,qBAAC,OAAD;EAAO,MAAK;EAAU,OAAM;EAA5B,UAAA;GAAwD;GACmC;GACxF,MAAM,SACH,qFACA;EACC;;AAEX;AAEA,SAAS,SAAS,OAEiC;CACjD,MAAM,EAAE,aAAa;CACrB,OACE,qBAAC,QAAD,EAAA,UAAA,CACE,oBAAC,QAAD,EAAA,UAAO,SAAS,IAAU,CAAA,GAC1B,oBAAC,OAAD;EAAO,MAAK;EAAW,UAAA,cAAc,SAAS;CAAe,CAAA,CACvD,EAAA,CAAA;AAEZ;;AAGA,SAAS,WAAW,OAE+B;CACjD,MAAM,EAAE,WAAW;CACnB,OACE,qBAAA,UAAA,EAAA,UAAA,CACE,qBAAC,QAAD;EACE,QAAO;EACP,QAAO;EACP,WAAQ;EACR,aAAU;EAJZ,UAAA;GAMG,UAAU;GACX,oBAAC,OAAD;IACE,OAAM;IACN,MAAK;IACL,OAAO,OAAO;IACd,MACE,OAAO,YACH,gEACA;GAEP,CAAA;GACD,oBAAC,aAAD,EAAA,UACE,oBAAC,QAAD;IAAQ,MAAK;IAAS,SAAQ;IAAY,MAAK;IAC5C,UAAA,OAAO,YAAY,SAAS;GACvB,CAAA,EACG,CAAA;EACT;CACN,CAAA,GAAA,qBAAC,QAAD;EACE,QAAO;EACP,QAAO;EACP,WAAQ;EACR,aAAU;EAJZ,UAAA,CAMG,UAAU,GACX,oBAAC,QAAD;GAAQ,MAAK;GAAS,SAAQ;GAAY,MAAK;GAAK,UAAA;EAE5C,CAAA,CACJ;CACN,CAAA,CAAA,EAAA,CAAA;AAEN;;AAGA,SAAS,YAA4D;CACnE,OACE,qBAAC,QAAD;EACE,QAAO;EACP,QAAO;EACP,WAAQ;EACR,aAAU;EAJZ,UAAA;GAMG,UAAU;GACX,oBAAC,OAAD;IAAO,OAAM;IAAS,MAAK;IAAS,aAAY;GAA6B,CAAA;GAC7E,oBAAC,aAAD,EAAA,UACE,oBAAC,QAAD;IAAQ,MAAK;IAAS,SAAQ;IAAY,MAAK;IAAK,UAAA;GAE5C,CAAA,EACG,CAAA;EACT;;AAEV"}

package/dist/pages/admin-system-targets.mjs

@@ -0,0 +1,53 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { Badge, Meta } from "../ui/feedback.mjs";
+import { Card, SectionTitle } from "../ui/layout.mjs";
+import { Table } from "../ui/table.mjs";
+import { targetLabel } from "../targets.mjs";
+import { jsx, jsxs } from "hono/jsx/jsx-runtime";
+import { unavailableReason } from "@storyshelf/core/adapter/capture-runner";
+//#region src/pages/admin-system-targets.tsx
+/** The browsers the capture runner offers and whether each can render now (ADR 0007, decision 7). */
+function CaptureTargetsCard(props) {
+	const { targets } = props;
+	return /* @__PURE__ */ jsxs(Card, { children: [
+		/* @__PURE__ */ jsx(SectionTitle, { children: "Capture browsers" }),
+		/* @__PURE__ */ jsx(Meta, { children: "What the capture runner offers, default first. A project can only pick a target that is ready; a declared engine that is not installed is listed with the reason." }),
+		/* @__PURE__ */ jsx(Table, { children: /* @__PURE__ */ jsxs("table", { children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
+			/* @__PURE__ */ jsx("th", { children: "Target" }),
+			/* @__PURE__ */ jsx("th", { children: "Reaches Storybook" }),
+			/* @__PURE__ */ jsx("th", { children: "Status" })
+		] }) }), /* @__PURE__ */ jsx("tbody", { children: targets.map((entry, index) => {
+			const reason = unavailableReason(entry.status);
+			return /* @__PURE__ */ jsxs("tr", { children: [
+				/* @__PURE__ */ jsxs("td", { children: [
+					/* @__PURE__ */ jsx("strong", { children: targetLabel(entry.target) }),
+					" ",
+					/* @__PURE__ */ jsx(Meta, {
+						as: "span",
+						mono: true,
+						children: entry.target
+					}),
+					index === 0 ? /* @__PURE__ */ jsx(Badge, { children: "default" }) : null
+				] }),
+				/* @__PURE__ */ jsx("td", { children: /* @__PURE__ */ jsx(Meta, {
+					as: "span",
+					children: entry.reach === "url" ? "signed URL" : "local server"
+				}) }),
+				/* @__PURE__ */ jsxs("td", { children: [/* @__PURE__ */ jsx(Badge, {
+					tone: reason === null ? "success" : "danger",
+					icon: true,
+					children: reason === null ? "ready" : "unavailable"
+				}), reason === null ? null : /* @__PURE__ */ jsx(Meta, {
+					as: "div",
+					children: reason
+				})] })
+			] }, entry.target);
+		}) })] }) })
+	] });
+}
+//#endregion
+export { CaptureTargetsCard };
+
+//# sourceMappingURL=admin-system-targets.mjs.map

package/dist/pages/admin-system-targets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-system-targets.mjs","names":[],"sources":["../../src/pages/admin-system-targets.tsx"],"sourcesContent":["import { unavailableReason, type RunnerTarget } from \"@storyshelf/core/adapter/capture-runner\";\nimport type { HtmlEscapedString } from \"hono/utils/html\";\nimport { targetLabel } from \"../targets.ts\";\nimport { Badge, Card, Meta, SectionTitle, Table } from \"../ui/components.tsx\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\n/** The browsers the capture runner offers and whether each can render now (ADR 0007, decision 7). */\nexport function CaptureTargetsCard(props: {\n  targets: readonly RunnerTarget[];\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  const { targets } = props;\n  return (\n    <Card>\n      <SectionTitle>Capture browsers</SectionTitle>\n      <Meta>\n        What the capture runner offers, default first. A project can only pick a target that is\n        ready; a declared engine that is not installed is listed with the reason.\n      </Meta>\n      <Table>\n        <table>\n          <thead>\n            <tr>\n              <th>Target</th>\n              <th>Reaches Storybook</th>\n              <th>Status</th>\n            </tr>\n          </thead>\n          <tbody>\n            {targets.map((entry, index) => {\n              const reason = unavailableReason(entry.status);\n              return (\n                <tr key={entry.target}>\n                  <td>\n                    <strong>{targetLabel(entry.target)}</strong>{\" \"}\n                    <Meta as=\"span\" mono>\n                      {entry.target}\n                    </Meta>\n                    {index === 0 ? <Badge>default</Badge> : null}\n                  </td>\n                  <td>\n                    <Meta as=\"span\">{entry.reach === \"url\" ? \"signed URL\" : \"local server\"}</Meta>\n                  </td>\n                  <td>\n                    <Badge tone={reason === null ? \"success\" : \"danger\"} icon>\n                      {reason === null ? \"ready\" : \"unavailable\"}\n                    </Badge>\n                    {reason === null ? null : <Meta as=\"div\">{reason}</Meta>}\n                  </td>\n                </tr>\n              );\n            })}\n          </tbody>\n        </table>\n      </Table>\n    </Card>\n  );\n}\n"],"mappings":";;;;;;;;;;;AAQA,SAAgB,mBAAmB,OAEgB;CACjD,MAAM,EAAE,YAAY;CACpB,OACE,qBAAC,MAAD,EAAA,UAAA;EACE,oBAAC,cAAD,EAAA,UAAc,mBAA8B,CAAA;EAC5C,oBAAC,MAAD,EAAA,UAAM,oKAGA,CAAA;EACN,oBAAC,OAAD,EAAA,UACE,qBAAC,SAAD,EAAA,UAAA,CACE,oBAAC,SAAD,EAAA,UACE,qBAAC,MAAD,EAAA,UAAA;GACE,oBAAC,MAAD,EAAA,UAAI,SAAU,CAAA;GACd,oBAAC,MAAD,EAAA,UAAI,oBAAqB,CAAA;GACzB,oBAAC,MAAD,EAAA,UAAI,SAAU,CAAA;EACZ,EAAA,CAAA,EACC,CAAA,GACP,oBAAC,SAAD,EAAA,UACG,QAAQ,KAAK,OAAO,UAAU;GAC7B,MAAM,SAAS,kBAAkB,MAAM,MAAM;GAC7C,OACE,qBAAC,MAAD,EAAA,UAAA;IACE,qBAAC,MAAD,EAAA,UAAA;KACE,oBAAC,UAAD,EAAA,UAAS,YAAY,MAAM,MAAM,EAAU,CAAA;KAAE;KAC7C,oBAAC,MAAD;MAAM,IAAG;MAAO,MAAA;MACb,UAAA,MAAM;KACH,CAAA;KACL,UAAU,IAAI,oBAAC,OAAD,EAAA,UAAO,UAAc,CAAA,IAAI;IACtC,EAAA,CAAA;IACJ,oBAAC,MAAD,EAAA,UACE,oBAAC,MAAD;KAAM,IAAG;KAAQ,UAAA,MAAM,UAAU,QAAQ,eAAe;IAAqB,CAAA,EAC3E,CAAA;IACJ,qBAAC,MAAD,EAAA,UAAA,CACE,oBAAC,OAAD;KAAO,MAAM,WAAW,OAAO,YAAY;KAAU,MAAA;KAClD,UAAA,WAAW,OAAO,UAAU;IACxB,CAAA,GACN,WAAW,OAAO,OAAO,oBAAC,MAAD;KAAM,IAAG;KAAO,UAAA;IAAa,CAAA,CACrD,EAAA,CAAA;GACF,EAAA,GAjBK,MAAM,MAiBX;EAER,CAAC,EACI,CAAA,CACF,EAAA,CAAA,EACF,CAAA;CACH,EAAA,CAAA;AAEV"}

package/dist/pages/admin-system.mjs

@@ -8,6 +8,9 @@ import { HStack } from "../ui/stacks.mjs";
 import { Table } from "../ui/table.mjs";
 import { csrfField } from "../ui/csrf-field.mjs";
 import { DocumentLayout } from "../ui/document.mjs";
+import { PublicOriginCard } from "./admin-system-origin.mjs";
+import { CaptureTargetsCard } from "./admin-system-targets.mjs";
+import { NotificationsPausedNotice } from "./notifications-paused.mjs";
 import { Fragment, jsx, jsxs } from "hono/jsx/jsx-runtime";
 //#region src/pages/admin-system.tsx
 function healthTone(state) {
@@ -90,9 +93,27 @@ function AdapterTable(props) {
 		/* @__PURE__ */ jsx("th", { children: "Detail" })
 	] }) }), /* @__PURE__ */ jsx("tbody", { children: report.adapters.map((adapter) => /* @__PURE__ */ jsx(AdapterRow, { adapter }, `${adapter.category}/${adapter.kind}`)) })] }) });
 }
+/** Detected hardware and the capture concurrency it yields (auto unless configured). */
+function CaptureSizing(props) {
+	const { cpus, memoryMb, builds, pages } = props.capture;
+	return /* @__PURE__ */ jsxs(Meta, { children: [
+		"Capture host ",
+		cpus,
+		" CPU · ",
+		memoryMb,
+		" MB · builds at once ",
+		builds.value,
+		builds.auto ? " (auto)" : " (configured)",
+		" · pages per build ",
+		pages.start,
+		"–",
+		pages.max,
+		" (auto, adapts to load unless the runner pins it)"
+	] });
+}
 /** Non-secret server facts (never secret, admin token, or credentials). */
 function ServerFacts(props) {
-	const { report, authEnabled, config, authMethods } = props;
+	const { report, authEnabled, config, authMethods, capture } = props.data;
 	return /* @__PURE__ */ jsxs(Card, { children: [
 		/* @__PURE__ */ jsx(SectionTitle, { children: "Server" }),
 		/* @__PURE__ */ jsxs("div", {
@@ -115,9 +136,6 @@ function ServerFacts(props) {
 		/* @__PURE__ */ jsxs(Meta, { children: [
 			"Auth ",
 			authEnabled ? "enabled" : "disabled — all operations permitted",
-			" · Capture concurrency",
-			" ",
-			formatOptional(config.captureConcurrency),
 			" · Purge TTL",
 			" ",
 			formatOptional(config.purgeTtlDays),
@@ -126,6 +144,7 @@ function ServerFacts(props) {
 			config.branchTtlDays === null ? "disabled" : `${formatOptional(config.branchTtlDays)} days`
 		] }),
 		authMethods && authMethods.length > 0 ? /* @__PURE__ */ jsx(HStack, { children: authMethods.map((method) => /* @__PURE__ */ jsx(Badge, { children: method }, method)) }) : null,
+		capture ? /* @__PURE__ */ jsx(CaptureSizing, { capture }) : null,
 		/* @__PURE__ */ jsxs(Meta, { children: [
 			"Scratch dir ",
 			formatOptional(config.scratchDir),
@@ -188,9 +207,37 @@ function CredentialsCard(props) {
 		}) : /* @__PURE__ */ jsx(Meta, { children: rotating ? "All credentials use the current secret. Remove SECRET_PREVIOUS." : "To rotate, set SECRET to the new value and SECRET_PREVIOUS to the old one." })
 	] });
 }
+/** Notice that `testing` is off, so a misconfigured instance in a fleet is visible (ADR 0006). */
+function HostingOnlyNotice(props) {
+	const { hiddenSnapshots } = props;
+	return /* @__PURE__ */ jsx("div", {
+		class: "mt-1",
+		children: /* @__PURE__ */ jsxs(Alert, {
+			tone: "info",
+			title: "Testing is off: Storybook hosting only",
+			children: [
+				"This instance publishes and serves Storybooks, but does not capture, compare or keep baselines, and no testing status is posted. Set the ",
+				/* @__PURE__ */ jsx("code", { children: "testing" }),
+				" option to turn testing on.",
+				hiddenSnapshots > 0 ? ` ${hiddenSnapshots} existing snapshot(s) are hidden, not deleted, and reappear when testing is turned on.` : ""
+			]
+		})
+	});
+}
+/** The public origin and the capture browsers (ADR 0007), when the instance has them. */
+function CaptureCards(props) {
+	const { publicOrigin, targets } = props.data;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [publicOrigin ? /* @__PURE__ */ jsx("div", {
+		class: "mt-1",
+		children: /* @__PURE__ */ jsx(PublicOriginCard, { origin: publicOrigin })
+	}) : null, targets && targets.length > 0 ? /* @__PURE__ */ jsx("div", {
+		class: "mt-1",
+		children: /* @__PURE__ */ jsx(CaptureTargetsCard, { targets })
+	}) : null] });
+}
 /** Site-admin System page: adapter inventory with in-depth health. */
 function renderAdminSystemPage(data) {
-	const { report, authEnabled, config, authMethods, credentials } = data;
+	const { report, config, credentials } = data;
 	return /* @__PURE__ */ jsxs(DocumentLayout, {
 		title: "System",
 		nav: { active: "admin" },
@@ -206,19 +253,22 @@ function renderAdminSystemPage(data) {
 					" ",
 					formatUptime(report.uptimeSecs)
 				] }),
-				actions: /* @__PURE__ */ jsx(Button, {
+				actions: /* @__PURE__ */ jsxs(HStack, { children: [data.aiEnabled ? /* @__PURE__ */ jsx(Button, {
+					variant: "secondary",
+					size: "sm",
+					href: "/admin/ai",
+					children: "AI usage"
+				}) : null, /* @__PURE__ */ jsx(Button, {
 					variant: "secondary",
 					size: "sm",
 					href: "/admin",
 					children: "Recheck"
-				})
-			}),
-			/* @__PURE__ */ jsx(ServerFacts, {
-				report,
-				authEnabled,
-				config,
-				authMethods
+				})] })
 			}),
+			/* @__PURE__ */ jsx(NotificationsPausedNotice, { paused: data.notificationsPaused }),
+			data.testing === false ? /* @__PURE__ */ jsx(HostingOnlyNotice, { hiddenSnapshots: data.hiddenSnapshots ?? 0 }) : null,
+			/* @__PURE__ */ jsx(ServerFacts, { data }),
+			/* @__PURE__ */ jsx(CaptureCards, { data }),
 			credentials ? /* @__PURE__ */ jsx("div", {
 				class: "mt-1",
 				children: /* @__PURE__ */ jsx(CredentialsCard, {