From 0348b2933073b8e8940640dede8b4119a9dee130 Mon Sep 17 00:00:00 2001 From: Nathan Date: Thu, 4 Jun 2026 07:01:07 -0400 Subject: [PATCH 1/8] initial plan --- .gitignore | 7 + docs/lobbying-disclosure-ingestion.md | 363 ++++++++++++++++++++++++++ 2 files changed, 370 insertions(+) create mode 100644 docs/lobbying-disclosure-ingestion.md diff --git a/.gitignore b/.gitignore index 571150641..7301e0ec2 100644 --- a/.gitignore +++ b/.gitignore @@ -92,3 +92,10 @@ cert.txt # local MCP server config (contains auth tokens) .mcp.json mcp-server/create-agent-key.ts + +# Claude +CLAUDE.md + +#gcloud +.gcloudignore + diff --git a/docs/lobbying-disclosure-ingestion.md b/docs/lobbying-disclosure-ingestion.md new file mode 100644 index 000000000..646cc4415 --- /dev/null +++ b/docs/lobbying-disclosure-ingestion.md @@ -0,0 +1,363 @@ +# Lobbying Disclosure Ingestion Pipeline + +## Overview + +The MA Secretary of State lobbying portal +([sec.state.ma.us/LobbyistPublicSearch](https://www.sec.state.ma.us/LobbyistPublicSearch/)) +publishes semi-annual disclosure filings for all registered lobbyists and +lobbying entities. This document describes the plan for scraping that data and +storing it in Firestore in a way that allows joining to MAPLE bill data. + +The portal has three levels of pages: + +1. **Search page** → one row per registrant per year +2. **Summary page** → registrant metadata + links to semi-annual disclosure + filings +3. **CompleteDisclosure page** → per-client compensation table + per-client bill + activity tables + +Historical data goes back to 2005. MAPLE has bill data only from ~2020 onward, +so bill joins will only resolve for filings from the 192nd General Court (2021) +and later. All historical filings are ingested regardless. + +--- + +## Terminology + +The portal has two registrant types: + +- **Lobbyist** — an individual person who lobbies directly on behalf of clients. +- **Employer** — a lobbying firm that employs individual lobbyists and is + retained by clients. Called "Lobbyist Entity" on the portal. + +In both cases, the registrant reports compensation received from each **client** +(the organization that hired them) and which bills they lobbied for that client. + +--- + +## Firestore Data Model + +Two top-level collections, normalized by registrant and by lobbying activity +record. + +### `/lobbyingRegistrants/{registrantId}` + +`registrantId` is a slugified `{entityName}_{year}` (stable, dedup-safe). + +One model covers both individual lobbyists and lobbying firms. A separate model +is not needed because the portal search returns both under the same schema, and +per-filing detail pages do not expose which individual lobbyists within a firm +worked on which bill. + +```typescript +interface LobbyingRegistrant { + registrantId: string // "{entityName}_{year}" slugified + entityName: string // firm name or individual lobbyist name (raw portal value) + entityNameNorm: string // normalized form; see Normalization section + year: number + generalCourt: number // computed from year + regType: "Lobbyist" | "Employer" + clients: LobbyingClient[] + disclosureUrls: string[] // source portal URLs, for audit trail + fetchedAt: Timestamp +} + +interface LobbyingClient { + clientName: string + clientNameNorm: string // normalized form + compensation: number | null +} +``` + +### `/lobbyingFilings/{filingId}` + +`filingId` is a slugified +`{entityName}_{clientName}_{chamber}_{activityRef}_{generalCourt}`. + +```typescript +type LobbyingChamber = + | "House Bill" + | "Senate Bill" + | "House Docket" + | "Senate Docket" + | "Executive" // lobbying of executive branch agencies + | "Other" // catch-all for rare legacy codes (FY, CMR, etc.) + +interface LobbyingFiling { + filingId: string + entityName: string // raw portal value + entityNameNorm: string // normalized form + clientName: string // raw portal value; "_total_salary_" sentinel for pre-2013 + clientNameNorm: string // normalized form + year: number + generalCourt: number + chamber: LobbyingChamber + // For legislative chambers: the bill number string (e.g. "H1234", "HD56"). + // For Executive: the agency name. Not a bill reference. + billId: string | null + activityTitle: string // bill title (legislative) or meeting description (executive) + position: string // "Support" | "Oppose" | "Neutral" | etc.; empty for executive + amount: number | null // compensation allocated to this activity + fetchedAt: Timestamp +} +``` + +### Constructing `billId` from Raw Portal Data + +The portal stores bill numbers as bare integers and records the chamber +separately. The `billId` field — which maps to `Bill.id` in MAPLE — is +constructed during ingest by combining chamber prefix and integer: + +| `chamber` | Prefix | Example raw | `billId` | +| --------------- | ------ | ----------- | -------- | +| `House Bill` | `H` | `1234` | `H1234` | +| `Senate Bill` | `S` | `1234` | `S1234` | +| `House Docket` | `HD` | `56` | `HD56` | +| `Senate Docket` | `SD` | `56` | `SD56` | +| `Executive` | — | agency name | `null` | +| `Other` | — | varies | `null` | + +Note: `H1234` and `S1234` are distinct bills even though they share the same +integer. The prefix is required to disambiguate. `billId` is `null` for +non-legislative chambers. + +#### Legacy chamber code normalization + +The portal uses short-form codes in older filings, normalized during ingest: + +| Raw value | Stored as | +| --------- | ------------- | +| `HB` | `House Bill` | +| `SB` | `Senate Bill` | + +Rare codes (`FY`, `C`, `CMR`, `HR`, etc.) are stored as `Other`. + +### Joining to Bill Data + +**The join only applies to legislative chambers** (`House Bill`, `Senate Bill`, +`House Docket`, `Senate Docket`) where `billId` is non-null. For `Executive` +and `Other`, no join should be attempted. + +```typescript +// Only valid when filing.billId !== null +db.collection(`/generalCourts/${filing.generalCourt}/bills`).doc(filing.billId) +``` + +--- + +## Entity Name Normalization + +The portal does not enforce consistent name formatting. The same client or +registrant may appear as "Acme Corp.", "ACME CORPORATION", "Acme, Inc. d/b/a +Acme Consulting", etc. across filings and years. Without normalization, +grouping by entity is unreliable. + +Both `entityName` and `clientName` are normalized using the following pipeline, +applied in order. The raw portal value is always preserved alongside the +normalized form. + +### Normalization pipeline + +1. **Uppercase** — convert the entire string to upper case. +2. **Strip d/b/a suffix** — remove everything from the first occurrence of + `D/B/A`, `D/B/A`, `DBA` (and spacing variants) onward, so the registered + name is used rather than a trade name. +3. **Hyphen → space** — replace `-` with ` ` so `LAN-TEL` and `LAN TEL` + collapse to the same key. +4. **Punctuation → space** — replace `,`, `.`, `'`, `'`, `'`, `(`, `)` with + space. Replacement with space (not empty string) prevents adjacent tokens + from concatenating (e.g. `,INC` becomes ` INC`, which is then caught by step + 5). +5. **Remove legal entity type words** — whole-word removal of: `LLC`, `LLP`, + `INC`, `INCORPORATED`, `CORPORATION`, `CORP`, `LTD`, `LIMITED`, `PC`, + `PLLC`. +6. **Remove "THE"** — whole-word removal anywhere in the string (not just as a + leading prefix). +7. **Ampersand → AND** — replace `&` with `AND`. +8. **Fix known typo** — replace `ASSICIATES` with `ASSOCIATES` (legacy portal + data). +9. **Remove professional suffix phrases** — whole-phrase removal of: `LAW +OFFICE OF`, `AND ASSOCIATES`, `& ASSOCIATES`, `AND ASSOC`, `ATTORNEY AT +LAW`, `ATTORNEY@LAW`, `ATTORNET AT LAW`, `AND PARTNERS`, `PUBLIC POLICY +GROUP`, `LEGISLATIVE SERVICES`, `POLICY GROUP`, `ASSOCIATES`, `COUNSELLORS +AT LAW`. +10. **Collapse whitespace** — replace runs of whitespace with a single space and + strip leading/trailing whitespace. + +### Usage + +`entityNameNorm` and `clientNameNorm` are stored on every document and filing. +They should be used for grouping, deduplication, and display-level matching. +Raw names are preserved for provenance and audit. + +--- + +## Deduplication and Amount Aggregation + +### Does lobbying the same bill multiple times mean we should sum amounts? + +The portal collects two semi-annual disclosure filings per registrant per year +(one for each 6-month period). In theory, a registrant could report the same +bill in both H1 and H2 filings with separate compensation amounts that should +be summed. Analysis of the actual data shows this does not occur: after +processing, zero rows share the same `(entityName, clientName, year, +generalCourt, billId, position)` — each (registrant, client, bill, year) +combination appears exactly once. The semi-annual periods report different +activity, not the same activity twice. + +The same registrant can lobby the same bill across multiple General Courts +(observed up to 6 times across years). These are stored as separate documents +per `generalCourt` and should not be summed — each court is a distinct +legislative session. + +### Null-bill row deduplication + +The one real duplication artifact in the portal data is **null-bill rows** — +entries filed when a registrant had no specific bills to report for a client in +a period. These appear in both the H1 and H2 disclosures as identical rows and +should be collapsed. During ingest, if the same `(entityName, clientName, year, +generalCourt, chamber, position)` with a null `billId` is encountered more than +once, keep the row with the highest `amount` so no spend is lost if the two +copies carry different values (in practice amounts are usually both zero). + +### Ingest strategy + +When processing multiple disclosure URLs for the same registrant+year, write +`lobbyingFilings` documents using the logical key as the document ID. A +subsequent disclosure URL that produces the same document ID will naturally +upsert (overwrite) rather than duplicate. For null-bill rows, since `billId` is +null, include `chamber` in the document ID to avoid false merges between +executive and legislative null rows. + +--- + +## Scraper Architecture + +The lobbying portal is an HTML scraper, not a REST API. It does not fit the +`createScraper` factory (which assumes list-IDs → fetch-per-ID against the MA +Legislature API). Instead, we use a custom scheduled function following the +`scrapeEvents` pattern. + +### Cloud Function: `scrapeLobbying` + +**File:** `functions/src/lobbying/scrapeLobbying.ts` + +- Schedule: `every 24 hours` +- Scrapes the current year and prior year (new filers arrive semi-annually) +- Persists a cursor in `/scrapers/lobbying`: + - `lastFetchedAt: Timestamp` + - `processedDiscUrls: string[]` — already-fetched disclosure URLs (skipped on + re-runs) +- For each new disclosure URL: + - Parse registrant + client compensation rows → upsert `lobbyingRegistrants` + doc + - Parse bill activity rows → batch-write `lobbyingFilings` docs +- Uses `axios` (existing dependency) with an iPad `User-Agent` header to match + portal expectations +- Uses `jsdom` for HTML table parsing (already a dependency; used by events scraper) +- 1s delay between requests; exponential backoff on failure (matching existing + scraper retry pattern) +- Function timeout: 540s + +### Incremental Strategy + +Processed disclosure URLs are stored in `/scrapers/lobbying.processedDiscUrls`. +At ~2 disclosure URLs per registrant × ~500 registrants per year, the +current+prior year window stays well within Firestore document limits. +Historical years beyond current-1 are stable (filings are frozen after year +closes) and are handled by the backfill script only. + +The backfill script uses a separate Firestore document +(`/scrapers/lobbyingBackfill`) for its own cursor so it does not interfere with +the live scraper. + +### Legacy Format (pre-2013) + +The portal uses a different HTML layout for filings before ~2013: total salary +is not broken down by client, and all bill activity is in a single table. These +are stored with `clientName: "_total_salary_"` so callers can detect and filter +them. No bill-level compensation amount is available for these years. + +--- + +## New Files + +``` +functions/src/lobbying/ + types.ts — Runtypes definitions for LobbyingRegistrant, LobbyingFiling + scrapeLobbying.ts — Scheduled Cloud Function + shared parsing/normalization logic + index.ts — Re-exports +``` + +--- + +## Firebase Admin Script + +**File:** `scripts/firebase-admin/backfillLobbying.ts` + +Ingests all historical filings from 2005 to the present. This is the primary +path for all data before the current and prior year. Accepts `--year` and +`--limit` CLI args for targeted re-runs or testing. Calls the same parsing +logic exported from `functions/src/lobbying/scrapeLobbying.ts` and writes +directly to Firestore via the firebase-admin SDK. + +```bash +GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + yarn firebase-admin run-script backfillLobbying --env dev +``` + +--- + +## Firestore Rules + +Add read-only public rules alongside the existing `generalCourts` rule: + +``` +match /lobbyingRegistrants/{doc} { allow read: if true; } +match /lobbyingFilings/{doc} { allow read: if true; } +``` + +--- + +## Firestore Indexes + +Add composite indexes for common query patterns: + +| Collection | Fields | Use case | +| ----------------- | -------------------------------------- | ---------------------------------------- | +| `lobbyingFilings` | `generalCourt ASC, billId ASC` | Fetch all legislative filings for a bill | +| `lobbyingFilings` | `generalCourt ASC, chamber ASC` | Filter by chamber within a court | +| `lobbyingFilings` | `generalCourt ASC, entityNameNorm ASC` | Fetch all filings for a registrant | +| `lobbyingFilings` | `generalCourt ASC, clientNameNorm ASC` | Fetch all filings for a client | + +Note: bill-join queries should always filter on `chamber` (or check +`billId !== null`) to exclude `Executive` and `Other` rows before treating +`billId` as a MAPLE bill reference. + +--- + +## Function Export + +Add to `functions/src/index.ts`: + +```typescript +export { scrapeLobbying } from "./lobbying" +``` + +--- + +## Design Decisions + +| Decision | Choice | Rationale | +| --------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Collection placement | Top-level `/lobbyingRegistrants`, `/lobbyingFilings` | Lobbying data spans multiple General Courts and is not scoped to a single court like bills/members | +| Single registrant model | One type, `regType: "Lobbyist" \| "Employer"` | Individual lobbyists and firms share the same portal schema; per-bill individual attribution is not available | +| `billId` construction | `{chamberPrefix}{billNumber}` at ingest time | Raw portal data stores chamber and integer separately; the composite is what matches MAPLE's `Bill.id` | +| `billId` null for Executive | `null` instead of agency name | Prevents accidental bill lookups; makes join guard explicit at the type level | +| Normalized name fields | Store both raw and `*Norm` fields | Raw names preserved for provenance; normalized names used for grouping and matching | +| HTML parser | `jsdom` | Already in `functions/package.json` (used by events scraper); no need to add cheerio | +| Live scraper cursor | Array in `/scrapers/lobbying` doc | ~1,000 URLs/year fits well within the 1 MB Firestore doc limit; simple and atomic with other scraper state | +| Backfill cursor | Firestore subcollection `/scrapers/lobbyingBackfill/processedUrls/{urlHash}` | Full 2005-present history (~50,000 URLs) would exceed the 1 MB doc limit; subcollection scales without bound and is durable, inspectable, and resumable from any machine | +| Incremental strategy | Skip already-processed disclosure URLs; write docs by logical key (upsert) | Survives function restarts and re-runs without re-fetching already-scraped pages; natural upsert prevents duplicates without an explicit dedup pass | +| Legacy format (pre-2013) | Store with `clientName: "_total_salary_"` sentinel | Preserves data completeness; callers can filter on this value | +| Historical data | Admin backfill script (2005 → present) | Full history is ingested once; Cloud Function maintains current+prior year going forward | From 774568e3371a20e09abf58a3a87ff8d588052b61 Mon Sep 17 00:00:00 2001 From: Nathan Date: Thu, 4 Jun 2026 08:38:21 -0400 Subject: [PATCH 2/8] feat: add lobbying disclosure ingestion pipeline MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Scrapes the MA Secretary of State lobbying portal (sec.state.ma.us/LobbyistPublicSearch) and writes structured data to Firestore for joining with MAPLE bill data. New collections: - /lobbyingRegistrants — one doc per (registrant, year), regType Lobbyist|Employer - /lobbyingFilings — one doc per (registrant, client, bill, court), with billId null for Executive/Other chambers so the join guard is type-level Key design points: - billId is constructed as {chamberPrefix}{integer} (e.g. H1234, SD56) to match Bill.id in the existing bills collection; raw integer + chamber stored separately - Entity name normalization pipeline ported from reference implementation (10 steps: d/b/a stripping, legal entity words, punctuation, THE, ampersand, typo fix, etc.) - Both raw and *Norm name fields stored for provenance and grouping - Live Cloud Function scrapes current+prior year on a 24h schedule with a summaryDiscCache to avoid re-fetching summary pages in steady state - Backfill admin script handles full 2005-present history with a Firestore subcollection cursor (/scrapers/lobbyingBackfill/processedUrls) that scales to ~50k URLs and is safely resumable Files: - functions/src/lobbying/{types,normalize,portal,scrapeLobbying,index}.ts - scripts/firebase-admin/backfillLobbying.ts - firestore.rules + firestore.indexes.json updated - docs/lobbying-disclosure-ingestion.md: full plan, test plan, future work Co-Authored-By: Claude Sonnet 4.6 --- docs/lobbying-disclosure-ingestion.md | 240 ++++++++++ firestore.indexes.json | 91 +++- firestore.rules | 8 + functions/src/index.ts | 2 + functions/src/lobbying/index.ts | 12 + functions/src/lobbying/normalize.ts | 73 +++ functions/src/lobbying/portal.ts | 491 +++++++++++++++++++++ functions/src/lobbying/scrapeLobbying.ts | 274 ++++++++++++ functions/src/lobbying/types.ts | 101 +++++ scripts/firebase-admin/backfillLobbying.ts | 156 +++++++ 10 files changed, 1441 insertions(+), 7 deletions(-) create mode 100644 functions/src/lobbying/index.ts create mode 100644 functions/src/lobbying/normalize.ts create mode 100644 functions/src/lobbying/portal.ts create mode 100644 functions/src/lobbying/scrapeLobbying.ts create mode 100644 functions/src/lobbying/types.ts create mode 100644 scripts/firebase-admin/backfillLobbying.ts diff --git a/docs/lobbying-disclosure-ingestion.md b/docs/lobbying-disclosure-ingestion.md index 646cc4415..ad67fe397 100644 --- a/docs/lobbying-disclosure-ingestion.md +++ b/docs/lobbying-disclosure-ingestion.md @@ -346,6 +346,246 @@ export { scrapeLobbying } from "./lobbying" --- +## Implementation Status + +| File | Status | +| -------------------------------------------- | ------- | +| `functions/src/lobbying/types.ts` | ✅ Done | +| `functions/src/lobbying/normalize.ts` | ✅ Done | +| `functions/src/lobbying/portal.ts` | ✅ Done | +| `functions/src/lobbying/scrapeLobbying.ts` | ✅ Done | +| `functions/src/lobbying/index.ts` | ✅ Done | +| `scripts/firebase-admin/backfillLobbying.ts` | ✅ Done | +| `functions/src/index.ts` (export) | ✅ Done | +| `firestore.rules` | ✅ Done | +| `firestore.indexes.json` | ✅ Done | + +### Document ID scheme + +Both `registrantId` and `filingId` are SHA-256 hashes (first 40 hex chars) of +their respective logical keys. Hashes are used rather than slugified strings +because entity names and client names contain arbitrary Unicode and punctuation +that would require aggressive sanitization to fit Firestore ID constraints. The +hash is stable across runs for the same logical record. + +--- + +## Future Work (Subsequent PRs) + +### Frontend + +- **Dedicated lobbying pages** + + - `/lobbyists` index: searchable list of registrants with total compensation, + client count, and year filter + - `/lobbyists/{registrantId}` profile: full client list, all bills lobbied, + compensation over time + - `/clients/{clientNameNorm}` profile: registrants hired, bills lobbied, + total spend per year + +- **Bill page integration** (`/bills/{court}/{billId}`) + + - "Lobbying activity" section listing registrants + clients that lobbied this + bill, with position (Support / Oppose / Neutral) and compensation where + available + - Link to registrant profile pages + +- **Organization profile page integration** + - If an organization's normalized name matches a `clientNameNorm` in + `lobbyingFilings`, surface a "Lobbying history" panel showing which bills + they lobbied and which registrants they hired + +### MCP Tools + +Expose lobbying data via the MAPLE MCP server so that AI agents and Claude can +answer questions like "who lobbied bill H1234?" or "what did Acme Corp lobby +for in 2024?". + +- **`get_lobbying_filings_for_bill`** — given `generalCourt` + `billId`, return + all `lobbyingFilings` for that bill with registrant, client, position, and + amount +- **`get_lobbying_registrant`** — given `registrantId`, return the registrant + document with client list and disclosure URLs +- **`search_lobbying_by_client`** — given a client name (raw or normalized), + return matching filings across all courts +- **`get_lobbying_summary_for_bill`** — aggregate view: unique registrant count, + unique client count, total compensation (where non-null), position breakdown + +--- + +## Incremental Test Plan + +Testing proceeds from the inside out: unit logic first, then live portal +fetches against the real site, then a small Firestore write, then a full +backfill year, then steady-state function operation. + +### Step 1 — Unit test: normalization + +Run the normalization pipeline against known inputs and verify the outputs match +the reference implementation. + +```bash +# In a Node REPL or ts-node session: +conda run -n maple-2025 ts-node -P tsconfig.script.json -e " +const { normalizeEntityName } = require('./functions/src/lobbying/normalize') +console.log(normalizeEntityName('Acme Corp., Inc. d/b/a Acme Consulting')) +// Expected: 'ACME' +console.log(normalizeEntityName('LAN-TEL COMMUNICATIONS, INC.')) +// Expected: 'LAN TEL COMMUNICATIONS' +console.log(normalizeEntityName('Law Office of Jane Smith, LLC')) +// Expected: 'JANE SMITH' +" +``` + +### Step 2 — Unit test: chamber normalization and billId construction + +```bash +conda run -n maple-2025 ts-node -P tsconfig.script.json -e " +const { normalizeChamber, constructBillId } = require('./functions/src/lobbying/portal') +console.log(normalizeChamber('HB')) // House Bill +console.log(normalizeChamber('SB')) // Senate Bill +console.log(normalizeChamber('Executive')) // Executive +console.log(normalizeChamber('FY2024')) // Other +console.log(constructBillId('House Bill', '1234')) // H1234 +console.log(constructBillId('Senate Bill', '567')) // S567 +console.log(constructBillId('House Docket', '89')) // HD89 +console.log(constructBillId('Executive', 'EOEEA')) // null +" +``` + +### Step 3 — Live portal fetch: summary links + +Verify the portal is reachable and returns results for the current year. Use +`--limit 1` to minimize requests. + +```bash +conda run -n maple-2025 ts-node -P tsconfig.script.json -e " +const { makePortalClient, fetchSummaryLinks } = require('./functions/src/lobbying/portal') +const client = makePortalClient() +fetchSummaryLinks(client, 2024).then(urls => { + console.log('Summary links for 2024:', urls.length) + console.log('First URL:', urls[0]) +}).catch(console.error) +" +``` + +Expected: ~400–600 URLs, each containing `Summary.aspx`. + +### Step 4 — Live portal fetch: summary meta + one disclosure + +Pick the first summary URL from Step 3 and fetch its meta and first disclosure. + +```bash +conda run -n maple-2025 ts-node -P tsconfig.script.json -e " +const { makePortalClient, fetchSummaryLinks, fetchDisclosureMeta, fetchDisclosureDetail } = require('./functions/src/lobbying/portal') +async function main() { + const client = makePortalClient() + const [summaryUrl] = await fetchSummaryLinks(client, 2024) + const meta = await fetchDisclosureMeta(client, summaryUrl) + console.log('Meta:', JSON.stringify(meta, null, 2)) + if (meta.disclosureUrls[0]) { + const detail = await fetchDisclosureDetail(client, meta.disclosureUrls[0], 2024) + console.log('Compensation rows:', detail.compensation.length) + console.log('Bill rows:', detail.bills.length) + console.log('First bill:', detail.bills[0]) + } +} +main().catch(console.error) +" +``` + +Verify: `meta.entityName` is non-empty, `meta.regType` is `"Lobbyist"` or +`"Employer"`, bill rows have `billId` set correctly for legislative chambers. + +### Step 5 — Backfill: single year, small limit against dev Firestore + +Write a small batch to the dev Firestore emulator or dev project. + +```bash +# Against local emulator: +conda run -n maple-2025 yarn firebase-admin run-script backfillLobbying \ + --env local -- --year 2024 --limit 3 + +# Against dev project (writes real Firestore): +GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + conda run -n maple-2025 yarn firebase-admin run-script backfillLobbying \ + --env dev -- --year 2024 --limit 3 +``` + +Verify in Firestore console or emulator UI: + +- `lobbyingRegistrants` has 3 documents with `entityName`, `entityNameNorm`, + `regType`, `clients`, `generalCourt` +- `lobbyingFilings` has documents with `billId` non-null for legislative rows + and null for Executive rows +- `/scrapers/lobbyingBackfill/processedUrls` has entries with `url` and + `processedAt` fields +- Re-running the same command skips already-processed URLs (output shows 0 new + disclosures) + +### Step 6 — Spot-check: bill join + +Pick a `lobbyingFiling` document with a non-null `billId` and a `generalCourt` +≥ 192. Verify the bill exists in MAPLE: + +``` +/generalCourts/{filing.generalCourt}/bills/{filing.billId} +``` + +If the bill is found, the join key is correct. If not found, check: (a) whether +MAPLE has data for that court, (b) whether the bill number format matches +(prefix + integer, no leading zeros). + +### Step 7 — Backfill: full current year + +Once Step 5 passes, run without `--limit` for the current year: + +```bash +GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + conda run -n maple-2025 yarn firebase-admin run-script backfillLobbying \ + --env dev -- --year 2024 +``` + +Monitor progress via console output. Expected: ~500–600 registrants, ~1,000 +disclosure pages, several thousand filing documents written. + +### Step 8 — Backfill: full history (2005–present) + +Run without `--year` to process all years. Can be interrupted and resumed: + +```bash +GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + conda run -n maple-2025 yarn firebase-admin run-script backfillLobbying \ + --env dev +``` + +Expected runtime: several hours at 1s/request. The subcollection cursor at +`/scrapers/lobbyingBackfill/processedUrls` allows safe interruption and +resumption. + +### Step 9 — Deploy and verify Cloud Function + +Deploy the function to the dev project: + +```bash +conda run -n maple-2025 firebase deploy \ + --only functions:maple:scrapeLobbying \ + --project digital-testimony-dev +``` + +Trigger a manual run via the Firebase console or: + +```bash +conda run -n maple-2025 yarn firebase-admin run-script runScrapers \ + --env local --targets scrapeLobbying +``` + +Verify: Cloud Function logs show the expected number of new disclosures (should +be near zero if backfill completed, since current+prior year are already +processed). + +--- + ## Design Decisions | Decision | Choice | Rationale | diff --git a/firestore.indexes.json b/firestore.indexes.json index 83cb3fa6d..c267a6868 100644 --- a/firestore.indexes.json +++ b/firestore.indexes.json @@ -788,25 +788,46 @@ "collectionGroup": "ballotQuestions", "queryScope": "COLLECTION", "fields": [ - { "fieldPath": "electionYear", "order": "ASCENDING" }, - { "fieldPath": "ballotStatus", "order": "ASCENDING" } + { + "fieldPath": "electionYear", + "order": "ASCENDING" + }, + { + "fieldPath": "ballotStatus", + "order": "ASCENDING" + } ] }, { "collectionGroup": "publishedTestimony", "queryScope": "COLLECTION_GROUP", "fields": [ - { "fieldPath": "ballotQuestionId", "order": "ASCENDING" }, - { "fieldPath": "publishedAt", "order": "DESCENDING" } + { + "fieldPath": "ballotQuestionId", + "order": "ASCENDING" + }, + { + "fieldPath": "publishedAt", + "order": "DESCENDING" + } ] }, { "collectionGroup": "publishedTestimony", "queryScope": "COLLECTION", "fields": [ - { "fieldPath": "billId", "order": "ASCENDING" }, - { "fieldPath": "court", "order": "ASCENDING" }, - { "fieldPath": "ballotQuestionId", "order": "ASCENDING" } + { + "fieldPath": "billId", + "order": "ASCENDING" + }, + { + "fieldPath": "court", + "order": "ASCENDING" + }, + { + "fieldPath": "ballotQuestionId", + "order": "ASCENDING" + } ] }, { @@ -898,6 +919,62 @@ } } ] + }, + { + "collectionGroup": "lobbyingFilings", + "queryScope": "COLLECTION", + "fields": [ + { + "fieldPath": "generalCourt", + "order": "ASCENDING" + }, + { + "fieldPath": "billId", + "order": "ASCENDING" + } + ] + }, + { + "collectionGroup": "lobbyingFilings", + "queryScope": "COLLECTION", + "fields": [ + { + "fieldPath": "generalCourt", + "order": "ASCENDING" + }, + { + "fieldPath": "chamber", + "order": "ASCENDING" + } + ] + }, + { + "collectionGroup": "lobbyingFilings", + "queryScope": "COLLECTION", + "fields": [ + { + "fieldPath": "generalCourt", + "order": "ASCENDING" + }, + { + "fieldPath": "entityNameNorm", + "order": "ASCENDING" + } + ] + }, + { + "collectionGroup": "lobbyingFilings", + "queryScope": "COLLECTION", + "fields": [ + { + "fieldPath": "generalCourt", + "order": "ASCENDING" + }, + { + "fieldPath": "clientNameNorm", + "order": "ASCENDING" + } + ] } ], "fieldOverrides": [ diff --git a/firestore.rules b/firestore.rules index a95586279..42db67276 100644 --- a/firestore.rules +++ b/firestore.rules @@ -103,6 +103,14 @@ service cloud.firestore { allow read: if true; allow write: if false; } + match /lobbyingRegistrants/{id} { + allow read: if true; + allow write: if false; + } + match /lobbyingFilings/{id} { + allow read: if true; + allow write: if false; + } match /transcriptions/{tid} { // public, read-only allow read: if true diff --git a/functions/src/index.ts b/functions/src/index.ts index 641255bf4..6c52b78c1 100644 --- a/functions/src/index.ts +++ b/functions/src/index.ts @@ -60,6 +60,8 @@ export { export { transcription } from "./webhooks" +export { scrapeLobbying } from "./lobbying" + export * from "./triggerPubsubFunction" // Export the health check last so it is loaded last. diff --git a/functions/src/lobbying/index.ts b/functions/src/lobbying/index.ts new file mode 100644 index 000000000..5e594cb34 --- /dev/null +++ b/functions/src/lobbying/index.ts @@ -0,0 +1,12 @@ +export { scrapeLobbying } from "./scrapeLobbying" +export * from "./types" +export { normalizeEntityName } from "./normalize" +export { + constructBillId, + fetchDisclosureDetail, + fetchDisclosureMeta, + fetchSummaryLinks, + makePortalClient, + normalizeChamber, + yearToGeneralCourt +} from "./portal" diff --git a/functions/src/lobbying/normalize.ts b/functions/src/lobbying/normalize.ts new file mode 100644 index 000000000..8d3d0a0ba --- /dev/null +++ b/functions/src/lobbying/normalize.ts @@ -0,0 +1,73 @@ +/** + * Entity name normalization pipeline. + * + * The SoS portal does not enforce consistent name formatting. The same client or + * registrant may appear as "Acme Corp.", "ACME CORPORATION", "Acme, Inc. d/b/a + * Acme Consulting", etc. across filings and years. + * + * This pipeline is a direct port of the reference implementation used in the + * companion data analysis project. The steps must be applied in the exact order + * listed here; changing the order produces different (incorrect) output. + */ + +// Step 2: strip d/b/a trade-name suffix before any other transforms so the +// trade name doesn't bleed into the canonical form. +const DBA_RE = /\s+D\s*\/+B\s*\/+A?\s+.*|\s+DBA\s+.*/i + +// Step 5: remove legal entity type words with whole-word matching so +// "INCORPORATED" and "CORP" are caught in addition to "LLC"/"INC". +const LEGAL_ENTITY_RE = + /\b(LLC|LLP|INC|INCORPORATED|CORPORATION|CORP|LTD|LIMITED|PC|PLLC)\b/g + +// Step 6: remove "THE" as a whole word anywhere (not just as a leading prefix). +const THE_RE = /\bTHE\b/g + +// Step 9: professional suffix phrases to remove wholesale. +const MISC_PHRASES = [ + "LAW OFFICE OF", + "AND ASSOCIATES", + "& ASSOCIATES", + "AND ASSOC", + "ATTORNEY AT LAW", + "ATTORNEY@LAW", + "ATTORNET AT LAW", // known portal typo + "AND PARTNERS", + "PUBLIC POLICY GROUP", + "LEGISLATIVE SERVICES", + "POLICY GROUP", + "ASSOCIATES", + "COUNSELLORS AT LAW" +] + +export function normalizeEntityName(raw: string | null | undefined): string { + if (!raw) return "" + + let x = raw.toUpperCase() // Step 1: uppercase + + x = x.replace(DBA_RE, "") // Step 2: strip d/b/a suffix + + x = x.replace(/-/g, " ") // Step 3: hyphen → space + + // Step 4: punctuation → space (not empty string, so ",INC" → " INC" → caught + // by step 5's whole-word removal). + for (const ch of [",", ".", "'", "‘", "’", "(", ")"]) { + x = x.split(ch).join(" ") + } + + x = x.replace(LEGAL_ENTITY_RE, " ") // Step 5: remove legal entity type words + + x = x.replace(THE_RE, " ") // Step 6: remove THE anywhere + + x = x.replace(/&/g, "AND") // Step 7: ampersand → AND + + x = x.replace("ASSICIATES", "ASSOCIATES") // Step 8: fix known portal typo + + // Step 9: remove professional suffix phrases + for (const phrase of MISC_PHRASES) { + x = x.split(phrase).join(" ") + } + + x = x.replace(/\s+/g, " ").trim() // Step 10: collapse whitespace + + return x +} diff --git a/functions/src/lobbying/portal.ts b/functions/src/lobbying/portal.ts new file mode 100644 index 000000000..e441522b8 --- /dev/null +++ b/functions/src/lobbying/portal.ts @@ -0,0 +1,491 @@ +/** + * HTTP client and HTML parser for the MA Secretary of State lobbying portal. + * + * Portal: https://www.sec.state.ma.us/LobbyistPublicSearch/ + * + * Page flow: + * 1. Search POST → grdvSearchResultByTypeAndCategory table + * One row per registrant; each row has a Summary.aspx link. + * 2. Summary.aspx → registrant name/year/type + CompleteDisclosure links + * 3. CompleteDisclosure.aspx → per-client compensation + per-client bill activity + * + * Two disclosure HTML formats exist: + * Modern (≥~2013): per-client compensation in grdvClientPaidToEntity; + * per-client bill tables as grdvActivitiesNew{year}_{n}. + * Legacy (<~2013): total salary in grdvSalaryPaid (no client breakdown); + * all bill activity in a single grdvActivities table. + */ + +import axios, { AxiosInstance } from "axios" +import { JSDOM } from "jsdom" +import { sha256 } from "js-sha256" +import { + CHAMBER_PREFIXES, + LEGACY_CHAMBER_MAP, + LEGACY_TOTAL_CLIENT, + LobbyingChamber +} from "./types" + +// ─── Constants ────────────────────────────────────────────────────────────── + +const BASE_URL = "https://www.sec.state.ma.us/LobbyistPublicSearch/" +const SEARCH_URL = BASE_URL + "Default.aspx" +const REQUEST_DELAY_MS = 1000 +const MAX_RETRIES = 5 + +const IPAD_UA = + "Mozilla/5.0 (iPad; CPU OS 12_2 like Mac OS X) " + + "AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148" + +const FIRST_GC = 183 +const FIRST_GC_START_YEAR = 2003 + +// ─── Public types ─────────────────────────────────────────────────────────── + +export interface RawCompensation { + clientName: string + amount: number | null +} + +export interface RawBillActivity { + clientName: string + chamber: LobbyingChamber + rawBillNumber: string + billId: string | null // pre-computed from chamber + rawBillNumber + activityTitle: string + position: string + amount: number | null +} + +export interface DisclosureMeta { + entityName: string + year: number | null + /** Portal reg_type mapped to our vocabulary */ + regType: "Lobbyist" | "Employer" + disclosureUrls: string[] +} + +export interface DisclosureDetail { + compensation: RawCompensation[] + bills: RawBillActivity[] +} + +// ─── HTTP helpers ──────────────────────────────────────────────────────────── + +export function makePortalClient(): AxiosInstance { + return axios.create({ + headers: { "User-Agent": IPAD_UA }, + timeout: 60_000 + }) +} + +function sleep(ms: number): Promise { + return new Promise(resolve => setTimeout(resolve, ms)) +} + +async function getHtml( + client: AxiosInstance, + url: string, + retries = MAX_RETRIES +): Promise { + for (let attempt = 0; attempt < retries; attempt++) { + await sleep( + attempt === 0 ? REQUEST_DELAY_MS : REQUEST_DELAY_MS * 2 ** attempt + ) + try { + const res = await client.get(url, { + responseType: "text", + headers: { Accept: "text/html" } + }) + return new JSDOM(res.data).window.document + } catch (e) { + if (attempt === retries - 1) throw e + if (axios.isAxiosError(e)) continue + throw e + } + } + throw new Error("unreachable") +} + +async function postHtml( + client: AxiosInstance, + url: string, + data: Record, + retries = MAX_RETRIES +): Promise { + const body = new URLSearchParams(data).toString() + for (let attempt = 0; attempt < retries; attempt++) { + await sleep( + attempt === 0 ? REQUEST_DELAY_MS : REQUEST_DELAY_MS * 2 ** attempt + ) + try { + const res = await client.post(url, body, { + responseType: "text", + headers: { + "Content-Type": "application/x-www-form-urlencoded", + Accept: "text/html" + }, + timeout: 180_000 + }) + return new JSDOM(res.data).window.document + } catch (e) { + if (attempt === retries - 1) throw e + if (axios.isAxiosError(e)) continue + throw e + } + } + throw new Error("unreachable") +} + +// ─── Year / General Court helpers ──────────────────────────────────────────── + +export function yearToGeneralCourt(year: number): number { + return FIRST_GC + Math.floor((year - FIRST_GC_START_YEAR) / 2) +} + +// ─── Chamber normalization ──────────────────────────────────────────────────── + +/** Normalize raw portal chamber string to a canonical LobbyingChamber value. */ +export function normalizeChamber(raw: string): LobbyingChamber { + const trimmed = raw.trim() + if (LEGACY_CHAMBER_MAP[trimmed]) return LEGACY_CHAMBER_MAP[trimmed] + const known: LobbyingChamber[] = [ + "House Bill", + "Senate Bill", + "House Docket", + "Senate Docket", + "Executive" + ] + if (known.includes(trimmed as LobbyingChamber)) + return trimmed as LobbyingChamber + return "Other" +} + +/** + * Construct the MAPLE-compatible billId from the portal's chamber + raw integer. + * + * The portal stores bill numbers as bare integers; the chamber prefix is what + * distinguishes H1234 from S1234. Returns null for Executive and Other chambers + * where no bill join is possible. + */ +export function constructBillId( + chamber: LobbyingChamber, + rawBillNumber: string +): string | null { + const prefix = CHAMBER_PREFIXES[chamber] + if (!prefix) return null + const n = parseInt(rawBillNumber, 10) + if (isNaN(n)) return null + return `${prefix}${n}` +} + +// ─── Document ID generation ─────────────────────────────────────────────────── + +/** Stable Firestore document ID for a registrant (entity + year). */ +export function registrantId(entityName: string, year: number): string { + return sha256(`${year}|${entityName}`).slice(0, 40) +} + +/** + * Stable Firestore document ID for a filing. + * + * Uses a hash of the logical deduplication key. For null-bill rows (billId is + * null) the chamber is included in the key to avoid merging executive null rows + * with legislative null rows. + */ +export function filingId( + entityName: string, + clientName: string, + chamber: LobbyingChamber, + billId: string | null, + generalCourt: number, + position: string +): string { + const key = [ + entityName, + clientName, + chamber, + billId ?? "__null__", + generalCourt, + position + ].join("|") + return sha256(key).slice(0, 40) +} + +// ─── Amount parsing ─────────────────────────────────────────────────────────── + +function parseAmount(text: string): number | null { + const cleaned = text.replace(/[$,]/g, "").trim() + const n = parseFloat(cleaned) + return isNaN(n) ? null : n +} + +// ─── Portal scraping functions ──────────────────────────────────────────────── + +/** Extract ASP.NET WebForms ViewState hidden inputs from a page. */ +function extractViewState(doc: Document): Record { + const fields: Record = {} + doc.querySelectorAll('input[type="hidden"]').forEach(el => { + const input = el as HTMLInputElement + if (input.name) fields[input.name] = input.value ?? "" + }) + return fields +} + +/** + * Fetch all Summary.aspx URLs for a given year. + * Sends a single search POST with page size 20000 to get all registrants at once. + */ +export async function fetchSummaryLinks( + client: AxiosInstance, + year: number +): Promise { + const searchPage = await getHtml(client, SEARCH_URL) + const vs = extractViewState(searchPage) + + const postData: Record = { + ...vs, + __EVENTTARGET: "", + __EVENTARGUMENT: "", + ctl00$ContentPlaceHolder1$Search: "rdbSearchByType", + ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$ddlYear: String(year), + ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$txtN_ame: "", + ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$lddSearchType$DropDown: + "3", + ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$drpType: "L", + ctl00$ContentPlaceHolder1$drpPageSize: "20000", + ctl00$ContentPlaceHolder1$btnSearch: "Search" + } + + const resultsPage = await postHtml(client, SEARCH_URL, postData) + + const table = resultsPage.querySelector( + '[id*="grdvSearchResultByTypeAndCategory"]' + ) + if (!table) return [] + + const links: string[] = [] + table.querySelectorAll("a[href]").forEach(el => { + const href = (el as HTMLAnchorElement).href + if (href && href.includes("Summary.aspx")) { + // href from JSDOM is already absolute when base is set; handle both cases + const url = href.startsWith("http") ? href : BASE_URL + href + links.push(url) + } + }) + return links +} + +/** + * Fetch a Summary.aspx page and return the registrant metadata + disclosure URLs. + */ +export async function fetchDisclosureMeta( + client: AxiosInstance, + summaryUrl: string +): Promise { + const doc = await getHtml(client, summaryUrl) + + const text = (id: string) => { + const el = doc.getElementById(id) + return el?.textContent?.trim() ?? "" + } + + const entityName = text("ContentPlaceHolder1_lblRegistrantName") + const yearText = text("ContentPlaceHolder1_lblYear") + const regTypeRaw = text("ContentPlaceHolder1_lblRegType") + + const year = parseInt(yearText, 10) + const regType: "Lobbyist" | "Employer" = regTypeRaw.includes("Entity") + ? "Employer" + : "Lobbyist" + + const disclosureUrls: string[] = [] + doc.querySelectorAll("a[href]").forEach(el => { + const raw = (el as HTMLAnchorElement).getAttribute("href") ?? "" + if (raw.includes("CompleteDisclosure")) { + const url = raw.startsWith("http") ? raw : BASE_URL + raw + disclosureUrls.push(url) + } + }) + + return { + entityName, + year: isNaN(year) ? null : year, + regType, + disclosureUrls + } +} + +/** + * Parse a CompleteDisclosure.aspx page. + * + * Handles both modern (≥~2013) and legacy (<~2013) HTML layouts. + */ +export async function fetchDisclosureDetail( + client: AxiosInstance, + discUrl: string, + year: number +): Promise { + const doc = await getHtml(client, discUrl) + const compensation: RawCompensation[] = [] + const bills: RawBillActivity[] = [] + + // ── Modern format ────────────────────────────────────────────────────────── + const compTable = doc.querySelector('[id*="grdvClientPaidToEntity"]') + if (compTable) { + compTable + .querySelectorAll("tr.GridRow, tr.GridAlternatingRow") + .forEach(row => { + const cells = Array.from(row.querySelectorAll("td")).map( + td => td.textContent?.trim() ?? "" + ) + if (cells.length >= 2) { + compensation.push({ + clientName: cells[0], + amount: parseAmount(cells[1]) + }) + } + }) + } + + // Bill activity tables — one per client per reporting period. Two ID patterns: + // 2014–2018: …rptActivityNew_grdvActivitiesNew_0 (no year suffix) + // 2019+: …rptActivityNew2020_grdvActivitiesNew2020_0 (year suffix) + doc.querySelectorAll('[id*="grdvActivitiesNew"]').forEach(actTable => { + // The client name lives in the nearest preceding span with lblClientName + let clientName = "" + let node: Element | null = actTable + while ((node = node.previousElementSibling ?? node.parentElement)) { + const span = node.id?.includes("lblClientName") + ? node + : node.querySelector?.('[id*="lblClientName"]') + if (span) { + clientName = span.textContent?.trim() ?? "" + break + } + if (node === node.parentElement) break + } + + actTable + .querySelectorAll("tr.GridRow, tr.GridAlternatingRow") + .forEach(row => { + const cells = Array.from(row.querySelectorAll("td")).map( + td => td.textContent?.trim() ?? "" + ) + // Columns: House/Senate, Bill Number, Bill title, Position, Amount, Direct business + if (cells.length < 4) return + const chamber = normalizeChamber(cells[0]) + const rawBillNumber = cells[1] + const billId = constructBillId(chamber, rawBillNumber) + bills.push({ + clientName, + chamber, + rawBillNumber, + billId, + activityTitle: cells[2] ?? "", + position: cells[3] ?? "", + amount: cells.length > 4 ? parseAmount(cells[4]) : null + }) + }) + }) + + if (compTable || bills.length > 0) { + return { compensation, bills } + } + + // ── Legacy format (<~2013) ───────────────────────────────────────────────── + const salaryTable = doc.querySelector('[id*="grdvSalaryPaid"]') + if (salaryTable) { + let total = 0 + salaryTable.querySelectorAll("tr").forEach(row => { + const cells = Array.from(row.querySelectorAll("td")).map( + td => td.textContent?.trim() ?? "" + ) + if (cells.length >= 2 && !cells[0].includes("Total")) { + const amt = parseAmount(cells[1]) + if (amt !== null) total += amt + } + }) + if (total > 0) { + compensation.push({ clientName: LEGACY_TOTAL_CLIENT, amount: total }) + } + } + + // Legacy bill activity: single grdvActivities table. Three known column layouts: + // 2009 4-col: Date | Bill+Title | Lobbyist | Client + // 2010+ individual 5-col: Activity | Position | DirectBiz | Client | Compensation + // 2010+ entity 6-col: Activity | Lobbyist | Position | DirectBiz | Client | Compensation + const actTable = doc.querySelector('[id$="grdvActivities"]') + if (actTable) { + const allRows = Array.from(actTable.querySelectorAll("tr")) + const headerCells = Array.from( + allRows[0]?.querySelectorAll("th, td") ?? [] + ).map(el => el.textContent?.trim() ?? "") + + let billCol = 1 + let positionCol: number | null = null + let clientCol = 3 + + if (headerCells[0]?.includes("Activity")) { + if (headerCells[1]?.includes("Lobbyist")) { + // 6-col entity layout + billCol = 0 + positionCol = 2 + clientCol = 4 + } else { + // 5-col individual layout + billCol = 0 + positionCol = 1 + clientCol = 3 + } + } + + const chamberMap: Record = { + H: "House Bill", + S: "Senate Bill", + HD: "House Docket", + SD: "Senate Docket" + } + + allRows.slice(1).forEach(row => { + const cells = Array.from(row.querySelectorAll("td")).map( + td => td.textContent?.trim() ?? "" + ) + if (cells.length <= Math.max(billCol, clientCol)) return + + const billCell = cells[billCol] + const skipValues = new Set([ + "Activity or Bill No and Title", + "N/A", + "None", + "", + "Total amount" + ]) + if (!billCell || skipValues.has(billCell)) return + + const parts = billCell.split(/\s+/) + const billNo = parts[0] + const activityTitle = parts.slice(1).join(" ") + const match = billNo.match(/^([A-Z]+)(\d+)$/) + if (!match) return + + const [, prefix, number] = match + const chamber: LobbyingChamber = chamberMap[prefix] ?? "Other" + const billId = constructBillId(chamber, number) + const position = positionCol !== null ? cells[positionCol] ?? "" : "" + const clientName = cells[clientCol] ?? "" + + bills.push({ + clientName, + chamber, + rawBillNumber: number, + billId, + activityTitle, + position, + amount: null + }) + }) + } + + return { compensation, bills } +} diff --git a/functions/src/lobbying/scrapeLobbying.ts b/functions/src/lobbying/scrapeLobbying.ts new file mode 100644 index 000000000..7a6140e8e --- /dev/null +++ b/functions/src/lobbying/scrapeLobbying.ts @@ -0,0 +1,274 @@ +import { logger } from "firebase-functions" +import { runWith } from "firebase-functions/v1" +import { db, Timestamp } from "../firebase" +import type { Database } from "../types" +import { normalizeEntityName } from "./normalize" +import { + fetchDisclosureDetail, + fetchDisclosureMeta, + fetchSummaryLinks, + filingId, + makePortalClient, + registrantId, + yearToGeneralCourt +} from "./portal" +import { + FILINGS_COLLECTION, + FIRST_LOBBYING_YEAR, + LobbyingFiling, + LobbyingRegistrant, + REGISTRANTS_COLLECTION, + SCRAPER_DOC +} from "./types" + +/** + * Scraper state stored in Firestore at /scrapers/lobbying. + * + * processedDiscUrls: disc URLs already fetched; skip on re-runs. + * summaryDiscCache: maps summaryUrl → its known disc URLs so we can skip + * summary page GETs for registrants with no new filings. + */ +interface ScraperState { + processedDiscUrls: string[] + summaryDiscCache: Record +} + +/** + * Maximum number of new disclosure pages to fetch per function invocation. + * Each page takes ~1s; this keeps the run well within the 540s timeout. + * Remaining work is picked up on the next scheduled run. + */ +const MAX_DISCLOSURES_PER_RUN = 200 + +/** + * Scrape lobbying disclosure data for the current and prior calendar year. + * + * Runs every 24 hours. New filers arrive semi-annually so daily polling is + * more than sufficient for steady-state freshness. For initial historical + * ingestion (2005-present) use the backfillLobbying admin script instead. + * + * Progress is checkpointed to Firestore after every disclosure page so the + * function is fully resumable if it times out or is interrupted. + */ +export const scrapeLobbying = runWith({ timeoutSeconds: 540, maxInstances: 1 }) + .pubsub.schedule("every 24 hours") + .onRun(async () => { + const currentYear = new Date().getFullYear() + const years = [currentYear, currentYear - 1] + + const scraperRef = db.doc(SCRAPER_DOC) + const scraperDoc = await scraperRef.get() + const state: ScraperState = { + processedDiscUrls: scraperDoc.data()?.processedDiscUrls ?? [], + summaryDiscCache: scraperDoc.data()?.summaryDiscCache ?? {} + } + const processedSet = new Set(state.processedDiscUrls) + const summaryCache: Record = state.summaryDiscCache + + const client = makePortalClient() + let newDiscCount = 0 + + for (const year of years) { + if (newDiscCount >= MAX_DISCLOSURES_PER_RUN) break + + logger.info(`scrapeLobbying: fetching summary links for ${year}`) + let summaryUrls: string[] + try { + summaryUrls = await fetchSummaryLinks(client, year) + } catch (e) { + logger.error( + `scrapeLobbying: failed to fetch summary links for ${year}`, + e + ) + continue + } + logger.info( + `scrapeLobbying: ${summaryUrls.length} registrants for ${year}` + ) + + for (const summaryUrl of summaryUrls) { + if (newDiscCount >= MAX_DISCLOSURES_PER_RUN) break + + // Use cached disc URLs when available to avoid re-fetching summary pages. + // For current year we always re-check (new filings arrive mid-year). + let discUrls = summaryCache[summaryUrl] + if (!discUrls || year === currentYear) { + try { + const meta = await fetchDisclosureMeta(client, summaryUrl) + discUrls = meta.disclosureUrls + + // Write registrant doc (upsert); don't wait for individual writes to + // finish — use a bulkWriter for the doc contents but checkpoint the + // scraper state separately so interruptions are recoverable. + if (meta.entityName && meta.year) { + await writeRegistrant( + db, + meta.entityName, + meta.year, + meta.regType, + discUrls + ) + } + + summaryCache[summaryUrl] = discUrls + await scraperRef.set( + { summaryDiscCache: summaryCache }, + { merge: true } + ) + } catch (e) { + logger.warn( + `scrapeLobbying: failed to fetch summary ${summaryUrl}`, + e + ) + continue + } + } + + const newDiscUrls = discUrls.filter(u => !processedSet.has(u)) + if (newDiscUrls.length === 0) continue + + for (const discUrl of newDiscUrls) { + if (newDiscCount >= MAX_DISCLOSURES_PER_RUN) break + try { + await processDisclosure(db, client, summaryUrl, discUrl, year) + processedSet.add(discUrl) + newDiscCount++ + + // Checkpoint after every disclosure so restarts lose at most one page + await scraperRef.set( + { processedDiscUrls: Array.from(processedSet) }, + { merge: true } + ) + } catch (e) { + logger.warn( + `scrapeLobbying: failed to process disclosure ${discUrl}`, + e + ) + } + } + } + } + + logger.info(`scrapeLobbying: processed ${newDiscCount} new disclosures`) + }) + +// ─── Shared write helpers (also used by backfillLobbying) ──────────────────── + +/** + * Write or update a LobbyingRegistrant document. Client list is assembled from + * the disclosure meta; filing documents are written separately per-bill. + */ +export async function writeRegistrant( + database: Database, + entityName: string, + year: number, + regType: "Lobbyist" | "Employer", + disclosureUrls: string[] +): Promise { + const id = registrantId(entityName, year) + const ref = database.collection(REGISTRANTS_COLLECTION).doc(id) + const partial: Omit & { + fetchedAt: FirebaseFirestore.Timestamp + } = { + registrantId: id, + entityName, + entityNameNorm: normalizeEntityName(entityName), + year, + generalCourt: yearToGeneralCourt(year), + regType, + disclosureUrls, + fetchedAt: Timestamp.now() + } + // Merge so repeated runs don't wipe clients accumulated from multiple disclosures + await ref.set(partial, { merge: true }) +} + +/** + * Fetch one CompleteDisclosure page and write LobbyingFiling documents. + * Also updates the registrant's client list. + */ +export async function processDisclosure( + database: Database, + client: ReturnType, + summaryUrl: string, + discUrl: string, + year: number +): Promise { + const meta = await fetchDisclosureMeta(client, summaryUrl) + const detail = await fetchDisclosureDetail(client, discUrl, year) + + const { entityName, regType } = meta + const gc = yearToGeneralCourt(year) + const entityNameNorm = normalizeEntityName(entityName) + const now = Timestamp.now() + + // Update registrant's client list + if (entityName && year) { + const regRef = database + .collection(REGISTRANTS_COLLECTION) + .doc(registrantId(entityName, year)) + + const clients = detail.compensation.map(c => ({ + clientName: c.clientName, + clientNameNorm: normalizeEntityName(c.clientName), + compensation: c.amount + })) + + await regRef.set( + { + registrantId: registrantId(entityName, year), + entityName, + entityNameNorm, + year, + generalCourt: gc, + regType: regType ?? "Lobbyist", + clients, + disclosureUrls: [discUrl], + fetchedAt: now + }, + { merge: true } + ) + } + + // Write one LobbyingFiling doc per bill row + if (detail.bills.length === 0) return + + const writer = database.bulkWriter() + for (const bill of detail.bills) { + const fid = filingId( + entityName, + bill.clientName, + bill.chamber, + bill.billId, + gc, + bill.position + ) + const doc: LobbyingFiling = { + filingId: fid, + entityName, + entityNameNorm, + clientName: bill.clientName, + clientNameNorm: normalizeEntityName(bill.clientName), + year, + generalCourt: gc, + chamber: bill.chamber, + billId: bill.billId, + activityTitle: bill.activityTitle, + position: bill.position, + amount: bill.amount, + fetchedAt: now + } + writer.set(database.collection(FILINGS_COLLECTION).doc(fid), doc, { + merge: false + }) + } + await writer.close() +} + +/** All years to scrape, for use by the backfill script. */ +export function allLobbyingYears(): number[] { + const current = new Date().getFullYear() + const years: number[] = [] + for (let y = FIRST_LOBBYING_YEAR; y <= current; y++) years.push(y) + return years +} diff --git a/functions/src/lobbying/types.ts b/functions/src/lobbying/types.ts new file mode 100644 index 000000000..83eaab761 --- /dev/null +++ b/functions/src/lobbying/types.ts @@ -0,0 +1,101 @@ +import { + Array, + InstanceOf, + Literal, + Number, + Null, + Record, + Static, + String, + Union +} from "runtypes" +import { Timestamp } from "../firebase" + +export type LobbyingChamber = Static +export const LobbyingChamber = Union( + Literal("House Bill"), + Literal("Senate Bill"), + Literal("House Docket"), + Literal("Senate Docket"), + Literal("Executive"), + Literal("Other") +) + +export type LobbyingClient = Static +export const LobbyingClient = Record({ + clientName: String, + clientNameNorm: String, + compensation: Null.Or(Number) +}) + +export type LobbyingRegistrant = Static +export const LobbyingRegistrant = Record({ + registrantId: String, + entityName: String, + entityNameNorm: String, + year: Number, + generalCourt: Number, + regType: Union(Literal("Lobbyist"), Literal("Employer")), + clients: Array(LobbyingClient), + disclosureUrls: Array(String), + fetchedAt: InstanceOf(Timestamp) +}) + +export type LobbyingFiling = Static +export const LobbyingFiling = Record({ + filingId: String, + entityName: String, + entityNameNorm: String, + clientName: String, + clientNameNorm: String, + year: Number, + generalCourt: Number, + chamber: LobbyingChamber, + // Non-null only for legislative chambers (House Bill, Senate Bill, House Docket, + // Senate Docket). For Executive and Other, no bill join should be attempted. + billId: Null.Or(String), + activityTitle: String, + position: String, + amount: Null.Or(Number), + fetchedAt: InstanceOf(Timestamp) +}) + +/** Firestore path for lobbying registrant documents */ +export const REGISTRANTS_COLLECTION = "lobbyingRegistrants" + +/** Firestore path for lobbying filing documents */ +export const FILINGS_COLLECTION = "lobbyingFilings" + +/** Firestore path for the live scraper cursor document */ +export const SCRAPER_DOC = "/scrapers/lobbying" + +/** Firestore path for the backfill cursor subcollection */ +export const BACKFILL_DOC = "/scrapers/lobbyingBackfill" +export const BACKFILL_URLS_COLLECTION = "processedUrls" + +/** Earliest year with portal data */ +export const FIRST_LOBBYING_YEAR = 2005 + +/** + * Sentinel clientName used for pre-2013 legacy filings where compensation is + * reported as a single total rather than broken down per client. + */ +export const LEGACY_TOTAL_CLIENT = "_total_salary_" + +/** + * Chamber prefix map for constructing billId values that match MAPLE's Bill.id. + * Typed as a plain index signature so portal.ts can look up any LobbyingChamber + * without triggering "Property X does not exist" on the Partial. + */ +export const CHAMBER_PREFIXES: { [chamber: string]: string | undefined } = { + "House Bill": "H", + "Senate Bill": "S", + "House Docket": "HD", + "Senate Docket": "SD" +} + +/** Canonical chamber values for legacy short-form codes found in older filings */ +export const LEGACY_CHAMBER_MAP: { [raw: string]: LobbyingChamber } = { + HB: "House Bill", + SB: "Senate Bill" +} diff --git a/scripts/firebase-admin/backfillLobbying.ts b/scripts/firebase-admin/backfillLobbying.ts new file mode 100644 index 000000000..f7914dd84 --- /dev/null +++ b/scripts/firebase-admin/backfillLobbying.ts @@ -0,0 +1,156 @@ +/** + * Backfill lobbying disclosure data from 2005 to the present. + * + * This script is the primary ingestion path for all historical data. The live + * Cloud Function (scrapeLobbying) only handles the current and prior year in + * steady state. Run this once to populate the full history, and re-run with + * --year to refresh specific years. + * + * Usage: + * GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + * yarn firebase-admin run-script backfillLobbying --env dev + * + * Options: + * --year NUMBER Only process this year (useful for testing or re-runs) + * --limit NUMBER Max registrants to process per year (for testing) + * + * Cursor storage: + * Processed disclosure URLs are stored as documents in the Firestore + * subcollection /scrapers/lobbyingBackfill/processedUrls/{urlHash}. + * This scales to the full historical URL set (~50,000+) without hitting the + * 1MB Firestore document size limit. Restart the script at any time; it will + * resume from where it left off. + */ + +import { createHash } from "crypto" +import { z } from "zod" +import { + allLobbyingYears, + processDisclosure, + writeRegistrant +} from "../../functions/src/lobbying/scrapeLobbying" +import { + fetchDisclosureMeta, + fetchSummaryLinks, + makePortalClient +} from "../../functions/src/lobbying/portal" +import { + BACKFILL_DOC, + BACKFILL_URLS_COLLECTION, + FIRST_LOBBYING_YEAR +} from "../../functions/src/lobbying/types" +import { Script } from "./types" + +const Args = z + .object({ + year: z.number().int().min(FIRST_LOBBYING_YEAR).optional(), + limit: z.number().int().positive().optional() + }) + .passthrough() + +export const script: Script = async ({ db, args }) => { + const { year: onlyYear, limit } = Args.parse(args) + + const years = onlyYear ? [onlyYear] : allLobbyingYears() + console.log( + `backfillLobbying: processing years ${years[0]}–${years[years.length - 1]}` + ) + + // Load already-processed disc URLs from the subcollection cursor. + const backfillRef = db.doc(BACKFILL_DOC) + const processedSnap = await backfillRef + .collection(BACKFILL_URLS_COLLECTION) + .select() // fetch only doc IDs (the URL hash), no field data needed + .get() + const processedHashes = new Set(processedSnap.docs.map(d => d.id)) + console.log( + `backfillLobbying: ${processedHashes.size} disc URLs already processed` + ) + + const client = makePortalClient() + let totalNew = 0 + + for (const year of years) { + console.log(`\n── ${year} ──`) + + let summaryUrls: string[] + try { + summaryUrls = await fetchSummaryLinks(client, year) + } catch (e) { + console.error(` Failed to fetch summary links for ${year}:`, e) + continue + } + + if (limit) summaryUrls = summaryUrls.slice(0, limit) + console.log(` ${summaryUrls.length} registrants on portal`) + + let yearNew = 0 + + for (let i = 0; i < summaryUrls.length; i++) { + const summaryUrl = summaryUrls[i] + let meta: Awaited> + + try { + meta = await fetchDisclosureMeta(client, summaryUrl) + } catch (e) { + console.warn( + ` [${i + 1}/${ + summaryUrls.length + }] Failed to fetch summary: ${summaryUrl}`, + e + ) + continue + } + + if (meta.entityName && meta.year) { + try { + await writeRegistrant( + db, + meta.entityName, + meta.year, + meta.regType, + meta.disclosureUrls + ) + } catch (e) { + console.warn(` Failed to write registrant ${meta.entityName}:`, e) + } + } + + for (const discUrl of meta.disclosureUrls) { + const urlHash = createHash("sha256") + .update(discUrl) + .digest("hex") + .slice(0, 40) + if (processedHashes.has(urlHash)) continue + + try { + await processDisclosure(db, client, summaryUrl, discUrl, year) + + // Mark as processed in the subcollection cursor + await backfillRef + .collection(BACKFILL_URLS_COLLECTION) + .doc(urlHash) + .set({ url: discUrl, processedAt: new Date().toISOString() }) + + processedHashes.add(urlHash) + totalNew++ + yearNew++ + } catch (e) { + console.warn(` Failed to process disclosure ${discUrl}:`, e) + } + } + + if ((i + 1) % 50 === 0 || i + 1 === summaryUrls.length) { + console.log( + ` [${i + 1}/${ + summaryUrls.length + }] ${yearNew} new disclosures this year` + ) + } + } + + console.log(` ${year} complete: ${yearNew} new disclosures`) + } + + console.log(`\nbackfillLobbying complete: ${totalNew} new disclosures total`) +} From 0074294861aece13daea9c90be3af634afd407fa Mon Sep 17 00:00:00 2001 From: Nathan Date: Fri, 5 Jun 2026 16:34:07 -0400 Subject: [PATCH 3/8] feat: add Python Cloud Run scraper for lobbying disclosures MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The MA SoS portal is protected by Imperva WAF, which uses TLS fingerprinting to classify HTTP clients before examining headers. Python's requests library produces a fingerprint that Imperva allows through; Node.js does not. A standalone Cloud Run container (Python 3.12) is therefore used for the scheduled ingestion instead of a Cloud Function. lobbying-scraper/ — Cloud Run container (3 pip deps: requests, beautifulsoup4, google-cloud-firestore): - scrape.py: entry point with --mode weekly (incremental, fast exit if nothing new) and --mode backfill (full 2005-present history, resumable subcollection cursor). Weekly mode caches summary URL→disc URL mappings so prior-year registrants with no new filings require zero additional HTTP requests. - portal.py: HTTP session management + HTML parsing for all three portal page levels (search POST, summary GET, disclosure GET). Handles both modern (>=2013) and legacy (<2013) disclosure formats. - normalize.py: port of functions/src/lobbying/normalize.ts — 10-step entity name normalization pipeline, must match the TypeScript version exactly. - writer.py: Firestore document construction and batch writes. Schema matches types.ts (lobbyingRegistrants, lobbyingFilings collections). scripts/firebase-admin/backfillLobbying.ts — simplified to spawn scrape.py as a subprocess; all HTTP and Firestore logic moved to Python. functions/src/lobbying/http/ — thin Python HTTP helper kept for reference; not used in the current architecture. Note: server-side IP reputation behavior with Imperva untested. Build and run the container on Cloud Run with --dry-run to validate before full deploy. Co-Authored-By: Claude Sonnet 4.6 --- docs/lobbying-disclosure-ingestion.md | 167 +++++--- functions/src/lobbying/http/.gitignore | 3 + functions/src/lobbying/http/fetch.py | 81 ++++ functions/src/lobbying/http/requirements.txt | 1 + functions/src/lobbying/normalize.ts | 3 +- functions/src/lobbying/portal.ts | 96 ++++- lobbying-scraper/.dockerignore | 4 + lobbying-scraper/Dockerfile | 14 + .../__pycache__/normalize.cpython-37.pyc | Bin 0 -> 1412 bytes .../__pycache__/portal.cpython-37.pyc | Bin 0 -> 11941 bytes lobbying-scraper/normalize.py | 50 +++ lobbying-scraper/portal.py | 376 ++++++++++++++++++ lobbying-scraper/requirements.txt | 3 + lobbying-scraper/scrape.py | 269 +++++++++++++ lobbying-scraper/writer.py | 126 ++++++ scripts/firebase-admin/backfillLobbying.ts | 168 ++------ 16 files changed, 1157 insertions(+), 204 deletions(-) create mode 100644 functions/src/lobbying/http/.gitignore create mode 100644 functions/src/lobbying/http/fetch.py create mode 100644 functions/src/lobbying/http/requirements.txt create mode 100644 lobbying-scraper/.dockerignore create mode 100644 lobbying-scraper/Dockerfile create mode 100644 lobbying-scraper/__pycache__/normalize.cpython-37.pyc create mode 100644 lobbying-scraper/__pycache__/portal.cpython-37.pyc create mode 100644 lobbying-scraper/normalize.py create mode 100644 lobbying-scraper/portal.py create mode 100644 lobbying-scraper/requirements.txt create mode 100644 lobbying-scraper/scrape.py create mode 100644 lobbying-scraper/writer.py diff --git a/docs/lobbying-disclosure-ingestion.md b/docs/lobbying-disclosure-ingestion.md index ad67fe397..264c77c52 100644 --- a/docs/lobbying-disclosure-ingestion.md +++ b/docs/lobbying-disclosure-ingestion.md @@ -233,43 +233,57 @@ executive and legislative null rows. ## Scraper Architecture -The lobbying portal is an HTML scraper, not a REST API. It does not fit the -`createScraper` factory (which assumes list-IDs → fetch-per-ID against the MA -Legislature API). Instead, we use a custom scheduled function following the -`scrapeEvents` pattern. - -### Cloud Function: `scrapeLobbying` - -**File:** `functions/src/lobbying/scrapeLobbying.ts` - -- Schedule: `every 24 hours` -- Scrapes the current year and prior year (new filers arrive semi-annually) +### Why a standalone Cloud Run container + +The MA SoS portal is protected by Imperva WAF, which uses TLS fingerprinting to +classify HTTP clients at the network layer before examining any headers. Node.js +produces a TLS fingerprint that Imperva challenges with a JavaScript +verification page; Python's `requests` library produces a fingerprint that +Imperva allows through without challenge. This is a runtime-level constraint +that cannot be addressed by header configuration or cipher reordering alone. + +The scraper therefore runs as a standalone **Cloud Run container** written in +Python, deployed alongside the existing MCP server container. All data modeling, +Firestore collection/field names, and normalization logic are documented here and +kept consistent between the Python container and the TypeScript type definitions +in `functions/src/lobbying/types.ts`. + +### Cloud Run container: `lobbying-scraper/` + +**Files:** `lobbying-scraper/{scrape,portal,normalize,writer}.py` + +- Scheduled weekly by Cloud Scheduler +- Runs an incremental check: fetches the current and prior year's summary links + (one POST), compares disc URLs against the Firestore cursor, and **exits + immediately if nothing is new** (fast path, typically seconds) +- When new or updated disclosures are found, fetches and processes them - Persists a cursor in `/scrapers/lobbying`: - - `lastFetchedAt: Timestamp` - - `processedDiscUrls: string[]` — already-fetched disclosure URLs (skipped on - re-runs) + - `processedDiscUrls: string[]` — disc URLs already written; skipped on + re-runs + - `summaryDiscCache: {[summaryUrl]: string[]}` — maps summary page URLs to + their disc URLs so summary page GETs are skipped for prior-year registrants + whose disclosures are all already processed - For each new disclosure URL: - Parse registrant + client compensation rows → upsert `lobbyingRegistrants` - doc - - Parse bill activity rows → batch-write `lobbyingFilings` docs -- Uses `axios` (existing dependency) with an iPad `User-Agent` header to match - portal expectations -- Uses `jsdom` for HTML table parsing (already a dependency; used by events scraper) -- 1s delay between requests; exponential backoff on failure (matching existing - scraper retry pattern) -- Function timeout: 540s - -### Incremental Strategy - -Processed disclosure URLs are stored in `/scrapers/lobbying.processedDiscUrls`. -At ~2 disclosure URLs per registrant × ~500 registrants per year, the -current+prior year window stays well within Firestore document limits. -Historical years beyond current-1 are stable (filings are frozen after year -closes) and are handled by the backfill script only. - -The backfill script uses a separate Firestore document -(`/scrapers/lobbyingBackfill`) for its own cursor so it does not interfere with -the live scraper. + - Parse bill activity rows → batch-write `lobbyingFilings` +- 1s delay between requests; exponential backoff on transient failures + +### Incremental strategy + +In steady state (after the initial backfill), each weekly run: + +1. One POST to fetch all summary links for current + prior year +2. For prior-year registrants with all disc URLs in the cursor: zero GETs +3. For current-year registrants: one GET per summary page to check for new + disclosure periods +4. For any new disc URLs: one GET per disclosure page + +New filings arrive twice a year (semi-annual reporting periods). Between +periods, the run completes in under a minute. + +The backfill script (`--mode backfill`) uses a separate subcollection cursor at +`/scrapers/lobbyingBackfill/processedUrls/{urlHash}` so it does not interfere +with the live scraper state. ### Legacy Format (pre-2013) @@ -284,26 +298,64 @@ them. No bill-level compensation amount is available for these years. ``` functions/src/lobbying/ - types.ts — Runtypes definitions for LobbyingRegistrant, LobbyingFiling - scrapeLobbying.ts — Scheduled Cloud Function + shared parsing/normalization logic - index.ts — Re-exports + types.ts — Runtypes definitions for LobbyingRegistrant, LobbyingFiling + normalize.ts — Entity name normalization pipeline + portal.ts — Reference implementation (HTTP layer not used in production) + scrapeLobbying.ts — Reference implementation (superseded by Cloud Run container) + index.ts — Re-exports + +lobbying-scraper/ + scrape.py — Entry point: --mode weekly (incremental) | --mode backfill + portal.py — HTTP + HTML parsing + normalize.py — Port of normalize.ts + writer.py — Firestore document construction + writes + requirements.txt — requests, beautifulsoup4, google-cloud-firestore + Dockerfile — Python 3.12-slim image ``` --- -## Firebase Admin Script +## Deploying the Cloud Run Container + +Follows the same pattern as the MCP server. Requires the +`maple-lobbying-scraper` Artifact Registry repository to exist. + +```bash +cd lobbying-scraper +IMAGE=us-central1-docker.pkg.dev/digital-testimony-dev/maple-lobbying/scraper:latest +docker build -t $IMAGE . && docker push $IMAGE + +gcloud run jobs create maple-lobbying-scraper \ + --image=$IMAGE \ + --project=digital-testimony-dev \ + --region=us-central1 \ + --service-account=@digital-testimony-dev.iam.gserviceaccount.com + +# Schedule weekly via Cloud Scheduler +gcloud scheduler jobs create http maple-lobbying-weekly \ + --schedule="0 6 * * 1" \ + --uri="https://us-central1-run.googleapis.com/apis/run.googleapis.com/v1/namespaces/digital-testimony-dev/jobs/maple-lobbying-scraper:run" \ + --http-method=POST \ + --oauth-service-account-email=@digital-testimony-dev.iam.gserviceaccount.com \ + --location=us-central1 +``` -**File:** `scripts/firebase-admin/backfillLobbying.ts` +## Historical Backfill (Admin Script) -Ingests all historical filings from 2005 to the present. This is the primary -path for all data before the current and prior year. Accepts `--year` and -`--limit` CLI args for targeted re-runs or testing. Calls the same parsing -logic exported from `functions/src/lobbying/scrapeLobbying.ts` and writes -directly to Firestore via the firebase-admin SDK. +Ingests all historical filings from 2005 to the present. Delegates to +`scrape.py --mode backfill` via subprocess. Resumable — the subcollection +cursor at `/scrapers/lobbyingBackfill/processedUrls` tracks what has been +processed. Run directly on the machine (requires `lobbying-scraper/` deps +installed or the `maple-2025` conda environment). ```bash GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ yarn firebase-admin run-script backfillLobbying --env dev + +# Or call scrape.py directly for more control: +cd lobbying-scraper +python3 scrape.py --mode backfill --year 2024 --limit 3 --dry-run +python3 scrape.py --mode backfill --year 2024 ``` --- @@ -348,17 +400,22 @@ export { scrapeLobbying } from "./lobbying" ## Implementation Status -| File | Status | -| -------------------------------------------- | ------- | -| `functions/src/lobbying/types.ts` | ✅ Done | -| `functions/src/lobbying/normalize.ts` | ✅ Done | -| `functions/src/lobbying/portal.ts` | ✅ Done | -| `functions/src/lobbying/scrapeLobbying.ts` | ✅ Done | -| `functions/src/lobbying/index.ts` | ✅ Done | -| `scripts/firebase-admin/backfillLobbying.ts` | ✅ Done | -| `functions/src/index.ts` (export) | ✅ Done | -| `firestore.rules` | ✅ Done | -| `firestore.indexes.json` | ✅ Done | +| File | Status | Notes | +| -------------------------------------------- | ------- | ---------------------------------------------------------- | +| `functions/src/lobbying/types.ts` | ✅ Done | TypeScript type definitions; source of truth for schema | +| `functions/src/lobbying/normalize.ts` | ✅ Done | Normalization pipeline (also ported to `normalize.py`) | +| `functions/src/lobbying/portal.ts` | ✅ Done | Kept for reference; HTTP layer not used (see architecture) | +| `functions/src/lobbying/scrapeLobbying.ts` | ✅ Done | Not deployed; superseded by Cloud Run container | +| `functions/src/lobbying/index.ts` | ✅ Done | | +| `functions/src/index.ts` (export) | ✅ Done | | +| `firestore.rules` | ✅ Done | | +| `firestore.indexes.json` | ✅ Done | | +| `lobbying-scraper/normalize.py` | ✅ Done | Port of normalize.ts | +| `lobbying-scraper/portal.py` | ✅ Done | HTTP + HTML parsing | +| `lobbying-scraper/writer.py` | ✅ Done | Firestore document construction | +| `lobbying-scraper/scrape.py` | ✅ Done | Entry point; `--mode weekly` and `--mode backfill` | +| `lobbying-scraper/Dockerfile` | ✅ Done | Python 3.12 slim | +| `scripts/firebase-admin/backfillLobbying.ts` | ✅ Done | Calls `scrape.py --mode backfill` as subprocess | ### Document ID scheme diff --git a/functions/src/lobbying/http/.gitignore b/functions/src/lobbying/http/.gitignore new file mode 100644 index 000000000..d0ee3b17c --- /dev/null +++ b/functions/src/lobbying/http/.gitignore @@ -0,0 +1,3 @@ +venv/ +__pycache__/ +*.pyc diff --git a/functions/src/lobbying/http/fetch.py b/functions/src/lobbying/http/fetch.py new file mode 100644 index 000000000..4e6c2c4ec --- /dev/null +++ b/functions/src/lobbying/http/fetch.py @@ -0,0 +1,81 @@ +"""Minimal HTTP fetch helper for the lobbying portal. + +Handles the portal's session cookie requirements that standard Node.js HTTP +clients cannot satisfy due to TLS-layer constraints. + +Usage: + python3 fetch.py --url URL [--method GET|POST] [--jar PATH] + +POST body is read from stdin as application/x-www-form-urlencoded. +Cookies are persisted to/from the JSON file at --jar so the session survives +across multiple subprocess invocations. +HTML response is written to stdout. Errors go to stderr with exit code 1. +""" + +import argparse +import json +import sys +from pathlib import Path + +import requests + +_UA = ( + "Mozilla/5.0 (iPad; CPU OS 12_2 like Mac OS X) " + "AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148" +) + + +def main() -> None: + p = argparse.ArgumentParser() + p.add_argument("--url", required=True) + p.add_argument("--method", default="GET", choices=["GET", "POST"]) + p.add_argument("--jar", default=None, help="Path to JSON cookie-jar file") + args = p.parse_args() + + session = requests.Session() + session.headers.update( + { + "User-Agent": _UA, + "Accept": "*/*", + "Accept-Encoding": "gzip, deflate, br", + "Connection": "keep-alive", + } + ) + + if args.jar: + jar = Path(args.jar) + if jar.exists(): + try: + session.cookies.update(json.loads(jar.read_text())) + except Exception as e: + print(f"warning: could not read cookie jar: {e}", file=sys.stderr) + + try: + if args.method == "POST": + body = sys.stdin.buffer.read() + resp = session.post( + args.url, + data=body, + headers={"Content-Type": "application/x-www-form-urlencoded"}, + timeout=180, + ) + else: + resp = session.get(args.url, timeout=60) + + resp.raise_for_status() + + if args.jar: + Path(args.jar).write_text(json.dumps(dict(session.cookies))) + + sys.stdout.buffer.write(resp.content) + + except requests.exceptions.HTTPError as e: + print(f"HTTP error {e.response.status_code}: {args.url}", file=sys.stderr) + sys.exit(1) + except requests.exceptions.RequestException as e: + print(f"request failed: {e}", file=sys.stderr) + sys.exit(1) + + +if __name__ == "__main__": + main() diff --git a/functions/src/lobbying/http/requirements.txt b/functions/src/lobbying/http/requirements.txt new file mode 100644 index 000000000..b18d51347 --- /dev/null +++ b/functions/src/lobbying/http/requirements.txt @@ -0,0 +1 @@ +requests>=2.28 diff --git a/functions/src/lobbying/normalize.ts b/functions/src/lobbying/normalize.ts index 8d3d0a0ba..a7beb338f 100644 --- a/functions/src/lobbying/normalize.ts +++ b/functions/src/lobbying/normalize.ts @@ -5,8 +5,7 @@ * registrant may appear as "Acme Corp.", "ACME CORPORATION", "Acme, Inc. d/b/a * Acme Consulting", etc. across filings and years. * - * This pipeline is a direct port of the reference implementation used in the - * companion data analysis project. The steps must be applied in the exact order + * The steps must be applied in the exact order * listed here; changing the order produces different (incorrect) output. */ diff --git a/functions/src/lobbying/portal.ts b/functions/src/lobbying/portal.ts index e441522b8..64d65831b 100644 --- a/functions/src/lobbying/portal.ts +++ b/functions/src/lobbying/portal.ts @@ -19,6 +19,7 @@ import axios, { AxiosInstance } from "axios" import { JSDOM } from "jsdom" import { sha256 } from "js-sha256" +import { CookieJar } from "tough-cookie" import { CHAMBER_PREFIXES, LEGACY_CHAMBER_MAP, @@ -72,19 +73,68 @@ export interface DisclosureDetail { // ─── HTTP helpers ──────────────────────────────────────────────────────────── -export function makePortalClient(): AxiosInstance { - return axios.create({ - headers: { "User-Agent": IPAD_UA }, - timeout: 60_000 +/** + * Create an axios instance pre-configured for the MA SoS portal. + * + * Includes a cookie jar via interceptors so ASP.NET session state (ViewState, + * anti-forgery tokens) is preserved across the GET → POST page flow without + * requiring the axios-cookiejar-support package. + */ +export interface PortalClient { + jar: CookieJar + client: AxiosInstance +} + +/** + * Create a portal client pre-configured for the MA SoS portal. + * + * Uses maxRedirects: 0 so our manual redirect loop (inside getHtml / postHtml) + * can extract Set-Cookie headers at each hop before following. This is necessary + * because the portal is protected by Incapsula, which issues a 302 challenge on + * first contact and requires the session cookies to be sent on the retried request. + * Axios's built-in redirect following happens before response interceptors fire, + * so the cookies from the challenge response are never captured automatically. + */ +export function makePortalClient(): PortalClient { + const jar = new CookieJar() + const client = axios.create({ + headers: { + "User-Agent": IPAD_UA, + Accept: "*/*", + "Accept-Encoding": "gzip, deflate, br", + Connection: "keep-alive" + }, + timeout: 60_000, + maxRedirects: 10, // let axios handle ordinary redirects; only Incapsula challenges need manual handling + validateStatus: s => s < 500 // surface 4xx so we can log them }) + return { jar, client } } function sleep(ms: number): Promise { return new Promise(resolve => setTimeout(resolve, ms)) } +function cookieHeader(jar: CookieJar, url: string): string { + return jar + .getCookiesSync(url) + .map(c => c.cookieString()) + .join("; ") +} + +function saveCookies( + jar: CookieJar, + url: string, + headers: Record +): void { + const raw = headers["set-cookie"] + if (!raw) return + const list = Array.isArray(raw) ? raw : [raw] + for (const c of list) jar.setCookieSync(c, url) +} + async function getHtml( - client: AxiosInstance, + pc: PortalClient, url: string, retries = MAX_RETRIES ): Promise { @@ -93,10 +143,16 @@ async function getHtml( attempt === 0 ? REQUEST_DELAY_MS : REQUEST_DELAY_MS * 2 ** attempt ) try { - const res = await client.get(url, { + const res = await pc.client.get(url, { responseType: "text", - headers: { Accept: "text/html" } + headers: { Cookie: cookieHeader(pc.jar, url) } }) + saveCookies( + pc.jar, + url, + res.headers as Record + ) + if (res.status >= 400) throw new Error(`HTTP ${res.status} for ${url}`) return new JSDOM(res.data).window.document } catch (e) { if (attempt === retries - 1) throw e @@ -108,7 +164,7 @@ async function getHtml( } async function postHtml( - client: AxiosInstance, + pc: PortalClient, url: string, data: Record, retries = MAX_RETRIES @@ -119,14 +175,20 @@ async function postHtml( attempt === 0 ? REQUEST_DELAY_MS : REQUEST_DELAY_MS * 2 ** attempt ) try { - const res = await client.post(url, body, { + const res = await pc.client.post(url, body, { responseType: "text", headers: { "Content-Type": "application/x-www-form-urlencoded", - Accept: "text/html" + Cookie: cookieHeader(pc.jar, url) }, timeout: 180_000 }) + saveCookies( + pc.jar, + url, + res.headers as Record + ) + if (res.status >= 400) throw new Error(`HTTP ${res.status} for ${url}`) return new JSDOM(res.data).window.document } catch (e) { if (attempt === retries - 1) throw e @@ -237,10 +299,10 @@ function extractViewState(doc: Document): Record { * Sends a single search POST with page size 20000 to get all registrants at once. */ export async function fetchSummaryLinks( - client: AxiosInstance, + pc: PortalClient, year: number ): Promise { - const searchPage = await getHtml(client, SEARCH_URL) + const searchPage = await getHtml(pc, SEARCH_URL) const vs = extractViewState(searchPage) const postData: Record = { @@ -257,7 +319,7 @@ export async function fetchSummaryLinks( ctl00$ContentPlaceHolder1$btnSearch: "Search" } - const resultsPage = await postHtml(client, SEARCH_URL, postData) + const resultsPage = await postHtml(pc, SEARCH_URL, postData) const table = resultsPage.querySelector( '[id*="grdvSearchResultByTypeAndCategory"]' @@ -280,10 +342,10 @@ export async function fetchSummaryLinks( * Fetch a Summary.aspx page and return the registrant metadata + disclosure URLs. */ export async function fetchDisclosureMeta( - client: AxiosInstance, + pc: PortalClient, summaryUrl: string ): Promise { - const doc = await getHtml(client, summaryUrl) + const doc = await getHtml(pc, summaryUrl) const text = (id: string) => { const el = doc.getElementById(id) @@ -322,11 +384,11 @@ export async function fetchDisclosureMeta( * Handles both modern (≥~2013) and legacy (<~2013) HTML layouts. */ export async function fetchDisclosureDetail( - client: AxiosInstance, + pc: PortalClient, discUrl: string, year: number ): Promise { - const doc = await getHtml(client, discUrl) + const doc = await getHtml(pc, discUrl) const compensation: RawCompensation[] = [] const bills: RawBillActivity[] = [] diff --git a/lobbying-scraper/.dockerignore b/lobbying-scraper/.dockerignore new file mode 100644 index 000000000..9460c99c4 --- /dev/null +++ b/lobbying-scraper/.dockerignore @@ -0,0 +1,4 @@ +__pycache__/ +*.pyc +*.pyo +.env diff --git a/lobbying-scraper/Dockerfile b/lobbying-scraper/Dockerfile new file mode 100644 index 000000000..738293459 --- /dev/null +++ b/lobbying-scraper/Dockerfile @@ -0,0 +1,14 @@ +FROM python:3.12-slim + +WORKDIR /app + +COPY requirements.txt . +RUN pip install --no-cache-dir -r requirements.txt + +COPY normalize.py portal.py writer.py scrape.py ./ + +# Cloud Run sets PORT; we don't use it (this is a job, not a server). +# Cloud Scheduler invokes the container via HTTP POST to /; handle it minimally. +ENV PYTHONUNBUFFERED=1 + +CMD ["python3", "scrape.py", "--mode", "weekly"] diff --git a/lobbying-scraper/__pycache__/normalize.cpython-37.pyc b/lobbying-scraper/__pycache__/normalize.cpython-37.pyc new file mode 100644 index 0000000000000000000000000000000000000000..47c3ba707ebdca4ef16776e15507d9f385437cab GIT binary patch literal 1412 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 literal 0 HcmV?d00001 diff --git a/lobbying-scraper/normalize.py b/lobbying-scraper/normalize.py new file mode 100644 index 000000000..6e6f7418e --- /dev/null +++ b/lobbying-scraper/normalize.py @@ -0,0 +1,50 @@ +"""Entity name normalization pipeline. + +Direct port of functions/src/lobbying/normalize.ts. Steps must be applied in +this exact order — changing the order produces different (incorrect) output. +""" + +from __future__ import annotations + +import re + +_DBA_RE = re.compile(r"\s+D\s*/+B\s*/+A?\s+.*|\s+DBA\s+.*", re.IGNORECASE) +_LEGAL_RE = re.compile( + r"\b(LLC|LLP|INC|INCORPORATED|CORPORATION|CORP|LTD|LIMITED|PC|PLLC)\b" +) +_THE_RE = re.compile(r"\bTHE\b") +_WS_RE = re.compile(r"\s+") + +_MISC_PHRASES = [ + "LAW OFFICE OF", + "AND ASSOCIATES", + "& ASSOCIATES", + "AND ASSOC", + "ATTORNEY AT LAW", + "ATTORNEY@LAW", + "ATTORNET AT LAW", # known portal typo + "AND PARTNERS", + "PUBLIC POLICY GROUP", + "LEGISLATIVE SERVICES", + "POLICY GROUP", + "ASSOCIATES", + "COUNSELLORS AT LAW", +] + + +def normalize_entity_name(raw: str | None) -> str: + if not raw: + return "" + x = raw.upper() # 1. uppercase + x = _DBA_RE.sub("", x) # 2. strip d/b/a suffix + x = x.replace("-", " ") # 3. hyphen → space + for ch in (",", ".", "'", "‘", "’", "(", ")"): + x = x.replace(ch, " ") # 4. punctuation → space + x = _LEGAL_RE.sub(" ", x) # 5. remove legal entity words + x = _THE_RE.sub(" ", x) # 6. remove THE anywhere + x = x.replace("&", "AND") # 7. ampersand → AND + x = x.replace("ASSICIATES", "ASSOCIATES") # 8. fix known typo + for phrase in _MISC_PHRASES: # 9. remove professional suffix phrases + x = x.replace(phrase, " ") + x = _WS_RE.sub(" ", x).strip() # 10. collapse whitespace + return x diff --git a/lobbying-scraper/portal.py b/lobbying-scraper/portal.py new file mode 100644 index 000000000..257721991 --- /dev/null +++ b/lobbying-scraper/portal.py @@ -0,0 +1,376 @@ +"""HTTP client and HTML parser for the MA SoS lobbying portal. + +Portal: https://www.sec.state.ma.us/LobbyistPublicSearch/ + +Page flow: + 1. Search POST → summary links table + 2. Summary.aspx → registrant name/year/type + CompleteDisclosure links + 3. CompleteDisclosure.aspx → per-client compensation + per-client bill activity + +Two disclosure HTML formats: + Modern (>=~2013): grdvClientPaidToEntity + grdvActivitiesNew{year}_{n} tables. + Legacy (<~2013): grdvSalaryPaid (total only) + grdvActivities (all bills). +""" + +from __future__ import annotations + +import hashlib +import re +import time +from dataclasses import dataclass, field +from typing import Optional + +import requests +from bs4 import BeautifulSoup, Tag + +# ── Constants ───────────────────────────────────────────────────────────────── + +BASE_URL = "https://www.sec.state.ma.us/LobbyistPublicSearch/" +SEARCH_URL = BASE_URL + "Default.aspx" + +_UA = ( + "Mozilla/5.0 (iPad; CPU OS 12_2 like Mac OS X) " + "AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148" +) +_REQUEST_DELAY = 1.0 +_MAX_RETRIES = 5 + +# Lobby disclosure data begins in 2005; GC 183 started Jan 2003. +FIRST_YEAR = 2005 +FIRST_GC = 183 +FIRST_GC_START_YEAR = 2003 + +# clientName sentinel for pre-2013 filings where compensation is a single total +LEGACY_TOTAL_CLIENT = "_total_salary_" + +# Maps canonical chamber names to the bill-ID prefix used in MAPLE's Bill.id +CHAMBER_PREFIXES: dict[str, str] = { + "House Bill": "H", + "Senate Bill": "S", + "House Docket": "HD", + "Senate Docket": "SD", +} + +# Legacy short-form chamber codes found in older filings +LEGACY_CHAMBER_MAP: dict[str, str] = { + "HB": "House Bill", + "SB": "Senate Bill", +} + +# ── Data types ──────────────────────────────────────────────────────────────── + + +@dataclass +class Compensation: + client_name: str + amount: Optional[float] + + +@dataclass +class BillActivity: + client_name: str + chamber: str # canonical LobbyingChamber value + raw_bill_number: str + bill_id: Optional[str] # e.g. "H1234"; null for Executive/Other + activity_title: str + position: str + amount: Optional[float] + + +@dataclass +class DisclosureMeta: + entity_name: str + year: Optional[int] + reg_type: str # "Lobbyist" | "Employer" + disclosure_urls: list[str] = field(default_factory=list) + + +@dataclass +class DisclosureDetail: + compensation: list[Compensation] = field(default_factory=list) + bills: list[BillActivity] = field(default_factory=list) + + +# ── Derived-value helpers ───────────────────────────────────────────────────── + + +def year_to_general_court(year: int) -> int: + return FIRST_GC + (year - FIRST_GC_START_YEAR) // 2 + + +def normalize_chamber(raw: str) -> str: + t = raw.strip() + if t in LEGACY_CHAMBER_MAP: + return LEGACY_CHAMBER_MAP[t] + known = {"House Bill", "Senate Bill", "House Docket", "Senate Docket", "Executive"} + return t if t in known else "Other" + + +def construct_bill_id(chamber: str, raw_bill_number: str) -> Optional[str]: + """Construct the MAPLE-compatible billId from chamber + raw integer. + + Returns None for Executive and Other chambers where no bill join is possible. + H1234 and S1234 are distinct bills even though they share the same integer — + the prefix is required to disambiguate. + """ + prefix = CHAMBER_PREFIXES.get(chamber) + if not prefix: + return None + try: + return f"{prefix}{int(raw_bill_number)}" + except (ValueError, TypeError): + return None + + +def registrant_id(entity_name: str, year: int) -> str: + key = f"{year}|{entity_name}" + return hashlib.sha256(key.encode()).hexdigest()[:40] + + +def filing_id( + entity_name: str, + client_name: str, + chamber: str, + bill_id: Optional[str], + general_court: int, + position: str, +) -> str: + key = "|".join([entity_name, client_name, chamber, bill_id or "__null__", + str(general_court), position]) + return hashlib.sha256(key.encode()).hexdigest()[:40] + + +# ── HTTP session ────────────────────────────────────────────────────────────── + + +def make_session() -> requests.Session: + s = requests.Session() + s.headers.update({ + "User-Agent": _UA, + "Accept": "*/*", + "Accept-Encoding": "gzip, deflate, br", + "Connection": "keep-alive", + }) + return s + + +def _get(session: requests.Session, url: str) -> BeautifulSoup: + for attempt in range(_MAX_RETRIES): + time.sleep(_REQUEST_DELAY * (2 ** attempt) if attempt else _REQUEST_DELAY) + try: + r = session.get(url, timeout=60) + r.raise_for_status() + return BeautifulSoup(r.text, "html.parser") + except (requests.exceptions.Timeout, requests.exceptions.ConnectionError) as e: + if attempt == _MAX_RETRIES - 1: + raise + print(f" GET retry {attempt + 1}: {e}") + + +def _post(session: requests.Session, url: str, data: dict) -> BeautifulSoup: + for attempt in range(_MAX_RETRIES): + time.sleep(_REQUEST_DELAY * (2 ** attempt) if attempt else _REQUEST_DELAY) + try: + r = session.post(url, data=data, timeout=180) + r.raise_for_status() + return BeautifulSoup(r.text, "html.parser") + except (requests.exceptions.Timeout, requests.exceptions.ConnectionError) as e: + if attempt == _MAX_RETRIES - 1: + raise + print(f" POST retry {attempt + 1}: {e}") + + +# ── Portal scraping ─────────────────────────────────────────────────────────── + + +def _viewstate(soup: BeautifulSoup) -> dict: + return { + inp["name"]: inp.get("value", "") + for inp in soup.find_all("input", type="hidden") + if inp.get("name") + } + + +def fetch_summary_links(session: requests.Session, year: int) -> list[str]: + """Return all Summary.aspx URLs for a given year via a single search POST.""" + soup = _get(session, SEARCH_URL) + data = { + **_viewstate(soup), + "__EVENTTARGET": "", + "__EVENTARGUMENT": "", + "ctl00$ContentPlaceHolder1$Search": "rdbSearchByType", + "ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$ddlYear": str(year), + "ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$txtN_ame": "", + "ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$lddSearchType$DropDown": "3", + "ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$drpType": "L", + "ctl00$ContentPlaceHolder1$drpPageSize": "20000", + "ctl00$ContentPlaceHolder1$btnSearch": "Search", + } + results = _post(session, SEARCH_URL, data) + table = results.find("table", id=lambda x: x and "grdvSearchResultByTypeAndCategory" in x) + if not table: + return [] + return [ + BASE_URL + a["href"] if not a["href"].startswith("http") else a["href"] + for a in table.find_all("a", href=True) + if "Summary.aspx" in a["href"] + ] + + +def fetch_disclosure_meta(session: requests.Session, summary_url: str) -> DisclosureMeta: + soup = _get(session, summary_url) + + def text(el_id: str) -> str: + el = soup.find(id=el_id) + return el.get_text(strip=True) if el else "" + + entity_name = text("ContentPlaceHolder1_lblRegistrantName") + year_text = text("ContentPlaceHolder1_lblYear") + reg_type_raw = text("ContentPlaceHolder1_lblRegType") + + try: + year = int(year_text) + except ValueError: + year = None + + reg_type = "Employer" if "Entity" in reg_type_raw else "Lobbyist" + + disc_urls = [ + BASE_URL + a["href"] if not a["href"].startswith("http") else a["href"] + for a in soup.find_all("a", href=True) + if "CompleteDisclosure" in a["href"] + ] + + return DisclosureMeta( + entity_name=entity_name, + year=year, + reg_type=reg_type, + disclosure_urls=disc_urls, + ) + + +def _parse_amount(text: str) -> Optional[float]: + cleaned = text.replace("$", "").replace(",", "").strip() + try: + return float(cleaned) + except ValueError: + return None + + +def _grid_rows(table: Tag) -> list[Tag]: + return table.find_all("tr", class_=lambda c: c and "Grid" in c and "Header" not in c) + + +def fetch_disclosure_detail( + session: requests.Session, disc_url: str, year: int +) -> DisclosureDetail: + soup = _get(session, disc_url) + compensation: list[Compensation] = [] + bills: list[BillActivity] = [] + gc = year_to_general_court(year) + + # ── Modern format (>=~2013) ─────────────────────────────────────────────── + comp_table = soup.find("table", id=lambda x: x and "grdvClientPaidToEntity" in (x or "")) + if comp_table: + for row in _grid_rows(comp_table): + cells = [td.get_text(strip=True) for td in row.find_all("td")] + if len(cells) >= 2: + compensation.append(Compensation( + client_name=cells[0], + amount=_parse_amount(cells[1]), + )) + + act_tables = soup.find_all( + "table", + id=lambda x: x and re.search(r"grdvActivitiesNew(\d{4})?_\d+", x or ""), + ) + for act_table in act_tables: + # Walk backwards to find the nearest lblClientName span + client_name = "" + node = act_table + while node: + node = node.find_previous(["span", "div", "td"]) + if not node: + break + if node.get("id") and "lblClientName" in node["id"]: + client_name = node.get_text(strip=True) + break + + for row in _grid_rows(act_table): + cells = [td.get_text(strip=True) for td in row.find_all("td")] + if len(cells) < 4: + continue + chamber = normalize_chamber(cells[0]) + raw_num = cells[1] + bill_id = construct_bill_id(chamber, raw_num) + bills.append(BillActivity( + client_name=client_name, + chamber=chamber, + raw_bill_number=raw_num, + bill_id=bill_id, + activity_title=cells[2] if len(cells) > 2 else "", + position=cells[3] if len(cells) > 3 else "", + amount=_parse_amount(cells[4]) if len(cells) > 4 else None, + )) + + if comp_table or bills: + return DisclosureDetail(compensation=compensation, bills=bills) + + # ── Legacy format (<~2013) ──────────────────────────────────────────────── + salary_table = soup.find("table", id=lambda x: x and "grdvSalaryPaid" in (x or "")) + if salary_table: + total = 0.0 + for row in salary_table.find_all("tr"): + cells = [td.get_text(strip=True) for td in row.find_all("td")] + if len(cells) >= 2 and "Total" not in cells[0]: + amt = _parse_amount(cells[1]) + if amt: + total += amt + if total: + compensation.append(Compensation(client_name=LEGACY_TOTAL_CLIENT, amount=total)) + + act_table = soup.find("table", id=lambda x: x and x.endswith("grdvActivities")) + if act_table: + all_rows = act_table.find_all("tr") + headers = [th.get_text(strip=True) + for th in (all_rows[0].find_all(["th", "td"]) if all_rows else [])] + + if headers and "Activity" in headers[0]: + # 6-col entity layout has Lobbyist as second header + if len(headers) >= 2 and "Lobbyist" in headers[1]: + bill_col, pos_col, client_col = 0, 2, 4 + else: + bill_col, pos_col, client_col = 0, 1, 3 + else: + bill_col, pos_col, client_col = 1, None, 3 + + chamber_map = {"H": "House Bill", "S": "Senate Bill", + "HD": "House Docket", "SD": "Senate Docket"} + skip = {"Activity or Bill No and Title", "N/A", "None", "", "Total amount"} + + for row in all_rows[1:]: + cells = [td.get_text(strip=True) for td in row.find_all("td")] + if len(cells) <= max(bill_col, client_col): + continue + bill_cell = cells[bill_col] + if not bill_cell or bill_cell in skip: + continue + parts = bill_cell.split(None, 1) + bill_no = parts[0] + m = re.match(r"^([A-Z]+)(\d+)$", bill_no) + if not m: + continue + prefix, number = m.group(1), m.group(2) + chamber = chamber_map.get(prefix, "Other") + bill_id = construct_bill_id(chamber, number) + bills.append(BillActivity( + client_name=cells[client_col] if len(cells) > client_col else "", + chamber=chamber, + raw_bill_number=number, + bill_id=bill_id, + activity_title=parts[1] if len(parts) > 1 else "", + position=cells[pos_col] if pos_col is not None and len(cells) > pos_col else "", + amount=None, + )) + + return DisclosureDetail(compensation=compensation, bills=bills) diff --git a/lobbying-scraper/requirements.txt b/lobbying-scraper/requirements.txt new file mode 100644 index 000000000..5e7b4bcc7 --- /dev/null +++ b/lobbying-scraper/requirements.txt @@ -0,0 +1,3 @@ +requests>=2.28 +beautifulsoup4>=4.12 +google-cloud-firestore>=2.14 diff --git a/lobbying-scraper/scrape.py b/lobbying-scraper/scrape.py new file mode 100644 index 000000000..fb985e05f --- /dev/null +++ b/lobbying-scraper/scrape.py @@ -0,0 +1,269 @@ +"""Lobbying disclosure scraper — Cloud Run entry point. + +Runs on a weekly Cloud Scheduler trigger. Checks for new or amended disclosures +and exits immediately if none are found (fast path). When new disclosures exist, +fetches and writes them to Firestore. + +Also serves as the library used by the TypeScript backfill admin script via +subprocess. + +Environment variables: + GOOGLE_CLOUD_PROJECT — GCP project ID (set automatically in Cloud Run) + FIRESTORE_EMULATOR_HOST — set to use the local emulator (e.g. localhost:8080) + +CLI flags (for local / backfill use): + --year YEAR Only process this year (default: current + prior) + --limit N Max registrants per year (for testing) + --dry-run Fetch and parse but do not write to Firestore +""" + +from __future__ import annotations + +import argparse +import hashlib +import json +import sys +from datetime import datetime, timezone + +from google.cloud import firestore + +from portal import ( + FIRST_YEAR, + fetch_disclosure_detail, + fetch_disclosure_meta, + fetch_summary_links, + make_session, +) +from writer import ( + BACKFILL_DOC, + BACKFILL_URLS_COLLECTION, + SCRAPER_DOC, + write_filings, + write_registrant, +) + + +# ── Cursor helpers ──────────────────────────────────────────────────────────── + + +def _load_live_cursor(db: firestore.Client) -> tuple[set[str], dict[str, list[str]]]: + """Return (processedDiscUrls, summaryDiscCache) from the live scraper doc.""" + doc = db.document(SCRAPER_DOC).get() + data = doc.to_dict() or {} + return ( + set(data.get("processedDiscUrls", [])), + data.get("summaryDiscCache", {}), + ) + + +def _save_live_cursor( + db: firestore.Client, + processed: set[str], + cache: dict[str, list[str]], +) -> None: + db.document(SCRAPER_DOC).set( + {"processedDiscUrls": list(processed), "summaryDiscCache": cache}, + merge=True, + ) + + +def _is_backfill_processed(db: firestore.Client, disc_url: str) -> bool: + h = hashlib.sha256(disc_url.encode()).hexdigest()[:40] + return db.document(BACKFILL_DOC).collection(BACKFILL_URLS_COLLECTION).document(h).get().exists + + +def _mark_backfill_processed(db: firestore.Client, disc_url: str) -> None: + h = hashlib.sha256(disc_url.encode()).hexdigest()[:40] + db.document(BACKFILL_DOC).collection(BACKFILL_URLS_COLLECTION).document(h).set( + {"url": disc_url, "processedAt": datetime.now(tz=timezone.utc).isoformat()} + ) + + +# ── Core processing ─────────────────────────────────────────────────────────── + + +def process_disclosure( + db: firestore.Client | None, + session, + summary_url: str, + disc_url: str, + year: int, + dry_run: bool = False, +) -> tuple[int, int]: + """Fetch one disclosure page and write registrant + filing documents. + + Returns (compensation_rows, filing_rows). + """ + meta = fetch_disclosure_meta(session, summary_url) + detail = fetch_disclosure_detail(session, disc_url, year) + + if dry_run or db is None: + return len(detail.compensation), len(detail.bills) + + write_registrant(db, meta, detail, disc_url) + n_filings = write_filings(db, meta, detail) + return len(detail.compensation), n_filings + + +# ── Weekly incremental run ──────────────────────────────────────────────────── + + +def run_weekly( + db: "firestore.Client | None", + years: list[int], + limit: int | None = None, + dry_run: bool = False, +) -> int: + """Incremental weekly check. Returns number of new disclosures processed.""" + current_year = datetime.now(tz=timezone.utc).year + processed, cache = _load_live_cursor(db) if db is not None else (set(), {}) + + session = make_session() + new_count = 0 + + for year in years: + print(f"\n── {year} ──") + try: + summary_urls = fetch_summary_links(session, year) + except Exception as e: + print(f" failed to fetch summary links: {e}", file=sys.stderr) + continue + + if limit: + summary_urls = summary_urls[:limit] + + print(f" {len(summary_urls)} registrants on portal") + + for summary_url in summary_urls: + # Use cached disc URLs for prior years; always re-check current year + disc_urls = cache.get(summary_url) + if disc_urls is None or year == current_year: + try: + meta = fetch_disclosure_meta(session, summary_url) + disc_urls = meta.disclosure_urls + cache[summary_url] = disc_urls + if not dry_run: + _save_live_cursor(db, processed, cache) + except Exception as e: + print(f" failed to fetch summary {summary_url}: {e}", file=sys.stderr) + continue + + new_disc_urls = [u for u in disc_urls if u not in processed] + if not new_disc_urls: + continue + + for disc_url in new_disc_urls: + try: + comp_n, filing_n = process_disclosure( + db, session, summary_url, disc_url, year, dry_run=dry_run + ) + processed.add(disc_url) + new_count += 1 + print(f" processed: {comp_n} clients, {filing_n} filings") + if not dry_run: + _save_live_cursor(db, processed, cache) + except Exception as e: + print(f" failed to process {disc_url}: {e}", file=sys.stderr) + + return new_count + + +# ── Historical backfill ─────────────────────────────────────────────────────── + + +def run_backfill( + db: "firestore.Client | None", + years: list[int], + limit: int | None = None, + dry_run: bool = False, +) -> int: + """Full historical backfill using the subcollection cursor. Resumable.""" + session = make_session() + total_new = 0 + + for year in years: + print(f"\n── {year} ──") + try: + summary_urls = fetch_summary_links(session, year) + except Exception as e: + print(f" failed to fetch summary links: {e}", file=sys.stderr) + continue + + if limit: + summary_urls = summary_urls[:limit] + + print(f" {len(summary_urls)} registrants on portal") + year_new = 0 + + for i, summary_url in enumerate(summary_urls): + try: + meta = fetch_disclosure_meta(session, summary_url) + except Exception as e: + print(f" [{i+1}/{len(summary_urls)}] failed to fetch summary: {e}", file=sys.stderr) + continue + + for disc_url in meta.disclosure_urls: + if db is not None and not dry_run and _is_backfill_processed(db, disc_url): + continue + try: + comp_n, filing_n = process_disclosure( + db, session, summary_url, disc_url, year, dry_run=dry_run + ) + if not dry_run: + _mark_backfill_processed(db, disc_url) + total_new += 1 + year_new += 1 + except Exception as e: + print(f" failed to process {disc_url}: {e}", file=sys.stderr) + + if (i + 1) % 50 == 0 or i + 1 == len(summary_urls): + print(f" [{i+1}/{len(summary_urls)}] {year_new} new disclosures so far") + + print(f" {year} complete: {year_new} new disclosures") + + return total_new + + +# ── Entry point ─────────────────────────────────────────────────────────────── + + +def main() -> None: + p = argparse.ArgumentParser() + p.add_argument("--year", type=int, default=None) + p.add_argument("--limit", type=int, default=None) + p.add_argument("--dry-run", action="store_true") + p.add_argument( + "--mode", + choices=["weekly", "backfill"], + default="weekly", + help="weekly: incremental check; backfill: full history with subcollection cursor", + ) + args = p.parse_args() + + current_year = datetime.now(tz=timezone.utc).year + + if args.year: + years = [args.year] + elif args.mode == "weekly": + years = [current_year, current_year - 1] + else: + years = list(range(FIRST_YEAR, current_year + 1)) + + db = firestore.Client() if not args.dry_run else None + + if args.mode == "weekly": + n = run_weekly(db, years, limit=args.limit, dry_run=args.dry_run) + if n == 0: + print("\nNo new disclosures found.") + else: + print(f"\nDone: {n} new disclosures written.") + else: + n = run_backfill(db, years, limit=args.limit, dry_run=args.dry_run) + print(f"\nBackfill complete: {n} new disclosures written.") + + # Emit structured result for callers (e.g. TypeScript backfill script) + print(json.dumps({"newDisclosures": n}), file=sys.stderr) + + +if __name__ == "__main__": + main() diff --git a/lobbying-scraper/writer.py b/lobbying-scraper/writer.py new file mode 100644 index 000000000..a6804f401 --- /dev/null +++ b/lobbying-scraper/writer.py @@ -0,0 +1,126 @@ +"""Firestore document construction and write helpers. + +Mirrors the data model in functions/src/lobbying/types.ts. All collection +names and field names must stay in sync with that file. +""" + +from __future__ import annotations + +from datetime import datetime, timezone +from typing import TYPE_CHECKING + +from normalize import normalize_entity_name +from portal import ( + BillActivity, + Compensation, + DisclosureDetail, + DisclosureMeta, + filing_id, + registrant_id, + year_to_general_court, +) + +if TYPE_CHECKING: + from google.cloud import firestore + +REGISTRANTS_COLLECTION = "lobbyingRegistrants" +FILINGS_COLLECTION = "lobbyingFilings" +SCRAPER_DOC = "/scrapers/lobbying" +BACKFILL_DOC = "/scrapers/lobbyingBackfill" +BACKFILL_URLS_COLLECTION = "processedUrls" + + +def _now() -> datetime: + return datetime.now(tz=timezone.utc) + + +def write_registrant( + db: firestore.Client, + meta: DisclosureMeta, + detail: DisclosureDetail, + disc_url: str, +) -> None: + """Upsert a LobbyingRegistrant document.""" + if not meta.entity_name or meta.year is None: + return + + doc_id = registrant_id(meta.entity_name, meta.year) + ref = db.collection(REGISTRANTS_COLLECTION).document(doc_id) + + clients = [ + { + "clientName": c.client_name, + "clientNameNorm": normalize_entity_name(c.client_name), + "compensation": c.amount, + } + for c in detail.compensation + ] + + data = { + "registrantId": doc_id, + "entityName": meta.entity_name, + "entityNameNorm": normalize_entity_name(meta.entity_name), + "year": meta.year, + "generalCourt": year_to_general_court(meta.year), + "regType": meta.reg_type, + "clients": clients, + "disclosureUrls": firestore.ArrayUnion([disc_url]), + "fetchedAt": _now(), + } + ref.set(data, merge=True) + + +def write_filings( + db: firestore.Client, + meta: DisclosureMeta, + detail: DisclosureDetail, +) -> int: + """Batch-write LobbyingFiling documents. Returns the number written.""" + if not meta.entity_name or meta.year is None or not detail.bills: + return 0 + + gc = year_to_general_court(meta.year) + entity_name = meta.entity_name + entity_norm = normalize_entity_name(entity_name) + now = _now() + + batch = db.batch() + count = 0 + + for bill in detail.bills: + fid = filing_id( + entity_name, + bill.client_name, + bill.chamber, + bill.bill_id, + gc, + bill.position, + ) + ref = db.collection(FILINGS_COLLECTION).document(fid) + doc = { + "filingId": fid, + "entityName": entity_name, + "entityNameNorm": entity_norm, + "clientName": bill.client_name, + "clientNameNorm": normalize_entity_name(bill.client_name), + "year": meta.year, + "generalCourt": gc, + "chamber": bill.chamber, + "billId": bill.bill_id, + "activityTitle": bill.activity_title, + "position": bill.position, + "amount": bill.amount, + "fetchedAt": now, + } + batch.set(ref, doc) + count += 1 + + # Firestore batch limit is 500 writes + if count % 400 == 0: + batch.commit() + batch = db.batch() + + if count % 400 != 0: + batch.commit() + + return count diff --git a/scripts/firebase-admin/backfillLobbying.ts b/scripts/firebase-admin/backfillLobbying.ts index f7914dd84..a2a66330e 100644 --- a/scripts/firebase-admin/backfillLobbying.ts +++ b/scripts/firebase-admin/backfillLobbying.ts @@ -1,156 +1,64 @@ /** * Backfill lobbying disclosure data from 2005 to the present. * - * This script is the primary ingestion path for all historical data. The live - * Cloud Function (scrapeLobbying) only handles the current and prior year in - * steady state. Run this once to populate the full history, and re-run with - * --year to refresh specific years. + * Delegates all HTTP fetching and Firestore writes to the Python scraper in + * lobbying-scraper/. The TypeScript layer handles argument parsing and + * environment setup only. * * Usage: * GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ * yarn firebase-admin run-script backfillLobbying --env dev * - * Options: - * --year NUMBER Only process this year (useful for testing or re-runs) - * --limit NUMBER Max registrants to process per year (for testing) + * Options (passed through to scrape.py): + * --year NUMBER Only process this year + * --limit NUMBER Max registrants per year (for testing) * - * Cursor storage: - * Processed disclosure URLs are stored as documents in the Firestore - * subcollection /scrapers/lobbyingBackfill/processedUrls/{urlHash}. - * This scales to the full historical URL set (~50,000+) without hitting the - * 1MB Firestore document size limit. Restart the script at any time; it will - * resume from where it left off. + * Requires: pip install -r lobbying-scraper/requirements.txt + * Or run inside the maple-2025 conda environment. */ -import { createHash } from "crypto" +import { spawn } from "child_process" +import path from "path" import { z } from "zod" -import { - allLobbyingYears, - processDisclosure, - writeRegistrant -} from "../../functions/src/lobbying/scrapeLobbying" -import { - fetchDisclosureMeta, - fetchSummaryLinks, - makePortalClient -} from "../../functions/src/lobbying/portal" -import { - BACKFILL_DOC, - BACKFILL_URLS_COLLECTION, - FIRST_LOBBYING_YEAR -} from "../../functions/src/lobbying/types" import { Script } from "./types" const Args = z .object({ - year: z.number().int().min(FIRST_LOBBYING_YEAR).optional(), + year: z.number().int().min(2005).optional(), limit: z.number().int().positive().optional() }) .passthrough() -export const script: Script = async ({ db, args }) => { - const { year: onlyYear, limit } = Args.parse(args) +const SCRAPER = path.resolve(__dirname, "../../lobbying-scraper/scrape.py") - const years = onlyYear ? [onlyYear] : allLobbyingYears() - console.log( - `backfillLobbying: processing years ${years[0]}–${years[years.length - 1]}` - ) - - // Load already-processed disc URLs from the subcollection cursor. - const backfillRef = db.doc(BACKFILL_DOC) - const processedSnap = await backfillRef - .collection(BACKFILL_URLS_COLLECTION) - .select() // fetch only doc IDs (the URL hash), no field data needed - .get() - const processedHashes = new Set(processedSnap.docs.map(d => d.id)) - console.log( - `backfillLobbying: ${processedHashes.size} disc URLs already processed` - ) - - const client = makePortalClient() - let totalNew = 0 - - for (const year of years) { - console.log(`\n── ${year} ──`) - - let summaryUrls: string[] - try { - summaryUrls = await fetchSummaryLinks(client, year) - } catch (e) { - console.error(` Failed to fetch summary links for ${year}:`, e) - continue - } - - if (limit) summaryUrls = summaryUrls.slice(0, limit) - console.log(` ${summaryUrls.length} registrants on portal`) - - let yearNew = 0 - - for (let i = 0; i < summaryUrls.length; i++) { - const summaryUrl = summaryUrls[i] - let meta: Awaited> +export const script: Script = async ({ env, args }) => { + const { year, limit } = Args.parse(args) - try { - meta = await fetchDisclosureMeta(client, summaryUrl) - } catch (e) { - console.warn( - ` [${i + 1}/${ - summaryUrls.length - }] Failed to fetch summary: ${summaryUrl}`, - e - ) - continue - } - - if (meta.entityName && meta.year) { - try { - await writeRegistrant( - db, - meta.entityName, - meta.year, - meta.regType, - meta.disclosureUrls - ) - } catch (e) { - console.warn(` Failed to write registrant ${meta.entityName}:`, e) - } - } - - for (const discUrl of meta.disclosureUrls) { - const urlHash = createHash("sha256") - .update(discUrl) - .digest("hex") - .slice(0, 40) - if (processedHashes.has(urlHash)) continue - - try { - await processDisclosure(db, client, summaryUrl, discUrl, year) - - // Mark as processed in the subcollection cursor - await backfillRef - .collection(BACKFILL_URLS_COLLECTION) - .doc(urlHash) - .set({ url: discUrl, processedAt: new Date().toISOString() }) - - processedHashes.add(urlHash) - totalNew++ - yearNew++ - } catch (e) { - console.warn(` Failed to process disclosure ${discUrl}:`, e) - } - } + if (env === "local") { + throw new Error( + "backfillLobbying requires --env dev or --env prod " + + "(it writes to a real Firestore project; local emulator not supported yet)" + ) + } - if ((i + 1) % 50 === 0 || i + 1 === summaryUrls.length) { - console.log( - ` [${i + 1}/${ - summaryUrls.length - }] ${yearNew} new disclosures this year` - ) - } - } + const pyArgs = ["--mode", "backfill"] + if (year) pyArgs.push("--year", String(year)) + if (limit) pyArgs.push("--limit", String(limit)) - console.log(` ${year} complete: ${yearNew} new disclosures`) - } + console.log(`Running: python3 ${SCRAPER} ${pyArgs.join(" ")}`) + console.log( + `Firestore project: ${process.env.GCLOUD_PROJECT || "(from ADC)"}` + ) - console.log(`\nbackfillLobbying complete: ${totalNew} new disclosures total`) + await new Promise((resolve, reject) => { + const proc = spawn("python3", [SCRAPER, ...pyArgs], { + stdio: ["ignore", "inherit", "inherit"], + env: { ...process.env } + }) + proc.on("close", code => { + if (code === 0) resolve() + else reject(new Error(`scrape.py exited with code ${code}`)) + }) + proc.on("error", reject) + }) } From 2bcb783f2e2e71631b524f49f5b194eb2d551e63 Mon Sep 17 00:00:00 2001 From: Nathan Date: Mon, 8 Jun 2026 22:05:04 -0400 Subject: [PATCH 4/8] refactor: remove dead TypeScript scraper code from lobbying module MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per code review feedback: the TypeScript Firebase Function and backfill script added no value — the portal's TLS fingerprinting requirements mean Node.js cannot reach it, so the TS HTTP layer was non-functional and the backfill script was just a thin subprocess wrapper with no benefit over calling scrape.py directly. Removed: - functions/src/lobbying/scrapeLobbying.ts (broken Cloud Function) - functions/src/lobbying/portal.ts (non-functional TS HTTP layer) - functions/src/lobbying/http/ (unused Python fetch helper) - scripts/firebase-admin/backfillLobbying.ts (shell wrapper, no value) - scrapeLobbying export from functions/src/index.ts Kept: - functions/src/lobbying/types.ts — Firestore schema; imported by frontend - functions/src/lobbying/normalize.ts — normalization pipeline - lobbying-scraper/ — the working Cloud Run container (unchanged) The historical backfill is now run directly: python3 lobbying-scraper/scrape.py --mode backfill Co-Authored-By: Claude Sonnet 4.6 --- docs/lobbying-disclosure-ingestion.md | 108 ++-- functions/src/index.ts | 2 - functions/src/lobbying/http/.gitignore | 3 - functions/src/lobbying/http/fetch.py | 81 --- functions/src/lobbying/http/requirements.txt | 1 - functions/src/lobbying/index.ts | 10 - functions/src/lobbying/portal.ts | 553 ------------------- functions/src/lobbying/scrapeLobbying.ts | 274 --------- lobbying-scraper/Dockerfile | 4 +- scripts/firebase-admin/backfillLobbying.ts | 64 --- 10 files changed, 66 insertions(+), 1034 deletions(-) delete mode 100644 functions/src/lobbying/http/.gitignore delete mode 100644 functions/src/lobbying/http/fetch.py delete mode 100644 functions/src/lobbying/http/requirements.txt delete mode 100644 functions/src/lobbying/portal.ts delete mode 100644 functions/src/lobbying/scrapeLobbying.ts delete mode 100644 scripts/firebase-admin/backfillLobbying.ts diff --git a/docs/lobbying-disclosure-ingestion.md b/docs/lobbying-disclosure-ingestion.md index 264c77c52..51719f342 100644 --- a/docs/lobbying-disclosure-ingestion.md +++ b/docs/lobbying-disclosure-ingestion.md @@ -298,64 +298,86 @@ them. No bill-level compensation amount is available for these years. ``` functions/src/lobbying/ - types.ts — Runtypes definitions for LobbyingRegistrant, LobbyingFiling - normalize.ts — Entity name normalization pipeline - portal.ts — Reference implementation (HTTP layer not used in production) - scrapeLobbying.ts — Reference implementation (superseded by Cloud Run container) - index.ts — Re-exports + types.ts — Runtypes schema definitions for LobbyingRegistrant, LobbyingFiling + normalize.ts — Entity name normalization pipeline (also used client-side) + index.ts — Re-exports lobbying-scraper/ - scrape.py — Entry point: --mode weekly (incremental) | --mode backfill - portal.py — HTTP + HTML parsing - normalize.py — Port of normalize.ts - writer.py — Firestore document construction + writes - requirements.txt — requests, beautifulsoup4, google-cloud-firestore - Dockerfile — Python 3.12-slim image + scrape.py — Entry point: --mode weekly (incremental) | --mode backfill + portal.py — HTTP + HTML parsing + normalize.py — Port of normalize.ts + writer.py — Firestore document construction + writes + requirements.txt — requests, beautifulsoup4, google-cloud-firestore + Dockerfile — Python 3.12-slim image ``` +The TypeScript lobbying module (`functions/src/lobbying/`) contains only the +schema types and normalization logic. There is no TypeScript scraper or +Firebase Function — ingestion is handled entirely by the Cloud Run container. +This follows the same pattern as the MCP server and avoids the complexity of +running multiple language runtimes in the same Firebase Functions deployment. + --- ## Deploying the Cloud Run Container -Follows the same pattern as the MCP server. Requires the -`maple-lobbying-scraper` Artifact Registry repository to exist. +Follows the same pattern as the MCP server. The Artifact Registry repo +(`maple-lobbying`) and Cloud Run job (`maple-lobbying-scraper`) are already +created in `digital-testimony-dev`. ```bash cd lobbying-scraper IMAGE=us-central1-docker.pkg.dev/digital-testimony-dev/maple-lobbying/scraper:latest docker build -t $IMAGE . && docker push $IMAGE -gcloud run jobs create maple-lobbying-scraper \ +gcloud run jobs update maple-lobbying-scraper \ --image=$IMAGE \ --project=digital-testimony-dev \ + --region=us-central1 +``` + +For a new project (prod), create the job first: + +```bash +gcloud artifacts repositories create maple-lobbying \ + --repository-format=docker --location=us-central1 --project= + +gcloud run jobs create maple-lobbying-scraper \ + --image=$IMAGE \ + --project= \ --region=us-central1 \ - --service-account=@digital-testimony-dev.iam.gserviceaccount.com + --task-timeout=30m \ + --max-retries=0 -# Schedule weekly via Cloud Scheduler +# Schedule weekly (Mondays 6am UTC) gcloud scheduler jobs create http maple-lobbying-weekly \ --schedule="0 6 * * 1" \ - --uri="https://us-central1-run.googleapis.com/apis/run.googleapis.com/v1/namespaces/digital-testimony-dev/jobs/maple-lobbying-scraper:run" \ + --uri="https://us-central1-run.googleapis.com/apis/run.googleapis.com/v1/namespaces//jobs/maple-lobbying-scraper:run" \ --http-method=POST \ - --oauth-service-account-email=@digital-testimony-dev.iam.gserviceaccount.com \ + --oauth-service-account-email=@.iam.gserviceaccount.com \ --location=us-central1 ``` -## Historical Backfill (Admin Script) +## Historical Backfill -Ingests all historical filings from 2005 to the present. Delegates to -`scrape.py --mode backfill` via subprocess. Resumable — the subcollection -cursor at `/scrapers/lobbyingBackfill/processedUrls` tracks what has been -processed. Run directly on the machine (requires `lobbying-scraper/` deps -installed or the `maple-2025` conda environment). +Runs `scrape.py --mode backfill` directly. Resumable — the subcollection +cursor at `/scrapers/lobbyingBackfill/processedUrls` tracks progress. +Requires `lobbying-scraper/` deps or the `maple-2025` conda environment. ```bash +cd lobbying-scraper + +# Test a single year with no writes GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ - yarn firebase-admin run-script backfillLobbying --env dev + python3 scrape.py --mode backfill --year 2024 --limit 3 --dry-run -# Or call scrape.py directly for more control: -cd lobbying-scraper -python3 scrape.py --mode backfill --year 2024 --limit 3 --dry-run -python3 scrape.py --mode backfill --year 2024 +# Run a single year for real +GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + python3 scrape.py --mode backfill --year 2024 + +# Full history (2005-present, resumable) +GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + python3 scrape.py --mode backfill ``` --- @@ -400,22 +422,18 @@ export { scrapeLobbying } from "./lobbying" ## Implementation Status -| File | Status | Notes | -| -------------------------------------------- | ------- | ---------------------------------------------------------- | -| `functions/src/lobbying/types.ts` | ✅ Done | TypeScript type definitions; source of truth for schema | -| `functions/src/lobbying/normalize.ts` | ✅ Done | Normalization pipeline (also ported to `normalize.py`) | -| `functions/src/lobbying/portal.ts` | ✅ Done | Kept for reference; HTTP layer not used (see architecture) | -| `functions/src/lobbying/scrapeLobbying.ts` | ✅ Done | Not deployed; superseded by Cloud Run container | -| `functions/src/lobbying/index.ts` | ✅ Done | | -| `functions/src/index.ts` (export) | ✅ Done | | -| `firestore.rules` | ✅ Done | | -| `firestore.indexes.json` | ✅ Done | | -| `lobbying-scraper/normalize.py` | ✅ Done | Port of normalize.ts | -| `lobbying-scraper/portal.py` | ✅ Done | HTTP + HTML parsing | -| `lobbying-scraper/writer.py` | ✅ Done | Firestore document construction | -| `lobbying-scraper/scrape.py` | ✅ Done | Entry point; `--mode weekly` and `--mode backfill` | -| `lobbying-scraper/Dockerfile` | ✅ Done | Python 3.12 slim | -| `scripts/firebase-admin/backfillLobbying.ts` | ✅ Done | Calls `scrape.py --mode backfill` as subprocess | +| File | Status | Notes | +| ------------------------------------- | ------- | -------------------------------------------------------- | +| `functions/src/lobbying/types.ts` | ✅ Done | Firestore schema types; imported by future frontend code | +| `functions/src/lobbying/normalize.ts` | ✅ Done | Normalization pipeline; also ported to `normalize.py` | +| `functions/src/lobbying/index.ts` | ✅ Done | Re-exports types and normalize | +| `firestore.rules` | ✅ Done | | +| `firestore.indexes.json` | ✅ Done | | +| `lobbying-scraper/normalize.py` | ✅ Done | Port of normalize.ts | +| `lobbying-scraper/portal.py` | ✅ Done | HTTP + HTML parsing | +| `lobbying-scraper/writer.py` | ✅ Done | Firestore document construction | +| `lobbying-scraper/scrape.py` | ✅ Done | Entry point; `--mode weekly` and `--mode backfill` | +| `lobbying-scraper/Dockerfile` | ✅ Done | Python 3.12-slim; deployed to Cloud Run | ### Document ID scheme diff --git a/functions/src/index.ts b/functions/src/index.ts index 6c52b78c1..641255bf4 100644 --- a/functions/src/index.ts +++ b/functions/src/index.ts @@ -60,8 +60,6 @@ export { export { transcription } from "./webhooks" -export { scrapeLobbying } from "./lobbying" - export * from "./triggerPubsubFunction" // Export the health check last so it is loaded last. diff --git a/functions/src/lobbying/http/.gitignore b/functions/src/lobbying/http/.gitignore deleted file mode 100644 index d0ee3b17c..000000000 --- a/functions/src/lobbying/http/.gitignore +++ /dev/null @@ -1,3 +0,0 @@ -venv/ -__pycache__/ -*.pyc diff --git a/functions/src/lobbying/http/fetch.py b/functions/src/lobbying/http/fetch.py deleted file mode 100644 index 4e6c2c4ec..000000000 --- a/functions/src/lobbying/http/fetch.py +++ /dev/null @@ -1,81 +0,0 @@ -"""Minimal HTTP fetch helper for the lobbying portal. - -Handles the portal's session cookie requirements that standard Node.js HTTP -clients cannot satisfy due to TLS-layer constraints. - -Usage: - python3 fetch.py --url URL [--method GET|POST] [--jar PATH] - -POST body is read from stdin as application/x-www-form-urlencoded. -Cookies are persisted to/from the JSON file at --jar so the session survives -across multiple subprocess invocations. -HTML response is written to stdout. Errors go to stderr with exit code 1. -""" - -import argparse -import json -import sys -from pathlib import Path - -import requests - -_UA = ( - "Mozilla/5.0 (iPad; CPU OS 12_2 like Mac OS X) " - "AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148" -) - - -def main() -> None: - p = argparse.ArgumentParser() - p.add_argument("--url", required=True) - p.add_argument("--method", default="GET", choices=["GET", "POST"]) - p.add_argument("--jar", default=None, help="Path to JSON cookie-jar file") - args = p.parse_args() - - session = requests.Session() - session.headers.update( - { - "User-Agent": _UA, - "Accept": "*/*", - "Accept-Encoding": "gzip, deflate, br", - "Connection": "keep-alive", - } - ) - - if args.jar: - jar = Path(args.jar) - if jar.exists(): - try: - session.cookies.update(json.loads(jar.read_text())) - except Exception as e: - print(f"warning: could not read cookie jar: {e}", file=sys.stderr) - - try: - if args.method == "POST": - body = sys.stdin.buffer.read() - resp = session.post( - args.url, - data=body, - headers={"Content-Type": "application/x-www-form-urlencoded"}, - timeout=180, - ) - else: - resp = session.get(args.url, timeout=60) - - resp.raise_for_status() - - if args.jar: - Path(args.jar).write_text(json.dumps(dict(session.cookies))) - - sys.stdout.buffer.write(resp.content) - - except requests.exceptions.HTTPError as e: - print(f"HTTP error {e.response.status_code}: {args.url}", file=sys.stderr) - sys.exit(1) - except requests.exceptions.RequestException as e: - print(f"request failed: {e}", file=sys.stderr) - sys.exit(1) - - -if __name__ == "__main__": - main() diff --git a/functions/src/lobbying/http/requirements.txt b/functions/src/lobbying/http/requirements.txt deleted file mode 100644 index b18d51347..000000000 --- a/functions/src/lobbying/http/requirements.txt +++ /dev/null @@ -1 +0,0 @@ -requests>=2.28 diff --git a/functions/src/lobbying/index.ts b/functions/src/lobbying/index.ts index 5e594cb34..6d039ae51 100644 --- a/functions/src/lobbying/index.ts +++ b/functions/src/lobbying/index.ts @@ -1,12 +1,2 @@ -export { scrapeLobbying } from "./scrapeLobbying" export * from "./types" export { normalizeEntityName } from "./normalize" -export { - constructBillId, - fetchDisclosureDetail, - fetchDisclosureMeta, - fetchSummaryLinks, - makePortalClient, - normalizeChamber, - yearToGeneralCourt -} from "./portal" diff --git a/functions/src/lobbying/portal.ts b/functions/src/lobbying/portal.ts deleted file mode 100644 index 64d65831b..000000000 --- a/functions/src/lobbying/portal.ts +++ /dev/null @@ -1,553 +0,0 @@ -/** - * HTTP client and HTML parser for the MA Secretary of State lobbying portal. - * - * Portal: https://www.sec.state.ma.us/LobbyistPublicSearch/ - * - * Page flow: - * 1. Search POST → grdvSearchResultByTypeAndCategory table - * One row per registrant; each row has a Summary.aspx link. - * 2. Summary.aspx → registrant name/year/type + CompleteDisclosure links - * 3. CompleteDisclosure.aspx → per-client compensation + per-client bill activity - * - * Two disclosure HTML formats exist: - * Modern (≥~2013): per-client compensation in grdvClientPaidToEntity; - * per-client bill tables as grdvActivitiesNew{year}_{n}. - * Legacy (<~2013): total salary in grdvSalaryPaid (no client breakdown); - * all bill activity in a single grdvActivities table. - */ - -import axios, { AxiosInstance } from "axios" -import { JSDOM } from "jsdom" -import { sha256 } from "js-sha256" -import { CookieJar } from "tough-cookie" -import { - CHAMBER_PREFIXES, - LEGACY_CHAMBER_MAP, - LEGACY_TOTAL_CLIENT, - LobbyingChamber -} from "./types" - -// ─── Constants ────────────────────────────────────────────────────────────── - -const BASE_URL = "https://www.sec.state.ma.us/LobbyistPublicSearch/" -const SEARCH_URL = BASE_URL + "Default.aspx" -const REQUEST_DELAY_MS = 1000 -const MAX_RETRIES = 5 - -const IPAD_UA = - "Mozilla/5.0 (iPad; CPU OS 12_2 like Mac OS X) " + - "AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148" - -const FIRST_GC = 183 -const FIRST_GC_START_YEAR = 2003 - -// ─── Public types ─────────────────────────────────────────────────────────── - -export interface RawCompensation { - clientName: string - amount: number | null -} - -export interface RawBillActivity { - clientName: string - chamber: LobbyingChamber - rawBillNumber: string - billId: string | null // pre-computed from chamber + rawBillNumber - activityTitle: string - position: string - amount: number | null -} - -export interface DisclosureMeta { - entityName: string - year: number | null - /** Portal reg_type mapped to our vocabulary */ - regType: "Lobbyist" | "Employer" - disclosureUrls: string[] -} - -export interface DisclosureDetail { - compensation: RawCompensation[] - bills: RawBillActivity[] -} - -// ─── HTTP helpers ──────────────────────────────────────────────────────────── - -/** - * Create an axios instance pre-configured for the MA SoS portal. - * - * Includes a cookie jar via interceptors so ASP.NET session state (ViewState, - * anti-forgery tokens) is preserved across the GET → POST page flow without - * requiring the axios-cookiejar-support package. - */ -export interface PortalClient { - jar: CookieJar - client: AxiosInstance -} - -/** - * Create a portal client pre-configured for the MA SoS portal. - * - * Uses maxRedirects: 0 so our manual redirect loop (inside getHtml / postHtml) - * can extract Set-Cookie headers at each hop before following. This is necessary - * because the portal is protected by Incapsula, which issues a 302 challenge on - * first contact and requires the session cookies to be sent on the retried request. - * Axios's built-in redirect following happens before response interceptors fire, - * so the cookies from the challenge response are never captured automatically. - */ -export function makePortalClient(): PortalClient { - const jar = new CookieJar() - const client = axios.create({ - headers: { - "User-Agent": IPAD_UA, - Accept: "*/*", - "Accept-Encoding": "gzip, deflate, br", - Connection: "keep-alive" - }, - timeout: 60_000, - maxRedirects: 10, // let axios handle ordinary redirects; only Incapsula challenges need manual handling - validateStatus: s => s < 500 // surface 4xx so we can log them - }) - return { jar, client } -} - -function sleep(ms: number): Promise { - return new Promise(resolve => setTimeout(resolve, ms)) -} - -function cookieHeader(jar: CookieJar, url: string): string { - return jar - .getCookiesSync(url) - .map(c => c.cookieString()) - .join("; ") -} - -function saveCookies( - jar: CookieJar, - url: string, - headers: Record -): void { - const raw = headers["set-cookie"] - if (!raw) return - const list = Array.isArray(raw) ? raw : [raw] - for (const c of list) jar.setCookieSync(c, url) -} - -async function getHtml( - pc: PortalClient, - url: string, - retries = MAX_RETRIES -): Promise { - for (let attempt = 0; attempt < retries; attempt++) { - await sleep( - attempt === 0 ? REQUEST_DELAY_MS : REQUEST_DELAY_MS * 2 ** attempt - ) - try { - const res = await pc.client.get(url, { - responseType: "text", - headers: { Cookie: cookieHeader(pc.jar, url) } - }) - saveCookies( - pc.jar, - url, - res.headers as Record - ) - if (res.status >= 400) throw new Error(`HTTP ${res.status} for ${url}`) - return new JSDOM(res.data).window.document - } catch (e) { - if (attempt === retries - 1) throw e - if (axios.isAxiosError(e)) continue - throw e - } - } - throw new Error("unreachable") -} - -async function postHtml( - pc: PortalClient, - url: string, - data: Record, - retries = MAX_RETRIES -): Promise { - const body = new URLSearchParams(data).toString() - for (let attempt = 0; attempt < retries; attempt++) { - await sleep( - attempt === 0 ? REQUEST_DELAY_MS : REQUEST_DELAY_MS * 2 ** attempt - ) - try { - const res = await pc.client.post(url, body, { - responseType: "text", - headers: { - "Content-Type": "application/x-www-form-urlencoded", - Cookie: cookieHeader(pc.jar, url) - }, - timeout: 180_000 - }) - saveCookies( - pc.jar, - url, - res.headers as Record - ) - if (res.status >= 400) throw new Error(`HTTP ${res.status} for ${url}`) - return new JSDOM(res.data).window.document - } catch (e) { - if (attempt === retries - 1) throw e - if (axios.isAxiosError(e)) continue - throw e - } - } - throw new Error("unreachable") -} - -// ─── Year / General Court helpers ──────────────────────────────────────────── - -export function yearToGeneralCourt(year: number): number { - return FIRST_GC + Math.floor((year - FIRST_GC_START_YEAR) / 2) -} - -// ─── Chamber normalization ──────────────────────────────────────────────────── - -/** Normalize raw portal chamber string to a canonical LobbyingChamber value. */ -export function normalizeChamber(raw: string): LobbyingChamber { - const trimmed = raw.trim() - if (LEGACY_CHAMBER_MAP[trimmed]) return LEGACY_CHAMBER_MAP[trimmed] - const known: LobbyingChamber[] = [ - "House Bill", - "Senate Bill", - "House Docket", - "Senate Docket", - "Executive" - ] - if (known.includes(trimmed as LobbyingChamber)) - return trimmed as LobbyingChamber - return "Other" -} - -/** - * Construct the MAPLE-compatible billId from the portal's chamber + raw integer. - * - * The portal stores bill numbers as bare integers; the chamber prefix is what - * distinguishes H1234 from S1234. Returns null for Executive and Other chambers - * where no bill join is possible. - */ -export function constructBillId( - chamber: LobbyingChamber, - rawBillNumber: string -): string | null { - const prefix = CHAMBER_PREFIXES[chamber] - if (!prefix) return null - const n = parseInt(rawBillNumber, 10) - if (isNaN(n)) return null - return `${prefix}${n}` -} - -// ─── Document ID generation ─────────────────────────────────────────────────── - -/** Stable Firestore document ID for a registrant (entity + year). */ -export function registrantId(entityName: string, year: number): string { - return sha256(`${year}|${entityName}`).slice(0, 40) -} - -/** - * Stable Firestore document ID for a filing. - * - * Uses a hash of the logical deduplication key. For null-bill rows (billId is - * null) the chamber is included in the key to avoid merging executive null rows - * with legislative null rows. - */ -export function filingId( - entityName: string, - clientName: string, - chamber: LobbyingChamber, - billId: string | null, - generalCourt: number, - position: string -): string { - const key = [ - entityName, - clientName, - chamber, - billId ?? "__null__", - generalCourt, - position - ].join("|") - return sha256(key).slice(0, 40) -} - -// ─── Amount parsing ─────────────────────────────────────────────────────────── - -function parseAmount(text: string): number | null { - const cleaned = text.replace(/[$,]/g, "").trim() - const n = parseFloat(cleaned) - return isNaN(n) ? null : n -} - -// ─── Portal scraping functions ──────────────────────────────────────────────── - -/** Extract ASP.NET WebForms ViewState hidden inputs from a page. */ -function extractViewState(doc: Document): Record { - const fields: Record = {} - doc.querySelectorAll('input[type="hidden"]').forEach(el => { - const input = el as HTMLInputElement - if (input.name) fields[input.name] = input.value ?? "" - }) - return fields -} - -/** - * Fetch all Summary.aspx URLs for a given year. - * Sends a single search POST with page size 20000 to get all registrants at once. - */ -export async function fetchSummaryLinks( - pc: PortalClient, - year: number -): Promise { - const searchPage = await getHtml(pc, SEARCH_URL) - const vs = extractViewState(searchPage) - - const postData: Record = { - ...vs, - __EVENTTARGET: "", - __EVENTARGUMENT: "", - ctl00$ContentPlaceHolder1$Search: "rdbSearchByType", - ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$ddlYear: String(year), - ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$txtN_ame: "", - ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$lddSearchType$DropDown: - "3", - ctl00$ContentPlaceHolder1$ucSearchCriteriaByType$drpType: "L", - ctl00$ContentPlaceHolder1$drpPageSize: "20000", - ctl00$ContentPlaceHolder1$btnSearch: "Search" - } - - const resultsPage = await postHtml(pc, SEARCH_URL, postData) - - const table = resultsPage.querySelector( - '[id*="grdvSearchResultByTypeAndCategory"]' - ) - if (!table) return [] - - const links: string[] = [] - table.querySelectorAll("a[href]").forEach(el => { - const href = (el as HTMLAnchorElement).href - if (href && href.includes("Summary.aspx")) { - // href from JSDOM is already absolute when base is set; handle both cases - const url = href.startsWith("http") ? href : BASE_URL + href - links.push(url) - } - }) - return links -} - -/** - * Fetch a Summary.aspx page and return the registrant metadata + disclosure URLs. - */ -export async function fetchDisclosureMeta( - pc: PortalClient, - summaryUrl: string -): Promise { - const doc = await getHtml(pc, summaryUrl) - - const text = (id: string) => { - const el = doc.getElementById(id) - return el?.textContent?.trim() ?? "" - } - - const entityName = text("ContentPlaceHolder1_lblRegistrantName") - const yearText = text("ContentPlaceHolder1_lblYear") - const regTypeRaw = text("ContentPlaceHolder1_lblRegType") - - const year = parseInt(yearText, 10) - const regType: "Lobbyist" | "Employer" = regTypeRaw.includes("Entity") - ? "Employer" - : "Lobbyist" - - const disclosureUrls: string[] = [] - doc.querySelectorAll("a[href]").forEach(el => { - const raw = (el as HTMLAnchorElement).getAttribute("href") ?? "" - if (raw.includes("CompleteDisclosure")) { - const url = raw.startsWith("http") ? raw : BASE_URL + raw - disclosureUrls.push(url) - } - }) - - return { - entityName, - year: isNaN(year) ? null : year, - regType, - disclosureUrls - } -} - -/** - * Parse a CompleteDisclosure.aspx page. - * - * Handles both modern (≥~2013) and legacy (<~2013) HTML layouts. - */ -export async function fetchDisclosureDetail( - pc: PortalClient, - discUrl: string, - year: number -): Promise { - const doc = await getHtml(pc, discUrl) - const compensation: RawCompensation[] = [] - const bills: RawBillActivity[] = [] - - // ── Modern format ────────────────────────────────────────────────────────── - const compTable = doc.querySelector('[id*="grdvClientPaidToEntity"]') - if (compTable) { - compTable - .querySelectorAll("tr.GridRow, tr.GridAlternatingRow") - .forEach(row => { - const cells = Array.from(row.querySelectorAll("td")).map( - td => td.textContent?.trim() ?? "" - ) - if (cells.length >= 2) { - compensation.push({ - clientName: cells[0], - amount: parseAmount(cells[1]) - }) - } - }) - } - - // Bill activity tables — one per client per reporting period. Two ID patterns: - // 2014–2018: …rptActivityNew_grdvActivitiesNew_0 (no year suffix) - // 2019+: …rptActivityNew2020_grdvActivitiesNew2020_0 (year suffix) - doc.querySelectorAll('[id*="grdvActivitiesNew"]').forEach(actTable => { - // The client name lives in the nearest preceding span with lblClientName - let clientName = "" - let node: Element | null = actTable - while ((node = node.previousElementSibling ?? node.parentElement)) { - const span = node.id?.includes("lblClientName") - ? node - : node.querySelector?.('[id*="lblClientName"]') - if (span) { - clientName = span.textContent?.trim() ?? "" - break - } - if (node === node.parentElement) break - } - - actTable - .querySelectorAll("tr.GridRow, tr.GridAlternatingRow") - .forEach(row => { - const cells = Array.from(row.querySelectorAll("td")).map( - td => td.textContent?.trim() ?? "" - ) - // Columns: House/Senate, Bill Number, Bill title, Position, Amount, Direct business - if (cells.length < 4) return - const chamber = normalizeChamber(cells[0]) - const rawBillNumber = cells[1] - const billId = constructBillId(chamber, rawBillNumber) - bills.push({ - clientName, - chamber, - rawBillNumber, - billId, - activityTitle: cells[2] ?? "", - position: cells[3] ?? "", - amount: cells.length > 4 ? parseAmount(cells[4]) : null - }) - }) - }) - - if (compTable || bills.length > 0) { - return { compensation, bills } - } - - // ── Legacy format (<~2013) ───────────────────────────────────────────────── - const salaryTable = doc.querySelector('[id*="grdvSalaryPaid"]') - if (salaryTable) { - let total = 0 - salaryTable.querySelectorAll("tr").forEach(row => { - const cells = Array.from(row.querySelectorAll("td")).map( - td => td.textContent?.trim() ?? "" - ) - if (cells.length >= 2 && !cells[0].includes("Total")) { - const amt = parseAmount(cells[1]) - if (amt !== null) total += amt - } - }) - if (total > 0) { - compensation.push({ clientName: LEGACY_TOTAL_CLIENT, amount: total }) - } - } - - // Legacy bill activity: single grdvActivities table. Three known column layouts: - // 2009 4-col: Date | Bill+Title | Lobbyist | Client - // 2010+ individual 5-col: Activity | Position | DirectBiz | Client | Compensation - // 2010+ entity 6-col: Activity | Lobbyist | Position | DirectBiz | Client | Compensation - const actTable = doc.querySelector('[id$="grdvActivities"]') - if (actTable) { - const allRows = Array.from(actTable.querySelectorAll("tr")) - const headerCells = Array.from( - allRows[0]?.querySelectorAll("th, td") ?? [] - ).map(el => el.textContent?.trim() ?? "") - - let billCol = 1 - let positionCol: number | null = null - let clientCol = 3 - - if (headerCells[0]?.includes("Activity")) { - if (headerCells[1]?.includes("Lobbyist")) { - // 6-col entity layout - billCol = 0 - positionCol = 2 - clientCol = 4 - } else { - // 5-col individual layout - billCol = 0 - positionCol = 1 - clientCol = 3 - } - } - - const chamberMap: Record = { - H: "House Bill", - S: "Senate Bill", - HD: "House Docket", - SD: "Senate Docket" - } - - allRows.slice(1).forEach(row => { - const cells = Array.from(row.querySelectorAll("td")).map( - td => td.textContent?.trim() ?? "" - ) - if (cells.length <= Math.max(billCol, clientCol)) return - - const billCell = cells[billCol] - const skipValues = new Set([ - "Activity or Bill No and Title", - "N/A", - "None", - "", - "Total amount" - ]) - if (!billCell || skipValues.has(billCell)) return - - const parts = billCell.split(/\s+/) - const billNo = parts[0] - const activityTitle = parts.slice(1).join(" ") - const match = billNo.match(/^([A-Z]+)(\d+)$/) - if (!match) return - - const [, prefix, number] = match - const chamber: LobbyingChamber = chamberMap[prefix] ?? "Other" - const billId = constructBillId(chamber, number) - const position = positionCol !== null ? cells[positionCol] ?? "" : "" - const clientName = cells[clientCol] ?? "" - - bills.push({ - clientName, - chamber, - rawBillNumber: number, - billId, - activityTitle, - position, - amount: null - }) - }) - } - - return { compensation, bills } -} diff --git a/functions/src/lobbying/scrapeLobbying.ts b/functions/src/lobbying/scrapeLobbying.ts deleted file mode 100644 index 7a6140e8e..000000000 --- a/functions/src/lobbying/scrapeLobbying.ts +++ /dev/null @@ -1,274 +0,0 @@ -import { logger } from "firebase-functions" -import { runWith } from "firebase-functions/v1" -import { db, Timestamp } from "../firebase" -import type { Database } from "../types" -import { normalizeEntityName } from "./normalize" -import { - fetchDisclosureDetail, - fetchDisclosureMeta, - fetchSummaryLinks, - filingId, - makePortalClient, - registrantId, - yearToGeneralCourt -} from "./portal" -import { - FILINGS_COLLECTION, - FIRST_LOBBYING_YEAR, - LobbyingFiling, - LobbyingRegistrant, - REGISTRANTS_COLLECTION, - SCRAPER_DOC -} from "./types" - -/** - * Scraper state stored in Firestore at /scrapers/lobbying. - * - * processedDiscUrls: disc URLs already fetched; skip on re-runs. - * summaryDiscCache: maps summaryUrl → its known disc URLs so we can skip - * summary page GETs for registrants with no new filings. - */ -interface ScraperState { - processedDiscUrls: string[] - summaryDiscCache: Record -} - -/** - * Maximum number of new disclosure pages to fetch per function invocation. - * Each page takes ~1s; this keeps the run well within the 540s timeout. - * Remaining work is picked up on the next scheduled run. - */ -const MAX_DISCLOSURES_PER_RUN = 200 - -/** - * Scrape lobbying disclosure data for the current and prior calendar year. - * - * Runs every 24 hours. New filers arrive semi-annually so daily polling is - * more than sufficient for steady-state freshness. For initial historical - * ingestion (2005-present) use the backfillLobbying admin script instead. - * - * Progress is checkpointed to Firestore after every disclosure page so the - * function is fully resumable if it times out or is interrupted. - */ -export const scrapeLobbying = runWith({ timeoutSeconds: 540, maxInstances: 1 }) - .pubsub.schedule("every 24 hours") - .onRun(async () => { - const currentYear = new Date().getFullYear() - const years = [currentYear, currentYear - 1] - - const scraperRef = db.doc(SCRAPER_DOC) - const scraperDoc = await scraperRef.get() - const state: ScraperState = { - processedDiscUrls: scraperDoc.data()?.processedDiscUrls ?? [], - summaryDiscCache: scraperDoc.data()?.summaryDiscCache ?? {} - } - const processedSet = new Set(state.processedDiscUrls) - const summaryCache: Record = state.summaryDiscCache - - const client = makePortalClient() - let newDiscCount = 0 - - for (const year of years) { - if (newDiscCount >= MAX_DISCLOSURES_PER_RUN) break - - logger.info(`scrapeLobbying: fetching summary links for ${year}`) - let summaryUrls: string[] - try { - summaryUrls = await fetchSummaryLinks(client, year) - } catch (e) { - logger.error( - `scrapeLobbying: failed to fetch summary links for ${year}`, - e - ) - continue - } - logger.info( - `scrapeLobbying: ${summaryUrls.length} registrants for ${year}` - ) - - for (const summaryUrl of summaryUrls) { - if (newDiscCount >= MAX_DISCLOSURES_PER_RUN) break - - // Use cached disc URLs when available to avoid re-fetching summary pages. - // For current year we always re-check (new filings arrive mid-year). - let discUrls = summaryCache[summaryUrl] - if (!discUrls || year === currentYear) { - try { - const meta = await fetchDisclosureMeta(client, summaryUrl) - discUrls = meta.disclosureUrls - - // Write registrant doc (upsert); don't wait for individual writes to - // finish — use a bulkWriter for the doc contents but checkpoint the - // scraper state separately so interruptions are recoverable. - if (meta.entityName && meta.year) { - await writeRegistrant( - db, - meta.entityName, - meta.year, - meta.regType, - discUrls - ) - } - - summaryCache[summaryUrl] = discUrls - await scraperRef.set( - { summaryDiscCache: summaryCache }, - { merge: true } - ) - } catch (e) { - logger.warn( - `scrapeLobbying: failed to fetch summary ${summaryUrl}`, - e - ) - continue - } - } - - const newDiscUrls = discUrls.filter(u => !processedSet.has(u)) - if (newDiscUrls.length === 0) continue - - for (const discUrl of newDiscUrls) { - if (newDiscCount >= MAX_DISCLOSURES_PER_RUN) break - try { - await processDisclosure(db, client, summaryUrl, discUrl, year) - processedSet.add(discUrl) - newDiscCount++ - - // Checkpoint after every disclosure so restarts lose at most one page - await scraperRef.set( - { processedDiscUrls: Array.from(processedSet) }, - { merge: true } - ) - } catch (e) { - logger.warn( - `scrapeLobbying: failed to process disclosure ${discUrl}`, - e - ) - } - } - } - } - - logger.info(`scrapeLobbying: processed ${newDiscCount} new disclosures`) - }) - -// ─── Shared write helpers (also used by backfillLobbying) ──────────────────── - -/** - * Write or update a LobbyingRegistrant document. Client list is assembled from - * the disclosure meta; filing documents are written separately per-bill. - */ -export async function writeRegistrant( - database: Database, - entityName: string, - year: number, - regType: "Lobbyist" | "Employer", - disclosureUrls: string[] -): Promise { - const id = registrantId(entityName, year) - const ref = database.collection(REGISTRANTS_COLLECTION).doc(id) - const partial: Omit & { - fetchedAt: FirebaseFirestore.Timestamp - } = { - registrantId: id, - entityName, - entityNameNorm: normalizeEntityName(entityName), - year, - generalCourt: yearToGeneralCourt(year), - regType, - disclosureUrls, - fetchedAt: Timestamp.now() - } - // Merge so repeated runs don't wipe clients accumulated from multiple disclosures - await ref.set(partial, { merge: true }) -} - -/** - * Fetch one CompleteDisclosure page and write LobbyingFiling documents. - * Also updates the registrant's client list. - */ -export async function processDisclosure( - database: Database, - client: ReturnType, - summaryUrl: string, - discUrl: string, - year: number -): Promise { - const meta = await fetchDisclosureMeta(client, summaryUrl) - const detail = await fetchDisclosureDetail(client, discUrl, year) - - const { entityName, regType } = meta - const gc = yearToGeneralCourt(year) - const entityNameNorm = normalizeEntityName(entityName) - const now = Timestamp.now() - - // Update registrant's client list - if (entityName && year) { - const regRef = database - .collection(REGISTRANTS_COLLECTION) - .doc(registrantId(entityName, year)) - - const clients = detail.compensation.map(c => ({ - clientName: c.clientName, - clientNameNorm: normalizeEntityName(c.clientName), - compensation: c.amount - })) - - await regRef.set( - { - registrantId: registrantId(entityName, year), - entityName, - entityNameNorm, - year, - generalCourt: gc, - regType: regType ?? "Lobbyist", - clients, - disclosureUrls: [discUrl], - fetchedAt: now - }, - { merge: true } - ) - } - - // Write one LobbyingFiling doc per bill row - if (detail.bills.length === 0) return - - const writer = database.bulkWriter() - for (const bill of detail.bills) { - const fid = filingId( - entityName, - bill.clientName, - bill.chamber, - bill.billId, - gc, - bill.position - ) - const doc: LobbyingFiling = { - filingId: fid, - entityName, - entityNameNorm, - clientName: bill.clientName, - clientNameNorm: normalizeEntityName(bill.clientName), - year, - generalCourt: gc, - chamber: bill.chamber, - billId: bill.billId, - activityTitle: bill.activityTitle, - position: bill.position, - amount: bill.amount, - fetchedAt: now - } - writer.set(database.collection(FILINGS_COLLECTION).doc(fid), doc, { - merge: false - }) - } - await writer.close() -} - -/** All years to scrape, for use by the backfill script. */ -export function allLobbyingYears(): number[] { - const current = new Date().getFullYear() - const years: number[] = [] - for (let y = FIRST_LOBBYING_YEAR; y <= current; y++) years.push(y) - return years -} diff --git a/lobbying-scraper/Dockerfile b/lobbying-scraper/Dockerfile index 738293459..4b2da65b5 100644 --- a/lobbying-scraper/Dockerfile +++ b/lobbying-scraper/Dockerfile @@ -11,4 +11,6 @@ COPY normalize.py portal.py writer.py scrape.py ./ # Cloud Scheduler invokes the container via HTTP POST to /; handle it minimally. ENV PYTHONUNBUFFERED=1 -CMD ["python3", "scrape.py", "--mode", "weekly"] +# ENTRYPOINT is the fixed executable; CMD provides default args that --args overrides. +ENTRYPOINT ["python3", "scrape.py"] +CMD ["--mode", "weekly"] diff --git a/scripts/firebase-admin/backfillLobbying.ts b/scripts/firebase-admin/backfillLobbying.ts deleted file mode 100644 index a2a66330e..000000000 --- a/scripts/firebase-admin/backfillLobbying.ts +++ /dev/null @@ -1,64 +0,0 @@ -/** - * Backfill lobbying disclosure data from 2005 to the present. - * - * Delegates all HTTP fetching and Firestore writes to the Python scraper in - * lobbying-scraper/. The TypeScript layer handles argument parsing and - * environment setup only. - * - * Usage: - * GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ - * yarn firebase-admin run-script backfillLobbying --env dev - * - * Options (passed through to scrape.py): - * --year NUMBER Only process this year - * --limit NUMBER Max registrants per year (for testing) - * - * Requires: pip install -r lobbying-scraper/requirements.txt - * Or run inside the maple-2025 conda environment. - */ - -import { spawn } from "child_process" -import path from "path" -import { z } from "zod" -import { Script } from "./types" - -const Args = z - .object({ - year: z.number().int().min(2005).optional(), - limit: z.number().int().positive().optional() - }) - .passthrough() - -const SCRAPER = path.resolve(__dirname, "../../lobbying-scraper/scrape.py") - -export const script: Script = async ({ env, args }) => { - const { year, limit } = Args.parse(args) - - if (env === "local") { - throw new Error( - "backfillLobbying requires --env dev or --env prod " + - "(it writes to a real Firestore project; local emulator not supported yet)" - ) - } - - const pyArgs = ["--mode", "backfill"] - if (year) pyArgs.push("--year", String(year)) - if (limit) pyArgs.push("--limit", String(limit)) - - console.log(`Running: python3 ${SCRAPER} ${pyArgs.join(" ")}`) - console.log( - `Firestore project: ${process.env.GCLOUD_PROJECT || "(from ADC)"}` - ) - - await new Promise((resolve, reject) => { - const proc = spawn("python3", [SCRAPER, ...pyArgs], { - stdio: ["ignore", "inherit", "inherit"], - env: { ...process.env } - }) - proc.on("close", code => { - if (code === 0) resolve() - else reject(new Error(`scrape.py exited with code ${code}`)) - }) - proc.on("error", reject) - }) -} From 26150ef77c8eb31ef75b8b161aa7570b25c27656 Mon Sep 17 00:00:00 2001 From: Nathan Date: Sat, 27 Jun 2026 20:14:04 -0400 Subject: [PATCH 5/8] feat: parser fixes for all 4 disclosure eras + GCS archiving infrastructure MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Portal parser (portal.py): - Hybrid era (2014-2018): per-client compensation from Panel1 divs — was silently $0 due to missing code path (e.g. Murphy Donoghue 2016: $990k) - Legacy era (2009-2013): per-client totals from 'Compensation received' column, with dedup of (client, amount) pairs before summing — was silently $0 per client (e.g. ML Strategies 2011: $641k across 23 clients) - Legacy bill semicolon separator: 'H73; Title' now parsed correctly - 'Total amount' summary row excluded from compensation pairs - HTTP retry on 429/500/502/503/504 (was aborting on first transient error) - parse_summary() and parse_disclosure_detail() split out as pure functions (no I/O) so the offline reparse driver can call them without a session GCS archiving (archive.py): - Write-only cold storage: every fetched Summary/CompleteDisclosure page saved as gs://{project}-lobbying-archive/raw_html/{sha1(url)}.html - Enabled by ARCHIVE_RAW=1 env var; no-op otherwise - Failures are logged but never interrupt the live scrape path Offline reparse driver (reparse_archive.py): - Lists CompleteDisclosure blobs from GCS, resolves registrant meta from Firestore via disclosureUrls array_contains, re-runs pure parsers, writes back via writer.py; resumable via /scrapers/lobbyingReparse cursor Pytest suite (tests/test_portal_parser.py, 26 tests): - All 4 eras verified against committed gzipped fixture pages - Compensation totals, client counts, bill counts, era detection asserted - Specific bug-fix regressions: Total-amount artifact, H73 semicolon, hybrid Panel1 compensation, 2007 _total_salary_ fallback Co-Authored-By: Claude Sonnet 4.6 --- docs/lobbying-disclosure-ingestion.md | 328 +++++++++++++++++- .../__pycache__/normalize.cpython-37.pyc | Bin 1412 -> 1412 bytes .../__pycache__/portal.cpython-37.pyc | Bin 11941 -> 16091 bytes lobbying-scraper/archive.py | 60 ++++ lobbying-scraper/portal.py | 272 +++++++++++---- lobbying-scraper/reparse_archive.py | 155 +++++++++ lobbying-scraper/requirements.txt | 1 + lobbying-scraper/tests/__init__.py | 0 .../tests/__pycache__/__init__.cpython-37.pyc | Bin 0 -> 166 bytes ..._portal_parser.cpython-37-pytest-7.4.4.pyc | Bin 0 -> 17098 bytes .../tests/fixtures/2007e_disc.html.gz | Bin 0 -> 21790 bytes .../tests/fixtures/2007e_summ.html.gz | Bin 0 -> 14101 bytes .../tests/fixtures/2011e_disc.html.gz | Bin 0 -> 32918 bytes .../tests/fixtures/2011e_summ.html.gz | Bin 0 -> 26526 bytes .../tests/fixtures/2011i_disc.html.gz | Bin 0 -> 14723 bytes .../tests/fixtures/2011i_summ.html.gz | Bin 0 -> 13673 bytes .../tests/fixtures/2016e_disc.html.gz | Bin 0 -> 259811 bytes .../tests/fixtures/2016e_summ.html.gz | Bin 0 -> 24496 bytes .../tests/fixtures/2024e_disc.html.gz | Bin 0 -> 23241 bytes .../tests/fixtures/2024e_summ.html.gz | Bin 0 -> 14583 bytes .../tests/fixtures/2024i_disc.html.gz | Bin 0 -> 62766 bytes .../tests/fixtures/2024i_summ.html.gz | Bin 0 -> 11739 bytes lobbying-scraper/tests/test_portal_parser.py | 172 +++++++++ 23 files changed, 902 insertions(+), 86 deletions(-) create mode 100644 lobbying-scraper/archive.py create mode 100644 lobbying-scraper/reparse_archive.py create mode 100644 lobbying-scraper/tests/__init__.py create mode 100644 lobbying-scraper/tests/__pycache__/__init__.cpython-37.pyc create mode 100644 lobbying-scraper/tests/__pycache__/test_portal_parser.cpython-37-pytest-7.4.4.pyc create mode 100644 lobbying-scraper/tests/fixtures/2007e_disc.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2007e_summ.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2011e_disc.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2011e_summ.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2011i_disc.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2011i_summ.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2016e_disc.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2016e_summ.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2024e_disc.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2024e_summ.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2024i_disc.html.gz create mode 100644 lobbying-scraper/tests/fixtures/2024i_summ.html.gz create mode 100644 lobbying-scraper/tests/test_portal_parser.py diff --git a/docs/lobbying-disclosure-ingestion.md b/docs/lobbying-disclosure-ingestion.md index 51719f342..862947cd0 100644 --- a/docs/lobbying-disclosure-ingestion.md +++ b/docs/lobbying-disclosure-ingestion.md @@ -303,12 +303,14 @@ functions/src/lobbying/ index.ts — Re-exports lobbying-scraper/ - scrape.py — Entry point: --mode weekly (incremental) | --mode backfill - portal.py — HTTP + HTML parsing - normalize.py — Port of normalize.ts - writer.py — Firestore document construction + writes - requirements.txt — requests, beautifulsoup4, google-cloud-firestore - Dockerfile — Python 3.12-slim image + scrape.py — Entry point: --mode weekly (incremental) | --mode backfill + portal.py — HTTP fetch wrappers + pure HTML parsers for all 4 format eras + normalize.py — Port of normalize.ts + writer.py — Firestore document construction + writes + archive.py — GCS raw-HTML archive (write-only; enabled by ARCHIVE_RAW=1) + reparse_archive.py — Offline driver to re-ingest archived HTML into Firestore + requirements.txt — requests, beautifulsoup4, google-cloud-firestore, google-cloud-storage + Dockerfile — Python 3.12-slim image ``` The TypeScript lobbying module (`functions/src/lobbying/`) contains only the @@ -422,18 +424,20 @@ export { scrapeLobbying } from "./lobbying" ## Implementation Status -| File | Status | Notes | -| ------------------------------------- | ------- | -------------------------------------------------------- | -| `functions/src/lobbying/types.ts` | ✅ Done | Firestore schema types; imported by future frontend code | -| `functions/src/lobbying/normalize.ts` | ✅ Done | Normalization pipeline; also ported to `normalize.py` | -| `functions/src/lobbying/index.ts` | ✅ Done | Re-exports types and normalize | -| `firestore.rules` | ✅ Done | | -| `firestore.indexes.json` | ✅ Done | | -| `lobbying-scraper/normalize.py` | ✅ Done | Port of normalize.ts | -| `lobbying-scraper/portal.py` | ✅ Done | HTTP + HTML parsing | -| `lobbying-scraper/writer.py` | ✅ Done | Firestore document construction | -| `lobbying-scraper/scrape.py` | ✅ Done | Entry point; `--mode weekly` and `--mode backfill` | -| `lobbying-scraper/Dockerfile` | ✅ Done | Python 3.12-slim; deployed to Cloud Run | +| File | Status | Notes | +| ------------------------------------- | ---------- | ---------------------------------------------------------------- | +| `functions/src/lobbying/types.ts` | ✅ Done | Firestore schema types; imported by future frontend code | +| `functions/src/lobbying/normalize.ts` | ✅ Done | Normalization pipeline; also ported to `normalize.py` | +| `functions/src/lobbying/index.ts` | ✅ Done | Re-exports types and normalize | +| `firestore.rules` | ✅ Done | | +| `firestore.indexes.json` | ✅ Done | | +| `lobbying-scraper/normalize.py` | ✅ Done | Port of normalize.ts | +| `lobbying-scraper/portal.py` | ✅ Done | All 4 format eras; pure parsers separated from fetch wrappers | +| `lobbying-scraper/writer.py` | ✅ Done | Firestore document construction | +| `lobbying-scraper/scrape.py` | ✅ Done | Entry point; `--mode weekly` and `--mode backfill` | +| `lobbying-scraper/archive.py` | ✅ Done | GCS write-only archive; enabled via `ARCHIVE_RAW=1` | +| `lobbying-scraper/reparse_archive.py` | ✅ Done | Offline reparse driver; looks up registrant meta from Firestore | +| `lobbying-scraper/Dockerfile` | ⚠️ Rebuild | Needs rebuild after `google-cloud-storage` added to requirements | ### Document ID scheme @@ -676,3 +680,291 @@ processed). | Incremental strategy | Skip already-processed disclosure URLs; write docs by logical key (upsert) | Survives function restarts and re-runs without re-fetching already-scraped pages; natural upsert prevents duplicates without an explicit dedup pass | | Legacy format (pre-2013) | Store with `clientName: "_total_salary_"` sentinel | Preserves data completeness; callers can filter on this value | | Historical data | Admin backfill script (2005 → present) | Full history is ingested once; Cloud Function maintains current+prior year going forward | + +--- + +## Appendix: Phase 2 — OCPF Contribution Ingestion + +This appendix tracks planned additions to the lobbying pipeline in a subsequent +PR. The changes link OCPF (Office of Campaign and Political Finance) campaign +contribution records to lobbying registrants, enabling questions like "how much +did this firm contribute to politicians while lobbying on this bill?" + +### Background + +The MA Secretary of State portal (Phase 1, implemented) covers who lobbied which +bills and for how much compensation. OCPF covers who donated to which political +candidates. Linking the two surfaces the intersection: lobbying firms that also +made political contributions. + +OCPF publishes bulk data files at +`ocpf2.blob.core.windows.net/downloads/data2/` (the same host used by +`matchOcpfMembers.ts` for the filers file). The contribution records file URL +needs to be confirmed before implementation begins. + +### New Data + +#### `/lobbyingContributionRecipients/{recipientId}` + +One document per deduplicated contribution recipient (politician/PAC). The +deduplication pipeline is described below. + +```typescript +interface LobbyingContributionRecipient { + recipientId: string // SHA-256(recipientName + officeSought)[:40] + recipientName: string // canonical display name after dedup + recipientSlug: string // slugify("{recipientName} {officeSought}") + officeSought: string // canonical office value (see normalization below) + totalReceived: number + nContributions: number + years: number[] + nameVariants: string[] // all raw names that resolved to this record + manuallyMerged: boolean // true if recipient_merges.json was applied + topFirms: [string, string, number][] // [entityName, entityNameNorm, amount] + fetchedAt: Timestamp +} +``` + +#### New fields on `LobbyingRegistrant` (optional, written by contribution run) + +```typescript +nBills?: number // total filing rows across all clients and years +nContributions?: number // total OCPF contribution records from this registrant +totalContributions?: number // total dollar amount contributed +``` + +`nBills` is computed during the disclosure scrape (bill rows are already in +memory) and written as a side effect of `--mode weekly` and `--mode backfill`. +`nContributions` and `totalContributions` are written by `--mode contributions`. + +#### Pure-contribution firms (new registrant subtype) + +Firms that made OCPF contributions but have zero lobbying activity (no filings) +are written as `LobbyingRegistrant` documents with `nBills: 0`, `clients: []`, +`totalContributions ≥ 500`. These were previously invisible. The $500 threshold +filters noise; adjust after reviewing the data. + +### Contribution Recipient Deduplication + +The same politician may appear under many name variants in OCPF data ("Joe +Curtatone", "Joseph Curtatone", "Curtatone"). The dedup pipeline runs in five +passes in-memory after loading all contribution records. + +All rules are systemic (handle a class of inputs); individual special cases are +handled via `recipient_merges.json` only. + +#### New file: `lobbying-scraper/recipient_normalize.py` + +**Step 1 — `_extract_recipient_name(raw)`** + +Strips committee wrapper names using 14 regex patterns (e.g. "Cte. to Elect Ron +Mariano" → "Ron Mariano"). Then applies in order: + +- Last-first flip: `"Mariano, Ronald"` → `"Ronald Mariano"` +- Honorific strip: `"Sen. Marc Rodrigues"` → `"Marc Rodrigues"` +- Party label strip: `"Ron Mariano Democrat"` → `"Ron Mariano"` +- Initial-dot prefix strip: `"R.Mariano"` → `"Mariano"` + +**Step 2 — `_recipient_dedup_key(name, office)` → `(first, last, office)`** + +Key is a `(first_token, last_token, canonical_office)` tuple. Before keying, +`first_token` is passed through `_NICKNAME_MAP`: + +| Raw | Canonical | +| ---------------- | --------- | +| joe | joseph | +| mike | michael | +| bob | robert | +| bill | william | +| jim | james | +| tom | thomas | +| dan | daniel | +| dave | david | +| steve | steven | +| ron | ronald | +| tim | timothy | +| rick, rich, dick | richard | +| charlie, chuck | charles | +| ben | benjamin | +| tony | anthony | +| marty | martin | +| don | donald | +| ken | kenneth | +| ed | edward | +| ray | raymond | +| nick | nicholas | + +If either token is a generic word (`the`, `comm`, `committee`, `democratic`, +`republican`, `house`, `senate`, `friends`, `cte`, `pac`), the key falls back +to the full canonical text. + +**Step 3 — Manual merges (`recipient_merges.json`)** + +JSON file maps `(name, office)` alias pairs to a canonical record. Start as an +empty object `{}`; populate incrementally as data review finds misses. Applied +after key assignment. + +**Step 4 — `_merge_bare_surnames(groups)`** + +Single-name entries where `first == last` (e.g. `"Curtatone"`) are merged into +the highest-total multi-token peer with the same `(last, office)`. + +**Step 5 — `_fuzzy_merge_keys(groups)`** + +Groups keys by `(first, office)`. Pairs where last tokens differ by Levenshtein +distance ≤ 1 are merged into the higher-total key. Minimum 6 chars on both last +tokens (protects short surnames: Walsh, Jones, etc.). + +### Office Normalization — `_normalize_office(raw)` in `recipient_normalize.py` + +Canonical office values: + +`State Representative` · `State Senator` · `Governor` · `Lt. Governor` · +`Attorney General` · `Treasurer` · `Auditor` · `Secretary of State` · `Mayor` · +`City Council` · `District Attorney` · `Sheriff` · `PAC` + +Normalization pipeline (applied in order): + +1. Strip `"Candidate for [Massachusetts] X"` prefix → `"X"` +2. Strip leading `MA` / `Mass.` / `Massachusetts` +3. Strip trailing junk punctuation (`:;/`) +4. Strip parenthetical suffixes +5. Strip `"of the …"` / `"from the …"` suffixes +6. Strip after dash or slash +7. Strip after comma +8. Strip ordinal suffixes (e.g. `" 3rd Norfolk …"`) +9. Re-strip trailing junk (ordinal strip can leave dangling colons) +10. `OFFICE_MAP` lookup (canonical string → canonical value) +11. Fallback — district lookup: ordinal + MA county → `State Representative` +12. Fallback — county suffix: `"Representative Suffolk"` → strip county → retry map +13. Fallback — location qualifier: strip `"of "`, trailing word, or leading + word → retry map (handles `"Mayor of Somerville"`, `"Somerville Mayor"`, + `"Mayor Somerville"` → `"Mayor"`) + +### New Files + +``` +lobbying-scraper/ + ocpf_contributions.py — OCPF bulk data download, parse, match to registrants + recipient_normalize.py — office normalization + 5-step recipient dedup pipeline + recipient_merges.json — manual merge overrides (start as {}) +``` + +### Infrastructure Changes + +**`firestore.rules`** — add: + +``` +match /lobbyingContributionRecipients/{id} { allow read: if true; allow write: if false; } +``` + +**`firestore.indexes.json`** — add: + +| Collection | Fields | Use case | +| -------------------------------- | -------------------------------------- | --------------------------- | +| `lobbyingContributionRecipients` | `officeSought ASC, totalReceived DESC` | Office-filtered leaderboard | +| `lobbyingContributionRecipients` | `officeSought ASC, recipientName ASC` | Alphabetical browse | + +### What Is Not Implemented (Phase 2) + +**AI bill topics (`tags.json` equivalent)** — requires a bill embeddings parquet +file. MAPLE does not produce this file. The topics feature is deferred; MAPLE's +existing bill search index could be used as a substitute in a future PR. + +**`recipient_merges.json`** — starts empty. Requires domain review of the +deduplicated output to find cases the automated rules miss. Populate +incrementally. + +### Order of Work + +1. Confirm OCPF bulk contribution file URL and column schema +2. Confirm or incorporate HTML archiving pattern (see open question below) +3. Implement `recipient_normalize.py` (self-contained, testable in isolation) +4. Implement `ocpf_contributions.py` +5. Update `functions/src/lobbying/types.ts` schema +6. Update `writer.py` and `scrape.py` +7. Update `firestore.rules` and `firestore.indexes.json` + +### HTML Archiving for Fast Reparsing + +The current scraper fetches and immediately parses SoS portal HTML, storing +nothing but the parsed Firestore documents. If parsing logic changes, the full +portal must be re-scraped — slow and fragile given the Imperva TLS constraint. +Phase 2 adds GCS archiving of raw HTML as a side effect of every portal fetch. + +#### Design principles (from the AMEND reference implementation) + +The archive is **write-only cold storage**, not a cache. It is fully decoupled +from both the incremental cursor (which stays Firestore-only) and the parse +path. Fetching from the portal is always driven by the Firestore cursor; the +archive is a downstream side effect of a successful fetch. + +Parsers must be **pure functions with no I/O** — `parse_summary(soup)`, +`parse_disclosure_detail(soup, year)` — so the identical code runs in the live +scrape and in the offline reparse script without modification. + +#### GCS key scheme + +One object per fetched page: `raw_html/{sha1(url)}.html`. URL-hash is +collision-free without modeling the ASP.NET URL key space. Individual `.html` +objects (not batch tarballs) are appropriate here because our scraper runs +weekly in small increments rather than in large historical sweeps; per-object +GCS is simpler and makes the reparse path a flat list + get. + +Bucket: `gs://-lobbying-archive/raw_html/` +Storage class: Archive (written once, read rarely). + +#### Write timing + +Archived immediately after `raise_for_status()` passes, before parsing, and +**not gated on parse success**: + +```python +def _get(session, url): + r = session.get(url, ...) + r.raise_for_status() + if "Summary.aspx" in url or "CompleteDisclosure" in url: + _archive_page(url, r.text) # side effect; never blocks parse + return BeautifulSoup(r.text, "html.parser") +``` + +Gating on parse success would defeat the purpose: the archive exists precisely +to recover from parser gaps later, so we want the bytes even when the current +parser does not fully understand them. The search/results page is excluded +(same URL across all years, trivially regenerable). + +#### Reparse path + +A dedicated offline script `lobbying-scraper/reparse_archive.py`: + +``` +python3 reparse_archive.py [--limit N] [--dry-run] +``` + +Lists `raw_html/*.html` objects from GCS, downloads them, resolves each +`sha1.html` back to its original URL (stored as object metadata at write time), +and runs the pure parser functions against the archived soup. Tracks completed +objects via a `processed_archive.txt` marker so reparse is resumable. + +#### Cursor interaction + +No change to the Firestore cursor. The archive is never consulted to skip a +portal fetch. "Have I processed this disclosure?" is still answered by the +Firestore cursor; the archive is a consequence of fetching, not an input to the +decision. + +#### New infrastructure required + +- GCS bucket `-lobbying-archive` (Archive class, no public access) +- `google-cloud-storage` added to `lobbying-scraper/requirements.txt` +- `GOOGLE_CLOUD_PROJECT` env var (already available on Cloud Run) used to + derive bucket name +- IAM: Cloud Run service account needs `storage.objects.create` on the bucket +- New file: `lobbying-scraper/reparse_archive.py` + +#### Order of work within Phase 2 + +This is a prerequisite for `ocpf_contributions.py` only in the sense that we +want the archive in place before running the full historical backfill so we do +not have to re-scrape. It is otherwise independent and can be implemented +alongside the contribution pipeline rather than before it. diff --git a/lobbying-scraper/__pycache__/normalize.cpython-37.pyc b/lobbying-scraper/__pycache__/normalize.cpython-37.pyc index 47c3ba707ebdca4ef16776e15507d9f385437cab..94efb861e98ad8f45f5a0ec1065e5d0290dfb499 100644 GIT binary patch delta 132 zcmZqSZsF#3;^pOH00O^GyN%ojnHg_QKFeGvaEmE9;}%;%Mp0sM>Pm(p*~xw^eFE}8 zWtu#<*yH0<@{{A^Z%ux~B5Qq%%hTP@KgiYDG1#?82&ke+6hw%D2ni4&4kAEWi)2v= Jxydf94gg<&ADI9E delta 132 zcmZqSZsF#3;^pOH00OyZiW|8PGBZX^KFeGv5XF?75ye)JQIuGmx{{$tYO)_opMVTd znI_LI_W1ae{N(ufsL5|wWUZsPJl*~LgIt{*gI$XRfhvkbK!hlW5C;)rAOfVdND7sZ Jp6tTv004rD9S;Bi diff --git a/lobbying-scraper/__pycache__/portal.cpython-37.pyc b/lobbying-scraper/__pycache__/portal.cpython-37.pyc index 413885e3d657f24ebf306be5b8d9a45a80835a47..d515175f364a6ecf06fd72e46412580c29dbe6e1 100644 GIT binary patch literal 16091 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 KpHQy!#QzrrFX^EG delta 4985 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 str: + global _bucket_name + if _bucket_name is None: + project = os.environ.get("GOOGLE_CLOUD_PROJECT") or _gcs().project + _bucket_name = f"{project}-lobbying-archive" + return _bucket_name + + +def blob_name(url: str) -> str: + """Return the GCS object name for a given URL.""" + return "raw_html/" + hashlib.sha1(url.encode()).hexdigest() + ".html" + + +def save_page(url: str, html: str) -> None: + """Write raw HTML to GCS. No-op when ARCHIVE_RAW is not set.""" + if not _ENABLED: + return + try: + bucket = _gcs().bucket(_get_bucket_name()) + blob = bucket.blob(blob_name(url)) + blob.metadata = {"source-url": url} + blob.upload_from_string( + html.encode("utf-8"), + content_type="text/html; charset=utf-8", + ) + except Exception as exc: + # Archive failures must never interrupt the live scrape path. + print(f" [archive] WARNING: failed to save {url[:80]!r}: {exc}") diff --git a/lobbying-scraper/portal.py b/lobbying-scraper/portal.py index 257721991..3a5528898 100644 --- a/lobbying-scraper/portal.py +++ b/lobbying-scraper/portal.py @@ -3,13 +3,19 @@ Portal: https://www.sec.state.ma.us/LobbyistPublicSearch/ Page flow: - 1. Search POST → summary links table - 2. Summary.aspx → registrant name/year/type + CompleteDisclosure links - 3. CompleteDisclosure.aspx → per-client compensation + per-client bill activity - -Two disclosure HTML formats: - Modern (>=~2013): grdvClientPaidToEntity + grdvActivitiesNew{year}_{n} tables. - Legacy (<~2013): grdvSalaryPaid (total only) + grdvActivities (all bills). + 1. Search POST -> summary links table + 2. Summary.aspx -> registrant name/year/type + CompleteDisclosure links + 3. CompleteDisclosure.aspx -> per-client compensation + per-client bill activity + +Four HTML format eras for CompleteDisclosure pages (detected by table IDs): + Modern (2019+): grdvClientPaidToEntity + grdvActivitiesNew{year}_{n} + Hybrid (2014-2018): no comp table; Panel1_{n} divs + grdvActivitiesNew_{n} + Legacy (2009-2013): grdvActivities with Compensation received column + Legacy (2005-2008): grdvSalaryPaid (entity total) + grdvActivities (no comp col) + +parse_summary() and parse_disclosure_detail() are pure functions (no I/O) so +they can be called from both the live scraper and the offline reparse driver. +fetch_* are thin wrappers that handle HTTP and raw-HTML archiving. """ from __future__ import annotations @@ -23,6 +29,8 @@ import requests from bs4 import BeautifulSoup, Tag +import archive + # ── Constants ───────────────────────────────────────────────────────────────── BASE_URL = "https://www.sec.state.ma.us/LobbyistPublicSearch/" @@ -33,14 +41,15 @@ "AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148" ) _REQUEST_DELAY = 1.0 -_MAX_RETRIES = 5 +_MAX_RETRIES = 6 +_RETRY_STATUS = {429, 500, 502, 503, 504} # Lobby disclosure data begins in 2005; GC 183 started Jan 2003. FIRST_YEAR = 2005 FIRST_GC = 183 FIRST_GC_START_YEAR = 2003 -# clientName sentinel for pre-2013 filings where compensation is a single total +# clientName sentinel for pre-2009 filings where compensation is a single entity total LEGACY_TOTAL_CLIENT = "_total_salary_" # Maps canonical chamber names to the bill-ID prefix used in MAPLE's Bill.id @@ -69,7 +78,7 @@ class Compensation: @dataclass class BillActivity: client_name: str - chamber: str # canonical LobbyingChamber value + chamber: str # canonical LobbyingChamber value raw_bill_number: str bill_id: Optional[str] # e.g. "H1234"; null for Executive/Other activity_title: str @@ -81,7 +90,7 @@ class BillActivity: class DisclosureMeta: entity_name: str year: Optional[int] - reg_type: str # "Lobbyist" | "Employer" + reg_type: str # "Lobbyist" | "Employer" disclosure_urls: list[str] = field(default_factory=list) @@ -110,7 +119,7 @@ def construct_bill_id(chamber: str, raw_bill_number: str) -> Optional[str]: """Construct the MAPLE-compatible billId from chamber + raw integer. Returns None for Executive and Other chambers where no bill join is possible. - H1234 and S1234 are distinct bills even though they share the same integer — + H1234 and S1234 are distinct bills even though they share the same integer; the prefix is required to disambiguate. """ prefix = CHAMBER_PREFIXES.get(chamber) @@ -135,8 +144,10 @@ def filing_id( general_court: int, position: str, ) -> str: - key = "|".join([entity_name, client_name, chamber, bill_id or "__null__", - str(general_court), position]) + key = "|".join([ + entity_name, client_name, chamber, + bill_id or "__null__", str(general_court), position, + ]) return hashlib.sha256(key.encode()).hexdigest()[:40] @@ -159,12 +170,23 @@ def _get(session: requests.Session, url: str) -> BeautifulSoup: time.sleep(_REQUEST_DELAY * (2 ** attempt) if attempt else _REQUEST_DELAY) try: r = session.get(url, timeout=60) - r.raise_for_status() - return BeautifulSoup(r.text, "html.parser") except (requests.exceptions.Timeout, requests.exceptions.ConnectionError) as e: if attempt == _MAX_RETRIES - 1: raise - print(f" GET retry {attempt + 1}: {e}") + print(f" GET network error (attempt {attempt + 1}): {e}") + continue + if r.status_code in _RETRY_STATUS: + print(f" GET HTTP {r.status_code} (attempt {attempt + 1}) — retrying") + if attempt == _MAX_RETRIES - 1: + r.raise_for_status() + continue + r.raise_for_status() + # Archive content pages before parsing; excludes the search page which + # shares one URL across all years and is trivially regenerable. + if "Summary.aspx" in url or "CompleteDisclosure" in url: + archive.save_page(url, r.text) + return BeautifulSoup(r.text, "html.parser") + raise RuntimeError("_get: exhausted retries") # unreachable def _post(session: requests.Session, url: str, data: dict) -> BeautifulSoup: @@ -172,12 +194,19 @@ def _post(session: requests.Session, url: str, data: dict) -> BeautifulSoup: time.sleep(_REQUEST_DELAY * (2 ** attempt) if attempt else _REQUEST_DELAY) try: r = session.post(url, data=data, timeout=180) - r.raise_for_status() - return BeautifulSoup(r.text, "html.parser") except (requests.exceptions.Timeout, requests.exceptions.ConnectionError) as e: if attempt == _MAX_RETRIES - 1: raise - print(f" POST retry {attempt + 1}: {e}") + print(f" POST network error (attempt {attempt + 1}): {e}") + continue + if r.status_code in _RETRY_STATUS: + print(f" POST HTTP {r.status_code} (attempt {attempt + 1}) — retrying") + if attempt == _MAX_RETRIES - 1: + r.raise_for_status() + continue + r.raise_for_status() + return BeautifulSoup(r.text, "html.parser") + raise RuntimeError("_post: exhausted retries") # unreachable # ── Portal scraping ─────────────────────────────────────────────────────────── @@ -207,7 +236,10 @@ def fetch_summary_links(session: requests.Session, year: int) -> list[str]: "ctl00$ContentPlaceHolder1$btnSearch": "Search", } results = _post(session, SEARCH_URL, data) - table = results.find("table", id=lambda x: x and "grdvSearchResultByTypeAndCategory" in x) + table = results.find( + "table", + id=lambda x: x and "grdvSearchResultByTypeAndCategory" in x, + ) if not table: return [] return [ @@ -217,9 +249,8 @@ def fetch_summary_links(session: requests.Session, year: int) -> list[str]: ] -def fetch_disclosure_meta(session: requests.Session, summary_url: str) -> DisclosureMeta: - soup = _get(session, summary_url) - +def parse_summary(soup: BeautifulSoup) -> DisclosureMeta: + """Parse a Summary.aspx page. Pure function — no I/O.""" def text(el_id: str) -> str: el = soup.find(id=el_id) return el.get_text(strip=True) if el else "" @@ -249,6 +280,10 @@ def text(el_id: str) -> str: ) +def fetch_disclosure_meta(session: requests.Session, summary_url: str) -> DisclosureMeta: + return parse_summary(_get(session, summary_url)) + + def _parse_amount(text: str) -> Optional[float]: cleaned = text.replace("$", "").replace(",", "").strip() try: @@ -257,20 +292,42 @@ def _parse_amount(text: str) -> Optional[float]: return None -def _grid_rows(table: Tag) -> list[Tag]: +def _grid_rows(table: Tag) -> list: return table.find_all("tr", class_=lambda c: c and "Grid" in c and "Header" not in c) -def fetch_disclosure_detail( - session: requests.Session, disc_url: str, year: int -) -> DisclosureDetail: - soup = _get(session, disc_url) +def parse_disclosure_detail(soup: BeautifulSoup, year: int) -> DisclosureDetail: + """Parse a CompleteDisclosure page. Pure function — no I/O. + + Four HTML format eras (detected by table IDs): + + Modern (2019+): grdvClientPaidToEntity holds per-client compensation; + bills in grdvActivitiesNew{year}_{n} (one table per client). + + Hybrid (2014-2018): no grdvClientPaidToEntity. Bills in grdvActivitiesNew_{n} + (no year suffix). Per-client compensation is in id-less Panel1_{n} divs + ("Total amount paid by client...: $X") indexed by lblClientName_{n} spans. + Each client reports either a Panel1 total OR activity-level amounts — + summing both sources is safe because the unused one is always zero. + Omitting this path silently drops ~99% of 2014-2018 compensation. + + Legacy (2009-2013): single grdvActivities table with a "Compensation received" + column carrying a per-client total repeated on every bill row for that client. + Must deduplicate distinct (client, amount) pairs before summing — never sum + raw rows or the total is multiplied by bill count. + + Legacy (2005-2008): grdvActivities has no compensation column; fall back to + grdvSalaryPaid entity total under the _total_salary_ placeholder client. + """ compensation: list[Compensation] = [] bills: list[BillActivity] = [] gc = year_to_general_court(year) - # ── Modern format (>=~2013) ─────────────────────────────────────────────── - comp_table = soup.find("table", id=lambda x: x and "grdvClientPaidToEntity" in (x or "")) + # ── Modern / Hybrid: per-client activity tables ─────────────────────────── + comp_table = soup.find( + "table", + id=lambda x: x and "grdvClientPaidToEntity" in (x or ""), + ) if comp_table: for row in _grid_rows(comp_table): cells = [td.get_text(strip=True) for td in row.find_all("td")] @@ -280,21 +337,19 @@ def fetch_disclosure_detail( amount=_parse_amount(cells[1]), )) - act_tables = soup.find_all( + # Activity tables: ID pattern grdvActivitiesNew{year}_{n} (Modern, 2019+) + # or grdvActivitiesNew_{n} with no year (Hybrid, 2014-2018). The same loop + # handles both; compensation source differs (see Hybrid block below). + activity_by_client: dict[str, float] = {} + for act_table in soup.find_all( "table", id=lambda x: x and re.search(r"grdvActivitiesNew(\d{4})?_\d+", x or ""), - ) - for act_table in act_tables: - # Walk backwards to find the nearest lblClientName span - client_name = "" - node = act_table - while node: - node = node.find_previous(["span", "div", "td"]) - if not node: - break - if node.get("id") and "lblClientName" in node["id"]: - client_name = node.get_text(strip=True) - break + ): + client_span = act_table.find_previous( + "span", + id=lambda x: x and "lblClientName" in (x or ""), + ) + client_name = client_span.get_text(strip=True) if client_span else "" for row in _grid_rows(act_table): cells = [td.get_text(strip=True) for td in row.find_all("td")] @@ -303,6 +358,7 @@ def fetch_disclosure_detail( chamber = normalize_chamber(cells[0]) raw_num = cells[1] bill_id = construct_bill_id(chamber, raw_num) + amt = _parse_amount(cells[4]) if len(cells) > 4 else None bills.append(BillActivity( client_name=client_name, chamber=chamber, @@ -310,30 +366,52 @@ def fetch_disclosure_detail( bill_id=bill_id, activity_title=cells[2] if len(cells) > 2 else "", position=cells[3] if len(cells) > 3 else "", - amount=_parse_amount(cells[4]) if len(cells) > 4 else None, + amount=amt, )) + if amt: + activity_by_client[client_name] = ( + activity_by_client.get(client_name, 0.0) + amt + ) + + # Hybrid (2014-2018): no modern comp table — reconstruct per-client amounts + # from Panel1 "Total amount paid by client" divs indexed by client-name spans. + if not comp_table and bills: + client_by_idx = { + sp["id"].split("_")[-1]: sp.get_text(strip=True) + for sp in soup.find_all( + "span", id=lambda x: x and "lblClientName_" in (x or "") + ) + } + panel_by_client: dict[str, float] = {} + for div in soup.find_all("div", id=lambda x: x and "Panel1_" in (x or "")): + idx = div["id"].split("_")[-1] + cn = client_by_idx.get(idx) + if not cn: + continue + m = re.search(r"\$([\d,]+\.\d\d)", div.get_text(" ", strip=True)) + panel_by_client[cn] = float(m.group(1).replace(",", "")) if m else 0.0 + for cn in set(panel_by_client) | set(activity_by_client): + amt = panel_by_client.get(cn, 0.0) + activity_by_client.get(cn, 0.0) + if amt: + compensation.append(Compensation(client_name=cn, amount=amt)) if comp_table or bills: return DisclosureDetail(compensation=compensation, bills=bills) - # ── Legacy format (<~2013) ──────────────────────────────────────────────── - salary_table = soup.find("table", id=lambda x: x and "grdvSalaryPaid" in (x or "")) - if salary_table: - total = 0.0 - for row in salary_table.find_all("tr"): - cells = [td.get_text(strip=True) for td in row.find_all("td")] - if len(cells) >= 2 and "Total" not in cells[0]: - amt = _parse_amount(cells[1]) - if amt: - total += amt - if total: - compensation.append(Compensation(client_name=LEGACY_TOTAL_CLIENT, amount=total)) - + # ── Legacy format (2005-2013): single grdvActivities table ─────────────── act_table = soup.find("table", id=lambda x: x and x.endswith("grdvActivities")) + # Distinct (client, amount) pairs from the "Compensation received" column + # (2009-2013). The portal repeats the per-client total on every bill row for + # that client, so we deduplicate before summing to avoid multiplying by bill count. + legacy_comp_pairs: set = set() + comp_col: Optional[int] = None + if act_table: all_rows = act_table.find_all("tr") - headers = [th.get_text(strip=True) - for th in (all_rows[0].find_all(["th", "td"]) if all_rows else [])] + headers = [ + th.get_text(strip=True) + for th in (all_rows[0].find_all(["th", "td"]) if all_rows else []) + ] if headers and "Activity" in headers[0]: # 6-col entity layout has Lobbyist as second header @@ -344,19 +422,35 @@ def fetch_disclosure_detail( else: bill_col, pos_col, client_col = 1, None, 3 - chamber_map = {"H": "House Bill", "S": "Senate Bill", - "HD": "House Docket", "SD": "Senate Docket"} + if any("Compensation" in h for h in headers): + comp_col = len(headers) - 1 + + chamber_map = { + "H": "House Bill", "S": "Senate Bill", + "HD": "House Docket", "SD": "Senate Docket", + } skip = {"Activity or Bill No and Title", "N/A", "None", "", "Total amount"} for row in all_rows[1:]: cells = [td.get_text(strip=True) for td in row.find_all("td")] if len(cells) <= max(bill_col, client_col): continue + client_name = cells[client_col] bill_cell = cells[bill_col] + amt = ( + _parse_amount(cells[comp_col]) + if comp_col is not None and len(cells) > comp_col + else None + ) + # Exclude "Total amount" summary rows appended by legacy individual + # disclosures — these are not real clients. + if amt is not None and client_name not in ("Total amount", "Total", ""): + legacy_comp_pairs.add((client_name, amt)) if not bill_cell or bill_cell in skip: continue - parts = bill_cell.split(None, 1) - bill_no = parts[0] + # Bill token may use a semicolon separator ("H73; Title") or a space + parts = re.split(r"[;\s]", bill_cell, maxsplit=1) + bill_no = parts[0].rstrip(";") m = re.match(r"^([A-Z]+)(\d+)$", bill_no) if not m: continue @@ -364,13 +458,55 @@ def fetch_disclosure_detail( chamber = chamber_map.get(prefix, "Other") bill_id = construct_bill_id(chamber, number) bills.append(BillActivity( - client_name=cells[client_col] if len(cells) > client_col else "", + client_name=client_name, chamber=chamber, raw_bill_number=number, bill_id=bill_id, - activity_title=parts[1] if len(parts) > 1 else "", - position=cells[pos_col] if pos_col is not None and len(cells) > pos_col else "", - amount=None, + activity_title=parts[1].strip() if len(parts) > 1 else "", + position=( + cells[pos_col] + if pos_col is not None and len(cells) > pos_col + else "" + ), + amount=amt, )) + # Per-client compensation from the "Compensation received" column (2009-2013). + # Fall back to grdvSalaryPaid entity total when no compensation column exists (2005-2008). + if comp_col is not None: + per_client: dict[str, float] = {} + for cn, amt in legacy_comp_pairs: + per_client[cn] = per_client.get(cn, 0.0) + amt + for cn, amt in per_client.items(): + if amt: + compensation.append(Compensation(client_name=cn, amount=amt)) + else: + salary_table = soup.find( + "table", id=lambda x: x and "grdvSalaryPaid" in (x or "") + ) + if salary_table: + total = 0.0 + for row in salary_table.find_all("tr"): + cells = [td.get_text(strip=True) for td in row.find_all("td")] + if len(cells) >= 2 and "Total" not in cells[0]: + amt = _parse_amount(cells[1]) + if amt: + total += amt + if total: + compensation.append( + Compensation(client_name=LEGACY_TOTAL_CLIENT, amount=total) + ) + return DisclosureDetail(compensation=compensation, bills=bills) + + +def fetch_disclosure_detail( + session: requests.Session, disc_url: str, year: int +) -> DisclosureDetail: + return parse_disclosure_detail(_get(session, disc_url), year) + + +def year_from_disc_url(url: str) -> Optional[int]: + """Extract the filing year from a CompleteDisclosure URL query string.""" + m = re.search(r"[?&]FilingYear=(\d{4})", url) + return int(m.group(1)) if m else None diff --git a/lobbying-scraper/reparse_archive.py b/lobbying-scraper/reparse_archive.py new file mode 100644 index 000000000..32f4b1563 --- /dev/null +++ b/lobbying-scraper/reparse_archive.py @@ -0,0 +1,155 @@ +"""Offline reparse driver: re-ingests raw HTML from the GCS archive. + +Downloads archived CompleteDisclosure pages from GCS, re-runs the pure parsers +against them, and writes results back to Firestore. Use this when parser logic +has changed and historical data needs to be re-ingested without re-scraping. + +For each archived disclosure page the driver looks up the corresponding +registrant document in Firestore (via the disclosureUrls array) to obtain the +entity name needed to construct filing document IDs. Registrant documents must +therefore already exist before running a reparse. + +Usage: + GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \\ + python3 reparse_archive.py [--limit N] [--dry-run] + +Progress is tracked in Firestore at /scrapers/lobbyingReparse so the run is +resumable: restarting skips blobs already marked as processed. +""" + +from __future__ import annotations + +import argparse +import os + +from bs4 import BeautifulSoup +from google.cloud import firestore, storage + +import archive +from portal import DisclosureMeta, parse_disclosure_detail, year_from_disc_url +from writer import REGISTRANTS_COLLECTION, write_filings + +REPARSE_DOC = "/scrapers/lobbyingReparse" + + +def _meta_for_disc_url(db: firestore.Client, disc_url: str) -> DisclosureMeta | None: + """Look up the registrant that owns this disclosure URL.""" + results = ( + db.collection(REGISTRANTS_COLLECTION) + .where("disclosureUrls", "array_contains", disc_url) + .limit(1) + .get() + ) + if not results: + return None + data = results[0].to_dict() + return DisclosureMeta( + entity_name=data.get("entityName", ""), + year=data.get("year"), + reg_type=data.get("regType", "Lobbyist"), + disclosure_urls=data.get("disclosureUrls", []), + ) + + +def _is_processed(db: firestore.Client, blob_name: str) -> bool: + doc = db.document(REPARSE_DOC).get() + if not doc.exists: + return False + return blob_name in doc.to_dict().get("processedBlobs", []) + + +def _mark_processed(db: firestore.Client, blob_name: str) -> None: + db.document(REPARSE_DOC).set( + {"processedBlobs": firestore.ArrayUnion([blob_name])}, + merge=True, + ) + + +def run(limit: int | None, dry_run: bool) -> None: + gcs = storage.Client() + bucket_name = archive._get_bucket_name() + bucket = gcs.bucket(bucket_name) + + db: firestore.Client | None = None if dry_run else firestore.Client() + + blobs = list(bucket.list_blobs(prefix="raw_html/")) + print(f"Found {len(blobs)} archived pages") + + processed = 0 + skipped = 0 + errors = 0 + + for blob in blobs: + if limit is not None and processed >= limit: + break + + blob.reload() + url = (blob.metadata or {}).get("source-url", "") + + if "CompleteDisclosure" not in url: + skipped += 1 + continue + + if db is not None and _is_processed(db, blob.name): + skipped += 1 + continue + + year = year_from_disc_url(url) + if year is None: + print(f" SKIP {blob.name}: cannot extract year from {url!r}") + skipped += 1 + continue + + meta: DisclosureMeta | None = None + if db is not None: + meta = _meta_for_disc_url(db, url) + if meta is None: + print(f" SKIP {blob.name}: no registrant found for {url!r}") + skipped += 1 + continue + + try: + html = blob.download_as_text(encoding="utf-8") + soup = BeautifulSoup(html, "html.parser") + detail = parse_disclosure_detail(soup, year) + except Exception as exc: + print(f" ERROR parsing {url}: {exc}") + errors += 1 + continue + + print( + f" {url[:80]!r} — {len(detail.compensation)} comp," + f" {len(detail.bills)} bills" + ) + + if not dry_run and db is not None and meta is not None: + write_filings(db, meta, detail) + _mark_processed(db, blob.name) + + processed += 1 + + print( + f"\nDone: {processed} reparsed, {skipped} skipped, {errors} errors" + + (" (dry run — nothing written)" if dry_run else "") + ) + + +def main() -> None: + parser = argparse.ArgumentParser( + description="Reparse raw HTML archive into Firestore" + ) + parser.add_argument("--limit", type=int, default=None, help="Stop after N pages") + parser.add_argument( + "--dry-run", action="store_true", help="Parse but do not write to Firestore" + ) + args = parser.parse_args() + + # Ensure archive module can resolve the bucket name even in dry-run mode + if not os.environ.get("ARCHIVE_RAW"): + os.environ["ARCHIVE_RAW"] = "1" + + run(limit=args.limit, dry_run=args.dry_run) + + +if __name__ == "__main__": + main() diff --git a/lobbying-scraper/requirements.txt b/lobbying-scraper/requirements.txt index 5e7b4bcc7..d92c075e4 100644 --- a/lobbying-scraper/requirements.txt +++ b/lobbying-scraper/requirements.txt @@ -1,3 +1,4 @@ requests>=2.28 beautifulsoup4>=4.12 google-cloud-firestore>=2.14 +google-cloud-storage>=2.10 diff --git a/lobbying-scraper/tests/__init__.py b/lobbying-scraper/tests/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/lobbying-scraper/tests/__pycache__/__init__.cpython-37.pyc b/lobbying-scraper/tests/__pycache__/__init__.cpython-37.pyc new file mode 100644 index 0000000000000000000000000000000000000000..33712a9e9d1c30a3e9f3117c1aeee0bc732287a3 GIT binary patch literal 166 zcmZ?b<>g`k0uBNDED-$|M8E(ekl_Ht#VkM~g&~+hlhJP_LlHU z)_2KIF3nBND=F6Z@ClB0@^+4QOU=p2FE7r>EYQzQEXYaK&&f|ps?5ww*DX#iN-Rh% m(l1FZ2C9#b&&p literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/__pycache__/test_portal_parser.cpython-37-pytest-7.4.4.pyc b/lobbying-scraper/tests/__pycache__/test_portal_parser.cpython-37-pytest-7.4.4.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e18d528fef20c09e455674b6193d29d211ecb5a7 GIT binary patch literal 17098 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 TqF`psEDqBgiQT8WIWzyiIwjag literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/fixtures/2007e_disc.html.gz b/lobbying-scraper/tests/fixtures/2007e_disc.html.gz new file mode 100644 index 0000000000000000000000000000000000000000..4311a97da1c89818ae2c6c06bfc17f94a57f8001 GIT binary patch literal 21790 zcmV(xK(&PXmo9C0PH^BOhl4RqyU$F~B@ zb+E1L=WlDM)(?W=p01BZqxz^_cfFo|b)nzTzM8bLxYPorW!((S+7TO^jd?S$9se++ zr{?bNF7Kd*j%aOy&7*_gGz}dLNPrP-p^IIuc4sUgF40^$UR zwO8kd#Oy(deso}4&R5j;NcXU&8@{jm!L3d3aOl_Ju7*5fAJ$lz-zOxfq2P8%4r>9q z33OJ04huC5j}Rxb!@wOn__|tFoZ z(SgqI=IEp6x;>kG#xNtdfn_B6(KJ3oK|lpO0Mqc>N8*@P_fraL-eKSM0wWBN1xyk3VGVGP_<9##)8hKj>B-^P z6a7Zx)yFWabilq(0$&gPk?Cu#&&}rN7K4fx0843Ii}HFA8f6Vc`!?Kb;@z|F%t=j+ z(Yf#3qO*5zuby0?x98_)h?R4>6}-urPz(#a_~lzjyxaP~awc(eb_=atZ`Yf3-?j$x zH14==;DbsUrW+v@2?qU(cNggQ*Y8e_U!%9je+p!>I*#$e7kO_vR!|7Bt$HKg<{+>F zn?TcFUb~&nt>p*keb})r16>mA8GYze=T+3nrIUI|r|^*y{`W!D$`#Qdq|<4pnYNl(3w7mi;ipF9w9y=V0U0z*T^ytYi<}2k6Maf zeuLm{>PR>Jajk2rfE4nt>XrPJJ@SChBv=igCQsd z>;(JYAN?BI_0Y!}XztIShaQMO@FFe1hT(c97_HP}t!KL(Y{zSfLS$R(XaSwV|93Xb zy2cRID24YN*CG4xz#&?nSiOF**Q{@l0Y!>Zmw0QmGk&RQFdLvJi7EPQ*2fR)S@qOH z1-1#@-2o0g%hA9F?zJ|PG_LbX6yfpQ+>I9V#`PMbLKEF}p?9r|2bO)iSG#mW&mia$+z<5LbI}LVsjZ_#={h>aw$<@q-p(x3 z4c5^W?z;oLjxJna8hC!?kxppzNr2v5t|K4XX+H6+ZX8DykXA83#P|_Bc>!T07NkOP z4q6@{9SqXf0Vt?R;lf85RwWvnK)eQhGrE1yWZYfqtVz$oNIP=fX@V*3V>h$w66+KeTT~rXrZXz=t6Y87P0<-^!O7b z+21DJfblT;o*&j2=fnV4go<@45TOFYrq#FpCVS0|1eqTFYFlId;)k69aYD@s1URWu z35H3A*bAUI04K&6qB}tpw6#g4l3GUn`QsJ*J=cFi{?NZgK#tJA-<+SlIz~^yr_#7E zw6=GjAynol&vo>Z=nwr{ZOFMRBL4n2TNtT4ihxOnH_z@K{n`n^?l^H1{rR&}%9Jy; zg=;3PAB3|-4J7i1*ooU2#B72n@tCS+C5ma-jP8s2MDv*bV%QDcVQ7Q1@WUdg*wr5w zNr#M906Qw6#qje8t-2B@7DsZ(LJF9MYJYG{p^IzFAU`;kHo=|)%j%WDvM7?c1M9_= zz>pzH*JsjKSY@B*C*%+Nd#DA~&hGZl1(p2$WS58kB^Oj;J%w!>VaJTEtAJPOx=LtP zW+DvNmjBAQmIyxcC|k_M5%J`<5*g%%qQxwQh+gs{-?c3hHHSB7t=k<(I_DX$B?sJW zBnK36@0^`Rc3t#`7zQzLQ4-#{JCC468|}x5$gXlJ`$(0byJYyXgN?5}&kY?@V`DBmnW!m`9+s#@PjtJ&0i*IfWAO zT_w+u3Z1fa42N`AG-z#RGE!_}=#22Wk$g10>l4YOjmJC&o0*0|>4Xvu?V=<8zz97L z)}MQOxEl~}9Tn*#a=!NZG*2x0LU+on^4K-o?*U6*7%&mOr*urjHB=_in(@pL5&`I~ zRz@Nq*^x{hq`+BgG+NCKEIhD`hF#YP{b}v^ZW-Ek&b+{#Y57AN-|ls6*Z7)_=f|@V zJfA01TpMFnV$8dh%BtnbEyRRyGeyREGAapNGV&B0&T*oGBN0nbl0l3L?Y7J;B=UHP z!9;(}oml3h)lQNmo`j=o0u}#eJfWoalz5U>)8ovJg827hIi4w#G8v{Mc6ZZi7J`bA zYjUql3`)){rN-cfoMi<0x=-rj)=t8Lq;w6?&USIIM`sFViJCES9aAx?;Eg9WrnFg| z?-CA1mN-9tPrwMKOKRzs(%S?%-xyn=l*UD($HZJ@HMgw)E7AiPABIx z6lk;A-ri~`&4nSPbWz-s#zxE7Xht4J={V(qjOn0h@rP*xq->hpbi(*+dp5%<$=%IX zQkKhtN*KrtgDouGf`(=0HSef0E>gzmBC!ykjjhbtkoG0b?Ii-Tgb9!%&oKu|c&ZEt z6xE+G5uEP3Lf@7=-V*4ojy@OPmq~J(ipfwx=@RLswHLzm6pSTI0ULHcepgq7Wq=@Z zMHzFzDV|)hN=_n{ptK5tBIGcNA9N zS_IwYuuGtMG;{&CraTQJV|0`0zOx9r%VC#5_h{&)nN^l&6wAEr^xC+zA(lW~KJL8g zJAb;iz?w}AO+%!JMJ)V2Hr){mpVB`KwsPb#n5>`%Xrm=4z@Qk1tMNqLbqbG_g|V@3}4}&u6c(pgWE{8(#)-I&RRHdaad= z;l=2owKBpj%~&o6n^x%WWe1ZuxAB^4oF3RLE^}Si8wiLsdYuWjxXA)A0~iqzA<(sWBE_-4LC#llU zN(@lI;kSdME|Sr*toh?*G5{A3k~bd50T5BOiFi)Ia;KS_PR z&&-Es&rc!NN86i^(S$KYGt2oxjDVOLP5pr!DzDf*2bm0>`ox9`&yq>s^s-~zt>yRu zwr%aU|3)+a^LE#|9(-$^+`er!|8gX_9`OMcc}HJ+W6aEQ-@GqQT}sByS$4=P$jmArG6$;@I7q!oF;41% zI$Ni<>l5?_s??6?-v>G$MzSdfL)_5Ud)3D8Ma~$?tsY~DT7st~LuYYwij~v93@H)Y zt5EzltN+BKDZ@-4FYCi#1d88gj~0KFCNduYn8X_N`0)i)Jp63=$UN79?ogw{(X&B( zosT!_ThPY8?$waz+Ux)kxCGXh!=CVA5vzWbnBR%i2<;RlSX7T6=(d%ECGs)#qPZFjX*qDBOf9;2 zP81>4EN0x8z4B^}nf*!GDirA{pc2%X)SIom@FhwkIThT^0DCfd^j<@@|l~c zdX~KxktC!>j8XEb$}qCh6rXp(Y{@C;xHnSvnb5bzA1eIt!|hxeKMN~%Jdo#(ki3|~ z{!OD4s4gV_jT_s{q(o9wl#PM&0>XgF@D|kgUwXEbkYqwZWyK9AfXgMh0K5$545g}W z9ZkcmD%B&f=3`4eNe18jd7&p31!MHU130=MJwOw@*}z4A!a6>(D07*RWuOM^XZbXF zq{EZYvjU5#m-T)yn2Pxe%b^P)kl6PgAkHLl6|sl49R2gvGIjW4nKv^rKQ}|3cLUrn zh|k{a^j8=4!1|jwn&r@dHjg`r9SW2XYd!Z`v&l8F{i!s0&8pC~`XwC-{Z2zj4o!Hj zDq(sN20C4=f%*;koNI2k3)Jy)iHM2d;knJiYUmwp2of`aBn8yA9@_Jo9p>wnZ>lC) zs#XQfQ6ZQZT=(Ka2AA~VgxvXBFSJZ@AJG+E%;d&XQ62qGt5bu;MfFnbM_N@u?b8q~ zzGWJ0CJ|op%IMWt-K{F#*980y?63=(`{8zICIuAC5nQ1^MK`NT29~2R0zGg?jwWtq z%L1>5FaoK#ML>otXpUZDdy;ZqG96%bJxmdT7LG_qKZSq!A+E}09s9$ZsYKxQM8Mq} z(u@E>XE?we?3d)o{*WfET}6|2yd0Z0_gaINYJE5Ki57sy$|#vByxeTPq%A;fp+z-C zb~+*0W(Rh4?FKX_sW{-Y2>eTJWCeZAw0zvL?0k!|KUqUW8=^C%;VM#yIpNe*Vg7eG zpcJvOLld}p^gC-&uAP4X-84`AymcA2>}u)xm)xHB!-S!eacE_mZsAz;nc7D=Vd!9# zO7Bml-NaDzb}|&L?Duasi-x5YswshKg${|BwDKg9$(0E*)47-@$h@r3amsm7x2G!@ zsGD6H3HI1rPBeL@vs1_cV}RX%{hm08U~a1hZFFp!uwL`23h07;a{>#4nZDJAp4;>A zV5W6D=Iz02kF}?PSlYe{#y&->0raHN^@ep#{Q0RS8b%j0X%yQsgpNhCDv)LYQQACl zAJr9-F`tzrhdUTpe(E}hOBmIy0@_SK2Ed--pb!b<_Bf6AkyVz9B+)jzH>^#PG(XxB zUVRa(g3I`g)mX(FB3zWZ$-#2t%2g1<;>-5vN(1L!sdwt z;tcu*{WCiV9}R)VTDb}onHOPOd`T<1n2GvpQLz#XFfY3Nl~Z|GL*jNO>f&o-7rgpP zL}PfPd)k>QhKn~>!_EMQ`M_U2n(z;eCN&bB#4{F{fTgU5CmdAFL| z1sA?5(PMO_~>wcvMasFKZQOogF&g{vFtX~C+ z{2)oB!UidC?Fyt3mYzY#ZB3W5k)0kLRycF;mVN+-9#DRMU266KM2pCmF0!%$JIMnL z+gqh=S*HY1k^%`76Nv%#l$&h+disN?IZ0MJVXOThzsCs-;mZtRQ{^q4=^e*;zU7~Vl-fV zBy$IGy3bxuuvE(hK!W`WIgmq{L8ANEicyDmVL9JIYYs}hlJ!?&1;5Ds6ifGoaz~4o z;tPqmP+@oILbfl*4eElEfB%>HGCd=CZcn?Ymn1`IV@F9KpKy?pv9r0{B8C_>;kg_c zMy>^TQRR6?#hsV39HL~uxt$^@8b!^=Vtu3SNg`VmUIz31O`f2dM(q~MU*iZ+^+cft z`viN!B!VcKR?iBs9qk}Uise+>cg7oMZ6wIMFn$2a#5Y;wCQiZq7i%yq4C%~rEtw*F zgB{!>gVJ6IyFcYh&3=H<8tHgAB-o~#d9h{^$HMlUNfC6+dMJy#3iwyNS%GByg8Z_| z_*%I$Cd)ZMK}mWPKSd$dNl9K8D2sCTuBJS%!rqojEcGM>HF1h%aVa(r zKb^1S!O0c%z;==wbonWw{H(U+x*FqcFF?nfHuMzRz@6CpKsx$+@B)1O4QP=52SUEe zN3-8nlUrxd8IXv&G)T6sibKKZqwds{TQnJ|O7zCWkp*!@c8_hKC{w>xftusZNE2z; zthbBMknUBQi+=G9#hF`}X3%j7PTX8gmY{!&zlpzK1$U!>gy`?>U zYZE#XV5RmrRbBC*d3DcXvjDldb-_!{+&RjnEIH+8j9^t!bisKUby3b@)3wMxs(pXJ>cm4vl(_k)l}2 zTQOC1$6%R6R9>u6816@V*RUjNu>&?Vv57i{VhLx z6liHOaIC*er;$U>@GT7por7ud9Bk(&8MH;v7+o^h{;nR;TpaZMh3GN$I9oYrMpLZWponv7kPBu;q+c8!k=-g3})&FLqnj*nh@!NIMRD&r~b zg-~!I`E;H@M;Ij%>u0R_@)^8@De1YcsR2n@glWDB$vj1nG9Wd?r^E}aE{!h{U%h!p zS8gxB#>`eLY8TYZ{0^YfQ$`u6mEvo$hlsm1LmNBJ+{Db0Ur+|oGe^v|=T^2t??tPU zHX+|HzE`n`U81ZK0le)>2k_+guxo|mcdw%!N{Zi+YvPo*Tcl9HPEth)*hw@K0Xtc| zq5(Tb>z_M9*vH=_A6GLz*K8~=KzIK@n+bDz>xSA_#~sCPX4<|p;J?4z5dAMy{#T{E z2cG@ERT!tpx#iIo0_9TkzmmY{=R88?cJjv&t3W2YSsD}9c6;|A6?LTWxFbCvfGkyD zK}e6jo8#nj1)TABJJ=cMSG-S|RK4U~m-VvO!|lRl?e3!itGXYf**IBpl7ca(qSt<= zASRq<*Q)YycB^7W=l>`X`_{}NzfAOyyFse9xU9r#a;MU(N!)S6p!ibqm^Md$l(rRw z#cs-3O70Y0N-~lt>qv=XVjU@qS92Z737y>fA=i=h&7ZqJxMWn+uPW^DG2kBj5H#ic zYxMNRynDBKx)Z&2E4Ify9|_>zz#hr-#ko^nZ?*7KUNfblqJ_~%o!~O}r=0#+S*(59 z7!PNA|GZu${JDxbXo<2s@0CtPKii@bU`rFcGL$ZgG_H)NV&iMib3@0}_&3P|`i-?A zh$s63`g8!N!1bFp^M@|ak1tMNo*ZAG*_GjUG<#HeYJ|_W3DgicVPt$4-_pyzDb}@! zZB9e;pzkR?YJIP!&z$cAy3s{#MeieucWoC3d+arh$lc^GZ6rTy0r%?X=x2X__`q_8 z;GzY$Ll}pCRv!FZDWQR8@=X_-0E*R(ppvf_uuo|q2OO+vbenCA4|Iz3^f#iV^h~UA z;2WMbR1wm@;A_lFr^E2H8#>JYdpcS-*Ms$N-C6h7$+NrB$0wH~t4q6l*ZBfI;*(E@ z&i?45^XZWO_0K<1!)JF>2cWg<-wydd|NQgu)3f?8^!ra?{z7_ufd6d&`@Vl@)(ww< zHa)l5p#o2XXZzE-CD5Qp0#VyPxxK=@w=f&f?qlQAzF)`wtz#TE;fi|t;XbKzVSVeG zq;5Gr@q!Zqv?os~x>Lvc{_N=pR^u*E$Tb+u>rXgspR7O8br?Yq$}pX};SO}@{{Ps! z)+R- z*>r?a*>E_Iz0cZv?ekn4uKPK_Kd;uGoE0SdZMFUhm2#~dNb}*R?YHnrJmG(~+CpO* zc)#OhEZ}8r4v+Cq*eC3#Yc&RklGg4fcko9o*!8#HvTr3?ph^O*-elu0w(FXkx%}>5 zpTYE>dGoK&8%~{iN7Rtg-!uJJqUTnrm42G>i<7TY1HP#Z)L`woDe~XF+Z*lh5v`+1 z&pvtwkH3ZezkS&C+K-F6HI_a96D`)dg+{rlggET3#v3~j9G z?%R*0|4*Cw`Lp2yWKq$m>%)`3eR%&rJI)0P92t-AKSJFN3vvVj{fwI7BCo#B|L0Az zl$Y)B^X@-s1NZ0nZ=R0b)wuMnmM((FtSt;Du-fA_~HdQWwi3i$?Q9rmMN*4F7-FnE+nUxq!NoAINu zxS?s=Mr{Ot!*`pNZmaJV2HF<7TR?YN97i|dWR=BYKDLbbd#m^Kx}HP5-lY}W9j=sF zL)-MX_45E7vc z8+>tN^55p;&s1N#W~J*B(5CQzpgrUtv$lG_ z9sMO-$_0h&+RzjR8LMT2;YVEsZI9obc?qWBd+N8p2;*Gk{)7HH3UBtD_(|S~8mEkX zw}l=e^`HcAN@ySw9gUnu5u2D`GYqj=+W+hO zf819a*g$@01d&wrMzv;z;3B#Di_JtpJWn_oz_rbR@dUJ7$fS=tPk0o=$2_-EPbnn`@HW ze+d!&Yd1-;-h=-ilT6U> zBZhar9+ROyY%fQ6f2I>$iwf&1F{u+|-wgRd9sOdSA}U-Hvw2Dj_=E^}hX@5oPuQy- z6=}_uZK;s|Qu88L$3>N}Ig)~ZpuNa| z%|%J9d=oe(UjlFC?pud zRV4IX`%o`laOg@$5@SBbLZ0HP=>3;ew_=kxq#NpNnXo+2XRBS)PU=(h_2H@RbQS5Q zj>=_Q6Y{Ihx`~FB8HHA=Cad@+t|X)}9S~CZdCZnqTuXP&xd45j+Ta}8=bM}jZFitg zEJvQ%;N}XZPq9dta-VxP_N7NNvFR~23D@c4e$^jNLijGx2V`}mM!uOWt0pcsIB$Yk zE#j9>+^AR;)3*}dA644(PQpQ(=|H8+yo?JA(9MLK9)CN#>D!L#`evm+8F_-sIaQ%K zCF~yEUz)hE8dZd{=_$;(MY^N8;G%W_ilB!^6g;0;(7(j_>_Jl9IkXKk)P~<{HcsAA z;sPNL@)V#SF&N0XH*%^eJ~|Tm@sUE&ao3@%@Jl+5o$yH*h?TaBbfwdf=b>By$yfK> z&2tB}$6TksgpqlP`-PWm`0;+1;uEOLY5KGIv}?Utd8t?0P-iz7Ibk5FjhUh9OQ>se zENx^0-_;e?UF%>YG_@S|W(+CH>94KKmq||wgOm4%vf3sF@|^c;Jx`yES|G<} zojYQo->Bk)?lCJ9m+KwOP5P{|(vd8vLtO@t2HJ@W4uR6lj`A4*3fqu2gmQL&@4u5& zCN^+o*7q9mHeb|-kIE}gOm7Wx(F1d~sZXlcL;mDQZIr6jFIbRXm@Kk(Cft&wL;p~4WIJRwnrOIecalS$_ZX1{)UW2ymyymGFg(H8 zcSm*D^V;_kMQ<%th$LsgG^J|9()6m`JuiI%wUzchh*f{ zmS#)}falO?&ET8uyAz!VOOth>E`3sG!KQ*e;+pkCehljU+>itlZ!I#bM+S)`wo zgG#_hv5k%2=iLS0bKIWuTtn`I-kIfyj+SOc+{+sBI-g!Dc)=gy1x~w?6ECRn)GRk% zAUI~&ab}aeLfIbWTL3);69I=d}5B7fS1m7Z# z`j8cvsNczojO@(0cSrW-)CQnFlN{L-rC&2o?9-_oKsHZe8&hrW0*3mhvaIwM`jC47 zIr<~d1?-l~=A2xNk$v61JCA#2rlUBs!k^eb*;5>2NG_3VB#&9^QjOP#lQP&G)=+DR zyDv30EI7hFa|FlEi6fZM=G-^}E+hnS1R`sU5To%EA;sa5jd+@#Ay=9T@#?YvJm8s1 z`w-rUQNQae;<3L!dUu9jY%vdgCONhrTkdec_bKj?Jw4?Ohx+y`@ZqLY+m7S#_HLX8 zzS+Jzk8@G&&!B%NW_)7rp8NV)dBHiZ(!>Ks`VnHMigZcgz8%jd@-iK**H?*nU^aHZKSq zATBsSf&Vv&e~eLb!@ooSAoBroz{hVA|1$J_->i@U==0Erim`ydoE?zy-1ZMt!4Ky< z79fe)c);6TA5`#wzc~IC3}W$o@Lv`h0@N=R!DiCL7@2p zm7OaTV}`eK1q*CJzgA%XuCX8Fhy5RA{UGp!G0~V!YsO;y*tgkcc^+H^O6`bnQ?U9-sxhQ|u=y_7c9eHA5C_<+Wx=GILx% zEaKfJ=!?pFt^ikko9B=*KKS}zgw9@7+cS{a#9*1(%W(kEQ>#BI{Qo`se=W?<|K~Vg zkj#MpXFG=w@&9hIZs^8+gy^i`XjNeUp0Ph+^1?p&{~YHE>1uZFPv6g6;g7@pC6Fm* zv@A#~7W;>rce{UhIH2=7hj>=&QaSD)j;olE?JSW9_+uVpzjUAW;N{L=6g9O!8{xtuM@N|6EY4oKYa1XDx!vI+ z#wlwWu*<A&$HfLi~#TZb3?7oUv!<-5cw!{PU9qiwij!z?wJ!z>v^5eP!%LC&-IpZ$Kf)c z)5xRWTjm7CxZz)&6AVRJ&WRJ)Wi%(3A1APVwD%(OnT;=dX4~D(A-?)JL90LOIK@6J z?tb@Sk+PK6+09y*-##oF-Q!Z}W?P4e<`RoJgklciZN~>#Zuh#?ggnO#)A(S9=XEa2 z{ly3A9716O{+c!*zcX3#+?VBupf3~4>kP;HvjJ~wj3C?ojPiDWh5+#}39*Oei+IDg zTJ5Da-}IfdOk&vRCoj8C<7qiuYqB1(wWK?rBszsnjaDBssYTGKSQRU-Rrt6Tn4TG+ zScD%mG)aym4WGCpm7X4dYe+YJyEdTDft~e%!%okStq1`+W7AOEE8rVUw zsVlT66xlS;t;aE7Z#@BxdAa74q*6P-*?Z=J4|O2E0-G1P7dX%EjLGtNKn}q^t_+n~ zbF{TWct>{f(m2Ocp7Ip$1=hX~Yoq+I7UhdIwEl_6ewLJU{XWX?#hHcj8;}y@jmAfA z#noiQ$~N#KUuPNU5Bz0*@N69LJXW4?2nzTWW_s?_dNxK}%nuyq2NX!zbK(+lI^h`xGxO#9)vg2Qn}b$Ht*-z?cDLq4D}t z{9WbVhw>llS zVl0N~=QD0ahy3OH1Q371Uw`b1xPb$5zyakn_P@<%X}9<+v@Q&Es}*t85ALUOy4M%^ zspJRpQ%NT=Z;h+)KM+?9^dX7nTo7hZzr<5+`^2YRn~M?WfDN^3gUwl+Ad~TxGja=T zy)L%&{IG=;*m`+v4R8fF09!}rSr%L{A1;{F946v|@(;uX`QRJt8^4zazSP)-1bx+q zIIE22@J3hG6Ba(}b$yna&sss`v*I7lXT5HWwZ#_rD-V@N;TSCAj+&$ZZI7Y6 zf(zz|tNiA#=*xE@+#jy6PNKag7i#OIhkVA;L4 z-mTz)uge3K{CMES^{jWu14YCGQ{BJTIQw_wsUo->t)-YUab{M`UFGMi%=~;+y-QKg_(6fUZ$c2p8R5+vOu`h-f58o}5E&ooyA!HP{Xtk=JU z@FpaBj4h6v<@yB4T9eyIKQle5c7`$2hCa21a*%GCgeQ{pCLfg`LK(h?zuO)vkF+^5 z{g>5xI;qiwP4}osYqmmyp|Hc98vA>7)c%aH`E43zp+lVru`x^Yi)6AX*QoL;JX|ggTk&#HNmfr}Y?-Zu1GZ zLg(6bZ(9X?KP()O4EFnW>A(94oxar z_5crtR70|IJ5AC-cad=|qHaiFyYShA!8Uw-5ZWL+UuP$P@BVBrmyJAFUJ`2^N5pq! zozxfIb%4h0aim)s^@HYdKY$v7?NF*5i{5k3-m_&gK>R|-WvG|10Dlys_CZ~dP63Nb zyz4jUTivcJgeX^pX%*|Hx<H{17szYJ|#-(%zC{YXYOf@S8Y4kkWX znk^FT`&ohPp)M}258E|;FS8BiNQtj>965n{GS79Z1;XI6Zkr5}pZg0Mqqc*F0rrK7`8apc= z^c+O6?F#zsyCgl`NB5f)zmRS7{n8$NdaV+-l__<1P=2wPINXD5_i&s~%69nJss3`Z zEutT)CH*G$hRD~CJKfUVLc|>G{?fSfLOI0&atfNKyHz%UKM~?Gd-&C23&cVMVJ zKYmY;PRRAZ50<`MhjFNndt_J=cbk8^1nQheX5`M3l| zr;x9`e*VKBx|>c7>IGFy%18ql<>lu?9`GVj^E$WBvWdHq+tW$0Wgd6SuC6Fzihilc~SVYHz?zl{%UgbW6{zyann2uG|!&^%3oY`v%`3sT*`v**{mP!|% zJ2epZ+#2@)iS&Vv_T1|r-VrlQB}QX?v~=s`qivhD=@@*wp>G9xv;i9#h+0YM88;NZ zi{b$5!%!gdP8jn$1 zr4QHLWy`)6mpy}PdIov5Mz3>6vLXNE^(S3_4RnKFs2-0g7xXNXxx@YGyX53?9k+Mw zxq56Tb7!^;SafB}#%Y|n`W&9}r6K3wyHisd*Sk`nCw<}Jd~^_DOp$hZ61Aeka7gF^}^F3%7?kVbr;oH>B&K8`pzd%jES<*nxJ#{3GPu>kZ^F1@i0ZQ}h|d z)^;AuO=kOydct4hw>z+xvM0YM+xl={0zCgi{6~6@UYqYrc9Y$;yL6_E8{u3F#>l|- z@tSJ28=2dBV8$ZKayqME{^jOH9E>%t93r{UDw+$4(Y(pcsW2~s@!j05;?e;0?tMIW z!}%@bw!3yHzdg!Kn{B2me%qnbbMV>_-$fYh-8}^j3g-(`vF*vXo4B9TC3Q-x6!>G( zm9M*xP^;|M!^@zzpM2Id`7A2$SzfPziRREG=wr{1eLSm7ytfpxhm#$&jIt&cEAKP% z{Q9T?c4%OY5#;O%J5Jz_>5dw+Nsp9$97cI#JfDyb=?K`vL|?TpU!>QX9>2eoqRS@P z?w5A$vF|&hy2O2lsn^q`T8CIj&M~jMOrNcu!5yUf4(h&Pnodi1i)A^G9UJT0hUYTR zwO>Z>?WeAfOY@mbdMv68`B7bkcwRO!wqq>!^3=2W>?H2@df$ympL)^V-7VN%5VsN- z9#mcp!&P>sip3tp7e7A7V^%$sPe%LuCoJ?6JaX;BaMK>(m}1f=YajNVC-~$i>XgIp zQ9*rjk!>=#M*+@3)Q>zId(s`SNA#`Lq&?#N;qLY9Q6E4oAccm6>j5v~ud4Hp(xkVR z=+VLN(M2&jfEck*Fz&aK7{%|Ry`Gr{-kwO7Mv^W+~#m+5hMl1&;` zc|Uekw+XD$(KQ(_o(JGMG;(@r9ss$oRA*D-;`G2*OQm)&H<{$^HFKP2=B-P20^Yg_ z-uA%TEBct5_G|*V=botx<1)@cnA7oPzLaHmy4=8cID=do=ZbW7p5k-(g$T9A5`9i5 znFmDYA79uW?+5i!Nt(2w>eDya*Am8@eUb0!F)4D}rs#UOZ|_S*oP(<+ZFCpxZ}ofP znB4=8i=DAQe;eU#3OHW=4Pr=l!!OijMNQP6b*MXEFE{TwL!mxY28M3W0JmNG!{)9J z(wwv`oKJ0X{C0j}j?mx|^@-Eu7+ibou5%d{na9-JVbLvu9pjp%etPcEe7zctOz}PS zi}2k|^99LRJEi#pu8TU(Nq1v&(udcxV=94#%P?O~+@Help06zd`#2BUP3BM4=)B?! z`|EaZqLy%uaxlKp5U-c~+|G0k#zZUy8j*^wH4)I-_>P`3? zUCK$e$GQU79MZ?Wu(C_eX?Sb(^VYoMI-vb&ooX|~-zDcMYNOb9|GeH(X(pC>b2D)l+(C@mw#7wO#N&*^k)8i2YH!m>$|y@7)z9+b(wBd55I|`F^Oc zd4XL}$?s%m>V@4s&gzo4&OE_K6YDLief0fld|)hRb953pU(JXGDRaCx?l&~1lOE<# zO{g_=zs66SM>u|KJk7?v@3NzfD_Qo@aKF8pvj&Gb1m9`Cln*NY4WcY;eGPvbHHD8u zXVBcV7kcoXL^dCJ?`pYxh(D7L|C_i>&?n90Bln#%myh<(zBz#|HGl3 zx6VB}$M_O_aGuXf@wxtY2;q1;+vf(~9?SH(RAi3gXT%QwTWZ038bDw8e6zjZ;vP7g z_JDW$DrxU<)^gr~Z3ORdhSq~r2cdnfV|Chh*0ZFn8|E9*WT}j3-CLL4XBzYR%~J4V zON#7fI0q#fx-rw3$-LNF;C@51NmKFO>Ft%nvOLHA#Ox*cT}{UNz$H z+ojFT-ms9bZczV&KEq3s)>dffuOaU+z1$_3&tB)1>{GC0#=h%WGViLV?`h@YdK$+F z)=9;bK3VpK}YJwM&e7oi*QiSq6iN4P)2 zCJWEpD0{!xe4H%fIB9w~!To)Hz!rNPFN}HcGmvky)T0Qv0h-FsWRG8yvW~vr`4m}K zN%K*tmy}T*`<$h$cr)x8_?{Bh6TFG*sN6VX@Ma_@Pttss@FBI+-fur(llOg~2jo?U zntwPi^6CtHcUGPe-wQ4u8{1@@>3`Tghnz!uUS-ib%Gs|Zl;0iev*Z31?!2yIX1`DS zq}W2Wg>g@X8q%AiS!L!UPp4an(=F1G8vcp+=t3=5d~lkEhe_KP!B` zT5H<8|BXD5>EN`+wYRKSY_3Q1KeP86%b*wZnu_aVob zK}>D;dy&0oKn66_JH_Cew{U(X8a;XdVmf{!c;daMRI9Mfioz|Kp}LUjTaZi7-RB17 zH>~f}DLrb=>D?0WzH3GIXoEO2GiMWtolSbGFy8K3b!k6q%Yz`zG#SZLOaMgd#E44864~0tUzDQ=h9b~-kF|UICIAJ9(%Y3 ze9|k|XbI%UJe&Li`msiiVejkn@xnPG@zbWXHeXTJ^6|-COQmoepuBwLA|Nmecer)WT!msjuvIecID1q6Qc%4!#7Z#W zuW#Q*O?KQLR0eFF<=I|k(CHNjP0Bj+DCirwtyC_TxGKYWgyavvj#z#$s@yeel|i$^ z2TxBN_8)z{Wu;1`HMg%jf3c16*i>3GYjwY-_A0&W*8eKM|N3uj-nl6iOFg-2Fa~29 zH@j(3noK8O1)lqNr{5~hwsLJYx>l_Be~rFc_Mmf5eyFr|QMvtrKc5|8uFHY&M0w@N zR)Mgcy$-Z&HOWyw67S2Tx%)&If~9Dyx6a!9NKhY4=Mym(#HC`bH!JC_xYpO!N5Zj$ zm2Cy z6tG|b#j30+s`HU3BOiHBKK{6%@+1=#1x1qoO5=O0YL0vq(R}SVYXh#PO{d_C;mG9o znFa=fVFS{O@8C%x%8^4~XDU@7ZtvFf`ChXf;(jyNHIeAcf+eb-uN^6NleON$fU7SB zI<959{I3Eb=$Zm2EgUs2sn43B5Vj?LDKrg1k?retrSAxi+*ogHxo-%%ezhw*a9b>N@+)-)6vM{vFr+Ccdgj1PAcD&Ag*F-*~Agj^tXS8* zvDe^%3Ci3Nwx&PI){(f6#0?50PJEoso-D$XY{Im(wM95!Q}?2uq=C>=BhA2Qz)x-S*`jsNRPA;4ZVN0Z?YJ_}^0S%54J4uh?r z#R#GbrsBX;>+(vr1f94OwlLCP8_klDf<16!Iq-jL{iq>V1PIBJ9YI^+A17LlW7@Ly zsEKg%5h^l>b+y`nHSaw_Ji60(bGC3RA-J%*3S;10;{>_JjpBSAP1hTc&)P6hKrW!S zvJQXCAOCALx6My6&<3D00PxQGBS_$XZCSi>ebAL5Ty5+G*aEv|ATZx)tEFAI^@Z^u z%Mu0wL}DJ>@DCc-S=S`Z=xH%1?n<1aEAgTe#N!JBQB-4bPmoPsXslTL3k?$`<6Vj) zjgFQT_ruYUF5K4QP(`FmXa>3+^9~`kq&+-$$m~So2(|_IS6j3+)A^`^ZLO{Sm9qZt zx77cnVT%Ecq8-}4^Kl6V^D{t}`zX?4q(2u&fhNOI#!CSQ75M52KY_npId8XqIx>fl zo|~efS!X5!`dmM$s38jyrksK5Pp%+5A`bYea7uGn^p*RhQ$kIfG6X;A^EJ|N`!SnH z&rJ|Nz{M0abtdH`bq)VP?0rwXCCGQzMbiDlr}D)$o1?3zoN)`TEWwy7-BS-Db9Hqs+V*uH<=9tc*|~y03w~vVu)KEvwq*TF!4fui2+WpSfhGW!ogN*ly?;FuonRpz5JJTHv~ikcJ3P=AHlN#?yjp2?s!cpU z32ms;bvZ#p`;~^j6H)}w-dLu(Pg0PcP(1;t&k4X{1b_q0(a%BKGYi%oHX_438h#z& z(GlS>8yku*+dkK1pIM02wE+*6Q0p&u-LI%rDq0a%q1bh- zWORH5_vj8BQRJ|Hrd|9j;gut@yI0q%pAcBwVIy*TN4TzE&|9tH!D+)mWnXikD}8HI_XqCOSGv{+WWQ zKTnMT4@@<;3qt+rP3Ym-d$+uAO4$<)8PE8Z_6&d44Qp`<3D0l3o!>zV6`bF91cqCR z^)sH$r9bInN`s3%mc0o=ulq=bx{t?+j8bxXCEw3v=@Z;cU(f|>e=lg#(aWeM z3>AhcuWZ*bUAxz4vQ6M+ui>@*>D6FrHLvGcx*WxdB|V1Oj^NaVsjml|wGd2O{uuo7 z$!*B|fxP*$s#}`mHQ*|`I@M(zv*?_TPT zi~^1g-*jZ-II$lTQw5Y1A9LO`Ea3LylN!A5bkbV#S6zMnRAJ$J| z&OWNGC~+yB>A~6&bixjtr0F_IkHPP1)Unnp<@QgC3K#*od&kb@2>s+S*NW#%XU-$$ zN3(Dx^E-vMjwxeiy;9g6#xmKCM7ZNwA~=0sWXlh1`3nqwN~lW_!%IZG)YIW;7BlZM zns*H<{9_#a?h|f%vZ$FjpMSwU1IV6<^#dV$+@F7EOiD$hw_;!=dqFt9EnZW_Yn-M! z%OU)Lk58x>P2eanY?MPlzOBLq8*o%a?!4I%{O7o^XC)Z5)p_ubAi)D!m(9=G?dNOl z7Hi=*u1yfpL#nWnR9R2vrg@CzF4YSE{7IE=u1fE)BFlZ|*@*aM06`UQIay+NzXuwy z3$wNzK>>~1s%DyS^&0~66%8D5%A8LQ8|Ul({kyBuhv!p0ee} z-nIU=Z6xu}IpF?>wF^PAau?5v2T$-yB8Obw;ryPDmYPOx-G6}d1`=>&5ZI>CgYH=7!I zN4HfOdP`=o((oTyVv1q#Ej2U&HJIi%rV6M|T~!3a#x`NJ6_E(r(~M^+5e_mH;V2>y zhN(GrQv$(ss*KHWQB4=zT}&5zL-QLOdsFvR8F~+yF7Oo51<2SesP74(B8L5Fx6;M?oi-z5xF0j?H4U}SY9VEp{ zh=k2FgFQ!)VAzy|B9TU^B;3Z#hOJXe8IiyhY@|DhHd>zM8qYA=NG)80Z|x-1>}ZbL z+~BK|i>Byei&UB5B5Tx(P$#%Z9dt6GN_^4w8=N#Uohp;2rf%!#{Fod^Q7GG#$V#49 z$z4W%ByYkr%E(DH>L7_U(49md8Dm9#WK-&bDI*ykXbT>ZPvP)d#QWqT)yQkv&ZBHA zgF_^|oz%2g4N8Qm(2UZ5KDy#5!;;c?G$;@1_?JwE`OZF(Q}Ini$xt>r!ZG}k@TVGn z+ir05sXE$#;i_(AyD4w9G_NsVLZ!SkW7vENrb@WcGBn3}mNH=?i$F_)l@JNT)6DM- zL*28=YIf<-^4FScu#(A|o~g~O`L2^CS>`@9TzG5s7GzZi9_k==pWF@O=s3v3Z?aA1 zt1ybn=0B3;$D0GFw!CZdBJ=CIrib^5d`0qpH0X%5>@Qlp@0ts}zHbThUb{^O{92Hr zw_eyQTDb;EG#bRRAu2FLbob{D#$9n+{`7T}$u6g$rHcNk9qH5(n8L#BRRTQ{DQUMC zA2@DFy~UMevmCFzgzT|3Wa}*=tGi;XBKc0Py)LC8nF>OU`%Knw&#l~k{JN8({jBV* zn2Jm`g6tlS7mqz=JuCCcWCFMC=yd%=?&daWI>HiRl3^u!(IV6(Ji~;FU9|)!k>u%?vvl*K&vOryB1>L(|i3Gl@zljNnmKC zcpcieCdJ1C@KFPJyK~W%lTPwUWW%IfyIxCV*H7$jL1MvmeQTO71tUUz#tIO^C!3)X zVsl9lOf*8g4((f3#pk0q48kGE@aKL4o)-tt(IV6v0cn~o+O&= zLwvFzx>dlk3RJ#$EK)h;+$MefYqv^TEpe*|`~G0v8vRqzMMuxiE?2g_Iu|?w59l)G zARy)bL}zk;61l}uAuaW~VKvg{ahoyAIX)l>T5cL_JS#%PvR!QLi=reLo40i@lu9g< zJ~oe{DmpDU&no77ah}x)(v}V8o4VV4kFK@sw5?M*YoHgBQrk)a&Isqq=2vsb+e5}oq84-4&U4EDic~+d*GO!x3nEW75XnV- zg{f0+m}k&Kl}8Uy_y&OUcoovl!BU5p^}u2}nq@VI6;nBb!!TfF)&4}gCU2>+-eq5q z_hAGR8t}c;C3lROIy|k18D>$9(xyOT>C9FQG$sbnn974jE(GRT9`O~MtSCe27%z3$ zS<}XNn(sGgV^l+ng#j&=@@TQpnV32}-KB{EAI4A(G&Tm%*vf;(#$;mZu(PI#u{GM5 z8{;fAv{nHw4hFb5%EJXHyy%NaJuWU`r4BD^V#U{JW8pEXV2s(tfE8DHtN?`<$tdsN zh)lgO{Ssd4@Uvz-nR=SH&R$IG7EdS#7!LzrJmmr7VVaB8VP{SI;%Zi7_66o*Of|Up z7~tY74;LR3T~;xQnaO29xqh=Y`-M&R75#fm(EGTa(n50$Fv%pjydIe zF0}xIBfpOz!B6o3W_u}q%W2YoVG8;$6h)Gss-NYTB)${3ql~-`V;%<~SC6C1(Ai$5 z-*FAiZ_w5#m*}S`GW}HjRKFwP_Uvr%1a6{FbxuGZ#pz7BMND|L(Zmqj`>}P89y%&vai@IfF9h0 z=X<`^dd11!JN7>HOwFpb_s&L5Evt{Uw%NjU@3Q$L z>7~iwaQz;J#Wi_SG5R&nOH{2``0jBvhSX$mleFb zHam}ydzoxP>=R9sR@1)Jo$(_;J_)YLJJ6V_GW_Ex9VXd)kIqkUTm8>GjEa`f>yuuy zGTi{{-&pQ>m#CsrP?>`SR+~_(5U%JPt~5Nrq9w4l1t(@Zn%!7FdY5nl7v0hs5;Sc< ztU_R7SiuB@Z{0x2&UKAt+;#~lvo)zNQFC}_0kr|K3IWQ*3Mlgl044Wab{lKdwM#@< zt!c5NngcuwsZFR=2vgP!rY=wMK+1Y5Ps%Y3&3YD=$}S|;M}n(Os8tA8cF_(m<#`g5 zw@EG{JkYXbbg+9RYxuY2PBHJ9xKmE+h@px3Z9uF-h;r~E%6S4r`OgGVZsGG=NFcQd zwF+U%#p+SHPZ6TVa1g91elUDKjT^0DZh|XEP=mG zs8tA4K2}WmPZ9Yu?FRc>>@?SFw5B_qsX4-P$=*%KRR~qozzQpBY&YL4r+$88>nL{$ zDcYLuR;%Xd&OvGua#ey9-Ugk+QkZe5z4X$s*;+HCRfOPxxTSfiihn8g@of!sm*W$0v~4GoDMm^6IyL z=G)b8TzdSW*9!vyk~sprZn*%N$({+!m|0zP9OwNcz9YxvxYHF8@AK}~b^a>(SXo8; zW^_kBhfx&r0eKT8-LQu0e{$+C!#omW%4IGf?Dfd!Bn?ECi?rOO{cdZf%P<;@TsS(N z>q(=okjSmPIjFG{9(Q@lamWV{eUZyG5f>tsf41c&G%FJG?Z4F(2?nY$z7kPFK8}XN z1pZ=>2{x9APhyyg3~tWz@Y~j8qgj2y7TWZliZ}*ceNN6{9^b!HL@-Q@y25-KUD3Ea zEKD=hln4v$6vLWMF;GZ^sk`bc2)lLkDh=Tgr(ytZNR7$b4kf|HY&cMeh0{9v11^m# zs!&LU^M9$>vQ)@jQUyHWWR#}x2ZKjX&PcNBObvMahs2;EvBsp zCloHd+#x6ZRP=snedXVH7Np@YKe!3wZgQhZ7>WP<_vNHA_j#!2K65Ud)dF{29F@9aN&SclzPv^6!slq@NEWNr(JPA}+Zp z;yHeRU`#|mN_c({i5_qxzvOA z;kZ=0tFLSwjgu6wQ@I0AM&9t~TNpp6HSfD&NyV5w1D;-maZw&+16O2ND@Z}7r*|aj zfdmSe><

d?R?2_vNv3xFHYvqfF%aa?R2l1-$Gex`K!S7!6=GACnP!Jg3qVoEB|XmE_j^Dua~LljDo(% z$@v9*|4XD@9&`91gA+hZ(y;eai&Wt3=lL)@(Dj>}8|^Adt|FlY$v_|QVWtnI_0uO@ z`8nzRTv#yuSBq(;?Hi`S_S-Ji42OD#&GxCM8Qwp7m*@PKJ##?!?990Jd||qV-!W;& z_Bxh*VBB{6fLq)afngZEjtKUwfeq(ddvtQX=L+9)I|g;(d<*}CMGd+{}-kvvL zduF$!!uBnH&+3+RFzPcOblHbkkmIc18Ku&jFUc`R|VrzH8Yl-$Mc+PYwXnzXCk8Op2B^ z;MxeRz>0&VB^cgoT`R<`G_j>xTU%wplq43xz4MNTuL6E@XL8y6Uz9MCPz)TsV7n;y~zVXS@4igx?O zT}zL4?(uKleRy^6^K}q-k!SiSyXj_a_Jz_fOg^FbzUuCWdgZ*mn7H{brl@*R{5u2! RyLYoE{|_|bo+iNw0|3CfWJv%3 literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/fixtures/2007e_summ.html.gz b/lobbying-scraper/tests/fixtures/2007e_summ.html.gz new file mode 100644 index 0000000000000000000000000000000000000000..58d40abbe322c67fb869aeb1610dd6a51fc2ebb3 GIT binary patch literal 14101 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

R zc;f6(Nz=N0+TgNC{t887}_MEcSe>?gIt$rV_JKuBg_n>il*tn*l8cY9W+q&_w>FK}xp8C%3 ztNVOkePK&++wjrs?U{*4M*()2(Zlty8x8 zKFieCIpz0W&u_O8HHi}8u-}BtsM(kccML|02g4#0IjrwTah53TVD6#o#Pu!P=sG>J zX4M3<3Z|^ra$TcJFC)e;YfLa()U{(VP&;V{0?{S#VD$E^I$t`F;fj===TTWK!|(R# zx-*ulE;hmEH8LOu2n-wv9zsa6&r<;}F3WLW5}p_#aJR$GZNIm}jx5W!ci4yju?*8H zxo11<5}u#UKWbFY$3V}=JT~9*2*o5yRWoUE)y&3ZwbxYmK4pcsVWExTwJqj(_50xM z_I>c(O#{OQ%QI{R1ww4&b=kRykfgS7i|O@Eb&1*Y?CzosXuDPuWv!XCXlrI;-r84@ z<)L7|V-kGEzJj|lWXK%{wqf;9J^lgDC^CnMSC+F^WM~QD?ldMtSZg<7({fmzCCrX)ANn4PuG3+7HqQAcZ(5 zpUc!dJ3a5PeSAIa(7tEFFU2}si5PiWHC$vRV4P&#A0D0%4I0CA()%X zF}VDifZXp*5>9K=Lg5OIlzIpdWONJ9lGhk9yz6$mc<*JAMy0h}V%!hJC=R90=vOa= zXH4d$>B}Zbu(NGWT#B#Yju=zkq5+Hwex&q88ub}c?m$mA2(rT%zn1-$vcO@{T zbFc$$&g1MuF(`uhM7s`>g>xAcFgc-eodz*DKC{bIiXOTHaVRE^iHL4x8b{@UXDR_e zloPMI2Fi!tQ?iT08Pqw zyOv4TfcR7P@g#+I&M}vh6Ra{3zyhC-x06)ff^F!O#oN;OMx^TC8+`RLg5YPQUv~yi z1np_NRug45V!tVAbz^QLYBehLnZScGSJb+EhQjtbuHz7P)h%N&EnZxK%H^3(5K!rm zj6>wUrPqI@iDfF?c&B=0e=A(ouqF;s8XxwXkjbzb)A;@-;!sZL&`ej>(91ph`D*)S zo3jfr8zR~&i*A$`s>JEY}p+bRw9S&{)c6~d;e+4 zpHD#TM)2rD)q4g3UL^eK#eS&ygrKHv_ueg{q(6%m>Cb9R`uiLYBlO;XMywj00#4qb^l>=@&U1WBz&JiP=x#*cL^_BhL=I^S!adJ0Bh)t1(TW+wBD ziF=u;{yk)*VGZ}TTL+@_Gwe5|b-XeC46H$ri?m$FKl0I~I)`mdywQ$pJ6(rt;W}%P ze71~ZX^VgxzJs|^z2)w57H{DWF;H+SyYMF(Kkq!eq_=7(7IMG1(40ZZi9?VF`%R%q&_oGpjMp>@3cN0?EK6BqGfb zAREEG>pQW5w2R0(z-zhAcH=eqQk zWxHijD{oTdN*A@V`(+WVep%$o*MIwlSC)fP1+AR2c$85VnX<|vQV!PMQq`o4vZ_>B zeah2Ss?1*bcTab#@3g$Sltq-uhW(~<&Z6~ZqkiVT;=l` zU3((^TFYE>(`|_N6&$By*?REQJlXL2)2i4D=RR5R9j;d$u@iXF=&qc4f za);&OKA(IrnTJ)KU)`~1^y@cSSCbiSn~?9qGjVO|3%Yrz8-+~9edw&4&1-!iB`=?$0CBD2IW6DtkQA&gR&IE4s-~!R`#uGdr48h$3 z+{Fg>?M|G|;nRa$!`e2?ZObstspI=m#ObwQzp>q%M?8yfUp#235)V|G=^Iq>p@De& z2n$*Xwfm;dqGZQB4cIA!CnAVj5Z|sE%7x5BF&W0W;@IeFl^tdxavzRi@?e&KWP2&d zS{y!oERCWIh_Kd)v>Ns{NDv9}F)PLAEWQMT$qvL9K|_4ZNnzCZik*oh6`4+4yhXgk z^g)Eqi>s?Rym=`Bveqs@HVpx?Dh22>e3h{aIg(*MCLuxALjyFiI6q=3)0Y&T_1hkY zhUnOpq60$1j*B$qG~@;b@kL@ndc?t}`51$z89{VFMOI9ghO9W%>y!+JSl8n?#;SZ2 z#Kn1NW`2*ch@Ik-5HmE+w&Bqb9=B3>_EJ7zpJOcbNz{NRM(S0WF$q0~1 z#7p)n1!$M2aRhHY7>43b=6{e7Bd<=3Y_O#->?p5ahKM-Iz3M<+-smJ25r#BEtzK=Y z1yTE9M#=;cahCg);`1BNhjME-iUiDsj6jTJL_&)CwNm80e89eDL2|bZpN1g$)d71v zR3Lj4V}T|L5(MKYi}vixe3qKLn{R#L_~K~*JsugL*{nvIzsleSUVa#Y^&ufQ>JZqK zrpF;?c|0;Pyjcx4UknA#0VU8!9m%*5#?Nn6@HEQwt|1i(vJ4^;w176_E<9%kViX6M z0~Ro?)+7XItpj;&=^+w`Od*2oz zsz#;h`O~$)^d|VzEtQ{YP@1AQ?aeJ{`3AVtLObJOofk;y~*h z#%s%sMM7?>G3fJL+zLv8JC5Tu%*~5~hbWLbbRvf`+uX(8~#5WeU|UJK~rU&=&cr z2A#>}d*L`9<5;vn^ZOI@EYR|XS4-um8fzxF zV~QhrMgHOXu|u1J{MgkDXlnd1d#TpO#_-2{5@J*hK@$Xm?Ao#$-vqmoZIzm*9 zOOu0y>?K1AD`LTn70LSbgF@Cav{F6TqT+w>tnf6P%A~I z8lz`M6s`2L|o+1(Y zE61Z_iNs)TeVq;q7O&aSVKkiSWmteN{uy^bToumk?;Wr!?D38}O|apH%=ftz(+&NzN3{X{IAW-YTMV#Ev;`WY7rP zz1kxR5lVbv8?^QkWmF<~uNr;+n~Vaugq?~37$O=nR9l-vg=H^}AFf}FdPKyi8i(HJ zX&AFTp2;T6;nx(RdJuZ9ZXy*4GKp-YdesOtz2oA&+G5c!UMlg=D?rs)^e#`)8G?{3 z6n8TJgN6*%R_H)~=* zL?ovgq9%7zs#gn5e}|J&*Ph#Bctj+q8kznquCCZQkAk5f;t16rQ|OXgzPxRd2qnm? zMyF|>mg?1m)D%xkB_c-u-`&;rwrvC9&l#})Kzm!ep_TRONV4OsY10)M(xzzA2K^LJ z5^XEd8$>#e`|EcUWyiK;H6514G?2ieM3KC^hj+&lU+nq_wQPG!*^Lou`SzBQ20r!i zY1xk3wVQ*}G9I_PzCFj*B4}r}=&*Nfiw;c^1l5P8Wm~CgHwUI=Td67$epVvW{LEu4 z=i$x&Eg?^>eI$uU+w~D?>GpTwbnL{wWb50qZY^*&OqG^wcPYEFFZ8aS-m|qpst-p? zxFM_E7?9qP4Ozi5WMk;$fTS?GC1H-Y1xFjEOUt&%kkfIV5qv{(jw3cE!u64Kv7xTX zf*-ei_#P<1{usE;80B4f;zgkk)d~}F4=*Wz^e6;9_0;LEBye)-Bh&9l%DvH#gppj9 z{mY!j=(H>0(s`@$sdamCR3D<2Y#E2se6*pA%Q&oxhrPWRGIq?gJq|%nJ@d?x1y1!5 z>tmdRBtn;ALZfsl2aXzp*4(nmwKAwW>fc@v)laCFaMhp$mJc7!js&co%Jv=-2CAzIf3_4f_4B6XTlT{V*@+MK>pstR;>N8HM@#7P zxRt%6C7-8gN`apZVQ9&wd$^UIq<3|?$Ckoq!%iOZInHk5ULMj+_NY`iht#vgqgj8! z=*A?XY!;D0dkEZ8ri2&O^MK3!_Tfd!aD@CNHqw7Z>j7nXnv4#A)ytH^YPTYfQA}tZs%*atL0Sdzt02L!m5>=o`wM% z_YgQUzqOH1q6qNigAyLJHIdG65X{qFngigA%X#^LgtDZu5ErtXjP(&CcT6ed(nEZU zCXz1;rrP5UFdFA%IA~wvTTJ~t%vf(4CP6yw@V-TU|D)fYWA1e{A*W$-LqP@bXNZkM ziZVPR2P!^nrv5wNsOS0`_xJYpmgT>iW0>Y~36<9I*_(^6AK#)eizD6+{)-~axk-{0 zegH5Q*pE`odJ!1{7yXFf9C`p7_mPkk7gQgWyv7rj_K}DEn^6v4Z=m>Tl;*u(hQndM zQhdq0VVZ(46iPCjW0vOaRV1vGZ)w@x=JMBJzg`n1z9MR?>y!04l>}6x!nktW)RBcQ zu79(Aco{}fh~vWS`hbdeIJym!Mzy)AK+%dhdtw+%go(n^tk(sufb}PS4vIdX%_moJ zbCf1if+O%C;oi!3#pV`39|N^dYZ?)QB>`6Bc{9M1AWA77yF6AT2T2e2Ly4Az{6cX6Twz=$_4Q9b`*V{9j}yM8-(e(-lY4 z6w@`7eT|QLR@2{W_)}v~(7`(bOMB3#UqSciP!6q5j5`ys0yQ^{Xr1wBa=@1DoOs3D2Xj+3dE&a{1yA&> z0$}Bx!qe+1y3oXc(6Vh4iWQprA&wLP>kV29LLPh-fIWxA&9Ih7&hLqfHnr2~#O zj2QVP!b!m6*+Ezi8M#>~h?pDi@<&p7SEQyCd14rD2@V`BKNQp1_`@Y8Y&L&Q_bTa@ zqM#3N-yWmC&OV{jvo}Yl=)=($q$qsUBSv$G=KeiV&`|#-!))B~z?{JN8)try6n%7Y zL$x|)M^~@u{jE+MCY@`_#~z|oF``|m{@v->>y7oR0C>WvI-%2mD#n$rUm3iHB3)Pd zfm#mU_7=nZz58CZSNzRuV6%+y-gL**`%!GWtoZ6A@xe`=MEL3xq3I;|$)D$!f1i9k zy*wJ&x*M2QVCud@OuSF_L6d;P+8x?NGmQZ#0N4Ma`7EIW^BOhl4RqyU$F~B@ zb+E1L=WlDM)(?W=p01BZqxz^_cfFo|b)nzTzM8bLxYPorW!((S+7TO^jd?S$9se++ zr{?bNF7Kd*j%aOy&7*_gGz}dLNPrP-p^IIuc4sUgF40^$UR zwO8kd#Oy(deso}4&R5j;NcXU&8@{jm!L3d3aOl_Ju7*5fAJ$lz-zOxfq2P8%4r>9q z33OJ04huC5j}Rxb!@wOn__|tFoZ z(SgqI=IEp6x;>kG#xNtdfn_B6(KJ3oK|lpO0Mqc>N8*@P_fraL-eKSM0wWBN1xyk3VGVGP_<9##)8hKj>B-^P z6a7Zx)yFWabilq(0$&gPk?Cu#&&}rN7K4fx0843Ii}HFA8f6Vc`!?Kb;@z|F%t=j+ z(Yf#3qO*5zuby0?x98_)h?R4>6}-urPz(#a_~lzjyxaP~awc(eb_=atZ`Yf3-?j$x zH14==;DbsUrW+v@2?qU(cNggQ*Y8e_U!%9je+p!>I*#$e7kO_vR!|7Bt$HKg<{+>F zn?TcFUb~&nt>p*keb})r16>mA8GYze=T+3nrIUI|r|^*y{`W!D$`#Qdq|<4pnYNl(3w7mi;ipF9w9y=V0U0z*T^ytYi<}2k6Maf zeuLm{>PR>Jajk2rfE4nt>XrPJJ@SChBv=igCQsd z>;(JYAN?BI_0Y!}XztIShaQMO@FFe1hT(c97_HP}t!KL(Y{zSfLS$R(XaSwV|93Xb zy2cRID24YN*CG4xz#&?nSiOF**Q{@l0Y!>Zmw0QmGk&RQFdLvJi7EPQ*2fR)S@qOH z1-1#@-2o0g%hA9F?zJ|PG_LbX6yfpQ+>I9V#`PMbLKEF}p?9r|2bO)iSG#mW&mia$+z<5LbI}LVsjZ_#={h>aw$<@q-p(x3 z4c5^W?z;oLjxJna8hC!?kxppzNr2v5t|K4XX+H6+ZX8DykXA83#P|_Bc>!T07NkOP z4q6@{9SqXf0Vt?R;lf85RwWvnK)eQhGrE1yWZYfqtVz$oNIP=fX@V*3V>h$w66+KeTT~rXrZXz=t6Y87P0<-^!O7b z+21DJfblT;o*&j2=fnV4go<@45TOFYrq#FpCVS0|1eqTFYFlId;)k69aYD@s1URWu z35H3A*bAUI04K&6qB}tpw6#g4l3GUn`QsJ*J=cFi{?NZgK#tJA-<+SlIz~^yr_#7E zw6=GjAynol&vo>Z=nwr{ZOFMRBL4n2TNtT4ihxOnH_z@K{n`n^?l^H1{rR&}%9Jy; zg=;3PAB3|-4J7i1*ooU2#B72n@tCS+C5ma-jP8s2MDv*bV%QDcVQ7Q1@WUdg*wr5w zNr#M906Qw6#qje8t-2B@7DsZ(LJF9MYJYG{p^IzFAU`;kHo=|)%j%WDvM7?c1M9_= zz>pzH*JsjKSY@B*C*%+Nd#DA~&hGZl1(p2$WS58kB^Oj;J%w!>VaJTEtAJPOx=LtP zW+DvNmjBAQmIyxcC|k_M5%J`<5*g%%qQxwQh+gs{-?c3hHHSB7t=k<(I_DX$B?sJW zBnK36@0^`Rc3t#`7zQzLQ4-#{JCC468|}x5$gXlJ`$(0byJYyXgN?5}&kY?@V`DBmnW!m`9+s#@PjtJ&0i*IfWAO zT_w+u3Z1fa42N`AG-z#RGE!_}=#22Wk$g10>l4YOjmJC&o0*0|>4Xvu?V=<8zz97L z)}MQOxEl~}9Tn*#a=!NZG*2x0LU+on^4K-o?*U6*7%&mOr*urjHB=_in(@pL5&`I~ zRz@Nq*^x{hq`+BgG+NCKEIhD`hF#YP{b}v^ZW-Ek&b+{#Y57AN-|ls6*Z7)_=f|@V zJfA01TpMFnV$8dh%BtnbEyRRyGeyREGAapNGV&B0&T*oGBN0nbl0l3L?Y7J;B=UHP z!9;(}oml3h)lQNmo`j=o0u}#eJfWoalz5U>)8ovJg827hIi4w#G8v{Mc6ZZi7J`bA zYjUql3`)){rN-cfoMi<0x=-rj)=t8Lq;w6?&USIIM`sFViJCES9aAx?;Eg9WrnFg| z?-CA1mN-9tPrwMKOKRzs(%S?%-xyn=l*UD($HZJ@HMgw)E7AiPABIx z6lk;A-ri~`&4nSPbWz-s#zxE7Xht4J={V(qjOn0h@rP*xq->hpbi(*+dp5%<$=%IX zQkKhtN*KrtgDouGf`(=0HSef0E>gzmBC!ykjjhbtkoG0b?Ii-Tgb9!%&oKu|c&ZEt z6xE+G5uEP3Lf@7=-V*4ojy@OPmq~J(ipfwx=@RLswHLzm6pSTI0ULHcepgq7Wq=@Z zMHzFzDV|)hN=_n{ptK5tBIGcNA9N zS_IwYuuGtMG;{&CraTQJV|0`0zOx9r%VC#5_h{&)nN^l&6wAEr^xC+zA(lW~KJL8g zJAb;iz?w}AO+%!JMJ)V2Hr){mpVB`KwsPb#n5>`%Xrm=4z@Qk1tMNqLbqbG_g|V@3}4}&u6c(pgWE{8(#)-I&RRHdaad= z;l=2owKBpj%~&o6n^x%WWe1ZuxAB^4oF3RLE^}Si8wiLsdYuWjxXA)A0~iqzA<(sWBE_-4LC#llU zN(@lI;kSdME|Sr*toh?*G5{A3k~bd50T5BOiFi)Ia;KS_PR z&&-Es&rc!NN86i^(S$KYGt2oxjDVOLP5pr!DzDf*2bm0>`ox9`&yq>s^s-~zt>yRu zwr%aU|3)+a^LE#|9(-$^+`er!|8gX_9`OMcc}HJ+W6aEQ-@GqQT}sByS$4=P$jmArG6$;@I7q!oF;41% zI$Ni<>l5?_s??6?-v>G$MzSdfL)_5Ud)3D8Ma~$?tsY~DT7st~LuYYwij~v93@H)Y zt5EzltN+BKDZ@-4FYCi#1d88gj~0KFCNduYn8X_N`0)i)Jp63=$UN79?ogw{(X&B( zosT!_ThPY8?$waz+Ux)kxCGXh!=CVA5vzWbnBR%i2<;RlSX7T6=(d%ECGs)#qPZFjX*qDBOf9;2 zP81>4EN0x8z4B^}nf*!GDirA{pc2%X)SIom@FhwkIThT^0DCfd^j<@@|l~c zdX~KxktC!>j8XEb$}qCh6rXp(Y{@C;xHnSvnb5bzA1eIt!|hxeKMN~%Jdo#(ki3|~ z{!OD4s4gV_jT_s{q(o9wl#PM&0>XgF@D|kgUwXEbkYqwZWyK9AfXgMh0K5$545g}W z9ZkcmD%B&f=3`4eNe18jd7&p31!MHU130=MJwOw@*}z4A!a6>(D07*RWuOM^XZbXF zq{EZYvjU5#m-T)yn2Pxe%b^P)kl6PgAkHLl6|sl49R2gvGIjW4nKv^rKQ}|3cLUrn zh|k{a^j8=4!1|jwn&r@dHjg`r9SW2XYd!Z`v&l8F{i!s0&8pC~`XwC-{Z2zj4o!Hj zDq(sN20C4=f%*;koNI2k3)Jy)iHM2d;knJiYUmwp2of`aBn8yA9@_Jo9p>wnZ>lC) zs#XQfQ6ZQZT=(Ka2AA~VgxvXBFSJZ@AJG+E%;d&XQ62qGt5bu;MfFnbM_N@u?b8q~ zzGWJ0CJ|op%IMWt-K{F#*980y?63=(`{8zICIuAC5nQ1^MK`NT29~2R0zGg?jwWtq z%L1>5FaoK#ML>otXpUZDdy;ZqG96%bJxmdT7LG_qKZSq!A+E}09s9$ZsYKxQM8Mq} z(u@E>XE?we?3d)o{*WfET}6|2yd0Z0_gaINYJE5Ki57sy$|#vByxeTPq%A;fp+z-C zb~+*0W(Rh4?FKX_sW{-Y2>eTJWCeZAw0zvL?0k!|KUqUW8=^C%;VM#yIpNe*Vg7eG zpcJvOLld}p^gC-&uAP4X-84`AymcA2>}u)xm)xHB!-S!eacE_mZsAz;nc7D=Vd!9# zO7Bml-NaDzb}|&L?Duasi-x5YswshKg${|BwDKg9$(0E*)47-@$h@r3amsm7x2G!@ zsGD6H3HI1rPBeL@vs1_cV}RX%{hm08U~a1hZFFp!uwL`23h07;a{>#4nZDJAp4;>A zV5W6D=Iz02kF}?PSlYe{#y&->0raHN^@ep#{Q0RS8b%j0X%yQsgpNhCDv)LYQQACl zAJr9-F`tzrhdUTpe(E}hOBmIy0@_SK2Ed--pb!b<_Bf6AkyVz9B+)jzH>^#PG(XxB zUVRa(g3I`g)mX(FB3zWZ$-#2t%2g1<;>-5vN(1L!sdwt z;tcu*{WCiV9}R)VTDb}onHOPOd`T<1n2GvpQLz#XFfY3Nl~Z|GL*jNO>f&o-7rgpP zL}PfPd)k>QhKn~>!_EMQ`M_U2n(z;eCN&bB#4{F{fTgU5CmdAFL| z1sA?5(PMO_~>wcvMasFKZQOogF&g{vFtX~C+ z{2)oB!UidC?Fyt3mYzY#ZB3W5k)0kLRycF;mVN+-9#DRMU266KM2pCmF0!%$JIMnL z+gqh=S*HY1k^%`76Nv%#l$&h+disN?IZ0MJVXOThzsCs-;mZtRQ{^q4=^e*;zU7~Vl-fV zBy$IGy3bxuuvE(hK!W`WIgmq{L8ANEicyDmVL9JIYYs}hlJ!?&1;5Ds6ifGoaz~4o z;tPqmP+@oILbfl*4eElEfB%>HGCd=CZcn?Ymn1`IV@F9KpKy?pv9r0{B8C_>;kg_c zMy>^TQRR6?#hsV39HL~uxt$^@8b!^=Vtu3SNg`VmUIz31O`f2dM(q~MU*iZ+^+cft z`viN!B!VcKR?iBs9qk}Uise+>cg7oMZ6wIMFn$2a#5Y;wCQiZq7i%yq4C%~rEtw*F zgB{!>gVJ6IyFcYh&3=H<8tHgAB-o~#d9h{^$HMlUNfC6+dMJy#3iwyNS%GByg8Z_| z_*%I$Cd)ZMK}mWPKSd$dNl9K8D2sCTuBJS%!rqojEcGM>HF1h%aVa(r zKb^1S!O0c%z;==wbonWw{H(U+x*FqcFF?nfHuMzRz@6CpKsx$+@B)1O4QP=52SUEe zN3-8nlUrxd8IXv&G)T6sibKKZqwds{TQnJ|O7zCWkp*!@c8_hKC{w>xftusZNE2z; zthbBMknUBQi+=G9#hF`}X3%j7PTX8gmY{!&zlpzK1$U!>gy`?>U zYZE#XV5RmrRbBC*d3DcXvjDldb-_!{+&RjnEIH+8j9^t!bisKUby3b@)3wMxs(pXJ>cm4vl(_k)l}2 zTQOC1$6%R6R9>u6816@V*RUjNu>&?Vv57i{VhLx z6liHOaIC*er;$U>@GT7por7ud9Bk(&8MH;v7+o^h{;nR;TpaZMh3GN$I9oYrMpLZWponv7kPBu;q+c8!k=-g3})&FLqnj*nh@!NIMRD&r~b zg-~!I`E;H@M;Ij%>u0R_@)^8@De1YcsR2n@glWDB$vj1nG9Wd?r^E}aE{!h{U%h!p zS8gxB#>`eLY8TYZ{0^YfQ$`u6mEvo$hlsm1LmNBJ+{Db0Ur+|oGe^v|=T^2t??tPU zHX+|HzE`n`U81ZK0le)>2k_+guxo|mcdw%!N{Zi+YvPo*Tcl9HPEth)*hw@K0Xtc| zq5(Tb>z_M9*vH=_A6GLz*K8~=KzIK@n+bDz>xSA_#~sCPX4<|p;J?4z5dAMy{#T{E z2cG@ERT!tpx#iIo0_9TkzmmY{=R88?cJjv&t3W2YSsD}9c6;|A6?LTWxFbCvfGkyD zK}e6jo8#nj1)TABJJ=cMSG-S|RK4U~m-VvO!|lRl?e3!itGXYf**IBpl7ca(qSt<= zASRq<*Q)YycB^7W=l>`X`_{}NzfAOyyFse9xU9r#a;MU(N!)S6p!ibqm^Md$l(rRw z#cs-3O70Y0N-~lt>qv=XVjU@qS92Z737y>fA=i=h&7ZqJxMWn+uPW^DG2kBj5H#ic zYxMNRynDBKx)Z&2E4Ify9|_>zz#hr-#ko^nZ?*7KUNfblqJ_~%o!~O}r=0#+S*(59 z7!PNA|GZu${JDxbXo<2s@0CtPKii@bU`rFcGL$ZgG_H)NV&iMib3@0}_&3P|`i-?A zh$s63`g8!N!1bFp^M@|ak1tMNo*ZAG*_GjUG<#HeYJ|_W3DgicVPt$4-_pyzDb}@! zZB9e;pzkR?YJIP!&z$cAy3s{#MeieucWoC3d+arh$lc^GZ6rTy0r%?X=x2X__`q_8 z;GzY$Ll}pCRv!FZDWQR8@=X_-0E*R(ppvf_uuo|q2OO+vbenCA4|Iz3^f#iV^h~UA z;2WMbR1wm@;A_lFr^E2H8#>JYdpcS-*Ms$N-C6h7$+NrB$0wH~t4q6l*ZBfI;*(E@ z&i?45^XZWO_0K<1!)JF>2cWg<-wydd|NQgu)3f?8^!ra?{z7_ufd6d&`@Vl@)(ww< zHa)l5p#o2XXZzE-CD5Qp0#VyPxxK=@w=f&f?qlQAzF)`wtz#TE;fi|t;XbKzVSVeG zq;5Gr@q!Zqv?os~x>Lvc{_N=pR^u*E$Tb+u>rXgspR7O8br?Yq$}pX};SO}@{{M)( z(k3^NZ2Q^&LgAU7w&O+HETYGHG5uZ$v569>*hPNnV39#0L0B7tH}l`$O+dA|%2til zJ&us2LP?T&mvhg(nV@}u@y8?caku}l-a)h9cl)2oRlao{X!Gvp{#-bvPPJcRRUfU6 z`4@(-b%yo}ILv&YK2Se@Ys3&x+R?o#9Q?Zo_U&)Khi?N>7Y4fMy$a)AoY%L)%*)^X z<0C--GvEB8uMGY$VhI1iZFn~!&!)8LQQ z=fOK@{$anFZK~yV66}`m-h)HM%hUYxySH~wPA9)(`S$(be|{TKgMa>WaLFm%j-d`s z&*#1${9ilGj~@dJE=w*=OdpQ?_1)XQoH-XLFbuYD-^1907= z%gfIG^X6ae1n-{X-yL1z-E#1~nQo5TOJ`W6%k47WtjIRyJh=3%c2o1iJPm^9Q8}5 zu_{0)`^^?KU*cd@>@RktRkVDC|2%ju{EtZBzMF5O$!_pBa?8fWVt9DVJDlCdTKL=@ zz8qVU-{Fi`Hvhd?RtI3O7fZ6-cEcih#>ECmoS=(5_gDJ25sdtv4s`ZS1lyJuds6=+ z*_XN!G%tgi@Sh)ty9c*qJ(_&(FLBX!w!w-Te^8bA$UA`Sc*Yx#Pr7 z`X;B@&y~4jVKT#@C;)Q9Y*;0na zQy9x9Z=8POd1Iu7jJjHSxQQpc6c%O~E10yg@7mb-Hq4#G%<;kZxOL!3(7%qMEsj?F zBxH3eWQK5z=4X>}rLE!O7VkRsIGNRBMzf>6))>Q?ZLr!}C4IXBV|e3a%C}=n_MfK? zhOyH^$hwDkJiQ_FZ{?7XcQRjNIia{T&T-){OzbYy9q*X`wUBf=^yoAyvV*_StEDh% zmJ6Nny%UXWsz!>$8M)*|ik>cW39 zywk7IpChNF4Nqji6B*p;VpD0>C-SN_K|DRWj^}p$_HB_zbUP*XBaai2=vY)LO)?cO za#(jCdQ!c#xHMw<;Vr9k5sT7Laq+FKX3+vqd>2&_BmIgdpBN;Sw8o&yE1X7?k>EP1 z9I(igba6f)0(%~DN}SzL zC)p?*s>hKz!Of+`-w>QefL(#d6;FKTMinx8CivAKX)m3RIFIF%Ji^(}_{Lw9*{nes!4FjMLA+LPoCa4mE`N<2 zG|_E-5{a}J3Nalw6q&2($Pyh+T6wJf1z-A%z6re16C2rOnyqm&Vf^RIq`Iz5f{R1_0SmKgYa_!?KIHQ;LX=i_Q}U0lsa z2h+hTZJn;|M$ebt?x=e@6*GIZ%$yci1y?=#xm(Arov0l6&@=Yovoj(2)9qtoT-j$9 z{%|h2vR91h*wIgctA26ilVWB&&bC|oupAcnmYfniC4N(e3c|rcO`nOqwYK_C*vRI} zvDaNJGby-f(g4*X?Ady0GqLPB@nR{7osG~0Pa!sV!^D~JPRQu%ka-vbK)1Eg==OLA z@~D11)`+i(HM8FS9@s3EX;wu6|KI8Mee9E}GxzVuwGut^iB7H%t7u1v7jqelvnDoN zZ{+!oKAW+UyUg5U7ppklbo5)>;vMAan=r>~->VWpsv5ZWy2~vf52&B|;wIA?XQvB3 zHCt!gQyI5h{~7z5PcE}B-rw;i;~oGLQ-~W)tf*-$yG7t>i4VLyV%=RV;{&Ss2HG%z zr{k#Rsjvq7UmzUHqiQNk2jKF@7%&BR8lK8x60v4Y@(ILd2?B0ERe0LZPo-b;X_y;H zq^M;~@+#}TpU{IG1^S5;coilMGNJ;{ZKiO2$brDd_0(rl8m>XbiguXFe*jm{v4ooJ zs1-h?OKxR*(=BS!bu7lUu{K)Y;6+I_vHq-{G&?zg?VT>w)1^4T`vz~zqm^IaGR&g{ z?6V0LI>{5(Aj3Rlr-|WU*{Lg#J&%0`=b)<;cp^8I(Gl`VKDKzn_i)|GQ`&<*fggzQ z`2_Jm^Tj*a0Ts850#Vg2zyo_-YV_|~cq$Xs2u+x^8TacgPUiW7nW`ph2VQVkL zq?^x`<9&nou2T+8(LMSZHr&EtBWA;RZkf9sp5GeYX*ZSH-2ND@s>Bvg!V@f))aNmL z@?$X!Y(pL%eT)Ai@`Ix#Np_ggUl3zTF(n-x7Hvbh+WHjL@nM7G!G~(J0IUW(us|oX z{0U~S3|fa6rrXJ3E}*N=KN4FkDZmz*kU7zS9mlZH{yvrOjzb*bS}Xy4DBJpmqT(=j zS>IE4V9Vrl4Y;v;a8461_$pMgL|ySU*y(mE)5IPNjVh$IuU{TTMlMhdc=|=1xBX@;KlY(;mP5D{~vd^P-`)z?m+e*4A2e z9LcO)M`feF)}m1A5#keI18*-qx(ehG8TW0J>l;MuCKq3h#cO}3H)9fuhgZjV7xPF# zN1u@hme!E>LM+A%$e+a9R?a5Ql2*?vegYU>parpgshKJ<#Lx=jf|h{XD1yU)<$WJu ze~Nj8b~V^sLij%UI|lrZ7^>GpbnQH3=*oJ5lyaiksd&Te^^kFesNice%lewvogQ3> z^&~HYm}YX%@a`dSI~sDByK)xkmEMO5A z;<#VSpe3SzI~xhJ39p8^_6*+ofVU2#t%lXyyA*G=qh>po;O)jHb&iF;BY8-iI~^|) z-66yVy60W#V?K5-VMQH6!-A3v%2ae_Jx_r@6rIy!29045bFj&%$s4!XJIrt$S zllb#|JQPoQJ>>LD^<#?{>c{y4x&a(^n>Ifryu>4U#iuT}P!Mn>x5r-RVLWR&oN(p3 zLqs9LbtM{!ZfVlsTW-1v9BCF}a}xDyFIGO6+*kY!&hzsRmqFqlHVgwW3J{IN@g9=e8~f+`-xP zykp(PMVjnQXi&=|)CT%F*NeKk6f>&)1wQjeupf{woKN!JmYc{l=oxrdm;3)6d|?CQ z0bhdH2*+Bk0{SL-dsjDroXn$p4kPWz+D+%LZZogJ-xfUZ2TaCvpXjs?D{&wSFs3et|oOG^k5Dk|MMP~3gT)>V*T0IpW2fph>YHd9Y;;YE9VR` z<2UZm@;0o-IGl^s%*~}D7C9BseU3`eDd0@)lQs8qUFxOUfKB{5X=ZEZ`n3UM@U{mW zVWFn?wUnN_5&mEEEcoNL(@&Q_*iMx==Q=!tNvuDf>opOnmvy+X0-fv$M{T(-aEi`1 zInXV{s6r*W+O>5x@D0d4a`2ZNuC)iq6H6rVfKDM${*BwEVR%`tzmta`=!_3 zU!$W~ELkTXsWV#LMofHbd#d3SShV`}tZDYu`axpJqb8Cu)#iXOe~8ItKliWqRDf>v zwaQm$ISra!WN67V|2%T=@fDXOmgo?=CW45@)Trz!es4k2|3}X^o%eF=nn^xyDDis_@7iN?>H7I1jdl{2_ zg^@}Gu^`G%6!>>~bRE?mx1v{tvXXLM`d$1$;wW5iePI0Eoz!tKj8&OOz&0J?5~+pG=x>bm}H z@YXpFiCr9W?&FZv$Dt&Az)jmYDUup0#PUhE)&qDn?c+K3%-UFTBk3vXFqRLA{p4I% zOI&Cr#6#oj*x$v-=i~;sbBH~Z`m9MfYu(nTa=>%eAo~>|e)FWBn?PVX+3Q`$qq|!0 z*ZDBu1oYEld&}d_d;ok9aJJ1!h#e!vC2Nt~H`o4B8&;y zRW2RTk=xZQ#BMB7v;Z9fcEB}2U-8$u;LH02Udja-$OG9+a_4y_WsqBe%m5#HZX7HS zZvC^vWBvcxyVB;gk#7C@{tK0B-g`eJlSl$=$V^<<7{p>Df`lZ{mnnf15D1}wSbzO{ zPD^ZJ2^c(qRCmo{8`R6`vp#*)ry`?#3M0^k5R(u-$iR1y-(^EH`^Y1eo-+*jU%jxu zGtvaGIXSMTce}7-?4Z$0WYk$IV^mx5z~4!Wpi^cB^k3(P8$Qk|2X+rOAy@d5aX5@S zI)!86j_6zvi*47zcU{DZOJ61M6}3y}y{Vk)Yk8sE;Qg4)7GKIamIoQkmsM}!E0*z` zq5*bX<%K{uXA_7A_SepJ_xdU2YI7)7pJuO}0(<#03@;7x;Wfejn7qRpU_Zc~fjqT zpEt5z0{og!yXw;-V2k(@^KOwO((O7bKwX1XJ>b3RrS)eobV zkjAs1hz$XIt}d|-jH8!$M6f4_c?=EsocL*Ii)v{+OGa5-*p8NzQ%ky*#GG{S4by$% zgYxjayzn*EIl&YW`ym)E@gds{JKh3%fG!e9+!#DxY~%Cbw?RCaz#Kgn{QqntW{!|o z;O7eBrVwk6;b#Tn#2Ne_;v`{WXrZ0Sf==tHF2oVtkO%4)*JWKb)?^FuGT4qPmsVtu zx9VJUWOtd*UTK0pCOr9EZ%KHT)0;XGyrfvnltAt(5FZqdj{A?6JIxV+54?r%1~wIF zD$I2}JI{r9da%!ke+={*vBCH^luwY$6dRn`tofS(zc_g2&{*OJcrGE}nL7A>*jKkz z?-Bfk1sdRa4}Kr#re7N0HrQtTWo{akn$C%8(J(V@S<8w&kbfb-6n(j_Il~HK6y$7Y z8`Ca5Ph#R+8Hsc8ShF6!2j5A6-v>U|8YbCrE1`dN;WMFL!ZnoEw9ectm?Mq(84aGB0FOk^;op!ml|72iB^J*nVXb+o4Ymek2K=tP4zZClHt|do z;sSgJpqb;~dn9*oZ1hO}4CtMBtEw#Up-Z0;6T`PHV2ozFOi- zA-{^i8&lAeMZ{n-VB03}Z{WvlpQ+7DvytxEh&ImlSAMJ(OUr$*MJbZ+zQQ>} z9}D&SD)*Gou^Ce*P4Lq&2NU=eXkQ@b80g=GIiKS?IV*^_^!0bvqByTx95)tr2hUJ= z%zGmE6Uc->&bQG&LEVFPlDxaIq9KmsSosjMtsy^fz!z!{&#p0NCBT^l;8D>t^WA_4 zG@OIbFcLX*%-<(_&=ckc=V$o9s-(#=Rb?{oL+F& zpu0<)Y&$PCZ}uTx?c@AFZir4Wd!XNQfs8|ZI|IGof)C8&+Tdq+2J|`DRG^uw6Z!@D zt#uw`Iv1YV<&^dH%)wT(gtrhku$MSws{(XIp96fNAU7zdPGB5%kw>eqeOKwJbJS6Y z*`hDCXN+tl7dK}t>_aw~?`D2iik#Q#fqr{7Ya-gV`FcNLe%`3?)c+BjCpm0nzfo6u zD9aIELwy8s7VtcYXOTZ8vQG_O4{}@cxR33&N!CyD{N_e3#Wivj;*(&1cuqlLV?tx3 zSK!B@4gucpZk{OxdsB?z=PK->(<$T;AHh60HNd~1ADjpBZ<9~K8VW5%sJF;DQcm@W zPoyO{%%3B+SVXbPGec_7nX3hN8 z%!q?(H_?{E{PJKg@SGQ8WR>7AJI=|xHOsVe^&AI#;e_vlkX(o~`n%9S z`iL5%(@w=SZ5ZH>RZi12JY&hO)v67Lin zSpj-YiQzkzFIvx;)MJGJbKH*8SkyD6PH9wrhd52rHvLcHpDy(v#?8}lm_L9#KHrn$ zYJl`xiF2;XB{ttlf{rmvX_3-RYv>=YLMyt)29V7RXA`ns}R5@)qT z`zC;{aWHqNxt-_8ma3JZI9Hao_GxjC#YS#)Whx@3QC-Fqoy9wuI?B{jcoziB2_(3n zFYm%w@k~Ea`BqNs88M+> z?G9&UEz8z5?uXfF4aJdR=9~dusXirMtH>|K<$IS;>pG?8fKCBlfzuIJL7NiZ%W<-P`B9cr1;u$9 zlr+CC=gn_=C#_gLE?(#LK~rm&<#{1duY#Ybd3-tN#|%{vm8x{#>=tXPP*mzpx~gc! zxWN`CK$1yCl^{kB@(v3s@n;sgH}HEjj6;a7Zj~~1ztrjaD;=@m&sE%O)gbN#KS?Dy zB+y5f_`dAvm`y+N%C=?Yc{nw=cEMy*J&3CB8?|;v@A*?Bn|LjCoVJ(~e8a8BjhN{v z3MYwqucpM>Su?NOFPzzt9CKcQ%{FtxaYON?Z-Fgs;~dF*XT3#kh=BXq4dRcdiD{#Sf8zoFuFj;dg>U7oUM}HT zUQK+qRAr*&Oit}K6DF6|!AA|>s{uc|7UV`Zqx%}HZ@RX=!9G3p)Ly+yy|&LC*k^)G zK^)BLiUj_RIBdiavs8A_fqMm85UaRey~5SUR=!v&_1dzLbsVGS^i5V8X--iydcLh^ z6R@v-$5LVHN^zuQD-%&E@J1eD*qZvHsO`An>Z7`9c1Yg3Q*=U{WK%BXJ&Y>>pwTT&dAgzywyu&53NC*C8y$6toHBDy`rXHMXeZX@mEKSy;X1<{&Um3XcocBOBoGK|T*r-CfI zR;D?wjU!h=3Gq1Vrw#n`fnF1**Pnd-ddGZTUXX|PPanFM4lmm~>T0@NR?JFI)v~m8N8Q>d;bnFA4?M?nadvYe z|AXys-)K12Vm3|7^{v73R=tUB`t2{wLn2xwfZ>v!{};1W$bng}a=#|i)X^^OgGhbNoi?}y4G_=BI^#{Rc&F3VNf?xI*ZlfZQxQ`0B-22kn< z;&3ecpIww7w-82adm-8GLb@zh{c|e7iX$}>nArVhH3D36IL|hB_qe!ZoC&XY4oWEe z{n3k*+^!KpSa3n}Bw?ZTsu*ia zgC7Umgd1A}pA?ZLO9D>qdv}j(yB*=1V5Elx>@D5{zj(^AzWXa~4oYY+9KT%|g2;Km zK4Fg<=@HrGZn0Ayx3j!GgaV114InWY^y|e_PZk^4nO5 zDrDW|eWS~gK}S?WVtf!d3s~x(hGSr1AiOOe%K?$QVu9+=v*9+aPdiyB!UU0uZ44Gp zUv5596U84n@i8pzVj8}|*h2<%0A9V0H`EULy-k{ice^r%Yci%iY&!kn2#7ndu;|Kg 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 literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/fixtures/2011i_disc.html.gz b/lobbying-scraper/tests/fixtures/2011i_disc.html.gz new file mode 100644 index 0000000000000000000000000000000000000000..84736b4a7b72bb266e2590afe2be52093f53b1c3 GIT binary patch literal 14723 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 literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/fixtures/2011i_summ.html.gz b/lobbying-scraper/tests/fixtures/2011i_summ.html.gz new file mode 100644 index 0000000000000000000000000000000000000000..430f6859164b38d83fdcb3f26c29948e32e53d3f GIT binary patch literal 13673 zcmV-vHI~XBiwFn?1~6&>12Ql%F==0Ob!}}fXmo9C0PH^BOhl4RqyU$F~B@ zb+E1L=WlDM)(?W=p01BZqxz^_cfFo|b)nzTzM8bLxYPorW!((S+7TO^jd?S$9se++ zr{?bNF7Kd*j%aOy&7*_gGz}dLNPrP-p^IIuc4sUgF40^$UR zwO8kd#Oy(deso}4&R5j;NcXU&8@{jm!L3d3aOl_Ju7*5fAJ$lz-zOxfq2P8%4r>9q z33OJ04huC5j}Rxb!@wOn__|tFoZ z(SgqI=IEp6x;>kG#xNtdfn_B6(KJ3oK|lpO0Mqc>N8*@P_fraL-eKSM0wWBN1xyk3VGVGP_<9##)8hKj>B-^P z6a7Zx)yFWabilq(0$&gPk?Cu#&&}rN7K4fx0843Ii}HFA8f6Vc`!?Kb;@z|F%t=j+ z(Yf#3qO*5zuby0?x98_)h?R4>6}-urPz(#a_~lzjyxaP~awc(eb_=atZ`Yf3-?j$x zH14==;DbsUrW+v@2?qU(cNggQ*Y8e_U!%9je+p!>I*#$e7kO_vR!|7Bt$HKg<{+>F zn?TcFUb~&nt>p*keb})r16>mA8GYze=T+3nrIUI|r|^*y{`W!D$`#Qdq|<4pnYNl(3w7mi;ipF9w9y=V0U0z*T^ytYi<}2k6Maf zeuLm{>PR>Jajk2rfE4nt>XrPJJ@SChBv=igCQsd z>;(JYAN?BI_0Y!}XztIShaQMO@FFe1hT(c97_HP}t!KL(Y{zSfLS$R(XaSwV|93Xb zy2cRID24YN*CG4xz#&?nSiOF**Q{@l0Y!>Zmw0QmGk&RQFdLvJi7EPQ*2fR)S@qOH z1-1#@-2o0g%hA9F?zJ|PG_LbX6yfpQ+>I9V#`PMbLKEF}p?9r|2bO)iSG#mW&mia$+z<5LbI}LVsjZ_#={h>aw$<@q-p(x3 z4c5^W?z;oLjxJna8hC!?kxppzNr2v5t|K4XX+H6+ZX8DykXA83#P|_Bc>!T07NkOP z4q6@{9SqXf0Vt?R;lf85RwWvnK)eQhGrE1yWZYfqtVz$oNIP=fX@V*3V>h$w66+KeTT~rXrZXz=t6Y87P0<-^!O7b z+21DJfblT;o*&j2=fnV4go<@45TOFYrq#FpCVS0|1eqTFYFlId;)k69aYD@s1URWu z35H3A*bAUI04K&6qB}tpw6#g4l3GUn`QsJ*J=cFi{?NZgK#tJA-<+SlIz~^yr_#7E zw6=GjAynol&vo>Z=nwr{ZOFMRBL4n2TNtT4ihxOnH_z@K{n`n^?l^H1{rR&}%9Jy; zg=;3PAB3|-4J7i1*ooU2#B72n@tCS+C5ma-jP8s2MDv*bV%QDcVQ7Q1@WUdg*wr5w zNr#M906Qw6#qje8t-2B@7DsZ(LJF9MYJYG{p^IzFAU`;kHo=|)%j%WDvM7?c1M9_= zz>pzH*JsjKSY@B*C*%+Nd#DA~&hGZl1(p2$WS58kB^Oj;J%w!>VaJTEtAJPOx=LtP zW+DvNmjBAQmIyxcC|k_M5%J`<5*g%%qQxwQh+gs{-?c3hHHSB7t=k<(I_DX$B?sJW zBnK36@0^`Rc3t#`7zQzLQ4-#{JCC468|}x5$gXlJ`$(0byJYyXgN?5}&kY?@V`DBmnW!m`9+s#@PjtJ&0i*IfWAO zT_w+u3Z1fa42N`AG-z#RGE!_}=#22Wk$g10>l4YOjmJC&o0*0|>4Xvu?V=<8zz97L z)}MQOxEl~}9Tn*#a=!NZG*2x0LU+on^4K-o?*U6*7%&mOr*urjHB=_in(@pL5&`I~ zRz@Nq*^x{hq`+BgG+NCKEIhD`hF#YP{b}v^ZW-Ek&b+{#Y57AN-|ls6*Z7)_=f|@V zJfA01TpMFnV$8dh%BtnbEyRRyGeyREGAapNGV&B0&T*oGBN0nbl0l3L?Y7J;B=UHP z!9;(}oml3h)lQNmo`j=o0u}#eJfWoalz5U>)8ovJg827hIi4w#G8v{Mc6ZZi7J`bA zYjUql3`)){rN-cfoMi<0x=-rj)=t8Lq;w6?&USIIM`sFViJCES9aAx?;Eg9WrnFg| z?-CA1mN-9tPrwMKOKRzs(%S?%-xyn=l*UD($HZJ@HMgw)E7AiPABIx z6lk;A-ri~`&4nSPbWz-s#zxE7Xht4J={V(qjOn0h@rP*xq->hpbi(*+dp5%<$=%IX zQkKhtN*KrtgDouGf`(=0HSef0E>gzmBC!ykjjhbtkoG0b?Ii-Tgb9!%&oKu|c&ZEt z6xE+G5uEP3Lf@7=-V*4ojy@OPmq~J(ipfwx=@RLswHLzm6pSTI0ULHcepgq7Wq=@Z zMHzFzDV|)hN=_n{ptK5tBIGcNA9N zS_IwYuuGtMG;{&CraTQJV|0`0zOx9r%VC#5_h{&)nN^l&6wAEr^xC+zA(lW~KJL8g zJAb;iz?w}AO+%!JMJ)V2Hr){mpVB`KwsPb#n5>`%Xrm=4z@Qk1tMNqLbqbG_g|V@3}4}&u6c(pgWE{8(#)-I&RRHdaad= z;l=2owKBpj%~&o6n^x%WWe1ZuxAB^4oF3RLE^}Si8wiLsdYuWjxXA)A0~iqzA<(sWBE_-4LC#llU zN(@lI;kSdME|Sr*toh?*G5{A3k~bd50T5BOiFi)Ia;KS_PR z&&-Es&rc!NN86i^(S$KYGt2oxjDVOLP5pr!DzDf*2bm0>`ox9`&yq>s^s-~zt>yRu zwr%aU|3)+a^LE#|9(-$^+`er!|8gX_9`OMcc}HJ+W6aEQ-@GqQT}sByS$4=P$jmArG6$;@I7q!oF;41% zI$Ni<>l5?_s??6?-v>G$MzSdfL)_5Ud)3D8Ma~$?tsY~DT7st~LuYYwij~v93@H)Y zt5EzltN+BKDZ@-4FYCi#1d88gj~0KFCNduYn8X_N`0)i)Jp63=$UN79?ogw{(X&B( zosT!_ThPY8?$waz+Ux)kxCGXh!=CVA5vzWbnBR%i2<;RlSX7T6=(d%ECGs)#qPZFjX*qDBOf9;2 zP81>4EN0x8z4B^}nf*!GDirA{pc2%X)SIom@FhwkIThT^0DCfd^j<@@|l~c zdX~KxktC!>j8XEb$}qCh6rXp(Y{@C;xHnSvnb5bzA1eIt!|hxeKMN~%Jdo#(ki3|~ z{!OD4s4gV_jT_s{q(o9wl#PM&0>XgF@D|kgUwXEbkYqwZWyK9AfXgMh0K5$545g}W z9ZkcmD%B&f=3`4eNe18jd7&p31!MHU130=MJwOw@*}z4A!a6>(D07*RWuOM^XZbXF zq{EZYvjU5#m-T)yn2Pxe%b^P)kl6PgAkHLl6|sl49R2gvGIjW4nKv^rKQ}|3cLUrn zh|k{a^j8=4!1|jwn&r@dHjg`r9SW2XYd!Z`v&l8F{i!s0&8pC~`XwC-{Z2zj4o!Hj zDq(sN20C4=f%*;koNI2k3)Jy)iHM2d;knJiYUmwp2of`aBn8yA9@_Jo9p>wnZ>lC) zs#XQfQ6ZQZT=(Ka2AA~VgxvXBFSJZ@AJG+E%;d&XQ62qGt5bu;MfFnbM_N@u?b8q~ zzGWJ0CJ|op%IMWt-K{F#*980y?63=(`{8zICIuAC5nQ1^MK`NT29~2R0zGg?jwWtq z%L1>5FaoK#ML>otXpUZDdy;ZqG96%bJxmdT7LG_qKZSq!A+E}09s9$ZsYKxQM8Mq} z(u@E>XE?we?3d)o{*WfET}6|2yd0Z0_gaINYJE5Ki57sy$|#vByxeTPq%A;fp+z-C zb~+*0W(Rh4?FKX_sW{-Y2>eTJWCeZAw0zvL?0k!|KUqUW8=^C%;VM#yIpNe*Vg7eG zpcJvOLld}p^gC-&uAP4X-84`AymcA2>}u)xm)xHB!-S!eacE_mZsAz;nc7D=Vd!9# zO7Bml-NaDzb}|&L?Duasi-x5YswshKg${|BwDKg9$(0E*)47-@$h@r3amsm7x2G!@ zsGD6H3HI1rPBeL@vs1_cV}RX%{hm08U~a1hZFFp!uwL`23h07;a{>#4nZDJAp4;>A zV5W6D=Iz02kF}?PSlYe{#y&->0raHN^@ep#{Q0RS8b%j0X%yQsgpNhCDv)LYQQACl zAJr9-F`tzrhdUTpe(E}hOBmIy0@_SK2Ed--pb!b<_Bf6AkyVz9B+)jzH>^#PG(XxB zUVRa(g3I`g)mX(FB3zWZ$-#2t%2g1<;>-5vN(1L!sdwt z;tcu*{WCiV9}R)VTDb}onHOPOd`T<1n2GvpQLz#XFfY3Nl~Z|GL*jNO>f&o-7rgpP zL}PfPd)k>QhKn~>!_EMQ`M_U2n(z;eCN&bB#4{F{fTgU5CmdAFL| z1sA?5(PMO_~>wcvMasFKZQOogF&g{vFtX~C+ z{2)oB!UidC?Fyt3mYzY#ZB3W5k)0kLRycF;mVN+-9#DRMU266KM2pCmF0!%$JIMnL z+gqh=S*HY1k^%`76Nv%#l$&h+disN?IZ0MJVXOThzsCs-;mZtRQ{^q4=^e*;zU7~Vl-fV zBy$IGy3bxuuvE(hK!W`WIgmq{L8ANEicyDmVL9JIYYs}hlJ!?&1;5Ds6ifGoaz~4o z;tPqmP+@oILbfl*4eElEfB%>HGCd=CZcn?Ymn1`IV@F9KpKy?pv9r0{B8C_>;kg_c zMy>^TQRR6?#hsV39HL~uxt$^@8b!^=Vtu3SNg`VmUIz31O`f2dM(q~MU*iZ+^+cft z`viN!B!VcKR?iBs9qk}Uise+>cg7oMZ6wIMFn$2a#5Y;wCQiZq7i%yq4C%~rEtw*F zgB{!>gVJ6IyFcYh&3=H<8tHgAB-o~#d9h{^$HMlUNfC6+dMJy#3iwyNS%GByg8Z_| z_*%I$Cd)ZMK}mWPKSd$dNl9K8D2sCTuBJS%!rqojEcGM>HF1h%aVa(r zKb^1S!O0c%z;==wbonWw{H(U+x*FqcFF?nfHuMzRz@6CpKsx$+@B)1O4QP=52SUEe zN3-8nlUrxd8IXv&G)T6sibKKZqwds{TQnJ|O7zCWkp*!@c8_hKC{w>xftusZNE2z; zthbBMknUBQi+=G9#hF`}X3%j7PTX8gmY{!&zlpzK1$U!>gy`?>U zYZE#XV5RmrRbBC*d3DcXvjDldb-_!{+&RjnEIH+8j9^t!bisKUby3b@)3wMxs(pXJ>cm4vl(_k)l}2 zTQOC1$6%R6R9>u6816@V*RUjNu>&?Vv57i{VhLx z6liHOaIC*er;$U>@GT7por7ud9Bk(&8MH;v7+o^h{;nR;TpaZMh3GN$I9oYrMpLZWponv7kPBu;q+c8!k=-g3})&FLqnj*nh@!NIMRD&r~b zg-~!I`E;H@M;Ij%>u0R_@)^8@De1YcsR2n@glWDB$vj1nG9Wd?r^E}aE{!h{U%h!p zS8gxB#>`eLY8TYZ{0^YfQ$`u6mEvo$hlsm1LmNBJ+{Db0Ur+|oGe^v|=T^2t??tPU zHX+|HzE`n`U81ZK0le)>2k_+guxo|mcdw%!N{Zi+YvPo*Tcl9HPEth)*hw@K0Xtc| zq5(Tb>z_M9*vH=_A6GLz*K8~=KzIK@n+bDz>xSA_#~sCPX4<|p;J?4z5dAMy{#T{E z2cG@ERT!tpx#iIo0_9TkzmmY{=R88?cJjv&t3W2YSsD}9c6;|A6?LTWxFbCvfGkyD zK}e6jo8#nj1)TABJJ=cMSG-S|RK4U~m-VvO!|lRl?e3!itGXYf**IBpl7ca(qSt<= zASRq<*Q)YycB^7W=l>`X`_{}NzfAOyyFse9xU9r#a;MU(N!)S6p!ibqm^Md$l(rRw z#cs-3O70Y0N-~lt>qv=XVjU@qS92Z737y>fA=i=h&7ZqJxMWn+uPW^DG2kBj5H#ic zYxMNRynDBKx)Z&2E4Ify9|_>zz#hr-#ko^nZ?*7KUNfblqJ_~%o!~O}r=0#+S*(59 z7!PNA|GZu${JDxbXo<2s@0CtPKii@bU`rFcGL$ZgG_H)NV&iMib3@0}_&3P|`i-?A zh$s63`g8!N!1bFp^M@|ak1tMNo*ZAG*_GjUG<#HeYJ|_W3DgicVPt$4-_pyzDb}@! zZB9e;pzkR?YJIP!&z$cAy3s{#MeieucWoC3d+arh$lc^GZ6rTy0r%?X=x2X__`q_8 z;GzY$Ll}pCRv!FZDWQR8@=X_-0E*R(ppvf_uuo|q2OO+vbenCA4|Iz3^f#iV^h~UA z;2WMbR1wm@;A_lFr^E2H8#>JYdpcS-*Ms$N-C6h7$+NrB$0wH~t4q6l*ZBfI;*(E@ z&i?45^XZWO_0K<1!)JF>2cWg<-wydd|NQgu)3f?8^!ra?{z7_ufd6d&`@Vl@)(ww< zHa)l5p#o2XXZzE-CD5Qp0#VyPxxK=@w=f&f?qlQAzF)`wtz#TE;fi|t;XbKzVSVeG zq;5Gr@q!Zqv?os~x>Lvc{_N=pR^u*E$Tb+u>rXgspR7O8br?Yq$}pX};SO}@{{Pr} z&hEsKY(MwEsN}eaO!r$vrjcxt0DbABWF#YjS`zW?{`Yrp2}CeKICMB~ znP8AA+$_krmeB_jpJt` z$94zsn7d#um_H6d3=V}tcal4Jt_3^%_LzMmc`--CeETFDw->KNZf5_xzc0b`?|Ad~ zWjLm$-VqTYzsLHJ{6HrqS~X^kjoQ?JhtL27fn!t6fA=mj+7l1+Xz1BT@8Iz<-T&?V zQffb3fQIR__Zyn~Zmf7@2!_?+#PG6; zZ@m8i3Z)y8e`t$BT6v5~m|M00{`vy6N z>2U1D#c*O8o}mvdOjCB0xV30f^LkG6CTWgUhr;$OyvN`KW@w8|*e6tR6ijsUjBg`j zgYT4gl*lJAYqcMJKesk>!QfFWekna;pv^pGcmiq*q(Z``|DWq0OTU;sw3P!Wtj(zaVjXQqe+`$ihapQGvSK49SQ;396cyYazdZ92Ov6jyi!Q?0 z1>Aq|+uHOd8WV4|jYDHPVqb2dhnf1Az#D>rNIV*u&LYA&K^TSzQ~N)ixkDdj`wAU{ zd^)?hY>XUSxTCq!|Krd6v0{&mPn`a3#w(KRD|7vK?%_(8M~Mel_O5#mLCZ*wTGN1+ z`*t-aHhRh56M7iA$Bx(?A*EX~F|B}}tF<1ef-XfPC|SB5W>Id0EzI!oA_VdEt5nXn z8_i5JA9l6zAcPr)q51pVq*bjp^Qr^LrvQfPMXWxku0d+C0mSI+W_znL2RHM?29 zc5@HE4W5-#SN#*$P+hXL|m9 zZraV3Ciw!ND^G-Gp)Y630Lx7~W8Uz5%@kCwVi|3Ft{0)aDMaOK&HPNX__EU0hvkCE zXpUs-*-1|<)raN0?5kXQR?TL5H75;q)1zvZ7i*14Pso+0LNn8oBmuCw>4}f|M73FC z#TkQ|1f3T1d}c7ye=&H6zQUOx>{u-A>(>Iu)O9)&J}i zL{@FHrZ(u0x*c(14sTEU&x2Zb+E zyI%alRDxE^b?8kY{#jxod7sVB}6YqA${IjZR-GIf1R_gp`;~P6Xs#uNA)QA>QRJyu&&| zE);sGKm* z^cux<0Pl0%PQ@-4cvf>nkO9#KIyL1^g;U!2ebT#Y=BGlInTn6Xyqq`3YP$tAF3g}V zFBe%?bwGYf6;m(TV~`zFb!zy24)4WoJ7vn86v*uqv)O;Q*D6)UdQp0WdK{G9=u>R= zXVB+N$Ymzwya;`=EcC+|jj;Vzq7MDFdd&oHYYyPqhG!1qS+~_e-R-s~y%s0UKn5S> zj^LMbwJGo;0K6wcmM^Fsko|;B;VS0~bI^U@e*t8p)svm{44(D%_LKoyBtVXaBzwM`b-C12Uvl=HNZui2=i8eun89MwZ&{EF zw>#qt@cR*T+EuwE(sUx^1Sp%ILD?MO>>7?V(m2!Avb>`v%Dtu|C4iOzz~y$i!ieGz zxQJjNz=lD;U=I=k@@@q5_sa!&thdD>>f{Rl%&;lRjaIfF!k4QBcg@TkXw9poI`BVb zE@UW@b?B4TizeU`t@GfsS))I21r92Qu(a znpZ8pr4;RX8DzHWR8r_C$|c=Zixco2EwEiEYm~;JEr91xX09U-iZ;l4dWL!iurc6& z7zK2=0Wtz*K*u)pd@Ngh3E&61NuZCFv6cY*tz?hd=%pV&WUEbP%~mgcRBhc>HGrF0x!)eN=JJ47l*j(K zQK;0u%nM#SZzh^tcOsSCz$l82!kI(0qvyJhQnqfJfm&pXVqR?CHSLkc*s{_O#uAKM zx^upxx6E%1C#Z>zbXV(WY3fVs>55AA2K2Fneq`OgXV7-dL~5J!Q>4?EC7p`;lD9Q& ziAJ%)OAL&O`%<-akhl32Z=E;f?IGAZQc^6I=UPYZHXOZPWot7fVdmQ4n%JOq z#o3CtLbE)Ec~KC-6&c8b9||OV?Ldc%Vph3&fjGI1H5Dx8#e6-}ysJN%6Ry2kOb)NEIhJFS%qAf3@bh<|sJ5|$25%NJyl561 zUX?+vQ`@WZguQWtzsQrs39_C!vB)I6CCp!B{g|mFw01@`!?qVsKbXs)ejiFl z2)rY!pMM8>lpbmgmYah~3h{`OLl>3+O2r@!%P_z1q6D4wZ|Bk?+0GVpiLgFS1;BVK zM}Z`+Hdp@<xjTF*jRLk+%qPYE~1?d}+eq9}o+4&B9tZJPwyAi{MDc#G?<%UXEl-b$Loloi5q zPct#7o`>SIXt7OOL~)6(YH`^$4##Fpf(qP1x5C_9nx$*mfMW#QEy3%^o&diM=km-2 z*RzHm5QVI-Ns<|e4dECjML?y=U>Fc(tXMWhYdFB2_ZM3U0)ML>+0G8y^=$LkGA|Gh z&WuDiitj}!dNHyONdO9GfJl8+Z3PqYaCMg6&4964pt^;pF=)ocPSM#Cf~^c`LXWjy zKBTuVg8HK*eqN+f=}Mpw%O_w1aH$g`!gwC&22B^SRC=?bZuy!$^hZEk&%h)ne~mDh zP-q3%h&m(7b#DLT;_IMCK%waR$4A;0(9ZHevMkJ*x!BxkNQ%b5@D!U=l?lOhPs=k9 zf*HY^ZQ=jkaBLw~1c>Arfnw1;)GJt`K9`4!tVG2CvJM6#Q1@8~NC@{X+=2;a_9|4Y zE;bZzpZ0EBxS_qR6!Ce~9gZ+Y?9iklD$tYg6sy~R4piUWO1g=J4p+c~;Vn?$Ut4LR zPlRo$*F1RLsx|2QXP+0ucrXkdeFRG4A++HSDp$-hui~M$ElChrlF)a7|2_-*kL|2B zxwdT$VuKv@9|8Ha(@mgup2E6+ys#}&O9#rGea>ha&LQ-Q|J7 z$i7sk{eWyg-U%0u38_y<2l&(x?Sgk}TmTL%vUg}IY&5O6djQ+r#tpV{V1!5Ws`rf> zY}H;K!8ZsnFK~s%$}E8OacyOGYf&$CuG&Mb|5w<18k{;XSn!w}AuQZfm5i?A{i(O)$8ls~ z-xiRZ${PlG!*W-o1XC2!2t30GK9Xc$l7c-PdLIelhkh^|d?Z5VBVjm}Wk{<*$R)XA zug{aI>+_qd>*TYUx({*uY>fui1~Z!kj6JYfMj4Kd4R&oFIP9r+9Fo0rwznU@H9TXg zz)LCeB))KHv~&#gSmasn{MbI7eM0XJ>@1zS;AzA($KxeQ>svJ2MWiEx*)<}bvKQ)U zpoXJcs<)#Lj-~7NNtdmK%|}5VH~BP5caZvf+dOEC>TVFSCA5<1)easgd_Dy`2Tx-QNMv$L?Cac#U3Z&oMP2`j&TGdq{J&(X@SK zP)AnJa=370DEgrRMp)X=pQS}RaX8($>}=-OWJz#QMrOFOv0Nd-C7kFxT_T$O;S=NG0heHYCYGJ(r*>42IgZ`+ zc>@phMuXbjFdSUhe%V0vX=hJn`aiu*+jJ~A2xHhw_;)R?{8Q)vZRQuG@0QO%0{{GE z{k2>G(zIz>{>qq7EZZikK_)}5PuJ=PgdgcWBOq10V!Ip|j(k~v3eZoI zVb9sEexjQo0k58?I3Gcrn8Z1A!z2h^a@7FCOTr_)NR|d?eOiQrmadbe4Lk$*07^jI zH861l2-EaNz}LcPpkvuY>Kr=dLL3OM_?EUhB^1D-{jnTJ7B{!~rsYzkMPouTj)8|# z55iuP=V^vZ(j*YTa}WR>rQrzAO*JyK{W8N z9{>l>&!;l`zFuzRKVS=K=A7YDz+&HD3YrFxMIbHteL;>Yp#o1V-yZ>qqN9p1KL)dz z7O@pAlJ+N&l#9cQOefi(UwlyZL*fG8d%(6H7kIT0z%m+>cqMnXDN2_h^!s|&^YABnyKF_n1eGl`a7c?o6 z0QL~OzSD(OEr^rf`f!e69+KYW69kS7{_U>M9uZ_BTRO;2HJKjxkHh_=!%d6wUzZ8; zEwcptj}-2#^W{AlU!5)52H$&_E_Gu(98MQCt$5tHnogz-sn%5#%V}PZ&h5*=K<6*L zv(cyVmlC|FE)Ea#M@`ElzmCT+EO@{Q5=(=rvg83|;J(^J^0eP^%bp+itjZ{(21&AX znM3EZYQ(1q)zwP9t?byz-rxT^KJ<-8>f zJHsY4S8n;*S)5t@aSL{)7sm_P{d)6lwYph83{TZ_urhj5>wbCGK$YO_8(FHDyLUjs z3d5D+_$Gfr#frjpGpJ4sKKUvvN+SKm&ZUjIqxK>BH*hc z;eS;WmfWL?gde1ek|)wzN}728{p!=*SFR_Fm$fU?>OEN%l>=1-1Wp96O&7gdXYMt) zdut`~+xUCyv(E!~_>_f_;895g=Q!%_YzKNIKpY0xk!!Zjici3aA5!?|UmugOB5U{> zdPGf!P)kwL@Lj^#JB2%)R9YWJflhwEO!h&`CMuRDg{}^7 z!~297(KAKO)h8HpPP5%%0OU)58uw+bdaj)SQ~Aa)jE`H@`@%D9Oryyfzl0u5M&~DZ>-E^d%ID>rr&iv7(IhmO1lxfUWOGm5X zRGoY`ccbd0RY-dgqGGS1yb0O$Q5WhM_H|D3Q?QZ1=~=e5pt&&UTntWjcMntwS(eZV z45f-htp?p7xMcytb3ugDkHpb;%m-Kj$D_8h544|{W{;VdVY`P@av$T|;HOGOtPQ~)iLxoN!1GycOlblsU#;kd5d z@Jm^NVwqPo5okqOlZq97sVTZDsYR&sJa1@F&q>oFDlg?gSY9qeMJj7ND5LTc&*KEG z5->zr6cjlpPlcQ~puH$6l9H1Kv>yUc1O@3boQzg=hMG5bZHpnM1MTe7Huh^6IRB?y z3-f)JdofI5^h|GI3Lhn$ zq?TZo`ZJ>c#3fqXGK0^{v}{i5TI%^FL};5SoL0@dh63K)PdMud=V{&t<)I>y|x7bhom zrqS*&t#+;2VlJwEpH-H6bCmWZ7!>NLKAx%Wu%IDxf`25R=>v;Aqu~ioDu@NZjhywV z!ql`1BZv6y0qHGjA=dn9t9_i>K8F@ObREuf76XSBZUMLza0}!(srCcTciyna=aT@f zpQ=B|zn}$5KZK1hxAtQ5e#5s-OGn#eZ=&9IpksS;9sb?D{M5W|T~-gvKpBYAKm@uB zMYRM=NRyxqYtbk}UK9-Rt>qj7@K)CjL8+vake!wDjOwf`ecjgsB&NYC+U0)%wMC8} H#!vwOkh!!v literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/fixtures/2016e_disc.html.gz b/lobbying-scraper/tests/fixtures/2016e_disc.html.gz new file mode 100644 index 0000000000000000000000000000000000000000..279fd59c08a9da29d997a8b8f27f7b27a16ea575 GIT binary patch literal 259811 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

JgffuXq9foVW7fRQ> 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

2e-loi<-iGl=fSA2$f)CyT~Qj$ycm&81sM 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 E0NB*32LJ#7 literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/fixtures/2016e_summ.html.gz b/lobbying-scraper/tests/fixtures/2016e_summ.html.gz new file mode 100644 index 0000000000000000000000000000000000000000..a0bc28b85feaced4b245234f19e9e67fe3481aba GIT binary patch literal 24496 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 F{0}B`6uSTb literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/fixtures/2024e_disc.html.gz b/lobbying-scraper/tests/fixtures/2024e_disc.html.gz new file mode 100644 index 0000000000000000000000000000000000000000..9074511f56fb9302124d71e06be0f148e40ed7fe GIT binary patch literal 23241 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 literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/fixtures/2024i_disc.html.gz b/lobbying-scraper/tests/fixtures/2024i_disc.html.gz new file mode 100644 index 0000000000000000000000000000000000000000..44dddc2ef9027bca17ae6e5ce8fce96ded87f38d GIT binary patch literal 62766 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 literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/fixtures/2024i_summ.html.gz b/lobbying-scraper/tests/fixtures/2024i_summ.html.gz new file mode 100644 index 0000000000000000000000000000000000000000..e6dc3b1b651d34dc806be85d3d6349eb4602ea96 GIT binary patch literal 11739 zcmV<1EhN$(iwFn=1~6&>12Ql&G-+RRb!}}fXmo9C0PH^BOhl4RqyU$F~B@ zb+E1L=WlDM)(?W=p01BZqxz^_cfFo|b)nzTzM8bLxYPorW!((S+7TO^jd?S$9se++ zr{?bNF7Kd*j%aOy&7*_gGz}dLNPrP-p^IIuc4sUgF40^$UR zwO8kd#Oy(deso}4&R5j;NcXU&8@{jm!L3d3aOl_Ju7*5fAJ$lz-zOxfq2P8%4r>9q z33OJ04huC5j}Rxb!@wOn__|tFoZ z(SgqI=IEp6x;>kG#xNtdfn_B6(KJ3oK|lpO0Mqc>N8*@P_fraL-eKSM0wWBN1xyk3VGVGP_<9##)8hKj>B-^P z6a7Zx)yFWabilq(0$&gPk?Cu#&&}rN7K4fx0843Ii}HFA8f6Vc`!?Kb;@z|F%t=j+ z(Yf#3qO*5zuby0?x98_)h?R4>6}-urPz(#a_~lzjyxaP~awc(eb_=atZ`Yf3-?j$x zH14==;DbsUrW+v@2?qU(cNggQ*Y8e_U!%9je+p!>I*#$e7kO_vR!|7Bt$HKg<{+>F zn?TcFUb~&nt>p*keb})r16>mA8GYze=T+3nrIUI|r|^*y{`W!D$`#Qdq|<4pnYNl(3w7mi;ipF9w9y=V0U0z*T^ytYi<}2k6Maf zeuLm{>PR>Jajk2rfE4nt>XrPJJ@SChBv=igCQsd z>;(JYAN?BI_0Y!}XztIShaQMO@FFe1hT(c97_HP}t!KL(Y{zSfLS$R(XaSwV|93Xb zy2cRID24YN*CG4xz#&?nSiOF**Q{@l0Y!>Zmw0QmGk&RQFdLvJi7EPQ*2fR)S@qOH z1-1#@-2o0g%hA9F?zJ|PG_LbX6yfpQ+>I9V#`PMbLKEF}p?9r|2bO)iSG#mW&mia$+z<5LbI}LVsjZ_#={h>aw$<@q-p(x3 z4c5^W?z;oLjxJna8hC!?kxppzNr2v5t|K4XX+H6+ZX8DykXA83#P|_Bc>!T07NkOP z4q6@{9SqXf0Vt?R;lf85RwWvnK)eQhGrE1yWZYfqtVz$oNIP=fX@V*3V>h$w66+KeTT~rXrZXz=t6Y87P0<-^!O7b z+21DJfblT;o*&j2=fnV4go<@45TOFYrq#FpCVS0|1eqTFYFlId;)k69aYD@s1URWu z35H3A*bAUI04K&6qB}tpw6#g4l3GUn`QsJ*J=cFi{?NZgK#tJA-<+SlIz~^yr_#7E zw6=GjAynol&vo>Z=nwr{ZOFMRBL4n2TNtT4ihxOnH_z@K{n`n^?l^H1{rR&}%9Jy; zg=;3PAB3|-4J7i1*ooU2#B72n@tCS+C5ma-jP8s2MDv*bV%QDcVQ7Q1@WUdg*wr5w zNr#M906Qw6#qje8t-2B@7DsZ(LJF9MYJYG{p^IzFAU`;kHo=|)%j%WDvM7?c1M9_= zz>pzH*JsjKSY@B*C*%+Nd#DA~&hGZl1(p2$WS58kB^Oj;J%w!>VaJTEtAJPOx=LtP zW+DvNmjBAQmIyxcC|k_M5%J`<5*g%%qQxwQh+gs{-?c3hHHSB7t=k<(I_DX$B?sJW zBnK36@0^`Rc3t#`7zQzLQ4-#{JCC468|}x5$gXlJ`$(0byJYyXgN?5}&kY?@V`DBmnW!m`9+s#@PjtJ&0i*IfWAO zT_w+u3Z1fa42N`AG-z#RGE!_}=#22Wk$g10>l4YOjmJC&o0*0|>4Xvu?V=<8zz97L z)}MQOxEl~}9Tn*#a=!NZG*2x0LU+on^4K-o?*U6*7%&mOr*urjHB=_in(@pL5&`I~ zRz@Nq*^x{hq`+BgG+NCKEIhD`hF#YP{b}v^ZW-Ek&b+{#Y57AN-|ls6*Z7)_=f|@V zJfA01TpMFnV$8dh%BtnbEyRRyGeyREGAapNGV&B0&T*oGBN0nbl0l3L?Y7J;B=UHP z!9;(}oml3h)lQNmo`j=o0u}#eJfWoalz5U>)8ovJg827hIi4w#G8v{Mc6ZZi7J`bA zYjUql3`)){rN-cfoMi<0x=-rj)=t8Lq;w6?&USIIM`sFViJCES9aAx?;Eg9WrnFg| z?-CA1mN-9tPrwMKOKRzs(%S?%-xyn=l*UD($HZJ@HMgw)E7AiPABIx z6lk;A-ri~`&4nSPbWz-s#zxE7Xht4J={V(qjOn0h@rP*xq->hpbi(*+dp5%<$=%IX zQkKhtN*KrtgDouGf`(=0HSef0E>gzmBC!ykjjhbtkoG0b?Ii-Tgb9!%&oKu|c&ZEt z6xE+G5uEP3Lf@7=-V*4ojy@OPmq~J(ipfwx=@RLswHLzm6pSTI0ULHcepgq7Wq=@Z zMHzFzDV|)hN=_n{ptK5tBIGcNA9N zS_IwYuuGtMG;{&CraTQJV|0`0zOx9r%VC#5_h{&)nN^l&6wAEr^xC+zA(lW~KJL8g zJAb;iz?w}AO+%!JMJ)V2Hr){mpVB`KwsPb#n5>`%Xrm=4z@Qk1tMNqLbqbG_g|V@3}4}&u6c(pgWE{8(#)-I&RRHdaad= z;l=2owKBpj%~&o6n^x%WWe1ZuxAB^4oF3RLE^}Si8wiLsdYuWjxXA)A0~iqzA<(sWBE_-4LC#llU zN(@lI;kSdME|Sr*toh?*G5{A3k~bd50T5BOiFi)Ia;KS_PR z&&-Es&rc!NN86i^(S$KYGt2oxjDVOLP5pr!DzDf*2bm0>`ox9`&yq>s^s-~zt>yRu zwr%aU|3)+a^LE#|9(-$^+`er!|8gX_9`OMcc}HJ+W6aEQ-@GqQT}sByS$4=P$jmArG6$;@I7q!oF;41% zI$Ni<>l5?_s??6?-v>G$MzSdfL)_5Ud)3D8Ma~$?tsY~DT7st~LuYYwij~v93@H)Y zt5EzltN+BKDZ@-4FYCi#1d88gj~0KFCNduYn8X_N`0)i)Jp63=$UN79?ogw{(X&B( zosT!_ThPY8?$waz+Ux)kxCGXh!=CVA5vzWbnBR%i2<;RlSX7T6=(d%ECGs)#qPZFjX*qDBOf9;2 zP81>4EN0x8z4B^}nf*!GDirA{pc2%X)SIom@FhwkIThT^0DCfd^j<@@|l~c zdX~KxktC!>j8XEb$}qCh6rXp(Y{@C;xHnSvnb5bzA1eIt!|hxeKMN~%Jdo#(ki3|~ z{!OD4s4gV_jT_s{q(o9wl#PM&0>XgF@D|kgUwXEbkYqwZWyK9AfXgMh0K5$545g}W z9ZkcmD%B&f=3`4eNe18jd7&p31!MHU130=MJwOw@*}z4A!a6>(D07*RWuOM^XZbXF zq{EZYvjU5#m-T)yn2Pxe%b^P)kl6PgAkHLl6|sl49R2gvGIjW4nKv^rKQ}|3cLUrn zh|k{a^j8=4!1|jwn&r@dHjg`r9SW2XYd!Z`v&l8F{i!s0&8pC~`XwC-{Z2zj4o!Hj zDq(sN20C4=f%*;koNI2k3)Jy)iHM2d;knJiYUmwp2of`aBn8yA9@_Jo9p>wnZ>lC) zs#XQfQ6ZQZT=(Ka2AA~VgxvXBFSJZ@AJG+E%;d&XQ62qGt5bu;MfFnbM_N@u?b8q~ zzGWJ0CJ|op%IMWt-K{F#*980y?63=(`{8zICIuAC5nQ1^MK`NT29~2R0zGg?jwWtq z%L1>5FaoK#ML>otXpUZDdy;ZqG96%bJxmdT7LG_qKZSq!A+E}09s9$ZsYKxQM8Mq} z(u@E>XE?we?3d)o{*WfET}6|2yd0Z0_gaINYJE5Ki57sy$|#vByxeTPq%A;fp+z-C zb~+*0W(Rh4?FKX_sW{-Y2>eTJWCeZAw0zvL?0k!|KUqUW8=^C%;VM#yIpNe*Vg7eG zpcJvOLld}p^gC-&uAP4X-84`AymcA2>}u)xm)xHB!-S!eacE_mZsAz;nc7D=Vd!9# zO7Bml-NaDzb}|&L?Duasi-x5YswshKg${|BwDKg9$(0E*)47-@$h@r3amsm7x2G!@ zsGD6H3HI1rPBeL@vs1_cV}RX%{hm08U~a1hZFFp!uwL`23h07;a{>#4nZDJAp4;>A zV5W6D=Iz02kF}?PSlYe{#y&->0raHN^@ep#{Q0RS8b%j0X%yQsgpNhCDv)LYQQACl zAJr9-F`tzrhdUTpe(E}hOBmIy0@_SK2Ed--pb!b<_Bf6AkyVz9B+)jzH>^#PG(XxB zUVRa(g3I`g)mX(FB3zWZ$-#2t%2g1<;>-5vN(1L!sdwt z;tcu*{WCiV9}R)VTDb}onHOPOd`T<1n2GvpQLz#XFfY3Nl~Z|GL*jNO>f&o-7rgpP zL}PfPd)k>QhKn~>!_EMQ`M_U2n(z;eCN&bB#4{F{fTgU5CmdAFL| z1sA?5(PMO_~>wcvMasFKZQOogF&g{vFtX~C+ z{2)oB!UidC?Fyt3mYzY#ZB3W5k)0kLRycF;mVN+-9#DRMU266KM2pCmF0!%$JIMnL z+gqh=S*HY1k^%`76Nv%#l$&h+disN?IZ0MJVXOThzsCs-;mZtRQ{^q4=^e*;zU7~Vl-fV zBy$IGy3bxuuvE(hK!W`WIgmq{L8ANEicyDmVL9JIYYs}hlJ!?&1;5Ds6ifGoaz~4o z;tPqmP+@oILbfl*4eElEfB%>HGCd=CZcn?Ymn1`IV@F9KpKy?pv9r0{B8C_>;kg_c zMy>^TQRR6?#hsV39HL~uxt$^@8b!^=Vtu3SNg`VmUIz31O`f2dM(q~MU*iZ+^+cft z`viN!B!VcKR?iBs9qk}Uise+>cg7oMZ6wIMFn$2a#5Y;wCQiZq7i%yq4C%~rEtw*F zgB{!>gVJ6IyFcYh&3=H<8tHgAB-o~#d9h{^$HMlUNfC6+dMJy#3iwyNS%GByg8Z_| z_*%I$Cd)ZMK}mWPKSd$dNl9K8D2sCTuBJS%!rqojEcGM>HF1h%aVa(r zKb^1S!O0c%z;==wbonWw{H(U+x*FqcFF?nfHuMzRz@6CpKsx$+@B)1O4QP=52SUEe zN3-8nlUrxd8IXv&G)T6sibKKZqwds{TQnJ|O7zCWkp*!@c8_hKC{w>xftusZNE2z; zthbBMknUBQi+=G9#hF`}X3%j7PTX8gmY{!&zlpzK1$U!>gy`?>U zYZE#XV5RmrRbBC*d3DcXvjDldb-_!{+&RjnEIH+8j9^t!bisKUby3b@)3wMxs(pXJ>cm4vl(_k)l}2 zTQOC1$6%R6R9>u6816@V*RUjNu>&?Vv57i{VhLx z6liHOaIC*er;$U>@GT7por7ud9Bk(&8MH;v7+o^h{;nR;TpaZMh3GN$I9oYrMpLZWponv7kPBu;q+c8!k=-g3})&FLqnj*nh@!NIMRD&r~b zg-~!I`E;H@M;Ij%>u0R_@)^8@De1YcsR2n@glWDB$vj1nG9Wd?r^E}aE{!h{U%h!p zS8gxB#>`eLY8TYZ{0^YfQ$`u6mEvo$hlsm1LmNBJ+{Db0Ur+|oGe^v|=T^2t??tPU zHX+|HzE`n`U81ZK0le)>2k_+guxo|mcdw%!N{Zi+YvPo*Tcl9HPEth)*hw@K0Xtc| zq5(Tb>z_M9*vH=_A6GLz*K8~=KzIK@n+bDz>xSA_#~sCPX4<|p;J?4z5dAMy{#T{E z2cG@ERT!tpx#iIo0_9TkzmmY{=R88?cJjv&t3W2YSsD}9c6;|A6?LTWxFbCvfGkyD zK}e6jo8#nj1)TABJJ=cMSG-S|RK4U~m-VvO!|lRl?e3!itGXYf**IBpl7ca(qSt<= zASRq<*Q)YycB^7W=l>`X`_{}NzfAOyyFse9xU9r#a;MU(N!)S6p!ibqm^Md$l(rRw z#cs-3O70Y0N-~lt>qv=XVjU@qS92Z737y>fA=i=h&7ZqJxMWn+uPW^DG2kBj5H#ic zYxMNRynDBKx)Z&2E4Ify9|_>zz#hr-#ko^nZ?*7KUNfblqJ_~%o!~O}r=0#+S*(59 z7!PNA|GZu${JDxbXo<2s@0CtPKii@bU`rFcGL$ZgG_H)NV&iMib3@0}_&3P|`i-?A zh$s63`g8!N!1bFp^M@|ak1tMNo*ZAG*_GjUG<#HeYJ|_W3DgicVPt$4-_pyzDb}@! zZB9e;pzkR?YJIP!&z$cAy3s{#MeieucWoC3d+arh$lc^GZ6rTy0r%?X=x2X__`q_8 z;GzY$Ll}pCRv!FZDWQR8@=X_-0E*R(ppvf_uuo|q2OO+vbenCA4|Iz3^f#iV^h~UA z;2WMbR1wm@;A_lFr^E2H8#>JYdpcS-*Ms$N-C6h7$+NrB$0wH~t4q6l*ZBfI;*(E@ z&i?45^XZWO_0K<1!)JF>2cWg<-wydd|NQgu)3f?8^!ra?{z7_ufd6d&`@Vl@)(ww< zHa)l5p#o2XXZzE-CD5Qp0#VyPxxK=@w=f&f?qlQAzF)`wtz#TE;fi|t;XbKzVSVeG zq;5Gr@q!Zqv?os~x>Lvc{_N=pR^u*E$Tb+u>rXgspR7O8br?Yq$}pX};SO}@{{Py0 z&i2HSq(A##^l-ZqZVf1a4W6;@2m<2;Y;ySGM+p!X5+eyPe((PK+d&c%2qA1H?JW}k z(Nb4e?(XU;i&xd;l1Z9YVrs%>kEZnj^%B+(Z1eGheJ{LaJ*mZ|yLwhx&b~7Fb)BIH z8obOTs08&P3}R?dFmy+mgV$=X@Lvz+VVXGu3W4SrEZ;3I6Fu=J|Fl8pjy${#;L zfs*9s`_adkn>iiTv5b8JH`jmy|M?GyatnzVBHGls_Y?R(Jj`U0SE0zFt`Y0QE5Ch= z{loFOAOQv5h<$>v^Ada_L{J?jCo{9vWsL#6(!hw&aaXG^LBOTIg+(Cm@|7MZXSN{5j6*MXm!y308lIwK)Ojd zJ^>vHe~-?Pe~LP4_c;0~Ov)aDIAbW(TM@w$q2foZf{w>KIWM7Vcnf@PA&em4{);|& zrZ=uny!CA48e@;$IYJL->PrBB0car-rAEfH2r?%i%Mc{A|2j6;O*q@y;s2p_&6uE#*bZD5aXSIjd5? zvl3aiN8Qi?3rbgDHBl^_Rm;0f1v{+E)~zB*B!<$rXfYv|?FER($8Lq|wc5EhN4oM| zAP_?*lzS+yI@M~MqiZi*x;|~BYVE`+BLV%D0VDnJX=%@?k3y=hUKm~=uIZWa`P!S zHXn-5gTn2KE9HxoRc+dQ8s;hxrc5t4$>j5mNljqx6uGCqNT~g!=C*INxp9{%nS$1( zDy2Fl&bq2pSdHtqO})YmO@Ya-tA*USG0Vbxvx{mWUvIQl<65!uTq};p-EIwzDl@LP zbE#^3{9IS4ms-1%LSreBF^+QO2^ss!{@&CR8}F*>N?-g zqh}25XXNp?$JVIQQQ`CHqQJs?a+Q2(+#s|W58yk3vmqC#^hBDe+MwT5yZt*e-)a8Q zFV$(GM^8lUX));6S8_4?BKPaep!ZA<+cY!iWFH#SW~zN#d9JhF2Z3vLn!RqSTh8Wt zT=%8huF#F%{AH-#-3q-@yTM52@HSt6Xu@$dhrMAhO^KM+^%sGu&r#pvdNpoy&kclA z4-Tt$MUJVjS1OA+DQn9AgggAcx)^dKad-=jsdk=kke*SA=hfBh0tC z@rFkV>&A0^Dw?&IMyfjPtPmWx8#u-`Eg`?=Rfuy)lgUI}=anI(N2T0^{9QK%wyq8f zY1H4;?k_j=&^4dW6!U!x;`dG+(nD3$>T`ifZ}_&5o``Hd^}yECB0HQ2w_Ww2Kb*9w zY@vQTsfkmLl{#6oS!$Ms{Ygil^Ht$ix@h0dsaC10wAxU{IF%Fo&01&LWg7G(-ziCK zhncgz8TH)mqz7H*c~WIWwyUbeMte+m%IRTe)=AwLhrOCA8LeWTeP~l?%%fH>J%>Ct z5iq|=bCGSXA*~?Hsd24cv1&!ms!en28Ut~vJlVL+YY2CLt~PQ3@nJdm;Gt}mb6n}q zUY!z(xz!z4hdkVbIBhnBa%np3Ks``~{4nL7n(Ww{k`$qk@T zH0SsXNTYE?*<~gzAf_T9ho-3CgD`2KgUXBWcNOjTKUQXA+Kxv-fx`)a_ap(1LfqZ8pf=gfA@^Yx^6t}kh6XI;Rrnh625NO9$RnJFtdq z0~m@*11Qo!(=EU+c}2y;(lvB8EwQzP{zWjr_WoJWHUBqf=NzS$a#`2)fZa{(2>bKE zf&wQ)mUp!g$Bys!G&V({%`EY8_HgN4BNijuLHy04OhK#lWO%Gzwmb+r1hX`xntOT3q z_D5|DP`P!qLU4|s1#zdqS%RvdU8RIS79W&lO*VKHRQVM^D}#z5BM8<2)qaEj8~Rc~ zqXG~~hHUW)K4r9l#qHBMe!F268KPCw7Es*R1P}su(AcaMihbcRTP1vgw@-SvHJq+) z3q^Dq4fF+?Ma}TG8)oPg$@6gaUK7mu*0z+(bZCv((yt%}{=F4AvBPYRT<4+Htt#4+ z8N0EOF_L8o*$BjmVZ(-RNVp=lIf;eZ)+CmzNr>%&_B%%Uk8G^`RNK}DkwJF*cY)mP z)DKi(p0fS^!Zu4e29$~24@VyD^BYt_b&}L*7TP)A3}d4f zp!S)o{Q644Rw^#2y7=^&^qz%A9THfxCOTArIm4Pjy^s?mS>-3ZWXCkU9s9@Pe;>j3 zqV+JQswkp^z3_F@+_vvmZWLD-0pCKc0qo^fG-4e6|w`&krG?UsQ6EgzAi4fgeW^Tg%yy97`Jt(S`;+ zUey*BXjz6VTjwBUO+ZQ2b>kd>ylz^$b`EN}b3idPl>wa=07;OhGVu(35ohUi=G8>q zH*oaY@(DaHjUR!L-5Y1E;h={Q6l51}uLF`v2G05RkIysCh$8S-jO?s3g!xQ|K#znT zZ|8^NS@$vhTvH2p0)w*l;k}S=6Wm2W_s-4(m}wKU>6{VaSoG%rKB)*{oPkR^3_hN; zy-qPxBuRDMbi#bwu6pF-Ser$ndE|J#!xpo>cpA8h9I2Zl5SW{xc{_C8@cZ{bL244wKGJ z%~7*F<6DKXD$Q%xv70W0$5?}$Y3ibalGUAqYW2atOnA)eyNJ9^=Uv(MDueGL=a4)% zztI<$=WHsINK>yD_hSm$N0)cp{HWICj;L#d`(Cf(9n$w}HOk2?eK2_6PRj)M7h>S( zpxwb!^oo0qC=2c74pb)>29~BHkXc)uWe52jYc4nPFy@>hs z9C8XMItl-JHV}RqDf$)hyQRVqf`2l!{=&NHhj?q>TW@*2wUaq!j*rZqNLYg6Kwbsh z+gbV-vX*~|<&sUT%OUajnbt&h!=XawfkyakX9Mkje1Gh~F8JHF zy|*^efArQI(J*F&jk%LdNh8SE4-+xp$WRo^n`TE5;(jtgku^apWQa(TVl50ene9nM za|;1)+B}Oe>`R}ndBu*|_tZGyI)$`2N=3gk6^-^K#*n4IUOKNiKq-0f!7Z3SvZfq#wz))p28*_YlOl^`#r40cQ+AxwBs>0 zA%bFLBH9CA@Gc34k8T&fHACYT0Y|TVzlVAyye6X{)UIrxLsvm_One?Lg3A*2I)H*m z$w9wFPmR7m6aWPPc!#@h-+$A_3BidH0`Tysx_YU;ShpRak`>fS@vBvBrk90&?xDA8 zO;^JiU90zdDxVx*b_a!ACjFodnsO#{(Pes1x76zTI(Adh6ib1#YTt=6nu$|%oS_&t zTHHW{T&)L^k{-6j(c@H4s*ECPkRVGKd80i_+;$P`g4a#uPNx@67KMBO;=c{yU)2!O z5e;E+bJ(+q4}1PatznU_p1>M@aS|{%T5^jG_kmD0r0xoWu-pP+d#}g&@Y%_G*Mpv zba%5QAVY+cdSjCg{L0Sojn@o6e)=4gYNLRDgBnXQaqdb|l_U%q2T2$@t4O+b>}=11 zASsYQw9UKXeW5*g;DDVM{R?^rDvz+~uQZLFP+uhpl5|K!l`)~eZB3j!NMx_o#x=jN z^nffM{}_!%pLZT_BX6XmJl%0qp7RE8>D!#(dwvQhVA}WmAkFFR$&|%7=`C<(7uYh6 za-NaOReKM7`%2XK?~L8_6jfFD87LXNCPJ<#^XgIwKO430fdq~Ay0YIQkG`OUX4F*2&?Ig%bu=4CPo|&1-i+n}n$tV6k;%ADw zzG}&1T|NgN@H^;KKETgKdCGSepv7w@`r0;RVIfXr3)EWhJ9JkhUgO~pCTsxN#85^b zVj!TR&{)^Us*Ed0%;3Z$IY$~d>0;#%ee?%T4VL_Oib=5PEX7jHdHj-2P#1KDN;Btl zCP8Ihk|=-D^*eS(ze}6cb0#aZmsD0@X(62vQt2z|S;&fficiZTMNuO`7T=|2Y1lsX zj&|E;F6C_MQlRKd*gi#3mlTz{phs+mWwM!fnHlqrl?W8+Y%2RMB@s9nI?H6CF1y!c z=*&!ng@I}lV$*^BoM38g&d=MyDdZGA);;_0`ZD)W@w?EBkj#?RD>|N`s5qNt;ulnw zirx6X9|HVG^PVpy6O`$lluS1P7l|d9@7?#YB`(n7?yFz3M`ek+rpe;|1Qnro;YxU@ zFm-VCM;h0vw99hsFb_k!NcS$y5aVmtG(>6Q&_Bv9Y4{n}EJIyGivksur*K(F^v13M zQQ!c~Amec`Ai{SGdjZYOuE`^xZCv1tUMX)OPZDGlCv}aGTzQIR;W>#KcMFSpzQ^OZ zUd`CxXWRJRt<_{xAWmv0?dm`GQCJ09?kiT_wzmn%$CNu^nh$Q7tH%E`u1EnWz9SREUb8sEV}?b-sR#A&XYc z5RZk_GDHU$NXkX1@Fc}9y~#UsKF4_5Z@=hxeN>C%Hs}}!!9dRYBWO84dXTW+{DocH z`Hqs;*Ey~TO7~4ry)Wddpq}g6Y3uEhPreey5K!@H&Rdg&0L=;7)to!!$lMFbRDw;= z$*H-yl$a@6Vrt@fyOUMlu6E^iU#{Ng_xA79NnV&M$&53PH2uh+9`N^|r@KY1&fJxv zvyD`p;lJTUt?Z5;E1C%1B0a2 literal 0 HcmV?d00001 diff --git a/lobbying-scraper/tests/test_portal_parser.py b/lobbying-scraper/tests/test_portal_parser.py new file mode 100644 index 000000000..03f73aaee --- /dev/null +++ b/lobbying-scraper/tests/test_portal_parser.py @@ -0,0 +1,172 @@ +"""Regression tests for the MA SoS lobbying disclosure parser. + +The portal HTML has four distinct format eras; the parser is the most likely +thing to silently break when the portal changes its markup. These tests parse +committed fixture pages (one per era, employer + individual) and assert known- +correct compensation totals, client/bill counts, era detection, and specific +bug fixes (the "Total amount" summary-row artifact; the "H73;" semicolon bill +separator; hybrid-era Panel1 compensation). + +Fixtures: tests/fixtures/*.html.gz (gzipped real disclosure + summary pages). +""" + +import gzip +import sys +from pathlib import Path + +import pytest +from bs4 import BeautifulSoup + +sys.path.insert(0, str(Path(__file__).parent.parent)) + +from portal import ( + _parse_amount, + parse_disclosure_detail, + parse_summary, + year_to_general_court, +) + +FIXTURES = Path(__file__).parent / "fixtures" + + +def _soup(name: str) -> BeautifulSoup: + with gzip.open(FIXTURES / f"{name}.html.gz", "rt", encoding="utf-8") as fh: + return BeautifulSoup(fh.read(), "html.parser") + + +def _comp_total(detail) -> float: + return sum(c.amount for c in detail.compensation if c.amount) + + +# ── Disclosure parsing ──────────────────────────────────────────────────────── + +# (fixture, year, expected_comp, n_clients, n_bills, era_label) +DISCLOSURE_CASES = [ + ("2007e", 2007, 112_500.00, 1, 2, "legacy 2005-2008: entity total under _total_salary_"), + ("2011e", 2011, 641_243.00, 23, 4, "legacy 2009-2013: per-client Compensation received column"), + ("2016e", 2016, 990_474.00, 30, 1357, "hybrid 2014-2018: Panel1 div totals"), + ("2024e", 2024, 115_000.00, 5, 22, "modern 2019+: grdvClientPaidToEntity"), + ("2024i", 2024, 1_095_200.0, 17, 135, "modern 2019+ individual"), + ("2011i", 2011, 18_518.00, 1, 0, "legacy 2009-2013 individual"), +] + + +@pytest.mark.parametrize("fix,year,exp_comp,n_clients,n_bills,era", DISCLOSURE_CASES) +def test_compensation_total_and_counts(fix, year, exp_comp, n_clients, n_bills, era): + detail = parse_disclosure_detail(_soup(f"{fix}_disc"), year) + assert _comp_total(detail) == pytest.approx(exp_comp, abs=1.0), f"{fix} ({era}) comp total" + assert len(detail.compensation) == n_clients, f"{fix} ({era}) client count" + assert len(detail.bills) == n_bills, f"{fix} ({era}) bill count" + + +@pytest.mark.parametrize("fix,year,_c,_n,_b,_e", DISCLOSURE_CASES) +def test_no_total_amount_artifact(fix, year, _c, _n, _b, _e): + """The legacy individual summary row (client_name == 'Total amount') must + never be captured as a real client — that bug inflated 2010-2013 comp rows.""" + detail = parse_disclosure_detail(_soup(f"{fix}_disc"), year) + bad = [ + c for c in detail.compensation + if c.client_name in ("Total amount", "Total", "") + ] + assert not bad, f"{fix} produced summary-row artifacts: {bad}" + + +def test_legacy_2007_uses_total_salary_placeholder(): + """2005-2008 has no per-client comp column; comp falls back to the entity + salary total stored under the _total_salary_ placeholder client.""" + detail = parse_disclosure_detail(_soup("2007e_disc"), 2007) + assert [c.client_name for c in detail.compensation] == ["_total_salary_"] + + +def test_legacy_2011_is_per_client_not_placeholder(): + """2009-2013 has a per-client 'Compensation received' column, so comp is + stored under real client names — never the _total_salary_ placeholder.""" + detail = parse_disclosure_detail(_soup("2011e_disc"), 2011) + names = [c.client_name for c in detail.compensation] + assert "_total_salary_" not in names + assert len(names) == len(set(names)), "per-client compensation should be deduplicated" + + +def test_hybrid_2016_has_nonzero_compensation(): + """2014-2018 compensation comes from Panel1 divs; was silently $0 before fix.""" + detail = parse_disclosure_detail(_soup("2016e_disc"), 2016) + assert _comp_total(detail) == pytest.approx(990_474.00, abs=1.0) + assert len(detail.compensation) == 30 + + +def test_semicolon_bill_separator_parsed(): + """Legacy bill tokens may use 'H73; Title' (semicolon separator) instead of + a space; the bill number must still be parsed correctly.""" + detail = parse_disclosure_detail(_soup("2011e_disc"), 2011) + house_numbers = {b.raw_bill_number for b in detail.bills if b.chamber == "House Bill"} + assert "73" in house_numbers, "H73 (semicolon-separated) should be parsed" + + +def test_modern_individual_per_client_comp(): + """Modern individual registrants report per-client compensation in + grdvClientPaidToEntity — verify it is captured.""" + detail = parse_disclosure_detail(_soup("2024i_disc"), 2024) + assert _comp_total(detail) > 0 + assert all( + c.client_name not in ("Total amount", "") for c in detail.compensation + ) + + +# ── Summary page parsing ────────────────────────────────────────────────────── + +# (fixture, entity_name, year, reg_type, n_disc_urls) +SUMMARY_CASES = [ + ("2007e_summ", "Ventry Associates, LLP", 2007, "Employer", 2), + ("2011e_summ", "ML Strategies, LLC", 2011, "Employer", 7), + ("2024e_summ", "21c, LLC", 2024, "Employer", 2), + ("2024i_summ", "Anthony Arthur Abdelahad", 2024, "Lobbyist", 2), + ("2011i_summ", "Aaron Judd Agulnek", 2011, "Lobbyist", 4), +] + + +@pytest.mark.parametrize("fix,name,year,reg_type,n_urls", SUMMARY_CASES) +def test_summary_metadata(fix, name, year, reg_type, n_urls): + meta = parse_summary(_soup(fix)) + assert meta.entity_name == name + assert meta.year == year + assert meta.reg_type == reg_type + assert len(meta.disclosure_urls) == n_urls + assert all("CompleteDisclosure" in u for u in meta.disclosure_urls) + + +# ── Helper functions ────────────────────────────────────────────────────────── + +def test_parse_amount(): + assert _parse_amount("$1,234.56") == 1234.56 + assert _parse_amount("$0.00") == 0.0 + assert _parse_amount("") is None + assert _parse_amount("N/A") is None + + +def test_year_to_general_court(): + assert year_to_general_court(2003) == 183 + assert year_to_general_court(2004) == 183 + assert year_to_general_court(2005) == 184 + assert year_to_general_court(2023) == 193 + assert year_to_general_court(2025) == 194 + + +# ── Bill ID construction ────────────────────────────────────────────────────── + +def test_bill_ids_in_modern_disclosure(): + """Verify bill_id is correctly constructed for each chamber prefix.""" + detail = parse_disclosure_detail(_soup("2024e_disc"), 2024) + house = [b for b in detail.bills if b.chamber == "House Bill"] + senate = [b for b in detail.bills if b.chamber == "Senate Bill"] + if house: + assert all(b.bill_id and b.bill_id.startswith("H") for b in house) + if senate: + assert all(b.bill_id and b.bill_id.startswith("S") for b in senate) + + +def test_executive_rows_have_null_bill_id(): + """Executive chamber rows must produce null billId so no accidental bill join occurs.""" + detail = parse_disclosure_detail(_soup("2024i_disc"), 2024) + executive = [b for b in detail.bills if b.chamber == "Executive"] + if executive: + assert all(b.bill_id is None for b in executive) From b66576aa506faeae9aa6272572bab481077b7c95 Mon Sep 17 00:00:00 2001 From: Nathan Date: Sun, 28 Jun 2026 20:56:45 -0400 Subject: [PATCH 6/8] fix: Firestore write path bugs found during dev write test MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - writer.py: move firestore import out of TYPE_CHECKING block so firestore.ArrayUnion() is available at runtime (was NameError) - writer.py/scrape.py/reparse_archive.py: strip leading slash from Firestore path constants (SCRAPER_DOC, BACKFILL_DOC, REPARSE_DOC) — db.document('/scrapers/x') raises ValueError: odd path element count - scrape.py: add os import; pass GOOGLE_CLOUD_PROJECT to firestore.Client() so local runs target the correct project rather than the ADC default Verified: 3 registrants / 6 disclosures written to digital-testimony-dev; re-run writes 0 (cursor working). Co-Authored-By: Claude Sonnet 4.6 --- lobbying-scraper/reparse_archive.py | 2 +- lobbying-scraper/scrape.py | 4 +++- lobbying-scraper/writer.py | 9 +++------ 3 files changed, 7 insertions(+), 8 deletions(-) diff --git a/lobbying-scraper/reparse_archive.py b/lobbying-scraper/reparse_archive.py index 32f4b1563..266ff1ad6 100644 --- a/lobbying-scraper/reparse_archive.py +++ b/lobbying-scraper/reparse_archive.py @@ -29,7 +29,7 @@ from portal import DisclosureMeta, parse_disclosure_detail, year_from_disc_url from writer import REGISTRANTS_COLLECTION, write_filings -REPARSE_DOC = "/scrapers/lobbyingReparse" +REPARSE_DOC = "scrapers/lobbyingReparse" def _meta_for_disc_url(db: firestore.Client, disc_url: str) -> DisclosureMeta | None: diff --git a/lobbying-scraper/scrape.py b/lobbying-scraper/scrape.py index fb985e05f..657c59603 100644 --- a/lobbying-scraper/scrape.py +++ b/lobbying-scraper/scrape.py @@ -22,6 +22,7 @@ import argparse import hashlib import json +import os import sys from datetime import datetime, timezone @@ -249,7 +250,8 @@ def main() -> None: else: years = list(range(FIRST_YEAR, current_year + 1)) - db = firestore.Client() if not args.dry_run else None + project = os.environ.get("GOOGLE_CLOUD_PROJECT") + db = firestore.Client(project=project) if not args.dry_run else None if args.mode == "weekly": n = run_weekly(db, years, limit=args.limit, dry_run=args.dry_run) diff --git a/lobbying-scraper/writer.py b/lobbying-scraper/writer.py index a6804f401..d49d12424 100644 --- a/lobbying-scraper/writer.py +++ b/lobbying-scraper/writer.py @@ -7,8 +7,8 @@ from __future__ import annotations from datetime import datetime, timezone -from typing import TYPE_CHECKING +from google.cloud import firestore from normalize import normalize_entity_name from portal import ( BillActivity, @@ -20,13 +20,10 @@ year_to_general_court, ) -if TYPE_CHECKING: - from google.cloud import firestore - REGISTRANTS_COLLECTION = "lobbyingRegistrants" FILINGS_COLLECTION = "lobbyingFilings" -SCRAPER_DOC = "/scrapers/lobbying" -BACKFILL_DOC = "/scrapers/lobbyingBackfill" +SCRAPER_DOC = "scrapers/lobbying" +BACKFILL_DOC = "scrapers/lobbyingBackfill" BACKFILL_URLS_COLLECTION = "processedUrls" From 6129130329e78e2a82d10486355f63b04e46afbf Mon Sep 17 00:00:00 2001 From: Nathan Date: Mon, 29 Jun 2026 17:04:51 -0400 Subject: [PATCH 7/8] docs: update lobbying ingestion doc to reflect Python scraper and all 4 HTML eras MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Replace TypeScript/ts-node test plan steps with Python equivalents - Document all 4 CompleteDisclosure HTML format eras (2005-2008, 2009-2013, 2014-2018, 2019+) including parser behavior and known quirks - Update Historical Backfill section with GOOGLE_CLOUD_PROJECT and ARCHIVE_RAW=1; remove local environment references - Add partial backfill pattern (--limit 50 across all years) as large-scale dev validation step - Remove stale Function Export section referencing deleted scrapeLobbying function - Update Step 8 (deploy) from Firebase Function commands to Cloud Run job commands - Fix cursor path prose to remove leading slashes; fix jsdom → beautifulsoup4 Co-Authored-By: Claude Sonnet 4.6 --- docs/lobbying-disclosure-ingestion.md | 261 +++++++++++++------------- 1 file changed, 129 insertions(+), 132 deletions(-) diff --git a/docs/lobbying-disclosure-ingestion.md b/docs/lobbying-disclosure-ingestion.md index 862947cd0..2a2e61bf0 100644 --- a/docs/lobbying-disclosure-ingestion.md +++ b/docs/lobbying-disclosure-ingestion.md @@ -257,7 +257,7 @@ in `functions/src/lobbying/types.ts`. (one POST), compares disc URLs against the Firestore cursor, and **exits immediately if nothing is new** (fast path, typically seconds) - When new or updated disclosures are found, fetches and processes them -- Persists a cursor in `/scrapers/lobbying`: +- Persists a cursor in `scrapers/lobbying`: - `processedDiscUrls: string[]` — disc URLs already written; skipped on re-runs - `summaryDiscCache: {[summaryUrl]: string[]}` — maps summary page URLs to @@ -282,15 +282,29 @@ New filings arrive twice a year (semi-annual reporting periods). Between periods, the run completes in under a minute. The backfill script (`--mode backfill`) uses a separate subcollection cursor at -`/scrapers/lobbyingBackfill/processedUrls/{urlHash}` so it does not interfere +`scrapers/lobbyingBackfill/processedUrls/{urlHash}` so it does not interfere with the live scraper state. -### Legacy Format (pre-2013) +### Portal HTML format eras -The portal uses a different HTML layout for filings before ~2013: total salary -is not broken down by client, and all bill activity is in a single table. These -are stored with `clientName: "_total_salary_"` so callers can detect and filter -them. No bill-level compensation amount is available for these years. +The `CompleteDisclosure.aspx` page has changed layout several times. The parser +handles all four eras: + +| Era | Years | Compensation source | Notes | +| -------- | ------------ | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------- | +| Modern | 2019–present | `grdvClientPaidToEntity` grid | Per-client rows; both employer and individual registrant variants | +| Hybrid | 2014–2018 | `Panel1_N` div blocks | Compensation in collapsible panels; bill activity in a separate grid | +| Legacy B | 2009–2013 | "Compensation received" column in bill-activity table | Per-client amounts; deduplication required (same (client, amount) pair can appear in multiple rows) | +| Legacy A | 2005–2008 | `grdvSalaryPaid` entity-total row | No per-client breakdown; stored under sentinel `clientName: "_total_salary_"` | + +Pre-2009 **individual** lobbyist summary pages link to `RegVersionLobbyist.aspx` +rather than `CompleteDisclosure.aspx`. These produce no disclosure detail and are +skipped — expected portal behavior. Employer/entity registrants use +`CompleteDisclosure.aspx` correctly across all years. + +For Legacy A filings (2005–2008), `clientName: "_total_salary_"` signals to +callers that per-client compensation is unavailable. No bill-level compensation +amount is available for these years. --- @@ -363,22 +377,30 @@ gcloud scheduler jobs create http maple-lobbying-weekly \ ## Historical Backfill Runs `scrape.py --mode backfill` directly. Resumable — the subcollection -cursor at `/scrapers/lobbyingBackfill/processedUrls` tracks progress. -Requires `lobbying-scraper/` deps or the `maple-2025` conda environment. +cursor at `scrapers/lobbyingBackfill/processedUrls` tracks progress. + +Always set `ARCHIVE_RAW=1` for real runs so every fetched page is preserved +for offline reparsing. Create the GCS archive bucket first if it does not +exist (see Step 7 of the test plan). ```bash cd lobbying-scraper # Test a single year with no writes -GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ +GOOGLE_CLOUD_PROJECT=digital-testimony-dev \ + GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ python3 scrape.py --mode backfill --year 2024 --limit 3 --dry-run -# Run a single year for real -GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ +# Run a single year for real (with archiving) +GOOGLE_CLOUD_PROJECT=digital-testimony-dev \ + GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + ARCHIVE_RAW=1 \ python3 scrape.py --mode backfill --year 2024 -# Full history (2005-present, resumable) -GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ +# Full history (2005–present, resumable, with archiving) +GOOGLE_CLOUD_PROJECT=digital-testimony-dev \ + GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + ARCHIVE_RAW=1 \ python3 scrape.py --mode backfill ``` @@ -412,16 +434,6 @@ Note: bill-join queries should always filter on `chamber` (or check --- -## Function Export - -Add to `functions/src/index.ts`: - -```typescript -export { scrapeLobbying } from "./lobbying" -``` - ---- - ## Implementation Status | File | Status | Notes | @@ -498,111 +510,58 @@ Testing proceeds from the inside out: unit logic first, then live portal fetches against the real site, then a small Firestore write, then a full backfill year, then steady-state function operation. -### Step 1 — Unit test: normalization +### Step 1 — Unit tests: parser, normalization, bill construction -Run the normalization pipeline against known inputs and verify the outputs match -the reference implementation. +Run the pytest suite against all 4 HTML format eras using committed fixture +pages: ```bash -# In a Node REPL or ts-node session: -conda run -n maple-2025 ts-node -P tsconfig.script.json -e " -const { normalizeEntityName } = require('./functions/src/lobbying/normalize') -console.log(normalizeEntityName('Acme Corp., Inc. d/b/a Acme Consulting')) -// Expected: 'ACME' -console.log(normalizeEntityName('LAN-TEL COMMUNICATIONS, INC.')) -// Expected: 'LAN TEL COMMUNICATIONS' -console.log(normalizeEntityName('Law Office of Jane Smith, LLC')) -// Expected: 'JANE SMITH' -" -``` - -### Step 2 — Unit test: chamber normalization and billId construction - -```bash -conda run -n maple-2025 ts-node -P tsconfig.script.json -e " -const { normalizeChamber, constructBillId } = require('./functions/src/lobbying/portal') -console.log(normalizeChamber('HB')) // House Bill -console.log(normalizeChamber('SB')) // Senate Bill -console.log(normalizeChamber('Executive')) // Executive -console.log(normalizeChamber('FY2024')) // Other -console.log(constructBillId('House Bill', '1234')) // H1234 -console.log(constructBillId('Senate Bill', '567')) // S567 -console.log(constructBillId('House Docket', '89')) // HD89 -console.log(constructBillId('Executive', 'EOEEA')) // null -" -``` - -### Step 3 — Live portal fetch: summary links - -Verify the portal is reachable and returns results for the current year. Use -`--limit 1` to minimize requests. - -```bash -conda run -n maple-2025 ts-node -P tsconfig.script.json -e " -const { makePortalClient, fetchSummaryLinks } = require('./functions/src/lobbying/portal') -const client = makePortalClient() -fetchSummaryLinks(client, 2024).then(urls => { - console.log('Summary links for 2024:', urls.length) - console.log('First URL:', urls[0]) -}).catch(console.error) -" +cd lobbying-scraper +python -m pytest tests/ -v ``` -Expected: ~400–600 URLs, each containing `Summary.aspx`. +Expected: 26 tests pass. Covers compensation totals and client/bill counts for +all eras (2007, 2011, 2016, 2024 — employer and individual), normalization edge +cases, bill ID construction, and specific bug regressions (semicolon bill +separator, "Total amount" artifact row, null billId for executive rows). -### Step 4 — Live portal fetch: summary meta + one disclosure +### Step 2 — Live portal fetch: dry run -Pick the first summary URL from Step 3 and fetch its meta and first disclosure. +Verify the portal is reachable and the parser returns valid data without writing +to Firestore: ```bash -conda run -n maple-2025 ts-node -P tsconfig.script.json -e " -const { makePortalClient, fetchSummaryLinks, fetchDisclosureMeta, fetchDisclosureDetail } = require('./functions/src/lobbying/portal') -async function main() { - const client = makePortalClient() - const [summaryUrl] = await fetchSummaryLinks(client, 2024) - const meta = await fetchDisclosureMeta(client, summaryUrl) - console.log('Meta:', JSON.stringify(meta, null, 2)) - if (meta.disclosureUrls[0]) { - const detail = await fetchDisclosureDetail(client, meta.disclosureUrls[0], 2024) - console.log('Compensation rows:', detail.compensation.length) - console.log('Bill rows:', detail.bills.length) - console.log('First bill:', detail.bills[0]) - } -} -main().catch(console.error) -" +cd lobbying-scraper +GOOGLE_CLOUD_PROJECT=digital-testimony-dev \ + GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + python3 scrape.py --mode backfill --year 2024 --limit 3 --dry-run ``` -Verify: `meta.entityName` is non-empty, `meta.regType` is `"Lobbyist"` or -`"Employer"`, bill rows have `billId` set correctly for legislative chambers. +Expected: 3 registrants fetched, compensation and bill rows printed, no +Firestore writes. -### Step 5 — Backfill: single year, small limit against dev Firestore +### Step 3 — Firestore write: single year, small limit -Write a small batch to the dev Firestore emulator or dev project. +Write a small batch to the dev project and verify results: ```bash -# Against local emulator: -conda run -n maple-2025 yarn firebase-admin run-script backfillLobbying \ - --env local -- --year 2024 --limit 3 - -# Against dev project (writes real Firestore): -GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ - conda run -n maple-2025 yarn firebase-admin run-script backfillLobbying \ - --env dev -- --year 2024 --limit 3 +cd lobbying-scraper +GOOGLE_CLOUD_PROJECT=digital-testimony-dev \ + GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + python3 scrape.py --mode backfill --year 2024 --limit 3 ``` -Verify in Firestore console or emulator UI: +Verify in Firestore console: - `lobbyingRegistrants` has 3 documents with `entityName`, `entityNameNorm`, `regType`, `clients`, `generalCourt` - `lobbyingFilings` has documents with `billId` non-null for legislative rows - and null for Executive rows -- `/scrapers/lobbyingBackfill/processedUrls` has entries with `url` and + and `null` for Executive rows +- `scrapers/lobbyingBackfill/processedUrls` has entries with `url` and `processedAt` fields -- Re-running the same command skips already-processed URLs (output shows 0 new - disclosures) +- Re-running skips already-processed URLs (output shows 0 new disclosures) -### Step 6 — Spot-check: bill join +### Step 4 — Spot-check: bill join Pick a `lobbyingFiling` document with a non-null `billId` and a `generalCourt` ≥ 192. Verify the bill exists in MAPLE: @@ -615,53 +574,91 @@ If the bill is found, the join key is correct. If not found, check: (a) whether MAPLE has data for that court, (b) whether the bill number format matches (prefix + integer, no leading zeros). -### Step 7 — Backfill: full current year +### Step 5 — Create GCS archive bucket (once per project) -Once Step 5 passes, run without `--limit` for the current year: +The archive bucket name is derived from `GOOGLE_CLOUD_PROJECT`. Create it once +with the Archive storage class (written once, read rarely): ```bash -GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ - conda run -n maple-2025 yarn firebase-admin run-script backfillLobbying \ - --env dev -- --year 2024 +gsutil mb -p digital-testimony-dev -l us-central1 \ + -c archive gs://digital-testimony-dev-lobbying-archive ``` -Monitor progress via console output. Expected: ~500–600 registrants, ~1,000 -disclosure pages, several thousand filing documents written. +Repeat for prod when running the prod backfill: -### Step 8 — Backfill: full history (2005–present) +```bash +gsutil mb -p digital-testimony-prod -l us-central1 \ + -c archive gs://digital-testimony-prod-lobbying-archive +``` + +Each project uses its own bucket. Dev and prod data are isolated; the Cloud Run +service account for each project only needs access to its own bucket. + +### Step 6 — Backfill: full current year (or partial across all years) + +Always run with `ARCHIVE_RAW=1` so every fetched page is preserved for offline +reparsing. For a large-scale dev test before a full prod run, `--limit N` is +applied per year — e.g. `--limit 50` across all years fetches ~10% of history: + +```bash +cd lobbying-scraper + +# Full current year +GOOGLE_CLOUD_PROJECT=digital-testimony-dev \ + GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + ARCHIVE_RAW=1 \ + python3 scrape.py --mode backfill --year 2024 + +# ~10% partial across all years (good large-scale dev validation) +GOOGLE_CLOUD_PROJECT=digital-testimony-dev \ + GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + ARCHIVE_RAW=1 \ + python3 scrape.py --mode backfill --limit 50 +``` + +Expected for full year: ~500–600 registrants, ~1,000 disclosure pages, several +thousand filing documents written. + +### Step 7 — Backfill: full history (2005–present) Run without `--year` to process all years. Can be interrupted and resumed: ```bash -GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ - conda run -n maple-2025 yarn firebase-admin run-script backfillLobbying \ - --env dev +GOOGLE_CLOUD_PROJECT=digital-testimony-dev \ + GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/application_default_credentials.json \ + ARCHIVE_RAW=1 \ + python3 scrape.py --mode backfill ``` -Expected runtime: several hours at 1s/request. The subcollection cursor at -`/scrapers/lobbyingBackfill/processedUrls` allows safe interruption and +Expected runtime: several hours at ~1s/request. The subcollection cursor at +`scrapers/lobbyingBackfill/processedUrls` allows safe interruption and resumption. -### Step 9 — Deploy and verify Cloud Function +### Step 8 — Deploy and verify Cloud Run scraper -Deploy the function to the dev project: +Build and push the container image, then update the Cloud Run job: ```bash -conda run -n maple-2025 firebase deploy \ - --only functions:maple:scrapeLobbying \ - --project digital-testimony-dev +cd lobbying-scraper +IMAGE=us-central1-docker.pkg.dev/digital-testimony-dev/maple-lobbying/scraper:latest +docker build -t $IMAGE . && docker push $IMAGE + +gcloud run jobs update maple-lobbying-scraper \ + --image=$IMAGE \ + --project=digital-testimony-dev \ + --region=us-central1 ``` -Trigger a manual run via the Firebase console or: +Trigger a manual run via the Cloud Run console or: ```bash -conda run -n maple-2025 yarn firebase-admin run-script runScrapers \ - --env local --targets scrapeLobbying +gcloud run jobs execute maple-lobbying-scraper \ + --project=digital-testimony-dev \ + --region=us-central1 ``` -Verify: Cloud Function logs show the expected number of new disclosures (should -be near zero if backfill completed, since current+prior year are already -processed). +Verify via Cloud Run logs: the run should find near-zero new disclosures if the +backfill already completed, confirming the weekly fast-path works correctly. --- @@ -674,7 +671,7 @@ processed). | `billId` construction | `{chamberPrefix}{billNumber}` at ingest time | Raw portal data stores chamber and integer separately; the composite is what matches MAPLE's `Bill.id` | | `billId` null for Executive | `null` instead of agency name | Prevents accidental bill lookups; makes join guard explicit at the type level | | Normalized name fields | Store both raw and `*Norm` fields | Raw names preserved for provenance; normalized names used for grouping and matching | -| HTML parser | `jsdom` | Already in `functions/package.json` (used by events scraper); no need to add cheerio | +| HTML parser | `beautifulsoup4` (Python) | Runs in the Cloud Run container alongside the scraper; no JavaScript runtime needed | | Live scraper cursor | Array in `/scrapers/lobbying` doc | ~1,000 URLs/year fits well within the 1 MB Firestore doc limit; simple and atomic with other scraper state | | Backfill cursor | Firestore subcollection `/scrapers/lobbyingBackfill/processedUrls/{urlHash}` | Full 2005-present history (~50,000 URLs) would exceed the 1 MB doc limit; subcollection scales without bound and is durable, inspectable, and resumable from any machine | | Incremental strategy | Skip already-processed disclosure URLs; write docs by logical key (upsert) | Survives function restarts and re-runs without re-fetching already-scraped pages; natural upsert prevents duplicates without an explicit dedup pass | @@ -892,7 +889,7 @@ nothing but the parsed Firestore documents. If parsing logic changes, the full portal must be re-scraped — slow and fragile given the Imperva TLS constraint. Phase 2 adds GCS archiving of raw HTML as a side effect of every portal fetch. -#### Design principles (from the AMEND reference implementation) +#### Design principles The archive is **write-only cold storage**, not a cache. It is fully decoupled from both the incremental cursor (which stays Firestore-only) and the parse From 1ef618a9a5a5aabd6c8d0f719be3273a9ca922c5 Mon Sep 17 00:00:00 2001 From: Nathan Date: Tue, 30 Jun 2026 16:13:24 -0400 Subject: [PATCH 8/8] docs: add real Firestore examples and fix registrantId description - Embed actual registrant and filing documents from dev Firestore to illustrate the data model concretely for reviewers - Correct registrantId description from "slugified" to SHA-256 hash (matches the actual implementation in writer.py) - filingId description likewise updated to SHA-256 hash Co-Authored-By: Claude Sonnet 4.6 --- docs/lobbying-disclosure-ingestion.md | 77 +++++++++++++++++++++++++-- 1 file changed, 74 insertions(+), 3 deletions(-) diff --git a/docs/lobbying-disclosure-ingestion.md b/docs/lobbying-disclosure-ingestion.md index 2a2e61bf0..99c9652a7 100644 --- a/docs/lobbying-disclosure-ingestion.md +++ b/docs/lobbying-disclosure-ingestion.md @@ -42,7 +42,10 @@ record. ### `/lobbyingRegistrants/{registrantId}` -`registrantId` is a slugified `{entityName}_{year}` (stable, dedup-safe). +`registrantId` is a SHA-256 hash (first 40 hex chars) of +`{entityName}_{year}`. Hashing avoids sanitizing arbitrary Unicode and +punctuation in entity names to fit Firestore ID constraints while remaining +stable and dedup-safe across runs. One model covers both individual lobbyists and lobbying firms. A separate model is not needed because the portal search returns both under the same schema, and @@ -51,7 +54,7 @@ worked on which bill. ```typescript interface LobbyingRegistrant { - registrantId: string // "{entityName}_{year}" slugified + registrantId: string // SHA-256 hash of "{entityName}_{year}" entityName: string // firm name or individual lobbyist name (raw portal value) entityNameNorm: string // normalized form; see Normalization section year: number @@ -69,9 +72,42 @@ interface LobbyingClient { } ``` +**Example document** (`lobbyingRegistrants/0f11970cc6f17e35cc02685b794cb63a655c13b3`): + +```json +{ + "registrantId": "0f11970cc6f17e35cc02685b794cb63a655c13b3", + "entityName": "27 South Strategies, LLC", + "entityNameNorm": "27 SOUTH STRATEGIES", + "year": 2024, + "generalCourt": 193, + "regType": "Employer", + "clients": [ + { + "clientName": "The Massachusetts International Festival of the Arts, Inc.", + "clientNameNorm": "MASSACHUSETTS INTERNATIONAL FESTIVAL OF ARTS", + "compensation": 24000.0 + }, + { + "clientName": "Veterinary Emergency Group, LLC", + "clientNameNorm": "VETERINARY EMERGENCY GROUP", + "compensation": 33000.0 + }, + { + "clientName": "Gobrands, Inc", + "clientNameNorm": "GOBRANDS", + "compensation": 60000.0 + } + ], + "disclosureUrls": [ + "https://www.sec.state.ma.us/LobbyistPublicSearch/CompleteDisclosure.aspx?sysvalue=hTpfuAXM..." + ] +} +``` + ### `/lobbyingFilings/{filingId}` -`filingId` is a slugified +`filingId` is a SHA-256 hash (first 40 hex chars) of the logical key `{entityName}_{clientName}_{chamber}_{activityRef}_{generalCourt}`. ```typescript @@ -102,6 +138,41 @@ interface LobbyingFiling { } ``` +**Example documents** — query: `lobbyingFilings` where `generalCourt == 193` and `billId == "H1"`: + +```json +[ + { + "filingId": "0bac34faf2f624083daaaea57ee55f5364d2be29", + "entityName": "Christina Ascolillo", + "entityNameNorm": "CHRISTINA ASCOLILLO", + "clientName": "American Council of Engineering Companies of Massachusetts", + "clientNameNorm": "AMERICAN COUNCIL OF ENGINEERING COMPANIES OF MASSACHUSETTS", + "year": 2023, + "generalCourt": 193, + "chamber": "House Bill", + "billId": "H1", + "activityTitle": "An Act making appropriations for the Fiscal Year 2024...", + "position": "Neutral", + "amount": 0.0 + }, + { + "filingId": "109600251ca8fd279e8bb7562bc9d234c39f63a8", + "entityName": "Christina Ascolillo", + "entityNameNorm": "CHRISTINA ASCOLILLO", + "clientName": "St. Mary's Center for Women and Children, Inc.", + "clientNameNorm": "ST MARY S CENTER FOR WOMEN AND CHILDREN", + "year": 2023, + "generalCourt": 193, + "chamber": "House Bill", + "billId": "H1", + "activityTitle": "An Act making appropriations for the Fiscal Year 2024...", + "position": "Neutral", + "amount": 0.0 + } +] +``` + ### Constructing `billId` from Raw Portal Data The portal stores bill numbers as bare integers and records the chamber