Docs

Registro de cambios

Dónde se va a listar cada versión del motor, de los SDK, del paquete de MCP, de las skills y de Sypnia Cloud, cómo se escribe una entrada, y qué prometen los números de versión.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Versiones
  2. Cómo se lleva esta página
  3. Cómo se ve una entrada
  4. Qué prometen los números de versión
  5. Motor y Sypnia Cloud
  6. Seguir los cambios

Esta página es para quien actualiza Sypnia o quiere saber qué cambió. Cubre lo que se publica como software, el motor de código abierto, los SDK, @sypnia/mcp y las skills Motor, y lo que cambia en el servicio, Sypnia Cloud Nube.

Versiones

Todavía no hay versiones.

Cómo se lleva esta página

  • Una entrada por versión, la más nueva primero. Una versión que no cambió nada que puedas ver igual tiene una línea.
  • Escrita para quien actualiza, en palabras simples: qué cambió para ti, no qué cambió en el código.
  • El mismo día de la versión. Una versión sin su entrada no está terminada.
  • Nunca se reescribe. Un error en una entrada se corrige con una nota visible, no editando la historia.

Cada componente tiene su propia versión y sus propias entradas:

ComponenteLa versión se ve en
El motor y la Consolasypnia version, y el encabezado Sypnia-Version de cada respuesta de la API
@sypnia/browser, @sypnia/node, @sypnia/nextLa versión del paquete en tu package.json
@sypnia/mcpLa versión del paquete
Las skills de agenteLa versión del plugin
Sypnia CloudLas entradas llevan fecha. El servicio no tiene versión propia; corre una versión publicada del motor.

Cómo se ve una entrada

Cada entrada usa los mismos encabezados, en este orden, y omite los que están vacíos:

EncabezadoContiene
Qué hacer al actualizarLo que la actualización te pide. La mayoría de las versiones no pide nada. Siempre va primero, para que nadie lo pase por alto.
AgregadoCosas nuevas.
CambiadoCosas que se comportan distinto.
ArregladoErrores.
SeguridadArreglos de problemas de seguridad, con qué tan grave es cada uno y a qué versiones afecta.
ObsoletoCosas que todavía funcionan y se van a quitar en la siguiente versión mayor.
EliminadoCosas que ya no están. Solo en una versión mayor.

Una entrada, como se va a ver. La versión y los dos arreglos son una ilustración, no una versión real:

Markdown
## Motor 1.0.1 — <fecha>

### Qué hacer al actualizar
Nada. Corre `sypnia migrate`, y luego reemplaza el motor.

### Arreglado
- Una sesión que cruzaba la medianoche se contaba en los dos días en los números diarios.
- `sypnia doctor` reportaba como fallida la revisión del almacenamiento en un bucket con prefijo.

Cuando algo de la página Planeado se publica, su entrada lo dice y el punto sale de esa página.

Qué prometen los números de versión

Las versiones son tres números, mayor.menor.parche.

Un cambio enSignifica
Parche, de 1.0.0 a 1.0.1Solo arreglos. Se puede tomar de inmediato.
Menor, de 1.0 a 1.1Cosas nuevas. Nada de lo que usas deja de funcionar.
Mayor, de 1 a 2Algo se quitó o cambió de una forma que necesita tu atención. Se anuncia aquí con anticipación.

Dentro de la versión 1, esto solo agrega:

QuéLa promesaDónde está escrita
La API HTTP bajo /v1Endpoints nuevos, parámetros opcionales nuevos, campos nuevos y valores nuevos en las respuestas. Un cambio que rompa algo sería /v2, con /v1 funcionando al menos 12 meses más.Errores, límites, paginación
El esquema de eventosTipos de evento nuevos y campos nuevos. El motor conserva los campos que no conoce, así que un SDK más nuevo funciona con un motor más viejo.Esquema de eventos
La configuración del motorAjustes nuevos con su valor por defecto. Un ajuste que el motor no conoce es una advertencia en sypnia doctor, nunca una falla al arrancar, así que un ajuste viejo no detiene una actualización.Referencia de configuración
La base de datosLas migraciones solo agregan. Un motor más viejo funciona contra un esquema más nuevo, así que puedes volver atrás.Actualizaciones
Las herramientas de MCPHerramientas nuevas y campos nuevos en los resultados.Referencia de herramientas

Motor y Sypnia Cloud

El motor de Sypnia y Sypnia Cloud, comparados
Motor de SypniaCódigo abierto, en tu propia infraestructuraSypnia CloudServicio pago, con un plan gratis
Quién actualizaTú, cuando tú decidas. Ver Actualizaciones, respaldos y retención.Nosotros. Tú no haces nada.
Qué lees aquíCada versión del motor, y qué hacer al actualizar.Entradas con fecha para los cambios en la app, los planes y el servicio.
Los SDKTú eliges cuándo actualizar el paquete en tu app.Lo mismo: el SDK está en tu app, no en nuestro servicio.

Seguir los cambios

Hasta que se abran los repositorios, esta página es el lugar. Después, las publicaciones de cada repositorio llevan las mismas entradas, y puedes seguir un repositorio para enterarte de las nuevas.

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