Makefile

SHELL := /bin/bash

GO_ROOT := $(shell go env GOROOT)
GIT_SHA := $(shell git rev-parse HEAD)
GIT_SHA_SHORT := $(shell git rev-parse --short HEAD)
DATE := $(shell date -u +"%Y-%m-%dT%H:%M:%SZ")
VERSION := $(shell git describe --tags)-$(GIT_SHA_SHORT)
LDFLAGS := -s -w \
	-X 'github.com/runmedev/runme/v3/internal/version.BuildDate=$(DATE)' \
	-X 'github.com/runmedev/runme/v3/internal/version.BuildVersion=$(subst v,,$(VERSION))' \
	-X 'github.com/runmedev/runme/v3/internal/version.Commit=$(GIT_SHA)'

LDTESTFLAGS := -X 'github.com/runmedev/runme/v3/internal/version.BuildVersion=$(subst v,,$(VERSION))'

ifeq ($(RUNME_EXT_BASE),)
RUNME_EXT_BASE := "../vscode-runme"
endif

.PHONY: build
build: BUILD_OUTPUT ?= runme
build:
	CGO_ENABLED=0 go build -o $(BUILD_OUTPUT) -ldflags="$(LDFLAGS)" main.go

.PHONY: wasm
wasm: WASM_OUTPUT ?= examples/web
wasm:
	cp $(GO_ROOT)/lib/wasm/wasm_exec.js $(WASM_OUTPUT)
	GOOS=js GOARCH=wasm go build -o $(WASM_OUTPUT)/runme.wasm -ldflags="$(LDFLAGS)" ./web

.PHONY: test/execute
test/execute: PKGS ?= "./..."
test/execute: RUN ?= .*
test/execute: RACE ?= false
test/execute: TAGS ?= "" # e.g. TAGS="docker_enabled"
# It depends on the build target because the runme binary
# is used for tests, for example, "runme env dump".
test/execute: build
	TZ=UTC go test -ldflags="$(LDTESTFLAGS)" -run="$(RUN)" -tags="$(TAGS)" -timeout=60s -race=$(RACE) $(PKGS)

.PHONY: test/coverage
test/coverage: PKGS ?= "./..."
test/coverage: RUN ?= .*
test/coverage: GOCOVERDIR ?= "."
test/coverage: TAGS ?= "" # e.g. TAGS="docker_enabled"
# It depends on the build target because the runme binary
# is used for tests, for example, "runme env dump".
test/coverage: build
	TZ=UTC go test -ldflags="$(LDTESTFLAGS)" -run="$(RUN)" -tags="$(TAGS)" -timeout=180s -covermode=atomic -coverprofile=cover.out -coverpkg=./... $(PKGS)

.PHONY: test
test: test/execute

.PHONY: test-coverage
test-coverage: test/coverage

.PHONY: test-docker
test-docker: test-docker/setup test-docker/run

.PHONY: test-docker/setup
test-docker/setup:
	docker pull \
		ghcr.io/runmedev/runme-build-env:latest
	docker volume create dev.runme.test-env-gocache

.PHONY: test-docker/cleanup
test-docker/cleanup:
	docker volume rm dev.runme.test-env-gocache

.PHONY: test-docker/run
test-docker/run:
	docker run --rm \
		-e RUNME_TEST_ENV=docker \
		-v $(shell pwd):/workspace \
		-v dev.runme.test-env-gocache:/root/.cache/go-build \
		ghcr.io/runmedev/runme-build-env:latest

.PHONY: build-docker
build-docker:
	docker build \
		--progress=plain \
		-t runme-build-env:latest \
		-f ./docker/runme-build-env.Dockerfile .

.PHONY: test/parser
test/parser:
	./runme --version
	find "$$GOPATH/pkg/mod/github.com" -name "*.md" | grep -v "\/\." | grep -v glamour | xargs dirname | uniq | xargs -n1 -I {} ./runme fmt --project {} > /dev/null

.PHONY: coverage/html
test/coverage/html:
	go tool cover -html=cover.out

.PHONY: coverage/func
test/coverage/func:
	go tool cover -func=cover.out

.PHONY: install/dev
install/dev:
	@# Most of the tools got moved to go.mod, but this is used in buf.gen.yaml.
	@# Remove when buf starts respecting binaries from provided by "go tool".
	go install github.com/stateful/go-proto-gql/protoc-gen-gql@latest
	@# Does not work with "go tool".
	go install gvisor.dev/gvisor/tools/checklocks/cmd/checklocks@go

.PHONY: fmt
fmt:
	@go tool gofumpt -w .
	@go tool goimports -local="github.com/runmedev/runme" -w -l .

.PHONY: generate
generate: _generate fmt

.PHONY: _generate
_generate:
	go generate ./...

.PHONY: lint
lint:
	@# "gofumpt -d ." does not return non-zero exit code if there are changes
	test -z "$$(git ls-files '*.go' | xargs go tool gofumpt -d)"
	@# "goimports -d ." does not return non-zero exit code if there are changes
	test -z $(shell go tool goimports -local="github.com/runmedev/runme" -l .)
	go tool revive \
		-config revive.toml \
		-formatter friendly \
		-exclude pkg/agent/... \
		./...
	go tool staticcheck ./...
	go tool gosec -quiet -exclude=G110,G115,G204,G304,G404 -exclude-dir=pkg/agent -exclude-generated ./...
	go vet -stdmethods=false ./...
	go vet -vettool=$(shell go env GOPATH)/bin/checklocks $(shell go list ./... | grep -v '^github.com/runmedev/runme/v3/pkg/agent')

.PHONY: pre-commit
pre-commit: build wasm test lint
	pre-commit run --all-files

.PHONY: proto/generate
proto/generate: proto/_generate fmt

.PHONY: proto/_generate
proto/_generate:
	cd api/proto && buf dep update
	buf lint
	buf format -w
	buf generate
	echo '{"type":"module","name":"@buf/runmedev_runme.bufbuild_es","dependencies":{"@buf/bufbuild_protovalidate.bufbuild_es":"2.9.0-20250912141014-52f32327d4b0.1","@buf/googleapis_googleapis.bufbuild_es":"2.9.0-20251009205305-72c8614f3bd0.1","@bufbuild/protobuf":"2.9.0"}}' > api/gen/proto/es/package.json
	cd api/gen/proto/es && npm install
	./api/proto/agent/tools/v1/build_tool_mcps.sh

.PHONY: proto/clean
proto/clean:
	rm -rf api/gen/proto

.PHONY: proto/dev
proto/dev: build proto/clean proto/generate
	rm -rf $(RUNME_EXT_BASE)/node_modules/@buf/runmedev_runme.community_timostamm-protobuf-ts/runme
	cp -vrf api/gen/proto/ts/runme $(RUNME_EXT_BASE)/node_modules/@buf/runmedev_runme.community_timostamm-protobuf-ts

.PHONY: proto/dev/reset
proto/dev/reset:
	rm -rf $(RUNME_EXT_BASE)/node_modules/@buf/runmedev_runme.community_timostamm-protobuf-ts
	cd $(RUNME_EXT_BASE) && runme run setup

# Remember to set up buf registry beforehand.
# More: https://docs.buf.build/bsr/authentication
.PHONY: proto/publish
proto/publish:
	@cd ./api/proto && buf push

.PHONY: config/schema/generate
config/schema/generate:
	@go tool go-jsonschema -t \
		-p config \
		--tags "json,yaml" \
		-o internal/config/config_schema.go \
	internal/config/config.schema.json

.PHONY: gql/schema/generate
gql/schema/generate:
	@go run ./tools/gqltool/main.go > ./internal/client/graphql/schema/introspection_query_result.json
	@npm install --prefix internal/client/graphql/schema
	@cd ./internal/client/graphql/schema && npm run convert

.PHONY: install/goreleaser
install/goreleaser:
	go install github.com/goreleaser/goreleaser@v1.26.2

.PHONY: release
release: install/goreleaser
	@goreleaser check
	@goreleaser release --snapshot --clean

.PHONY: release/publish
release/publish: install/goreleaser
	@goreleaser release