# Reproduction Scripts Coverage

This project includes reproduction scripts in `tests/repro/` that verify specific spec compliance and bug fixes. These scripts are automatically included in CI/gate execution via pytest-collectable wrappers.

## Test Discovery

Reproduction scripts are made pytest-visible through wrapper modules:

```
tests/repro/
├── __init__.py                                            # Package marker
├── issue_spec_compliance_verify_spawn.py                 # Repro script (standalone)
├── test_spec_compliance_verify_spawn.py                  # Pytest wrapper
├── issue_spec_compliance_verify_meta_and_interact.py     # Repro script (standalone)
└── test_spec_compliance_verify_meta_and_interact.py      # Pytest wrapper
```

## Execution

All tests (including repro scripts) are executed via standard pytest commands:

```bash
# Run all tests (default CI/gate command)
uv run pytest

# Run specific repro test
uv run pytest tests/repro/test_spec_compliance_verify_spawn.py

# Run all repro tests
uv run pytest tests/repro/
```

## Adding New Repro Scripts

When adding a new reproduction script:

1. Create the repro script: `tests/repro/issue_*.py`
2. Create a pytest wrapper: `tests/repro/test_*.py` that imports and calls the repro function
3. Ensure `tests/repro/__init__.py` exists (package marker)

Wrapper template:

```python
"""Pytest collectable wrapper for issue_* repro."""

import pytest
from .issue_name import repro_issue_name


def test_issue_name():
    """Brief description of what the repro verifies."""
    repro_issue_name()
```

## CI Integration

The repro scripts are automatically executed in:

- **Local development**: `uv run pytest` (discovers all tests by default)
- **CI workflows**: Part of standard test suite via pytest configuration in `pyproject.toml`

No special CI configuration needed — pytest's default discovery includes all `test_*.py` files in the `tests/` directory tree.