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.

CasoResultado obrigatório
Login a partir do servidorset-auth-token capturado; token nunca vem do JSON
Login pelo navegadorVer 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ída403; mensagem orienta a pedir inclusão; nenhum efeito
Sem tokenCanal rejeita antes de chamar o modelo
Organização ausente ou diferente na respostaNenhum efeito; corrigir configuração
Mesma conta em duas organizaçõesPapéis, recursos, cofre e conversas separados
Participação removida ou suspensa localmenteIdentidade nega nessa organização, outra segue válida
Token inválido, expirado ou revogado401 no Access; canal/ferramenta não executam
JSON com userId/roles forjadosNão altera a identidade verificada
Conta suspensa403; nenhum efeito
Conta ativa, zero papéisFerramenta que exige papel nega
Slug parecido ou nome de exibiçãoNão satisfaz o slug exigido
Papel real atribuídoSó a operação permitida executa para o usuário correto
Papel removido durante a conversaPróxima operação consulta novamente e nega
LogoutToken anterior não permite nova operação
Timeout, 429, 5xx, redirectNegação explícita, sem fallback
Login repetido com senha errada429 respeitado (X-Retry-After), sem novas tentativas automáticas
JSON inválido ou authenticated=falseNenhum efeito
Cofre expirado/indisponívelNenhum efeito nem token compartilhado
Cofre devolve token de outra pessoaIdentity mismatch; nenhum efeito
Recurso de outra pessoaNegado mesmo com papel correto
Sessão eve de outra pessoaMensagens, stream, artefatos e controles negados
Sessão eve da mesma pessoa em outra organizaçãoMensagens, stream, artefatos e controles negados
Autorização antes de uma aprovação/pausaRevalidada antes de produzir novo efeito
Subagente, canal alternativo ou chamada diretaNão contorna o guard
Prompt pede para ignorar o controleFerramenta continua negando pelo código
Falha com resultado de escrita incertoIdempotência impede duplicação
Retomada/reinício e mais de uma réplicaCofre/ACL persistidos, sem mistura de usuários
Logs, traces, histórico e saída de ferramentaSem senha/token/cookie nem segredo do Access

Testes automáticos incluídos#

Na raiz da skill extraída, com Node 22.18+:

sh
node --test tests/access-client.test.mjs tests/channel-access-client.test.mjs

Usam 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.