[mgalore]

Summary

• add the suite_artifact pytest fixture for writing an indented, stable Suite.to_json() artifact when an eval row fails
• avoid creating artifacts for fully passing suites
• document the fixture and cover failure and pass behavior

Closes #1

Verification

• PATH="$PWD/.venv/bin:$PATH" .venv/bin/python -m pytest -q — 8 passed
• .venv/bin/python -m compileall -q src tests
• git diff --check

Risk

This is opt-in and uses only the standard library; it does not add required dependencies or affect existing fixtures.

[vk-ai]

Thanks — LGTM for #1.

Opt-in suite_artifact fixture is clean (stdlib only, skips on full pass). Local pytest: 8 passed.

One note vs the issue: you shipped a fixture instead of an auto-write pytest hook — preferable (explicit I/O). Empty suite → no file, which is fine.

Happy to merge.