Collection as an ETL pipeline; runs_clean.csv from every source; Report a run

- collection/pipeline.yaml declares every source (extract kind, transform,
  privacy rules, load target, run source); `python -m collection update|build`
- extract keeps data/raw/<source>/current + previous only (git-ignored);
  data/manifest.json records the current raw checksum and change date
- transforms are pure; validate checks runs against data/dictionary.yaml
  before load; load writes byte-stable files only when they change
- data/public/runs_clean.csv: every run from every source with a new
  `source` column (reddit spreadsheet, reddit thread, reported, bot,
  reddit pdf); the sheet's own row label moves to `entry`; run_id is text
- bot importer ported to Python (same output as bot.js on the fixture);
  labels and crosswalk in collection/specs/bot.yaml, written into graph.js
- Reddit through the official API (result links to add by hand); the 12
  result pages move to collection/manual/reddit_results.yaml
- "Report a run": a GitHub issue form generated from
  collection/specs/report_form.yaml, collected as source "reported", plus a
  site tab pointing to it, the community spreadsheet and the megathread
- analysis and the route model read runs_clean.csv (sources in
  measures.yaml); stats.json and policy.json unchanged apart from the
  factor's new name
- daily workflow runs the pipeline; the raw store is kept between runs in
  the Actions cache, encrypted with RAW_ARCHIVE_KEY

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UCzTd31GphpMXDhQqWrCMQ
This commit is contained in:
ekcSchiano
2026-11-04 02:46:48 +00:00
co-authored by Claude Opus 5.5
parent 61bc50583c
commit 3b24a11f5a
64 changed files with 8626 additions and 6909 deletions
+76
View File
@@ -0,0 +1,76 @@
"""Paths, the pipeline spec, and byte-stable writers shared by every stage."""
import hashlib
import json
import sys
from pathlib import Path
import yaml
ROOT = Path(__file__).resolve().parents[2]
if str(ROOT / "core") not in sys.path:
sys.path.insert(0, str(ROOT / "core"))
def path(p):
return ROOT / p
def read_yaml(p):
with open(path(p), encoding="utf-8") as f:
return yaml.safe_load(f)
def pipeline():
return read_yaml("collection/pipeline.yaml")
def sha256_bytes(data):
return hashlib.sha256(data).hexdigest()
def sha256_file(p):
h = hashlib.sha256()
with open(p, "rb") as f:
for block in iter(lambda: f.read(1 << 20), b""):
h.update(block)
return h.hexdigest()
def json_bytes(obj, compact=True):
if compact:
return (json.dumps(obj, ensure_ascii=False, separators=(",", ":"))).encode("utf-8")
return (json.dumps(obj, ensure_ascii=False, indent=1) + "\n").encode("utf-8")
def jsonl_bytes(rows):
return "".join(json.dumps(r, ensure_ascii=False, separators=(",", ":")) + "\n" for r in rows).encode("utf-8")
def read_jsonl(p):
p = Path(p)
if not p.exists():
return []
out = []
for line in p.read_text(encoding="utf-8").splitlines():
if line.strip():
try:
out.append(json.loads(line))
except json.JSONDecodeError:
pass
return out
class Report:
"""What a pipeline run did, as Markdown lines (the daily pull request's body)."""
def __init__(self):
self.lines = []
self.changed = False
self.failed = []
def add(self, line):
self.lines.append(line)
print(line)
def text(self, title):
return "\n".join([f"## {title}", ""] + self.lines) + "\n"