Docs: true entity counts — 37,667 records across five types

README and roadmap had drifted two syncs behind reality: 10,390
jurisdictions (incl. 6,824 state legislative districts), 13,329
people, 11,221 legal sections.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

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

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.