diff --git a/README.md b/README.md index 2ef0dfec82..dbbf1dae53 100644 --- a/README.md +++ b/README.md @@ -8,17 +8,17 @@ Government is already software: statutes are code, agencies are processes, elect ## What's in here today -19,721 markdown records, every one schema-validated: +37,667 markdown records, every one schema-validated: | Entity | Count | What it is | |---|---:|---| | **Person** | 13,329 | Current officeholders — federal, all 50 state legislatures, and Florida down to the municipal level. Federal members carry their bioguide ID, leadership roles, and committee seats. | | **Body** | 233 | The institutions themselves — the U.S. House, the Senate, 49 committees, 181 subcommittees, each with its leadership. | | **Candidate** | 2,494 | Everyone running for federal office in 2026, from FEC filings. | -| **Jurisdiction** | 3,494 | Every U.S. county (3,131) and 363 congressional districts, each carrying Census demographics — the nationwide skeleton, filled with data. | -| **LegalText** | 171 | U.S. Code Title 52, Voting and Elections, mirrored from the official OLRC XML release current through Public Law 119-100. | +| **Jurisdiction** | 10,390 | Every U.S. county (3,131), all 435 congressional districts (Census demographics on 363), and every state legislative district — 4,927 house, 1,897 senate — the nationwide skeleton, filled with data. | +| **LegalText** | 11,221 | U.S. Code Titles 1–11 and 52 — General Provisions through Bankruptcy, plus Voting and Elections — mirrored section-by-section from the official OLRC XML release current through Public Law 119-100. | -The mirror answers, with receipts: *who holds power, who runs the institution, who's running, what each place is made of,* and now *what legal text governs elections* — and, through git, *what changed.* +The mirror answers, with receipts: *who holds power, who runs the institution, who's running, what each place is made of,* and *what the law says* — and, through git, *what changed.* ## How it works @@ -38,7 +38,7 @@ data/legal/raw ──► scripts/ingest_*.py ──► legal/** ```bash make build # regenerate the entity tree from the raw exports -make legal-us-code # regenerate the U.S. Code Title 52 legal corpus seed +make legal-us-code # regenerate the U.S. Code legal corpus (TITLES="1 2 ..." overridable) make validate # OKF + schema + link-integrity checks on all records make changelog # what changed in the government since the last commit make board # rebuild the Board's inlined data from the tree diff --git a/docs/roadmap.md b/docs/roadmap.md index e7050bd097..dcdfed5bab 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -5,9 +5,11 @@ An honest account of what exists, what's next, and what's further out. This repo ## Done - **The substrate** — repo-canonical, OKF markdown + YAML frontmatter, JSON-Schema validated, deterministic build (byte-identical on rerun). -- **Four entity types, 17,506 files** — Person (11,285), Body (233), Candidate (2,494), Jurisdiction (3,494). +- **Five entity types, 37,667 files** — Person (13,329), Body (233), Candidate (2,494), Jurisdiction (10,390), LegalText (11,221). - **The federal government, structurally** — every member of Congress, the chambers, 49 committees and 181 subcommittees with their leadership, and every member's committee seats. -- **The nationwide county skeleton** — all 3,131 U.S. counties as demographic nodes, plus 363 congressional districts, from Census ACS. +- **The nationwide county skeleton** — all 3,131 U.S. counties as demographic nodes, plus all 435 congressional districts (Census ACS demographics on 363). +- **The authority layer** — every state legislative district (4,927 house, 1,897 senate) linked county↔district↔legislator, nationwide. +- **The legal corpus, seeded wide** — U.S. Code Titles 1–11 and 52 as 11,221 per-section records, mirrored from pinned OLRC XML (release 119-100) with manifests and checksums. Titles 12–54 pending an OLRC XML retry (the GovInfo HTML fallback is not source-quality). - **The 2026 federal candidate field** — every FEC filing as a Candidate. - **Florida to the ground** — officeholders down to the municipal level across all 67 counties. - **The pipeline** — `make build` / `validate` / `changelog` / `check`, standard-library only. @@ -16,7 +18,8 @@ An honest account of what exists, what's next, and what's further out. This repo ## Next -- **Self-updating mirror** — a GitHub Action running `make check` on every push, then a scheduled job that pulls a fresh Atlas export, rebuilds, and commits the changelog automatically. This is the point where the mirror maintains itself and the daily civic changelog becomes real (the first *re-sync* diff, where only genuine government changes surface). +- **Self-updating mirror** — the `make check` GitHub Action now guards every push; next is the scheduled job that pulls a fresh Atlas export, rebuilds, and commits the changelog automatically. That is the point where the mirror maintains itself and the daily civic changelog becomes real (the first *re-sync* diff, where only genuine government changes surface). +- **The full U.S. Code** — titles 12–54 as OLRC USLM XML at the same release point (retry in progress on Atlas; the WAF-blocked titles currently exist only as GovInfo HTML, which stays a secondary snapshot). - **The demographic choropleth** — the Board already has ACS data for every county; shade the map by population, income, and poverty, turning it from a coverage indicator into an instrument. - **State and local bodies** — Bodies currently exist only at the federal level. Mint them for state legislatures and, following the Florida depth, county commissions and city councils. - **Graph export** — a loader that walks the tree and builds the relationship graph (Memgraph) as a materialized view, so the repo can rehydrate the graph rather than the reverse.