Core idea
V1 closes the trust gap with three guarantees:- Scope — only approved tables and joins
- Meaning — governed metric definitions
- Safety — policy-enforced execution (PII, limits, time filters)
V1 building blocks
| Layer | Purpose | Primary files |
|---|---|---|
| Semantic model | Deterministic metrics and joins | semantics/semantic_model.yml |
| Business rules | Guidance and domain constraints | semantics/business_rules.yml |
| Dataset bundles | Allowed tables + join graph | datasets/<bundle_id>/dataset.yaml |
| Policy | Enforceable constraints | policies/policy.yml |
| Execution contracts | Per-query audit artifact | contracts/runs/*.json |
Runtime flow
- User asks a question.
- Agent calls
build_contract. - Policy engine returns
allow,block, orneeds_clarification. - If allowed, execution runs with
contract_id. - Contract is persisted for provenance.
Strict vs compatibility mode
policies/policy.yml controls runtime strictness:
false: backward-compatible behaviortrue: strict contract gating (recommended for production)
Why V1 matters
- Consistent revenue-style metrics across LLMs
- Deterministic PII blocking
- Query boundary control with dataset bundles
- Auditable artifacts for compliance and debugging
Validation and testing
Run
dazense validate, dazense eval, and dazense eval --engine