Pipeline CI

O CI é executado em cada push para main e em cada pull request. Ele usa escopo inteligente para pular trabalhos caros quando apenas documentação ou código nativo mudou.

Visão geral dos trabalhos

TrabalhoPropósitoQuando executa
docs-scopeDetectar mudanças apenas em documentaçãoSempre
changed-scopeDetectar quais áreas mudaram (node/macos/android)PRs não relacionados a docs
checkTipos TypeScript, lint, formatoMudanças não relacionadas a docs
check-docsLint de Markdown + verificação de links quebradosDocumentação alterada
code-analysisVerificação de limite de LOC (1000 linhas)Apenas PRs
secretsDetectar segredos vazadosSempre
build-artifactsConstruir dist uma vez, compartilhar com outros trabalhosMudanças não relacionadas a docs, node
release-checkValidar conteúdo do npm packApós build
checksTestes Node/Bun + verificação de protocoloMudanças não relacionadas a docs, node
checks-windowsTestes específicos do WindowsMudanças não relacionadas a docs, node
macosLint/build/test Swift + testes TSPRs com mudanças no macos
androidBuild Gradle + testesMudanças não relacionadas a docs, android

Ordem Fail-Fast

Os trabalhos são ordenados para que verificações baratas falhem antes que as caras sejam executadas:

  1. docs-scope + code-analysis + check (paralelo, ~1-2 min)
  2. build-artifacts (bloqueado no acima)
  3. checks, checks-windows, macos, android (bloqueado no build)

Runners

RunnerTrabalhos
blacksmith-16vcpu-ubuntu-2404Maioria dos trabalhos Linux, incluindo detecção de escopo
blacksmith-16vcpu-windows-2025checks-windows
macos-latestmacos, ios

Equivalentes locais

bash
pnpm check          # tipos + lint + formato
pnpm test           # testes vitest
pnpm check:docs     # formato docs + lint + links quebrados
pnpm release:check  # validar npm pack