Docs

Pull requests

Solo en Sypnia Cloud: cómo abre Sypnia un pull request con el arreglo, qué trae, qué puede hacer la GitHub App, qué nunca hace y los límites por plan.

Aplica a Nube Al lanzar

Ver como Markdown
En esta página
  1. Antes de empezar
  2. Cuándo se puede abrir un pull request
  3. Qué pasa
  4. Sypnia lee el repositorio
  5. Escribe el cambio y una prueba
  6. Abre el pull request
  7. Corren tus comprobaciones, una persona revisa
  8. Después del merge
  9. Qué trae el pull request
  10. Qué puede hacer la GitHub App
  11. Qué nunca hace
  12. Cuando no puede
  13. Límites por plan

Nube En Sypnia Cloud, un problema puede llegar con su arreglo como pull request. Sypnia escribe el cambio y una prueba en una rama de tu repositorio y abre el pull request. Una persona lo lee y hace el merge. Sypnia nunca hace merge.

El motor de código abierto no abre pull requests. Ahí, pásale el arreglo a tu propio agente de código con el prompt o el servidor MCP. Es la misma información.

Antes de empezar

  • El proyecto está conectado a un repositorio por la GitHub App de Sypnia. Mira La GitHub App para instalarla y elegir repositorios.
  • Tu app envía su release como el commit de git, así Sypnia sabe qué código estaba corriendo. Mira Versiones y source maps.

Cuándo se puede abrir un pull request

CondiciónPor qué
El análisis está en ready con confianza high o mediumSypnia no escribe un arreglo que no puede justificar. Con low, o not_enough_evidence, el botón está apagado y dice por qué
El problema está abiertoUn problema resuelto o ignorado no necesita arreglo
El problema no tiene un pull request abierto de SypniaUno a la vez por problema
A la organización le quedan arreglos este mesMira los límites abajo

Entonces se abre de una de dos formas:

  • Tú lo pides. El botón «Abrir pull request» en el problema, o POST /v1/problems/{problem}/pull-request.
  • Solo, si lo enciendes: el ajuste del proyecto agent.auto_pull_requests en high_confidence abre uno por cada análisis con confianza high. Viene apagado.

Qué pasa

  1. Sypnia lee el repositorio

    Por la GitHub App, en el commit de la versión donde ocurre el problema. Lee los archivos que nombra el análisis y los que están alrededor. Tu código se usa para este pull request y no se guarda después.

  2. Escribe el cambio y una prueba

    El cambio más pequeño que quita la causa, y una prueba que falla sin él, en el framework de pruebas de tu proyecto. Si el proyecto no tiene pruebas, el pull request trae solo el cambio y lo dice.

  3. Abre el pull request

    En una rama nueva llamada sypnia/<slug del problema>, por ejemplo sypnia/pay-button-does-nothing, contra tu rama principal.

    Deberías ver
    En pocos minutos el problema muestra el pull request, y se envía el webhook problem.pull_request_opened.
  4. Corren tus comprobaciones, una persona revisa

    Sypnia no corre tu código. Tu propio CI corre sobre el pull request, como en cualquier otro. Tú lo lees, pides cambios o lo cambias tú, y haces el merge.

  5. Después del merge

    Cuando el arreglo esté desplegado, marca el problema como resuelto, o deja que lo haga tu agente de código. Si la falla vuelve, el problema se reabre solo.

Qué trae el pull request

ParteContenido
TítuloLo que hace el cambio, en imperativo: «Read the cart total from its new field»
DescripciónLa frase del problema, a quién afectó y desde cuándo; la causa con su evidencia; qué se cambió y por qué; cómo lo cubre la prueba; enlaces al problema y a una sesión con grabación; la confianza
CommitsUno para el cambio, uno para la prueba, con autor sypnia[bot]
ArchivosSolo los que necesita el arreglo. Nunca archivos de workflows, archivos de bloqueo ni configuración de tu CI

La descripción nunca trae nombres, correos ni ids de las personas afectadas.

Qué puede hacer la GitHub App

La app pide tres permisos, en los repositorios que tú eliges y en ningún otro.

PermisoAccesoPara qué
ContentsLectura y escrituraLeer el código; subir la rama sypnia/<slug del problema>
Pull requestsLectura y escrituraAbrir el pull request y actualizar su descripción
MetadataLecturaLo exige GitHub para cualquier app: el nombre del repositorio y su rama principal

Qué nunca hace

  • Nunca hace merge de un pull request, y nunca aprueba uno.
  • Nunca sube cambios a tu rama principal ni a una rama que no creó. Nunca fuerza un push sobre commits de otra persona.
  • Nunca cambia workflows, secretos, ajustes, colaboradores ni la protección de ramas. No tiene permiso para hacerlo.
  • Nunca abre más de un pull request a la vez para un problema, y nunca reabre uno que cerraste.
  • Nunca corre tu código ni tus pruebas.

Protege tu rama principal en GitHub para que todo pull request necesite una revisión. Los de Sypnia siguen entonces la misma regla que los de cualquiera.

Cuando no puede

Qué vesPor qué
El botón apagado: «No hay evidencia suficiente para escribir un arreglo»El análisis no tiene causa, o su confianza es low
El botón apagado: «Conecta un repositorio»El proyecto no tiene repositorio por la GitHub App
failed, con una razón, en el problemaSypnia leyó el código y no pudo escribir un cambio en el que confíe: el código de ese commit no coincide con el análisis, o el arreglo tocaría más de lo debido. No se abrió nada y no contó contra tu límite
El pull request está abierto y tus comprobaciones fallanSypnia no reintenta por su cuenta. Arréglalo en la rama, o ciérralo y pide otro

Límites por plan

Un pull request cuenta cuando se abre. Pedir otro para el mismo problema cuenta otra vez. La cuenta es por organización, por mes calendario en UTC.

PlanPull requests que Sypnia abre al mes
Free5
Builder50
Team300

Estos números salen de los planes y los muestra, con lo que llevas usado, GET /v1/usage. En el límite, el botón dice cuándo se reinicia la cuenta; el análisis y el prompt siguen funcionando.

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar