katra-core — the shared vocabulary of Katra3D.
Every other crate builds on the types defined here so that the semantic request graph, the trace format, the profiler, the reporters, and the runtime subsystems can cooperate directly without FFI boundaries.
This crate intentionally contains no unsafe code and no I/O. It is the vocabulary, the error model, and the policy types.
Format stability discipline
Several types here are serialized into the Katra trace format
(katra-trace). Enum layouts are serialized by variant index, therefore:
- Append-only evolution: new enum variants must be appended at the end.
- Any layout-affecting change must bump the trace format version and/or the
schema hash (see
katra-trace::header).