We currently have a great markdown document explaining the format, but a programmatic JSON schema would support docs creation, and in code validation from a single source of truth.
We could implement this by defining the json input as data classes in the code, and then generating json schemas and docs from it