Makefile

SHELL := /bin/bash

include scripts/tool-versions.env
export HELM_DOCS_VERSION HELM_UNITTEST_VERSION HELMCOV_VERSION HELMCOV_CHECKSUMS_SHA256 COVERAGE_THRESHOLD BRANCH_COVERAGE_THRESHOLD

CHART ?= charts/clickstack
SUITES ?= $(patsubst integration-tests/%/suite.yaml,%,$(wildcard integration-tests/*/suite.yaml))
HELM_UNITTEST_PLUGIN := https://github.com/helm-unittest/helm-unittest.git
# Coverage minimums come from scripts/tool-versions.env; override with `make coverage COVERAGE_THRESHOLD=N BRANCH_COVERAGE_THRESHOLD=N`.

.PHONY: help setup ci-setup hooks chart-deps install-helm-unittest install-helm-docs validate test coverage integration docs docs-check ci

help:
	@echo "Targets:"
	@echo "  make setup     Install helm-unittest, helm-docs, chart deps, and git hooks"
	@echo "  make test      Run helm-unittest and example values validation"
	@echo "  make coverage  Run helmcov template coverage (min $(COVERAGE_THRESHOLD)% line, $(BRANCH_COVERAGE_THRESHOLD)% branch)"
	@echo "  make integration  Run Kind integration suites (needs kind, kubectl, yq; SUITES=api-only for one)"
	@echo "  make docs      Regenerate chart README files from values.yaml via helm-docs"
	@echo "  make ci        Run test, coverage, and docs verification"
	@echo ""
	@echo "Variables:"
	@echo "  CHART=$(CHART)"
	@echo "  SUITES=$(SUITES)"
	@echo "  HELMCOV_VERSION=$(HELMCOV_VERSION)"
	@echo "  HELM_UNITTEST_VERSION=$(HELM_UNITTEST_VERSION)"
	@echo "  COVERAGE_THRESHOLD=$(COVERAGE_THRESHOLD)"
	@echo "  BRANCH_COVERAGE_THRESHOLD=$(BRANCH_COVERAGE_THRESHOLD)"

setup: hooks ci-setup
	@echo "Setup complete."

ci-setup: install-helm-unittest install-helm-docs chart-deps

hooks:
	./scripts/install-hooks.sh

install-helm-docs:
	./scripts/install-helm-docs.sh

chart-deps:
	@command -v helm >/dev/null || { echo "helm is required; install Helm 3 first." >&2; exit 1; }
	helm dependency build $(CHART)

install-helm-unittest:
	@command -v helm >/dev/null || { echo "helm is required; install Helm 3 first." >&2; exit 1; }
	@want="$(HELM_UNITTEST_VERSION:v%=%)"; \
	installed=$$(helm plugin list 2>/dev/null | awk '$$1=="unittest"{print $$2}'); \
	if [ "$$installed" = "$$want" ]; then \
		echo "helm-unittest $(HELM_UNITTEST_VERSION) already installed"; \
	else \
		[ -n "$$installed" ] && { echo "Replacing helm-unittest $$installed with $(HELM_UNITTEST_VERSION)..."; helm plugin uninstall unittest >/dev/null 2>&1 || true; } || true; \
		echo "Installing helm-unittest $(HELM_UNITTEST_VERSION)..."; \
		helm plugin install $(HELM_UNITTEST_PLUGIN) --version $(HELM_UNITTEST_VERSION); \
	fi

validate: chart-deps
	@for f in examples/*/values.yaml; do echo "Validating $$f"; helm template clickstack-example $(CHART) -f "$$f" >/dev/null || exit 1; done

test: chart-deps validate
	helm unittest $(CHART)

coverage: chart-deps
	THRESHOLD=$(COVERAGE_THRESHOLD) BRANCH_THRESHOLD=$(BRANCH_COVERAGE_THRESHOLD) ./scripts/helmcov.sh

# Each suite gets its own Kind cluster; delete it whether the suite passes or not.
integration:
	@for t in kind kubectl yq helm; do command -v $$t >/dev/null || { echo "$$t is required for integration tests." >&2; exit 1; }; done
	@for s in $(SUITES); do \
		rc=0; ./integration-tests/run-suite.sh "$$s" || rc=$$?; \
		kind delete cluster --name "test-$$s" || true; \
		[ $$rc -eq 0 ] || exit $$rc; \
	done

docs: install-helm-docs
	./scripts/helmdocs.sh

docs-check: docs
	@git diff --exit-code -- charts/clickstack/README.md charts/clickstack-operators/README.md; \
		rc=$$?; \
		git checkout -- charts/clickstack/README.md charts/clickstack-operators/README.md; \
		exit $$rc

ci: test coverage docs-check