feat: quick wins Pareto — proteções financeiras ligadas, fixes no /v1/risk e plano de desenvolvimento

[danzeroum]

Resumo

Análise Pareto 80/20 do repositório: as 10 melhorias de maior razão valor/esforço (~8h, ≈13,5% do esforço mapeado) foram implementadas e capturam ≈72% do valor identificado. Inclui veredito de funcionalidade (executado, não presumido), diagrama de Pareto interativo e plano de desenvolvimento para o restante.

Veredito da análise: a ferramenta é funcional de ponta a ponta em paper trading — o achado central é que havia código de proteção financeira escrito mas desligado ou quebrado, corrigido aqui.

Proteção financeira (bugs reais)

• CapitalProtections ligado ao pipeline — os limites de perda semanal (−6%, halva posições) e mensal (−15%, suspende trading + alerta) eram código morto: .check() não era chamado em lugar nenhum de src/. Agora rodam antes de cada ciclo no SquadOrchestrator, alimentados pelo P&L realizado do ledger.
• Reset diário do circuit breaker — reset_daily() nunca era chamado: o contador "diário" acumulava para sempre (limite virava cumulativo-desde-o-início). Agora zera na virada do dia UTC.
• Fix /v1/risk — o path do risk_params.yaml usava parents[4] e resolvia fora do repo: GET devolvia defaults silenciosos e PATCH retornava 500. Corrigido para parents[3].
• Fix perda diária no /v1/risk/circuit-breaker — lia data.timestamp (campo inexistente no evento position_closed) e reportava sempre 0%; agora lê o timestamp real do ledger.

Robustez e coerência

• Timeout nas chamadas LLM (LLM_TIMEOUT_SECONDS, default 30s) — provider pendurado não trava mais o ciclo de trading; a camada advisory devolve None e segue determinística.
• Saldo paper respeita INITIAL_CAPITAL (antes: 10 000 USDT hardcoded, incoerente com o sizing).
• Versão única em src/version.py (0.6.0) — API e /health reportavam "1.0.0" falso.
• Removidos: dependência morta slowapi e .env.template órfão (esquema conflitante com .env.example).
• Senhas changeme comentadas no .env.example — um cp apressado não sobe mais Postgres/Grafana com credenciais previsíveis.

Docs

• docs/pareto-analysis-dev-plan.md — análise de funcionalidade + plano de desenvolvimento P0–P3 (unificar thresholds com o yaml, persistir o dia do breaker, hardening para ordens reais, convergir orquestradores, qualidade).
• docs/pareto-value-diagram.html — diagrama de Pareto interativo (valor por item + acumulado com corte de 80%).
• README: contagem de testes corrigida (383 → 418); snapshot OpenAPI regenerado (mudança de versão).

Testes

• 15 testes de regressão novos cobrindo cada correção.
• Suíte completa: 418 passed, 8 skipped, cobertura 72,9% (gate ≥72%), ruff limpo.
• Smoke test manual: um ciclo do OrchestratorLoop em dry-run e probes da API (/health, /health/ready, /v1/metrics, POST /v1/orders) executados com sucesso.

🤖 Generated with Claude Code

https://claude.ai/code/session_01AL1NrUBCPydLG8SBwKsHsB

---

Generated by Claude Code