av/remotion-bits

Remotion Bits Release

Use esta skill ao preparar e publicar uma nova versão do remotion-bits a partir deste repositório.

O Que Esta Skill Faz

Esta skill executa o fluxo de trabalho completo de lançamento:

1. Atualiza a versão em ./package.json. O padrão é um bump de patch, a menos que o usuário solicite explicitamente minor, major ou uma versão específica.
2. Atualiza CHANGELOG.md com notas de release concisas para a nova versão.
3. Executa npm run registry:build.
4. Cria o commit das alterações de release com chore: vX.Y.Z.
5. Envia o commit de release para master.
6. Pesquisa mudanças notáveis desde o release anterior no histórico do git e PRs mesclados.
7. Abre o formulário de release do GitHub pré-preenchido com o navegador do sistema, não o navegador interno.
8. Após a publicação do release no GitHub, implanta a documentação com ./scripts/deploy-docs.sh.
9. Publica o pacote no npm com npm publish.

Pré-condições

• Trabalhe a partir da raiz do repositório.
• Não inicie o servidor de desenvolvimento da documentação.
• Assuma que a publicação do release requer credenciais válidas do GitHub, Cloudflare e npm já configuradas no ambiente.
• Se a árvore de trabalho contiver alterações do usuário não relacionadas, não as reverta. Ou contorne-as ou pare e pergunte antes de tocá-las se elas afetarem os arquivos de release.

Fluxo de Release

1. Determinar a Versão Alvo

• Leia a versão atual de ./package.json.
• Se o usuário forneceu uma versão específica, use-a.
• Se o usuário forneceu um tipo de bump, aplique-o.
• Caso contrário, faça um bump de patch.
• A tag git e o título do release devem ser vX.Y.Z.

2. Preparar Notas de Release

• Revise os commits desde a última tag lançada.
• Revise PRs mesclados quando eles ajudarem a resumir as mudanças.
• Atualize CHANGELOG.md inserindo a seção da nova versão no topo.
• Mantenha as entradas concisas e voltadas para o usuário.
• Use este formato:

### vX.Y.Z

- Funcionalidade: Breve descrição da nova funcionalidade
- Correção: Breve descrição da correção de bug
- Melhoria: Breve descrição do aprimoramento
- Documentação: Breve descrição da mudança na documentação

3. Atualizar a Versão e Construir o Registro

• Atualize ./package.json para a nova versão.
• Execute:

npm run registry:build

• Se a construção falhar, pare e corrija o problema subjacente antes de continuar.

4. Commitar e Enviar o Release

• Revise o diff do release.
• Crie o commit do release preparado com:

git commit -am "chore: vX.Y.Z"

• Envie o commit para master.
• Se o repositório estiver atrás do remoto ou o push falhar, resolva esse estado antes de continuar.

5. Rascunhar o Release do GitHub

• Construa as notas de release a partir do resumo do changelog e commits recentes.
• Abra esta URL com xdg-open ou outro comando de abertura no nível do sistema, nunca o navegador interno:

https://github.com/everlier/remotion-bits/releases/new?tag=vX.Y.Z&target=master&title=vX.Y.Z&body=...

• Pré-preencha o formulário com:

  • tag: vX.Y.Z
  • target: master
  • title: vX.Y.Z
  • prerelease: false

• O corpo do release deve seguir esta estrutura:

## O Que Mudou

- Uma frase curta por nova funcionalidade notável.
- Uma frase curta por correção de bug notável.
- Uma frase curta por melhoria notável.

**Changelog Completo**: https://github.com/everlier/remotion-bits/compare/vX.Y.(Z-1)...vX.Y.Z

• Pause para o usuário publicar o release do GitHub se a confirmação no navegador for necessária.

6. Implantar a Documentação

• Após o release do GitHub ser publicado, execute:

./scripts/deploy-docs.sh

7. Publicar no npm

• Confirme se a autenticação npm está disponível.
• Publique a partir da raiz do repositório:

npm publish

Regras de Decisão

• Padrão para releases de patch, a menos que o usuário diga o contrário.
• Se as notas de release não estiverem claras, derive-as do histórico de commits antes de perguntar ao usuário.
• Se um comando alterar artefatos de release, mantenha essas alterações geradas no commit de release.
• Se a publicação exigir uma etapa manual no navegador, pare no limite, diga exatamente ao usuário o que está esperando e, em seguida, continue após a confirmação.
• Se as credenciais do GitHub, Cloudflare ou npm estiverem faltando, pare e informe o pré-requisito ausente em vez de tentar novamente cegamente.

Lista de Verificação de Conclusão

• package.json tem a versão alvo.
• CHANGELOG.md tem uma nova seção no topo para essa versão.
• npm run registry:build foi concluída com sucesso.
• O commit de release chore: vX.Y.Z existe e foi enviado para master.
• O formulário de release do GitHub foi aberto com os valores pré-preenchidos corretos.
• A implantação da documentação foi concluída.
• npm publish foi concluída com sucesso.