Skip to content

Commit 5e653cc

Browse files
SFC correctness example
1 parent dd93e52 commit 5e653cc

3 files changed

Lines changed: 238 additions & 90 deletions

File tree

ADOPTION.md

Lines changed: 26 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -347,7 +347,7 @@ never positioning against it.
347347

348348
## 8. Possible objections — each pre-empted in the draft text
349349

350-
*(Revision **-04** is the latest — being submitted; schema label `"2.0"`. It renames the
350+
*(Revision **-04** is the latest — posted to the Datatracker, under ISE review; schema label `"2.0"`. It renames the
351351
requested suffix to `sustainability-data`, adds the optional `target-type` member, and
352352
applies a final audit round: a CORS recommendation (`Access-Control-Allow-Origin: *`) for
353353
browser clients, an all-or-none array rule for `target-type`, client tolerance for
@@ -380,9 +380,9 @@ for redirects, revalidation, and rate limiting. Every answer below reflects -04.
380380

381381
## 9. Readiness evidence (in this repository)
382382

383-
- Draft at **draft-besleaga-sustainability-wellknown-04** — the latest revision, being
384-
submitted; the prior -03 (posted to the Datatracker 2026-07-23) is under ISE review as
385-
an Independent Submission. The series continues and replaces the
383+
- Draft at **draft-besleaga-sustainability-wellknown-04** — the latest revision, posted
384+
to the Datatracker and under ISE review as an Independent Submission (the prior -03 was
385+
posted 2026-07-23). The series continues and replaces the
386386
draft-besleaga-green-sustainability-wellknown -00–-05 series, with the Datatracker
387387
"Replaces" relationship recorded. Revisions build strict-clean (`xml2rfc --strict`,
388388
0 warnings; idnits **0 errors**); all references verified against authoritative sources,
@@ -399,13 +399,13 @@ for redirects, revalidation, and rate limiting. Every answer below reflects -04.
399399
- **Dual formal schemas** (JTD + CDDL) with two independent validation toolchains (the
400400
Python `jtd` package; the Ruby `cddl` gem) — 5 repository examples and 6 in-draft
401401
examples, each passing both validators.
402-
- A **production reference gateway** (TypeScript, a 120-test suite, all passing) with adapters for
402+
- A **production reference gateway** (TypeScript, a 128-test suite, all passing) with adapters for
403403
static/computed, Kepler/Prometheus, Climatiq, CO2.js and the carbon.txt hosted API
404404
(Green Web Foundation), Salesforce NZC, Microsoft Sustainability Manager, and Watershed —
405405
every adapter's output validates against both schemas, and the gateway enforces the
406406
draft's MUSTs that schemas cannot express (sci-score/functional-unit coupling, array
407407
ordering and uniformity, single-object response rules, deterministic noise).
408-
- A **reference client** (`consumer/`, TypeScript, a 127-test suite, all passing; also
408+
- A **reference client** (`consumer/`, TypeScript, a 148-test suite, all passing; also
409409
published to npm as
410410
`sustainability-wellknown-consumer`) that complements the publisher: it fetches,
411411
defensively validates, transforms (CSV/NDJSON/flatten/trend), and conformance-checks a
@@ -414,6 +414,24 @@ for redirects, revalidation, and rate limiting. Every answer below reflects -04.
414414
**two independent, interoperating implementations** (producer and consumer), not just one.
415415
- CI that rebuilds the draft and cross-validates generated documents.
416416

417+
- **Independent research-framework symbiosis (a working correctness example).** The draft
418+
already serves as the disclosure layer for an independently defined, ACM accepted-to-be-published
419+
evaluation framework: Sustainability-First Consensus (SFC, DOI 10.1145/3809296) sets
420+
measurable sustainability criteria for distributed-ledger systems — an annualized energy
421+
cap, hardware-lifecycle responsibility, GHG Scope 2/3 carbon accountability, and
422+
CSRD/ESG-compatible auditability — and that last criterion is satisfied *directly* by
423+
publishing a conformant `/.well-known/sustainability-data` document, while the energy cap
424+
becomes mechanically checkable from the document's own members (an annual
425+
`reporting-period` with `energy-consumption` < 1 and `energy-unit: "GWh"`). The
426+
field-level mapping is worked out member-by-member in
427+
[sfc-compliance/SFC.md](sfc-compliance/SFC.md) and implemented by the reference
428+
publisher's adapters and unit normalization — evidence of two things reviewers care
429+
about: the schema is expressive enough to carry an external framework's requirements
430+
without any extension to the specification, and the draft functions as neutral
431+
infrastructure that independent research and evaluation frameworks (not just this
432+
author's) can build on. One RFC, many frameworks — the well-known document is the common
433+
disclosure surface they all lack today.
434+
417435
## 10. Process fit: the Independent Submission Stream
418436

419437
- **Right stream (RFC 4846).** An individual, application-layer convention with no IETF WG
@@ -548,8 +566,8 @@ model of the specification:
548566
with IETF work"; process detail in §10).
549567
7. **Running code, both sides of the wire.** Two interoperating reference
550568
implementations (publisher with nine adapters; consumer/validator), dual
551-
independent schema validators (JTD and CDDL), 247 automated tests (120 publisher +
552-
127 consumer, all passing, verified 2026-07-26), real nginx/Apache deployment
569+
independent schema validators (JTD and CDDL), 276 automated tests (128 publisher +
570+
148 consumer, all passing, verified 2026-07-27), real nginx/Apache deployment
553571
configurations exercised in CI, and every example in the draft validated against
554572
both schemas on every commit (details in §9). Few well-known registrations arrive
555573
with this much implementation evidence.

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Sustainability data about digital services exists today — inside enterprise ca
6161

6262
* **Nothing in the IETF/IRTF space defines this.** No active or expired Internet-Draft or RFC specifies an application-layer sustainability disclosure format or well-known URI: the GREEN WG *excludes* carbon accounting and reporting by charter (its scope is network-device YANG management), and the adjacent expired drafts (sustainability-insights, green-metrics) were network-telemetry proposals with no disclosure endpoint. This draft is the only proposal of its kind on the Datatracker.
6363
* **The nearest neighbor is complementary, not competing.** carbon.txt (Green Web Foundation) is a discovery *index* — a TOML file of links to disclosure documents that, in its own maintainer's words, "contains no quantitative metrics." This proposal publishes the metrics themselves; the two specs cross-reference each other by design.
64-
* **First in the registry's history.** The IANA Well-Known URIs registry has never contained a sustainability, carbon, green, energy, or ESG entry, and this registration request (issue #95, June 2026) is the first sustainability-related request ever filed there — it creates the category's anchor rather than joining a crowd.
64+
* **First in the registry.** The IANA Well-Known URIs registry has never contained a sustainability, carbon, green, energy, or ESG entry, and no other sustainability-related request was found in the registry's public review queue — this registration request (issue #95, June 2026) creates the category's anchor rather than joining a crowd.
6565
* **Everything else is proprietary, regulated-filing-shaped, or advisory.** Enterprise carbon platforms (Salesforce, Microsoft, Watershed) expose per-vendor, authenticated APIs with incompatible shapes; regulatory formats (ESRS/XBRL filings, the DPP) are entity-level compliance documents, not web-discoverable machine endpoints; the W3C's Web Sustainability Guidelines are guidance, not a data format. None of them gives an arbitrary consumer a fetchable, validated document at a known URL.
6666
* **Most complete by construction.** No other effort combines, in one specification: fixed-location discovery *and* the quantitative metrics themselves; a declared reporting subject that spans organizations, sites, paths, devices, cloud tenants, and products; a mandatory methodology link plus optional signed attestations; dual formal schemas (CDDL + JTD); full security *and* privacy treatment (DoS caps, path-disclosure defense, fingerprinting noise, consumer hardening); explicit legacy compatibility and collision-proof extensibility; and two interoperating open-source implementations with 276 automated tests proving both sides of the wire. It arrives not as an idea but as a finished, running system.
6767
* **Future-compatible with everything — by design, not by promise.** The must-ignore rule plus open schemas mean any future metric (water use, hardware lifecycle, embodied carbon, whatever the next regulation demands) can be added by anyone, immediately, without touching the RFC or IANA: vendors extend today via collision-proof reverse-domain member names (`com.example.pue`), future revisions extend via the reserved undotted namespace, and the change-controlled `version` label records provenance without ever gating processing. The same tolerance rules that absorb the future also absorb the past — historical 1.x documents remain readable by current clients. Publishing the RFC freezes the text, not the ecosystem: nothing that matters is locked in, and no deployed client is ever stranded.
@@ -115,7 +115,7 @@ rfc-sustainability-wellknown/
115115
├── publisher/ # Production publisher/gateway (TypeScript): adapters → conformant /.well-known/sustainability-data
116116
├── consumer/ # Reference client (TypeScript): fetch, validate, transform a /.well-known/sustainability-data document
117117
├── discovery/ # Product discovery: market scan, opportunity, problem, requirements, PRD, spec
118-
├── sfc-compliance/ # SFC framework compliance matrix (relationship to the ACM SFC framework)
118+
├── sfc-compliance/ # SFC framework alignment (relationship to the ACM SFC framework)
119119
└── ADOPTION.md # The case for RFC/IANA adoption (business, technical, regulatory benefits)
120120
121121
```
@@ -324,7 +324,7 @@ same lifecycle against the current (schema-`2.0`-model) sources.
324324
## Discovery & SFC compliance
325325

326326
* [discovery/](discovery/) — product discovery suite (market scan, opportunity assessment, problem statement, requirements, PRD, technical spec) framing the gateway against the enterprise carbon-accounting ecosystem, plus [a deep-research companion to the draft](discovery/07-greenweb-carbontxt-integration.md) on the Green Web Foundation / carbon.txt / CO2.js integration.
327-
* [sfc-compliance/SFC.md](sfc-compliance/SFC.md) — additional optional appendix on how this draft and the publisher relate to the Sustainability-First Consensus (SFC) framework, with a field-level compliance matrix.
327+
* [sfc-compliance/SFC.md](sfc-compliance/SFC.md) — additional optional appendix on how this draft and the publisher relate to the Sustainability-First Consensus (SFC) framework, with a field-level mapping (article concept → draft member).
328328

329329

330330
## CHANGELOG

0 commit comments

Comments
 (0)