KNELPerfHub/README.md

⚡ KNELPerfHub — content for performance.knownelement.com

The Grav site at performance.knownelement.com pulls its pages from this repo. Publishers push; the site never runs foreign tooling.

Flow

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.