Lumenqraph/Makefile at main · knightqueen-sketch/Lumenqraph · 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
.PHONY: help db db-down seed build test test-db test-smoke fmt lint indexer api webhooks backfill up down mcp sdk-ts sdk-py openapi-check deny audit dashboards-check ci

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

db: ## Start local Postgres
	docker compose up -d

db-down: ## Stop local Postgres
	docker compose down

seed: ## Populate demo dataset for local exploration
	@if [ -z "$$DATABASE_URL" ]; then \
	  export DATABASE_URL=postgres://lumenqraph:lumenqraph@localhost:5432/lumenqraph; \
	fi; \
	psql "$$DATABASE_URL" -v ON_ERROR_STOP=1 -f scripts/seed.sql

build: ## Build the workspace
	cargo build --workspace

test: ## Run tests (unit + integration, no Postgres required)
	cargo test --workspace

test-db: db ## Run Postgres-backed tests (requires TEST_DATABASE_URL or a running local Postgres)
	@if [ -z "$$TEST_DATABASE_URL" ]; then \
	  export TEST_DATABASE_URL=postgres://lumenqraph:lumenqraph@localhost:5432/lumenqraph_test; \
	fi; \
	psql "$$TEST_DATABASE_URL" -v ON_ERROR_STOP=1 -c 'SELECT 1' >/dev/null 2>&1 || \
	  psql "postgres://lumenqraph:lumenqraph@localhost:5432/postgres" -v ON_ERROR_STOP=1 \
	    -c 'CREATE DATABASE lumenqraph_test' >/dev/null 2>&1 || true; \
	cargo test -p lumenqraph-indexer  -- --ignored; \
	cargo test -p lumenqraph-webhooks -- --ignored; \
	cargo test -p lumenqraph-api      -- --ignored; \
	cargo test -p lumenqraph-mcp      -- --ignored

test-smoke: db ## Run the gated end-to-end smoke test (requires TEST_DATABASE_URL or a running local Postgres)
	@if [ -z "$$TEST_DATABASE_URL" ]; then \
	  export TEST_DATABASE_URL=postgres://lumenqraph:lumenqraph@localhost:5432/lumenqraph_test; \
	fi; \
	psql "$$TEST_DATABASE_URL" -v ON_ERROR_STOP=1 -c 'SELECT 1' >/dev/null 2>&1 || \
	  psql "postgres://lumenqraph:lumenqraph@localhost:5432/postgres" -v ON_ERROR_STOP=1 \
	    -c 'CREATE DATABASE lumenqraph_test' >/dev/null 2>&1 || true; \
	cargo test -p lumenqraph-indexer --features smoke-tests smoke -- --ignored

fmt: ## Format
	cargo fmt --all

lint: ## Clippy (deny warnings)
	cargo clippy --workspace --all-targets -- -D warnings

indexer: ## Run the indexer (live)
	cargo run -p lumenqraph-indexer

backfill: ## Run backfill from START_LEDGER (make backfill LEDGER=123)
	cargo run -p lumenqraph-indexer -- backfill $(LEDGER)

api: ## Run the API
	cargo run -p lumenqraph-api

webhooks: ## Run the webhooks service
	cargo run -p lumenqraph-webhooks

mcp: ## Run the MCP server
	cargo run -p lumenqraph-mcp

sdk-ts: ## Typecheck, lint, test, and verify codegen for the TypeScript SDK
	cd sdk/typescript && npm ci && npm run typecheck && npm run lint && npm test && npm run codegen:check

sdk-py: ## Install, test, and typecheck the Python SDK
	cd sdk/python && pip install -e '.[dev]' && pytest && mypy .

openapi-check: ## Verify openapi.yaml matches the API's generated schema
	cargo run -p lumenqraph-api -- --print-openapi | python3 scripts/check_openapi_drift.py openapi.yaml -

deny: ## Run cargo-deny supply-chain checks
	cargo deny check

audit: ## Run cargo-audit for known vulnerabilities
	cargo audit

dashboards-check: ## Validate dashboard metric definitions
	python3 scripts/validate_dashboards.py

ci: fmt lint test sdk-ts sdk-py openapi-check deny ## Run the same checks as CI (minus network-dependent E2E)

up: ## Full stack in Docker
	docker compose -f docker-compose.full.yml up --build -d

down: ## Stop the full stack
	docker compose -f docker-compose.full.yml down