@wu-framework/cli 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -2,6 +2,77 @@
 
 Todos los cambios notables de wu-cli. Formato basado en [Keep a Changelog](https://keepachangelog.com/) y [SemVer](https://semver.org/).
 
+## [0.5.1] — 2026-08-29 — fiabilidad del desarrollo local
+
+### Corregido
+
+- El compilador Angular resuelve las hojas CSS importadas desde TypeScript sin
+  tratarlas como imports JavaScript, tanto en desarrollo como en HMR.
+- `wu dev` y `wu serve` rechazan de forma inmediata y legible un puerto ya
+  ocupado, incluido Windows, en vez de anunciar un servidor que no inició o
+  dejar dos procesos disputando el mismo listener.
+- `wu doctor` reconoce dependencias locales absolutas `file:C:/...` en Windows.
+- Los scaffolds conservan metadatos completos, usan estilos externos compatibles
+  con CSP y evitan HTML dinámico inseguro en el shell vanilla.
+- Las plantillas Vanilla, Svelte, Solid, Stencil, Alpine, HTMX y Stimulus usan
+  CSS externo y controles accesibles, sin atributos de estilo que la CSP de
+  producción termine bloqueando.
+- El scaffold Stimulus conserva el contrato `{ controllers, template }` que
+  consume su adapter; el controlador y sus acciones se mantienen aislados en
+  la configuración generada.
+- Alpine se genera con el runtime oficial `@alpinejs/csp` inyectado y un
+  proveedor aislado por app; HTMX se importa realmente, desactiva evaluación y
+  scripts inline mediante su meta-config previa al import, usa estilos de
+  indicadores externos y limpia sus listeners al desmontar.
+- Los proyectos nuevos fijan `wu-framework@^3.0.1`, la primera versión estable
+  que expone la inyección de runtime usada por estos scaffolds.
+
+## [0.5.0] — 2026-08-29 — alineación con wu-framework 3
+
+### Cambiado
+
+- Los proyectos nuevos usan la versión estable `wu-framework@^3.0.0`, declaran Node 20+ y
+  `wu doctor` detecta rangos de registro que todavía resuelven a V2.
+- Los shells generados conservan el objeto completo de cada micro-app al
+  inicializar Wu; ya no pierden `framework`, ownership DOM, grants ni
+  compatibilidad al recalcular su URL.
+- Los shells Vite nativos usan una hoja CSS externa compartida y el shell
+  vanilla construye sus nodos con DOM seguro. Esto elimina atributos `style`
+  dinámicos y concatenaciones `innerHTML` sin relajar la CSP de producción.
+- Cada shell incluye un favicon SVG real en `public/`; desarrollo ya no genera
+  un 404 por depender del icono implícito del navegador.
+- `wu install` conserva correctamente rutas `file:C:/...` y `file:C:\\...` en
+  Windows; antes las convertía en junctions relativos inválidos aunque npm
+  terminara con éxito. Las pruebas de `install.zig` ya forman parte de la suite
+  agregada y dejan de ser tests escritos que nunca se ejecutaban.
+- `wu doctor` reconoce esas mismas rutas absolutas de Windows y UNC como un
+  único destino en todos los `package.json`; ya no inventa rutas como
+  `shell/C:/...` ni contradice el resultado correcto de `wu install`.
+- Los listeners de `wu dev` y `wu serve` ya no solicitan `SO_REUSEADDR` ni
+  `SO_REUSEPORT`; además mantienen una lease de host/puerto entre procesos Wu
+  en Windows, donde el backend AFD de Zig acepta dos binds aun sin reuse. Un
+  segundo servidor termina con un error claro en vez de arrancar aparentemente
+  y repartir tráfico entre dos proyectos; `wu serve` sólo anuncia su URL
+  después de poseer realmente el puerto.
+- Las apps React generadas inyectan en el adapter el mismo runtime que compiló
+  el componente y esperan su registro. Esto evita dos copias de React en chunks
+  de producción y el fallo de hooks que sólo aparecía después de `wu build`.
+- El componente React inicial usa `App.css`, clases y controles accesibles en
+  lugar de objetos `style`; el scaffold funciona con la CSP estricta que el
+  propio `wu build` publica.
+- `apps[].grants` y `apps[].compatibility` forman parte del schema del CLI y se
+  propagan sin pérdida por desarrollo, build, `apps.json`, `wu-manifest.json` y
+  shells generados.
+- `wu build` fusiona el `wu.json` de la app con la entry final: conserva sus
+  solicitudes V3 y rechaza JSON malformado en lugar de borrarlo en silencio.
+- El launcher npm ya no ejecuta el binario al importarlo desde tests y vuelve a
+  despachar Linux ARM64, que se distribuía pero faltaba en su mapa de plataforma.
+
+### Pruebas
+
+- Cobertura para rangos V3/locales, rechazo de V2, persistencia de grants y
+  compatibilidad, y conservación de permisos en manifiestos de producción.
+
 ## [0.4.0] — 2026-08-27 — cabeceras, CSP generada y ficheros que no debían salir
 
 Todo lo de aquí sale de un informe de escaneo contra un sitio wu: `.env` servido, sin CSP, sin `X-Frame-Options`, `package.json` público, `Access-Control-Allow-Origin: *`. Nueve de los once hallazgos los producía wu, no el hosting.
@@ -252,4 +323,3 @@ Primera versión con el pipeline completo. (La 0.1.0, del 2026-02-27, fue el pri
 - Soporte inicial para 13 frameworks
 
 ---
-

package/README.md

@@ -32,7 +32,7 @@
 
 **Wu CLI** es un CLI + dev-server nativo en **Zig 0.16** para arquitecturas microfrontend ([wu-framework](https://www.wu-framework.com)). Reemplaza **N procesos Vite** (uno por micro-app) con **un único proceso en un solo puerto** que descubre, compila, sirve y hace HMR. Sin dependencias Zig, binario de ~250-460 KB por plataforma, distribuido vía npm.
 
-## Estado actual (código v0.4.0)
+## Estado actual (código v0.5.1)
 
 Las versiones de `package.json`, `src/main.zig` y `build.zig.zon` están
 sincronizadas y una invariante de CI evita que vuelvan a divergir. Consulta el
@@ -70,7 +70,8 @@ sincronizadas y una invariante de CI evita que vuelvan a divergir. Consulta el
 npm install -g @wu-framework/cli
 ```
 
-Requiere **Node.js 16+** para instalar. Node.js 18+ a runtime sólo si usas Vue, Svelte, Solid o Angular (React/Preact corren en Zig puro).
+Requiere **Node.js 20+**. El requisito coincide con wu-framework 3 y con las
+plantillas actuales de Astro, Next y Angular.
 
 ### Desde fuente
 
@@ -168,7 +169,14 @@ Referencia completa con todas las flags: **[docs/cli.md](docs/cli.md)**.
     "framework": "react"
   },
   "apps": [
-    { "name": "catalog", "dir": "mf-catalog", "framework": "react", "port": 5001 },
+    {
+      "name": "catalog",
+      "dir": "mf-catalog",
+      "framework": "react",
+      "port": 5001,
+      "grants": ["events.emit:catalog:*", "events.subscribe:catalog:*"],
+      "compatibility": "strict"
+    },
     { "name": "cart",    "dir": "mf-cart",    "framework": "vue",   "port": 5002 }
   ],
   "shared": ["react", "react-dom", "react-dom/client"],
@@ -180,6 +188,10 @@ Referencia completa con todas las flags: **[docs/cli.md](docs/cli.md)**.
 }
 ```
 
+En wu-framework 3, `grants` es autoridad del shell y se cruza con lo que cada
+app solicita en `wu.json`; declarar un grant que la app no pidió no le concede
+nada. `compatibility: "v2"` es un puente temporal por app, no el nuevo default.
+
 Si no existe, `wu` auto-descubre micro-apps escaneando subdirectorios con `vite.config.*` + `package.json`. El directorio llamado **`shell`** se promueve a shell del proyecto.
 
 Schema completo, defaults, ejemplos de proxy: **[docs/configuration.md](docs/configuration.md)**.
@@ -266,13 +278,12 @@ Configuración para producción y modelo de amenazas: **[docs/security.md](docs/
 - **47** archivos Zig fuente, **~18.4k LOC** totales en `src/` (runtime + cli + config + commands)
 - **~250-460 KB** binario release por plataforma (con `-Doptimize=ReleaseFast`)
 - **0** dependencias Zig externas
-- **138** tests Zig descubiertos, más launcher npm, invariantes, fuzzing y smokes
+- Suite Zig, launcher npm, invariantes, fuzzing y smokes de proyectos generados
 - **0** procesos Vite simultáneos en `wu dev` (modo nativo). `wu dev --vite` legacy sí spawnea N procesos.
 
 ## Requisitos
 
-- **Node.js 16+** para `npm install -g @wu-framework/cli`
-- **Node.js 18+** a runtime sólo para Vue, Svelte, Solid o Angular (React/Preact corren en Zig puro)
+- **Node.js 20+** para instalar el CLI y ejecutar los toolchains generados
 - **Zig 0.16.0** sólo si construyes desde fuente
 
 ## Licencia

package/bin/wu.js

@@ -5,57 +5,74 @@ const path = require('path');
 const fs = require('fs');
 const os = require('os');
 
-const PLATFORM_MAP = {
-  'win32-x64':   'wu-win32-x64.exe',
-  'linux-x64':   'wu-linux-x64',
-  'darwin-x64':  'wu-darwin-x64',
-  'darwin-arm64': 'wu-darwin-arm64',
-};
-
-const platform = os.platform();
-const arch = os.arch();
-const key = `${platform}-${arch}`;
-const binaryName = PLATFORM_MAP[key];
-
-if (!binaryName) {
-  console.error(`wu-cli: unsupported platform ${platform}-${arch}`);
-  console.error(`Supported: ${Object.keys(PLATFORM_MAP).join(', ')}`);
-  process.exit(1);
-}
-
-const binaryPath = path.join(__dirname, binaryName);
-
-if (!fs.existsSync(binaryPath)) {
-  console.error(`wu-cli: binary not found at ${binaryPath}`);
-  console.error('This may mean the package was not built for your platform.');
-  console.error('Try reinstalling: npm install -g wu-cli');
-  process.exit(1);
-}
-
-const args = process.argv.slice(2);
-
-let result = spawnSync(binaryPath, args, {
-  stdio: 'inherit',
-  env: process.env,
-});
-
-// Handle EACCES — try chmod +x and retry (Linux/macOS)
-if (result.error && result.error.code === 'EACCES') {
-  try {
-    fs.chmodSync(binaryPath, 0o755);
-    result = spawnSync(binaryPath, args, {
-      stdio: 'inherit',
-      env: process.env,
-    });
-  } catch (chmodErr) {
-    console.error(`wu-cli: permission denied and could not chmod: ${chmodErr.message}`);
-    process.exit(1);
-  }
-}
-
-if (result.error) {
-  console.error(`wu-cli: failed to execute binary: ${result.error.message}`);
-  process.exit(1);
-}
-
-process.exit(result.status ?? 1);
+const PLATFORM_MAP = {
+  'win32-x64':   'wu-win32-x64.exe',
+  'linux-x64':   'wu-linux-x64',
+  'linux-arm64': 'wu-linux-arm64',
+  'darwin-x64':  'wu-darwin-x64',
+  'darwin-arm64': 'wu-darwin-arm64',
+};
+
+function binaryNameFor(platform, arch) {
+  return PLATFORM_MAP[`${platform}-${arch}`];
+}
+
+function executeBinary(binaryPath, args, runtime = {}) {
+  const spawn = runtime.spawn ?? spawnSync;
+  const chmod = runtime.chmod ?? fs.chmodSync;
+  const reportError = runtime.reportError ?? console.error;
+  const options = {
+    stdio: 'inherit',
+    env: runtime.env ?? process.env,
+  };
+
+  let result = spawn(binaryPath, args, options);
+
+  // npm pack on Windows cannot preserve POSIX executable bits. Repair the
+  // packaged Linux/macOS binary only when the operating system rejects it.
+  if (result.error && result.error.code === 'EACCES') {
+    try {
+      chmod(binaryPath, 0o755);
+      result = spawn(binaryPath, args, options);
+    } catch (chmodErr) {
+      reportError(`wu-cli: permission denied and could not chmod: ${chmodErr.message}`);
+      return 1;
+    }
+  }
+
+  if (result.error) {
+    reportError(`wu-cli: failed to execute binary: ${result.error.message}`);
+    return 1;
+  }
+
+  return result.status ?? 1;
+}
+
+function runCli(args = process.argv.slice(2)) {
+  const platform = os.platform();
+  const arch = os.arch();
+  const binaryName = binaryNameFor(platform, arch);
+
+  if (!binaryName) {
+    console.error(`wu-cli: unsupported platform ${platform}-${arch}`);
+    console.error(`Supported: ${Object.keys(PLATFORM_MAP).join(', ')}`);
+    return 1;
+  }
+
+  const binaryPath = path.join(__dirname, binaryName);
+
+  if (!fs.existsSync(binaryPath)) {
+    console.error(`wu-cli: binary not found at ${binaryPath}`);
+    console.error('This may mean the package was not built for your platform.');
+    console.error('Try reinstalling: npm install -g @wu-framework/cli');
+    return 1;
+  }
+
+  return executeBinary(binaryPath, args);
+}
+
+module.exports = { PLATFORM_MAP, binaryNameFor, executeBinary, runCli };
+
+if (require.main === module) {
+  process.exit(runCli());
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wu-framework/cli",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Native Zig dev server + CLI for wu-framework microfrontends. One binary, one port, all your micro-apps.",
   "license": "MIT",
   "author": "Wu Framework Team",
@@ -15,8 +15,11 @@
     "LICENSE"
   ],
   "scripts": {
-    "prepublishOnly": "bash scripts/build-all.sh",
-    "test:wrapper": "node --test \"tests/*.test.cjs\""
+    "build:binaries": "node scripts/build-all.mjs",
+    "test": "npm run test:invariants && npm run test:wrapper",
+    "test:invariants": "node scripts/check-invariants.mjs",
+    "test:wrapper": "node --test \"tests/*.test.cjs\"",
+    "prepublishOnly": "npm test && npm run build:binaries"
   },
   "keywords": [
     "micro-frontend",
@@ -41,7 +44,7 @@
     "stimulus"
   ],
   "engines": {
-    "node": ">=16"
+    "node": ">=20"
   },
   "publishConfig": {
     "access": "public"