Specification · draft

Draft. This is the draft of the METAIS specification at commit f7f57020f4fe5067f6107bae90bb3ae07e1fa803, not a released revision. It may change before it is released.

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

  1. Introduction
  2. Container
  3. Manifest
  4. Versions
  5. Data specification
  6. Supplying inputs
  7. Template environment
  8. Filters and tags
  9. Outputs
  10. Transforms
  11. Rendering
  12. Findings
  13. Authoring
  14. Security
  15. Conformance

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.