feat(#1466): non-blocking insurance prompt read-model + urgency badge (P3a)

apps/admin/src/app/trips/[id]/_components/insurance-prompt-card.tsx

@@ -0,0 +1,78 @@
+'use client'
+
+/**
+ * Insurance-prompt card — Automation Gate P3a (#1466).
+ *
+ * A PERSISTENT, NON-BLOCKING prompt rendered above the grouped automation jobs
+ * while any traveler's insurance decision is still pending. It deep-links to the
+ * Insurance tab (?tab=insurance) — it does NOT re-implement the proposal dialog.
+ *
+ * The urgency badge is DISPLAY-ONLY (Al: purchase_window_hours never gates).
+ * The underlying read-model fails open to "no badge" / no card on any error, so
+ * this can never block the Automation tab from rendering.
+ */
+
+import * as React from 'react'
+import { useRouter } from 'next/navigation'
+import { Shield, ChevronRight } from 'lucide-react'
+import { Button } from '@/components/ui/button'
+import { useInsurancePrompt } from '@/hooks/use-automations'
+import type { InsuranceUrgencyTier } from '@tailfire/shared-types/api'
+
+interface InsurancePromptCardProps {
+  tripId: string
+}
+
+const URGENCY_BADGE: Record<
+  Exclude<InsuranceUrgencyTier, 'none'>,
+  { label: string; className: string }
+> = {
+  urgent: { label: 'Purchase window closing', className: 'bg-red-100 text-red-700' },
+  soon: { label: 'Purchase window soon', className: 'bg-amber-100 text-amber-700' },
+}
+
+export function InsurancePromptCard({ tripId }: InsurancePromptCardProps) {
+  const router = useRouter()
+  const { data } = useInsurancePrompt(tripId)
+
+  // Fail-open: no data yet, or nothing pending → render nothing (card hidden
+  // once every traveler's insurance is resolved).
+  if (!data || !data.anyPending) return null
+
+  const badge = data.urgency === 'none' ? null : URGENCY_BADGE[data.urgency]
+  const count = data.pendingCount
+  const travelerWord = count === 1 ? 'traveller' : 'travellers'
+
+  return (
+    <div className="flex items-start justify-between gap-3 rounded-lg border border-sky-200 bg-sky-50 px-4 py-3">
+      <div className="flex items-start gap-3">
+        <Shield className="mt-0.5 h-5 w-5 shrink-0 text-sky-600" />
+        <div className="space-y-0.5">
+          <div className="flex items-center gap-2">
+            <p className="text-sm font-semibold text-sky-900">Insurance not yet confirmed</p>
+            {badge && (
+              <span
+                className={`inline-flex items-center rounded-full px-2 py-0.5 text-xs font-medium ${badge.className}`}
+              >
+                {badge.label}
+              </span>
+            )}
+          </div>
+          <p className="text-xs text-sky-700">
+            {count} {travelerWord} still {count === 1 ? 'needs' : 'need'} an insurance decision.
+            Confirm coverage, record their own policy, or log a declination on the Insurance tab.
+          </p>
+        </div>
+      </div>
+      <Button
+        size="sm"
+        variant="outline"
+        className="shrink-0 gap-1 border-sky-300 bg-white text-sky-800 hover:bg-sky-100"
+        onClick={() => router.push(`/trips/${tripId}?tab=insurance`)}
+      >
+        Review insurance
+        <ChevronRight className="h-4 w-4" />
+      </Button>
+    </div>
+  )
+}

apps/admin/src/app/trips/[id]/_components/trip-automations.tsx

@@ -29,6 +29,7 @@ import {
 import { AutomationScheduleDialog } from './automation-schedule-dialog'
 import { AutomationRecalibrateButton } from './automation-recalibrate-button'
 import { AutomationTasksSection } from './automation-tasks-section'
+import { InsurancePromptCard } from './insurance-prompt-card'
 import {
   useTripAutomations,
   usePauseAutomation,
@@ -364,13 +365,19 @@ export function TripAutomations({ trip }: TripAutomationsProps) {
   }
 
   // Flag OFF + no jobs → exact v1 empty state (no header), keeping v1 inert.
+  // The insurance prompt (#1466 P3a) is NOT gated by the automation-control flag —
+  // it renders above the empty state whenever a traveler's insurance is pending,
+  // and returns null otherwise (so the flag-off/no-pending case stays byte-identical).
   if (!controlsEnabled && sortedJobs.length === 0) {
     return (
-      <EmptyState
-        icon={<Zap className="h-6 w-6" />}
-        title="No automation jobs yet"
-        description="Jobs will appear here when you initiate insurance proposals or other automated workflows."
-      />
+      <div className="space-y-4">
+        <InsurancePromptCard tripId={trip.id} />
+        <EmptyState
+          icon={<Zap className="h-6 w-6" />}
+          title="No automation jobs yet"
+          description="Jobs will appear here when you initiate insurance proposals or other automated workflows."
+        />
+      </div>
     )
   }
 
@@ -504,6 +511,9 @@ export function TripAutomations({ trip }: TripAutomationsProps) {
       {renderHeader()}
       {renderFilterBar()}
 
+      {/* #1466 P3a — persistent, non-blocking insurance prompt above the jobs. */}
+      <InsurancePromptCard tripId={trip.id} />
+
       {pendingReview.length > 0 &&
         renderGroup(
           '__pending_review__',

apps/admin/src/hooks/use-automations.ts

@@ -27,6 +27,7 @@ import type {
   CreateAdHocAutomationParams,
   EditAutomationContent,
   ExecuteNowResult,
+  InsurancePromptDto,
   JobIdentity,
   JobSelector,
   RescheduleMode,
@@ -48,6 +49,7 @@ export type {
   ReconcileApplyItem,
   ReconcileApplyRequest,
   ReconcileApplyResponse,
+  InsurancePromptDto,
   JobIdentity,
   JobSelector,
   RescheduleMode,
@@ -147,6 +149,8 @@ export const tripAutomationKeys = {
   list: (tripId: string) => [...tripAutomationKeys.all, tripId] as const,
   insurancePreview: (tripId: string) =>
     [...tripAutomationKeys.all, 'insurance-preview', tripId] as const,
+  insurancePrompt: (tripId: string) =>
+    [...tripAutomationKeys.all, 'insurance-prompt', tripId] as const,
   contentPreview: (tripId: string, queueName: string, jobId: string) =>
     [...tripAutomationKeys.all, 'content-preview', tripId, queueName, jobId] as const,
   reconcilePreview: (tripId: string) =>
@@ -208,6 +212,20 @@ export function useInsurancePreview(tripId: string, enabled = true) {
   })
 }
 
+/**
+ * Fetch the non-blocking insurance-prompt read-model (#1466 P3a). Drives the
+ * persistent prompt card in the Automation tab: `anyPending` toggles the card,
+ * `urgency` is a DISPLAY badge only. Read-only; the endpoint fails open to an
+ * empty read-model, so this never blocks the tab render.
+ */
+export function useInsurancePrompt(tripId: string, enabled = true) {
+  return useQuery({
+    queryKey: tripAutomationKeys.insurancePrompt(tripId),
+    queryFn: () => api.get<InsurancePromptDto>(`/trips/${tripId}/automations/insurance-prompt`),
+    enabled: !!tripId && enabled,
+  })
+}
+
 /**
  * Resolve the channel-aware rendered content of a queued/paused job for the
  * preview pane + the edit modal's seed (WS-2 content-preview). Read-only: