@teamscala/service-boot 0.23.382 → 0.23.383

package/package.json

@@ -6,7 +6,7 @@
   },
   "name": "@teamscala/service-boot",
   "type": "module",
-  "version": "0.23.382",
+  "version": "0.23.383",
   "sideEffects": false,
   "imports": {
     "#service-boot/*": "./src/*",
@@ -190,6 +190,14 @@
       "types": "./src/content-gate/access.d.ts",
       "default": "./src/content-gate/access.ts"
     },
+    "./content-gate/catalog": {
+      "types": "./src/content-gate/catalog.d.ts",
+      "default": "./src/content-gate/catalog.ts"
+    },
+    "./content-gate/catalog.ts": {
+      "types": "./src/content-gate/catalog.d.ts",
+      "default": "./src/content-gate/catalog.ts"
+    },
     "./content-gate/config-types": {
       "types": "./src/content-gate/config-types.d.ts",
       "default": "./src/content-gate/config-types.ts"
@@ -722,6 +730,14 @@
       "types": "./src/register-registry-page-route/ai-chat-prefetch.d.ts",
       "default": "./src/register-registry-page-route/ai-chat-prefetch.ts"
     },
+    "./register-registry-page-route/captured-loader-config": {
+      "types": "./src/register-registry-page-route/captured-loader-config.d.ts",
+      "default": "./src/register-registry-page-route/captured-loader-config.ts"
+    },
+    "./register-registry-page-route/captured-loader-config.ts": {
+      "types": "./src/register-registry-page-route/captured-loader-config.d.ts",
+      "default": "./src/register-registry-page-route/captured-loader-config.ts"
+    },
     "./register-registry-page-route/graph-cache": {
       "types": "./src/register-registry-page-route/graph-cache.d.ts",
       "default": "./src/register-registry-page-route/graph-cache.ts"

package/src/register-registry-page-route/captured-loader-config.test.ts

@@ -0,0 +1,37 @@
+/**
+ * @system ui-service-boot
+ * @status handwritten
+ * @edit edit directly
+ *
+ * The boot log is the ONLY observable statement of what a running service
+ * captured from its resource_loader row (the 2026-08-18 evening-long bisect:
+ * a footer region added to the row never reached the booted process, and
+ * nothing anywhere said so). These tests pin the contract the line states —
+ * the captured source keys, the captured region slots, and the restart
+ * requirement — so the observability cannot silently regress to the old bare
+ * "registered route" line.
+ */
+import { describe, expect, test } from "bun:test";
+import { describeCapturedLoaderConfig } from "./captured-loader-config.ts";
+
+describe("describeCapturedLoaderConfig", () => {
+	test("names every captured source key and region slot, and states the restart contract", () => {
+		const line = describeCapturedLoaderConfig({
+			sources: [{ key: "brand" }, { key: "website" }, { key: "footer" }],
+			region_slots: ["header", "center", "footer"],
+		});
+		expect(line).toContain("brand");
+		expect(line).toContain("website");
+		expect(line).toContain("footer");
+		expect(line).toContain("header");
+		expect(line).toContain("center");
+		expect(line).toContain("captured at boot");
+		expect(line).toContain("restart");
+	});
+
+	test("an absent list renders as none, never an empty bracket pair", () => {
+		const line = describeCapturedLoaderConfig({ sources: [{ key: "page" }] });
+		expect(line).toContain("region_slots [none]");
+		expect(line).not.toContain("region_slots []");
+	});
+});

package/src/register-registry-page-route/captured-loader-config.ts

@@ -0,0 +1,29 @@
+/**
+ * @system ui-service-boot
+ * @status handwritten
+ * @edit edit directly
+ *
+ * Summarises the resource_loader config a route captured at boot, for the
+ * route-registration log line. Registration reads the loader row ONCE into
+ * the route closure, so an edit to the row silently does not reach the
+ * running service (measured 2026-08-18: a footer region added to a report
+ * produced no footer and no diagnostic until a cold wake). Naming the
+ * captured shape in the boot log makes the row-vs-running-service gap a
+ * one-glance check in the service logs, and the restart contract is stated
+ * where the operator will be looking when the edit "doesn't work".
+ */
+
+/** Structural slice of the ResourceLoaderConfigSchema output this unit reads. */
+interface LoaderConfigSlice {
+	sources?: { key: string }[];
+	region_slots?: string[];
+}
+
+export function describeCapturedLoaderConfig(
+	loaderConfig: LoaderConfigSlice,
+): string {
+	const sourceKeys =
+		loaderConfig.sources?.map((source) => source.key).join(", ") ?? "";
+	const regionSlots = loaderConfig.region_slots?.join(", ") ?? "";
+	return `captured at boot: sources [${sourceKeys || "none"}], region_slots [${regionSlots || "none"}] — resource_loader edits reach this service only after a restart`;
+}

package/src/register-registry-page-route/resolve-page-data.test.ts

@@ -0,0 +1,72 @@
+/**
+ * @system ui-service-boot
+ * @status handwritten
+ * @edit edit directly
+ *
+ * Regression test for the silent region-slot vanish (measured 2026-08-18): a
+ * region the operator declared in resource_loader.region_slots whose source
+ * did not resolve was skipped with no log, no error and no signal anywhere —
+ * the page rendered minus a region while every other suspect checked out.
+ * These tests pin the observable contract: the omission is LOGGED naming the
+ * slot, once per slot per process (hot path never spams), and the resolved
+ * regions still render every slot that did resolve.
+ */
+import { describe, expect, mock, test } from "bun:test";
+
+const warn = mock((_message: string) => {});
+mock.module("@teamscala/logger/app-loggers", () => ({
+	getAppLogger: () => ({ warn, info: () => {} }),
+}));
+mock.module("@teamscala/db/registry/load-config", () => ({
+	loadRegistryConfig: async () => ({}),
+}));
+mock.module("@teamscala/service-boot/page-server-orpc/server-client", () => ({
+	getServerClient: () => ({}),
+}));
+
+const { resolvedToPageData } = await import("./resolve-page-data.ts");
+
+const request = (): Request =>
+	new Request("https://portal.example.com/site/org/dashboard");
+
+function makeResolved(): Record<string, unknown> {
+	return {
+		website: { slug: "site", name: "Site" },
+		center: {
+			id: "p1",
+			name: "Dashboard",
+			puck_data: { root: { props: {} }, content: [] },
+		},
+	};
+}
+
+describe("resolvedToPageData — unresolved region slots are observable", () => {
+	test("a declared slot whose source did not resolve is omitted AND warned by name", () => {
+		const pageData = resolvedToPageData(
+			makeResolved(),
+			{},
+			request(),
+			undefined,
+			["center", "footer"],
+		) as { regions?: { slot: string }[] };
+		const slots = (pageData.regions ?? []).map((region) => region.slot);
+		expect(slots).toContain("center");
+		expect(slots).not.toContain("footer");
+		expect(warn.mock.calls.length).toBe(1);
+		const message = String(warn.mock.calls[0][0]);
+		expect(message).toContain("footer");
+		expect(message).toContain("no source resolved");
+	});
+
+	test("the warn throttles to once per slot per process", () => {
+		const before = warn.mock.calls.length;
+		resolvedToPageData(
+			makeResolved(),
+			{},
+			request(),
+			undefined,
+			["center", "footer"],
+		);
+		expect(warn.mock.calls.length).toBe(before);
+	});
+});

package/src/register-registry-page-route/resolve-page-data.ts

@@ -81,6 +81,24 @@ interface RegionEntry {
 	metaDescription?: string | null;
 }
 
+// A region slot the operator DECLARED (resource_loader.region_slots) whose
+// source did not resolve used to vanish with no signal anywhere — the page
+// rendered minus a region while the page, source, attributes, template and
+// tree builder all looked innocent (measured 2026-08-18: a footer region
+// added to a report produced no footer and no diagnostic; the cause was the
+// boot-time config capture named in the message). One warn per slot per
+// process, throttled like the block-coverage guard in the caller, so the hot
+// path never spams it.
+const unresolvedRegionSlotsLogged = new Set<string>();
+
+function warnUnresolvedRegionSlot(slot: string): void {
+	if (unresolvedRegionSlotsLogged.has(slot)) return;
+	unresolvedRegionSlotsLogged.add(slot);
+	getAppLogger().warn(
+		`[resolve-page-data] region slot "${slot}" is declared in the resource_loader config but no source resolved for it — the region is omitted from this render. A resource_loader edit reaches a booted service only after a restart.`,
+	);
+}
+
 export function resolvedToPageData(
 	resolved: Record<string, unknown>,
 	meta: Record<string, unknown>,
@@ -133,7 +151,10 @@ export function resolvedToPageData(
 		const regions: RegionEntry[] = [];
 		for (const slot of regionSlots) {
 			const source = resolved[slot] as Record<string, unknown> | undefined;
-			if (!source) continue;
+			if (!source) {
+				warnUnresolvedRegionSlot(slot);
+				continue;
+			}
 			const puckData = extractPuckData(source) ?? EMPTY_PUCK_DATA;
 			applyLayoutDefaults(puckData, layoutDefaults);
 			regions.push({

package/src/register-registry-page-route.ts

@@ -42,6 +42,7 @@ import {
 	readCachedGraph,
 } from "./register-registry-page-route/graph-cache.ts";
 import { resolvedToPageData } from "./register-registry-page-route/resolve-page-data.ts";
+import { describeCapturedLoaderConfig } from "./register-registry-page-route/captured-loader-config.ts";
 import {
 	buildMetaFromContext,
 } from "./register-registry-page-route/meta-title.ts";
@@ -850,8 +851,12 @@ export async function registerRegistryPageRoute(
 		});
 
 		registeredPatterns.push(pattern);
+		// The loader config was captured at boot into the loadData closure — name
+		// the captured shape + the restart contract so a row edit that "doesn't
+		// work" on a running service is answered by this line, not an evening of
+		// bisecting (measured 2026-08-18).
 		log.info(
-			`[scala-install:${serviceSlug}] registered registry page route "${pattern}" → resource_loader "${loaderSlug}"`,
+			`[scala-install:${serviceSlug}] registered registry page route "${pattern}" → resource_loader "${loaderSlug}" (${describeCapturedLoaderConfig(loaderConfig)})`,
 		);
 	}