@saulwade/swl-ses 2.3.1 → 2.4.2

package/scripts/mcp-server/cache.js

@@ -1,106 +1,106 @@
-'use strict';
-
-/**
- * Cache mtime-based para handlers del swl-mcp-server v1.0.0 (ADR-0019 Sub-fase 3).
- *
- * El stub experimental leía disco en cada call (latencia medida ~10ms con
- * APRENDIZAJES.md de 1172 líneas). Para datasets más grandes (>10k líneas) o
- * múltiples clientes concurrentes, el caching reduce sustancialmente la carga.
- *
- * Patrón:
- *   - Key = path absoluto del archivo.
- *   - Value = { mtime, contenido, parsed }.
- *   - Invalidación: si fs.stat().mtime > value.mtime → recargar y reparsear.
- *   - TTL opcional vía `SWL_MCP_CACHE_TTL_MS` (default 60000 ms): aunque mtime no
- *     haya cambiado, recargar tras TTL para defensa contra clock skew o ediciones
- *     que no actualizan mtime (raras pero posibles en filesystems exóticos).
- *
- * Zero-deps. NO usar para escritura — sigue read-only.
- *
- * @module scripts/mcp-server/cache
- */
-
-const fs = require('fs');
-
-const DEFAULT_TTL_MS = 60 * 1000;
-
-/**
- * Crea una instancia de cache mtime-based.
- *
- * @param {object} [opciones]
- * @param {number} [opciones.ttlMs] - TTL en milisegundos. Default 60000.
- * @param {object} [opciones.env] - Para leer SWL_MCP_CACHE_TTL_MS en tests.
- * @returns {{ get: Function, invalidate: Function, stats: Function, _store: Map }}
- */
-function crearCache(opciones = {}) {
-  const env = opciones.env || process.env;
-  const ttlMs = opciones.ttlMs !== undefined
-    ? opciones.ttlMs
-    : (parseInt(env.SWL_MCP_CACHE_TTL_MS, 10) || DEFAULT_TTL_MS);
-
-  const store = new Map();
-  const stats = { hits: 0, misses: 0, invalidations: 0 };
-
-  /**
-   * Obtiene el valor cacheado para `path`. Si el archivo cambió (mtime) o el TTL
-   * expiró, vuelve a leer y parsear con `parser(contenido, path)`.
-   *
-   * @param {string} ruta - Path absoluto del archivo a cachear.
-   * @param {(contenido: string, ruta: string) => any} parser - Función que transforma
-   *   el contenido del archivo en el objeto a cachear. DEBE ser pura.
-   * @returns {{ data: any, hit: boolean } | null} null si el archivo no existe.
-   */
-  function get(ruta, parser) {
-    let stat;
-    try {
-      stat = fs.statSync(ruta);
-    } catch (err) {
-      if (err.code === 'ENOENT') return null;
-      throw err;
-    }
-
-    const mtimeMs = stat.mtimeMs;
-    const ahora = Date.now();
-    const cached = store.get(ruta);
-
-    if (cached && cached.mtimeMs === mtimeMs && (ahora - cached.cargadoEn) < ttlMs) {
-      stats.hits++;
-      return { data: cached.data, hit: true };
-    }
-
-    if (cached) stats.invalidations++;
-    else stats.misses++;
-
-    const contenido = fs.readFileSync(ruta, 'utf-8');
-    const data = parser(contenido, ruta);
-    store.set(ruta, { mtimeMs, cargadoEn: ahora, data });
-    return { data, hit: false };
-  }
-
-  /**
-   * Invalida una entrada o todo el cache.
-   * @param {string} [ruta] - Si se omite, vacía todo.
-   */
-  function invalidate(ruta) {
-    if (ruta === undefined) {
-      const n = store.size;
-      store.clear();
-      stats.invalidations += n;
-      return n;
-    }
-    if (store.delete(ruta)) stats.invalidations++;
-    return 0;
-  }
-
-  return {
-    get,
-    invalidate,
-    stats: () => ({ ...stats, size: store.size, ttlMs }),
-    _store: store, // exposed para tests
-  };
-}
-
-module.exports = {
-  crearCache,
-  DEFAULT_TTL_MS,
-};
+'use strict';
+
+/**
+ * Cache mtime-based para handlers del swl-mcp-server v1.0.0 (ADR-0019 Sub-fase 3).
+ *
+ * El stub experimental leía disco en cada call (latencia medida ~10ms con
+ * APRENDIZAJES.md de 1172 líneas). Para datasets más grandes (>10k líneas) o
+ * múltiples clientes concurrentes, el caching reduce sustancialmente la carga.
+ *
+ * Patrón:
+ *   - Key = path absoluto del archivo.
+ *   - Value = { mtime, contenido, parsed }.
+ *   - Invalidación: si fs.stat().mtime > value.mtime → recargar y reparsear.
+ *   - TTL opcional vía `SWL_MCP_CACHE_TTL_MS` (default 60000 ms): aunque mtime no
+ *     haya cambiado, recargar tras TTL para defensa contra clock skew o ediciones
+ *     que no actualizan mtime (raras pero posibles en filesystems exóticos).
+ *
+ * Zero-deps. NO usar para escritura — sigue read-only.
+ *
+ * @module scripts/mcp-server/cache
+ */
+
+const fs = require('fs');
+
+const DEFAULT_TTL_MS = 60 * 1000;
+
+/**
+ * Crea una instancia de cache mtime-based.
+ *
+ * @param {object} [opciones]
+ * @param {number} [opciones.ttlMs] - TTL en milisegundos. Default 60000.
+ * @param {object} [opciones.env] - Para leer SWL_MCP_CACHE_TTL_MS en tests.
+ * @returns {{ get: Function, invalidate: Function, stats: Function, _store: Map }}
+ */
+function crearCache(opciones = {}) {
+  const env = opciones.env || process.env;
+  const ttlMs = opciones.ttlMs !== undefined
+    ? opciones.ttlMs
+    : (parseInt(env.SWL_MCP_CACHE_TTL_MS, 10) || DEFAULT_TTL_MS);
+
+  const store = new Map();
+  const stats = { hits: 0, misses: 0, invalidations: 0 };
+
+  /**
+   * Obtiene el valor cacheado para `path`. Si el archivo cambió (mtime) o el TTL
+   * expiró, vuelve a leer y parsear con `parser(contenido, path)`.
+   *
+   * @param {string} ruta - Path absoluto del archivo a cachear.
+   * @param {(contenido: string, ruta: string) => any} parser - Función que transforma
+   *   el contenido del archivo en el objeto a cachear. DEBE ser pura.
+   * @returns {{ data: any, hit: boolean } | null} null si el archivo no existe.
+   */
+  function get(ruta, parser) {
+    let stat;
+    try {
+      stat = fs.statSync(ruta);
+    } catch (err) {
+      if (err.code === 'ENOENT') return null;
+      throw err;
+    }
+
+    const mtimeMs = stat.mtimeMs;
+    const ahora = Date.now();
+    const cached = store.get(ruta);
+
+    if (cached && cached.mtimeMs === mtimeMs && (ahora - cached.cargadoEn) < ttlMs) {
+      stats.hits++;
+      return { data: cached.data, hit: true };
+    }
+
+    if (cached) stats.invalidations++;
+    else stats.misses++;
+
+    const contenido = fs.readFileSync(ruta, 'utf-8');
+    const data = parser(contenido, ruta);
+    store.set(ruta, { mtimeMs, cargadoEn: ahora, data });
+    return { data, hit: false };
+  }
+
+  /**
+   * Invalida una entrada o todo el cache.
+   * @param {string} [ruta] - Si se omite, vacía todo.
+   */
+  function invalidate(ruta) {
+    if (ruta === undefined) {
+      const n = store.size;
+      store.clear();
+      stats.invalidations += n;
+      return n;
+    }
+    if (store.delete(ruta)) stats.invalidations++;
+    return 0;
+  }
+
+  return {
+    get,
+    invalidate,
+    stats: () => ({ ...stats, size: store.size, ttlMs }),
+    _store: store, // exposed para tests
+  };
+}
+
+module.exports = {
+  crearCache,
+  DEFAULT_TTL_MS,
+};

package/scripts/tui/pantallas/inspect.js

@@ -1,173 +1,175 @@
-'use strict';
-
-/**
- * Pantalla Inspect — navegador read-only de componentes instalados.
- *
- * Flujo:
- *   1. Lista de instalaciones detectadas (runtime + scope + perfil + version)
- *   2. Al seleccionar una, muestra detalles:
- *      - Componentes por categoría (con conteos)
- *      - Última actualización
- *      - Lista de hooks registrados
- *      - Lista de skills disponibles
- *
- * No modifica nada. Solo lee de los archivos de estado.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const { selectorUnico } = require('../componentes/selector-unico');
-const render = require('../lib/render');
-const teclas = require('../lib/teclas');
-const { colores, semantico, iconos } = require('../lib/colores');
-
-function _cargarDatosInstalaciones() {
-  let detectarRuntimes, cargarEstado;
-  try {
-    ({ detectarRuntimes } = require('../../lib/detectar-runtime'));
-    ({ cargarEstado } = require('../../lib/estado'));
-  } catch (_) {
-    return [];
-  }
-
-  const runtimes = detectarRuntimes();
-  const filas = [];
-  for (const runtime of runtimes) {
-    const candidatos = [
-      { ruta: runtime.global, scope: 'global' },
-      { ruta: path.resolve(runtime.local), scope: 'proyecto' },
-    ];
-    for (const { ruta, scope } of candidatos) {
-      if (!fs.existsSync(ruta)) continue;
-      const estado = cargarEstado(ruta);
-      if (!estado) continue;
-      filas.push({
-        id: `${runtime.id}:${scope}`,
-        runtimeId: runtime.id,
-        runtimeNombre: runtime.nombre,
-        scope,
-        ruta,
-        version: estado.versionSistema || 'desconocida',
-        perfil: estado.perfil || '-',
-        instalado: estado.fechaInstalacion || estado.timestamp || '-',
-        componentes: estado.componentesInstalados || [],
-        archivos: estado.archivosInstalados || [],
-      });
-    }
-  }
-  return filas;
-}
-
-function _agruparPorCategoria(archivos) {
-  const grupos = {};
-  for (const a of archivos) {
-    const cat = a.tipo || a.categoria || 'otros';
-    grupos[cat] = (grupos[cat] || 0) + 1;
-  }
-  return grupos;
-}
-
-function _pantallaDetalle(fila) {
-  return new Promise((resolve) => {
-    if (!render.ES_TTY || !process.stdin.isTTY) {
-      resolve();
-      return;
-    }
-
-    function _renderizar() {
-      render.limpiarPantalla();
-      const { cols, rows } = render.obtenerDimensiones();
-
-      render.escribirEn(2, 3, semantico.titulo(`${fila.runtimeNombre} — ${fila.scope}`));
-      render.escribirEn(3, 3, colores.dim(fila.ruta));
-
-      const datos = [
-        ['Versión', colores.cyan('v' + fila.version)],
-        ['Perfil', semantico.enfasis(fila.perfil)],
-        ['Instalado', fila.instalado],
-        ['Total componentes', String(fila.componentes.length)],
-        ['Total archivos', String(fila.archivos.length)],
-      ];
-
-      datos.forEach((d, i) => {
-        render.escribirEn(5 + i, 5,
-          render.rellenarDer(colores.dim(d[0] + ':'), 22) + d[1]);
-      });
-
-      // Conteos por categoría
-      const grupos = _agruparPorCategoria(fila.archivos);
-      const categorias = Object.entries(grupos).sort(([a], [b]) => a.localeCompare(b));
-
-      const filaCat = 5 + datos.length + 2;
-      render.escribirEn(filaCat, 3, semantico.enfasis('Archivos por categoría:'));
-      categorias.forEach(([cat, n], i) => {
-        const fila = filaCat + 1 + i;
-        if (fila >= rows - 3) return;
-        render.escribirEn(fila, 5,
-          render.rellenarDer(`${iconos.punto} ${cat}`, 22) +
-          colores.cyan(String(n).padStart(4)));
-      });
-
-      render.dibujarPiePagina([
-        ['Enter|Esc', 'volver al listado'],
-      ]);
-    }
-
-    render.iniciarModoTui();
-    _renderizar();
-
-    const onResize = () => _renderizar();
-    process.stdout.on('resize', onResize);
-
-    const teclado = teclas.crearTeclado();
-    function _finalizar() {
-      teclado.desactivar();
-      process.stdout.removeListener('resize', onResize);
-      render.salirModoTui();
-      resolve();
-    }
-    teclado.on('return', _finalizar);
-    teclado.on('escape', _finalizar);
-    teclado.activar();
-  });
-}
-
-async function ejecutarInspect() {
-  const instalaciones = _cargarDatosInstalaciones();
-
-  if (instalaciones.length === 0) {
-    return {
-      exito: false,
-      error: 'No se detectaron instalaciones SWL en este equipo.',
-      sugerencia: 'Ejecuta swl-ses install para crear una.',
-    };
-  }
-
-  // Loop: seleccionar una instalación → ver detalle → volver al listado.
-  // Esc en el listado sale del Inspect.
-  while (true) {
-    const items = instalaciones.map(i => ({
-      valor: i.id,
-      etiqueta: `${i.runtimeNombre} (${i.scope}) — v${i.version} · perfil ${i.perfil}`,
-      descripcion: `${i.componentes.length} componentes · ${i.archivos.length} archivos · ${i.ruta}`,
-    }));
-
-    const elegida = await selectorUnico({
-      titulo: 'Inspect — Elige una instalación para ver detalle:',
-      items,
-    });
-    if (!elegida) break;
-
-    const fila = instalaciones.find(i => i.id === elegida);
-    if (fila) await _pantallaDetalle(fila);
-  }
-
-  return { exito: true };
-}
-
-module.exports = {
-  ejecutarInspect,
-  _cargarDatosInstalaciones,
-  _agruparPorCategoria,
-};
+'use strict';
+
+/**
+ * Pantalla Inspect — navegador read-only de componentes instalados.
+ *
+ * Flujo:
+ *   1. Lista de instalaciones detectadas (runtime + scope + perfil + version)
+ *   2. Al seleccionar una, muestra detalles:
+ *      - Componentes por categoría (con conteos)
+ *      - Última actualización
+ *      - Lista de hooks registrados
+ *      - Lista de skills disponibles
+ *
+ * No modifica nada. Solo lee de los archivos de estado.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const { selectorUnico } = require('../componentes/selector-unico');
+const render = require('../lib/render');
+const teclas = require('../lib/teclas');
+const { colores, semantico, iconos } = require('../lib/colores');
+
+function _cargarDatosInstalaciones() {
+  let detectarRuntimes, cargarEstado;
+  try {
+    ({ detectarRuntimes, scopesReales } = require('../../lib/detectar-runtime'));
+    ({ cargarEstado } = require('../../lib/estado'));
+  } catch (_) {
+    return [];
+  }
+
+  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 candidatos = scopesReales(runtime).map(({ dir, esGlobal }) => (
+      { ruta: dir, scope: esGlobal ? 'global' : 'proyecto' }
+    ));
+    for (const { ruta, scope } of candidatos) {
+      if (!fs.existsSync(ruta)) continue;
+      const estado = cargarEstado(ruta);
+      if (!estado) continue;
+      filas.push({
+        id: `${runtime.id}:${scope}`,
+        runtimeId: runtime.id,
+        runtimeNombre: runtime.nombre,
+        scope,
+        ruta,
+        version: estado.versionSistema || 'desconocida',
+        perfil: estado.perfil || '-',
+        instalado: estado.fechaInstalacion || estado.timestamp || '-',
+        componentes: estado.componentesInstalados || [],
+        archivos: estado.archivosInstalados || [],
+      });
+    }
+  }
+  return filas;
+}
+
+function _agruparPorCategoria(archivos) {
+  const grupos = {};
+  for (const a of archivos) {
+    const cat = a.tipo || a.categoria || 'otros';
+    grupos[cat] = (grupos[cat] || 0) + 1;
+  }
+  return grupos;
+}
+
+function _pantallaDetalle(fila) {
+  return new Promise((resolve) => {
+    if (!render.ES_TTY || !process.stdin.isTTY) {
+      resolve();
+      return;
+    }
+
+    function _renderizar() {
+      render.limpiarPantalla();
+      const { cols, rows } = render.obtenerDimensiones();
+
+      render.escribirEn(2, 3, semantico.titulo(`${fila.runtimeNombre} — ${fila.scope}`));
+      render.escribirEn(3, 3, colores.dim(fila.ruta));
+
+      const datos = [
+        ['Versión', colores.cyan('v' + fila.version)],
+        ['Perfil', semantico.enfasis(fila.perfil)],
+        ['Instalado', fila.instalado],
+        ['Total componentes', String(fila.componentes.length)],
+        ['Total archivos', String(fila.archivos.length)],
+      ];
+
+      datos.forEach((d, i) => {
+        render.escribirEn(5 + i, 5,
+          render.rellenarDer(colores.dim(d[0] + ':'), 22) + d[1]);
+      });
+
+      // Conteos por categoría
+      const grupos = _agruparPorCategoria(fila.archivos);
+      const categorias = Object.entries(grupos).sort(([a], [b]) => a.localeCompare(b));
+
+      const filaCat = 5 + datos.length + 2;
+      render.escribirEn(filaCat, 3, semantico.enfasis('Archivos por categoría:'));
+      categorias.forEach(([cat, n], i) => {
+        const fila = filaCat + 1 + i;
+        if (fila >= rows - 3) return;
+        render.escribirEn(fila, 5,
+          render.rellenarDer(`${iconos.punto} ${cat}`, 22) +
+          colores.cyan(String(n).padStart(4)));
+      });
+
+      render.dibujarPiePagina([
+        ['Enter|Esc', 'volver al listado'],
+      ]);
+    }
+
+    render.iniciarModoTui();
+    _renderizar();
+
+    const onResize = () => _renderizar();
+    process.stdout.on('resize', onResize);
+
+    const teclado = teclas.crearTeclado();
+    function _finalizar() {
+      teclado.desactivar();
+      process.stdout.removeListener('resize', onResize);
+      render.salirModoTui();
+      resolve();
+    }
+    teclado.on('return', _finalizar);
+    teclado.on('escape', _finalizar);
+    teclado.activar();
+  });
+}
+
+async function ejecutarInspect() {
+  const instalaciones = _cargarDatosInstalaciones();
+
+  if (instalaciones.length === 0) {
+    return {
+      exito: false,
+      error: 'No se detectaron instalaciones SWL en este equipo.',
+      sugerencia: 'Ejecuta swl-ses install para crear una.',
+    };
+  }
+
+  // Loop: seleccionar una instalación → ver detalle → volver al listado.
+  // Esc en el listado sale del Inspect.
+  while (true) {
+    const items = instalaciones.map(i => ({
+      valor: i.id,
+      etiqueta: `${i.runtimeNombre} (${i.scope}) — v${i.version} · perfil ${i.perfil}`,
+      descripcion: `${i.componentes.length} componentes · ${i.archivos.length} archivos · ${i.ruta}`,
+    }));
+
+    const elegida = await selectorUnico({
+      titulo: 'Inspect — Elige una instalación para ver detalle:',
+      items,
+    });
+    if (!elegida) break;
+
+    const fila = instalaciones.find(i => i.id === elegida);
+    if (fila) await _pantallaDetalle(fila);
+  }
+
+  return { exito: true };
+}
+
+module.exports = {
+  ejecutarInspect,
+  _cargarDatosInstalaciones,
+  _agruparPorCategoria,
+};