Perpetual-CI-CD
Perpetual-CI-CD es una herramienta open source que crea un gemelo local de tu aplicación en cada push para ejecutar pruebas de viaje de negocio reales. Bloquea los merges si los flujos críticos fallan, integrándose con GitHub Actions y Docker Compose sin necesidad de despliegues externos.
Ficha actualizada 24 sept 2026, 23:44 · upstream 24 sept 2026, 23:32 · release sin release detectada
Qué es Perpetual-CI-CD
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Perpetual-CI-CD es una herramienta open source diseñada para validar aplicaciones web mediante la ejecución de viajes de negocio (journeys) reales en un entorno local llamado "twin". En cada push a la rama objetivo, el sistema reconstruye una réplica completa de tu aplicación utilizando Docker Compose y servicios oficiales locales o sandboxes de proveedores como Stripe y Supabase. Un agente explora la aplicación para definir flujos críticos (ej. registro, suscripción) que un humano debe revisar antes de ejecutarlos.
El proceso actúa como una puerta de seguridad (gate) integrada en GitHub: si los viajes aprobados fallan al ejecutarse en el nuevo commit, el estado del commit se marca como fallido, impidiendo la promoción automática mediante reglas de protección de ramas. La herramienta opera bajo un modelo local-first, ejecutándose en tu máquina y consultando a GitHub mediante polling, sin exponer credenciales ni requerir webhooks públicos.
Está escrita con Node.js, Python y React, y utiliza Playwright para la exploración del navegador. Actualmente se encuentra en versión alpha 0.1 bajo licencia AGPL-3.0-only, lo que permite su uso interno pero exige compartir el código fuente si se modifica y se expone públicamente.
- Validar flujos de usuario críticos (ej. checkout) antes de cada merge
- Simular servicios externos reales mediante sandboxes oficiales sin mocks manuales
- Ejecutar pruebas E2E en un entorno idéntico al local sin desplegar en producción
- Integrar verificación de negocio real en reglas de protección de ramas de GitHub
- Descubrir y documentar flujos de negocio mediante exploración automática del navegador
- Utiliza sandboxes oficiales de proveedores (Stripe, Supabase) en lugar de mocks API
- Bloquea automáticamente los merges si los viajes de negocio aprobados fallan
- Operación local-first sin necesidad de webhooks ni despliegues públicos
- Exploración automática del navegador para definir flujos de prueba críticos
- Soporte nativo para múltiples bases de datos (PostgreSQL, MongoDB, Redis) vía Docker Compose
- Versión alpha 0.1 con funcionalidades experimentales como el sandbox de escritorio
- Requiere configuración manual inicial (Docker Compose, uv, GitHub CLI)
- No soporta webhooks nativos, utiliza polling para consultar estado de repositorios
- Necesita API key de OpenRouter para la capa de inteligencia artificial
- Solo funciona con aplicaciones que pueden ejecutarse bajo Docker Compose
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 22+, Docker con Compose, uv, GitHub CLI autenticado y una API key de OpenRouter. Clona el repositorio, instala dependencias (`npm ci`, `uv sync`) e inicia el servidor local con `node src/cli.mjs serve --repo`. Configura la clave en Settings, conecta el repositorio y crea un entorno Beta. El primer build puede tardar varios minutos. No despliega a producción; se ejecuta localmente o en CI si se configura el entorno adecuadamente.
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.