Add pytest-cov for coverage reporting

Makefile

@@ -1,4 +1,4 @@
-.PHONY: setup cli migrate ingest test lint format
+.PHONY: setup cli migrate ingest test cov lint format
 
 setup:
 	uv sync
@@ -18,6 +18,10 @@ ingest:
 test:
 	uv run pytest
 
+cov:
+	uv run pytest --cov-report=html
+	@echo "HTML coverage report: htmlcov/index.html"
+
 lint:
 	uv run ruff check .
 

README.md

@@ -234,6 +234,7 @@ Every command runs through `uv run`, so you never need to activate the venv.
 | `make lint` | Run ruff (lint only, no changes) |
 | `make format` | Run black (rewrites files in place) |
 | `make test` | Run the pytest suite (requires Docker running) |
+| `make cov` | Run the suite and write a browsable HTML coverage report to `htmlcov/index.html` |
 
 ## Running checks locally
 

pyproject.toml

@@ -26,6 +26,7 @@ dev = [
     "black",
     "psycopg2-binary",
     "pre-commit>=4.6.0",
+    "pytest-cov>=7.1.0",
 ]
 
 [tool.ruff]
@@ -47,3 +48,8 @@ asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "session"
 asyncio_default_test_loop_scope = "session"
 testpaths = ["tests"]
+addopts = "--cov=src --cov-report=term-missing"
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["src/infrastructure/db/versions/*"]