scaffold: kind+Tilt cluster, api/ui/docs stubs, green at nvi.local.ar

Makefile

@@ -0,0 +1,50 @@
+.PHONY: kind tilt-up tilt-down seed evals \
+        compose-up compose-down compose-clean compose-seed compose-evals \
+        docs-graphs
+
+COMPOSE := docker compose -f ctrl/docker-compose.yml
+KCTX    := --context kind-nvi
+KNS     := -n nvi
+
+# ── kind + Tilt (primary path) ─────────────────────────────
+
+kind:
+	bash ctrl/kind-config.sh
+
+tilt-up:
+	cd ctrl && tilt up $(KCTX)
+
+tilt-down:
+	cd ctrl && tilt down $(KCTX)
+
+seed:
+	kubectl $(KCTX) $(KNS) exec deploy/api -- uv run python -m seed.load_bird
+
+evals:
+	kubectl $(KCTX) $(KNS) exec deploy/api -- uv run python -m evals.run_evals
+
+# ── docker-compose (alternative path) ──────────────────────
+
+compose-up:
+	$(COMPOSE) up -d --build
+
+compose-down:
+	$(COMPOSE) down
+
+compose-clean:
+	$(COMPOSE) down -v
+
+compose-seed:
+	$(COMPOSE) exec api uv run python -m seed.load_bird
+
+compose-evals:
+	$(COMPOSE) exec api uv run python -m evals.run_evals
+
+# ── docs ───────────────────────────────────────────────────
+
+docs-graphs:
+	@for f in docs/graphs/*.dot; do \
+		out=$${f%.dot}.svg; \
+		echo "  graphviz $$f → $$out"; \
+		dot -Tsvg $$f -o $$out; \
+	done