AGENTS.md@infrastructure/doctor/detectors · git:20260529.44ffb76 · 2026-05-29 · sha256 bb00c34a3bfcd053

AGENTS.md@infrastructure/doctor/detectors git:20260529.44ffb76A

Immutable. This exact content is served forever at /api/v1/blob/bb00c34a3bfcd053.

# Doctor detectors package

## Public API

- `DETECTORS: tuple[DetectorFn, ...]` — canonical registration order (`registry.py`)
- `run_detectors(repo_root, selected=None) -> list[Finding]` — crash-isolated runner
- Individual `detect_*` functions re-exported for tests and CLI wiring

## Invariants

- Detectors are idempotent and side-effect free (read-only probes only).
- A detector exception becomes a CRITICAL `DOC000[fn]` finding; never aborts the run.

## Tests

```bash
uv run pytest tests/infra_tests/doctor/test_detectors.py -q
```