XGML (Extensible Graph Markup Language) defines a structured reasoning contract: claims, evidence, proofs, and Ed25519 signatures that survive model boundaries and regulatory scrutiny.
Every XGML document is a directed acyclic graph of typed nodes. The type system is closed at v1.0.0 — extensions go through the spec process.
XGML is JSON. No binary encoding, no proprietary tooling. Any language that can parse JSON can read or produce XGML.
{
"xgml_version": "1.0.0",
"document_type": "CAUSAL_PROOF_GRAPH",
"nodes": [{
"id": "theorem_bft_safe",
"type": "THEOREM",
"status": "PROVED",
"name": "bft_safe",
"lean_ref": {
"file": "Byzantine.lean",
"line": 42
}
}],
"edges": [{
"source": "theorem_bft_safe",
"target": "def_bft_threshold",
"type": "DEPENDS"
}],
"root_hash": "c340c373...",
"signature": {
"algorithm": "Ed25519",
"issuer": "Aevion LLC"
}
}
Pick the track that fits your team. All three interoperate — a producer's output validates against the same schema a governance participant helped write.
Parse and validate XGML documents against the schema. Confirm that every claimed proof node has a valid Lean reference and that the Ed25519 signature chain is intact.
Emit XGML from your Lean 4 corpus or proof system. The reference exporter converts lake build artifacts into signed, graph-structured XGML documents automatically.
Participate in spec evolution via GitHub discussions. Propose new node types, edge semantics, or signature schemes through the formal RFC process before they enter the versioned schema.