Makefile

.PHONY: build test lint clean docker help install deps integration-test test-unit test-scripts test-integration test-e2e test-all fmt vet check build-agent-musl build-agent-all docker-mgmt docker-agent docker-push

# Docker image tags
# Internal base image. Versioned tag is what downstream Dockerfile FROMs
# consume; `:latest` is kept as a developer-convenience alias only. Per
# issue #262, no `:latest` in FROM lines anywhere in the repo.
BASE_VERSION      := v2026.5.17
BASE_IMAGE        := agentic-sandbox-base:$(BASE_VERSION)
BASE_IMAGE_LATEST := agentic-sandbox-base:latest
TEST_IMAGE  := agentic-sandbox-test:latest
REGISTRY    ?= registry.example.invalid
MGMT_IMAGE  := $(REGISTRY)/agentic-sandbox/agentic-mgmt
AGENT_IMAGE := $(REGISTRY)/agentic-sandbox/agent-client
IMAGE_TAG   ?= latest

help: ## Show this help message
	@echo 'Usage: make [target]'
	@echo ''
	@echo 'Available targets:'
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2}'

# Build targets
build: ## Build Rust components (management server, agent client, CLI)
	@echo "Building Rust components..."
	@$(MAKE) -s build-management
	@$(MAKE) -s build-agent
	@$(MAKE) -s build-cli

build-management: ## Build Rust management server
	@echo "Building management server..."
	@cd management && cargo build --release

build-agent: ## Build Rust agent client (glibc - for Ubuntu)
	@echo "Building agent client (glibc)..."
	@cd agent-rs && cargo build --release

build-agent-musl: ## Build agent client (musl/static - for Alpine)
	@echo "Building agent client (musl/static)..."
	@cd agent-rs && cargo build --release --target x86_64-unknown-linux-musl --no-default-features

build-agent-all: build-agent build-agent-musl ## Build both agent variants (glibc + musl)

build-cli: ## Build Rust CLI
	@echo "Building CLI..."
	@cd cli && cargo build --release

# Test targets
test: test-unit ## Run unit tests (default)

test-unit: ## Run Rust unit tests (workspace-wide for management)
	@echo "Running Rust unit tests..."
	@cd management && cargo test --workspace
	@cd agent-rs && cargo test
	@cd cli && cargo test

test-scripts: ## Run lightweight script regression tests
	@echo "Running script regression tests..."
	@./tests/package/test-package-macos.sh
	@./tests/package/test-macos-release-recovery.sh
	@./scripts/test-benchmark-terminal-transports.sh
	@./images/qemu/tests/test-vsock-cidr-lifecycle.sh
	@./images/qemu/tests/test-cloud-hypervisor-backend.sh
	@./images/qemu/tests/test-ch-faststart.sh
	@./images/qemu/tests/test-libvirt-checkpoint.sh
	@python3 ./images/qemu/tests/test-ch-fork-memory-probe.py
	@./scripts/test-reap-e2e-vms-cloud-hypervisor.sh
	@./scripts/test-vfio-gpu-runner-guard.sh
	@./images/qemu/tests/test-agent-client-path-parity.sh
	@./images/qemu/tests/test-build-base-image-automation.sh
	@./tests/container/test-multiarch-build-contract.sh
	@./tests/container/test-macos-validation-contract.sh
	@./tests/container/test-macos-release-ceremony-contract.sh
	@./tests/container/test-debian-apt-https.sh

# E2E tests
test-e2e: ## Run E2E integration tests (management server + agents)
	@echo "Running E2E integration tests..."
	./scripts/run-e2e-tests.sh

test-all: test-unit test-e2e ## Run all tests
	@echo "All tests completed"

# Lint/format targets
fmt: ## Format Rust code
	@echo "Formatting Rust code..."
	@cd management && cargo fmt
	@cd agent-rs && cargo fmt
	@cd cli && cargo fmt

lint: ## Check Rust formatting
	@echo "Checking Rust formatting..."
	@cd management && cargo fmt -- --check
	@cd agent-rs && cargo fmt -- --check
	@cd cli && cargo fmt -- --check

# Docker targets
docker: docker-base docker-test ## Build all Docker images

docker-base: ## Build base Docker image (versioned + :latest alias)
	@echo "Building base Docker image $(BASE_IMAGE)..."
	docker build -t $(BASE_IMAGE) -t $(BASE_IMAGE_LATEST) images/base/

docker-test: ## Build test Docker image
	@echo "Building test Docker image..."
	docker build -t $(TEST_IMAGE) images/test/

docker-mgmt: ## Build management server image
	@echo "Building management server image..."
	docker build -t $(MGMT_IMAGE):$(IMAGE_TAG) -f deploy/docker/Dockerfile.management .

docker-agent: ## Build agent client image
	@echo "Building agent client image..."
	docker build -t $(AGENT_IMAGE):$(IMAGE_TAG) -f deploy/docker/Dockerfile.agent-rust .

docker-push: docker-mgmt docker-agent ## Build and push production images to registry
	@echo "Pushing to $(REGISTRY)..."
	docker push $(MGMT_IMAGE):$(IMAGE_TAG)
	docker push $(AGENT_IMAGE):$(IMAGE_TAG)

docker-clean: ## Remove Docker images
	@echo "Removing Docker images..."
	docker rmi -f $(BASE_IMAGE) $(BASE_IMAGE_LATEST) $(TEST_IMAGE) $(MGMT_IMAGE):$(IMAGE_TAG) $(AGENT_IMAGE):$(IMAGE_TAG) 2>/dev/null || true

# Development environment
dev-setup: ## Set up development environment
	@echo "Setting up development environment..."
	./scripts/dev-setup.sh

dev-up: ## Start development environment
	@echo "Starting development environment..."
	docker-compose -f docker-compose.dev.yaml up -d

dev-down: ## Stop development environment
	@echo "Stopping development environment..."
	docker-compose -f docker-compose.dev.yaml down

dev-logs: ## View development environment logs
	docker-compose -f docker-compose.dev.yaml logs -f

# Clean targets
clean: ## Remove build artifacts
	@echo "Cleaning build artifacts..."
	@cd management && cargo clean
	@cd agent-rs && cargo clean
	@cd cli && cargo clean

clean-all: clean docker-clean ## Remove all build artifacts and Docker images

# Quick checks before commit
check: lint test-unit test-scripts ## Run all checks (format check + tests)

.DEFAULT_GOAL := help