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>
README/roadmap/data-model updated for the city nodes: entity counts,
the places tree layout, and the roadmap pivot from 'mint local bodies'
to 'fill the municipal skeleton.'
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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>
Add `make board` and docs/board.md so the Board's rebuild-and-redeploy flow
is a documented step, not tribal knowledge. Covers why the county data is
inlined (self-contained Artifact / CSP), that build_viz.py injects it into
board.html, and that a live Artifact must be REPUBLISHED (editing the repo
file doesn't update a deployed Artifact). README links it in both the make
list and the docs index.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The README described intent; the repo is now real. Rewrote it to reflect
what actually exists — 17,506 validated files across four entity types,
the deterministic pipeline, the commands — and added the /docs tree:
government-as-code.md the philosophy: git primitives -> government
data-model.md entity types, IDs, file format, the tree, determinism
sources.md where every fact comes from, and how current
roadmap.md done / next / later, honest about what isn't built
contributing.md the disciplines, and how to add a source
Plus data/sources/sources.yaml — the machine-readable source registry.
Every count, path, and source claim is grounded in the current tree, not
the aspirational brief. Internal links verified; validation still clean.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Government as an operating system, git as its missing changelog.
The mirror architecture, influence as a computable tool, a visual
grammar for power, and the game layer that lights the map.
The diff is the product.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>