@open-mova/cli 0.1.20 → 0.1.21

package/dist/application/shell-configuration.js

@@ -14,12 +14,14 @@ function renderApplicationConfiguration(configuration) {
     path: ${JSON.stringify(microfrontend.route)},
     remote: ${JSON.stringify(microfrontend.remoteName)},
     exposedModule: './Routes',
+    requiredCoreVersion: ${JSON.stringify(microfrontend.compatibility.requiredCoreVersion)},
   },`)
         .join('\n');
     return `export interface MicrofrontendDefinition {
   readonly path: string;
   readonly remote: string;
   readonly exposedModule: './Routes';
+  readonly requiredCoreVersion: string;
 }
 
 // Este fichero lo mantiene el CLI a partir de mova.config.json.

package/dist/application/shell-repository.d.ts

@@ -1,4 +1,4 @@
-export declare const SHELL_REPOSITORY = "https://github.com/rgarciadelongoria/open-mova.git";
+export declare const SHELL_REPOSITORY: string;
 export declare const DEMO_MICROFRONTEND_REMOTE_ENTRY = "https://rgarciadelongoria.github.io/open-mova/remoteEntry.json";
 export interface ShellVersion {
     readonly repository: string;

package/dist/application/shell-repository.js

@@ -1,8 +1,8 @@
 import { spawnSync } from 'node:child_process';
-import { cpSync, existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { cpSync, existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { basename, join } from 'node:path';
 import { tmpdir } from 'node:os';
-export const SHELL_REPOSITORY = 'https://github.com/rgarciadelongoria/open-mova.git';
+export const SHELL_REPOSITORY = process.env['OPEN_MOVA_SHELL_REPOSITORY'] ?? 'https://github.com/rgarciadelongoria/open-mova.git';
 // El demo publicado permite probar una aplicación recién creada sin desplegar un MF propio.
 export const DEMO_MICROFRONTEND_REMOTE_ENTRY = 'https://rgarciadelongoria.github.io/open-mova/remoteEntry.json';
 const VERSION_PATTERN = /^v(\d+)\.(\d+)\.(\d+)$/;
@@ -41,9 +41,17 @@ export function downloadTaggedProject(project, destination, requestedVersion) {
     try {
         const checkout = join(temporaryDirectory, 'repository');
         runGit([
-            '-c', 'advice.detachedHead=false',
-            'clone', '--quiet', '--depth', '1', '--single-branch',
-            '--branch', version, SHELL_REPOSITORY, checkout,
+            '-c',
+            'advice.detachedHead=false',
+            'clone',
+            '--quiet',
+            '--depth',
+            '1',
+            '--single-branch',
+            '--branch',
+            version,
+            SHELL_REPOSITORY,
+            checkout,
         ]);
         const source = join(checkout, project);
         const requiredFiles = ['package.json', 'angular.json', 'src/main.ts'];
@@ -92,8 +100,7 @@ export function configureDownloadedShell(destination, applicationName, includesS
         writeFileSync(capacitorPath, customizedConfig);
     }
     writeFileSync(join(destination, '.nvmrc'), '22\n');
-    const installSteps = 'npm install\n' +
-        (includesStarterMicrofrontend ? 'npm --prefix mfs/home install\n' : '');
+    const installSteps = 'npm install\n' + (includesStarterMicrofrontend ? 'npm --prefix mfs/home install\n' : '');
     const runSteps = includesStarterMicrofrontend
         ? 'Inicia `npm --prefix mfs/home start` y `npm start` en dos terminales. Abre `http://localhost:4200/home/inicio`.\n'
         : 'Registra primero un MF con `mova mf create nombre` y después ejecuta `mova start`.\n';

package/dist/application/shell-update.d.ts

@@ -1,9 +1,6 @@
 import type { OpenMovaApplicationConfiguration } from '../types.js';
 import { type ShellVersion } from './shell-repository.js';
-interface FileChange {
-    readonly path: string;
-    readonly content?: Buffer;
-}
+import { type FileChange } from './project-update.js';
 export interface ShellUpdatePlan {
     readonly currentVersion: string;
     readonly target: ShellVersion;
@@ -16,4 +13,3 @@ export interface ShellUpdatePlan {
 }
 export declare function createShellUpdatePlan(applicationRoot: string, configuration: OpenMovaApplicationConfiguration, requestedVersion?: string): ShellUpdatePlan;
 export declare function applyShellUpdate(applicationRoot: string, configuration: OpenMovaApplicationConfiguration, plan: ShellUpdatePlan): void;
-export {};

package/dist/application/shell-update.js

@@ -1,10 +1,12 @@
-import { spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync, } from 'node:fs';
-import { dirname, join, relative } from 'node:path';
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
 import { tmpdir } from 'node:os';
 import { synchronizeShellConfiguration } from './shell-configuration.js';
 import { downloadShell, listShellVersions } from './shell-repository.js';
 import { writeApplicationConfiguration } from './configuration.js';
+import { applyFileChanges, compareManagedFiles, comparePackageConfiguration, requireCleanGitRepository, } from './project-update.js';
+import { findIncompatibleMicrofrontends } from './core-compatibility.js';
+import { readRequiredCoreVersion } from './microfrontend-manifest.js';
 const GENERATED_PATHS = new Set([
     'package.json',
     'package-lock.json',
@@ -34,8 +36,10 @@ export function createShellUpdatePlan(applicationRoot, configuration, requestedV
             throw new Error(`El commit registrado para ${configuration.shell.version} no coincide con el tag remoto.`);
         }
         const conflicts = [];
-        const fileChanges = compareManagedFiles(applicationRoot, currentDirectory, targetDirectory, conflicts);
+        const fileChanges = compareManagedFiles(applicationRoot, currentDirectory, targetDirectory, conflicts, GENERATED_PATHS);
         const packageUpdate = comparePackageConfiguration(applicationRoot, currentDirectory, targetDirectory, conflicts);
+        const targetCoreVersion = readRequiredCoreVersion(targetDirectory);
+        conflicts.push(...findIncompatibleMicrofrontends(configuration, targetCoreVersion));
         const capacitorUpdate = compareCapacitorConfiguration(applicationRoot, currentDirectory, targetDirectory, conflicts);
         const changes = [
             ...fileChanges.map((change) => `${change.content ? 'Actualizar' : 'Eliminar'} ${change.path}`),
@@ -65,16 +69,7 @@ export function applyShellUpdate(applicationRoot, configuration, plan) {
         throw new Error('No se puede actualizar mientras existan conflictos.');
     }
     requireCleanGitRepository(applicationRoot);
-    for (const change of plan.fileChanges) {
-        const destination = join(applicationRoot, change.path);
-        if (change.content) {
-            mkdirSync(dirname(destination), { recursive: true });
-            writeFileSync(destination, change.content);
-        }
-        else {
-            rmSync(destination, { force: true });
-        }
-    }
+    applyFileChanges(applicationRoot, plan.fileChanges);
     if (plan.packageContent) {
         writeFileSync(join(applicationRoot, 'package.json'), plan.packageContent, 'utf8');
     }
@@ -91,60 +86,6 @@ export function applyShellUpdate(applicationRoot, configuration, plan) {
     writeApplicationConfiguration(applicationRoot, updatedConfiguration);
     synchronizeShellConfiguration(applicationRoot, updatedConfiguration);
 }
-function compareManagedFiles(applicationRoot, currentDirectory, targetDirectory, conflicts) {
-    const paths = new Set([
-        ...listFiles(currentDirectory),
-        ...listFiles(targetDirectory),
-    ]);
-    const changes = [];
-    for (const path of [...paths].sort()) {
-        if (GENERATED_PATHS.has(path))
-            continue;
-        const currentContent = readOptionalFile(join(currentDirectory, path));
-        const targetContent = readOptionalFile(join(targetDirectory, path));
-        const applicationContent = readOptionalFile(join(applicationRoot, path));
-        if (buffersEqual(currentContent, targetContent))
-            continue;
-        if (buffersEqual(applicationContent, currentContent)) {
-            changes.push({ path, ...(targetContent ? { content: targetContent } : {}) });
-            continue;
-        }
-        if (buffersEqual(applicationContent, targetContent))
-            continue;
-        conflicts.push(path);
-    }
-    return changes;
-}
-function comparePackageConfiguration(applicationRoot, currentDirectory, targetDirectory, conflicts) {
-    const application = readJson(join(applicationRoot, 'package.json'));
-    const current = readJson(join(currentDirectory, 'package.json'));
-    const target = readJson(join(targetDirectory, 'package.json'));
-    let changed = false;
-    for (const section of ['scripts', 'dependencies', 'devDependencies']) {
-        const applicationSection = readStringMap(application[section]);
-        const currentSection = readStringMap(current[section]);
-        const targetSection = readStringMap(target[section]);
-        const keys = new Set([...Object.keys(currentSection), ...Object.keys(targetSection)]);
-        for (const key of keys) {
-            if (currentSection[key] === targetSection[key])
-                continue;
-            if (applicationSection[key] === currentSection[key]) {
-                if (targetSection[key] === undefined) {
-                    delete applicationSection[key];
-                }
-                else {
-                    applicationSection[key] = targetSection[key];
-                }
-                changed = true;
-            }
-            else if (applicationSection[key] !== targetSection[key]) {
-                conflicts.push(`package.json#${section}.${key}`);
-            }
-        }
-        application[section] = applicationSection;
-    }
-    return changed ? `${JSON.stringify(application, null, 2)}\n` : undefined;
-}
 function compareCapacitorConfiguration(applicationRoot, currentDirectory, targetDirectory, conflicts) {
     const applicationPath = join(applicationRoot, 'capacitor.config.ts');
     const currentPath = join(currentDirectory, 'capacitor.config.ts');
@@ -163,46 +104,6 @@ function compareCapacitorConfiguration(applicationRoot, currentDirectory, target
     conflicts.push('capacitor.config.ts');
     return undefined;
 }
-function requireCleanGitRepository(applicationRoot) {
-    const repository = spawnSync('git', ['-C', applicationRoot, 'rev-parse', '--is-inside-work-tree'], { encoding: 'utf8' });
-    if (repository.status !== 0) {
-        throw new Error('Inicializa Git y crea un commit antes de ejecutar mova update.');
-    }
-    const status = spawnSync('git', ['-C', applicationRoot, 'status', '--porcelain', '--untracked-files=all'], { encoding: 'utf8' });
-    if (status.status !== 0 || status.stdout.trim() !== '') {
-        throw new Error('El repositorio debe estar limpio antes de ejecutar mova update.');
-    }
-}
-function listFiles(directory) {
-    const files = [];
-    const visit = (currentDirectory) => {
-        for (const entry of readdirSync(currentDirectory, { withFileTypes: true })) {
-            const absolutePath = join(currentDirectory, entry.name);
-            if (entry.isDirectory()) {
-                visit(absolutePath);
-            }
-            else if (entry.isFile()) {
-                files.push(relative(directory, absolutePath));
-            }
-        }
-    };
-    visit(directory);
-    return files;
-}
-function readOptionalFile(path) {
-    return existsSync(path) ? readFileSync(path) : undefined;
-}
-function buffersEqual(first, second) {
-    return first === undefined ? second === undefined : second !== undefined && first.equals(second);
-}
-function readJson(path) {
-    return JSON.parse(readFileSync(path, 'utf8'));
-}
-function readStringMap(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        return {};
-    return { ...value };
-}
 function readCapacitorIdentity(content) {
     const appId = content.match(/\bappId:\s*['"]([^'"]+)['"]/)?.[1];
     const appName = content.match(/\bappName:\s*['"]([^'"]+)['"]/)?.[1];

package/dist/cli.js

@@ -4,6 +4,7 @@ import { Command } from 'commander';
 import { registerBuildCommand } from './commands/build.js';
 import { registerCapacitorCommands } from './commands/capacitor.js';
 import { registerCreateCommand } from './commands/create.js';
+import { registerDoctorCommand } from './commands/doctor.js';
 import { registerInfoCommand } from './commands/info.js';
 import { registerMicrofrontendCommands } from './commands/microfrontend.js';
 import { registerStartCommand } from './commands/start.js';
@@ -16,6 +17,7 @@ program
     .description('Herramientas de desarrollo para aplicaciones Open Mova')
     .version(packageVersion.version);
 registerCreateCommand(program);
+registerDoctorCommand(program);
 registerMicrofrontendCommands(program);
 registerStartCommand(program);
 registerShellCommands(program);

package/dist/commands/capacitor.js

@@ -1,11 +1,13 @@
 import { spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { readApplicationConfiguration, requireApplicationRoot, } from '../application/configuration.js';
+import { configureAndroidProject } from '../application/android-configuration.js';
 import { localBinaryName, npmCommand, useCommandShell } from '../utils/platform.js';
 export function registerCapacitorCommands(program) {
     const capacitor = program.command('cap').description('Prepara la shell para Android o iOS');
-    capacitor.command('add <platform>')
+    capacitor
+        .command('add <platform>')
         .description('Crea el proyecto nativo de la plataforma')
         .action((platform) => {
         const selectedPlatform = parsePlatform(platform);
@@ -14,7 +16,8 @@ export function registerCapacitorCommands(program) {
         runCapacitor(root, ['add', selectedPlatform]);
         configureNativePlatform(root, selectedPlatform, readApplicationConfiguration(root));
     });
-    capacitor.command('sync [platform]')
+    capacitor
+        .command('sync [platform]')
         .description('Compila la shell y sincroniza sus assets y plugins nativos')
         .action((platform) => {
         const root = requireApplicationRoot(process.cwd());
@@ -28,7 +31,8 @@ export function registerCapacitorCommands(program) {
             configureExistingPlatforms(root, readApplicationConfiguration(root));
         }
     });
-    capacitor.command('open <platform>')
+    capacitor
+        .command('open <platform>')
         .description('Abre el proyecto nativo en Android Studio o Xcode')
         .action((platform) => {
         const root = requireApplicationRoot(process.cwd());
@@ -79,95 +83,9 @@ function configureExistingPlatforms(root, configuration) {
 }
 function configureNativePlatform(root, platform, configuration) {
     if (platform === 'android') {
-        configureMinimumAndroidSdk(root);
-        configureBackgroundRunnerForAndroid(root);
-        configureGoogleMapsForAndroid(root, configuration);
+        configureAndroidProject(root, configuration);
     }
 }
-function configureGoogleMapsForAndroid(root, configuration) {
-    const packageJson = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
-    if (!packageJson.dependencies?.['@capacitor/google-maps'])
-        return;
-    const manifestPath = join(root, 'android', 'app', 'src', 'main', 'AndroidManifest.xml');
-    if (!existsSync(manifestPath)) {
-        throw new Error('No se encuentra AndroidManifest.xml para configurar Google Maps.');
-    }
-    const manifest = readFileSync(manifestPath, 'utf8');
-    const apiKeyMetadata = 'android:name="com.google.android.geo.API_KEY"';
-    if (!manifest.includes(apiKeyMetadata)) {
-        const applicationCloseTag = '</application>';
-        if (!manifest.includes(applicationCloseTag)) {
-            throw new Error('No se ha encontrado el elemento application en AndroidManifest.xml.');
-        }
-        const metadata = [
-            '        <meta-data',
-            `            ${apiKeyMetadata}`,
-            '            android:value="@string/open_mova_google_maps_api_key" />',
-        ].join('\n');
-        writeFileSync(manifestPath, manifest.replace(applicationCloseTag, `${metadata}\n    ${applicationCloseTag}`), 'utf8');
-    }
-    const valuesDirectory = join(root, 'android', 'app', 'src', 'main', 'res', 'values');
-    mkdirSync(valuesDirectory, { recursive: true });
-    const apiKey = process.env.OPEN_MOVA_GOOGLE_MAPS_ANDROID_API_KEY
-        ?? configuration.native?.googleMaps?.androidApiKey
-        // Google Maps aborta la aplicación si falta por completo esta entrada.
-        // El valor explícito permite arrancar; Maps seguirá requiriendo una clave real al usarse.
-        ?? 'OPEN_MOVA_GOOGLE_MAPS_API_KEY_NOT_CONFIGURED';
-    const resource = [
-        '<?xml version="1.0" encoding="utf-8"?>',
-        '<resources>',
-        `    <string name="open_mova_google_maps_api_key" translatable="false">${escapeXml(apiKey)}</string>`,
-        '</resources>',
-        '',
-    ].join('\n');
-    writeFileSync(join(valuesDirectory, 'open_mova_google_maps.xml'), resource, 'utf8');
-}
-function escapeXml(value) {
-    return value.replace(/[&<>"']/g, (character) => ({
-        '&': '&amp;',
-        '<': '&lt;',
-        '>': '&gt;',
-        '"': '&quot;',
-        "'": '&apos;',
-    })[character] ?? character);
-}
-function configureMinimumAndroidSdk(root) {
-    const packageJson = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
-    if (!packageJson.dependencies?.['@capacitor/local-llm'])
-        return;
-    const variablesPath = join(root, 'android', 'variables.gradle');
-    if (!existsSync(variablesPath)) {
-        throw new Error('No se encuentra android/variables.gradle para configurar Local LLM.');
-    }
-    const variables = readFileSync(variablesPath, 'utf8');
-    const minimumSdkPattern = /minSdkVersion\s*=\s*(\d+)/;
-    const currentMinimumSdk = Number(minimumSdkPattern.exec(variables)?.[1]);
-    if (!Number.isFinite(currentMinimumSdk)) {
-        throw new Error('No se ha encontrado minSdkVersion en android/variables.gradle.');
-    }
-    if (currentMinimumSdk >= 28)
-        return;
-    writeFileSync(variablesPath, variables.replace(minimumSdkPattern, 'minSdkVersion = 28'), 'utf8');
-}
-function configureBackgroundRunnerForAndroid(root) {
-    const packageJson = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
-    if (!packageJson.dependencies?.['@capacitor/background-runner'])
-        return;
-    const gradlePath = join(root, 'android', 'app', 'build.gradle');
-    if (!existsSync(gradlePath)) {
-        throw new Error('No se encuentra android/app/build.gradle para configurar Background Runner.');
-    }
-    const repositoryEntry = "dirs '../../node_modules/@capacitor/background-runner/android/src/main/libs', 'libs'";
-    const gradle = readFileSync(gradlePath, 'utf8');
-    if (gradle.includes(repositoryEntry))
-        return;
-    const flatDirectory = /flatDir\s*\{/;
-    if (!flatDirectory.test(gradle)) {
-        throw new Error('No se ha encontrado el bloque flatDir en android/app/build.gradle.');
-    }
-    const configuredGradle = gradle.replace(flatDirectory, (match) => `${match}\n        ${repositoryEntry}`);
-    writeFileSync(gradlePath, configuredGradle, 'utf8');
-}
 function runCapacitor(root, args) {
     if (!existsSync(join(root, 'capacitor.config.ts'))) {
         throw new Error('Esta versión de shell no incluye Capacitor. Usa una shell v0.1.2 o posterior.');

package/dist/commands/create.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, mkdtempSync, renameSync, rmSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { createMicrofrontend } from '../application/microfrontend.js';
-import { addMicrofrontend, writeApplicationConfiguration, } from '../application/configuration.js';
+import { addMicrofrontend, writeApplicationConfiguration } from '../application/configuration.js';
 import { synchronizeShellConfiguration } from '../application/shell-configuration.js';
 import { configureDownloadedShell, DEMO_MICROFRONTEND_REMOTE_ENTRY, downloadShell, } from '../application/shell-repository.js';
 import { normalizeName } from '../utils/names.js';
@@ -27,7 +27,7 @@ export function registerCreateCommand(program) {
             shellVersion = shell.version;
             configureDownloadedShell(temporaryApplication, applicationName, !options.empty);
             let configuration = {
-                schemaVersion: 1,
+                schemaVersion: 2,
                 name: applicationName,
                 shell,
                 microfrontends: [],

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerDoctorCommand(program: Command): void;

package/dist/commands/doctor.js

@@ -0,0 +1,25 @@
+import { inspectDevelopmentEnvironment } from '../application/doctor.js';
+const STATUS_SYMBOL = {
+    ok: '✓',
+    warning: '!',
+    error: '✗',
+};
+export function registerDoctorCommand(program) {
+    program
+        .command('doctor')
+        .description('Comprueba el entorno y la configuración de una aplicación Open Mova')
+        .action(() => {
+        const report = inspectDevelopmentEnvironment(process.cwd());
+        console.log('Diagnóstico de Open Mova');
+        for (const check of report.checks) {
+            console.log(`${STATUS_SYMBOL[check.status]} ${check.message}`);
+            if (check.detail)
+                console.log(`  ${check.detail}`);
+        }
+        const errors = report.checks.filter((check) => check.status === 'error').length;
+        const warnings = report.checks.filter((check) => check.status === 'warning').length;
+        console.log(`Resultado: ${errors} errores, ${warnings} avisos.`);
+        if (errors > 0)
+            process.exitCode = 1;
+    });
+}

package/dist/commands/info.js

@@ -1,5 +1,5 @@
 import { resolve } from 'node:path';
-import { findApplicationRoot, readApplicationConfiguration, } from '../application/configuration.js';
+import { findApplicationRoot, readApplicationConfiguration } from '../application/configuration.js';
 export function registerInfoCommand(program) {
     program
         .command('info')

package/dist/commands/microfrontend.js

@@ -4,6 +4,7 @@ import { addMicrofrontend, readApplicationConfiguration, requireApplicationRoot,
 import { synchronizeShellConfiguration } from '../application/shell-configuration.js';
 import { normalizeName } from '../utils/names.js';
 import { listShellVersions } from '../application/shell-repository.js';
+import { applyMicrofrontendUpdate, createMicrofrontendUpdatePlan, } from '../application/microfrontend-update.js';
 export function registerMicrofrontendCommands(program) {
     const microfrontend = program
         .command('mf')
@@ -21,7 +22,9 @@ export function registerMicrofrontendCommands(program) {
         const applicationRoot = requireApplicationRoot(process.cwd());
         const configuration = readApplicationConfiguration(applicationRoot);
         const normalizedName = normalizeName(name, 'El nombre del microfrontal');
-        const templateVersion = options.templateVersion ?? (options.demo ? configuration.shell?.version : undefined) ?? listShellVersions()[0];
+        const templateVersion = options.templateVersion ??
+            (options.demo ? configuration.shell?.version : undefined) ??
+            listShellVersions()[0];
         if (!templateVersion) {
             throw new Error('No hay tags estables disponibles para crear el microfrontal.');
         }
@@ -53,6 +56,7 @@ export function registerMicrofrontendCommands(program) {
         .option('--remote-entry <url>', 'URL del remoteEntry.json')
         .option('--port <number>', 'puerto de desarrollo para un proyecto local', parsePort)
         .option('--production-remote-entry <url>', 'URL HTTPS del remoto publicado')
+        .option('--core-version <range>', 'rango requerido de @open-mova/core')
         .action((sourcePath, options) => {
         const applicationRoot = requireApplicationRoot(process.cwd());
         const configuration = readApplicationConfiguration(applicationRoot);
@@ -64,6 +68,7 @@ export function registerMicrofrontendCommands(program) {
             remoteEntry: options.remoteEntry,
             port: options.port,
             productionRemoteEntry: options.productionRemoteEntry,
+            coreVersion: options.coreVersion,
         });
         const updatedConfiguration = addMicrofrontend(configuration, microfrontendConfiguration);
         writeApplicationConfiguration(applicationRoot, updatedConfiguration);
@@ -71,6 +76,40 @@ export function registerMicrofrontendCommands(program) {
         console.log(`Microfrontal "${microfrontendConfiguration.name}" registrado.`);
         console.log(`Ruta pública: /${microfrontendConfiguration.route}`);
     });
+    microfrontend
+        .command('update <name>')
+        .description('Actualiza un microfrontal creado desde la plantilla de Open Mova')
+        .option('--check', 'mostrar los cambios sin modificar archivos')
+        .option('--to <tag>', 'versión de destino, por ejemplo v0.2.1')
+        .action((name, options) => {
+        const applicationRoot = requireApplicationRoot(process.cwd());
+        const configuration = readApplicationConfiguration(applicationRoot);
+        const normalizedName = normalizeName(name, 'El nombre del microfrontal');
+        const plan = createMicrofrontendUpdatePlan(applicationRoot, configuration, normalizedName, options.to);
+        console.log(`Plantilla actual: ${plan.currentVersion}`);
+        console.log(`Plantilla destino: ${plan.target.version}`);
+        for (const change of plan.changes)
+            console.log(`- ${change}`);
+        if (plan.conflicts.length > 0) {
+            console.log('Conflictos que no se sobrescribirán:');
+            for (const conflict of plan.conflicts)
+                console.log(`- ${conflict}`);
+        }
+        if (options.check)
+            return;
+        if (plan.conflicts.length > 0) {
+            throw new Error('Resuelve los conflictos antes de actualizar el microfrontal.');
+        }
+        if (plan.changes.length === 0) {
+            console.log('El microfrontal ya está actualizado.');
+            return;
+        }
+        applyMicrofrontendUpdate(applicationRoot, configuration, plan);
+        console.log(`Microfrontal "${normalizedName}" actualizado a ${plan.target.version}.`);
+        if (plan.removePackageLock) {
+            console.log(`Ejecuta npm install en ${plan.projectRoot}.`);
+        }
+    });
 }
 function parsePort(value) {
     const port = Number(value);

package/dist/commands/update.js

@@ -1,5 +1,5 @@
-import { readApplicationConfiguration, requireApplicationRoot, } from '../application/configuration.js';
-import { applyShellUpdate, createShellUpdatePlan, } from '../application/shell-update.js';
+import { readApplicationConfigurationDocument, requireApplicationRoot, } from '../application/configuration.js';
+import { applyShellUpdate, createShellUpdatePlan } from '../application/shell-update.js';
 export function registerUpdateCommand(program) {
     program
         .command('update')
@@ -8,20 +8,29 @@ export function registerUpdateCommand(program) {
         .option('--to <tag>', 'versión de destino, por ejemplo v0.2.0')
         .action((options) => {
         const applicationRoot = requireApplicationRoot(process.cwd());
-        const configuration = readApplicationConfiguration(applicationRoot);
+        const document = readApplicationConfigurationDocument(applicationRoot);
+        const configuration = document.configuration;
         const plan = createShellUpdatePlan(applicationRoot, configuration, options.to);
         printPlan(plan);
+        if (document.migrations.length > 0) {
+            console.log('Migraciones de mova.config.json:');
+            for (const migration of document.migrations)
+                console.log(`- ${migration}`);
+        }
         if (options.check)
             return;
         if (plan.conflicts.length > 0) {
             throw new Error('Se han detectado archivos modificados. Resuelve los conflictos antes de actualizar.');
         }
-        if (plan.changes.length === 0) {
+        if (plan.changes.length === 0 && document.migrations.length === 0) {
             console.log('La aplicación ya está actualizada.');
             return;
         }
         applyShellUpdate(applicationRoot, configuration, plan);
         console.log(`Aplicación actualizada a ${plan.target.version}.`);
+        if (document.migrations.length > 0) {
+            console.log('mova.config.json se ha migrado al esquema actual.');
+        }
         if (plan.removePackageLock) {
             console.log('Ejecuta npm install para instalar dependencias y regenerar package-lock.json.');
         }

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 export interface OpenMovaApplicationConfiguration {
-    readonly schemaVersion: 1;
+    readonly schemaVersion: 2;
     readonly name: string;
     readonly shell?: {
         readonly repository: string;
@@ -24,6 +24,10 @@ export interface MicrofrontendConfiguration {
     readonly developmentRemoteEntry: string;
     readonly productionRemoteEntry?: string;
     readonly sourcePath?: string;
+    readonly compatibility: {
+        /** Rango de @open-mova/core declarado y publicado por el microfrontal. */
+        readonly requiredCoreVersion: string;
+    };
     readonly template?: {
         readonly repository: string;
         readonly version: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mova/cli",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "CLI para crear y mantener aplicaciones Open Mova",
   "license": "MIT",
   "author": "Open Mova contributors",
@@ -39,13 +39,17 @@
   "scripts": {
     "build": "tsc",
     "start": "tsx src/cli.ts",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && npm run test:unit",
+    "test:unit": "node --test test/*.test.mjs"
   },
   "dependencies": {
-    "commander": "^14.0.0"
+    "commander": "^14.0.0",
+    "semver": "^7.8.5"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
+    "@types/semver": "^7.8.0",
     "tsx": "^4.20.0",
     "typescript": "^5.9.3"
   }