Comandos CLI

O invoice-cli expõe subcomandos por domínio. Instalado com uv sync e disponível no .venv.

Comandos principais

# Listar subcomandos
uv run invoice-cli --help

# Otimização (cost analyzer)
uv run invoice-cli optimization analyze --period-days 30

# Eval (golden dataset)
uv run invoice-cli eval run --dataset golden --limit 50

# Shadow mode
uv run invoice-cli shadow status
uv run invoice-cli shadow compare --operadora vivo --limit 100

# Aprendizado (Fase 10)
uv run invoice-cli learning summary --period-days 7

# Maintenance Agent (Fase 9)
uv run invoice-cli maintenance run --task-id <clickup_id>

# Migrações Alembic
uv run alembic upgrade head
uv run alembic revision --autogenerate -m 'descrição'

# Servidor
uv run uvicorn invoice_ia.api.app:app --reload --port 8080

Eval local de parsers (bypass S3)

Para medir cobertura de um parser usando PDFs locais sem depender do HLG/S3:

cd /home/diego/Code/invoice_project/invoice-agent
.venv/bin/python \
  /home/diego/Code/invoice_project/projeto_hlg_100/scripts/local_eval.py vivo

Lint, type-check, testes

uv run ruff check src/ tests/
uv run ruff format src/ tests/
uv run mypy src/
uv run pytest -q --no-cov