Encontrar el cambio que causó un problema

Empieza por lo que sabes: un mensaje de commit, un archivo, una línea eliminada o una versión que funcionaba. Riff ofrece un camino para cada pista y muestra el alcance de la búsqueda durante la investigación.

Leer el gráfico y buscar en el historial

Sigue los nombres de ramas y etiquetas en el gráfico de commits o muestra todas las ramas para ver dónde se unen sus historiales. Selecciona un commit para consultar autor, commits padre, título, descripción y archivos modificados. El filtro del historial busca en los commits cargados por título, autor o SHA. La búsqueda profunda usa un índice separado en el equipo con hasta 1.000 commits recientes, incluido el texto de los mensajes, y devuelve hasta 500 coincidencias. No garantiza una búsqueda de todo el historial.

Navegar con la búsqueda unificada

Abre la paleta de comandos para encontrar acciones disponibles, repositorios registrados, ramas locales y remotas y commits del repositorio activo. Filtra por tipo de resultado y combina palabras del mensaje, autor o SHA.

Abrir una rama o un commit en los resultados muestra su historial sin hacer checkout. La búsqueda de commits necesita al menos dos caracteres y abarca los 1.000 commits más recientes entre las referencias del repositorio activo. Cada tipo muestra hasta 20 resultados; precisa la consulta al alcanzar el límite. No recorre todos los archivos ni el historial completo de todos los repositorios.

Seguir el historial de un archivo

1. Abre el explorador de historial del repositorio activo y elige el archivo. Su historial sigue los cambios de nombre y carga 50 commits cada vez.
2. Selecciona una revisión y examina los cambios. Usa blame para identificar el commit responsable de una línea y abre ese commit o la versión anterior.
3. Compara dos revisiones para ver las diferencias entre archivos. Riff resuelve las revisiones a commits concretos antes de cargar la comparación.
4. Usa Atrás para volver a la investigación anterior, incluidas las páginas cargadas, el commit seleccionado y la posición de blame.

El selector muestra hasta 10.000 rutas. Blame rechaza archivos de más de 1 MiB, con más de 10.000 saltos de línea o líneas de más de 20.000 caracteres. Las comparaciones tienen un límite de 4 MiB tanto para la suma de los blobs modificados como para el parche generado; una pequeña edición en archivos grandes puede superarlo. El contenido no compatible recibe un estado explícito.

Buscar texto añadido o eliminado

En el explorador de historial, escribe texto literal y elige un filtro de ruta o carpeta, si distingues mayúsculas y una revisión o todas las referencias. Sigue el recuento de commits examinados y los resultados durante la búsqueda. Abre una coincidencia para examinar el cambio.

La búsqueda examina líneas añadidas y eliminadas y compara cada commit con su primer padre. No busca por separado en todos los padres de un merge. Se detiene en 2.000 commits o 1.000 coincidencias; el contenido omitido y los límites alcanzados indican una búsqueda incompleta. La caché está en memoria, sin crear un índice permanente del repositorio completo.

Para texto en los archivos de trabajo actuales, usa la búsqueda en archivos. Admite distinguir mayúsculas, palabras completas, expresiones regulares y archivos sin seguimiento de forma opcional, con resultados por ruta y apertura en el editor predeterminado.

Localizar una regresión con Bisect

1. Abre Bisect en el repositorio. Introduce una revisión que funcionaba y otra con fallo y comprueba los commits exactos antes de empezar.
2. Prepara un árbol de trabajo limpio. Los cambios pendientes, otra operación Git o las colisiones con archivos ignorados pueden impedir el cambio de revisión. Aparta por tu cuenta los archivos ignorados que bloqueen la operación; no son datos desechables.
3. Inicia la investigación. Riff guarda un punto de recuperación y prepara un candidato. Ejecuta la comprobación adecuada y marca la revisión como funcional, con fallo o imposible de probar.
4. Repite para el siguiente candidato. El diálogo muestra los resultados registrados, candidatos restantes y destino de regreso. Los commits omitidos pueden dejar más de una causa posible.
5. Termina la investigación para volver a la rama o al commit original. Cerrar solo el diálogo conserva la sesión; usa el aviso del repositorio para retomarla, incluso después de reiniciar Riff.

Bisect no ejecuta comandos de prueba arbitrarios por ti. El intervalo está limitado a 100.000 commits y la lista visible, a 100 candidatos. Las sesiones Git existentes con términos personalizados, filtros de ruta o modo first-parent pueden inspeccionarse y terminarse, pero el flujo guiado no las reinterpreta.

Prepara la corrección en un commit bien delimitado o revisa los puntos de recuperación antes de cambiar el historial.