GBR: ADR-0003 Memória de Sessão de IA com Válvula de Escape Híbrida (ConsultantActor)

• *Status:* Aceito
• *Data:* 2026-05-01

*Contexto:*

Manter o histórico completo de interações (o "Contexto") de um LLM exclusivamente na RAM resulta num crescimento linear do consumo de memória. Consultas iterativas e pesadas esgotariam rapidamente os recursos do terminal local do utilizador (Out Of Memory).

*Decisão:*

1. *Divisão de Memória (Hot/Cold Context):* Implementou-se um design bifurcado no session.gleam. - Memória Quente (RAM - Córtex Ativo): O Ator mantém em memória apenas uma lista imutável das últimas $N$ interações (ex: max_hot_context = 10). - Memória Fria (Disco - Hipocampo): Cada nova mensagem injetada desencadeia imediatamente uma instrução disk_log.async_log utilizando a biblioteca interna gbr_disk_log.
2. *Buffer Circular em Disco (Modo Wrap):* O histórico de disco rígido foi configurado no modo Wrap, com limites rígidos de byte size (ex: 10MB).

*Consequências:*

• *Positivas:* O consumo de RAM da CLI (gleambrctl) permanece liso, O(1), independentemente da duração da sessão. O histórico de longo prazo está a salvo de crashes de máquina, e o HD do desenvolvedor não será inundado com gigabytes de logs residuais.
• *Negativas/Riscos:* Operações que exijam "Arquivistas Semânticos" (RAG de histórico profundo de conversas) não poderão recorrer à memória do Ator, obrigando leituras e vetorizações ativas do ficheiro de log persistido no disco.