makefile, pre-commit config, .env.example

tired of typing the uvicorn invocation. also ignore venv/ properly so it stops showing up in git status.

.env.example

@@ -0,0 +1,11 @@
+# LLM agent (inference.py) — required
+API_BASE_URL=https://api.openai.com/v1
+MODEL_NAME=gpt-4o-mini
+HF_TOKEN=sk-replace-me
+
+# Environment URL the agent talks to (optional, defaults to localhost:7860)
+ENV_URL=http://localhost:7860
+
+# Logging (used by observability.py)
+LOG_LEVEL=INFO
+LOG_FORMAT=plain   # plain | json

.gitignore

@@ -1,2 +1,5 @@
 .venv
+venv
 __pycache__/
+.pytest_cache/
+.ruff_cache/

.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files

Makefile

@@ -0,0 +1,45 @@
+PY ?= python
+VENV ?= venv
+BIN := $(VENV)/bin
+
+.PHONY: help venv install test lint format run docker clean
+
+help:
+	@echo "Targets:"
+	@echo "  venv     - create local virtualenv at ./$(VENV)"
+	@echo "  install  - install runtime + dev dependencies"
+	@echo "  test     - run pytest suite"
+	@echo "  lint     - run ruff (lint only, no fixes)"
+	@echo "  format   - run ruff format"
+	@echo "  run      - start the FastAPI environment on :7860"
+	@echo "  docker   - build the docker image"
+	@echo "  inspect  - dump current env state as JSON"
+	@echo "  clean    - remove caches"
+
+venv:
+	$(PY) -m venv $(VENV)
+
+install:
+	$(BIN)/pip install -r requirements.txt
+	$(BIN)/pip install pytest ruff
+
+test:
+	$(BIN)/python -m pytest tests/ -q
+
+lint:
+	$(BIN)/ruff check .
+
+format:
+	$(BIN)/ruff format .
+
+run:
+	$(BIN)/uvicorn environment:app --host 0.0.0.0 --port 7860 --reload
+
+docker:
+	docker build -t adaptive-traffic-controller .
+
+inspect:
+	$(BIN)/python inspect_env.py
+
+clean:
+	rm -rf .pytest_cache __pycache__ */__pycache__ .ruff_cache