@saulwade/swl-ses 1.5.1 → 1.6.0

package/scripts/tui/pantallas/welcome.js

@@ -0,0 +1,187 @@
+'use strict';
+
+/**
+ * Pantalla Welcome de la TUI de swl-ses.
+ *
+ * Diseño:
+ *   - Logo ASCII centrado en la parte superior
+ *   - Tabla de runtimes detectados (nombre, scope, versión instalada, estado)
+ *   - Pie con atajos: Enter continuar / Esc salir
+ *
+ * No-TTY: imprime versión texto plano y retorna { continuar: true } inmediatamente.
+ */
+
+const path = require('path');
+
+const render = require('../lib/render');
+const teclas = require('../lib/teclas');
+const { colores, semantico, iconos } = require('../lib/colores');
+
+// Logo en caracteres ASCII art compactos (5 líneas)
+const LOGO = [
+  '  ███████ ██     ██ ██          ███████ ███████ ███████  ',
+  '  ██      ██     ██ ██          ██      ██      ██       ',
+  '  ███████ ██  █  ██ ██          ███████ █████   ███████  ',
+  '       ██ ██ ███ ██ ██               ██ ██           ██  ',
+  '  ███████  ███ ███  ███████     ███████ ███████ ███████  ',
+];
+
+const SUBTITULO = 'Sistema de ingeniería de software auto-evolutivo multi-runtime';
+
+/**
+ * Detecta runtimes instalados leyendo desde scripts/lib/detectar-runtime.
+ * No falla si la lib no está disponible — devuelve array vacío.
+ */
+function detectarInstalaciones() {
+  let detectarRuntimes;
+  let cargarEstado;
+  try {
+    ({ detectarRuntimes } = require('../../lib/detectar-runtime'));
+    ({ cargarEstado } = require('../../lib/estado'));
+  } catch (_) {
+    return [];
+  }
+
+  const runtimes = detectarRuntimes();
+  const filas = [];
+  for (const runtime of runtimes) {
+    const dirs = [
+      { ruta: runtime.global, scope: 'global' },
+      { ruta: path.resolve(runtime.local), scope: 'proyecto' },
+    ];
+    for (const { ruta, scope } of dirs) {
+      try {
+        const estado = cargarEstado(ruta);
+        if (!estado) continue;
+        filas.push({
+          runtime: runtime.nombre,
+          scope,
+          version: estado.versionSistema || 'desconocida',
+          perfil: estado.perfil || '-',
+          componentes: estado.componentesInstalados?.length || 0,
+        });
+      } catch (_) {
+        // ignorar errores de lectura
+      }
+    }
+  }
+  return filas;
+}
+
+/**
+ * Pinta el contenido completo de la pantalla. Idempotente — se puede invocar
+ * múltiples veces (resize, re-render).
+ */
+function _renderizar(filas, version) {
+  render.limpiarPantalla();
+  const { cols, rows } = render.obtenerDimensiones();
+
+  // Logo centrado
+  const filaLogo = 2;
+  for (let i = 0; i < LOGO.length; i++) {
+    const linea = LOGO[i];
+    const colLogo = Math.max(1, Math.floor((cols - linea.length) / 2));
+    render.escribirEn(filaLogo + i, colLogo, semantico.titulo(linea));
+  }
+
+  // Subtítulo + versión
+  const filaSub = filaLogo + LOGO.length + 1;
+  const subFinal = `${SUBTITULO}  ${colores.dim('v' + version)}`;
+  const colSub = Math.max(1, Math.floor((cols - render.anchoVisual(subFinal)) / 2));
+  render.escribirEn(filaSub, colSub, subFinal);
+
+  // Tabla de runtimes detectados
+  const filaTabla = filaSub + 3;
+  if (filas.length === 0) {
+    const mensaje = colores.dim('No se detectaron instalaciones SWL en este equipo.');
+    const colMsg = Math.max(1, Math.floor((cols - render.anchoVisual(mensaje)) / 2));
+    render.escribirEn(filaTabla, colMsg, mensaje);
+  } else {
+    render.escribirEn(filaTabla - 1, 4, semantico.enfasis('Instalaciones detectadas:'));
+    const cabecera =
+      render.rellenarDer(colores.dim('Runtime'), 14) +
+      render.rellenarDer(colores.dim('Scope'), 10) +
+      render.rellenarDer(colores.dim('Versión'), 12) +
+      render.rellenarDer(colores.dim('Perfil'), 18) +
+      colores.dim('Componentes');
+    render.escribirEn(filaTabla, 4, cabecera);
+
+    filas.slice(0, rows - filaTabla - 4).forEach((f, i) => {
+      const estado = f.version === version
+        ? semantico.exito(iconos.check)
+        : semantico.warn(iconos.warn);
+      const linea =
+        render.rellenarDer(`${estado} ${f.runtime}`, 14) +
+        render.rellenarDer(f.scope, 10) +
+        render.rellenarDer('v' + f.version, 12) +
+        render.rellenarDer(f.perfil, 18) +
+        colores.cyan(String(f.componentes));
+      render.escribirEn(filaTabla + 1 + i, 4, linea);
+    });
+  }
+
+  // Mensaje central de continuación
+  const filaCont = rows - 4;
+  const mensaje = `Presiona ${semantico.cursor('Enter')} para continuar al menú principal o ${semantico.cursor('Esc')} para salir.`;
+  const colCont = Math.max(1, Math.floor((cols - render.anchoVisual(mensaje)) / 2));
+  render.escribirEn(filaCont, colCont, mensaje);
+
+  // Pie con atajos
+  render.dibujarPiePagina([
+    ['Enter', 'continuar'],
+    ['Esc',   'salir'],
+  ]);
+}
+
+/**
+ * Muestra la pantalla Welcome y espera input del usuario.
+ *
+ * @returns {Promise<{ continuar: boolean, instalaciones: Array }>}
+ */
+function mostrarWelcome() {
+  const version = require('../../../package.json').version;
+  const filas = detectarInstalaciones();
+
+  return new Promise((resolve) => {
+    // Modo no-TTY: salida texto plano sin esperar input
+    if (!render.ES_TTY || !process.stdin.isTTY) {
+      console.log('');
+      console.log(`  swl-ses v${version}`);
+      console.log(`  ${SUBTITULO}`);
+      console.log('');
+      if (filas.length > 0) {
+        console.log('  Instalaciones detectadas:');
+        for (const f of filas) {
+          console.log(`    ${f.runtime} (${f.scope}): v${f.version}, perfil ${f.perfil}`);
+        }
+      } else {
+        console.log('  No se detectaron instalaciones SWL.');
+      }
+      console.log('');
+      resolve({ continuar: true, instalaciones: filas });
+      return;
+    }
+
+    render.iniciarModoTui();
+    _renderizar(filas, version);
+
+    // Re-renderizar en resize
+    const onResize = () => _renderizar(filas, version);
+    process.stdout.on('resize', onResize);
+
+    const teclado = teclas.crearTeclado();
+
+    function finalizar(continuar) {
+      teclado.desactivar();
+      process.stdout.removeListener('resize', onResize);
+      render.salirModoTui();
+      resolve({ continuar, instalaciones: filas });
+    }
+
+    teclado.on('return', () => finalizar(true));
+    teclado.on('escape', () => finalizar(false));
+    teclado.activar();
+  });
+}
+
+module.exports = { mostrarWelcome, detectarInstalaciones, LOGO, SUBTITULO };

package/scripts/validar-userland-vacio.js

@@ -1,110 +1,110 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * validar-userland-vacio.js — guard pre-publish.
- *
- * Verifica que `_userland/` solo contenga archivos `.gitkeep` antes de
- * empaquetar el tarball. Si algún contributor accidentalmente commiteó
- * agentes, skills o credenciales experimentales en `_userland/`, este
- * gate aborta el publish con exit 1 y lista los archivos extraños.
- *
- * Por qué existe (defensa en profundidad):
- *   `_userland/` es el directorio donde el USUARIO instala su contenido
- *   custom. En el repo del sistema debe permanecer vacío (solo
- *   `.gitkeep` para preservar la estructura). El campo `files` de
- *   package.json incluye `_userland/`, así que cualquier archivo real
- *   que se cuele entrará al tarball publicado a npm — exposición
- *   potencial de IP o secretos. Aunque `.gitignore` y `.npmignore` ya
- *   cubren los vectores típicos (.env, credenciales), este guard
- *   garantiza que la regla "_userland/ vacío en distribución" se cumpla
- *   determinísticamente.
- *
- * Variables de entorno:
- *   SWL_USERLAND_GUARD_ALLOW=archivo1,archivo2 — permite archivos extra
- *     (uso excepcional documentado en commit que active la variable).
- *
- * Exit codes:
- *   0 — OK, _userland/ solo contiene .gitkeep
- *   1 — hay archivos extraños; lista impresa a stderr
- *   2 — error de invariante (cwd incorrecto, _userland/ no existe)
- */
-
-const fs   = require('fs');
-const path = require('path');
-
-const USERLAND_DIR = '_userland';
-const PERMITIDOS_BASE = new Set(['.gitkeep', '.gitignore']);
-
-function log(msg) { process.stdout.write(`[userland-guard] ${msg}\n`); }
-function err(msg) { process.stderr.write(`[userland-guard] ERROR: ${msg}\n`); }
-
-/**
- * Normaliza una ruta relativa al separador POSIX (`/`) para que la
- * comparación contra la allowlist funcione idéntica en Windows y POSIX.
- */
-function normalizar(rel) {
-  return rel.replace(/\\/g, '/');
-}
-
-function obtenerExtras() {
-  const extras = process.env.SWL_USERLAND_GUARD_ALLOW;
-  if (!extras) return new Set();
-  return new Set(extras.split(',').map(s => normalizar(s.trim())).filter(Boolean));
-}
-
-function listarRecursivo(dir, baseDir = dir, acumulador = []) {
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const full = path.join(dir, entry.name);
-    const rel  = normalizar(path.relative(baseDir, full));
-    if (entry.isDirectory()) {
-      listarRecursivo(full, baseDir, acumulador);
-    } else if (entry.isFile()) {
-      acumulador.push(rel);
-    } else if (entry.isSymbolicLink()) {
-      // Symlinks dentro del paquete distribuido son anti-patrón.
-      acumulador.push(`${rel} (symlink)`);
-    }
-  }
-  return acumulador;
-}
-
-function main() {
-  const cwd = process.cwd();
-  const userland = path.join(cwd, USERLAND_DIR);
-
-  if (!fs.existsSync(userland)) {
-    err(`${USERLAND_DIR}/ no existe en ${cwd}. ¿cwd incorrecto?`);
-    process.exit(2);
-  }
-
-  const extrasPermitidos = obtenerExtras();
-  const archivos = listarRecursivo(userland);
-
-  const noPermitidos = archivos.filter(rel => {
-    const nombre = path.basename(rel);
-    if (PERMITIDOS_BASE.has(nombre)) return false;
-    if (extrasPermitidos.has(rel)) return false;
-    return true;
-  });
-
-  if (noPermitidos.length > 0) {
-    err(`${USERLAND_DIR}/ contiene ${noPermitidos.length} archivo(s) que no deberían distribuirse en el tarball npm:`);
-    for (const rel of noPermitidos) {
-      err(`  - ${USERLAND_DIR}/${rel}`);
-    }
-    err('');
-    err('Acciones posibles:');
-    err(`  1. Mover el contenido fuera de ${USERLAND_DIR}/ si es del sistema base`);
-    err(`  2. Borrarlo si era código experimental local`);
-    err(`  3. Permitir explícitamente con SWL_USERLAND_GUARD_ALLOW="ruta1,ruta2"`);
-    err('     (documentar la excepción en el mensaje de commit)');
-    process.exit(1);
-  }
-
-  log(`OK: ${USERLAND_DIR}/ solo contiene ${archivos.length} archivo(s) permitido(s).`);
-  process.exit(0);
-}
-
-main();
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * validar-userland-vacio.js — guard pre-publish.
+ *
+ * Verifica que `_userland/` solo contenga archivos `.gitkeep` antes de
+ * empaquetar el tarball. Si algún contributor accidentalmente commiteó
+ * agentes, skills o credenciales experimentales en `_userland/`, este
+ * gate aborta el publish con exit 1 y lista los archivos extraños.
+ *
+ * Por qué existe (defensa en profundidad):
+ *   `_userland/` es el directorio donde el USUARIO instala su contenido
+ *   custom. En el repo del sistema debe permanecer vacío (solo
+ *   `.gitkeep` para preservar la estructura). El campo `files` de
+ *   package.json incluye `_userland/`, así que cualquier archivo real
+ *   que se cuele entrará al tarball publicado a npm — exposición
+ *   potencial de IP o secretos. Aunque `.gitignore` y `.npmignore` ya
+ *   cubren los vectores típicos (.env, credenciales), este guard
+ *   garantiza que la regla "_userland/ vacío en distribución" se cumpla
+ *   determinísticamente.
+ *
+ * Variables de entorno:
+ *   SWL_USERLAND_GUARD_ALLOW=archivo1,archivo2 — permite archivos extra
+ *     (uso excepcional documentado en commit que active la variable).
+ *
+ * Exit codes:
+ *   0 — OK, _userland/ solo contiene .gitkeep
+ *   1 — hay archivos extraños; lista impresa a stderr
+ *   2 — error de invariante (cwd incorrecto, _userland/ no existe)
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const USERLAND_DIR = '_userland';
+const PERMITIDOS_BASE = new Set(['.gitkeep', '.gitignore']);
+
+function log(msg) { process.stdout.write(`[userland-guard] ${msg}\n`); }
+function err(msg) { process.stderr.write(`[userland-guard] ERROR: ${msg}\n`); }
+
+/**
+ * Normaliza una ruta relativa al separador POSIX (`/`) para que la
+ * comparación contra la allowlist funcione idéntica en Windows y POSIX.
+ */
+function normalizar(rel) {
+  return rel.replace(/\\/g, '/');
+}
+
+function obtenerExtras() {
+  const extras = process.env.SWL_USERLAND_GUARD_ALLOW;
+  if (!extras) return new Set();
+  return new Set(extras.split(',').map(s => normalizar(s.trim())).filter(Boolean));
+}
+
+function listarRecursivo(dir, baseDir = dir, acumulador = []) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+    const rel  = normalizar(path.relative(baseDir, full));
+    if (entry.isDirectory()) {
+      listarRecursivo(full, baseDir, acumulador);
+    } else if (entry.isFile()) {
+      acumulador.push(rel);
+    } else if (entry.isSymbolicLink()) {
+      // Symlinks dentro del paquete distribuido son anti-patrón.
+      acumulador.push(`${rel} (symlink)`);
+    }
+  }
+  return acumulador;
+}
+
+function main() {
+  const cwd = process.cwd();
+  const userland = path.join(cwd, USERLAND_DIR);
+
+  if (!fs.existsSync(userland)) {
+    err(`${USERLAND_DIR}/ no existe en ${cwd}. ¿cwd incorrecto?`);
+    process.exit(2);
+  }
+
+  const extrasPermitidos = obtenerExtras();
+  const archivos = listarRecursivo(userland);
+
+  const noPermitidos = archivos.filter(rel => {
+    const nombre = path.basename(rel);
+    if (PERMITIDOS_BASE.has(nombre)) return false;
+    if (extrasPermitidos.has(rel)) return false;
+    return true;
+  });
+
+  if (noPermitidos.length > 0) {
+    err(`${USERLAND_DIR}/ contiene ${noPermitidos.length} archivo(s) que no deberían distribuirse en el tarball npm:`);
+    for (const rel of noPermitidos) {
+      err(`  - ${USERLAND_DIR}/${rel}`);
+    }
+    err('');
+    err('Acciones posibles:');
+    err(`  1. Mover el contenido fuera de ${USERLAND_DIR}/ si es del sistema base`);
+    err(`  2. Borrarlo si era código experimental local`);
+    err(`  3. Permitir explícitamente con SWL_USERLAND_GUARD_ALLOW="ruta1,ruta2"`);
+    err('     (documentar la excepción en el mensaje de commit)');
+    process.exit(1);
+  }
+
+  log(`OK: ${USERLAND_DIR}/ solo contiene ${archivos.length} archivo(s) permitido(s).`);
+  process.exit(0);
+}
+
+main();