Branch alvo: Objetivo: validar manualmente, em modo dev (Turbopack), que toda página renderiza sem erro de runtime ou de backend antes de fechar a versão 3.8.0. Para cada erro encontrado, o operador corrige na própria página e segue para a próxima — esse documento é o roteiro vivo da sessão.

smoke test manual operacional, não uma suíte automatizada. Pareceu didático demais? É proposital: o objetivo é que outro mantenedor consiga retomar do meio se a sessão for interrompida.

---

git fetch origin
git checkout release/v3.8.0
git pull origin release/v3.8.0 --ff-only
git status                       # working tree limpo

na raiz

e geram na raiz (gitignored, mirror de ). Se ele existir, o Next.js dev prefere a raiz e quebra todas as rotas (Turbopack devolve ).

[ -d app ] && mv app /tmp/omniroute-pack-artifact-$(date +%s)
ls -d app 2>/dev/null && echo "STILL THERE — abortar" || echo "ok"

rm -rf .next/dev

npm run dev 2>&1 | tee /tmp/omniroute-dev.log

e . Mantenha o terminal visível durante toda a sessão — é a fonte primária de erros de backend.

DevTools aberto (F12), aba Console ativa, filtro , e a aba Network com "Preserve log" marcado.
• ) para isolar o ruído.

tail -F /tmp/omniroute-dev.log | grep --line-buffered -iE "error|warn|cannot|undefined|TypeError|PageNotFoundError"

Erros da linha correspondente.

---

todas estas condições são atendidas:

(não /). Redirects (/) só são aceitáveis se intencionais (ex.: → ).
1. error overlay do Turbopack/React aparece na tela.
2. no DevTools (warnings são toleráveis, mas anote os novos).
3. . Erros pré-existentes recorrentes (refresh de token de provider sem credencial, p.ex.) podem ser ignorados — mas confirme que são os mesmos de antes.

status , descreva o sintoma na coluna Erros, corrija, recarregue, marque quando passar.

---

		na raiz, ou stale
em runtime
		fora de	, ou marcar a sub-árvore como
em rota de API chamada pela página			e o módulo em
			ou adicionar a chave
		busca dados de uma API que retorna 401/500
		falhando	em

Regra de ouro: se a correção exigir mais de ~20 linhas ou cruza módulos do , anote como e siga para a próxima página — não trave a release por um refactor.

---

.

deslogado primeiro, depois logar)

		ou conforme sessão
	(ex. slug)
	, , , , , , , ,

, autentique e siga.

		(HTTP 307)

	(qualquer válido)

		atenção: se Monaco falhar com , é regressão do fix do

	(já testado em 3.1)

		)

---

Limpar console do DevTools ().
1. Navegar clicando na sidebar (preferível a digitar URL — testa também a navegação).
2. Esperar carregar (até o spinner sumir e o conteúdo principal aparecer; timeout subjetivo: 10s).
3. Olhar o DevTools Console: qualquer vermelho conta.
4. Olhar o terminal do : stack trace nova = falha.
5. Interagir com o elemento óbvio da página (1 clique em filtro/aba/CTA). Se o clique disparar erro, falha.
6. Marcar se ok, + nota se falhar.
7. Se falhar: a. Categorizar pela tabela §2. b. Corrigir. c. Salvar; aguardar Turbopack recompilar (~2-5s; olhar o terminal do dev server). d. Recarregar a página; refazer §1–6. e. Quando passar, atualizar a coluna Erros desta linha com "Fix: " e marcar .
8. Próxima linha.

---

Um fix por página, com escopo claro:

# exemplo
git add src/app/\(dashboard\)/dashboard/<página>/page.tsx
git commit -m "fix(<area>): <descrição curta>

E2E shakedown v3.8.0: <página> quebrava com <sintoma>.
<o que mudou e por quê>"

(hard rule #16). Não rodar .

push único com todos os fixes:

git push origin release/v3.8.0

---

:

npm run lint npm run typecheck:core npm run test:unit
1. como evidência.
2. com a linha:

   .

3. e disparar o release.

---

exemplo: /dashboard/cli-tools	500 no POST /api/cli-tools/config	Zod schema faltando	Adicionado	abc123