GBR: ADR-0014 Soberania de Geração de Código e Fixação da Versão AST (Glance 3.0) | Wiki
Documentação de engenharia e especificações técnicas da Gleam-BR.
GBR: ADR-0014 Soberania de Geração de Código e Fixação da Versão AST (Glance 3.0)
*Status:* Aceito *Data:* 2026-05-01
*Contexto:*
O ecossistema Gleam evolui rápido, mas a biblioteca de parsing glance (essencial para o nosso AST Chunking e Codegen) quebrou a compatibilidade com o glance-printer nas versões 6.x. O glance-printer é a nossa ferramenta para transformar ASTs modificadas pela IA de volta em arquivos .gleam válidos. Sem ele, a IA pode "ler" o código, mas não consegue "escrevê-lo" com formatação canônica.
*Decisão:*
-
*Downgrade Estratégico:* Fixar a dependência global em
glance v3.0.0. - *Priorização da Geração de Código:* Manter a capacidade de "Round-trip" (Código -> AST -> Modificação -> Código) é mais valioso para o projeto do que as novas funcionalidades puramente de análise das versões recentes do Glance.
*Consequências:*
- *Positivas:* Garante que a IA possa realizar refatorações automáticas e gerar ERPs inteiros que compilem de primeira e respeitem o estilo da linguagem.
- *Negativas/Riscos:* Ficamos temporariamente fora do fluxo de atualizações oficiais do compilador Gleam, podendo enfrentar problemas ao parsear sintaxes novas da linguagem lançadas após a versão 3.0 do Glance.
Avaliar o uso
Hoje utilizamo o gleance, para realizar o parse do código fonte Gleam gerando uma AST. A versão que usamos é a glance 3.0, a atual é 6.x, por causa do glance-printer, que foi abandonado.
Alternativas
- Trick: https://gearsco.de/trick/