Version: 1.0
Status: Released 2026-10-26, tag spec-1.0
Latest release: 1.0, tag spec-1.0
The METAIS specification
METAIS is a format for packages: single files that turn input data into finished files, carrying their templates, a data specification saying which data they need and what it means, and optionally references, assets and examples. This document specifies the format, the operations a conforming program performs on a package, and the suite of vectors that proves a program's conformance.
Contents
- Introduction
- Container
- Manifest
- Versions
- Data specification
- Supplying inputs
- Template environment
- Filters and tags
- Outputs
- Transforms
- Rendering
- Findings
- Authoring
- Security
- Conformance
- Appendix A. References
- Appendix B. A worked package
- Appendix C. Currency minor units
- Changelog
- Errata
- The conformance suite
- The published schemas
- The finding-code registry
How to read this document
Start with chapter 1: it states what the document covers, how its normative
language is read, the conformance classes, the terms and notation every other
chapter uses, and the statement areas each chapter owns. Each chapter then
opens with a status line, saying whether it is normative and which areas it
owns, and a summary paragraph, which is informative. Every rule is a numbered
statement whose identifier, such as MTS-OUT-012, never changes and is the
way to cite it; section numbers may change between revisions. An author new
to METAIS can begin with appendix B, which builds a package step by step, and
look up each rule as it is used.
The status block above names the revision this text describes. Draft means
the revision is not yet released: its text may still change, and the exact
bytes of a released revision are at its spec-<MAJOR>.<MINOR> tag. The
specification and its conformance vectors are licensed under the Apache
License 2.0, like the rest of this repository.