@saulwade/swl-ses 2.3.1 → 2.4.2

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

@@ -1,232 +1,234 @@
-'use strict';
-
-/**
- * Wizard de actualización TUI.
- * Reemplaza el flujo simple de scripts/actualizar.js que pregunta una vez
- * por runtime con un wizard visual:
- *
- *   1. Detectar runtimes instalados (con su versión, perfil, scope)
- *   2. Multi-select de runtimes a actualizar (default: todos los desactualizados)
- *   3. Multi-select de categorías de componentes a refrescar
- *      (skills, hooks, agentes, reglas, comandos, schemas, plantillas)
- *   4. Diff preview: ¿qué cambia entre versión instalada y nueva?
- *   5. Confirmación final
- *
- * Devuelve el plan completo o { cancelado: true }.
- */
-
-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 CATEGORIAS = [
-  { valor: 'agentes',     etiqueta: 'Agentes',     descripcion: '60 agentes especializados (orquestador, revisor, depurador, etc.)' },
-  { valor: 'habilidades', etiqueta: 'Skills',      descripcion: '162 skills cargables bajo demanda' },
-  { valor: 'comandos',    etiqueta: 'Comandos',    descripcion: '44 comandos /swl:* del runtime' },
-  { valor: 'reglas',      etiqueta: 'Reglas',      descripcion: '66 reglas obligatorias' },
-  { valor: 'hooks',       etiqueta: 'Hooks',       descripcion: '41 hooks de pre/post-tool' },
-  { valor: 'schemas',     etiqueta: 'Schemas',     descripcion: 'JSON schemas de validación' },
-  { valor: 'plantillas',  etiqueta: 'Plantillas',  descripcion: 'Plantillas para .planning/' },
-  { valor: 'manifiestos', etiqueta: 'Manifiestos', descripcion: 'Catálogos de módulos, perfiles y hooks' },
-];
-
-// ---------------------------------------------------------------------------
-// Detección
-// ---------------------------------------------------------------------------
-
-function _detectarInstalaciones() {
-  let detectarRuntimes, cargarEstado;
-  try {
-    ({ detectarRuntimes } = require('../../lib/detectar-runtime'));
-    ({ cargarEstado } = require('../../lib/estado'));
-  } catch (_) {
-    return [];
-  }
-
-  const versionPaquete = require('../../../package.json').version;
-  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 {
-        if (!fs.existsSync(ruta)) continue;
-        const estado = cargarEstado(ruta);
-        if (!estado) continue;
-        const version = estado.versionSistema || 'desconocida';
-        filas.push({
-          id: `${runtime.id}:${scope}`,
-          runtimeId: runtime.id,
-          runtimeNombre: runtime.nombre,
-          scope,
-          version,
-          perfil: estado.perfil || '-',
-          esGlobal: scope === 'global',
-          desactualizada: version !== versionPaquete,
-          componentes: estado.componentesInstalados?.length || 0,
-        });
-      } catch (_) {
-        // ignorar
-      }
-    }
-  }
-  return filas;
-}
-
-// ---------------------------------------------------------------------------
-// Pantalla de diff preview
-// ---------------------------------------------------------------------------
-
-function _pantallaDiff(plan, versionPaquete) {
-  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 de la actualización'));
-      render.escribirEn(3, 3, colores.dim(`Versión disponible: v${versionPaquete}`));
-
-      render.escribirEn(5, 3, semantico.enfasis('Runtimes a actualizar:'));
-      plan.runtimes.forEach((r, i) => {
-        const versionEstado = r.version === versionPaquete
-          ? semantico.exito(`v${r.version}`)
-          : semantico.warn(`v${r.version} → v${versionPaquete}`);
-        const linea =
-          `${iconos.arrow} ${render.rellenarDer(colores.negrita(r.runtimeNombre), 18)}` +
-          render.rellenarDer(`(${r.scope})`, 12) +
-          render.rellenarDer(r.perfil, 18) +
-          versionEstado;
-        render.escribirEn(6 + i, 5, linea);
-      });
-
-      const filaCat = 7 + plan.runtimes.length;
-      render.escribirEn(filaCat, 3, semantico.enfasis('Componentes a refrescar:'));
-      plan.categorias.forEach((c, i) => {
-        const cat = CATEGORIAS.find(x => x.valor === c);
-        const lab = cat ? cat.etiqueta : c;
-        render.escribirEn(filaCat + 1 + i, 5,
-          `${colores.verde(iconos.check)} ${lab}`);
-      });
-
-      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(v) {
-      teclado.desactivar();
-      process.stdout.removeListener('resize', onResize);
-      render.salirModoTui();
-      resolve(v);
-    }
-    teclado.on('return', () => _finalizar(true));
-    teclado.on('escape', () => _finalizar(false));
-    teclado.activar();
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Wizard principal
-// ---------------------------------------------------------------------------
-
-async function ejecutarWizardUpdate() {
-  const versionPaquete = require('../../../package.json').version;
-  const instalaciones = _detectarInstalaciones();
-
-  if (instalaciones.length === 0) {
-    return {
-      exito: false,
-      error: 'No se detectaron instalaciones SWL para actualizar.',
-      sugerencia: 'Ejecuta primero swl-ses install para crear una instalación.',
-    };
-  }
-
-  // 1. Multi-select de runtimes a actualizar
-  const itemsRuntimes = instalaciones.map(i => ({
-    valor: i.id,
-    etiqueta: `${i.runtimeNombre} (${i.scope}) — v${i.version} · perfil ${i.perfil}`,
-    descripcion: i.desactualizada
-      ? `Desactualizado. Subirá de v${i.version} a v${versionPaquete}. ${i.componentes} componentes.`
-      : `Ya está en v${versionPaquete}. Re-instalación refrescará archivos sin cambio de versión.`,
-    preseleccionado: i.desactualizada, // por default, solo los desactualizados
-  }));
-
-  const idsElegidos = await selectorMulti({
-    titulo: 'Paso 1/4 — ¿Qué runtimes actualizas?',
-    items: itemsRuntimes,
-  });
-  if (idsElegidos === null) return { exito: false, cancelado: true };
-  if (idsElegidos.length === 0) {
-    return { exito: false, vacio: true, error: 'No seleccionaste ningún runtime para actualizar.' };
-  }
-
-  const runtimesPlan = instalaciones.filter(i => idsElegidos.includes(i.id));
-
-  // 2. Multi-select de categorías
-  const categoriasElegidas = await selectorMulti({
-    titulo: 'Paso 2/4 — ¿Qué categorías de componentes refrescas?',
-    items: CATEGORIAS.map(c => ({ ...c, preseleccionado: true })),
-  });
-  if (categoriasElegidas === null) return { exito: false, cancelado: true };
-  if (categoriasElegidas.length === 0) {
-    return { exito: false, vacio: true, error: 'No seleccionaste ninguna categoría.' };
-  }
-
-  const plan = {
-    runtimes: runtimesPlan,
-    categorias: categoriasElegidas,
-  };
-
-  // 3. Diff preview
-  const proceder = await _pantallaDiff(plan, versionPaquete);
-  if (!proceder) return { exito: false, cancelado: true };
-
-  // 4. Confirmación final
-  const confirmacion = await selectorUnico({
-    titulo: 'Paso 4/4 — Confirmar e iniciar actualización',
-    items: [
-      {
-        valor: 'si',
-        etiqueta: 'Sí, actualizar ahora',
-        descripcion: `Actualiza ${plan.runtimes.length} runtime(s) en ${plan.categorias.length} categorías. La operación es idempotente; archivos sin cambio quedan iguales.`,
-      },
-      {
-        valor: 'no',
-        etiqueta: 'No, cancelar',
-        descripcion: 'Volver al menú sin tocar nada.',
-      },
-    ],
-  });
-  if (confirmacion !== 'si') return { exito: false, cancelado: true };
-
-  return { exito: true, plan, versionPaquete };
-}
-
-module.exports = {
-  ejecutarWizardUpdate,
-  // exports para tests
-  CATEGORIAS,
-  _detectarInstalaciones,
-};
+'use strict';
+
+/**
+ * Wizard de actualización TUI.
+ * Reemplaza el flujo simple de scripts/actualizar.js que pregunta una vez
+ * por runtime con un wizard visual:
+ *
+ *   1. Detectar runtimes instalados (con su versión, perfil, scope)
+ *   2. Multi-select de runtimes a actualizar (default: todos los desactualizados)
+ *   3. Multi-select de categorías de componentes a refrescar
+ *      (skills, hooks, agentes, reglas, comandos, schemas, plantillas)
+ *   4. Diff preview: ¿qué cambia entre versión instalada y nueva?
+ *   5. Confirmación final
+ *
+ * Devuelve el plan completo o { cancelado: true }.
+ */
+
+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 CATEGORIAS = [
+  { valor: 'agentes',     etiqueta: 'Agentes',     descripcion: '60 agentes especializados (orquestador, revisor, depurador, etc.)' },
+  { valor: 'habilidades', etiqueta: 'Skills',      descripcion: '162 skills cargables bajo demanda' },
+  { valor: 'comandos',    etiqueta: 'Comandos',    descripcion: '44 comandos /swl:* del runtime' },
+  { valor: 'reglas',      etiqueta: 'Reglas',      descripcion: '66 reglas obligatorias' },
+  { valor: 'hooks',       etiqueta: 'Hooks',       descripcion: '41 hooks de pre/post-tool' },
+  { valor: 'schemas',     etiqueta: 'Schemas',     descripcion: 'JSON schemas de validación' },
+  { valor: 'plantillas',  etiqueta: 'Plantillas',  descripcion: 'Plantillas para .planning/' },
+  { valor: 'manifiestos', etiqueta: 'Manifiestos', descripcion: 'Catálogos de módulos, perfiles y hooks' },
+];
+
+// ---------------------------------------------------------------------------
+// Detección
+// ---------------------------------------------------------------------------
+
+function _detectarInstalaciones() {
+  let detectarRuntimes, cargarEstado;
+  try {
+    ({ detectarRuntimes, scopesReales } = require('../../lib/detectar-runtime'));
+    ({ cargarEstado } = require('../../lib/estado'));
+  } catch (_) {
+    return [];
+  }
+
+  const versionPaquete = require('../../../package.json').version;
+  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 {
+        if (!fs.existsSync(ruta)) continue;
+        const estado = cargarEstado(ruta);
+        if (!estado) continue;
+        const version = estado.versionSistema || 'desconocida';
+        filas.push({
+          id: `${runtime.id}:${scope}`,
+          runtimeId: runtime.id,
+          runtimeNombre: runtime.nombre,
+          scope,
+          version,
+          perfil: estado.perfil || '-',
+          esGlobal: scope === 'global',
+          desactualizada: version !== versionPaquete,
+          componentes: estado.componentesInstalados?.length || 0,
+        });
+      } catch (_) {
+        // ignorar
+      }
+    }
+  }
+  return filas;
+}
+
+// ---------------------------------------------------------------------------
+// Pantalla de diff preview
+// ---------------------------------------------------------------------------
+
+function _pantallaDiff(plan, versionPaquete) {
+  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 de la actualización'));
+      render.escribirEn(3, 3, colores.dim(`Versión disponible: v${versionPaquete}`));
+
+      render.escribirEn(5, 3, semantico.enfasis('Runtimes a actualizar:'));
+      plan.runtimes.forEach((r, i) => {
+        const versionEstado = r.version === versionPaquete
+          ? semantico.exito(`v${r.version}`)
+          : semantico.warn(`v${r.version} → v${versionPaquete}`);
+        const linea =
+          `${iconos.arrow} ${render.rellenarDer(colores.negrita(r.runtimeNombre), 18)}` +
+          render.rellenarDer(`(${r.scope})`, 12) +
+          render.rellenarDer(r.perfil, 18) +
+          versionEstado;
+        render.escribirEn(6 + i, 5, linea);
+      });
+
+      const filaCat = 7 + plan.runtimes.length;
+      render.escribirEn(filaCat, 3, semantico.enfasis('Componentes a refrescar:'));
+      plan.categorias.forEach((c, i) => {
+        const cat = CATEGORIAS.find(x => x.valor === c);
+        const lab = cat ? cat.etiqueta : c;
+        render.escribirEn(filaCat + 1 + i, 5,
+          `${colores.verde(iconos.check)} ${lab}`);
+      });
+
+      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(v) {
+      teclado.desactivar();
+      process.stdout.removeListener('resize', onResize);
+      render.salirModoTui();
+      resolve(v);
+    }
+    teclado.on('return', () => _finalizar(true));
+    teclado.on('escape', () => _finalizar(false));
+    teclado.activar();
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Wizard principal
+// ---------------------------------------------------------------------------
+
+async function ejecutarWizardUpdate() {
+  const versionPaquete = require('../../../package.json').version;
+  const instalaciones = _detectarInstalaciones();
+
+  if (instalaciones.length === 0) {
+    return {
+      exito: false,
+      error: 'No se detectaron instalaciones SWL para actualizar.',
+      sugerencia: 'Ejecuta primero swl-ses install para crear una instalación.',
+    };
+  }
+
+  // 1. Multi-select de runtimes a actualizar
+  const itemsRuntimes = instalaciones.map(i => ({
+    valor: i.id,
+    etiqueta: `${i.runtimeNombre} (${i.scope}) — v${i.version} · perfil ${i.perfil}`,
+    descripcion: i.desactualizada
+      ? `Desactualizado. Subirá de v${i.version} a v${versionPaquete}. ${i.componentes} componentes.`
+      : `Ya está en v${versionPaquete}. Re-instalación refrescará archivos sin cambio de versión.`,
+    preseleccionado: i.desactualizada, // por default, solo los desactualizados
+  }));
+
+  const idsElegidos = await selectorMulti({
+    titulo: 'Paso 1/4 — ¿Qué runtimes actualizas?',
+    items: itemsRuntimes,
+  });
+  if (idsElegidos === null) return { exito: false, cancelado: true };
+  if (idsElegidos.length === 0) {
+    return { exito: false, vacio: true, error: 'No seleccionaste ningún runtime para actualizar.' };
+  }
+
+  const runtimesPlan = instalaciones.filter(i => idsElegidos.includes(i.id));
+
+  // 2. Multi-select de categorías
+  const categoriasElegidas = await selectorMulti({
+    titulo: 'Paso 2/4 — ¿Qué categorías de componentes refrescas?',
+    items: CATEGORIAS.map(c => ({ ...c, preseleccionado: true })),
+  });
+  if (categoriasElegidas === null) return { exito: false, cancelado: true };
+  if (categoriasElegidas.length === 0) {
+    return { exito: false, vacio: true, error: 'No seleccionaste ninguna categoría.' };
+  }
+
+  const plan = {
+    runtimes: runtimesPlan,
+    categorias: categoriasElegidas,
+  };
+
+  // 3. Diff preview
+  const proceder = await _pantallaDiff(plan, versionPaquete);
+  if (!proceder) return { exito: false, cancelado: true };
+
+  // 4. Confirmación final
+  const confirmacion = await selectorUnico({
+    titulo: 'Paso 4/4 — Confirmar e iniciar actualización',
+    items: [
+      {
+        valor: 'si',
+        etiqueta: 'Sí, actualizar ahora',
+        descripcion: `Actualiza ${plan.runtimes.length} runtime(s) en ${plan.categorias.length} categorías. La operación es idempotente; archivos sin cambio quedan iguales.`,
+      },
+      {
+        valor: 'no',
+        etiqueta: 'No, cancelar',
+        descripcion: 'Volver al menú sin tocar nada.',
+      },
+    ],
+  });
+  if (confirmacion !== 'si') return { exito: false, cancelado: true };
+
+  return { exito: true, plan, versionPaquete };
+}
+
+module.exports = {
+  ejecutarWizardUpdate,
+  // exports para tests
+  CATEGORIAS,
+  _detectarInstalaciones,
+};