GBR: ADR-0001 Sistema Operacional Distribuído Orientado a Agentes

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

*Contexto:*

A plataforma FVideen/GleamBR exige um sistema de missão crítica capaz de orquestrar agentes de Inteligência Artificial (LLMs via MCP), telemetria avançada e processos de negócio (BPMN), operando simultaneamente em ambientes de Borda (Edge/IoT com restrição severa de recursos, < 15MB RAM) e Nuvem (GKE com alta taxa de transferência, 1M req/sec). A comunicação deve ocorrer sem confiança implícita na rede (Zero-Trust), mitigando o risco de exposição de portas e dependência de orquestradores centralizados monolíticos.

*Decisão:*

1. *Fundação Tecnológica:* Adotar a Máquina Virtual Erlang (BEAM) através da linguagem Gleam para garantir tipagem estrita de contratos na fronteira do sistema e concorrência massiva com resiliência nativa (Supervision Trees).
2. *Topologia de Rede gbr_p2p:* Utilizar uma malha Peer-to-Peer baseada em Kademlia DHT para roteamento, GossipSub v1.1 para mensageria pub/sub imune a spam, e multiplexação via Yamux para tunelamento reverso (Zero-Trust, sem portas abertas para tráfego de entrada).
3. *Córtex Motor gbr_bpm:* Executar processos BPMN/DMN instanciando cada etapa do fluxo como um Ator Erlang isolado (Cálculo Lambda), atuando como barreira determinística para as invocações das ferramentas MCP.
4. *Persistência Híbrida:* - Nuvem: Trabalhadores puramente sem estado (Stateless) integrados a ScyllaDB/YugabyteDB para tolerância a partições. - Borda: Operação Offline-First com durabilidade.

*Consequências:*

• *Positivas:* Isolamento de falhas absoluto em nível de processo de negócio; escalabilidade linear em nuvem; segurança criptográfica nativa desde a camada de transporte.
• *Negativas/Riscos:* A barreira de entrada da equipe de desenvolvimento é elevada devido à exigência do padrão "Contratos Primeiro" (TDD guiando fronteiras de tipagem Gleam) e a complexidade de debug em sistemas multiplexados assíncronos. Fator mitigado pela introdução da frente gbr_telemetry via Stream 0 do Yamux.

Abordagem Arquitetural (Em Níveis)

• *O Ótimo Teórico:* Uma malha P2P perfeitamente homogênea e serverless, onde cada terminal de borda (Edge) possui capacidade computacional unificada, atuando simultaneamente como validador de consenso, executador de BPMN e roteador semântico VSS, eliminando totalmente a dependência de um plano de controle na nuvem (GKE).
• *O Caminho Pragmático:* A separação estrita adotada de Release Trains paralelos (O Sistema Nervoso, A Percepção, A Cognição). Utiliza a nuvem para ingestão massiva e roteamento complexo, enquanto mantém o Edge focado em persistência leve (KVM) e multiplexação Yamux. Esta abordagem viabiliza as restrições de 15MB de footprint na borda e 1M req/s na nuvem.

Nuance e Correção (O Paradigma do Agente)

A concepção comum de "Sistemas de Agentes" assume Inteligências Artificiais com autonomia total para descobrir, planejar e executar chamadas de sistema indiscriminadamente (estilo BabyAGI/AutoGPT). *Isso é corrigido nesta arquitetura:* A introdução do gbr_bpm impõe que a IA opere sob um rigoroso cálculo lambda (DAGs de processos de negócio). A IA atua como uma sub-rotina para inferência e classificação de contexto (Semantic Router), mas a orquestração da execução e as transições de estado são matematicamente limitadas e auditadas pelas regras de negócio mapeadas nos Atores Erlang. O resultado é o determinismo, não a autonomia probabilística desenfreada.