Encontrar a alteração que causou um problema

Comece pelo que sabe: uma mensagem de commit, um ficheiro, uma linha removida ou uma versão que funcionava. O Riff oferece um caminho para cada pista, com o âmbito da pesquisa visível durante a investigação.

Ler o gráfico e pesquisar no histórico

Acompanhe os nomes de ramos e tags no gráfico de commits ou apresente todos os ramos para ver onde os históricos se cruzam. Selecione um commit para consultar autor, commits pais, título, descrição e ficheiros alterados. O filtro do histórico pesquisa nos commits carregados por título, autor ou SHA. A pesquisa aprofundada usa um índice separado no computador com até 1.000 commits recentes, incluindo o texto das mensagens, e devolve até 500 ocorrências. Não garante uma pesquisa de todo o histórico.

Navegar pela pesquisa unificada

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

Abrir um ramo ou um commit nos resultados apresenta o seu histórico sem fazer checkout. A pesquisa de commits exige pelo menos dois caracteres e abrange os 1.000 commits mais recentes entre as referências do repositório ativo. Cada tipo mostra até 20 resultados; refine a consulta ao atingir esse limite. A pesquisa não percorre todos os ficheiros nem o histórico completo de todos os repositórios.

Acompanhar o histórico de um ficheiro

Abra o explorador de histórico do repositório ativo e escolha o ficheiro. O histórico acompanha mudanças de nome e carrega 50 commits de cada vez.
Selecione uma revisão e confira as alterações. 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 ficheiros. O Riff resolve as revisões para commits específicos antes de carregar a comparação.
Use Voltar para regressar à investigação anterior, incluindo páginas carregadas, commit selecionado e posição do blame.

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

Pesquisar texto adicionado ou removido

No explorador de histórico, introduza o texto literal e escolha o filtro de caminho ou pasta, a 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 pesquisa. Abra uma ocorrência para examinar a alteração.

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

Para texto nos ficheiros de trabalho atuais, use a pesquisa em ficheiros. Permite distinguir maiúsculas, procurar palavras inteiras, usar expressões regulares e incluir ficheiros por rastrear, com resultados por caminho e abertura no editor predefinido.

Localizar uma regressão com Bisect

Abra Bisect no repositório. Indique 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 ficheiros ignorados podem impedir a mudança para uma revisão de teste. Mova os ficheiros ignorados que bloquearem a operação para outro local; não são dados descartáveis.
Inicie a investigação. O Riff guarda um ponto de recuperação e prepara um candidato. Execute a verificação adequada e marque a revisão como funcional, com falha ou sem possibilidade de teste.
Repita para o próximo candidato. O diálogo mostra resultados registados, candidatos restantes e destino de regresso. Commits saltados podem deixar mais de uma causa possível.
Termine a investigação para regressar ao ramo ou ao commit original. Fechar apenas o diálogo conserva a sessão; use o aviso no repositório para retomar, incluindo depois de reiniciar o Riff.

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

Prepare a correção num commit bem delimitado ou reveja os pontos de recuperação antes de alterar o histórico.