feat(bulk): synchronous bulk action endpoints + UI on interests/clients/yachts

Until now the only bulk action anywhere was Archive on the interests
list — implemented as parallel fan-out with no per-row failure
reporting. The bulk BullMQ worker was a TODO stub with no producers.

- bulk-helpers.runBulk wraps a per-row loop and returns
  {results, summary} for the caller. Page-size capped at 100.
- New endpoints: /api/v1/{interests,clients,yachts,companies}/bulk
  with a Zod discriminated union over the action. Interests support
  change_stage + add_tag + remove_tag + archive; clients/yachts/companies
  support archive + add_tag + remove_tag. Each action is permission-gated
  individually (delete vs edit vs change_stage).
- interest-list, client-list, yacht-list expose the new actions in the
  bulk-action toolbar with dialogs for stage / tag selection. Failure
  summaries surface via window.confirm.
- bulkWorker stub gets a docblock explaining the v1 sync-only choice
  and what the queue is reserved for (CSV imports, port-wide migrations,
  bulk emails to >100 recipients).

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

src/components/yachts/yacht-list.tsx

@@ -2,7 +2,7 @@
 
 import { useState } from 'react';
 import { useParams } from 'next/navigation';
-import { Plus } from 'lucide-react';
+import { Plus, Archive, Tag as TagIcon, TagsIcon } from 'lucide-react';
 import { useMutation, useQueryClient } from '@tanstack/react-query';
 
 import { Button } from '@/components/ui/button';
@@ -14,6 +14,15 @@ import { EmptyState } from '@/components/shared/empty-state';
 import { TableSkeleton } from '@/components/shared/loading-skeleton';
 import { ArchiveConfirmDialog } from '@/components/shared/archive-confirm-dialog';
 import { PermissionGate } from '@/components/shared/permission-gate';
+import { TagPicker } from '@/components/shared/tag-picker';
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from '@/components/ui/dialog';
 import { YachtCard } from '@/components/yachts/yacht-card';
 import { YachtForm } from '@/components/yachts/yacht-form';
 import { yachtFilterDefinitions } from '@/components/yachts/yacht-filters';
@@ -30,6 +39,30 @@ export function YachtList() {
   const [createOpen, setCreateOpen] = useState(false);
   const [editYacht, setEditYacht] = useState<YachtRow | null>(null);
   const [archiveYacht, setArchiveYacht] = useState<YachtRow | null>(null);
+  const [tagDialog, setTagDialog] = useState<{ ids: string[]; mode: 'add' | 'remove' } | null>(
+    null,
+  );
+  const [tagChoice, setTagChoice] = useState<string[]>([]);
+
+  const bulkMutation = useMutation({
+    mutationFn: async (
+      payload:
+        | { action: 'archive'; ids: string[] }
+        | { action: 'add_tag'; ids: string[]; tagId: string }
+        | { action: 'remove_tag'; ids: string[]; tagId: string },
+    ) =>
+      apiFetch<{ data: { summary: { total: number; succeeded: number; failed: number } } }>(
+        '/api/v1/yachts/bulk',
+        { method: 'POST', body: payload },
+      ),
+    onSuccess: (res) => {
+      queryClient.invalidateQueries({ queryKey: ['yachts'] });
+      const s = res.data.summary;
+      if (s.failed > 0) {
+        alert(`${s.succeeded} of ${s.total} succeeded. ${s.failed} failed.`);
+      }
+    },
+  });
 
   const {
     data,
@@ -125,6 +158,42 @@ export function YachtList() {
           onSortChange={setSort}
           isLoading={isFetching && !isLoading}
           getRowId={(row) => row.id}
+          bulkActions={[
+            {
+              label: 'Add tag',
+              icon: TagIcon,
+              onClick: (ids) => {
+                if (ids.length === 0) return;
+                setTagChoice([]);
+                setTagDialog({ ids, mode: 'add' });
+              },
+            },
+            {
+              label: 'Remove tag',
+              icon: TagsIcon,
+              onClick: (ids) => {
+                if (ids.length === 0) return;
+                setTagChoice([]);
+                setTagDialog({ ids, mode: 'remove' });
+              },
+            },
+            {
+              label: 'Archive',
+              icon: Archive,
+              variant: 'destructive',
+              onClick: (ids) => {
+                if (ids.length === 0) return;
+                if (
+                  !window.confirm(
+                    `Archive ${ids.length} yacht${ids.length === 1 ? '' : 's'}? This can be undone from the archived list.`,
+                  )
+                ) {
+                  return;
+                }
+                bulkMutation.mutate({ action: 'archive', ids });
+              },
+            },
+          ]}
           cardRender={(row) => (
             <YachtCard
               yacht={row.original}
@@ -143,6 +212,52 @@ export function YachtList() {
         />
       )}
 
+      <Dialog open={!!tagDialog} onOpenChange={(o) => !o && setTagDialog(null)}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>{tagDialog?.mode === 'add' ? 'Add tag' : 'Remove tag'}</DialogTitle>
+            <DialogDescription>
+              {tagDialog?.mode === 'add'
+                ? `Add a tag to ${tagDialog?.ids.length ?? 0} selected yacht${tagDialog?.ids.length === 1 ? '' : 's'}.`
+                : `Remove a tag from ${tagDialog?.ids.length ?? 0} selected yacht${tagDialog?.ids.length === 1 ? '' : 's'}. Yachts without the tag are unchanged.`}
+            </DialogDescription>
+          </DialogHeader>
+          <div className="py-2">
+            <TagPicker
+              selectedIds={tagChoice}
+              onChange={(ids) => setTagChoice(ids.slice(-1))}
+              placeholder="Pick one tag…"
+            />
+            <p className="text-xs text-muted-foreground mt-2">
+              Pick a single tag. To apply multiple tags, run the action once per tag.
+            </p>
+          </div>
+          <DialogFooter>
+            <Button variant="outline" onClick={() => setTagDialog(null)}>
+              Cancel
+            </Button>
+            <Button
+              disabled={bulkMutation.isPending || tagChoice.length === 0}
+              onClick={() => {
+                if (!tagDialog || tagChoice.length === 0) return;
+                const tagId = tagChoice[0];
+                if (!tagId) return;
+                bulkMutation.mutate(
+                  {
+                    action: tagDialog.mode === 'add' ? 'add_tag' : 'remove_tag',
+                    ids: tagDialog.ids,
+                    tagId,
+                  },
+                  { onSettled: () => setTagDialog(null) },
+                );
+              }}
+            >
+              Apply
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+
       <YachtForm open={createOpen} onOpenChange={setCreateOpen} />
 
       {editYacht && (