Interface: Governance

The governance attestation carried with a governed answer — confidence, Certified/Disputed provenance, the certified metrics it derived from, data freshness, and the snapshot timestamp. Mirrors the API's governance field. All fields optional: an ungoverned raw-SQL answer carries a sparse snapshot.

Properties

as_of?

optional as_of?: string | null

ISO-8601 time the snapshot was taken (for "confidence as of …").

---

breakdown?

optional breakdown?: Record<string, unknown> | null

Per-dimension breakdown + labels (schema/values/joins/…).

---

certified_metrics?

optional certified_metrics?: string[]

Certified metric names the answer derived from.

---

confidence_score?

optional confidence_score?: number | null

Headline confidence, 0–100.

---

fan_out?

optional fan_out?: Record<string, unknown> | null

{detected, enforced, measure_table} fan-out / double-count warning.

---

freshness?

optional freshness?: { column?: string; message?: string; } | null

{column, message} data-freshness label.

---

governed_derivation?

optional governed_derivation?: boolean

True when the measure compiled from a certified metric.

---

lineage?

optional lineage?: Record<string, unknown> | null

{tables, metrics} the number came from.

---

provenance_status?

optional provenance_status?: "proven" | "disputed" | null

Verify-and-prove verdict, or null when there's no certified definition.

---

rls_scope_note?

optional rls_scope_note?: string | null

Human note when the result was narrowed by row-level security.