Add datasource quality and schema gates

2026-08-04 11:23:14 +02:00
parent a6d5c9839d
commit 075d2fc087
16 changed files with 1305 additions and 10 deletions
@@ -76,6 +76,14 @@ A stage records schema, row and byte counts, fingerprint, validation result,
 provenance, and intended target. Promotion either creates a datasource or adds
 a new immutable materialization to an existing compatible datasource.

+For bounded tabular stages, the Datasource quality policy now enforces row,
+field, nullability, uniqueness, numeric range, and embedded referential-set
+rules. Updates receive a deterministic compatible, warning, or breaking schema
+classification. Errors and breaking changes keep a stage inspectable but block
+promotion; warnings remain visible and promotable. The policy hash, diagnostics,
+and schema diff are retained with the promoted materialization evidence. See
+[QUALITY_POLICY.md](QUALITY_POLICY.md) for the contract and its privacy bounds.
+
 The first slice stores bounded tabular JSON/CSV stages. Future providers may
 stage file references, object-store blobs, directory snapshots, or streaming
 checkpoints through the same lifecycle contract.