Evidence Pack Contract
[!IMPORTANT] Non-Normative Document
This document is informative only.
[!NOTE] Verified Source Model This page is a Documentation-surface first projection of the current public contract model verified for Validation Lab:
- public contract surface authority:
Validation_Lab/app/policies/contract/page.tsx- supporting contract provenance:
Validation_Lab/governance/contracts/- supporting coverage provenance:
Validation_Lab/governance/COVERAGE_GOVERNANCE_ADDENDUM.mdThis docs page does not replace the Lab public contract surface. It summarizes that verified source model.
Current Public Contract Model
The current Validation Lab contract story is not a single markdown-file projection. It has two layers:
| Layer | Verified Asset | Role |
|---|---|---|
| Public contract authority | Validation_Lab/app/policies/contract/page.tsx | Current public contract surface for /policies/contract |
| Supporting contract provenance | Validation_Lab/governance/contracts/*.md plus coverage addendum | Supporting governance references and provenance |
That means this docs page should be read as a reference projection of the current contract model, not as the contract authority surface itself.
What is an Evidence Pack?
An evidence pack is the input to the Validation Lab adjudication model. It contains the evidence artifacts, timeline material, and integrity data that a ruleset evaluates.
Validation Lab does not run your code or accept uploads for execution. Evidence packs are generated in your own environment and then evaluated against versioned rulesets.
Current Contract Components
The current supporting contract provenance includes:
| Contract Asset | Current Role |
|---|---|
evidence-pack-contract-v1.0.md | Core evidence-pack contract |
evidence-pack-contract-v1.1.md | Additive substrate metadata addendum |
admission-criteria-v1.0.md | Admission criteria before adjudication |
ruleset-contract-v1.0.md | Ruleset structure and compatibility model |
pointer-contract-v1.0.md | Evidence pointer structure for determinations |
Current Version Model
The current contract and compatibility story is:
| Domain | Current Verified Expression | Where It Comes From |
|---|---|---|
| Evidence pack contract core | 1.0 | evidence-pack-contract-v1.0.md |
| Additive substrate metadata addendum | 1.1 | evidence-pack-contract-v1.1.md |
| Ruleset-declared contract compatibility | evidence_pack_contract: 1.0 | Validation_Lab/data/rulesets/*/manifest.yaml |
| Pack version compatibility range | min_pack_version: 1.0, max_pack_version: 1.x | Validation_Lab/data/rulesets/*/manifest.yaml |
Older Lab materials may still mention pack-v0.x labels.
For the current verified contract story, this page follows the contract and compatibility fields now declared in the supporting contract assets and current ruleset manifests.
Evidence-Pack Structure
The core evidence-pack contract still centers on the same high-level input groups:
| Component | Purpose |
|---|---|
manifest.json | Pack metadata, compatibility declarations, and integrity anchors |
artifacts/ | Module outputs and other evidence artifacts |
timeline/ | Event sequence material such as events.ndjson |
snapshots/ | Optional state snapshots and diffs |
integrity/ | Checksums and pack-level integrity files |
For exact required fields and compatibility details, use the supporting contract assets listed above and the current public contract surface.
Export Contract Is Related, But Separate
export/curated-runs.json belongs to the Lab export contract surface.
It is related to evidence-pack adjudication, but it is not itself the evidence-pack input contract.
So treat these as separate layers:
- Evidence-pack input contract: what a producer must generate for adjudication
- Export contract surface: what the Lab publishes outward for consumers after curation / adjudication
That separation matters because earlier docs drift mixed the input-pack story with the outward export surface.
How to Use This Page
Use this page as a Documentation reference projection when you need to:
- understand the current public contract model,
- locate the authority surface for
/policies/contract, - and distinguish input evidence-pack requirements from export-surface artifacts.
If you need the live Lab contract authority page, use Lab Site: Contract Policy.
Related Resources
- Validation Lab Overview — Four boundaries and terminology
- Lifecycle Guarantees — Current guarantees source model
- Ruleset Reference — Current ruleset source model
- Lab Site: Contract Policy — Current public contract surface