open-standards/jouleclaw/scales/v1/eu.eed.dr2026.pue.provenance.json
David Charlot 4d9236fe1c
Some checks failed
jouleclaw public surface must stay documented / Public-surface audit (jouleclaw-rs) (pull_request) Successful in 1m3s
no-vanity-metrics / Scan committed Markdown for vanity metrics (pull_request) Successful in 4s
standards workspaces build + test / aac-rs (pull_request) Successful in 1m37s
standards workspaces build + test / eoc-rs (pull_request) Successful in 1m47s
standards workspaces build + test / joule-code-rs (pull_request) Successful in 2m1s
standards workspaces build + test / jcp-rs (pull_request) Successful in 1m14s
standards workspaces build + test / proof-rs (pull_request) Successful in 1m10s
standards workspaces build + test / sandbox-rs (pull_request) Successful in 2m1s
standards workspaces build + test / smart-byte-rs (pull_request) Successful in 2m32s
WAI conformance / cargo-class corpora · linux (pull_request) Successful in 33s
WAI conformance / cross-arch byte-equality · linux (pull_request) Successful in 18s
standards workspaces build + test / jouleclaw-rs (pull_request) Successful in 7m19s
standards workspaces build + test / joulecontract-rs (pull_request) Successful in 1m18s
standards workspaces build + test / map-rs (pull_request) Successful in 1m11s
standards workspaces build + test / mesh-rs (pull_request) Successful in 53s
standards workspaces build + test / openpay (pull_request) Successful in 3m43s
WAI conformance / cargo-class corpora · linux-arm64 (pull_request) Successful in 1m7s
WAI conformance / cross-arch byte-equality · linux-arm64 (pull_request) Successful in 33s
standards workspaces build + test / arl-rs (pull_request) Successful in 26m42s
standards workspaces build + test / joule-ui-rs (pull_request) Successful in 14m25s
standards workspaces build + test / jouledesk-rs (pull_request) Successful in 11m21s
standards workspaces build + test / joulehook-rs (pull_request) Successful in 9m52s
standards workspaces build + test / sense-rs (pull_request) Successful in 8m13s
WAI conformance / cargo-class corpora · macos (pull_request) Successful in 1m21s
WAI conformance / cross-arch byte-equality · macos (pull_request) Successful in 21s
WAI conformance / cargo-class corpora · windows (pull_request) Has been cancelled
WAI conformance / cross-arch byte-equality · windows (pull_request) Has been cancelled
compliance: publish the EU draft PUE bands as a sourced data pack, not as code
`BandingScale` deliberately ships no canonical scale: which thresholds are
correct for a metric is a policy question a library has no standing to settle,
and baking one in would repeat the mistake the type was written to retire —
`is_compliant`'s `pue < 1.5 && renewable_pct >= 50.0`, two magic floats with no
provenance, no version, and no way to say which instrument they encoded.

So the EU draft's PUE bands are published as **data**, in `jouleclaw/scales/v1/`,
with their sources beside them. `BandingScale` already derives `Deserialize`, so
a pack loads with `serde_json::from_str` and this adds no crate code at all —
which is the point.

Each pack is exactly a `BandingScale`, accompanied by a provenance file
recording where the numbers came from, the status of that source, what the pack
omits, and the reuse terms. A pack with no provenance file is not publishable
here; a threshold whose origin is unstated is the thing the directory exists to
replace.

Three things the provenance says plainly:

- **The instrument is a DRAFT** — registered 2026-03-26, revised 2026-07-02, not
  adopted and not in the Official Journal, with first labels expected
  2027-08-15. A grade produced from it is not a regulatory determination.
- **WUE is deliberately absent.** The instrument sets the grade from PUE *and*
  WUE, and only the PUE bands were read from it. Inventing WUE boundaries to
  complete the set would be exactly the failure this design prevents: a
  threshold with no provenance, presented as though it had one. A test asserts
  that a composite built from this pack reports `covers(&["pue","wue"]) ==
  false`, so a half-graded facility cannot read as graded.
- **The instrument permits calculation and estimates**, not only measurement, so
  a PUE fed to this scale may be self-declared. The scale bands whatever number
  it is given and says nothing about how that number was acquired.

The scale id is a version and is never edited in place. Ratings cite their
`scale_id` and `comparable_with` refuses to rank across scales, which only works
if an id means one fixed set of boundaries forever — so a changed instrument is
a new id, never an edit that would silently re-band grades already issued.

The pack is tested, not merely committed: it is `include_str!`-ed, deserialized,
validated and banded, and the test pins that its last boundary is **1900** —
this file's own example fixture uses 2000, and only one of the two is sourced.

Verified: 52 jouleclaw-compliance tests pass (2 new).

Co-Authored-By: Claude Opus 5 <[email protected]>
2026-09-06 06:24:25 -04:00

18 lines
1.9 KiB
JSON

{
"scale_id": "eu.eed.dr2026.pue/1",
"instrument": "Draft delegated regulation establishing an EU-wide scheme for rating the sustainability of data centres, with an electronic label",
"instrument_status": "DRAFT — registered 2026-03-26, revised draft dated 2026-07-02. NOT adopted, NOT in the Official Journal.",
"first_labels_expected": "2027-08-15",
"graded_metrics_in_instrument": ["pue", "wue"],
"metrics_in_this_pack": ["pue"],
"omitted_deliberately": {
"wue": "The instrument sets the A-G grade from PUE and WUE together, but this pack ships only the PUE bands, because only those were read from the instrument text. Inventing WUE boundaries to complete the set would be precisely the failure BandingScale exists to prevent: a threshold with no provenance, presented as if it had one. A composite grade built from this pack alone covers one axis, and CompositeRating::covers reports that it does."
},
"reuse": "Commission documents are reusable under Decision 2011/833/EU (CC BY 4.0). This pack restates threshold values only; it reproduces no instrument text.",
"read_on": "2026-08-29",
"caveats": [
"A grade produced from this scale is NOT a regulatory determination. The instrument is a draft; its thresholds may change before adoption, and the scheme's own assurance requirements are not modelled here.",
"The instrument permits measurement AND calculation methods, with an explicit fallback to well-founded assumptions and estimates. A PUE fed to this scale may therefore be self-declared. The scale bands whatever number it is given and says nothing about how that number was acquired — carry the acquisition class alongside it.",
"This pack supersedes no earlier reading. If the adopted instrument differs, that is a NEW scale_id (eu.eed.dr2026.pue/2 or a successor), never an edit to this file: ratings cite the scale_id, so editing in place would silently re-band every grade already issued."
]
}