EuConform Evidence Format
April 21, 2026 · View on GitHub
EuConform implements the EuConform Evidence Format, an open specification for portable, machine-readable AI compliance evidence.
Document types
Stage 1 — Stable
| Document | Purpose |
|---|---|
euconform.report.v1 | Compliance-oriented evidence, open questions, gaps, and recommendations |
euconform.aibom.v1 | AI Bill of Materials (AI BOM) inventory for runtimes, providers, models, and supporting components |
euconform.aibom.v1.1 | AI BOM v1 plus optional import provenance metadata |
euconform.ci.v1 | CI gate status, fail threshold, gap counts, and top findings |
Stage 2 — Available
| Document | Purpose |
|---|---|
euconform.bundle.v1 | Integrity and transport manifest binding artifacts from a single scan run |
Positioning
- the format is currently documented as an open specification
AI BOMis a sub-specification inside the format, not the umbrella name
Interoperability
EuConform supports native artifact generation, empirical model evaluation, and external ingestion:
scangenerates native EuConform artifacts from a repositorybiasproduces reproducible model-behavior evidence via local CrowS-Pairs evaluation — EuConform's distinctive empirical layervalidatechecks EuConform JSON documents against the published schemasverifychecks bundle integrity for manifests, extracted directories, and ZIP archivesimportmaps external CycloneDX JSON into the AIBOM layer (emitseuconform.aibom.v1.1) as an interoperability bridge
Important boundaries:
biasis independent ofscanand can be used standalone for model evaluationimportdoes not replace a full native EuConform scan of a repositoryvalidateandverifycomplement each other: schema checks for individual documents, integrity checks for artifact sets
Versioning and compatibility
schemaVersionis the compatibility boundary for every document- Schemas enforce
additionalProperties: false— all fields must be explicitly defined - Published schema revisions should avoid changing document shape in place
- When new fields affect document shape or compatibility expectations, prefer a new schema revision (e.g.
report-v1.1.schema.json) because strict schemas reject unknown properties - Major schema changes must use a new
schemaVersion(e.g.euconform.report.v2)
Schemas
Examples
Document guides
Verification flow
- Build the CLI with
pnpm --filter @euconform/cli build - Generate native artifacts with
node packages/cli/dist/index.js scan . - Validate EuConform JSON documents with
node packages/cli/dist/index.js validate <path> - Optionally import a CycloneDX JSON file with
node packages/cli/dist/index.js import <path> - Optionally create a transport archive with
node packages/cli/dist/index.js scan . --zip true - Verify a manifest, bundle directory, or ZIP archive with
node packages/cli/dist/index.js verify <path> - Hash and metadata mismatches are warnings by default and become errors in strict mode
Reserved future document types
evalis reserved for evaluation results and benchmark outputs — third-party extensions should not claim this namespace