smokey

Smokey es un panel de desarrollador estático de un solo archivo para monitorear la salud de los repositorios de GitHub. Se abre index.html en un navegador, se ingresa un nombre de usuario u organización de GitHub, se enumeran los repositorios en formato owner/repo y la página renderiza su estado actual en una sola tabla ordenable. El objetivo declarado es ver la salud del repositorio sin tener que navegar por GitHub. Lo que muestra la tabla - El último push por repositorio, con el push más antiguo listado primero por defecto; cualquier encabezado de columna (repositorio, último push, PRs, issues) puede clickedse para reordenar. - La versión del lanzamiento más reciente y la fecha de lanzamiento, mostradas debajo del nombre del repositorio. - Recuentos de pull requests abiertos e issues abiertos; al hacer clic en un recuento se abre la página de GitHub filtrada para ese repositorio. - Insignias de atención: una fila para PRs abiertos y una para issues abiertos, que aparecen solo para repositorios con actividad de colaboradores externos, y cada insignia enlaza a la vista filtrada de GitHub. Los PRs creados por bots (por ejemplo, de github-actions[bot]) se filtran automáticamente. Autenticación Los repositorios públicos se cargan sin iniciar sesión. Opcionalmente, se puede añadir un token de acceso personal de GitHub en el panel de configuración para desbloquear los repositorios privados y la columna de estado de CI, y es obligatorio para los repositorios de organización protegidos por SAML SSO si el token está autorizado para esa organización. Dado que el acceso a la API no autenticado está limitado a 60 solicitudes por hora y cada repositorio consume cuatro solicitudes, un token se vuelve necesario una vez que se monitorean aproximadamente quince repositorios públicos; un token autenticado eleva el límite a 5,000 solicitudes por hora. El README indica que el token se almacena únicamente en el localStorage del navegador y se envía solo a api.github.com. Se describen tanto los tokens clásicos (alcance repo) como los tokens de grano fino (Contents: Read, Metadata: Read, Actions: Read para el estado de CI). Gráfico de tráfico En lugar de la API de tráfico en vivo de GitHub, el panel dibuja un gráfico de área de tráfico de historial completo utilizando una instantánea diaria guardada en una rama traffic-log, acumulada por un flujo de trabajo de GitHub Actions semanal independiente (log-traffic.yml). El gráfico utiliza un eje de tiempo logarítmico que expande los días recientes y una escala de valor de raíz cuadrada. Esta vista no requiere token. Si la rama o las filas registradas aún no existen, el gráfico informa que no hay historial de tráfico. Alojamiento y configuración No hay paso de compilación, ni instalación de dependencias ni servidor. Hay una copia alojada disponible en GitHub Pages, por lo que el panel puede usarse sin instalar nada; de lo contrario, se descarga index.html y se abre localmente. Para ejecutar su propia instancia, haga un fork del repositorio y habilite GitHub Pages desde la carpeta raíz de la rama principal. El diseño se describe como compacto y compatible con dispositivos móviles, sin barras laterales. El README también documenta casos de resolución de problemas: una página almacenada en caché obsoleta que produce un mensaje persistente de "add a PAT" (resuelto mediante una actualización forzada, señalando que el localStorage se borra en ventanas privadas), errores 403 causados por límites de tasa no autenticados o falta de autorización SAML, y el gráfico de tráfico que permanece vacío hasta que el flujo de trabajo de registro se haya ejecutado al menos una vez después de agregar los repositorios. Licencia y contacto: Licencia MIT, copyright 2025 Scott Kirvan. Se invitan contribuciones a través de issues, forks y pull requests; los canales de contacto enumerados incluyen LinkedIn y un servidor de Discord, y el repositorio incluye un CHANGELOG y un TODO en su carpeta de notas.