Revisar cambios de un agente con Changes en Paneflow

La pestaña Changes de Paneflow muestra los cambios locales junto al terminal de tu agente. Puedes comparar los archivos con el último commit (HEAD), abrirlos en el editor para consultar el contexto o restaurar un bloque que quieras retirar.

Los pasos siguientes describen Paneflow 0.17.5. Changes incluye cambios preparados y sin preparar para el commit, además de archivos no rastreados. Los agrupa por checkout, independientemente de quién los haya hecho. Si varios agentes trabajan sobre los mismos archivos, sus cambios aparecen juntos.

Guía actualizada. Este artículo anunció originalmente la interfaz Diff de Paneflow 0.3.7. Ahora describe la pestaña Changes del dock.

Elegir el checkout que vas a revisar

Abre tu proyecto Git, selecciona la pestaña del checkout o worktree que quieras revisar y abre Changes en el dock. Comprueba las rutas de los archivos antes de leer el diff.

La comparación muestra los archivos actuales frente a HEAD. Los cambios preparados y sin preparar se combinan en esta vista. Para ver exactamente qué incluirá tu próximo commit, inspecciona el índice de Git por separado con git diff --cached.

Changes excluye los cambios ya confirmados en la rama. En un repositorio sin un primer commit, usa un árbol vacío como base de comparación.

Leer el diff con su contexto

Elige Split para leer las versiones una al lado de la otra o Unified para ver las adiciones y eliminaciones en una sola vista. El resaltado Words marca los cambios dentro de una línea.

Las opciones de espacios en blanco permiten recortarlos o ignorarlos en la comparación. Mantén Default cuando los espacios afecten al comportamiento, como la indentación en Python.

Si necesitas el código que rodea a un bloque o quieres hacer una corrección, abre el archivo en Files, el editor integrado. Guarda tus cambios para que aparezcan en Changes, que lee los archivos del disco.

Cuando un archivo no muestra un diff de texto

En Paneflow 0.17.5, Changes lista los archivos binarios, los de más de 512 KiB y ciertos archivos de bloqueo de dependencias sin mostrar un diff de texto. La lista muestra hasta 200 archivos e indica cuando se omiten más archivos.

Un archivo sin diff de texto puede haber cambiado. Usa Git para inspeccionar la lista completa y una herramienta adecuada para revisar archivos grandes o binarios.

Restaurar un bloque con Revert

En un archivo de texto modificado, Revert reemplaza un bloque por su contenido en HEAD. El clic escribe en disco inmediatamente, sin diálogo de confirmación. Copia o conserva de otra forma los cambios que puedas querer mantener antes de usarlo y revisa después el diff restante.

Revert deja el índice de Git sin cambios. Si ya habías preparado el bloque para el commit, seguirá incluido hasta que actualices el índice. Comprueba git diff --cached después de restaurar cambios ya preparados. Revert no elimina archivos no rastreados.

Paneflow rechaza la restauración en estos dos casos:

• El archivo tiene cambios sin guardar en el editor. Guárdalos o descártalos si ya no los necesitas y vuelve a leer el diff antes de intentarlo de nuevo.
• El archivo cambió en disco desde que se cargó el diff. Vuelve a leer el diff actualizado antes de intentarlo de nuevo, sobre todo si un agente sigue editando el archivo.

Revisar toda la rama con un agente

Para pedir una revisión, inicia el agente en el checkout que quieras inspeccionar y especifica la rama base. Por ejemplo, si tu rama parte de main:

Revisa esta rama respecto a main, incluyendo los commits y los cambios locales. No modifiques archivos. Señala bugs y riesgos de regresión con rutas de archivos, números de línea y tests pertinentes.

El agente puede así examinar los cambios ya confirmados que Changes no muestra. Lee sus observaciones junto al código, realiza las correcciones necesarias y ejecuta los tests pertinentes. Antes del commit, inspecciona git diff --cached para comprobar qué vas a registrar.