odek/Makefile at main · BackendStack21/odek · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
# odek — the fastest, minimalistic autonomous ReAct agent CLI in Go.
# https://github.com/BackendStack21/odek

GO      := go
GOLINT  := $(shell command -v golangci-lint 2>/dev/null)
GIT_TAG := $(shell git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0-dev")
LDFLAGS := -s -w -X main.version=$(GIT_TAG)
COVER   := coverage.out
BINARY  := odek

.PHONY: all
all: test build

# ── Build ──────────────────────────────────────────────────────────────

.PHONY: build
build: ## Build the odek binary
	$(GO) build -ldflags "$(LDFLAGS)" -o bin/$(BINARY) ./cmd/$(BINARY)

.PHONY: install
install: ## Install odek to $GOPATH/bin
	$(GO) install -ldflags "$(LDFLAGS)" ./cmd/$(BINARY)

.PHONY: build-all
build-all: ## Cross-compile for linux, darwin (amd64 + arm64)
	GOOS=linux   GOARCH=amd64 $(GO) build -ldflags "$(LDFLAGS)" -o bin/$(BINARY)-linux-amd64   ./cmd/$(BINARY)
	GOOS=linux   GOARCH=arm64 $(GO) build -ldflags "$(LDFLAGS)" -o bin/$(BINARY)-linux-arm64   ./cmd/$(BINARY)
	GOOS=darwin  GOARCH=amd64 $(GO) build -ldflags "$(LDFLAGS)" -o bin/$(BINARY)-darwin-amd64  ./cmd/$(BINARY)
	GOOS=darwin  GOARCH=arm64 $(GO) build -ldflags "$(LDFLAGS)" -o bin/$(BINARY)-darwin-arm64  ./cmd/$(BINARY)

# ── Test (no LLM) ──────────────────────────────────────────────────────

.PHONY: test
test: ## Run unit tests (fast, no LLM API calls; excludes cmd/odek)
	$(GO) list ./... | grep -v cmd/odek | xargs $(GO) test -short -count=1

.PHONY: test-internal
test-internal: ## Run only internal package tests (excludes cmd/odek)
	$(GO) list ./... | grep -v cmd/odek | xargs $(GO) test -short -count=1

.PHONY: test-cmd
test-cmd: ## Run cmd/odek unit tests (env-gated E2E/sandbox suites skipped)
	$(GO) test -short -count=1 -timeout 600s ./cmd/odek -skip 'TestE2E_|TestMCPE2E|TestSandbox'

.PHONY: test-cli-serve
test-cli-serve: ## Serve/WS/REST headless-run surface only (~1 min)
	$(GO) test -short -count=1 -timeout 300s -run 'TestServe|TestWS|TestRestRun|TestPrompt|TestHandlePrompt' ./cmd/odek

# Sandbox-only: /tmp is noexec and fakeowner mounts don't enforce write bits,
# so TempDir needs are split — exec-capable (cmd/odek mocks, mcpclient
# fakeserver) vs permission-enforcing (/tmp tmpfs for flock/maintenance).
.PHONY: test-sandbox
test-sandbox: ## Full suite inside the odek sandbox (Dockerfile.odek image)
	GOTMPDIR=/workspace/.gotmp TMPDIR=/workspace/.gotmp $(GO) test -short -count=1 -timeout 600s -skip 'TestE2E_|TestMCPE2E|TestSandbox' ./cmd/odek
	GOTMPDIR=/workspace/.gotmp $(GO) test -short -count=1 -p 1 -timeout 900s $$( $(GO) list ./... | grep -vE 'cmd/odek|internal/mcpclient' )
	GOTMPDIR=/workspace/.gotmp TMPDIR=/workspace/.gotmp $(GO) test -short -count=1 -timeout 300s ./internal/mcpclient

.PHONY: test-race
test-race: ## Run unit tests with race detector (excludes cmd/odek)
	$(GO) list ./... | grep -v cmd/odek | xargs $(GO) test -short -race -count=1

.PHONY: test-verbose
test-verbose: ## Run unit tests with full output (excludes cmd/odek)
	$(GO) list ./... | grep -v cmd/odek | xargs $(GO) test -short -v -count=1

# ── Coverage ───────────────────────────────────────────────────────────

.PHONY: coverage
coverage: ## Generate HTML coverage report (unit tests; excludes cmd/odek)
	$(GO) list ./... | grep -v cmd/odek | xargs $(GO) test -short -coverprofile=$(COVER) -covermode=atomic
	$(GO) tool cover -html=$(COVER) -o coverage.html
	@echo "→ coverage.html"

.PHONY: coverage-func
coverage-func: ## Print per-function coverage summary (excludes cmd/odek)
	$(GO) list ./... | grep -v cmd/odek | xargs $(GO) test -short -coverprofile=$(COVER) -covermode=atomic
	$(GO) tool cover -func=$(COVER)

.PHONY: coverage-total
coverage-total: ## Print total coverage percentage (excludes cmd/odek)
	$(GO) list ./... | grep -v cmd/odek | xargs $(GO) test -short -coverprofile=$(COVER) -covermode=atomic
	@$(GO) tool cover -func=$(COVER) | tail -1 | awk '{print "total " $$3}'

# ── Test (with LLM) ────────────────────────────────────────────────────

.PHONY: test-integration
test-integration: ## Run integration tests (requires ODEK_API_KEY or DEEPSEEK_API_KEY)
	@test -n "$$ODEK_API_KEY$$DEEPSEEK_API_KEY" || { \
		echo "ERROR: ODEK_API_KEY or DEEPSEEK_API_KEY not set"; \
		echo "  export ODEK_API_KEY=sk-..."; \
		exit 1; \
	}
	$(GO) test -tags=integration -count=1 -timeout 300s -run Integration ./...

.PHONY: test-all
test-all: test test-integration ## Run all tests (unit + integration)

# ── Lint & Format ──────────────────────────────────────────────────────

.PHONY: fmt
fmt: ## Format all Go source files
	$(GO) fmt ./...

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

.PHONY: lint
lint: ## Run golangci-lint (if installed)
ifdef GOLINT
	$(GOLINT) run ./...
else
	@echo "golangci-lint not installed — run: go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest"
	@exit 1
endif

.PHONY: check
check: fmt vet test ## Format, vet, and unit test (CI fast gate)

# ── Docker / Sandbox ───────────────────────────────────────────────────

.PHONY: docker-test
docker-test: build ## Run tests inside Docker sandbox (mimics --sandbox)
	docker run --rm -v "$(PWD):/workspace:ro" -w /workspace golang:1.24-alpine sh -c \
		'go test -short -count=1 ./...'

# ── Clean ──────────────────────────────────────────────────────────────

.PHONY: clean
clean: ## Remove build artifacts and coverage files
	rm -rf bin/ $(COVER) coverage.html

# ── Help ───────────────────────────────────────────────────────────────

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