caml-trace

CAML-Trace is a minimal JSONL runtime trace format + validator for CAML adventures and simulations.

- Easy to emit from any engine/tool (Unity, Foundry, Ink glue, sims)
- Easy to validate (JSON Schema + optional ref checks against a CAML module)
- Useful immediately for debugging, replay, and analytics

Install

``bash
npm install -g caml-trace
`

Validate

Schema-only:

`bash
caml-trace validate trace.jsonl
`

Schema + reference checking against a CAML module:

`bash
caml-trace validate trace.jsonl module.caml.json
`

Machine-readable:

`bash
caml-trace validate trace.jsonl module.caml.json --json
`

Summarize

`bash
caml-trace summary trace.jsonl
`

Files

- Schema: schema/caml-trace.v0.1.schema.json
- One-page spec: docs/CAML-Trace-OnePage.md`

License

MIT