@saulwade/swl-ses 2.3.1 → 2.4.2

package/scripts/tui/pantallas/welcome.js

@@ -1,187 +1,189 @@
-'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 };
+'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, scopesReales } = require('../../lib/detectar-runtime'));
+    ({ cargarEstado } = require('../../lib/estado'));
+  } catch (_) {
+    return [];
+  }
+
+  const runtimes = detectarRuntimes();
+  const filas = [];
+  for (const runtime of runtimes) {
+    // Dedup + guard anti-fantasma: desde HOME, el local relativo resuelve al
+    // global propio (duplicado) o al de OTRO runtime (p.ej. .claude de
+    // OpenClaude = global de Claude Code) — ver scopesReales().
+    const dirs = scopesReales(runtime).map(({ dir, esGlobal }) => (
+      { ruta: dir, scope: esGlobal ? 'global' : '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.js

@@ -55,7 +55,7 @@ if (fs.existsSync(hooksConfigPath)) {
   verificar(hooksEnConfig.length >= 4, `hooks-config.json: ${hooksEnConfig.length} hooks definidos (mínimo 4)`);
   for (const hookName of hooksEnConfig) {
     const hc = hooksConfig.hooks[hookName];
-    const eventosValidos = ['PreToolUse', 'PostToolUse', 'Stop', 'Notification', 'SubagentStop', 'UserPromptSubmit', 'PreCompact', 'SessionStart'];
+    const eventosValidos = ['PreToolUse', 'PostToolUse', 'Stop', 'Notification', 'SubagentStart', 'SubagentStop', 'UserPromptSubmit', 'PreCompact', 'SessionStart'];
     verificar(
       eventosValidos.includes(hc.event),
       `hooks-config.json: ${hookName} tiene event válido (${hc.event})`

package/scripts/verificar-release.js

@@ -329,6 +329,17 @@ function main() {
     ? '  [OK] Gate evolución: manifiesto al día + fuente sin evolved espurio'
     : `  [FALLA] Gate evolución: ${gateEvolved.problemas.join('; ')}`);
 
+  // Gate de invariantes: frases load-bearing de manifiestos/invariantes-criticos.json
+  // presentes verbatim en sus componentes. Blocking — perder una frase en un
+  // reword rompe el contrato cross-componente en silencio.
+  const gateInvariantes = ejecutarGateInvariantes();
+  if (!gateInvariantes.ok) {
+    fallasObligatorias++;
+  }
+  console.log(gateInvariantes.ok
+    ? `  [OK] Gate invariantes: ${gateInvariantes.frasesVerificadas} frase(s) load-bearing presentes`
+    : `  [FALLA] Gate invariantes: ${gateInvariantes.problemas.join('; ')}`);
+
   if (jsonOut) {
     process.stdout.write(JSON.stringify({
       version,
@@ -343,6 +354,7 @@ function main() {
       aiisms_gate: aiismsGate,
       gate_licencias: gateLicencias,
       gate_evolved: gateEvolved,
+      gate_invariantes: gateInvariantes,
       resultados: resultados.map(({ entrada, resultado }) => ({
         archivo: entrada.archivo,
         obligatorio: entrada.obligatorio,
@@ -928,6 +940,44 @@ function ejecutarGateLicencias(baseDir = CWD) {
   }
 }
 
+/**
+ * Gate de invariantes: frases load-bearing declaradas en
+ * manifiestos/invariantes-criticos.json deben existir verbatim en sus
+ * archivos. Complementa a canonical-hashes (que detecta QUE un archivo
+ * cambió) detectando si un reword perdió UNA regla puntual del contrato
+ * cross-componente. Blocking: la fricción de actualizar el manifiesto en
+ * un reword intencional es el recordatorio de propagar el cambio.
+ *
+ * @param {string} [baseDir=CWD] - Raíz del repo (inyectable para tests).
+ * @returns {{ ok: boolean, disponible: boolean, problemas: string[], frasesVerificadas: number }}
+ */
+function ejecutarGateInvariantes(baseDir = CWD) {
+  const manifiestoPath = path.join(baseDir, 'manifiestos', 'invariantes-criticos.json');
+  let manifiesto;
+  try {
+    manifiesto = JSON.parse(fs.readFileSync(manifiestoPath, 'utf8'));
+  } catch (err) {
+    return { ok: false, disponible: false, problemas: [`manifiesto ilegible: ${err.message}`], frasesVerificadas: 0 };
+  }
+
+  const problemas = [];
+  let frasesVerificadas = 0;
+  for (const [archivo, frases] of Object.entries(manifiesto.invariantes || {})) {
+    const contenido = leerArchivoSeguro(path.join(baseDir, archivo));
+    if (contenido === null) {
+      problemas.push(`${archivo}: archivo no existe`);
+      continue;
+    }
+    for (const frase of frases) {
+      frasesVerificadas++;
+      if (!contenido.includes(frase)) {
+        problemas.push(`${archivo}: perdió la frase invariante "${frase}"`);
+      }
+    }
+  }
+  return { ok: problemas.length === 0, disponible: true, problemas, frasesVerificadas };
+}
+
 if (require.main === module) main();
 
 module.exports = {
@@ -938,4 +988,5 @@ module.exports = {
   ejecutarGateDescription,
   ejecutarGateLicencias,
   ejecutarGateEvolved,
+  ejecutarGateInvariantes,
 };