Observal/Makefile at main · BALLOON005/Observal · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
# SPDX-FileCopyrightText: 2026 Hari Srinivasan <harisrini21@gmail.com>
# SPDX-FileCopyrightText: 2026 Hemalatha Madeswaran <hemalathamadeswaran@gmail.com>
# SPDX-FileCopyrightText: 2026 Shaan Narendran <shaannaren06@gmail.com>
# SPDX-FileCopyrightText: 2026 Swathi Saravanan <ss4522@cornell.edu>
# SPDX-FileCopyrightText: 2026 Vishnu Muthiah <vishnu.muthiah04@gmail.com>
# SPDX-License-Identifier: AGPL-3.0-only

.PHONY: lint format check test test-adversarial test-eval-completeness test-all hooks clean migrate check-migrations new-migration reset rebuild rebuild-enterprise rebuild-local release-major release-feature release-patch sync-skill

# ── Linting ──────────────────────────────────────────────

lint:  ## Run all linters
	uv run --with ruff==0.15.10 ruff check .

format:  ## Auto-format all code
	uv run --with ruff==0.15.10 ruff format .
	uv run --with ruff==0.15.10 ruff check --fix .

check:  ## Full pre-commit check on all files
	SKIP=no-commit-to-branch uvx --from pre-commit pre-commit run --all-files

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

test:  ## Run Python tests
	cd observal-server && uv run --with pytest --with pytest-asyncio --with pyyaml --with typer --with rich --with hypothesis --with pyarrow pytest ../tests/ -q

test-v:  ## Run Python tests (verbose)
	cd observal-server && uv run --with pytest --with pytest-asyncio --with pyyaml --with typer --with rich --with hypothesis --with pyarrow pytest ../tests/ -v

test-adversarial:  ## Run BenchJack self-test suite
	cd observal-server && uv run --with pytest --with pytest-asyncio --with pyyaml --with typer --with rich pytest ../tests/test_adversarial_self.py -v --tb=short

test-eval-completeness:  ## Run eval completeness tests
	cd observal-server && uv run --with pytest --with pytest-asyncio --with pyyaml --with typer --with rich pytest ../tests/test_eval_completeness.py -v --tb=short

test-all: test test-eval-completeness test-adversarial  ## Run all tests including adversarial and completeness

sync-skill:  ## Regenerate the auto-generated command reference in the bundled Observal skill
	cd observal-server && uv run --with typer --with rich --with loguru --with pyyaml python ../scripts/sync_observal_skill.py

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

hooks:  ## Install pre-commit hooks
	uvx --from pre-commit pre-commit install
	uvx --from pre-commit pre-commit install --hook-type commit-msg
	uvx --from pre-commit pre-commit install --hook-type pre-push
	@echo "✓ Hooks installed"

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

# Auto-detect enterprise edition: if ee/observal_insights/ exists, include enterprise compose file.
# Enterprise features activate when OBSERVAL_LICENSE_KEY is set in .env.
COMPOSE_FILES := -f docker-compose.yml
ifneq (,$(wildcard ee/observal_insights/__init__.py))
  COMPOSE_FILES += -f docker-compose.enterprise.yml
  $(info [enterprise mode] ee/observal_insights/ detected)
endif

up:  ## Start Docker stack
	cd docker && docker compose $(COMPOSE_FILES) up -d

down:  ## Stop Docker stack
	cd docker && docker compose $(COMPOSE_FILES) down

migrate:  ## Run database migrations
	cd docker && docker compose $(COMPOSE_FILES) exec observal-api /app/.venv/bin/python -m alembic upgrade head

check-migrations:  ## Validate alembic migration chain (no duplicates, no forks)
	python3 scripts/check_migrations.py

new-migration:  ## Create a new migration: make new-migration MSG="add foo to bar"
	@test -n "$(MSG)" || (echo 'Usage: make new-migration MSG="description"' && exit 1)
	./scripts/new_migration.sh "$(MSG)"

rebuild:  ## Rebuild and restart Docker stack (runs migrations automatically)
	cd docker && docker compose $(COMPOSE_FILES) up --build -d
	@echo "Waiting for API to be healthy..."
	@cd docker && until docker compose $(COMPOSE_FILES) exec observal-api python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')" >/dev/null 2>&1; do sleep 1; done
	cd docker && docker compose $(COMPOSE_FILES) restart observal-lb
	@echo "API is healthy."

rebuild-enterprise:  ## Rebuild in enterprise mode (insights enabled)
	cd docker && docker compose -f docker-compose.yml -f docker-compose.enterprise.yml up --build -d
	@echo "Waiting for API to be healthy..."
	@cd docker && until docker compose -f docker-compose.yml -f docker-compose.enterprise.yml exec observal-api python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')" >/dev/null 2>&1; do sleep 1; done
	cd docker && docker compose -f docker-compose.yml -f docker-compose.enterprise.yml restart observal-lb
	@echo "✓ Running in enterprise mode (license key active)"

rebuild-local:  ## Rebuild in local mode (no enterprise features)
	cd docker && docker compose -f docker-compose.yml up --build -d
	@echo "Waiting for API to be healthy..."
	@cd docker && until docker compose -f docker-compose.yml exec observal-api python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')" >/dev/null 2>&1; do sleep 1; done
	cd docker && docker compose -f docker-compose.yml restart observal-lb
	@echo "✓ Running in local mode (DEPLOYMENT_MODE=local)"

reset:  ## Nuke all Docker volumes and rebuild from scratch (fresh app, no file changes)
	cd docker && docker compose $(COMPOSE_FILES) down -v
	cd docker && docker compose $(COMPOSE_FILES) up --build -d
	@echo "Waiting for API to be healthy..."
	@cd docker && until docker compose $(COMPOSE_FILES) exec observal-api python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')" >/dev/null 2>&1; do sleep 1; done
	cd docker && docker compose $(COMPOSE_FILES) restart observal-lb
	@echo "API is healthy — all data has been reset."

rebuild-clean:  ## Rebuild from scratch (no Docker cache), remove volumes, and restart
	cd docker && docker compose $(COMPOSE_FILES) down -v && docker compose $(COMPOSE_FILES) build --no-cache && docker compose $(COMPOSE_FILES) up -d
	@echo "Waiting for API to be healthy..."
	@cd docker && until docker compose $(COMPOSE_FILES) exec observal-api python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')" >/dev/null 2>&1; do sleep 1; done
	cd docker && docker compose $(COMPOSE_FILES) restart observal-lb
	@echo "API is healthy."

logs:  ## Tail Docker logs
	cd docker && docker compose logs -f --tail=50

# ── Cleanup ──────────────────────────────────────────────

clean:  ## Remove build artifacts and caches
	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
	find . -type d -name .ruff_cache -exec rm -rf {} + 2>/dev/null || true
	find . -type d -name .pytest_cache -exec rm -rf {} + 2>/dev/null || true
	find . -type d -name '*.egg-info' -exec rm -rf {} + 2>/dev/null || true
	rm -rf dist/ build/ htmlcov/ .coverage

# ── Release ─────────────────────────────────────────────────

release-major:  ## Cut a major release (X.0.0, requires approval)
	tools/release.sh major

release-feature:  ## Cut a feature release (x.Y.0, requires approval)
	tools/release.sh feature

release-patch:  ## Cut a patch release (x.y.Z, auto-publishes)
	tools/release.sh patch

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

.DEFAULT_GOAL := help