Timmy-time-dashboard/Makefile

.PHONY: install install-bigbrain dev test test-cov test-cov-html watch lint clean help \
        docker-build docker-up docker-down docker-agent docker-logs docker-shell

VENV        := .venv
PYTHON      := $(VENV)/bin/python
PIP         := $(VENV)/bin/pip
PYTEST      := $(VENV)/bin/pytest
UVICORN     := $(VENV)/bin/uvicorn
SELF_TDD    := $(VENV)/bin/self-tdd

# ── Setup ─────────────────────────────────────────────────────────────────────

install: $(VENV)/bin/activate
	$(PIP) install --quiet -e ".[dev]"
	@echo "✓ Ready. Run 'make dev' to start the dashboard."

install-bigbrain: $(VENV)/bin/activate
	$(PIP) install --quiet -e ".[dev,bigbrain]"
	@if [ "$$(uname -m)" = "arm64" ] && [ "$$(uname -s)" = "Darwin" ]; then \
	    $(PIP) install --quiet "airllm[mlx]"; \
	    echo "✓ AirLLM + MLX installed (Apple Silicon detected)"; \
	else \
	    echo "✓ AirLLM installed (PyTorch backend)"; \
	fi

$(VENV)/bin/activate:
	python3 -m venv $(VENV)

# ── Development ───────────────────────────────────────────────────────────────

dev:
	$(UVICORN) dashboard.app:app --reload --host 0.0.0.0 --port 8000

# Print the local IP addresses your phone can use to reach this machine.
# Connect your phone to the same hotspot your Mac is sharing from,
# then open  http://<IP>:8000  in your phone browser.
# The server auto-reloads on Python/template changes (--reload above).
# For CSS/static changes, just pull-to-refresh on your phone.
ip:
	@echo ""
	@echo "  Open one of these on your phone:  http://<IP>:8000"
	@echo ""
	@ipconfig getifaddr en0  2>/dev/null | awk '{print "  en0 (Wi-Fi):    http://" $$1 ":8000"}' || true
	@ipconfig getifaddr en1  2>/dev/null | awk '{print "  en1 (Ethernet): http://" $$1 ":8000"}' || true
	@ipconfig getifaddr en2  2>/dev/null | awk '{print "  en2:            http://" $$1 ":8000"}' || true
	@ifconfig 2>/dev/null | awk '/inet / && !/127\.0\.0\.1/ && !/::1/{print "  " $$2 "  →  http://" $$2 ":8000"}' | head -5 || true
	@echo ""

watch:
	$(SELF_TDD) watch --interval 60

# ── Testing ───────────────────────────────────────────────────────────────────

test:
	$(PYTEST) tests/ -q --tb=short

test-cov:
	$(PYTEST) tests/ --cov=src --cov-report=term-missing --cov-report=xml -q

test-cov-html:
	$(PYTEST) tests/ --cov=src --cov-report=term-missing --cov-report=html -q
	@echo "✓ HTML coverage report: open htmlcov/index.html"

# ── Code quality ──────────────────────────────────────────────────────────────

lint:
	@$(PYTHON) -m ruff check src/ tests/ 2>/dev/null || \
	 $(PYTHON) -m flake8 src/ tests/ 2>/dev/null || \
	 echo "No linter installed — run: pip install ruff"

# ── Housekeeping ──────────────────────────────────────────────────────────────

# ── Docker ────────────────────────────────────────────────────────────────────

docker-build:
	docker build -t timmy-time:latest .

docker-up:
	mkdir -p data
	docker compose up -d dashboard

docker-down:
	docker compose down

# Spawn one agent worker connected to the running dashboard.
# Override name/capabilities: make docker-agent AGENT_NAME=Echo AGENT_CAPABILITIES=summarise
docker-agent:
	AGENT_NAME=$${AGENT_NAME:-Worker} \
	AGENT_CAPABILITIES=$${AGENT_CAPABILITIES:-general} \
	docker compose --profile agents up -d --scale agent=1 agent

docker-logs:
	docker compose logs -f

docker-shell:
	docker compose exec dashboard bash

# ── Housekeeping ──────────────────────────────────────────────────────────────

clean:
	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
	find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
	find . -name "*.pyc" -delete 2>/dev/null || true
	rm -rf .pytest_cache htmlcov .coverage coverage.xml

help:
	@echo ""
	@echo "  make install          create venv + install dev deps"
	@echo "  make install-bigbrain install with AirLLM (big-model backend)"
	@echo "  make dev              start dashboard at http://localhost:8000"
	@echo "  make ip               print local IP addresses for phone testing"
	@echo "  make test             run all tests"
	@echo "  make test-cov         tests + coverage report (terminal + XML)"
	@echo "  make test-cov-html    tests + HTML coverage report"
	@echo "  make watch            self-TDD watchdog (60s poll)"
	@echo "  make lint             run ruff or flake8"
	@echo "  make clean            remove build artefacts and caches"
	@echo ""
	@echo "  make docker-build     build the timmy-time:latest image"
	@echo "  make docker-up        start dashboard container"
	@echo "  make docker-agent     add one agent worker (AGENT_NAME=Echo)"
	@echo "  make docker-down      stop all containers"
	@echo "  make docker-logs      tail container logs"
	@echo "  make docker-shell     open a bash shell in the dashboard container"
	@echo ""