Makefile

SHELL := /usr/bin/env bash
.DEFAULT_GOAL := help

.PHONY: help install setup db-up db-down db-migrate db-downgrade full-build full-up full-down backup-create backup-restore dev-api dev-worker worker-job-once dev-web aiic aiic-start aiic-stop aiic-restart aiic-status aiic-logs aiic-run openapi lint format format-check test secrets-check scan ci hooks-install hooks-run iur-smoke iur-happy-path iur-directed-flow iur-directed-3layer clean

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

install: ## Install prerequisites/dependencies and configure aiic launcher alias
	./scripts/install.sh

setup: ## Install toolchains and project dependencies
	./scripts/setup.sh

db-up: ## Start local Postgres service via docker compose
	./scripts/db-up.sh

db-down: ## Stop local Postgres service via docker compose
	./scripts/db-down.sh

db-migrate: ## Apply Alembic migrations to the configured database
	./scripts/db-migrate.sh

db-downgrade: ## Roll back one Alembic migration revision
	./scripts/db-downgrade.sh

full-build: ## Build full containerized stack images (api/worker/web)
	docker compose -f docker-compose.full.yml build

full-up: ## Start full containerized stack (postgres/api/worker/web)
	docker compose -f docker-compose.full.yml up -d

full-down: ## Stop full containerized stack
	docker compose -f docker-compose.full.yml down

backup-create: ## Create timestamped DB + artifact backup bundle
	./scripts/backup-create.sh

backup-restore: ## Restore DB + artifacts from a backup bundle (BACKUP=/abs/path.tar.gz)
	@test -n "$(BACKUP)" || (echo "Usage: make backup-restore BACKUP=/abs/path/to/aiic-backup.tar.gz" && exit 1)
	./scripts/backup-restore.sh "$(BACKUP)"

dev-api: ## Run FastAPI development server
	pnpm run dev:api

dev-worker: ## Run worker in polling mode to process queued jobs
	pnpm run dev:worker

worker-job-once: ## Process a single queued job immediately
	pnpm run worker:run-job-once

dev-web: ## Run web development server
	pnpm run dev:web

aiic: ## Start AIIC in background and open web app (default launcher)
	./scripts/aiic-watchdog.sh start

aiic-start: ## Start AIIC in background without opening browser
	./scripts/aiic-watchdog.sh start --no-open

aiic-stop: ## Stop AIIC manager + services and aiic-owned database
	./scripts/aiic-watchdog.sh stop

aiic-restart: ## Restart AIIC manager + services
	./scripts/aiic-watchdog.sh restart

aiic-status: ## Show AIIC manager/service/database status
	./scripts/aiic-watchdog.sh status

aiic-logs: ## Show recent AIIC manager logs
	./scripts/aiic-watchdog.sh logs manager

aiic-run: ## Run AIIC in foreground (Ctrl+C to stop)
	./scripts/aiic-watchdog.sh run

openapi: ## Export FastAPI OpenAPI schema to apps/api/openapi.json
	./scripts/export-openapi.sh

lint: ## Run JS + Python linting
	./scripts/lint.sh

format: ## Auto-format JS + Python code
	./scripts/format.sh write

format-check: ## Verify formatting without changing files
	./scripts/format.sh check

test: ## Run all tests
	./scripts/test.sh

secrets-check: ## Validate runtime secret baseline policy
	./scripts/secrets-check.sh

scan: ## Run dependency + static security scans
	./scripts/scan.sh

ci: ## Run the full local CI gate
	./scripts/ci.sh

hooks-install: ## Install git pre-commit and pre-push hooks
	./scripts/hooks-install.sh

hooks-run: ## Run all pre-commit hooks against all files
	./scripts/hooks-run.sh

iur-smoke: ## Execute the Initial Usable Release API smoke workflow
	./scripts/iur-smoke.sh

iur-happy-path: ## Execute IUR smoke + process jobs + validate composite artifact
	./scripts/iur-happy-path.sh

iur-directed-flow: ## Execute directed person/table/cake 3-layer smoke + refine validation
	./scripts/iur-directed-3layer.sh

iur-directed-3layer: iur-directed-flow

clean: ## Remove common local caches/artifacts
	rm -rf .venv .pytest_cache .ruff_cache .pre-commit-cache .coverage coverage dist node_modules