Makefile

.PHONY: help deploy build up down logs ps watch scale lint format clean clean-all restart shell stats health ai-docs
.PHONY: dev-up dev-down dev-build dev-logs dev-ps dev-watch dev-restart dev-shell
.PHONY: prod-up prod-down prod-build prod-rebuild prod-logs prod-ps prod-restart prod-shell

# Python configuration
PYTHON := $(shell if [ -d .venv ]; then echo ".venv/bin/python"; else echo "python3"; fi)

# Default target: show help information
help:
	@echo "NetPulse Common Operations"
	@echo "========================"
	@echo ""
	@echo "Docker Deployment (Production - docker-compose.yaml):"
	@echo "  make deploy      - One-click Docker deployment (auto-generate env and certs)"
	@echo "  make build       - Build Docker images (production)"
	@echo "  make up          - Start all Docker services (production)"
	@echo "  make down        - Stop all Docker services (production)"
	@echo "  make restart     - Restart all Docker services (production)"
	@echo "  make logs        - View Docker service logs (production)"
	@echo "  make ps          - Show Docker service status (production)"
	@echo "  make watch       - Start Docker development mode (watch, production)"
	@echo "  make logs controller  - View logs (service or container name)"
	@echo "  make shell controller  - Open shell (service or container name)"
	@echo "  make stats       - Show Docker container resource usage"
	@echo "  make health      - Check service health status"
	@echo ""
	@echo "Development Environment (docker-compose.dev.yaml):"
	@echo "  make dev-build   - Build Docker images (development)"
	@echo "  make dev-up      - Start all Docker services (development)"
	@echo "  make dev-down    - Stop all Docker services (development)"
	@echo "  make dev-restart - Restart all Docker services (development)"
	@echo "  make dev-logs    - View Docker service logs (development)"
	@echo "  make dev-ps      - Show Docker service status (development)"
	@echo "  make dev-watch   - Start Docker development mode (watch, development)"
	@echo "  make dev-shell <service> - Open shell in development service"
	@echo ""
	@echo "Production Environment (docker-compose.yaml):"
	@echo "  make prod-build  - Build Docker images (production)"
	@echo "  make prod-up     - Start all Docker services (production)"
	@echo "  make prod-down   - Stop all Docker services (production)"
	@echo "  make prod-restart - Restart all Docker services (production)"
	@echo "  make prod-logs   - View Docker service logs (production)"
	@echo "  make prod-ps     - Show Docker service status (production)"
	@echo "  make prod-rebuild - Rebuild and restart production services (build -> down -> up)"
	@echo "  make prod-shell <service> - Open shell in production service"
	@echo ""
	@echo "Scaling:"
	@echo "  make scale NODE=2 FIFO=1  - Scale workers (default: NODE=2, FIFO=1)"
	@echo ""
	@echo "Development:"
	@echo "  make lint        - Run code linting and auto-fix issues"
	@echo "  make format      - Format code"
	@echo ""
	@echo "Cleanup:"
	@echo "  make clean       - Stop Docker services (preserves data volumes)"
	@echo "  make clean-all   - Remove Docker services and volumes (⚠️  WARNING: deletes Redis data)"
	@echo ""
	@echo "AI Knowledge Kit (ai-docs/):"
	@echo "  make ai-docs     - Generate AI-ready context (llms.txt, openapi.json, repomix-output.xml)"
	@echo ""

# Docker deployment operations
deploy:
	@echo "🚀 Starting one-click Docker deployment..."
	bash ./scripts/docker_auto_deploy.sh

# Production environment (docker-compose.yaml)
build:
	@echo "🔨 Building Docker images (production)..."
	docker compose build

up:
	@echo "⬆️  Starting Docker services (production)..."
	docker compose up -d

down:
	@echo "⬇️  Stopping Docker services (production)..."
	docker compose down

restart:
	@echo "🔄 Restarting Docker services (production)..."
	docker compose restart

prod-build:
	@echo "🔨 Building Docker images (production)..."
	docker compose -f docker-compose.yaml build

prod-up:
	@echo "⬆️  Starting Docker services (production)..."
	docker compose -f docker-compose.yaml up -d

prod-down:
	@echo "⬇️  Stopping Docker services (production)..."
	docker compose -f docker-compose.yaml down

prod-rebuild: prod-build prod-down prod-up
	@echo "✅ Production services rebuilt and restarted successfully"

prod-restart:
	@echo "🔄 Restarting Docker services (production)..."
	docker compose -f docker-compose.yaml restart

prod-logs:
	@SERVICE=$$(echo "$(filter-out $@,$(MAKECMDGOALS))" | head -1); \
	if [ -z "$$SERVICE" ]; then \
		echo "📋 Viewing all Docker service logs (production)..."; \
		docker compose -f docker-compose.yaml logs -f; \
	else \
		echo "📋 Viewing logs for $$SERVICE (production)..."; \
		docker compose -f docker-compose.yaml logs -f $$SERVICE; \
	fi

prod-ps:
	@echo "📊 Showing Docker service status (production)..."
	docker compose -f docker-compose.yaml ps

prod-shell:
	@SERVICE=$$(echo "$(filter-out $@,$(MAKECMDGOALS))" | head -1); \
	if [ -z "$$SERVICE" ]; then \
		echo "⚠️  Usage: make prod-shell <service-name>"; \
		exit 1; \
	fi; \
	echo "🐚 Opening shell in service $$SERVICE (production)..."; \
	docker compose -f docker-compose.yaml exec $$SERVICE /bin/bash 2>/dev/null || docker compose -f docker-compose.yaml exec $$SERVICE /bin/sh

# Development environment (docker-compose.dev.yaml)
dev-build:
	@echo "🔨 Building Docker images (development)..."
	docker compose -f docker-compose.dev.yaml build

dev-up:
	@echo "⬆️  Starting Docker services (development)..."
	docker compose -f docker-compose.dev.yaml up -d

dev-down:
	@echo "⬇️  Stopping Docker services (development)..."
	docker compose -f docker-compose.dev.yaml down

dev-restart:
	@echo "🔄 Restarting Docker services (development)..."
	docker compose -f docker-compose.dev.yaml restart

dev-logs:
	@SERVICE=$$(echo "$(filter-out $@,$(MAKECMDGOALS))" | head -1); \
	if [ -z "$$SERVICE" ]; then \
		echo "📋 Viewing all Docker service logs (development)..."; \
		docker compose -f docker-compose.dev.yaml logs -f; \
	else \
		echo "📋 Viewing logs for $$SERVICE (development)..."; \
		docker compose -f docker-compose.dev.yaml logs -f $$SERVICE; \
	fi

dev-ps:
	@echo "📊 Showing Docker service status (development)..."
	docker compose -f docker-compose.dev.yaml ps

dev-watch:
	@echo "👀 Starting Docker development mode (watch, development)..."
	docker compose -f docker-compose.dev.yaml watch

dev-shell:
	@SERVICE=$$(echo "$(filter-out $@,$(MAKECMDGOALS))" | head -1); \
	if [ -z "$$SERVICE" ]; then \
		echo "⚠️  Usage: make dev-shell <service-name>"; \
		exit 1; \
	fi; \
	echo "🐚 Opening shell in service $$SERVICE (development)..."; \
	docker compose -f docker-compose.dev.yaml exec $$SERVICE /bin/bash 2>/dev/null || docker compose -f docker-compose.dev.yaml exec $$SERVICE /bin/sh

logs:
	@SERVICE=$$(echo "$(filter-out $@,$(MAKECMDGOALS))" | head -1); \
	if [ -z "$$SERVICE" ]; then \
		echo "📋 Viewing all Docker service logs..."; \
		echo "💡 Tip: Use 'make logs controller' or 'make logs netpulse-controller-1'"; \
		docker compose logs -f; \
	else \
		echo "📋 Viewing logs for $$SERVICE..."; \
		if docker ps --format "{{.Names}}" | grep -q "^$$SERVICE$$"; then \
			docker logs -f $$SERVICE; \
		else \
			docker compose logs -f $$SERVICE; \
		fi; \
	fi
%:
	@:

ps:
	@echo "📊 Showing Docker service status..."
	docker compose ps

watch:
	@echo "👀 Starting Docker development mode (watch, production)..."
	docker compose watch

shell:
	@SERVICE=$$(echo "$(filter-out $@,$(MAKECMDGOALS))" | head -1); \
	if [ -z "$$SERVICE" ]; then \
		echo "⚠️  Usage: make shell <service-name-or-container-name>"; \
		echo "   Examples:"; \
		echo "     make shell controller          # Service name"; \
		echo "     make shell netpulse-controller-1  # Container name"; \
		echo "   Use 'make ps' to see all containers"; \
		exit 1; \
	fi; \
	if docker ps --format "{{.Names}}" | grep -q "^$$SERVICE$$"; then \
		echo "🐚 Opening shell in container $$SERVICE..."; \
		docker exec -it $$SERVICE /bin/bash 2>/dev/null || docker exec -it $$SERVICE /bin/sh; \
	elif docker compose ps $$SERVICE 2>/dev/null | grep -q "Up"; then \
		echo "🐚 Opening shell in service $$SERVICE..."; \
		docker compose exec $$SERVICE /bin/bash 2>/dev/null || docker compose exec $$SERVICE /bin/sh; \
	else \
		echo "❌ Container or service '$$SERVICE' not found or not running."; \
		echo "   Use 'make ps' to check available containers and services."; \
		exit 1; \
	fi

stats:
	@echo "📊 Showing Docker container resource usage..."
	docker stats --no-stream

health:
	@echo "🏥 Checking service health..."
	@docker compose ps --format "table {{.Name}}\t{{.Status}}\t{{.Ports}}"

# Scaling operations
scale:
	@NODE_COUNT=$${NODE:-2}; \
	FIFO_COUNT=$${FIFO:-1}; \
	echo "📈 Scaling workers (NODE=$$NODE_COUNT, FIFO=$$FIFO_COUNT)..."; \
	docker compose up -d --scale node-worker=$$NODE_COUNT --no-deps node-worker; \
	docker compose up -d --scale fifo-worker=$$FIFO_COUNT --no-deps fifo-worker; \
	echo "✅ Workers scaled successfully (node-worker: $$NODE_COUNT, fifo-worker: $$FIFO_COUNT)"

# Development operations
lint:
	@echo "🔍 Running code linting and auto-fixing..."
	ruff check --fix .

format:
	@echo "✨ Formatting code..."
	ruff format .

# Cleanup operations
clean:
	@echo "🧹 Stopping Docker services (data volumes preserved)..."
	docker compose down
	@echo "✅ Services stopped"

clean-all:
	@echo "⚠️  WARNING: This will delete all Docker services and data volumes!"
	@echo "⚠️  This includes Redis data (task queues, job states, etc.)"
	@read -p "Are you sure you want to continue? [y/N] " -n 1 -r; \
	echo; \
	if [ "$$REPLY" = "y" ] || [ "$$REPLY" = "Y" ]; then \
		echo "🧹 Removing Docker services and volumes..."; \
		docker compose down -v; \
		docker system prune -f; \
		echo "✅ All services and data removed"; \
	else \
		echo "❌ Cleanup cancelled"; \
	fi

# AI Documentation operations
ai-docs:
	@echo "🤖 Generating AI-ready documentation in ai-docs/..."
	@mkdir -p ai-docs
	@echo "1/3 Exporting OpenAPI schema..."
	@uv run --extra api python scripts/export_openapi.py
	@echo "2/3 Packing codebase with Repomix (XML format)..."
	@repomix
	@echo "3/3 Checking LLM guide (llms.txt)..."
	@if [ ! -f llms.txt ]; then \
		echo "⚠️  llms.txt not found in root, creating a basic template..."; \
		echo "# NetPulse AI Guide" > llms.txt; \
	fi
	@cp llms.txt ai-docs/llms.txt
	@echo "✅ AI Knowledge Kit updated in ai-docs/ directory!"