Trust Model
Publisher verification, conformance scoring, and operational notices in YounndAI Domains.
Why Trust Matters
When an AI agent consumes a domain schema, it trusts the field definitions to be accurate. A malformed or misleading schema can cause data corruption, incorrect processing, or security vulnerabilities. The trust model provides built-in signals to help consumers evaluate quality.
Three Trust Fields
Every domain schema carries three trust fields at the top level:
- tier
- official | institutional | partner | community
- verified
- true | false
- score
- 0.0 – 1.0 (conformance confidence)
Tier
Indicates who published the domain and how it was reviewed:
| Tier | Prefix | Review Process |
|---|---|---|
| Official | yon.*, std.* | Curated by YounndAI. Platinum conformance. |
| Institutional | edu.*, gov.*, org.* | Identity-verified institution. Gold+ conformance. |
| Partner | <name>.* (verified) | Identity-verified entity. Gold+ conformance. |
| Community | com.* | Self-published. No external review. |
Verified
A boolean flag indicating whether the publisher's identity has been confirmed. Official, institutional, and partner domains are always verified. Community domains are not verified and have verified: false.
Score
A conformance confidence value between 0.0 and 1.0. Higher scores indicate better adherence to schema standards. Levels range from Platinum (1.0) through Gold (≥ 0.9), Silver (≥ 0.7), Bronze (≥ 0.5), down to Below (< 0.5).
The score evaluates type coverage, description completeness, naming conventions, constraint coverage, and parser roundtrip validity.
💡Tip
For the full scoring methodology, criteria breakdown, and tips on improving your score, see Conformance Scoring.
Notice System
Domains can carry an operational notice code that signals issues. The notice field is null when all clear, or a code like N001 when there's an advisory:
- N001
- Domain deprecation notice
- N002
- Migration advisory — newer version available
- N003
- Schema correction pending
- N004
- Sunset notice — domain will be archived
💡Tip
Always check the notice field before relying on a domain in production. A
non-null notice signals that the domain may require attention.
When to Trust vs. Verify
| Scenario | Recommended Action |
|---|---|
Official domain (yon.*) + score ≥ 0.9 | Trust directly |
| Verified publisher + score ≥ 0.9 | Trust with review |
| Unverified publisher | Always verify before production use |
| Score < 0.5 | Treat as draft quality |
| Non-null notice | Read notice before proceeding |