Limites e segurança

Limites de geração, modelo de permissões, privacidade e o que acontece quando algo falha.

Limites de geração

O Synk mantém limites para evitar respostas grandes demais, falhas de geração e poluição visual — eles são parte da estabilidade, não arbitrariedade.

Esses valores são os mesmos exibidos por /synk_limits dentro do Discord.

Modelo de permissões

• Nunca Administrator. Requisito rejeitado explicitamente pelo projeto.
• Permissões perigosas bloqueadas por lista — uma operação que exceda o escopo seguro é recusada.
• Verificação dupla: cada operação confere a permissão do usuário e a do bot para aquele tipo de ação.
• Hierarquia respeitada: o cargo do Synk deve permanecer abaixo de administradores e moderadores.
• Captura e importação pedem Gerenciar Canais de quem executa.

Privacidade

• Nenhuma leitura de conteúdo de mensagens. Insights usam apenas metadados agregados de atividade estrutural (contagens, eventos de canal/categoria).
• Ephemeral por padrão nos fluxos sensíveis: preview, confirmação, undo e diagnósticos aparecem só para você.
• Telemetria local de uso alimenta diagnóstico do próprio produto — não é um serviço de rastreamento externo.

Persistência e integridade

Os dados do Synk ficam em armazenamento local (synk_data), com:

• escrita atômica (arquivo temporário + substituição) — sem JSON corrompido por interrupção;
• schema versionado — migrações declaradas, não improvisadas;
• quarentena — arquivos ilegíveis são isolados em .broken em vez de apagados silenciosamente;
• índice por servidor (guild_index) para localizar execuções e rollbacks por guild.

Resiliência de IA

A camada de IA (atualmente Gemini via REST) é tratada como dependência que pode falhar:

• retry com backoff progressivo e limite de tentativas;
• request_id para correlacionar diagnóstico e impedir execuções duplicadas;
• circuit breaker para evitar tempestade de requisições;
• cooldown por usuário em todos os caminhos de geração e refinamento.

Regra de ouro: falha de planejamento nunca altera o servidor. Se a IA falha, nada acontece — e você recebe uma explicação clara do que houve e do que fazer.

O que o Synk não faz

• Não executa ações destrutivas automaticamente.
• Não administra o servidor por conta própria.
• Não coleta conteúdo de mensagens para métricas.
• Não aplica imports, syncs ou permissões sem preview e confirmação.