Índice

Read in English
Todos los proyectos

RepoScope

Convierte una rama y los commits que elijas en un informe de progreso para el equipo y para quienes no siguieron el trabajo día a día. Cada punto del informe remite al commit que lo respalda.

Por qué existe

Cada semana, un líder técnico tiene que contar lo que su equipo entregó a personas que no leen diffs. Escribirlo a mano lleva tiempo, y lo que se escribe de memoria no siempre coincide con lo que se subió.

Cómo funciona

Eliges un repositorio, una rama y hasta 50 commits. Un modelo de IA redacta el informe en cuatro secciones y cada afirmación enlaza a su commit. Se comparte con un enlace público o llega por Slack, Telegram o correo.

Qué se resistió

  1. Que el informe no invente

    La salida del modelo se valida con Zod, y solo quedan las referencias a commits que de verdad se eligieron.

  2. Un minuto de trabajo sin servidor propio

    La generación corre en segundo plano en Vercel; la página consulta el estado cada 3 segundos y sobrevive a una recarga.

  3. Secretos que el navegador nunca ve

    Los tokens de GitHub y los canales se guardan cifrados con AES-GCM, y todas las tablas tienen RLS.

El correo que entrega el informe, con el título, el resumen, las cifras y el botón para leerlo completo
El informe llega donde el equipo ya lee.
Rol
Análisis, diseño y desarrollo
Año
2026

Stack: Astro, Bun, Supabase, PostgreSQL, Vercel AI SDK, DeepSeek, Tailwind CSS, daisyUI, Zod, Playwright

Por qué

Cada semana o cada sprint, alguien en un equipo de software tiene que explicar qué se entregó a personas que no siguieron el trabajo de cerca: producto, dirección, un cliente interno. Esa persona vive en GitHub, pero su público no lee commits ni diffs.

Escribir ese informe a mano lleva su rato, y tiene un riesgo menos visible: lo que se cuenta de memoria no siempre coincide con lo que de verdad se subió. RepoScope parte de los commits reales y deja cada afirmación atada a uno de ellos.

Cómo

El flujo tiene pocos pasos. Conectas repositorios de GitHub a un espacio de equipo, eliges una rama y marcas los commits que quieres cubrir, hasta 50. El informe sale en cuatro secciones (lo que se entregó, lo que mejoró, lo que conviene mirar de cerca y las notas de versión), y en el idioma que elijas para ese informe: español o inglés.

La pantalla Nuevo informe, con el repositorio, la rama y la lista de commits marcados

Nuevo informe: repositorio, rama y los commits que va a cubrir.

Es un monolito Astro en modo SSR, desplegable en Vercel, con Supabase para la base de datos y la autenticación (correo, GitHub OAuth y segundo factor con TOTP). No hay framework de cliente: las pantallas son formularios renderizados en el servidor, y la única interactiva de verdad, el selector de commits, es un custom element en TypeScript. Antes de elegirlo probé las tres opciones con esa misma pantalla: el custom element enviaba 0,6 KB de JavaScript, una isla de Preact 11,2 KB y Alpine.js 19,1 KB.

Hubo una versión anterior en Laravel, Inertia y React. Esta la reconstruí desde cero sobre Bun, con TypeScript en su modo más estricto, Biome y un script propio que rechaza archivos de más de 150 líneas.

El informe es el producto

Leer y compartir el informe va antes que configurar nada. Cada punto lleva el sha corto de su commit y las líneas que añadió; el índice de partes, a la derecha, permite saltar de cualquier afirmación al commit que la respalda en GitHub.

Las secciones del informe, con puntos numerados que citan los archivos tocados

Cada punto numerado se puede seguir hasta su commit.

El informe se comparte con un enlace público de solo lectura, que se puede revocar, o se imprime como PDF con una hoja de estilos de impresión. También se entrega a los canales que el equipo ya usa: un webhook de Slack, un bot de Telegram o el correo.

La pantalla Integraciones, con el formulario para conectar un canal de Slack, Telegram o correo

Los canales se conectan una vez; las credenciales se cifran al guardarlas.

Desafíos

Que el informe no invente

Un modelo de lenguaje escribe bien, y por eso mismo puede afirmar cosas que los commits no dicen. El pipeline no confía en el texto libre: le pide al modelo (DeepSeek, a través del Vercel AI SDK) una salida estructurada que se valida con Zod. Después la normaliza: respeta el orden de las secciones de la plantilla, recorta los puntos que sobran y deja como máximo tres etiquetas por punto.

Las referencias a commits se resuelven contra la lista que el usuario eligió. Si el modelo cita un sha que no está en esa lista, la referencia simplemente no aparece. Como el pipeline recibe el modelo como dependencia, los tests lo ejercitan con un modelo simulado, sin llamar a la API real.

Un minuto de trabajo sin servidor propio

Generar un informe pide hasta 50 commits a GitHub y una llamada al modelo que puede tardar. La versión en Laravel lo resolvía con un worker de colas, pero en Vercel no hay procesos permanentes. La acción guarda el informe como pendiente, responde al momento y sigue trabajando con waitUntil. Las llamadas a GitHub van en paralelo, de ocho en ocho.

La tarjeta Escribiendo, con el texto «Leyendo 9 commits…» y una barra de progreso

Mientras escribe, la página consulta el estado cada 3 segundos y se actualiza sola.

Para que una recarga o una petición repetida no lancen dos generaciones, el trabajo empieza «reclamando» el informe: solo pasa de pending a generating si seguía pendiente, y esa actualización la gana una sola petición.

Secretos que el navegador nunca ve

RepoScope guarda tokens de GitHub con permiso sobre repositorios y la configuración de cada canal. Se cifran en la aplicación con AES-GCM (un IV aleatorio por mensaje y un formato versionado), y esas columnas no se pueden leer con el rol de un usuario normal. Todas las tablas tienen RLS en Postgres: el cliente con privilegios solo se usa en el servidor, después de comprobar el acceso con el cliente del propio usuario.

El correo de entrega en la bandeja de pruebas, con el resumen y el botón para leer el informe completo

Así llega el informe por correo.

Lo que quedó fuera

Solo hay un proveedor, GitHub. Si la función de Vercel muere antes de empezar, el informe se queda pendiente: no hay reintentos automáticos todavía. El producto aún no está desplegado en producción, y los vídeos usan un GitHub simulado con datos de demostración.