fy59/trainlog
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trainlog/format/README.md
fy59 3d5f9a2bef Freeze Trainlog exchange format v1
2026-09-05 19:28:26 +02:00

668 B
Raw Blame History

Trainlog Format

This directory contains the machine-readable Trainlog exchange contract.

Current canonical state:

GATE_0=PASS
GATE_1_REVIEW_01=PASS
GATE_1_REVIEW_02=PASS
GATE_1=PASS
TRAINLOG_FORMAT_V1=FROZEN

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.