Makefile

# Makefile — единый dev-процесс: FastAPI (uvicorn) + Tailwind watcher + линтеры/форматтеры
# ✔️ Без "source venv/bin/activate": вызываем бинарники из venv напрямую
# ✔️ Подхватываем .env для подпроцессов
# ✔️ Аккуратный shutdown: trap + kill по PID
# ✔️ Безопасный lint-fix: Prettier не трогает Jinja/Alpine
# ✔️ Guard: валим сборку, если Alpine-атрибуты экранированы сущностями
# ✔️ Совместимо с bash 3.2 (macOS): один явный shell-блок в dev, без wait -n и без awk strftime

SHELL := /bin/bash
.SHELLFLAGS := -eu -o pipefail -c

# ── Пути и бинарники ──────────────────────────────────────────────────────────
# Предпочитаем pyenv-интерпретатор 3.13.7 (если установлен), иначе fallback на системный python3.
PYENV_PY    := $(HOME)/.pyenv/versions/3.13.7/bin/python
ifeq ($(wildcard $(PYENV_PY)),)
  PYTHON    ?= python3
else
  PYTHON    := $(PYENV_PY)
endif
VENV_DIR     ?= venv
PIP          := $(VENV_DIR)/bin/pip
PY           := $(VENV_DIR)/bin/python
UVICORN      := $(VENV_DIR)/bin/uvicorn
RUFF         := $(VENV_DIR)/bin/ruff
DJLINT       := $(VENV_DIR)/bin/djlint
ALEMBIC      := $(VENV_DIR)/bin/alembic  # ✅ Alembic CLI

# JS-инструменты через pnpm (локальные, из node_modules/.bin)
PRETTIER     := pnpm exec prettier
ESLINT       := pnpm exec eslint

APP          ?= app.main:app
HOST         ?= 0.0.0.0
PORT         ?= 8000

TEMPLATES_DIR:= app/templates

# Экспортируем .env в окружение подпроцессов
export_env = if [ -f .env ]; then set -a; . ./.env; set +a; fi

# ── Подготовка окружения ───────────────────────────────────────────────────────
venv:
	@test -d "$(VENV_DIR)" || $(PYTHON) -m venv "$(VENV_DIR)"
	@echo "✅ venv ready → $(VENV_DIR)"
	@$(PY) -m pip install -U pip setuptools wheel

# Полное пересоздание окружения на правильном интерпретаторе
.PHONY: venv-recreate
venv-recreate:
	@echo "🧹 Recreate venv on $(PYTHON)"
	@rm -rf "$(VENV_DIR)"
	@$(PYTHON) -m venv "$(VENV_DIR)"
	@$(PY) -m pip install -U pip setuptools wheel

install-py: venv
	@$(PY) -m pip install -r requirements.txt
	@echo "✅ Python runtime deps installed"

# Доп. дев-зависимости (ruff/djlint/mypy и т.п.) — ставим отдельно
install-py-dev: install-py
	@test -f requirements-dev.txt && $(PY) -m pip install -r requirements-dev.txt || true
	@echo "✅ Python dev deps installed"

install-js:
	@pnpm install
	@echo "✅ JS deps installed"

install: install-py-dev install-js
	@echo "✅ All deps installed (Python + JS)"

# ── Раздельные цели (по желанию) ──────────────────────────────────────────────
dev-api: venv
	@echo "🚀 Starting API"
	@$(export_env); \
	PORT_VAL=$${PORT:-$(PORT)}; HOST_VAL=$${HOST:-"$(HOST)"}; \
	echo "→ http://$$HOST_VAL:$$PORT_VAL"; \
	$(UVICORN) $(APP) --reload --host $$HOST_VAL --port $$PORT_VAL

dev-css:
	@echo "🎨 Starting CSS watcher (pnpm dev:css)"
	@$(export_env); \
	pnpm dev:css 2>&1 | while IFS= read -r line; do echo "[css] $$line"; done

# ── JS: разовая сборка и вотчер ──────────────────────────────────────────────
.PHONY: build-js dev-js clean-js

build-js:
	@echo "🧱 Building JS bundle (esbuild)..."
	@$(export_env); pnpm run build:js
	@echo "✅ JS built → static/js/bundle.js"

dev-js:
	@echo "🧩 Starting JS watcher (pnpm dev:js)"
	@$(export_env); \
	pnpm dev:js 2>&1 | while IFS= read -r line; do echo "[js] $$line"; done

clean-js:
	@rm -f static/js/bundle.js || true
	@echo "🧹 Removed static/js/bundle.js (if existed)"

# ── Единый dev: параллельный запуск + аккуратный shutdown ─────────────────────
dev: install build-css build-js
	@echo "▶️  Dev mode: API + CSS + JS watchers"; \
	$(export_env); \
	{ \
	  PORT_VAL=$${PORT:-$(PORT)}; HOST_VAL=$${HOST:-"$(HOST)"}; \
	  echo "   - API : http://$$HOST_VAL:$$PORT_VAL"; \
	  echo "   - CSS : pnpm dev:css"; \
	  echo "   - JS  : pnpm dev:js"; \
	  \
	  free_port() { \
	    local p="$$1"; \
	    lsof -ti tcp:"$$p" | xargs -r kill -TERM 2>/dev/null || true; \
	    sleep 0.2; \
	    lsof -ti tcp:"$$p" | xargs -r kill -KILL 2>/dev/null || true; \
	  }; \
	  cleanup() { \
	    echo; echo "⏹  Stopping..."; \
	    [ -n "$$CSS_PID" ] && kill "$$CSS_PID" 2>/dev/null || true; \
	    [ -n "$$JS_PID" ] && kill "$$JS_PID" 2>/dev/null || true; \
	    [ -n "$$API_PID" ] && kill "$$API_PID" 2>/dev/null || true; \
	    wait "$$CSS_PID" "$$JS_PID" "$$API_PID" 2>/dev/null || true; \
	    echo "✅ Stopped."; \
	  }; \
	  trap 'cleanup' EXIT INT TERM; \
	  \
	  free_port "$$PORT_VAL"; \
	  \
	  $(UVICORN) $(APP) --reload --host "$$HOST_VAL" --port "$$PORT_VAL" & API_PID=$$!; \
	  pnpm dev:css 2>&1 | while IFS= read -r line; do echo "[css] $$line"; done & CSS_PID=$$!; \
	  pnpm dev:js  2>&1 | while IFS= read -r line; do echo "[js]  $$line"; done  & JS_PID=$$!; \
	  \
	  wait "$$API_PID" "$$CSS_PID" "$$JS_PID"; \
	}

# ── Совместимость со старой привычкой ─────────────────────────────────────────
run: dev-api

# ── Сборка CSS ────────────────────────────────────────────────────────────────
build-css:
	@$(export_env); pnpm build:css
	@echo "✅ CSS built → static/styles/build.css"

# ── Очистка кешей ─────────────────────────────────────────────────────────────
clean:
	@find . -name "__pycache__" -type d -prune -exec rm -rf {} +
	@find . -name "*.pyc" -delete
	@echo "🧹 Cleaned caches"

# ── Сторожок: проверка, что Alpine-атрибуты не экранированы сущностями ────────
guard-templates:
	@! grep -RInE 'x-(data|on):|x-on:' $(TEMPLATES_DIR) | grep -E '"|&|>|<' && \
	 echo "✅ templates guard: no HTML entities in Alpine attributes" || \
	 (echo "❌ Found HTML entities inside Alpine attributes. Fix before commit."; exit 1)

# ── Линтинг кода (Python, JS, Jinja) ──────────────────────────────────────────
lint:
	@echo "🔎 Lint: py/js/jinja"
	@$(RUFF) check .
	@$(ESLINT) . --ext .js,.mjs --max-warnings=0 || true
	@$(DJLINT) $(TEMPLATES_DIR) --quiet
	@$(MAKE) guard-templates

# ── Форматирование кода (Python, JS, Jinja) ───────────────────────────────────
fmt:
	@echo "🧹 Format: py/js/jinja"
	@$(RUFF) format .
	@$(RUFF) check . --fix || true
	@$(PRETTIER) "**/*.{js,mjs,json,md,css}" --write
	@$(DJLINT) $(TEMPLATES_DIR) --reformat --quiet || true
	@$(MAKE) guard-templates

# ── Авто-исправление всего за раз (безопасно для Jinja/Alpine) ───────────────
lint-fix:
	@echo "🛠  Auto-fix (ruff + eslint + prettier + djlint)"
	@$(RUFF) format .
	@$(RUFF) check . --fix --unsafe-fixes || true
	@$(ESLINT) . --ext .js,.mjs --fix || true
	@$(PRETTIER) "**/*.{js,mjs,json,md,css}" --write
	@$(DJLINT) $(TEMPLATES_DIR) --reformat --quiet || true
	@$(MAKE) guard-templates

# ── Alembic (миграции БД) ────────────────────────────────────────────────────
# Пояснения:
# - m="message" — сообщение ревизии
# - t="target"  — цель миграции (напр., head или -1)
# - По умолчанию: upgrade → head; downgrade → -1

# Ревизия без autogenerate (ручная правка)
# usage: make alembic-rev-empty m="reports: init"
alembic-rev-empty:
	@$(export_env); $(ALEMBIC) revision -m "$(m)"

# Ревизия с autogenerate (SQLite может потребовать ручные правки FK/индексов)
# usage: make alembic-rev-auto m="reports: add report & link tables"
alembic-rev-auto:
	@$(export_env); $(ALEMBIC) revision --autogenerate -m "$(m)"

# Оставляем совместимость с твоей старой целью (rev без автогенерации)
# usage: make alembic-rev m="message"
alembic-rev:
	@$(export_env); $(ALEMBIC) revision -m "$(m)"

# Применить миграции: по умолчанию — до head
# usage: make alembic-up            → upgrade head
#        make alembic-up t=base     → откат к base
#        make alembic-up t=+1       → на одну вперёд
alembic-up:
	@$(export_env); if [ -n "$$t" ]; then $(ALEMBIC) upgrade "$$t"; else $(ALEMBIC) upgrade head; fi

# Откатить миграции: по умолчанию — на 1 назад
# usage: make alembic-down          → downgrade -1
#        make alembic-down t=-2     → на две назад
alembic-down:
	@$(export_env); if [ -n "$$t" ]; then $(ALEMBIC) downgrade "$$t"; else $(ALEMBIC) downgrade -1; fi

# Текущая ревизия
alembic-cur:
	@$(export_env); $(ALEMBIC) current

# История миграций (краткая/подробная)
alembic-history:
	@$(export_env); $(ALEMBIC) history

alembic-hist:
	@$(export_env); $(ALEMBIC) history --verbose

# Заголовки веток (если используются множественные heads/branches)
alembic-heads:
	@$(export_env); $(ALEMBIC) heads

# ── Остановка dev-сервера ─────────────────────────────────────────────────────
stop:
	@echo "⏹  Stopping dev processes..."
	@PORT_VAL=$${PORT:-$(PORT)}; \
	lsof -ti tcp:"$$PORT_VAL" | xargs -r kill -TERM 2>/dev/null || true; \
	sleep 0.2; \
	lsof -ti tcp:"$$PORT_VAL" | xargs -r kill -KILL 2>/dev/null || true; \
	pkill -f "pnpm dev:css" 2>/dev/null || true; \
	echo "✅ Stopped."

# ── Рестарт dev-сервера ──────────────────────────────────────────────────────
restart: stop dev

.PHONY: venv venv-recreate install install-py install-py-dev install-js dev dev-api dev-css dev-js run build-css build-js clean clean-js \
        guard-templates lint fmt lint-fix \
        alembic-rev-empty alembic-rev-auto alembic-rev alembic-up alembic-down \
        alembic-history alembic-hist alembic-cur alembic-heads stop restart

# ─────────────────────────────────────────────────────────────────────────────
# 🔍 Project health check (custom lint)
# ─────────────────────────────────────────────────────────────────────────────
.PHONY: health
health:
	@echo "▶ Running project health check..."
	@$(PY) tools/health_check.py

# ============================================================================
# I18N (Babel + Jinja2)
# ----------------------------------------------------------------------------
# Цели:
#   make i18n-extract   # собрать .pot по доменам
#   make i18n-init      # разово создать .po для локалей (если их ещё нет)
#   make i18n-update    # обновить .po из .pot (msgid добавятся/удалятся)
#   make i18n-compile   # скомпилировать .po → .mo
#   make i18n-all       # полный цикл: extract → update → compile
#   make i18n-status    # сравнить POT vs PO (missing/obsolete)
#   make i18n-clean     # удалить только .mo
# ----------------------------------------------------------------------------

# --- БАЗОВЫЕ ПУТИ ------------------------------------------------------
PYBABEL         ?= $(VENV_DIR)/bin/pybabel              # ✅ из venv
BABEL_CFG       ?= babel.cfg
LOCALES_DIR     ?= app/locales
POTS_DIR        ?= .i18n/pot
APP_TEMPLATES   ?= app/templates

# Если нет бинаря в venv — берём системный
ifeq ($(shell test -x "$(PYBABEL)" && echo ok),)
  PYBABEL := $(shell command -v pybabel)
endif

# --- ДОМЕНЫ И ЛОКАЛИ --------------------------------------------------
I18N_DOMAINS    ?= ui validation enums emails
I18N_LOCALES    ?= ru en es_AR

# Источники по доменам
UI_SOURCES          ?= $(APP_TEMPLATES)
VALIDATION_SOURCES  ?= app/i18n/validation_catalog.py
ENUMS_SOURCES       ?= app/i18n/enums_catalog.py
EMAILS_SOURCES      ?= $(APP_TEMPLATES)/emails app/i18n/emails_catalog.py

# 🔹 Добавляем Python-источники, из которых нужно собирать строки домена ui
#    (в коде вы часто используете pgettext/_ прямо в flows/routers)
APP_UI_PY_DIRS  ?= app/flows app/routers

# Явный список файлов: HTML для ui.pot и PY для ui.pot
UI_HTML_FILES := $(shell find "$(APP_TEMPLATES)" -type f -name '*.html' 2>/dev/null)
UI_PY_FILES   := $(shell find $(APP_UI_PY_DIRS) -type f -name '*.py' 2>/dev/null)

# Переключатель подробного шелл-лога (I18N_VERBOSE=1 ...)
I18N_VERBOSE ?= 0
SHVERBOSE :=
BABEL_V   :=
ifeq ($(I18N_VERBOSE),1)
  SHVERBOSE := set -x;
  # В Babel используется длинный ключ --verbose, короткого -v нет
  BABEL_V   := --verbose
endif

# --- ХЕЛПЕРЫ ----------------------------------------------------------
define _ensure_dir
	@if [[ ! -d "$(1)" ]]; then \
	  echo "📁 mkdir -p $(1)"; \
	  mkdir -p "$(1)"; \
	fi
endef

.PHONY: i18n-ensure-email-template-dir
i18n-ensure-email-template-dir:
	@$(call _ensure_dir,$(APP_TEMPLATES)/emails)
	@if [[ ! -f "$(APP_TEMPLATES)/emails/.placeholder.html" ]]; then \
	  echo "🧩 create $(APP_TEMPLATES)/emails/.placeholder.html"; \
	  printf '<!-- placeholder for emails templates -->\n' > "$(APP_TEMPLATES)/emails/.placeholder.html"; \
	fi

.PHONY: i18n-vars
i18n-vars:
	@echo "PYBABEL      = $(PYBABEL)"
	@echo "PY           = $(PY)"
	@echo "BABEL_CFG    = $(BABEL_CFG)"
	@echo "LOCALES_DIR  = $(LOCALES_DIR)"
	@echo "POTS_DIR     = $(POTS_DIR)"
	@echo "APP_TEMPLATES= $(APP_TEMPLATES)"
	@echo "I18N_DOMAINS = $(I18N_DOMAINS)"
	@echo "I18N_LOCALES = $(I18N_LOCALES)"
	@echo "UI_SOURCES          = $(UI_SOURCES)"
	@echo "VALIDATION_SOURCES  = $(VALIDATION_SOURCES)"
	@echo "ENUMS_SOURCES       = $(ENUMS_SOURCES)"
	@echo "EMAILS_SOURCES      = $(EMAILS_SOURCES)"
	@echo "UI_HTML_FILES(count)= $(words $(UI_HTML_FILES))"
	@echo "UI_PY_FILES(count)  = $(words $(UI_PY_FILES))"
	@echo
	@echo "pybabel version:"
	@"$(PYBABEL)" --version || true

# --- EXTRACT -----------------------------------------------------------
.PHONY: i18n-extract
i18n-extract: i18n-ensure-email-template-dir
	@$(call _ensure_dir,$(POTS_DIR))
	@echo "📦 Extract POTs → $(POTS_DIR)"
	@echo "  • ui.pot"
	@if [[ -n "$(UI_HTML_FILES)$(UI_PY_FILES)" ]]; then \
	  echo "    html: $(words $(UI_HTML_FILES))  py: $(words $(UI_PY_FILES))"; \
	  "$(PYBABEL)" extract $(BABEL_V) -F "$(BABEL_CFG)" -o "$(POTS_DIR)/ui.pot" $(UI_HTML_FILES) $(UI_PY_FILES); \
	else \
	  echo "    ⚠ no files found; passing default UI_SOURCES to pybabel"; \
	  "$(PYBABEL)" extract $(BABEL_V) -F "$(BABEL_CFG)" -o "$(POTS_DIR)/ui.pot" "$(UI_SOURCES)"; \
	fi
	@echo "  • validation.pot"
	@"$(PYBABEL)" extract $(BABEL_V) -F "$(BABEL_CFG)" -o "$(POTS_DIR)/validation.pot" $(VALIDATION_SOURCES)
	@echo "  • enums.pot"
	@"$(PYBABEL)" extract $(BABEL_V) -F "$(BABEL_CFG)" -o "$(POTS_DIR)/enums.pot" $(ENUMS_SOURCES)
	@echo "  • emails.pot"
	@"$(PYBABEL)" extract $(BABEL_V) -F "$(BABEL_CFG)" -o "$(POTS_DIR)/emails.pot" $(EMAILS_SOURCES)

# --- INIT --------------------------------------------------------------
.PHONY: i18n-init
i18n-init: i18n-extract
	@set -e; \
	for dom in $(I18N_DOMAINS); do \
	  pot="$(POTS_DIR)/$$dom.pot"; \
	  if [[ ! -f "$$pot" ]]; then echo "❌ no POT: $$pot"; exit 1; fi; \
	  for lang in $(I18N_LOCALES); do \
	    po="$(LOCALES_DIR)/$$lang/LC_MESSAGES/$$dom.po"; \
	    if [[ -f "$$po" ]]; then \
	      echo "↷ skip (exists) $$po"; \
	    else \
	      echo "🆕 Init $$lang/$$dom"; \
	      mkdir -p "$(LOCALES_DIR)/$$lang/LC_MESSAGES"; \
	      "$(PYBABEL)" init $(BABEL_V) -d "$(LOCALES_DIR)" -D "$$dom" -i "$$pot" -l "$$lang"; \
	    fi; \
	  done; \
	done

# --- UPDATE ------------------------------------------------------------
.PHONY: i18n-update
i18n-update: i18n-extract
	@set -e; \
	for dom in $(I18N_DOMAINS); do \
	  pot="$(POTS_DIR)/$$dom.pot"; \
	  echo "🔄 Update catalogs for domain=$$dom"; \
	  for lang in $(I18N_LOCALES); do \
	    po="$(LOCALES_DIR)/$$lang/LC_MESSAGES/$$dom.po"; \
	    if [[ -f "$$po" ]]; then \
	      echo "  → updating: $$po"; \
	      "$(PYBABEL)" update $(BABEL_V) -d "$(LOCALES_DIR)" -D "$$dom" -i "$$pot" -l "$$lang"; \
	    else \
	      echo "  ✗ skip (no file): $$po"; \
	    fi; \
	  done; \
	done

# --- COMPILE -----------------------------------------------------------
.PHONY: i18n-compile
i18n-compile:
	@echo "🛠  Compile .mo"
	@echo "   Domains: $(I18N_DOMAINS)"
	@set -e; \
	for dom in $(I18N_DOMAINS); do \
	  for lang in $(I18N_LOCALES); do \
	    po="$(LOCALES_DIR)/$$lang/LC_MESSAGES/$$dom.po"; \
	    if [[ -f "$$po" ]]; then \
	      echo "→ compiling: $$po"; \
	      "$(PYBABEL)" compile $(BABEL_V) -d "$(LOCALES_DIR)" -D "$$dom" -l "$$lang" --statistics --use-fuzzy; \
	    else \
	      echo "✗ skip (no file): $$po"; \
	    fi; \
	  done; \
	done

# --- STATUS / CLEAN ----------------------------------------------------
.PHONY: i18n-ls i18n-clean
i18n-ls:
	@echo "📚 .po catalogs:"; \
	find "$(LOCALES_DIR)" -maxdepth 3 -name "*.po" -print

i18n-clean:
	@echo "🧹 Clean compiled .mo"
	@find "$(LOCALES_DIR)" -name "*.mo" -delete || true

# --- УТИЛИТЫ -----------------------------------------------------------
.PHONY: i18n-autofill i18n-status i18n-translate-scan i18n-check

# Префлайт: какой python и есть ли google-genai (важно для Gemini)
i18n-check: venv
	@$(PY) - <<'PY'
	import sys
	print("PYTHON =", sys.executable)
	try:
			import google.genai as genai  # type: ignore[attr-defined]
			print("google-genai: OK")
	except Exception as e:
			print("google-genai: FAIL ->", e)
	PY

# --- I18N: autofill -----------------------------------------------------------
# По умолчанию работаем с русской локалью.
# ⚠️ На текущем этапе автозаполняем ТОЛЬКО ui.po для ru и es_AR.
# Примеры:
#   make i18n-autofill                 # ru, app/locales/ru/LC_MESSAGES/ui.po
#   make i18n-autofill LOCALE=es_AR    # es_AR, app/locales/es_AR/LC_MESSAGES/ui.po

LOCALE ?= ru

ifeq ($(LOCALE),ru)
  PO := app/locales/ru/LC_MESSAGES/ui.po
else ifeq ($(LOCALE),es_AR)
  PO := app/locales/es_AR/LC_MESSAGES/ui.po
else
  $(error Unsupported LOCALE '$(LOCALE)'; allowed: ru, es_AR)
endif

i18n-autofill: venv
	@$(PY) -m tools.i18n.autofill --po "$(PO)" --locale "$(LOCALE)" --write --progress auto

# Сравнение POT vs PO по (msgctxt,msgid)
i18n-status: venv
	@$(PY) -m tools.i18n.status --domains "$(I18N_DOMAINS)" --locales "$(I18N_LOCALES)" --pots-dir "$(POTS_DIR)" --locales-dir "$(LOCALES_DIR)"

# Обёртка RU → EN literal в шаблон без ключей и без записи в PO
# Примеры:
#   make i18n-translate-scan paths='app/templates/main.html' phrase=1 backup=1
#   make i18n-translate-scan paths='app/templates/**/*.html' words=1 only=3,4 stdout=1
i18n-translate-scan: venv
	@$(PY) -m tools.i18n.scan wrap $(paths) \
		$(if $(phrase),--phrase,) \
		$(if $(words),--words,) \
		$(if $(only),--only $(only),) \
		$(if $(backup),--backup,) \
		$(if $(stdout),--stdout,)

# ============================================================================
# I18N Cache (SQLite) — maintenance utilities
# ----------------------------------------------------------------------------
# Назначение:
#   Утилиты для диагностики и очистки кэша переводов (таблица translations),
#   который использует i18n ядро. Полезно после сбоев провайдера, когда
#   в кэш могли попасть «эхо»-переводы (src==dst на кириллице).
#
# Требования:
#   - venv должен существовать (цель `venv` подготовит окружение).
#   - Файл кэша берётся из I18N_CACHE_DB (см. tools/i18n/_translate_core.py).
#
# Быстрый старт:
#   make i18n-cache-show     # просмотреть подозрительные записи
#   make i18n-cache-purge    # удалить «эхо»-переводы и выполнить VACUUM
#   make i18n-cache-vacuum   # только VACUUM (сжатие БД)
#
# Настройка провайдера/локали (по умолчанию — Gemini + EN):
I18N_CACHE_PROVIDER ?= gemini
I18N_CACHE_LOCALE   ?= en

.PHONY: i18n-cache-show i18n-cache-purge i18n-cache-vacuum

## i18n-cache-show: вывести до 200 «подозрительных» строк (src==dst с не-ASCII)
i18n-cache-show: venv
	@$(PY) -m tools.i18n.cache_cli --provider $(I18N_CACHE_PROVIDER) --locale $(I18N_CACHE_LOCALE) show

## i18n-cache-purge: удалить «эхо»-переводы и затем VACUUM (в новом соединении)
i18n-cache-purge: venv
	@$(PY) -m tools.i18n.cache_cli --provider $(I18N_CACHE_PROVIDER) --locale $(I18N_CACHE_LOCALE) purge-equals-nonascii

## i18n-cache-vacuum: выполнить VACUUM без удаления записей
i18n-cache-vacuum: venv
	@$(PY) -m tools.i18n.cache_cli vacuum

i18n-cache-clear-en:
	@sqlite3 app/.i18n/cache.db "DELETE FROM translations WHERE provider='gemini' AND locale='en'; VACUUM;" && \
	echo "🧹 Cleared cache for provider=gemini, locale=en"


backfill-reports-v2:
	@$(PY) -m tools.backfill_reports_v2

gc-documents:
	@$(PY) -m app.scripts.gc_documents

guard-on:
	@unset LEGACY_REPORT_FILE_LINKS_ENABLED; unset ALLOW_LEGACY_LINKS_QUERY; echo "Legacy links guard: ON"

guard-off:
	@export ALLOW_LEGACY_LINKS_QUERY=1; echo "Legacy links guard: OFF (ALLOW_LEGACY_LINKS_QUERY=1)"

audit-reports:
	@$(PY) -m app.scripts.audit_reports || true