From 511d65f9a0513769bb8dc03dd1241dbf044ccf61 Mon Sep 17 00:00:00 2001 From: Fabio Date: Mon, 6 Jul 2026 10:51:35 -0400 Subject: [PATCH] =?UTF-8?q?Policy:=20dev=20mode=20until=20v1=20=E2=80=94?= =?UTF-8?q?=20main=20is=20the=20workbench,=20raw=20bytes=20off-repo?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This repo is a prototype testing a theory, not yet a mirror the public relies on. The immutability disciplines (never-overwrite, never-rewrite, raw-first-in-repo) are reframed as the v1.0 target, not day-3 law — a mirror that force-pushes while preaching immutability would betray its own founding principle. Until v1: history is malleable and raw source snapshots live off-repo on the depot (.gitignore'd), with only the product (records) and provenance (manifests + SHA-256) committed. The 147MB of already-tracked raw zips are dropped from HEAD (git rm --cached, a forward delete — the bytes stay on the depot). Co-Authored-By: Claude Opus 4.8 --- .gitignore | 7 +++++++ README.md | 15 +++++++++------ docs/legal-corpus.md | 26 ++++++++++++++++---------- 3 files changed, 32 insertions(+), 16 deletions(-) diff --git a/.gitignore b/.gitignore index 40ddbcd711..3e98bfcfc6 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,9 @@ .DS_Store .claude/ + +# Dev mode (pre-v1): raw source snapshots live off-repo on the depot, not in +# git history. We commit the product (records) + provenance (manifests + +# checksums); the raw bytes those hashes anchor stay lean off-box. The +# "raw-first, in-repo" discipline turns on at v1.0 — see README. +data/legal/raw/**/*.zip +data/legal/raw/**/*.xml diff --git a/README.md b/README.md index 99fafd89ed..fb52ee4495 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ Government is already software: statutes are code, agencies are processes, elect ## What's in here today -57,185 markdown records, every one schema-validated: +105,704 markdown records, every one schema-validated: | Entity | Count | What it is | |---|---:|---| @@ -16,9 +16,9 @@ Government is already software: statutes are code, agencies are processes, elect | **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** | 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** | 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. | +| **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 law says* — 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 — down to the city,* and *what the entire body of federal statutory law says* — and, through git, *what changed.* ## How it works @@ -59,12 +59,15 @@ Everything runs on the Python standard library. No dependencies to install. - [Technical Brief — Government as Software](Technical%20Brief%20—%20Government%20as%20Software.md) — the founding document - [CHANGELOG.md](CHANGELOG.md) — the civic changelog, generated from git history -## The disciplines +## The disciplines — the v1.0 target -Three rules govern everything here, and they are won by subtraction: +This repository is a **prototype testing a theory**, not a finished mirror. Until it earns a `v1.0`, **main is the workbench**: history is malleable — rebase, squash, force-push, and prune are all fair game — and raw source snapshots live off-repo (on the depot), so the tree stays lean while the shape is still moving. What's committed here is the *product* (the entity + legal records) and its *provenance* (manifests and SHA-256 checksums); the raw bytes those hashes anchor are recoverable off-box. + +The disciplines the finished mirror will be held to — and which lock in at `v1.0`, once there's a record people depend on: 1. **Never overwrite** — a change is a new commit, not a clobbered file. Deletes are diffs. 2. **Never rewrite history** — no force-push, no squash. The past is load-bearing. 3. **Always push off-box** — one copy is a single point of failure; more is not. +4. **Raw-first, in-repo** — every source snapshot committed, so origin is recoverable from git alone. -Substrate for [influence.tools](https://influence.tools). +They are ideals for a mirror the public relies on. We're not there yet — we're finding out whether the theory holds. Substrate for [influence.tools](https://influence.tools). diff --git a/docs/legal-corpus.md b/docs/legal-corpus.md index 4d138151aa..ce40d9ac32 100644 --- a/docs/legal-corpus.md +++ b/docs/legal-corpus.md @@ -8,26 +8,32 @@ The legal pipeline is deliberately mechanical: official source -> raw snapshot -> normalized legal tree -> manifest -> checksums -> git diff ``` -The first legal corpus is a seed import of the United States Code, Title 52, -Voting and Elections, from the Office of the Law Revision Counsel XML release -point current through Public Law 119-100. +The legal corpus is the **complete United States Code** — every section of all +53 titles that carry content (Title 53 is reserved and empty), 59,740 records, +from the Office of the Law Revision Counsel USLM XML at release point 119-100 +(current through Public Law 119-100). One source, one edition, end to end. + +> Pre-v1 note: the raw `.zip`/`.xml` snapshots live off-repo on the depot, not +> in git — only the manifests and checksums (which anchor them by SHA-256) are +> committed. The "raw-first, in-repo" discipline turns on at v1.0. See the +> [README](../README.md#the-disciplines--the-v10-target). ## Layout ```text -data/legal/raw/us/code/ - title-52/ - xml_usc52@119-100.zip - usc52.xml +data/legal/raw/us/code/ (off-repo pre-v1; hashes committed below) + title-NN/ + xml_uscNN@119-100.zip + uscNN.xml data/legal/manifests/ - us-code-title-52-119-100.json + us-code-title-NN-119-100.json data/legal/checksums/ - us-code-title-52-119-100.sha256 + us-code-title-NN-119-100.sha256 legal/us/code/ - title-52/ + title-NN/ chapter-101/ section-10101.md ```