Fabio
1beeaab2db
The first edges in the repo. Every US county now links to the districts it sits in, weighted by area overlap, and every legislator links to the district they represent — county → district → representative, traversable. Data (PostGIS, no Atlas dependency — computed directly from geometry): - data/county_district_edges.jsonl — 16,328 weighted edges. area_weight = ST_Area(ST_Intersection(county, district))/ST_Area(county) over ST_MakeValid Census TIGER 2024 geometries, overlaps <0.5% dropped. Uses area-intersection, NOT centroid-in-polygon, so urban districts that carve through counties (e.g. GA CD-5 / Atlanta across Clayton+DeKalb+Fulton) are captured, not silently dropped. Per-county weights sum to ~1.0 per district type. build.py: - ~6,896 new district nodes: 435 CD (ACS demographics where available; sparse for the 8 states missing from acs_cd) + 4,927 state-house + 1,897 state-senate (geometry-only). GEOID/number-keyed, stable. - county index.md gains a `districts:` block (frontmatter) + a ## Districts section (body links, so link-integrity checks them). - legislators + US House members gain `represents:` pointing at their district node; edge stored once on the person, inverse left to the view. - schemas/jurisdiction: classification enum + chamber/districts fields. Honest gaps (logged, not hidden): ID + NH have no state-house geometry, so their house districts get nodes (represents resolves) but no county edges; CD nodes for acs_cd-missing states are demographically sparse. Deterministic (byte-identical rebuild); validate.py passes 26,617 records, link-integrity clean (every district/represents link resolves). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
110 lines
3.9 KiB
YAML
110 lines
3.9 KiB
YAML
# Republic OS — source registry.
|
|
# Machine-readable index of the public sources feeding the mirror.
|
|
# Prose companion: docs/sources.md
|
|
|
|
sources:
|
|
- id: atlas
|
|
name: Atlas / influence.tools
|
|
url: https://influence.tools
|
|
type: aggregator
|
|
authority_level: aggregator
|
|
requires_api_key: false
|
|
refresh_frequency: on-demand
|
|
feeds: [Person]
|
|
raw: [officeholders-v2.jsonl]
|
|
notes: >
|
|
Draws from official upstreams (House Clerk XML, Senate.gov XML,
|
|
OpenStates, Census TIGER/Line, FL Cities partner API) and records the
|
|
specific upstream per field. Officeholders at federal, state, and
|
|
Florida county/municipal levels.
|
|
|
|
- id: congress-legislators
|
|
name: unitedstates/congress-legislators
|
|
url: https://github.com/unitedstates/congress-legislators
|
|
type: dataset
|
|
authority_level: authoritative-community
|
|
requires_api_key: false
|
|
refresh_frequency: continuous
|
|
feeds: [Body, Person]
|
|
raw: [bodies.jsonl, leadership.jsonl, committee_memberships.jsonl]
|
|
notes: >
|
|
Structured YAML for chambers, committees, subcommittees, current
|
|
leadership, and committee membership. Keyed by bioguide ID.
|
|
|
|
- id: fec
|
|
name: Federal Election Commission
|
|
url: https://www.fec.gov/data/
|
|
type: api
|
|
authority_level: official
|
|
requires_api_key: true
|
|
refresh_frequency: daily
|
|
feeds: [Candidate]
|
|
raw: [fec_candidates.jsonl]
|
|
notes: 2026 federal candidate filings; keyed by fec_id and committee_id.
|
|
|
|
- id: census-acs
|
|
name: Census American Community Survey (2023)
|
|
url: https://www.census.gov/programs-surveys/acs
|
|
type: dataset
|
|
authority_level: official
|
|
requires_api_key: false
|
|
refresh_frequency: annual
|
|
feeds: [Jurisdiction]
|
|
raw: [acs_county.jsonl, acs_cd.jsonl]
|
|
notes: County and congressional-district demographics; keyed by FIPS.
|
|
|
|
- id: place-county-crosswalk
|
|
name: Census place → county crosswalk (Atlas PostGIS)
|
|
url: https://www.census.gov/geographies/mapping-files.html
|
|
type: dataset
|
|
authority_level: official
|
|
requires_api_key: false
|
|
refresh_frequency: on-demand
|
|
feeds: [Person]
|
|
raw: [place_county_crosswalk.jsonl]
|
|
notes: >
|
|
Atlas PostGIS spatial join of Census TIGER 2024 places against county
|
|
geometries — 32,041 places, one primary county each. Resolves municipal
|
|
officeholders to their county. Join key is county_geoid (5-digit FIPS);
|
|
the sibling county_fips column is the 3-digit county code only.
|
|
|
|
- id: county-district-overlap
|
|
name: County → district area overlap (PostGIS)
|
|
url: https://www.census.gov/geographies/mapping-files.html
|
|
type: dataset
|
|
authority_level: official
|
|
requires_api_key: false
|
|
refresh_frequency: on-demand
|
|
feeds: [Jurisdiction]
|
|
raw: [county_district_edges.jsonl]
|
|
notes: >
|
|
PostGIS area-intersection of Census TIGER 2024 county boundaries against
|
|
congressional / state-senate / state-house district boundaries —
|
|
ST_Area(ST_Intersection(county, district)) / ST_Area(county), computed on
|
|
ST_MakeValid geometries, overlaps below 0.5% dropped. 16,328 weighted
|
|
county→district edges. Also seeds the state-legislative district nodes
|
|
(which have no ACS demographics — geometry only).
|
|
|
|
# Prepared but not yet ingested — see docs/roadmap.md
|
|
planned:
|
|
- id: govinfo
|
|
name: GovInfo
|
|
url: https://www.govinfo.gov/
|
|
authority_level: official
|
|
- id: federal-register
|
|
name: Federal Register
|
|
url: https://www.federalregister.gov/
|
|
authority_level: official
|
|
- id: usaspending
|
|
name: USAspending.gov
|
|
url: https://www.usaspending.gov/
|
|
authority_level: official
|
|
- id: legistar
|
|
name: Legistar / Granicus / CivicPlus (local agenda portals)
|
|
url: https://webapi.legistar.com/
|
|
authority_level: official
|
|
- id: census-tiger
|
|
name: Census TIGER/Line (geometry)
|
|
url: https://www.census.gov/geographies/mapping-files.html
|
|
authority_level: official
|