#!/usr/bin/env -S make -f
# ==============================================================================
# MCP Stack Helm Chart Makefile
# ==============================================================================

# Chart configuration
CHART_NAME := mcp-stack
CHART_VERSION := $(shell grep '^version:' Chart.yaml | cut -d' ' -f2)
APP_VERSION := $(shell grep '^appVersion:' Chart.yaml | cut -d' ' -f2 | tr -d '"')

# Registry configuration
REGISTRY := ghcr.io
REPO := ibm/mcp-context-forge
CHART_REGISTRY := oci://$(REGISTRY)/$(REPO)

# Directories
DIST_DIR := dist
DOCS_DIR := docs
TEMP_DIR := tmp
TEST_DIR := tests

# Kubernetes configuration
KUBECONFIG ?= ~/.kube/config
NAMESPACE ?= mcp-test
RELEASE_NAME ?= mcp-stack-test

# Colors for output
RED := \033[0;31m
GREEN := \033[0;32m
YELLOW := \033[0;33m
BLUE := \033[0;34m
PURPLE := \033[0;35m
CYAN := \033[0;36m
WHITE := \033[0;37m
NC := \033[0m # No Color

# Default target
.DEFAULT_GOAL := help

# ==============================================================================
# HELP & INFORMATION
# ==============================================================================

.PHONY: help
help: ## 🎯 Show this help message
	@echo "$(CYAN)MCP Stack Helm Chart$(NC) - Available targets:"
	@echo ""
	@awk 'BEGIN {FS = ":.*##"; printf "Usage: make $(CYAN)<target>$(NC)\n\nTargets:\n"} \
		/^[a-zA-Z_-]+:.*?##/ { \
			printf "  $(CYAN)%-20s$(NC) %s\n", $$1, $$2 \
		} \
		/^##@/ { \
			printf "\n$(YELLOW)%s$(NC)\n", substr($$0, 5) \
		}' $(MAKEFILE_LIST)
	@echo ""

.PHONY: info
info: ## 📋 Show chart information
	@echo "$(CYAN)Chart Information:$(NC)"
	@echo "  Name:        $(CHART_NAME)"
	@echo "  Version:     $(CHART_VERSION)"
	@echo "  App Version: $(APP_VERSION)"
	@echo "  Registry:    $(CHART_REGISTRY)"
	@echo "  Namespace:   $(NAMESPACE)"
	@echo "  Release:     $(RELEASE_NAME)"
	@echo ""

.PHONY: version
version: ## 🏷️ Show chart version
	@echo "$(CHART_VERSION)"

##@ 🔍 Validation & Linting

.PHONY: lint
lint: ## 🔧 Run Helm lint on the chart
	@echo "$(BLUE)Running Helm lint...$(NC)"
	@helm lint . --strict
	@echo "$(GREEN)✓ Lint completed successfully$(NC)"

.PHONY: lint-values
lint-values: ## 📝 Validate values.yaml against schema
	@echo "$(BLUE)Validating values.yaml against schema...$(NC)"
	@if [ -f values.schema.json ]; then \
		helm lint . --strict > /dev/null && \
		echo "$(GREEN)✓ Values validation passed$(NC)"; \
	else \
		echo "$(YELLOW)⚠ No values.schema.json found$(NC)"; \
	fi

.PHONY: lint-yaml
lint-yaml: ## 🔍 Lint YAML files with yamllint
	@echo "$(BLUE)Running yamllint...$(NC)"
	@if command -v yamllint >/dev/null 2>&1; then \
		if [ -f .yamllint.yml ]; then \
			yamllint . -c .yamllint.yml; \
		elif [ -f ../../.yamllint ]; then \
			yamllint Chart.yaml values.yaml -c ../../.yamllint; \
		else \
			yamllint Chart.yaml values.yaml; \
		fi; \
		echo "$(GREEN)✓ YAML lint completed$(NC)"; \
	else \
		echo "$(YELLOW)⚠ yamllint not found, skipping$(NC)"; \
	fi

.PHONY: validate-all
validate-all: lint lint-values lint-yaml ## ✅ Run all validation checks

##@ 🧪 Testing

.PHONY: test-template
test-template: ## 📄 Test template rendering with default values
	@echo "$(BLUE)Testing template rendering...$(NC)"
	@helm template $(CHART_NAME) . --debug --dry-run > $(TEMP_DIR)/rendered.yaml
	@echo "$(GREEN)✓ Template rendering successful$(NC)"

.PHONY: test-template-values
test-template-values: ## 📄 Test template rendering with custom values
	@echo "$(BLUE)Testing template rendering with custom values...$(NC)"
	@if [ -f my-values.yaml ]; then \
		helm template $(CHART_NAME) . -f my-values.yaml --debug --dry-run > $(TEMP_DIR)/rendered-custom.yaml; \
		echo "$(GREEN)✓ Template rendering with custom values successful$(NC)"; \
	else \
		echo "$(YELLOW)⚠ my-values.yaml not found, using default values$(NC)"; \
		$(MAKE) test-template; \
	fi

.PHONY: test-dry-run
test-dry-run: ## 🎭 Test installation with dry-run
	@echo "$(BLUE)Testing installation (dry-run)...$(NC)"
	@helm install $(RELEASE_NAME) . --namespace $(NAMESPACE) --create-namespace --dry-run --debug
	@echo "$(GREEN)✓ Dry-run installation successful$(NC)"

.PHONY: test-upgrade-dry-run
test-upgrade-dry-run: ## 🔄 Test upgrade with dry-run
	@echo "$(BLUE)Testing upgrade (dry-run)...$(NC)"
	@helm upgrade $(RELEASE_NAME) . --namespace $(NAMESPACE) --dry-run --debug
	@echo "$(GREEN)✓ Dry-run upgrade successful$(NC)"

.PHONY: test-kubeval
test-kubeval: ## 🔍 Validate Kubernetes manifests with kubeval
	@echo "$(BLUE)Validating Kubernetes manifests...$(NC)"
	@if command -v kubeval >/dev/null 2>&1; then \
		helm template $(CHART_NAME) . | kubeval --strict --ignore-missing-schemas; \
		echo "$(GREEN)✓ Kubeval validation passed$(NC)"; \
	else \
		echo "$(YELLOW)⚠ kubeval not found, skipping$(NC)"; \
	fi

.PHONY: test-all
test-all: test-template test-dry-run test-kubeval ## 🧪 Run all tests

##@ 📦 Packaging & Publishing

.PHONY: clean
clean: ## 🧹 Clean build artifacts
	@echo "$(BLUE)Cleaning build artifacts...$(NC)"
	@rm -rf $(DIST_DIR) $(TEMP_DIR) *.tgz values.schema.generated.json
	@echo "$(GREEN)✓ Clean completed$(NC)"

.PHONY: package
package: clean validate-all ## 📦 Package the Helm chart
	@echo "$(BLUE)Packaging Helm chart...$(NC)"
	@mkdir -p $(DIST_DIR)
	@helm package . --destination $(DIST_DIR) --dependency-update
	@echo "$(GREEN)✓ Chart packaged: $(DIST_DIR)/$(CHART_NAME)-$(CHART_VERSION).tgz$(NC)"

.PHONY: package-dev
package-dev: clean ## 📦 Package chart for development (skip validation)
	@echo "$(BLUE)Packaging Helm chart (development)...$(NC)"
	@mkdir -p $(DIST_DIR)
	@helm package . --destination $(DIST_DIR)
	@echo "$(GREEN)✓ Chart packaged: $(DIST_DIR)/$(CHART_NAME)-$(CHART_VERSION).tgz$(NC)"

.PHONY: push
push: package ## 🚀 Push chart to OCI registry
	@echo "$(BLUE)Pushing chart to registry...$(NC)"
	@helm push $(DIST_DIR)/$(CHART_NAME)-$(CHART_VERSION).tgz $(CHART_REGISTRY)
	@echo "$(GREEN)✓ Chart pushed to $(CHART_REGISTRY)$(NC)"

.PHONY: sign
sign: package ## 🔐 Sign the chart package
	@echo "$(BLUE)Signing chart package...$(NC)"
	@if command -v cosign >/dev/null 2>&1; then \
		cosign sign-blob --yes $(DIST_DIR)/$(CHART_NAME)-$(CHART_VERSION).tgz \
			--output-signature $(DIST_DIR)/$(CHART_NAME)-$(CHART_VERSION).tgz.sig \
			--output-certificate $(DIST_DIR)/$(CHART_NAME)-$(CHART_VERSION).tgz.pem; \
		echo "$(GREEN)✓ Chart signed$(NC)"; \
	else \
		echo "$(YELLOW)⚠ cosign not found, skipping signing$(NC)"; \
	fi

##@ 🚀 Deployment & Management

.PHONY: install
install: ## 🚀 Install the chart
	@echo "$(BLUE)Installing chart...$(NC)"
	@helm install $(RELEASE_NAME) . --namespace $(NAMESPACE) --create-namespace --wait --timeout 10m
	@echo "$(GREEN)✓ Chart installed successfully$(NC)"

.PHONY: install-dev
install-dev: ## 🚀 Install chart with development values
	@echo "$(BLUE)Installing chart (development)...$(NC)"
	@if [ -f my-values.yaml ]; then \
		helm install $(RELEASE_NAME) . --namespace $(NAMESPACE) --create-namespace -f my-values.yaml --wait --timeout 10m; \
	else \
		echo "$(YELLOW)⚠ my-values.yaml not found, using default values$(NC)"; \
		$(MAKE) install; \
	fi
	@echo "$(GREEN)✓ Chart installed successfully$(NC)"

.PHONY: upgrade
upgrade: ## 🔄 Upgrade the chart
	@echo "$(BLUE)Upgrading chart...$(NC)"
	@helm upgrade $(RELEASE_NAME) . --namespace $(NAMESPACE) --wait --timeout 10m
	@echo "$(GREEN)✓ Chart upgraded successfully$(NC)"

.PHONY: upgrade-dev
upgrade-dev: ## 🔄 Upgrade chart with development values
	@echo "$(BLUE)Upgrading chart (development)...$(NC)"
	@if [ -f my-values.yaml ]; then \
		helm upgrade $(RELEASE_NAME) . --namespace $(NAMESPACE) -f my-values.yaml --wait --timeout 10m; \
	else \
		echo "$(YELLOW)⚠ my-values.yaml not found, using default values$(NC)"; \
		$(MAKE) upgrade; \
	fi
	@echo "$(GREEN)✓ Chart upgraded successfully$(NC)"

.PHONY: uninstall
uninstall: ## 🗑️ Uninstall the chart
	@echo "$(BLUE)Uninstalling chart...$(NC)"
	@helm uninstall $(RELEASE_NAME) --namespace $(NAMESPACE) --wait --timeout 5m
	@echo "$(GREEN)✓ Chart uninstalled successfully$(NC)"

.PHONY: status
status: ## 📊 Show chart status
	@echo "$(BLUE)Chart status:$(NC)"
	@helm status $(RELEASE_NAME) --namespace $(NAMESPACE)

.PHONY: history
history: ## 📜 Show chart history
	@echo "$(BLUE)Chart history:$(NC)"
	@helm history $(RELEASE_NAME) --namespace $(NAMESPACE)

.PHONY: rollback
rollback: ## ⏪ Rollback to previous version
	@echo "$(BLUE)Rolling back chart...$(NC)"
	@helm rollback $(RELEASE_NAME) --namespace $(NAMESPACE) --wait --timeout 5m
	@echo "$(GREEN)✓ Chart rolled back successfully$(NC)"

##@ 🔍 Debugging & Inspection

.PHONY: debug
debug: ## 🐛 Show debug information
	@echo "$(BLUE)Debug information:$(NC)"
	@echo "Kubernetes context: $$(kubectl config current-context)"
	@echo "Namespace: $(NAMESPACE)"
	@echo "Release name: $(RELEASE_NAME)"
	@echo ""
	@echo "$(BLUE)Helm releases:$(NC)"
	@helm list --namespace $(NAMESPACE) || echo "No releases found"
	@echo ""
	@echo "$(BLUE)Kubernetes resources:$(NC)"
	@kubectl get all --namespace $(NAMESPACE) || echo "No resources found"

.PHONY: describe
describe: ## 📋 Describe all chart resources
	@echo "$(BLUE)Describing chart resources...$(NC)"
	@kubectl describe all --namespace $(NAMESPACE) -l app.kubernetes.io/instance=$(RELEASE_NAME)

.PHONY: logs
logs: ## 📜 Show logs for all pods
	@echo "$(BLUE)Showing logs for all pods...$(NC)"
	@kubectl logs --namespace $(NAMESPACE) -l app.kubernetes.io/instance=$(RELEASE_NAME) --all-containers=true --tail=100

.PHONY: logs-follow
logs-follow: ## 📜 Follow logs for all pods
	@echo "$(BLUE)Following logs for all pods...$(NC)"
	@kubectl logs --namespace $(NAMESPACE) -l app.kubernetes.io/instance=$(RELEASE_NAME) --all-containers=true --follow

.PHONY: port-forward
port-forward: ## 🌐 Port-forward to gateway service
	@echo "$(BLUE)Port-forwarding to gateway service...$(NC)"
	@kubectl port-forward --namespace $(NAMESPACE) service/$(RELEASE_NAME)-mcpgateway 4444:80

.PHONY: shell
shell: ## 🐚 Open shell in gateway pod
	@echo "$(BLUE)Opening shell in gateway pod...$(NC)"
	@kubectl exec --namespace $(NAMESPACE) -it deployment/$(RELEASE_NAME)-mcpgateway -- /bin/bash

##@ 📚 Documentation

.PHONY: docs
docs: ## 📚 Generate chart documentation
	@echo "$(BLUE)Generating chart documentation...$(NC)"
	@if command -v helm-docs >/dev/null 2>&1; then \
		helm-docs --chart-search-root=. --template-files=README.md.gotmpl --output-file=README.md; \
		echo "$(GREEN)✓ Documentation generated$(NC)"; \
	else \
		echo "$(YELLOW)⚠ helm-docs not found, skipping documentation generation$(NC)"; \
	fi

.PHONY: schema
schema: ## 📋 Generate values schema (preserves existing schema)
	@echo "$(BLUE)Generating values schema...$(NC)"
	@if command -v helm schema >/dev/null 2>&1; then \
		helm schema --input values.yaml --output values.schema.generated.json; \
		echo "$(GREEN)✓ Values schema generated: values.schema.generated.json$(NC)"; \
		echo "$(YELLOW)⚠ Review and manually merge with values.schema.json if needed$(NC)"; \
		if [ -f values.schema.json ]; then \
			echo "$(BLUE)💡 Compare schemas with: make schema-diff$(NC)"; \
		fi; \
	else \
		echo "$(YELLOW)⚠ helm schema plugin not found$(NC)"; \
		echo "Install with: make install-deps or helm plugin install https://github.com/karuppiah7890/helm-schema-gen"; \
	fi

.PHONY: schema-diff
schema-diff: ## 🔍 Compare existing and generated schemas
	@echo "$(BLUE)Comparing schemas...$(NC)"
	@if [ -f values.schema.json ] && [ -f values.schema.generated.json ]; then \
		if command -v diff >/dev/null 2>&1; then \
			diff -u values.schema.json values.schema.generated.json || echo "$(YELLOW)⚠ Schemas differ$(NC)"; \
		elif command -v jq >/dev/null 2>&1; then \
			echo "$(BLUE)Existing schema keys:$(NC)"; \
			jq -r 'paths(scalars) as $p | $p | join(".")' values.schema.json | sort; \
			echo "$(BLUE)Generated schema keys:$(NC)"; \
			jq -r 'paths(scalars) as $p | $p | join(".")' values.schema.generated.json | sort; \
		else \
			echo "$(YELLOW)⚠ diff or jq not found for comparison$(NC)"; \
		fi; \
	else \
		echo "$(YELLOW)⚠ Both schemas must exist for comparison$(NC)"; \
		echo "Run 'make schema' to generate values.schema.generated.json"; \
	fi

.PHONY: schema-validate
schema-validate: ## ✅ Validate values.yaml against existing schema
	@echo "$(BLUE)Validating values.yaml against schema...$(NC)"
	@if [ -f values.schema.json ]; then \
		if command -v ajv >/dev/null 2>&1; then \
			ajv validate -s values.schema.json -d values.yaml && echo "$(GREEN)✓ Values validation passed$(NC)" || \
			(echo "$(YELLOW)⚠ ajv failed, trying without meta-schema validation$(NC)" && \
			 ajv validate -s values.schema.json -d values.yaml && echo "$(GREEN)✓ Values validation passed$(NC)"); \
		elif command -v ajv-cli >/dev/null 2>&1; then \
			ajv-cli validate -s values.schema.json -d values.yaml && echo "$(GREEN)✓ Values validation passed$(NC)" || \
			(echo "$(YELLOW)⚠ ajv-cli failed, trying helm lint validation$(NC)" && \
			 helm lint . --strict > /dev/null && echo "$(GREEN)✓ Helm lint validation passed$(NC)"); \
		elif command -v python3 >/dev/null 2>&1; then \
			echo "$(YELLOW)⚠ ajv not found, trying Python jsonschema validation$(NC)"; \
			python3 -c "import jsonschema, yaml, json; jsonschema.validate(yaml.safe_load(open('values.yaml')), json.load(open('values.schema.json')))" 2>/dev/null && \
			echo "$(GREEN)✓ Python jsonschema validation passed$(NC)" || \
			(echo "$(YELLOW)⚠ Python validation failed, using helm lint$(NC)" && \
			 helm lint . --strict > /dev/null && echo "$(GREEN)✓ Helm lint validation passed$(NC)"); \
		else \
			echo "$(YELLOW)⚠ No schema validators found, using helm lint for basic validation$(NC)"; \
			echo "$(YELLOW)💡 For proper schema validation, install ajv: npm install -g ajv-cli$(NC)"; \
			helm lint . --strict > /dev/null && echo "$(GREEN)✓ Helm lint validation passed$(NC)"; \
		fi; \
	else \
		echo "$(YELLOW)⚠ values.schema.json not found$(NC)"; \
	fi

.PHONY: schema-validate-simple
schema-validate-simple: ## ✅ Simple schema validation using Python
	@echo "$(BLUE)Validating values.yaml against schema (Python method)...$(NC)"
	@if [ -f values.schema.json ]; then \
		if command -v python3 >/dev/null 2>&1; then \
			python3 -c "import jsonschema, yaml, json; jsonschema.validate(yaml.safe_load(open('values.yaml')), json.load(open('values.schema.json'))); print('✓ Schema validation passed')" || \
			echo "$(YELLOW)⚠ Install required Python packages: pip install jsonschema pyyaml$(NC)"; \
		else \
			echo "$(YELLOW)⚠ Python3 not found$(NC)"; \
		fi; \
	else \
		echo "$(YELLOW)⚠ values.schema.json not found$(NC)"; \
	fi

.PHONY: readme
readme: ## 📖 Update README with chart values
	@echo "$(BLUE)Updating README with chart values...$(NC)"
	@if command -v helm-docs >/dev/null 2>&1; then \
		helm-docs --sort-values-order=file; \
		echo "$(GREEN)✓ README updated$(NC)"; \
	else \
		echo "$(YELLOW)⚠ helm-docs not found$(NC)"; \
	fi

##@ 🔄 Dependencies

.PHONY: deps-update
deps-update: ## 📥 Update chart dependencies
	@echo "$(BLUE)Updating chart dependencies...$(NC)"
	@helm dependency update
	@echo "$(GREEN)✓ Dependencies updated$(NC)"

.PHONY: deps-build
deps-build: ## 🔨 Build chart dependencies
	@echo "$(BLUE)Building chart dependencies...$(NC)"
	@helm dependency build
	@echo "$(GREEN)✓ Dependencies built$(NC)"

.PHONY: deps-clean
deps-clean: ## 🧹 Clean chart dependencies
	@echo "$(BLUE)Cleaning chart dependencies...$(NC)"
	@rm -rf charts/ Chart.lock
	@echo "$(GREEN)✓ Dependencies cleaned$(NC)"

##@ 🛠️ Development Tools

.PHONY: install-deps
install-deps: ## 📥 Install missing development dependencies
	@echo "$(BLUE)Installing development dependencies...$(NC)"
	@echo "$(BLUE)Detecting package manager...$(NC)"
	@if command -v brew >/dev/null 2>&1; then \
		echo "$(GREEN)✓ Using Homebrew$(NC)"; \
		$(MAKE) install-deps-brew; \
	elif command -v apt-get >/dev/null 2>&1; then \
		echo "$(GREEN)✓ Using APT$(NC)"; \
		$(MAKE) install-deps-apt; \
	elif command -v yum >/dev/null 2>&1; then \
		echo "$(GREEN)✓ Using YUM$(NC)"; \
		$(MAKE) install-deps-yum; \
	elif command -v npm >/dev/null 2>&1; then \
		echo "$(GREEN)✓ Using NPM for Node.js tools$(NC)"; \
		$(MAKE) install-deps-npm; \
	else \
		echo "$(YELLOW)⚠ No supported package manager found$(NC)"; \
		echo "Please install tools manually:"; \
		echo "  - yamllint: pip install yamllint"; \
		echo "  - kubeval: https://github.com/instrumenta/kubeval/releases"; \
		echo "  - helm-docs: https://github.com/norwoodj/helm-docs/releases"; \
		echo "  - cosign: https://github.com/sigstore/cosign/releases"; \
		echo "  - prettier: npm install -g prettier"; \
		echo "  - ajv-cli: npm install -g ajv-cli (for JSON schema validation)"; \
		echo "  - fswatch: https://github.com/emcrisostomo/fswatch/releases"; \
	fi
	@$(MAKE) install-helm-plugins

.PHONY: install-deps-brew
install-deps-brew: ## 📥 Install dependencies using Homebrew
	@echo "$(BLUE)Installing dependencies with Homebrew...$(NC)"
	@tools="yamllint kubeval helm-docs cosign prettier fswatch"; \
	for tool in $tools; do \
		if ! command -v $tool >/dev/null 2>&1; then \
			echo "$(BLUE)Installing $tool...$(NC)"; \
			brew install $tool || echo "$(YELLOW)⚠ Failed to install $tool$(NC)"; \
		else \
			echo "$(GREEN)✓ $tool already installed$(NC)"; \
		fi; \
	done

.PHONY: install-deps-apt
install-deps-apt: ## 📥 Install dependencies using APT
	@echo "$(BLUE)Installing dependencies with APT...$(NC)"
	@sudo apt-get update
	@if ! command -v yamllint >/dev/null 2>&1; then \
		echo "$(BLUE)Installing yamllint...$(NC)"; \
		sudo apt-get install -y yamllint || pip3 install yamllint; \
	fi
	@if ! command -v kubeval >/dev/null 2>&1; then \
		echo "$(BLUE)Installing kubeval...$(NC)"; \
		wget -O /tmp/kubeval.tar.gz https://github.com/instrumenta/kubeval/releases/latest/download/kubeval-linux-amd64.tar.gz; \
		tar -xzf /tmp/kubeval.tar.gz -C /tmp/; \
		sudo mv /tmp/kubeval /usr/local/bin/; \
	fi
	@if ! command -v helm-docs >/dev/null 2>&1; then \
		echo "$(BLUE)Installing helm-docs...$(NC)"; \
		wget -O /tmp/helm-docs.tar.gz https://github.com/norwoodj/helm-docs/releases/latest/download/helm-docs_$(shell uname -s)_$(shell uname -m).tar.gz; \
		tar -xzf /tmp/helm-docs.tar.gz -C /tmp/; \
		sudo mv /tmp/helm-docs /usr/local/bin/; \
	fi
	@if ! command -v prettier >/dev/null 2>&1; then \
		echo "$(BLUE)Installing prettier via npm...$(NC)"; \
		sudo npm install -g prettier || echo "$(YELLOW)⚠ npm not found, skipping prettier$(NC)"; \
	fi
	@if ! command -v ajv-cli >/dev/null 2>&1; then \
		echo "$(BLUE)Installing ajv-cli for JSON schema validation...$(NC)"; \
		sudo npm install -g ajv-cli || echo "$(YELLOW)⚠ npm not found, skipping ajv-cli$(NC)"; \
	fi

.PHONY: install-deps-yum
install-deps-yum: ## 📥 Install dependencies using YUM
	@echo "$(BLUE)Installing dependencies with YUM...$(NC)"
	@if ! command -v yamllint >/dev/null 2>&1; then \
		echo "$(BLUE)Installing yamllint...$(NC)"; \
		sudo yum install -y yamllint || pip3 install yamllint; \
	fi
	@echo "$(YELLOW)⚠ Please install remaining tools manually:$(NC)"
	@echo "  - kubeval: https://github.com/instrumenta/kubeval/releases"
	@echo "  - helm-docs: https://github.com/norwoodj/helm-docs/releases"
	@echo "  - cosign: https://github.com/sigstore/cosign/releases"

.PHONY: install-deps-npm
install-deps-npm: ## 📥 Install Node.js dependencies using NPM
	@echo "$(BLUE)Installing Node.js dependencies with NPM...$(NC)"
	@if ! command -v prettier >/dev/null 2>&1; then \
		echo "$(BLUE)Installing prettier...$(NC)"; \
		npm install -g prettier; \
	fi
	@if ! command -v ajv-cli >/dev/null 2>&1; then \
		echo "$(BLUE)Installing ajv-cli for JSON schema validation...$(NC)"; \
		npm install -g ajv-cli; \
	fi

.PHONY: install-helm-plugins
install-helm-plugins: ## 📥 Install required Helm plugins
	@echo "$(BLUE)Installing Helm plugins...$(NC)"
	@if ! helm plugin list | grep -q "schema"; then \
		echo "$(BLUE)Installing helm-schema plugin...$(NC)"; \
		helm plugin install https://github.com/karuppiah7890/helm-schema-gen || echo "$(YELLOW)⚠ Failed to install helm-schema$(NC)"; \
	else \
		echo "$(GREEN)✓ helm-schema plugin already installed$(NC)"; \
	fi
	@if ! helm plugin list | grep -q "diff"; then \
		echo "$(BLUE)Installing helm-diff plugin...$(NC)"; \
		helm plugin install https://github.com/databus23/helm-diff || echo "$(YELLOW)⚠ Failed to install helm-diff$(NC)"; \
	else \
		echo "$(GREEN)✓ helm-diff plugin already installed$(NC)"; \
	fi

.PHONY: setup-dev
setup-dev: ## 🔧 Set up development environment
	@echo "$(BLUE)Setting up development environment...$(NC)"
	@mkdir -p $(TEMP_DIR) $(DIST_DIR)
	@if [ ! -f my-values.yaml ]; then \
		cp values.yaml my-values.yaml; \
		echo "$(GREEN)✓ Created my-values.yaml$(NC)"; \
	fi
	@echo "$(GREEN)✓ Development environment ready$(NC)"
	@echo "$(YELLOW)💡 Run 'make install-deps' to install optional development tools$(NC)"

.PHONY: watch
watch: ## 👀 Watch for changes and re-lint
	@echo "$(BLUE)Watching for changes...$(NC)"
	@if command -v fswatch >/dev/null 2>&1; then \
		fswatch -o . -e "$(DIST_DIR)" -e "$(TEMP_DIR)" -e "*.tgz" | xargs -n1 -I{} make lint; \
	else \
		echo "$(YELLOW)⚠ fswatch not found, install with: brew install fswatch$(NC)"; \
	fi

.PHONY: format
format: ## 🎨 Format YAML files
	@echo "$(BLUE)Formatting YAML files...$(NC)"
	@if command -v prettier >/dev/null 2>&1; then \
		prettier --write "**/*.{yaml,yml}" --ignore-path .helmignore; \
		echo "$(GREEN)✓ YAML files formatted$(NC)"; \
	else \
		echo "$(YELLOW)⚠ prettier not found, skipping formatting$(NC)"; \
	fi

.PHONY: check-tools
check-tools: ## 🔍 Check for required tools
	@echo "$(BLUE)Checking for required tools...$(NC)"
	@tools="helm kubectl"; \
	missing_required=""; \
	for tool in $tools; do \
		if command -v $tool >/dev/null 2>&1; then \
			echo "$(GREEN)✓ $tool$(NC)"; \
		else \
			echo "$(RED)✗ $tool (required)$(NC)"; \
			missing_required="$missing_required $tool"; \
		fi; \
	done
	@if [ -n "$missing_required" ]; then \
		echo "$(RED)Missing required tools:$missing_required$(NC)"; \
		echo "Please install them manually."; \
		exit 1; \
	fi
	@echo ""
	@echo "$(BLUE)Checking for optional tools...$(NC)"
	@tools="yamllint kubeval helm-docs cosign prettier fswatch"; \
	missing_optional=""; \
	for tool in $tools; do \
		if command -v $tool >/dev/null 2>&1; then \
			echo "$(GREEN)✓ $tool$(NC)"; \
		else \
			echo "$(YELLOW)- $tool (optional)$(NC)"; \
			missing_optional="$missing_optional $tool"; \
		fi; \
	done
	@echo ""
	@echo "$(BLUE)Checking for Helm plugins...$(NC)"
	@plugins="schema diff"; \
	for plugin in $plugins; do \
		if helm plugin list | grep -q "$plugin"; then \
			echo "$(GREEN)✓ helm-$plugin$(NC)"; \
		else \
			echo "$(YELLOW)- helm-$plugin (optional)$(NC)"; \
		fi; \
	done
	@if [ -n "$missing_optional" ]; then \
		echo ""; \
		echo "$(YELLOW)💡 Install missing tools with: make install-deps$(NC)"; \
	fi

##@ 🧪 Integration Testing

.PHONY: test-integration
test-integration: install ## 🧪 Run integration tests
	@echo "$(BLUE)Running integration tests...$(NC)"
	@echo "Waiting for pods to be ready..."
	@kubectl wait --for=condition=ready pod --namespace $(NAMESPACE) -l app.kubernetes.io/instance=$(RELEASE_NAME) --timeout=300s
	@echo "$(GREEN)✓ Integration tests passed$(NC)"

.PHONY: test-e2e
test-e2e: install ## 🔄 Run end-to-end tests
	@echo "$(BLUE)Running end-to-end tests...$(NC)"
	@kubectl wait --for=condition=ready pod --namespace $(NAMESPACE) -l app.kubernetes.io/instance=$(RELEASE_NAME) --timeout=300s
	@kubectl port-forward --namespace $(NAMESPACE) service/$(RELEASE_NAME)-mcpgateway 4444:80 &
	@sleep 5
	@curl -f http://localhost:4444/health || (echo "$(RED)✗ Health check failed$(NC)" && exit 1)
	@pkill -f "kubectl port-forward" || true
	@echo "$(GREEN)✓ End-to-end tests passed$(NC)"

.PHONY: test-cleanup
test-cleanup: ## 🧹 Clean up test resources
	@echo "$(BLUE)Cleaning up test resources...$(NC)"
	@helm uninstall $(RELEASE_NAME) --namespace $(NAMESPACE) --ignore-not-found --wait --timeout 5m
	@kubectl delete namespace $(NAMESPACE) --ignore-not-found --wait --timeout 5m
	@echo "$(GREEN)✓ Test cleanup completed$(NC)"

##@ 🎯 CI/CD Targets

.PHONY: ci-setup
ci-setup: check-tools ## 🔄 CI: Set up CI environment
	@echo "$(BLUE)Setting up CI environment...$(NC)"
	@$(MAKE) setup-dirs
	@echo "$(GREEN)✓ CI setup completed$(NC)"

.PHONY: ci-lint
ci-lint: validate-all ## 🔄 CI: Run linting and validation
	@echo "$(GREEN)✓ CI linting completed$(NC)"

.PHONY: ci-test
ci-test: test-all ## 🔄 CI: Run all tests
	@echo "$(GREEN)✓ CI testing completed$(NC)"

.PHONY: ci-package
ci-package: package ## 🔄 CI: Package chart
	@echo "$(GREEN)✓ CI packaging completed$(NC)"

.PHONY: ci-publish
ci-publish: push ## 🔄 CI: Publish chart
	@echo "$(GREEN)✓ CI publishing completed$(NC)"

.PHONY: ci-all
ci-all: ci-setup ci-lint ci-test ci-package ## 🔄 CI: Run all CI tasks

# ==============================================================================
# UTILITY FUNCTIONS
# ==============================================================================

# Ensure temp directory exists
$(TEMP_DIR):
	@mkdir -p $(TEMP_DIR)

# Ensure dist directory exists
$(DIST_DIR):
	@mkdir -p $(DIST_DIR)

# Set up directories
.PHONY: setup-dirs
setup-dirs: $(TEMP_DIR) $(DIST_DIR)

# Include setup-dirs as a dependency for targets that need it
test-template: setup-dirs
package: setup-dirs
package-dev: setup-dirs

# ==============================================================================
# PHONY TARGETS
# ==============================================================================

.PHONY: all
all: validate-all test-all package ## 🎯 Run full build pipeline

# Mark all targets as phony
.PHONY: $(MAKECMDGOALS)
