.env.example

# Refarm — variáveis de ambiente para ferramentas de agente
#
# Este arquivo documenta as variáveis esperadas no ambiente de desenvolvimento.
# NUNCA commite o arquivo .env com valores reais.
#
# Como configurar:
#   cp .env.example .env
#   # edite .env com seus valores
#
# No VS Code Dev Container, você pode adicionar via:
#   Ctrl+Shift+P → "Dev Containers: Add Dev Container Configuration Variables"
# Ou exportar manualmente no terminal antes de usar cada ferramenta.

# ── Anthropic ─────────────────────────────────────────────────────────────────
# Usada por: Claude Code (claude) e Pi coding agent (pi)
# Obter em: https://console.anthropic.com/settings/keys
ANTHROPIC_API_KEY=

# ── GitHub ────────────────────────────────────────────────────────────────────
# Usada por: GitHub CLI (gh)
# Alternativa: rodar `gh auth login` no terminal (fluxo OAuth interativo)
# Obter em: https://github.com/settings/tokens
GH_TOKEN=

# ── Testing / resolução de dependências ──────────────────────────────────────
# Controlam como getAliases() em @refarm.dev/vtconfig resolve imports nos testes.
# Não são necessárias em uso normal — só para investigação e compat testing.
#
# Exemplos de uso:
#   VITEST_USE_DIST=true pnpm -C packages/barn run test
#     → testa contra os artefatos compilados (dist/) em vez de src/
#
#   VITEST_FORCE_DIST=@refarm.dev/barn pnpm run test
#     → só esse pacote resolve via dist/, o resto continua em src/
#
# Veja também: pnpm run compat:forward / compat:backward para testar contra
# versões publicadas na registry (cenário diferente — local vs publicado).
VITEST_USE_DIST=
VITEST_FORCE_DIST=

# ── Notas de runtime ─────────────────────────────────────────────────────────
# Nenhuma dessas variáveis é necessária para o devcontainer iniciar.
# Configure uma por vez conforme precisar de cada ferramenta:
#
#   pi      → requer ANTHROPIC_API_KEY  (ou: pi /login)
#   claude  → requer ANTHROPIC_API_KEY  (ou: claude /login)
#   gh      → requer GH_TOKEN           (ou: gh auth login)