Pular para conteúdo

Como contribuir

Antes de abrir uma solicitação de pull, execute as verificações locais e leia a página sobre a arquitetura da ponte.

npm install
npm run check

Relatórios de testes

Os relatórios locais gerados com test:report:generate continuam sendo arquivos HTML independentes. Os relatórios combinados de CI usam arquivos separados de HTML, JavaScript e dados para evitar o limite de tamanho de arquivo do GitHub. Baixe e extraia todo o artefato combined-test-report e abra seu diretório:

npm run test:report:open -- --report /path/to/extracted-report

Para um relatório com vários arquivos, este comando inicia o visualizador Allure instalado. Mantenha-o em execução enquanto consulta o relatório; pressione Ctrl+C para encerrá-lo. A publicação no GitHub Pages preserva os recursos do relatório no repositório separado de relatórios.

Lista de verificação para pull requests

  • npm run check foi aprovado.
  • O novo comportamento da ponte possui testes.
  • Os esquemas, descrições e respostas do MCP do Playwright upstream permanecem inalterados.
  • As alterações visíveis ao usuário estão documentadas.
  • CHANGELOG.md foi atualizado para refletir as alterações visíveis ao usuário.
  • As alterações relacionadas à segurança estão indicadas na descrição do PR.

O que não se deve fazer

  • Não reintroduza o adaptador nativo do navegador, o registro de ferramentas ou o modelo de capacidade que foram removidos.
  • Não grave logs de tempo de execução em stdout; o stdio está reservado para o MCP JSON-RPC.
  • Não adicione uma dependência, a menos que ela seja importada pelo tempo de execução ou pelos testes.
  • Não enfraqueça as configurações do TypeScript, ESLint ou Prettier para que uma alteração seja aprovada.
  • Não faça commit de dist/, coverage/, artifacts/, site/, .venv-docs/, ou node_modules/.

Questões de segurança

Relate vulnerabilidades por meio dos Alertas de Segurança do GitHub, e não por meio de issues públicos. Consulte SECURITY.md.