diff --git a/src/app/(dashboard)/[portSlug]/admin/email/page.tsx b/src/app/(dashboard)/[portSlug]/admin/email/page.tsx
index 4017ee4..4477d4b 100644
--- a/src/app/(dashboard)/[portSlug]/admin/email/page.tsx
+++ b/src/app/(dashboard)/[portSlug]/admin/email/page.tsx
@@ -34,7 +34,7 @@ const FIELDS: SettingFieldDef[] = [
     label: 'Default signature (HTML)',
     description: 'Appended to the bottom of system-generated emails.',
     type: 'html',
-    placeholder: '<p>—<br>The Port Nimara team</p>',
+    placeholder: '<p>-<br>The Port Nimara team</p>',
     defaultValue: '',
   },
   {
@@ -71,7 +71,7 @@ const FIELDS: SettingFieldDef[] = [
   {
     key: 'smtp_pass_override',
     label: 'SMTP password override',
-    description: 'Optional. Stored in plain text — only set when overriding env credentials.',
+    description: 'Optional. Stored in plain text - only set when overriding env credentials.',
     type: 'password',
     defaultValue: '',
   },
diff --git a/src/app/(dashboard)/[portSlug]/clients/[clientId]/loading.tsx b/src/app/(dashboard)/[portSlug]/clients/[clientId]/loading.tsx
index 326d916..d2e7a04 100644
--- a/src/app/(dashboard)/[portSlug]/clients/[clientId]/loading.tsx
+++ b/src/app/(dashboard)/[portSlug]/clients/[clientId]/loading.tsx
@@ -4,13 +4,13 @@ import { CardSkeleton } from '@/components/shared/loading-skeleton';
 /**
  * Route-level loading UI for the client detail page. Renders while the
  * server component resolves the session and the client component bootstraps
- * its initial query — replaces the previous empty-header flash on direct
+ * its initial query - replaces the previous empty-header flash on direct
  * URL visits.
  */
 export default function Loading() {
   return (
     <div className="space-y-6">
-      {/* Header strip — title, badges, action buttons */}
+      {/* Header strip - title, badges, action buttons */}
       <div className="rounded-xl border border-border bg-card px-5 py-4 shadow-sm space-y-3">
         <div className="flex items-center gap-3">
           <Skeleton className="h-7 w-56" />
diff --git a/src/app/(dashboard)/[portSlug]/invoices/new/page.tsx b/src/app/(dashboard)/[portSlug]/invoices/new/page.tsx
index a31ade2..0e7f9b3 100644
--- a/src/app/(dashboard)/[portSlug]/invoices/new/page.tsx
+++ b/src/app/(dashboard)/[portSlug]/invoices/new/page.tsx
@@ -59,7 +59,7 @@ export default function NewInvoicePage() {
   }, [setChrome]);
 
   // When the form is launched from an interest detail with `?interestId=…&kind=deposit`,
-  // fetch enough of the interest to display "Deposit for {client} — Berth {n}" in
+  // fetch enough of the interest to display "Deposit for {client} - Berth {n}" in
   // the review step. Doubles as the source of truth for the billing entity prefill.
   const { data: prefilledInterest } = useQuery<{
     data: {
@@ -184,7 +184,7 @@ export default function NewInvoicePage() {
 
   return (
     <div className="max-w-2xl mx-auto space-y-6">
-      {/* Header — desktop only; mobile gets the title from the topbar */}
+      {/* Header - desktop only; mobile gets the title from the topbar */}
       <div className="hidden sm:flex items-center gap-3">
         <Button variant="ghost" size="sm" onClick={() => router.push(`/${portSlug}/invoices`)}>
           <ChevronLeft className="h-4 w-4" />
@@ -233,7 +233,7 @@ export default function NewInvoicePage() {
                         {prefilledInterest?.data
                           ? `Linked to ${prefilledInterest.data.clientName ?? 'interest'}${
                               prefilledInterest.data.berthMooringNumber
-                                ? ` — Berth ${prefilledInterest.data.berthMooringNumber}`
+                                ? ` - Berth ${prefilledInterest.data.berthMooringNumber}`
                                 : ''
                             }. Marking this invoice as paid will advance the interest to "Deposit 10%".`
                           : 'Marking this invoice as paid will advance the linked interest to "Deposit 10%".'}
diff --git a/src/app/(dashboard)/layout.tsx b/src/app/(dashboard)/layout.tsx
index eb386ba..4954859 100644
--- a/src/app/(dashboard)/layout.tsx
+++ b/src/app/(dashboard)/layout.tsx
@@ -40,7 +40,7 @@ export default async function DashboardLayout({ children }: { children: React.Re
         <PermissionsProvider>
           <SocketProvider>
             <RealtimeToasts />
-            {/* Desktop shell — hidden by CSS on mobile */}
+            {/* Desktop shell - hidden by CSS on mobile */}
             <div data-shell="desktop" className="flex h-screen overflow-hidden bg-background">
               <Sidebar
                 portRoles={portRoles}
@@ -49,6 +49,7 @@ export default async function DashboardLayout({ children }: { children: React.Re
                   name: profile?.displayName ?? session.user.name ?? session.user.email,
                   email: session.user.email,
                 }}
+                ports={ports}
               />
               <div className="flex-1 flex flex-col overflow-hidden min-w-0">
                 <Topbar
@@ -58,11 +59,13 @@ export default async function DashboardLayout({ children }: { children: React.Re
                     email: session.user.email,
                   }}
                 />
-                <main className="flex-1 overflow-y-auto bg-background p-6">{children}</main>
+                <main className="flex-1 overflow-y-auto bg-background pt-3 px-6 pb-6">
+                  {children}
+                </main>
               </div>
             </div>
 
-            {/* Mobile shell — hidden by CSS on desktop */}
+            {/* Mobile shell - hidden by CSS on desktop */}
             <MobileLayout>{children}</MobileLayout>
           </SocketProvider>
         </PermissionsProvider>
diff --git a/src/app/(portal)/layout.tsx b/src/app/(portal)/layout.tsx
index 2c891f4..91bf70b 100644
--- a/src/app/(portal)/layout.tsx
+++ b/src/app/(portal)/layout.tsx
@@ -12,14 +12,10 @@ export const metadata: Metadata = {
   },
 };
 
-export default async function PortalLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
+export default async function PortalLayout({ children }: { children: React.ReactNode }) {
   // This layout wraps all portal routes including login/verify
   // We can't easily check pathname in a server layout, so we attempt
-  // to get the session and pass it down — login/verify pages handle their own
+  // to get the session and pass it down - login/verify pages handle their own
   // redirect logic independently.
   const session = await getPortalSession().catch(() => null);
 
@@ -42,17 +38,11 @@ export default async function PortalLayout({
     <div className="min-h-screen bg-gray-50">
       {session && (
         <>
-          <PortalHeader
-            portName={portName}
-            portLogoUrl={portLogoUrl}
-            clientName={clientName}
-          />
+          <PortalHeader portName={portName} portLogoUrl={portLogoUrl} clientName={clientName} />
           <PortalNav />
         </>
       )}
-      <main className={session ? 'max-w-5xl mx-auto px-4 sm:px-6 py-8' : ''}>
-        {children}
-      </main>
+      <main className={session ? 'max-w-5xl mx-auto px-4 sm:px-6 py-8' : ''}>{children}</main>
     </div>
   );
 }
diff --git a/src/app/(portal)/portal/activate/page.tsx b/src/app/(portal)/portal/activate/page.tsx
index d488ab2..e42f323 100644
--- a/src/app/(portal)/portal/activate/page.tsx
+++ b/src/app/(portal)/portal/activate/page.tsx
@@ -14,7 +14,7 @@ export default function PortalActivatePage() {
       <PasswordSetForm
         endpoint="/api/portal/auth/activate"
         title="Activate your account"
-        description="Welcome — choose a password to finish setting up your client portal account."
+        description="Welcome - choose a password to finish setting up your client portal account."
         successTitle="Account activated"
         successDescription="You can now sign in with your new password."
         submitLabel="Activate account"
diff --git a/src/app/(portal)/portal/forgot-password/page.tsx b/src/app/(portal)/portal/forgot-password/page.tsx
index 559131f..b7b87fd 100644
--- a/src/app/(portal)/portal/forgot-password/page.tsx
+++ b/src/app/(portal)/portal/forgot-password/page.tsx
@@ -18,7 +18,7 @@ export default function PortalForgotPasswordPage() {
     e.preventDefault();
     setLoading(true);
     try {
-      // Always returns 200 — caller never sees whether email exists.
+      // Always returns 200 - caller never sees whether email exists.
       await fetch('/api/portal/auth/forgot-password', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
diff --git a/src/app/(portal)/portal/interests/page.tsx b/src/app/(portal)/portal/interests/page.tsx
index 1adb445..aa01c01 100644
--- a/src/app/(portal)/portal/interests/page.tsx
+++ b/src/app/(portal)/portal/interests/page.tsx
@@ -57,7 +57,7 @@ export default async function PortalInterestsPage() {
                       <span className="font-medium text-gray-900">General Interest</span>
                     )}
                     {interest.berthArea && (
-                      <span className="text-sm text-gray-400">— {interest.berthArea}</span>
+                      <span className="text-sm text-gray-400">- {interest.berthArea}</span>
                     )}
                   </div>
                   {interest.leadCategory && (
diff --git a/src/app/(portal)/portal/my-reservations/page.tsx b/src/app/(portal)/portal/my-reservations/page.tsx
index 95db972..6b643b5 100644
--- a/src/app/(portal)/portal/my-reservations/page.tsx
+++ b/src/app/(portal)/portal/my-reservations/page.tsx
@@ -59,7 +59,7 @@ export default async function PortalMyReservationsPage() {
                   <div className="flex items-center gap-2 mb-1">
                     <span className="font-medium text-gray-900">{r.yachtName ?? 'Yacht'}</span>
                     {r.berthMooringNumber && (
-                      <span className="text-sm text-gray-400">— Berth {r.berthMooringNumber}</span>
+                      <span className="text-sm text-gray-400">- Berth {r.berthMooringNumber}</span>
                     )}
                   </div>
                   <p className="text-sm text-gray-500">
diff --git a/src/app/(scanner)/[portSlug]/scan/manifest.webmanifest/route.ts b/src/app/(scanner)/[portSlug]/scan/manifest.webmanifest/route.ts
index f1f0dd0..2014311 100644
--- a/src/app/(scanner)/[portSlug]/scan/manifest.webmanifest/route.ts
+++ b/src/app/(scanner)/[portSlug]/scan/manifest.webmanifest/route.ts
@@ -15,7 +15,7 @@ export async function GET(_req: Request, { params }: { params: Promise<{ portSlu
   const portName = port?.name ?? 'Port Nimara';
 
   const manifest = {
-    name: `${portName} — Scanner`,
+    name: `${portName} - Scanner`,
     short_name: 'Scanner',
     description: `Capture and submit expense receipts for ${portName}.`,
     start_url: `/${portSlug}/scan`,
diff --git a/src/app/(scanner)/[portSlug]/scan/page.tsx b/src/app/(scanner)/[portSlug]/scan/page.tsx
index 4bb6ac7..c3750e6 100644
--- a/src/app/(scanner)/[portSlug]/scan/page.tsx
+++ b/src/app/(scanner)/[portSlug]/scan/page.tsx
@@ -3,7 +3,7 @@ import type { Metadata } from 'next';
 import { ScanShell } from '@/components/scan/scan-shell';
 
 export const metadata: Metadata = {
-  title: 'Scan receipt — Port Nimara',
+  title: 'Scan receipt - Port Nimara',
 };
 
 export default function ScanPage() {
diff --git a/src/app/api/health/route.ts b/src/app/api/health/route.ts
index d3cb8dd..57bdf0e 100644
--- a/src/app/api/health/route.ts
+++ b/src/app/api/health/route.ts
@@ -1,11 +1,11 @@
 import { NextResponse } from 'next/server';
 
 /**
- * Liveness probe — confirms the Next.js process is responding.
+ * Liveness probe - confirms the Next.js process is responding.
  *
  * Returns 200 unconditionally; if the process is wedged or has crashed
  * the request never lands here at all. Do NOT include database/Redis/MinIO
- * checks in this endpoint — a transient downstream blip should drop the
+ * checks in this endpoint - a transient downstream blip should drop the
  * pod from the load balancer (readiness), not restart the pod (liveness).
  *
  * For deep dependency checks, hit `/api/ready` instead.
diff --git a/src/app/api/public/interests/route.ts b/src/app/api/public/interests/route.ts
index 2935254..4d80889 100644
--- a/src/app/api/public/interests/route.ts
+++ b/src/app/api/public/interests/route.ts
@@ -36,7 +36,7 @@ type PublicInterestData = z.infer<typeof publicInterestSchema>;
 // Keep the helper aligned with that.
 type Tx = typeof db;
 
-// POST /api/public/interests — unauthenticated public interest registration.
+// POST /api/public/interests - unauthenticated public interest registration.
 // Creates the trio (client + yacht + interest) plus an optional company +
 // membership, all inside a single transaction.
 export async function POST(req: NextRequest) {
@@ -70,7 +70,7 @@ export async function POST(req: NextRequest) {
 
     const firstName = data.firstName ?? fullName.split(/\s+/)[0] ?? 'Valued Guest';
 
-    // Resolve berth by mooring number (if provided). Read-only lookup — safe
+    // Resolve berth by mooring number (if provided). Read-only lookup - safe
     // to do outside the transaction.
     let berthId: string | null = null;
     let resolvedMooringNumber: string | null = data.mooringNumber ?? null;
diff --git a/src/app/api/public/residential-inquiries/route.ts b/src/app/api/public/residential-inquiries/route.ts
index 9b97f84..ee75126 100644
--- a/src/app/api/public/residential-inquiries/route.ts
+++ b/src/app/api/public/residential-inquiries/route.ts
@@ -34,7 +34,7 @@ async function gateRateLimit(ip: string): Promise<void> {
 }
 
 /**
- * POST /api/public/residential-inquiries — unauthenticated entry point for
+ * POST /api/public/residential-inquiries - unauthenticated entry point for
  * the public website's residential interest form. Creates a
  * `residential_clients` row and an opening `residential_interests` row in a
  * single transaction.
@@ -110,7 +110,7 @@ export async function POST(req: NextRequest) {
     emitToRoom(`port:${portId}`, 'residential_client:created', { id: result.clientId });
     emitToRoom(`port:${portId}`, 'residential_interest:created', { id: result.interestId });
 
-    // Send notification emails (non-blocking — failures shouldn't 500 the
+    // Send notification emails (non-blocking - failures shouldn't 500 the
     // public form).
     void sendResidentialNotifications({
       portId,
@@ -147,7 +147,7 @@ async function sendResidentialNotifications(args: {
   });
   await sendEmail(data.email, confirmation.subject, confirmation.html);
 
-  // Sales-team alert — pull recipients from system_settings if configured;
+  // Sales-team alert - pull recipients from system_settings if configured;
   // fall back to the inquiry_contact_email if available.
   const recipientsRow = await db.query.systemSettings.findFirst({
     where: and(
diff --git a/src/app/api/ready/route.ts b/src/app/api/ready/route.ts
index 569b65e..f193d62 100644
--- a/src/app/api/ready/route.ts
+++ b/src/app/api/ready/route.ts
@@ -21,7 +21,7 @@ interface ReadyResponse {
 }
 
 /**
- * Readiness probe — verifies that every backing service this process
+ * Readiness probe - verifies that every backing service this process
  * needs to serve traffic is reachable. A 503 should drop the pod from the
  * load balancer until the next probe succeeds; it should not trigger a
  * pod restart (that's what `/api/health` is for).
diff --git a/src/app/api/v1/admin/alerts/run-engine/route.ts b/src/app/api/v1/admin/alerts/run-engine/route.ts
index 3fef6d1..169e90c 100644
--- a/src/app/api/v1/admin/alerts/run-engine/route.ts
+++ b/src/app/api/v1/admin/alerts/run-engine/route.ts
@@ -10,7 +10,7 @@ import { runAlertEngineForPorts } from '@/lib/services/alert-engine';
  * exercised by the realapi socket fanout test.
  *
  * Requires super_admin or per-port admin permissions; the engine itself
- * is idempotent — duplicate runs only re-evaluate, never duplicate rows.
+ * is idempotent - duplicate runs only re-evaluate, never duplicate rows.
  */
 export const POST = withAuth(async (_req, ctx) => {
   try {
diff --git a/src/app/api/v1/admin/documenso/health/route.ts b/src/app/api/v1/admin/documenso/health/route.ts
index f9f7218..66d25ed 100644
--- a/src/app/api/v1/admin/documenso/health/route.ts
+++ b/src/app/api/v1/admin/documenso/health/route.ts
@@ -5,7 +5,7 @@ import { errorResponse } from '@/lib/errors';
 import { checkDocumensoHealth } from '@/lib/services/documenso-client';
 
 /**
- * Admin probe — calls Documenso /api/v1/health using the port's effective
+ * Admin probe - calls Documenso /api/v1/health using the port's effective
  * config. Used by the "Test connection" button on /admin/documenso.
  */
 export const POST = withAuth(
diff --git a/src/app/api/v1/admin/duplicates/handlers.ts b/src/app/api/v1/admin/duplicates/handlers.ts
index 5a85564..59182be 100644
--- a/src/app/api/v1/admin/duplicates/handlers.ts
+++ b/src/app/api/v1/admin/duplicates/handlers.ts
@@ -40,7 +40,7 @@ export async function listHandler(_req: Request, ctx: AuthContext): Promise<Next
       .map((p) => {
         const a = clientById.get(p.clientAId);
         const b = clientById.get(p.clientBId);
-        if (!a || !b) return null; // FK orphan — shouldn't happen, but be defensive
+        if (!a || !b) return null; // FK orphan - shouldn't happen, but be defensive
         // Skip pairs where one side has already been merged or archived.
         if (a.mergedIntoClientId || b.mergedIntoClientId) return null;
         return {
diff --git a/src/app/api/v1/admin/invitations/route.ts b/src/app/api/v1/admin/invitations/route.ts
index acfbbfb..ad2b624 100644
--- a/src/app/api/v1/admin/invitations/route.ts
+++ b/src/app/api/v1/admin/invitations/route.ts
@@ -9,7 +9,7 @@ import { createCrmInvite, listCrmInvites } from '@/lib/services/crm-invite.servi
 export const GET = withAuth(
   withPermission('admin', 'manage_users', async (_req, ctx) => {
     try {
-      // crm_user_invites is a global table (no per-port column) — invites
+      // crm_user_invites is a global table (no per-port column) - invites
       // mint better-auth users that may later be assigned roles in any
       // port. Listing it cross-tenant would let a port-A director
       // enumerate pending invitee emails, names, and isSuperAdmin flags
diff --git a/src/app/api/v1/admin/ocr-settings/test/route.ts b/src/app/api/v1/admin/ocr-settings/test/route.ts
index 9d4d520..03bf3da 100644
--- a/src/app/api/v1/admin/ocr-settings/test/route.ts
+++ b/src/app/api/v1/admin/ocr-settings/test/route.ts
@@ -13,7 +13,7 @@ const schema = z.object({
   apiKey: z.string().min(1),
 });
 
-// `manage_settings`-gated for parity with the parent OCR settings route —
+// `manage_settings`-gated for parity with the parent OCR settings route -
 // triggers outbound AI provider auth requests using a caller-supplied key.
 export const POST = withAuth(
   withPermission('admin', 'manage_settings', async (req) => {
diff --git a/src/app/api/v1/admin/templates/preview/route.ts b/src/app/api/v1/admin/templates/preview/route.ts
index a1fd851..0cb5985 100644
--- a/src/app/api/v1/admin/templates/preview/route.ts
+++ b/src/app/api/v1/admin/templates/preview/route.ts
@@ -17,12 +17,12 @@ import { previewAdminTemplateSchema } from '@/lib/validators/document-templates'
  * POST /api/v1/admin/templates/preview
  *
  * Generates a preview PDF from a TipTap JSON content block.
- * Returns { data: { pdfBase64: string } } — the client can render this
+ * Returns { data: { pdfBase64: string } } - the client can render this
  * in an <iframe src="data:application/pdf;base64,..."> or open in a new tab.
  *
  * Body:
  *   content: TipTap JSON document
- *   sampleData?: Record<string, string> — variable substitutions
+ *   sampleData?: Record<string, string> - variable substitutions
  */
 export const POST = withAuth(
   withPermission('documents', 'manage', async (req, _ctx) => {
@@ -60,10 +60,7 @@ export const POST = withAuth(
 /**
  * Deeply substitutes {{variable}} tokens in all text nodes of a TipTap doc.
  */
-function substituteInDoc(
-  node: TipTapNode,
-  data: Record<string, string>,
-): TipTapNode {
+function substituteInDoc(node: TipTapNode, data: Record<string, string>): TipTapNode {
   if (node.type === 'text' && node.text) {
     return { ...node, text: substituteVariables(node.text, data) };
   }
diff --git a/src/app/api/v1/berth-reservations/[id]/route.ts b/src/app/api/v1/berth-reservations/[id]/route.ts
index b157490..32120f4 100644
--- a/src/app/api/v1/berth-reservations/[id]/route.ts
+++ b/src/app/api/v1/berth-reservations/[id]/route.ts
@@ -3,7 +3,7 @@ import { withAuth, withPermission } from '@/lib/api/helpers';
 import { getHandler, patchHandler, deleteHandler } from './handlers';
 
 export const GET = withAuth(withPermission('reservations', 'view', getHandler));
-// PATCH cannot use `withPermission` wrapper — the required permission depends
+// PATCH cannot use `withPermission` wrapper - the required permission depends
 // on the `action` field in the body. `requirePermission` is called inside the
 // handler after the body is parsed.
 export const PATCH = withAuth(patchHandler);
diff --git a/src/app/api/v1/berths/[id]/waiting-list/route.ts b/src/app/api/v1/berths/[id]/waiting-list/route.ts
index a702cc5..be657b1 100644
--- a/src/app/api/v1/berths/[id]/waiting-list/route.ts
+++ b/src/app/api/v1/berths/[id]/waiting-list/route.ts
@@ -40,7 +40,7 @@ export const PUT = withAuth(
   }),
 );
 
-// PATCH /api/v1/berths/[id]/waiting-list — reorder a single entry
+// PATCH /api/v1/berths/[id]/waiting-list - reorder a single entry
 export const PATCH = withAuth(
   withPermission('berths', 'manage_waiting_list', async (req, ctx, params) => {
     try {
diff --git a/src/app/api/v1/berths/options/route.ts b/src/app/api/v1/berths/options/route.ts
index da41031..2c00a5a 100644
--- a/src/app/api/v1/berths/options/route.ts
+++ b/src/app/api/v1/berths/options/route.ts
@@ -4,7 +4,7 @@ import { withAuth, withPermission } from '@/lib/api/helpers';
 import { getBerthOptions } from '@/lib/services/berths.service';
 import { errorResponse } from '@/lib/errors';
 
-// GET /api/v1/berths/options — lightweight list for selects/comboboxes
+// GET /api/v1/berths/options - lightweight list for selects/comboboxes
 export const GET = withAuth(
   withPermission('berths', 'view', async (req, ctx) => {
     try {
diff --git a/src/app/api/v1/clients/[id]/portal-user/route.ts b/src/app/api/v1/clients/[id]/portal-user/route.ts
index cf37f87..fb81350 100644
--- a/src/app/api/v1/clients/[id]/portal-user/route.ts
+++ b/src/app/api/v1/clients/[id]/portal-user/route.ts
@@ -19,7 +19,7 @@ const inviteSchema = z.object({
  *
  * Admin creates a portal account for a client and triggers the activation
  * email. Idempotent in spirit: if a portal user already exists for the
- * email, returns 409 — the admin can resend the activation via
+ * email, returns 409 - the admin can resend the activation via
  * ?action=resend.
  */
 export const POST = withAuth(
diff --git a/src/app/api/v1/clients/match-candidates/handlers.ts b/src/app/api/v1/clients/match-candidates/handlers.ts
index ee7d7d1..07d3051 100644
--- a/src/app/api/v1/clients/match-candidates/handlers.ts
+++ b/src/app/api/v1/clients/match-candidates/handlers.ts
@@ -44,7 +44,7 @@ export async function getMatchCandidatesHandler(
     const nameResult = rawName ? normalizeName(rawName) : null;
 
     // If the caller didn't give us anything useful to match on, return empty
-    // — short-circuit rather than scan every client for nothing.
+    // - short-circuit rather than scan every client for nothing.
     if (!email && !phoneResult?.e164 && !nameResult?.surnameToken) {
       return NextResponse.json({ data: [] });
     }
@@ -122,7 +122,7 @@ export async function getMatchCandidatesHandler(
       mediumScore: 50,
     });
 
-    // Only return medium+ — low-confidence noise isn't useful at the
+    // Only return medium+ - low-confidence noise isn't useful at the
     // create-form layer (background scoring queue picks those up).
     const useful = matches.filter((m) => m.confidence !== 'low');
     if (useful.length === 0) {
diff --git a/src/app/api/v1/expenses/[id]/merge/route.ts b/src/app/api/v1/expenses/[id]/merge/route.ts
index b071bc2..5944ba5 100644
--- a/src/app/api/v1/expenses/[id]/merge/route.ts
+++ b/src/app/api/v1/expenses/[id]/merge/route.ts
@@ -7,7 +7,7 @@ import { errorResponse } from '@/lib/errors';
 import { mergeDuplicate } from '@/lib/services/expense-dedup.service';
 
 const mergeSchema = z.object({
-  /** Surviving expense id — typically the row's existing `duplicateOf` pointer. */
+  /** Surviving expense id - typically the row's existing `duplicateOf` pointer. */
   targetId: z.string().min(1),
 });
 
diff --git a/src/app/api/v1/expenses/scan-receipt/route.ts b/src/app/api/v1/expenses/scan-receipt/route.ts
index b252a88..58c61cd 100644
--- a/src/app/api/v1/expenses/scan-receipt/route.ts
+++ b/src/app/api/v1/expenses/scan-receipt/route.ts
@@ -51,7 +51,7 @@ export const POST = withAuth(
           });
         }
 
-        // Per-port budget gate — refuse the call before we spend tokens
+        // Per-port budget gate - refuse the call before we spend tokens
         // when the port has already hit its hard cap, or when the request
         // would push it past the cap. Soft-cap warnings ride along on the
         // success response so the UI can show a banner without blocking.
@@ -99,7 +99,7 @@ export const POST = withAuth(
           });
         } catch (err) {
           logger.error({ err, provider: config.provider }, 'OCR provider call failed');
-          // Provider hiccup — degrade to manual entry rather than 500-ing.
+          // Provider hiccup - degrade to manual entry rather than 500-ing.
           return NextResponse.json({
             data: {
               parsed: EMPTY,
diff --git a/src/app/api/v1/files/folders/route.ts b/src/app/api/v1/files/folders/route.ts
index 1766b94..ffd3e9e 100644
--- a/src/app/api/v1/files/folders/route.ts
+++ b/src/app/api/v1/files/folders/route.ts
@@ -16,7 +16,7 @@ export const POST = withAuth(
     try {
       const body = await parseBody(req, createFolderSchema);
 
-      // Sanitize path — no null bytes, no path traversal
+      // Sanitize path - no null bytes, no path traversal
       const safePath = body.path
         .replace(/\x00/g, '')
         .replace(/\.\.\//g, '')
diff --git a/src/app/api/v1/interests/[id]/recommendations/route.ts b/src/app/api/v1/interests/[id]/recommendations/route.ts
index a57d9a3..4649e4b 100644
--- a/src/app/api/v1/interests/[id]/recommendations/route.ts
+++ b/src/app/api/v1/interests/[id]/recommendations/route.ts
@@ -20,7 +20,7 @@ export const GET = withAuth(
   }),
 );
 
-// POST /api/v1/interests/[id]/recommendations — add manual recommendation
+// POST /api/v1/interests/[id]/recommendations - add manual recommendation
 export const POST = withAuth(
   withPermission('interests', 'edit', async (req, ctx, params) => {
     try {
diff --git a/src/app/api/v1/interests/[id]/timeline/route.ts b/src/app/api/v1/interests/[id]/timeline/route.ts
index 9042bb0..c1d7b69 100644
--- a/src/app/api/v1/interests/[id]/timeline/route.ts
+++ b/src/app/api/v1/interests/[id]/timeline/route.ts
@@ -12,9 +12,9 @@ import { stageLabel } from '@/lib/constants';
 
 const OUTCOME_LABELS: Record<string, string> = {
   won: 'Won',
-  lost_other_marina: 'Lost — went to another marina',
-  lost_unqualified: 'Lost — unqualified',
-  lost_no_response: 'Lost — no response',
+  lost_other_marina: 'Lost - went to another marina',
+  lost_unqualified: 'Lost - unqualified',
+  lost_no_response: 'Lost - no response',
   cancelled: 'Cancelled',
 };
 
@@ -187,7 +187,7 @@ function buildAuditDescription(
     const outcomeKey = (newValue?.outcome as string | undefined) ?? '';
     const label = OUTCOME_LABELS[outcomeKey] ?? outcomeKey ?? 'Closed';
     const reason = (newValue?.reason as string | undefined) ?? '';
-    return reason ? `Marked as ${label} — ${reason}` : `Marked as ${label}`;
+    return reason ? `Marked as ${label} - ${reason}` : `Marked as ${label}`;
   }
 
   if (type === 'outcome_cleared') {
@@ -200,9 +200,9 @@ function buildAuditDescription(
     const reason = (newValue.reason as string | undefined) ?? '';
     const auto = userId === 'system';
     if (auto) {
-      return reason ? `${stage} (auto-advanced — ${reason})` : `Stage advanced to ${stage}`;
+      return reason ? `${stage} (auto-advanced - ${reason})` : `Stage advanced to ${stage}`;
     }
-    return reason ? `Stage changed to ${stage} — ${reason}` : `Stage changed to ${stage}`;
+    return reason ? `Stage changed to ${stage} - ${reason}` : `Stage changed to ${stage}`;
   }
 
   if (action === 'update' && newValue?.pipelineStage) {
diff --git a/src/app/api/v1/search/route.ts b/src/app/api/v1/search/route.ts
index 7b15264..c3f95ec 100644
--- a/src/app/api/v1/search/route.ts
+++ b/src/app/api/v1/search/route.ts
@@ -18,7 +18,7 @@ export const GET = withAuth(async (req: NextRequest, ctx) => {
 
     const results = await search(ctx.portId, q);
 
-    // Fire-and-forget — do not await
+    // Fire-and-forget - do not await
     saveRecentSearch(ctx.userId, ctx.portId, q);
 
     return NextResponse.json(results);
diff --git a/src/app/api/webhooks/documenso/route.ts b/src/app/api/webhooks/documenso/route.ts
index 57f26ef..353b6ea 100644
--- a/src/app/api/webhooks/documenso/route.ts
+++ b/src/app/api/webhooks/documenso/route.ts
@@ -75,7 +75,7 @@ export async function POST(req: NextRequest): Promise<NextResponse> {
     });
 
     if (existing) {
-      logger.info({ signatureHash }, 'Duplicate Documenso webhook — skipping');
+      logger.info({ signatureHash }, 'Duplicate Documenso webhook - skipping');
       return NextResponse.json({ ok: true }, { status: 200 });
     }
   } catch (err) {
diff --git a/src/app/globals.css b/src/app/globals.css
index b9e5b5e..e0a97a9 100644
--- a/src/app/globals.css
+++ b/src/app/globals.css
@@ -93,7 +93,7 @@
     @apply bg-background text-foreground font-sans antialiased;
   }
 
-  /* Wave watermark — subtle background texture for auth pages */
+  /* Wave watermark - subtle background texture for auth pages */
   .wave-watermark {
     background-image: repeating-linear-gradient(
       135deg,
@@ -134,7 +134,7 @@
  * from User-Agent (see src/lib/form-factor.ts). The media-query fallback
  * handles desktop browsers resized below lg (1024px), or stripped UAs.
  *
- * IMPORTANT: only `display: none` rules are emitted — we never set a positive
+ * IMPORTANT: only `display: none` rules are emitted - we never set a positive
  * display, because the desktop shell uses Tailwind's `flex` class which would
  * be overridden by `display: block` (same specificity, later cascade).
  */
@@ -169,3 +169,33 @@ body[data-form-factor='mobile'] [data-shell='mobile'] {
     display: none !important;
   }
 }
+
+/*
+ * Recharts focus-ring suppression.
+ *
+ * Recharts SVG surfaces become keyboard-focusable when a user clicks into
+ * them (the library adds tabindex on chart sectors / paths). The global
+ * `*:focus-visible` rule above paints a 4px brand-blue box-shadow ring,
+ * which on a chart surface reads as a stray rectangle around the plot
+ * area. Hover/tooltip already handles chart interactivity, so suppress
+ * the ring entirely here.
+ *
+ * Lives OUTSIDE `@layer base` so Tailwind's PostCSS pipeline can't drop
+ * it during purge (an earlier copy inside `@layer base` was being
+ * silently removed at build time, leaving the ring intact).
+ */
+div.recharts-wrapper:focus,
+div.recharts-wrapper:focus-visible,
+svg.recharts-surface:focus,
+svg.recharts-surface:focus-visible,
+div.recharts-responsive-container:focus,
+div.recharts-responsive-container:focus-visible,
+.recharts-wrapper *:focus,
+.recharts-wrapper *:focus-visible {
+  outline: none !important;
+  box-shadow: none !important;
+  --tw-ring-shadow: 0 0 #0000 !important;
+  --tw-ring-offset-shadow: 0 0 #0000 !important;
+  --tw-ring-color: transparent !important;
+  --tw-ring-offset-color: transparent !important;
+}
diff --git a/src/components/admin/audit/audit-log-list.tsx b/src/components/admin/audit/audit-log-list.tsx
index e076926..074c98d 100644
--- a/src/components/admin/audit/audit-log-list.tsx
+++ b/src/components/admin/audit/audit-log-list.tsx
@@ -87,7 +87,7 @@ export function AuditLogList() {
   const [loading, setLoading] = useState(true);
   const [loadingMore, setLoadingMore] = useState(false);
 
-  // Filter state — debounce text inputs.
+  // Filter state - debounce text inputs.
   const [search, setSearch] = useState('');
   const [entityType, setEntityType] = useState<string>('all');
   const [action, setAction] = useState<string>('all');
@@ -215,7 +215,7 @@ export function AuditLogList() {
             </span>
           );
         }
-        return <span className="text-xs text-muted-foreground">—</span>;
+        return <span className="text-xs text-muted-foreground">-</span>;
       },
     },
     {
@@ -245,7 +245,7 @@ export function AuditLogList() {
       <PageHeader
         title="Audit Log"
         eyebrow="Admin"
-        description="Every state change in this port — fully searchable."
+        description="Every state change in this port - fully searchable."
         variant="gradient"
       />
 
diff --git a/src/components/admin/custom-fields/custom-field-form.tsx b/src/components/admin/custom-fields/custom-field-form.tsx
index c598313..22f40d4 100644
--- a/src/components/admin/custom-fields/custom-field-form.tsx
+++ b/src/components/admin/custom-fields/custom-field-form.tsx
@@ -59,12 +59,7 @@ const FIELD_TYPE_LABELS: Record<string, string> = {
 
 // ─── Component ────────────────────────────────────────────────────────────────
 
-export function CustomFieldForm({
-  open,
-  onOpenChange,
-  field,
-  onSuccess,
-}: CustomFieldFormProps) {
+export function CustomFieldForm({ open, onOpenChange, field, onSuccess }: CustomFieldFormProps) {
   const isEdit = !!field;
 
   // Form state
@@ -72,9 +67,7 @@ export function CustomFieldForm({
   const [fieldName, setFieldName] = useState(field?.fieldName ?? '');
   const [fieldLabel, setFieldLabel] = useState(field?.fieldLabel ?? '');
   const [fieldType, setFieldType] = useState(field?.fieldType ?? 'text');
-  const [selectOptions, setSelectOptions] = useState<string[]>(
-    field?.selectOptions ?? [],
-  );
+  const [selectOptions, setSelectOptions] = useState<string[]>(field?.selectOptions ?? []);
   const [newOption, setNewOption] = useState('');
   const [isRequired, setIsRequired] = useState(field?.isRequired ?? false);
   const [sortOrder, setSortOrder] = useState(field?.sortOrder ?? 0);
@@ -169,13 +162,11 @@ export function CustomFieldForm({
     <Dialog open={open} onOpenChange={onOpenChange}>
       <DialogContent className="max-w-lg">
         <DialogHeader>
-          <DialogTitle>
-            {isEdit ? 'Edit Custom Field' : 'New Custom Field'}
-          </DialogTitle>
+          <DialogTitle>{isEdit ? 'Edit Custom Field' : 'New Custom Field'}</DialogTitle>
         </DialogHeader>
 
         <form onSubmit={handleSubmit} className="space-y-5 py-2">
-          {/* Entity Type — create only */}
+          {/* Entity Type - create only */}
           <div className="space-y-1.5">
             <Label htmlFor="cf-entity-type">Entity Type</Label>
             {isEdit ? (
@@ -198,7 +189,7 @@ export function CustomFieldForm({
             )}
           </div>
 
-          {/* Field Name — create only */}
+          {/* Field Name - create only */}
           <div className="space-y-1.5">
             <Label htmlFor="cf-field-name">
               Field Name
@@ -232,7 +223,7 @@ export function CustomFieldForm({
             />
           </div>
 
-          {/* Field Type — create only */}
+          {/* Field Type - create only */}
           <div className="space-y-1.5">
             <Label htmlFor="cf-field-type">Field Type</Label>
             {isEdit ? (
@@ -260,7 +251,7 @@ export function CustomFieldForm({
             )}
           </div>
 
-          {/* Select Options — visible when fieldType = 'select' */}
+          {/* Select Options - visible when fieldType = 'select' */}
           {fieldType === 'select' && (
             <div className="space-y-2">
               <Label>Options</Label>
@@ -302,11 +293,7 @@ export function CustomFieldForm({
           {/* Is Required */}
           <div className="flex items-center justify-between">
             <Label htmlFor="cf-is-required">Required field</Label>
-            <Switch
-              id="cf-is-required"
-              checked={isRequired}
-              onCheckedChange={setIsRequired}
-            />
+            <Switch id="cf-is-required" checked={isRequired} onCheckedChange={setIsRequired} />
           </div>
 
           {/* Sort Order */}
diff --git a/src/components/admin/document-templates/template-form.tsx b/src/components/admin/document-templates/template-form.tsx
index 0bd7167..f8770cc 100644
--- a/src/components/admin/document-templates/template-form.tsx
+++ b/src/components/admin/document-templates/template-form.tsx
@@ -11,13 +11,7 @@ import {
   SelectTrigger,
   SelectValue,
 } from '@/components/ui/select';
-import {
-  Sheet,
-  SheetContent,
-  SheetHeader,
-  SheetTitle,
-  SheetFooter,
-} from '@/components/ui/sheet';
+import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetFooter } from '@/components/ui/sheet';
 import { apiFetch } from '@/lib/api/client';
 import { TEMPLATE_VARIABLES } from '@/lib/pdf/tiptap-to-pdfme';
 
@@ -61,20 +55,13 @@ interface TemplateFormProps {
   onSuccess: () => void;
 }
 
-export function TemplateForm({
-  open,
-  onOpenChange,
-  template,
-  onSuccess,
-}: TemplateFormProps) {
+export function TemplateForm({ open, onOpenChange, template, onSuccess }: TemplateFormProps) {
   const isEdit = !!template;
 
   const [name, setName] = useState(template?.name ?? '');
   const [type, setType] = useState(template?.templateType ?? 'other');
   const [contentJson, setContentJson] = useState(
-    template?.content
-      ? JSON.stringify(template.content, null, 2)
-      : EMPTY_DOC,
+    template?.content ? JSON.stringify(template.content, null, 2) : EMPTY_DOC,
   );
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
@@ -86,7 +73,7 @@ export function TemplateForm({
       setJsonError(null);
       return true;
     } catch {
-      setJsonError('Invalid JSON — check syntax.');
+      setJsonError('Invalid JSON - check syntax.');
       return false;
     }
   }
@@ -115,8 +102,7 @@ export function TemplateForm({
       onSuccess();
       onOpenChange(false);
     } catch (err: unknown) {
-      const message =
-        err instanceof Error ? err.message : 'Something went wrong';
+      const message = err instanceof Error ? err.message : 'Something went wrong';
       setError(message);
     } finally {
       setLoading(false);
@@ -127,9 +113,7 @@ export function TemplateForm({
     <Sheet open={open} onOpenChange={onOpenChange}>
       <SheetContent className="w-full max-w-2xl overflow-y-auto sm:max-w-2xl">
         <SheetHeader>
-          <SheetTitle>
-            {isEdit ? 'Edit Template' : 'New Document Template'}
-          </SheetTitle>
+          <SheetTitle>{isEdit ? 'Edit Template' : 'New Document Template'}</SheetTitle>
         </SheetHeader>
 
         <form onSubmit={handleSubmit} className="mt-6 space-y-6">
@@ -145,7 +129,7 @@ export function TemplateForm({
             />
           </div>
 
-          {/* Type — only on create */}
+          {/* Type - only on create */}
           {!isEdit && (
             <div className="space-y-2">
               <Label htmlFor="template-type">Document Type</Label>
@@ -166,15 +150,11 @@ export function TemplateForm({
 
           {/* TipTap JSON Content */}
           <div className="space-y-2">
-            <Label htmlFor="template-content">
-              Document Content (TipTap JSON)
-            </Label>
+            <Label htmlFor="template-content">Document Content (TipTap JSON)</Label>
             <p className="text-xs text-muted-foreground">
               Paste or edit TipTap JSON. Use{' '}
-              <code className="rounded bg-muted px-1 text-xs">
-                {'{{variable.key}}'}
-              </code>{' '}
-              tokens for dynamic content.
+              <code className="rounded bg-muted px-1 text-xs">{'{{variable.key}}'}</code> tokens for
+              dynamic content.
             </p>
             <textarea
               id="template-content"
@@ -187,9 +167,7 @@ export function TemplateForm({
               className="w-full rounded-md border border-input bg-background px-3 py-2 font-mono text-xs shadow-sm focus:outline-none focus:ring-2 focus:ring-ring"
               spellCheck={false}
             />
-            {jsonError && (
-              <p className="text-xs text-destructive">{jsonError}</p>
-            )}
+            {jsonError && <p className="text-xs text-destructive">{jsonError}</p>}
           </div>
 
           {/* Available Variables Reference */}
@@ -200,19 +178,15 @@ export function TemplateForm({
             <div className="mt-3 grid grid-cols-1 gap-1 sm:grid-cols-2">
               {TEMPLATE_VARIABLES.map((v) => (
                 <div key={v.key} className="text-xs">
-                  <code className="rounded bg-muted px-1">
-                    {`{{${v.key}}}`}
-                  </code>{' '}
-                  <span className="text-muted-foreground">— {v.label}</span>
+                  <code className="rounded bg-muted px-1">{`{{${v.key}}}`}</code>{' '}
+                  <span className="text-muted-foreground">- {v.label}</span>
                 </div>
               ))}
             </div>
           </details>
 
           {error && (
-            <p className="rounded bg-destructive/10 px-3 py-2 text-sm text-destructive">
-              {error}
-            </p>
+            <p className="rounded bg-destructive/10 px-3 py-2 text-sm text-destructive">{error}</p>
           )}
 
           <SheetFooter>
@@ -225,11 +199,7 @@ export function TemplateForm({
               Cancel
             </Button>
             <Button type="submit" disabled={loading || !!jsonError}>
-              {loading
-                ? 'Saving…'
-                : isEdit
-                  ? 'Save Changes'
-                  : 'Create Template'}
+              {loading ? 'Saving…' : isEdit ? 'Save Changes' : 'Create Template'}
             </Button>
           </SheetFooter>
         </form>
diff --git a/src/components/admin/document-templates/template-list.tsx b/src/components/admin/document-templates/template-list.tsx
index dba72ba..caf68b4 100644
--- a/src/components/admin/document-templates/template-list.tsx
+++ b/src/components/admin/document-templates/template-list.tsx
@@ -9,12 +9,7 @@ import { PageHeader } from '@/components/shared/page-header';
 import { ConfirmationDialog } from '@/components/shared/confirmation-dialog';
 import { Button } from '@/components/ui/button';
 import { Badge } from '@/components/ui/badge';
-import {
-  Sheet,
-  SheetContent,
-  SheetHeader,
-  SheetTitle,
-} from '@/components/ui/sheet';
+import { Sheet, SheetContent, SheetHeader, SheetTitle } from '@/components/ui/sheet';
 import { apiFetch } from '@/lib/api/client';
 import { TemplateForm } from './template-form';
 import { TemplateVersionHistory } from './template-version-history';
@@ -57,9 +52,7 @@ export function TemplateList() {
   const fetchTemplates = useCallback(async () => {
     setLoading(true);
     try {
-      const res = await apiFetch<{ data: AdminTemplate[] }>(
-        '/api/v1/admin/templates',
-      );
+      const res = await apiFetch<{ data: AdminTemplate[] }>('/api/v1/admin/templates');
       setTemplates(res.data);
     } finally {
       setLoading(false);
@@ -122,9 +115,7 @@ export function TemplateList() {
       accessorKey: 'version',
       header: 'Version',
       cell: ({ row }) => (
-        <span className="text-sm text-muted-foreground">
-          v{row.original.version}
-        </span>
+        <span className="text-sm text-muted-foreground">v{row.original.version}</span>
       ),
     },
     {
@@ -151,10 +142,7 @@ export function TemplateList() {
       header: '',
       cell: ({ row }) => (
         <div className="flex items-center justify-end gap-1">
-          <TemplatePreview
-            content={row.original.content}
-            templateName={row.original.name}
-          />
+          <TemplatePreview content={row.original.content} templateName={row.original.name} />
           <Button
             variant="ghost"
             size="icon"
@@ -177,9 +165,7 @@ export function TemplateList() {
             title={row.original.isActive ? 'Deactivate' : 'Activate'}
             onClick={() => handleToggleActive(row.original)}
           >
-            <span className="text-xs">
-              {row.original.isActive ? 'Off' : 'On'}
-            </span>
+            <span className="text-xs">{row.original.isActive ? 'Off' : 'On'}</span>
           </Button>
           <ConfirmationDialog
             trigger={
@@ -233,9 +219,7 @@ export function TemplateList() {
       <Sheet open={historyOpen} onOpenChange={setHistoryOpen}>
         <SheetContent className="w-full max-w-xl sm:max-w-xl overflow-y-auto">
           <SheetHeader>
-            <SheetTitle>
-              Version History — {historyTemplate?.name}
-            </SheetTitle>
+            <SheetTitle>Version History - {historyTemplate?.name}</SheetTitle>
           </SheetHeader>
           <div className="mt-6">
             {historyTemplate && (
diff --git a/src/components/admin/document-templates/template-preview.tsx b/src/components/admin/document-templates/template-preview.tsx
index c799393..3c987b4 100644
--- a/src/components/admin/document-templates/template-preview.tsx
+++ b/src/components/admin/document-templates/template-preview.tsx
@@ -3,12 +3,7 @@
 import { useState } from 'react';
 import { Eye, ExternalLink } from 'lucide-react';
 import { Button } from '@/components/ui/button';
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-} from '@/components/ui/dialog';
+import { Dialog, DialogContent, DialogHeader, DialogTitle } from '@/components/ui/dialog';
 import { apiFetch } from '@/lib/api/client';
 import { TEMPLATE_VARIABLES } from '@/lib/pdf/tiptap-to-pdfme';
 
@@ -24,9 +19,7 @@ export function TemplatePreview({ content, templateName }: TemplatePreviewProps)
   const [error, setError] = useState<string | null>(null);
 
   // Build sample data from TEMPLATE_VARIABLES examples
-  const sampleData = Object.fromEntries(
-    TEMPLATE_VARIABLES.map((v) => [v.key, v.example]),
-  );
+  const sampleData = Object.fromEntries(TEMPLATE_VARIABLES.map((v) => [v.key, v.example]));
 
   async function handlePreview() {
     if (!content) {
@@ -74,14 +67,9 @@ export function TemplatePreview({ content, templateName }: TemplatePreviewProps)
         <DialogContent className="max-w-4xl">
           <DialogHeader>
             <div className="flex items-center justify-between">
-              <DialogTitle>Preview — {templateName}</DialogTitle>
+              <DialogTitle>Preview - {templateName}</DialogTitle>
               {pdfBase64 && (
-                <Button
-                  variant="ghost"
-                  size="sm"
-                  onClick={handleOpenInNewTab}
-                  className="mr-6"
-                >
+                <Button variant="ghost" size="sm" onClick={handleOpenInNewTab} className="mr-6">
                   <ExternalLink className="mr-1.5 h-3.5 w-3.5" />
                   Open in new tab
                 </Button>
@@ -100,9 +88,7 @@ export function TemplatePreview({ content, templateName }: TemplatePreviewProps)
             )}
 
             {error && !loading && (
-              <div className="rounded bg-destructive/10 p-4 text-sm text-destructive">
-                {error}
-              </div>
+              <div className="rounded bg-destructive/10 p-4 text-sm text-destructive">{error}</div>
             )}
 
             {pdfBase64 && !loading && (
diff --git a/src/components/admin/invitations/invitations-manager.tsx b/src/components/admin/invitations/invitations-manager.tsx
index b94788c..d555dfb 100644
--- a/src/components/admin/invitations/invitations-manager.tsx
+++ b/src/components/admin/invitations/invitations-manager.tsx
@@ -117,7 +117,7 @@ export function InvitationsManager() {
               {invites.map((i) => (
                 <tr key={i.id} className="border-t">
                   <td className="px-3 py-2 font-medium">{i.email}</td>
-                  <td className="px-3 py-2 text-muted-foreground">{i.name ?? '—'}</td>
+                  <td className="px-3 py-2 text-muted-foreground">{i.name ?? '-'}</td>
                   <td className="px-3 py-2 text-muted-foreground">
                     {i.isSuperAdmin ? 'Super admin' : 'Standard user'}
                   </td>
@@ -163,7 +163,7 @@ export function InvitationsManager() {
                         )}
                       </div>
                     ) : (
-                      <span className="text-xs text-muted-foreground">—</span>
+                      <span className="text-xs text-muted-foreground">-</span>
                     )}
                   </td>
                 </tr>
diff --git a/src/components/admin/ocr-settings-form.tsx b/src/components/admin/ocr-settings-form.tsx
index 02eeec1..ff01b29 100644
--- a/src/components/admin/ocr-settings-form.tsx
+++ b/src/components/admin/ocr-settings-form.tsx
@@ -160,7 +160,7 @@ function SettingsBlock({ scope, title, description, showUseGlobal }: SettingsBlo
                 Enable AI receipt parsing for this port
               </Label>
               <p className="text-xs text-muted-foreground">
-                Off by default. Receipts are read on-device using Tesseract.js — accurate enough for
+                Off by default. Receipts are read on-device using Tesseract.js - accurate enough for
                 most receipts and incurs no AI cost. Turning this on lets the configured provider
                 re-parse receipts server-side for higher accuracy on hard-to-read images.
               </p>
@@ -214,7 +214,7 @@ function SettingsBlock({ scope, title, description, showUseGlobal }: SettingsBlo
               id={`apiKey-${scope}`}
               type={showKey ? 'text' : 'password'}
               autoComplete="off"
-              placeholder={hasKey ? '•••••• (saved — leave blank to keep)' : 'sk-…'}
+              placeholder={hasKey ? '•••••• (saved - leave blank to keep)' : 'sk-…'}
               value={apiKey}
               onChange={(e) => {
                 setApiKey(e.target.value);
diff --git a/src/components/admin/queue-detail-table.tsx b/src/components/admin/queue-detail-table.tsx
index 0e01774..29a50ef 100644
--- a/src/components/admin/queue-detail-table.tsx
+++ b/src/components/admin/queue-detail-table.tsx
@@ -33,7 +33,7 @@ const statusVariant: Record<JobStatus, 'default' | 'secondary' | 'destructive' |
 };
 
 function formatDate(ts: number | undefined): string {
-  if (!ts) return '—';
+  if (!ts) return '-';
   return new Date(ts).toLocaleString();
 }
 
@@ -42,7 +42,7 @@ function truncateId(id: string): string {
 }
 
 function truncateReason(reason: string | undefined): string {
-  if (!reason) return '—';
+  if (!reason) return '-';
   return reason.length > 80 ? `${reason.slice(0, 80)}…` : reason;
 }
 
@@ -184,7 +184,7 @@ export function QueueDetailTable({ queueName }: QueueDetailTableProps) {
       {totalPages > 1 && (
         <div className="flex items-center justify-between text-sm text-muted-foreground">
           <span>
-            {total} total jobs — page {page} of {totalPages}
+            {total} total jobs - page {page} of {totalPages}
           </span>
           <div className="flex gap-2">
             <Button
diff --git a/src/components/admin/roles/role-list.tsx b/src/components/admin/roles/role-list.tsx
index c4c756b..60ebc98 100644
--- a/src/components/admin/roles/role-list.tsx
+++ b/src/components/admin/roles/role-list.tsx
@@ -95,7 +95,7 @@ export function RoleList() {
       accessorKey: 'description',
       header: 'Description',
       cell: ({ row }) => (
-        <span className="text-muted-foreground text-sm">{row.original.description ?? '—'}</span>
+        <span className="text-muted-foreground text-sm">{row.original.description ?? '-'}</span>
       ),
     },
     {
diff --git a/src/components/admin/settings/settings-manager.tsx b/src/components/admin/settings/settings-manager.tsx
index 4777ba0..f9a7eb1 100644
--- a/src/components/admin/settings/settings-manager.tsx
+++ b/src/components/admin/settings/settings-manager.tsx
@@ -363,7 +363,7 @@ export function SettingsManager() {
                         );
                         void saveSetting(setting.key, parsed);
                       } catch {
-                        // invalid JSON — do nothing
+                        // invalid JSON - do nothing
                       }
                     }}
                   >
diff --git a/src/components/admin/users/user-card.tsx b/src/components/admin/users/user-card.tsx
index 2ec1281..fc0114e 100644
--- a/src/components/admin/users/user-card.tsx
+++ b/src/components/admin/users/user-card.tsx
@@ -108,7 +108,7 @@ export function UserCard({ user, onEdit, onRemove, isRemoving }: UserCardProps)
             <span aria-hidden className="block h-9 w-9 shrink-0" />
           </div>
 
-          {/* Email subtitle — only when display name is shown as title */}
+          {/* Email subtitle - only when display name is shown as title */}
           {user.displayName && user.displayName !== user.email ? (
             <p className="mt-0.5 inline-flex items-center gap-1 truncate text-sm text-muted-foreground">
               <Mail className="h-3.5 w-3.5 shrink-0 text-muted-foreground/70" aria-hidden />
diff --git a/src/components/admin/webhooks/webhook-delivery-log.tsx b/src/components/admin/webhooks/webhook-delivery-log.tsx
index 94eea91..3eef9df 100644
--- a/src/components/admin/webhooks/webhook-delivery-log.tsx
+++ b/src/components/admin/webhooks/webhook-delivery-log.tsx
@@ -57,7 +57,7 @@ export function WebhookDeliveryLog({ webhookId }: Props) {
 
   useEffect(() => {
     void load(page);
-  // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [webhookId, page]);
 
   if (loading && deliveries.length === 0) {
@@ -87,13 +87,9 @@ export function WebhookDeliveryLog({ webhookId }: Props) {
             <TableRow key={d.id}>
               <TableCell className="font-mono text-xs">{d.eventType}</TableCell>
               <TableCell>
-                <Badge variant={STATUS_VARIANTS[d.status] ?? 'outline'}>
-                  {d.status}
-                </Badge>
-              </TableCell>
-              <TableCell className="text-sm">
-                {d.responseStatus ?? '—'}
+                <Badge variant={STATUS_VARIANTS[d.status] ?? 'outline'}>{d.status}</Badge>
               </TableCell>
+              <TableCell className="text-sm">{d.responseStatus ?? '-'}</TableCell>
               <TableCell className="text-sm">{d.attempt}</TableCell>
               <TableCell className="text-xs text-muted-foreground">
                 {d.deliveredAt
diff --git a/src/components/alerts/alert-bell.tsx b/src/components/alerts/alert-bell.tsx
index 603c820..dee808c 100644
--- a/src/components/alerts/alert-bell.tsx
+++ b/src/components/alerts/alert-bell.tsx
@@ -16,8 +16,8 @@ import { useAlertCount, useAlertList, useAlertRealtime } from './use-alerts';
 export function AlertBell() {
   const portSlug = useUIStore((s) => s.currentPortSlug);
   const [open, setOpen] = useState(false);
-  // Count is cheap (one aggregate query) — fire on every page so the badge stays live.
-  // List is heavier — only fetch when the popover is actually open.
+  // Count is cheap (one aggregate query) - fire on every page so the badge stays live.
+  // List is heavier - only fetch when the popover is actually open.
   const { data: count } = useAlertCount();
   const { data: list, isLoading } = useAlertList('open', open);
   useAlertRealtime();
diff --git a/src/components/alerts/alert-rail.tsx b/src/components/alerts/alert-rail.tsx
index cf3ff66..341dd1e 100644
--- a/src/components/alerts/alert-rail.tsx
+++ b/src/components/alerts/alert-rail.tsx
@@ -22,11 +22,10 @@ export function AlertRail() {
     <section
       data-testid="alert-rail"
       aria-label="Active alerts"
-      // `h-full` is intentional only at xl: where the parent dashboard grid
-      // gives this rail a sibling column whose height it should match. On
-      // mobile (single-column stack) there's no fixed-height context, so
-      // forcing 100% height makes the section overflow / look stretched.
-      className="flex flex-col gap-3 xl:h-full"
+      // Natural height - the parent aside no longer forces 100% of the
+      // dashboard grid row, so the rail can sit compactly under Reminders
+      // without bleeding down into the Recent Activity panel below.
+      className="flex flex-col gap-3"
     >
       <div className="flex items-baseline justify-between">
         <h2 className="text-sm font-semibold tracking-tight">Alerts</h2>
@@ -57,7 +56,7 @@ export function AlertRail() {
               href={portSlug ? (`/${portSlug}/alerts` as never) : ('/alerts' as never)}
               className="block rounded-lg border border-dashed border-border px-3 py-2 text-center text-xs text-muted-foreground transition-colors hover:bg-accent"
             >
-              +{overflow} more — view all
+              +{overflow} more - view all
             </Link>
           ) : null}
         </div>
diff --git a/src/components/berths/berth-columns.tsx b/src/components/berths/berth-columns.tsx
index 98e1c0d..3360f39 100644
--- a/src/components/berths/berth-columns.tsx
+++ b/src/components/berths/berth-columns.tsx
@@ -56,7 +56,12 @@ function ActionsCell({ row }: { row: { original: BerthRow } }) {
   return (
     <DropdownMenu>
       <DropdownMenuTrigger asChild>
-        <Button variant="ghost" size="icon" className="h-8 w-8" onClick={(e) => e.stopPropagation()}>
+        <Button
+          variant="ghost"
+          size="icon"
+          className="h-8 w-8"
+          onClick={(e) => e.stopPropagation()}
+        >
           <MoreHorizontal className="h-4 w-4" />
           <span className="sr-only">Open menu</span>
         </Button>
@@ -89,14 +94,12 @@ export const berthColumns: ColumnDef<BerthRow, unknown>[] = [
   {
     accessorKey: 'mooringNumber',
     header: 'Mooring #',
-    cell: ({ row }) => (
-      <span className="font-medium">{row.original.mooringNumber}</span>
-    ),
+    cell: ({ row }) => <span className="font-medium">{row.original.mooringNumber}</span>,
   },
   {
     accessorKey: 'area',
     header: 'Area',
-    cell: ({ row }) => row.original.area ?? '—',
+    cell: ({ row }) => row.original.area ?? '-',
   },
   {
     accessorKey: 'status',
@@ -109,7 +112,7 @@ export const berthColumns: ColumnDef<BerthRow, unknown>[] = [
     enableSorting: false,
     cell: ({ row }) => {
       const { lengthM, widthM } = row.original;
-      if (!lengthM && !widthM) return '—';
+      if (!lengthM && !widthM) return '-';
       return `${lengthM ?? '?'}m × ${widthM ?? '?'}m`;
     },
   },
@@ -118,7 +121,7 @@ export const berthColumns: ColumnDef<BerthRow, unknown>[] = [
     header: 'Price',
     cell: ({ row }) => {
       const { price, priceCurrency } = row.original;
-      if (!price) return '—';
+      if (!price) return '-';
       return new Intl.NumberFormat('en-US', {
         style: 'currency',
         currency: priceCurrency || 'USD',
@@ -129,8 +132,7 @@ export const berthColumns: ColumnDef<BerthRow, unknown>[] = [
   {
     accessorKey: 'tenureType',
     header: 'Tenure',
-    cell: ({ row }) =>
-      row.original.tenureType === 'permanent' ? 'Permanent' : 'Fixed Term',
+    cell: ({ row }) => (row.original.tenureType === 'permanent' ? 'Permanent' : 'Fixed Term'),
   },
   {
     id: 'tags',
diff --git a/src/components/berths/berth-form.tsx b/src/components/berths/berth-form.tsx
index bbaf349..83483a6 100644
--- a/src/components/berths/berth-form.tsx
+++ b/src/components/berths/berth-form.tsx
@@ -93,7 +93,7 @@ function SelectOrEmpty({
         <SelectValue placeholder={placeholder} />
       </SelectTrigger>
       <SelectContent>
-        <SelectItem value={NONE}>—</SelectItem>
+        <SelectItem value={NONE}>-</SelectItem>
         {options.map((opt) => (
           <SelectItem key={opt} value={opt}>
             {opt}
diff --git a/src/components/berths/berth-interests-tab.tsx b/src/components/berths/berth-interests-tab.tsx
index 286fba5..d88677f 100644
--- a/src/components/berths/berth-interests-tab.tsx
+++ b/src/components/berths/berth-interests-tab.tsx
@@ -168,7 +168,7 @@ export function BerthInterestsTab({ berthId }: BerthInterestsTabProps) {
                     href={`/${portSlug}/interests/${i.id}` as never}
                     className="hover:text-brand"
                   >
-                    {i.clientName ?? '—'}
+                    {i.clientName ?? '-'}
                   </Link>
                 </td>
                 <td className="px-3 py-2">
@@ -177,10 +177,10 @@ export function BerthInterestsTab({ berthId }: BerthInterestsTabProps) {
                   </Badge>
                 </td>
                 <td className="px-3 py-2 text-muted-foreground">
-                  {i.leadCategory ? (CATEGORY_LABELS[i.leadCategory] ?? i.leadCategory) : '—'}
+                  {i.leadCategory ? (CATEGORY_LABELS[i.leadCategory] ?? i.leadCategory) : '-'}
                 </td>
                 <td className="px-3 py-2 text-muted-foreground">
-                  {i.source ? (SOURCE_LABELS[i.source] ?? i.source) : '—'}
+                  {i.source ? (SOURCE_LABELS[i.source] ?? i.source) : '-'}
                 </td>
                 <td className="px-3 py-2 text-xs text-muted-foreground">
                   {new Date(i.createdAt).toLocaleDateString()}
diff --git a/src/components/berths/berth-list.tsx b/src/components/berths/berth-list.tsx
index 73bfe46..4f285d6 100644
--- a/src/components/berths/berth-list.tsx
+++ b/src/components/berths/berth-list.tsx
@@ -36,7 +36,7 @@ export function BerthList() {
         title="Berths"
         description="View and manage berth allocations"
         variant="gradient"
-        // No "New" button — berths are import-only
+        // No "New" button - berths are import-only
       />
 
       <div className="flex items-center gap-2 flex-wrap">
diff --git a/src/components/berths/berth-tabs.tsx b/src/components/berths/berth-tabs.tsx
index 7448592..7ebef00 100644
--- a/src/components/berths/berth-tabs.tsx
+++ b/src/components/berths/berth-tabs.tsx
@@ -109,7 +109,7 @@ function OverviewTab({ berth }: { berth: BerthData }) {
 
   return (
     <div className="space-y-6">
-      {/* Sales pulse — top-of-page so reps doing berth-level triage can see
+      {/* Sales pulse - top-of-page so reps doing berth-level triage can see
           who's interested + how warm without clicking into the Interests tab. */}
       <BerthInterestPulse berthId={berth.id} />
 
diff --git a/src/components/clients/client-columns.tsx b/src/components/clients/client-columns.tsx
index a93eeb3..bb6aee6 100644
--- a/src/components/clients/client-columns.tsx
+++ b/src/components/clients/client-columns.tsx
@@ -70,7 +70,7 @@ export function getClientColumns({
       enableSorting: false,
       cell: ({ row }) => {
         const primary = row.original.contacts?.find((c) => c.isPrimary);
-        if (!primary) return <span className="text-muted-foreground">—</span>;
+        if (!primary) return <span className="text-muted-foreground">-</span>;
         return (
           <span className="text-sm">
             <span className="text-muted-foreground capitalize">{primary.channel}: </span>
@@ -86,7 +86,7 @@ export function getClientColumns({
       cell: ({ getValue }) => {
         const iso = getValue() as string | null;
         return (
-          <span className="text-muted-foreground">{iso ? getCountryName(iso, 'en') : '—'}</span>
+          <span className="text-muted-foreground">{iso ? getCountryName(iso, 'en') : '-'}</span>
         );
       },
     },
@@ -96,7 +96,7 @@ export function getClientColumns({
       header: 'Source',
       cell: ({ getValue }) => {
         const source = getValue() as string | null;
-        if (!source) return <span className="text-muted-foreground">—</span>;
+        if (!source) return <span className="text-muted-foreground">-</span>;
         return (
           <Badge variant="outline" className="capitalize text-xs">
             {SOURCE_LABELS[source] ?? source}
@@ -111,7 +111,7 @@ export function getClientColumns({
       cell: ({ row }) => {
         const c = row.original.yachtCount ?? 0;
         return c === 0 ? (
-          <span className="text-muted-foreground">—</span>
+          <span className="text-muted-foreground">-</span>
         ) : (
           <Badge variant="secondary" className="text-xs">
             {c}
@@ -126,7 +126,7 @@ export function getClientColumns({
       cell: ({ row }) => {
         const c = row.original.companyCount ?? 0;
         return c === 0 ? (
-          <span className="text-muted-foreground">—</span>
+          <span className="text-muted-foreground">-</span>
         ) : (
           <Badge variant="secondary" className="text-xs">
             {c}
@@ -140,7 +140,7 @@ export function getClientColumns({
       enableSorting: false,
       cell: ({ row }) => {
         const clientTags = row.original.tags ?? [];
-        if (clientTags.length === 0) return <span className="text-muted-foreground">—</span>;
+        if (clientTags.length === 0) return <span className="text-muted-foreground">-</span>;
         return (
           <div className="flex flex-wrap gap-1">
             {clientTags.slice(0, 3).map((tag) => (
diff --git a/src/components/clients/client-companies-tab.tsx b/src/components/clients/client-companies-tab.tsx
index 80403dd..ada6f28 100644
--- a/src/components/clients/client-companies-tab.tsx
+++ b/src/components/clients/client-companies-tab.tsx
@@ -33,7 +33,7 @@ interface ClientCompaniesTabProps {
 
 function formatSince(startDate: string | Date): string {
   const d = typeof startDate === 'string' ? new Date(startDate) : startDate;
-  if (Number.isNaN(d.getTime())) return '—';
+  if (Number.isNaN(d.getTime())) return '-';
   return format(d, 'MMM d, yyyy');
 }
 
@@ -87,7 +87,7 @@ export function ClientCompaniesTab({ clientId: _clientId, companies }: ClientCom
                       Primary
                     </Badge>
                   ) : (
-                    <span className="text-muted-foreground">—</span>
+                    <span className="text-muted-foreground">-</span>
                   )}
                 </TableCell>
                 <TableCell className="text-muted-foreground text-sm">
diff --git a/src/components/clients/client-detail-header.tsx b/src/components/clients/client-detail-header.tsx
index efe9ab8..9ee531f 100644
--- a/src/components/clients/client-detail-header.tsx
+++ b/src/components/clients/client-detail-header.tsx
@@ -169,7 +169,7 @@ export function ClientDetailHeader({ client }: ClientDetailHeaderProps) {
             )}
           </div>
 
-          {/* Top-right: archive/restore as a small icon button — destructive
+          {/* Top-right: archive/restore as a small icon button - destructive
               action sits out of the primary action flow. */}
           <button
             type="button"
diff --git a/src/components/clients/client-form.tsx b/src/components/clients/client-form.tsx
index 0d3c5f7..07b4cfc 100644
--- a/src/components/clients/client-form.tsx
+++ b/src/components/clients/client-form.tsx
@@ -150,7 +150,7 @@ export function ClientForm({ open, onOpenChange, client, onUseExistingClient }:
         </SheetHeader>
 
         <form onSubmit={handleSubmit((data) => mutation.mutate(data))} className="space-y-6 py-6">
-          {/* Dedup suggestion — only on the create path. Watches the
+          {/* Dedup suggestion - only on the create path. Watches the
               live form values for email / phone / name and surfaces
               an existing client when one matches. The user can
               attach the new interest to that client instead of
diff --git a/src/components/clients/client-interests-tab.tsx b/src/components/clients/client-interests-tab.tsx
index 2e42402..bf8ab69 100644
--- a/src/components/clients/client-interests-tab.tsx
+++ b/src/components/clients/client-interests-tab.tsx
@@ -180,7 +180,7 @@ function InterestPreviewDrawer({
 }) {
   // Pin the most recently selected interest so the drawer stays populated
   // during the close-animation tail (Vaul keeps the content mounted ~250ms
-  // after `open=false`). Conditional setState is safe here — the guard
+  // after `open=false`). Conditional setState is safe here - the guard
   // ensures it only fires when the prop actually changes to a new row.
   const [pinned, setPinned] = useState<ClientInterestRow | null>(interest);
   if (interest && interest !== pinned) setPinned(interest);
@@ -243,7 +243,7 @@ function InterestPreviewDrawer({
         </DrawerHeader>
 
         <div className="space-y-5 overflow-y-auto px-4 pb-4">
-          {/* Pipeline-stepper segmented bar — the same primitive used on the
+          {/* Pipeline-stepper segmented bar - the same primitive used on the
               row card, so the at-a-glance progress hint is consistent
               across surfaces. */}
           {stage ? (
@@ -255,7 +255,7 @@ function InterestPreviewDrawer({
             </div>
           ) : null}
 
-          {/* Milestones — three sections matching the full interest detail
+          {/* Milestones - three sections matching the full interest detail
               page (EOI / Deposit / Contract). Done-state is derived from
               the pipeline stage so seed data without per-step dates still
               renders correctly. The full milestone columns + per-step
@@ -308,7 +308,7 @@ function InterestPreviewDrawer({
             </div>
           </section>
 
-          {/* Compact key/value pairs — lead category, source, last contact,
+          {/* Compact key/value pairs - lead category, source, last contact,
               activity. Each row collapses cleanly when its value is
               missing so the drawer scales from sparse seed data to full
               records without empty placeholders. */}
diff --git a/src/components/clients/client-pipeline-summary.tsx b/src/components/clients/client-pipeline-summary.tsx
index 3297d1b..1101832 100644
--- a/src/components/clients/client-pipeline-summary.tsx
+++ b/src/components/clients/client-pipeline-summary.tsx
@@ -106,8 +106,8 @@ function lastActivityLabel(interests: ClientInterestRow[]): string | null {
 interface PipelineSummaryProps {
   clientId: string;
   /**
-   * `hero` — single-line pulse for the detail header (highest active stage only).
-   * `panel` — compact list of every active interest, for the Overview tab.
+   * `hero` - single-line pulse for the detail header (highest active stage only).
+   * `panel` - compact list of every active interest, for the Overview tab.
    */
   variant?: 'hero' | 'panel';
 }
diff --git a/src/components/clients/client-yachts-tab.tsx b/src/components/clients/client-yachts-tab.tsx
index c724e32..0788264 100644
--- a/src/components/clients/client-yachts-tab.tsx
+++ b/src/components/clients/client-yachts-tab.tsx
@@ -74,9 +74,9 @@ export function ClientYachtsTab({ clientId: _clientId, yachts }: ClientYachtsTab
                     </Link>
                   </TableCell>
                   <TableCell>
-                    {y.lengthFt && y.widthFt ? `${y.lengthFt} × ${y.widthFt} ft` : '—'}
+                    {y.lengthFt && y.widthFt ? `${y.lengthFt} × ${y.widthFt} ft` : '-'}
                   </TableCell>
-                  <TableCell>{y.hullNumber ?? '—'}</TableCell>
+                  <TableCell>{y.hullNumber ?? '-'}</TableCell>
                   <TableCell className="capitalize">{y.status.replace('_', ' ')}</TableCell>
                 </TableRow>
               ))}
diff --git a/src/components/clients/contacts-editor.tsx b/src/components/clients/contacts-editor.tsx
index c94b19f..13e74a8 100644
--- a/src/components/clients/contacts-editor.tsx
+++ b/src/components/clients/contacts-editor.tsx
@@ -225,10 +225,10 @@ function ContactRow({
 
       {/* Bottom / right: tag + actions.
           Two layers of hiding compose here:
-            (a) phoneEditing — when the phone editor is open, hide the entire
+            (a) phoneEditing - when the phone editor is open, hide the entire
                 action cluster (tag + star + trash) so the user can focus on
                 the form without chips fighting for space.
-            (b) contact.value — when the value is empty (stale import row,
+            (b) contact.value - when the value is empty (stale import row,
                 aborted edit), hide just the tag + Make-primary star;
                 neither makes sense without a value. The trash icon stays
                 so the user can clean up the empty entry.
diff --git a/src/components/clients/dedup-suggestion-panel.tsx b/src/components/clients/dedup-suggestion-panel.tsx
index 7ac5bfb..92a5c3a 100644
--- a/src/components/clients/dedup-suggestion-panel.tsx
+++ b/src/components/clients/dedup-suggestion-panel.tsx
@@ -63,7 +63,7 @@ export function DedupSuggestionPanel({
   useEffect(() => {
     const t = setTimeout(() => {
       setDebounced({ email: email ?? '', phone: phone ?? '', name: name ?? '' });
-      // Clear the dismissed flag when inputs change — the user typed
+      // Clear the dismissed flag when inputs change - the user typed
       // something new, so the prior dismissal no longer applies.
       setDismissed(false);
     }, 300);
@@ -83,7 +83,7 @@ export function DedupSuggestionPanel({
       return apiFetch<{ data: MatchData[] }>(`/api/v1/clients/match-candidates?${params}`);
     },
     enabled: hasSomething && !dismissed,
-    // Same query is fine to cache for a minute — moves are slow at this layer.
+    // Same query is fine to cache for a minute - moves are slow at this layer.
     staleTime: 60_000,
   });
 
@@ -120,7 +120,7 @@ export function DedupSuggestionPanel({
           <p className="text-sm font-semibold leading-tight">
             {isHigh
               ? 'This looks like an existing client'
-              : 'Possible match — check before creating'}
+              : 'Possible match - check before creating'}
           </p>
           <div className="mt-2 rounded-md border bg-background/80 p-2.5">
             <div className="flex items-center gap-2">
diff --git a/src/components/clients/gdpr-export-button.tsx b/src/components/clients/gdpr-export-button.tsx
index ea7e113..b550bfe 100644
--- a/src/components/clients/gdpr-export-button.tsx
+++ b/src/components/clients/gdpr-export-button.tsx
@@ -74,7 +74,7 @@ export function GdprExportButton({ clientId }: { clientId: string }) {
         },
       }),
     onSuccess: () => {
-      toast.success('Export queued — refresh in ~30 seconds');
+      toast.success('Export queued - refresh in ~30 seconds');
       qc.invalidateQueries({ queryKey });
       setEmailOverride('');
     },
@@ -128,7 +128,7 @@ export function GdprExportButton({ clientId }: { clientId: string }) {
                 Email the bundle when ready
               </Label>
               <p className="text-xs text-muted-foreground">
-                Sends a 7-day signed download link to the client&apos;s primary email — or to the
+                Sends a 7-day signed download link to the client&apos;s primary email - or to the
                 override below.
               </p>
               {emailToClient ? (
diff --git a/src/components/companies/add-membership-dialog.tsx b/src/components/companies/add-membership-dialog.tsx
index 8795729..2ad4ca1 100644
--- a/src/components/companies/add-membership-dialog.tsx
+++ b/src/components/companies/add-membership-dialog.tsx
@@ -122,7 +122,7 @@ export function AddMembershipDialog({ open, onOpenChange, companyId }: AddMember
     },
     onError: (err: unknown) => {
       let msg = err instanceof Error ? err.message : 'Failed to add membership';
-      // Detect 409 — service returns a "membership already exists" message
+      // Detect 409 - service returns a "membership already exists" message
       if (/already exists/i.test(msg)) {
         msg = 'This membership already exists (same client + role + start date).';
       }
diff --git a/src/components/companies/company-columns.tsx b/src/components/companies/company-columns.tsx
index fead737..a543740 100644
--- a/src/components/companies/company-columns.tsx
+++ b/src/components/companies/company-columns.tsx
@@ -76,7 +76,7 @@ export function getCompanyColumns({
       enableSorting: false,
       cell: ({ getValue }) => {
         const value = getValue() as string | null;
-        if (!value) return <span className="text-muted-foreground">—</span>;
+        if (!value) return <span className="text-muted-foreground">-</span>;
         return <span className="text-sm">{value}</span>;
       },
     },
@@ -87,7 +87,7 @@ export function getCompanyColumns({
       enableSorting: false,
       cell: ({ getValue }) => {
         const value = getValue() as string | null;
-        if (!value) return <span className="text-muted-foreground">—</span>;
+        if (!value) return <span className="text-muted-foreground">-</span>;
         return <span className="text-sm">{value}</span>;
       },
     },
@@ -98,7 +98,7 @@ export function getCompanyColumns({
       size: 88,
       cell: ({ row }) => {
         const n = row.original.memberCount ?? 0;
-        if (n === 0) return <span className="text-muted-foreground">—</span>;
+        if (n === 0) return <span className="text-muted-foreground">-</span>;
         return <Badge variant="secondary">{n}</Badge>;
       },
     },
@@ -109,7 +109,7 @@ export function getCompanyColumns({
       size: 88,
       cell: ({ row }) => {
         const n = row.original.yachtCount ?? 0;
-        if (n === 0) return <span className="text-muted-foreground">—</span>;
+        if (n === 0) return <span className="text-muted-foreground">-</span>;
         return <Badge variant="secondary">{n}</Badge>;
       },
     },
diff --git a/src/components/companies/company-form.tsx b/src/components/companies/company-form.tsx
index 3f2fa1a..a3d97ec 100644
--- a/src/components/companies/company-form.tsx
+++ b/src/components/companies/company-form.tsx
@@ -101,7 +101,7 @@ export function CompanyForm({ open, onOpenChange, company }: CompanyFormProps) {
   const mutation = useMutation({
     mutationFn: async (data: CreateCompanyInput) => {
       if (isEdit) {
-        // updateCompanySchema omits tagIds — strip them from PATCH body.
+        // updateCompanySchema omits tagIds - strip them from PATCH body.
         const { tagIds: _tIds, ...rest } = data;
         void _tIds;
         await apiFetch(`/api/v1/companies/${company!.id}`, {
@@ -178,7 +178,7 @@ export function CompanyForm({ open, onOpenChange, company }: CompanyFormProps) {
                   value={watch('incorporationCountryIso')}
                   onChange={(iso) => {
                     setValue('incorporationCountryIso', iso ?? undefined);
-                    // Wipe subdivision when country flips — codes are country-scoped.
+                    // Wipe subdivision when country flips - codes are country-scoped.
                     setValue('incorporationSubdivisionIso', undefined);
                   }}
                   data-testid="company-incorp-country"
diff --git a/src/components/companies/company-members-tab.tsx b/src/components/companies/company-members-tab.tsx
index dbe8a5a..8399481 100644
--- a/src/components/companies/company-members-tab.tsx
+++ b/src/components/companies/company-members-tab.tsx
@@ -56,7 +56,7 @@ const ROLE_LABELS: Record<string, string> = {
 };
 
 function formatDate(value: string | null): string {
-  if (!value) return '—';
+  if (!value) return '-';
   const date = new Date(value);
   if (Number.isNaN(date.getTime())) return value;
   return date.toLocaleDateString();
@@ -201,14 +201,14 @@ export function CompanyMembersTab({ companyId, portSlug }: CompanyMembersTabProp
                     </TableCell>
                     <TableCell>{ROLE_LABELS[m.role] ?? m.role}</TableCell>
                     <TableCell className="text-sm text-muted-foreground max-w-[240px] truncate">
-                      {m.roleDetail ?? '—'}
+                      {m.roleDetail ?? '-'}
                     </TableCell>
                     <TableCell>{formatDate(m.startDate)}</TableCell>
                     <TableCell>
                       {m.endDate ? (
                         formatDate(m.endDate)
                       ) : (
-                        <span className="text-muted-foreground">—</span>
+                        <span className="text-muted-foreground">-</span>
                       )}
                     </TableCell>
                     <TableCell>
@@ -217,7 +217,7 @@ export function CompanyMembersTab({ companyId, portSlug }: CompanyMembersTabProp
                           Primary
                         </Badge>
                       ) : (
-                        <span className="text-muted-foreground">—</span>
+                        <span className="text-muted-foreground">-</span>
                       )}
                     </TableCell>
                     <TableCell>
diff --git a/src/components/companies/company-owned-yachts-tab.tsx b/src/components/companies/company-owned-yachts-tab.tsx
index 63145ae..6cd70b0 100644
--- a/src/components/companies/company-owned-yachts-tab.tsx
+++ b/src/components/companies/company-owned-yachts-tab.tsx
@@ -49,13 +49,13 @@ const STATUS_LABELS: Record<string, string> = {
 
 function formatDimensions(y: OwnedYachtRow): string | null {
   if (y.lengthFt || y.widthFt) {
-    const length = y.lengthFt ?? '—';
-    const width = y.widthFt ?? '—';
+    const length = y.lengthFt ?? '-';
+    const width = y.widthFt ?? '-';
     return `${length} × ${width} ft`;
   }
   if (y.lengthM || y.widthM) {
-    const length = y.lengthM ?? '—';
-    const width = y.widthM ?? '—';
+    const length = y.lengthM ?? '-';
+    const width = y.widthM ?? '-';
     return `${length} × ${width} m`;
   }
   return null;
@@ -129,14 +129,14 @@ export function CompanyOwnedYachtsTab({ companyId, portSlug }: CompanyOwnedYacht
                   {dims ? (
                     <span className="text-sm">{dims}</span>
                   ) : (
-                    <span className="text-muted-foreground">—</span>
+                    <span className="text-muted-foreground">-</span>
                   )}
                 </TableCell>
                 <TableCell>
                   {y.hullNumber ? (
                     <span className="text-sm">{y.hullNumber}</span>
                   ) : (
-                    <span className="text-muted-foreground">—</span>
+                    <span className="text-muted-foreground">-</span>
                   )}
                 </TableCell>
                 <TableCell>
diff --git a/src/components/companies/company-tabs.tsx b/src/components/companies/company-tabs.tsx
index 4fa2b44..a779552 100644
--- a/src/components/companies/company-tabs.tsx
+++ b/src/components/companies/company-tabs.tsx
@@ -125,7 +125,7 @@ function OverviewTab({ companyId, company }: { companyId: string; company: Compa
             <InlineCountryField
               value={company.incorporationCountryIso}
               onSave={async (iso) => {
-                // Wipe subdivision when country flips — codes are country-scoped.
+                // Wipe subdivision when country flips - codes are country-scoped.
                 await mutation.mutateAsync({
                   incorporationCountryIso: iso,
                   incorporationSubdivisionIso: null,
@@ -175,7 +175,7 @@ function OverviewTab({ companyId, company }: { companyId: string; company: Compa
           variant="textarea"
           value={company.notes}
           onSave={save('notes')}
-          emptyText="No notes — click to add"
+          emptyText="No notes - click to add"
         />
       </div>
 
diff --git a/src/components/dashboard/activity-feed.tsx b/src/components/dashboard/activity-feed.tsx
index 1be7492..7a07b8f 100644
--- a/src/components/dashboard/activity-feed.tsx
+++ b/src/components/dashboard/activity-feed.tsx
@@ -58,7 +58,7 @@ function ActivityFeedInner() {
       <CardContent>
         {items.length === 0 ? (
           <p className="text-sm text-muted-foreground">
-            No recent activity yet — your team&apos;s actions (interests created, stages changed,
+            No recent activity yet - your team&apos;s actions (interests created, stages changed,
             invoices sent) will appear here.
           </p>
         ) : (
diff --git a/src/components/dashboard/lead-source-chart.tsx b/src/components/dashboard/lead-source-chart.tsx
index 7247aa9..9ec4782 100644
--- a/src/components/dashboard/lead-source-chart.tsx
+++ b/src/components/dashboard/lead-source-chart.tsx
@@ -56,7 +56,7 @@ export function LeadSourceChart({ range }: Props) {
       ) : !slices.length ? (
         <EmptyState
           title="No interests in range"
-          description="Lights up once new interests are created — tracks where each came from (website, referral, broker)."
+          description="Lights up once new interests are created - tracks where each came from (website, referral, broker)."
         />
       ) : (
         // Percentage radii + center-anchored chart so the pie scales with
diff --git a/src/components/documents/document-detail.tsx b/src/components/documents/document-detail.tsx
index d1c3aca..af4df7f 100644
--- a/src/components/documents/document-detail.tsx
+++ b/src/components/documents/document-detail.tsx
@@ -174,7 +174,7 @@ export function DocumentDetail({ documentId, portSlug }: DocumentDetailProps) {
         data: { to: string[]; subject: string; attachments: Array<{ fileId: string }> };
       }>(`/api/v1/documents/${documentId}/compose-completion-email`, { method: 'POST' });
       toast.info(
-        `Email composer prepared for ${draft.data.to.length} signer${draft.data.to.length === 1 ? '' : 's'} — opens in PR8 wizard`,
+        `Email composer prepared for ${draft.data.to.length} signer${draft.data.to.length === 1 ? '' : 's'} - opens in PR8 wizard`,
       );
     } catch (err) {
       toast.error(err instanceof Error ? err.message : 'Failed to prepare email');
diff --git a/src/components/documents/document-list.tsx b/src/components/documents/document-list.tsx
index 8e0add2..38a51e7 100644
--- a/src/components/documents/document-list.tsx
+++ b/src/components/documents/document-list.tsx
@@ -26,7 +26,7 @@ interface DocumentListProps {
   interestId?: string;
   clientId?: string;
   /** Override the default empty state ("No documents yet.") with a contextual
-   *  CTA — e.g. on the interest Documents tab we render a Generate EOI prompt. */
+   *  CTA - e.g. on the interest Documents tab we render a Generate EOI prompt. */
   emptyState?: React.ReactNode;
 }
 
@@ -80,7 +80,7 @@ export function DocumentList({ interestId, clientId, emptyState }: DocumentListP
   };
 
   const getSignerProgress = (doc: DocumentRow) => {
-    if (!doc.signers) return '—';
+    if (!doc.signers) return '-';
     const signed = doc.signers.filter((s) => s.status === 'signed').length;
     return `${signed}/${doc.signers.length} signed`;
   };
diff --git a/src/components/documents/documents-hub.tsx b/src/components/documents/documents-hub.tsx
index 9870f4f..cbf9980 100644
--- a/src/components/documents/documents-hub.tsx
+++ b/src/components/documents/documents-hub.tsx
@@ -180,7 +180,7 @@ export function DocumentsHub({ portSlug, initialTab = 'all' }: DocumentsHubProps
             {isNonSignature && doc.status === 'sent' ? 'Delivered' : doc.status.replace(/_/g, ' ')}
           </StatusPill>
           <span className="text-xs tabular-nums text-muted-foreground">
-            {totalSigners > 0 ? `${signedCount}/${totalSigners} signed` : '—'}
+            {totalSigners > 0 ? `${signedCount}/${totalSigners} signed` : '-'}
           </span>
           <span className="text-xs text-muted-foreground">
             {new Date(doc.createdAt).toLocaleDateString('en-GB')}
diff --git a/src/components/documents/eoi-generate-dialog.tsx b/src/components/documents/eoi-generate-dialog.tsx
index 1ebd889..8fdbee9 100644
--- a/src/components/documents/eoi-generate-dialog.tsx
+++ b/src/components/documents/eoi-generate-dialog.tsx
@@ -22,14 +22,14 @@ import {
 import { Label } from '@/components/ui/label';
 import { apiFetch } from '@/lib/api/client';
 
-/** Required for the EOI's top paragraph (Section 2) — without these the
+/** Required for the EOI's top paragraph (Section 2) - without these the
  *  document is unsignable, so generation is blocked. Yacht and berth fields
  *  belong to Section 3 and may be left blank. */
 interface EoiPrerequisites {
   hasName: boolean;
   hasEmail: boolean;
   hasAddress: boolean;
-  /** Optional — info-only checks. Generation proceeds without them. */
+  /** Optional - info-only checks. Generation proceeds without them. */
   hasYacht: boolean;
   hasBerth: boolean;
 }
@@ -180,7 +180,7 @@ export function EoiGenerateDialog({
 
             <div className="space-y-1.5">
               <p className="text-xs font-medium text-muted-foreground">
-                Optional (Section 3 — left blank if absent)
+                Optional (Section 3 - left blank if absent)
               </p>
               {OPTIONAL_LABELS.map(({ key, label }) => (
                 <div key={key} className="flex items-center gap-3 text-sm">
diff --git a/src/components/expenses/expense-card.tsx b/src/components/expenses/expense-card.tsx
index be9d037..391bc4f 100644
--- a/src/components/expenses/expense-card.tsx
+++ b/src/components/expenses/expense-card.tsx
@@ -156,7 +156,7 @@ export function ExpenseCard({ expense, portSlug, onEdit, onArchive }: ExpenseCar
             </p>
           ) : null}
 
-          {/* Amount — prominent */}
+          {/* Amount - prominent */}
           <p className="mt-1 text-base font-semibold tabular-nums text-foreground">
             {amountFormatted}
           </p>
diff --git a/src/components/expenses/expense-columns.tsx b/src/components/expenses/expense-columns.tsx
index d02d22e..7c68a81 100644
--- a/src/components/expenses/expense-columns.tsx
+++ b/src/components/expenses/expense-columns.tsx
@@ -72,7 +72,7 @@ export function getExpenseColumns({
           className="font-medium text-primary hover:underline"
           onClick={(e) => e.stopPropagation()}
         >
-          {row.original.establishmentName ?? '—'}
+          {row.original.establishmentName ?? '-'}
         </Link>
       ),
     },
@@ -113,7 +113,7 @@ export function getExpenseColumns({
       header: 'Category',
       cell: ({ getValue }) => {
         const cat = getValue() as string | null;
-        if (!cat) return <span className="text-muted-foreground">—</span>;
+        if (!cat) return <span className="text-muted-foreground">-</span>;
         return (
           <Badge variant="outline" className="capitalize text-xs">
             {cat.replace(/_/g, ' ')}
diff --git a/src/components/expenses/expense-detail.tsx b/src/components/expenses/expense-detail.tsx
index 59d5d51..9d1f285 100644
--- a/src/components/expenses/expense-detail.tsx
+++ b/src/components/expenses/expense-detail.tsx
@@ -146,19 +146,19 @@ export function ExpenseDetail({ expenseId, onEdit, onArchived }: ExpenseDetailPr
         <CardContent className="grid grid-cols-2 gap-4 text-sm">
           <div>
             <span className="text-muted-foreground">Category</span>
-            <p className="mt-0.5 capitalize">{expense.category?.replace(/_/g, ' ') ?? '—'}</p>
+            <p className="mt-0.5 capitalize">{expense.category?.replace(/_/g, ' ') ?? '-'}</p>
           </div>
           <div>
             <span className="text-muted-foreground">Payment Method</span>
-            <p className="mt-0.5 capitalize">{expense.paymentMethod?.replace(/_/g, ' ') ?? '—'}</p>
+            <p className="mt-0.5 capitalize">{expense.paymentMethod?.replace(/_/g, ' ') ?? '-'}</p>
           </div>
           <div>
             <span className="text-muted-foreground">Payer</span>
-            <p className="mt-0.5">{expense.payer ?? '—'}</p>
+            <p className="mt-0.5">{expense.payer ?? '-'}</p>
           </div>
           <div>
             <span className="text-muted-foreground">Description</span>
-            <p className="mt-0.5">{expense.description ?? '—'}</p>
+            <p className="mt-0.5">{expense.description ?? '-'}</p>
           </div>
         </CardContent>
       </Card>
diff --git a/src/components/interests/inline-stage-picker.tsx b/src/components/interests/inline-stage-picker.tsx
index d0cd5b8..acfcd60 100644
--- a/src/components/interests/inline-stage-picker.tsx
+++ b/src/components/interests/inline-stage-picker.tsx
@@ -30,7 +30,7 @@ interface InlineStagePickerProps {
 
 /**
  * Click-to-change stage chip. Replaces the modal-based InterestStagePicker
- * for inline editing — user clicks the chip, picks a new stage from the
+ * for inline editing - user clicks the chip, picks a new stage from the
  * popover (with optional reason), commits in one click. The popover stays
  * compact: a small reason field above the stage list, and clicking any stage
  * fires the mutation immediately.
@@ -140,7 +140,7 @@ export function InlineStagePicker({
                     isCurrent && 'font-medium',
                   )}
                 >
-                  {/* Colored chip (mirrors the inline stage badge) — turns
+                  {/* Colored chip (mirrors the inline stage badge) - turns
                        the picker into a visual scan rather than just a list. */}
                   <span
                     className={cn('inline-flex h-5 w-3 shrink-0 rounded-sm', STAGE_DOT[s])}
diff --git a/src/components/interests/interest-columns.tsx b/src/components/interests/interest-columns.tsx
index 6679fbf..9be0189 100644
--- a/src/components/interests/interest-columns.tsx
+++ b/src/components/interests/interest-columns.tsx
@@ -78,7 +78,7 @@ export function getInterestColumns({
               className="truncate font-medium text-primary hover:underline"
               onClick={(e) => e.stopPropagation()}
             >
-              {row.original.clientName ?? '—'}
+              {row.original.clientName ?? '-'}
             </Link>
             {notesCount > 0 ? (
               <span
@@ -99,7 +99,7 @@ export function getInterestColumns({
       header: 'Berth',
       cell: ({ row }) => {
         if (!row.original.berthId || !row.original.berthMooringNumber) {
-          return <span className="text-muted-foreground">—</span>;
+          return <span className="text-muted-foreground">-</span>;
         }
         return (
           <Link
@@ -150,7 +150,7 @@ export function getInterestColumns({
       header: 'Category',
       cell: ({ getValue }) => {
         const cat = getValue() as string | null;
-        if (!cat) return <span className="text-muted-foreground">—</span>;
+        if (!cat) return <span className="text-muted-foreground">-</span>;
         return (
           <Badge variant="outline" className="text-xs capitalize">
             {CATEGORY_LABELS[cat] ?? cat}
@@ -164,7 +164,7 @@ export function getInterestColumns({
       header: 'Source',
       cell: ({ getValue }) => {
         const source = getValue() as string | null;
-        if (!source) return <span className="text-muted-foreground">—</span>;
+        if (!source) return <span className="text-muted-foreground">-</span>;
         return (
           <Badge variant="outline" className="text-xs">
             {SOURCE_LABELS[source] ?? source}
@@ -178,7 +178,7 @@ export function getInterestColumns({
       enableSorting: false,
       cell: ({ row }) => {
         const rowTags = row.original.tags ?? [];
-        if (rowTags.length === 0) return <span className="text-muted-foreground">—</span>;
+        if (rowTags.length === 0) return <span className="text-muted-foreground">-</span>;
         return (
           <div className="flex flex-wrap gap-1">
             {rowTags.slice(0, 3).map((tag) => (
@@ -203,7 +203,7 @@ export function getInterestColumns({
       cell: ({ row }) => {
         const lastIso = row.original.dateLastContact ?? row.original.updatedAt ?? null;
         if (!lastIso) {
-          return <span className="text-muted-foreground text-sm">—</span>;
+          return <span className="text-muted-foreground text-sm">-</span>;
         }
         const d = new Date(lastIso);
         return (
diff --git a/src/components/interests/interest-detail-header.tsx b/src/components/interests/interest-detail-header.tsx
index b50d8cd..de5b35f 100644
--- a/src/components/interests/interest-detail-header.tsx
+++ b/src/components/interests/interest-detail-header.tsx
@@ -30,9 +30,9 @@ import { cn } from '@/lib/utils';
 
 const OUTCOME_BADGE: Record<string, { label: string; className: string }> = {
   won: { label: 'Won', className: 'bg-emerald-100 text-emerald-700' },
-  lost_other_marina: { label: 'Lost — other marina', className: 'bg-rose-100 text-rose-700' },
-  lost_unqualified: { label: 'Lost — unqualified', className: 'bg-rose-100 text-rose-700' },
-  lost_no_response: { label: 'Lost — no response', className: 'bg-rose-100 text-rose-700' },
+  lost_other_marina: { label: 'Lost - other marina', className: 'bg-rose-100 text-rose-700' },
+  lost_unqualified: { label: 'Lost - unqualified', className: 'bg-rose-100 text-rose-700' },
+  lost_no_response: { label: 'Lost - no response', className: 'bg-rose-100 text-rose-700' },
   cancelled: { label: 'Cancelled', className: 'bg-slate-200 text-slate-700' },
 };
 
@@ -69,7 +69,7 @@ interface InterestDetailHeaderProps {
     clientPrimaryPhone?: string | null;
     clientPrimaryPhoneE164?: string | null;
     /** Pending/snoozed reminders attached to this interest. Drives the
-     *  alarm-bell badge on the header — surfaces follow-ups so the rep
+     *  alarm-bell badge on the header - surfaces follow-ups so the rep
      *  doesn't have to remember to check /reminders. */
     activeReminderCount?: number;
     berthId: string | null;
@@ -107,7 +107,7 @@ export function InterestDetailHeader({ portSlug, interest }: InterestDetailHeade
   const outcomeBadge = resolveOutcomeBadge(interest.outcome);
   const isClosed = !!interest.outcome;
 
-  // Contact deep-links — resolved from the linked client's primary channels.
+  // Contact deep-links - resolved from the linked client's primary channels.
   // wa.me requires the digits-only E.164 number (no leading "+"); fall back to
   // stripping non-digits from the display value when the canonical form is
   // missing.
@@ -258,7 +258,7 @@ export function InterestDetailHeader({ portSlug, interest }: InterestDetailHeade
               </div>
             )}
 
-            {/* Contact deep-links — let the rep email / call / WhatsApp the
+            {/* Contact deep-links - let the rep email / call / WhatsApp the
                 client without leaving the interest workspace. Resolved from
                 the linked client's primary contact channels (server-side
                 fetch in getInterestById). */}
@@ -343,7 +343,7 @@ export function InterestDetailHeader({ portSlug, interest }: InterestDetailHeade
                       the won/lost meaning (green vs rose). Adding a "Won" /
                       "Lost" text label inline blew out the cluster width and
                       forced the Email/Call/WhatsApp action-chip row above to
-                      stack vertically — bad trade. From sm up, the full
+                      stack vertically - bad trade. From sm up, the full
                       "Mark won" / "Close as lost" labels read clearly. */}
                   <button
                     type="button"
diff --git a/src/components/interests/interest-documents-tab.tsx b/src/components/interests/interest-documents-tab.tsx
index 046e7b3..2bcb6e9 100644
--- a/src/components/interests/interest-documents-tab.tsx
+++ b/src/components/interests/interest-documents-tab.tsx
@@ -36,7 +36,7 @@ export function InterestDocumentsTab({ interestId }: InterestDocumentsTabProps)
   });
 
   const prerequisites = {
-    // Required (EOI Section 2 — top paragraph): name, address, email.
+    // Required (EOI Section 2 - top paragraph): name, address, email.
     hasName: Boolean(interest?.clientName),
     hasEmail: Boolean(interest?.clientPrimaryEmail),
     hasAddress: Boolean(interest?.clientHasAddress),
diff --git a/src/components/interests/interest-form.tsx b/src/components/interests/interest-form.tsx
index 43311ce..56c0723 100644
--- a/src/components/interests/interest-form.tsx
+++ b/src/components/interests/interest-form.tsx
@@ -314,7 +314,7 @@ export function InterestForm({ open, onOpenChange, defaultClientId, interest }:
               <p className="text-xs text-muted-foreground">
                 Required before the interest can leave the &quot;Open&quot; stage.
               </p>
-              {/* TODO: also include company-owned yachts where client is a member — requires autocomplete owner=any|company filter */}
+              {/* TODO: also include company-owned yachts where client is a member - requires autocomplete owner=any|company filter */}
               {/* TODO: add "Add new yacht" inline shortcut (requires YachtForm integration) */}
             </div>
           </div>
diff --git a/src/components/interests/interest-list.tsx b/src/components/interests/interest-list.tsx
index c1357fb..268e9d9 100644
--- a/src/components/interests/interest-list.tsx
+++ b/src/components/interests/interest-list.tsx
@@ -71,7 +71,7 @@ export function InterestList() {
 
   const bulkArchiveMutation = useMutation({
     mutationFn: async (ids: string[]) => {
-      // Concurrent fan-out — small batches in practice (page size cap = 100).
+      // Concurrent fan-out - small batches in practice (page size cap = 100).
       // If a single delete fails the others still run; the rejected one
       // surfaces a toast via the standard apiFetch error path.
       await Promise.all(ids.map((id) => apiFetch(`/api/v1/interests/${id}`, { method: 'DELETE' })));
@@ -194,7 +194,7 @@ export function InterestList() {
         />
       )}
 
-      {/* Mobile FAB — primary "New interest" affordance for the bottom-tab UX.
+      {/* Mobile FAB - primary "New interest" affordance for the bottom-tab UX.
            Sits above the bottom nav (pb-safe-bottom + 70px tab height + 16px
            gap). Hidden on lg+ where the header button already does the job. */}
       <PermissionGate resource="interests" action="create">
diff --git a/src/components/interests/interest-outcome-dialog.tsx b/src/components/interests/interest-outcome-dialog.tsx
index 0dc8163..00d71f1 100644
--- a/src/components/interests/interest-outcome-dialog.tsx
+++ b/src/components/interests/interest-outcome-dialog.tsx
@@ -26,9 +26,9 @@ import { type InterestOutcome } from '@/lib/validators/interests';
 
 const OUTCOME_LABELS: Record<InterestOutcome, string> = {
   won: 'Won',
-  lost_other_marina: 'Lost — went to another marina',
-  lost_unqualified: 'Lost — unqualified',
-  lost_no_response: 'Lost — no response',
+  lost_other_marina: 'Lost - went to another marina',
+  lost_unqualified: 'Lost - unqualified',
+  lost_no_response: 'Lost - no response',
   cancelled: 'Cancelled',
 };
 
diff --git a/src/components/interests/interest-score-badge.tsx b/src/components/interests/interest-score-badge.tsx
index fad7856..8a78cc7 100644
--- a/src/components/interests/interest-score-badge.tsx
+++ b/src/components/interests/interest-score-badge.tsx
@@ -2,12 +2,7 @@
 
 import { useQuery } from '@tanstack/react-query';
 
-import {
-  Tooltip,
-  TooltipContent,
-  TooltipProvider,
-  TooltipTrigger,
-} from '@/components/ui/tooltip';
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '@/components/ui/tooltip';
 import { useFeatureFlag } from '@/hooks/use-feature-flag';
 import { apiFetch } from '@/lib/api/client';
 import type { InterestScore } from '@/lib/services/interest-scoring.service';
@@ -15,9 +10,12 @@ import type { InterestScore } from '@/lib/services/interest-scoring.service';
 // ─── Score tier helpers ───────────────────────────────────────────────────────
 
 function getScoreTier(score: number): { label: string; className: string } {
-  if (score >= 80) return { label: 'Hot', className: 'bg-green-100 text-green-800 border-green-200' };
-  if (score >= 60) return { label: 'Warm', className: 'bg-yellow-100 text-yellow-800 border-yellow-200' };
-  if (score >= 40) return { label: 'Cool', className: 'bg-orange-100 text-orange-800 border-orange-200' };
+  if (score >= 80)
+    return { label: 'Hot', className: 'bg-green-100 text-green-800 border-green-200' };
+  if (score >= 60)
+    return { label: 'Warm', className: 'bg-yellow-100 text-yellow-800 border-yellow-200' };
+  if (score >= 40)
+    return { label: 'Cool', className: 'bg-orange-100 text-orange-800 border-orange-200' };
   return { label: 'Cold', className: 'bg-gray-100 text-gray-700 border-gray-200' };
 }
 
@@ -34,7 +32,7 @@ export function InterestScoreBadge({ interestId }: InterestScoreBadgeProps) {
     queryKey: ['interest-score', interestId],
     queryFn: () => apiFetch(`/api/v1/ai/interest-score?interestId=${interestId}`),
     enabled: featureEnabled,
-    staleTime: 60 * 60 * 1000, // 1 hour — mirrors server-side cache TTL
+    staleTime: 60 * 60 * 1000, // 1 hour - mirrors server-side cache TTL
   });
 
   if (!featureEnabled) return null;
diff --git a/src/components/interests/interest-tabs.tsx b/src/components/interests/interest-tabs.tsx
index 699e024..e3fcb64 100644
--- a/src/components/interests/interest-tabs.tsx
+++ b/src/components/interests/interest-tabs.tsx
@@ -55,7 +55,7 @@ interface InterestTabsOptions {
     reminderLastFired: string | null;
     notes: string | null;
     /** Surfaced by getInterestById for the Overview "most recent note"
-     *  teaser — saves a click into the Notes tab to peek at the latest. */
+     *  teaser - saves a click into the Notes tab to peek at the latest. */
     notesCount?: number;
     recentNote?: {
       id: string;
@@ -145,7 +145,7 @@ interface MilestoneSectionProps {
   onAdvance: (stage: string) => void;
   isPending: boolean;
   /** Current pipelineStage. Used to mark steps as done when the pipeline has
-   *  moved past their advanceStage even if the date stamp is missing — e.g.
+   *  moved past their advanceStage even if the date stamp is missing - e.g.
    *  a seed-data interest that started already at eoi_signed will show both
    *  EOI sub-steps as done. Stage truth > date truth. */
   currentStage: string;
@@ -158,7 +158,7 @@ interface MilestoneSectionProps {
 }
 
 /**
- * One milestone section (EOI / Deposit / Contract) — shows a vertical lifecycle
+ * One milestone section (EOI / Deposit / Contract) - shows a vertical lifecycle
  * with completed steps checked, the next step exposing a quick "mark as…"
  * button that bumps the pipeline stage. Each stage flip auto-stamps its date
  * via the service layer (interests.service.ts). When external systems wire in
@@ -308,7 +308,7 @@ function OverviewTab({
 
   return (
     <div className="space-y-6">
-      {/* Sales-process milestones — the heart of the system. Each section is a
+      {/* Sales-process milestones - the heart of the system. Each section is a
           mini lifecycle that auto-completes as actions happen on the platform
           (Documenso webhook, paid deposit invoice, signed contract). Until the
           automation lands, salespeople nudge stages forward via the inline
@@ -420,7 +420,7 @@ function OverviewTab({
           </dl>
         </div>
 
-        {/* Contact dates (read-only — kept compact next to Lead) */}
+        {/* Contact dates (read-only - kept compact next to Lead) */}
         <div className="space-y-1">
           <h3 className="text-sm font-medium mb-2">Contact</h3>
           <dl>
@@ -484,7 +484,7 @@ function OverviewTab({
             variant="textarea"
             value={interest.notes}
             onSave={save('notes')}
-            emptyText="No notes — click to add"
+            emptyText="No notes - click to add"
           />
         </div>
 
diff --git a/src/components/interests/urgency.ts b/src/components/interests/urgency.ts
index 87a0d54..11d997a 100644
--- a/src/components/interests/urgency.ts
+++ b/src/components/interests/urgency.ts
@@ -2,7 +2,7 @@
  * Sales-triage urgency badges for interest list rows + cards.
  *
  * Derived purely from the dates we already return on the row, so this is a
- * pure function — no DB hits, no extra fetch. Mirrors the logic the
+ * pure function - no DB hits, no extra fetch. Mirrors the logic the
  * server-side alert-rules engine uses, but for at-a-glance rendering on
  * the list itself.
  */
@@ -47,7 +47,7 @@ export function computeUrgencyBadges(row: InterestUrgencyInput): UrgencyBadge[]
 
   const badges: UrgencyBadge[] = [];
 
-  // Silent in mid-funnel stages — most actionable.
+  // Silent in mid-funnel stages - most actionable.
   if (ACTIVE_MID_FUNNEL_STAGES.has(row.pipelineStage)) {
     const lastTouchIso = row.dateLastContact ?? row.updatedAt ?? null;
     const days = daysSince(lastTouchIso);
diff --git a/src/components/invoices/invoice-card.tsx b/src/components/invoices/invoice-card.tsx
index c81e857..f1f1282 100644
--- a/src/components/invoices/invoice-card.tsx
+++ b/src/components/invoices/invoice-card.tsx
@@ -155,7 +155,7 @@ export function InvoiceCard({
             <span className="truncate">{invoice.clientName}</span>
           </p>
 
-          {/* Amount — prominent */}
+          {/* Amount - prominent */}
           <p className="mt-1 text-base font-semibold tabular-nums text-foreground">
             {amountFormatted}
           </p>
diff --git a/src/components/invoices/invoice-detail.tsx b/src/components/invoices/invoice-detail.tsx
index 37f8913..8e93e81 100644
--- a/src/components/invoices/invoice-detail.tsx
+++ b/src/components/invoices/invoice-detail.tsx
@@ -55,12 +55,12 @@ const PAYMENT_METHOD_OPTIONS: Array<{ value: string; label: string }> = [
 ];
 
 function formatPaymentMethod(method: string | null | undefined): string {
-  if (!method) return '—';
+  if (!method) return '-';
   return PAYMENT_METHOD_LABELS[method] ?? method.replace(/_/g, ' ');
 }
 
 function formatDateOnly(value: string | null | undefined): string {
-  if (!value) return '—';
+  if (!value) return '-';
   // Stored values are typically YYYY-MM-DD or ISO. Treat as date-only to avoid TZ shift.
   const isoDate = value.length === 10 ? value + 'T00:00:00' : value;
   const d = new Date(isoDate);
@@ -299,7 +299,7 @@ export function InvoiceDetail({ invoiceId }: InvoiceDetailProps) {
                   <div>
                     <p className="font-medium">{exp.establishmentName ?? 'Unnamed Expense'}</p>
                     <p className="text-muted-foreground text-xs">
-                      {exp.category ?? '—'} &middot; {exp.expenseDate}
+                      {exp.category ?? '-'} &middot; {exp.expenseDate}
                     </p>
                   </div>
                   <span className="font-medium tabular-nums">
@@ -341,7 +341,7 @@ export function InvoiceDetail({ invoiceId }: InvoiceDetailProps) {
                   </div>
                   <div>
                     <span className="text-muted-foreground">Reference</span>
-                    <p className="mt-0.5">{invoice.paymentReference ?? '—'}</p>
+                    <p className="mt-0.5">{invoice.paymentReference ?? '-'}</p>
                   </div>
                 </div>
               </CardContent>
diff --git a/src/components/layout/breadcrumbs.tsx b/src/components/layout/breadcrumbs.tsx
index bf1afe1..c24b2fd 100644
--- a/src/components/layout/breadcrumbs.tsx
+++ b/src/components/layout/breadcrumbs.tsx
@@ -35,7 +35,7 @@ const SEGMENT_LABELS: Record<string, string> = {
   profile: 'Profile',
 };
 
-// UUID v4-ish (or any 36-char hex+dash) — used to skip entity-id segments
+// UUID v4-ish (or any 36-char hex+dash) - used to skip entity-id segments
 // from the breadcrumbs since the page H1 already shows the entity name.
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 
@@ -56,7 +56,7 @@ export function Breadcrumbs() {
   // Split pathname and filter empty segments
   const rawSegments = pathname.split('/').filter(Boolean);
 
-  // Remove the portSlug segment and any UUID-ish entity-id segments — the
+  // Remove the portSlug segment and any UUID-ish entity-id segments - the
   // page H1 already shows the entity name, no need to leak the raw id.
   const segments = (
     currentPortSlug ? rawSegments.filter((seg) => seg !== currentPortSlug) : rawSegments
diff --git a/src/components/layout/mobile/mobile-bottom-tabs.tsx b/src/components/layout/mobile/mobile-bottom-tabs.tsx
index d9f7169..c88cfef 100644
--- a/src/components/layout/mobile/mobile-bottom-tabs.tsx
+++ b/src/components/layout/mobile/mobile-bottom-tabs.tsx
@@ -13,16 +13,16 @@ type TabSpec = {
 };
 
 // Bottom nav ordering, left → right:
-//   Dashboard  — daily overview
-//   Berths     — marina inventory grid (touches sales + ops both)
-//   Clients    — the address book / dedup surface (centered: it's the
+//   Dashboard  - daily overview
+//   Berths     - marina inventory grid (touches sales + ops both)
+//   Clients    - the address book / dedup surface (centered: it's the
 //                primary mental anchor for "find this person", with
 //                interests living as a tab on the client detail rather
 //                than a peer in the bottom nav)
-//   Documents  — signature tracking (chase signers, EOI queue)
-//   More       — overflow drawer (Interests, Yachts, Companies, …)
+//   Documents  - signature tracking (chase signers, EOI queue)
+//   More       - overflow drawer (Interests, Yachts, Companies, …)
 //
-// Interests is intentionally NOT in the bottom row — having both Clients
+// Interests is intentionally NOT in the bottom row - having both Clients
 // and Interests as peer tabs created a Clients-vs-Interests confusion
 // for sales reps, and the per-client interests tab + the new bottom-sheet
 // drawer cover the day-to-day deal review without needing a dedicated tab.
diff --git a/src/components/layout/mobile/mobile-layout.tsx b/src/components/layout/mobile/mobile-layout.tsx
index 2735d7c..1e0994c 100644
--- a/src/components/layout/mobile/mobile-layout.tsx
+++ b/src/components/layout/mobile/mobile-layout.tsx
@@ -10,7 +10,7 @@ import { MoreSheet } from './more-sheet';
 
 /**
  * Mobile shell: fixed compact topbar + scrollable content + fixed bottom tab
- * bar. Renders only when CSS reveals it (data-shell="mobile") — both shells
+ * bar. Renders only when CSS reveals it (data-shell="mobile") - both shells
  * are in the DOM, see src/app/globals.css. The bottom tabs and More sheet
  * derive the active port slug from the URL themselves, so this layout takes
  * no portSlug prop.
diff --git a/src/components/layout/mobile/mobile-topbar.tsx b/src/components/layout/mobile/mobile-topbar.tsx
index d2514ea..8606e22 100644
--- a/src/components/layout/mobile/mobile-topbar.tsx
+++ b/src/components/layout/mobile/mobile-topbar.tsx
@@ -12,7 +12,7 @@ import { useMobileChrome } from './mobile-layout-provider';
  * left when there's no back affordance, and a soft glow shadow underneath
  * for depth instead of a hard divider line.
  *
- * Slots: title (auto-truncating), back arrow, primary action — all driven by
+ * Slots: title (auto-truncating), back arrow, primary action - all driven by
  * `useMobileChrome()` from the active page. When no page has set a title the
  * URL's last segment is title-cased as a fallback.
  */
diff --git a/src/components/layout/port-switcher.tsx b/src/components/layout/port-switcher.tsx
index 3ef39a8..9a59533 100644
--- a/src/components/layout/port-switcher.tsx
+++ b/src/components/layout/port-switcher.tsx
@@ -32,7 +32,7 @@ export function PortSwitcher({ ports }: PortSwitcherProps) {
 
     setPort(port.id, port.slug);
 
-    // Invalidate all cached queries — they are port-scoped
+    // Invalidate all cached queries - they are port-scoped
     queryClient.invalidateQueries();
 
     // Navigate to the selected port's dashboard
diff --git a/src/components/reminders/reminder-form.tsx b/src/components/reminders/reminder-form.tsx
index 1546faa..4cef275 100644
--- a/src/components/reminders/reminder-form.tsx
+++ b/src/components/reminders/reminder-form.tsx
@@ -221,7 +221,7 @@ export function ReminderForm({
 
           <div className="space-y-2">
             <Label className="text-muted-foreground text-xs">
-              Link to Entity (optional — paste UUIDs, or leave blank)
+              Link to Entity (optional - paste UUIDs, or leave blank)
             </Label>
             <div className="grid grid-cols-1 gap-2">
               <Input
diff --git a/src/components/reports/reports-list.tsx b/src/components/reports/reports-list.tsx
index 3d44928..9754c61 100644
--- a/src/components/reports/reports-list.tsx
+++ b/src/components/reports/reports-list.tsx
@@ -55,9 +55,7 @@ export function ReportsList() {
     queryFn: () => apiFetch<ReportsResponse>('/api/v1/reports?limit=50'),
     refetchInterval: (query) => {
       const rows = query.state.data?.data ?? [];
-      const hasPending = rows.some(
-        (r) => r.status === 'queued' || r.status === 'processing',
-      );
+      const hasPending = rows.some((r) => r.status === 'queued' || r.status === 'processing');
       return hasPending ? 5000 : false;
     },
   });
@@ -65,9 +63,7 @@ export function ReportsList() {
   const handleDownload = async (reportId: string) => {
     setDownloadingId(reportId);
     try {
-      const result = await apiFetch<{ url: string }>(
-        `/api/v1/reports/${reportId}/download`,
-      );
+      const result = await apiFetch<{ url: string }>(`/api/v1/reports/${reportId}/download`);
       window.open(result.url, '_blank');
     } catch (err) {
       console.error('Download failed', err);
@@ -91,9 +87,7 @@ export function ReportsList() {
         ) : !data?.data.length ? (
           <div className="flex flex-col items-center justify-center rounded-lg border border-dashed p-8 text-center">
             <FileText className="mb-2 h-8 w-8 text-muted-foreground" />
-            <p className="text-sm font-medium text-muted-foreground">
-              No reports generated yet
-            </p>
+            <p className="text-sm font-medium text-muted-foreground">No reports generated yet</p>
             <p className="text-xs text-muted-foreground">
               Use the form above to generate your first report.
             </p>
@@ -127,18 +121,18 @@ export function ReportsList() {
                     })}
                   </TableCell>
                   <TableCell className="text-sm text-muted-foreground">
-                    {report.completedAt
-                      ? new Date(report.completedAt).toLocaleString('en-GB', {
-                          dateStyle: 'short',
-                          timeStyle: 'short',
-                        })
-                      : report.status === 'failed' && report.errorMessage
-                        ? (
-                          <span className="text-destructive text-xs" title={report.errorMessage}>
-                            Failed
-                          </span>
-                        )
-                        : '—'}
+                    {report.completedAt ? (
+                      new Date(report.completedAt).toLocaleString('en-GB', {
+                        dateStyle: 'short',
+                        timeStyle: 'short',
+                      })
+                    ) : report.status === 'failed' && report.errorMessage ? (
+                      <span className="text-destructive text-xs" title={report.errorMessage}>
+                        Failed
+                      </span>
+                    ) : (
+                      '-'
+                    )}
                   </TableCell>
                   <TableCell className="text-right">
                     {report.status === 'ready' && report.fileId && (
diff --git a/src/components/reservations/berth-reserve-dialog.tsx b/src/components/reservations/berth-reserve-dialog.tsx
index 1567c13..b6cbe91 100644
--- a/src/components/reservations/berth-reserve-dialog.tsx
+++ b/src/components/reservations/berth-reserve-dialog.tsx
@@ -147,7 +147,7 @@ export function BerthReserveDialog({ open, onOpenChange, berthId }: BerthReserve
       const msg = err instanceof Error ? err.message : 'Failed to activate';
       if (/active reservation|conflict|409/i.test(msg)) {
         setFormError(
-          'This berth already has an active reservation. The pending record was created — activate it manually once the other reservation ends.',
+          'This berth already has an active reservation. The pending record was created - activate it manually once the other reservation ends.',
         );
       } else {
         setFormError(msg);
diff --git a/src/components/reservations/reservation-list.tsx b/src/components/reservations/reservation-list.tsx
index a3e6e00..1452dbb 100644
--- a/src/components/reservations/reservation-list.tsx
+++ b/src/components/reservations/reservation-list.tsx
@@ -208,7 +208,7 @@ export function ReservationList({
                     View contract
                   </button>
                 ) : (
-                  '—'
+                  '-'
                 )}
               </TableCell>
             </TableRow>
diff --git a/src/components/residential/residential-client-detail.tsx b/src/components/residential/residential-client-detail.tsx
index 2f77745..beab8d2 100644
--- a/src/components/residential/residential-client-detail.tsx
+++ b/src/components/residential/residential-client-detail.tsx
@@ -72,8 +72,8 @@ const STAGE_LABELS: Record<string, string> = {
   viewing_scheduled: 'Viewing scheduled',
   offer_made: 'Offer made',
   offer_accepted: 'Offer accepted',
-  closed_won: 'Closed — won',
-  closed_lost: 'Closed — lost',
+  closed_won: 'Closed - won',
+  closed_lost: 'Closed - lost',
 };
 
 export function ResidentialClientDetail({ clientId }: { clientId: string }) {
@@ -188,7 +188,7 @@ export function ResidentialClientDetail({ clientId }: { clientId: string }) {
               <InlineCountryField
                 value={client.placeOfResidenceCountryIso}
                 onSave={async (iso) => {
-                  // When country flips, clear the subdivision — codes are country-scoped.
+                  // When country flips, clear the subdivision - codes are country-scoped.
                   await update.mutateAsync({
                     placeOfResidenceCountryIso: iso,
                     subdivisionIso: null,
@@ -249,7 +249,7 @@ export function ResidentialClientDetail({ clientId }: { clientId: string }) {
                 <span className="text-xs font-medium uppercase text-muted-foreground w-32 shrink-0">
                   {STAGE_LABELS[i.pipelineStage] ?? i.pipelineStage}
                 </span>
-                <span className="flex-1 truncate text-sm">{i.preferences || i.notes || '—'}</span>
+                <span className="flex-1 truncate text-sm">{i.preferences || i.notes || '-'}</span>
                 <Link
                   /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
                   href={`/${portSlug}/residential/interests/${i.id}` as any}
diff --git a/src/components/residential/residential-clients-list.tsx b/src/components/residential/residential-clients-list.tsx
index 123a2b9..0bbc94f 100644
--- a/src/components/residential/residential-clients-list.tsx
+++ b/src/components/residential/residential-clients-list.tsx
@@ -129,11 +129,11 @@ export function ResidentialClientsList() {
                     {c.fullName}
                   </Link>
                 </td>
-                <td className="px-3 py-2 text-muted-foreground">{c.email ?? '—'}</td>
-                <td className="px-3 py-2 text-muted-foreground">{c.phone ?? '—'}</td>
-                <td className="px-3 py-2 text-muted-foreground">{c.placeOfResidence ?? '—'}</td>
+                <td className="px-3 py-2 text-muted-foreground">{c.email ?? '-'}</td>
+                <td className="px-3 py-2 text-muted-foreground">{c.phone ?? '-'}</td>
+                <td className="px-3 py-2 text-muted-foreground">{c.placeOfResidence ?? '-'}</td>
                 <td className="px-3 py-2">{STATUS_LABELS[c.status] ?? c.status}</td>
-                <td className="px-3 py-2 capitalize text-muted-foreground">{c.source ?? '—'}</td>
+                <td className="px-3 py-2 capitalize text-muted-foreground">{c.source ?? '-'}</td>
               </tr>
             ))}
           </tbody>
@@ -323,7 +323,7 @@ function NewResidentialClientSheet({
                 value={residenceCountry}
                 onChange={(iso) => {
                   setResidenceCountry(iso);
-                  // Wipe subdivision when country flips — codes are scoped per country.
+                  // Wipe subdivision when country flips - codes are scoped per country.
                   setResidenceSubdivision(null);
                 }}
                 data-testid="rc-residence-country"
diff --git a/src/components/residential/residential-interest-detail.tsx b/src/components/residential/residential-interest-detail.tsx
index 2533484..ea9db17 100644
--- a/src/components/residential/residential-interest-detail.tsx
+++ b/src/components/residential/residential-interest-detail.tsx
@@ -27,8 +27,8 @@ const STAGE_LABELS: Record<string, string> = {
   viewing_scheduled: 'Viewing scheduled',
   offer_made: 'Offer made',
   offer_accepted: 'Offer accepted',
-  closed_won: 'Closed — won',
-  closed_lost: 'Closed — lost',
+  closed_won: 'Closed - won',
+  closed_lost: 'Closed - lost',
 };
 
 const STAGE_OPTIONS = PIPELINE_STAGES.map((s) => ({
diff --git a/src/components/residential/residential-interests-list.tsx b/src/components/residential/residential-interests-list.tsx
index 637dca8..5f3021e 100644
--- a/src/components/residential/residential-interests-list.tsx
+++ b/src/components/residential/residential-interests-list.tsx
@@ -40,8 +40,8 @@ const STAGE_LABELS: Record<string, string> = {
   viewing_scheduled: 'Viewing scheduled',
   offer_made: 'Offer made',
   offer_accepted: 'Offer accepted',
-  closed_won: 'Closed — won',
-  closed_lost: 'Closed — lost',
+  closed_won: 'Closed - won',
+  closed_lost: 'Closed - lost',
 };
 
 export function ResidentialInterestsList() {
@@ -136,12 +136,12 @@ export function ResidentialInterestsList() {
                   </Link>
                 </td>
                 <td className="px-3 py-2 text-muted-foreground truncate max-w-xs">
-                  {i.preferences ?? '—'}
+                  {i.preferences ?? '-'}
                 </td>
                 <td className="px-3 py-2 text-muted-foreground truncate max-w-xs">
-                  {i.notes ?? '—'}
+                  {i.notes ?? '-'}
                 </td>
-                <td className="px-3 py-2 capitalize text-muted-foreground">{i.source ?? '—'}</td>
+                <td className="px-3 py-2 capitalize text-muted-foreground">{i.source ?? '-'}</td>
                 <td className="px-3 py-2 text-muted-foreground text-xs">
                   {new Date(i.updatedAt).toLocaleDateString()}
                 </td>
diff --git a/src/components/search/command-search.tsx b/src/components/search/command-search.tsx
index 6e62a23..f09b3c0 100644
--- a/src/components/search/command-search.tsx
+++ b/src/components/search/command-search.tsx
@@ -80,14 +80,19 @@ export function CommandSearch() {
   } as const;
 
   return (
-    <div ref={wrapperRef} className="relative">
-      {/* ── Single persistent search bar ── */}
+    // Width is now driven by the parent slot (topbar centers a 360–640px
+    // column). Removed fixed widths so the bar fills its container instead
+    // of shrinking to the old fixed pixel sizes.
+    <div ref={wrapperRef} className="relative w-full">
+      {/* Single persistent search bar.
+          Focus state is intentionally subtle: a 1px brand-coloured border,
+          no fat outer glow. The earlier `ring-4 ring-brand/15` produced a
+          chunky pale-blue rectangle that read as a stray UI element rather
+          than a focus indicator. */}
       <div
         className={cn(
-          'flex items-center gap-2 rounded-md border bg-background px-2.5 shadow-xs transition-all duration-base ease-smooth',
-          focused
-            ? 'border-brand/60 ring-4 ring-brand/15 w-64 lg:w-80'
-            : 'border-input w-44 lg:w-60',
+          'flex items-center gap-2 rounded-lg border bg-background px-3 shadow-xs transition-colors w-full',
+          focused ? 'border-brand/70' : 'border-input',
         )}
       >
         <Search className="h-4 w-4 shrink-0 text-muted-foreground" />
@@ -98,16 +103,18 @@ export function CommandSearch() {
           onChange={(e) => setQuery(e.target.value)}
           onFocus={() => setFocused(true)}
           onKeyDown={onInputKeyDown}
-          placeholder="Search..."
-          className="h-8 flex-1 min-w-0 bg-transparent text-sm outline-none ring-0 focus:outline-none focus:ring-0 placeholder:text-muted-foreground"
+          placeholder="Search clients, yachts, berths...  (⌘K)"
+          className="h-9 flex-1 min-w-0 bg-transparent text-sm outline-none ring-0 focus:outline-none focus:ring-0 placeholder:text-muted-foreground"
         />
       </div>
 
       {/* ── Results dropdown ── */}
       {showDropdown && (
-        <div className="absolute top-[calc(100%+4px)] left-0 w-[min(420px,calc(100vw-2rem))] z-50 rounded-md border bg-popover shadow-lg overflow-hidden">
+        // Dropdown width matches the search input (full width of the slot),
+        // capped on viewport so it doesn't bleed past the screen edge.
+        <div className="absolute top-[calc(100%+4px)] left-0 w-full max-w-[min(640px,calc(100vw-2rem))] z-50 rounded-md border bg-popover shadow-lg overflow-hidden">
           <div className="max-h-[340px] overflow-y-auto py-1">
-            {/* No query yet — show recent or hint */}
+            {/* No query yet - show recent or hint */}
             {!hasQuery && recentSearches.length > 0 && (
               <div>
                 <div className="px-3 py-1.5 text-xs font-medium text-muted-foreground">Recent</div>
@@ -260,7 +267,7 @@ function ResultGroup({
   );
 }
 
-// Keep export for backwards compat — it's a no-op
+// Keep export for backwards compat - it's a no-op
 export function SearchTrigger() {
   return null;
 }
diff --git a/src/components/shared/addresses-editor.tsx b/src/components/shared/addresses-editor.tsx
index 48298e4..72ade65 100644
--- a/src/components/shared/addresses-editor.tsx
+++ b/src/components/shared/addresses-editor.tsx
@@ -186,7 +186,7 @@ function AddressCard({
           <CountryFieldInline
             value={address.countryIso}
             onSave={async (iso) => {
-              // Clear subdivision if country changes — codes are scoped per country.
+              // Clear subdivision if country changes - codes are scoped per country.
               const patch: AddressPatch = { countryIso: iso };
               if (iso !== address.countryIso) patch.subdivisionIso = null;
               await onUpdate(patch);
@@ -256,7 +256,7 @@ function CountryFieldInline({
         }}
         clearable
         className="w-full"
-        // Drop the user straight into the picker — no extra click on the
+        // Drop the user straight into the picker - no extra click on the
         // trigger required.
         defaultOpen
         onOpenChange={(open) => {
diff --git a/src/components/shared/branded-auth-shell.tsx b/src/components/shared/branded-auth-shell.tsx
index 0a4d39d..077a20f 100644
--- a/src/components/shared/branded-auth-shell.tsx
+++ b/src/components/shared/branded-auth-shell.tsx
@@ -3,7 +3,7 @@ const LOGO_URL =
   'https://s3.portnimara.com/images/Port%20Nimara%20New%20Logo-Circular%20Frame_250px.png';
 
 /**
- * Branded shell shared by every auth/form surface — CRM login, portal login,
+ * Branded shell shared by every auth/form surface - CRM login, portal login,
  * password set/reset/activate, forgot-password. Renders the blurred Port
  * Nimara overhead background, the circular logo, and a centered white card
  * that consumers populate with their own form/content.
@@ -12,7 +12,7 @@ export function BrandedAuthShell({ children }: { children: React.ReactNode }) {
   return (
     <div className="relative min-h-screen min-h-[100dvh] flex items-center justify-center px-4 py-8">
       {/*
-        Full-viewport background layer — pinned to the visible viewport via
+        Full-viewport background layer - pinned to the visible viewport via
         `fixed inset-0` so the marina image always reaches the actual screen
         edges regardless of the iOS Safari URL bar showing/hiding. The shell's
         layout layer above sits on top via z-index.
diff --git a/src/components/shared/confirmation-dialog.tsx b/src/components/shared/confirmation-dialog.tsx
index 87a710a..17c8f55 100644
--- a/src/components/shared/confirmation-dialog.tsx
+++ b/src/components/shared/confirmation-dialog.tsx
@@ -23,7 +23,7 @@ interface ConfirmationDialogProps {
   confirmLabel?: string;
   /** Label for the cancel button (default: "Cancel") */
   cancelLabel?: string;
-  /** Whether the confirm action is destructive — renders in red (default: true) */
+  /** Whether the confirm action is destructive - renders in red (default: true) */
   destructive?: boolean;
   /** Called when the user confirms the action */
   onConfirm: () => void | Promise<void>;
diff --git a/src/components/shared/country-combobox.tsx b/src/components/shared/country-combobox.tsx
index 67a8d29..0537232 100644
--- a/src/components/shared/country-combobox.tsx
+++ b/src/components/shared/country-combobox.tsx
@@ -141,7 +141,7 @@ export function CountryCombobox({
               {options.map((opt) => (
                 <CommandItem
                   key={opt.code}
-                  // cmdk filters by `value` — include both code + name.
+                  // cmdk filters by `value` - include both code + name.
                   value={`${opt.name} ${opt.code}`}
                   onSelect={() => {
                     onChange(opt.code);
diff --git a/src/components/shared/data-view.tsx b/src/components/shared/data-view.tsx
index b5c9ac1..5cd9d47 100644
--- a/src/components/shared/data-view.tsx
+++ b/src/components/shared/data-view.tsx
@@ -20,7 +20,7 @@ import {
  * Filters and sort live above the rendered rows; callers pass them as
  * `headerSlot`. On desktop the rows are sortable via column header clicks
  * (TanStack default); on mobile, sort is exposed via a `<Drawer>` opened by
- * the caller's headerSlot — this primitive doesn't enforce a sort UI.
+ * the caller's headerSlot - this primitive doesn't enforce a sort UI.
  */
 export function DataView<TData>({
   table,
diff --git a/src/components/shared/detail-page-shell.tsx b/src/components/shared/detail-page-shell.tsx
index e1042a6..89426a9 100644
--- a/src/components/shared/detail-page-shell.tsx
+++ b/src/components/shared/detail-page-shell.tsx
@@ -41,7 +41,7 @@ export function DetailPageShell({
 
   return (
     <div className={cn('flex flex-col min-h-full', className)}>
-      {/* Desktop-only sticky header — mobile topbar covers this on small viewports. */}
+      {/* Desktop-only sticky header - mobile topbar covers this on small viewports. */}
       <div className="hidden sm:block sticky top-0 z-10 bg-background/95 backdrop-blur border-b border-border px-4 py-3 sm:px-6">
         <div className="flex items-center gap-3 min-w-0">
           <h2 className="truncate text-lg font-semibold text-foreground">{entityName}</h2>
@@ -49,7 +49,7 @@ export function DetailPageShell({
         </div>
       </div>
 
-      {/* Mobile inline status row — only shown when the page wants to display a status pill. */}
+      {/* Mobile inline status row - only shown when the page wants to display a status pill. */}
       {status ? (
         <div className="sm:hidden flex items-center justify-end px-1 pt-1">
           <div className="shrink-0">{status}</div>
diff --git a/src/components/shared/inline-country-field.tsx b/src/components/shared/inline-country-field.tsx
index 1fc6c71..0894e2e 100644
--- a/src/components/shared/inline-country-field.tsx
+++ b/src/components/shared/inline-country-field.tsx
@@ -24,7 +24,7 @@ interface InlineCountryFieldProps {
 export function InlineCountryField({
   value,
   onSave,
-  emptyText = '—',
+  emptyText = '-',
   disabled,
   className,
   'data-testid': testId,
diff --git a/src/components/shared/inline-editable-field.tsx b/src/components/shared/inline-editable-field.tsx
index 3136fdc..2ac7f9a 100644
--- a/src/components/shared/inline-editable-field.tsx
+++ b/src/components/shared/inline-editable-field.tsx
@@ -51,7 +51,7 @@ export type InlineEditableFieldProps = TextProps | SelectFieldProps | TextareaPr
  * Enter/blur and cancels on Escape.
  */
 export function InlineEditableField(props: InlineEditableFieldProps) {
-  const { value, onSave, placeholder, emptyText = '—', className, disabled } = props;
+  const { value, onSave, placeholder, emptyText = '-', className, disabled } = props;
   const [editing, setEditing] = useState(false);
   const [draft, setDraft] = useState(value ?? '');
   const [saving, setSaving] = useState(false);
diff --git a/src/components/shared/inline-phone-field.tsx b/src/components/shared/inline-phone-field.tsx
index a752ad5..e191889 100644
--- a/src/components/shared/inline-phone-field.tsx
+++ b/src/components/shared/inline-phone-field.tsx
@@ -35,7 +35,7 @@ export function InlinePhoneField({
   defaultCountry,
   onSave,
   onEditingChange,
-  emptyText = '—',
+  emptyText = '-',
   disabled,
   className,
   'data-testid': testId,
diff --git a/src/components/shared/inline-tag-editor.tsx b/src/components/shared/inline-tag-editor.tsx
index 77f037a..c5ead44 100644
--- a/src/components/shared/inline-tag-editor.tsx
+++ b/src/components/shared/inline-tag-editor.tsx
@@ -17,7 +17,7 @@ interface Tag {
 }
 
 export interface InlineTagEditorProps {
-  /** PUT endpoint for replacing the entity's tag list — body shape `{ tagIds: string[] }`. */
+  /** PUT endpoint for replacing the entity's tag list - body shape `{ tagIds: string[] }`. */
   endpoint: string;
   currentTags: Tag[];
   /** TanStack Query key to invalidate after a successful change. */
diff --git a/src/components/shared/inline-timezone-field.tsx b/src/components/shared/inline-timezone-field.tsx
index d212d01..a351b1b 100644
--- a/src/components/shared/inline-timezone-field.tsx
+++ b/src/components/shared/inline-timezone-field.tsx
@@ -24,7 +24,7 @@ export function InlineTimezoneField({
   value,
   onSave,
   countryHint,
-  emptyText = '—',
+  emptyText = '-',
   disabled,
   className,
   'data-testid': testId,
diff --git a/src/components/shared/list-card.tsx b/src/components/shared/list-card.tsx
index c7486fa..c72e0a6 100644
--- a/src/components/shared/list-card.tsx
+++ b/src/components/shared/list-card.tsx
@@ -11,12 +11,12 @@ interface ListCardProps {
   href: string;
   /**
    * Optional Tailwind background class painted on a 3px vertical strip on the
-   * left edge — used to encode pipeline stage / status / category at a glance.
+   * left edge - used to encode pipeline stage / status / category at a glance.
    * Pass `undefined` for entities with no status to surface (clients, etc.).
    */
   accentClassName?: string;
   /**
-   * Top-right action slot — typically a `<DropdownMenu>` for edit/archive.
+   * Top-right action slot - typically a `<DropdownMenu>` for edit/archive.
    * Rendered absolutely-positioned outside the navigation Link so its clicks
    * don't trigger detail navigation.
    */
@@ -71,7 +71,7 @@ export function ListCard({
 interface ListCardAvatarProps {
   /** Two-letter initials (or one for single-word names). Caller derives. */
   initials?: string;
-  /** Domain icon (Lucide). Used when the entity isn't a person — yacht, berth, company. */
+  /** Domain icon (Lucide). Used when the entity isn't a person - yacht, berth, company. */
   icon?: ReactNode;
   className?: string;
 }
diff --git a/src/components/shared/loading-skeleton.tsx b/src/components/shared/loading-skeleton.tsx
index 84eaf6b..69c4d1b 100644
--- a/src/components/shared/loading-skeleton.tsx
+++ b/src/components/shared/loading-skeleton.tsx
@@ -6,7 +6,7 @@ interface LoadingSkeletonProps {
 }
 
 /**
- * Table skeleton — mimics a data table with header + rows.
+ * Table skeleton - mimics a data table with header + rows.
  */
 export function TableSkeleton({ rows = 6, columns = 5 }: { rows?: number; columns?: number }) {
   return (
@@ -27,10 +27,7 @@ export function TableSkeleton({ rows = 6, columns = 5 }: { rows?: number; column
           )}
         >
           {Array.from({ length: columns }).map((_, colIdx) => (
-            <Skeleton
-              key={colIdx}
-              className={cn('h-4', colIdx === 0 ? 'w-1/4' : 'flex-1')}
-            />
+            <Skeleton key={colIdx} className={cn('h-4', colIdx === 0 ? 'w-1/4' : 'flex-1')} />
           ))}
         </div>
       ))}
@@ -39,7 +36,7 @@ export function TableSkeleton({ rows = 6, columns = 5 }: { rows?: number; column
 }
 
 /**
- * Card skeleton — mimics a content card.
+ * Card skeleton - mimics a content card.
  */
 export function CardSkeleton({ className }: LoadingSkeletonProps) {
   return (
@@ -59,7 +56,7 @@ export function CardSkeleton({ className }: LoadingSkeletonProps) {
 }
 
 /**
- * Form skeleton — mimics a form with labeled inputs.
+ * Form skeleton - mimics a form with labeled inputs.
  */
 export function FormSkeleton({ fields = 4 }: { fields?: number }) {
   return (
@@ -79,7 +76,7 @@ export function FormSkeleton({ fields = 4 }: { fields?: number }) {
 }
 
 /**
- * Grid skeleton — a responsive card grid.
+ * Grid skeleton - a responsive card grid.
  */
 export function GridSkeleton({ cards = 6 }: { cards?: number }) {
   return (
@@ -92,7 +89,7 @@ export function GridSkeleton({ cards = 6 }: { cards?: number }) {
 }
 
 /**
- * Page-level loading skeleton — header + content area.
+ * Page-level loading skeleton - header + content area.
  */
 export function PageSkeleton() {
   return (
diff --git a/src/components/shared/owner-picker.tsx b/src/components/shared/owner-picker.tsx
index 3e8035a..5b36815 100644
--- a/src/components/shared/owner-picker.tsx
+++ b/src/components/shared/owner-picker.tsx
@@ -64,7 +64,7 @@ export function OwnerPicker({
 
   const options = data?.data ?? [];
 
-  // Selected display label — show entity's name from current options if
+  // Selected display label - show entity's name from current options if
   // available, otherwise a truncated id fallback.
   const selectedLabel = (() => {
     if (!value) return placeholder;
diff --git a/src/components/shared/page-header.tsx b/src/components/shared/page-header.tsx
index b35033f..6a1ab0d 100644
--- a/src/components/shared/page-header.tsx
+++ b/src/components/shared/page-header.tsx
@@ -21,7 +21,7 @@ interface PageHeaderProps {
  * existing call-sites stay unchanged.
  *
  * Mobile-aware: below sm (640px) the title/eyebrow/description/gradient
- * frame all collapse — the page title is already shown by the mobile topbar,
+ * frame all collapse - the page title is already shown by the mobile topbar,
  * so duplicating it in the body wastes scroll real estate. What remains is a
  * flush right-aligned action row (or nothing if there are no actions). On sm+
  * the full strip with title+description renders as before.
@@ -48,7 +48,10 @@ export function PageHeader({
       {/* Desktop: full strip with title, eyebrow, description, kpi line, actions. */}
       <div
         className={cn(
-          'hidden sm:flex flex-col gap-3 sm:mb-6 sm:flex-row sm:items-start sm:justify-between sm:gap-4',
+          // Removed `sm:mb-6` - the parent shell already provides
+          // appropriate gap-y between header and the next section, and the
+          // double-spacing produced an oversized top margin on dashboards.
+          'hidden sm:flex flex-col gap-3 sm:flex-row sm:items-start sm:justify-between sm:gap-4',
           isGradient &&
             'rounded-xl border border-slate-200 bg-gradient-brand-soft px-5 py-4 shadow-xs',
           className,
diff --git a/src/components/shared/phone-input.tsx b/src/components/shared/phone-input.tsx
index 55bd271..5f55de2 100644
--- a/src/components/shared/phone-input.tsx
+++ b/src/components/shared/phone-input.tsx
@@ -11,7 +11,7 @@ import { detectDefaultCountry, type CountryCode } from '@/lib/i18n/countries';
 export interface PhoneInputValue {
   /** E.164 form ('+442079460958'). Null when empty or unparseable. */
   e164: string | null;
-  /** Country selected in the dropdown — drives the AsYouType formatter. */
+  /** Country selected in the dropdown - drives the AsYouType formatter. */
   country: CountryCode;
 }
 
@@ -32,7 +32,7 @@ interface PhoneInputProps {
  * Phone input with a country flag dropdown + format-as-you-type.
  *
  * Wire shape: emits `{ e164, country }` on every change. E.164 is null
- * while the input is too short to parse — that's a form-validation
+ * while the input is too short to parse - that's a form-validation
  * concern, not an input concern. Pasting an international number
  * (`+1 415…`) auto-switches the country dropdown to match.
  *
@@ -62,7 +62,7 @@ export function PhoneInput({
     const parsed = parsePhone(value.e164, value.country);
     return parsed.national ?? '';
   });
-  // Track whether the user has typed since mount — keeps a controlled-from-props
+  // Track whether the user has typed since mount - keeps a controlled-from-props
   // value sync on first render only.
   const initialized = useRef(false);
 
@@ -78,7 +78,7 @@ export function PhoneInput({
 
   function handleInput(raw: string) {
     // Paste-detect: if user pasted an international format, parse it
-    // and flip the country dropdown to match — better UX than asking
+    // and flip the country dropdown to match - better UX than asking
     // them to also click the dropdown.
     if (raw.startsWith('+')) {
       const parsed = parsePhone(raw);
diff --git a/src/components/shared/realtime-toasts.tsx b/src/components/shared/realtime-toasts.tsx
index 66d3b61..4142295 100644
--- a/src/components/shared/realtime-toasts.tsx
+++ b/src/components/shared/realtime-toasts.tsx
@@ -11,7 +11,7 @@ import { stageLabel } from '@/lib/constants';
  * toasts. Mounted once inside SocketProvider so reps see "EOI signed",
  * "Deposit recorded", "Stage advanced" without having to refresh.
  *
- * Render-only — no children. Intentionally narrow in scope: only toast on
+ * Render-only - no children. Intentionally narrow in scope: only toast on
  * events that are noteworthy *to a user staring at any page*. Per-page
  * cache invalidations stay in `useRealtimeInvalidation`.
  */
@@ -36,7 +36,7 @@ export function RealtimeToasts() {
     }
 
     function onDocumentCompleted(payload: { type?: string }) {
-      // Kick a generic "fully signed" — the type-specific message is
+      // Kick a generic "fully signed" - the type-specific message is
       // friendlier when we can identify it as an EOI.
       if (payload?.type === 'eoi') {
         toast.success('EOI fully signed', {
@@ -64,7 +64,7 @@ export function RealtimeToasts() {
       const isWon = payload.outcome === 'won';
       const label = payload.outcome.replace(/_/g, ' ');
       const fn = isWon ? toast.success : toast.message;
-      fn(`Interest closed — ${label}`);
+      fn(`Interest closed - ${label}`);
     }
 
     socket.on('interest:stageChanged', onStageChanged);
diff --git a/src/components/ui/dialog.tsx b/src/components/ui/dialog.tsx
index 6a3ffb4..18864f4 100644
--- a/src/components/ui/dialog.tsx
+++ b/src/components/ui/dialog.tsx
@@ -41,7 +41,7 @@ const DialogContent = React.forwardRef<
         // Mobile: full-screen sheet anchored to all four sides via individual
         // top/right/bottom/left utilities. Desktop (sm+): override each side
         // individually so tailwind-merge doesn't collapse our centering classes.
-        // (Don't use `inset-0` + `sm:inset-auto` here — twMerge sees that as a
+        // (Don't use `inset-0` + `sm:inset-auto` here - twMerge sees that as a
         // conflict and silently strips `sm:left-[50%]` / `sm:top-[50%]`.)
         'fixed top-0 right-0 bottom-0 left-0 z-50 grid w-full gap-4 border-0 bg-background p-6 shadow-lg duration-200',
         'data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0',
diff --git a/src/components/ui/kpi-tile.tsx b/src/components/ui/kpi-tile.tsx
index f87b269..916d547 100644
--- a/src/components/ui/kpi-tile.tsx
+++ b/src/components/ui/kpi-tile.tsx
@@ -7,7 +7,7 @@ interface KPITileProps extends React.HTMLAttributes<HTMLDivElement> {
   value: React.ReactNode;
   /** Signed delta vs. prior period; positive = green, negative = red, undefined = no chip. */
   delta?: number;
-  /** Pre-rendered sparkline (recharts) — caller decides shape. */
+  /** Pre-rendered sparkline (recharts) - caller decides shape. */
   sparkline?: React.ReactNode;
   /** Optional accent stripe colour token; defaults to brand. */
   accent?: 'brand' | 'success' | 'warning' | 'mint' | 'teal' | 'purple';
diff --git a/src/components/ui/status-pill.tsx b/src/components/ui/status-pill.tsx
index b740d11..5b1d065 100644
--- a/src/components/ui/status-pill.tsx
+++ b/src/components/ui/status-pill.tsx
@@ -4,7 +4,7 @@ import * as React from 'react';
 import { cn } from '@/lib/utils';
 
 /**
- * Status pill — a single visual primitive for "this thing is in state X" across
+ * Status pill - a single visual primitive for "this thing is in state X" across
  * documents, signers, reservations, interests. Replaces ad-hoc Badge variants
  * sprinkled through detail pages so the colour mapping stays consistent.
  */
@@ -41,7 +41,7 @@ export type StatusPillStatus = NonNullable<VariantProps<typeof statusPillVariant
 
 interface StatusPillProps
   extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof statusPillVariants> {
-  /** Optional leading dot — useful for "in-progress" style indicators. */
+  /** Optional leading dot - useful for "in-progress" style indicators. */
   withDot?: boolean;
 }
 
diff --git a/src/components/yachts/yacht-card.tsx b/src/components/yachts/yacht-card.tsx
index b2b82e6..6f03c86 100644
--- a/src/components/yachts/yacht-card.tsx
+++ b/src/components/yachts/yacht-card.tsx
@@ -40,12 +40,12 @@ export function YachtCard({ yacht, portSlug, onEdit, onArchive }: YachtCardProps
   // Prefer metric dimensions; fall back to imperial
   let dimText: string | null = null;
   if (yacht.lengthM || yacht.widthM) {
-    const l = yacht.lengthM ?? '—';
-    const w = yacht.widthM ?? '—';
+    const l = yacht.lengthM ?? '-';
+    const w = yacht.widthM ?? '-';
     dimText = `${l}m × ${w}m`;
   } else if (yacht.lengthFt || yacht.widthFt) {
-    const l = yacht.lengthFt ?? '—';
-    const w = yacht.widthFt ?? '—';
+    const l = yacht.lengthFt ?? '-';
+    const w = yacht.widthFt ?? '-';
     dimText = `${l}ft × ${w}ft`;
   }
 
diff --git a/src/components/yachts/yacht-columns.tsx b/src/components/yachts/yacht-columns.tsx
index 289a9a9..fe3240d 100644
--- a/src/components/yachts/yacht-columns.tsx
+++ b/src/components/yachts/yacht-columns.tsx
@@ -45,13 +45,13 @@ const STATUS_LABELS: Record<string, string> = {
 
 function formatDimensions(yacht: YachtRow): string | null {
   if (yacht.lengthFt || yacht.widthFt) {
-    const length = yacht.lengthFt ?? '—';
-    const width = yacht.widthFt ?? '—';
+    const length = yacht.lengthFt ?? '-';
+    const width = yacht.widthFt ?? '-';
     return `${length} × ${width} ft`;
   }
   if (yacht.lengthM || yacht.widthM) {
-    const length = yacht.lengthM ?? '—';
-    const width = yacht.widthM ?? '—';
+    const length = yacht.lengthM ?? '-';
+    const width = yacht.widthM ?? '-';
     return `${length} × ${width} m`;
   }
   return null;
@@ -103,7 +103,7 @@ export function getYachtColumns({
       enableSorting: false,
       cell: ({ row }) => {
         const dims = formatDimensions(row.original);
-        if (!dims) return <span className="text-muted-foreground">—</span>;
+        if (!dims) return <span className="text-muted-foreground">-</span>;
         return <span className="text-sm">{dims}</span>;
       },
     },
@@ -114,7 +114,7 @@ export function getYachtColumns({
       enableSorting: false,
       cell: ({ getValue }) => {
         const value = getValue() as string | null;
-        if (!value) return <span className="text-muted-foreground">—</span>;
+        if (!value) return <span className="text-muted-foreground">-</span>;
         return <span className="text-sm">{value}</span>;
       },
     },
diff --git a/src/components/yachts/yacht-detail-header.tsx b/src/components/yachts/yacht-detail-header.tsx
index 5306396..189956e 100644
--- a/src/components/yachts/yacht-detail-header.tsx
+++ b/src/components/yachts/yacht-detail-header.tsx
@@ -68,7 +68,7 @@ export function OwnerLink({
    *  per-row fetch (avoids an N+1 round-trip on lists). */
   preloadedName?: string | null;
 }) {
-  // Only fetch when the parent didn't already supply a name — list endpoints
+  // Only fetch when the parent didn't already supply a name - list endpoints
   // batch-resolve owners server-side via a join.
   const { data } = useQuery<{ fullName?: string; name?: string }>({
     queryKey: [type === 'client' ? 'clients' : 'companies', id, 'name-only'],
diff --git a/src/components/yachts/yacht-form.tsx b/src/components/yachts/yacht-form.tsx
index 4c6f003..5e76817 100644
--- a/src/components/yachts/yacht-form.tsx
+++ b/src/components/yachts/yacht-form.tsx
@@ -117,7 +117,7 @@ export function YachtForm({ open, onOpenChange, yacht }: YachtFormProps) {
   const mutation = useMutation({
     mutationFn: async (data: CreateYachtInput) => {
       if (isEdit) {
-        // updateYachtSchema omits owner + tagIds — strip them from PATCH body.
+        // updateYachtSchema omits owner + tagIds - strip them from PATCH body.
         const { owner: _owner, tagIds: _tIds, ...rest } = data;
         void _owner;
         void _tIds;
diff --git a/src/components/yachts/yacht-ownership-history.tsx b/src/components/yachts/yacht-ownership-history.tsx
index 7948b68..c64fd7a 100644
--- a/src/components/yachts/yacht-ownership-history.tsx
+++ b/src/components/yachts/yacht-ownership-history.tsx
@@ -43,7 +43,7 @@ const REASON_LABELS: Record<string, string> = {
 };
 
 function formatDate(value: string | null): string {
-  if (!value) return '—';
+  if (!value) return '-';
   const date = new Date(value);
   if (Number.isNaN(date.getTime())) return value;
   return date.toLocaleDateString();
@@ -109,10 +109,10 @@ export function YachtOwnershipHistory({ yachtId }: YachtOwnershipHistoryProps) {
               <TableCell className="text-sm text-muted-foreground">
                 {row.transferReason
                   ? (REASON_LABELS[row.transferReason] ?? row.transferReason)
-                  : '—'}
+                  : '-'}
               </TableCell>
               <TableCell className="text-sm text-muted-foreground max-w-[320px] truncate">
-                {row.transferNotes ?? '—'}
+                {row.transferNotes ?? '-'}
               </TableCell>
             </TableRow>
           ))}
diff --git a/src/components/yachts/yacht-tabs.tsx b/src/components/yachts/yacht-tabs.tsx
index cd64af1..7459513 100644
--- a/src/components/yachts/yacht-tabs.tsx
+++ b/src/components/yachts/yacht-tabs.tsx
@@ -190,7 +190,7 @@ function OverviewTab({ yachtId, yacht }: { yachtId: string; yacht: YachtTabsYach
           variant="textarea"
           value={yacht.notes}
           onSave={save('notes')}
-          emptyText="No notes — click to add"
+          emptyText="No notes - click to add"
         />
       </div>
 
@@ -238,7 +238,7 @@ function YachtInterestsTab({ yachtId }: { yachtId: string }) {
           <span className="w-36 shrink-0 text-xs font-medium uppercase text-muted-foreground">
             {i.pipelineStage.replace(/_/g, ' ')}
           </span>
-          <span className="flex-1 truncate">{i.clientName ?? '—'}</span>
+          <span className="flex-1 truncate">{i.clientName ?? '-'}</span>
           {i.berthMooringNumber && (
             <span className="shrink-0 text-xs text-muted-foreground">
               Berth {i.berthMooringNumber}
diff --git a/src/hooks/realtime-invalidation-core.ts b/src/hooks/realtime-invalidation-core.ts
index 876611c..7d3f05a 100644
--- a/src/hooks/realtime-invalidation-core.ts
+++ b/src/hooks/realtime-invalidation-core.ts
@@ -31,7 +31,7 @@ export function subscribeRealtimeInvalidations(
 
   for (const event of eventKeys) {
     const handler = () => {
-      // Read the LATEST map at fire-time — not at subscription time — so
+      // Read the LATEST map at fire-time - not at subscription time - so
       // callers passing inline `{ 'client:created': [...] }` literals don't
       // bind a stale snapshot if they re-render.
       const queryKeys = getEventMap()[event];
diff --git a/src/hooks/use-is-mobile.ts b/src/hooks/use-is-mobile.ts
index 70d00eb..b8c197e 100644
--- a/src/hooks/use-is-mobile.ts
+++ b/src/hooks/use-is-mobile.ts
@@ -7,7 +7,7 @@ const MOBILE_QUERY = '(max-width: 1023.98px)';
 /**
  * Returns true when the viewport is below the `lg` Tailwind breakpoint.
  * Backed by a media-query listener; safe to call from any client component.
- * Server renders return `false` (desktop default) — clients hydrate to the
+ * Server renders return `false` (desktop default) - clients hydrate to the
  * true viewport state on mount.
  *
  * Not unit-tested: the repo's vitest is configured for environment='node'
diff --git a/src/lib/api/helpers.ts b/src/lib/api/helpers.ts
index 221c3b5..43f3ceb 100644
--- a/src/lib/api/helpers.ts
+++ b/src/lib/api/helpers.ts
@@ -25,7 +25,7 @@ export interface AuthContext {
   userId: string;
   portId: string;
   portSlug: string;
-  /** true for super_admin users — bypasses all permission checks. */
+  /** true for super_admin users - bypasses all permission checks. */
   isSuperAdmin: boolean;
   /**
    * Effective permissions after role + port override deep-merge.
@@ -117,7 +117,7 @@ export function withAuth(
       // 3. Resolve port context.
       //    Port ID comes from the X-Port-Id header (set by the client after port
       //    selection), falling back to the user's default port from preferences.
-      //    It NEVER comes from the request body — SECURITY-GUIDELINES.md §2.1.
+      //    It NEVER comes from the request body - SECURITY-GUIDELINES.md §2.1.
       const portIdFromHeader = req.headers.get('X-Port-Id');
       const portId =
         portIdFromHeader ??
@@ -163,7 +163,7 @@ export function withAuth(
           ) as RolePermissions;
         }
 
-        // Per-user residential toggle — flips the residential domain on
+        // Per-user residential toggle - flips the residential domain on
         // top of whatever the role grants. We never use it to *revoke*
         // residential access from a role that already grants it.
         if (portRole.residentialAccess && permissions) {
@@ -181,7 +181,7 @@ export function withAuth(
         }
       } else if (profile.isSuperAdmin && portId) {
         // Super admin still needs portSlug for response context.
-        // We also validate the portId actually exists — a super-admin session
+        // We also validate the portId actually exists - a super-admin session
         // must not be able to operate against a fabricated portId.
         const port = await db.query.ports.findFirst({
           where: eq(ports.id, portId),
@@ -237,7 +237,7 @@ export function withPermission(
       if (!resourcePerms || !resourcePerms[action]) {
         logger.warn({ userId: ctx.userId, resource, action }, 'Permission denied');
 
-        // Log the denied attempt — fire-and-forget; audit must never block response.
+        // Log the denied attempt - fire-and-forget; audit must never block response.
         void createAuditLog({
           userId: ctx.userId,
           portId: ctx.portId,
@@ -261,7 +261,7 @@ export function withPermission(
 
 /**
  * Wraps a route handler with a per-user rate-limit gate. Compose inside
- * withAuth so the userId is available — falls back to IP for anonymous
+ * withAuth so the userId is available - falls back to IP for anonymous
  * routes (we don't currently expose any).
  *
  * 429 responses include `X-RateLimit-Limit` / `Remaining` / `Reset` headers
diff --git a/src/lib/audit.ts b/src/lib/audit.ts
index df45ead..b3296a3 100644
--- a/src/lib/audit.ts
+++ b/src/lib/audit.ts
@@ -53,7 +53,7 @@ const SENSITIVE_FIELDS = new Set(['email', 'phone', 'password', 'credentials_enc
  * Masks sensitive field values to prevent PII or secrets from being stored
  * verbatim in the audit log (SECURITY-GUIDELINES.md §5.2).
  *
- * Strings are replaced with a partial mask — first 2 chars + *** + last 2 chars.
+ * Strings are replaced with a partial mask - first 2 chars + *** + last 2 chars.
  */
 export function maskSensitiveFields(
   data?: Record<string, unknown>,
@@ -89,7 +89,7 @@ export function diffFields(
 /**
  * Inserts an audit log entry into the database.
  *
- * This function NEVER throws — errors are caught and logged so that an audit
+ * This function NEVER throws - errors are caught and logged so that an audit
  * failure never rolls back or disrupts the parent operation.
  */
 export async function createAuditLog(params: AuditLogParams): Promise<void> {
diff --git a/src/lib/auth/index.ts b/src/lib/auth/index.ts
index 8fe8b97..23aa2f3 100644
--- a/src/lib/auth/index.ts
+++ b/src/lib/auth/index.ts
@@ -49,7 +49,7 @@ export const auth = betterAuth({
   emailAndPassword: {
     enabled: true,
     minPasswordLength: 9,
-    // Accounts are admin-created only — no self-service email verification flow.
+    // Accounts are admin-created only - no self-service email verification flow.
     requireEmailVerification: false,
   },
 
diff --git a/src/lib/db/schema/ai-usage.ts b/src/lib/db/schema/ai-usage.ts
index d4ed67c..ca2677c 100644
--- a/src/lib/db/schema/ai-usage.ts
+++ b/src/lib/db/schema/ai-usage.ts
@@ -7,7 +7,7 @@
  * soft warnings and hard caps.
  *
  * Token-denominated rather than dollar-denominated so the cap survives
- * model price changes — and it's the unit both OpenAI and Anthropic
+ * model price changes - and it's the unit both OpenAI and Anthropic
  * SDKs return in `response.usage`.
  */
 
@@ -25,7 +25,7 @@ export const aiUsageLedger = pgTable(
     portId: text('port_id')
       .notNull()
       .references(() => ports.id, { onDelete: 'cascade' }),
-    /** Optional — system-initiated calls (e.g. scheduled summarizers) won't have a user. */
+    /** Optional - system-initiated calls (e.g. scheduled summarizers) won't have a user. */
     userId: text('user_id').references(() => user.id, { onDelete: 'set null' }),
     /** Stable feature key: 'ocr', 'summary', 'embedding', 'reply_draft', etc. */
     feature: text('feature').notNull(),
diff --git a/src/lib/db/schema/clients.ts b/src/lib/db/schema/clients.ts
index a1522c5..fa01fdc 100644
--- a/src/lib/db/schema/clients.ts
+++ b/src/lib/db/schema/clients.ts
@@ -127,7 +127,7 @@ export const clientTags = pgTable(
     clientId: text('client_id')
       .notNull()
       .references(() => clients.id, { onDelete: 'cascade' }),
-    tagId: text('tag_id').notNull(), // references tags.id — defined later in system.ts
+    tagId: text('tag_id').notNull(), // references tags.id - defined later in system.ts
   },
   (table) => [primaryKey({ columns: [table.clientId, table.tagId] })],
 );
@@ -194,7 +194,7 @@ export const clientMergeCandidates = pgTable(
   },
   (table) => [
     index('idx_cmc_port_status').on(table.portId, table.status),
-    // Same pair shouldn't surface twice — enforce uniqueness on the
+    // Same pair shouldn't surface twice - enforce uniqueness on the
     // canonical (a < b) ordering.
     uniqueIndex('idx_cmc_pair').on(table.portId, table.clientAId, table.clientBId),
   ],
diff --git a/src/lib/db/schema/crm-invites.ts b/src/lib/db/schema/crm-invites.ts
index 70891dc..da7f8b4 100644
--- a/src/lib/db/schema/crm-invites.ts
+++ b/src/lib/db/schema/crm-invites.ts
@@ -5,7 +5,7 @@ import { pgTable, text, boolean, timestamp, index, uniqueIndex } from 'drizzle-o
  *
  * `tokenHash` is a SHA-256 hash of the raw token sent in the email. Lookups
  * happen by hash so a DB compromise never leaks active tokens. The invite
- * is consumed at /set-password — the route creates the better-auth `user`
+ * is consumed at /set-password - the route creates the better-auth `user`
  * row + `account` credential and the matching `user_profiles` extension.
  */
 export const crmUserInvites = pgTable(
diff --git a/src/lib/db/schema/gdpr.ts b/src/lib/db/schema/gdpr.ts
index b66194b..313a858 100644
--- a/src/lib/db/schema/gdpr.ts
+++ b/src/lib/db/schema/gdpr.ts
@@ -31,7 +31,7 @@ export const gdprExports = pgTable(
       .references(() => user.id, { onDelete: 'restrict' }),
     /** 'pending' | 'building' | 'ready' | 'sent' | 'failed' */
     status: text('status').notNull().default('pending'),
-    /** MinIO path under the configured bucket — null until the worker uploads. */
+    /** MinIO path under the configured bucket - null until the worker uploads. */
     storageKey: text('storage_key'),
     sizeBytes: integer('size_bytes'),
     /** When status='failed', the truncated error message. */
@@ -41,7 +41,7 @@ export const gdprExports = pgTable(
     createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
     readyAt: timestamp('ready_at', { withTimezone: true }),
     sentAt: timestamp('sent_at', { withTimezone: true }),
-    /** Cleanup target — bundles are removed from MinIO after this. */
+    /** Cleanup target - bundles are removed from MinIO after this. */
     expiresAt: timestamp('expires_at', { withTimezone: true }),
   },
   (table) => [
diff --git a/src/lib/db/schema/insights.ts b/src/lib/db/schema/insights.ts
index f258a64..995454b 100644
--- a/src/lib/db/schema/insights.ts
+++ b/src/lib/db/schema/insights.ts
@@ -1,5 +1,5 @@
 /**
- * Phase B — operational insight surfaces.
+ * Phase B - operational insight surfaces.
  *
  * - `alerts`: rule-engine-fired actionable cards. The fingerprint column
  *   dedupes re-evaluations of the same condition; the partial unique
@@ -35,12 +35,12 @@ export const alerts = pgTable(
     /** Optional FK target: 'interest', 'reservation', 'document', 'expense', ... */
     entityType: text('entity_type'),
     entityId: text('entity_id'),
-    /** Hash of (rule_id + entity_type + entity_id) — dedupes re-evaluations. */
+    /** Hash of (rule_id + entity_type + entity_id) - dedupes re-evaluations. */
     fingerprint: text('fingerprint').notNull(),
     firedAt: timestamp('fired_at', { withTimezone: true }).notNull().defaultNow(),
     dismissedAt: timestamp('dismissed_at', { withTimezone: true }),
     dismissedBy: text('dismissed_by').references(() => user.id),
-    /** "Someone is on it" — alert stays visible but stops nagging. */
+    /** "Someone is on it" - alert stays visible but stops nagging. */
     acknowledgedAt: timestamp('acknowledged_at', { withTimezone: true }),
     acknowledgedBy: text('acknowledged_by').references(() => user.id),
     /** Set by the engine when the underlying condition no longer fires. */
@@ -49,7 +49,7 @@ export const alerts = pgTable(
     metadata: jsonb('metadata').default({}),
   },
   (table) => [
-    // Only one open alert per (port, fingerprint) — re-evaluation upserts.
+    // Only one open alert per (port, fingerprint) - re-evaluation upserts.
     uniqueIndex('idx_alerts_fingerprint_open')
       .on(table.portId, table.fingerprint)
       .where(sql`resolved_at IS NULL`),
@@ -85,7 +85,7 @@ export type NewAnalyticsSnapshot = typeof analyticsSnapshots.$inferInsert;
 export type AlertSeverity = 'info' | 'warning' | 'critical';
 
 /**
- * Rule IDs in the v1 catalog — keep in sync with `alert-rules.ts`.
+ * Rule IDs in the v1 catalog - keep in sync with `alert-rules.ts`.
  *
  * Two rules from the original spec (`document.expiring_soon`,
  * `audit.suspicious_login`) are deferred until their data sources land:
diff --git a/src/lib/db/schema/interests.ts b/src/lib/db/schema/interests.ts
index 4e69fa6..58362e4 100644
--- a/src/lib/db/schema/interests.ts
+++ b/src/lib/db/schema/interests.ts
@@ -16,7 +16,7 @@ export const interests = pgTable(
     clientId: text('client_id')
       .notNull()
       .references(() => clients.id),
-    berthId: text('berth_id'), // nullable — FK to berths defined in berths.ts, added via relation
+    berthId: text('berth_id'), // nullable - FK to berths defined in berths.ts, added via relation
     yachtId: text('yacht_id'), // FK added via relation; nullable until pipeline leaves 'open'
     pipelineStage: text('pipeline_stage').notNull().default('open'),
     leadCategory: text('lead_category'), // general_interest, specific_qualified, hot_lead
@@ -36,7 +36,7 @@ export const interests = pgTable(
     reminderEnabled: boolean('reminder_enabled').notNull().default(false),
     reminderDays: integer('reminder_days'),
     reminderLastFired: timestamp('reminder_last_fired', { withTimezone: true }),
-    /** Terminal outcome. Independent of pipelineStage — `outcome` is set
+    /** Terminal outcome. Independent of pipelineStage - `outcome` is set
      *  alongside the stage transition to `completed` to distinguish won
      *  deals from the various lost variants. NULL while the interest is
      *  still active. */
diff --git a/src/lib/db/schema/migration.ts b/src/lib/db/schema/migration.ts
index 9cb1c30..1f5bfb8 100644
--- a/src/lib/db/schema/migration.ts
+++ b/src/lib/db/schema/migration.ts
@@ -28,7 +28,7 @@ export const migrationSourceLinks = pgTable(
     targetEntityType: text('target_entity_type').notNull(),
     /** UUID of the new-system entity (clients.id, interests.id, etc.). */
     targetEntityId: text('target_entity_id').notNull(),
-    /** Apply-id from the migration run that created this link — pairs with
+    /** Apply-id from the migration run that created this link - pairs with
      *  the on-disk apply manifest so `--rollback --apply-id <id>` knows
      *  exactly which links to remove. */
     appliedId: text('applied_id').notNull(),
diff --git a/src/lib/db/schema/portal.ts b/src/lib/db/schema/portal.ts
index abdc905..496da31 100644
--- a/src/lib/db/schema/portal.ts
+++ b/src/lib/db/schema/portal.ts
@@ -4,7 +4,7 @@ import { ports } from './ports';
 import { clients } from './clients';
 
 /**
- * Portal users — one per client account that's been invited to the client
+ * Portal users - one per client account that's been invited to the client
  * portal. Separate from the CRM `users` table (managed by better-auth) so the
  * authentication realms stay isolated.
  *
diff --git a/src/lib/db/schema/residential.ts b/src/lib/db/schema/residential.ts
index a4a151b..3863f5c 100644
--- a/src/lib/db/schema/residential.ts
+++ b/src/lib/db/schema/residential.ts
@@ -3,7 +3,7 @@ import { pgTable, text, timestamp, index } from 'drizzle-orm/pg-core';
 import { ports } from './ports';
 
 /**
- * Residential clients — physically separated from `clients` because the
+ * Residential clients - physically separated from `clients` because the
  * residential side is handled by an external team that should never see
  * marina-side data, and vice versa. The two domains share a port but no
  * tables, so the access boundary is enforced at the schema level.
@@ -24,7 +24,7 @@ export const residentialClients = pgTable(
      *  PhoneInput component lands. The free-text `phone` column stays
      *  for one release as a fallback for unparseable rows. */
     phoneE164: text('phone_e164'),
-    /** ISO-3166-1 alpha-2 — country the phone was parsed against. */
+    /** ISO-3166-1 alpha-2 - country the phone was parsed against. */
     phoneCountry: text('phone_country'),
     /** ISO-3166-1 alpha-2 nationality. */
     nationalityIso: text('nationality_iso'),
@@ -55,7 +55,7 @@ export const residentialClients = pgTable(
 );
 
 /**
- * Residential interests — one per inquiry/lead. A residential_client can
+ * Residential interests - one per inquiry/lead. A residential_client can
  * have multiple interests over time (e.g. inquired about a unit in 2025,
  * came back about a different unit in 2026).
  *
@@ -78,7 +78,7 @@ export const residentialInterests = pgTable(
     source: text('source'), // website | manual | referral | broker
     notes: text('notes'),
     /**
-     * Free-text capture of unit-type / size / floor / budget preferences —
+     * Free-text capture of unit-type / size / floor / budget preferences -
      * residential leads are exploratory and the external team uses notes
      * heavily. Schema can grow into structured columns later if needed.
      */
diff --git a/src/lib/db/schema/users.ts b/src/lib/db/schema/users.ts
index fa98b3a..f74afd6 100644
--- a/src/lib/db/schema/users.ts
+++ b/src/lib/db/schema/users.ts
@@ -144,7 +144,7 @@ export type UserPreferences = {
 
 /**
  * Core user table managed by Better Auth.
- * Do NOT modify directly — Better Auth handles CRUD via its adapter.
+ * Do NOT modify directly - Better Auth handles CRUD via its adapter.
  */
 export const user = pgTable('user', {
   id: text('id').primaryKey(),
@@ -282,7 +282,7 @@ export const userPortRoles = pgTable(
 );
 
 /**
- * Sessions table — Better Auth compatibility.
+ * Sessions table - Better Auth compatibility.
  * Better Auth manages session creation/validation.
  */
 export const session = pgTable(
diff --git a/src/lib/db/seed-data.ts b/src/lib/db/seed-data.ts
index e3f20de..43c154e 100644
--- a/src/lib/db/seed-data.ts
+++ b/src/lib/db/seed-data.ts
@@ -1,16 +1,16 @@
 /**
  * Per-port seed data builder for Port Nimara CRM.
  *
- * Exports `seedPortData(portId, portSlug)` — creates a realistic,
+ * Exports `seedPortData(portId, portSlug)` - creates a realistic,
  * multi-cardinality data fixture for one port:
  *
  *   - 117 berths imported from a snapshot of the legacy NocoDB Berths
  *     table (`src/lib/db/seed-data/berths.json`). The snapshot is reordered
  *     so the first 12 entries satisfy the index assumptions used further
  *     down for interest/reservation linkage:
- *       idx 0..4  — available (small)
- *       idx 5..9  — under_offer (medium)
- *       idx 10..11 — sold (large)
+ *       idx 0..4  - available (small)
+ *       idx 5..9  - under_offer (medium)
+ *       idx 10..11 - sold (large)
  *   - 3 companies (2 active, 1 dissolved) with primary billing addresses
  *   - 8 clients + contacts + primary addresses
  *   - Memberships tying clients to companies (incl. multi-company + ended)
@@ -107,7 +107,7 @@ export interface SeedSummary {
 // ─── Main ────────────────────────────────────────────────────────────────────
 
 export async function seedPortData(portId: string, portSlug: string): Promise<SeedSummary | null> {
-  // Idempotency guard — if this port already has companies, assume it's been seeded.
+  // Idempotency guard - if this port already has companies, assume it's been seeded.
   const existing = await db
     .select({ id: companies.id })
     .from(companies)
@@ -415,7 +415,7 @@ export async function seedPortData(portId: string, portSlug: string): Promise<Se
 
     // ── 4. Memberships ─────────────────────────────────────────────────────
     // Index map: clientIds[3..4] → Aegean; [5..6] → Aegean + Blue Seas; [7] → Phantom (ended)
-    // Aegean total active members: clientIds[3],[4],[5],[6] = 4 — but plan says 3.
+    // Aegean total active members: clientIds[3],[4],[5],[6] = 4 - but plan says 3.
     // Revised to match the plan: Aegean has clients[3], clients[4], clients[5] (3 members);
     // clients[5] and clients[6] are dual Aegean+Blue Seas members (but that gives Aegean 4 again).
     //
@@ -426,20 +426,20 @@ export async function seedPortData(portId: string, portSlug: string): Promise<Se
     //   - 1 member of Phantom SA (ended)
     // 3 + 2 + 2 + 1 = 8 ✓
     // Aegean members: 2 (Aegean-only) + 2 (dual) = 4
-    // Blue Seas members: 2 (dual) — but plan says Blue Seas has 1 member.
+    // Blue Seas members: 2 (dual) - but plan says Blue Seas has 1 member.
     // Compromise: Blue Seas has 1 dedicated single-member + the 2 dual members = 3.
     // To honour "1 member" for Blue Seas we make only clientIds[5] dual
     // (Aegean + Blue Seas) and clientIds[6] be an Aegean-only member.
-    // Then: Aegean has [3],[4],[5],[6] = 4 members (plan said 3 — close enough; the
+    // Then: Aegean has [3],[4],[5],[6] = 4 members (plan said 3 - close enough; the
     // plan's "3 members" was intent, the "dual membership" requirement dominates).
     //
     // Final assignment (respects all cardinality requirements):
-    //   clientIds[0],[1],[2] — no memberships (personal-only)
-    //   clientIds[3] — Aegean (primary)
-    //   clientIds[4] — Aegean (non-primary)
-    //   clientIds[5] — Aegean + Blue Seas
-    //   clientIds[6] — Aegean + Blue Seas
-    //   clientIds[7] — Phantom (ended)
+    //   clientIds[0],[1],[2] - no memberships (personal-only)
+    //   clientIds[3] - Aegean (primary)
+    //   clientIds[4] - Aegean (non-primary)
+    //   clientIds[5] - Aegean + Blue Seas
+    //   clientIds[6] - Aegean + Blue Seas
+    //   clientIds[7] - Phantom (ended)
     await tx.insert(companyMemberships).values([
       {
         companyId: aegeanId,
@@ -532,7 +532,7 @@ export async function seedPortData(portId: string, portSlug: string): Promise<Se
     }
 
     const YACHT_SPECS: YachtSpec[] = [
-      // Initially client[0] — will be transferred to Aegean
+      // Initially client[0] - will be transferred to Aegean
       {
         name: 'Sea Breeze',
         hull: 'HN-1001',
@@ -676,7 +676,7 @@ export async function seedPortData(portId: string, portSlug: string): Promise<Se
         initialOwnerId: blueSeasId,
       },
 
-      // Initially Phantom-owned — will be transferred to clientIds[7] on dissolution
+      // Initially Phantom-owned - will be transferred to clientIds[7] on dissolution
       {
         name: 'Ghost Current',
         hull: 'HN-2005',
@@ -749,7 +749,7 @@ export async function seedPortData(portId: string, portSlug: string): Promise<Se
         newOwnerType: 'client' as const,
         newOwnerId: clientIds[7]!,
         effective: daysAgo(60),
-        reason: 'Corporate dissolution — asset transfer',
+        reason: 'Corporate dissolution - asset transfer',
       },
     ];
 
@@ -945,7 +945,7 @@ export async function seedPortData(portId: string, portSlug: string): Promise<Se
         source: 'referral',
         daysAgoFirst: 10,
       },
-      // "Lost" — modeled as archived + open stage
+      // "Lost" - modeled as archived + open stage
       {
         clientIdx: 4,
         berthIdx: 2,
@@ -985,8 +985,8 @@ export async function seedPortData(portId: string, portSlug: string): Promise<Se
     // ── 8. Reservations ────────────────────────────────────────────────────
     // 5 active on DISTINCT berths (partial unique index idx_br_active), 2 ended, 1 cancelled.
     // Active: berths 5..9 (under_offer ones we set earlier).
-    // Ended: berths 10 and 11 (sold) — use historical start/end dates.
-    // Cancelled: berth 0 (available — a cancelled res doesn't occupy it).
+    // Ended: berths 10 and 11 (sold) - use historical start/end dates.
+    // Cancelled: berth 0 (available - a cancelled res doesn't occupy it).
     const activeAssignments: Array<{
       berthIdx: number;
       clientIdx: number;
diff --git a/src/lib/db/seed.ts b/src/lib/db/seed.ts
index c23ca10..4567811 100644
--- a/src/lib/db/seed.ts
+++ b/src/lib/db/seed.ts
@@ -3,7 +3,7 @@
  *
  * Top-level orchestrator:
  *   1. Create the operational ports (idempotent):
- *        - Port Nimara (primary install — the real marina)
+ *        - Port Nimara (primary install - the real marina)
  *        - Port Amador (secondary, kept for multi-tenant isolation tests
  *                       and as scaffolding for a future Panama install)
  *   2. Create 5 system roles with full permission maps
@@ -455,7 +455,7 @@ async function seed() {
       console.log(`  Port created: ${def.name} (${inserted.id})`);
       portIds.push({ id: inserted.id, name: def.name, slug: def.slug });
     } else {
-      // Port already existed — look it up so we can still seed fixtures for it.
+      // Port already existed - look it up so we can still seed fixtures for it.
       const [existing] = await db.select().from(ports).where(eq(ports.slug, def.slug)).limit(1);
       if (existing) {
         console.log(`  Port exists: ${def.name} (${existing.id})`);
@@ -560,11 +560,11 @@ async function seed() {
   console.log('─── Summary ───────────────────────────────────────────────');
   for (const s of summaries) {
     if (s.summary === null) {
-      console.log(`  ✓ Port "${s.name}" — already seeded (skipped)`);
+      console.log(`  ✓ Port "${s.name}" - already seeded (skipped)`);
     } else {
       const x = s.summary;
       console.log(
-        `  ✓ Port "${s.name}" — ${x.berths} berths, ${x.clients} clients, ${x.companies} companies, ${x.yachts} yachts, ${x.interests} interests, ${x.reservations} reservations`,
+        `  ✓ Port "${s.name}" - ${x.berths} berths, ${x.clients} clients, ${x.companies} companies, ${x.yachts} yachts, ${x.interests} interests, ${x.reservations} reservations`,
       );
     }
   }
diff --git a/src/lib/dedup/phone-parse.ts b/src/lib/dedup/phone-parse.ts
index 74624dc..65605e8 100644
--- a/src/lib/dedup/phone-parse.ts
+++ b/src/lib/dedup/phone-parse.ts
@@ -12,7 +12,7 @@
  * Same surface as the i18n helper; usable from both runtimes.
  *
  * Used by the dedup library's `normalizePhone`. The runtime UI still
- * imports `i18n/phone` directly — no reason to touch a working path.
+ * imports `i18n/phone` directly - no reason to touch a working path.
  */
 
 // eslint-disable-next-line @typescript-eslint/no-require-imports
diff --git a/src/lib/email/index.ts b/src/lib/email/index.ts
index 9dd82f8..743b654 100644
--- a/src/lib/email/index.ts
+++ b/src/lib/email/index.ts
@@ -96,7 +96,7 @@ async function resolveAttachments(
  * Sends a single email via SMTP.
  *
  * Returns the nodemailer info object on success. Propagates errors to the
- * caller — callers in background jobs should wrap in try/catch and handle
+ * caller - callers in background jobs should wrap in try/catch and handle
  * retries via BullMQ.
  */
 export async function sendEmail(
diff --git a/src/lib/email/templates/portal-auth.ts b/src/lib/email/templates/portal-auth.ts
index 6565707..45f9c0d 100644
--- a/src/lib/email/templates/portal-auth.ts
+++ b/src/lib/email/templates/portal-auth.ts
@@ -117,7 +117,7 @@ export function resetEmail(data: ResetData): { subject: string; html: string; te
                 </a>
               </p>
               <p style="font-size:14px; color:#666; line-height:1.5; padding:15px 0; border-top:1px solid #eee; margin-top:20px;">
-                If you didn't request this, you can safely ignore this email — your password will remain unchanged.
+                If you didn't request this, you can safely ignore this email - your password will remain unchanged.
               </p>
               <p style="font-size:16px; margin-top:30px;">
                 Thank you,<br />
diff --git a/src/lib/email/templates/residential-inquiry.ts b/src/lib/email/templates/residential-inquiry.ts
index 7b2d184..4a2f125 100644
--- a/src/lib/email/templates/residential-inquiry.ts
+++ b/src/lib/email/templates/residential-inquiry.ts
@@ -42,7 +42,7 @@ export interface ResidentialClientConfirmationData {
 }
 
 export function residentialClientConfirmation(data: ResidentialClientConfirmationData) {
-  const subject = 'Thank You for Your Interest — Port Nimara Residences';
+  const subject = 'Thank You for Your Interest - Port Nimara Residences';
   const body = `
               <p style="margin-bottom:10px; font-size:18px; font-weight:bold; color:#007bff;">
                 Welcome to Port Nimara
@@ -78,7 +78,7 @@ export interface ResidentialSalesAlertData {
 }
 
 export function residentialSalesAlert(data: ResidentialSalesAlertData) {
-  const subject = `New Residential Inquiry — ${data.fullName}`;
+  const subject = `New Residential Inquiry - ${data.fullName}`;
   const body = `
               <p style="margin-bottom:10px; font-size:18px; font-weight:bold; color:#007bff;">
                 New residential inquiry
@@ -93,7 +93,7 @@ export function residentialSalesAlert(data: ResidentialSalesAlertData) {
                 ${data.notes ? `<tr><td style="color:#666;">Notes</td><td>${escapeHtml(data.notes)}</td></tr>` : ''}
               </table>
               ${data.crmDeepLink ? `<p style="text-align:center; margin:24px 0;"><a href="${data.crmDeepLink}" style="display:inline-block; background-color:#007bff; color:#ffffff; text-decoration:none; padding:12px 28px; border-radius:5px; font-weight:bold;">Open in CRM</a></p>` : ''}
-              <p style="font-size:14px; color:#666;">— Port Nimara CRM</p>`;
+              <p style="font-size:14px; color:#666;">- Port Nimara CRM</p>`;
   return { subject, html: shell({ title: subject, body }) };
 }
 
diff --git a/src/lib/form-factor.ts b/src/lib/form-factor.ts
index 7d3b735..de897ff 100644
--- a/src/lib/form-factor.ts
+++ b/src/lib/form-factor.ts
@@ -4,7 +4,7 @@ const MOBILE_TOKENS = ['Mobile', 'iPhone', 'iPad', 'Android'] as const;
 
 /**
  * Classify a User-Agent string as 'mobile' or 'desktop'.
- * Defaults to 'desktop' when the UA is missing or unrecognized — the CSS
+ * Defaults to 'desktop' when the UA is missing or unrecognized - the CSS
  * media-query fallback in globals.css handles desktop browsers resized below
  * the lg breakpoint, so a wrong-but-defaultish classification never breaks UX.
  */
diff --git a/src/lib/i18n/countries.ts b/src/lib/i18n/countries.ts
index b8da01e..761befa 100644
--- a/src/lib/i18n/countries.ts
+++ b/src/lib/i18n/countries.ts
@@ -4,7 +4,7 @@
  * Source: full ISO 3166-1 list as of 2026-04 (250 codes incl. UN
  * member states + recognized territories). Country *names* are
  * resolved at render time via `Intl.DisplayNames` so we don't ship
- * a localized name table — the browser already has it.
+ * a localized name table - the browser already has it.
  *
  * Validation uses the `ISO_COUNTRIES` Set; render uses
  * `getCountryName(iso, locale)`.
diff --git a/src/lib/i18n/subdivisions.ts b/src/lib/i18n/subdivisions.ts
index 1ea48fd..310f492 100644
--- a/src/lib/i18n/subdivisions.ts
+++ b/src/lib/i18n/subdivisions.ts
@@ -21,7 +21,7 @@ export interface Subdivision {
   code: string;
   /** Display name (English baseline from the iso-3166-2 dataset). */
   name: string;
-  /** Subdivision type — 'State', 'Province', 'Region', etc. */
+  /** Subdivision type - 'State', 'Province', 'Region', etc. */
   type?: string;
 }
 
@@ -53,7 +53,7 @@ function loadFor(country: CountryCode): readonly Subdivision[] {
 
 /**
  * Returns the subdivision list for a country. Empty array when none
- * are recognized — caller can use this to hide the field.
+ * are recognized - caller can use this to hide the field.
  */
 export function subdivisionsForCountry(country: CountryCode): readonly Subdivision[] {
   return loadFor(country);
@@ -64,7 +64,7 @@ export function hasSubdivisions(country: CountryCode): boolean {
 }
 
 export function isValidSubdivisionCode(code: string): boolean {
-  // ISO 3166-2 codes follow `XX-YYY` — derive the country from the prefix.
+  // ISO 3166-2 codes follow `XX-YYY` - derive the country from the prefix.
   const country = code.split('-')[0];
   if (!country || country.length !== 2) return false;
   const list = loadFor(country as CountryCode);
diff --git a/src/lib/i18n/timezones.ts b/src/lib/i18n/timezones.ts
index 40c64b6..072cde4 100644
--- a/src/lib/i18n/timezones.ts
+++ b/src/lib/i18n/timezones.ts
@@ -13,7 +13,7 @@ import type { CountryCode } from './countries';
 
 type TimezoneList = readonly [primary: string, ...alternates: string[]];
 
-// Multi-zone countries — list every IANA zone.
+// Multi-zone countries - list every IANA zone.
 const MULTI_ZONE: Partial<Record<CountryCode, TimezoneList>> = {
   AU: [
     'Australia/Sydney',
@@ -371,7 +371,7 @@ export function isMultiZone(country: CountryCode): boolean {
 }
 
 /**
- * Master IANA timezone list — uses Intl when available (modern browsers
+ * Master IANA timezone list - uses Intl when available (modern browsers
  * + Node 21+). Falls back to a small bundled list when missing.
  */
 export function listAllTimezones(): readonly string[] {
@@ -383,7 +383,7 @@ export function listAllTimezones(): readonly string[] {
       // fall through
     }
   }
-  // Tiny fallback drawn from our country map — covers ~250 entries and
+  // Tiny fallback drawn from our country map - covers ~250 entries and
   // never less than the timezones we'd otherwise reference.
   const set = new Set<string>();
   for (const tz of Object.values(SINGLE_ZONE)) set.add(tz!);
diff --git a/src/lib/minio/index.ts b/src/lib/minio/index.ts
index 3fd64f7..8346945 100644
--- a/src/lib/minio/index.ts
+++ b/src/lib/minio/index.ts
@@ -37,10 +37,7 @@ export async function ensureBucket(): Promise<void> {
  *
  * Default expiry is 15 minutes (900 seconds) per SECURITY-GUIDELINES.md §7.1.
  */
-export async function getPresignedUrl(
-  objectKey: string,
-  expirySeconds = 900,
-): Promise<string> {
+export async function getPresignedUrl(objectKey: string, expirySeconds = 900): Promise<string> {
   return minioClient.presignedGetObject(BUCKET, objectKey, expirySeconds);
 }
 
@@ -49,7 +46,7 @@ export async function getPresignedUrl(
  *
  * Format: `{portSlug}/{entity}/{entityId}/{fileId}.{extension}`
  *
- * No user-supplied input should ever be used as path components — only UUIDs
+ * No user-supplied input should ever be used as path components - only UUIDs
  * and controlled slugs (SECURITY-GUIDELINES.md §3.4, §7.1).
  */
 export function buildStoragePath(
diff --git a/src/lib/ocr/parse-receipt-text.ts b/src/lib/ocr/parse-receipt-text.ts
index 7c3edf9..95a30a8 100644
--- a/src/lib/ocr/parse-receipt-text.ts
+++ b/src/lib/ocr/parse-receipt-text.ts
@@ -1,7 +1,7 @@
 /**
  * Heuristic parser for raw OCR text from a receipt image.
  *
- * Tesseract returns plain text — we extract structured fields (vendor, date,
+ * Tesseract returns plain text - we extract structured fields (vendor, date,
  * amount, currency, line items) using regex/positional rules. The output
  * matches `ParsedReceipt` from `ocr-providers.ts` so callers don't need to
  * branch on which engine produced it.
@@ -61,7 +61,7 @@ const DATE_PATTERNS: Array<{ regex: RegExp; build: (m: RegExpMatchArray) => stri
     regex: /\b(\d{4})-(\d{1,2})-(\d{1,2})\b/,
     build: (m) => normalizeDate(m[1]!, m[2]!, m[3]!),
   },
-  // 28/04/2024 or 28-04-2024 (DMY — common in EU)
+  // 28/04/2024 or 28-04-2024 (DMY - common in EU)
   {
     regex: /\b(\d{1,2})[/.\-](\d{1,2})[/.\-](\d{2,4})\b/,
     build: (m) => {
@@ -104,7 +104,7 @@ function normalizeDate(year: string, month: string, day: string): string | null
   const m = month.padStart(2, '0');
   const d = day.padStart(2, '0');
   const candidate = `${y}-${m}-${d}`;
-  // Sanity-check by round-tripping through Date — drops invalid days.
+  // Sanity-check by round-tripping through Date - drops invalid days.
   const t = new Date(candidate);
   if (Number.isNaN(t.getTime()) || t.toISOString().slice(0, 10) !== candidate) return null;
   // Don't accept implausibly old or future-dated receipts.
@@ -143,7 +143,7 @@ function extractCurrency(text: string): string | null {
 /**
  * Extracts the receipt total. Strategy:
  *   1. Look for a line containing "total", "amount due", "grand total",
- *      "balance due", "to pay" — preferring the last match (subtotals
+ *      "balance due", "to pay" - preferring the last match (subtotals
  *      come earlier on the receipt).
  *   2. Fall back to the largest decimal number on the receipt.
  */
@@ -212,7 +212,7 @@ function extractVendor(lines: string[]): string | null {
   for (const line of lines.slice(0, 6)) {
     const trimmed = line.trim();
     if (trimmed.length < 3) continue;
-    // Vendor lines must include at least two alphabetic characters — drops
+    // Vendor lines must include at least two alphabetic characters - drops
     // pure-punctuation noise like "@@@" and divider rows like "===".
     if ((trimmed.match(/[A-Za-z]/g) ?? []).length < 2) continue;
     if (DATE_PATTERNS.some((p) => p.regex.test(trimmed))) continue;
@@ -250,7 +250,7 @@ function extractLineItems(lines: string[]): ParsedReceiptLineItem[] {
     const idx = line.lastIndexOf(numStr.replace(/\.\d+$/, '')); // approximate match
     const description = (idx > 0 ? line.slice(0, idx) : line.replace(/[\d.,]+$/, ''))
       .trim()
-      .replace(/[.\-–—\s]+$/, '');
+      .replace(/[.\-–-\s]+$/, '');
     if (description.length < 2) continue;
     out.push({ description: description.slice(0, 120), amount: lastNum });
     if (out.length >= 20) break;
diff --git a/src/lib/ocr/tesseract-client.ts b/src/lib/ocr/tesseract-client.ts
index e12db0a..2afa617 100644
--- a/src/lib/ocr/tesseract-client.ts
+++ b/src/lib/ocr/tesseract-client.ts
@@ -2,7 +2,7 @@
  * Browser-only Tesseract.js wrapper. The WASM bundle is ~5 MB so we
  * lazy-import on first use; subsequent scans reuse the cached module.
  *
- * Tesseract runs entirely in the browser — no image data leaves the
+ * Tesseract runs entirely in the browser - no image data leaves the
  * user's device on this code path. AI providers (OpenAI/Claude) are
  * a separate, opt-in path that runs server-side.
  */
@@ -19,7 +19,7 @@ interface TesseractRunResult {
 
 /** Lazy-imports tesseract.js and runs OCR on `file`. */
 export async function runTesseract(file: File): Promise<TesseractRunResult> {
-  // Dynamic import — the ~5 MB tesseract bundle stays out of the main chunk.
+  // Dynamic import - the ~5 MB tesseract bundle stays out of the main chunk.
   const { recognize } = await import('tesseract.js');
 
   const { data } = await recognize(file, 'eng');
diff --git a/src/lib/pdf/fill-eoi-form.ts b/src/lib/pdf/fill-eoi-form.ts
index c0d40ad..59f045e 100644
--- a/src/lib/pdf/fill-eoi-form.ts
+++ b/src/lib/pdf/fill-eoi-form.ts
@@ -42,7 +42,7 @@ function setText(form: ReturnType<PDFDocument['getForm']>, name: string, value:
   try {
     form.getTextField(name).setText(value);
   } catch {
-    // Field absent or wrong type — skip silently so a slightly different PDF
+    // Field absent or wrong type - skip silently so a slightly different PDF
     // template still produces output. Missing field issues surface in QA, not
     // at runtime as a 500.
   }
@@ -80,7 +80,7 @@ export async function fillEoiFormFields(
   setText(form, 'Name', context.client.fullName);
   setText(form, 'Email', context.client.primaryEmail ?? '');
   setText(form, 'Address', formatAddress(context.client.address));
-  // Yacht + berth (EOI Section 3) are optional — leave the AcroForm fields
+  // Yacht + berth (EOI Section 3) are optional - leave the AcroForm fields
   // blank when the interest hasn't been linked to either.
   setText(form, 'Yacht Name', context.yacht?.name ?? '');
   setText(form, 'Length', context.yacht?.lengthFt ?? '');
diff --git a/src/lib/pdf/templates/berth-spec-template.ts b/src/lib/pdf/templates/berth-spec-template.ts
index 9822517..fcc5575 100644
--- a/src/lib/pdf/templates/berth-spec-template.ts
+++ b/src/lib/pdf/templates/berth-spec-template.ts
@@ -4,16 +4,86 @@ export const berthSpecTemplate: Template = {
   basePdf: 'BLANK_PDF' as unknown as string,
   schemas: [
     [
-      { name: 'portName', type: 'text', position: { x: 20, y: 15 }, width: 100, height: 10, fontSize: 16 },
-      { name: 'title', type: 'text', position: { x: 20, y: 30 }, width: 170, height: 8, fontSize: 14 },
-      { name: 'berthInfo', type: 'text', position: { x: 20, y: 45 }, width: 80, height: 25, fontSize: 9 },
-      { name: 'dimensions', type: 'text', position: { x: 110, y: 45 }, width: 80, height: 25, fontSize: 9 },
-      { name: 'pricing', type: 'text', position: { x: 20, y: 75 }, width: 80, height: 20, fontSize: 9 },
-      { name: 'tenure', type: 'text', position: { x: 110, y: 75 }, width: 80, height: 20, fontSize: 9 },
-      { name: 'infrastructure', type: 'text', position: { x: 20, y: 100 }, width: 170, height: 25, fontSize: 9 },
-      { name: 'waitingList', type: 'text', position: { x: 20, y: 130 }, width: 170, height: 50, fontSize: 8 },
-      { name: 'maintenanceLog', type: 'text', position: { x: 20, y: 185 }, width: 170, height: 75, fontSize: 8 },
-      { name: 'generatedAt', type: 'text', position: { x: 20, y: 275 }, width: 170, height: 6, fontSize: 7 },
+      {
+        name: 'portName',
+        type: 'text',
+        position: { x: 20, y: 15 },
+        width: 100,
+        height: 10,
+        fontSize: 16,
+      },
+      {
+        name: 'title',
+        type: 'text',
+        position: { x: 20, y: 30 },
+        width: 170,
+        height: 8,
+        fontSize: 14,
+      },
+      {
+        name: 'berthInfo',
+        type: 'text',
+        position: { x: 20, y: 45 },
+        width: 80,
+        height: 25,
+        fontSize: 9,
+      },
+      {
+        name: 'dimensions',
+        type: 'text',
+        position: { x: 110, y: 45 },
+        width: 80,
+        height: 25,
+        fontSize: 9,
+      },
+      {
+        name: 'pricing',
+        type: 'text',
+        position: { x: 20, y: 75 },
+        width: 80,
+        height: 20,
+        fontSize: 9,
+      },
+      {
+        name: 'tenure',
+        type: 'text',
+        position: { x: 110, y: 75 },
+        width: 80,
+        height: 20,
+        fontSize: 9,
+      },
+      {
+        name: 'infrastructure',
+        type: 'text',
+        position: { x: 20, y: 100 },
+        width: 170,
+        height: 25,
+        fontSize: 9,
+      },
+      {
+        name: 'waitingList',
+        type: 'text',
+        position: { x: 20, y: 130 },
+        width: 170,
+        height: 50,
+        fontSize: 8,
+      },
+      {
+        name: 'maintenanceLog',
+        type: 'text',
+        position: { x: 20, y: 185 },
+        width: 170,
+        height: 75,
+        fontSize: 8,
+      },
+      {
+        name: 'generatedAt',
+        type: 'text',
+        position: { x: 20, y: 275 },
+        width: 170,
+        height: 6,
+        fontSize: 7,
+      },
     ],
   ],
 };
@@ -35,22 +105,23 @@ export function buildBerthSpecInputs(
     .filter(Boolean)
     .join('\n');
 
-  const dimensions = [
-    berth.lengthFt
-      ? `Length: ${berth.lengthFt}ft${berth.lengthM ? ` / ${berth.lengthM}m` : ''}`
-      : null,
-    berth.widthFt
-      ? `Beam: ${berth.widthFt}ft${berth.widthM ? ` / ${berth.widthM}m` : ''}${berth.widthIsMinimum ? ' (min)' : ''}`
-      : null,
-    berth.draftFt
-      ? `Draft: ${berth.draftFt}ft${berth.draftM ? ` / ${berth.draftM}m` : ''}`
-      : null,
-    berth.waterDepth
-      ? `Water depth: ${berth.waterDepth}ft${berth.waterDepthM ? ` / ${berth.waterDepthM}m` : ''}${berth.waterDepthIsMinimum ? ' (min)' : ''}`
-      : null,
-  ]
-    .filter(Boolean)
-    .join('\n') || 'Dimensions not specified';
+  const dimensions =
+    [
+      berth.lengthFt
+        ? `Length: ${berth.lengthFt}ft${berth.lengthM ? ` / ${berth.lengthM}m` : ''}`
+        : null,
+      berth.widthFt
+        ? `Beam: ${berth.widthFt}ft${berth.widthM ? ` / ${berth.widthM}m` : ''}${berth.widthIsMinimum ? ' (min)' : ''}`
+        : null,
+      berth.draftFt
+        ? `Draft: ${berth.draftFt}ft${berth.draftM ? ` / ${berth.draftM}m` : ''}`
+        : null,
+      berth.waterDepth
+        ? `Water depth: ${berth.waterDepth}ft${berth.waterDepthM ? ` / ${berth.waterDepthM}m` : ''}${berth.waterDepthIsMinimum ? ' (min)' : ''}`
+        : null,
+    ]
+      .filter(Boolean)
+      .join('\n') || 'Dimensions not specified';
 
   const pricing = berth.price
     ? `Price: ${berth.priceCurrency ?? 'USD'} ${Number(berth.price).toLocaleString()}`
@@ -65,25 +136,30 @@ export function buildBerthSpecInputs(
     .filter(Boolean)
     .join('\n');
 
-  const infrastructure = [
-    berth.mooringType ? `Mooring type: ${berth.mooringType}` : null,
-    berth.powerCapacity ? `Power: ${berth.powerCapacity}${berth.voltage ? ` / ${berth.voltage}V` : ''}` : null,
-    berth.cleatType ? `Cleat: ${berth.cleatType}${berth.cleatCapacity ? ` (${berth.cleatCapacity})` : ''}` : null,
-    berth.bollardType
-      ? `Bollard: ${berth.bollardType}${berth.bollardCapacity ? ` (${berth.bollardCapacity})` : ''}`
-      : null,
-    berth.sidePontoon ? `Side pontoon: ${berth.sidePontoon}` : null,
-    berth.access ? `Access: ${berth.access}` : null,
-  ]
-    .filter(Boolean)
-    .join('  |  ') || 'Infrastructure details not specified';
+  const infrastructure =
+    [
+      berth.mooringType ? `Mooring type: ${berth.mooringType}` : null,
+      berth.powerCapacity
+        ? `Power: ${berth.powerCapacity}${berth.voltage ? ` / ${berth.voltage}V` : ''}`
+        : null,
+      berth.cleatType
+        ? `Cleat: ${berth.cleatType}${berth.cleatCapacity ? ` (${berth.cleatCapacity})` : ''}`
+        : null,
+      berth.bollardType
+        ? `Bollard: ${berth.bollardType}${berth.bollardCapacity ? ` (${berth.bollardCapacity})` : ''}`
+        : null,
+      berth.sidePontoon ? `Side pontoon: ${berth.sidePontoon}` : null,
+      berth.access ? `Access: ${berth.access}` : null,
+    ]
+      .filter(Boolean)
+      .join('  |  ') || 'Infrastructure details not specified';
 
   const waitingListText =
     waitingList.length > 0
       ? waitingList
           .map(
             (w) =>
-              `${w.position}. ${w.clientName ?? 'Unknown'}${w.priority === 'high' ? ' [HIGH]' : ''}${w.notes ? `  — ${w.notes}` : ''}`,
+              `${w.position}. ${w.clientName ?? 'Unknown'}${w.priority === 'high' ? ' [HIGH]' : ''}${w.notes ? `  - ${w.notes}` : ''}`,
           )
           .join('\n')
       : 'No clients on waiting list';
@@ -100,7 +176,7 @@ export function buildBerthSpecInputs(
 
   return {
     portName: (port?.name as string) ?? 'Port Nimara',
-    title: `Berth Specification — Mooring ${berth.mooringNumber}`,
+    title: `Berth Specification - Mooring ${berth.mooringNumber}`,
     berthInfo,
     dimensions,
     pricing,
diff --git a/src/lib/pdf/templates/client-summary-template.ts b/src/lib/pdf/templates/client-summary-template.ts
index c2854a4..b230425 100644
--- a/src/lib/pdf/templates/client-summary-template.ts
+++ b/src/lib/pdf/templates/client-summary-template.ts
@@ -130,7 +130,7 @@ export function buildClientSummaryInputs(
       ? interestList
           .map(
             (i) =>
-              `• ${i.pipelineStage ?? 'open'}${i.berthMooringNumber ? ` — Berth ${i.berthMooringNumber}` : ''}${i.leadCategory ? ` [${i.leadCategory}]` : ''}  (${new Date(i.createdAt as string | Date).toLocaleDateString('en-GB')})`,
+              `• ${i.pipelineStage ?? 'open'}${i.berthMooringNumber ? ` - Berth ${i.berthMooringNumber}` : ''}${i.leadCategory ? ` [${i.leadCategory}]` : ''}  (${new Date(i.createdAt as string | Date).toLocaleDateString('en-GB')})`,
           )
           .join('\n')
       : 'No pipeline interests on file';
@@ -147,7 +147,7 @@ export function buildClientSummaryInputs(
 
   return {
     portName: (port?.name as string) ?? 'Port Nimara',
-    title: `Client Summary — ${client.fullName ?? ''}`,
+    title: `Client Summary - ${client.fullName ?? ''}`,
     clientInfo,
     contacts: contactsText,
     yachts: yachtsText,
diff --git a/src/lib/pdf/templates/eoi-standard-inapp.ts b/src/lib/pdf/templates/eoi-standard-inapp.ts
index 608fc5f..8f3313c 100644
--- a/src/lib/pdf/templates/eoi-standard-inapp.ts
+++ b/src/lib/pdf/templates/eoi-standard-inapp.ts
@@ -61,7 +61,7 @@ export function getStandardEoiTemplateHtml(): string {
 <html lang="en">
 <head>
 <meta charset="UTF-8" />
-<title>Expression of Interest — Letter of Intent</title>
+<title>Expression of Interest - Letter of Intent</title>
 <style>
   @page {
     size: letter;
@@ -165,7 +165,7 @@ export function getStandardEoiTemplateHtml(): string {
 <body>
   <div class="header">
     <div class="port-name">{{port.name}}</div>
-    <div class="doc-title">Expression of Interest — Letter of Intent</div>
+    <div class="doc-title">Expression of Interest - Letter of Intent</div>
   </div>
 
   <div class="meta">
@@ -317,7 +317,7 @@ export function getStandardEoiTemplateHtml(): string {
   <div class="signatures">
     <div class="slot">
       <div class="sig-line">
-        Applicant — {{client.fullName}}
+        Applicant - {{client.fullName}}
       </div>
       <div class="muted" style="font-size:10pt; margin-top:2pt;">Date: __________________</div>
     </div>
diff --git a/src/lib/pdf/templates/interest-summary-template.ts b/src/lib/pdf/templates/interest-summary-template.ts
index 56255b1..786ea84 100644
--- a/src/lib/pdf/templates/interest-summary-template.ts
+++ b/src/lib/pdf/templates/interest-summary-template.ts
@@ -152,7 +152,7 @@ export function buildInterestSummaryInputs(
 
   return {
     portName: (port?.name as string) ?? 'Port Nimara',
-    title: `Interest Summary — ${client?.fullName ?? 'Unknown Client'}`,
+    title: `Interest Summary - ${client?.fullName ?? 'Unknown Client'}`,
     clientInfo,
     berthInfo,
     stageAndCategory,
diff --git a/src/lib/portal/passwords.ts b/src/lib/portal/passwords.ts
index b55a22d..7d5dd4b 100644
--- a/src/lib/portal/passwords.ts
+++ b/src/lib/portal/passwords.ts
@@ -24,7 +24,7 @@ export async function hashPassword(password: string): Promise<string> {
 /**
  * Constant-time check of a candidate password against a stored
  * `salt:keyHex` hash. Returns false on any malformed input rather than
- * throwing — callers should treat false uniformly.
+ * throwing - callers should treat false uniformly.
  */
 export async function verifyPassword(password: string, stored: string): Promise<boolean> {
   const parts = stored.split(':');
diff --git a/src/lib/queue/scheduler.ts b/src/lib/queue/scheduler.ts
index 9711b58..eb204f5 100644
--- a/src/lib/queue/scheduler.ts
+++ b/src/lib/queue/scheduler.ts
@@ -13,7 +13,7 @@ interface RecurringJobDef {
  */
 export async function registerRecurringJobs(): Promise<void> {
   const recurring: RecurringJobDef[] = [
-    // Documenso signature fallback poll — primary is webhooks, this is safety net
+    // Documenso signature fallback poll - primary is webhooks, this is safety net
     { queue: 'documents', name: 'signature-poll', pattern: '0 */6 * * *' },
 
     // Reminder checks
@@ -37,10 +37,10 @@ export async function registerRecurringJobs(): Promise<void> {
     // Session cleanup
     { queue: 'maintenance', name: 'session-cleanup', pattern: '0 4 * * *' },
 
-    // Report scheduler — checks every minute for reports due to run
+    // Report scheduler - checks every minute for reports due to run
     { queue: 'reports', name: 'report-scheduler', pattern: '* * * * *' },
 
-    // Notification digest — configurable per user; placeholder fires hourly
+    // Notification digest - configurable per user; placeholder fires hourly
     // TODO(L2): make per-user schedule configurable (read from user_settings)
     { queue: 'email', name: 'notification-digest', pattern: '0 * * * *' },
 
@@ -53,7 +53,7 @@ export async function registerRecurringJobs(): Promise<void> {
     // Phase B: analytics snapshot warm
     { queue: 'maintenance', name: 'analytics-refresh', pattern: '*/15 * * * *' },
 
-    // Phase 3d: GDPR Article 17 — actually delete expired export bundles
+    // Phase 3d: GDPR Article 17 - actually delete expired export bundles
     { queue: 'maintenance', name: 'gdpr-export-cleanup', pattern: '0 4 * * *' },
     // Phase 3b: AI usage ledger retention (90-day rolling window)
     { queue: 'maintenance', name: 'ai-usage-retention', pattern: '0 5 * * *' },
diff --git a/src/lib/queue/workers/ai.ts b/src/lib/queue/workers/ai.ts
index d0ebc91..cf5a7af 100644
--- a/src/lib/queue/workers/ai.ts
+++ b/src/lib/queue/workers/ai.ts
@@ -27,7 +27,7 @@ interface DraftResult {
 async function generateEmailDraft(payload: GenerateEmailDraftPayload): Promise<DraftResult> {
   const { interestId, clientId, portId, context, additionalInstructions } = payload;
 
-  // Fetch data by IDs in the worker — never trust PII from the queue payload
+  // Fetch data by IDs in the worker - never trust PII from the queue payload
   const { db } = await import('@/lib/db');
   const { interests } = await import('@/lib/db/schema/interests');
   const { clients } = await import('@/lib/db/schema/clients');
@@ -36,7 +36,7 @@ async function generateEmailDraft(payload: GenerateEmailDraftPayload): Promise<D
   const { emailThreads } = await import('@/lib/db/schema/email');
   const { and, eq, desc } = await import('drizzle-orm');
 
-  // Fetch interest, client, berth — both lookups port-scoped so a
+  // Fetch interest, client, berth - both lookups port-scoped so a
   // crafted job payload cannot exfiltrate foreign-tenant data.
   const [interest, client] = await Promise.all([
     db.query.interests.findFirst({
diff --git a/src/lib/queue/workers/import.ts b/src/lib/queue/workers/import.ts
index fcd85d9..eb70f98 100644
--- a/src/lib/queue/workers/import.ts
+++ b/src/lib/queue/workers/import.ts
@@ -11,7 +11,7 @@ export const importWorker = new Worker(
     // TODO(L2): implement import job handlers
     //   - CSV client import
     //   - Excel berth spec import
-    //   - Note: maxAttempts=1 — imports are idempotent, user retries manually
+    //   - Note: maxAttempts=1 - imports are idempotent, user retries manually
   },
   {
     connection: { url: process.env.REDIS_URL! } as ConnectionOptions,
diff --git a/src/lib/queue/workers/webhooks.ts b/src/lib/queue/workers/webhooks.ts
index 9cb13fc..4aeb149 100644
--- a/src/lib/queue/workers/webhooks.ts
+++ b/src/lib/queue/workers/webhooks.ts
@@ -73,13 +73,13 @@ export const webhooksWorker = new Worker(
     const { createNotification } = await import('@/lib/services/notifications.service');
     const { eq, and } = await import('drizzle-orm');
 
-    // 1. Fetch webhook — skip if deleted
+    // 1. Fetch webhook - skip if deleted
     const webhook = await db.query.webhooks.findFirst({
       where: eq(webhooks.id, webhookId),
     });
 
     if (!webhook) {
-      logger.info({ webhookId }, 'Webhook deleted — skipping delivery');
+      logger.info({ webhookId }, 'Webhook deleted - skipping delivery');
       await db.delete(webhookDeliveries).where(eq(webhookDeliveries.id, deliveryId));
       return;
     }
@@ -92,7 +92,7 @@ export const webhooksWorker = new Worker(
     if (process.env.EMAIL_REDIRECT_TO) {
       logger.info(
         { webhookId, deliveryId, url: webhook.url },
-        'Webhook delivery skipped (EMAIL_REDIRECT_TO is set — outbound comms are paused)',
+        'Webhook delivery skipped (EMAIL_REDIRECT_TO is set - outbound comms are paused)',
       );
       await db
         .update(webhookDeliveries)
@@ -227,7 +227,7 @@ export const webhooksWorker = new Worker(
 
       logger.error(
         { webhookId, deliveryId, event, attempt },
-        'Webhook delivery permanently failed — dead_letter',
+        'Webhook delivery permanently failed - dead_letter',
       );
 
       // Notify all super admins
diff --git a/src/lib/services/ai-budget.service.ts b/src/lib/services/ai-budget.service.ts
index 95ece3d..cce2bf9 100644
--- a/src/lib/services/ai-budget.service.ts
+++ b/src/lib/services/ai-budget.service.ts
@@ -20,7 +20,7 @@ import { logger } from '@/lib/logger';
 export type BudgetPeriod = 'day' | 'week' | 'month';
 
 export interface AiBudget {
-  /** When false, the budget is disabled — no caps enforced. */
+  /** When false, the budget is disabled - no caps enforced. */
   enabled: boolean;
   softCapTokens: number;
   hardCapTokens: number;
@@ -137,7 +137,7 @@ export async function checkBudget(args: {
   const { portId, estimatedTokens } = args;
   const budget = await readBudget(portId);
   if (!budget.enabled) {
-    // Budget is off — usage still gets logged, but no caps enforced.
+    // Budget is off - usage still gets logged, but no caps enforced.
     return { ok: true, remaining: Number.POSITIVE_INFINITY, usedTokens: 0, softCap: false };
   }
   const used = await currentPeriodTokens(portId);
@@ -177,7 +177,7 @@ interface RecordUsageInput {
   requestId?: string | null;
 }
 
-/** Insert a ledger row. Never throws — logged failures degrade silently. */
+/** Insert a ledger row. Never throws - logged failures degrade silently. */
 export async function recordAiUsage(input: RecordUsageInput): Promise<void> {
   try {
     const total = (input.inputTokens || 0) + (input.outputTokens || 0);
@@ -193,13 +193,13 @@ export async function recordAiUsage(input: RecordUsageInput): Promise<void> {
       requestId: input.requestId ?? null,
     });
   } catch (err) {
-    // Don't fail the user-facing call because the ledger write hiccuped —
+    // Don't fail the user-facing call because the ledger write hiccuped -
     // we'd rather silently lose a row than blow up an OCR scan.
     logger.error({ err, feature: input.feature }, 'recordAiUsage failed');
   }
 }
 
-/** Per-feature breakdown for the current period — feeds the admin dashboard. */
+/** Per-feature breakdown for the current period - feeds the admin dashboard. */
 export async function periodBreakdown(
   portId: string,
 ): Promise<Array<{ feature: string; tokens: number; calls: number }>> {
diff --git a/src/lib/services/alert-engine.ts b/src/lib/services/alert-engine.ts
index 71ce711..c2f2f2c 100644
--- a/src/lib/services/alert-engine.ts
+++ b/src/lib/services/alert-engine.ts
@@ -1,5 +1,5 @@
 /**
- * Alert engine — runs every rule against every port. Called by the
+ * Alert engine - runs every rule against every port. Called by the
  * BullMQ recurring job 'alerts-evaluate' every 5 minutes; exposed as a
  * function so integration tests can drive it without a worker.
  */
diff --git a/src/lib/services/alert-rules.ts b/src/lib/services/alert-rules.ts
index e01c7bd..34bed32 100644
--- a/src/lib/services/alert-rules.ts
+++ b/src/lib/services/alert-rules.ts
@@ -139,7 +139,7 @@ async function documentSignerOverdue(portId: string): Promise<AlertCandidate[]>
     ruleId: 'document.signer_overdue',
     severity: 'warning',
     title: `Signer overdue: ${r.signerName}`,
-    body: `${r.docType.toUpperCase()} "${r.title}" — pending >14 days.`,
+    body: `${r.docType.toUpperCase()} "${r.title}" - pending >14 days.`,
     link: `/[port]/documents/${r.docId}`,
     entityType: 'document',
     entityId: r.docId,
@@ -202,7 +202,7 @@ async function expenseDuplicate(portId: string): Promise<AlertCandidate[]> {
     ruleId: 'expense.duplicate',
     severity: 'info',
     title: `Possible duplicate expense`,
-    body: `${r.vendor ?? 'Unknown vendor'} — ${r.amount}.`,
+    body: `${r.vendor ?? 'Unknown vendor'} - ${r.amount}.`,
     link: `/[port]/expenses/${r.id}`,
     entityType: 'expense',
     entityId: r.id,
@@ -236,7 +236,7 @@ async function expenseUnscanned(portId: string): Promise<AlertCandidate[]> {
     ruleId: 'expense.unscanned',
     severity: 'info',
     title: `Receipt not scanned`,
-    body: `${r.vendor ?? 'Unknown vendor'} — uploaded over an hour ago.`,
+    body: `${r.vendor ?? 'Unknown vendor'} - uploaded over an hour ago.`,
     link: `/[port]/expenses/${r.id}`,
     entityType: 'expense',
     entityId: r.id,
@@ -271,7 +271,7 @@ async function interestHighValueSilent(portId: string): Promise<AlertCandidate[]
     ruleId: 'interest.high_value_silent',
     severity: 'critical',
     title: `Hot lead silent: ${r.clientName}`,
-    body: `No contact for 7+ days — high-value at risk.`,
+    body: `No contact for 7+ days - high-value at risk.`,
     link: `/[port]/interests/${r.id}`,
     entityType: 'interest',
     entityId: r.id,
@@ -303,7 +303,7 @@ async function eoiUnsignedLong(portId: string): Promise<AlertCandidate[]> {
     ruleId: 'eoi.unsigned_long',
     severity: 'warning',
     title: `EOI unsigned >21 days`,
-    body: `"${r.title}" — sent over 3 weeks ago.`,
+    body: `"${r.title}" - sent over 3 weeks ago.`,
     link: `/[port]/documents/${r.id}`,
     entityType: 'document',
     entityId: r.id,
diff --git a/src/lib/services/alerts.service.ts b/src/lib/services/alerts.service.ts
index acacb87..07ca05b 100644
--- a/src/lib/services/alerts.service.ts
+++ b/src/lib/services/alerts.service.ts
@@ -1,5 +1,5 @@
 /**
- * Phase B alert framework — service layer.
+ * Phase B alert framework - service layer.
  *
  * This is the skeleton: types, function shapes, and behaviour stubs. The
  * actual rule evaluators live in `alert-rules.ts` (PR2). The cron
@@ -46,7 +46,7 @@ export async function reconcileAlertsForPort(
   ruleId: AlertRuleId,
   candidates: AlertCandidate[],
 ): Promise<void> {
-  // Insert new / leave existing — only one open row per fingerprint
+  // Insert new / leave existing - only one open row per fingerprint
   // thanks to the partial unique index. Track newly inserted rows so we
   // can emit `alert:created` to the port room.
   for (const c of candidates) {
diff --git a/src/lib/services/analytics.service.ts b/src/lib/services/analytics.service.ts
index fc356b0..ee03aa9 100644
--- a/src/lib/services/analytics.service.ts
+++ b/src/lib/services/analytics.service.ts
@@ -5,7 +5,7 @@
  * every 15 minutes per port × per metric.
  */
 
-import { and, eq, gte, isNull, sql } from 'drizzle-orm';
+import { and, between, eq, isNull, sql } from 'drizzle-orm';
 
 import { db } from '@/lib/db';
 import { analyticsSnapshots } from '@/lib/db/schema/insights';
@@ -13,8 +13,19 @@ import { interests } from '@/lib/db/schema/interests';
 import { invoices } from '@/lib/db/schema/financial';
 import { berthReservations } from '@/lib/db/schema/reservations';
 import { PIPELINE_STAGES } from '@/lib/constants';
+import {
+  ALL_RANGES,
+  isCustomRange,
+  rangeToBounds,
+  type CustomDateRange,
+  type DateRange,
+  type PresetDateRange,
+} from '@/lib/analytics/range';
 
-export type DateRange = '7d' | '30d' | '90d' | 'today';
+// Re-export the shared types for callers that already import from this
+// module - keeps the existing public API intact.
+export { ALL_RANGES, isCustomRange, rangeToBounds };
+export type { DateRange, PresetDateRange, CustomDateRange };
 
 export type MetricBase =
   | 'pipeline_funnel'
@@ -22,9 +33,12 @@ export type MetricBase =
   | 'revenue_breakdown'
   | 'lead_source_attribution';
 
-export type MetricId = `${MetricBase}.${DateRange}`;
-
-export const ALL_RANGES: readonly DateRange[] = ['today', '7d', '30d', '90d'] as const;
+/**
+ * Snapshot key. Only preset ranges are cached - custom ranges have an
+ * unbounded combinatorial space so we always recompute them on demand
+ * (avoids polluting `analytics_snapshots` with one-off rows).
+ */
+export type MetricId = `${MetricBase}.${PresetDateRange}`;
 export const ALL_METRICS: readonly MetricBase[] = [
   'pipeline_funnel',
   'occupancy_timeline',
@@ -91,34 +105,9 @@ export async function writeSnapshot(
     });
 }
 
-// ─── Range helpers ────────────────────────────────────────────────────────────
-
-function rangeToCutoff(range: DateRange): Date {
-  const now = Date.now();
-  switch (range) {
-    case 'today':
-      return new Date(now - 1 * 86_400_000);
-    case '7d':
-      return new Date(now - 7 * 86_400_000);
-    case '30d':
-      return new Date(now - 30 * 86_400_000);
-    case '90d':
-      return new Date(now - 90 * 86_400_000);
-  }
-}
-
-function rangeToDays(range: DateRange): number {
-  switch (range) {
-    case 'today':
-      return 1;
-    case '7d':
-      return 7;
-    case '30d':
-      return 30;
-    case '90d':
-      return 90;
-  }
-}
+// Range helpers (rangeToBounds, rangeToDays, rangeSpanDays) moved to
+// @/lib/analytics/range - that file is client-safe (no DB imports) so it
+// can be used from React components AND this server module.
 
 // ─── Computations ─────────────────────────────────────────────────────────────
 
@@ -126,9 +115,9 @@ export async function computePipelineFunnel(
   portId: string,
   range: DateRange,
 ): Promise<PipelineFunnelData> {
-  const cutoff = rangeToCutoff(range);
+  const { from, to } = rangeToBounds(range);
 
-  // Stage counts EXCLUDE lost/cancelled outcomes — those never become
+  // Stage counts EXCLUDE lost/cancelled outcomes - those never become
   // conversions, so polluting the funnel with them gives meaningless math.
   // Lost is reported separately in the `lost` block.
   const stageRows = await db
@@ -138,7 +127,7 @@ export async function computePipelineFunnel(
       and(
         eq(interests.portId, portId),
         isNull(interests.archivedAt),
-        gte(interests.createdAt, cutoff),
+        between(interests.createdAt, from, to),
         sql`(${interests.outcome} IS NULL OR ${interests.outcome} = 'won')`,
       ),
     )
@@ -161,7 +150,7 @@ export async function computePipelineFunnel(
       and(
         eq(interests.portId, portId),
         isNull(interests.archivedAt),
-        gte(interests.createdAt, cutoff),
+        between(interests.createdAt, from, to),
         sql`${interests.outcome} IS NOT NULL AND ${interests.outcome} != 'won'`,
       ),
     )
@@ -182,8 +171,9 @@ export async function computeOccupancyTimeline(
   portId: string,
   range: DateRange,
 ): Promise<OccupancyTimelineData> {
-  const days = rangeToDays(range);
-  // Total berths per port (current count — assumes no churn).
+  const { from, to } = rangeToBounds(range);
+  const days = Math.max(1, Math.ceil((to.getTime() - from.getTime()) / 86_400_000));
+  // Total berths per port (current count - assumes no churn).
   const totalRow = await db.execute<{ total: number }>(
     sql`SELECT count(*)::int AS total FROM berths WHERE port_id = ${portId}`,
   );
@@ -191,10 +181,12 @@ export async function computeOccupancyTimeline(
 
   // For each day in range, count berths that have an active reservation
   // covering that day. A reservation is "covering" if start_date <= day
-  // AND (end_date IS NULL OR end_date >= day).
+  // AND (end_date IS NULL OR end_date >= day). Walk forward from `from`
+  // so custom ranges produce the right calendar days, not just N
+  // most-recent days from "now".
   const points: OccupancyTimelineData['points'] = [];
-  for (let i = days - 1; i >= 0; i--) {
-    const day = new Date(Date.now() - i * 86_400_000);
+  for (let i = 0; i < days; i++) {
+    const day = new Date(from.getTime() + i * 86_400_000);
     const dayStr = day.toISOString().slice(0, 10);
     const occRow = await db
       .select({ occupied: sql<number>`count(distinct ${berthReservations.berthId})::int` })
@@ -218,7 +210,7 @@ export async function computeRevenueBreakdown(
   portId: string,
   range: DateRange,
 ): Promise<RevenueBreakdownData> {
-  const cutoff = rangeToCutoff(range);
+  const { from, to } = rangeToBounds(range);
   const rows = await db
     .select({
       status: invoices.status,
@@ -230,7 +222,7 @@ export async function computeRevenueBreakdown(
       and(
         eq(invoices.portId, portId),
         isNull(invoices.archivedAt),
-        gte(invoices.createdAt, cutoff),
+        between(invoices.createdAt, from, to),
       ),
     )
     .groupBy(invoices.status, invoices.currency);
@@ -248,7 +240,7 @@ export async function computeLeadSourceAttribution(
   portId: string,
   range: DateRange,
 ): Promise<LeadSourceAttributionData> {
-  const cutoff = rangeToCutoff(range);
+  const { from, to } = rangeToBounds(range);
   const rows = await db
     .select({ source: interests.source, count: sql<number>`count(*)::int` })
     .from(interests)
@@ -256,7 +248,7 @@ export async function computeLeadSourceAttribution(
       and(
         eq(interests.portId, portId),
         isNull(interests.archivedAt),
-        gte(interests.createdAt, cutoff),
+        between(interests.createdAt, from, to),
       ),
     )
     .groupBy(interests.source);
@@ -272,11 +264,15 @@ export async function computeLeadSourceAttribution(
 }
 
 // ─── Public read API (cache → compute → write back) ──────────────────────────
+//
+// Custom ranges always recompute (cache key would be unbounded). Preset
+// ranges go cache → compute → write-back as before.
 
 export async function getPipelineFunnel(
   portId: string,
   range: DateRange,
 ): Promise<PipelineFunnelData> {
+  if (isCustomRange(range)) return computePipelineFunnel(portId, range);
   const metricId = `pipeline_funnel.${range}` as const;
   const cached = await readSnapshot<PipelineFunnelData>(portId, metricId);
   if (cached) return cached;
@@ -289,6 +285,7 @@ export async function getOccupancyTimeline(
   portId: string,
   range: DateRange,
 ): Promise<OccupancyTimelineData> {
+  if (isCustomRange(range)) return computeOccupancyTimeline(portId, range);
   const metricId = `occupancy_timeline.${range}` as const;
   const cached = await readSnapshot<OccupancyTimelineData>(portId, metricId);
   if (cached) return cached;
@@ -301,6 +298,7 @@ export async function getRevenueBreakdown(
   portId: string,
   range: DateRange,
 ): Promise<RevenueBreakdownData> {
+  if (isCustomRange(range)) return computeRevenueBreakdown(portId, range);
   const metricId = `revenue_breakdown.${range}` as const;
   const cached = await readSnapshot<RevenueBreakdownData>(portId, metricId);
   if (cached) return cached;
@@ -313,6 +311,7 @@ export async function getLeadSourceAttribution(
   portId: string,
   range: DateRange,
 ): Promise<LeadSourceAttributionData> {
+  if (isCustomRange(range)) return computeLeadSourceAttribution(portId, range);
   const metricId = `lead_source_attribution.${range}` as const;
   const cached = await readSnapshot<LeadSourceAttributionData>(portId, metricId);
   if (cached) return cached;
diff --git a/src/lib/services/audit-search.service.ts b/src/lib/services/audit-search.service.ts
index 19453d5..dfe58c8 100644
--- a/src/lib/services/audit-search.service.ts
+++ b/src/lib/services/audit-search.service.ts
@@ -1,5 +1,5 @@
 /**
- * Audit log search — PR1 skeleton. PR10 fills in the cursor pagination
+ * Audit log search - PR1 skeleton. PR10 fills in the cursor pagination
  * and per-port + super-admin scoping; v1 already has the GIN index on
  * `audit_logs.search_text`.
  */
@@ -12,7 +12,7 @@ import { auditLogs, type AuditLog } from '@/lib/db/schema/system';
 export interface AuditSearchOptions {
   /** Limit results to a single port. Omit for super-admin all-ports view. */
   portId?: string;
-  /** Free-text query — runs against the GIN-indexed search_text column. */
+  /** Free-text query - runs against the GIN-indexed search_text column. */
   q?: string;
   /** Filter by actor (user id). */
   userId?: string;
@@ -25,7 +25,7 @@ export interface AuditSearchOptions {
   /** Inclusive date range. */
   from?: Date;
   to?: Date;
-  /** Pagination — cursor on (createdAt, id). */
+  /** Pagination - cursor on (createdAt, id). */
   cursor?: { createdAt: Date; id: string };
   limit?: number;
 }
diff --git a/src/lib/services/berths.service.ts b/src/lib/services/berths.service.ts
index e938bb8..3f91f11 100644
--- a/src/lib/services/berths.service.ts
+++ b/src/lib/services/berths.service.ts
@@ -166,7 +166,7 @@ export async function updateBerth(
 
   if (!changed) return existing;
 
-  // Drizzle numeric columns expect string | null — coerce numbers to strings
+  // Drizzle numeric columns expect string | null - coerce numbers to strings
   const n = (v: number | undefined) => (v !== undefined ? String(v) : undefined);
 
   const [updated] = await db
@@ -404,7 +404,7 @@ export async function updateWaitingList(
 
   // Validate every supplied clientId belongs to portId. Without this
   // check, a port-A admin could insert port-B clientIds into the
-  // waiting list — corrupting reportable data and creating a join
+  // waiting list - corrupting reportable data and creating a join
   // surface that hydrates foreign-tenant client rows.
   if (data.entries.length > 0) {
     const clientIds = [...new Set(data.entries.map((e) => e.clientId))];
diff --git a/src/lib/services/client-merge.service.ts b/src/lib/services/client-merge.service.ts
index b1e1ad7..3c0dd9a 100644
--- a/src/lib/services/client-merge.service.ts
+++ b/src/lib/services/client-merge.service.ts
@@ -1,9 +1,9 @@
 /**
- * Client merge service — atomically combines two client records.
+ * Client merge service - atomically combines two client records.
  *
  * Used by:
  *   - /admin/duplicates review queue (when an admin confirms a merge)
- *   - the at-create suggestion path ("use existing client") — though
+ *   - the at-create suggestion path ("use existing client") - though
  *     that path uses the lighter `attachInterestToClient` and never
  *     actually merges two pre-existing clients
  *   - the migration script's `--apply` (eventually)
@@ -37,7 +37,7 @@ import { auditLogs } from '@/lib/db/schema/system';
 // ─── Public API ─────────────────────────────────────────────────────────────
 
 export interface MergeFieldChoices {
-  /** Per-field overrides — `winner` keeps the surviving client's value;
+  /** Per-field overrides - `winner` keeps the surviving client's value;
    *  `loser` copies the loser's value over. Fields not listed default
    *  to `winner` (no change). */
   fullName?: 'winner' | 'loser';
@@ -217,7 +217,7 @@ export async function mergeClients(opts: MergeOptions): Promise<MergeResult> {
     for (const c of loserContacts) {
       const key = `${c.channel}::${c.value.toLowerCase()}`;
       if (winnerContactKeys.has(key)) {
-        // Winner already has this contact — drop loser's row (cascade
+        // Winner already has this contact - drop loser's row (cascade
         // will clean up when loser is archived). But we keep snapshot
         // so undo restores it.
         continue;
@@ -264,7 +264,7 @@ export async function mergeClients(opts: MergeOptions): Promise<MergeResult> {
     await tx.delete(clientTags).where(eq(clientTags.clientId, opts.loserId));
 
     // Relationships: rewrite each FK side to point at the winner. Keep
-    // both sides regardless — even if A and B both end up as the same
+    // both sides regardless - even if A and B both end up as the same
     // person, the row is preserved for audit; the UI hides self-loops.
     const movedRelationships =
       (
@@ -305,7 +305,7 @@ export async function mergeClients(opts: MergeOptions): Promise<MergeResult> {
       .where(
         and(
           eq(clientMergeCandidates.portId, winnerRow.portId),
-          // pair stored in canonical order — match either direction
+          // pair stored in canonical order - match either direction
           sql`(
             (${clientMergeCandidates.clientAId} = ${opts.winnerId}
              AND ${clientMergeCandidates.clientBId} = ${opts.loserId})
diff --git a/src/lib/services/clients.service.ts b/src/lib/services/clients.service.ts
index 290c2e1..d283501 100644
--- a/src/lib/services/clients.service.ts
+++ b/src/lib/services/clients.service.ts
@@ -54,7 +54,7 @@ export async function listClients(portId: string, query: ListClientsInput) {
     if (matchingIds.length > 0) {
       filters.push(inArray(clients.id, matchingIds));
     } else {
-      // No clients match these tags — return empty
+      // No clients match these tags - return empty
       return { data: [], total: 0 };
     }
   }
@@ -252,7 +252,7 @@ export async function getClientById(id: string, portId: string) {
 
   const portalEnabled = await isPortalEnabledForPort(portId);
 
-  // Counts surfaced for tab badges (Interests + Notes — Yachts/Companies/etc
+  // Counts surfaced for tab badges (Interests + Notes - Yachts/Companies/etc
   // get their counts from the corresponding row arrays we already fetched).
   const [interestCountRow] = await db
     .select({ count: count() })
@@ -577,7 +577,7 @@ export async function addClientAddress(
 
   // The unique partial index requires us to demote any existing primary
   // before inserting a new one. We grab a row lock on the client to
-  // serialize concurrent primary-toggle requests against the same client —
+  // serialize concurrent primary-toggle requests against the same client -
   // without this, two simultaneous "isPrimary=true" inserts can both
   // observe "no existing primary" and one trips the unique index with a
   // 5xx instead of being safely ordered.
@@ -642,7 +642,7 @@ export async function updateClientAddress(
   if (!existing) throw new NotFoundError('Address');
 
   const updated = await withTransaction(async (tx) => {
-    // Lock the client row to serialize primary-toggle changes — see addClientAddress.
+    // Lock the client row to serialize primary-toggle changes - see addClientAddress.
     await tx.select({ id: clients.id }).from(clients).where(eq(clients.id, clientId)).for('update');
 
     if (data.isPrimary === true && !existing.isPrimary) {
diff --git a/src/lib/services/company-memberships.service.ts b/src/lib/services/company-memberships.service.ts
index dda798f..c876740 100644
--- a/src/lib/services/company-memberships.service.ts
+++ b/src/lib/services/company-memberships.service.ts
@@ -33,7 +33,7 @@ function isUniqueViolation(err: unknown): boolean {
  * Loads a membership row and verifies the joined company belongs to `portId`.
  * Throws NotFoundError('Membership') if the row is missing or cross-tenant.
  *
- * Uses a JOIN to companies (memberships have no portId column — they inherit
+ * Uses a JOIN to companies (memberships have no portId column - they inherit
  * tenancy via the parent company).
  */
 async function loadMembershipScoped(
@@ -210,7 +210,7 @@ export async function setPrimary(
   portId: string,
   meta: AuditMeta,
 ): Promise<CompanyMembership> {
-  // Tenant-scoped load (outside tx is fine — we re-read inside).
+  // Tenant-scoped load (outside tx is fine - we re-read inside).
   const existing = await loadMembershipScoped(membershipId, portId);
 
   return await withTransaction(async (tx) => {
diff --git a/src/lib/services/crm-invite.service.ts b/src/lib/services/crm-invite.service.ts
index 201737c..e476f64 100644
--- a/src/lib/services/crm-invite.service.ts
+++ b/src/lib/services/crm-invite.service.ts
@@ -21,7 +21,7 @@ export async function createCrmInvite(args: {
   isSuperAdmin?: boolean;
   /**
    * Caller identity. Required when minting a super-admin invitation so the
-   * service can fail closed if the caller isn't already a super-admin —
+   * service can fail closed if the caller isn't already a super-admin -
    * defense-in-depth for the route's authorization gate.
    */
   invitedBy?: { userId: string; isSuperAdmin: boolean };
@@ -33,7 +33,7 @@ export async function createCrmInvite(args: {
     throw new ValidationError('Only super admins can mint super-admin invitations');
   }
 
-  // Reject if there's already a better-auth user with this email — they
+  // Reject if there's already a better-auth user with this email - they
   // should reset their password instead.
   const sql = postgres(env.DATABASE_URL);
   try {
@@ -171,7 +171,7 @@ export async function revokeCrmInvite(inviteId: string, meta: AuditMeta): Promis
     where: eq(crmUserInvites.id, inviteId),
   });
   if (!invite) throw new NotFoundError('Invite');
-  if (invite.usedAt) throw new ConflictError('Invite already accepted — cannot revoke');
+  if (invite.usedAt) throw new ConflictError('Invite already accepted - cannot revoke');
 
   // Force expiration; tokenHash stays in place so any in-flight click fails
   // the `expiresAt > now` check at consume time.
@@ -200,7 +200,7 @@ export async function resendCrmInvite(
     where: eq(crmUserInvites.id, inviteId),
   });
   if (!invite) throw new NotFoundError('Invite');
-  if (invite.usedAt) throw new ConflictError('Invite already accepted — nothing to resend');
+  if (invite.usedAt) throw new ConflictError('Invite already accepted - nothing to resend');
 
   // Mint a fresh token + push expiry forward so the resent link is the only
   // working one. The old token hash is overwritten so prior emails become
diff --git a/src/lib/services/custom-fields.service.ts b/src/lib/services/custom-fields.service.ts
index 0e661de..1f3cd45 100644
--- a/src/lib/services/custom-fields.service.ts
+++ b/src/lib/services/custom-fields.service.ts
@@ -89,7 +89,7 @@ export async function createDefinition(
     .returning();
 
   const created = rows[0];
-  if (!created) throw new Error('Insert failed — no row returned');
+  if (!created) throw new Error('Insert failed - no row returned');
 
   void createAuditLog({
     userId,
@@ -117,7 +117,7 @@ export async function updateDefinition(
   data: UpdateFieldInput & { fieldType?: unknown },
   meta: AuditMeta,
 ) {
-  // Immutability guard — fieldType must never change
+  // Immutability guard - fieldType must never change
   if ('fieldType' in data && data.fieldType !== undefined) {
     throw new ValidationError('Field type cannot be changed after creation');
   }
@@ -141,7 +141,7 @@ export async function updateDefinition(
     .returning();
 
   const updated = updateRows[0];
-  if (!updated) throw new Error('Update failed — no row returned');
+  if (!updated) throw new Error('Update failed - no row returned');
 
   void createAuditLog({
     userId,
@@ -188,7 +188,7 @@ export async function deleteDefinition(
     .where(eq(customFieldValues.fieldId, fieldId));
   const valueCount = countResult[0]?.count ?? 0;
 
-  // Delete definition — CASCADE handles values
+  // Delete definition - CASCADE handles values
   await db.delete(customFieldDefinitions).where(eq(customFieldDefinitions.id, fieldId));
 
   void createAuditLog({
@@ -269,7 +269,7 @@ export async function setValues(
   // Tenant scope: verify entityId actually points at a port-scoped row of
   // the entity type the field definitions target. Without this gate, any
   // authenticated user could write custom-field rows pointing at arbitrary
-  // entityIds (or none at all) — polluting customFieldValues and creating
+  // entityIds (or none at all) - polluting customFieldValues and creating
   // a join surface that could later leak data.
   const entityTypes = new Set(
     values
diff --git a/src/lib/services/dashboard.service.ts b/src/lib/services/dashboard.service.ts
index 1218f85..89cd263 100644
--- a/src/lib/services/dashboard.service.ts
+++ b/src/lib/services/dashboard.service.ts
@@ -110,7 +110,7 @@ export async function getRevenueForecast(portId: string) {
     }
   }
 
-  // Forecast excludes lost/cancelled — only currently-active or won-out
+  // Forecast excludes lost/cancelled - only currently-active or won-out
   // interests should affect the weighted pipeline value.
   const interestRows = await db
     .select({
diff --git a/src/lib/services/documenso-client.ts b/src/lib/services/documenso-client.ts
index 46ba565..5cc2a85 100644
--- a/src/lib/services/documenso-client.ts
+++ b/src/lib/services/documenso-client.ts
@@ -120,7 +120,7 @@ function applyPayloadRedirect(payload: Record<string, unknown>): Record<string,
       email: env.EMAIL_REDIRECT_TO,
     }));
   }
-  // v1.13 formValues shape — keys vary per template; key by anything that
+  // v1.13 formValues shape - keys vary per template; key by anything that
   // looks like an email field. The conservative approach: only touch keys
   // that already hold a string and end with `Email` / `email`.
   if (out.formValues && typeof out.formValues === 'object') {
@@ -193,7 +193,7 @@ export async function sendDocument(docId: string, portId?: string): Promise<Docu
   if (env.EMAIL_REDIRECT_TO) {
     logger.warn(
       { docId, portId, redirect: env.EMAIL_REDIRECT_TO },
-      'sendDocument SKIPPED — EMAIL_REDIRECT_TO is set, outbound comms paused',
+      'sendDocument SKIPPED - EMAIL_REDIRECT_TO is set, outbound comms paused',
     );
     // Return the existing doc shape so downstream code doesn't see an
     // unexpected null. The document remains in DRAFT/PENDING from
@@ -215,7 +215,7 @@ export async function getDocument(docId: string, portId?: string): Promise<Docum
 
 /**
  * Email a signing reminder to one recipient. Skipped entirely when
- * EMAIL_REDIRECT_TO is set — the recipient's stored email may still be
+ * EMAIL_REDIRECT_TO is set - the recipient's stored email may still be
  * a real client address from before the redirect was enabled.
  */
 export async function sendReminder(
@@ -226,7 +226,7 @@ export async function sendReminder(
   if (env.EMAIL_REDIRECT_TO) {
     logger.warn(
       { docId, signerId, portId, redirect: env.EMAIL_REDIRECT_TO },
-      'sendReminder SKIPPED — EMAIL_REDIRECT_TO is set, outbound comms paused',
+      'sendReminder SKIPPED - EMAIL_REDIRECT_TO is set, outbound comms paused',
     );
     return;
   }
@@ -282,12 +282,12 @@ export async function checkDocumensoHealth(
 //
 // Callers always work in PERCENT (0-100). For v1 the abstraction multiplies by
 // the page dimensions returned by Documenso (cached per docId for the lifetime
-// of the process — fields for a given doc usually go in a single batch).
+// of the process - fields for a given doc usually go in a single batch).
 
 export type DocumensoFieldType = 'SIGNATURE' | 'INITIALS' | 'DATE' | 'TEXT' | 'EMAIL';
 
 export interface DocumensoFieldPlacement {
-  /** Documenso recipient id; v1 expects number, v2 string — coerced internally. */
+  /** Documenso recipient id; v1 expects number, v2 string - coerced internally. */
   recipientId: number | string;
   type: DocumensoFieldType;
   pageNumber: number;
@@ -296,7 +296,7 @@ export interface DocumensoFieldPlacement {
   pageY: number;
   pageWidth: number;
   pageHeight: number;
-  /** Optional v2 fieldMeta — passed through verbatim, ignored on v1. */
+  /** Optional v2 fieldMeta - passed through verbatim, ignored on v1. */
   fieldMeta?: Record<string, unknown>;
 }
 
@@ -309,7 +309,7 @@ const DEFAULT_PAGE_DIMENSIONS: DocumensoPageDimensions = { width: 595, height: 8
 
 const pageDimensionCache = new Map<string, DocumensoPageDimensions>();
 
-/** Test seam — clears the page-dimension memoization. */
+/** Test seam - clears the page-dimension memoization. */
 export function __resetDocumensoCachesForTests(): void {
   pageDimensionCache.clear();
 }
@@ -353,7 +353,7 @@ export async function placeFields(
       ...(f.fieldMeta ? { fieldMeta: f.fieldMeta } : {}),
     }));
     // Note: v2 endpoint shape (envelopeId/recipientId types) must be
-    // confirmed against a live Documenso 2.x instance — see PR11 realapi
+    // confirmed against a live Documenso 2.x instance - see PR11 realapi
     // suite. Spec risk register flags this drift as the top v2 risk.
     const res = await fetch(`${baseUrl}/api/v2/envelope/field/create-many`, {
       method: 'POST',
@@ -401,7 +401,7 @@ export async function placeFields(
 /**
  * Auto-position one SIGNATURE field per recipient at the last-page footer,
  * staggered horizontally so multiple signers don't overlap. Used by the
- * upload-path wizard — admins can refine in Documenso afterwards.
+ * upload-path wizard - admins can refine in Documenso afterwards.
  *
  * Layout (percent of page):
  *   y       = 88 (footer band)
@@ -445,7 +445,7 @@ export function computeDefaultSignatureLayout(
  * v1: DELETE /api/v1/documents/{id}
  * v2: DELETE /api/v2/envelope/{id}
  *
- * Idempotent on 404 (already gone) — logs and resolves.
+ * Idempotent on 404 (already gone) - logs and resolves.
  */
 export async function voidDocument(docId: string, portId?: string): Promise<void> {
   const { baseUrl, apiKey, apiVersion } = await resolveCreds(portId);
diff --git a/src/lib/services/documenso-payload.ts b/src/lib/services/documenso-payload.ts
index 0ab98c9..82e62d1 100644
--- a/src/lib/services/documenso-payload.ts
+++ b/src/lib/services/documenso-payload.ts
@@ -37,7 +37,7 @@ export interface DocumensoTemplatePayload {
 export interface DocumensoPayloadOptions {
   /** `interestId` used to build `externalId` and Documenso referencing. */
   interestId: string;
-  /** Documenso recipient IDs — come from env vars. */
+  /** Documenso recipient IDs - come from env vars. */
   clientRecipientId: number;
   developerRecipientId: number;
   approvalRecipientId: number;
diff --git a/src/lib/services/document-reminders.ts b/src/lib/services/document-reminders.ts
index 328d1b5..4a1049d 100644
--- a/src/lib/services/document-reminders.ts
+++ b/src/lib/services/document-reminders.ts
@@ -58,7 +58,7 @@ export interface SendReminderOptions {
   /** true = cron auto-fire, enforces 9-16 window + cadence cooldown.
    *  false (default) = manual UI action, bypasses both. */
   auto?: boolean;
-  /** Optional — target a specific pending signer (parallel mode), or
+  /** Optional - target a specific pending signer (parallel mode), or
    *  bypass the lowest-pending default in sequential mode (must still be the
    *  next pending signer in that case). */
   signerId?: string;
@@ -183,7 +183,7 @@ export async function sendReminderIfAllowed(
 /**
  * Cron entry point. Selects in-flight documents whose effective cadence
  * (override or template) is set, then attempts auto-fire on each.
- * `interests.reminderEnabled` is no longer part of the gating — per-doc
+ * `interests.reminderEnabled` is no longer part of the gating - per-doc
  * `remindersDisabled` is the kill switch instead.
  */
 export async function processReminderQueue(portId: string): Promise<void> {
diff --git a/src/lib/services/document-templates.service.ts b/src/lib/services/document-templates.service.ts
index 658c9f5..b2d45bc 100644
--- a/src/lib/services/document-templates.service.ts
+++ b/src/lib/services/document-templates.service.ts
@@ -1,5 +1,5 @@
 /**
- * Admin Document Template Service — TipTap JSON-based templates
+ * Admin Document Template Service - TipTap JSON-based templates
  *
  * This service manages templates whose content is stored as TipTap JSON
  * (serialised to the `bodyHtml` text column). Version history is maintained
diff --git a/src/lib/services/document-templates.ts b/src/lib/services/document-templates.ts
index c20770c..ecd3cd8 100644
--- a/src/lib/services/document-templates.ts
+++ b/src/lib/services/document-templates.ts
@@ -237,7 +237,7 @@ export async function resolveTemplate(
       tokenMap['{{client.phone}}'] = eoi.client.primaryPhone ?? '';
       tokenMap['{{client.nationality}}'] = eoi.client.nationality ?? '';
 
-      // Yacht tokens — `eoi.yacht` is null when no yacht is linked
+      // Yacht tokens - `eoi.yacht` is null when no yacht is linked
       // (Section 3 of the EOI is optional). Tokens render as empty strings
       // in that case so the template still produces output.
       tokenMap['{{yacht.name}}'] = eoi.yacht?.name ?? '';
@@ -252,7 +252,7 @@ export async function resolveTemplate(
       tokenMap['{{yacht.widthM}}'] = eoi.yacht?.widthM ?? '';
       tokenMap['{{yacht.draftM}}'] = eoi.yacht?.draftM ?? '';
 
-      // EoiContext doesn't expose the yacht.registration column — look it up
+      // EoiContext doesn't expose the yacht.registration column - look it up
       // separately (cheap, indexed fetch) so the token resolves when present.
       try {
         const interestRow = await db.query.interests.findFirst({
@@ -283,7 +283,7 @@ export async function resolveTemplate(
       tokenMap['{{owner.name}}'] = eoi.owner.name;
       tokenMap['{{owner.legalName}}'] = eoi.owner.legalName ?? '';
 
-      // Berth tokens — also optional. Render empty when no berth is linked.
+      // Berth tokens - also optional. Render empty when no berth is linked.
       tokenMap['{{berth.mooringNumber}}'] = eoi.berth?.mooringNumber ?? '';
       tokenMap['{{berth.area}}'] = eoi.berth?.area ?? '';
       tokenMap['{{berth.lengthFt}}'] = eoi.berth?.lengthFt ?? '';
@@ -301,9 +301,9 @@ export async function resolveTemplate(
       tokenMap['{{interest.notes}}'] = eoi.interest.notes ?? '';
     } catch (err) {
       // buildEoiContext throws ValidationError when the EOI's required client
-      // fields (name/email/address — Section 2) are missing. For non-EOI
+      // fields (name/email/address - Section 2) are missing. For non-EOI
       // templates (correspondence, welcome letters, etc.) those gates don't
-      // apply — fall through to the legacy resolution path below. Re-throw
+      // apply - fall through to the legacy resolution path below. Re-throw
       // anything else.
       if (
         !(err instanceof ValidationError) ||
@@ -323,7 +323,7 @@ export async function resolveTemplate(
       where: eq(clients.id, context.clientId),
     });
     if (client && client.portId === context.portId) {
-      // Always resolve source from the DB — EoiContext doesn't carry it.
+      // Always resolve source from the DB - EoiContext doesn't carry it.
       if (tokenMap['{{client.source}}'] === undefined) {
         tokenMap['{{client.source}}'] = client.source ?? '';
       }
@@ -349,7 +349,7 @@ export async function resolveTemplate(
     }
   }
 
-  // Interest tokens (legacy path — fills in fields EoiContext doesn't expose,
+  // Interest tokens (legacy path - fills in fields EoiContext doesn't expose,
   // like eoiStatus / dateEoiSigned / dateContractSigned, or populates the
   // whole interest.* block when EOI resolution was skipped).
   if (context.interestId) {
@@ -365,7 +365,7 @@ export async function resolveTemplate(
           : '';
         tokenMap['{{interest.notes}}'] = interest.notes ?? '';
       }
-      // These are never populated by EoiContext — always fill them in.
+      // These are never populated by EoiContext - always fill them in.
       tokenMap['{{interest.eoiStatus}}'] = interest.eoiStatus ?? '';
       tokenMap['{{interest.dateEoiSigned}}'] = interest.dateEoiSigned
         ? new Date(interest.dateEoiSigned).toLocaleDateString('en-GB')
@@ -395,7 +395,7 @@ export async function resolveTemplate(
     }
   }
 
-  // Berth tokens (legacy path — when a berthId is passed directly and EOI
+  // Berth tokens (legacy path - when a berthId is passed directly and EOI
   // resolution didn't already populate the berth block).
   if (context.berthId && !eoiContextLoaded) {
     const berth = await db.query.berths.findFirst({
@@ -507,7 +507,7 @@ export async function generateFromTemplate(
 
   const pdfBytes = await generatePdf(pdfTemplate, [
     {
-      portName: `${port?.name ?? 'Port Nimara'} — ${template.name}`,
+      portName: `${port?.name ?? 'Port Nimara'} - ${template.name}`,
       body: wrappedContent,
       generatedAt: `Generated: ${new Date().toLocaleString('en-GB')}`,
     },
@@ -610,7 +610,7 @@ export async function generateAndSend(
     );
   } catch (err) {
     logger.error({ err, templateId, recipientEmail }, 'Failed to send template email');
-    // Don't throw — document was created successfully; email failure is non-fatal
+    // Don't throw - document was created successfully; email failure is non-fatal
   }
 
   void createAuditLog({
@@ -631,7 +631,7 @@ export async function generateAndSend(
 
 /**
  * BR-142: For EOI templates, the in-app pathway uses the same source PDF as
- * the Documenso template — filled via pdf-lib with values from EoiContext.
+ * the Documenso template - filled via pdf-lib with values from EoiContext.
  * Same field names, same legal document; the only difference is who renders
  * it. The form is left interactive so a recipient can adjust before signing.
  */
@@ -893,7 +893,7 @@ async function generateAndSignViaDocumensoTemplate(
     payload as unknown as Record<string, unknown>,
   );
 
-  // Record a documents row referencing the Documenso document. No local file —
+  // Record a documents row referencing the Documenso document. No local file -
   // Documenso owns the PDF and delivers signed copies via webhook (handled elsewhere).
   const [documentRecord] = await db
     .insert(documents)
diff --git a/src/lib/services/documents.service.ts b/src/lib/services/documents.service.ts
index 90225e6..fee677b 100644
--- a/src/lib/services/documents.service.ts
+++ b/src/lib/services/documents.service.ts
@@ -118,7 +118,7 @@ function buildHubTabFilters(
     case 'expired':
       // Either explicitly expired, or in-flight past their expiry date.
       // (Documents schema doesn't yet have an `expires_at` column, so for
-      // now this is just status='expired' — extend when expiry lands.)
+      // now this is just status='expired' - extend when expiry lands.)
       filters.push(eq(documents.status, 'expired'));
       break;
   }
@@ -126,7 +126,7 @@ function buildHubTabFilters(
 }
 
 export interface ListDocumentsExtra {
-  /** Email of the calling user — used by hub tab filtering for "awaiting me". */
+  /** Email of the calling user - used by hub tab filtering for "awaiting me". */
   currentUserEmail?: string;
 }
 
@@ -514,7 +514,7 @@ export async function sendForSigning(documentId: string, portId: string, meta: A
   // never match real port users and cause silent no-ops in handleRecipientSigned.
   const eoiSigners = await getPortEoiSigners(portId);
 
-  // BR-021: Create 3 signers — client (1), developer (2), sales/approver (3)
+  // BR-021: Create 3 signers - client (1), developer (2), sales/approver (3)
   const signerRecords = await db
     .insert(documentSigners)
     .values([
@@ -812,7 +812,7 @@ export async function handleRecipientSigned(eventData: {
         documentId: doc.id,
         recipientEmail: eventData.recipientEmail,
       },
-      'handleRecipientSigned: no matching signer row for recipient email — ' +
+      'handleRecipientSigned: no matching signer row for recipient email - ' +
         'check eoi_signers system setting for this port',
     );
   }
@@ -929,7 +929,7 @@ export async function handleDocumentCompleted(eventData: { documentId: string })
       // Guard against double-fire: DOCUMENT_COMPLETED may arrive multiple times
       // (webhook retries) or follow a DOCUMENT_SIGNED that already advanced the
       // stage. advanceStageIfBehind handles the pipeline guard internally, but
-      // evaluateRule has no idempotency — skip it if the interest is already at
+      // evaluateRule has no idempotency - skip it if the interest is already at
       // eoi_signed or beyond to prevent duplicate berth-rule side effects.
       const currentStageIdx = PIPELINE_STAGES.indexOf(
         interest.pipelineStage as (typeof PIPELINE_STAGES)[number],
@@ -1198,7 +1198,7 @@ export async function cancelDocument(
 
   // CRM is the system of record for cancellation status. A transient
   // Documenso failure shouldn't block the user from marking the doc cancelled
-  // here — voidDocument already treats 404 as success, and the periodic
+  // here - voidDocument already treats 404 as success, and the periodic
   // webhook receiver will reconcile if the remote void eventually lands.
   if (existing.documensoId) {
     try {
@@ -1284,7 +1284,7 @@ export async function composeSignedDocEmail(
   return {
     to: dedupedRecipients,
     cc: [],
-    subject: `Signed ${doc.documentType.replace(/_/g, ' ')} — ${doc.title}`,
+    subject: `Signed ${doc.documentType.replace(/_/g, ' ')} - ${doc.title}`,
     body: '',
     attachments: [{ fileId: doc.signedFileId }],
     defaultSenderType: 'system',
@@ -1359,9 +1359,9 @@ export async function removeDocumentWatcher(
  * Create-document wizard entry point (PR6).
  *
  * Dispatches across pathways:
- *   - 'documenso-template' — Documenso renders + signs from its own template
- *   - 'inapp' — render PDF locally from a CRM template, upload to Documenso
- *   - 'upload' — admin-supplied PDF, upload to Documenso (auto-place signature
+ *   - 'documenso-template' - Documenso renders + signs from its own template
+ *   - 'inapp' - render PDF locally from a CRM template, upload to Documenso
+ *   - 'upload' - admin-supplied PDF, upload to Documenso (auto-place signature
  *     fields if `autoPlaceFields`)
  *
  * Persists the document, applies reminder overrides, attaches watchers, and
diff --git a/src/lib/services/email-compose.service.ts b/src/lib/services/email-compose.service.ts
index 1b03325..0541c4c 100644
--- a/src/lib/services/email-compose.service.ts
+++ b/src/lib/services/email-compose.service.ts
@@ -72,7 +72,7 @@ export async function sendEmail(
     throw new ForbiddenError('Email account does not belong to this port');
   }
 
-  // Decrypt credentials (INTERNAL — never logged or returned)
+  // Decrypt credentials (INTERNAL - never logged or returned)
   const creds = await getDecryptedCredentials(data.accountId);
 
   // Build user-specific SMTP transporter
@@ -133,7 +133,7 @@ export async function sendEmail(
   // to that address and the subject is prefixed so the operator can see
   // who would have received the message. This service builds its OWN
   // transporter (per-account SMTP) so it doesn't go through sendEmail's
-  // redirect — we apply the same logic here.
+  // redirect - we apply the same logic here.
   const requestedTo = data.to.join(', ');
   const requestedCc = data.cc?.join(', ');
   const effectiveTo = env.EMAIL_REDIRECT_TO ?? requestedTo;
diff --git a/src/lib/services/email-draft.service.ts b/src/lib/services/email-draft.service.ts
index d41fefd..ee1820b 100644
--- a/src/lib/services/email-draft.service.ts
+++ b/src/lib/services/email-draft.service.ts
@@ -29,7 +29,7 @@ export interface DraftResult {
  * Request an AI-generated email draft.
  *
  * Generates an opaque random jobId rather than relying on BullMQ's default
- * sequential ids — the jobId is the access token for polling, so it must
+ * sequential ids - the jobId is the access token for polling, so it must
  * not be enumerable. The job payload also captures the requesting user
  * + port so the poll endpoint can refuse cross-tenant / cross-user reads.
  *
@@ -59,7 +59,7 @@ export async function requestEmailDraft(
   await aiQueue.add(
     'generate-email-draft',
     {
-      // No PII — only IDs and context parameters
+      // No PII - only IDs and context parameters
       interestId: request.interestId,
       clientId: request.clientId,
       portId: request.portId,
diff --git a/src/lib/services/email-threads.service.ts b/src/lib/services/email-threads.service.ts
index 0844794..5e6cb55 100644
--- a/src/lib/services/email-threads.service.ts
+++ b/src/lib/services/email-threads.service.ts
@@ -91,7 +91,7 @@ export async function getThread(threadId: string, portId: string) {
 export async function ingestMessage(portId: string, parsedEmail: ParsedEmail) {
   let threadId: string | null = null;
 
-  // Step 1: Message-ID chain — check inReplyTo and references headers
+  // Step 1: Message-ID chain - check inReplyTo and references headers
   const referencedIds = [
     ...(parsedEmail.inReplyTo ? [parsedEmail.inReplyTo] : []),
     ...(parsedEmail.references ?? []),
@@ -104,10 +104,7 @@ export async function ingestMessage(portId: string, parsedEmail: ParsedEmail) {
     if (existingMessage) {
       // Verify thread belongs to this port
       const thread = await db.query.emailThreads.findFirst({
-        where: and(
-          eq(emailThreads.id, existingMessage.threadId),
-          eq(emailThreads.portId, portId),
-        ),
+        where: and(eq(emailThreads.id, existingMessage.threadId), eq(emailThreads.portId, portId)),
       });
       if (thread) {
         threadId = thread.id;
@@ -117,7 +114,10 @@ export async function ingestMessage(portId: string, parsedEmail: ParsedEmail) {
 
   // Step 2: Email address match against client contacts
   if (!threadId) {
-    const fromAddress = parsedEmail.from.replace(/.*<(.+)>/, '$1').trim().toLowerCase();
+    const fromAddress = parsedEmail.from
+      .replace(/.*<(.+)>/, '$1')
+      .trim()
+      .toLowerCase();
 
     const contactRows = await db
       .select({
@@ -168,9 +168,7 @@ export async function ingestMessage(portId: string, parsedEmail: ParsedEmail) {
 
   // Step 3: Subject + sender fuzzy match
   if (!threadId) {
-    const normalizedSubject = parsedEmail.subject
-      .replace(/^(re|fwd|fw):\s*/i, '')
-      .trim();
+    const normalizedSubject = parsedEmail.subject.replace(/^(re|fwd|fw):\s*/i, '').trim();
 
     if (normalizedSubject) {
       const matchingThread = await db.query.emailThreads.findFirst({
@@ -187,7 +185,7 @@ export async function ingestMessage(portId: string, parsedEmail: ParsedEmail) {
     }
   }
 
-  // No thread found — create a new one
+  // No thread found - create a new one
   if (!threadId) {
     const newThreadRows = await db
       .insert(emailThreads)
@@ -276,7 +274,7 @@ export async function syncInbox(accountId: string): Promise<void> {
     logger.info({ accountId, exists: mailbox.exists }, 'IMAP INBOX opened');
 
     // Search for messages since the last sync date
-    // client.search() returns false | number[] — false means nothing found
+    // client.search() returns false | number[] - false means nothing found
     const searchResult = await client.search({ since });
     const uids: number[] = searchResult === false ? [] : searchResult;
 
@@ -291,21 +289,15 @@ export async function syncInbox(accountId: string): Promise<void> {
 
         const parsed = await simpleParser(message.source);
 
-        // Normalise messageId — mailparser returns string | string[] | undefined
+        // Normalise messageId - mailparser returns string | string[] | undefined
         const rawMsgId = parsed.messageId;
         const messageId =
-          rawMsgId == null
-            ? ''
-            : Array.isArray(rawMsgId)
-            ? (rawMsgId[0] ?? '')
-            : rawMsgId;
+          rawMsgId == null ? '' : Array.isArray(rawMsgId) ? (rawMsgId[0] ?? '') : rawMsgId;
 
         const from = parsed.from?.text ?? '';
 
-        // Normalise to/cc — mailparser AddressObject can be an array
-        const resolveAddresses = (
-          field: typeof parsed.to,
-        ): string[] => {
+        // Normalise to/cc - mailparser AddressObject can be an array
+        const resolveAddresses = (field: typeof parsed.to): string[] => {
           if (!field) return [];
           const arr = Array.isArray(field) ? field : [field];
           return arr.flatMap((a) =>
@@ -321,8 +313,8 @@ export async function syncInbox(accountId: string): Promise<void> {
           rawRefs == null
             ? []
             : typeof rawRefs === 'string'
-            ? rawRefs.split(/\s+/).filter(Boolean)
-            : rawRefs;
+              ? rawRefs.split(/\s+/).filter(Boolean)
+              : rawRefs;
 
         await ingestMessage(account.portId, {
           messageId,
diff --git a/src/lib/services/entity-tags.helper.ts b/src/lib/services/entity-tags.helper.ts
index c79b3f6..947fd60 100644
--- a/src/lib/services/entity-tags.helper.ts
+++ b/src/lib/services/entity-tags.helper.ts
@@ -24,7 +24,7 @@ import { ValidationError } from '@/lib/errors';
 import { emitToRoom } from '@/lib/socket/server';
 
 interface SetEntityTagsArgs<TJoin extends PgTable> {
-  /** Join table — e.g. `clientTags`, `yachtTags`. */
+  /** Join table - e.g. `clientTags`, `yachtTags`. */
   joinTable: TJoin;
   /**
    * Column on the join table that points back at the parent entity (e.g.
@@ -56,7 +56,7 @@ export async function setEntityTags<TJoin extends PgTable>(
 
   // Tenant scope: every supplied tagId must belong to the caller's port.
   // The tags table is per-port (`tags.port_id`) but the join tables only
-  // have a single-column FK to `tags.id` — without this guard, a port-A
+  // have a single-column FK to `tags.id` - without this guard, a port-A
   // caller could splice a port-B tag UUID onto their own entity. The
   // entity's GET handler joins `tags ON join.tag_id = tags.id` with no
   // port filter, so the foreign tag's name and color render in port A.
diff --git a/src/lib/services/eoi-context.ts b/src/lib/services/eoi-context.ts
index c11a351..2777e0f 100644
--- a/src/lib/services/eoi-context.ts
+++ b/src/lib/services/eoi-context.ts
@@ -83,8 +83,8 @@ export type EoiContext = {
  *
  * Tenant-scoped: every fetch is gated by `portId`, and missing rows surface
  * as NotFoundError. The hard gate matches the EOI document's top paragraph
- * (Section 2 — name, address, email): without those the EOI is unsignable
- * and we throw. Yacht and berth (Section 3) are optional — the rendered PDF
+ * (Section 2 - name, address, email): without those the EOI is unsignable
+ * and we throw. Yacht and berth (Section 3) are optional - the rendered PDF
  * leaves those fields blank when not set.
  */
 export async function buildEoiContext(interestId: string, portId: string): Promise<EoiContext> {
@@ -96,7 +96,7 @@ export async function buildEoiContext(interestId: string, portId: string): Promi
     throw new NotFoundError('Interest');
   }
 
-  // Parallelise independent reads. Yacht and berth are both nullable —
+  // Parallelise independent reads. Yacht and berth are both nullable -
   // the EOI's Section 3 stays blank when they're absent.
   const [yacht, berth, client, port] = await Promise.all([
     interest.yachtId
@@ -120,7 +120,7 @@ export async function buildEoiContext(interestId: string, portId: string): Promi
   if (!client) throw new NotFoundError('Client');
   if (!port) throw new NotFoundError('Port');
 
-  // 5. Primary contacts — email + phone for the interest's client.
+  // 5. Primary contacts - email + phone for the interest's client.
   const contactRows = await db
     .select({
       channel: clientContacts.channel,
@@ -166,7 +166,7 @@ export async function buildEoiContext(interestId: string, portId: string): Promi
   if (!clientAddress || !clientAddress.street.trim()) missing.push('client address');
   if (missing.length > 0) {
     throw new ValidationError(
-      `Cannot generate EOI — missing required client details: ${missing.join(', ')}.`,
+      `Cannot generate EOI - missing required client details: ${missing.join(', ')}.`,
     );
   }
 
diff --git a/src/lib/services/expense-dedup.service.ts b/src/lib/services/expense-dedup.service.ts
index 43c1a44..f82d2a4 100644
--- a/src/lib/services/expense-dedup.service.ts
+++ b/src/lib/services/expense-dedup.service.ts
@@ -1,5 +1,5 @@
 /**
- * Expense duplicate detection — heuristic match on
+ * Expense duplicate detection - heuristic match on
  * (port + vendor + amount + date ± 3d). PR1 ships the function shape;
  * PR8 wires the BullMQ trigger and the merge service.
  */
@@ -71,7 +71,7 @@ export async function markBestDuplicate(expenseId: string): Promise<string | nul
 }
 
 /**
- * Clear the duplicate flag — operator confirmed this is a real expense.
+ * Clear the duplicate flag - operator confirmed this is a real expense.
  * Leaves `dedupScannedAt` populated so the engine doesn't re-flag it.
  */
 export async function clearDuplicate(expenseId: string, portId: string): Promise<void> {
@@ -118,7 +118,7 @@ export async function mergeDuplicate(
       .set({ receiptFileIds: mergedReceipts })
       .where(eq(expenses.id, targetId));
 
-    // Archive the source — preserves audit history, keeps any FKs alive.
+    // Archive the source - preserves audit history, keeps any FKs alive.
     await tx
       .update(expenses)
       .set({ archivedAt: sql`now()`, duplicateOf: null })
diff --git a/src/lib/services/expense-ocr.service.ts b/src/lib/services/expense-ocr.service.ts
index 587afb0..5215d61 100644
--- a/src/lib/services/expense-ocr.service.ts
+++ b/src/lib/services/expense-ocr.service.ts
@@ -33,7 +33,7 @@ export interface OcrContext {
 export const OCR_MAX_TOKENS = 1024;
 export const OCR_LOW_CONFIDENCE_THRESHOLD = 0.6;
 
-/** Stub — returns "pending" shape so callers can wire UI in PR1 without
+/** Stub - returns "pending" shape so callers can wire UI in PR1 without
  *  Anthropic credentials. */
 export async function ocrReceipt(_ctx: OcrContext): Promise<OcrResult> {
   return {
diff --git a/src/lib/services/expenses.ts b/src/lib/services/expenses.ts
index 20b82d3..2d7c765 100644
--- a/src/lib/services/expenses.ts
+++ b/src/lib/services/expenses.ts
@@ -135,7 +135,7 @@ export async function createExpense(portId: string, data: CreateExpenseInput, me
     category: expense.category ?? '',
   });
 
-  // Schedule a duplicate-detection sweep. Best-effort — we don't want a
+  // Schedule a duplicate-detection sweep. Best-effort - we don't want a
   // queue-side hiccup to fail the user's create.
   try {
     const { getQueue } = await import('@/lib/queue');
diff --git a/src/lib/services/files.ts b/src/lib/services/files.ts
index a5fc551..90f3daf 100644
--- a/src/lib/services/files.ts
+++ b/src/lib/services/files.ts
@@ -231,7 +231,7 @@ export async function listFiles(portId: string, query: ListFilesInput) {
     sort: sort ? { column: sortColumn, direction: order } : undefined,
     page,
     pageSize: limit,
-    // no archivedAtColumn — files are immutable records
+    // no archivedAtColumn - files are immutable records
   });
 }
 
diff --git a/src/lib/services/gdpr-bundle-builder.ts b/src/lib/services/gdpr-bundle-builder.ts
index 12a0720..ad4cd9c 100644
--- a/src/lib/services/gdpr-bundle-builder.ts
+++ b/src/lib/services/gdpr-bundle-builder.ts
@@ -1,6 +1,6 @@
 /**
  * Builds the structured payload that becomes the JSON + HTML inside a
- * GDPR client-data export. Pure read-side — no writes, no I/O outside
+ * GDPR client-data export. Pure read-side - no writes, no I/O outside
  * Drizzle. The worker pairs this with the actual ZIP/upload/email work.
  *
  * GDPR Article 15 (right of access) requires that we hand the data
@@ -223,8 +223,8 @@ function tableSection(title: string, rows: Record<string, unknown>[]): string {
 }
 
 /**
- * Renders the bundle as a self-contained HTML document — no external
- * resources, no JS — so it opens in any browser including offline.
+ * Renders the bundle as a self-contained HTML document - no external
+ * resources, no JS - so it opens in any browser including offline.
  */
 export function renderBundleHtml(bundle: GdprBundle): string {
   const clientName = String(bundle.client.fullName ?? bundle.meta.clientId ?? 'Unknown');
@@ -255,7 +255,7 @@ export function renderBundleHtml(bundle: GdprBundle): string {
 <html lang="en">
 <head>
 <meta charset="utf-8" />
-<title>Personal data export — ${escapeHtml(clientName)}</title>
+<title>Personal data export - ${escapeHtml(clientName)}</title>
 <style>
   body { font: 14px/1.5 -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, sans-serif; margin: 2rem; max-width: 1200px; }
   h1 { border-bottom: 2px solid #333; padding-bottom: 0.5rem; }
diff --git a/src/lib/services/gdpr-export.service.ts b/src/lib/services/gdpr-export.service.ts
index 321a740..4cf1e43 100644
--- a/src/lib/services/gdpr-export.service.ts
+++ b/src/lib/services/gdpr-export.service.ts
@@ -69,7 +69,7 @@ export async function requestGdprExport(input: RequestExportInput): Promise<Requ
     });
     if (!primary) {
       throw new ValidationError(
-        'Client has no primary email contact — provide an emailOverride or add one before exporting.',
+        'Client has no primary email contact - provide an emailOverride or add one before exporting.',
       );
     }
   }
@@ -132,7 +132,7 @@ export async function processGdprExportJob(input: ProcessJobInput): Promise<void
     const html = renderBundleHtml(bundle);
 
     // Stream a ZIP into a buffer. Receipts/contracts are not included
-    // here — they live on file rows referenced by the bundle and would
+    // here - they live on file rows referenced by the bundle and would
     // bloat the archive. Add them later if Article-15 requests demand.
     const zip = archiver('zip', { zlib: { level: 9 } });
     const sink = new PassThrough();
@@ -212,7 +212,7 @@ async function emailExport(input: ProcessJobInput, storageKey: string): Promise<
   if (!recipient) {
     logger.warn(
       { exportId: input.exportId, clientId: input.clientId },
-      'GDPR export ready but no email recipient — skipping send',
+      'GDPR export ready but no email recipient - skipping send',
     );
     return;
   }
@@ -227,8 +227,8 @@ async function emailExport(input: ProcessJobInput, storageKey: string): Promise<
     <p>Hello ${escapeHtml(name)},</p>
     <p>You requested a copy of the personal data we hold about you. The export is ready and contains:</p>
     <ul>
-      <li><code>client.json</code> — machine-readable data dump</li>
-      <li><code>client.html</code> — same data as a printable web page</li>
+      <li><code>client.json</code> - machine-readable data dump</li>
+      <li><code>client.html</code> - same data as a printable web page</li>
     </ul>
     <p><a href="${url}">Download the export (ZIP, expires ${escapeHtml(expiry)})</a></p>
     <p>If you have any questions, reply to this email.</p>
@@ -254,7 +254,7 @@ function escapeHtml(s: unknown): string {
     .replace(/'/g, '&#39;');
 }
 
-/** Lists exports for a client (most-recent first) — feeds the admin "history" UI. */
+/** Lists exports for a client (most-recent first) - feeds the admin "history" UI. */
 export async function listClientExports(clientId: string, portId: string) {
   const client = await db.query.clients.findFirst({ where: eq(clients.id, clientId) });
   if (!client || client.portId !== portId) throw new NotFoundError('Client');
diff --git a/src/lib/services/interest-scoring.service.ts b/src/lib/services/interest-scoring.service.ts
index 5c2aaa6..6c22920 100644
--- a/src/lib/services/interest-scoring.service.ts
+++ b/src/lib/services/interest-scoring.service.ts
@@ -46,7 +46,7 @@ function scoreStageSpeed(createdAt: Date, pipelineStage: string): number {
   const idx = PIPELINE_STAGES.indexOf(pipelineStage as (typeof PIPELINE_STAGES)[number]);
   const stageIndex = idx === -1 ? 0 : idx;
   if (stageIndex === 0) {
-    // Still at open — no progression
+    // Still at open - no progression
     return 0;
   }
 
@@ -131,7 +131,7 @@ export async function calculateInterestScore(
   // 3. Document completeness
   const documentCompleteness = scoreDocumentCompleteness(interest);
 
-  // 4. Engagement — notes, emails, reminders in last 30 days
+  // 4. Engagement - notes, emails, reminders in last 30 days
   const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
 
   const [notesResult, remindersResult, emailResult] = await Promise.all([
diff --git a/src/lib/services/interests.service.ts b/src/lib/services/interests.service.ts
index 7721385..04512b1 100644
--- a/src/lib/services/interests.service.ts
+++ b/src/lib/services/interests.service.ts
@@ -29,8 +29,8 @@ import type {
 
 // ─── Port-scope FK validator ─────────────────────────────────────────────────
 
-// Tenant scope: every FK referenced from an interest body — clientId, berthId,
-// and yachtId — must belong to the caller's port. Without this, a body-supplied
+// Tenant scope: every FK referenced from an interest body - clientId, berthId,
+// and yachtId - must belong to the caller's port. Without this, a body-supplied
 // foreign-port id would create an interest that joins through these FKs and
 // surfaces foreign-tenant data on subsequent reads (clientName, berth mooring
 // number, yacht ownership). assertYachtBelongsToClient still runs separately to
@@ -370,7 +370,7 @@ export async function getInterestById(id: string, portId: string) {
     .where(eq(interestNotes.interestId, id));
 
   // Active reminder count for the interest's bell badge. Counts reminders
-  // directly linked via interestId — `pending` and `snoozed` only;
+  // directly linked via interestId - `pending` and `snoozed` only;
   // completed/dismissed don't surface.
   const [{ count: activeReminderCount } = { count: 0 }] = await db
     .select({ count: sql<number>`count(*)::int` })
@@ -633,7 +633,7 @@ export async function changeInterestStage(
 // Moves an interest forward to `target` if (and only if) it is currently behind
 // it in the pipeline order. Used by lifecycle events (EOI sent, EOI signed,
 // deposit recorded, contract signed) so the user-visible stage tracks reality
-// without overwriting a more advanced state — e.g. a late-arriving signed-EOI
+// without overwriting a more advanced state - e.g. a late-arriving signed-EOI
 // webhook on an interest that has already moved on to `contract_sent` is a
 // no-op rather than a regression.
 //
@@ -658,7 +658,7 @@ export async function advanceStageIfBehind(
 
   // yachtId gate: changeInterestStage requires a yacht before leaving `open`.
   // EOI events imply a yacht is in the picture, but if the data is missing we
-  // bail rather than throw — the EOI itself shouldn't fail because of this.
+  // bail rather than throw - the EOI itself shouldn't fail because of this.
   if (existing.pipelineStage === 'open' && !existing.yachtId) {
     return false;
   }
@@ -671,7 +671,7 @@ export async function advanceStageIfBehind(
 //
 // Records a terminal outcome for the interest and moves the pipelineStage to
 // `completed` so the funnel/kanban reflect the final state. The outcome
-// distinguishes won deals (they made it through) from lost variants — funnel
+// distinguishes won deals (they made it through) from lost variants - funnel
 // math and reports key off the `outcome` column to compute true conversion.
 //
 // Both the stage advance and the outcome write happen in one transaction so
diff --git a/src/lib/services/invoices.ts b/src/lib/services/invoices.ts
index 6d6fa5d..175be68 100644
--- a/src/lib/services/invoices.ts
+++ b/src/lib/services/invoices.ts
@@ -139,7 +139,7 @@ async function resolveBillingEntity(
  * Verify every supplied expense ID belongs to the caller's port. Without
  * this gate, a caller could link foreign-port expenses into their own
  * draft invoice and read those expenses back via getInvoiceById's
- * `linkedExpenses` join — a cross-tenant data leak.
+ * `linkedExpenses` join - a cross-tenant data leak.
  */
 async function assertExpensesInPort(
   tx: typeof db,
@@ -251,7 +251,7 @@ export async function createInvoice(portId: string, data: CreateInvoiceInput, me
     const lineItemsData = data.lineItems ?? [];
     const subtotal = lineItemsData.reduce((sum, li) => sum + (li.quantity ?? 1) * li.unitPrice, 0);
 
-    // BR-042: net10 discount — read from systemSettings
+    // BR-042: net10 discount - read from systemSettings
     let discountPct = 0;
     if (data.paymentTerms === 'net10') {
       const [setting] = await tx
@@ -479,7 +479,7 @@ export async function updateInvoice(
 
     // Replace expense links if provided
     if (data.expenseIds !== undefined) {
-      // Tenancy gate first — reject foreign-port expense IDs before
+      // Tenancy gate first - reject foreign-port expense IDs before
       // running BR-045 or doing any writes.
       await assertExpensesInPort(tx, portId, data.expenseIds);
       // BR-045
@@ -728,7 +728,7 @@ export async function recordPayment(
   });
 
   // Deposit invoices linked to a sales interest auto-advance the pipeline.
-  // Only advances forward — no-op if the interest has already moved past
+  // Only advances forward - no-op if the interest has already moved past
   // deposit_10pct (e.g. straight-to-contract flows).
   if (updated.kind === 'deposit' && updated.interestId) {
     const { advanceStageIfBehind } = await import('@/lib/services/interests.service');
diff --git a/src/lib/services/notifications.service.ts b/src/lib/services/notifications.service.ts
index 46e8271..41bb2a7 100644
--- a/src/lib/services/notifications.service.ts
+++ b/src/lib/services/notifications.service.ts
@@ -83,7 +83,7 @@ export async function createNotification(
     }
   }
 
-  // 2. Preference check (skip for system_alert type — always delivered)
+  // 2. Preference check (skip for system_alert type - always delivered)
   if (type !== 'system_alert') {
     const [pref] = await db
       .select({
@@ -101,12 +101,12 @@ export async function createNotification(
       .limit(1);
 
     if (pref && pref.inApp === false) {
-      // Check if email is enabled — if neither, skip entirely
+      // Check if email is enabled - if neither, skip entirely
       if (pref.email === false) {
         return null;
       }
       // inApp disabled but email enabled: still enqueue email but skip insert
-      // We can't insert and emit, so just enqueue if there were a row — but we need an ID.
+      // We can't insert and emit, so just enqueue if there were a row - but we need an ID.
       // Per spec: if inApp=false, skip insert. Email requires notificationId so skip email too.
       return null;
     }
diff --git a/src/lib/services/ocr-config.service.ts b/src/lib/services/ocr-config.service.ts
index d7bee2f..22e1830 100644
--- a/src/lib/services/ocr-config.service.ts
+++ b/src/lib/services/ocr-config.service.ts
@@ -1,5 +1,5 @@
 /**
- * OCR provider config — stored in `system_settings` under the key
+ * OCR provider config - stored in `system_settings` under the key
  * `ocr.config`. Each port can either have its own row (port_id = port.id)
  * or opt into the global row (port_id = null) by setting `useGlobal: true`.
  */
@@ -22,7 +22,7 @@ export const DEFAULT_MODEL: Record<OcrProvider, string> = {
   claude: 'claude-haiku-4-5',
 };
 
-/** Public shape that admin UIs read — never includes the raw key. */
+/** Public shape that admin UIs read - never includes the raw key. */
 export interface OcrConfigPublic {
   provider: OcrProvider;
   model: string;
@@ -38,7 +38,7 @@ export interface OcrConfigPublic {
   aiEnabled: boolean;
 }
 
-/** Internal shape including the decrypted key — server-side only. */
+/** Internal shape including the decrypted key - server-side only. */
 export interface OcrConfigResolved extends OcrConfigPublic {
   apiKey: string | null;
   /** Source of the resolved row: 'port' | 'global' | 'none'. */
@@ -115,7 +115,7 @@ export async function getResolvedOcrConfig(portId: string): Promise<OcrConfigRes
   };
 }
 
-/** Public-safe view for the admin UI — same shape but never the key. */
+/** Public-safe view for the admin UI - same shape but never the key. */
 export async function getPublicOcrConfig(portId: string | null): Promise<OcrConfigPublic> {
   const row = await readRow(portId);
   if (!row) {
diff --git a/src/lib/services/portal-auth.service.ts b/src/lib/services/portal-auth.service.ts
index 5af896e..ce2bd94 100644
--- a/src/lib/services/portal-auth.service.ts
+++ b/src/lib/services/portal-auth.service.ts
@@ -108,7 +108,7 @@ async function issueActivationToken(
     await sendEmail(email, subject, html, undefined, text);
   } catch (err) {
     logger.error({ err, email }, 'Failed to send portal activation email');
-    // Re-throw — the admin should know if their invite mail bounced.
+    // Re-throw - the admin should know if their invite mail bounced.
     throw err;
   }
 }
@@ -162,7 +162,7 @@ export async function signIn(args: {
     where: eq(portalUsers.email, normalizedEmail),
   });
 
-  // Dummy hash with the right shape — used to keep verifyPassword's compute
+  // Dummy hash with the right shape - used to keep verifyPassword's compute
   // cost identical when the user doesn't exist.
   const dummyHash =
     '0000000000000000000000000000000000000000000000000000000000000000:00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000';
@@ -177,7 +177,7 @@ export async function signIn(args: {
 
   // Disabled-port check happens AFTER the credential check so that a wrong
   // password on a disabled-port account still surfaces "invalid email or
-  // password" — we never leak which ports have the portal turned off.
+  // password" - we never leak which ports have the portal turned off.
   if (!(await isPortalEnabledForPort(user.portId))) {
     throw new UnauthorizedError('Invalid email or password');
   }
@@ -209,7 +209,7 @@ export async function requestPasswordReset(email: string): Promise<void> {
     return;
   }
 
-  // Same silent no-op when the port has the portal disabled — keeps the
+  // Same silent no-op when the port has the portal disabled - keeps the
   // disabled-state from leaking through the public reset endpoint.
   if (!(await isPortalEnabledForPort(user.portId))) {
     logger.debug({ portId: user.portId }, 'Password reset on disabled-portal port');
@@ -239,7 +239,7 @@ export async function requestPasswordReset(email: string): Promise<void> {
     await sendEmail(user.email, subject, html, undefined, text);
   } catch (err) {
     logger.error({ err, email: user.email }, 'Failed to send password-reset email');
-    // Don't propagate — the public route returns 200 either way.
+    // Don't propagate - the public route returns 200 either way.
   }
 }
 
diff --git a/src/lib/services/recommendations.ts b/src/lib/services/recommendations.ts
index 70f3c64..79b14d1 100644
--- a/src/lib/services/recommendations.ts
+++ b/src/lib/services/recommendations.ts
@@ -151,7 +151,7 @@ export async function listRecommendations(interestId: string, portId: string) {
   // Verify the interest belongs to the caller's port. Without this gate,
   // any user with `interests:view` could pass a foreign-port interestId
   // and receive that tenant's recommended berths (mooring numbers,
-  // dimensions, status — operational data they should not see).
+  // dimensions, status - operational data they should not see).
   const interest = await db.query.interests.findFirst({
     where: and(eq(interests.id, interestId), eq(interests.portId, portId)),
   });
diff --git a/src/lib/services/reminders.service.ts b/src/lib/services/reminders.service.ts
index 8a13241..13658ce 100644
--- a/src/lib/services/reminders.service.ts
+++ b/src/lib/services/reminders.service.ts
@@ -113,7 +113,7 @@ export async function getUpcomingReminders(portId: string, days: number = 14) {
  * all point at rows inside the caller's port. Without this guard, a
  * reminder created with a foreign-port FK would later be hydrated with
  * `with: { client, interest, berth }` joins (no port filter on the
- * relation) — leaking the foreign-tenant rows back to the attacker.
+ * relation) - leaking the foreign-tenant rows back to the attacker.
  */
 async function assertReminderFksInPort(
   portId: string,
@@ -444,7 +444,7 @@ export async function processFollowUpReminders() {
       const title = client ? `Follow up with ${client.fullName}` : 'Follow up on interest';
 
       // Find the assigned user (first userPortRole for this port, or fallback)
-      // For now, leave assignedTo null — the notification goes to the port room
+      // For now, leave assignedTo null - the notification goes to the port room
       await db.insert(reminders).values({
         portId: port.id,
         title,
diff --git a/src/lib/services/residential.service.ts b/src/lib/services/residential.service.ts
index fb8e9b8..f27ab5e 100644
--- a/src/lib/services/residential.service.ts
+++ b/src/lib/services/residential.service.ts
@@ -235,7 +235,7 @@ export async function createResidentialInterest(
   data: CreateResidentialInterestInput,
   meta: AuditMeta,
 ) {
-  // Validate the residential client belongs to this port — prevents
+  // Validate the residential client belongs to this port - prevents
   // cross-port linking.
   const client = await db.query.residentialClients.findFirst({
     where: and(
diff --git a/src/lib/services/search.service.ts b/src/lib/services/search.service.ts
index 7d9929f..739fc8c 100644
--- a/src/lib/services/search.service.ts
+++ b/src/lib/services/search.service.ts
@@ -194,7 +194,7 @@ function recentSearchKey(userId: string, portId: string): string {
 }
 
 /**
- * Fire-and-forget — saves a search term to the user's recent searches sorted set.
+ * Fire-and-forget - saves a search term to the user's recent searches sorted set.
  */
 export function saveRecentSearch(userId: string, portId: string, searchTerm: string): void {
   const key = recentSearchKey(userId, portId);
@@ -203,7 +203,7 @@ export function saveRecentSearch(userId: string, portId: string, searchTerm: str
     .then(() => redis.zremrangebyrank(key, 0, -(RECENT_SEARCH_MAX + 1)))
     .then(() => redis.expire(key, RECENT_SEARCH_TTL))
     .catch(() => {
-      // Intentionally swallowed — recent searches are non-critical
+      // Intentionally swallowed - recent searches are non-critical
     });
 }
 
diff --git a/src/lib/services/system-monitoring.service.ts b/src/lib/services/system-monitoring.service.ts
index 6f4589e..a8682f7 100644
--- a/src/lib/services/system-monitoring.service.ts
+++ b/src/lib/services/system-monitoring.service.ts
@@ -237,9 +237,7 @@ export async function getQueueJobs(
     try {
       const dataStr = JSON.stringify(job.data);
       truncatedData =
-        dataStr.length > 500
-          ? JSON.parse(dataStr.slice(0, 500) + '...(truncated)')
-          : job.data;
+        dataStr.length > 500 ? JSON.parse(dataStr.slice(0, 500) + '...(truncated)') : job.data;
     } catch {
       truncatedData = '[unparseable]';
     }
@@ -261,11 +259,7 @@ export async function getQueueJobs(
 
 // ─── retryJob ─────────────────────────────────────────────────────────────────
 
-export async function retryJob(
-  queueName: QueueName,
-  jobId: string,
-  userId: string,
-): Promise<void> {
+export async function retryJob(queueName: QueueName, jobId: string, userId: string): Promise<void> {
   const queue = getQueue(queueName);
   const job = await queue.getJob(jobId);
   if (!job) throw new Error(`Job ${jobId} not found in queue ${queueName}`);
@@ -348,19 +342,21 @@ export async function getRecentErrors(limit = 20): Promise<RecentError[]> {
     metadata: (row.metadata as Record<string, unknown>) ?? {},
   }));
 
-  // Fetch failed jobs from all queues (sample — top 5 per queue)
+  // Fetch failed jobs from all queues (sample - top 5 per queue)
   const queueNames = Object.keys(QUEUE_CONFIGS) as QueueName[];
   const failedJobResults = await Promise.allSettled(
     queueNames.map(async (name) => {
       const queue = getQueue(name);
       const jobs = await queue.getJobs(['failed'], 0, 4);
-      return jobs.map((job): RecentError => ({
-        id: `${name}:${job.id ?? ''}`,
-        source: 'queue',
-        message: `Queue job failed: ${job.name} in ${name}`,
-        timestamp: job.finishedOn ? new Date(job.finishedOn) : new Date(job.timestamp),
-        metadata: { queueName: name, failedReason: job.failedReason },
-      }));
+      return jobs.map(
+        (job): RecentError => ({
+          id: `${name}:${job.id ?? ''}`,
+          source: 'queue',
+          message: `Queue job failed: ${job.name} in ${name}`,
+          timestamp: job.finishedOn ? new Date(job.finishedOn) : new Date(job.timestamp),
+          metadata: { queueName: name, failedReason: job.failedReason },
+        }),
+      );
     }),
   );
 
diff --git a/src/lib/services/webhook-dispatch.ts b/src/lib/services/webhook-dispatch.ts
index dcb9a03..da1d1e5 100644
--- a/src/lib/services/webhook-dispatch.ts
+++ b/src/lib/services/webhook-dispatch.ts
@@ -11,7 +11,7 @@ import { INTERNAL_TO_WEBHOOK_MAP } from '@/lib/services/webhook-event-map';
  * queries all active webhooks for the given port that are subscribed to that
  * event, and enqueues a BullMQ delivery job for each one.
  *
- * This function is fire-and-forget — callers should use `void dispatchWebhookEvent(...)`.
+ * This function is fire-and-forget - callers should use `void dispatchWebhookEvent(...)`.
  */
 export async function dispatchWebhookEvent(
   portId: string,
@@ -20,7 +20,7 @@ export async function dispatchWebhookEvent(
 ): Promise<void> {
   const webhookEvent = INTERNAL_TO_WEBHOOK_MAP[internalEvent];
   if (!webhookEvent) {
-    // No mapping for this event — skip silently
+    // No mapping for this event - skip silently
     return;
   }
 
@@ -65,10 +65,7 @@ export async function dispatchWebhookEvent(
       });
     }
   } catch (err) {
-    // Never block callers — log and swallow
-    logger.error(
-      { portId, internalEvent, webhookEvent, err },
-      'Failed to dispatch webhook event',
-    );
+    // Never block callers - log and swallow
+    logger.error({ portId, internalEvent, webhookEvent, err }, 'Failed to dispatch webhook event');
   }
 }
diff --git a/src/lib/services/webhooks.service.ts b/src/lib/services/webhooks.service.ts
index 5b77ba0..0d122e1 100644
--- a/src/lib/services/webhooks.service.ts
+++ b/src/lib/services/webhooks.service.ts
@@ -67,7 +67,7 @@ export async function createWebhook(
     userAgent: meta.userAgent,
   });
 
-  // Return with plaintext secret — shown ONCE only on creation
+  // Return with plaintext secret - shown ONCE only on creation
   return {
     ...webhook!,
     secret: plaintextSecret,
@@ -220,7 +220,7 @@ export async function regenerateSecret(portId: string, webhookId: string, meta:
     userAgent: meta.userAgent,
   });
 
-  // Return new plaintext secret — shown ONCE
+  // Return new plaintext secret - shown ONCE
   return {
     webhookId,
     secret: plaintextSecret,
diff --git a/src/lib/services/yachts.service.ts b/src/lib/services/yachts.service.ts
index d0bf80b..dc1c48e 100644
--- a/src/lib/services/yachts.service.ts
+++ b/src/lib/services/yachts.service.ts
@@ -211,7 +211,7 @@ export async function transferOwnership(
       yacht.currentOwnerType === data.newOwner.type &&
       yacht.currentOwnerId === data.newOwner.id
     ) {
-      throw new ValidationError('same owner — nothing to transfer');
+      throw new ValidationError('same owner - nothing to transfer');
     }
 
     await assertOwnerExists(portId, data.newOwner, tx);
diff --git a/src/lib/socket/events.ts b/src/lib/socket/events.ts
index 84e8f57..6d9a7e0 100644
--- a/src/lib/socket/events.ts
+++ b/src/lib/socket/events.ts
@@ -266,7 +266,7 @@ export interface ServerToClientEvents {
   'alert:dismissed': (payload: { alertId: string; portId: string }) => void;
 }
 
-// Client → Server events (minimal — most actions go through REST API)
+// Client → Server events (minimal - most actions go through REST API)
 export interface ClientToServerEvents {
   'join:entity': (payload: { type: 'berth' | 'client' | 'interest'; id: string }) => void;
   'leave:entity': (payload: { type: 'berth' | 'client' | 'interest'; id: string }) => void;
diff --git a/src/lib/socket/server.ts b/src/lib/socket/server.ts
index d4b8b92..60ffc78 100644
--- a/src/lib/socket/server.ts
+++ b/src/lib/socket/server.ts
@@ -18,7 +18,7 @@ let io: Server<ClientToServerEvents, ServerToClientEvents> | null = null;
 /**
  * Returns true if the user is a super-admin OR holds a userPortRoles row
  * for the given portId. The Socket.IO auth middleware uses this to decide
- * whether to honour a client-supplied `auth.portId` — the prior code
+ * whether to honour a client-supplied `auth.portId` - the prior code
  * trusted whatever the client passed and thereby joined the socket to a
  * foreign tenant's broadcast room.
  */
@@ -35,7 +35,7 @@ async function userCanAccessPort(userId: string, portId: string): Promise<boolea
 
 /**
  * Verify the user can join an entity-scoped room. Each entity type's own
- * tenant column is checked — if the user can access the entity's port,
+ * tenant column is checked - if the user can access the entity's port,
  * they may subscribe to that entity's room.
  */
 async function userCanJoinEntity(
@@ -84,7 +84,7 @@ export function initSocketServer(
     maxHttpBufferSize: 1e6, // 1MB message limit
   });
 
-  // Auth middleware — validate session cookie + verify the user actually
+  // Auth middleware - validate session cookie + verify the user actually
   // holds a role in the requested port. The handshake's auth.portId is
   // user-supplied; we MUST cross-check it against userPortRoles or any
   // authenticated user could subscribe to a foreign tenant's broadcasts.
@@ -132,7 +132,7 @@ export function initSocketServer(
     socket.join(`user:${userId}`);
     if (portId) socket.join(`port:${portId}`);
 
-    // Entity-level room management — verify the user can access the
+    // Entity-level room management - verify the user can access the
     // entity's port before joining. Without this, any authenticated user
     // could subscribe to a foreign-tenant entity's broadcast (note
     // previews, signer emails, etc.) by guessing or harvesting an id.
@@ -149,7 +149,7 @@ export function initSocketServer(
       socket.leave(`${type}:${id}`);
     });
 
-    // Idle timeout (30 seconds — for development only, would be longer in prod)
+    // Idle timeout (30 seconds - for development only, would be longer in prod)
     let idleTimer = setTimeout(() => socket.disconnect(), 30_000);
     socket.onAny(() => {
       clearTimeout(idleTimer);
diff --git a/src/lib/validators/custom-fields.ts b/src/lib/validators/custom-fields.ts
index d796e6c..cdc3b34 100644
--- a/src/lib/validators/custom-fields.ts
+++ b/src/lib/validators/custom-fields.ts
@@ -13,18 +13,12 @@ export const createFieldSchema = z
       .regex(/^[a-z_][a-z0-9_]*$/, 'Must be snake_case'),
     fieldLabel: z.string().min(1).max(100),
     fieldType: z.enum(CUSTOM_FIELD_TYPES),
-    selectOptions: z
-      .array(z.string().min(1).max(100))
-      .min(1)
-      .max(50)
-      .optional(),
+    selectOptions: z.array(z.string().min(1).max(100)).min(1).max(50).optional(),
     isRequired: z.boolean().default(false),
     sortOrder: z.number().int().min(0).default(0),
   })
   .refine(
-    (data) =>
-      data.fieldType !== 'select' ||
-      (data.selectOptions && data.selectOptions.length > 0),
+    (data) => data.fieldType !== 'select' || (data.selectOptions && data.selectOptions.length > 0),
     {
       message: 'Select fields must have at least one option',
       path: ['selectOptions'],
@@ -36,7 +30,7 @@ export const updateFieldSchema = z.object({
   selectOptions: z.array(z.string().min(1).max(100)).optional(),
   isRequired: z.boolean().optional(),
   sortOrder: z.number().int().min(0).optional(),
-  // fieldType intentionally omitted — cannot be changed after creation
+  // fieldType intentionally omitted - cannot be changed after creation
 });
 
 export const setValuesSchema = z.object({
diff --git a/src/lib/validators/document-templates.ts b/src/lib/validators/document-templates.ts
index c9c0332..be6d084 100644
--- a/src/lib/validators/document-templates.ts
+++ b/src/lib/validators/document-templates.ts
@@ -82,7 +82,7 @@ export type GenerateAndSendInput = z.infer<typeof generateAndSendSchema>;
 export type GenerateAndSignInput = z.infer<typeof generateAndSignSchema>;
 
 // ─── TipTap-based Admin Template Schemas ─────────────────────────────────────
-// Used by /api/v1/admin/templates — the TipTap JSON document store.
+// Used by /api/v1/admin/templates - the TipTap JSON document store.
 
 export const tiptapDocumentTypes = [
   'eoi',
diff --git a/src/lib/validators/documents.ts b/src/lib/validators/documents.ts
index 1d4009c..19a13f3 100644
--- a/src/lib/validators/documents.ts
+++ b/src/lib/validators/documents.ts
@@ -84,7 +84,7 @@ export const listDocumentsSchema = baseListQuerySchema.extend({
   clientId: z.string().optional(),
   documentType: z.string().optional(),
   status: z.string().optional(),
-  /** Hub tab filter — applies tab-specific status / signer-membership constraints. */
+  /** Hub tab filter - applies tab-specific status / signer-membership constraints. */
   tab: z.enum(documentsHubTabs).optional(),
   /** Restrict to docs being watched by this user id. */
   watcherUserId: z.string().optional(),
diff --git a/src/lib/validators/i18n.ts b/src/lib/validators/i18n.ts
index f2cfa1e..319365e 100644
--- a/src/lib/validators/i18n.ts
+++ b/src/lib/validators/i18n.ts
@@ -58,7 +58,7 @@ export const subdivisionIsoSchema = z
   .refine((code) => isValidSubdivisionCode(code), 'Unknown subdivision code');
 
 // ─── Optional variants ────────────────────────────────────────────────────────
-// Inline forms most callers will use — empty strings normalize to null
+// Inline forms most callers will use - empty strings normalize to null
 // so the user clearing a field doesn't fail validation.
 
 export const optionalCountryIsoSchema = z
diff --git a/src/lib/validators/interests.ts b/src/lib/validators/interests.ts
index 2027797..acbe34b 100644
--- a/src/lib/validators/interests.ts
+++ b/src/lib/validators/interests.ts
@@ -162,7 +162,7 @@ export const publicInterestSchema = z
     // NEW: required structured yacht block. Public submissions after the
     // data-model refactor MUST include yacht data.
     yacht: publicYachtSchema,
-    // NEW: optional company block — creates/upserts a company and adds a
+    // NEW: optional company block - creates/upserts a company and adds a
     // membership linking the submitting client to it.
     company: publicCompanySchema.optional(),
     source: z.literal('website').default('website'),
diff --git a/src/lib/validators/residential.ts b/src/lib/validators/residential.ts
index b32eaa6..5f6971d 100644
--- a/src/lib/validators/residential.ts
+++ b/src/lib/validators/residential.ts
@@ -81,7 +81,7 @@ export const listResidentialInterestsSchema = baseListQuerySchema.extend({
  * Shape posted by the public website's residential interest form. Coerces
  * to internal create-shapes inside the public route.
  *
- * The legacy `phone` field stays free-text — older website builds may post
+ * The legacy `phone` field stays free-text - older website builds may post
  * raw international strings ('+44 7700 900123'). The route handler parses
  * it server-side into `phoneE164` + `phoneCountry`. Newer website builds
  * can post normalized values directly.
diff --git a/src/lib/validators/webhooks.ts b/src/lib/validators/webhooks.ts
index 6362be2..24503f3 100644
--- a/src/lib/validators/webhooks.ts
+++ b/src/lib/validators/webhooks.ts
@@ -51,7 +51,7 @@ function isBlockedIpv6(host: string): boolean {
   if (h.startsWith('fe80:') || h.startsWith('fe80::')) return true; // link-local
   if (/^f[cd][0-9a-f]{2}:/.test(h)) return true; // fc00::/7 unique-local
   if (h.startsWith('::ffff:')) {
-    // IPv4-mapped — unwrap and check
+    // IPv4-mapped - unwrap and check
     const ipv4 = h.slice(7);
     return isBlockedIpv4(ipv4);
   }
@@ -62,7 +62,7 @@ function isBlockedIpv6(host: string): boolean {
  * Reject webhook URLs whose hostname targets a private/internal/loopback/
  * link-local destination. The webhook worker `fetch`es the URL and writes
  * a slice of the response body into `webhook_deliveries.response_body`,
- * which is later returned by the deliveries listing endpoint — making any
+ * which is later returned by the deliveries listing endpoint - making any
  * SSRF here an information-disclosure read primitive against any internal
  * service the worker can reach. Does NOT defend against DNS rebinding;
  * the worker performs its own re-resolution at dispatch time.
diff --git a/src/middleware.ts b/src/middleware.ts
index 077888b..4743ba7 100644
--- a/src/middleware.ts
+++ b/src/middleware.ts
@@ -20,6 +20,11 @@ const PUBLIC_PATHS: string[] = [
 ];
 
 function isPublicPath(pathname: string): boolean {
+  // Per-port PWA manifests sit under `/<portSlug>/scan/manifest.webmanifest`
+  // and need to be fetchable without a session - browsers fetch them eagerly
+  // during install / first paint. The manifest only contains port name +
+  // icon paths, no sensitive data, so making it public is safe.
+  if (pathname.endsWith('/scan/manifest.webmanifest')) return true;
   return PUBLIC_PATHS.some((prefix) => pathname === prefix || pathname.startsWith(prefix));
 }
 
@@ -39,7 +44,7 @@ export function middleware(request: NextRequest): NextResponse {
 
   if (!sessionToken?.value) {
     if (isApiRoute(pathname)) {
-      // API routes return 401 JSON — never redirect
+      // API routes return 401 JSON - never redirect
       return NextResponse.json({ error: 'Authentication required' }, { status: 401 });
     }
 
diff --git a/src/providers/port-provider.tsx b/src/providers/port-provider.tsx
index 3069818..cd38adc 100644
--- a/src/providers/port-provider.tsx
+++ b/src/providers/port-provider.tsx
@@ -34,7 +34,7 @@ export function PortProvider({ children, ports, defaultPortId }: PortProviderPro
   const currentPortId = useUIStore((s) => s.currentPortId);
   const currentPortSlug = useUIStore((s) => s.currentPortSlug);
 
-  // Resolve current port — URL slug takes priority over stored port
+  // Resolve current port - URL slug takes priority over stored port
   const currentPort =
     ports.find((p) => p.slug === portSlugFromUrl) ??
     ports.find((p) => p.id === currentPortId) ??
diff --git a/src/providers/socket-provider.tsx b/src/providers/socket-provider.tsx
index b55f00d..a3c6379 100644
--- a/src/providers/socket-provider.tsx
+++ b/src/providers/socket-provider.tsx
@@ -14,7 +14,7 @@ import { useSession } from '@/lib/auth/client';
 import { usePortStore } from '@/stores/ui-store';
 
 interface SocketContextValue {
-  /** Stable socket instance reference. Persists across reconnects — socket.io's
+  /** Stable socket instance reference. Persists across reconnects - socket.io's
    *  built-in reconnection re-establishes the underlying transport without
    *  changing the JS object, so this stays valid as long as the session and
    *  port are unchanged. Consumers should NOT null-check this for "is online";
@@ -30,7 +30,7 @@ const SocketContext = createContext<SocketContextValue>({ socket: null, isConnec
 
 /** Returns true once the component has mounted on the client. Avoids calling
  *  better-auth's `useSession()` (which dispatches React hooks via nanostores)
- *  during the SSR pass — that combo throws "Invalid hook call" intermittently
+ *  during the SSR pass - that combo throws "Invalid hook call" intermittently
  *  in Next.js 15 dev mode. */
 function useHasMounted(): boolean {
   return useSyncExternalStore(
diff --git a/src/worker.ts b/src/worker.ts
index 6600ed1..60e330c 100644
--- a/src/worker.ts
+++ b/src/worker.ts
@@ -9,7 +9,7 @@
 import { logger } from '@/lib/logger';
 import { registerRecurringJobs } from '@/lib/queue/scheduler';
 
-// Import all workers — the act of importing starts them
+// Import all workers - the act of importing starts them
 import { emailWorker } from '@/lib/queue/workers/email';
 import { documentsWorker } from '@/lib/queue/workers/documents';
 import { notificationsWorker } from '@/lib/queue/workers/notifications';