flowchart LR
    S[📡 scrapers/collectors<br/>KNELPerf + SITER-Solar tooling] --> P[📝 grav-publish.sh<br/>renders pages, git push]
    P --> R[📦 this repo] -->|host-side git pull every 5 min<br/>no container execs| G[🌐 Grav<br/>cache.check=file]

Publishing = commit markdown to this repo (bash only; house rules).
The Cloudron VPS runs a systemd timer that git pulls this repo into the Grav pages dir (public repo → plain HTTPS, no deploy keys).
Grav's cache.check.method: file picks changes up automatically — the app container executes nothing but its own PHP.

Layout

01.home/ — site landing page
performance/ — auto-published dashboard (ERCOT risk, arbitrage verdict, baseline index) + reports
02.typography/ — theme demo (from the Grav skeleton; removable)

Work tracking: Redmine #826

Docs live on Discourse — this repo is the executable source of truth.

🔓 Transparency policy (org standard)

The site and this repo are public read-only — ultra-open and transparent by default. The one carve-out: revenue and expense detail is private (LLC members only) and is never published here. Practically:

Public: performance/audit data, benchmarks, risk intelligence, architecture and decision reports.
Never published: SITER-Solar financials (project cost, billing history, ROI detail), KillBill revenue data, contract rates.
grav-publish.sh publishes from an explicit whitelist only — anything new must be added deliberately, not swept in by default.
The Grav local admin account is disabled; publishing is exclusively git-based through this repo.