feat(platform): residential module + admin UI + reliability fixes

Residential platform
- New schema: residentialClients, residentialInterests (separate from
  marina/yacht clients) with migration 0010
- Service layer with CRUD + audit + sockets + per-port portal toggle
- v1 + public API routes (/api/v1/residential/*, /api/public/residential-inquiries)
- List + detail pages with inline editing for clients and interests
- Per-user residentialAccess toggle on userPortRoles (migration 0011)
- Permission keys: residential_clients, residential_interests
- Sidebar nav + role form integration
- Smoke spec covering page loads, UI create flow, public endpoint

Admin & shared UI
- Admin → Forms (form templates CRUD) with validators + service
- Notification preferences page (in-app + email per type)
- Email composition + accounts list + threads view
- Branded auth shell shared across CRM + portal auth surfaces
- Inline editing extended to yacht/company/interest detail pages
- InlineTagEditor + per-entity tags endpoints (yachts, companies)
- Notes service polymorphic across clients/interests/yachts/companies
- Client list columns: yachtCount + companyCount badges
- Reservation file-download via presigned URL (replaces stale <a href>)

Route handler refactor
- Extracted yachts/companies/berths reservation handlers to sibling
  handlers.ts files (Next.js 15 route.ts only allows specific exports)

Reliability fixes
- apiFetch double-stringify bug fixed across 13 components
  (apiFetch already JSON.stringifies its body; passing a stringified
  body produced double-encoded JSON which failed zod validation)
- SocketProvider gated behind useSyncExternalStore-based mount check
  to avoid useSession() SSR crashes under React 19 + Next 15
- apiFetch falls back to URL-pathname → port-id resolution when the
  Zustand store hasn't hydrated yet (fresh contexts, e2e tests)
- CRM invite flow (schema, service, route, email, dev script)
- Dashboard route → [portSlug]/dashboard/page.tsx + redirect
- Document the dev-server restart-after-migration gotcha in CLAUDE.md

Tests
- 5-case residential smoke spec
- Integration test updates for new service signatures

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

src/components/email/email-threads-list.tsx

@@ -0,0 +1,70 @@
+'use client';
+
+import { useQuery } from '@tanstack/react-query';
+import { formatDistanceToNow } from 'date-fns';
+import { Mail } from 'lucide-react';
+
+import { apiFetch } from '@/lib/api/client';
+
+interface Thread {
+  id: string;
+  subject: string;
+  snippet: string | null;
+  lastMessageAt: string;
+  participants: string[];
+  unreadCount: number;
+}
+
+interface ThreadsResponse {
+  data: Thread[];
+  total: number;
+}
+
+export function EmailThreadsList() {
+  const { data, isLoading } = useQuery<ThreadsResponse>({
+    queryKey: ['email', 'threads'],
+    queryFn: () => apiFetch<ThreadsResponse>('/api/v1/email/threads'),
+  });
+
+  if (isLoading) {
+    return <p className="text-sm text-muted-foreground">Loading threads…</p>;
+  }
+
+  const threads = data?.data ?? [];
+
+  if (threads.length === 0) {
+    return (
+      <div className="rounded-lg border border-dashed p-8 text-center text-muted-foreground">
+        <Mail className="mx-auto h-6 w-6 mb-2" />
+        <p className="text-sm">No email threads yet.</p>
+        <p className="text-xs">
+          Connect an account and trigger a sync to see incoming threads here.
+        </p>
+      </div>
+    );
+  }
+
+  return (
+    <div className="rounded-lg border divide-y">
+      {threads.map((t) => (
+        <div key={t.id} className="p-3 hover:bg-muted/40">
+          <div className="flex items-center justify-between gap-2">
+            <div className="text-sm font-medium truncate">{t.subject || '(no subject)'}</div>
+            <div className="text-xs text-muted-foreground shrink-0">
+              {formatDistanceToNow(new Date(t.lastMessageAt), { addSuffix: true })}
+            </div>
+          </div>
+          <div className="text-xs text-muted-foreground truncate">{t.participants.join(', ')}</div>
+          {t.snippet && (
+            <div className="text-xs text-muted-foreground mt-1 line-clamp-1">{t.snippet}</div>
+          )}
+          {t.unreadCount > 0 && (
+            <span className="inline-block mt-1 rounded-full bg-primary/10 px-2 py-0.5 text-xs text-primary">
+              {t.unreadCount} unread
+            </span>
+          )}
+        </div>
+      ))}
+    </div>
+  );
+}