Repository navigation
Releases: homium-tech/audit
Release list
v2.0.0 — 9 dimensiones estables, GEO v2, instalador reforzado
Hito de estabilidad de las 9 dimensiones. Sin cambios de schema que rompan compatibilidad con audit-platform.
Agregado
- Screenshots de alta calidad — captura directa con Chrome headless (PNG, mobile 412×823@1.75x emulando Moto G Power, desktop 1350×940), reemplaza el thumbnail comprimido de Lighthouse como método principal. Lighthouse queda como fallback si Chrome no está disponible.
Corregido — instalador (install.sh)
- Node.js vía NodeSource en Debian/Ubuntu —
apt-get install nodejs npmfallaba con frecuencia por choque de archivos entre paquetes y versiones viejas en los repos default (reportado en instalación real sobre Ubuntu Server). Ahora usa el script de NodeSource, el método soportado oficialmente. - Guardia contra
sudo bash install.shcompleto — ejecutar el instalador entero como root resuelve$HOMEa/root(env_reset de sudoers) y deja el symlink y el PATH configurados donde el usuario real nunca los ve. El instalador ahora aborta con instrucciones si detecta esto. - Creación de rc file si no existe al configurar el PATH.
También incluido en este hito (sin release de GitHub propio hasta ahora)
- GEO v2 completo (v1.10.0) — noai/noimageai detection, citation patterns, calidad real de llms.txt, definition sentences, ai-plugin.json.
- Seguridad complementaria (v1.11.0) — SRI ratio real, HSTS includeSubDomains+preload, MTA-STS.
- GEO v2 base, CSP/TLS/SameSite, CORS, API keys en JS (v1.8.x–v1.9.0).
Historial completo en CHANGELOG.md.
v1.3.4 — Detección de Chrome en Windows, macOS y Linux
Problema resuelto
Lighthouse no corría en Windows aunque Chrome estuviese instalado, dejando Core Web Vitals y screenshots en N/A.
Causa raíz
chrome-launcher (la librería que usa Lighthouse para encontrar Chrome) puede fallar en entornos Git Bash porque busca Chrome vía el registro de Windows, lo cual no siempre funciona en ese shell. Al no encontrar Chrome, Lighthouse falla silenciosamente.
Solución
Nueva función _detect_chrome() que busca Chrome en las rutas conocidas de cada plataforma y pasa --chrome-path explícitamente a Lighthouse:
- Windows (Git Bash):
C:/Program Files/Google/Chrome/...,Program Files (x86)yAppData\Localdel usuario. Convierte rutas Git Bash (/c/...) al formatoC:/...que Node.js entiende. - macOS:
/Applications/Google Chrome.app/..., Homebrew Chromium en/opt/homebrewy/usr/local - Linux:
google-chrome,google-chrome-stable,chromium-browser,chromium
Si no se encuentra ningún navegador, Lighthouse corre sin --chrome-path (comportamiento anterior — fallback a auto-detección).
También incluye
install.shinstala Chromium automáticamente si no hay ningún navegador compatible (brew / apt / dnf)
Upgrade
homium-audit --updatev1.3.3 — Fix Lighthouse vía npx
Qué se corrigió
Lighthouse ahora siempre corre en equipos sin instalación global.
El problema
resolve_cmd() intentaba verificar que el paquete npx estuviese disponible corriendo npx lighthouse --version antes de usarlo. Esto provocaba que npm descargara el paquete completo durante la verificación — si esa descarga fallaba o hacía timeout (permisos, red lenta, npm cache con permisos de root), Lighthouse quedaba marcado como no disponible y la auditoría corría sin él.
La solución
resolve_cmd() ahora solo comprueba si el binario npx existe en el sistema, y devuelve npx --yes <pkg>. La descarga del paquete ocurre en tiempo de ejecución, donde npm tiene contexto completo para manejar errores.
# Antes (problemático)
elif command -v npx &>/dev/null && npx "$pkg" --version &>/dev/null 2>&1; then
echo "npx $pkg"
# Ahora (correcto)
elif command -v npx &>/dev/null; then
echo "npx --yes $pkg"Impacto
- Lighthouse Mobile + Desktop corre correctamente en equipos sin instalación global
- Screenshots mobile y desktop se generan en el reporte
- Core Web Vitals (LCP, FCP, TBT, CLS) aparecen en la tabla comparativa
- El instalador sigue siendo igual — no requiere cambios
Upgrade
homium-audit --updatev1.3.2 — Installer totalmente automático
Installer sin intervención manual
El instalador ahora configura todo automáticamente — no requiere que el usuario instale nada por separado.
Qué instala automáticamente
| Herramienta | macOS | Linux | Windows |
|---|---|---|---|
| Homebrew | ✅ Si no está | — | — |
| curl, openssl, perl | ✅ brew | ✅ apt/dnf/yum/pacman | incluidos en Git Bash |
| jq, dig, whois | ✅ brew | ✅ apt/dnf/... | fallback a API |
| Node.js / npx | ✅ brew | ✅ apt | aviso con link |
| Go + webanalyze | ✅ brew + go install | ✅ apt + go install | go install si Go está |
Comportamiento
- Si una herramienta ya está instalada → la reconoce y continúa sin reinstalar
- Si una instalación falla → avisa y continúa (no bloquea)
lighthouse,axe-core,pa11yyhtmlhintse ejecutan víanpxbajo demanda — sin instalación global
Instalación
curl -sSL https://raw.githubusercontent.com/homium-tech/audit/main/install.sh | bashv1.3.1 — Fix installer sin npm install global
Fix: Installer ya no instala paquetes npm globalmente
Problema
La v1.3.0 intentaba hacer npm install -g lighthouse @axe-core/cli pa11y htmlhint durante la instalación, lo que causaba falsos positivos en antivirus y fallos de permisos en algunos sistemas.
Solución
El installer ahora solo verifica que npx esté disponible. Las herramientas se ejecutan automáticamente vía npx bajo demanda al momento de la auditoría — sin instalación global, sin permisos especiales, sin tocar el sistema.
Esto ya era el comportamiento del script principal (función resolve_cmd); el installer ahora es consistente con esa lógica.
Instalación
curl -sSL https://raw.githubusercontent.com/homium-tech/audit/main/install.sh | bashActualización
homium-audit --updatev1.3.0 — Installer auto-npm + bugfixes del reporte
¿Qué hay de nuevo?
🚀 Installer con auto-npm
install.sh ahora instala automáticamente todas las herramientas de análisis si node/npm está disponible — no más configuración manual después de instalar.
- Instala
lighthouse,@axe-core/cli,pa11yyhtmlhinten un solo paso - Verifica si ya están instalados antes de reinstalar
- No bloquea si un paquete falla — advierte y continúa
📸 Screenshots mejorados
- Usa
full-page-screenshotde Lighthouse (página completa, ~1280px de ancho) en lugar del thumbnail comprimido anterior - Fallback automático a
final-screenshotpara compatibilidad con versiones anteriores de Lighthouse
🐛 Bugs corregidos
| Bug | Detalle |
|---|---|
| Fecha en inglés | El reporte mostraba "June" en lugar de "junio" |
og:image inválida |
Descartaba valores no-URL como "website" que rompían el reporte |
| Recomendaciones vacías | Las líneas de protocolo y compresión en Performance aparecían en blanco cuando estaban OK |
| Tabla seguridad | La fila "HTTPS Redirect" tenía 3 columnas en una tabla de 4 |
| Meta Pixel no detectado | Patrón ampliado a facebook.net y connect.facebook |
| Matriz de priorización | La numeración saltaba números cuando ítems previos estaban OK — ahora es secuencial |
Instalación
curl -sSL https://raw.githubusercontent.com/homium-tech/audit/main/install.sh | bashActualización
homium-audit --update