E0208: reference simulator error on sample N
What happened
The reference SimBackend returned an error when running sample sample_idx during a conformance harness run. Unlike E0207 (which is a backend-under-test error), this error comes from the reference simulator itself.
Why
The reference simulator should never fail on a valid artifact and a valid input. If it does, one of the following is true:
- The artifact is invalid (corrupted or malformed — check with
thrindex doctor --check)
- The fixture file is malformed (invalid JSON, wrong shape)
- There is a bug in the reference simulator (please file a bug report)
This is always a harness or artifact problem, never a property of the backend under test.
How to fix
- Verify the artifact:
thrindex doctor --check <artifact.thx>. If it reports any errors, recompile.
- Verify the fixture file: inspect the sample JSON file at the reported sample index. Confirm it is valid JSON with the correct
spikes field shape.
- Run the simulator directly on the failing sample:
thrindex run <artifact.thx> --stdin < fixture_N.json. If it fails, this confirms an artifact or fixture issue.
- If the artifact and fixture are valid and this error occurs, please file a bug at https://github.com/thrindex/thrindex/issues.
Example