@storyshelf/app 0.7.0 → 0.9.0-next-d2cc082

package/dist/app-types.d.mts

@@ -5,11 +5,10 @@ import { AdapterSetupResult } from "@storyshelf/core/adapter/setup";
 import { ShelfConfig, UIConfig } from "@storyshelf/core/config";
 import { NotifierProvider } from "@storyshelf/core/adapter/notifier";
 import { AuthUser } from "@storyshelf/core/types";
+import { DatabaseAdapter } from "@storyshelf/core/adapter/database";
 import { Logger, createShelfLogger } from "@storyshelf/core/logger";
 import { CaptureQueue } from "@storyshelf/core/adapter/capture-queue";
-import { DatabaseAdapter } from "@storyshelf/core/adapter/database";
 import { StorageAdapter } from "@storyshelf/core/adapter/storage";
-//#region src/app-types.d.ts
 /** Per-request shelf context (adapters, config, user, capture queue). */
 interface ShelfContext {
   requestId?: string;
@@ -47,6 +46,5 @@ interface ShelfLifecycle {
 type ShelfApp = ShelfRouter & {
   readonly lifecycle: ShelfLifecycle;
 };
-//#endregion
 export { ShelfApp, ShelfContext, ShelfLifecycle, ShelfRouter };
 //# sourceMappingURL=app-types.d.mts.map

package/dist/asset-manifest.mjs

@@ -5,7 +5,7 @@ import { contentHash, iconSprite, iconSpriteHash, iconSpriteHref } from "./ui/ic
 import { htmxSource } from "./assets/htmx.mjs";
 import { markSource } from "./assets/mark.mjs";
 import { clientScript } from "./ui/shell/client-script.mjs";
-//#region src/asset-manifest.ts
+// src/asset-manifest.ts
 /**
 * Static assets with content-addressed URLs. A URL that embeds the content
 * hash may be cached forever (`immutable`): changing the file changes the
@@ -43,7 +43,6 @@ const assetManifest = {
 		href: `/assets/mark-${markHash}.svg`
 	}
 };
-//#endregion
 export { assetManifest };
 
 //# sourceMappingURL=asset-manifest.mjs.map

package/dist/assets/htmx.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/assets/htmx.ts
+// src/assets/htmx.ts
 const htmxSource = String.raw`(function (e, t) {
   if (typeof define === "function" && define.amd) {
     define([], t);
@@ -3307,7 +3307,6 @@ const htmxSource = String.raw`(function (e, t) {
   })();
 });
 `;
-//#endregion
 export { htmxSource };
 
 //# sourceMappingURL=htmx.mjs.map

package/dist/assets/mark.mjs

@@ -1,10 +1,9 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/assets/mark.ts
+// src/assets/mark.ts
 /** The StoryShelf brand mark (an SVG): the favicon and the default sidebar logo. */
 const markSource = String.raw`<svg xmlns='http://www.w3.org/2000/svg' width='64' height='64' viewBox='0 0 64 64' role='img' aria-label='StoryShelf'><rect width='64' height='64' rx='14' fill='#1d5fcf'/><path d='M15 11 H49 A4 4 0 0 1 53 15 V15 A2 2 0 0 1 51 17 H13 A2 2 0 0 1 11 15 V15 A4 4 0 0 1 15 11 Z' fill='#ffffff'/><path d='M13 29 H51 A2 2 0 0 1 53 31 V33 A2 2 0 0 1 51 35 H13 A2 2 0 0 1 11 33 V31 A2 2 0 0 1 13 29 Z' fill='#ffffff'/><path d='M13 47 H51 A2 2 0 0 1 53 49 V49 A4 4 0 0 1 49 53 H15 A4 4 0 0 1 11 49 V49 A2 2 0 0 1 13 47 Z' fill='#ffffff'/><path d='M16 19 H16 A2 2 0 0 1 18 21 V27 A2 2 0 0 1 16 29 H16 A2 2 0 0 1 14 27 V21 A2 2 0 0 1 16 19 Z' fill='#ffffff'/><path d='M22 21 H22 A2 2 0 0 1 24 23 V27 A2 2 0 0 1 22 29 H22 A2 2 0 0 1 20 27 V23 A2 2 0 0 1 22 21 Z' fill='#ffffff'/><path d='M28 23 H28 A2 2 0 0 1 30 25 V27 A2 2 0 0 1 28 29 H28 A2 2 0 0 1 26 27 V25 A2 2 0 0 1 28 23 Z' fill='#ffffff'/><path d='M48 37 H48 A2 2 0 0 1 50 39 V45 A2 2 0 0 1 48 47 H48 A2 2 0 0 1 46 45 V39 A2 2 0 0 1 48 37 Z' fill='#ffffff'/><path d='M42 39 H42 A2 2 0 0 1 44 41 V45 A2 2 0 0 1 42 47 H42 A2 2 0 0 1 40 45 V41 A2 2 0 0 1 42 39 Z' fill='#ffffff'/><path d='M36 41 H36 A2 2 0 0 1 38 43 V45 A2 2 0 0 1 36 47 H36 A2 2 0 0 1 34 45 V43 A2 2 0 0 1 36 41 Z' fill='#ffffff'/></svg>`;
-//#endregion
 export { markSource };
 
 //# sourceMappingURL=mark.mjs.map

package/dist/boot-tasks.mjs

@@ -6,7 +6,7 @@ import { startConsumer, trackBackground } from "./lifecycle.mjs";
 import { checkCredentialsAfterSetup } from "./credentials.mjs";
 import { logHostingOnlyMode } from "./hidden-data.mjs";
 import { requestOpenBuildStates, sweepOrphanedScratch } from "@storyshelf/core/capture";
-//#region src/boot-tasks.ts
+// src/boot-tasks.ts
 /**
 * Boot-time work that runs once adapters are ready: the job consumer starts (there is no boot sweep
 * of builds left `capturing`: leases expire and jobs are redelivered, so a second instance can
@@ -74,7 +74,6 @@ function sweepScratchOnBoot(cell, scratchDir, logger) {
 		logger.warn({ err: error }, "scratch sweep failed");
 	}));
 }
-//#endregion
 export { runBootTasks };
 
 //# sourceMappingURL=boot-tasks.mjs.map

package/dist/build-state-flags.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/build-state-flags.ts
+// src/build-state-flags.ts
 /**
 * What decides which statuses a project's builds show: the instance's `testing` and the project's
 * review switch (a row without the column, from a hand-built table, counts as on, the default).
@@ -12,7 +12,6 @@ function buildStateFlags(testing, project) {
 		review: project.reviewEnabled !== false
 	};
 }
-//#endregion
 export { buildStateFlags };
 
 //# sourceMappingURL=build-state-flags.mjs.map

package/dist/build-state-setup.mjs

@@ -6,7 +6,7 @@ import { notifySystemWith } from "./notify.mjs";
 import { buildStateFlags } from "./build-state-flags.mjs";
 import { createBuildStatePublisher, createNotifyEnqueuer, createNotifyHandler, notifyExhausted } from "@storyshelf/core/capture";
 import { ProjectModel } from "@storyshelf/core/models";
-//#region src/build-state-setup.ts
+// src/build-state-setup.ts
 /**
 * Build-state wiring (ADR 0014, decisions 5 and 7): the publisher every build transition calls and
 * the `notify` job kind behind it. On a host that polls the queue, a transition queues one durable
@@ -69,7 +69,6 @@ async function alertAdmins(options, runtime, failure) {
 		message: `${failure.provider} channel of ${project?.slug ?? "a project"} could not show build ${failure.buildId}: ${failure.error}`
 	});
 }
-//#endregion
 export { setupBuildState };
 
 //# sourceMappingURL=build-state-setup.mjs.map

package/dist/capture-alerts.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { notifyProjectWith, notifySystemWith } from "./notify.mjs";
 import { BuildModel, ProjectModel } from "@storyshelf/core/models";
-//#region src/capture-alerts.ts
+// src/capture-alerts.ts
 /**
 * Builds already alerted about, keyed by the build's last update. A sharded build settles one job
 * per shard and every one of them sees the failed build; only the first alerts. A retry rewrites
@@ -40,7 +40,6 @@ async function notifyCaptureFailed(options, config, logger, buildId, publicOrigi
 		status: "failed"
 	}, `/builds/${buildId}`);
 }
-//#endregion
 export { alreadyAlerted, notifyCaptureFailed };
 
 //# sourceMappingURL=capture-alerts.mjs.map

package/dist/capture-process.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { DIFF_WORKERS_ENV, IMAGE_ENGINE_ENV } from "@storyshelf/core/diff";
 import { detectResources } from "@storyshelf/core/utils";
 import { CAPTURE_RETRIES_ENV, CAPTURE_SHARD_SIZE_ENV, canForkCaptureChild, createForkedCaptureHandler, decideCaptureProcess, forkCaptureChild } from "@storyshelf/core/capture";
-//#region src/capture-process.ts
+// src/capture-process.ts
 /** Chooses between in-process and forked capture, and builds the forked handler. */
 /**
 * Whether to fork a capture child. `mode: "fork"` forces it (and fails if it cannot); `auto` forks
@@ -53,7 +53,6 @@ function createForkedHandler(deps) {
 		logger: deps.logger
 	});
 }
-//#endregion
 export { childEnvOf, createForkedHandler, shouldForkCapture };
 
 //# sourceMappingURL=capture-process.mjs.map

package/dist/capture-setup.mjs

@@ -7,7 +7,7 @@ import { createForkedHandler, shouldForkCapture } from "./capture-process.mjs";
 import { DEFAULT_SCRATCH_DIR } from "@storyshelf/core/config";
 import { currentTraceparent } from "@storyshelf/observability";
 import { DEFAULT_RETRIES, captureDispatchDeps, createCaptureHandler, failCrashedCapture, isFinalAttempt } from "@storyshelf/core/capture";
-//#region src/capture-setup.ts
+// src/capture-setup.ts
 /** Queue a build, continuing the active request trace when present. */
 function enqueuerFor(queue) {
 	return async (buildId, reqId) => {
@@ -111,7 +111,6 @@ function alerting(inner, retries, alert) {
 		...inner.close ? { close: inner.close } : {}
 	};
 }
-//#endregion
 export { setupCapture };
 
 //# sourceMappingURL=capture-setup.mjs.map

package/dist/connections.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { credentialKeys } from "./credential-keys.mjs";
 import { getStore } from "./store.mjs";
 import { ConnectionModel } from "@storyshelf/core/models";
-//#region src/connections.ts
+// src/connections.ts
 /**
 * Services a user can connect their own account to. Today only design providers
 * offer OAuth; a future issue-tracker or notifier adapter that exposes
@@ -28,7 +28,6 @@ function canConnect() {
 	const { authEnabled, user, config } = getStore();
 	return authEnabled && Boolean(user) && Boolean(config.secret);
 }
-//#endregion
 export { canConnect, connectableServices, connectionModel, findConnectable };
 
 //# sourceMappingURL=connections.mjs.map

package/dist/consumer-setup.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { captureMetrics } from "@storyshelf/observability";
 import { createCaptureConsumer } from "@storyshelf/core/capture";
-//#region src/consumer-setup.ts
+// src/consumer-setup.ts
 /**
 * The consumer of the app's queues (ADR 0006, decision 5): built when first started, so a host
 * that never starts one never touches the queue, and drained as a unit on teardown.
@@ -52,7 +52,6 @@ function jobMetrics() {
 		else if (event.outcome === "failed") instruments.jobsFailed.add(1, attributes);
 	} };
 }
-//#endregion
 export { combineConsumers, jobMetrics, lazyConsumer };
 
 //# sourceMappingURL=consumer-setup.mjs.map

package/dist/credential-keys.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/credential-keys.ts
+// src/credential-keys.ts
 /**
 * Key material for encrypted credentials: the current secret, plus
 * `previousSecret` as a decrypt-only fallback during a rotation. Not for
@@ -14,7 +14,6 @@ function credentialKeys(config) {
 	};
 	return config.secret;
 }
-//#endregion
 export { credentialKeys };
 
 //# sourceMappingURL=credential-keys.mjs.map

package/dist/credentials.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { trackBackground } from "./lifecycle.mjs";
 import { probeCredentials, reencryptCredentials } from "@storyshelf/core/models";
-//#region src/credentials.ts
+// src/credentials.ts
 /** Current/previous key pair for a probe, or null when no secret is configured. */
 function secretKeysOf(config) {
 	if (!config.secret) return null;
@@ -51,7 +51,6 @@ function checkCredentialsAfterSetup(cell, db, config, logger) {
 		logger.error({ err: error }, "credential check failed");
 	}));
 }
-//#endregion
 export { checkCredentialsAfterSetup, checkCredentialsAtBoot, loadCredentialProbe, reencryptWithCurrent, secretKeysOf };
 
 //# sourceMappingURL=credentials.mjs.map

package/dist/design-events.mjs

@@ -0,0 +1,71 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { credentialKeys } from "./credential-keys.mjs";
+import { clearPaused, notificationOrigin, warnPaused } from "./notifications-pause.mjs";
+import { notifyProjectWith } from "./notify.mjs";
+import { designChange } from "@storyshelf/core/models";
+import { emitWebhookEvent } from "@storyshelf/core/adapter/webhook-events";
+import { createUrlBuilder } from "@storyshelf/core/urls";
+// src/design-events.ts
+/**
+* `design:changed`: a design moved after its baseline was approved, or no longer exists. It rides
+* the existing paths (signed webhooks and the notification fan-out) and is a normal subscribable
+* topic: it is not default-on (see `notify.ts`), so only people who opted in hear about it.
+*
+* Sent once per (project, design node, design version) from the first health check that sees the
+* change. The durable claim is `DesignNodeModel.claimChange`; with no confirmed public origin
+* nothing is sent and nothing is claimed, so the change is still announced once an origin exists.
+* There is no boot replay: an unannounced change waits for the next health check.
+*/
+/** Event name of a design change. */
+const DESIGN_CHANGED_EVENT = "design:changed";
+/**
+* Announce every observed design change not announced before. Never throws: a failure is logged
+* and the next health check tries again.
+*/
+async function announceDesignChangesWith(deps, nodes, project, observations) {
+	const changes = observations.flatMap((observation) => {
+		const change = observation.componentPath ? designChange(observation.node, observation.baselineVersion) : null;
+		return observation.node && observation.componentPath && change ? [{
+			...observation,
+			node: observation.node,
+			componentPath: observation.componentPath,
+			change
+		}] : [];
+	});
+	if (changes.length === 0 || !await originConfirmed(deps)) return;
+	await Promise.all(changes.map(async (item) => {
+		try {
+			if (await nodes.claimChange(item.node, item.change)) await announce(deps, project, item);
+		} catch (error) {
+			deps.logger.warn({
+				err: error,
+				projectId: project.id
+			}, "design change not announced");
+		}
+	}));
+}
+async function originConfirmed(deps) {
+	if (await notificationOrigin(deps) === void 0) {
+		warnPaused(deps.logger, DESIGN_CHANGED_EVENT);
+		return false;
+	}
+	clearPaused(deps.logger);
+	return true;
+}
+async function announce(deps, project, item) {
+	const data = {
+		projectId: project.id,
+		componentPath: item.componentPath,
+		figmaUrl: item.url,
+		change: item.change.change,
+		designVersion: item.change.designVersion
+	};
+	await emitWebhookEvent(deps.db, { webhooks: deps.db.tables.webhooks }, project.id, DESIGN_CHANGED_EVENT, data, credentialKeys(deps.config), deps.logger);
+	const component = createUrlBuilder("").component(project.slug, item.componentPath);
+	await notifyProjectWith(deps, project, DESIGN_CHANGED_EVENT, data, component.slice(`/projects/${project.slug}`.length));
+}
+export { DESIGN_CHANGED_EVENT, announceDesignChangesWith };
+
+//# sourceMappingURL=design-events.mjs.map

package/dist/design-events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-events.mjs","names":[],"sources":["../src/design-events.ts"],"sourcesContent":["/**\n * `design:changed`: a design moved after its baseline was approved, or no longer exists. It rides\n * the existing paths (signed webhooks and the notification fan-out) and is a normal subscribable\n * topic: it is not default-on (see `notify.ts`), so only people who opted in hear about it.\n *\n * Sent once per (project, design node, design version) from the first health check that sees the\n * change. The durable claim is `DesignNodeModel.claimChange`; with no confirmed public origin\n * nothing is sent and nothing is claimed, so the change is still announced once an origin exists.\n * There is no boot replay: an unannounced change waits for the next health check.\n */\nimport { emitWebhookEvent } from \"@storyshelf/core/adapter/webhook-events\";\nimport { designChange, type DesignChange, type DesignNodeModel } from \"@storyshelf/core/models\";\nimport type { DesignNode, Project } from \"@storyshelf/core/schema\";\nimport { createUrlBuilder } from \"@storyshelf/core/urls\";\nimport { credentialKeys } from \"./credential-keys.ts\";\nimport { clearPaused, notificationOrigin, warnPaused } from \"./notifications-pause.ts\";\nimport { notifyProjectWith, type NotifyDeps } from \"./notify.ts\";\n\n/** Event name of a design change. */\nexport const DESIGN_CHANGED_EVENT = \"design:changed\";\n\n/** What `design:changed` carries. */\nexport interface DesignChangedData extends Record<string, unknown> {\n  projectId: string;\n  /** Story file (the component) whose design changed. */\n  componentPath: string;\n  figmaUrl: string;\n  change: DesignChange[\"change\"];\n  designVersion: string | null;\n}\n\n/** One design a health check looked at. */\nexport interface DesignObservation {\n  url: string;\n  node: DesignNode | undefined;\n  /** The component (story file) the design belongs to. */\n  componentPath: string | null;\n  /** Version of the baseline the component was approved at. */\n  baselineVersion: string | null;\n}\n\n/**\n * Announce every observed design change not announced before. Never throws: a failure is logged\n * and the next health check tries again.\n */\nexport async function announceDesignChangesWith(\n  deps: NotifyDeps,\n  nodes: Pick<DesignNodeModel, \"claimChange\">,\n  project: Pick<Project, \"id\" | \"slug\">,\n  observations: readonly DesignObservation[],\n): Promise<void> {\n  const changes = observations.flatMap((observation) => {\n    const change = observation.componentPath\n      ? designChange(observation.node, observation.baselineVersion)\n      : null;\n    return observation.node && observation.componentPath && change\n      ? [\n          {\n            ...observation,\n            node: observation.node,\n            componentPath: observation.componentPath,\n            change,\n          },\n        ]\n      : [];\n  });\n  if (changes.length === 0 || !(await originConfirmed(deps))) return;\n  await Promise.all(\n    changes.map(async (item) => {\n      try {\n        if (await nodes.claimChange(item.node, item.change)) await announce(deps, project, item);\n      } catch (error) {\n        deps.logger.warn({ err: error, projectId: project.id }, \"design change not announced\");\n      }\n    }),\n  );\n}\n\nasync function originConfirmed(deps: NotifyDeps): Promise<boolean> {\n  const origin = await notificationOrigin(deps);\n  if (origin === undefined) {\n    warnPaused(deps.logger, DESIGN_CHANGED_EVENT);\n    return false;\n  }\n  clearPaused(deps.logger);\n  return true;\n}\n\nasync function announce(\n  deps: NotifyDeps,\n  project: Pick<Project, \"id\" | \"slug\">,\n  item: { url: string; componentPath: string; change: DesignChange },\n): Promise<void> {\n  const data: DesignChangedData = {\n    projectId: project.id,\n    componentPath: item.componentPath,\n    figmaUrl: item.url,\n    change: item.change.change,\n    designVersion: item.change.designVersion,\n  };\n  await emitWebhookEvent(\n    deps.db,\n    { webhooks: deps.db.tables.webhooks },\n    project.id,\n    DESIGN_CHANGED_EVENT,\n    data,\n    credentialKeys(deps.config),\n    deps.logger,\n  );\n  const component = createUrlBuilder(\"\").component(project.slug, item.componentPath);\n  await notifyProjectWith(\n    deps,\n    project,\n    DESIGN_CHANGED_EVENT,\n    data,\n    component.slice(`/projects/${project.slug}`.length),\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,uBAAuB;;;;;AA0BpC,eAAsB,0BACpB,MACA,OACA,SACA,cACe;CACf,MAAM,UAAU,aAAa,SAAS,gBAAgB;EACpD,MAAM,SAAS,YAAY,gBACvB,aAAa,YAAY,MAAM,YAAY,eAAe,IAC1D;EACJ,OAAO,YAAY,QAAQ,YAAY,iBAAiB,SACpD,CACE;GACE,GAAG;GACH,MAAM,YAAY;GAClB,eAAe,YAAY;GAC3B;EACF,CACF,IACA,CAAC;CACP,CAAC;CACD,IAAI,QAAQ,WAAW,KAAK,CAAE,MAAM,gBAAgB,IAAI,GAAI;CAC5D,MAAM,QAAQ,IACZ,QAAQ,IAAI,OAAO,SAAS;EAC1B,IAAI;GACF,IAAI,MAAM,MAAM,YAAY,KAAK,MAAM,KAAK,MAAM,GAAG,MAAM,SAAS,MAAM,SAAS,IAAI;EACzF,SAAS,OAAO;GACd,KAAK,OAAO,KAAK;IAAE,KAAK;IAAO,WAAW,QAAQ;GAAG,GAAG,6BAA6B;EACvF;CACF,CAAC,CACH;AACF;AAEA,eAAe,gBAAgB,MAAoC;CAEjE,IAAI,MADiB,mBAAmB,IAAI,MAC7B,KAAA,GAAW;EACxB,WAAW,KAAK,QAAQ,oBAAoB;EAC5C,OAAO;CACT;CACA,YAAY,KAAK,MAAM;CACvB,OAAO;AACT;AAEA,eAAe,SACb,MACA,SACA,MACe;CACf,MAAM,OAA0B;EAC9B,WAAW,QAAQ;EACnB,eAAe,KAAK;EACpB,UAAU,KAAK;EACf,QAAQ,KAAK,OAAO;EACpB,eAAe,KAAK,OAAO;CAC7B;CACA,MAAM,iBACJ,KAAK,IACL,EAAE,UAAU,KAAK,GAAG,OAAO,SAAS,GACpC,QAAQ,IACR,sBACA,MACA,eAAe,KAAK,MAAM,GAC1B,KAAK,MACP;CACA,MAAM,YAAY,iBAAiB,EAAE,CAAC,CAAC,UAAU,QAAQ,MAAM,KAAK,aAAa;CACjF,MAAM,kBACJ,MACA,SACA,sBACA,MACA,UAAU,MAAM,aAAa,QAAQ,OAAO,MAAM,CACpD;AACF"}

package/dist/git-status.mjs

@@ -6,7 +6,7 @@ import { getStore } from "./store.mjs";
 import { notificationOrigin } from "./notifications-pause.mjs";
 import { buildStateFlags } from "./build-state-flags.mjs";
 import { createBuildStatePublisher, requestOpenBuildStates } from "@storyshelf/core/capture";
-//#region src/git-status.ts
+// src/git-status.ts
 /** Ask for a build's state to be shown on its project's git channels (ADR 0014, decision 5). */
 /**
 * Show the build's current state (commit statuses and the pull-request comment) on every git
@@ -40,7 +40,6 @@ function inlinePublisher(store) {
 		logger: store.logger
 	} });
 }
-//#endregion
 export { requestBuildState, requestOpenBuildStatesNow };
 
 //# sourceMappingURL=git-status.mjs.map

package/dist/hidden-data.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/hidden-data.ts
+// src/hidden-data.ts
 /**
 * Snapshots stored in the database. With `testing` off they are hidden, not deleted (ADR 0006,
 * decision 1): the System page and the startup log say how many.
@@ -18,7 +18,6 @@ async function logHostingOnlyMode(db, logger) {
 	}
 	logger.info("testing is off: hosting Storybooks only (no capture, compare or baselines)");
 }
-//#endregion
 export { countHiddenSnapshots, logHostingOnlyMode };
 
 //# sourceMappingURL=hidden-data.mjs.map

package/dist/index.d.mts

@@ -4,7 +4,6 @@ import { ShelfApp, ShelfContext, ShelfLifecycle, ShelfRouter } from "./app-types
 import { createAuthSystemHook } from "./notify.mjs";
 import { BrandTheme, NotificationsConfig, ShelfCompareOptions, ShelfConfig, ShelfNotificationsOptions, ShelfOptions, ShelfOptions as ShelfOptions$1, ShelfTestingOptions, UIConfig } from "@storyshelf/core/config";
 import { Logger, LoggerOptions, PinoTransport, createShelfLogger } from "@storyshelf/core/logger";
-//#region src/index.d.ts
 /**
  * Create the StoryShelf Hono app with all API routes and HTML pages.
  *
@@ -13,6 +12,5 @@ import { Logger, LoggerOptions, PinoTransport, createShelfLogger } from "@storys
  * fail-fast startup, or let the first request gate on settlement.
  */
 declare function createShelfApp(rawOptions: ShelfOptions$1): ShelfApp;
-//#endregion
 export { type BrandTheme, type Logger, type LoggerOptions, type NotificationsConfig, type PinoTransport, type ShelfApp, type ShelfCompareOptions, type ShelfConfig, type ShelfContext, type ShelfLifecycle, type ShelfNotificationsOptions, type ShelfOptions, type ShelfRouter, type ShelfTestingOptions, type UIConfig, createAuthSystemHook, createShelfApp, createShelfLogger };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -52,7 +52,7 @@ import { STORYBOOK_TOKEN_PREFIX } from "@storyshelf/core/utils";
 import { createHttpMiddleware, createInstrumentedDatabase, createInstrumentedStorage } from "@storyshelf/observability";
 import { requestId } from "hono/request-id";
 import { createShelfLogger } from "@storyshelf/core/logger";
-//#region src/index.tsx
+// src/index.tsx
 /**
 * StoryShelf app: compose database, storage, capture, auth, and notifier
 * adapters into a complete self-hosted visual-testing Hono app.
@@ -380,9 +380,8 @@ function registerDocs(app) {
 * from source (dev server, tests).
 */
 function packageVersion() {
-	return "0.7.0";
+	return "0.9.0-next-d2cc082";
 }
-//#endregion
 export { createAuthSystemHook, createShelfApp, createShelfLogger };
 
 //# sourceMappingURL=index.mjs.map

package/dist/insights/budget.mjs

@@ -5,7 +5,7 @@ import { notifySystemWith } from "../notify.mjs";
 import { failWith } from "./errors.mjs";
 import { AiBudgetAlertModel, AiUsageModel } from "@storyshelf/core/models";
 import { countedTokens, crossedThresholds, utcDay, utcDayStart } from "@storyshelf/core/insights";
-//#region src/insights/budget.ts
+// src/insights/budget.ts
 /** DB-counted budget: pre-flight limits, usage rows and threshold alerts. */
 const HOUR_MS = 36e5;
 /** Tokens counted so far today (UTC), summed across all instances from rows. */
@@ -43,7 +43,6 @@ async function recordUsage(deps, input) {
 		await fireAlerts(deps, crossedThresholds(before, after, dailyTokens), utcDay(now), after, dailyTokens);
 	}
 }
-//#endregion
 export { assertWithinBudget, dayTokens, recordUsage };
 
 //# sourceMappingURL=budget.mjs.map

package/dist/insights/deps.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { getStore } from "../store.mjs";
-//#region src/insights/deps.ts
+// src/insights/deps.ts
 /** Snapshot the current request store into explicit deps (null when AI is off). */
 function insightDepsFromStore() {
 	const store = getStore();
@@ -15,7 +15,6 @@ function insightDepsFromStore() {
 		notify: store
 	};
 }
-//#endregion
 export { insightDepsFromStore };
 
 //# sourceMappingURL=deps.mjs.map

package/dist/insights/errors.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { HTTPException } from "hono/http-exception";
-//#region src/insights/errors.ts
+// src/insights/errors.ts
 /** JSON errors for the insights API (`{ message }`, optional `Retry-After`). */
 /** Throw an HTTP error with a JSON `{ message }` body. */
 function failWith(status, message, retryAfterSeconds) {
@@ -16,7 +16,6 @@ function failWith(status, message, retryAfterSeconds) {
 		})
 	});
 }
-//#endregion
 export { failWith };
 
 //# sourceMappingURL=errors.mjs.map

package/dist/insights/health-panel.mjs

@@ -34,7 +34,6 @@ async function loadHealthBadge(project) {
 		score: scoreOf(toInsightView(row).output)
 	};
 }
-//#endregion
 export { loadHealthBadge, loadHealthPanel };
 
 //# sourceMappingURL=health-panel.mjs.map

package/dist/insights/job.mjs

@@ -5,7 +5,7 @@ import { notifyProjectWith } from "../notify.mjs";
 import { recordUsage } from "./budget.mjs";
 import { InsightModel } from "@storyshelf/core/models";
 import { AiError } from "@storyshelf/core/ai";
-//#region src/insights/job.ts
+// src/insights/job.ts
 /** Background insight job: summarize, record usage, persist the result, notify. */
 const running = /* @__PURE__ */ new Set();
 /** Wait for in-flight jobs (graceful teardown and tests). */
@@ -97,7 +97,6 @@ function spawnJob(deps, row, spec) {
 	});
 	running.add(promise);
 }
-//#endregion
 export { packResult, settleInsightJobs, spawnJob };
 
 //# sourceMappingURL=job.mjs.map

package/dist/insights/load-health.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { BuildModel, SnapshotModel } from "@storyshelf/core/models";
 import { buildHealthEvidence, resolveLimits, snapshotKey } from "@storyshelf/core/insights";
 import { modeSegment } from "@storyshelf/core/paths";
-//#region src/insights/load-health.ts
+// src/insights/load-health.ts
 /** Load project-health evidence: build aggregates plus the most churny stories. */
 const DAY_MS = 864e5;
 /** Parse windows like `30d` (1–365 days); null for anything else. */
@@ -53,7 +53,6 @@ async function loadHealthEvidence(deps, project, window, days) {
 		limits: resolveLimits(deps.ai.limits())
 	});
 }
-//#endregion
 export { loadHealthEvidence, parseWindow };
 
 //# sourceMappingURL=load-health.mjs.map

package/dist/insights/load-triage.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { CaptureAttemptModel, CaptureLogModel, CommentModel, SnapshotModel } from "@storyshelf/core/models";
 import { buildTriageEvidence, rankSnapshots, resolveLimits } from "@storyshelf/core/insights";
 import { modeSegment } from "@storyshelf/core/paths";
-//#region src/insights/load-triage.ts
+// src/insights/load-triage.ts
 /** Load triage evidence inputs (snapshots, logs, comments, thumbnails) and assemble them. */
 function storyIdOf(log) {
 	try {
@@ -92,7 +92,6 @@ async function loadTriageEvidence(deps, project, build) {
 		limits
 	});
 }
-//#endregion
 export { loadTriageEvidence };
 
 //# sourceMappingURL=load-triage.mjs.map

package/dist/insights/panel.mjs

@@ -8,7 +8,7 @@ import { APPROVER_ROLES } from "../routers/builds.handlers.mjs";
 import { freshen } from "./stale.mjs";
 import { toInsightView } from "./view.mjs";
 import { InsightModel } from "@storyshelf/core/models";
-//#region src/insights/panel.ts
+// src/insights/panel.ts
 /** Data for the build-review insight panel (null when AI is off for the project). */
 /** Load the panel for a build, or null when AI is off site-wide or for the project. */
 async function loadInsightPanel(project, build) {
@@ -22,7 +22,6 @@ async function loadInsightPanel(project, build) {
 		canGenerate: role !== null && APPROVER_ROLES.includes(role)
 	};
 }
-//#endregion
 export { loadInsightPanel };
 
 //# sourceMappingURL=panel.mjs.map

package/dist/insights/request.mjs

@@ -8,7 +8,7 @@ import { loadTriageEvidence } from "./load-triage.mjs";
 import { InsightModel } from "@storyshelf/core/models";
 import { HEALTH_SYSTEM, PROMPT_VERSION, TRIAGE_SYSTEM, computeInputHash, healthEnvelopeSchema, triageEnvelopeSchema } from "@storyshelf/core/insights";
 import { createHash } from "node:crypto";
-//#region src/insights/request.ts
+// src/insights/request.ts
 /** Request-side insight orchestration: evidence, hash, cache check, budget, spawn. */
 /** The profile a project uses: override, else its gate value (`default` = default profile). */
 function profileFor(deps, project, override) {
@@ -107,7 +107,6 @@ async function requestHealth(deps, project, window, options) {
 		});
 	});
 }
-//#endregion
 export { profileFor, requestHealth, requestTriage };
 
 //# sourceMappingURL=request.mjs.map

package/dist/insights/stale.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { InsightModel } from "@storyshelf/core/models";
 import { STALE_RUN_MS } from "@storyshelf/core/retention";
-//#region src/insights/stale.ts
+// src/insights/stale.ts
 /** Lazy interruption check: a run stuck past the stale window is failed on read. */
 /** Return the row, first marking it `interrupted` when it is stale and still in flight. */
 async function freshen(deps, row) {
@@ -15,7 +15,6 @@ async function freshen(deps, row) {
 		errorCode: "interrupted"
 	};
 }
-//#endregion
 export { freshen };
 
 //# sourceMappingURL=stale.mjs.map

package/dist/insights/usage-report.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { AiUsageModel } from "@storyshelf/core/models";
 import { countedTokens, utcDay } from "@storyshelf/core/insights";
-//#region src/insights/usage-report.ts
+// src/insights/usage-report.ts
 /** Aggregates for the site-admin AI usage page (counted tokens per day and profile). */
 const DAY_MS = 864e5;
 function addTo(map, key, make, tokens, failed) {
@@ -54,7 +54,6 @@ async function buildUsageReport(deps, windowDays = 14, now = /* @__PURE__ */ new
 		dailyTokens: dailyTokens ?? null
 	};
 }
-//#endregion
 export { buildUsageReport };
 
 //# sourceMappingURL=usage-report.mjs.map

package/dist/insights/view.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/insights/view.ts
+// src/insights/view.ts
 function parseResult(raw) {
 	if (!raw) return {
 		output: null,
@@ -42,7 +42,6 @@ function toInsightView(row) {
 		finishedAt: row.finishedAt
 	};
 }
-//#endregion
 export { toInsightView };
 
 //# sourceMappingURL=view.mjs.map

package/dist/job-canceller.mjs

@@ -1,14 +1,13 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/job-canceller.ts
+// src/job-canceller.ts
 /** Ask each queue that can cancel to cancel the build's jobs; a queue without `cancel` is skipped. */
 function createJobCanceller(queues) {
 	return async (buildId) => {
 		return (await Promise.all(queues.map(async (queue) => await queue?.cancel?.(buildId) ?? false))).some(Boolean);
 	};
 }
-//#endregion
 export { createJobCanceller };
 
 //# sourceMappingURL=job-canceller.mjs.map

package/dist/job-queue.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { DATABASE_QUEUE_METADATA, createDatabaseCaptureQueue } from "@storyshelf/core/capture";
-//#region src/job-queue.ts
+// src/job-queue.ts
 /**
 * Create the lazy queue polling `kinds`, with `retries` after a first failed attempt, the lease
 * of `testing.leaseSeconds` and the clock of `testing.queueClock` (production: real time).
@@ -45,7 +45,6 @@ function queueView(get) {
 		cancel: async (id) => await get().cancel(id)
 	};
 }
-//#endregion
 export { createJobQueue };
 
 //# sourceMappingURL=job-queue.mjs.map