Makefile

# forgequant — common developer tasks. Stdlib-only; no build step.
# Override the interpreter with `make PY=python3.12 test`.
PY ?= python3

.PHONY: help test lint check list ui benchy

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

test:           ## Run the unit suite (.dat parser, corpus renderer, recipes, UI guards)
	$(PY) test_forge.py

lint:           ## Byte-compile every module to catch syntax errors (excludes benchy)
	$(PY) -m compileall -q -x 'benchy/.*' .

check: lint test  ## Lint + test (what CI runs)

list:           ## List the available recipes
	$(PY) forgequant.py list

ui:             ## Launch the web dashboard on http://localhost:8060
	$(PY) forge_ui.py

benchy:         ## Clone the benchy benchmark registry to ./benchy (if missing)
	@test -d benchy || git clone https://github.com/andreaborio/benchy.git