Perpetual
Perpetual construye un gemelo local de tu app en cada push, reproduce flujos de negocio aprobados y reporta estado CI para bloquear merges si fallan. Usa Playwright, agentes LLM y servicios reales/sandbox.
Ficha actualizada 25 sept 2026, 23:35 · upstream 25 sept 2026, 23:33 · release sin release detectada
Qué es Perpetual
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Perpetual automatiza la validación de aplicaciones web mediante la creación de un entorno local idéntico (twin) que se reconstruye en cada commit a la rama objetivo. Utiliza Playwright para ejecutar flujos de usuario completos como 'registro → suscripción → uso de feature premium', asegurando que las funcionalidades críticas funcionen antes de permitir el merge.
El sistema combina agentes de IA para descubrir y generar código de pruebas, con un proceso riguroso de revisión humana: se aprueba el código tras tres ejecuciones exitosas y una prueba de control donde todas las escrituras están bloqueadas. Esto garantiza que las pruebas sean robustas y no dependan de simulaciones falsas.
Integra servicios reales (PostgreSQL, Stripe sandbox, Supabase) o emula proveedores mediante vercel-labs/emulate cuando no hay modo local oficial. El controlador corre localmente sin exponer credenciales ni requerir webhooks públicos, actuando como una puerta de seguridad que bloquea promociones si algún journey falla.
- Validar flujos críticos (checkout, registro) antes del merge en repositorios monorepo o multirepo
- Automatizar pruebas E2E con generación de código por IA y revisión humana aprobada
- Simular entornos de producción locales con servicios reales (Stripe, Supabase) sin exponer credenciales
- Integrar como requisito de protección de ramas en GitHub Actions mediante status checks personalizados
- Descubrir automáticamente flujos de negocio desde el código existente para crear pruebas end-to-end
- Generación automática de journeys con Playwright y revisión humana obligatoria (3 runs + control)
- Uso de servicios reales o sandbox oficiales (Stripe listen, Supabase local) sin mocks manuales
- Controlador local-first que no requiere webhooks públicos ni expone credenciales de producción
- Integración nativa con GitHub branch protection mediante status checks perpetual/<Stage>
- Licencia AGPL-3.0 compatible con despliegues privados y CI/CD internos sin restricciones adicionales
- Estado alpha 0.1: requiere configuración manual de cada twin y no soporta reparación automática de código tras cambios en la app
- No incluye GitHub App ni webhooks nativos; depende de CLI local o despliegue manual del controlador
- Requiere Node.js 24.12+, Docker Compose, uv y OpenRouter API key para funcionalidad completa
- Soporte experimental para sandbox de escritorio; no hay despliegues hosteados ni twins en producción aún
- Solo soporta aplicaciones web que puedan ejecutarse bajo Docker Compose con servicios específicos listados
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Node.js 24.12+, Docker Compose, uv y GitHub CLI autenticado. Clonar repositorio, ejecutar npm ci && npm run build, instalar Playwright Chromium. Iniciar con node src/cli.ts serve --repo /ruta/app. Configurar OpenRouter API key en Settings, conectar repositorio y crear entorno Beta. Añadir status check perpetual/Beta a reglas de protección de ramas. Primer build puede tardar minutos por descarga de imágenes e instalación de deps.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.