@saulwade/swl-ses 2.4.1 → 2.4.3

package/manifiestos/skills-lock.json

@@ -1,8 +1,8 @@
 {
   "lockfileVersion": 1,
-  "generatedAt": "2026-07-04T01:11:41.591Z",
+  "generatedAt": "2026-07-04T03:32:42.479Z",
   "skillsCount": 182,
-  "lockHash": "sha256:11e9eee7053170aabbbc79839cb2619d024d8b4b95e6985c0f25cf3c3c458552",
+  "lockHash": "sha256:eed4668851d0500545bd6e3a769a2f9de54fd81c9f3b4936839a55800ba96622",
   "skills": [
     {
       "nombre": "accesibilidad-a11y",
@@ -609,9 +609,9 @@
     {
       "nombre": "harness-claude-code",
       "path": "habilidades/harness-claude-code/SKILL.md",
-      "hash": "sha256:7bcb9251d0478856ce349bab482c7c6a663d4f9fe5e26a70f9a214a720c27105",
-      "bytes": 15960,
-      "version": "\"1.0.2\""
+      "hash": "sha256:8afb83288a4b2bef3e4713c909f7e07d27a220fa5c4e19bb0f424fba16ab3c2b",
+      "bytes": 16803,
+      "version": "\"1.0.3\""
     },
     {
       "nombre": "iam-secretos",
@@ -1169,9 +1169,9 @@
     {
       "nombre": "tdd-workflow",
       "path": "habilidades/tdd-workflow/SKILL.md",
-      "hash": "sha256:ea41e35fac8dc05cd6c9199e84281e78c842e2bd01af793ce14c7b49dd6f1ae8",
-      "bytes": 35042,
-      "version": "\"1.2.2\""
+      "hash": "sha256:ca7d4f88d8d63528389aca2ef6a779c39bb65bdc751247a53cde891d9fb2d5ab",
+      "bytes": 35955,
+      "version": "\"1.2.3\""
     },
     {
       "nombre": "terraform-experto",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saulwade/swl-ses",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot con 60 agentes, 182 habilidades, 45 comandos, 77 reglas y 49 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. v1.8.0 unifica los directorios runtime de .planning/ al ingles (evolution/, auto-evolution/, user-profile/, archive/), manteniendo fases/ en espanol, con guard validar-planning-paths y allowlist canonica (ADR-0031). Hereda de v1.7.4: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
   "bin": {
     "swl-ses": "bin/swl-ses.js",

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "swl-ses",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 60 agentes, 182 habilidades, 45 comandos, 77 reglas y 49 hooks. 76 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021). v1.8.0 unifica los directorios runtime de .planning/ al ingles (evolution/, auto-evolution/, user-profile/, archive/), manteniendo fases/ en espanol, con guard validar-planning-paths y allowlist canonica (ADR-0031). Hereda de v1.7.4: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
   "author": "Saul Wade Leon",
   "license": "MIT",

package/reglas/arreglar-al-detectar.md

@@ -57,6 +57,22 @@ principio:
 - Si encuentras código adyacente que se quedó obsoleto por un refactor previo,
   actualizarlo. No dejar deuda residual.
 
+### Fix de clase, no de instancia (barrido por patrón obligatorio)
+
+- Si el bug corregido es un PATRÓN (regex incompleto, umbral mal calibrado,
+  construcción de path repetida, gate copy-pasteado) y no un typo puntual,
+  el MISMO turno incluye un `grep` de todos los hermanos del patrón en el
+  codebase y su corrección — o el registro explícito de por qué no aplica.
+- Arreglar solo la instancia que falló deja a los gemelos esperando el peor
+  momento para reventar. Evidencia doble (2026-07-03, swl-ses): se corrigió
+  el gate de reloj de un test sin barrer la clase → su gemelo tumbó el
+  `npm publish` de v2.4.0 horas después (bump de coordinación innecesario);
+  se corrigió el scope fantasma en el doctor sin barrer → quedaron 7 sitios
+  más con el mismo patrón, incluido un uninstall-wizard que ofrecía borrar
+  la instalación global de Claude Code.
+- Es la aplicación a FIXES del "sweep por patrón" que
+  `verificar-citas-normativas.md § Familia 2` ya exige para reportes.
+
 ### Al detectar un error ajeno al trabajo actual
 
 - NO bypassear (excluir tests del glob, comentar checks, `|| true`,

package/reglas/pruebas.md

@@ -86,9 +86,13 @@ Reglas del AAA:
   latencia en un test:
   - **Warm-up**: descartar las primeras iteraciones (cold-start de JIT/FS-cache).
   - **N ≥ 50 muestras** para un p95 estable.
-  - **Umbral tolerante a carga** (≥2× del presupuesto): detecta una regresión
-    gruesa sin flaquear por varianza; reportar el p95 observado en el mensaje del
-    assert para vigilar el presupuesto fino.
+  - **Umbral de ORDEN DE MAGNITUD (5-10× del presupuesto)**: el "≥2×" que esta
+    regla recomendaba resultó corto en la práctica — bajo la carga de
+    `npm publish` (suite + smoke + disco simultáneos) el 2× reventó DOS veces
+    (p95=208ms vs gate 200 en v2.3.x; p95=531ms vs gate 400=2× tumbó el publish
+    v2.4.0 y forzó un republish de coordinación, 2026-07-03). El gate bloqueante
+    solo debe atrapar regresiones de orden de magnitud; el presupuesto fino se
+    OBSERVA en el p95 impreso en el mensaje del assert, nunca se asevera duro.
   - **Mejor aún**: medir-y-avisar (benchmark/log) FUERA de la suite bloqueante;
     el gate duro detecta regresión, no afina el SLA.
 

package/scripts/actualizar.js

@@ -1,254 +1,253 @@
-'use strict';
-
-/**
- * swl-ses update
- * Actualiza componentes instalados preservando _userland/.
- * Interactivo: muestra versiones, pide confirmación, muestra progreso.
- * No-interactivo con --force o sin TTY.
- *
- * Modo --check (read-only):
- *   Solo muestra el estado actual de versiones (local vs npm vs runtimes instalados).
- *   No pide confirmación. No actualiza nada. Util para el autor o usuarios que
- *   quieren verificar si están al dia sin esperar al hook automatico.
- */
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { detectarRuntimes } = require('./lib/detectar-runtime');
-const { cargarEstado } = require('./lib/estado');
-const {
-  color, icono, encabezado, formatearPaso, formatearAdvertencia,
-  spinner, preguntarSiNo, lineaSeparadora, ES_TTY,
-} = require('./lib/ui');
-const { versionRemotaParalela, compararSemver } = require('./lib/npm-version');
-
-const VERSION_LOCAL = require('../package.json').version;
-
-/**
- * Consulta la versión más reciente publicada en npm. Si la consulta falla
- * (sin red, timeout), retorna la versión local como fallback razonable.
- */
-async function obtenerVersionRemota() {
-  const r = await versionRemotaParalela({ timeoutMs: 10000 });
-  return r.version || VERSION_LOCAL;
-}
-
-/**
- * Modo --check: muestra el estado actual sin actualizar. Read-only.
- *
- * Salida:
- *   - Version del paquete que esta ejecutando este CLI (VERSION_LOCAL).
- *   - Version mas reciente publicada en npm.
- *   - Comparacion semver: al dia / adelantado / atras.
- *   - Estado del hook check-update.js: ultima verificacion automatica.
- *   - Tabla por runtime instalado (si los detecta) con su versionSistema.
- */
-async function checkStatus() {
-  console.log(encabezado('swl-ses update --check', VERSION_LOCAL));
-
-  // Resolver version remota con timeout corto
-  const remota = await obtenerVersionRemota();
-  const cmp = compararSemver(VERSION_LOCAL, remota);
-
-  let estadoVersion;
-  if (cmp === null) {
-    estadoVersion = color.amarillo('Comparacion no disponible (formato inesperado)');
-  } else if (cmp === 0) {
-    estadoVersion = color.verde('Al dia');
-  } else if (cmp < 0) {
-    estadoVersion = color.amarillo(`Nueva version disponible (${remota})`);
-  } else {
-    estadoVersion = color.dim(`Local mas reciente que npm (${VERSION_LOCAL} > ${remota}, publicacion pendiente)`);
-  }
-
-  console.log(`  Paquete ejecutado:  ${color.negrita('v' + VERSION_LOCAL)}`);
-  console.log(`  Version en npm:     ${color.negrita('v' + remota)}`);
-  console.log(`  Estado:             ${estadoVersion}`);
-  console.log('');
-
-  // Estado del hook automatico (check-update.js).
-  // SWL_UPDATE_FLAG_PATH override solo para tests (evita race con flag único).
-  const flagPath = process.env.SWL_UPDATE_FLAG_PATH || path.join(os.tmpdir(), 'swl-ses-update-check.json');
-  try {
-    const flag = JSON.parse(fs.readFileSync(flagPath, 'utf8'));
-    const horas = ((Date.now() - flag.timestamp) / 3600000).toFixed(1);
-    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
-    console.log(`    Ultima verificacion: hace ${horas}h`);
-    console.log(`    Local registrada:    ${flag.local}`);
-    console.log(`    Remota registrada:   ${flag.remota || color.dim('(no resuelta)')}`);
-    console.log(`    hayNueva:            ${flag.hayNueva ? color.amarillo('si') : color.verde('no')}`);
-    console.log(`    Flag:                ${flagPath}`);
-  } catch {
-    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
-    console.log(`    ${color.dim('Sin flag de throttle — el hook nunca se ha ejecutado en este equipo,')}`);
-    console.log(`    ${color.dim('o el archivo temp/swl-ses-update-check.json fue removido.')}`);
-  }
-  console.log('');
-
-  // Estado por runtime instalado
-  const runtimes = detectarRuntimes();
-  if (runtimes.length === 0) {
-    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalacion SWL'));
-    console.log('');
-    return;
-  }
-
-  console.log(`  ${color.negrita('Runtimes detectados:')}`);
-  let totalRuntimes = 0;
-  for (const runtime of runtimes) {
-    const dirs = [runtime.global, path.resolve(runtime.local)];
-    for (const dir of dirs) {
-      if (!fs.existsSync(dir)) continue;
-      const estado = cargarEstado(dir);
-      if (!estado) continue;
-
-      const esGlobal = dir === runtime.global;
-      const ubicacion = esGlobal ? 'global' : 'proyecto';
-      const v = estado.versionSistema || 'desconocida';
-
-      const cmpRuntime = compararSemver(v, remota);
-      let etiqueta;
-      if (cmpRuntime === null) {
-        etiqueta = color.dim('(version no reconocida)');
-      } else if (cmpRuntime === 0) {
-        etiqueta = color.verde('al dia');
-      } else if (cmpRuntime < 0) {
-        etiqueta = color.amarillo(`atrasada (npm: ${remota})`);
-      } else {
-        etiqueta = color.dim('adelantada');
-      }
-
-      console.log(`    ${runtime.nombre} (${ubicacion}): v${v}  ${etiqueta}`);
-      totalRuntimes++;
-    }
-  }
-  if (totalRuntimes === 0) {
-    console.log(`    ${color.dim('(ninguno con .swl-install-state.json valido)')}`);
-  }
-  console.log('');
-  console.log(`  ${color.dim('Modo --check es read-only. Para actualizar:')} npx -y @saulwade/swl-ses@latest update`);
-  console.log('');
-}
-
-async function update(opciones) {
-  // Modo read-only: solo reportar estado, no tocar nada
-  if (opciones.check) {
-    await checkStatus();
-    return;
-  }
-
-  const force = opciones.force || !ES_TTY;
-
-  // Obtener la versión más reciente del registro npm
-  const VERSION = await obtenerVersionRemota();
-
-  console.log(encabezado('swl-ses update', VERSION_LOCAL));
-
-  // 1. Detectar runtimes
-  const runtimes = detectarRuntimes();
-
-  if (runtimes.length === 0) {
-    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalación SWL'));
-    console.log(`\n  Ejecuta primero: npx @saulwade/swl-ses@latest install --target claude`);
-    process.exit(1);
-  }
-
-  let actualizados = 0;
-  let omitidos = 0;
-
-  // 2. Iterar runtimes
-  for (const runtime of runtimes) {
-    const dirs = [runtime.global, path.resolve(runtime.local)];
-    for (const dir of dirs) {
-      if (!fs.existsSync(dir)) continue;
-
-      const estado = cargarEstado(dir);
-      if (!estado) continue;
-
-      const versionInstalada = estado.versionSistema || 'desconocida';
-      const esGlobal = dir === runtime.global;
-      const ubicacion = esGlobal ? 'global' : 'proyecto';
-
-      const necesitaActualizar = versionInstalada !== VERSION;
-      const paqueteDesactualizado = VERSION_LOCAL !== VERSION;
-
-      console.log(`  ${color.negrita(`Runtime: ${runtime.nombre}`)} ${color.dim(`(${ubicacion})`)}`);
-      console.log(`  Versión instalada:  ${necesitaActualizar ? color.amarillo(versionInstalada) : color.verde(versionInstalada)}`);
-      console.log(`  Versión disponible: ${color.verde(VERSION)}${paqueteDesactualizado ? color.dim(` (ejecutando con v${VERSION_LOCAL})`) : ''}`);
-      console.log(`  Perfil:             ${estado.perfil}`);
-      console.log(`  Componentes:        ${estado.componentesInstalados.length}`);
-      console.log(`  Archivos:           ${estado.archivosInstalados.length}`);
-      console.log('');
-
-      // Si la versión disponible es más reciente pero el paquete ejecutándose es viejo,
-      // indicar al usuario que use @latest
-      if (paqueteDesactualizado && necesitaActualizar) {
-        console.log(formatearAdvertencia(runtime.nombre,
-          `Este paquete es v${VERSION_LOCAL} pero la v${VERSION} está disponible.\n` +
-          `  Para actualizar, ejecuta: npx @saulwade/swl-ses@latest update --force`));
-        console.log('');
-        omitidos++;
-        continue;
-      }
-
-      // Verificar si ya está actualizado
-      if (!necesitaActualizar && !force) {
-        console.log(formatearPaso(runtime.nombre, 'Ya está en la versión más reciente'));
-        console.log('');
-        omitidos++;
-        continue;
-      }
-
-      // Confirmar
-      if (!force) {
-        const confirmar = await preguntarSiNo(
-          !necesitaActualizar
-            ? `¿Re-instalar ${runtime.nombre} v${VERSION}?`
-            : `¿Actualizar ${runtime.nombre} de ${versionInstalada} a ${VERSION}?`
-        );
-        console.log('');
-
-        if (!confirmar) {
-          console.log(formatearAdvertencia(runtime.nombre, 'Actualización cancelada por el usuario'));
-          console.log('');
-          omitidos++;
-          continue;
-        }
-      }
-
-      // Ejecutar actualización con spinner
-      const sp = spinner(`Actualizando ${runtime.nombre}...`);
-
-      try {
-        const instalador = require('./instalador');
-        await instalador({
-          target: runtime.id,
-          profile: estado.perfil,
-          global: estado.global,
-          force: true,
-        });
-
-        sp.exito(`${runtime.nombre} actualizado a v${VERSION} (${estado.archivosInstalados.length} archivos)`);
-        actualizados++;
-      } catch (err) {
-        sp.fallo(`Error actualizando ${runtime.nombre}: ${err.message}`);
-      }
-
-      console.log('');
-    }
-  }
-
-  // 3. Reporte final
-  console.log(`  ${lineaSeparadora()}`);
-  if (actualizados > 0) {
-    console.log(formatearPaso('Resultado', `${actualizados} runtime(s) actualizado(s)${omitidos > 0 ? `, ${omitidos} omitido(s)` : ''}`));
-  } else if (omitidos > 0) {
-    console.log(formatearPaso('Resultado', 'Todo está actualizado'));
-  } else {
-    console.log(formatearAdvertencia('Resultado', 'Ningún runtime fue actualizado'));
-  }
-  console.log('');
-}
-
-module.exports = update;
+'use strict';
+
+/**
+ * swl-ses update
+ * Actualiza componentes instalados preservando _userland/.
+ * Interactivo: muestra versiones, pide confirmación, muestra progreso.
+ * No-interactivo con --force o sin TTY.
+ *
+ * Modo --check (read-only):
+ *   Solo muestra el estado actual de versiones (local vs npm vs runtimes instalados).
+ *   No pide confirmación. No actualiza nada. Util para el autor o usuarios que
+ *   quieren verificar si están al dia sin esperar al hook automatico.
+ */
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { detectarRuntimes, scopesReales } = require('./lib/detectar-runtime');
+const { cargarEstado } = require('./lib/estado');
+const {
+  color, icono, encabezado, formatearPaso, formatearAdvertencia,
+  spinner, preguntarSiNo, lineaSeparadora, ES_TTY,
+} = require('./lib/ui');
+const { versionRemotaParalela, compararSemver } = require('./lib/npm-version');
+
+const VERSION_LOCAL = require('../package.json').version;
+
+/**
+ * Consulta la versión más reciente publicada en npm. Si la consulta falla
+ * (sin red, timeout), retorna la versión local como fallback razonable.
+ */
+async function obtenerVersionRemota() {
+  const r = await versionRemotaParalela({ timeoutMs: 10000 });
+  return r.version || VERSION_LOCAL;
+}
+
+/**
+ * Modo --check: muestra el estado actual sin actualizar. Read-only.
+ *
+ * Salida:
+ *   - Version del paquete que esta ejecutando este CLI (VERSION_LOCAL).
+ *   - Version mas reciente publicada en npm.
+ *   - Comparacion semver: al dia / adelantado / atras.
+ *   - Estado del hook check-update.js: ultima verificacion automatica.
+ *   - Tabla por runtime instalado (si los detecta) con su versionSistema.
+ */
+async function checkStatus() {
+  console.log(encabezado('swl-ses update --check', VERSION_LOCAL));
+
+  // Resolver version remota con timeout corto
+  const remota = await obtenerVersionRemota();
+  const cmp = compararSemver(VERSION_LOCAL, remota);
+
+  let estadoVersion;
+  if (cmp === null) {
+    estadoVersion = color.amarillo('Comparacion no disponible (formato inesperado)');
+  } else if (cmp === 0) {
+    estadoVersion = color.verde('Al dia');
+  } else if (cmp < 0) {
+    estadoVersion = color.amarillo(`Nueva version disponible (${remota})`);
+  } else {
+    estadoVersion = color.dim(`Local mas reciente que npm (${VERSION_LOCAL} > ${remota}, publicacion pendiente)`);
+  }
+
+  console.log(`  Paquete ejecutado:  ${color.negrita('v' + VERSION_LOCAL)}`);
+  console.log(`  Version en npm:     ${color.negrita('v' + remota)}`);
+  console.log(`  Estado:             ${estadoVersion}`);
+  console.log('');
+
+  // Estado del hook automatico (check-update.js).
+  // SWL_UPDATE_FLAG_PATH override solo para tests (evita race con flag único).
+  const flagPath = process.env.SWL_UPDATE_FLAG_PATH || path.join(os.tmpdir(), 'swl-ses-update-check.json');
+  try {
+    const flag = JSON.parse(fs.readFileSync(flagPath, 'utf8'));
+    const horas = ((Date.now() - flag.timestamp) / 3600000).toFixed(1);
+    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
+    console.log(`    Ultima verificacion: hace ${horas}h`);
+    console.log(`    Local registrada:    ${flag.local}`);
+    console.log(`    Remota registrada:   ${flag.remota || color.dim('(no resuelta)')}`);
+    console.log(`    hayNueva:            ${flag.hayNueva ? color.amarillo('si') : color.verde('no')}`);
+    console.log(`    Flag:                ${flagPath}`);
+  } catch {
+    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
+    console.log(`    ${color.dim('Sin flag de throttle — el hook nunca se ha ejecutado en este equipo,')}`);
+    console.log(`    ${color.dim('o el archivo temp/swl-ses-update-check.json fue removido.')}`);
+  }
+  console.log('');
+
+  // Estado por runtime instalado
+  const runtimes = detectarRuntimes();
+  if (runtimes.length === 0) {
+    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalacion SWL'));
+    console.log('');
+    return;
+  }
+
+  console.log(`  ${color.negrita('Runtimes detectados:')}`);
+  let totalRuntimes = 0;
+  for (const runtime of runtimes) {
+    // Dedup + guard anti-fantasma (ver scopesReales): desde HOME el local
+    // colapsa con el global propio o con el de otro runtime.
+    for (const { dir, esGlobal } of scopesReales(runtime)) {
+      if (!fs.existsSync(dir)) continue;
+      const estado = cargarEstado(dir);
+      if (!estado) continue;
+
+      const ubicacion = esGlobal ? 'global' : 'proyecto';
+      const v = estado.versionSistema || 'desconocida';
+
+      const cmpRuntime = compararSemver(v, remota);
+      let etiqueta;
+      if (cmpRuntime === null) {
+        etiqueta = color.dim('(version no reconocida)');
+      } else if (cmpRuntime === 0) {
+        etiqueta = color.verde('al dia');
+      } else if (cmpRuntime < 0) {
+        etiqueta = color.amarillo(`atrasada (npm: ${remota})`);
+      } else {
+        etiqueta = color.dim('adelantada');
+      }
+
+      console.log(`    ${runtime.nombre} (${ubicacion}): v${v}  ${etiqueta}`);
+      totalRuntimes++;
+    }
+  }
+  if (totalRuntimes === 0) {
+    console.log(`    ${color.dim('(ninguno con .swl-install-state.json valido)')}`);
+  }
+  console.log('');
+  console.log(`  ${color.dim('Modo --check es read-only. Para actualizar:')} npx -y @saulwade/swl-ses@latest update`);
+  console.log('');
+}
+
+async function update(opciones) {
+  // Modo read-only: solo reportar estado, no tocar nada
+  if (opciones.check) {
+    await checkStatus();
+    return;
+  }
+
+  const force = opciones.force || !ES_TTY;
+
+  // Obtener la versión más reciente del registro npm
+  const VERSION = await obtenerVersionRemota();
+
+  console.log(encabezado('swl-ses update', VERSION_LOCAL));
+
+  // 1. Detectar runtimes
+  const runtimes = detectarRuntimes();
+
+  if (runtimes.length === 0) {
+    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalación SWL'));
+    console.log(`\n  Ejecuta primero: npx @saulwade/swl-ses@latest install --target claude`);
+    process.exit(1);
+  }
+
+  let actualizados = 0;
+  let omitidos = 0;
+
+  // 2. Iterar runtimes
+  for (const runtime of runtimes) {
+    // Dedup + guard anti-fantasma (ver scopesReales).
+    for (const { dir, esGlobal } of scopesReales(runtime)) {
+      if (!fs.existsSync(dir)) continue;
+
+      const estado = cargarEstado(dir);
+      if (!estado) continue;
+
+      const versionInstalada = estado.versionSistema || 'desconocida';
+      const ubicacion = esGlobal ? 'global' : 'proyecto';
+
+      const necesitaActualizar = versionInstalada !== VERSION;
+      const paqueteDesactualizado = VERSION_LOCAL !== VERSION;
+
+      console.log(`  ${color.negrita(`Runtime: ${runtime.nombre}`)} ${color.dim(`(${ubicacion})`)}`);
+      console.log(`  Versión instalada:  ${necesitaActualizar ? color.amarillo(versionInstalada) : color.verde(versionInstalada)}`);
+      console.log(`  Versión disponible: ${color.verde(VERSION)}${paqueteDesactualizado ? color.dim(` (ejecutando con v${VERSION_LOCAL})`) : ''}`);
+      console.log(`  Perfil:             ${estado.perfil}`);
+      console.log(`  Componentes:        ${estado.componentesInstalados.length}`);
+      console.log(`  Archivos:           ${estado.archivosInstalados.length}`);
+      console.log('');
+
+      // Si la versión disponible es más reciente pero el paquete ejecutándose es viejo,
+      // indicar al usuario que use @latest
+      if (paqueteDesactualizado && necesitaActualizar) {
+        console.log(formatearAdvertencia(runtime.nombre,
+          `Este paquete es v${VERSION_LOCAL} pero la v${VERSION} está disponible.\n` +
+          `  Para actualizar, ejecuta: npx @saulwade/swl-ses@latest update --force`));
+        console.log('');
+        omitidos++;
+        continue;
+      }
+
+      // Verificar si ya está actualizado
+      if (!necesitaActualizar && !force) {
+        console.log(formatearPaso(runtime.nombre, 'Ya está en la versión más reciente'));
+        console.log('');
+        omitidos++;
+        continue;
+      }
+
+      // Confirmar
+      if (!force) {
+        const confirmar = await preguntarSiNo(
+          !necesitaActualizar
+            ? `¿Re-instalar ${runtime.nombre} v${VERSION}?`
+            : `¿Actualizar ${runtime.nombre} de ${versionInstalada} a ${VERSION}?`
+        );
+        console.log('');
+
+        if (!confirmar) {
+          console.log(formatearAdvertencia(runtime.nombre, 'Actualización cancelada por el usuario'));
+          console.log('');
+          omitidos++;
+          continue;
+        }
+      }
+
+      // Ejecutar actualización con spinner
+      const sp = spinner(`Actualizando ${runtime.nombre}...`);
+
+      try {
+        const instalador = require('./instalador');
+        await instalador({
+          target: runtime.id,
+          profile: estado.perfil,
+          global: estado.global,
+          force: true,
+        });
+
+        sp.exito(`${runtime.nombre} actualizado a v${VERSION} (${estado.archivosInstalados.length} archivos)`);
+        actualizados++;
+      } catch (err) {
+        sp.fallo(`Error actualizando ${runtime.nombre}: ${err.message}`);
+      }
+
+      console.log('');
+    }
+  }
+
+  // 3. Reporte final
+  console.log(`  ${lineaSeparadora()}`);
+  if (actualizados > 0) {
+    console.log(formatearPaso('Resultado', `${actualizados} runtime(s) actualizado(s)${omitidos > 0 ? `, ${omitidos} omitido(s)` : ''}`));
+  } else if (omitidos > 0) {
+    console.log(formatearPaso('Resultado', 'Todo está actualizado'));
+  } else {
+    console.log(formatearAdvertencia('Resultado', 'Ningún runtime fue actualizado'));
+  }
+  console.log('');
+}
+
+module.exports = update;