diff --git a/schemes/README.md b/schemes/README.md index b870e71..962c715 100644 --- a/schemes/README.md +++ b/schemes/README.md @@ -4,7 +4,10 @@ A **scheme** is a concrete data-labelling or tool-annotation approach that fills the [`trust-annotations`](../specification/draft/trust-annotations.mdx) `evidenceRef` slot under an `evidenceRef.type` value. The extension defines a small, stable wire vocabulary and an open `type` pointer; a scheme defines the -richer, out-of-band record that pointer resolves to. +richer, out-of-band record that pointer resolves to. The wire vocabulary (notably +`sensitive`) is a lowest-common-denominator floor every client can act on; +schemes refine it for hosts that implement them, and a server that can classify +more precisely is encouraged to emit **both** the floor and a scheme record. Schemes are **not** extensions and **not** siblings of the extensions. They are interchangeable: a deployment can adopt one, several, or none, and can swap them diff --git a/schemes/data-class.md b/schemes/data-class.md index 74bf932..b59407c 100644 --- a/schemes/data-class.md +++ b/schemes/data-class.md @@ -94,7 +94,9 @@ The record is a JSON object. Shapes below are **open questions**, not settled: A client that does not implement `data-class.v1` ignores the record and relies on the `trust-annotations` `sensitive` boolean, which remains meaningful on its own. The scheme only ever *refines* the boolean; it never contradicts it (a -`data-class.v1` record only appears where `sensitive` is already `true`). +`data-class.v1` record only appears where `sensitive` is already `true`). Because +the boolean is the lowest-common-denominator floor, a producer of this scheme +SHOULD emit **both** the boolean and the record, never the record alone. ## Producer / consumer @@ -119,5 +121,5 @@ The scheme only ever *refines* the boolean; it never contradicts it (a ## Changelog -- **2026-06-17** — Initial skeleton. Payload shapes are candidates pending the +- **2026-06-16** — Initial skeleton. Payload shapes are candidates pending the open questions above.