Laravel Vitals v1.3
Star Install
Changelog

Versiones

Versionado con semver. La rama 1.x solo recibirá cambios no disruptivos — los cambios disruptivos irán a 2.x con una guía de migración. Suscríbete al feed RSS o sigue las versiones de GitHub.

función
v1.3.0
26 de julio de 2026

Servidor MCP + asesor de índices de BD

Dos funciones que hacen que Vitals actúe sobre tu app: un servidor MCP para que los agentes de IA lean y ejecuten auditorías, y un asesor de índices que convierte las consultas lentas capturadas en migraciones de índices listas para pegar.

Servidor MCP para agentes de IA
  • · Un servidor [Model Context Protocol](https://modelcontextprotocol.io) integrado (vitals), con tecnología de laravel/mcp, con tres herramientas: latest_audit (puntuaciones, Core Web Vitals, telemetría backend), list_recommendations (hallazgos priorizados con sus referencias archivo:línea) y run_audit.
  • · Registrado automáticamente como servidor stdio local; endpoint HTTP opcional vía vitals.mcp.web_route. Configurado bajo vitals.mcp. _laravel/mcp es pre-1.0; su superficie de herramientas puede evolucionar._
Asesor de índices de BD
  • · Lee las consultas lentas que la telemetría backend ya captura, analiza en estático las columnas filtradas / unidas / ordenadas, y emite una recomendación missing-index con una migración Schema::table(...)->index(...) lista para pegar.
  • · Estático y consultivo por diseño — nunca ejecuta el SQL, nunca migra, omite las tablas vitals_* del paquete y valida contra el esquema real para no producir falsos positivos. Conmutable con VITALS_DB_ADVISOR_ENABLED.
función
v1.2.0
26 de julio de 2026

Preparación para agentes

Una nueva categoría «Preparación para agentes» en el motor de comprobaciones SEO (8 comprobaciones, 30 en total) que mide si los agentes de IA pueden leer y operar tus páginas — alineada con Lighthouse agentic-browsing y Cloudflare agent-ready.

Comprobaciones estáticas (cualquier driver)
  • · llms.txt presente y bien formado, bots de IA permitidos en robots.txt, sitemap detectable, nombres accesibles en elementos interactivos y estabilidad del diseño (CLS).
  • · Aparecen en su propia sección en /vitals/audits/{id}/seo y en el filtro por categoría de /vitals/seo, con pesos bajos para que un fallo del web emergente nunca distorsione tu puntuación SEO.
WebMCP mediante el driver Playwright
  • · Detecta la exposición de herramientas WebMCP declarativas e imperativas en una sesión de navegador — herramientas disponibles, formularios que exponen WebMCP declarativo y herramientas que declaran un esquema de entrada.
  • · La sonda se ejecuta en un contexto aislado tras la auditoría, por lo que nunca puede alterar el resultado de Lighthouse; en otros drivers estas comprobaciones pasan con la nota «no medido».
Configuración
  • · Desactiva el grupo con VITALS_SEO_AGENTIC_ENABLED=false, o comprobación por comprobación vía vitals.seo.disabled_checks. Los umbrales y la lista de bots de IA están en vitals.seo.agentic.
parche
v1.1.1
16 de junio de 2026

Refuerzo de PostgreSQL

Correcciones de portabilidad entre drivers reveladas por la nueva lane de CI de PostgreSQL.

Corregido
  • · La página de estado pública ya no se rompe en PostgreSQL — el cálculo de disponibilidad se reescribió como COUNT(DISTINCT DATE(...)), lo que además corrige un recuento erróneo de días activos.
  • · Las páginas de detalle de auditoría y la API JSON ahora devuelven 404 (no 500) para ids malformados en todos los drivers de base de datos.
parche
v1.1.0
16 de junio de 2026

PostgreSQL en CI

PostgreSQL es ahora un driver de base de datos de primera clase, cubierto por CI.

Corregido
  • · La vista SEO entre URLs ya no se rompe en PostgreSQL — la agregación MAX(uuid) se sustituyó por una reducción en PHP sobre las recomendaciones precargadas (una consulta menos, totalmente portable).
Añadido
  • · Una lane de CI dedicada a Postgres ejecuta toda la suite Pest contra postgres:16, para detectar problemas específicos de drivers antes de publicar.
estable
v1.0.0
22 de mayo de 2026

Primera versión estable

Un dashboard de auditoría de rendimiento nativo de Laravel, construido sobre Livewire 4 + Flux Free 2 + Tailwind 4, con soporte completo para Laravel 11 / 12 / 13.

Drivers de auditoría
  • · Auditorías Lighthouse con cuatro drivers intercambiables (local, playwright, pagespeed, stub). Cada uno devuelve puntuaciones de Rendimiento / Accesibilidad / Buenas prácticas / SEO más valores de métricas en bruto (LCP, INP, CLS, TTFB, FCP, TBT, Speed Index).
  • · Telemetría backend — número de consultas, tiempo de consulta, sospecha N+1, memoria máxima, vistas renderizadas, jobs despachados, eventos disparados, hits/misses de caché. Muestreado mediante una cabecera X-Vitals-Audit-Id firmada para no afectar nunca al tráfico de producción.
  • · Análisis de código — escáneres estáticos adjuntan referencias exactas archivo:línea a los hallazgos de Lighthouse leyendo vistas Blade, configuración de Vite y composer.json.
Interfaces
  • · /vitals — vista general con instantánea de salud y tendencias sparkline para todas las URLs monitorizadas.
  • · /vitals/urls y /vitals/urls/{id} — detalle por URL con historial de auditorías, puntuaciones promedio, filtro de período y alternador de métricas.
  • · /vitals/audits/{id} — detalle completo de auditoría con medidores de puntuación, tarjetas Core Web Vitals, desglose frontend ↔ backend, recomendaciones con color según gravedad.
  • · /vitals/issues — principales problemas, regresiones y todas las recomendaciones agrupadas por clave de auditoría.
  • · /vitals/seo — vista SEO multi-URL con desglose de comprobaciones personalizadas, comprobaciones más fallidas y filtro de categoría.
  • · /vitals/rum — Real User Monitoring con atribución INP (elemento + tipo de evento).
  • · /vitals/queries — baselines de consultas por ruta con detección N+1 y patrones SQL repetidos.
  • · /vitals/learn — base de conocimiento de cada problema detectable, navegable por categoría con fragmentos de código.
  • · /vitals/budgets — umbrales por métrica con historial de violaciones.
  • · Spotlight (Cmd/Ctrl+K) — búsqueda global entre auditorías, URLs, recomendaciones y entradas learn.
Subsistema de comprobaciones SEO
  • · 22 comprobaciones alineadas con las mejores prácticas de Google 2026 — Configuración (3), Contenido (5), Metadatos (7), Rendimiento (7).
  • · El accessor Audit::vitals_seo_score mezcla el SEO de Lighthouse (50%) con la tasa de aprobación ponderada de las comprobaciones personalizadas (50%), produciendo una puntuación más estricta de 0 a 100.
Real User Monitoring
  • · Directiva Blade @vitalsRum — ligera (~11 KB, gzip ~4 KB), usa web-vitals v4 con datos de atribución.
  • · Respetuosa con la privacidad: sin almacenamiento de IPs, sin fingerprinting.
  • · Atribución INP: extrae el selector objetivo + tipo de evento de la interacción más lenta para que corrijas el elemento correcto.
Ergonomía del desarrollador
  • · Abrir en editor — 11 presets de editores (VSCode, Cursor, PHPStorm, IntelliJ IDEA, Sublime Text, Atom, TextMate, MacVim, Emacs, Nova, Zed). Plantillas personalizadas via VITALS_EDITOR_URL_TEMPLATE.
  • · API JSON v1 — /vitals/api/v1/{audits,urls,recommendations} con paginación, filtrado por fecha y acceso protegido por la Gate viewVitals.
  • · Seeder de demo — php artisan vitals:demo rellena datos sintéticos para que el dashboard sea explorable antes de ejecutar auditorías reales.
Notificaciones
  • · Canales de email + Slack para los eventos Regresión detectada y Presupuesto violado.
  • · Los mensajes de Slack se organizan en hilos por URL — las regresiones posteriores responden al mensaje original.
i18n
  • · Interfaz completa en EN, FR, DE, ES — ~1 100 cadenas de traducción en páginas, componentes, recomendaciones, títulos/descripciones/pistas de comprobaciones SEO y tooltips.
Tema
  • · Paleta OKLCH nativa con acento rosa y escala de grises neutrales teñidos.
  • · Geist Sans + Geist Mono auto-alojados via @fontsource-variable.
  • · Modo claro + oscuro controlado por una clase .dark en <html>, persistido mediante el botón de la barra de navegación.
Tests
  • · 550+ pruebas Pest (unit + feature + integration) que cubren pipelines de auditoría, comprobaciones SEO, componentes Livewire, API JSON, notificaciones, captura de telemetría y evaluación de presupuestos. PHPStan nivel max, sin baseline.