Makefile

# freerouter Makefile.

.PHONY: build run up down test conformance oss-clean check oracle-capture parity live-verify

# build compiles the pure-Go gateway binary into bin/freerouter. CGO_ENABLED=0 is
# load-bearing: the SQLite backend is modernc.org/sqlite (no CGO, no system libs).
build:
	CGO_ENABLED=0 go build -o bin/freerouter ./cmd/freerouter

# run builds then launches the gateway. With no configuration it comes up as a real,
# durable personal metered gateway on :8080 (health at /healthz). Ctrl-C to stop.
run: build
	./bin/freerouter

# up / down drive the docker compose personal-gateway (see docker-compose.yml).
up:
	docker compose up --build

down:
	docker compose down

# test runs the full freerouter suite.
test:
	go test ./...

# conformance runs the executable forge<->freerouter contract GATE: the C-*
# assertions (docs/design/contract.md §8) exercised against the LINKED, in-process
# meter (github.com/3dl-dev/forge/meterlib) via internal/metertest — nothing mocked
# at the meter boundary. This is the gate forge's meterlib must keep passing.
conformance:
	go test -v ./internal/conformance/...

# oss-clean runs the OSS-CLEAN merge gate: scans the tracked source and FAILS if a
# commit would leak a secret or bake operator-specific identity into the open-source
# core. Dependency-light (bash + git + grep). See docs/dev/oss-clean.md.
oss-clean:
	bash scripts/oss-clean.sh

# oracle-capture (re-)captures OpenRouter's PUBLIC surface (models list + OpenAPI schema)
# into the committed golden fixtures under test/oracle/openrouter/. OpenRouter is the
# parity ORACLE; the parity harness (internal/parity) compares freerouter against these
# captured fixtures, never against hand-written expected values. Needs outbound HTTPS to
# openrouter.ai; on a blocked network it prints a clear message and leaves the committed
# fallback fixtures intact. See docs/dev/parity-harness.md.
oracle-capture:
	go run ./cmd/oraclecapture

# parity runs the oracle-derived parity-verification harness: it loads the captured oracle
# fixtures and asserts freerouter's real /models + chat/completions shapes conform.
parity:
	go test -v ./internal/parity/...

# live-verify proves REAL third-party provider connectivity (not mock upstreams). Runs the
# livevendor-tagged adapter + parity tests against whatever provider keys are in the env; each
# self-skips when its key is unset. See docs/dev/live-verification.md for the key names.
live-verify:
	bash scripts/live-verify.sh

# check is the local pre-merge flow: the OSS-CLEAN gate first (cheap, fails fast on
# a leak), then the full suite and the contract conformance gate.
check: oss-clean test conformance