Makefile

# wsl2-devkit — task runner (run inside WSL/Ubuntu)
.DEFAULT_GOAL := help
SHELL := /bin/bash

WSL_SCRIPTS := wsl/stage2-ubuntu.sh wsl/verify-setup.sh demo/lib/setup.sh demo/lib/stage1.sh demo/lib/stage2.sh

.PHONY: help verify verify-quiet lint demo bump-go checksums

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

verify: ## Run the WSL dev-environment health check
	@bash wsl/verify-setup.sh

verify-quiet: ## Health check — problems + summary only
	@bash wsl/verify-setup.sh -q

bump-go: ## Update the pinned Go version + in-repo checksums in stage2-ubuntu.sh
	@set -e; \
	json=$$(curl -fs "https://go.dev/dl/?mode=json"); \
	v=$$(echo "$$json" | jq -r '.[0].version'); \
	a=$$(echo "$$json" | jq -r '.[0].files[] | select(.os=="linux" and .arch=="amd64" and .kind=="archive").sha256'); \
	m=$$(echo "$$json" | jq -r '.[0].files[] | select(.os=="linux" and .arch=="arm64" and .kind=="archive").sha256'); \
	[ -n "$$v" ] && [ -n "$$a" ] && [ -n "$$m" ] || { echo "failed to fetch Go release metadata"; exit 1; }; \
	sed -i "s|^    GO_VERSION=\".*\"|    GO_VERSION=\"$$v\"|" wsl/stage2-ubuntu.sh; \
	sed -i "s|^    GO_SHA256_AMD64=\".*\"|    GO_SHA256_AMD64=\"$$a\"|" wsl/stage2-ubuntu.sh; \
	sed -i "s|^    GO_SHA256_ARM64=\".*\"|    GO_SHA256_ARM64=\"$$m\"|" wsl/stage2-ubuntu.sh; \
	echo "Pinned $$v"; \
	echo "  amd64 $$a"; \
	echo "  arm64 $$m"; \
	git diff --stat -- wsl/stage2-ubuntu.sh

demo: ## Record the README walkthrough GIF (needs charmbracelet/vhs)
	@command -v vhs >/dev/null || { echo "vhs not found — install: go install github.com/charmbracelet/vhs@latest"; exit 1; }
	@vhs demo/devkit-demo.tape && echo "Wrote demo/devkit-demo.gif"

checksums: ## Write checksums.txt (SHA256 of every script) for a release
	@sha256sum windows/*.ps1 wsl/*.sh | tee checksums.txt
	@echo "-> attach checksums.txt to the GitHub release (see CONTRIBUTING.md, Releasing)"

lint: ## Syntax-check + shellcheck the shell scripts (wsl/ + demo/lib/)
	@for f in $(WSL_SCRIPTS); do \
		echo "== $$f =="; \
		bash -n "$$f" && echo "  bash -n OK"; \
		if command -v shellcheck >/dev/null; then shellcheck -S warning "$$f" || true; fi; \
	done
	@echo "Note: PowerShell scripts (windows/*.ps1) lint on Windows via PSScriptAnalyzer."