feat: add Meetings Still Polling detail table with sidebar to Diavgeia admin

Extract getBackoffState() helper from inline tier calculation logic so
it can be reused. Expand getPollingStats() to return per-meeting details
(unlinked subjects, backoff state, poll history) instead of just a count.

Add a collapsible table showing each still-polling meeting with city,
date, unlinked/eligible counts, first/last poll dates (with timestamp
tooltips on hover), backoff tier, and a details sidebar listing the
unlinked subject names with a link to the meeting admin page.

Refactor getPollingHistoryForMeeting() to use the shared helper.

Author: kouloumos

src/components/admin/diavgeia/PollingStats.tsx

@@ -60,9 +60,23 @@ interface RecentPoll {
   responseBody: string | null;
 }
 
+interface StillPollingMeeting {
+  cityId: string;
+  meetingId: string;
+  meetingDate: string;
+  unlinkedSubjects: Array<{ id: string; name: string }>;
+  totalEligibleSubjects: number;
+  totalPolls: number;
+  firstPollAt: string | null;
+  lastPollAt: string | null;
+  currentTierLabel: string | null;
+  nextPollEligible: string | null;
+}
+
 interface PollingStatsData {
   backoffSchedule: BackoffTier[];
   maxPollingDays: number;
+  meetingsStillPolling: StillPollingMeeting[];
   summary: {
     totalDiscoveries: number;
     meetingsStillPolling: number;
@@ -206,6 +220,7 @@ export function PollingStats({ stats, pollCities, cityFilter, pollMeetings, meet
   const [sortField, setSortField] = useState<SortField>('discoveredAt');
   const [sortDirection, setSortDirection] = useState<SortDirection>('desc');
   const [selectedPoll, setSelectedPoll] = useState<RecentPoll | null>(null);
+  const [selectedMeeting, setSelectedMeeting] = useState<StillPollingMeeting | null>(null);
   const { updateParam, updateParams, isPending } = useUrlParams();
 
   const handleSort = (field: SortField) => {
@@ -243,7 +258,7 @@ export function PollingStats({ stats, pollCities, cityFilter, pollMeetings, meet
     },
     {
       title: 'Meetings Still Polling',
-      value: stats.summary.meetingsStillPolling,
+      value: stats.meetingsStillPolling.length,
       icon: <Activity className="h-4 w-4" />,
       description: 'With unlinked subjects',
     },
@@ -276,11 +291,90 @@ export function PollingStats({ stats, pollCities, cityFilter, pollMeetings, meet
   );
 
   return (
+    <>
     <Sheet open={!!selectedPoll} onOpenChange={(open) => !open && setSelectedPoll(null)}>
     <div className="space-y-6">
       {/* Summary Cards */}
       <StatsCard items={summaryItems} columns={4} />
 
+      {/* Meetings Still Polling */}
+      <CollapsibleSection
+        title="Meetings Still Polling"
+        badge={`${stats.meetingsStillPolling.length} meetings`}
+        defaultOpen={stats.meetingsStillPolling.length > 0}
+      >
+        {stats.meetingsStillPolling.length === 0 ? (
+          <div className="p-8 text-center text-muted-foreground">
+            No meetings are currently being polled.
+          </div>
+        ) : (
+          <div className="overflow-x-auto">
+            <table className="w-full text-sm">
+              <thead>
+                <tr className="bg-muted/50 border-b text-muted-foreground">
+                  <th className="text-left px-4 py-2 font-medium">City</th>
+                  <th className="text-left px-4 py-2 font-medium">Meeting ID</th>
+                  <th className="text-left px-4 py-2 font-medium">Meeting Date</th>
+                  <th className="text-left px-4 py-2 font-medium">Unlinked</th>
+                  <th className="text-left px-4 py-2 font-medium">Polls</th>
+                  <th className="text-left px-4 py-2 font-medium">First Poll</th>
+                  <th className="text-left px-4 py-2 font-medium">Last Poll</th>
+                  <th className="text-left px-4 py-2 font-medium">Backoff</th>
+                  <th className="text-right px-4 py-2 font-medium">Details</th>
+                </tr>
+              </thead>
+              <TooltipProvider>
+              <tbody>
+                {stats.meetingsStillPolling.map(m => (
+                  <tr key={`${m.cityId}:${m.meetingId}`} className="border-b last:border-b-0 hover:bg-muted/30">
+                    <td className="px-4 py-2 whitespace-nowrap font-mono text-xs">{m.cityId}</td>
+                    <td className="px-4 py-2 whitespace-nowrap font-mono text-xs">{m.meetingId}</td>
+                    <td className="px-4 py-2 whitespace-nowrap">{m.meetingDate}</td>
+                    <td className="px-4 py-2 whitespace-nowrap">
+                      {m.unlinkedSubjects.length} / {m.totalEligibleSubjects}
+                    </td>
+                    <td className="px-4 py-2 whitespace-nowrap text-center">{m.totalPolls}</td>
+                    <td className="px-4 py-2 whitespace-nowrap">
+                      {m.firstPollAt ? (
+                        <Tooltip>
+                          <TooltipTrigger asChild>
+                            <span className="block cursor-default">{new Date(m.firstPollAt).toLocaleDateString()}</span>
+                          </TooltipTrigger>
+                          <TooltipContent side="bottom">{new Date(m.firstPollAt).toLocaleString()}</TooltipContent>
+                        </Tooltip>
+                      ) : 'Never'}
+                    </td>
+                    <td className="px-4 py-2 whitespace-nowrap">
+                      {m.lastPollAt ? (
+                        <Tooltip>
+                          <TooltipTrigger asChild>
+                            <span className="block cursor-default">{new Date(m.lastPollAt).toLocaleDateString()}</span>
+                          </TooltipTrigger>
+                          <TooltipContent side="bottom">{new Date(m.lastPollAt).toLocaleString()}</TooltipContent>
+                        </Tooltip>
+                      ) : 'Never'}
+                    </td>
+                    <td className="px-4 py-2 whitespace-nowrap text-xs">
+                      {m.currentTierLabel ?? '\u2014'}
+                    </td>
+                    <td className="px-4 py-2 text-right">
+                      <Button
+                        variant="ghost"
+                        size="sm"
+                        onClick={() => setSelectedMeeting(m)}
+                      >
+                        <Eye className="h-4 w-4" />
+                      </Button>
+                    </td>
+                  </tr>
+                ))}
+              </tbody>
+              </TooltipProvider>
+            </table>
+          </div>
+        )}
+      </CollapsibleSection>
+
       {/* Recent Polls */}
       <CollapsibleSection
         title="Recent Polls"
@@ -579,5 +673,82 @@ export function PollingStats({ stats, pollCities, cityFilter, pollMeetings, meet
       </SheetContent>
     )}
     </Sheet>
+
+    {/* Still Polling Meeting Details Sidebar */}
+    <Sheet open={!!selectedMeeting} onOpenChange={(open) => !open && setSelectedMeeting(null)}>
+    {selectedMeeting && (
+      <SheetContent className="sm:max-w-lg overflow-y-auto">
+        <SheetHeader>
+          <SheetTitle>Meeting Polling Details</SheetTitle>
+          <SheetDescription>
+            {selectedMeeting.cityId} / {selectedMeeting.meetingId}
+          </SheetDescription>
+        </SheetHeader>
+
+        <div className="mt-6 space-y-6">
+          {/* Metadata Grid */}
+          <div className="grid grid-cols-2 gap-4">
+            <div>
+              <div className="text-sm text-muted-foreground mb-1">City</div>
+              <div className="text-sm font-mono">{selectedMeeting.cityId}</div>
+            </div>
+            <div>
+              <div className="text-sm text-muted-foreground mb-1">Meeting Date</div>
+              <div className="text-sm font-medium">{selectedMeeting.meetingDate}</div>
+            </div>
+            <div>
+              <div className="text-sm text-muted-foreground mb-1">Backoff Tier</div>
+              <div className="text-sm font-medium">{selectedMeeting.currentTierLabel ?? 'Not started'}</div>
+            </div>
+            <div>
+              <div className="text-sm text-muted-foreground mb-1">Next Poll Eligible</div>
+              <div className="text-sm font-medium">
+                {selectedMeeting.nextPollEligible
+                  ? new Date(selectedMeeting.nextPollEligible).toLocaleString()
+                  : 'Next cron run'}
+              </div>
+            </div>
+            <div>
+              <div className="text-sm text-muted-foreground mb-1">Total Polls</div>
+              <div className="text-sm font-medium">{selectedMeeting.totalPolls}</div>
+            </div>
+            <div>
+              <div className="text-sm text-muted-foreground mb-1">Last Poll</div>
+              <div className="text-sm font-medium">
+                {selectedMeeting.lastPollAt ? new Date(selectedMeeting.lastPollAt).toLocaleString() : 'Never'}
+              </div>
+            </div>
+          </div>
+
+          {/* Meeting Admin Link */}
+          <Link href={`/${selectedMeeting.cityId}/${selectedMeeting.meetingId}/admin`}>
+            <Button variant="outline" className="w-full">
+              <ExternalLink className="h-4 w-4 mr-2" />
+              Go to Meeting Admin
+            </Button>
+          </Link>
+
+          {/* Unlinked Subjects */}
+          <div>
+            <div className="text-sm font-medium mb-2">
+              Unlinked Subjects ({selectedMeeting.unlinkedSubjects.length} / {selectedMeeting.totalEligibleSubjects})
+            </div>
+            {selectedMeeting.unlinkedSubjects.length === 0 ? (
+              <p className="text-sm text-muted-foreground">All subjects have linked decisions.</p>
+            ) : (
+              <ul className="space-y-2">
+                {selectedMeeting.unlinkedSubjects.map(s => (
+                  <li key={s.id} className="text-sm border rounded-md px-3 py-2 bg-muted/20">
+                    {s.name}
+                  </li>
+                ))}
+              </ul>
+            )}
+          </div>
+        </div>
+      </SheetContent>
+    )}
+    </Sheet>
+    </>
   );
 }

src/lib/tasks/__tests__/pollDecisions.test.ts

@@ -1,4 +1,4 @@
-import { shouldSkipPolling, BACKOFF_SCHEDULE, MAX_POLLING_DAYS } from '../pollDecisionsBackoff';
+import { shouldSkipPolling, getBackoffState, BACKOFF_SCHEDULE, MAX_POLLING_DAYS } from '../pollDecisionsBackoff';
 
 // Helper: create a Date that is `daysAgo` days before now
 const daysAgo = (days: number) => new Date(Date.now() - days * 24 * 60 * 60 * 1000);
@@ -116,3 +116,82 @@ describe('shouldSkipPolling', () => {
         });
     });
 });
+
+describe('getBackoffState', () => {
+    describe('no history', () => {
+        it('returns nulls when both dates are null', () => {
+            expect(getBackoffState(null, null)).toEqual({
+                currentTierLabel: null,
+                nextPollEligible: null,
+            });
+        });
+
+        it('returns nulls when firstPollAt is null', () => {
+            expect(getBackoffState(null, daysAgo(1))).toEqual({
+                currentTierLabel: null,
+                nextPollEligible: null,
+            });
+        });
+
+        it('returns nulls when lastPollAt is null', () => {
+            expect(getBackoffState(daysAgo(1), null)).toEqual({
+                currentTierLabel: null,
+                nextPollEligible: null,
+            });
+        });
+    });
+
+    describe('week 1 (days 0-7): every cron run', () => {
+        it('returns "Every cron run" with no next poll restriction', () => {
+            const result = getBackoffState(daysAgo(3), daysAgo(0));
+            expect(result.currentTierLabel).toBe('Every cron run');
+            expect(result.nextPollEligible).toBeNull();
+        });
+    });
+
+    describe('week 2 (days 7-14)', () => {
+        it('returns week 2 tier label', () => {
+            const result = getBackoffState(daysAgo(8), daysAgo(0));
+            expect(result.currentTierLabel).toBe('Week 2: every 2d');
+        });
+
+        it('returns future next poll eligible when recently polled', () => {
+            const result = getBackoffState(daysAgo(8), daysAgo(0));
+            expect(result.nextPollEligible).not.toBeNull();
+            expect(new Date(result.nextPollEligible!).getTime()).toBeGreaterThan(Date.now());
+        });
+
+        it('returns null next poll eligible when interval has passed', () => {
+            const result = getBackoffState(daysAgo(8), daysAgo(3));
+            expect(result.nextPollEligible).toBeNull();
+        });
+    });
+
+    describe('week 3 (days 14-21)', () => {
+        it('returns week 3 tier label', () => {
+            const result = getBackoffState(daysAgo(15), daysAgo(0));
+            expect(result.currentTierLabel).toBe('Week 3: every 3d');
+        });
+    });
+
+    describe('week 4+ (days 21+)', () => {
+        it('returns week 4 tier label', () => {
+            const result = getBackoffState(daysAgo(25), daysAgo(0));
+            expect(result.currentTierLabel).toBe('Week 4: every 7d');
+        });
+    });
+
+    describe('max polling days exceeded', () => {
+        it(`returns stopped label after ${MAX_POLLING_DAYS} days`, () => {
+            const result = getBackoffState(daysAgo(MAX_POLLING_DAYS + 1), daysAgo(8));
+            expect(result.currentTierLabel).toContain('Stopped');
+            expect(result.currentTierLabel).toContain(`${MAX_POLLING_DAYS}`);
+            expect(result.nextPollEligible).toBeNull();
+        });
+
+        it(`returns active tier just before ${MAX_POLLING_DAYS} days`, () => {
+            const result = getBackoffState(daysAgo(MAX_POLLING_DAYS - 1), daysAgo(8));
+            expect(result.currentTierLabel).not.toContain('Stopped');
+        });
+    });
+});