Documentation: accurate README + full /docs tree

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>
2026-07-04 08:38:06 -04:00
parent 2e5197d1a3
commit 316c4e563c
7 changed files with 429 additions and 7 deletions
@@ -0,0 +1,77 @@
+# Republic OS — source registry.
+# Machine-readable index of the public sources feeding the mirror.
+# Prose companion: docs/sources.md
+
+sources:
+  - id: atlas
+    name: Atlas / influence.tools
+    url: https://influence.tools
+    type: aggregator
+    authority_level: aggregator
+    requires_api_key: false
+    refresh_frequency: on-demand
+    feeds: [Person]
+    raw: [officeholders-v2.jsonl]
+    notes: >
+      Draws from official upstreams (House Clerk XML, Senate.gov XML,
+      OpenStates, Census TIGER/Line, FL Cities partner API) and records the
+      specific upstream per field. Officeholders at federal, state, and
+      Florida county/municipal levels.
+
+  - id: congress-legislators
+    name: unitedstates/congress-legislators
+    url: https://github.com/unitedstates/congress-legislators
+    type: dataset
+    authority_level: authoritative-community
+    requires_api_key: false
+    refresh_frequency: continuous
+    feeds: [Body, Person]
+    raw: [bodies.jsonl, leadership.jsonl, committee_memberships.jsonl]
+    notes: >
+      Structured YAML for chambers, committees, subcommittees, current
+      leadership, and committee membership. Keyed by bioguide ID.
+
+  - id: fec
+    name: Federal Election Commission
+    url: https://www.fec.gov/data/
+    type: api
+    authority_level: official
+    requires_api_key: true
+    refresh_frequency: daily
+    feeds: [Candidate]
+    raw: [fec_candidates.jsonl]
+    notes: 2026 federal candidate filings; keyed by fec_id and committee_id.
+
+  - id: census-acs
+    name: Census American Community Survey (2023)
+    url: https://www.census.gov/programs-surveys/acs
+    type: dataset
+    authority_level: official
+    requires_api_key: false
+    refresh_frequency: annual
+    feeds: [Jurisdiction]
+    raw: [acs_county.jsonl, acs_cd.jsonl]
+    notes: County and congressional-district demographics; keyed by FIPS.
+
+# Prepared but not yet ingested — see docs/roadmap.md
+planned:
+  - id: govinfo
+    name: GovInfo
+    url: https://www.govinfo.gov/
+    authority_level: official
+  - id: federal-register
+    name: Federal Register
+    url: https://www.federalregister.gov/
+    authority_level: official
+  - id: usaspending
+    name: USAspending.gov
+    url: https://www.usaspending.gov/
+    authority_level: official
+  - id: legistar
+    name: Legistar / Granicus / CivicPlus (local agenda portals)
+    url: https://webapi.legistar.com/
+    authority_level: official
+  - id: census-tiger
+    name: Census TIGER/Line (geometry)
+    url: https://www.census.gov/geographies/mapping-files.html
+    authority_level: official