attune/Makefile

.PHONY: help build test clean run-api run-executor run-worker run-sensor run-notifier \
        check fmt clippy install-tools db-create db-migrate db-reset docker-build \
        docker-up docker-down docker-cache-warm docker-stop-system-services dev watch generate-agents-index \
        docker-build-workers docker-build-worker-base docker-build-worker-python \
        docker-build-worker-node docker-build-worker-full

# Default target
help:
	@echo "Attune Development Commands"
	@echo "==========================="
	@echo ""
	@echo "Building:"
	@echo "  make build          - Build all services"
	@echo "  make build-release  - Build all services in release mode"
	@echo "  make clean          - Clean build artifacts"
	@echo ""
	@echo "Testing:"
	@echo "  make test           - Run all tests"
	@echo "  make test-common    - Run tests for common library"
	@echo "  make test-api       - Run tests for API service"
	@echo "  make test-integration - Run integration tests"
	@echo "  make check          - Check code without building"
	@echo ""
	@echo "Code Quality:"
	@echo "  make fmt            - Format all code"
	@echo "  make clippy         - Run linter"
	@echo "  make lint           - Run both fmt and clippy"
	@echo ""
	@echo "Running Services:"
	@echo "  make run-api        - Run API service"
	@echo "  make run-executor   - Run executor service"
	@echo "  make run-worker     - Run worker service"
	@echo "  make run-sensor     - Run sensor service"
	@echo "  make run-notifier   - Run notifier service"
	@echo "  make dev            - Run all services in development mode"
	@echo ""
	@echo "Database:"
	@echo "  make db-create      - Create database"
	@echo "  make db-migrate     - Run migrations"
	@echo "  make db-reset       - Drop and recreate database"
	@echo "  make db-test-setup  - Setup test database"
	@echo "  make db-test-reset  - Reset test database"
	@echo ""
	@echo "Docker (Port conflicts? Run 'make docker-stop-system-services' first):"
	@echo "  make docker-stop-system-services - Stop system PostgreSQL/RabbitMQ/Redis"
	@echo "  make docker-cache-warm           - Pre-load build cache (prevents races)"
	@echo "  make docker-build                - Build Docker images"
	@echo "  make docker-build-workers        - Build all worker variants"
	@echo "  make docker-build-worker-base    - Build base worker (shell only)"
	@echo "  make docker-build-worker-python  - Build Python worker"
	@echo "  make docker-build-worker-node    - Build Node.js worker"
	@echo "  make docker-build-worker-full    - Build full worker (all runtimes)"
	@echo "  make docker-up                   - Start services with docker compose"
	@echo "  make docker-down                 - Stop services"
	@echo ""
	@echo "Development:"
	@echo "  make watch          - Watch and rebuild on changes"
	@echo "  make install-tools  - Install development tools"
	@echo ""
	@echo "Documentation:"
	@echo "  make generate-agents-index - Generate AGENTS.md index for AI agents"
	@echo ""

# Building
build:
	cargo build

build-release:
	cargo build --release

clean:
	cargo clean

# Testing
test:
	cargo test

test-common:
	cargo test -p attune-common

test-api:
	cargo test -p attune-api

test-verbose:
	cargo test -- --nocapture --test-threads=1

test-integration:
	@echo "Setting up test database..."
	@make db-test-setup
	@echo "Running integration tests..."
	cargo test --test '*' -p attune-common -- --test-threads=1
	@echo "Integration tests complete"

test-with-db: db-test-setup test-integration
	@echo "All tests with database complete"

# Code quality
check:
	cargo check --all-features

fmt:
	cargo fmt --all

clippy:
	cargo clippy --all-features -- -D warnings

lint: fmt clippy

# Running services
run-api:
	cargo run --bin attune-api

run-api-release:
	cargo run --bin attune-api --release

run-executor:
	cargo run --bin attune-executor

run-executor-release:
	cargo run --bin attune-executor --release

run-worker:
	cargo run --bin attune-worker

run-worker-release:
	cargo run --bin attune-worker --release

run-sensor:
	cargo run --bin attune-sensor

run-sensor-release:
	cargo run --bin attune-sensor --release

run-notifier:
	cargo run --bin attune-notifier

run-notifier-release:
	cargo run --bin attune-notifier --release

# Development mode (run all services)
dev:
	@echo "Starting all services in development mode..."
	@echo "Note: Run each service in a separate terminal or use docker compose"
	@echo ""
	@echo "Terminal 1: make run-api"
	@echo "Terminal 2: make run-executor"
	@echo "Terminal 3: make run-worker"
	@echo "Terminal 4: make run-sensor"
	@echo "Terminal 5: make run-notifier"

# Watch for changes and rebuild
watch:
	cargo watch -x check -x test -x build

# Database operations
db-create:
	createdb attune || true

db-migrate:
	sqlx migrate run

db-drop:
	dropdb attune || true

db-reset: db-drop db-create db-migrate
	@echo "Database reset complete"

# Test database operations
db-test-create:
	createdb attune_test || true

db-test-migrate:
	DATABASE_URL=postgresql://postgres:postgres@localhost:5432/attune_test sqlx migrate run

db-test-drop:
	dropdb attune_test || true

db-test-reset: db-test-drop db-test-create db-test-migrate
	@echo "Test database reset complete"

db-test-setup: db-test-create db-test-migrate
	@echo "Test database setup complete"

# Docker operations

# Stop system services that conflict with Docker Compose
# This resolves "address already in use" errors for PostgreSQL (5432), RabbitMQ (5672), Redis (6379)
docker-stop-system-services:
	@echo "Stopping system services that conflict with Docker..."
	@./scripts/stop-system-services.sh

# Pre-warm the build cache by building one service first
# This prevents race conditions when building multiple services in parallel
# The first build populates the shared cargo registry/git cache
docker-cache-warm:
	@echo "Warming up build cache (building API service first)..."
	@echo "This prevents race conditions during parallel builds."
	docker compose build api
	@echo ""
	@echo "Cache warmed! Now you can safely run 'make docker-build' for parallel builds."

docker-build:
	@echo "Building Docker images..."
	docker compose build

docker-build-api:
	docker compose build api

docker-build-web:
	docker compose build web

# Build worker images
docker-build-workers: docker-build-worker-base docker-build-worker-python docker-build-worker-node docker-build-worker-full
	@echo "✅ All worker images built successfully"

docker-build-worker-base:
	@echo "Building base worker (shell only)..."
	DOCKER_BUILDKIT=1 docker build --target worker-base -t attune-worker:base -f docker/Dockerfile.worker .
	@echo "✅ Base worker image built: attune-worker:base"

docker-build-worker-python:
	@echo "Building Python worker (shell + python)..."
	DOCKER_BUILDKIT=1 docker build --target worker-python -t attune-worker:python -f docker/Dockerfile.worker .
	@echo "✅ Python worker image built: attune-worker:python"

docker-build-worker-node:
	@echo "Building Node.js worker (shell + node)..."
	DOCKER_BUILDKIT=1 docker build --target worker-node -t attune-worker:node -f docker/Dockerfile.worker .
	@echo "✅ Node.js worker image built: attune-worker:node"

docker-build-worker-full:
	@echo "Building full worker (all runtimes)..."
	DOCKER_BUILDKIT=1 docker build --target worker-full -t attune-worker:full -f docker/Dockerfile.worker .
	@echo "✅ Full worker image built: attune-worker:full"

docker-up:
	@echo "Starting all services with Docker Compose..."
	docker compose up -d

docker-down:
	@echo "Stopping all services..."
	docker compose down

docker-down-volumes:
	@echo "Stopping all services and removing volumes (WARNING: deletes data)..."
	docker compose down -v

docker-restart:
	docker compose restart

docker-logs:
	docker compose logs -f

docker-logs-api:
	docker compose logs -f api

docker-ps:
	docker compose ps

docker-shell-api:
	docker compose exec api /bin/sh

docker-shell-db:
	docker compose exec postgres psql -U attune

docker-clean:
	@echo "Cleaning up Docker resources..."
	docker compose down -v --rmi local
	docker system prune -f

# Install development tools
install-tools:
	@echo "Installing development tools..."
	cargo install cargo-watch
	cargo install cargo-expand
	cargo install sqlx-cli --no-default-features --features postgres
	@echo "Tools installed successfully"

# Setup environment
setup: install-tools
	@echo "Setting up development environment..."
	@if [ ! -f .env ]; then \
		echo "Creating .env file from .env.example..."; \
		cp .env.example .env; \
		echo "⚠️  Please edit .env and update configuration values"; \
	fi
	@if [ ! -f .env.test ]; then \
		echo ".env.test already exists"; \
	fi
	@echo "Setup complete! Run 'make db-create && make db-migrate' to initialize the database."
	@echo "For testing, run 'make db-test-setup' to initialize the test database."

# Documentation
docs:
	cargo doc --no-deps --open

# Generate AGENTS.md index
generate-agents-index:
	@echo "Generating AGENTS.md index..."
	python3 scripts/generate_agents_md_index.py
	@echo "✅ AGENTS.md generated successfully"

# Benchmarks
bench:
	cargo bench

# Coverage
coverage:
	cargo tarpaulin --out Html --output-dir coverage

# Update dependencies
update:
	cargo update

# Audit dependencies for security issues
audit:
	cargo audit

# Check dependency tree
tree:
	cargo tree

# Generate licenses list
licenses:
	cargo license --json > licenses.json
	@echo "License information saved to licenses.json"

# All-in-one check before committing
pre-commit: fmt clippy test
	@echo "✅ All checks passed! Ready to commit."

# CI simulation
ci: check clippy test
	@echo "✅ CI checks passed!"