GBR: Requisitos do Loop de Raciocínio Distribuído | Wiki
Documentação de engenharia e especificações técnicas da Gleam-BR.
GBR: Requisitos do Loop de Raciocínio Distribuído
*Requisitos Ubíquos (Ubiquitous Requirements)*
- *UBQ-01:* O sistema de orquestração deve tratar retornos de ferramentas remotas como eventos assíncronos primários, sendo proibido o bloqueio da thread principal da CLI para aguardar respostas de rede ou inferências neurais.
- *UBQ-02:* Toda resposta gerada pelo Oráculo para o usuário final deve ser formatada em Markdown, suportando a renderização rica de blocos de código e tabelas providas pelos adaptadores de UI.
*Requisitos Orientados a Eventos (Event-Driven Requirements)*
-
*EVD-01:* Quando o Ator Listener interceptar um pacote de dados via Yamux contendo o campo
resultdo JSON-RPC, ele deve extrair a carga útil, remeter a mensagemToolExecutionFeedbackao Agente e encerrar o seu processo OTP imediatamente para libertar recursos da RAM. - *EVD-02:* Quando o Agente Orquestrador identificar a recepção de feedback de ferramenta, ele deve formular automaticamente um prompt de "Follow-up", injetando o contexto do sucesso ou erro na caixa de mensagens do Oráculo para síntese cognitiva.
*Requisitos Orientados a Estado (State-Driven Requirements)*
-
*STD-01:* Enquanto o sistema estiver no estado de espera por inferência de IA (após o despacho para o Oráculo), a FSM do Agente deve permanecer no estado
Idleou receptivo, garantindo que o sinal de parada (/exit) ou novos comandos de interrupção possam ser processados sem travar a VM.
*Requisitos de Comportamento Indesejado (Unwanted Behavior Requirements)*
-
*UNW-01:* Se a chamada para o motor LLM via
DirectPromptexceder o teto temporal de 120 segundos (Timeout), o processo de captura deve retornar um objeto de Erro controlado, impedindo que o processo da CLI fique pendurado indefinidamente em conexões de rede ou cálculos matriciais zumbis.