@open-mova/cli 0.1.20 → 0.1.22

package/dist/commands/capacitor.js

@@ -1,11 +1,51 @@
 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 { diagnoseNativeCapabilities, disableNativeCapabilities, enableNativeCapabilities, listNativeCapabilities, } from '../application/native-capabilities.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('list')
+        .description('Lista las capacidades nativas disponibles y habilitadas')
+        .action(() => {
+        const root = requireApplicationRoot(process.cwd());
+        for (const { definition, enabled } of listNativeCapabilities(root)) {
+            console.log(`${enabled ? '✓' : '○'} ${definition.name} (${definition.platforms.join(', ')})`);
+        }
+    });
+    capacitor
+        .command('enable <capabilities...>')
+        .description('Instala y habilita capacidades nativas en la aplicación')
+        .action((capabilities) => {
+        const root = requireApplicationRoot(process.cwd());
+        enableNativeCapabilities(root, capabilities);
+        synchronizeExistingNativeProjects(root);
+        console.log(`Capacidades habilitadas: ${capabilities.join(', ')}.`);
+    });
+    capacitor
+        .command('disable <capabilities...>')
+        .description('Deshabilita capacidades y elimina los plugins que ya no se usan')
+        .action((capabilities) => {
+        const root = requireApplicationRoot(process.cwd());
+        disableNativeCapabilities(root, capabilities);
+        synchronizeExistingNativeProjects(root);
+        console.log(`Capacidades deshabilitadas: ${capabilities.join(', ')}.`);
+    });
+    capacitor
+        .command('doctor [platform]')
+        .description('Muestra requisitos y configuración pendiente de las capacidades')
+        .action((platform) => {
+        const root = requireApplicationRoot(process.cwd());
+        const selectedPlatform = platform ? parsePlatform(platform) : undefined;
+        for (const message of diagnoseNativeCapabilities(root, selectedPlatform)) {
+            console.log(message);
+        }
+    });
+    capacitor
+        .command('add <platform>')
         .description('Crea el proyecto nativo de la plataforma')
         .action((platform) => {
         const selectedPlatform = parsePlatform(platform);
@@ -14,7 +54,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 +69,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());
@@ -77,96 +119,19 @@ function configureExistingPlatforms(root, configuration) {
         configureNativePlatform(root, 'android', configuration);
     }
 }
-function configureNativePlatform(root, platform, configuration) {
-    if (platform === 'android') {
-        configureMinimumAndroidSdk(root);
-        configureBackgroundRunnerForAndroid(root);
-        configureGoogleMapsForAndroid(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.');
+function synchronizeExistingNativeProjects(root) {
+    const platforms = ['android', 'ios'];
+    for (const platform of platforms) {
+        if (existsSync(join(root, platform))) {
+            runCapacitor(root, ['sync', platform]);
+            configureNativePlatform(root, platform, readApplicationConfiguration(root));
         }
-        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.');
+function configureNativePlatform(root, platform, configuration) {
+    if (platform === 'android') {
+        configureAndroidProject(root, configuration);
     }
-    const configuredGradle = gradle.replace(flatDirectory, (match) => `${match}\n        ${repositoryEntry}`);
-    writeFileSync(gradlePath, configuredGradle, 'utf8');
 }
 function runCapacitor(root, args) {
     if (!existsSync(join(root, 'capacitor.config.ts'))) {

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,9 +27,10 @@ export function registerCreateCommand(program) {
             shellVersion = shell.version;
             configureDownloadedShell(temporaryApplication, applicationName, !options.empty);
             let configuration = {
-                schemaVersion: 1,
+                schemaVersion: 3,
                 name: applicationName,
                 shell,
+                native: { capabilities: [] },
                 microfrontends: [],
             };
             if (!options.empty) {

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: 3;
     readonly name: string;
     readonly shell?: {
         readonly repository: string;
@@ -11,6 +11,8 @@ export interface OpenMovaApplicationConfiguration {
     readonly microfrontends: readonly MicrofrontendConfiguration[];
 }
 export interface NativeConfiguration {
+    /** Capacidades instaladas y proporcionadas por la shell. */
+    readonly capabilities: readonly string[];
     readonly googleMaps?: {
         /** Clave de Android Maps. También puede venir de OPEN_MOVA_GOOGLE_MAPS_ANDROID_API_KEY. */
         readonly androidApiKey?: string;
@@ -24,6 +26,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.22",
   "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"
   }