Relatório final e prévia

Uma execução que completa, o que significa que ficou sem trabalho por conta própria, entrega duas coisas: um relatório final e uma prévia ao vivo do seu app. Execuções que foram pausadas, paradas, interrompidas ou estouraram o orçamento não entregam.

Quando há um app para mostrar, um aviso diz isso. Ele diz O app está concluído, seu relatório e prévia estão prontos quando a prévia está rodando, e O app está concluído, seu relatório está pronto, e sua prévia inicia na aba Relatório quando não está. Quando o relatório não considera o app concluído, ele diz Uma execução foi concluída, seu relatório final está pronto. Relatório e prévia ficam na aba Relatório do Manager, lado a lado.

O relatório final

O relatório é construído a partir do próprio registro da execução, sem nenhuma chamada de modelo. Ele nunca reexecuta seus testes; ele lê o que o loop fez.

• O que foi construído: os arquivos que a execução criou ou alterou, os cartões que concluiu e o último
• Como executar: o comando do seu README que inicia o app (npm run dev, npm start resumo de cada bubble em suas próprias palavras. e assim por diante), com a etapa de instalação primeiro quando faltam dependências.
• O que foi testado: o último comando de teste que o loop executou, seu código de saída e quando.
• O que falta: qualquer coisa que impeça a execução de contar como concluída, como ausência de README, sem script de teste, testes nunca executados, testes falhando, cartões ainda abertos ou uma prévia que travou. Sem nada faltando, ele diz Nada que o registro da execução possa ver.

O relatório chama o app de concluído quando:

1. o README fornece um comando para executá-lo,
2. a última execução de teste passou,
3. nenhum bubble terminou em FAIL ou ERROR, e
4. a prévia não travou.

Abaixo do veredito, o relatório também diz se o app está Apresentável, a partir da última revisão visual da execução: Apresentável, a revisão visual passou, …falhou com N bloqueantes, ou não julgado quando nenhuma revisão foi executada. Isso é reportado, não contado: um loop sem interface não tem revisão visual, e uma revisão falhada já encerra a passada do Revisor em FAIL.

Com uma prévia rodando, o relatório também tira capturas de tela do app. Os relatórios são salvos no projeto, na pasta do app, como JSON para a aba e Markdown para o seu editor. Os últimos 20 são mantidos.

A prévia ao vivo

A prévia é o servidor de desenvolvimento do seu app, um por quadro. Ela é mantida separada das execuções: o término de uma execução não a para, e uma nova execução também não a para, então um app Vite continua acompanhando as edições do loop.

• Inicie, reinicie e pare a prévia na aba Relatório, e leia o log dela lá.
• No fim de uma execução, ela inicia sozinha apenas quando o quadro está em Full Auto e o comando é permitido. Caso contrário, pressione Iniciar prévia.
• Um quadro que isola comandos em sandbox não pode rodar uma prévia.
• Se o servidor morrer, a aba mostra seu código de saída e as últimas linhas em vez de ficar em branco silenciosamente.

A revisão visual

Em um loop que constrói uma interface de usuário, o Revisor executa uma revisão visual. Ele abre o app em um navegador real a 1280 × 800 e a 390 × 844 e verifica cada página.

• Falham imediatamente: um erro HTTP, uma sobreposição de erro do servidor de desenvolvimento, uma página em branco, uma página mais larga do que a janela, uma imagem quebrada, texto de espaço reservado como lorem ipsum ou TODO:, e hosts de imagens substitutas.
• Se você definiu um modelo de visão (página Modelos, Modelos auxiliares), ele também olha para as capturas de tela e as julga em relação ao arquivo DESIGN.md do loop. Problemas de layout, espaços reservados e imagens quebradas que ele marca como bloqueantes falham na revisão; anotações de design e acabamento são conselhos.
• Sem um modelo de visão, as verificações da página decidem sozinhas, e o resultado diz claramente que ninguém olhou para as capturas de tela.

Configurações › Navegador do agente oferece Baixar Chromium, com o tamanho dele primeiro. Assim que estiver lá, execuções com a janela desativada o usarão; caso contrário, os agentes usarão um Chrome ou Edge instalado.