[net0well]

Resumo

Ver as Etapas de uma trilha na tela de Etapas e recarregar uma tela cujo código não baixou. Segue a revisão aprovada das specs 008 (AC-26, AC-27) e 007 (AC-26), decisões D-163 a D-165.

API (spec 007)

• GET /stages?pipelineKey=X traz só as Etapas da última versão publicada da trilha X, na ordem dos passos.
  • Uma Etapa usada em dois passos aparece uma vez.
  • Combina com search e status.
  • Trilha inexistente ou só com rascunho devolve página vazia.
• Na biblioteca é CatalogQuery.UsedByPipeline, um parâmetro opcional no fim do record, só para Etapas. O ListPipelinesAsync o rejeita com ArgumentException.
• Snapshot do OpenAPI atualizado (só o parâmetro novo) e tipos do painel regenerados.

Painel (spec 008)

• Filtro "Trilha" na lista de Etapas, ao lado de Buscar e Status.
  • Fica na URL (?trilha=X), então o link pode ser compartilhado e o filtro sobrevive a recarregar.
  • Trilha sem versão publicada mostra "Esta trilha ainda não tem versão publicada".
• O detalhe da trilha ganha o link Ver Etapas desta trilha.
• Recarga de tela que não carregou: quando o código de uma tela falha ao baixar (rede oscilou, versão nova do painel):
  • a página recarrega uma vez na rota pedida;
  • se falhar de novo em até 10 s, aparece "Não foi possível carregar esta tela" com Recarregar, sem laço;
  • sem sessionStorage, mostra o aviso direto em vez de arriscar um laço.
  • A tela de aviso é importada direto (não depende da rede) e é pública, para não cair no login se ele também não carregar.
• O safeReturn mudou para router/paths.ts, para evitar import circular com a tela nova; o router/index.ts continua exportando.

Testes

• API: Spec007_AC26 cobre:
  • a ordem dos passos;
  • o rascunho v2 com uma Etapa a mais, que não conta;
  • a combinação com search;
  • a trilha só com rascunho e a trilha inexistente, que devolvem página vazia.
• E2E:
  • Spec008_AC26: filtro, URL, recarregar e o link a partir do detalhe de html-para-email.
  • Spec008_AC27: um download bloqueado uma vez recarrega e abre a lista; bloqueado sempre, mostra o aviso depois de uma única recarga.
• Vitest: a detecção da falha nos textos do Chromium, Firefox e Safari, a trava de 10 s por rota e o caso sem sessionStorage.

Verificação local

• Painel: lint, tipos, Vitest (39/39) e build com o check-bundle ✅
• dotnet test --solution tests/PythonScriptRunner.SemE2E.slnf: 203 testes, 0 falhas, 2 ignorados (só rodam no Linux) ✅
• E2E do painel: 22/22 ✅
• dotnet format --verify-no-changes ✅

🤖 Generated with Claude Code