Omnist documentation

This folder is the source for the VitePress docs site (docs.yml deploys it to GitHub Pages on push to master). Start here, in roughly this order:

Doc	What it covers
Quickstart	The shortest possible tour.
User guide	The practical tour -- documents, OML, OSD and the builder functions, validation, the schema operations, codecs, inference.
The Schema model & OSD	record definitions, cardinality, the builder functions, and the comparison/inference operations.
A real-life example	One order schema validated against an order written in OML.
API reference	Every public name with signatures.
CLI	The omnist command-line tool.
Formats	How each format maps to the model -- OML / JSON / YAML / TOML / XML.
Spec: formal model, grammars & algebra	The normative Document/Schema models, OML/OSD grammars, and schema algebra -- language-agnostic, authoritative for every omnist port.
Glossary	One definition per term used across the docs and code.
Testing	The test suite: layout, coverage tooling and target, fuzzing, the semantic oracle, and the doc-example CI gate.
Repo layout	How the repo is organized: src/*.ts responsibilities, the docs page map, the test file map.