Farol es una herramienta de línea de comandos y acción de GitHub de código abierto que permite a los desarrolladores evaluar el riesgo de fusionar una solicitud de extracción (pull request) antes de aprobarla. Diseñada para complementarse con las revisiones realizadas por agentes de inteligencia artificial, Farol identifica los archivos más críticos y los puntos de impacto de los cambios, asegurando que las revisiones humanas se centren en las partes más peligrosas del código.
El sistema funciona mediante análisis estático determinista, utilizando los compiladores nativos de los lenguajes (TypeScript, Go, Python) en lugar de predicciones probabilísticas de modelos de lenguaje. Esto garantiza que el mismo pull request siempre genere el mismo informe, eliminando la inconsistencia en las evaluaciones. Farol analiza la cadena de llamadas de funciones, la cobertura del diff y los posibles rotos de contrato en APIs, GraphQL o gRPC, así como los cambios en dependencias.
La herramienta ofrece un informe interactivo que clasifica la revisión como de 'trayecto rápido', 'rápida' o 'cuidado', asignando una puntuación de riesgo del 0 al 100. Incluye una lista de verificación de pruebas manuales y permite marcar archivos ya revisados. Farol se ejecuta localmente o en entornos CI, sin necesidad de cuentas de servicio, y no ejecuta ni envía código externo. Está disponible para React, Next.js, TanStack Router, Go y Python, integrándose en flujos de trabajo existentes para mejorar la calidad y seguridad del código.
