> This page is for version 0.5.0.
> For other versions, use one of these documentation indexes:
> - Main (default): https://docs.nvidia.com/nemo/gym/main/llms.txt
> - 0.7.0: https://docs.nvidia.com/nemo/gym/v0.7.0/llms.txt
> - 0.6.0: https://docs.nvidia.com/nemo/gym/v0.6.0/llms.txt
> - 0.5.1: https://docs.nvidia.com/nemo/gym/v0.5.1/llms.txt
> - 0.5.0: https://docs.nvidia.com/nemo/gym/v0.5.0/llms.txt
> - 0.4.0: https://docs.nvidia.com/nemo/gym/v0.4.0/llms.txt
> - 0.3.0: https://docs.nvidia.com/nemo/gym/v0.3.0/llms.txt
> - 0.2.1: https://docs.nvidia.com/nemo/gym/v0.2.1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/gym/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/gym/_mcp/server.

# nemo_gym.eval.comparison.suite.failures

Read saved run failure accounting without scanning rollout records or attempt history.

## Module Contents

### Functions

| Name                                                                                      | Description                                                                             |
| ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| [`read_saved_failures`](#nemo_gym-eval-comparison-suite-failures-read_saved_failures)     | Read this rollout file's existing coverage snapshot; absent accounting remains unknown. |
| [`saved_failure_warning`](#nemo_gym-eval-comparison-suite-failures-saved_failure_warning) | Summarize positive saved counts or unavailable accounting in one advisory line.         |

### Data

[`_COUNT_KEYS`](#nemo_gym-eval-comparison-suite-failures-_COUNT_KEYS)

### API

```python
nemo_gym.eval.comparison.suite.failures.read_saved_failures(
    path: pathlib.Path
) -> nemo_gym.eval.comparison.suite.schema.SuiteFailureSummary | None
```

Read this rollout file's existing coverage snapshot; absent accounting remains unknown.

The saved counts cover the entire rollout file, including every agent and benchmark.
This reader neither refreshes the snapshot nor interprets historical failure rows.

```python
nemo_gym.eval.comparison.suite.failures.saved_failure_warning(
    summary: nemo_gym.eval.comparison.suite.schema.SuiteFailureSummary
) -> str | None
```

Summarize positive saved counts or unavailable accounting in one advisory line.

```python
nemo_gym.eval.comparison.suite.failures._COUNT_KEYS = {'total': 'failed', 'final': 'failed_final', 'not_final': 'failed_not_final', 'b...
```