Entity trust
Every entity in the Registry carries a trust level from 0 to 5. It is a human judgement: a person saying how much they believe the description and the structure.
The scale
Section titled “The scale”| Level | Meaning |
|---|---|
| 0 | Unknown — introspected, nothing verified |
| 1 | Recognised — the source is real, the content is unreviewed |
| 2 | Partially reviewed — some columns described |
| 3 | Reviewed — described and checked against the source |
| 4 | Well established — relied on by certified metrics |
| 5 | Authoritative — a system of record for the business |
The scale is about how much you should believe the description, not how important the table is. An important table nobody has reviewed is level 0, and that is exactly the table most worth reviewing.
The certification threshold
Section titled “The certification threshold”Level 3 and above counts as automatically certified. Metrics built on a certified entity are treated as certified and do not need individual review.
This makes trust the highest-leverage governance setting: raising it on a source table promotes the whole family of metrics built on it, instead of leaving you to approve each one.
It also makes over-trusting expensive. Set level 3 only where the description matches the table, not because the table looks important.
Two different numbers
Section titled “Two different numbers”Entity trust (0–5) — a human judgement, set by an admin.
System trust (%) — a machine-computed percentage shown on metrics, derived from the underlying columns and their descriptions.
They answer different questions and routinely disagree. The system score measures description completeness; entity trust measures whether the description is true. A table can be fully described and entirely wrong.
Assigning trust
Section titled “Assigning trust”Set it per entity, or select several entities and apply a level to all of them at once — see admin Registry. Assigning in bulk is how you get a newly introspected source to a usable state quickly, then spend your effort on the tables that deserve level 4 or 5.
How it flows to answers
Section titled “How it flows to answers”A low-trust entity is a weaker basis for grounding, and the agent has less reason to treat its description as authoritative. High-trust entities — and the certified metrics built on them — are what make an answer defensible. This is the mechanism behind trustworthy numbers.