Makefile

.PHONY: bootstrap install dev install-dev lint typecheck test cov
.PHONY: bootstrap install dev install-dev lint typecheck test help format test-cov migrate clean

help: ## Show all targets
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  %-18s %s\n", $$1, $$2}'

bootstrap:
	pip install pip-tools
	pip-compile pyproject.toml --generate-hashes -o requirements.lock
	pip install -r requirements.lock
	pip install -e .

install:
	pip install -r requirements.lock

dev: install
	pip install -e ".[dev]"

lint:
	ruff check .

format:
	ruff format .

typecheck:
	mypy app/

test: ## Run tests
	pytest

cov:
	pytest --cov-branch --cov-fail-under=80 --cov=app/services/ --cov=app/utils/ --cov=app/db/
test-cov: ## Run tests with coverage
	coverage run -m pytest && coverage report -m

format: ## Format code with ruff
	ruff format .
modernize:	## Modernize Python syntax for 3.11+ with pyupgrade
	pyupgrade --py311-plus $(find . -path './.venv' -prune -o -name '*.py' -print)
migrate: ## Run alembic migrations
	alembic upgrade head

clean: ## Remove build artifacts
	rm -rf __pycache__ .pytest_cache .mypy_cache *.egg-info

welcome: ## Codespaces onboarding: install dev deps, verify env, run tests
	@echo "🚀 ApexChainx Backend – Codespaces onboarding"
	pip install -e ".[dev]"
	@echo "✅ Dependencies installed"
	python -c "from app.main import app; print('✅ app.main imports cleanly')"
	pytest --tb=short -q
	@echo "🎉 Welcome to ApexChainx! Everything looks good."

openapi-update: ## Regenerate docs/openapi.snapshot.json from the live app schema
	python scripts/openapi_diff.py --update 2>/dev/null || true
	python -c "\
import os; \
os.environ.setdefault('DATABASE_URL','postgresql://user:pass@localhost:5432/apexchainx'); \
os.environ.setdefault('JWT_SECRET_KEY','openapi-drift-check-key'); \
os.environ.setdefault('STELLAR_NETWORK','testnet'); \
os.environ.setdefault('CONTRACT_EXECUTION_MODE','local_adapter'); \
os.environ.setdefault('CELERY_TASK_ALWAYS_EAGER','true'); \
os.environ.setdefault('API_V1_PREFIX','/api/v1'); \
os.environ.setdefault('ALLOWED_ORIGINS','[\"http://localhost:3000\"]'); \
from app.main import app; import json; \
open('docs/openapi.snapshot.json','w').write(json.dumps(app.openapi(),indent=2,sort_keys=True)+'\n'); \
print('Snapshot updated: docs/openapi.snapshot.json')"

ci: lint format typecheck test ## Full CI pipeline