.PHONY: help start stop restart status logs dev-health install test lint typecheck

help:
	@echo "Research-Link-AI — developer commands"
	@echo "  make start       Start backend (serves the web UI) using .env"
	@echo "  make stop        Stop backend/frontend and clean PID files"
	@echo "  make restart     Stop then start"
	@echo "  make status      Show process/URL/LLM status"
	@echo "  make logs        Print recent backend/frontend logs"
	@echo "  make dev-health  Check environment readiness"
	@echo "  make index       Rebuild papers/README.md workspace index"
	@echo "  make install     pip install -e .[dev]"
	@echo "  make test        Run pytest"
	@echo "  make lint        Run ruff"
	@echo "  make typecheck   Run mypy (typed surface)"

start:
	@bash scripts/start.sh

stop:
	@bash scripts/stop.sh

restart: stop start

status:
	@bash scripts/status.sh

logs:
	@echo "== backend (last 120) =="; tail -n 120 .runtime/backend.log 2>/dev/null || echo "  no backend log yet"
	@echo "== frontend (last 120) =="; tail -n 120 .runtime/frontend.log 2>/dev/null || echo "  no frontend log (served by backend)"

dev-health:
	@bash scripts/dev-health.sh

index:
	@researchlink index papers 2>/dev/null || echo "No papers/ workspace yet — ingest a paper first."

install:
	pip install -e ".[dev]"

test:
	python -m pytest -q

lint:
	python -m ruff check .

typecheck:
	python -m mypy src/researchlink/services src/researchlink/schemas