TTT-b/stremio-ai-translator

Fluxo de trabalho Git e GitHub

Remoto: origin = https://github.com/TTT-b/stremio-ai-translator. Branch padrão: main. Comandos Windows PowerShell.

Início do trabalho

1. git status -sb e git fetch origin.
2. Se a árvore de trabalho estiver limpa: git pull --ff-only. Se não estiver limpa, pare e informe ao usuário o que foi modificado.

Durante o trabalho

• Trabalhe em uma branch para qualquer alteração não trivial: git switch -c <nome-curto>. Correções pequenas e seguras podem ir diretamente para main apenas se o usuário autorizar.
• Faça commits pequenos e focados. Mensagem: vX.Y.Z: resumo curto para releases, caso contrário tipo: resumo curto (fix:, feat:, docs:, test:, chore:).
• Adicione arquivos pelo nome (git add <arquivo>), nunca git add . ou -A cegamente. Verifique git diff --staged primeiro.
• Nunca faça commit de .env, settings.json, data/, logs/, node_modules/, dist-electron/, release/, tokens ou chaves de API. Se um segredo foi commitado, pare e informe ao usuário para rotacioná-lo.
• Execute npm run check antes de cada commit. Não faça commit enquanto ele falhar.

Enviando (push)

• Envie apenas quando o usuário solicitar. Push normal: git push. Nunca --force na main. Se um force push for realmente necessário em uma branch pessoal, use --force-with-lease e pergunte primeiro.
• Releases: incremente version em package.json, atualize README/TROUBLESHOOTING se o comportamento mudou, faça commit, então git tag vX.Y.Z e git push --follow-tags apenas após o usuário confirmar. Cada tag deve apontar para seu próprio commit.

Verificações de release (toda release, não apenas quando algo parece errado)

1. npm run check passa (inclui o teste de que RELEASE_NOTES tem notas em pt e en para a versão em package.json).
2. A versão em package.json é maior que a última tag publicada (git tag --sort=-v:refname | Select-Object -First 1); o atualizador no aplicativo só oferece versões mais altas.
3. Compile com npm run dist e peça ao usuário para instalar a partir de release/ primeiro; aguarde a autorização deles antes de publicar.
4. Após a publicação, gh release view vX.Y.Z deve listar o instalador .exe, seu .blockmap e latest.yml. Sem latest.yml, a opção "verificar atualizações" no aplicativo não encontra nada.
5. Peça ao usuário para pressionar "Verificar atualizações" na versão anterior e confirmar que a nova versão é oferecida.

Sincronizando com o notebook/celular

• O desktop é a máquina de trabalho. Quando o usuário disser que o GitHub está atualizado: git fetch origin, mostre git log --oneline HEAD..origin/main, depois git pull --ff-only. Se não for possível fazer fast-forward, mostre a divergência e pergunte antes de fazer merge ou rebase.

Configurações recomendadas do GitHub (definidas pelo usuário na interface web)

Configurações do Repositório -> Branches: proteja main (exija pull request, bloqueie force pushes, bloqueie exclusão). Configurações -> Segurança de código: ative varredura de segredos com proteção contra push, alertas Dependabot e atualizações de segurança Dependabot. Configurações -> Geral: ative "Excluir automaticamente branches head". Conta: ative a autenticação de dois fatores.