> Esta traducción se ofrece por comodidad. El texto normativo es el original en inglés. # Migración desde v1 **Especificación del Meta-Universo** **ID del documento:** MU-V2-GUIDE-005 **Título:** Guía de migración del Meta-Universo v1.x a v2 **Clase de documento:** informativo **Versión:** 2.0 (borrador) **Estado:** borrador de trabajo **Referencias normativas:** MUC, MMAS, MUFP **Referencias informativas:** Repository-Structure, Create-a-New-Meta-Model, Federation-Guide **Copyright:** © Orkestron.AI **Licencia:** Apache-2.0 --- # 1. Propósito Esta guía explica cómo migrar repositorios y meta-modelos existentes del Meta-Universo v1.x a la arquitectura del Meta-Universo v2. La migración preserva el conocimiento histórico a la vez que alinea los repositorios con los principios constitucionales, arquitectónicos y de federación introducidos en v2. La migración es evolutiva, no disruptiva. --- # 1a. Tres niveles de migración La migración no es una sola operación. Ocurre en **tres niveles distintos**, que pueden avanzar a velocidades distintas y razonarse por separado: - **Migración estructural**: la *estructura del repositorio y de los documentos*: disposición de carpetas, organización de ficheros, identificadores y cabeceras de documento. Es la más visible y la más fácil de automatizar. - **Migración semántica**: la *terminología, los conceptos, las relaciones y las reglas*: cómo una Galaxia pasa a ser un Espacio de nombres, cómo un Objeto pasa a ser un Meta-Objeto, cómo se preservan los significados al cambiar los nombres. Aquí está la sustancia de la migración. - **Migración de federación**: *cómo el modelo interactúa con otros Universos*: adoptar Confianza, Vinculación de identidades, Correspondencias semánticas, Contratos y Sincronización de proyecciones para que el modelo migrado pueda participar en el ecosistema más amplio. La migración estructural mueve los ficheros; la semántica preserva el significado dentro de ellos; la de federación restablece cómo el modelo se relaciona con los demás. Una migración completa aborda las tres. ## 1a.1 Invariantes de la migración Sea cual sea el nivel, la migración: - es **trazable**: todo cambio puede seguirse desde su origen hasta su resultado; - es **explicable de forma reversible**: se registran la razón y el estado previo, de modo que un cambio pueda entenderse y, donde haga falta, revertirse; - **preserva la continuidad histórica**: las versiones y los Sucesos pasados siguen disponibles; - **no rompe la Identidad canónica**: las identidades sobreviven al traslado sin cambios; - **no cambia el significado en silencio**: todo cambio de significado se registra como un Suceso de migración explícito, nunca como un efecto colateral no anunciado de la reestructuración. La última invariante es la más importante: al cambio estructural se le permite ser silencioso; al semántico, no. El significado solo cambia mediante un suceso de migración declarado. --- # 2. Filosofía de la migración Se espera que la migración: - preserve la trazabilidad histórica; - evite la pérdida semántica; - minimice los cambios rompedores; - introduzca los conceptos nuevos de forma incremental; - preserve las identidades canónicas. La historia sigue siendo parte del repositorio. --- # 3. Cambios principales en v2 La versión 2 introduce: - la Constitución del Meta-Universo (MUC); - el Estándar de Arquitectura de Meta-Modelos (MMAS); - el Protocolo de Federación del Meta-Universo (MUFP); - la Arquitectura de referencia; - las especificaciones del ecosistema; - una organización estandarizada del repositorio. Estas incorporaciones amplían los conceptos previos en lugar de sustituirlos. --- # 4. Migración del repositorio Migración recomendada: 1. Archiva la estructura existente del repositorio v1. 2. Crea la disposición de directorios de v2. 3. Mueve los documentos históricos a `archive/v1/`. 4. Introduce los nuevos documentos de fundamento. 5. Añade las especificaciones constitucionales. 6. Añade las especificaciones de arquitectura. 7. Añade las especificaciones de federación. 8. Valida la coherencia del repositorio. Las publicaciones históricas siguen disponibles. --- # 5. Correspondencia de conceptos Evolución típica de los conceptos: - Galaxia → Espacio de nombres - Meta-Universo → Universo - Objeto existente → Meta-Objeto - Proyección existente → Proyección (sin cambios) - Identidad existente → Identidad canónica La evolución de los conceptos preserva la intención semántica. --- # 6. Migración de espacios de nombres Los espacios de nombres pasan a ser elementos arquitectónicos de primera clase. Los identificadores existentes pueden quedarse igual donde sean compatibles. La propiedad del espacio de nombres se vuelve explícita. --- # 7. Migración de la estructura del repositorio La documentación existente se reorganiza en: - 00-foundation - 01-constitution - 02-architecture - 03-federation - 04-core-concepts - 05-reference-architecture - 06-ecosystem - 07-guides La reorganización preserva la historia de los documentos. --- # 8. Migración de federación Los repositorios adoptan conceptos de MUFP, entre ellos: - el Modelo de confianza; - la Vinculación de identidades; - la Correspondencia semántica; - los Contratos de federación; - la Sincronización de proyecciones. La federación puede introducirse poco a poco. --- # 9. Validación Tras la migración, verifica: - la organización del repositorio; - los identificadores de documento; - la coherencia terminológica; - las convenciones de nombres; - las referencias entre documentos; - los metadatos de versión. La validación se automatiza siempre que sea practicable. --- # 10. Retrocompatibilidad El Meta-Universo v2 está diseñado para preservar la compatibilidad con los conceptos de v1 siempre que sea practicable. La terminología histórica puede permanecer dentro de los documentos archivados. Los documentos actuales usan la terminología de v2. --- # 11. Flujo de migración recomendado Secuencia sugerida: 1. Archivar 2. Reorganizar 3. Renombrar conceptos 4. Introducir MUC 5. Introducir MMAS 6. Introducir MUFP 7. Añadir la Arquitectura de referencia 8. Añadir el Ecosistema 9. Validar 10. Publicar Cada etapa sigue siendo trazable. --- # 12. Dificultades frecuentes de la migración Entre los problemas típicos están: - terminología duplicada; - identidades incoherentes; - trazabilidad ausente; - descripciones orientadas a la tecnología; - fronteras de dominio mezcladas. La migración antepone la coherencia semántica a la disposición de los documentos. --- # 13. Lista de comprobación de la migración Antes de publicar, verifica que: - el archivo está completo; - el repositorio sigue la estructura de v2; - la terminología está actualizada; - Espacio de nombres sustituye a Galaxia donde corresponda; - las referencias son válidas; - la validación pasa; - la historia se conserva. --- # 14. Evolución futura Los repositorios migrados a v2 están listos para: - publicarse en el registro; - generar la Matriz de compatibilidad; - la Certificación; - los Perfiles de federación; - la validación asistida por IA. La migración prepara los repositorios para una participación duradera en el ecosistema. --- # 15. Direcciones futuras Al nivel semántico de la migración le vendría bien un **Estándar de migración semántica (SMS)** dedicado. SMS formalizaría cómo se lleva el significado de una versión a otra: un vocabulario de Sucesos de migración, correspondencias legibles por máquina de conceptos viejos a nuevos, garantías de trazabilidad y reversibilidad, y reglas de conformidad que aseguren que ningún significado cambia sin un suceso de migración explícito y registrado. Con SMS en su sitio, la migración estructural y la semántica podrían validarse e incluso automatizarse en parte, manteniendo intactas la Identidad canónica y la continuidad histórica en todo un Universo. --- # Declaración final Migrar al Meta-Universo v2 es una evolución arquitectónica, no una reescritura. Al preservar el conocimiento histórico mientras se adoptan la gobernanza constitucional, la arquitectura estandarizada y la federación semántica, las organizaciones pueden modernizar repositorios existentes con una disrupción mínima y colocarlos en posición de interoperar a largo plazo dentro del creciente ecosistema del Meta-Universo.