devcloud/Makefile at main · simota/devcloud · 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
# devcloud Makefile
#
# Convenience wrapper for the commands documented in CLAUDE.md and README.md.
# Run `make help` to see all available targets.

SHELL          := /bin/bash
.DEFAULT_GOAL  := help

# ---- Tunables ----------------------------------------------------------------
GO             ?= go
NPM            ?= npm
BIN_DIR        ?= bin
BIN            ?= $(BIN_DIR)/devcloud
PKG            ?= ./cmd/devcloud
DASHBOARD_DIR  ?= web/dashboard
SERVICES       ?= mail s3 gcs dynamodb bigquery sqs pubsub redshift
VERIFY_STAGE   ?= full

# Per-service test packages (override with TEST_PKG=...).
TEST_PKG       ?= ./...

.PHONY: help

help: ## Show this help.
	@awk 'BEGIN {FS = ":.*?## "; printf "Usage: make \033[36m<target>\033[0m\n\nTargets:\n"} \
	     /^[a-zA-Z0-9_.-]+:.*?## / {printf "  \033[36m%-26s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
	@printf "\nPer-service targets (expand %% with: $(SERVICES)):\n"
	@printf "  \033[36m%-26s\033[0m %s\n" "e2e-<svc>"    "Run scripts/<svc>-e2e.sh"
	@printf "  \033[36m%-26s\033[0m %s\n" "verify-<svc>" "Run scripts/<svc>-autoloop/verify.sh (VERIFY_STAGE=$(VERIFY_STAGE))"

# ---- Go: build & run ---------------------------------------------------------
.PHONY: build run init up dashboard reset tidy fmt vet

build: ## Build the devcloud CLI binary into $(BIN).
	@mkdir -p $(BIN_DIR)
	$(GO) build -o $(BIN) $(PKG)

run: build ## Build then run `devcloud up` from the built binary.
	./$(BIN) up

init: ## Write .devcloud/config.yaml with default ports/services.
	$(GO) run $(PKG) init

up: ## Start all enabled services + dashboard (Ctrl-C to stop).
	$(GO) run $(PKG) up

dashboard: ## Start only the dashboard server.
	$(GO) run $(PKG) dashboard

reset: ## Wipe .devcloud/data for the configured workspace.
	$(GO) run $(PKG) reset

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

fmt: ## gofmt the entire tree.
	$(GO) fmt ./...

vet: ## go vet the entire tree.
	$(GO) vet ./...

# ---- Go: tests ---------------------------------------------------------------
.PHONY: test test-pkg test-run

test: ## Run all Go unit/integration tests.
	$(GO) test ./...

test-pkg: ## Run tests for a single package: make test-pkg TEST_PKG=./internal/services/s3/...
	$(GO) test $(TEST_PKG)

test-run: ## Run tests matching NAME: make test-run NAME=TestFoo TEST_PKG=./internal/...
	@if [ -z "$(NAME)" ]; then echo "usage: make test-run NAME=TestFoo [TEST_PKG=./...]" >&2; exit 2; fi
	$(GO) test $(TEST_PKG) -run $(NAME)

# ---- Dashboard (React / Vite) ------------------------------------------------
.PHONY: dashboard-install dashboard-dev dashboard-build dashboard-typecheck

dashboard-install: ## npm install in web/dashboard.
	cd $(DASHBOARD_DIR) && $(NPM) install

dashboard-dev: ## Vite dev server (proxies /api to a running devcloud up).
	cd $(DASHBOARD_DIR) && $(NPM) run dev

dashboard-build: ## Typecheck + emit static assets into internal/dashboard/assets/react.
	cd $(DASHBOARD_DIR) && $(NPM) run build

dashboard-typecheck: ## TypeScript check only.
	cd $(DASHBOARD_DIR) && $(NPM) run typecheck

# ---- E2E smoke ---------------------------------------------------------------
# `make e2e-s3` etc. — boot devcloud up, exercise the service, tear down.
.PHONY: $(addprefix e2e-,$(SERVICES)) e2e-all

$(addprefix e2e-,$(SERVICES)): e2e-%: ## Run the E2E smoke script for service %.
	bash scripts/$*-e2e.sh

e2e-all: ## Run every per-service E2E smoke script sequentially.
	@for svc in $(SERVICES); do \
		echo "==> e2e: $$svc"; \
		bash scripts/$$svc-e2e.sh || exit $$?; \
	done

# ---- Acceptance gates (per-service autoloops) --------------------------------
# `make verify-s3` runs scripts/s3-autoloop/verify.sh at VERIFY_STAGE=$(VERIFY_STAGE).
# Pub/Sub and Redshift only ship verify scripts under their primary autoloop folder.
VERIFY_SERVICES ?= mail s3 gcs dynamodb bigquery sqs pubsub
.PHONY: $(addprefix verify-,$(VERIFY_SERVICES)) verify-all

$(addprefix verify-,$(VERIFY_SERVICES)): verify-%: ## Run the autoloop verify gate for service %.
	VERIFY_STAGE=$(VERIFY_STAGE) bash scripts/$*-autoloop/verify.sh

verify-all: ## Run every per-service acceptance gate sequentially.
	@for svc in $(VERIFY_SERVICES); do \
		echo "==> verify($(VERIFY_STAGE)): $$svc"; \
		VERIFY_STAGE=$(VERIFY_STAGE) bash scripts/$$svc-autoloop/verify.sh || exit $$?; \
	done

# ---- Housekeeping ------------------------------------------------------------
.PHONY: clean clean-data clean-dashboard

clean: clean-data ## Remove build artifacts and runtime data.
	rm -rf $(BIN_DIR)

clean-data: ## Remove .devcloud/data (runtime storage).
	rm -rf .devcloud/data

clean-dashboard: ## Remove dashboard node_modules and built bundle.
	rm -rf $(DASHBOARD_DIR)/node_modules internal/dashboard/assets/react