Makefile

# Copyright © 2026 OpenCHAMI a Series of LF Projects, LLC
# SPDX-FileCopyrightText: 2026 OpenCHAMI Contributors
#
# SPDX-License-Identifier: MIT

.PHONY: help build test test-integration lint clean install run docker-build docker-run release-test check-no-pkg-resources-imports generate generate-check dev reuse-annotate-generated

# Variables
BINARY_NAME=fru-tracker-server
CLIENT_BINARY_NAME=fru-tracker-client
GO=go
GOFLAGS=-v
TEST_TIMEOUT ?= 5m
VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
COMMIT ?= $(shell git rev-parse --short HEAD 2>/dev/null || echo "unknown")
DATE ?= $(shell date -u +"%Y-%m-%dT%H:%M:%SZ")
LDFLAGS=-ldflags "-X main.version=$(VERSION) -X main.commit=$(COMMIT) -X main.date=$(DATE)"
FABRICA_CMD ?= go run github.com/openchami/fabrica/cmd/fabrica@latest
FABRICA_SOURCE_ARG ?=
FABRICA_ENV ?=
LOCAL_FABRICA ?=

ifneq ($(strip $(LOCAL_FABRICA)),)
FABRICA_CMD := $(LOCAL_FABRICA)/bin/fabrica
FABRICA_SOURCE_ARG := --fabrica-source $(LOCAL_FABRICA)
FABRICA_ENV := GOTOOLCHAIN=auto
endif

help: ## Display this help screen
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'


build: generate
	go build -o bin/$(BINARY_NAME) ./cmd/server/
	go build -o bin/$(CLIENT_BINARY_NAME) ./cmd/client/

generate: ## Regenerate Fabrica outputs
ifneq ($(strip $(LOCAL_FABRICA)),)
	@if [ ! -x $(LOCAL_FABRICA)/bin/fabrica ]; then \
		echo "Local Fabrica binary not found at $(LOCAL_FABRICA)/bin/fabrica"; \
		echo "Build it with: (cd $(LOCAL_FABRICA) && go build -o bin/fabrica ./cmd/fabrica)"; \
		exit 1; \
	fi
endif
	$(FABRICA_ENV) $(FABRICA_CMD) generate $(FABRICA_SOURCE_ARG)
	$(GO) mod tidy
	@$(MAKE) reuse-annotate-generated

reuse-annotate-generated: ## Add SPDX headers to generated Go files when REUSE is installed
	@if command -v reuse >/dev/null 2>&1; then \
		files=$$({ \
			find internal/storage/ent -type f -name '*.go' -print; \
			find cmd internal pkg -type f -name '*_generated.go' -print; \
			printf '%s\n' cmd/server/export.go cmd/server/import.go cmd/client/main.go; \
		} | while IFS= read -r file; do [ -f "$$file" ] && echo "$$file"; done | sort -u); \
		if [ -n "$$files" ]; then \
			reuse annotate --copyright="OpenCHAMI Contributors" --license="MIT" --year="$(shell date +%Y)" --skip-existing $$files; \
		fi; \
	else \
		echo "reuse not installed; skipping generated file annotation"; \
	fi

generate-check: ## Fail if generated files are out of sync (requires clean git tree)
	@if ! git diff --quiet || ! git diff --cached --quiet; then \
		echo "Working tree must be clean before running generate-check"; \
		git --no-pager status --short; \
		exit 1; \
	fi
	$(MAKE) generate LOCAL_FABRICA="$(LOCAL_FABRICA)"
	@if ! git diff --quiet || ! git diff --cached --quiet; then \
		echo "Generated files are out of sync. Run 'make generate' and commit the results."; \
		git --no-pager diff --stat; \
		exit 1; \
	fi

dev: build ## Regenerate code then build server and client binaries

test: ## Run tests
	$(GO) test $(GOFLAGS) -timeout $(TEST_TIMEOUT) -race -coverprofile=coverage.out -covermode=atomic $$(go list ./... 2>/dev/null | grep -v /demo/)

test-integration: ## Run integration tests with explicit timeout (override with TEST_TIMEOUT=)
	$(GO) test $(GOFLAGS) -timeout $(TEST_TIMEOUT) ./cmd/server -run TestDiscoverySnapshotIntegration -v

test-coverage: test ## Run tests with coverage report
	$(GO) tool cover -html=coverage.out -o coverage.html
	@echo "Coverage report generated: coverage.html"

lint: ## Run golangci-lint
	golangci-lint run

lint-fix: ## Run golangci-lint with auto-fix
	golangci-lint run --fix

clean: ## Clean build artifacts
	rm -rf bin/ dist/ coverage.out coverage.html
	$(GO) clean -cache

tidy: ## Tidy go.mod
	$(GO) mod tidy

run: build ## Build and run the application
	./bin/$(BINARY_NAME) serve

docker-build: ## Build Docker image
	docker build -t fru-tracker:latest .

docker-run: docker-build ## Build and run Docker container
	docker run --rm fru-tracker:latest

release-snapshot: ## Create a snapshot release with GoReleaser
	goreleaser release --snapshot --clean

release-test: ## Test release locally using GoReleaser snapshot (requires goreleaser)
	@command -v goreleaser >/dev/null 2>&1 || { echo "goreleaser is required but not installed. Install with: 'brew install goreleaser' or 'go install github.com/goreleaser/goreleaser@latest'"; exit 1; }
	@goreleaser release --snapshot --clean

fmt: ## Format code
	$(GO) fmt ./...
	goimports -w .

vet: ## Run go vet
	$(GO) vet ./...

vuln: ## Check for vulnerabilities
	govulncheck ./...

reuse: ## Check REUSE compliance
	reuse lint

reuse-spdx: ## Generate SPDX bill of materials
	reuse spdx -o reuse.spdx

reuse-install: ## Install REUSE tool
	@command -v pipx >/dev/null 2>&1 || { echo "pipx is required but not installed. Install it with: python3 -m pip install --user pipx"; exit 1; }
	pipx install reuse
	@echo "REUSE tool installed successfully"

reuse-annotate: ## Add REUSE headers to all files in the repository
	@echo "Annotating files with REUSE headers..."
	@echo "This will add SPDX headers to files that don't have them yet."
# REUSE-IgnoreStart
	@read -p "Copyright holder [OpenCHAMI Contributors]: " holder; \
	holder=$${holder:-OpenCHAMI Contributors}; \
	read -p "License [MIT]: " license; \
	license=$${license:-MIT}; \
	read -p "Year [$(shell date +%Y)]: " year; \
	year=$${year:-$(shell date +%Y)}; \
	echo "Annotating with: SPDX-FileCopyrightText: $$year $$holder"; \
	echo "                 SPDX-License-Identifier: $$license"; \
	reuse annotate --copyright="$$holder" --license="$$license" --year="$$year" --skip-existing --recursive --skip-unrecognized .
# REUSE-IgnoreEnd

reuse-download-license: ## Download a license file (usage: make reuse-download-license LICENSE=MIT)
	@if [ -z "$(LICENSE)" ]; then \
		echo "Error: LICENSE variable is required. Usage: make reuse-download-license LICENSE=MIT"; \
		exit 1; \
	fi
	reuse download $(LICENSE)

pre-commit-install: ## Install pre-commit tool
	@command -v pipx >/dev/null 2>&1 || { echo "pipx is required but not installed. Install it with: python3 -m pip install --user pipx"; exit 1; }
	pipx install pre-commit
	@echo "pre-commit installed successfully"

pre-commit-setup: ## Install pre-commit hooks
	@command -v pre-commit >/dev/null 2>&1 || { echo "pre-commit is not installed. Run 'make pre-commit-install' first."; exit 1; }
	pre-commit install
	pre-commit install --hook-type commit-msg
	@echo "pre-commit hooks installed successfully"

pre-commit-run: ## Run pre-commit hooks on all files
	pre-commit run --all-files

pre-commit-update: ## Update pre-commit hooks to latest versions
	pre-commit autoupdate

setup-dev: reuse-install pre-commit-install pre-commit-setup ## Set up development environment (install tools and hooks)
	@echo ""
	@echo "Development environment setup complete!"
	@echo "Next steps:"
	@echo "  1. Run 'make reuse-annotate' to add REUSE headers to all files"
	@echo "  2. Run 'make pre-commit-run' to test pre-commit hooks"
	@echo "  3. Start coding! Pre-commit hooks will run automatically on git commit"
	@echo ""
	@echo "Optional: Install 'act' to test GitHub Actions locally:"
	@echo "  brew install act"
	@echo "  make act-list  # List available workflows"

act-install: ## Install act (GitHub Actions local runner) via Homebrew
	@command -v brew >/dev/null 2>&1 || { echo "Homebrew is required. Install from https://brew.sh"; exit 1; }
	brew install act
	@echo "act installed successfully"

act-list: ## List all GitHub Actions workflows
	@command -v act >/dev/null 2>&1 || { echo "act is not installed. Run 'make act-install' first."; exit 1; }
	@echo "Available workflows:"
	@ls -1 .github/workflows/*.yaml | sed 's/.*\//  - /'

act-test: ## Run GitHub Actions test workflow locally (ubuntu only, stable Go)
	@command -v act >/dev/null 2>&1 || { echo "act is not installed. Run 'make act-install' first."; exit 1; }
	@echo "Note: Testing with ubuntu-latest and stable Go version only (full matrix runs on GitHub)"
	act push -W .github/workflows/test.yaml --container-architecture linux/amd64 --matrix os:ubuntu-latest --matrix go-version:stable

act-build: ## Run GitHub Actions build workflow locally
	@command -v act >/dev/null 2>&1 || { echo "act is not installed. Run 'make act-install' first."; exit 1; }
	act push -W .github/workflows/build.yaml --container-architecture linux/amd64

act-lint: ## Run GitHub Actions golangci-lint workflow locally
	@command -v act >/dev/null 2>&1 || { echo "act is not installed. Run 'make act-install' first."; exit 1; }
	act push -W .github/workflows/golangci-lint.yaml --container-architecture linux/amd64

act-reuse: ## Run GitHub Actions REUSE workflow locally
	@command -v act >/dev/null 2>&1 || { echo "act is not installed. Run 'make act-install' first."; exit 1; }
	act push -W .github/workflows/reuse.yaml --container-architecture linux/amd64

act-vuln: ## Run GitHub Actions vulnerability check workflow locally
	@command -v act >/dev/null 2>&1 || { echo "act is not installed. Run 'make act-install' first."; exit 1; }
	act push -W .github/workflows/govulncheck.yaml --container-architecture linux/amd64

act-all: ## Run all testable workflows locally (build, test, lint, reuse, vuln)
	@command -v act >/dev/null 2>&1 || { echo "act is not installed. Run 'make act-install' first."; exit 1; }
	@echo "Running all testable workflows..."
	@echo "\n=== Build Workflow ==="
	@act -W .github/workflows/build.yaml || true
	@echo "\n=== Test Workflow ==="
	@act -W .github/workflows/test.yaml || true
	@echo "\n=== Lint Workflow ==="
	@act -W .github/workflows/golangci-lint.yaml || true
	@echo "\n=== REUSE Workflow ==="
	@act -W .github/workflows/reuse.yaml || true
	@echo "\n=== Vulnerability Check Workflow ==="
	@act -W .github/workflows/govulncheck.yaml || true

all: clean install lint test build ## Run all checks and build

.DEFAULT_GOAL := help