Documentation / VFX-E-1602

VFX-E-1602

Title

NoRecognisableEvents

Explanation

The events file was read but contained no recognisable vouchfx event. The file exists and was readable — this is not a VFX-E-1004/VFX-E-1005 condition — but nothing in it matched any known event shape, so explain_run/diagnose_run had nothing to diagnose.

Common causes

  • The file at eventsPath exists and is readable but contains no lines matching any known vouchfx event shape — for example, it is empty, or holds unrelated JSON Lines content.
  • The events file was truncated or corrupted before being read (for example, the run process was killed mid-write).
  • eventsPath points at the wrong file entirely — a general log file rather than the run's actual JSON Lines event stream.

Fixes

  • Confirm eventsPath points at the events file run_suite returned as eventsFilePath, not some other log output.
  • Re-run the suite with run_suite and use the events path it returns directly, without hand-editing it.
  • Open the file and inspect its first few lines to confirm it genuinely contains vouchfx JSON Lines events.