Metric Contracts
Formal, versioned agreements on what each metric means. Revenue = X, signed by CFO. When Orion answers, it cites the active contract.
Why use it: Eliminate "whose definition is right?" arguments. When Revenue v2 is signed by the CFO, that's what Orion uses.
Where to find it: Suite → Governance → Contracts
Who can use it: Weaver and Luminary can create and sign contracts. All roles see contract citations in Orion answers.
Metric Contracts
Formal, versioned agreements on what each metric means. Revenue = X, signed by CFO. When Orion answers, it cites the active contract. When two definitions conflict, it flags which contract applies.
Creating a contract
Suite → Governance → Contracts → "New Contract"
What a contract contains
| Field | Description |
|---|---|
| Metric name | The canonical name (e.g. revenue) |
| SQL definition | The exact query that produces this metric |
| Plain English description | What it means in business terms |
| Signed by | Name and role of the person signing |
| Signature date | When the contract was signed |
| Notes | Optional context (edge cases, exclusions, etc.) |
Versioning
Contracts are versioned. When you update a definition:
- v1 is preserved and marked as superseded
- v2 becomes active immediately
- Full version history is always available under the contract detail page
This means you can answer "what did Revenue mean in Q1?" by looking at which version was active at that time.
How Orion uses contracts
Every Orion answer that involves a contracted metric cites the active contract:
"Source: orders_analysis · Contract: Revenue v2 · Aisha (CFO)"
If a metric appears in multiple contracts, Orion flags the conflict and shows which version it used and why.
Conflict resolution
When Orion detects two active contracts that define the same metric differently, it:
- Notes the conflict in the answer provenance footer
- Uses the most recently signed contract
- Flags the conflict in the Lumen Metric Conflicts panel
Resolve conflicts in the Metric Conflicts panel — either archive one version or update both to share a definition.