Policy: dev mode until v1 — main is the workbench, raw bytes off-repo

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 <noreply@anthropic.com>
This commit is contained in:
Fabio
2026-07-06 10:51:35 -04:00
parent 80720cfd15
commit 511d65f9a0
3 changed files with 32 additions and 16 deletions
+16 -10
View File
@@ -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
```