@saulwade/swl-ses 1.5.2 → 1.6.0

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# CLAUDE.md — @saulwade/swl-ses v1.5.2
+# CLAUDE.md — @saulwade/swl-ses v1.6.0
 
 ## Reglas de máxima prioridad (aplican SIEMPRE, sin excepción)
 

package/README.md

@@ -1,4 +1,4 @@
-# swl-ses v1.5.2
+# swl-ses v1.6.0
 
 > El paquete anterior `@saulwadeleon/swl-software-engineering-system` está deprecado. Migrar a `@saulwade/swl-ses` (npmjs.org canónico) o `@saul-wade/swl-ses` (mirror en GitHub Packages) — el CLI `swl-ses` no cambia.
 
@@ -6,7 +6,7 @@ Sistema de ingeniería de software auto-evolutivo **multi-runtime** con agentes
 
 Soporta 7 runtimes de IA: Claude Code, OpenClaude, OpenCode y Gemini CLI (soporte completo); Cursor, Codex CLI y GitHub Copilot (soporte parcial — reglas + MCP server o consolidación en archivo de instrucciones según el runtime). Incluye sistema de transformadores que adapta el formato canónico SWL al formato nativo de cada runtime, **multi-target install** (`--target=claude,cursor,codex` en una sola invocación), y **`swl-mcp-server` v1.0.0** con auth opt-in para que Cursor, Codex y otros clientes MCP consulten la memoria SWL (aprendizajes, instintos, sesiones).
 
-Cubre el SDLC completo: discovery, requisitos, arquitectura, UX/UI, frontend, backend, mobile, datos, testing, seguridad, CI/CD, observabilidad, releases, documentación, notificaciones y auto-evolución. Incluye sistema de notificaciones Telegram opt-in (hook saliente, bot bidireccional con 15 comandos, autostart cross-platform) y **auditoría profunda Nemesis** (loop iterativo Feynman + State Inconsistency hasta convergencia) con 8 tools ejecutables JSON-output para code-profiler, pentest-scanner, dep-doctor, bundle-tracker y más (ADR-0018, v1.4.1).
+Cubre el SDLC completo: discovery, requisitos, arquitectura, UX/UI, frontend, backend, mobile, datos, testing, seguridad, CI/CD, observabilidad, releases, documentación, notificaciones y auto-evolución. Incluye sistema de notificaciones Telegram opt-in (hook saliente, bot bidireccional con 15 comandos, autostart cross-platform), **auditoría profunda Nemesis** (loop iterativo Feynman + State Inconsistency hasta convergencia, ahora con loop evaluator-optimizer opt-in vía `/swl:nemesis --remediar` desde v1.5.2 - ADR-0021) con 8 tools ejecutables JSON-output para code-profiler, pentest-scanner, dep-doctor, bundle-tracker y más (ADR-0018, v1.4.1), e **instalador/actualizador TUI custom** zero-deps con paneles, multi-select y barra de progreso por categoría (v1.6.0).
 
 ## Inventario
 
@@ -56,6 +56,23 @@ El setup requiere **dos comandos en orden**, con propósitos distintos:
 > y los hace disponibles en todos tus proyectos. Aun así, cada proyecto necesita su propio `init`
 > para obtener `.planning/` y `_userland/`.
 
+### Modo recomendado: TUI visual (v1.6.0+)
+
+Desde v1.6.0, al ejecutar `install` o `update` sin flags desde una terminal
+interactiva, swl-ses lanza un **TUI custom** con paneles, selectores con
+flechas, multi-select con espacio y barra de progreso por categoría.
+
+```bash
+# Lanza el TUI: Welcome → Menú → Wizard → Progreso → Resumen
+npx -y @saulwade/swl-ses@latest install
+npx -y @saulwade/swl-ses@latest update
+```
+
+Opt-out con `--no-tui` para usar el asistido lineal clásico, o pasa cualquier
+flag (`--target`, `--profile`, `--force`, etc.) y el CLI usa el flujo directo
+sin prompts. Ver [`MANUAL_USO.md`](./MANUAL_USO.md) sección "Opción C — Modo
+TUI visual" para capturas ASCII de cada pantalla.
+
 ### Opción 1: CLI vía npmjs (recomendada)
 
 ```bash

package/bin/swl-ses.js

@@ -190,7 +190,7 @@ GESTIÓN DE COMPONENTES:
   agents remove <nombre>        Remueve un agente individual
 
 OPCIONES DE INSTALL:
-  --target <runtime>     Runtime destino: claude|openclaude|copilot|opencode|codex|gemini (default: claude)
+  --target <runtime>     Runtime destino: claude|openclaude|copilot|opencode|codex|gemini|cursor (default: claude)
   --profile <perfil>     Perfil: core|backend-python|backend-node|frontend-react|frontend-angular|
                          fullstack-python-angular|fullstack-node-react|mobile|devops|completo (default: core)
   --with <componentes>   Incluir componentes adicionales (separados por coma)
@@ -200,10 +200,19 @@ OPCIONES DE INSTALL:
   --dry-run              Mostrar plan sin aplicar cambios
   --force                Sobreescribir archivos existentes sin confirmar
   --all-langs            Instalar reglas de todos los lenguajes (omite detección automática de stack)
+  --with-mcp             Configura el MCP server swl-memory automáticamente (v1.5.0+)
+  --tui                  Fuerza el modo TUI visual aunque pases otros flags (v1.6.0+)
+  --no-tui               Desactiva el TUI; usa el asistido lineal clásico (v1.6.0+)
+  --verbose              Expande el panel de log del Progreso del TUI de 8 a 24 líneas (v1.6.0+)
   --no-claudemd          No modificar el CLAUDE.md del proyecto (solo aplica con --target claude).
                          Por defecto el instalador crea o actualiza un bloque delimitado por
                          <!-- SWL-BEGIN vX.Y.Z --> / <!-- SWL-END --> preservando el resto del archivo.
 
+MODOS DE INVOCACIÓN (v1.6.0+):
+  TTY + sin flags        → TUI visual completo (recomendado)
+  TTY + --no-tui         → Asistido lineal clásico (preguntas en serie)
+  No-TTY o con flags     → Modo directo sin prompts (CI/scripts)
+
 OPCIONES DE SKILLS/AGENTS:
   --skill <nombre>       Nombre del skill a extraer del repo (con skills add)
   --agent <nombre>       Nombre del agente a extraer del repo (con agents add)
@@ -215,11 +224,14 @@ OPCIONES GENERALES:
 
 EJEMPLOS:
   ${NOMBRE} init
-  ${NOMBRE} install                                    (modo asistido — recomendado para primera vez)
+  ${NOMBRE} install                                    (TUI visual — recomendado para primera vez)
+  ${NOMBRE} install --no-tui                           (asistido lineal clásico)
   ${NOMBRE} install --target claude --profile backend-python
   ${NOMBRE} install --target openclaude --profile fullstack-python-angular
   ${NOMBRE} install --target gemini --profile core
   ${NOMBRE} install --target copilot --profile fullstack-node-react
+  ${NOMBRE} update                                     (TUI visual con multi-select de runtimes)
+  ${NOMBRE} update --no-tui                            (preguntas lineales clásicas)
   ${NOMBRE} skills list --target claude
   ${NOMBRE} skills add https://github.com/user/repo --skill mi-skill
   ${NOMBRE} agents add ./path/local --agent mi-agente
@@ -312,14 +324,44 @@ function main() {
 
   const opciones = parsearOpciones(args.slice(1));
 
-  // Modo asistido: `install` sin flags → flujo interactivo
-  // (Si el usuario pasa cualquier flag relevante, se asume que sabe lo que hace.)
-  if (comando === 'install') {
-    const flagsIrrelevantesParaAsistido = ['verbose'];
+  // Modo asistido / TUI: `install` o `update` sin flags relevantes → modo visual.
+  //
+  // Niveles de fallback:
+  //   1. TTY + sin flags (excepto --tui): lanzar TUI completo (scripts/tui/index.js)
+  //   2. TTY + --no-tui: lanzar install-asistido clásico (preguntarOpcion lineal)
+  //   3. No TTY (CI/pipe): flujo clásico con flags por defecto sin asistido
+  //
+  // El usuario puede forzar el TUI incluso con flags pasando --tui.
+  if (comando === 'install' || comando === 'update') {
+    const flagsIrrelevantesParaAsistido = ['verbose', 'tui'];
     const flagsEspecificados = Object.keys(opciones).filter(
       k => k !== '_args' && !flagsIrrelevantesParaAsistido.includes(k)
     );
-    if (flagsEspecificados.length === 0) {
+    const stdinTty = !!process.stdin.isTTY;
+    const optoutTui = opciones['no-tui'] || opciones.no_tui;
+    const forzarTui = opciones.tui;
+    const sinFlags = flagsEspecificados.length === 0;
+
+    if ((sinFlags || forzarTui) && stdinTty && !optoutTui) {
+      try {
+        const { iniciarTui } = require('../scripts/tui');
+        iniciarTui({ operacionInicial: comando }).then(() => {
+          process.exit(0);
+        }).catch(err => {
+          console.error(`Error en TUI: ${err.message}`);
+          if (opciones.verbose) console.error(err.stack);
+          process.exit(1);
+        });
+        return;
+      } catch (err) {
+        console.error(`Error cargando TUI: ${err.message}`);
+        if (opciones.verbose) console.error(err.stack);
+        // Caer al asistido clásico como fallback
+      }
+    }
+
+    if (comando === 'install' && sinFlags && !forzarTui) {
+      // Fallback al asistido lineal (sin TUI) — preserva la UX de versiones previas
       try {
         const asistido = require('../scripts/comandos/install-asistido');
         asistido.main().catch(err => {

package/hooks/extraccion-aprendizajes.js

@@ -618,6 +618,17 @@ const PATRONES_ARCHIVO_SWL_EXCLUIDO = [
   /(?:^|[\\/])plantillas[\\/]/,
   /(?:^|[\\/])contextos[\\/]/,
   /(?:^|[\\/])instintos[\\/]/,
+  // Tests (cualquier convención): los comentarios JSDoc/docstring de un test
+  // describen el SUT y suelen contener palabras como "bug", "patrón", "fix"
+  // de forma narrativa-descriptiva, no como descubrimiento. Detectado cuando
+  // el hook capturó comentarios del propio test que valida un fix y los
+  // promovió a APRENDIZAJES.md como entradas truncadas.
+  /(?:^|[\\/])tests?[\\/]/,
+  /(?:^|[\\/])__tests__[\\/]/,
+  /(?:^|[\\/])spec[\\/]/,
+  /\.(?:test|spec)\.(?:js|ts|jsx|tsx|mjs|cjs)$/i,
+  /(?:^|[\\/])test_.*\.py$/,
+  /_test\.(?:py|go)$/i,
   // Todo .planning/ salvo wiki/ (que puede contener conocimiento del proyecto usuario).
   // En swl-ses .planning/ es meta del sistema; los aprendizajes se gestionan manualmente.
   /(?:^|[\\/])\.planning[\\/](?!wiki[\\/])/,

package/manifiestos/skills-lock.json

@@ -1,8 +1,8 @@
 {
   "lockfileVersion": 1,
-  "generatedAt": "2026-05-15T04:05:25.970Z",
-  "skillsCount": 158,
-  "lockHash": "sha256:e8aa8826b7a7285c7a0f182973b7565db338c7bb6a13707b6c518b2ac980b096",
+  "generatedAt": "2026-05-16T18:45:23.117Z",
+  "skillsCount": 162,
+  "lockHash": "sha256:20e7bde29e6c2ca22f9fa77c436ebc2a9085d6f45c0378478ba2d7717f00875c",
   "skills": [
     {
       "nombre": "accesibilidad-a11y",
@@ -343,9 +343,9 @@
     {
       "nombre": "discutir-fase",
       "path": "habilidades/discutir-fase/SKILL.md",
-      "hash": "sha256:63963663eebf79a3966660e60ebdf797fccae4130faf4cae667d8b2e40cfd826",
-      "bytes": 8370,
-      "version": "\"1.0.0\""
+      "hash": "sha256:c3e77c9a40ee4fcec31d26a0be8e34b915c6ce1d704b02900456328669f4fad5",
+      "bytes": 11591,
+      "version": "\"1.1.0\""
     },
     {
       "nombre": "diseno-herramientas-agente",
@@ -396,6 +396,13 @@
       "bytes": 19364,
       "version": "\"1.1.0\""
     },
+    {
+      "nombre": "ejecutar-task-iterativo",
+      "path": "habilidades/ejecutar-task-iterativo/SKILL.md",
+      "hash": "sha256:ca8780fd72ad10dd21085c6cbbbd3baa0e625c0ba0834e1c3ec8e2b5934b88ba",
+      "bytes": 13131,
+      "version": "\"1.0.0\""
+    },
     {
       "nombre": "estilo-sin-ai-isms",
       "path": "habilidades/estilo-sin-ai-isms/SKILL.md",
@@ -651,9 +658,9 @@
     {
       "nombre": "meta-skills-estandar",
       "path": "habilidades/meta-skills-estandar/SKILL.md",
-      "hash": "sha256:6c2861defb5f5c46c1ac851ecf2ec06958be714fd14d3f7f512ba916b43e3b7b",
-      "bytes": 13101,
-      "version": "\"1.0.0\""
+      "hash": "sha256:4908de280db0d143643fc96ae748519edc2142aa9ef35c415cd84074c274d613",
+      "bytes": 23181,
+      "version": "\"1.1.1\""
     },
     {
       "nombre": "microservicios",
@@ -690,6 +697,20 @@
       "bytes": 11807,
       "version": "\"1.0.1\""
     },
+    {
+      "nombre": "nemesis-evaluacion-json",
+      "path": "habilidades/nemesis-evaluacion-json/SKILL.md",
+      "hash": "sha256:e8c84252b6d6080101486b5acc021af14c9eeab6d25b71a0fc0f450177d5782d",
+      "bytes": 10610,
+      "version": null
+    },
+    {
+      "nombre": "nemesis-redistribuir",
+      "path": "habilidades/nemesis-redistribuir/SKILL.md",
+      "hash": "sha256:171919fe921f411b065644ab09a93bd32c68fa74f43669d83522ad237e4b0590",
+      "bytes": 13610,
+      "version": null
+    },
     {
       "nombre": "nestjs-experto",
       "path": "habilidades/nestjs-experto/SKILL.md",
@@ -721,9 +742,9 @@
     {
       "nombre": "node-experto",
       "path": "habilidades/node-experto/SKILL.md",
-      "hash": "sha256:8002768234ffb90d057d2d626488015c68bc969556e026b8c66542c681f3b8e6",
-      "bytes": 13538,
-      "version": "\"1.0.1\""
+      "hash": "sha256:bf8ea36fadabf2b7a30590a2a1658ca39ddb15b4285c709db4379c631259f2b2",
+      "bytes": 19290,
+      "version": "\"1.0.2\""
     },
     {
       "nombre": "notificaciones-multicanal",
@@ -837,6 +858,13 @@
       "bytes": 21302,
       "version": "\"1.1.0\""
     },
+    {
+      "nombre": "protocolo-revision-swl",
+      "path": "habilidades/protocolo-revision-swl/SKILL.md",
+      "hash": "sha256:5ebbe37b828d70f7e5190f49116fd56e75280cc9a39e5c53302064e211437215",
+      "bytes": 15867,
+      "version": "\"1.0.1\""
+    },
     {
       "nombre": "rag-arquitectura",
       "path": "habilidades/rag-arquitectura/SKILL.md",
@@ -1001,9 +1029,9 @@
     {
       "nombre": "tdd-workflow",
       "path": "habilidades/tdd-workflow/SKILL.md",
-      "hash": "sha256:5f63f554a6a54e1a3b9d47f2497ae12176eb955418d2b0b138a168475dc1d820",
-      "bytes": 17424,
-      "version": "\"1.0.2\""
+      "hash": "sha256:5bc34fef3315efa871c56210fc1942f430e1b5fb61dc54ab23891c352555e638",
+      "bytes": 23870,
+      "version": "\"1.0.4\""
     },
     {
       "nombre": "terraform-experto",
@@ -1078,9 +1106,9 @@
     {
       "nombre": "verificar-trabajo",
       "path": "habilidades/verificar-trabajo/SKILL.md",
-      "hash": "sha256:001fd34fbeefbe995c4b76fb55fa1a5277577f701b098998f189fd7d0c35e40e",
-      "bytes": 14619,
-      "version": "\"1.1.1\""
+      "hash": "sha256:4aeab56aee56b7b481d8e2c59a4da505ad5bad6abff22e83e4e116c58fa1bbbf",
+      "bytes": 21346,
+      "version": "\"1.2.1\""
     },
     {
       "nombre": "web-fetcher-routing",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saulwade/swl-ses",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot con 60 agentes, 162 habilidades, 44 comandos, 66 reglas y 41 hooks. Soporta 11 lenguajes y 7 runtimes: Claude Code, OpenClaude, OpenCode, Gemini CLI, Cursor, Codex CLI (soporte completo); GitHub Copilot (soporte parcial). 100% en espanol (Mexico). Multi-target install (--target CSV / --all-runtimes), autoconfig MCP en Cursor/Codex con --with-mcp, agentes Codex en TOML, hooks Cursor (17 eventos) y Codex (6 eventos). Gateway bidireccional con relay Telegram y auditoria profunda Nemesis con loop evaluator-optimizer opt-in (ADR-0021) y 8 tools ejecutables.",
   "bin": {
     "swl-ses": "bin/swl-ses.js",
@@ -28,12 +28,13 @@
   ],
   "scripts": {
     "postinstall": "echo '\n  swl-software-engineering-system instalado.\n  Ejecuta: npx swl-ses init\n'",
-    "test": "node --test tests/lib/*.test.js tests/scripts/*.test.js tests/scripts/lib/*.test.js tests/hooks/*.test.js tests/gateway/*.test.js tests/bin/*.test.js tests/transformadores/*.test.js tests/mcp-server/*.test.js",
+    "test": "node --test tests/lib/*.test.js tests/scripts/*.test.js tests/scripts/lib/*.test.js tests/scripts/tui/*.test.js tests/hooks/*.test.js tests/gateway/*.test.js tests/bin/*.test.js tests/transformadores/*.test.js tests/mcp-server/*.test.js",
     "test:validate": "node scripts/validar.js",
     "test:manifest": "node scripts/validar-manifest.js",
+    "test:docs": "node scripts/verificar-docs-vs-codigo.js",
     "test:smoke": "node scripts/smoke-test.js",
     "test:aislamiento": "node scripts/validar-tests-aislamiento.js",
-    "test:all": "npm test && node scripts/validar.js && node scripts/validar-manifest.js",
+    "test:all": "npm test && node scripts/validar.js && node scripts/validar-manifest.js && node scripts/verificar-docs-vs-codigo.js",
     "test:userland": "node scripts/validar-userland-vacio.js",
     "test:release": "npm run test:all && npm run test:userland && npm run test:smoke",
     "doctor": "node scripts/doctor.js",

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "swl-ses",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 60 agentes, 162 habilidades, 44 comandos, 66 reglas y 41 hooks. 62 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021).",
   "author": "Saul Wade Leon",
   "license": "MIT",
@@ -62,6 +62,7 @@
     "habilidades/doubt-driven-review",
     "habilidades/drift-detection",
     "habilidades/ejecutar-fase",
+    "habilidades/ejecutar-task-iterativo",
     "habilidades/estilo-sin-ai-isms",
     "habilidades/estructura-proyecto-claude",
     "habilidades/eval-framework",
@@ -127,6 +128,7 @@
     "habilidades/prevencion-sobreingenieria",
     "habilidades/privacy-memoria",
     "habilidades/prompt-engineering",
+    "habilidades/protocolo-revision-swl",
     "habilidades/rag-arquitectura",
     "habilidades/rails-experto",
     "habilidades/react-experto",

package/scripts/desinstalar.js

@@ -3,6 +3,22 @@
 /**
  * swl-ses uninstall
  * Desinstala componentes SWL del runtime especificado.
+ *
+ * Contrato adicional: opciones.onProgress(evento)
+ *
+ * Si se pasa una función onProgress, el desinstalador emite eventos
+ * estructurados en vez de imprimir cada archivo a stdout:
+ *   { tipo: 'archivo-eliminado',  componente, archivo, destino }
+ *   { tipo: 'bloque-eliminado',   archivo, etiqueta }
+ *   { tipo: 'archivo-no-encontrado', archivo }
+ *   { tipo: 'error',              archivo, mensaje }
+ *   { tipo: 'log',                linea }
+ *
+ * Backward compat: si onProgress no se pasa, los console.log son idénticos
+ * a antes. El CLI clásico (uninstall sin TUI) no cambia.
+ *
+ * Devuelve { eliminados, noEncontrados, bloquesEliminados } para que el
+ * caller (TUI) pueda mostrar resumen sin re-parsear stdout.
  */
 
 const fs = require('fs');
@@ -15,23 +31,40 @@ const { eliminarBloque } = require('./lib/append-con-marcadores');
 function uninstall(opciones) {
   const target = opciones.target || 'claude';
   const esGlobal = opciones.global || false;
+  const onProgress = typeof opciones.onProgress === 'function' ? opciones.onProgress : null;
 
-  console.log('swl-ses uninstall');
-  console.log('='.repeat(40));
+  function _emitir(evento, mensajeFallback) {
+    if (onProgress) {
+      onProgress(evento);
+    } else if (mensajeFallback) {
+      console.log(mensajeFallback);
+    }
+  }
+
+  if (!onProgress) {
+    console.log('swl-ses uninstall');
+    console.log('='.repeat(40));
+  }
 
   const runtime = obtenerRuntime(target);
   const rutas = calcularRutas(target, { global: esGlobal });
 
   const estado = cargarEstado(rutas.base);
   if (!estado) {
+    if (onProgress) {
+      onProgress({ tipo: 'log', linea: `No se encontró instalación SWL en ${rutas.base}` });
+      return { eliminados: 0, noEncontrados: 0, bloquesEliminados: 0, error: 'instalacion-no-encontrada' };
+    }
     console.log(`No se encontró instalación SWL en ${rutas.base}`);
     process.exit(1);
   }
 
-  console.log(`Target: ${target} (${runtime.nombre})`);
-  console.log(`Ubicación: ${rutas.base}`);
-  console.log(`Archivos a eliminar: ${estado.archivosInstalados.length}`);
-  console.log('');
+  if (!onProgress) {
+    console.log(`Target: ${target} (${runtime.nombre})`);
+    console.log(`Ubicación: ${rutas.base}`);
+    console.log(`Archivos a eliminar: ${estado.archivosInstalados.length}`);
+    console.log('');
+  }
 
   let eliminados = 0;
   let noEncontrados = 0;
@@ -56,10 +89,17 @@ function uninstall(opciones) {
       if (accionInstall === 'creado') {
         try {
           fs.unlinkSync(archivo.destino);
-          console.log(`  - ${archivo.destino} (creado por swl-ses, eliminación completa)`);
+          _emitir(
+            { tipo: 'archivo-eliminado', componente: archivo.tipo, archivo: archivo.destino, motivo: 'creado-por-swl' },
+            `  - ${archivo.destino} (creado por swl-ses, eliminación completa)`
+          );
           eliminados++;
         } catch (err) {
-          console.error(`  ! Error eliminando ${archivo.destino}: ${err.message}`);
+          _emitir(
+            { tipo: 'error', archivo: archivo.destino, mensaje: err.message },
+            null
+          );
+          if (!onProgress) console.error(`  ! Error eliminando ${archivo.destino}: ${err.message}`);
         }
       } else {
         try {
@@ -70,12 +110,19 @@ function uninstall(opciones) {
             'sin-cambios':        'sin bloque SWL presente (ya limpio)',
             'error':              `error: ${r.detalle || 'desconocido'}`,
           }[r.accion] || r.accion;
-          console.log(`  ~ ${archivo.destino} (${etiqueta})`);
+          _emitir(
+            { tipo: 'bloque-eliminado', archivo: archivo.destino, etiqueta, accion: r.accion },
+            `  ~ ${archivo.destino} (${etiqueta})`
+          );
           if (r.accion === 'bloque-eliminado' || r.accion === 'archivo-eliminado') {
             bloquesEliminados++;
           }
         } catch (err) {
-          console.error(`  ! Error limpiando bloque en ${archivo.destino}: ${err.message}`);
+          _emitir(
+            { tipo: 'error', archivo: archivo.destino, mensaje: err.message },
+            null
+          );
+          if (!onProgress) console.error(`  ! Error limpiando bloque en ${archivo.destino}: ${err.message}`);
         }
       }
       continue;
@@ -88,26 +135,47 @@ function uninstall(opciones) {
       } else {
         fs.unlinkSync(archivo.destino);
       }
-      console.log(`  - ${archivo.destino}`);
+      _emitir(
+        { tipo: 'archivo-eliminado', componente: archivo.tipo, archivo: archivo.destino },
+        `  - ${archivo.destino}`
+      );
       eliminados++;
     } catch (err) {
-      console.error(`  ! Error eliminando ${archivo.destino}: ${err.message}`);
+      _emitir(
+        { tipo: 'error', archivo: archivo.destino, mensaje: err.message },
+        null
+      );
+      if (!onProgress) console.error(`  ! Error eliminando ${archivo.destino}: ${err.message}`);
     }
   }
 
   // Desregistrar hooks de settings.json
+  let hooksDesregistrados = 0;
+  let hooksPreservados = 0;
   if (runtime.soportaHooks) {
     const settingsPath = rutaSettings(runtime, rutas.base);
     try {
       const resultado = desregistrarHooks(settingsPath);
-      if (resultado.eliminados > 0) {
-        console.log(`  - Hooks desregistrados de settings.json: ${resultado.eliminados}`);
+      hooksDesregistrados = resultado.eliminados || 0;
+      hooksPreservados = resultado.preservados || 0;
+      if (hooksDesregistrados > 0) {
+        _emitir(
+          { tipo: 'hooks-desregistrados', cuenta: hooksDesregistrados },
+          `  - Hooks desregistrados de settings.json: ${hooksDesregistrados}`
+        );
       }
-      if (resultado.preservados > 0) {
-        console.log(`    (${resultado.preservados} hooks externos preservados)`);
+      if (hooksPreservados > 0) {
+        _emitir(
+          { tipo: 'hooks-preservados', cuenta: hooksPreservados },
+          `    (${hooksPreservados} hooks externos preservados)`
+        );
       }
     } catch (err) {
-      console.error(`  ! Error desregistrando hooks: ${err.message}`);
+      _emitir(
+        { tipo: 'error', mensaje: `Error desregistrando hooks: ${err.message}` },
+        null
+      );
+      if (!onProgress) console.error(`  ! Error desregistrando hooks: ${err.message}`);
     }
   }
 
@@ -117,14 +185,27 @@ function uninstall(opciones) {
     fs.unlinkSync(estadoPath);
   }
 
-  console.log('');
-  console.log(`Eliminados: ${eliminados}`);
-  if (bloquesEliminados > 0) {
-    console.log(`Bloques SWL quitados (contenido de usuario preservado): ${bloquesEliminados}`);
+  if (!onProgress) {
+    console.log('');
+    console.log(`Eliminados: ${eliminados}`);
+    if (bloquesEliminados > 0) {
+      console.log(`Bloques SWL quitados (contenido de usuario preservado): ${bloquesEliminados}`);
+    }
+    console.log(`No encontrados: ${noEncontrados}`);
+    console.log('');
+    console.log('Nota: .planning/ y _userland/ no se eliminan (contienen datos del proyecto).');
   }
-  console.log(`No encontrados: ${noEncontrados}`);
-  console.log('');
-  console.log('Nota: .planning/ y _userland/ no se eliminan (contienen datos del proyecto).');
+
+  return {
+    eliminados,
+    noEncontrados,
+    bloquesEliminados,
+    hooksDesregistrados,
+    hooksPreservados,
+    target,
+    scope: esGlobal ? 'global' : 'proyecto',
+    ubicacion: rutas.base,
+  };
 }
 
 module.exports = uninstall;

package/scripts/instalador.js

@@ -42,6 +42,24 @@ const { actualizarGitignore, entradasParaRuntime, limpiarTracked, leerManifest,
 const RAIZ_PKG = path.resolve(__dirname, '..');
 const VERSION = require('../package.json').version;
 
+/**
+ * Contrato adicional: `opciones.onProgress(evento)`
+ *
+ * Si se pasa una función `opciones.onProgress`, el instalador deja de imprimir
+ * cada archivo copiado/backup/symlink a stdout y en su lugar emite eventos
+ * estructurados que el caller (típicamente la TUI) puede consumir para mostrar
+ * barra de progreso + contadores por categoría.
+ *
+ * Eventos emitidos:
+ *   { tipo: 'archivo-copiado', componente: 'agentes'|'habilidades'|... , archivo: 'nombre.md' }
+ *   { tipo: 'backup',          componente: <tipo>, archivo, rutaBackup }
+ *   { tipo: 'symlink',         componente: <tipo>, archivo }
+ *   { tipo: 'colision',        componente: <tipo>, archivo }
+ *   { tipo: 'log',             linea: 'mensaje libre' }   — para mensajes informativos
+ *
+ * Backward compat: si onProgress NO se pasa, los console.log siguen iguales.
+ * El comportamiento sin TUI no cambia.
+ */
 async function install(opciones) {
   // Leer manifest .swl-ses si existe — sus valores son defaults que el CLI puede sobreescribir
   const manifest = leerManifest(process.cwd());
@@ -990,7 +1008,15 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
 
   // Verificar colisión
   if (fs.existsSync(destino) && !opciones.force) {
-    console.log(`  - Colisión: ${nombreArchivo} (usa --force para sobreescribir)`);
+    if (typeof opciones.onProgress === 'function') {
+      opciones.onProgress({
+        tipo: 'colision',
+        componente: archivo.tipo,
+        archivo: nombreArchivo,
+      });
+    } else {
+      console.log(`  - Colisión: ${nombreArchivo} (usa --force para sobreescribir)`);
+    }
     return { instalado: false, colision: true };
   }
 
@@ -998,7 +1024,16 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
   if (fs.existsSync(destino) && opciones.force && opciones.versionAnterior) {
     const backup = crearBackup(process.cwd(), destino, opciones.versionAnterior);
     if (backup.respaldado) {
-      console.log(`  ↩ Backup: ${nombreArchivo} → ${path.relative(process.cwd(), backup.rutaBackup)}`);
+      if (typeof opciones.onProgress === 'function') {
+        opciones.onProgress({
+          tipo: 'backup',
+          componente: archivo.tipo,
+          archivo: nombreArchivo,
+          rutaBackup: backup.rutaBackup,
+        });
+      } else {
+        console.log(`  ↩ Backup: ${nombreArchivo} → ${path.relative(process.cwd(), backup.rutaBackup)}`);
+      }
       if (opciones.estado) {
         registrarBackup(opciones.estado, {
           rutaOriginal: destino,
@@ -1027,7 +1062,15 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
         }
         const origenAbsoluto = path.resolve(archivo.origen);
         fs.symlinkSync(origenAbsoluto, destino, stat.isDirectory() ? 'junction' : 'file');
-        console.log(`  ~ ${path.relative(rutas.base, destino)} (symlink)`);
+        if (typeof opciones.onProgress === 'function') {
+          opciones.onProgress({
+            tipo: 'symlink',
+            componente: archivo.tipo,
+            archivo: nombreArchivo,
+          });
+        } else {
+          console.log(`  ~ ${path.relative(rutas.base, destino)} (symlink)`);
+        }
         return { instalado: true, destino };
       } catch (symlinkErr) {
         // Fallback a copy si symlink falla (permisos, filesystem)
@@ -1045,7 +1088,15 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
     } else {
       fs.copyFileSync(archivo.origen, destino);
     }
-    console.log(`  + ${path.relative(rutas.base, destino)}`);
+    if (typeof opciones.onProgress === 'function') {
+      opciones.onProgress({
+        tipo: 'archivo-copiado',
+        componente: archivo.tipo,
+        archivo: nombreArchivo,
+      });
+    } else {
+      console.log(`  + ${path.relative(rutas.base, destino)}`);
+    }
     return { instalado: true, destino };
   } else {
     return { instalado: false, razon: 'origen no existe' };

package/scripts/lib/parsear-opciones.js

@@ -45,6 +45,9 @@ const BOOLEANAS = [
   // ADR-0019 — Codex/Cursor + MCP autoconfig opt-in
   'with-mcp', 'no-mcp',
   'all-runtimes',
+  // TUI opt-out (Fase 4 instalador visual). Default: si stdin es TTY y no
+  // hay flags, lanza el TUI. Con --no-tui cae al install-asistido clásico.
+  'no-tui', 'tui',
 ];
 
 /**