tn-elections-mcp 0.5.0

package/dist/data/tn-counties.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from 'vitest';
+import { resolveCounty, EASYVOTE_COUNTIES, TN_COUNTIES } from './tn-counties.js';
+describe('resolveCounty', () => {
+    it('resolves by exact name', () => {
+        const result = resolveCounty('Knox');
+        expect(result).not.toBeNull();
+        expect(result.name).toBe('Knox');
+        expect(result.slug).toBe('knoxcountytn');
+    });
+    it('resolves by exact name (case-insensitive)', () => {
+        const result = resolveCounty('davidson');
+        expect(result).not.toBeNull();
+        expect(result.name).toBe('Davidson');
+    });
+    it('resolves by slug', () => {
+        const result = resolveCounty('shelbycountytn');
+        expect(result).not.toBeNull();
+        expect(result.name).toBe('Shelby');
+    });
+    it('resolves by county seat', () => {
+        const result = resolveCounty('Nashville');
+        expect(result).not.toBeNull();
+        expect(result.name).toBe('Davidson');
+    });
+    it('resolves by county seat (case-insensitive)', () => {
+        const result = resolveCounty('knoxville');
+        expect(result).not.toBeNull();
+        expect(result.name).toBe('Knox');
+    });
+    it('resolves by partial name prefix', () => {
+        const result = resolveCounty('david');
+        expect(result).not.toBeNull();
+        expect(result.name).toBe('Davidson');
+    });
+    it('resolves by partial county seat', () => {
+        const result = resolveCounty('chatt');
+        expect(result).not.toBeNull();
+        expect(result.name).toBe('Hamilton');
+    });
+    it('returns null for unknown county', () => {
+        expect(resolveCounty('FakeCounty')).toBeNull();
+    });
+    it('returns null for empty string', () => {
+        expect(resolveCounty('')).toBeNull();
+    });
+});
+describe('EASYVOTE_COUNTIES', () => {
+    it('has 14 entries', () => {
+        expect(EASYVOTE_COUNTIES).toHaveLength(14);
+    });
+    it('all have required fields', () => {
+        for (const county of EASYVOTE_COUNTIES) {
+            expect(county.slug).toBeTruthy();
+            expect(county.name).toBeTruthy();
+            expect(county.tenantId).toMatch(/^[A-F0-9-]+$/i);
+            expect(county.countySeat).toBeTruthy();
+            expect(typeof county.filerCount).toBe('number');
+        }
+    });
+    it('slug follows {name}countytn pattern', () => {
+        for (const county of EASYVOTE_COUNTIES) {
+            expect(county.slug).toBe(`${county.name.toLowerCase()}countytn`);
+        }
+    });
+});
+describe('TN_COUNTIES', () => {
+    it('has 95 entries', () => {
+        expect(Object.keys(TN_COUNTIES)).toHaveLength(95);
+    });
+});
+//# sourceMappingURL=tn-counties.test.js.map

package/dist/data/tn-counties.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tn-counties.test.js","sourceRoot":"","sources":["../../src/data/tn-counties.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerEasyVoteTools } from './tools/easyvote.js';
+// Phase 2: State campaign finance (tncamp)
+import { registerTncampTools } from './tools/tncamp.js';
+// Sumner County campaign finance (PDF-based)
+import { registerSumnerTools } from './tools/sumner.js';
+// TN Secretary of State candidate filings
+import { registerSosTools } from './tools/sos.js';
+const server = new McpServer({
+    name: 'tn-elections-mcp',
+    version: '0.5.0',
+});
+// County campaign finance (EasyVote — 14 counties)
+registerEasyVoteTools(server);
+// Phase 2: State campaign finance (tncamp)
+registerTncampTools(server);
+// Sumner County campaign finance (PDF-based)
+registerSumnerTools(server);
+// TN Secretary of State candidate filings
+registerSosTools(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,2CAA2C;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAEvD,6CAA6C;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAEvD,0CAA0C;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAA;AAEF,mDAAmD;AACnD,qBAAqB,CAAC,MAAM,CAAC,CAAA;AAE7B,2CAA2C;AAC3C,mBAAmB,CAAC,MAAM,CAAC,CAAA;AAE3B,6CAA6C;AAC7C,mBAAmB,CAAC,MAAM,CAAC,CAAA;AAE3B,0CAA0C;AAC1C,gBAAgB,CAAC,MAAM,CAAC,CAAA;AAExB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/parsers/sos-xlsx.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Parser for TN Secretary of State candidate filing data.
+ * Pure functions — no network calls.
+ *
+ * Two data formats:
+ * 1. HTML page listing xlsx/pdf links (parsed with node-html-parser)
+ * 2. xlsx files with 6 columns of candidate data (parsed with xlsx)
+ */
+import type { SosFiledCandidate, SosOfficeCategory } from '../types.js';
+/**
+ * Parse the SOS candidate list HTML page to extract office categories with xlsx/pdf URLs.
+ *
+ * Expected HTML structure:
+ * <li>Office Name: <a href="...pdf">PDF</a> | <a href="...xlsx">Excel</a></li>
+ */
+export declare function parseCandidateListPage(html: string): SosOfficeCategory[];
+/**
+ * Parse an xlsx buffer into an array of SosFiledCandidate.
+ *
+ * @param buffer - Raw xlsx file contents
+ * @param officeCategory - Category name (e.g., "Governor", "TN Senate")
+ * @param year - Election cycle year (used to infer year for date-only strings)
+ */
+export declare function parseXlsx(buffer: ArrayBuffer, officeCategory: string, year: number): SosFiledCandidate[];

package/dist/parsers/sos-xlsx.js

@@ -0,0 +1,149 @@
+/**
+ * Parser for TN Secretary of State candidate filing data.
+ * Pure functions — no network calls.
+ *
+ * Two data formats:
+ * 1. HTML page listing xlsx/pdf links (parsed with node-html-parser)
+ * 2. xlsx files with 6 columns of candidate data (parsed with xlsx)
+ */
+import { parse } from 'node-html-parser';
+import * as XLSX from 'xlsx';
+/** Header variations across federal vs state xlsx files */
+const HEADER_MAP = {
+    'Office': 'office',
+    'Candidate': 'candidateName',
+    'Party': 'party',
+    'Party Name': 'party',
+    'City': 'city',
+    'Filing Date': 'filingDate',
+    'Filed': 'filingDate',
+    'Status': 'status',
+};
+/**
+ * Parse the SOS candidate list HTML page to extract office categories with xlsx/pdf URLs.
+ *
+ * Expected HTML structure:
+ * <li>Office Name: <a href="...pdf">PDF</a> | <a href="...xlsx">Excel</a></li>
+ */
+export function parseCandidateListPage(html) {
+    const root = parse(html);
+    const offices = [];
+    const listItems = root.querySelectorAll('li');
+    for (const li of listItems) {
+        const links = li.querySelectorAll('a');
+        let xlsxUrl = '';
+        let pdfUrl = '';
+        for (const link of links) {
+            const href = link.getAttribute('href') || '';
+            if (href.endsWith('.xlsx'))
+                xlsxUrl = href;
+            else if (href.endsWith('.pdf'))
+                pdfUrl = href;
+        }
+        if (!xlsxUrl)
+            continue;
+        // Office name is the text before the colon
+        const rawText = li.text || '';
+        const colonIdx = rawText.indexOf(':');
+        const name = colonIdx > 0 ? rawText.substring(0, colonIdx).trim() : rawText.trim();
+        if (name) {
+            offices.push({ name, xlsxUrl, pdfUrl, candidateCount: 0 });
+        }
+    }
+    return offices;
+}
+/**
+ * Normalize a date string to YYYY-MM-DD format.
+ *
+ * Handles three cases:
+ * - Full date: "3/6/2026" → "2026-03-06"
+ * - Year-less date: "4/4" → "{year}-04-04" (state-level files omit the year)
+ * - Already formatted: "2026-03-06" → pass through
+ */
+function normalizeDate(raw, year) {
+    if (!raw)
+        return '';
+    const trimmed = raw.trim();
+    // Already ISO format
+    if (/^\d{4}-\d{2}-\d{2}$/.test(trimmed))
+        return trimmed;
+    // M/D/YYYY or M/D/YY
+    const fullMatch = trimmed.match(/^(\d{1,2})\/(\d{1,2})\/(\d{2,4})$/);
+    if (fullMatch) {
+        const month = fullMatch[1].padStart(2, '0');
+        const day = fullMatch[2].padStart(2, '0');
+        let yr = fullMatch[3];
+        if (yr.length === 2)
+            yr = `20${yr}`;
+        return `${yr}-${month}-${day}`;
+    }
+    // M/D (no year — state-level files)
+    const shortMatch = trimmed.match(/^(\d{1,2})\/(\d{1,2})$/);
+    if (shortMatch) {
+        const month = shortMatch[1].padStart(2, '0');
+        const day = shortMatch[2].padStart(2, '0');
+        return `${year}-${month}-${day}`;
+    }
+    // Fallback: return as-is
+    return trimmed;
+}
+/**
+ * Parse an xlsx buffer into an array of SosFiledCandidate.
+ *
+ * @param buffer - Raw xlsx file contents
+ * @param officeCategory - Category name (e.g., "Governor", "TN Senate")
+ * @param year - Election cycle year (used to infer year for date-only strings)
+ */
+export function parseXlsx(buffer, officeCategory, year) {
+    const wb = XLSX.read(buffer, { type: 'array' });
+    const sheetName = wb.SheetNames[0];
+    if (!sheetName)
+        return [];
+    const sheet = wb.Sheets[sheetName];
+    if (!sheet)
+        return [];
+    // Read as array of arrays to handle header normalization ourselves
+    const rows = XLSX.utils.sheet_to_json(sheet, { header: 1, defval: '' });
+    if (rows.length < 2)
+        return []; // Need at least header + 1 data row
+    // Map header row to our field names
+    const headerRow = rows[0];
+    const columnMap = headerRow.map(h => {
+        const trimmed = String(h).trim();
+        return HEADER_MAP[trimmed] || null;
+    });
+    const candidates = [];
+    for (let i = 1; i < rows.length; i++) {
+        const row = rows[i];
+        // Skip empty rows
+        const hasData = row.some(cell => String(cell).trim() !== '');
+        if (!hasData)
+            continue;
+        const candidate = { officeCategory };
+        for (let col = 0; col < columnMap.length; col++) {
+            const field = columnMap[col];
+            if (!field)
+                continue;
+            let value = String(row[col] ?? '').trim();
+            if (field === 'filingDate') {
+                value = normalizeDate(value, year);
+            }
+            ;
+            candidate[field] = value;
+        }
+        // Only add if we have at least a candidate name
+        if (candidate.candidateName) {
+            candidates.push({
+                office: candidate.office || '',
+                candidateName: candidate.candidateName,
+                party: candidate.party || '',
+                city: candidate.city || '',
+                filingDate: candidate.filingDate || '',
+                status: candidate.status || '',
+                officeCategory,
+            });
+        }
+    }
+    return candidates;
+}
+//# sourceMappingURL=sos-xlsx.js.map

package/dist/parsers/sos-xlsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sos-xlsx.js","sourceRoot":"","sources":["../../src/parsers/sos-xlsx.ts"],"names":[],"mappings":"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"}

package/dist/parsers/sos-xlsx.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/sos-xlsx.test.js

@@ -0,0 +1,111 @@
+import { describe, it, expect } from 'vitest';
+import * as XLSX from 'xlsx';
+import { parseCandidateListPage, parseXlsx } from './sos-xlsx.js';
+// ============================================================
+// HTML page parsing tests
+// ============================================================
+const CANDIDATE_LIST_HTML = `
+<html>
+<body>
+<div class="paragraph paragraph--type--additional-information">
+<div class="field field--name-field-info-text">
+<ul>
+<li>Governor: <a href="https://sos-prod.tnsosgovfiles.com/s3fs-public/document/Governor_Filed_2026-03-24.pdf">PDF</a> | <a href="https://sos-prod.tnsosgovfiles.com/s3fs-public/document/Governor_Filed_2026-03-24.xlsx">Excel</a></li>
+<li>U.S. Senate: <a href="https://sos-prod.tnsosgovfiles.com/s3fs-public/document/USSenate_Filed_2026-03-24.pdf">PDF</a> | <a href="https://sos-prod.tnsosgovfiles.com/s3fs-public/document/USSenate_Filed_2026-03-24.xlsx">Excel</a></li>
+<li>TN Senate: <a href="https://sos-prod.tnsosgovfiles.com/s3fs-public/document/TNSenate_Filed_2026-03-24.pdf">PDF</a> | <a href="https://sos-prod.tnsosgovfiles.com/s3fs-public/document/TNSenate_Filed_2026-03-24.xlsx">Excel</a></li>
+</ul>
+</div>
+</div>
+</body>
+</html>
+`;
+describe('parseCandidateListPage', () => {
+    it('extracts office names and xlsx/pdf URLs', () => {
+        const offices = parseCandidateListPage(CANDIDATE_LIST_HTML);
+        expect(offices).toHaveLength(3);
+        expect(offices[0].name).toBe('Governor');
+        expect(offices[0].xlsxUrl).toContain('Governor_Filed_2026-03-24.xlsx');
+        expect(offices[0].pdfUrl).toContain('Governor_Filed_2026-03-24.pdf');
+        expect(offices[1].name).toBe('U.S. Senate');
+        expect(offices[2].name).toBe('TN Senate');
+    });
+    it('skips list items without xlsx links', () => {
+        const html = '<ul><li>No files here</li><li>Also nothing: <a href="page.html">Link</a></li></ul>';
+        expect(parseCandidateListPage(html)).toHaveLength(0);
+    });
+    it('returns empty for no list items', () => {
+        expect(parseCandidateListPage('<html></html>')).toHaveLength(0);
+    });
+});
+// ============================================================
+// XLSX parsing tests
+// ============================================================
+/** Helper: create an xlsx ArrayBuffer from headers + rows */
+function createXlsx(headers, rows) {
+    const aoa = [headers, ...rows];
+    const ws = XLSX.utils.aoa_to_sheet(aoa);
+    const wb = XLSX.utils.book_new();
+    XLSX.utils.book_append_sheet(wb, ws, 'Sheet1');
+    const out = XLSX.write(wb, { type: 'array', bookType: 'xlsx' });
+    return out;
+}
+describe('parseXlsx', () => {
+    it('parses federal-style headers (Party Name, Filing Date)', () => {
+        const buffer = createXlsx(['Office', 'Candidate', 'Party Name', 'City', 'Filing Date', 'Status'], [
+            ['Governor', 'DOE, JANE', 'Republican', 'Nashville', '3/6/2026', 'Signatures Approved'],
+            ['Governor', 'SMITH, JOHN', 'Democratic', 'Memphis', '3/10/2026', 'Signatures Approved'],
+        ]);
+        const candidates = parseXlsx(buffer, 'Governor', 2026);
+        expect(candidates).toHaveLength(2);
+        expect(candidates[0].candidateName).toBe('DOE, JANE');
+        expect(candidates[0].party).toBe('Republican');
+        expect(candidates[0].city).toBe('Nashville');
+        expect(candidates[0].filingDate).toBe('2026-03-06');
+        expect(candidates[0].status).toBe('Signatures Approved');
+        expect(candidates[0].officeCategory).toBe('Governor');
+    });
+    it('parses state-style headers (Party, Filed) with year-less dates', () => {
+        const buffer = createXlsx(['Office', 'Candidate', 'Party', 'City', 'Filed', 'Status'], [
+            ['State Senate District 5', 'POWERS, BILL', 'Republican', 'Knoxville', '1/1', 'Signatures Approved'],
+            ['State Senate District 5', 'JONES, MARY', 'Democratic', 'Chattanooga', '4/4', 'Signatures Approved'],
+        ]);
+        const candidates = parseXlsx(buffer, 'TN Senate', 2026);
+        expect(candidates).toHaveLength(2);
+        expect(candidates[0].candidateName).toBe('POWERS, BILL');
+        expect(candidates[0].filingDate).toBe('2026-01-01');
+        expect(candidates[0].officeCategory).toBe('TN Senate');
+        expect(candidates[1].filingDate).toBe('2026-04-04');
+    });
+    it('normalizes full dates to YYYY-MM-DD', () => {
+        const buffer = createXlsx(['Office', 'Candidate', 'Party Name', 'City', 'Filing Date', 'Status'], [['US House District 1', 'TEST, CANDIDATE', 'Independent', 'Bristol', '3/6/2026', 'Signatures Approved']]);
+        const candidates = parseXlsx(buffer, 'US House', 2026);
+        expect(candidates[0].filingDate).toBe('2026-03-06');
+    });
+    it('handles two-digit year dates', () => {
+        const buffer = createXlsx(['Office', 'Candidate', 'Party', 'City', 'Filed', 'Status'], [['Governor', 'TEST, NAME', 'Republican', 'Nashville', '3/6/26', 'Signatures Approved']]);
+        const candidates = parseXlsx(buffer, 'Governor', 2026);
+        expect(candidates[0].filingDate).toBe('2026-03-06');
+    });
+    it('skips empty rows', () => {
+        const buffer = createXlsx(['Office', 'Candidate', 'Party', 'City', 'Filed', 'Status'], [
+            ['Governor', 'DOE, JANE', 'Republican', 'Nashville', '3/6', 'Signatures Approved'],
+            ['', '', '', '', '', ''],
+            ['Governor', 'SMITH, JOHN', 'Democratic', 'Memphis', '3/10', 'Signatures Approved'],
+        ]);
+        const candidates = parseXlsx(buffer, 'Governor', 2026);
+        expect(candidates).toHaveLength(2);
+    });
+    it('returns empty for header-only sheet', () => {
+        const buffer = createXlsx(['Office', 'Candidate', 'Party', 'City', 'Filed', 'Status'], []);
+        const candidates = parseXlsx(buffer, 'Governor', 2026);
+        expect(candidates).toHaveLength(0);
+    });
+    it('returns empty for empty workbook', () => {
+        const wb = XLSX.utils.book_new();
+        XLSX.utils.book_append_sheet(wb, XLSX.utils.aoa_to_sheet([]), 'Sheet1');
+        const buffer = XLSX.write(wb, { type: 'array', bookType: 'xlsx' });
+        const candidates = parseXlsx(buffer, 'Governor', 2026);
+        expect(candidates).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=sos-xlsx.test.js.map

package/dist/parsers/sos-xlsx.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sos-xlsx.test.js","sourceRoot":"","sources":["../../src/parsers/sos-xlsx.test.ts"],"names":[],"mappings":"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"}

package/dist/parsers/sumner-html.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sumner County financial disclosure page parser.
+ *
+ * Parses votesumnertn.org disclosure pages where candidate/office info
+ * is encoded in inline style colors (not semantic HTML classes).
+ */
+import type { SumnerCyclePage, SumnerElectionCycle } from '../types.js';
+export declare function parseSumnerCyclePage(html: string, cycle: SumnerElectionCycle): SumnerCyclePage;

package/dist/parsers/sumner-html.js

@@ -0,0 +1,200 @@
+/**
+ * Sumner County financial disclosure page parser.
+ *
+ * Parses votesumnertn.org disclosure pages where candidate/office info
+ * is encoded in inline style colors (not semantic HTML classes).
+ */
+import { parse } from 'node-html-parser';
+const BASE_URL = 'https://www.votesumnertn.org';
+/** Match office header background color (rgb or hex variants) */
+function isOfficeHeader(style) {
+    return (style.includes('background-color') || style.includes('background:')) &&
+        (style.includes('71, 85, 119') || style.includes('71,85,119') ||
+            style.includes('#475577') || style.includes('#47557'));
+}
+/** Match candidate/district text color (without background) */
+function isCandidateColor(style) {
+    if (style.includes('background'))
+        return false;
+    return style.includes('71, 85, 119') || style.includes('71,85,119') ||
+        style.includes('#475577') || style.includes('#47557');
+}
+/** Match municipal header color */
+function isMunicipalColor(style) {
+    return (style.includes('41, 105, 176') || style.includes('41,105,176') ||
+        style.includes('#2969b0') || style.includes('#2969B0'));
+}
+/** Check if text looks like a district identifier rather than a name */
+function isDistrictText(text) {
+    return /^(district|zone|seat|ward)\s+\d/i.test(text.trim());
+}
+/** Check if text is a section header or office title rather than a candidate name */
+function isSectionOrOfficeTitle(text) {
+    const lower = text.toLowerCase().trim();
+    return lower === 'municipal offices' ||
+        lower === 'county offices' ||
+        lower === 'school districts' ||
+        lower === 'state offices' ||
+        lower === 'mayor' ||
+        lower === 'alderman' ||
+        lower === 'aldermen' ||
+        lower === 'vice mayor' ||
+        lower === 'city council' ||
+        lower === 'city judge' ||
+        lower === 'city recorder' ||
+        lower === 'non-disclosure' ||
+        lower === 'statements of non-disclosure' ||
+        /^(register|clerk|trustee|sheriff|assessor|superintendent)\s*$/i.test(lower);
+}
+export function parseSumnerCyclePage(html, cycle) {
+    const root = parse(html);
+    const candidates = [];
+    const nonDisclosures = [];
+    // Find the content area
+    const contentArea = root.querySelector('.fr-view') ||
+        root.querySelector('.ContentPadding') ||
+        root.querySelector('.entry-content') ||
+        root;
+    // The page content is one big blob of inline-styled spans, strongs, and links.
+    // We need to walk through the raw HTML and track state as we encounter markers.
+    const contentHtml = contentArea.innerHTML;
+    // Strategy: split on <br> and block-level tags to get "lines", then classify each
+    // This is more robust than walking the DOM because the markup is flat (not nested hierarchically).
+    // Extract all meaningful elements in order using regex on the raw HTML
+    const elements = [];
+    // Office headers: span with background-color
+    const officePattern = /<span[^>]*style="[^"]*background-color[^"]*"[^>]*>(.*?)<\/span>/gi;
+    // Candidate names: strong > span OR span > strong with color (no background)
+    // Both patterns exist: <strong><span style="color:...">Name</span></strong>
+    //                  and: <span style="color:..."><strong>Name</strong></span>
+    const candidatePattern = /(?:<strong[^>]*>\s*<span[^>]*style="[^"]*color[^"]*"[^>]*>(.*?)<\/span>\s*<\/strong>|<span[^>]*style="[^"]*color:\s*rgb\(71,?\s*85,?\s*119\)[^"]*"[^>]*>\s*<strong[^>]*>(.*?)<\/strong>\s*<\/span>)/gi;
+    // Municipal headers: span with blue color inside strong
+    const municipalPattern = /<span[^>]*style="[^"]*color:\s*rgb\(41,?\s*105,?\s*176\)[^"]*"[^>]*>\s*<strong[^>]*>(.*?)<\/strong>\s*<\/span>/gi;
+    // Also catch strong > span variant for municipal
+    const municipal2Pattern = /<strong[^>]*>\s*<span[^>]*style="[^"]*color:\s*rgb\(41,?\s*105,?\s*176\)[^"]*"[^>]*>(.*?)<\/span>\s*<\/strong>/gi;
+    // PDF links
+    const linkPattern = /<a[^>]*class="fr-file"[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi;
+    // Build a position-ordered list of all elements
+    const allMatches = [];
+    let m;
+    while ((m = officePattern.exec(contentHtml)) !== null) {
+        const text = m[1].replace(/<[^>]+>/g, '').trim();
+        if (text)
+            allMatches.push({ pos: m.index, type: 'office', text });
+    }
+    while ((m = municipalPattern.exec(contentHtml)) !== null) {
+        const text = m[1].replace(/<[^>]+>/g, '').trim();
+        if (text)
+            allMatches.push({ pos: m.index, type: 'municipal', text });
+    }
+    while ((m = municipal2Pattern.exec(contentHtml)) !== null) {
+        const text = m[1].replace(/<[^>]+>/g, '').trim();
+        if (text && !allMatches.some(x => x.type === 'municipal' && x.text === text)) {
+            allMatches.push({ pos: m.index, type: 'municipal', text });
+        }
+    }
+    while ((m = candidatePattern.exec(contentHtml)) !== null) {
+        // Two capture groups: m[1] from strong>span pattern, m[2] from span>strong pattern
+        const text = (m[1] || m[2] || '').replace(/<[^>]+>/g, '').trim();
+        if (text) {
+            // Skip if this was already matched as an office header (overlapping regex)
+            const isOffice = allMatches.some(x => x.type === 'office' && Math.abs(x.pos - m.index) < 20);
+            if (!isOffice) {
+                allMatches.push({ pos: m.index, type: 'candidate', text });
+            }
+        }
+    }
+    while ((m = linkPattern.exec(contentHtml)) !== null) {
+        const href = m[1];
+        const text = m[2].replace(/<[^>]+>/g, '').trim();
+        if (href && text) {
+            const pdfUrl = href.startsWith('http') ? href : `${BASE_URL}${href}`;
+            allMatches.push({ pos: m.index, type: 'link', text, href: pdfUrl });
+        }
+    }
+    // Sort by position in the HTML
+    allMatches.sort((a, b) => a.pos - b.pos);
+    // Walk through matches and build the candidate list
+    let currentMunicipality = undefined;
+    let currentOffice = undefined;
+    let currentDistrict = undefined;
+    let isMunicipal = false;
+    let inNonDisclosure = false;
+    for (const match of allMatches) {
+        if (match.type === 'municipal') {
+            currentMunicipality = match.text;
+            isMunicipal = true;
+            inNonDisclosure = false;
+            continue;
+        }
+        if (match.type === 'office') {
+            // Check for non-disclosure section
+            if (match.text.toLowerCase().includes('non-disclosure') ||
+                match.text.toLowerCase().includes('non disclosure')) {
+                inNonDisclosure = true;
+                continue;
+            }
+            inNonDisclosure = false;
+            currentOffice = match.text;
+            currentDistrict = undefined;
+            // Extract district from office text if present
+            const distMatch = match.text.match(/(district|zone|seat|ward)\s+\d+/i);
+            if (distMatch) {
+                currentDistrict = distMatch[0];
+                currentOffice = match.text.replace(distMatch[0], '').replace(/[-–—,]\s*$/, '').trim();
+                if (!currentOffice)
+                    currentOffice = match.text;
+            }
+            continue;
+        }
+        if (match.type === 'candidate') {
+            // Check if this is a district identifier, not a candidate name
+            if (isDistrictText(match.text)) {
+                currentDistrict = match.text;
+                continue;
+            }
+            // Check if this is a section header or office title (Mayor, Alderman, etc.)
+            if (isSectionOrOfficeTitle(match.text)) {
+                // Treat as a sub-office within a municipal section
+                if (isMunicipal) {
+                    currentOffice = match.text.toUpperCase();
+                }
+                continue;
+            }
+            if (inNonDisclosure) {
+                nonDisclosures.push({ name: match.text, cycle: cycle.year });
+            }
+            else if (currentOffice) {
+                candidates.push({
+                    name: match.text,
+                    office: {
+                        name: currentOffice,
+                        district: currentDistrict,
+                        isMunicipal,
+                        municipality: isMunicipal ? currentMunicipality : undefined,
+                    },
+                    reports: [],
+                    cycle: cycle.year,
+                });
+            }
+            continue;
+        }
+        if (match.type === 'link') {
+            // Attach to most recent candidate
+            if (candidates.length > 0) {
+                candidates[candidates.length - 1].reports.push({
+                    reportName: match.text,
+                    pdfUrl: match.href,
+                });
+            }
+            continue;
+        }
+    }
+    return {
+        cycle,
+        candidates,
+        nonDisclosures,
+        scrapedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=sumner-html.js.map