v0.2.0 — 4-sprint catalog expansion

Major expansion of the public-data catalog across 4 sprints, each adversarially reviewed by an external LLM (gpt-5.4 xhigh via tmux). 14 real bugs caught and fixed before release.

What's new

• Sprint 1 — CVM IPE (fatos relevantes / comunicados), CVM FCA (B3-ticker → CNPJ resolver), B3 COTAHIST (oficial diário desde 1986), B3 índices (IBOV, IBrX, SMLL, IDIV, IFIX + 14 sectoriais)
• Sprint 2 — CVM FII (Fundos Imobiliários), CVM FIDC (Direitos Creditórios), CVM FIP (Participações)
• Sprint 3 — Tesouro SICONFI (RREO/RGF, 5,598 entidades), Receita Federal arrecadação por UF (45 tributos × meses desde 2000)
• Sprint 4 — ANEEL leilões (geração + transmissão desde 1999), SUSEP empresas (233 entidades supervisionadas)

Stack

• 10 fontes públicas (era 6): BCB, CVM, B3, IBGE, IPEA, Tesouro, ANBIMA, Receita, ANEEL, SUSEP
• 117 testes unitários (era 57)
• 73 rotas REST (era 35) com MCP auto-mount em /mcp
• CLI com 10 subcomandos
• ICP-Brasil chain trust via integração truststore
• ruff + ruff-format + mypy --strict clean

Adversarial reviews

Sprint	Bugs caught	Examples
1	4	FATCOT 1000x off · indices pagination · NBSP not stripped · COTAHIST RAM bomb
2	3	FII pre-2021 schema · FIP quarter=5 silent expansion
3	4	SICONFI co_anexo→no_anexo · uf="BR" wrong · BR-thousand decimals
4	3	ANEEL/SUSEP CP1252 encoding · search whitespace strip

Quickstart

pip install findata-br
findata serve  # REST + MCP at :8000
findata cvm ipe 33.000.167/0001-01 -y 2024 --categoria "Fato Relevante"
findata b3 cotahist PETR4 -y 2024 -m 3
findata aneel leiloes --fonte Eólica -y 2024

Full changelog

See CHANGELOG.md.