PYTHON ?= python3 BASE_URL ?= https://localhost:8443 CA_FILE ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) .PHONY: help check validate test test-primitives test-internal-mtls test-login-limit test-openbao-acl test-worker-isolation test-worker-rotation test-leaf-rotation test-telemetry-redaction test-argon-budget load benchmark-observability \ test-attachments test-idempotency-race test-reconcile test-worker test-pipeline-faults \ test-pipeline-replay test-outbox-recovery test-worker-recovery test-reconcile-integration \ test-upload-concurrency test-persistence test-failover test-security 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) test-primitives: $(PYTHON) -m unittest discover -s tests -p 'test_*.py' test-internal-mtls: docker compose exec -T api python3 /app/tests/internal_mtls.py test-login-limit: $(PYTHON) tests/login_rate_limit.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-openbao-acl: $(PYTHON) tests/openbao_acl.py --ca-file "$(CURDIR)/secrets/pki/ca.crt" test-worker-isolation: docker compose exec -T worker python3 /app/tests/worker_isolation.py test-worker-rotation: @test -n "$(ROOT_TOKEN_FILE)" || (echo "Set ROOT_TOKEN_FILE to an operator-only root-token file"; exit 2) $(PYTHON) tests/worker_identity_rotation.py --ca-file "$(CURDIR)/secrets/pki/ca.crt" --root-token-file "$(ROOT_TOKEN_FILE)" test-leaf-rotation: $(PYTHON) tests/leaf_certificate_rotation.py test-telemetry-redaction: $(PYTHON) tests/telemetry_redaction.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-argon-budget: docker compose exec -T api python3 /app/tests/argon2_budget.py load: $(PYTHON) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS) benchmark-observability: $(PYTHON) student-tests/track1_benchmark.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-attachments: $(PYTHON) student-tests/test_attachments.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-idempotency-race: $(PYTHON) student-tests/test_idempotency_race.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-reconcile: $(PYTHON) student-tests/test_reconcile.py test-worker: $(PYTHON) student-tests/test_worker.py test-pipeline-faults: $(PYTHON) student-tests/test_pipeline_faults.py test-pipeline-replay: $(PYTHON) student-tests/test_pipeline_replay_integration.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-outbox-recovery: $(PYTHON) student-tests/test_outbox_recovery_integration.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-worker-recovery: $(PYTHON) student-tests/test_worker_recovery_integration.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-reconcile-integration: $(PYTHON) student-tests/test_reconcile_integration.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-upload-concurrency: $(PYTHON) student-tests/upload_concurrency.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) test-security: $(PYTHON) tests/security.py --base-url "$(BASE_URL)" $(TLS_ARGS)