# 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: el motor de Sypnia (código abierto, en tu propia infraestructura) y Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/reference/changelog/

Para agentes: La página del registro de cambios de Sypnia y sus reglas. Todavía no se ha publicado nada, así que no hay entradas. Cuando haya versiones: una entrada por versión, la más nueva primero, por componente (motor, SDK, @sypnia/mcp, skills, Sypnia Cloud), con encabezados fijos (Qué hacer al actualizar, Agregado, Cambiado, Arreglado, Seguridad, Obsoleto, Eliminado). Las versiones siguen el versionado semántico; dentro de la versión 1 la API, el esquema de eventos, la configuración y la base de datos solo agregan.

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]**.

> **Nota: Todavía no hay versiones**
>
> Sypnia se escribe empezando por la documentación: estos documentos son el contrato, y el código se está escribiendo para cumplirlos. No se ha publicado nada, así que esta página no tiene entradas. La primera será la versión 1.0.0 del motor y de los SDK. Lo que sigue es cómo se va a llevar la página.

## 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:

| Componente                                        | La versión se ve en                                                                                    |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| El motor y la Consola                             | `sypnia version`, y el encabezado `Sypnia-Version` de cada respuesta de la API                         |
| `@sypnia/browser`, `@sypnia/node`, `@sypnia/next` | La versión del paquete en tu `package.json`                                                            |
| `@sypnia/mcp`                                     | La versión del paquete                                                                                 |
| Las skills de agente                              | La versión del plugin                                                                                  |
| Sypnia Cloud                                      | Las 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:

| Encabezado                  | Contiene                                                                                                                        |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Qué hacer al actualizar** | Lo 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. |
| **Agregado**                | Cosas nuevas.                                                                                                                   |
| **Cambiado**                | Cosas que se comportan distinto.                                                                                                |
| **Arreglado**               | Errores.                                                                                                                        |
| **Seguridad**               | Arreglos de problemas de seguridad, con qué tan grave es cada uno y a qué versiones afecta.                                     |
| **Obsoleto**                | Cosas que todavía funcionan y se van a quitar en la siguiente versión mayor.                                                    |
| **Eliminado**               | Cosas 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:

```md
## 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](https://docs.sypnia.com/es/reference/planned) 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 en                 | Significa                                                                                       |
| ---------------------------- | ----------------------------------------------------------------------------------------------- |
| **Parche**, de 1.0.0 a 1.0.1 | Solo arreglos. Se puede tomar de inmediato.                                                     |
| **Menor**, de 1.0 a 1.1      | Cosas nuevas. Nada de lo que usas deja de funcionar.                                            |
| **Mayor**, de 1 a 2          | Algo 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 promesa                                                                                                                                                                                          | Dónde está escrita                                                                                    |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| La API HTTP bajo `/v1`     | Endpoints 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](https://docs.sypnia.com/es/api/errors-limits-pagination)               |
| El esquema de eventos      | Tipos 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](https://docs.sypnia.com/es/reference/event-schema)                               |
| La configuración del motor | Ajustes 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](https://docs.sypnia.com/es/self-hosting/configuration)                  |
| La base de datos           | Las migraciones solo agregan. Un motor más viejo funciona contra un esquema más nuevo, así que puedes volver atrás.                                                                                 | [Actualizaciones](https://docs.sypnia.com/es/self-hosting/upgrades-backups-retention#actualizaciones) |
| Las herramientas de MCP    | Herramientas nuevas y campos nuevos en los resultados.                                                                                                                                              | [Referencia de herramientas](https://docs.sypnia.com/es/mcp/tools-reference)                          |

## Motor y Sypnia Cloud

|                 | Motor de Sypnia (código abierto, en tu propia infraestructura)     | Sypnia Cloud (servicio pago, con un plan gratis)                         |
| --------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| Quién actualiza | Tú, 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 SDK         | Tú 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.
