PYTHON ?= python3 BASE_URL ?= http://127.0.0.1:8083 CA_FILE ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) .PHONY: help check validate test load test-persistence test-failover help: @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes" check: $(PYTHON) scripts/check_contract.py validate: $(PYTHON) scripts/validate_openapi.py test: $(PYTHON) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS) load: $(PYTHON) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-persistence: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2) $(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) test-failover: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2) $(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) RESEARCH_OUTPUT ?= evidence/scaling-new .PHONY: bootstrap up down image lint test-student verify research bootstrap: $(PYTHON) scripts/bootstrap.py up: VCS_REF=$$(git rev-parse HEAD) docker compose --env-file .env up -d --build --wait down: docker compose --env-file .env down image: VCS_REF=$$(git rev-parse HEAD) docker compose --env-file .env build lint: uv run --locked ruff check src student-tests scripts/bootstrap.py scripts/cluster.py scripts/stop-one.py scripts/rolling-update.py scripts/verify_cluster.py research test-student: uv run --locked pytest verify: uv run --locked python scripts/verify_cluster.py research: uv run --locked python research/run.py --output "$(RESEARCH_OUTPUT)" uv run --locked --group research python research/analyze.py "$(RESEARCH_OUTPUT)"