@saulwade/swl-ses 2.6.0 → 2.8.0

package/scripts/tui/pantallas/install-wizard.js

@@ -1,403 +1,408 @@
-'use strict';
-
-/**
- * Wizard de instalación TUI.
- * Reemplaza la versión simple basada en preguntarOpcion del install-asistido.js
- * con un flujo multi-step visual usando los componentes selector-unico y
- * selector-multi.
- *
- * Pasos:
- *   1. Runtime destino (Claude/Codex/OpenCode/etc.)
- *   2. Perfil (core / backend-python / fullstack-* / completo / ...)
- *   3. Scope (proyecto / global)
- *   4. Flags adicionales (with-mcp, dry-run, solo-hooks)
- *   5. Módulos opt-in (fuera de todos los perfiles — DT-MODULOS-OPT-IN)
- *   6. Stacks de lenguajes (solo si perfil = completo)
- *   7. Preview del plan + confirmación final
- *
- * Devuelve el objeto de opciones para `scripts/instalador.js` o null si el
- * usuario canceló en cualquier paso.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const { selectorUnico } = require('../componentes/selector-unico');
-const { selectorMulti } = require('../componentes/selector-multi');
-const render = require('../lib/render');
-const teclas = require('../lib/teclas');
-const { colores, semantico, iconos } = require('../lib/colores');
-
-const RAIZ = path.resolve(__dirname, '..', '..', '..');
-const PERFILES_PATH = path.join(RAIZ, 'manifiestos', 'perfiles.json');
-
-// ---------------------------------------------------------------------------
-// Datos estáticos
-// ---------------------------------------------------------------------------
-
-const RUNTIMES = [
-  {
-    valor: 'claude',
-    etiqueta: 'Claude Code',
-    descripcion: 'Runtime principal de Anthropic. Soporte completo de hooks, agentes, skills y comandos.',
-    badge: 'recomendado',
-  },
-  {
-    valor: 'openclaude',
-    etiqueta: 'OpenClaude',
-    descripcion: 'Fork open source compatible con Claude Code. Soporte completo.',
-  },
-  {
-    valor: 'opencode',
-    etiqueta: 'OpenCode',
-    descripcion: 'CLI de código abierto multi-modelo. Soporte completo.',
-  },
-  {
-    valor: 'codex',
-    etiqueta: 'Codex CLI (OpenAI)',
-    descripcion: 'CLI oficial de OpenAI. Soporte parcial: agentes en TOML, hooks limitados.',
-  },
-  {
-    valor: 'gemini',
-    etiqueta: 'Gemini CLI (Google)',
-    descripcion: 'CLI oficial de Google Gemini. Soporte completo.',
-  },
-  {
-    valor: 'copilot',
-    etiqueta: 'GitHub Copilot',
-    descripcion: 'Copilot Chat / CLI. Soporte parcial — no soporta todos los hooks SWL.',
-  },
-  {
-    valor: 'cursor',
-    etiqueta: 'Cursor',
-    descripcion: 'IDE basado en VS Code con Cursor Agents. Soporte completo de hooks (17 eventos).',
-  },
-];
-
-const SCOPES = [
-  {
-    valor: 'proyecto',
-    etiqueta: 'Proyecto (./.claude/)',
-    descripcion: 'Solo este proyecto. Recomendado para uso por proyecto y CI/CD.',
-    badge: 'recomendado',
-  },
-  {
-    valor: 'global',
-    etiqueta: 'Global (~/.claude/)',
-    descripcion: 'Disponible en todos los proyectos del usuario. Útil para herramientas comunes.',
-  },
-];
-
-const STACKS_ADICIONALES = [
-  { valor: 'java',    etiqueta: 'Java + Spring Boot' },
-  { valor: 'go',      etiqueta: 'Go' },
-  { valor: 'rust',    etiqueta: 'Rust' },
-  { valor: 'csharp',  etiqueta: 'C# / .NET' },
-  { valor: 'kotlin',  etiqueta: 'Kotlin + Android' },
-  { valor: 'swift',   etiqueta: 'Swift + iOS' },
-  { valor: 'php',     etiqueta: 'PHP + Laravel' },
-  { valor: 'nextjs',  etiqueta: 'Next.js' },
-];
-
-const FLAGS = [
-  {
-    valor: 'with-mcp',
-    etiqueta: 'Configurar MCP server swl-memory',
-    descripcion: 'Habilita búsqueda híbrida BM25+vector en sesiones pasadas. Recomendado.',
-    preseleccionado: false,
-  },
-  {
-    valor: 'dry-run',
-    etiqueta: 'Dry-run (solo mostrar plan, no copiar archivos)',
-    descripcion: 'Útil para inspeccionar qué se haría sin tocar el filesystem.',
-    preseleccionado: false,
-  },
-  {
-    valor: 'solo-hooks',
-    etiqueta: 'Solo hooks (telemetría de proyecto, sin copiar componentes)',
-    descripcion: 'Registra los hooks del scope GLOBAL en el settings.json de ESTE proyecto — evita duplicar agentes/comandos en la UI. Ignora perfil, scope y módulos. Solo target Claude Code.',
-    preseleccionado: false,
-  },
-];
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-const MODULOS_PATH = path.join(RAIZ, 'manifiestos', 'modulos.json');
-
-/**
- * Módulos `opt_in: true` de modulos.json — fuera de todos los perfiles,
- * instalables solo por selección explícita (DT-MODULOS-OPT-IN). El wizard
- * los ofrece como paso propio; el CLI equivalente es `--with a,b`.
- *
- * @returns {Array<{valor: string, etiqueta: string, descripcion: string}>}
- */
-function cargarModulosOptIn() {
-  try {
-    const data = JSON.parse(fs.readFileSync(MODULOS_PATH, 'utf8'));
-    const modulos = data.modulos || {};
-    return Object.entries(modulos)
-      .filter(([, m]) => m && m.opt_in === true)
-      .map(([nombre, m]) => ({
-        valor: nombre,
-        etiqueta: nombre,
-        descripcion: String(m.descripcion || '').slice(0, 140),
-      }));
-  } catch (_) {
-    return [];
-  }
-}
-
-function cargarPerfiles() {
-  try {
-    const data = JSON.parse(fs.readFileSync(PERFILES_PATH, 'utf8'));
-    return data.perfiles || {};
-  } catch (_) {
-    return {};
-  }
-}
-
-function construirItemsPerfil(perfiles) {
-  // Orden: core primero, completo al final, el resto alfabético
-  const keys = Object.keys(perfiles);
-  const ordenados = [];
-  if (keys.includes('core')) ordenados.push('core');
-  const intermedios = keys.filter(k => k !== 'core' && k !== 'completo').sort();
-  ordenados.push(...intermedios);
-  if (keys.includes('completo')) ordenados.push('completo');
-
-  return ordenados.map(k => {
-    const p = perfiles[k];
-    return {
-      valor: k,
-      etiqueta: k,
-      descripcion: p.descripcion || `Perfil ${k} con ${p.modulos?.length || 0} módulos`,
-      badge: k === 'core' ? 'mínimo' : k === 'completo' ? 'todo' : undefined,
-    };
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Pantalla de preview
-// ---------------------------------------------------------------------------
-
-/**
- * Renderiza una pantalla de preview con el resumen del plan y espera Enter
- * (continuar a confirmación) o Esc (cancelar). Devuelve true/false.
- */
-function pantallaPreview(opciones, perfiles) {
-  return new Promise((resolve) => {
-    if (!render.ES_TTY || !process.stdin.isTTY) {
-      resolve(true);
-      return;
-    }
-
-    function _renderizar() {
-      render.limpiarPantalla();
-      const { cols } = render.obtenerDimensiones();
-
-      render.escribirEn(2, 3, semantico.titulo('Resumen del plan'));
-      render.escribirEn(3, 3, colores.dim('Revisa antes de confirmar:'));
-
-      const filas = [
-        ['Runtime(s)',  (opciones.targets || [opciones.target]).join(', ')],
-        ['Perfil',      opciones.profile],
-        ['Scope',       opciones.global ? 'global (~/.claude)' : 'proyecto (./.claude)'],
-        ['With MCP',    opciones.with_mcp ? 'sí' : 'no'],
-        ['Dry-run',     opciones.dry_run ? 'sí (no copia archivos)' : 'no'],
-      ];
-
-      if (opciones.profile === 'completo' && opciones.stacks?.length > 0) {
-        filas.push(['Stacks extra', opciones.stacks.join(', ')]);
-      }
-
-      if (opciones['solo-hooks']) {
-        filas.push(['Solo hooks', 'sí — registra hooks del scope global en el proyecto, sin copiar componentes']);
-      }
-      if (opciones.with) {
-        filas.push(['Módulos opt-in', opciones.with]);
-      }
-
-      const perfilInfo = perfiles[opciones.profile];
-      if (perfilInfo?.modulos) {
-        filas.push(['Módulos', String(perfilInfo.modulos.length)]);
-      }
-
-      filas.forEach((fila, i) => {
-        const [k, v] = fila;
-        render.escribirEn(5 + i, 5,
-          render.rellenarDer(colores.dim(k + ':'), 16) + semantico.enfasis(v));
-      });
-
-      // Si hay perfil con módulos, listar los primeros 8
-      if (perfilInfo?.modulos) {
-        const filaMod = 7 + filas.length;
-        render.escribirEn(filaMod, 5, colores.dim('Módulos incluidos:'));
-        const mostrar = perfilInfo.modulos.slice(0, 8);
-        mostrar.forEach((m, i) => {
-          render.escribirEn(filaMod + 1 + i, 7, colores.cyan(iconos.punto) + ' ' + m);
-        });
-        if (perfilInfo.modulos.length > 8) {
-          render.escribirEn(filaMod + 1 + mostrar.length, 7,
-            colores.dim(`... y ${perfilInfo.modulos.length - 8} más`));
-        }
-      }
-
-      render.dibujarPiePagina([
-        ['Enter', 'continuar a confirmación'],
-        ['Esc',   'cancelar'],
-      ]);
-    }
-
-    render.iniciarModoTui();
-    _renderizar();
-
-    const onResize = () => _renderizar();
-    process.stdout.on('resize', onResize);
-
-    const teclado = teclas.crearTeclado();
-
-    function _finalizar(continuar) {
-      teclado.desactivar();
-      process.stdout.removeListener('resize', onResize);
-      render.salirModoTui();
-      resolve(continuar);
-    }
-
-    teclado.on('return', () => _finalizar(true));
-    teclado.on('escape', () => _finalizar(false));
-    teclado.activar();
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Wizard principal
-// ---------------------------------------------------------------------------
-
-async function ejecutarWizardInstall() {
-  const perfiles = cargarPerfiles();
-  if (Object.keys(perfiles).length === 0) {
-    return { exito: false, error: 'No se pudo cargar manifiestos/perfiles.json' };
-  }
-
-  // 1. Runtime(s) — multiselección: instala en varios runtimes en una corrida
-  // (fix 2026-07-09: era selector único; el flujo multi-runtime obligaba a
-  // repetir el wizard completo por cada runtime).
-  let targets = null;
-  let tituloPaso1 = 'Paso 1/7 — ¿En qué runtime(s) instalas SWL? (espacio para marcar)';
-  for (;;) {
-    targets = await selectorMulti({ titulo: tituloPaso1, items: RUNTIMES });
-    if (targets === null) return { exito: false, cancelado: true };
-    if (targets.length > 0) break;
-    // no-TTY: selectorMulti resuelve [] al instante — re-preguntar sería un
-    // spin infinito en caliente (colgó la suite 2.7h el 2026-07-09). Default:
-    // primer runtime, igual que hacía el selector único.
-    if (!render.ES_TTY || !process.stdin.isTTY) {
-      targets = [RUNTIMES[0].valor];
-      break;
-    }
-    tituloPaso1 = 'Paso 1/7 — Marca AL MENOS un runtime con espacio (Esc para cancelar)';
-  }
-  const target = targets[0]; // compat: preview/ejecutores leen .target
-
-  // 2. Perfil
-  const profile = await selectorUnico({
-    titulo: 'Paso 2/7 — ¿Qué perfil instalas?',
-    items: construirItemsPerfil(perfiles),
-    indiceDefault: 0,
-  });
-  if (!profile) return { exito: false, cancelado: true };
-
-  // 3. Scope
-  const scope = await selectorUnico({
-    titulo: 'Paso 3/7 — ¿Dónde se instala?',
-    items: SCOPES,
-    indiceDefault: 0,
-  });
-  if (!scope) return { exito: false, cancelado: true };
-
-  // 4. Flags
-  const flagsSeleccionados = await selectorMulti({
-    titulo: 'Paso 4/7 — Flags adicionales (espacio para toggle):',
-    items: FLAGS,
-  });
-  if (flagsSeleccionados === null) return { exito: false, cancelado: true };
-
-  // 5. Módulos opt-in (DT-MODULOS-OPT-IN) — fuera de todos los perfiles;
-  // solo se instalan por selección explícita. Se omite en modo solo-hooks
-  // (ese camino no copia componentes).
-  const soloHooks = flagsSeleccionados.includes('solo-hooks');
-  let modulosOptIn = [];
-  const itemsOptIn = soloHooks ? [] : cargarModulosOptIn();
-  if (itemsOptIn.length > 0) {
-    const elegidos = await selectorMulti({
-      titulo: 'Paso 5/7 — Módulos opt-in (fuera del perfil; espacio para marcar, Enter para omitir):',
-      items: itemsOptIn,
-    });
-    if (elegidos === null) return { exito: false, cancelado: true };
-    modulosOptIn = elegidos;
-  }
-
-  // 6. Stacks (solo si perfil = completo)
-  let stacks = [];
-  if (profile === 'completo' && !soloHooks) {
-    const elegidos = await selectorMulti({
-      titulo: 'Paso 6/7 — Stacks de lenguajes adicionales (perfil completo):',
-      items: STACKS_ADICIONALES,
-    });
-    if (elegidos === null) return { exito: false, cancelado: true };
-    stacks = elegidos;
-  }
-
-  const opciones = {
-    target,
-    targets,
-    profile,
-    global: scope === 'global',
-    with_mcp: flagsSeleccionados.includes('with-mcp'),
-    dry_run: flagsSeleccionados.includes('dry-run'),
-    'solo-hooks': soloHooks,
-    with: modulosOptIn.join(',') || undefined,
-    all_langs: stacks.length > 0,
-    stacks,
-  };
-
-  // 6. Preview
-  const procederPreview = await pantallaPreview(opciones, perfiles);
-  if (!procederPreview) return { exito: false, cancelado: true };
-
-  // 7. Confirmación final (selector único con 2 opciones para claridad visual)
-  const confirmacion = await selectorUnico({
-    titulo: 'Paso 7/7 — Confirmar e iniciar instalación',
-    items: [
-      {
-        valor: 'si',
-        etiqueta: 'Sí, instalar ahora',
-        descripcion: 'Ejecuta el plan y muestra progreso. Puedes usar dry-run en el paso 4 si solo quieres ver qué pasaría.',
-      },
-      {
-        valor: 'no',
-        etiqueta: 'No, cancelar',
-        descripcion: 'Vuelve al menú principal sin tocar nada.',
-      },
-    ],
-    indiceDefault: 0,
-  });
-
-  if (confirmacion !== 'si') return { exito: false, cancelado: true };
-
-  return { exito: true, opciones };
-}
-
-module.exports = {
-  ejecutarWizardInstall,
-  // exports auxiliares para tests
-  RUNTIMES,
-  SCOPES,
-  STACKS_ADICIONALES,
-  FLAGS,
-  cargarPerfiles,
-  construirItemsPerfil,
-  cargarModulosOptIn,
-};
+'use strict';
+
+/**
+ * Wizard de instalación TUI.
+ * Reemplaza la versión simple basada en preguntarOpcion del install-asistido.js
+ * con un flujo multi-step visual usando los componentes selector-unico y
+ * selector-multi.
+ *
+ * Pasos:
+ *   1. Runtime destino (Claude/Codex/OpenCode/etc.)
+ *   2. Perfil (core / backend-python / fullstack-* / completo / ...)
+ *   3. Scope (proyecto / global)
+ *   4. Flags adicionales (with-mcp, dry-run, solo-hooks)
+ *   5. Módulos opt-in (fuera de todos los perfiles — DT-MODULOS-OPT-IN)
+ *   6. Stacks de lenguajes (solo si perfil = completo)
+ *   7. Preview del plan + confirmación final
+ *
+ * Devuelve el objeto de opciones para `scripts/instalador.js` o null si el
+ * usuario canceló en cualquier paso.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const { selectorUnico } = require('../componentes/selector-unico');
+const { selectorMulti } = require('../componentes/selector-multi');
+const render = require('../lib/render');
+const teclas = require('../lib/teclas');
+const { colores, semantico, iconos } = require('../lib/colores');
+const { obtenerEtiquetaConformidad } = require('../../lib/detectar-runtime');
+
+const RAIZ = path.resolve(__dirname, '..', '..', '..');
+const PERFILES_PATH = path.join(RAIZ, 'manifiestos', 'perfiles.json');
+
+function describirRuntime(target, detalle) {
+  return `${detalle} Conformidad ${obtenerEtiquetaConformidad(target)}.`;
+}
+
+// ---------------------------------------------------------------------------
+// Datos estáticos
+// ---------------------------------------------------------------------------
+
+const RUNTIMES = [
+  {
+    valor: 'claude',
+    etiqueta: 'Claude Code',
+    descripcion: describirRuntime('claude', 'Runtime principal de Anthropic.'),
+    badge: 'recomendado',
+  },
+  {
+    valor: 'openclaude',
+    etiqueta: 'OpenClaude',
+    descripcion: describirRuntime('openclaude', 'Fork open source con artefactos de Claude Code.'),
+  },
+  {
+    valor: 'opencode',
+    etiqueta: 'OpenCode',
+    descripcion: describirRuntime('opencode', 'CLI de código abierto multi-modelo.'),
+  },
+  {
+    valor: 'codex',
+    etiqueta: 'Codex CLI (OpenAI)',
+    descripcion: describirRuntime('codex', 'CLI de OpenAI; emite agentes TOML y seis eventos de hooks.'),
+  },
+  {
+    valor: 'gemini',
+    etiqueta: 'Gemini CLI (Google)',
+    descripcion: describirRuntime('gemini', 'CLI de Google Gemini.'),
+  },
+  {
+    valor: 'copilot',
+    etiqueta: 'GitHub Copilot',
+    descripcion: describirRuntime('copilot', 'Copilot Chat / CLI; consolida agentes y reglas.'),
+  },
+  {
+    valor: 'cursor',
+    etiqueta: 'Cursor',
+    descripcion: describirRuntime('cursor', 'IDE basado en VS Code; emite 17 eventos de hooks.'),
+  },
+];
+
+const SCOPES = [
+  {
+    valor: 'proyecto',
+    etiqueta: 'Proyecto (./.claude/)',
+    descripcion: 'Solo este proyecto. Recomendado para uso por proyecto y CI/CD.',
+    badge: 'recomendado',
+  },
+  {
+    valor: 'global',
+    etiqueta: 'Global (~/.claude/)',
+    descripcion: 'Disponible en todos los proyectos del usuario. Útil para herramientas comunes.',
+  },
+];
+
+const STACKS_ADICIONALES = [
+  { valor: 'java',    etiqueta: 'Java + Spring Boot' },
+  { valor: 'go',      etiqueta: 'Go' },
+  { valor: 'rust',    etiqueta: 'Rust' },
+  { valor: 'csharp',  etiqueta: 'C# / .NET' },
+  { valor: 'kotlin',  etiqueta: 'Kotlin + Android' },
+  { valor: 'swift',   etiqueta: 'Swift + iOS' },
+  { valor: 'php',     etiqueta: 'PHP + Laravel' },
+  { valor: 'nextjs',  etiqueta: 'Next.js' },
+];
+
+const FLAGS = [
+  {
+    valor: 'with-mcp',
+    etiqueta: 'Configurar MCP server swl-memory',
+    descripcion: 'Habilita búsqueda híbrida BM25+vector en sesiones pasadas. Recomendado.',
+    preseleccionado: false,
+  },
+  {
+    valor: 'dry-run',
+    etiqueta: 'Dry-run (solo mostrar plan, no copiar archivos)',
+    descripcion: 'Útil para inspeccionar qué se haría sin tocar el filesystem.',
+    preseleccionado: false,
+  },
+  {
+    valor: 'solo-hooks',
+    etiqueta: 'Solo hooks (telemetría de proyecto, sin copiar componentes)',
+    descripcion: 'Registra los hooks del scope GLOBAL en el settings.json de ESTE proyecto — evita duplicar agentes/comandos en la UI. Ignora perfil, scope y módulos. Solo target Claude Code.',
+    preseleccionado: false,
+  },
+];
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+const MODULOS_PATH = path.join(RAIZ, 'manifiestos', 'modulos.json');
+
+/**
+ * Módulos `opt_in: true` de modulos.json — fuera de todos los perfiles,
+ * instalables solo por selección explícita (DT-MODULOS-OPT-IN). El wizard
+ * los ofrece como paso propio; el CLI equivalente es `--with a,b`.
+ *
+ * @returns {Array<{valor: string, etiqueta: string, descripcion: string}>}
+ */
+function cargarModulosOptIn() {
+  try {
+    const data = JSON.parse(fs.readFileSync(MODULOS_PATH, 'utf8'));
+    const modulos = data.modulos || {};
+    return Object.entries(modulos)
+      .filter(([, m]) => m && m.opt_in === true)
+      .map(([nombre, m]) => ({
+        valor: nombre,
+        etiqueta: nombre,
+        descripcion: String(m.descripcion || '').slice(0, 140),
+      }));
+  } catch (_) {
+    return [];
+  }
+}
+
+function cargarPerfiles() {
+  try {
+    const data = JSON.parse(fs.readFileSync(PERFILES_PATH, 'utf8'));
+    return data.perfiles || {};
+  } catch (_) {
+    return {};
+  }
+}
+
+function construirItemsPerfil(perfiles) {
+  // Orden: core primero, completo al final, el resto alfabético
+  const keys = Object.keys(perfiles);
+  const ordenados = [];
+  if (keys.includes('core')) ordenados.push('core');
+  const intermedios = keys.filter(k => k !== 'core' && k !== 'completo').sort();
+  ordenados.push(...intermedios);
+  if (keys.includes('completo')) ordenados.push('completo');
+
+  return ordenados.map(k => {
+    const p = perfiles[k];
+    return {
+      valor: k,
+      etiqueta: k,
+      descripcion: p.descripcion || `Perfil ${k} con ${p.modulos?.length || 0} módulos`,
+      badge: k === 'core' ? 'mínimo' : k === 'completo' ? 'todo' : undefined,
+    };
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Pantalla de preview
+// ---------------------------------------------------------------------------
+
+/**
+ * Renderiza una pantalla de preview con el resumen del plan y espera Enter
+ * (continuar a confirmación) o Esc (cancelar). Devuelve true/false.
+ */
+function pantallaPreview(opciones, perfiles) {
+  return new Promise((resolve) => {
+    if (!render.ES_TTY || !process.stdin.isTTY) {
+      resolve(true);
+      return;
+    }
+
+    function _renderizar() {
+      render.limpiarPantalla();
+      const { cols } = render.obtenerDimensiones();
+
+      render.escribirEn(2, 3, semantico.titulo('Resumen del plan'));
+      render.escribirEn(3, 3, colores.dim('Revisa antes de confirmar:'));
+
+      const filas = [
+        ['Runtime(s)',  (opciones.targets || [opciones.target]).join(', ')],
+        ['Perfil',      opciones.profile],
+        ['Scope',       opciones.global ? 'global (~/.claude)' : 'proyecto (./.claude)'],
+        ['With MCP',    opciones.with_mcp ? 'sí' : 'no'],
+        ['Dry-run',     opciones.dry_run ? 'sí (no copia archivos)' : 'no'],
+      ];
+
+      if (opciones.profile === 'completo' && opciones.stacks?.length > 0) {
+        filas.push(['Stacks extra', opciones.stacks.join(', ')]);
+      }
+
+      if (opciones['solo-hooks']) {
+        filas.push(['Solo hooks', 'sí — registra hooks del scope global en el proyecto, sin copiar componentes']);
+      }
+      if (opciones.with) {
+        filas.push(['Módulos opt-in', opciones.with]);
+      }
+
+      const perfilInfo = perfiles[opciones.profile];
+      if (perfilInfo?.modulos) {
+        filas.push(['Módulos', String(perfilInfo.modulos.length)]);
+      }
+
+      filas.forEach((fila, i) => {
+        const [k, v] = fila;
+        render.escribirEn(5 + i, 5,
+          render.rellenarDer(colores.dim(k + ':'), 16) + semantico.enfasis(v));
+      });
+
+      // Si hay perfil con módulos, listar los primeros 8
+      if (perfilInfo?.modulos) {
+        const filaMod = 7 + filas.length;
+        render.escribirEn(filaMod, 5, colores.dim('Módulos incluidos:'));
+        const mostrar = perfilInfo.modulos.slice(0, 8);
+        mostrar.forEach((m, i) => {
+          render.escribirEn(filaMod + 1 + i, 7, colores.cyan(iconos.punto) + ' ' + m);
+        });
+        if (perfilInfo.modulos.length > 8) {
+          render.escribirEn(filaMod + 1 + mostrar.length, 7,
+            colores.dim(`... y ${perfilInfo.modulos.length - 8} más`));
+        }
+      }
+
+      render.dibujarPiePagina([
+        ['Enter', 'continuar a confirmación'],
+        ['Esc',   'cancelar'],
+      ]);
+    }
+
+    render.iniciarModoTui();
+    _renderizar();
+
+    const onResize = () => _renderizar();
+    process.stdout.on('resize', onResize);
+
+    const teclado = teclas.crearTeclado();
+
+    function _finalizar(continuar) {
+      teclado.desactivar();
+      process.stdout.removeListener('resize', onResize);
+      render.salirModoTui();
+      resolve(continuar);
+    }
+
+    teclado.on('return', () => _finalizar(true));
+    teclado.on('escape', () => _finalizar(false));
+    teclado.activar();
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Wizard principal
+// ---------------------------------------------------------------------------
+
+async function ejecutarWizardInstall() {
+  const perfiles = cargarPerfiles();
+  if (Object.keys(perfiles).length === 0) {
+    return { exito: false, error: 'No se pudo cargar manifiestos/perfiles.json' };
+  }
+
+  // 1. Runtime(s) — multiselección: instala en varios runtimes en una corrida
+  // (fix 2026-07-09: era selector único; el flujo multi-runtime obligaba a
+  // repetir el wizard completo por cada runtime).
+  let targets = null;
+  let tituloPaso1 = 'Paso 1/7 — ¿En qué runtime(s) instalas SWL? (espacio para marcar)';
+  for (;;) {
+    targets = await selectorMulti({ titulo: tituloPaso1, items: RUNTIMES });
+    if (targets === null) return { exito: false, cancelado: true };
+    if (targets.length > 0) break;
+    // no-TTY: selectorMulti resuelve [] al instante — re-preguntar sería un
+    // spin infinito en caliente (colgó la suite 2.7h el 2026-07-09). Default:
+    // primer runtime, igual que hacía el selector único.
+    if (!render.ES_TTY || !process.stdin.isTTY) {
+      targets = [RUNTIMES[0].valor];
+      break;
+    }
+    tituloPaso1 = 'Paso 1/7 — Marca AL MENOS un runtime con espacio (Esc para cancelar)';
+  }
+  const target = targets[0]; // compat: preview/ejecutores leen .target
+
+  // 2. Perfil
+  const profile = await selectorUnico({
+    titulo: 'Paso 2/7 — ¿Qué perfil instalas?',
+    items: construirItemsPerfil(perfiles),
+    indiceDefault: 0,
+  });
+  if (!profile) return { exito: false, cancelado: true };
+
+  // 3. Scope
+  const scope = await selectorUnico({
+    titulo: 'Paso 3/7 — ¿Dónde se instala?',
+    items: SCOPES,
+    indiceDefault: 0,
+  });
+  if (!scope) return { exito: false, cancelado: true };
+
+  // 4. Flags
+  const flagsSeleccionados = await selectorMulti({
+    titulo: 'Paso 4/7 — Flags adicionales (espacio para toggle):',
+    items: FLAGS,
+  });
+  if (flagsSeleccionados === null) return { exito: false, cancelado: true };
+
+  // 5. Módulos opt-in (DT-MODULOS-OPT-IN) — fuera de todos los perfiles;
+  // solo se instalan por selección explícita. Se omite en modo solo-hooks
+  // (ese camino no copia componentes).
+  const soloHooks = flagsSeleccionados.includes('solo-hooks');
+  let modulosOptIn = [];
+  const itemsOptIn = soloHooks ? [] : cargarModulosOptIn();
+  if (itemsOptIn.length > 0) {
+    const elegidos = await selectorMulti({
+      titulo: 'Paso 5/7 — Módulos opt-in (fuera del perfil; espacio para marcar, Enter para omitir):',
+      items: itemsOptIn,
+    });
+    if (elegidos === null) return { exito: false, cancelado: true };
+    modulosOptIn = elegidos;
+  }
+
+  // 6. Stacks (solo si perfil = completo)
+  let stacks = [];
+  if (profile === 'completo' && !soloHooks) {
+    const elegidos = await selectorMulti({
+      titulo: 'Paso 6/7 — Stacks de lenguajes adicionales (perfil completo):',
+      items: STACKS_ADICIONALES,
+    });
+    if (elegidos === null) return { exito: false, cancelado: true };
+    stacks = elegidos;
+  }
+
+  const opciones = {
+    target,
+    targets,
+    profile,
+    global: scope === 'global',
+    with_mcp: flagsSeleccionados.includes('with-mcp'),
+    dry_run: flagsSeleccionados.includes('dry-run'),
+    'solo-hooks': soloHooks,
+    with: modulosOptIn.join(',') || undefined,
+    all_langs: stacks.length > 0,
+    stacks,
+  };
+
+  // 6. Preview
+  const procederPreview = await pantallaPreview(opciones, perfiles);
+  if (!procederPreview) return { exito: false, cancelado: true };
+
+  // 7. Confirmación final (selector único con 2 opciones para claridad visual)
+  const confirmacion = await selectorUnico({
+    titulo: 'Paso 7/7 — Confirmar e iniciar instalación',
+    items: [
+      {
+        valor: 'si',
+        etiqueta: 'Sí, instalar ahora',
+        descripcion: 'Ejecuta el plan y muestra progreso. Puedes usar dry-run en el paso 4 si solo quieres ver qué pasaría.',
+      },
+      {
+        valor: 'no',
+        etiqueta: 'No, cancelar',
+        descripcion: 'Vuelve al menú principal sin tocar nada.',
+      },
+    ],
+    indiceDefault: 0,
+  });
+
+  if (confirmacion !== 'si') return { exito: false, cancelado: true };
+
+  return { exito: true, opciones };
+}
+
+module.exports = {
+  ejecutarWizardInstall,
+  // exports auxiliares para tests
+  RUNTIMES,
+  SCOPES,
+  STACKS_ADICIONALES,
+  FLAGS,
+  cargarPerfiles,
+  construirItemsPerfil,
+  cargarModulosOptIn,
+};