Seu próprio painel de revisão
O Narsil Check é um painel lateral que revisa sua sessão antes de entregar: ambiente, conectores, CI, branch atrás da remota, atualizações agrupadas por risco, vulnerabilidades e uma lista de pendências que o Claude pode usar. Cada guia explica uma de suas funcionalidades, as decisões de design por trás dela e o pedido que deu início a ela.
Quando o pedido original ficou registrado, o guia o cita palavra por palavra. Quando não, o guia avisa e o reconstrói a partir do histórico de commits.
Os guias
- 1O painel lateralComo o Narsil Check desenha um painel ao lado do chat com seções recolhíveis, um ponto colorido por seção, o estado recolhido que ele lembra e linhas que você copia com um clique.
- 2O ambiente da sessãoComo o Narsil Check mostra o repositório, a pasta, o branch, o Remote Control e o Auto-fix, lidos do git e dos servidores do app de desktop, e por que os consulta tão pouco.
- 3ConectoresComo o Narsil Check lista os servidores MCP da sessão com o seu estado e quantas ferramentas cada um tem, pedidos uma vez ao próprio servidor de conectores do app de desktop.
- 4O CI do seu PRComo o Narsil Check acompanha os passos do GitHub Actions do pull request da sessão com a CLI gh, a cada 10 segundos enquanto uma execução roda, e para quando ela termina.
- 5Um branch atrás do seu remotoComo o Narsil Check faz fetch, conta os commits que faltam no seu branch, avisa no topo do painel e os traz com um botão de git pull -r.
- 6Um adaptador por ecossistemaComo o Narsil Check lê onze ecossistemas de pacotes por um contrato pequeno: cada adaptador lê o seu manifesto, consulta o seu registro e diz como subir uma versão.
- 7Classificar as atualizaçõesComo o Narsil Check separa cada biblioteca desatualizada em Bloqueada, Versão major, Só subir a versão ou Fora do Expo SDK, e por que guarda as respostas dos registros por seis horas.
- 8Dependências que se bloqueiamComo o Narsil Check encontra atualizações npm que não podem subir sozinhas: peers que a nova versão pede, peers que os pacotes instalados pedem e pins exatos na árvore.
- 9A espera de 24 horasPor que o Narsil Check nunca sobe uma versão publicada há menos de um dia, onde cada registro diz quando uma versão saiu e o que acontece quando ninguém sabe dizer.
- 10Versões fixadas de propósitoComo o Narsil Check lê um comentário como "# pinned: 3.7 breaks auth" num manifest e deixa essa biblioteca fora do botão de atualização, com o comentário como motivo.
- 11Explicar uma versão major com o HaikuComo o Narsil Check pergunta ao Haiku o quanto uma major é difícil para este projeto, a partir das notas de versão e das linhas que importam a biblioteca, e como impede o modelo de inventar.
- 12Atualizar as triviaisComo o botão Actualizar las N sobe todos os patches e minors de uma vez, mantendo o operador de intervalo e a seção de cada um, e depois roda a ferramenta de instalação de cada ecossistema.
- 13Criar o PRComo o Narsil Check transforma manifests atualizados num commit, num branch chore/upgrade-deps e num pull request aberto com o gh, e depois leva você de volta ao branch principal.
- 14Vulnerabilidades com o OSV.devComo o Narsil Check pergunta ao OSV.dev sobre cada pacote instalado numa só consulta em lote, classifica cada alerta pela sua própria nota ou pelo vetor CVSS e conta os alertas gêmeos uma vez.
- 15PendênciasComo o Narsil Check mantém uma lista de pendências por projeto num arquivo JSON não rastreado, a deixa fora do git e nunca sobrescreve uma lista danificada sem uma cópia.
- 16Ferramentas para o ClaudeComo o Narsil Check dá ao Claude quatro ferramentas sobre a lista de pendências com $.tool.register, as atende a partir de hooks tool.call, e como o modelo decide quando usá-las.
- 17Kotlin, Gradle e AGP (avançado)Por que um build Kotlin ou Android não sobe uma ferramenta sozinha, e como o Narsil Check bloqueia o Kotlin além dos plugins do compilador e confere os mínimos entre Gradle, AGP, Kotlin e Compose.