Encontrar a mudança que causou um problema

Comece pelo que você sabe: uma mensagem de commit, um arquivo, uma linha removida ou uma versão que funcionava. O Riff oferece um caminho para cada pista, com o alcance da busca visível durante a investigação.

Ler o gráfico e buscar no histórico

Acompanhe os nomes de branches e tags no gráfico de commits ou exiba todas as branches para ver onde os históricos se encontram. Selecione um commit para consultar autor, commits pais, título, descrição e arquivos alterados. O filtro do histórico busca nos commits carregados por título, autor ou SHA. A busca aprofundada usa um índice separado no computador com até 1.000 commits recentes, incluindo o texto das mensagens, e retorna até 500 ocorrências. Ela não garante uma busca de todo o histórico.

Navegar pela busca unificada

Abra a paleta de comandos para encontrar ações disponíveis, repositórios cadastrados, branches locais e remotas e commits do repositório ativo. Filtre pelo tipo de resultado e combine palavras da mensagem, do autor ou do SHA.

Abrir uma branch ou um commit nos resultados navega até seu histórico sem fazer checkout. A busca de commits exige pelo menos dois caracteres e cobre os 1.000 commits mais recentes entre as referências do repositório ativo. Cada tipo mostra até 20 resultados; refine a consulta ao alcançar esse limite. A busca não percorre todos os arquivos nem o histórico completo de todos os repositórios.

Acompanhar o histórico de um arquivo

Abra o explorador de histórico do repositório ativo e escolha o arquivo. O histórico acompanha renomeações e carrega 50 commits por vez.
Selecione uma revisão e confira as mudanças. Use blame para identificar o commit responsável por uma linha e abra esse commit ou a versão anterior.
Compare duas revisões para ver as diferenças entre arquivos. O Riff resolve as revisões para commits específicos antes de carregar a comparação.
Use Voltar para retornar à investigação anterior, incluindo páginas carregadas, commit selecionado e posição do blame.

O seletor exibe até 10.000 caminhos. Blame recusa arquivos acima de 1 MiB, com mais de 10.000 quebras de linha ou linhas acima de 20.000 caracteres. Comparações têm limite de 4 MiB tanto para a soma dos blobs alterados quanto para o patch gerado; uma pequena edição em arquivos grandes pode ultrapassá-lo. Conteúdo não suportado recebe um estado explícito.

Buscar texto adicionado ou removido

No explorador de histórico, digite o texto literal e escolha filtro de caminho ou pasta, distinção entre maiúsculas e minúsculas e uma revisão ou todas as referências. Acompanhe a contagem de commits examinados e os resultados durante a busca. Abra uma ocorrência para examinar a mudança.

A busca examina linhas adicionadas e removidas, comparando cada commit com seu primeiro pai. Ela não pesquisa separadamente todos os pais de um merge. Para em 2.000 commits ou 1.000 ocorrências; conteúdo ignorado e limites atingidos significam que a busca está incompleta. O cache fica em memória, sem criar um índice permanente de todo o repositório.

Para texto nos arquivos de trabalho atuais, use a busca em arquivos. Ela permite distinguir maiúsculas, buscar palavras inteiras, usar expressões regulares e incluir arquivos não rastreados, com resultados por caminho e abertura no editor padrão.

Localizar uma regressão com Bisect

Abra Bisect no repositório. Informe uma revisão que funcionava e outra com falha e confira os commits exatos antes de iniciar.
Prepare uma árvore de trabalho limpa. Alterações pendentes, outra operação Git ou colisões com arquivos ignorados podem impedir a troca para uma revisão de teste. Mova por conta própria os arquivos ignorados que bloquearem a operação; eles não são dados descartáveis.
Inicie a investigação. O Riff salva um ponto de recuperação e prepara um candidato. Execute a verificação adequada e marque a revisão como funcionando, com falha ou sem possibilidade de teste.
Repita para o próximo candidato. O diálogo mostra resultados registrados, candidatos restantes e destino de retorno. Commits pulados podem deixar mais de uma causa possível.
Encerre a investigação para voltar à branch ou ao commit original. Fechar somente o diálogo conserva a sessão; use o aviso no repositório para retomar, inclusive depois de reiniciar o Riff.

Bisect não executa comandos de teste arbitrários por você. O intervalo tem limite de 100.000 commits e a lista exibida, de 100 candidatos. Sessões Git existentes com termos personalizados, filtros de caminho ou modo first-parent podem ser inspecionadas e encerradas, mas não são reinterpretadas pelo fluxo guiado.

Prepare a correção em um commit com foco ou revise os pontos de recuperação antes de alterar o histórico.