Makefile

.PHONY: help install lint lint-fix format format-check typecheck securite arch check test test-watch benchmark ci mutation commit bump changelog docker-build docker-up docker-down clean

## Show this help
help:
	@grep -E '^## ' Makefile | sed 's/## /  /'

## Install dependencies and git hooks
install:
	uv sync --extra dev
	uv run pre-commit install

## Run lint (ruff)
lint:
	uv run ruff check src tests

## Auto-fix lint errors
lint-fix:
	uv run ruff check --fix src tests

## Format code (ruff format)
format:
	uv run ruff format src tests

## Check formatting without modifying files
format-check:
	uv run ruff format --check src tests

## Check types (mypy strict)
typecheck:
	uv run mypy src

## Static security analysis (bandit) + dependency vulnerabilities (pip-audit)
securite:
	uv run bandit -c pyproject.toml -r src
	uv run pip-audit

## Cyclomatic complexity check (xenon) — fails if average > A or any function > C
complexity:
	uv run xenon --max-average=A --max-modules=B --max-absolute=C src

## Check architecture import boundaries (tach)
arch:
	uv run tach check

## Lint + format + types + security + complexity + architecture (mirrors CI locally)
check: lint format-check typecheck securite complexity arch

## Run tests with coverage report (threshold: 80%)
test:
	uv run pytest

## Run tests in watch mode
test-watch:
	uv run pytest-watch

## Performance benchmarks on the domain (excluded from normal run)
benchmark:
	uv run pytest tests/examples/test_benchmarks.py --benchmark-only --benchmark-sort=mean

## Run the full CI pipeline locally, in order
ci: check test
	@echo "CI pipeline completed successfully."

## Mutation testing on the domain slice only (slow — reserve for PRs)
mutation:
	uv run mutmut run
	uv run mutmut results

## Interactive conventional commit (commitizen)
commit:
	uv run cz commit

## Bump version + update CHANGELOG.md (commitizen)
bump:
	uv run cz bump

## Regenerate CHANGELOG.md from commit history
changelog:
	uv run cz changelog

## Build the Docker image
docker-build:
	docker build --target runtime -t my-project .

## Start the stack (app + dependencies)
docker-up:
	docker compose up --build -d

## Stop the stack
docker-down:
	docker compose down

## Remove build and cache artefacts
clean:
	rm -rf .pytest_cache .mypy_cache .ruff_cache __pycache__ coverage.xml htmlcov
	find . -type d -name __pycache__ -exec rm -rf {} +