@saulwade/swl-ses 2.6.1 → 2.8.0

package/scripts/tui/ejecutores.js

@@ -1,375 +1,375 @@
-'use strict';
-
-/**
- * Ejecutores TUI — conectan los wizards con scripts/instalador.js y
- * scripts/actualizar.js a través del callback `onProgress`.
- *
- * Diseño:
- *   - El wizard devuelve un plan (opciones del instalador).
- *   - Se crea la pantalla Progreso con las categorías esperadas.
- *   - Se invoca al instalador con onProgress conectado a la pantalla.
- *   - Al terminar, se cierra Progreso y se muestra Resumen.
- *
- * Las funciones son async y devuelven el resultado de la operación
- * (sin tirar excepciones — los errores quedan en el objeto resultado).
- */
-
-const path = require('path');
-
-const { crearProgreso } = require('./pantallas/progreso');
-const { mostrarResumen } = require('./pantallas/resumen');
-
-const RAIZ_PKG = path.resolve(__dirname, '..', '..');
-
-// ---------------------------------------------------------------------------
-// Categorías que tracker el progreso. Total es estimación inicial — el
-// instalador puede emitir set-total para corregirlo si la cifra exacta
-// se conoce solo en runtime (depende del perfil).
-// ---------------------------------------------------------------------------
-
-function _categoriasDesdeOpciones(opciones) {
-  // Para los totales reales se podrían leer manifiestos. Por simplicidad,
-  // empezamos con totales nominales del proyecto y se ajustan con set-total
-  // si el instalador los provee.
-  return [
-    { nombre: 'agentes',     etiqueta: 'Agentes',     total: 0 },
-    { nombre: 'habilidades', etiqueta: 'Skills',      total: 0 },
-    { nombre: 'comandos',    etiqueta: 'Comandos',    total: 0 },
-    { nombre: 'reglas',      etiqueta: 'Reglas',      total: 0 },
-    { nombre: 'hooks',       etiqueta: 'Hooks',       total: 0 },
-    { nombre: 'schemas',     etiqueta: 'Schemas',     total: 0 },
-    { nombre: 'plantillas',  etiqueta: 'Plantillas',  total: 0 },
-  ];
-}
-
-function _calcularTotalesDelPlan(opciones) {
-  // Calcula el total estimado leyendo manifiestos/perfiles.json + modulos.json
-  // mediante resolverPerfil, que devuelve { perfil, modulos, archivos, warnings }.
-  try {
-    const { resolverPerfil } = require('../lib/manifiestos');
-    const resolucion = resolverPerfil(opciones.profile || 'completo', {});
-    if (!resolucion || !Array.isArray(resolucion.archivos)) return {};
-    const totales = {};
-    for (const archivo of resolucion.archivos) {
-      const tipo = archivo.tipo || 'otros';
-      totales[tipo] = (totales[tipo] || 0) + 1;
-    }
-    return totales;
-  } catch (_) {
-    return {};
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Ejecutar Install
-// ---------------------------------------------------------------------------
-
-/**
- * Ejecuta el install con UI de progreso conectada.
- *
- * @param {object} opciones - resultado del wizard Install (target, profile, global, etc.)
- * @returns {Promise<{ ok, totales, error? }>}
- */
-async function ejecutarInstall(opciones) {
-  const categorias = _categoriasDesdeOpciones(opciones);
-  const totalesEstimados = _calcularTotalesDelPlan(opciones);
-  for (const cat of categorias) {
-    if (totalesEstimados[cat.nombre]) cat.total = totalesEstimados[cat.nombre];
-  }
-
-  const ctrl = crearProgreso({
-    titulo: `Instalando perfil "${opciones.profile}" en ${opciones.target} (${opciones.global ? 'global' : 'proyecto'})`,
-    categorias,
-    verbose: !!opciones.verbose,
-  });
-  ctrl.iniciar();
-
-  let resultadoInstalador = null;
-  let error = null;
-
-  try {
-    const install = require('../instalador');
-    const fn = typeof install === 'function' ? install : install.install;
-    resultadoInstalador = await fn({
-      ...opciones,
-      onProgress: (evento) => ctrl.onEvento(evento),
-    });
-    ctrl.finalizar({
-      ok: true,
-      mensaje: opciones.dry_run
-        ? 'Dry-run completado (no se modificaron archivos)'
-        : 'Instalación completada con éxito',
-    });
-  } catch (e) {
-    error = e;
-    ctrl.finalizar({
-      ok: false,
-      mensaje: `Error: ${e.message}`,
-    });
-  }
-
-  await ctrl.esperarSalida();
-
-  // Resumen
-  const tabla = [
-    ['Runtime', opciones.target],
-    ['Perfil',  opciones.profile],
-    ['Scope',   opciones.global ? 'global' : 'proyecto'],
-  ];
-  if (opciones.with_mcp) tabla.push(['MCP', 'configurado']);
-  if (opciones.dry_run)  tabla.push(['Modo', 'dry-run (sin escribir)']);
-  if (opciones.stacks?.length > 0) tabla.push(['Stacks', opciones.stacks.join(', ')]);
-
-  await mostrarResumen({
-    operacion: 'install',
-    ok: !error,
-    tituloPrincipal: error ? 'Falló la instalación' : 'Instalación completada',
-    mensajeFinal: error ? error.message : undefined,
-    tabla,
-  });
-
-  return {
-    ok: !error,
-    error: error ? error.message : null,
-    resultado: resultadoInstalador,
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Ejecutar Update
-// ---------------------------------------------------------------------------
-
-/**
- * Ejecuta el update con UI de progreso. Itera por cada runtime+scope del
- * plan, llamando al instalador con force=true y onProgress conectado.
- *
- * @param {object} planUpdate - resultado del wizard Update
- * @returns {Promise<{ ok, actualizados, errores }>}
- */
-async function ejecutarUpdate(planUpdate) {
-  const { plan, versionPaquete, verbose } = planUpdate;
-  const categorias = _categoriasDesdeOpciones({});
-
-  const ctrl = crearProgreso({
-    titulo: `Actualizando ${plan.runtimes.length} runtime(s) a v${versionPaquete}`,
-    categorias,
-    verbose: !!verbose,
-  });
-  ctrl.iniciar();
-
-  let actualizados = 0;
-  const errores = [];
-
-  const install = require('../instalador');
-  const fn = typeof install === 'function' ? install : install.install;
-
-  for (const runtime of plan.runtimes) {
-    ctrl.onEvento({
-      tipo: 'log',
-      linea: `→ Actualizando ${runtime.runtimeNombre} (${runtime.scope})...`,
-    });
-
-    try {
-      await fn({
-        target: runtime.runtimeId,
-        profile: runtime.perfil,
-        global: runtime.esGlobal,
-        force: true,
-        versionAnterior: runtime.version,
-        versionActual: versionPaquete,
-        onProgress: (evento) => ctrl.onEvento(evento),
-      });
-      actualizados++;
-      ctrl.onEvento({
-        tipo: 'log',
-        linea: `  ✓ ${runtime.runtimeNombre} (${runtime.scope}) actualizado`,
-      });
-    } catch (e) {
-      errores.push({ runtime: runtime.id, error: e.message });
-      ctrl.onEvento({
-        tipo: 'log',
-        linea: `  ✗ ${runtime.runtimeNombre}: ${e.message}`,
-      });
-    }
-  }
-
-  const ok = errores.length === 0;
-  ctrl.finalizar({
-    ok,
-    mensaje: ok
-      ? `${actualizados} runtime(s) actualizado(s)`
-      : `${actualizados} ok, ${errores.length} con error`,
-  });
-  await ctrl.esperarSalida();
-
-  const tabla = [
-    ['Versión objetivo', `v${versionPaquete}`],
-    ['Runtimes en plan', String(plan.runtimes.length)],
-    ['Actualizados',     String(actualizados)],
-    ['Errores',          String(errores.length)],
-    ['Categorías',       plan.categorias.join(', ')],
-  ];
-
-  await mostrarResumen({
-    operacion: 'update',
-    ok,
-    tituloPrincipal: ok ? 'Actualización completada' : 'Actualización con errores',
-    mensajeFinal: errores.length > 0
-      ? `${errores.length} runtime(s) fallaron — revisa los logs`
-      : undefined,
-    tabla,
-  });
-
-  return { ok, actualizados, errores };
-}
-
-// ---------------------------------------------------------------------------
-// Ejecutar Uninstall (TUI completo, Fase 5)
-// ---------------------------------------------------------------------------
-
-/**
- * Ejecuta el uninstall con UI de progreso. Itera por cada instalación del
- * plan invocando scripts/desinstalar.js con onProgress conectado.
- *
- * @param {object} planUninstall - resultado del wizard Uninstall
- * @returns {Promise<{ ok, totalEliminados, totalBloques, errores }>}
- */
-async function ejecutarUninstall(planUninstall) {
-  if (!planUninstall || !planUninstall.plan) {
-    // Sin plan (caller no pasó datos del wizard) — devolver pendiente
-    await mostrarResumen({
-      operacion: 'uninstall',
-      ok: false,
-      tituloPrincipal: 'Uninstall sin plan',
-      mensajeFinal: 'Falta el resultado del wizard. Llama ejecutarUninstall(planUninstall) con el plan completo.',
-      tabla: [],
-    });
-    return { ok: false, pendiente: true };
-  }
-
-  const { seleccionadas } = planUninstall.plan;
-
-  const { crearProgreso: crear } = require('./pantallas/progreso');
-  const ctrl = crear({
-    titulo: `Desinstalando ${seleccionadas.length} instalación(es) SWL`,
-    categorias: [
-      { nombre: 'archivos-eliminados', etiqueta: 'Archivos',  total: 0 },
-      { nombre: 'bloques-limpiados',   etiqueta: 'Bloques',   total: 0 },
-      { nombre: 'hooks-quitados',      etiqueta: 'Hooks',     total: 0 },
-    ],
-    verbose: !!planUninstall.verbose,
-  });
-  ctrl.iniciar();
-
-  let totalEliminados = 0;
-  let totalBloques = 0;
-  let totalHooks = 0;
-  const errores = [];
-
-  const uninstall = require('../desinstalar');
-
-  for (const inst of seleccionadas) {
-    ctrl.onEvento({
-      tipo: 'log',
-      linea: `→ Desinstalando ${inst.runtimeNombre} (${inst.scope})...`,
-    });
-
-    try {
-      const resultado = uninstall({
-        target: inst.runtimeId,
-        global: inst.esGlobal,
-        onProgress: (evento) => {
-          // Mapear eventos del desinstalador a categorías de la pantalla
-          if (evento.tipo === 'archivo-eliminado') {
-            ctrl.onEvento({
-              tipo: 'archivo-copiado', // re-usa el contador de progreso
-              componente: 'archivos-eliminados',
-              archivo: evento.archivo,
-            });
-          } else if (evento.tipo === 'bloque-eliminado') {
-            ctrl.onEvento({
-              tipo: 'archivo-copiado',
-              componente: 'bloques-limpiados',
-              archivo: evento.archivo,
-            });
-          } else if (evento.tipo === 'hooks-desregistrados') {
-            for (let i = 0; i < evento.cuenta; i++) {
-              ctrl.onEvento({
-                tipo: 'archivo-copiado',
-                componente: 'hooks-quitados',
-              });
-            }
-          } else if (evento.tipo === 'log') {
-            ctrl.onEvento(evento);
-          } else if (evento.tipo === 'error') {
-            ctrl.onEvento({
-              tipo: 'log',
-              linea: `  ✗ ${evento.archivo || ''}: ${evento.mensaje}`,
-            });
-          }
-        },
-      });
-
-      totalEliminados += resultado.eliminados || 0;
-      totalBloques += resultado.bloquesEliminados || 0;
-      totalHooks += resultado.hooksDesregistrados || 0;
-
-      ctrl.onEvento({
-        tipo: 'log',
-        linea: `  ✓ ${inst.runtimeNombre} (${inst.scope}) limpiado`,
-      });
-    } catch (e) {
-      errores.push({ instalacion: inst.id, error: e.message });
-      ctrl.onEvento({
-        tipo: 'log',
-        linea: `  ✗ ${inst.runtimeNombre}: ${e.message}`,
-      });
-    }
-  }
-
-  const ok = errores.length === 0;
-  ctrl.finalizar({
-    ok,
-    mensaje: ok
-      ? `${totalEliminados} archivos eliminados, ${totalBloques} bloques limpiados`
-      : `${errores.length} instalación(es) con error`,
-  });
-  await ctrl.esperarSalida();
-
-  const tabla = [
-    ['Instalaciones procesadas', String(seleccionadas.length)],
-    ['Archivos eliminados',      String(totalEliminados)],
-    ['Bloques CLAUDE.md limpiados', String(totalBloques)],
-    ['Hooks desregistrados',     String(totalHooks)],
-  ];
-  if (errores.length > 0) {
-    tabla.push(['Errores', String(errores.length)]);
-  }
-
-  await mostrarResumen({
-    operacion: 'uninstall',
-    ok,
-    tituloPrincipal: ok ? 'Desinstalación completada' : 'Desinstalación con errores',
-    mensajeFinal: ok
-      ? '_userland/ y APRENDIZAJES.md fueron preservados.'
-      : 'Algunas instalaciones fallaron — revisa el log.',
-    tabla,
-  });
-
-  return {
-    ok,
-    totalEliminados,
-    totalBloques,
-    totalHooks,
-    errores,
-  };
-}
-
-module.exports = {
-  ejecutarInstall,
-  ejecutarUpdate,
-  ejecutarUninstall,
-  // exports para tests
-  _calcularTotalesDelPlan,
-  _categoriasDesdeOpciones,
-};
+'use strict';
+
+/**
+ * Ejecutores TUI — conectan los wizards con scripts/instalador.js y
+ * scripts/actualizar.js a través del callback `onProgress`.
+ *
+ * Diseño:
+ *   - El wizard devuelve un plan (opciones del instalador).
+ *   - Se crea la pantalla Progreso con las categorías esperadas.
+ *   - Se invoca al instalador con onProgress conectado a la pantalla.
+ *   - Al terminar, se cierra Progreso y se muestra Resumen.
+ *
+ * Las funciones son async y devuelven el resultado de la operación
+ * (sin tirar excepciones — los errores quedan en el objeto resultado).
+ */
+
+const path = require('path');
+
+const { crearProgreso } = require('./pantallas/progreso');
+const { mostrarResumen } = require('./pantallas/resumen');
+
+const RAIZ_PKG = path.resolve(__dirname, '..', '..');
+
+// ---------------------------------------------------------------------------
+// Categorías que tracker el progreso. Total es estimación inicial — el
+// instalador puede emitir set-total para corregirlo si la cifra exacta
+// se conoce solo en runtime (depende del perfil).
+// ---------------------------------------------------------------------------
+
+function _categoriasDesdeOpciones(opciones) {
+  // Para los totales reales se podrían leer manifiestos. Por simplicidad,
+  // empezamos con totales nominales del proyecto y se ajustan con set-total
+  // si el instalador los provee.
+  return [
+    { nombre: 'agentes',     etiqueta: 'Agentes',     total: 0 },
+    { nombre: 'habilidades', etiqueta: 'Skills',      total: 0 },
+    { nombre: 'comandos',    etiqueta: 'Comandos',    total: 0 },
+    { nombre: 'reglas',      etiqueta: 'Reglas',      total: 0 },
+    { nombre: 'hooks',       etiqueta: 'Hooks',       total: 0 },
+    { nombre: 'schemas',     etiqueta: 'Schemas',     total: 0 },
+    { nombre: 'plantillas',  etiqueta: 'Plantillas',  total: 0 },
+  ];
+}
+
+function _calcularTotalesDelPlan(opciones) {
+  // Calcula el total estimado leyendo manifiestos/perfiles.json + modulos.json
+  // mediante resolverPerfil, que devuelve { perfil, modulos, archivos, warnings }.
+  try {
+    const { resolverPerfil } = require('../lib/manifiestos');
+    const resolucion = resolverPerfil(opciones.profile || 'completo', {});
+    if (!resolucion || !Array.isArray(resolucion.archivos)) return {};
+    const totales = {};
+    for (const archivo of resolucion.archivos) {
+      const tipo = archivo.tipo || 'otros';
+      totales[tipo] = (totales[tipo] || 0) + 1;
+    }
+    return totales;
+  } catch (_) {
+    return {};
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Ejecutar Install
+// ---------------------------------------------------------------------------
+
+/**
+ * Ejecuta el install con UI de progreso conectada.
+ *
+ * @param {object} opciones - resultado del wizard Install (target, profile, global, etc.)
+ * @returns {Promise<{ ok, totales, error? }>}
+ */
+async function ejecutarInstall(opciones) {
+  const categorias = _categoriasDesdeOpciones(opciones);
+  const totalesEstimados = _calcularTotalesDelPlan(opciones);
+  for (const cat of categorias) {
+    if (totalesEstimados[cat.nombre]) cat.total = totalesEstimados[cat.nombre];
+  }
+
+  const ctrl = crearProgreso({
+    titulo: `Instalando perfil "${opciones.profile}" en ${opciones.target} (${opciones.global ? 'global' : 'proyecto'})`,
+    categorias,
+    verbose: !!opciones.verbose,
+  });
+  ctrl.iniciar();
+
+  let resultadoInstalador = null;
+  let error = null;
+
+  try {
+    const install = require('../instalador');
+    const fn = typeof install === 'function' ? install : install.install;
+    resultadoInstalador = await fn({
+      ...opciones,
+      onProgress: (evento) => ctrl.onEvento(evento),
+    });
+    ctrl.finalizar({
+      ok: true,
+      mensaje: opciones.dry_run
+        ? 'Dry-run completado (no se modificaron archivos)'
+        : 'Instalación completada con éxito',
+    });
+  } catch (e) {
+    error = e;
+    ctrl.finalizar({
+      ok: false,
+      mensaje: `Error: ${e.message}`,
+    });
+  }
+
+  await ctrl.esperarSalida();
+
+  // Resumen
+  const tabla = [
+    ['Runtime', opciones.target],
+    ['Perfil',  opciones.profile],
+    ['Scope',   opciones.global ? 'global' : 'proyecto'],
+  ];
+  if (opciones.with_mcp) tabla.push(['MCP', 'configurado']);
+  if (opciones.dry_run)  tabla.push(['Modo', 'dry-run (sin escribir)']);
+  if (opciones.stacks?.length > 0) tabla.push(['Stacks', opciones.stacks.join(', ')]);
+
+  await mostrarResumen({
+    operacion: 'install',
+    ok: !error,
+    tituloPrincipal: error ? 'Falló la instalación' : 'Instalación completada',
+    mensajeFinal: error ? error.message : undefined,
+    tabla,
+  });
+
+  return {
+    ok: !error,
+    error: error ? error.message : null,
+    resultado: resultadoInstalador,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Ejecutar Update
+// ---------------------------------------------------------------------------
+
+/**
+ * Ejecuta el update con UI de progreso. Itera por cada runtime+scope del
+ * plan, llamando al instalador con force=true y onProgress conectado.
+ *
+ * @param {object} planUpdate - resultado del wizard Update
+ * @returns {Promise<{ ok, actualizados, errores }>}
+ */
+async function ejecutarUpdate(planUpdate) {
+  const { plan, versionPaquete, verbose } = planUpdate;
+  const categorias = _categoriasDesdeOpciones({});
+
+  const ctrl = crearProgreso({
+    titulo: `Actualizando ${plan.runtimes.length} runtime(s) a v${versionPaquete}`,
+    categorias,
+    verbose: !!verbose,
+  });
+  ctrl.iniciar();
+
+  let actualizados = 0;
+  const errores = [];
+
+  const install = require('../instalador');
+  const fn = typeof install === 'function' ? install : install.install;
+
+  for (const runtime of plan.runtimes) {
+    ctrl.onEvento({
+      tipo: 'log',
+      linea: `→ Actualizando ${runtime.runtimeNombre} (${runtime.scope})...`,
+    });
+
+    try {
+      await fn({
+        target: runtime.runtimeId,
+        profile: runtime.perfil,
+        global: runtime.esGlobal,
+        force: true,
+        versionAnterior: runtime.version,
+        versionActual: versionPaquete,
+        onProgress: (evento) => ctrl.onEvento(evento),
+      });
+      actualizados++;
+      ctrl.onEvento({
+        tipo: 'log',
+        linea: `  ✓ ${runtime.runtimeNombre} (${runtime.scope}) actualizado`,
+      });
+    } catch (e) {
+      errores.push({ runtime: runtime.id, error: e.message });
+      ctrl.onEvento({
+        tipo: 'log',
+        linea: `  ✗ ${runtime.runtimeNombre}: ${e.message}`,
+      });
+    }
+  }
+
+  const ok = errores.length === 0;
+  ctrl.finalizar({
+    ok,
+    mensaje: ok
+      ? `${actualizados} runtime(s) actualizado(s)`
+      : `${actualizados} ok, ${errores.length} con error`,
+  });
+  await ctrl.esperarSalida();
+
+  const tabla = [
+    ['Versión objetivo', `v${versionPaquete}`],
+    ['Runtimes en plan', String(plan.runtimes.length)],
+    ['Actualizados',     String(actualizados)],
+    ['Errores',          String(errores.length)],
+    ['Categorías',       plan.categorias.join(', ')],
+  ];
+
+  await mostrarResumen({
+    operacion: 'update',
+    ok,
+    tituloPrincipal: ok ? 'Actualización completada' : 'Actualización con errores',
+    mensajeFinal: errores.length > 0
+      ? `${errores.length} runtime(s) fallaron — revisa los logs`
+      : undefined,
+    tabla,
+  });
+
+  return { ok, actualizados, errores };
+}
+
+// ---------------------------------------------------------------------------
+// Ejecutar Uninstall (TUI completo, Fase 5)
+// ---------------------------------------------------------------------------
+
+/**
+ * Ejecuta el uninstall con UI de progreso. Itera por cada instalación del
+ * plan invocando scripts/desinstalar.js con onProgress conectado.
+ *
+ * @param {object} planUninstall - resultado del wizard Uninstall
+ * @returns {Promise<{ ok, totalEliminados, totalBloques, errores }>}
+ */
+async function ejecutarUninstall(planUninstall) {
+  if (!planUninstall || !planUninstall.plan) {
+    // Sin plan (caller no pasó datos del wizard) — devolver pendiente
+    await mostrarResumen({
+      operacion: 'uninstall',
+      ok: false,
+      tituloPrincipal: 'Uninstall sin plan',
+      mensajeFinal: 'Falta el resultado del wizard. Llama ejecutarUninstall(planUninstall) con el plan completo.',
+      tabla: [],
+    });
+    return { ok: false, pendiente: true };
+  }
+
+  const { seleccionadas } = planUninstall.plan;
+
+  const { crearProgreso: crear } = require('./pantallas/progreso');
+  const ctrl = crear({
+    titulo: `Desinstalando ${seleccionadas.length} instalación(es) SWL`,
+    categorias: [
+      { nombre: 'archivos-eliminados', etiqueta: 'Archivos',  total: 0 },
+      { nombre: 'bloques-limpiados',   etiqueta: 'Bloques',   total: 0 },
+      { nombre: 'hooks-quitados',      etiqueta: 'Hooks',     total: 0 },
+    ],
+    verbose: !!planUninstall.verbose,
+  });
+  ctrl.iniciar();
+
+  let totalEliminados = 0;
+  let totalBloques = 0;
+  let totalHooks = 0;
+  const errores = [];
+
+  const uninstall = require('../desinstalar');
+
+  for (const inst of seleccionadas) {
+    ctrl.onEvento({
+      tipo: 'log',
+      linea: `→ Desinstalando ${inst.runtimeNombre} (${inst.scope})...`,
+    });
+
+    try {
+      const resultado = uninstall({
+        target: inst.runtimeId,
+        global: inst.esGlobal,
+        onProgress: (evento) => {
+          // Mapear eventos del desinstalador a categorías de la pantalla
+          if (evento.tipo === 'archivo-eliminado') {
+            ctrl.onEvento({
+              tipo: 'archivo-copiado', // re-usa el contador de progreso
+              componente: 'archivos-eliminados',
+              archivo: evento.archivo,
+            });
+          } else if (evento.tipo === 'bloque-eliminado') {
+            ctrl.onEvento({
+              tipo: 'archivo-copiado',
+              componente: 'bloques-limpiados',
+              archivo: evento.archivo,
+            });
+          } else if (evento.tipo === 'hooks-desregistrados') {
+            for (let i = 0; i < evento.cuenta; i++) {
+              ctrl.onEvento({
+                tipo: 'archivo-copiado',
+                componente: 'hooks-quitados',
+              });
+            }
+          } else if (evento.tipo === 'log') {
+            ctrl.onEvento(evento);
+          } else if (evento.tipo === 'error') {
+            ctrl.onEvento({
+              tipo: 'log',
+              linea: `  ✗ ${evento.archivo || ''}: ${evento.mensaje}`,
+            });
+          }
+        },
+      });
+
+      totalEliminados += resultado.eliminados || 0;
+      totalBloques += resultado.bloquesEliminados || 0;
+      totalHooks += resultado.hooksDesregistrados || 0;
+
+      ctrl.onEvento({
+        tipo: 'log',
+        linea: `  ✓ ${inst.runtimeNombre} (${inst.scope}) limpiado`,
+      });
+    } catch (e) {
+      errores.push({ instalacion: inst.id, error: e.message });
+      ctrl.onEvento({
+        tipo: 'log',
+        linea: `  ✗ ${inst.runtimeNombre}: ${e.message}`,
+      });
+    }
+  }
+
+  const ok = errores.length === 0;
+  ctrl.finalizar({
+    ok,
+    mensaje: ok
+      ? `${totalEliminados} archivos eliminados, ${totalBloques} bloques limpiados`
+      : `${errores.length} instalación(es) con error`,
+  });
+  await ctrl.esperarSalida();
+
+  const tabla = [
+    ['Instalaciones procesadas', String(seleccionadas.length)],
+    ['Archivos eliminados',      String(totalEliminados)],
+    ['Bloques CLAUDE.md limpiados', String(totalBloques)],
+    ['Hooks desregistrados',     String(totalHooks)],
+  ];
+  if (errores.length > 0) {
+    tabla.push(['Errores', String(errores.length)]);
+  }
+
+  await mostrarResumen({
+    operacion: 'uninstall',
+    ok,
+    tituloPrincipal: ok ? 'Desinstalación completada' : 'Desinstalación con errores',
+    mensajeFinal: ok
+      ? '_userland/ y APRENDIZAJES.md fueron preservados.'
+      : 'Algunas instalaciones fallaron — revisa el log.',
+    tabla,
+  });
+
+  return {
+    ok,
+    totalEliminados,
+    totalBloques,
+    totalHooks,
+    errores,
+  };
+}
+
+module.exports = {
+  ejecutarInstall,
+  ejecutarUpdate,
+  ejecutarUninstall,
+  // exports para tests
+  _calcularTotalesDelPlan,
+  _categoriasDesdeOpciones,
+};