Docs: the authority axis + executive layer
Body 233→275, total 105,746; the two axes now cross (law ↔ office). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -8,17 +8,19 @@ Government is already software: statutes are code, agencies are processes, elect
|
||||
|
||||
## What's in here today
|
||||
|
||||
105,704 markdown records, every one schema-validated:
|
||||
105,746 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. |
|
||||
| **Body** | 275 | The institutions themselves — the U.S. House, the Senate, 49 committees, 181 subcommittees, and now the **executive branch**: the 15 Cabinet departments and the 21 Executive-Schedule Level I offices, minted from the Code's own enumerations (5 U.S.C. §§ 101, 5312). |
|
||||
| **Candidate** | 2,494 | Everyone running for federal office in 2026, from FEC filings. |
|
||||
| **Jurisdiction** | 29,908 | Every U.S. county (3,131), all 435 congressional districts (Census demographics on 363), every state legislative district (4,927 house, 1,897 senate), and **every incorporated municipality in the country — 19,513 cities, towns, villages, and boroughs** — keyed by Census place GEOID, with officeholders attached where the mirror has them. |
|
||||
| **LegalText** | 59,740 | **The complete United States Code** — every section of all 53 titles that carry content (Title 53 is reserved), from General Provisions to Wildlife, mirrored section-by-section from the official OLRC USLM XML at release point 119-100 (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 — down to the city,* and *what the entire body of federal statutory law says* — and, through git, *what changed.*
|
||||
And the axes now cross: **27,804 authority edges** link 17,031 U.S. Code sections to the executive offices they empower, so the Attorney General's node lists every one of the 2,386 sections that vests authority in it. Law and power are no longer separate piles.
|
||||
|
||||
The mirror answers, with receipts: *who holds power, who runs the institution, who's running, what each place is made of — down to the city, what the entire body of federal statutory law says,* and *which office each law empowers* — and, through git, *what changed.*
|
||||
|
||||
## How it works
|
||||
|
||||
|
||||
+2
-2
@@ -46,13 +46,13 @@ The format conforms to the [Open Knowledge Format (OKF)](https://github.com/Goog
|
||||
| `type` | Count | Home | Schema |
|
||||
|---|---:|---|---|
|
||||
| **Person** | 13,329 | `us/people/`, `us/states/<st>/…/people/` | [person.schema.json](../schemas/person.schema.json) |
|
||||
| **Body** | 233 | `us/bodies/…` | [body.schema.json](../schemas/body.schema.json) |
|
||||
| **Body** | 275 | `us/bodies/…`, `us/executive/…` | [body.schema.json](../schemas/body.schema.json) |
|
||||
| **Candidate** | 2,494 | `us/states/<st>/candidates/` | [candidate.schema.json](../schemas/candidate.schema.json) |
|
||||
| **Jurisdiction** | 29,908 | county / city `index.md`, `us/states/<st>/districts/` | [jurisdiction.schema.json](../schemas/jurisdiction.schema.json) |
|
||||
| **LegalText** | 11,221 | `legal/us/code/title-<nn>/…` | [legal_text.schema.json](../schemas/legal_text.schema.json) |
|
||||
|
||||
- **Person** — an officeholder, filed by the jurisdiction they serve. Federal members are enriched with their bioguide ID, leadership roles, and committee seats.
|
||||
- **Body** — an institution: a chamber, committee, or subcommittee. The "repos" of the government-as-code model. Each lists its leadership; subcommittees name their parent.
|
||||
- **Body** — an institution: a chamber, committee, subcommittee, or an executive department/agency/office. The "repos" of the government-as-code model. Executive Bodies under `us/executive/` are minted from the Code's own enumerations (5 U.S.C. §§ 101, 5312) and carry the **authority axis** — reciprocal links to the U.S. Code sections that empower them, from `data/section_authority_edges.jsonl`.
|
||||
- **Candidate** — someone running for office, distinct from a current officeholder. Sourced from FEC filings.
|
||||
- **Jurisdiction** — a place with a government, carrying Census demographics and/or district edges. A county's node is its directory `index.md`; a **city's** is likewise an `index.md` under `municipalities/`, keyed by Census place GEOID and modelled exactly like a county (place + government fused, officeholders nested beneath); a district's is a file under `districts/`.
|
||||
- **LegalText** — a single section of statute, filed under its title and chapter. See the [legal corpus](legal-corpus.md).
|
||||
|
||||
+4
-2
@@ -5,12 +5,13 @@ 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).
|
||||
- **Five entity types, 105,704 files** — Person (13,329), Body (233), Candidate (2,494), Jurisdiction (29,908), LegalText (59,740).
|
||||
- **Five entity types, 105,746 files** — Person (13,329), Body (275), Candidate (2,494), Jurisdiction (29,908), LegalText (59,740).
|
||||
- **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 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 municipal layer** — every incorporated place in the country (19,513 cities, towns, villages, boroughs) as a first-class Jurisdiction node keyed by Census place GEOID, modelled like a county (place + government fused). 2,229 are filled with their officeholders today (2,217 GEOID-resolved off a 98.8% name→GEOID join); the rest are truthful skeleton stubs — "governed, not yet mirrored" — waiting for depth, the same discipline as the county skeleton.
|
||||
- **The complete U.S. Code** — every section of all 53 populated titles (Title 53 is reserved), 59,740 per-section records, mirrored from the official OLRC USLM XML at release point 119-100, uniform edition end to end, with manifests and checksums.
|
||||
- **The authority axis (v1)** — the executive branch minted as nodes from the Code's own enumerations (15 Cabinet departments from 5 U.S.C. § 101, 21 Level I offices from § 5312), and **27,804 edges** linking 17,031 sections to the offices they empower. `scripts/extract_authority.py` → `data/section_authority_edges.jsonl` (a committed input, like the district edges); reciprocal "empowered by" links render on each office node. Named references only for now (cabinet-level); relative refs ("the Secretary") and the agency long tail are next.
|
||||
- **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.
|
||||
@@ -20,7 +21,8 @@ An honest account of what exists, what's next, and what's further out. This repo
|
||||
## Next
|
||||
|
||||
- **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 Code as a living diff** — the whole Code is in; the next lever is re-syncing it at each new OLRC release point so amendments surface as diffs (a new public law becomes a visible change to the affected sections), and linking sections to the offices and bodies they empower (the authority axis).
|
||||
- **Deepen the authority axis** — v1 links cabinet-level *named* references. Next: resolve relative references ("the Secretary", "the Commission") via each title's definitions section; mint the agency long tail (~600 more offices the Code names — EPA, OPM, FCC, GAO…); attach current occupants (a Person for the sitting Secretary, from Atlas); and render the reverse edge on the section files themselves.
|
||||
- **The Code as a living diff** — re-sync the Code at each new OLRC release point so amendments surface as diffs: a new public law becomes a visible change to the affected sections.
|
||||
- **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.
|
||||
- **Fill the municipal skeleton** — the 19,513 city nodes exist; 2,229 carry officeholders. The work now is depth: pull municipal officeholders for the next states (Texas, California, Ohio all have a spine already), each a diff against a node that's waiting. Municipal ACS demographics would enrich every city node the way ACS already enriches counties.
|
||||
- **State and local bodies** — Bodies (as distinct institution files) currently exist only at the federal level. Mint them for state legislatures and, following the municipal layer, county commissions where they warrant a Body of their own.
|
||||
|
||||
Reference in New Issue
Block a user