PYTHON ?= python3
BASE_URL ?= http://localhost:8080
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)

.PHONY: test-idempotency up down
up:
	./scripts/bootstrap.sh
	./scripts/compose.sh up -d --build

down:
	./scripts/compose.sh down

test-idempotency:
	$(PYTHON) tests/idempotency_concurrent.py --base-url "$(BASE_URL)"

.PHONY: test-replicas test-rolling research-scaling plot-scaling
# The target image must already be built; API_IMAGE selects it.
test-rolling:
	$(PYTHON) tests/rolling_update.py --base-url "$(BASE_URL)"

test-replicas:
	$(PYTHON) tests/replica_matrix.py --base-url "$(BASE_URL)"

research-scaling:
	$(PYTHON) scripts/research_scaling.py --base-url "$(BASE_URL)"

plot-scaling:
	$(PYTHON) scripts/plot_scaling.py
	$(PYTHON) scripts/summarize_research.py

.PHONY: test-cache
# Run inside the private Compose network; no DB/cache ports are exposed.
test-cache:
	./scripts/compose.sh exec -T -e BASE_URL=http://lb:8080 -e CACHE_URL=redis://valkey:6379/0 api python - < tests/cache_consistency.py
