feat(PBI-76): user-settings bridge mounted in app layout

Hydrates the zustand store with the user's persisted settings via
prop (SSR-correct, no flicker). Opens an EventSource to
/api/realtime/user-settings so changes from other tabs/devices
flow into the same store. Demo accounts skip the SSE subscription.

Layout now selects user.settings alongside the other user fields,
no extra DB roundtrip.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

app/(app)/layout.tsx

@@ -8,6 +8,8 @@ import { MinWidthBanner } from '@/components/shared/min-width-banner'
 import { StatusBar } from '@/components/shared/status-bar'
 import { SoloRealtimeBridge } from '@/components/solo/realtime-bridge'
 import { NotificationsBridge } from '@/components/notifications/notifications-bridge'
+import { UserSettingsBridge } from '@/components/shared/user-settings-bridge'
+import { parseUserSettings } from '@/lib/user-settings'
 import { AlertToast } from '@/components/shared/alert-toast'
 import { Suspense } from 'react'
 
@@ -17,7 +19,7 @@ export default async function AppLayout({ children }: { children: React.ReactNod
   const [user, userRoles, accessibleProducts] = await Promise.all([
     prisma.user.findUnique({
       where: { id: session.userId },
-      select: { username: true, email: true, active_product_id: true, min_quota_pct: true },
+      select: { username: true, email: true, active_product_id: true, min_quota_pct: true, settings: true },
     }),
     prisma.userRole.findMany({
       where: { user_id: session.userId },
@@ -79,6 +81,10 @@ export default async function AppLayout({ children }: { children: React.ReactNod
       <StatusBar />
       <SoloRealtimeBridge productId={activeProduct?.id ?? null} />
       <NotificationsBridge userId={session.userId} />
+      <UserSettingsBridge
+        initial={parseUserSettings(user.settings)}
+        isDemo={session.isDemo ?? false}
+      />
       <Suspense>
         <AlertToast />
       </Suspense>

components/shared/user-settings-bridge.tsx

@@ -0,0 +1,41 @@
+'use client'
+
+import { useEffect } from 'react'
+import { useUserSettingsStore } from '@/stores/user-settings/store'
+import type { UserSettings } from '@/lib/user-settings'
+
+interface Props {
+  initial: UserSettings
+  isDemo: boolean
+}
+
+/**
+ * PBI-76: hydrates the user-settings Zustand store with server-rendered prefs
+ * and opens an SSE subscription so other tabs/devices of the same user
+ * immediately see changes. Demo accounts skip the SSE subscription — their
+ * settings live only in-memory.
+ */
+export function UserSettingsBridge({ initial, isDemo }: Props) {
+  const hydrate = useUserSettingsStore((s) => s.hydrate)
+  const applyServerPatch = useUserSettingsStore((s) => s.applyServerPatch)
+
+  useEffect(() => {
+    hydrate(initial, isDemo)
+  }, [hydrate, initial, isDemo])
+
+  useEffect(() => {
+    if (isDemo) return
+    const es = new EventSource('/api/realtime/user-settings')
+    es.onmessage = (e) => {
+      try {
+        const patch = JSON.parse(e.data) as Partial<UserSettings>
+        applyServerPatch(patch)
+      } catch {
+        // ignore malformed event
+      }
+    }
+    return () => es.close()
+  }, [applyServerPatch, isDemo])
+
+  return null
+}