[FINAL-04] Alinhar documentação, README e status real do compilador

[Bappoz]

Objetivo

Ajustar a documentação para refletir o estado real do projeto no momento da entrega.

O que revisar

• status do README
• descrição do pipeline atual
• funcionalidades realmente suportadas
• limitações conhecidas
• comandos de uso e exemplos

Por que isso importa

Na apresentação, a documentação precisa bater com o comportamento real. Isso evita promessas que o compilador ainda não cumpre e deixa a entrega mais honesta.

Critério de aceite

• README descreve o que realmente funciona hoje
• Limitações conhecidas estão explícitas
• Exemplos de uso estão corretos
• A documentação técnica não contradiz o código