fix(audit): comprehensive 2026-05-15 audit fix wave + Documenso v2 polish

Bundles the prior session's 50-task fix sweep (Documenso v2 + EOI/signing-
progress redesign + env-to-admin migration + dev-mode banner) with the
2026-05-18 audit fix wave (3 CRITICAL, 14 HIGH, 28 MEDIUM, 6 LOW).

CRITICAL (3):
 - C-01 interest-berths INNER JOIN -> LEFT JOIN so hard-deleted berths
   no longer silently drop interest links
 - C-02 /setup added to PUBLIC_PATHS; fresh-deploy bootstrap loop fixed
 - C-03 generic PATCH /interests/[id] no longer accepts pipelineStage —
   callers must go through /stage with the override-guard chain

HIGH (14/15):
 - H-01 explicit ON DELETE on previously-implicit NO ACTION FKs across
   interests/documents/reservations/reminders/invoices (migration 0070)
 - H-02 login page reads ?redirect= param with same-origin guard
 - H-03 CRM invite token moves to URL fragment so it never lands in
   nginx access logs / Referer headers
 - H-04 Retry-After header on sign-in-by-identifier 429 (RFC 6585 §4)
 - H-05 toggleAccount writes an audit row
 - H-06 upsertSetting masks any value whose key ends with _encrypted
 - H-07 archiveClient cascade fires per-interest audit rows
 - H-08 createSalesTransporter applies SMTP_TIMEOUTS
 - H-09 AppShell stable children — viewport flip across breakpoint no
   longer destroys in-progress form drafts
 - H-10 portal documents page swaps Unicode glyph status icons for
   Lucide CheckCircle2/XCircle/Circle + aria-labels
 - H-12 list components swap alert(...) for toast.warning(...)
 - H-13 5 icon-only buttons gain aria-label
 - H-14 parseBody treats empty bodies as {}
 - H-15 admin layout renders a 403 panel instead of silent bounce
 - H-11 not applicable — mobile-search-overlay IS a mobile bottom-sheet

MEDIUM (28+):
 - M-MT01-05 defense-in-depth port_id/parent-id filters on UPDATE/DELETE
   WHEREs across custom-fields, notes (all 6 entity types x update +
   delete), client-contacts, yacht ownerClient lookup, webhook reads
 - M-D01 documents-hub realtime event-name typo (file:created -> uploaded)
 - M-EM01 portal-auth emails thread through portId
 - M-EM02 sendEmail accepts cc/bcc params
 - M-EM04 notification_digest catalog key
 - M-IN01 portal presigned download URLs use 4h TTL
 - M-IN02 OpenAI client lazy-instantiated
 - M-IN04 stale pdfme refs updated to pdf-lib AcroForm
 - M-IN05 umami.testConnection returns tagged union
 - M-L01 reservations tenure_type unified with berths
 - M-L02 report-generators canonicalize stage values
 - M-AU01 audit log placeholder copy fixed
 - M-AU04 outcome_set / outcome_cleared distinct audit verbs
 - M-NEW-2 activity feed entity name+type separator
 - M-R01 portal allowlist narrowed + portal_session backstop in proxy
 - M-SC02 companies archived partial index
 - M-SC04 audit_logs.searchText documented as DB-managed
 - M-S01 storage_s3_access_key_encrypted admin field
 - M-U01 audit log empty state uses <EmptyState>
 - M-U09 invoice delete dialog -> <AlertDialog>
 - M-U10 toast.success on ClientForm + InterestForm create/edit
 - M-U11 settings-form-card logo preview alt text
 - M-U14 mobile topbar title on clients/yachts/interests/berths
 - M-U15 Invoices in mobile More-sheet

LOW (6/8):
 - L-AU01 severity defaults for security-relevant verbs
 - L-AU02 +13 missing actions in admin audit filter
 - L-AU03 +7 missing entity types in admin audit filter
 - L-AU04 dead listAuditLogs stubbed
 - L-D02 CLAUDE.md Owner-wins chain tightened

Bonus — Document detail polish (#67 partial, 3/6 deliverables):
 - state-aware action button per signer
 - watcher Add UI with display-name resolution
 - cleanSignerName cleanup

Prior session work bundled in:
 - Documenso v2 webhook + envelope-ID normalization + sequential signing
 - SigningProgress UI redesign (avatars, per-signer state, timestamps)
 - env->admin settings registry + RegistryDrivenForm + encrypted creds
 - Embedded-signing card + Test connection + setup help
 - Dev-mode EMAIL_REDIRECT_TO banner
 - Pipeline rules admin page
 - Sales email config card
 - Audit log details Sheet
 - EOI tab: Finalising badge, absolute timestamps, sequential indicator
 - Notes pipeline_stage_at_creation (migration 0069)
 - Documenso numeric ID dual-key webhook (migration 0068)
 - Dimensions criterion copy (migration 0067)

Tests: 1374/1374 vitest pass. tsc clean. lint clean.

See docs/AUDIT-FIX-WAVE-2026-05-18.md for the full progress report and
the user-input items still pending.

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

src/components/layout/app-shell.tsx

@@ -2,9 +2,14 @@
 
 import { useEffect, useState, type ComponentProps, type ReactNode } from 'react';
 
+import { cn } from '@/lib/utils';
 import { Sidebar } from '@/components/layout/sidebar';
 import { Topbar } from '@/components/layout/topbar';
-import { MobileLayout } from '@/components/layout/mobile/mobile-layout';
+import { MobileLayoutProvider } from '@/components/layout/mobile/mobile-layout-provider';
+import { MobileTopbar } from '@/components/layout/mobile/mobile-topbar';
+import { MobileBottomTabs } from '@/components/layout/mobile/mobile-bottom-tabs';
+import { MoreSheet } from '@/components/layout/mobile/more-sheet';
+import { MobileSearchOverlay } from '@/components/search/mobile-search-overlay';
 
 type SidebarProps = ComponentProps<typeof Sidebar>;
 type TopbarProps = ComponentProps<typeof Topbar>;
@@ -27,11 +32,23 @@ interface AppShellProps {
 const MOBILE_QUERY = '(max-width: 1023.98px)';
 
 /**
- * #26: single-tree responsive shell. Pre-fix the layout mounted BOTH
- * desktop and mobile shells in the DOM and CSS-hid one — doubling React
- * state, fetches, Tabs providers, and a11y landmarks. AppShell decides
- * once per render which tree to mount, so a page only ever runs the
- * effects + queries it actually displays.
+ * #26 + H-09: single-tree responsive shell with stable children subtree.
+ *
+ * The shell renders ONE `<main>` and ONE `<MobileLayoutProvider>` at all
+ * viewports — only the chrome (sidebar+topbar vs mobile-topbar+bottom-tabs)
+ * conditionally renders. Two payoffs:
+ *
+ *   - #26 / first ship: no double-mount of chrome subtrees (Sidebar +
+ *     MobileTopbar both running fetches / providers in parallel like the
+ *     old layout did).
+ *   - H-09: `{children}` stays mounted across viewport flips. A rep
+ *     editing an inline field on desktop who resizes through the mobile
+ *     breakpoint no longer loses the draft mid-edit — the children tree's
+ *     position in the DOM is invariant, so React preserves its state.
+ *
+ * The mobile-only floating panels (MoreSheet, MobileSearchOverlay) only
+ * mount in the mobile branch — they have no desktop counterpart and would
+ * be wasteful to keep mounted otherwise.
  *
  * SSR safety: the server passes its UA-classified hint via `initialFormFactor`;
  * the first client render uses the same value so hydration matches. After
@@ -46,6 +63,8 @@ export function AppShell({
   children,
 }: AppShellProps) {
   const [isMobile, setIsMobile] = useState(initialFormFactor === 'mobile');
+  const [moreOpen, setMoreOpen] = useState(false);
+  const [searchOpen, setSearchOpen] = useState(false);
 
   useEffect(() => {
     const mq = window.matchMedia(MOBILE_QUERY);
@@ -55,17 +74,54 @@ export function AppShell({
     return () => mq.removeEventListener('change', update);
   }, []);
 
-  if (isMobile) {
-    return <MobileLayout>{children}</MobileLayout>;
-  }
+  // Build the chrome subtree based on form factor; the children's parent
+  // chain (MobileLayoutProvider > div > main) is invariant across both
+  // branches, so React reconciliation keeps the children subtree mounted
+  // when isMobile flips.
+  const chrome = isMobile ? (
+    <>
+      <MobileTopbar />
+    </>
+  ) : (
+    <Sidebar portRoles={portRoles} isSuperAdmin={isSuperAdmin} user={user} ports={ports} />
+  );
+
+  const footer = isMobile ? (
+    <>
+      <MobileBottomTabs
+        onMoreClick={() => setMoreOpen(true)}
+        onSearchClick={() => setSearchOpen(true)}
+      />
+      <MoreSheet open={moreOpen} onOpenChange={setMoreOpen} />
+      <MobileSearchOverlay open={searchOpen} onOpenChange={setSearchOpen} />
+    </>
+  ) : null;
+
+  const desktopTopbar = !isMobile ? <Topbar ports={ports} user={user} /> : null;
 
   return (
-    <div className="flex h-screen overflow-hidden bg-background">
-      <Sidebar portRoles={portRoles} isSuperAdmin={isSuperAdmin} user={user} ports={ports} />
-      <div className="flex-1 flex flex-col overflow-hidden min-w-0">
-        <Topbar ports={ports} user={user} />
-        <main className="flex-1 overflow-y-auto bg-background px-6 pt-3 pb-6">{children}</main>
+    <MobileLayoutProvider>
+      <div
+        className={cn(
+          'bg-background',
+          isMobile ? 'min-h-[100dvh]' : 'flex h-screen overflow-hidden',
+        )}
+      >
+        {chrome}
+        <div className={cn(isMobile ? 'contents' : 'flex-1 flex flex-col overflow-hidden min-w-0')}>
+          {desktopTopbar}
+          <main
+            className={cn(
+              isMobile
+                ? 'px-4 min-h-[100dvh] pt-[calc(56px+env(safe-area-inset-top)+1rem)] pb-[calc(56px+env(safe-area-inset-bottom)+2rem)]'
+                : 'flex-1 overflow-y-auto bg-background px-6 pt-3 pb-6',
+            )}
+          >
+            {children}
+          </main>
+        </div>
+        {footer}
       </div>
-    </div>
+    </MobileLayoutProvider>
   );
 }

src/components/layout/mobile/more-sheet.tsx

@@ -8,6 +8,7 @@ import {
   Bookmark,
   Building2,
   FileSignature,
+  FileText,
   Globe,
   Home,
   Inbox,
@@ -66,6 +67,9 @@ const MORE_GROUPS: MoreGroup[] = [
     label: 'Operations',
     items: [
       { label: 'Alerts & Reminders', icon: Inbox, segment: 'inbox' },
+      // M-U15: invoices was missing from the mobile nav — reps doing
+      // mobile follow-ups had to type the URL by hand.
+      { label: 'Invoices', icon: FileText, segment: 'invoices' },
       { label: 'Expenses', icon: Receipt, segment: 'expenses' },
       { label: 'Reservations', icon: Anchor, segment: 'berth-reservations' },
       { label: 'Reports', icon: BarChart3, segment: 'reports' },