GBR: Requisitos Operacionais para Ingestão AST e RAG Híbrido

*Requisitos Ubíquos (Ubiquitous Requirements)*

• *UBQ-01:* O motor RAG da CLI (gleambrctl) deve efetuar a varredura da base de dados exclusivamente sob fragmentos limitados arquitetonicamente por nós de árvore de sintaxe, repudiando o seccionamento literário que viole fronteiras de blocos de execução ou tipos da linguagem.
• *UBQ-02:* A interface de telemetria deve garantir que falhas no parsing de um arquivo (ex: código em desenvolvimento com erro de sintaxe) reportadas via glance não anulem a ingestão de todo o diretório, operando silenciosamente com drop unicamente sobre o ficheiro ofensor.

*Requisitos Orientados a Eventos (Event-Driven Requirements)*

• *EVD-01:* Quando a CLI desencadear a instrução /index visando um pacote Gleam local, o indexador deve abrir as raízes sintáticas dos ficheiros .gleam, percorrendo interativamente a coleção interna de instâncias Function e CustomType, enviando a string bruta do respectivo bloco sintático para a NIF de Inferência embed antes do roteamento da mensagem OTP.
• *EVD-02:* Quando o backend em Wisp necessitar injetar os fragmentos selecionados do RAG na formatação da Requisição da API Groq/Gemini, o Oracle deverá assegurar o encapsulamento formatado do trecho anexando a propriedade Nome_Da_Função e Arquivo_Base em cabeçalho explícito de contexto.

*Requisitos Orientados a Estado (State-Driven Requirements)*

• *STD-01:* Enquanto a API de LLM operar num contexto complexo e extenso (alvo de fenômeno Lost in the Middle), o roteamento do servidor deverá limitar o envio global de chunks a fragmentos da AST estritamente qualificados nos escores mais críticos retornados do Banco Vetorial DuckDB, a menos que operem num regime de Reranking.

*Requisitos de Funcionalidades Opcionais / Futuras (Optional Feature Requirements)*

• *OPT-01:* O motor de pesquisa gbr_graph poderá futuramente abandonar a confiança cega em similaridade Dense Vector, integrando a rotina C++ de pesquisa de texto por palavras inteiras nativa do DuckDB (FTS) aliada a um cálculo de convergência RRF para otimização de descoberta de nomes de variáveis e pacotes técnicos exatos da comunidade.
• *OPT-02:* Em conformidade com inovações avançadas, o pipeline da Nuvem poderá ativar um filtro HyDE silencioso perante perguntas humanas abertas, forçando uma mini-inferência assíncrona local ou via Groq API unicamente para simular o pseudo-código resposta antes da submissão aos filtros do banco DuckDB.