Rebase do Branch Atual

Atualize o branch ativo, reaplicando seus commits em cima do branch padrão mais recente do seu remoto upstream. Use o branch padrão real do repositório, seja ele chamado main, master ou outro branch.

Fluxo de Trabalho

1. Inspecione antes de alterar qualquer coisa. Execute git status --porcelain=v1 --branch --untracked-files=all e git branch --show-current. Confirme que o branch atual não é o branch padrão e anote quaisquer alterações locais. Se a árvore de trabalho tiver alterações, pare e pergunte ao usuário se deve commitar, fazer stash ou lidar com elas de outra forma. Não faça stash automaticamente.

2. Identifique o upstream e o branch padrão. Verifique git remote -v e git remote show <remote> (ou o HEAD simbólico do remoto) para determinar o branch que este repositório trata como seu padrão. Prefira o upstream configurado para o branch atual quando disponível; caso contrário, use origin. Não presuma que main existe ou que um branch chamado master está atualizado. Se o branch padrão não puder ser identificado inequivocamente, pergunte ao usuário.

3. Busque o branch padrão mais recente. Busque apenas o remoto e o branch padrão identificados, por exemplo:

   git fetch <remote> <default-branch>
   

   Verifique se a referência de rastreamento remoto buscada existe antes de continuar.

4. Rebase o branch ativo. Informe ao usuário qual branch será rebaseado sobre qual branch de rastreamento remoto, em seguida, execute:

   git rebase <remote>/<default-branch>
   

5. Lide com conflitos sem descartar o trabalho. Se o rebase parar, explique quais arquivos estão em conflito e que o rebase está pausado. Resolva apenas quando as alterações pretendidas forem claras; caso contrário, pergunte ao usuário. Após a resolução, adicione os arquivos resolvidos ao stage e execute git rebase --continue. Se o usuário quiser abandonar a operação, execute git rebase --abort. Nunca use git reset --hard, descarte alterações do usuário ou pule commits para forçar a conclusão.

6. Ofereça hooks de validação. Após o rebase ser bem-sucedido, inspecione as etapas de validação documentadas do repositório e os hooks configurados (por exemplo, hooks pre-commit ou scripts de lint e teste). Pergunte ao usuário se ele deseja que essas verificações sejam executadas antes de prosseguir. Se ele concordar, execute as verificações aplicáveis e relate seus resultados; não ignore ou desabilite hooks.

7. Verifique o resultado. Quando o rebase for concluído, execute git status --porcelain=v1 --branch --untracked-files=all e resuma o resultado, incluindo o branch base usado, os resultados da validação (se executados) e quaisquer alterações restantes. Não faça push, force-push ou altere commits, a menos que o usuário peça separadamente.

Caminho Rápido

Para uma árvore de trabalho limpa onde o branch padrão upstream é conhecido, a operação principal é:

git fetch <remote> <default-branch>
git rebase <remote>/<default-branch>

Substitua <default-branch> pelo nome do branch detectado (main, master ou outro padrão configurado). Nunca execute os comandos de placeholder literalmente.

Regras de Segurança

• Preserve o branch atual do usuário e o trabalho não commitado.
• Não faça rebase do próprio branch padrão.
• Não presuma que main ou master locais estão atualizados; faça rebase sobre o branch de rastreamento remoto buscado.
• Não faça push ou force-push como parte deste fluxo de trabalho.
• Se um rebase já estiver em andamento, inspecione seu estado e pergunte se deve continuar ou abortar; não inicie outro rebase.