fix(audit-wave-9): standardize on Sheet for previews; doctrine in CLAUDE.md

Swap the one outlier (client-interests-tab.tsx) from Vaul Drawer to
Sheet side=right so every detail-preview surface uses the same
primitive. Document the doctrine: Sheet for side panels on both desktop
and mobile; Vaul Drawer reserved for mobile-only bottom-sheet UX
(currently just MoreSheet).

Closes ui/ux M11.

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

src/components/companies/company-files-tab.tsx

@@ -9,6 +9,7 @@ import { FilePreviewDialog } from '@/components/files/file-preview-dialog';
 import { PermissionGate } from '@/components/shared/permission-gate';
 import { usePaginatedQuery } from '@/hooks/use-paginated-query';
 import { useRealtimeInvalidation } from '@/hooks/use-realtime-invalidation';
+import { useConfirmation } from '@/hooks/use-confirmation';
 import { apiFetch } from '@/lib/api/client';
 import type { FileRow } from '@/components/files/file-grid';
 
@@ -19,6 +20,7 @@ interface CompanyFilesTabProps {
 export function CompanyFilesTab({ companyId }: CompanyFilesTabProps) {
   const queryClient = useQueryClient();
   const [previewFile, setPreviewFile] = useState<FileRow | null>(null);
+  const { confirm, dialog: confirmDialog } = useConfirmation();
 
   const { data, isLoading } = usePaginatedQuery<FileRow>({
     queryKey: ['files', { companyId }],
@@ -47,7 +49,12 @@ export function CompanyFilesTab({ companyId }: CompanyFilesTabProps) {
   };
 
   const handleDelete = async (file: FileRow) => {
-    if (!confirm(`Delete "${file.filename}"? This cannot be undone.`)) return;
+    const ok = await confirm({
+      title: 'Delete file',
+      description: `Delete "${file.filename}"? This cannot be undone.`,
+      confirmLabel: 'Delete',
+    });
+    if (!ok) return;
     try {
       await apiFetch(`/api/v1/files/${file.id}`, { method: 'DELETE' });
       queryClient.invalidateQueries({ queryKey: ['files', { companyId }] });
@@ -83,6 +90,7 @@ export function CompanyFilesTab({ companyId }: CompanyFilesTabProps) {
         fileName={previewFile?.filename}
         mimeType={previewFile?.mimeType ?? undefined}
       />
+      {confirmDialog}
     </div>
   );
 }

src/components/companies/company-list.tsx

@@ -37,12 +37,14 @@ import { useCreateFromUrl } from '@/hooks/use-create-from-url';
 import { usePaginatedQuery } from '@/hooks/use-paginated-query';
 import { useRealtimeInvalidation } from '@/hooks/use-realtime-invalidation';
 import { useTablePreferences } from '@/hooks/use-table-preferences';
+import { useConfirmation } from '@/hooks/use-confirmation';
 import { apiFetch } from '@/lib/api/client';
 
 export function CompanyList() {
   const params = useParams<{ portSlug: string }>();
   const portSlug = params?.portSlug ?? '';
   const queryClient = useQueryClient();
+  const { confirm, dialog: confirmDialog } = useConfirmation();
 
   const [createOpen, setCreateOpen] = useState(false);
   useCreateFromUrl(() => setCreateOpen(true));
@@ -195,15 +197,14 @@ export function CompanyList() {
               label: 'Archive',
               icon: Archive,
               variant: 'destructive',
-              onClick: (ids) => {
+              onClick: async (ids) => {
                 if (ids.length === 0) return;
-                if (
-                  !window.confirm(
-                    `Archive ${ids.length} compan${ids.length === 1 ? 'y' : 'ies'}? This can be undone from the archived list.`,
-                  )
-                ) {
-                  return;
-                }
+                const ok = await confirm({
+                  title: `Archive ${ids.length} compan${ids.length === 1 ? 'y' : 'ies'}`,
+                  description: 'This can be undone from the archived list.',
+                  confirmLabel: 'Archive',
+                });
+                if (!ok) return;
                 bulkMutation.mutate({ action: 'archive', ids });
               },
             },
@@ -303,6 +304,7 @@ export function CompanyList() {
         onConfirm={() => archiveCompany && archiveMutation.mutate(archiveCompany.id)}
         isLoading={archiveMutation.isPending}
       />
+      {confirmDialog}
     </div>
   );
 }