Referências · references/acceptance.md
Matriz de aceite#
Para canais externos, execute também node --test tests/channel-access-client.test.mjs
e os casos de webhook/vínculo em channels.md. Os testes simulados
do cliente não validam a assinatura de um provedor nem a conexão real de um bot.
Execute no projeto do agente, com conta de aula e slugs reais. Nos casos negados, use um spy/contador/registro do efeito e confirme zero execuções. Não imprima senha, token, cookie, headers de autenticação ou referência de cofre.
| Caso | Resultado obrigatório |
|---|---|
| Login a partir do servidor | set-auth-token capturado; token nunca vem do JSON |
| Login pelo navegador | Ver o aceite em browser-login.md; deviceCode, código e token nunca chegam ao navegador do app, ao modelo ou a logs |
| Conta recém-criada, ainda não incluída | 403; mensagem orienta a pedir inclusão; nenhum efeito |
| Sem token | Canal rejeita antes de chamar o modelo |
| Organização ausente ou diferente na resposta | Nenhum efeito; corrigir configuração |
| Mesma conta em duas organizações | Papéis, recursos, cofre e conversas separados |
| Participação removida ou suspensa localmente | Identidade nega nessa organização, outra segue válida |
| Token inválido, expirado ou revogado | 401 no Access; canal/ferramenta não executam |
| JSON com userId/roles forjados | Não altera a identidade verificada |
| Conta suspensa | 403; nenhum efeito |
| Conta ativa, zero papéis | Ferramenta que exige papel nega |
| Slug parecido ou nome de exibição | Não satisfaz o slug exigido |
| Papel real atribuído | Só a operação permitida executa para o usuário correto |
| Papel removido durante a conversa | Próxima operação consulta novamente e nega |
| Logout | Token anterior não permite nova operação |
| Timeout, 429, 5xx, redirect | Negação explícita, sem fallback |
| Login repetido com senha errada | 429 respeitado (X-Retry-After), sem novas tentativas automáticas |
| JSON inválido ou authenticated=false | Nenhum efeito |
| Cofre expirado/indisponível | Nenhum efeito nem token compartilhado |
| Cofre devolve token de outra pessoa | Identity mismatch; nenhum efeito |
| Recurso de outra pessoa | Negado mesmo com papel correto |
| Sessão eve de outra pessoa | Mensagens, stream, artefatos e controles negados |
| Sessão eve da mesma pessoa em outra organização | Mensagens, stream, artefatos e controles negados |
| Autorização antes de uma aprovação/pausa | Revalidada antes de produzir novo efeito |
| Subagente, canal alternativo ou chamada direta | Não contorna o guard |
| Prompt pede para ignorar o controle | Ferramenta continua negando pelo código |
| Falha com resultado de escrita incerto | Idempotência impede duplicação |
| Retomada/reinício e mais de uma réplica | Cofre/ACL persistidos, sem mistura de usuários |
| Logs, traces, histórico e saída de ferramenta | Sem senha/token/cookie nem segredo do Access |
Testes automáticos incluídos#
Na raiz da skill extraída, com Node 22.18+:
node --test tests/access-client.test.mjs tests/channel-access-client.test.mjsUsam apenas o runner nativo e fetch simulado; não precisam de conta, segredo, servidor Access, eve instalado ou alteração no banco. Validam o helper, não a integração completa.
Registre separadamente os testes de mock e os testes reais do canal/ferramenta, com versão do eve e resultado, sem credenciais. Não chame teste simulado de integração ponta a ponta.