checks-local

checks-local — rodar os checks do seu projeto na propria maquina

Por que essa skill existe

CI na nuvem (GitHub Actions e afins) e pago por minuto e as vezes trava a conta inteira quando estoura o limite — ai TODA PR nasce vermelha sem ninguem ter testado nada. Esta skill roda os mesmos checks localmente, em segundos, e (opcionalmente) deixa voce mergear por bypass de admin quando tudo passar local.

⚠️ Template — exige configuracao. O que cada check roda depende do seu stack. Antes de usar, edite scripts/checks.config.sh e preencha os comandos do seu projeto (typecheck, testes, lint, validacao de migration). O setup.sh do plugin ja cria esse arquivo a partir do exemplo se voce rodou o setup.

Comando unico

bash <caminho-do-plugin>/skills/checks-local/scripts/run-checks.sh

Detecta o repo pela pasta atual (git rev-parse --show-toplevel), entao funciona tanto na raiz do projeto quanto em qualquer worktree. Sai 0 se os obrigatorios passam (mesmo com alertas de seguranca ⚠️), 1 se algum obrigatorio falha ou se a varredura de seguranca achar um bloqueio duro. Mostra as ultimas linhas do log de cada falha.

O que cada check faz

Os comandos sao definidos em scripts/checks.config.sh. O padrao do template assume um projeto JS/TS + (opcionalmente) Supabase, mas voce troca pelos do seu stack:

Check	Comando (configuravel)	Observacao
typecheck	CHECK_TYPECHECK (ex: npm run typecheck)	trava anti-regressao de tipo. Vazio = pula
test	CHECK_TEST (ex: npm test, pytest, go test ./...)	testes do projeto. Vazio = pula
lint	CHECK_LINT (ex: npm run lint, ruff check)	opcional. Vazio = pula
migrations	CHECK_MIGRATIONS (ex: validar nome canonico das migrations)	opcional. Vazio = pula
security	check-security.sh — varre so o diff (linhas adicionadas vs base)	bucket publico, tabela sem regra de acesso (RLS), segredo sem timing-safe, CORS *, endpoint publico sem barreira. ⚠️ avisa, nao bloqueia (exceto tabela sem RLS). Customize as regras no script

Checks com comando vazio na config sao pulados silenciosamente — voce so liga os que fazem sentido pro seu stack.

Pre-requisito (1 vez so)

• Preencha scripts/checks.config.sh com os comandos do seu projeto.
• Instale as dependencias do seu stack (o template tem um hook opcional CHECK_BOOTSTRAP pra rodar algo como npm ci se faltar node_modules).

Mergear por bypass depois que passar (opcional)

Quando os checks passam local, da pra mergear a PR sem esperar o CI remoto:

gh pr merge <NUMERO> --repo <owner/repo> --admin --squash --delete-branch

--admin usa o privilegio de admin pra passar por cima dos checks vermelhos remotos. So fazer isso depois de ver tudo verde localmente — e a confianca que substitui o CI. Se voce nao e admin do repo, remova o --admin. O script scripts/safe-merge.sh (na skill principal) faz isso de forma atomica: roda os checks e so mergeia se passarem.

Limite honesto

Rodar local nao pinta o check do GitHub de verde — ele continua como estiver no servidor. O valor aqui e (1) feedback rapido e (2) confianca pra mergear por bypass. Automacoes que dependem de Actions (ex: review automatico na nuvem, lighthouse) so rodam la.