fy59/trainlog
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trainlog/format
History
fy59 9d9a9223a0 Define Trainlog v1 freeze candidate
2026-09-05 19:22:37 +02:00
..
README.md Define Trainlog v1 freeze candidate 2026-09-05 19:22:37 +02:00
trainlog-v1.schema.json Define Trainlog v1 freeze candidate 2026-09-05 19:22:37 +02:00

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.