trainlog/format/README.md

Trainlog Format

This directory contains the machine-readable Trainlog exchange contract.

Current canonical state:

GATE_0=PASS
GATE_1_REVIEW_01=IMPLEMENTED
GATE_1=VALIDATION_PENDING
TRAINLOG_FORMAT_V1=DRAFT

Files:

• trainlog-v1.schema.json: structural JSON Schema;
• ../docs/exchange_format.md: canonical semantic specification;
• ../tools/validate_json.py: executable structural + semantic validator.

The JSON Schema alone is not the complete Trainlog contract.

A document is valid only when it passes both structural and semantic validation.

After TRAINLOG_FORMAT_V1=FROZEN, incompatible changes require a new exchange-format version.