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/interests/berth-recommender-panel.tsx

@@ -75,6 +75,12 @@ interface BerthRecommenderPanelProps {
   desiredLengthFt: number | null;
   desiredWidthFt: number | null;
   desiredDraftFt: number | null;
+  /**
+   * Unit the rep originally entered the dimensions in. Drives header
+   * display so a metric-entered deal doesn't render its dims as ft.
+   * Falls back to 'ft' when missing.
+   */
+  desiredUnit?: 'ft' | 'm' | null;
 }
 
 const TIER_LABELS: Record<Tier, { label: string; tone: string }> = {
@@ -115,11 +121,23 @@ function formatDimensions(
   return parts.join(' · ');
 }
 
-function formatDesired(length: number | null, width: number | null, draft: number | null): string {
+function formatDesired(
+  length: number | null,
+  width: number | null,
+  draft: number | null,
+  unit: 'ft' | 'm' = 'ft',
+): string {
+  // Storage is canonical-ft (the recommender's SQL ranks against
+  // berths.length_ft etc.). For display we convert back to whatever the rep
+  // entered. 0.3048 m/ft exactly.
+  const toDisplay = (ft: number): string => {
+    const v = unit === 'm' ? ft * 0.3048 : ft;
+    return v.toFixed(2).replace(/\.?0+$/, '');
+  };
   const parts: string[] = [];
-  if (length !== null) parts.push(`${length}ft L`);
-  if (width !== null) parts.push(`${width}ft W`);
-  if (draft !== null) parts.push(`${draft}ft D`);
+  if (length !== null) parts.push(`${toDisplay(length)}${unit} L`);
+  if (width !== null) parts.push(`${toDisplay(width)}${unit} W`);
+  if (draft !== null) parts.push(`${toDisplay(draft)}${unit} D`);
   return parts.length > 0 ? parts.join(' · ') : 'no dimensions set';
 }
 
@@ -332,11 +350,14 @@ function AmenityFilterForm({ filters, onChange }: AmenityFilterFormProps) {
   );
 }
 
+// destructure includes `desiredUnit` so the header formatter pivots on the
+// rep's entered unit. Falls back to 'ft' (the legacy default) when missing.
 export function BerthRecommenderPanel({
   interestId,
   desiredLengthFt,
   desiredWidthFt,
   desiredDraftFt,
+  desiredUnit,
 }: BerthRecommenderPanelProps) {
   const params = useParams<{ portSlug: string }>();
   const portSlug = params?.portSlug ?? '';
@@ -364,7 +385,12 @@ export function BerthRecommenderPanel({
       apiFetch<{ data: Recommendation[] }>(`/api/v1/interests/${interestId}/recommend-berths`, {
         method: 'POST',
         body: {
-          ...(showAll ? { topN: 999 } : {}),
+          // `showAll` opens the floodgates: bumps `topN` AND raises the
+          // oversize-cap so berths well beyond the strict feasibility window
+          // surface. Without that second bump the user could end up staring
+          // at "no berths match" when the test data only had oversized rows
+          // — exactly the case in our seeded demo port.
+          ...(showAll ? { topN: 999, maxOversizePct: 1000 } : {}),
           ...(Object.keys(amenityFilters).length > 0 ? { amenityFilters } : {}),
         },
       }).then((r) => r.data),
@@ -400,7 +426,13 @@ export function BerthRecommenderPanel({
           <div className="min-w-0 space-y-1">
             <CardTitle className="flex items-center gap-2 text-base">
               <Sparkles className="size-4 text-brand-600" aria-hidden />
-              Recommendations for {formatDesired(desiredLengthFt, desiredWidthFt, desiredDraftFt)}
+              Recommendations for{' '}
+              {formatDesired(
+                desiredLengthFt,
+                desiredWidthFt,
+                desiredDraftFt,
+                desiredUnit === 'm' ? 'm' : 'ft',
+              )}
             </CardTitle>
             {!hasDimensions ? (
               <p className="text-xs text-muted-foreground">
@@ -489,9 +521,18 @@ export function BerthRecommenderPanel({
             ))}
           </div>
         ) : recommendations.length === 0 ? (
-          <p className="py-6 text-center text-sm text-muted-foreground">
-            No berths match the current dimensions and filters.
-          </p>
+          <div className="py-6 text-center text-sm text-muted-foreground space-y-2">
+            <p>
+              {showAll
+                ? 'No berths in the port match these dimensions and filters.'
+                : 'No berths fit inside the strict oversize tolerance.'}
+            </p>
+            {!showAll && (
+              <Button type="button" size="sm" variant="outline" onClick={() => setShowAll(true)}>
+                Show oversized matches too
+              </Button>
+            )}
+          </div>
         ) : (
           <div className="space-y-2">
             {recommendations.map((rec) => (
@@ -507,7 +548,7 @@ export function BerthRecommenderPanel({
         {hasDimensions && recommendations.length > 0 ? (
           <div className="flex justify-center pt-1">
             <Button type="button" size="sm" variant="ghost" onClick={() => setShowAll((v) => !v)}>
-              {showAll ? 'Show top recommendations' : 'Show all feasible'}
+              {showAll ? 'Show top in-tolerance only' : 'Show oversized matches too'}
             </Button>
           </div>
         ) : null}