Documentación pública · v1.0.0

09 · Publicación

MSD-09-PUB · Publicación

Una plataforma para desarrolladores solo está completa cuando puede distribuirse, instalarse y mantenerse de forma oficial.

Toda la operación. Una sola plataforma.

Objetivo del capítulo

Definir el proceso oficial de publicación, distribución y mantenimiento de los artefactos para desarrolladores de Roustix: documentación, OpenAPI, SDK, CLI y colecciones.

MSD-09 establece el ciclo de vida del ecosistema de desarrollo, garantizando que todos los componentes evolucionen de forma sincronizada con MAG y con cada versión de la plataforma.

1 · Filosofía

Publicar no es subir archivos.

Es distribuir un ecosistema coherente.

Cada versión de Roustix debe publicar simultáneamente:

Código / MAG
      │
      ▼
   OpenAPI
      │
      ▼
     SDK
      │
      ▼
     CLI
      │
      ▼
Colecciones
      │
      ▼
Developer Portal

Toda la documentación debe representar exactamente el estado de la plataforma.

2 · Artefactos oficiales

Cada versión publica los siguientes componentes:

Artefacto	Estado documental	Estado distribución
OpenAPI 3.1	✅ Oficial	🟢 `openapi.v1.yaml` · `/api/v1/openapi.json`
SDK Python	✅ Estrategia MSD-04	📋 PyPI pendiente
SDK JavaScript	✅ Estrategia MSD-04	📋 npm pendiente
SDK PHP	✅ Estrategia MSD-04	📋 Packagist pendiente
Roustix CLI	✅ Estrategia MSD-05	📋 PyPI pendiente
Colección Postman	✅ Snapshot v1	🟢 `docs/api/collections/`
Colección Insomnia	✅ Snapshot v1	🟢 `docs/api/collections/`
Developer Portal	✅ MSD-02	🟡 `/msd/` · 📋 `developer.roustix.app`

Todos siguen el mismo número de versión del ecosistema cuando se publiquen paquetes (1.x ↔ MAG v1).

3 · Plataformas de publicación

Artefacto	Plataforma
SDK Python	PyPI (`roustix`)
SDK JavaScript	npm (`@roustix/sdk`)
SDK PHP	Packagist (`roustix/sdk`)
CLI	PyPI (`roustix-cli`)
OpenAPI	Repositorio + `GET /api/v1/openapi.json`
Colecciones	`docs/api/collections/` + Portal
Documentación	Developer Portal · Roustix Docs

4 · Versionado

Todos los componentes siguen el contrato definido en MAG-07:

Componente	Versionado
API	MAG v1
OpenAPI	v1 (`info.version: 1.0.0`)
SDK	1.x
CLI	1.x
Colecciones	v1 (`Roustix API v1`)
MSD (docs)	v1.0.0

No pueden existir SDK o CLI oficiales incompatibles con la versión vigente de MAG.

5 · Flujo de publicación

Nueva versión Roustix
          │
          ▼
   Actualizar MAG
          │
          ▼
   Generar OpenAPI
          │
          ▼
    Generar SDK
          │
          ▼
    Generar CLI
          │
          ▼
 Generar colecciones
          │
          ▼
Publicar Developer Portal
          │
          ▼
   Release oficial

El flujo garantiza que todos los artefactos permanezcan sincronizados.

6 · Integración continua

La publicación forma parte del pipeline CI/CD (objetivo operativo MSD v1.0):

Cada release ejecuta automáticamente:

validación OpenAPI (Spectral · Prism)
pruebas del SDK
pruebas de la CLI
generación de colecciones
despliegue del Portal
publicación de documentación

Solo si todas las verificaciones son exitosas se realiza la publicación.

Etapa	Herramienta
Lint OpenAPI	Spectral
Contract tests	Prism · sandbox
SDK tests	pytest · jest · phpunit
Colecciones	openapi2postmanv2
Portal	deploy estático / CDN

Estado: pipeline documentado · automatización en roadmap post MSD v1.0 doc.

7 · Changelog

Cada publicación incorpora un historial de cambios.

Ejemplo:

Roustix SDK 1.2.0

+ Nuevo módulo Inventory
+ Nuevos endpoints Work Orders
+ Correcciones CLI
+ Mejoras OpenAPI

Los cambios incompatibles solo aparecen en nuevas versiones mayores (MAG v2 · SDK 2.x).

Fuentes oficiales:

MSD changelog
MAG changelog
Changelog en Developer Portal

8 · Compatibilidad

Todos los artefactos mantienen compatibilidad con la misma versión de la API:

MAG v1
│
├── OpenAPI v1
├── SDK 1.x
├── CLI 1.x
└── Colecciones v1

No se mezclan versiones mayores.

9 · Distribución

Los desarrolladores disponen de un único punto de acceso:

https://developer.roustix.app

Local (transitorio): http://127.0.0.1:5000/msd/

Desde el Portal pueden:

consultar la documentación
descargar OpenAPI
instalar SDK
instalar la CLI
descargar colecciones
acceder al Sandbox
revisar el changelog

El Portal es el centro del ecosistema para desarrolladores.

→ MSD-02 · Developer Portal

10 · Buenas prácticas

#	Regla
1	Publicar todos los artefactos conjuntamente
2	Mantener el mismo versionado entre componentes
3	No distribuir SDK generados manualmente
4	Validar OpenAPI antes de publicar
5	Actualizar la documentación en cada versión
6	Mantener un changelog completo
7	Automatizar el proceso mediante CI/CD

11 · Roadmap

Evolución prevista del ecosistema:

publicación automática en GitHub Releases
firma digital de paquetes
Docker oficial para el Sandbox
cliente MCP para IA y agentes
SDK para Go, Java y C#
Marketplace de integraciones
registro de plugins oficiales

Filosofía del capítulo

Una plataforma moderna no termina en su API. Su verdadero valor aparece cuando cualquier desarrollador puede descubrirla, instalar sus herramientas, integrarlas y mantenerlas con confianza.

MSD-09 cierra el ecosistema para desarrolladores de Roustix, unificando documentación, OpenAPI, SDK, CLI, Sandbox y Portal bajo un proceso de publicación coherente, automatizado y versionado.

MSD v1.0 · Índice completo

Código	Capítulo	Estado
MSD-01	Filosofía del ecosistema	✅
MSD-02	Developer Portal	✅
MSD-03	OpenAPI 3.1	✅
MSD-04	SDK oficiales	✅
MSD-05	CLI	✅
MSD-06	Sandbox y API Explorer	✅
MSD-07	Quick Start	✅
MSD-08	Colecciones Postman e Insomnia	✅
MSD-09	Publicación	✅

← 08 · Colecciones Contrato API →