WU CLI

WU CLI crea y opera proyectos de microfrontends con un shell y aplicaciones de distintos frameworks. Escribe el scaffold, agrega dependencias, sirve fuentes durante el desarrollo y reúne los builds en un artefacto publicable. El ejecutable está escrito en Zig; el paquete npm incluye un launcher Node y binarios por plataforma.

Usa @wu-framework/cli para administrar el proyecto y wu-framework como runtime de las aplicaciones. Las plantillas solicitan wu-framework: ^3.0.1. Esta referencia describe los comandos y archivos de la implementación del repositorio; consulta wu --version para identificar el ejecutable que utilizas.

Empezar con Astro, React y Vue

npm install -g @wu-framework/cli
wu create conocimiento --template react --shell astro
cd conocimiento
wu add vue explorador --no-install
wu install
wu dev --no-open

El modo rápido de create genera archivos sin instalar. add --no-install permite sumar apps antes de realizar una instalación conjunta. Astro construye el shell y las microapps se registran en WU; no se convierten automáticamente en islas Astro.

El paquete npm declara Node >=20. Para compilar esta CLI desde el código se necesita Zig >=0.16.0. Las toolchains de las aplicaciones tienen sus propios requisitos, que deben comprobarse al elegir versiones.

Comandos implementados

| Comando | Uso | | --- | --- | | wu create [nombre] | Asistente interactivo | | wu create <nombre> --template <fw> [--shell <fw>] | Scaffold reproducible sin instalación | | wu add <fw> <nombre> [--no-install] | Añade una microapp | | wu install, wu i | Agrega dependencias e instala con npm | | wu dev | Desarrollo nativo; admite puerto, apertura y selección --vite | | wu build | Construye y reúne dist/ | | wu serve [puerto] [--mode <modo>] | Páginas estáticas o rutas del cliente; 404 y caché coherentes | | wu doctor [--json] [--url URL] | Diagnóstico local y remoto con salida estructurada | | wu contracts types/check | Tipos y compatibilidad desde definiciones compartidas | | wu test [opciones] | Pruebas Node y conformance del proyecto | | wu info | Imprime la topología configurada o descubierta | | wu update | Actualización global gestionada por el launcher npm | | wu --version, wu --help | Versión y ayuda general |

La referencia completa incluye los alias y opciones exactos. No existen comandos públicos deploy, status, config ni remove en este dispatcher. Los argumentos de cada comando se procesan localmente; no hay una validación global uniforme de flags desconocidos.

Modelo de proyecto

wu.config.json declara shell, apps, comandos, puertos, proxy y política HTTP. Cada shell o app declara sus dependencias en su package.json; wu install escribe el agregado raíz. Cuando hacen falta versiones distintas, .wu-deps.json vincula overrides con directorios.

En desarrollo nativo, WU expone un origen HTTP y resuelve módulos por rutas. Para compilar JSX, TypeScript y otros frameworks utiliza herramientas Node, habitualmente mediante un daemon persistente. «Un puerto» no significa que todas las combinaciones funcionen sin Node ni con un único proceso del sistema.

wu build ejecuta las toolchains del proyecto y reúne entradas, catálogos, CSS y manifiestos. wu serve permite revisar esa salida. Para publicar en un host externo se distribuye dist/ y se aplica la configuración de rutas/cabeceras apropiada del host.

Manual

• Visión general y comandos
• Instalación, binarios y actualización
• Crear proyectos
• Añadir y retirar microapps
• Configuración y descubrimiento
• Desarrollo y recarga
• Dependencias y versiones por app
• Build de producción
• Servir y desplegar
• Doctor y troubleshooting
• Política HTTP y seguridad
• Arquitectura y pruebas
• Plantillas y composición políglota
• Referencia completa de comandos, opciones y errores

Comportamientos que debes conocer

| Comportamiento | Cómo trabajar con él | | --- | --- | | JSX y TypeScript utilizan herramientas Node | Instala las dependencias antes de iniciar wu dev | | serve escucha en loopback | Pasa el puerto como argumento posicional y configura por separado el host de publicación | | Doctor comprueba HTTP en el puerto 3000 | Usa ese puerto para validar D8 y consulta su informe completo | | install regenera el manifiesto raíz | Declara dependencias en shell/apps y conserva automatizaciones propias fuera de los campos regenerados | | Astro y Next son targets de shell | Elige un target CSR para --template y Astro o Next para --shell |

El resumen de doctor devuelve código 1 cuando registra problemas. Algunas distribuciones anteriores terminan con 0 incluso ante hallazgos; antes de usarlo como condición de CI, comprueba el contrato de salida y compatibilidad de binarios. La referencia del repositorio no garantiza que todos los paquetes distribuidos incorporen al mismo tiempo cada corrección.

La CLI dispone de trece targets de microapps. La matriz de plantillas explica los adaptadores y el alcance de cada scaffold: Stencil genera un custom element directamente, y el shell Astro/Next utiliza salida estática.

Desarrollar la CLI

zig build
zig build test --summary all
npm test

Los tests Zig, las invariantes, las pruebas Node y los smokes de navegador validan contratos distintos. Un cambio de plantilla debe verificarse montando e interactuando con la aplicación generada. El agregador de src/main.zig determina qué módulos de tests Zig se analizan.

Consulta CONTRIBUTING.md antes de modificar implementación. El historial conserva hechos de versiones anteriores; el manual define los contratos de la implementación.

Contract tooling and project tests · Remote doctor