Makefile

# Unlok - Makefile
# Deploy to Google Cloud Run (zero-Docker deployment)
# 
# Prerequisites:
#   1. gcloud CLI installed: https://cloud.google.com/sdk/docs/install
#   2. Authenticated: gcloud auth login
#   3. Project set: gcloud config set project PROJECT_ID
#   4. APIs enabled (auto-enabled on first deploy):
#      - run.googleapis.com
#      - cloudbuild.googleapis.com  
#      - artifactregistry.googleapis.com

# ============================================
# CONFIGURATION
# ============================================

# Project settings
PROJECT_ID ?= $(shell gcloud config get-value project)
SERVICE_NAME ?= unlok
REGION ?= us-central1

# Gemini 3 Models (HACKATHON REQUIREMENT)
GEMINI_PRO_MODEL = gemini-3.0-pro-preview
GEMINI_FLASH_MODEL = gemini-3.0-flash-preview

# Resource limits
MEMORY ?= 1Gi
CPU ?= 1
MAX_INSTANCES ?= 10
MIN_INSTANCES ?= 0
TIMEOUT ?= 300

# ============================================
# COLORS
# ============================================
GREEN  := \033[0;32m
YELLOW := \033[0;33m
RED    := \033[0;31m
NC     := \033[0m # No Color

# ============================================
# MAIN TARGETS
# ============================================

.PHONY: help
help: ## Show this help
	@echo "$(GREEN)Unlok - Cloud Run Deployment$(NC)"
	@echo ""
	@echo "$(YELLOW)Usage:$(NC)"
	@echo "  make [target]"
	@echo ""
	@echo "$(YELLOW)Targets:$(NC)"
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  $(GREEN)%-20s$(NC) %s\n", $$1, $$2}'

.PHONY: deploy
deploy: check-env ## Deploy to Cloud Run
	@echo "$(GREEN)🚀 Deploying Unlok to Cloud Run...$(NC)"
	@echo "$(YELLOW)   Project: $(PROJECT_ID)$(NC)"
	@echo "$(YELLOW)   Region:  $(REGION)$(NC)"
	@echo "$(YELLOW)   Service: $(SERVICE_NAME)$(NC)"
	@echo ""
	gcloud run deploy $(SERVICE_NAME) \
		--source . \
		--region $(REGION) \
		--platform managed \
		--allow-unauthenticated \
		--memory 2Gi \
		--cpu 2 \
		--max-instances 3 \
		--min-instances 0 \
		--concurrency 1 \
		--timeout 600 \
		--set-env-vars "GEMINI_PRO_MODEL=$(GEMINI_PRO_MODEL)" \
		--set-env-vars "GEMINI_FLASH_MODEL=$(GEMINI_FLASH_MODEL)" \
		--set-env-vars "NODE_ENV=production" \
		--set-secrets "GOOGLE_AI_API_KEY=gemini-api-key:latest"
	@echo ""
	@echo "$(GREEN)✅ Deployment complete!$(NC)"
	@make url

# ============================================
# SECRET MANAGEMENT
# ============================================

.PHONY: create-secret
create-secret: ## Create Gemini API key secret (interactive)
	@echo "$(YELLOW)Creating secret for Gemini API key...$(NC)"
	@echo "Enter your Gemini API key:"
	@read -s API_KEY && printf '%s' "$$API_KEY" | \
		gcloud secrets create gemini-api-key --data-file=- || \
		(printf '%s' "$$API_KEY" | gcloud secrets versions add gemini-api-key --data-file=-)
	@echo "$(GREEN)✅ Secret created/updated!$(NC)"

.PHONY: update-secret
update-secret: ## Update Gemini API key secret
	@echo "$(YELLOW)Updating secret...$(NC)"
	@echo "Enter your new Gemini API key:"
	@read -s API_KEY && printf '%s' "$$API_KEY" | \
		gcloud secrets versions add gemini-api-key --data-file=-
	@echo "$(GREEN)✅ Secret updated!$(NC)"

.PHONY: delete-secret
delete-secret: ## Delete Gemini API key secret
	@echo "$(RED)⚠️  Deleting secret...$(NC)"
	gcloud secrets delete gemini-api-key --quiet
	@echo "$(GREEN)✅ Secret deleted!$(NC)"

# ============================================
# SERVICE MANAGEMENT
# ============================================

.PHONY: url
url: ## Get the service URL
	@echo "$(GREEN)🌐 Service URL:$(NC)"
	@gcloud run services describe $(SERVICE_NAME) \
		--region $(REGION) \
		--format 'value(status.url)' 2>/dev/null || \
		echo "$(RED)Service not deployed yet$(NC)"

.PHONY: logs
logs: ## Stream logs from Cloud Run
	@echo "$(GREEN)📋 Streaming logs...$(NC)"
	gcloud run services logs read $(SERVICE_NAME) \
		--region $(REGION) \
		--limit 100

.PHONY: logs-tail
logs-tail: ## Tail logs in real-time
	@echo "$(GREEN)📋 Tailing logs (Ctrl+C to stop)...$(NC)"
	gcloud beta run services logs tail $(SERVICE_NAME) \
		--region $(REGION)

.PHONY: describe
describe: ## Show service details
	gcloud run services describe $(SERVICE_NAME) \
		--region $(REGION)

.PHONY: revisions
revisions: ## List all revisions
	gcloud run revisions list \
		--service $(SERVICE_NAME) \
		--region $(REGION)

.PHONY: traffic
traffic: ## Show traffic allocation
	gcloud run services describe $(SERVICE_NAME) \
		--region $(REGION) \
		--format 'yaml(spec.traffic)'

.PHONY: delete
delete: ## Delete the service (with confirmation)
	@echo "$(RED)⚠️  This will delete the service '$(SERVICE_NAME)'$(NC)"
	@read -p "Are you sure? [y/N] " confirm && [ "$$confirm" = "y" ]
	gcloud run services delete $(SERVICE_NAME) \
		--region $(REGION) \
		--quiet
	@echo "$(GREEN)✅ Service deleted!$(NC)"

# ============================================
# DEVELOPMENT
# ============================================

.PHONY: dev
dev: ## Run locally for development
	npm run dev

.PHONY: start
start: ## Start production server locally
	npm run start

.PHONY: test
test: ## Run tests
	npm test

.PHONY: lint
lint: ## Run linter
	npm run lint

# ============================================
# SETUP & UTILITIES
# ============================================

.PHONY: check-env
check-env: ## Verify gcloud configuration
	@echo "$(YELLOW)Checking environment...$(NC)"
	@which gcloud > /dev/null || (echo "$(RED)❌ gcloud CLI not installed$(NC)" && exit 1)
	@gcloud auth print-access-token > /dev/null 2>&1 || (echo "$(RED)❌ Not authenticated. Run: gcloud auth login$(NC)" && exit 1)
	@test -n "$(PROJECT_ID)" || (echo "$(RED)❌ No project set. Run: gcloud config set project PROJECT_ID$(NC)" && exit 1)
	@echo "$(GREEN)✅ Environment OK$(NC)"
	@echo "   Project: $(PROJECT_ID)"
	@echo "   Region:  $(REGION)"

.PHONY: setup-project
setup-project: ## Enable required APIs
	@echo "$(YELLOW)Enabling required APIs...$(NC)"
	gcloud services enable run.googleapis.com
	gcloud services enable cloudbuild.googleapis.com
	gcloud services enable artifactregistry.googleapis.com
	gcloud services enable secretmanager.googleapis.com
	@echo "$(GREEN)✅ APIs enabled!$(NC)"

.PHONY: setup-iam
setup-iam: ## Configure IAM permissions for Cloud Build
	@echo "$(YELLOW)Setting up IAM permissions...$(NC)"
	@PROJECT_NUMBER=$$(gcloud projects describe $(PROJECT_ID) --format='value(projectNumber)') && \
	gcloud projects add-iam-policy-binding $(PROJECT_ID) \
		--member=serviceAccount:$$PROJECT_NUMBER-compute@developer.gserviceaccount.com \
		--role=roles/run.builder
	@echo "$(GREEN)✅ IAM configured!$(NC)"

.PHONY: regions
regions: ## List available regions
	@echo "$(GREEN)Available Cloud Run regions:$(NC)"
	gcloud run regions list

.PHONY: info
info: ## Show project info
	@echo "$(GREEN)Project Information$(NC)"
	@echo "===================="
	@echo "Project ID:     $(PROJECT_ID)"
	@echo "Service Name:   $(SERVICE_NAME)"
	@echo "Region:         $(REGION)"
	@echo "Gemini Pro:     $(GEMINI_PRO_MODEL)"
	@echo "Gemini Flash:   $(GEMINI_FLASH_MODEL)"
	@echo ""
	@echo "$(YELLOW)Current gcloud config:$(NC)"
	@gcloud config list --format="table(core.project, compute.region)"

# ============================================
# COST MANAGEMENT
# ============================================

.PHONY: scale-down
scale-down: ## Scale to zero (save costs)
	@echo "$(YELLOW)Scaling service to zero...$(NC)"
	gcloud run services update $(SERVICE_NAME) \
		--region $(REGION) \
		--min-instances 0 \
		--max-instances 1
	@echo "$(GREEN)✅ Service scaled down$(NC)"

.PHONY: scale-up
scale-up: ## Scale up for demo/testing
	@echo "$(YELLOW)Scaling service up...$(NC)"
	gcloud run services update $(SERVICE_NAME) \
		--region $(REGION) \
		--min-instances 1 \
		--max-instances 10
	@echo "$(GREEN)✅ Service scaled up$(NC)"

# ============================================
# QUICK COMMANDS
# ============================================

.PHONY: open
open: ## Open service URL in browser
	@URL=$$(gcloud run services describe $(SERVICE_NAME) --region $(REGION) --format 'value(status.url)') && \
	echo "Opening $$URL..." && \
	open "$$URL" 2>/dev/null || xdg-open "$$URL" 2>/dev/null || echo "URL: $$URL"

.PHONY: status
status: ## Quick status check
	@echo "$(GREEN)Service Status$(NC)"
	@gcloud run services describe $(SERVICE_NAME) \
		--region $(REGION) \
		--format 'table(status.conditions.type, status.conditions.status, status.conditions.message)' 2>/dev/null || \
		echo "$(RED)Service not found$(NC)"

# Default target
.DEFAULT_GOAL := help