feat: harden gmail sync foundation

job-tracker-ui/src/components/Correspondence.tsx

@@ -413,6 +413,16 @@ export default function Correspondence({ jobId, job }: { jobId: number; job: Job
         <Box sx={{ display: "flex", gap: 1, flexWrap: "wrap" }}>
           <Chip size="small" color={gmailStatus?.connected ? "success" : "default"} variant="outlined" label={gmailStatus?.connected ? "Gmail connected" : "Gmail not connected"} />
           <Chip size="small" color={linkedThreadIds.length > 0 ? "success" : "default"} variant="outlined" label={linkedThreadIds.length > 0 ? `Linked threads: ${linkedThreadIds.length}` : "No linked threads yet"} />
+          {gmailStatus?.lastSyncStatus ? (
+            <Chip
+              size="small"
+              color={gmailStatus.lastSyncStatus === "success" ? "success" : "warning"}
+              variant="outlined"
+              label={gmailStatus.lastSyncStatus === "success"
+                ? `Last Gmail sync ${gmailStatus.lastSyncMode || "sync"} ok`
+                : `Last Gmail sync ${gmailStatus.lastSyncMode || "sync"} failed`}
+            />
+          ) : null}
           {linkedThreadRefresh ? (
             <Chip
               size="small"
@@ -425,6 +435,11 @@ export default function Correspondence({ jobId, job }: { jobId: number; job: Job
             />
           ) : null}
         </Box>
+        {gmailStatus?.lastSyncError ? (
+          <Typography variant="body2" sx={{ color: "warning.main", mt: 1 }}>
+            Latest Gmail sync issue: {gmailStatus.lastSyncError}
+          </Typography>
+        ) : null}
       </Box>
 
       <Box sx={{ display: "flex", gap: 1, alignItems: "flex-start", mt: 1.5, flexWrap: "wrap" }}>
@@ -503,6 +518,8 @@ export default function Correspondence({ jobId, job }: { jobId: number; job: Job
                     </Box>
                   ) : null}
                   {gmailStatus.lastSyncedAt ? <Chip label={t("correspondenceLastSynced", { date: new Date(gmailStatus.lastSyncedAt).toLocaleString() })} size="small" /> : null}
+                  {gmailStatus.lastSyncAttemptedAt ? <Chip label={`Sync checked ${new Date(gmailStatus.lastSyncAttemptedAt).toLocaleString()}`} size="small" variant="outlined" /> : null}
+                  {gmailStatus.lastSyncStatus === "error" && gmailStatus.lastSyncError ? <Chip label={`Sync issue: ${gmailStatus.lastSyncError}`} size="small" color="warning" variant="outlined" /> : null}
                   {linkedThreadIds.length > 0 ? (
                     <Box sx={{ display: "flex", gap: 1, flexWrap: "wrap" }}>
                       <Chip size="small" color="success" variant="outlined" label={`Linked threads: ${linkedThreadIds.length}`} />

job-tracker-ui/src/correspondence-gmail-import.test.tsx

@@ -78,7 +78,7 @@ describe("correspondence Gmail import", () => {
         return Promise.resolve({ data: correspondenceMessages } as any);
       }
       if (url === "/gmail/status") {
-        return Promise.resolve({ data: { connected: true, gmailAddress: "user@example.test", lastSyncedAt: new Date().toISOString() } } as any);
+        return Promise.resolve({ data: { connected: true, gmailAddress: "user@example.test", lastSyncedAt: new Date().toISOString(), lastSyncAttemptedAt: new Date().toISOString(), lastSyncMode: "list-messages", lastSyncSource: "custom-query", lastSyncStatus: "error", lastSyncError: "Token refresh failed" } } as any);
       }
       if (url === "/gmail/job-candidates") {
         return Promise.resolve({
@@ -291,6 +291,16 @@ describe("correspondence Gmail import", () => {
     expect((await screen.findAllByText(/thread thread-1/i)).length).toBeGreaterThan(0);
   });
 
+  test("shows Gmail sync state diagnostics alongside linked thread continuity", async () => {
+    renderDialog();
+
+    fireEvent.click(await screen.findByRole("button", { name: /import email/i }));
+    fireEvent.click(await screen.findByRole("tab", { name: /^google$/i }));
+
+    expect(await screen.findByText(/sync checked/i)).toBeInTheDocument();
+    expect((await screen.findAllByText(/token refresh failed/i)).length).toBeGreaterThan(0);
+  });
+
   test("manual Gmail search override reloads job candidates with queryOverride", async () => {
     renderDialog();
 

job-tracker-ui/src/types.ts

@@ -293,6 +293,12 @@ export interface GmailStatus {
   gmailAddress?: string;
   connectedAt?: string;
   lastSyncedAt?: string;
+  lastSyncAttemptedAt?: string;
+  lastSyncSucceededAt?: string;
+  lastSyncMode?: string | null;
+  lastSyncSource?: string | null;
+  lastSyncStatus?: string | null;
+  lastSyncError?: string | null;
 }
 
 export interface GmailMessageSummary {