@saulwade/swl-ses 1.4.1 → 1.5.0

package/scripts/instalador.js

@@ -411,6 +411,11 @@ async function install(opciones) {
     perfil,
     rutaBase: rutas.base,
     global: esGlobal,
+    // Persistir contexto de filtrado de reglas-lenguajes para que doctor
+    // verifique conteos contra el filtro real al instalar (no recalcule
+    // desde el cwd actual del doctor). Fix v1.4.3.
+    allLangs: allLangs === true,
+    stackInstalado: stackDetectado instanceof Set ? [...stackDetectado] : null,
   });
 
   let instalados = 0;
@@ -447,6 +452,11 @@ async function install(opciones) {
     }
   }
 
+  // Cargar transformador del target ANTES del loop de instalación —
+  // Sub-fase 11.5: permite que instalarArchivo invoque transformarAgente
+  // por archivo para targets que cambian formato (ej. codex .md → .toml).
+  const transformadorTarget = obtenerTransformador(target, runtime);
+
   // Instalar archivos core
   for (const archivo of resolucion.archivos) {
     try {
@@ -457,6 +467,7 @@ async function install(opciones) {
         estado,
         syncMode,
         flatNaming,
+        transformador: transformadorTarget,
       });
       if (resultado.instalado) {
         registrarArchivo(estado, {
@@ -612,6 +623,13 @@ async function install(opciones) {
         // transformador Claude pueda detectar stack/comandos/framework.
         // Otros transformadores ignoran este campo.
         dirProyecto: process.cwd(),
+        // ADR-0019 Sub-fase 1: el transformador Codex necesita saber el scope para
+        // resolver dirBase (~/.codex/ vs cwd) y registrar el MCP server.
+        // El runtime trae los paths absolutos calculados por detectar-runtime.js.
+        esGlobal,
+        dirRuntimeGlobal: runtime.global,
+        withMcp: Boolean(opciones.with_mcp) && !opciones.no_mcp,
+        swlBinPath: path.join(RAIZ_PKG, 'bin', 'swl-mcp-server.js'),
       });
 
       if (instrucciones) {
@@ -628,6 +646,7 @@ async function install(opciones) {
           console.log('  = CLAUDE.md no modificado (--no-claudemd)');
         } else if (instrucciones.merge && instrucciones.merge.tipo === 'marcadores') {
           // Merge idempotente con marcadores — preserva contenido del usuario.
+          // Aplica a CLAUDE.md (Claude Code) y AGENTS.md (Codex CLI) — ADR-0019 Sub-fase 1.
           if (!fs.existsSync(dirInstrucciones)) {
             fs.mkdirSync(dirInstrucciones, { recursive: true });
           }
@@ -637,12 +656,13 @@ async function install(opciones) {
             endTag:      instrucciones.merge.endTag,
             beginPrefix: instrucciones.merge.beginPrefix,
           });
+          const nombreArchivo = instrucciones.rutaRelativa;
           const etiqueta = {
-            'creado':       '+ CLAUDE.md creado con bloque SWL',
-            'append':       '+ Bloque SWL agregado al final de CLAUDE.md (contenido del usuario preservado)',
-            'reemplazado':  '* Bloque SWL actualizado en CLAUDE.md (contenido del usuario preservado)',
-            'sin-cambios':  '= CLAUDE.md ya tenía el bloque SWL actualizado',
-            'error':        '! Error al fusionar CLAUDE.md',
+            'creado':       `+ ${nombreArchivo} creado con bloque SWL`,
+            'append':       `+ Bloque SWL agregado al final de ${nombreArchivo} (contenido del usuario preservado)`,
+            'reemplazado':  `* Bloque SWL actualizado en ${nombreArchivo} (contenido del usuario preservado)`,
+            'sin-cambios':  `= ${nombreArchivo} ya tenía el bloque SWL actualizado`,
+            'error':        `! Error al fusionar ${nombreArchivo}`,
           }[resMerge.accion] || `${resMerge.accion} ${resMerge.archivo}`;
           console.log(`  ${etiqueta}${resMerge.detalle ? ': ' + resMerge.detalle : ''}`);
           registrarArchivo(estado, {
@@ -850,6 +870,33 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
 
   let nombreArchivo = path.basename(archivo.origen);
 
+  // Sub-fase 11.5 v1.5.0: para tipo 'agentes', aplicar transformarAgente del
+  // transformador del target ANTES de la copia. Permite que codex emita TOML
+  // (.toml) en lugar del .md original, o que cursor normalice el frontmatter.
+  // Si transformarAgente devuelve `consolidar: true`, saltar — el archivo
+  // se incluirá en el archivoPrincipal (AGENTS.md) generado más adelante.
+  let contenidoTransformado = null;
+  if (archivo.tipo === 'agentes' && opciones.transformador && typeof opciones.transformador.transformarAgente === 'function') {
+    try {
+      const original = fs.readFileSync(archivo.origen, 'utf-8');
+      const t = opciones.transformador.transformarAgente(original, { nombreArchivo });
+      if (t && t.consolidar === true) {
+        // El transformador del target prefiere consolidar este agente en el
+        // archivoPrincipal en lugar de tener archivo individual. No instalar aquí.
+        return { instalado: false, razon: 'consolidado en archivoPrincipal' };
+      }
+      if (t && typeof t.contenido === 'string') {
+        contenidoTransformado = t.contenido;
+        if (t.rutaRelativa) {
+          // Usar el basename del rutaRelativa devuelto (puede cambiar extensión .md → .toml)
+          nombreArchivo = path.basename(t.rutaRelativa);
+        }
+      }
+    } catch (err) {
+      console.log(`  ! Transformación de agente falló (${err.message}), copia literal del .md`);
+    }
+  }
+
   // Flat naming: convierte rutas jerárquicas en nombres planos con __
   // Ejemplo: habilidades/build-errors-python → build-errors-python (sin cambio, ya es plano)
   // Ejemplo: reglas/lenguajes/java/java-estilo.md → java__java-estilo.md
@@ -991,6 +1038,10 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
     // Copy mode (default) o fallback de symlink
     if (stat.isDirectory()) {
       copiarDirectorio(archivo.origen, path.join(dirDestino, nombreArchivo));
+    } else if (contenidoTransformado !== null) {
+      // Sub-fase 11.5: el transformador del target reescribió el contenido
+      // (ej. codex .md → .toml). Escribir el contenido transformado.
+      fs.writeFileSync(destino, contenidoTransformado, 'utf-8');
     } else {
       fs.copyFileSync(archivo.origen, destino);
     }

package/scripts/lib/artefactos-python.js

@@ -1,43 +1,43 @@
-'use strict';
-
-/**
- * artefactos-python.js — fuente única de verdad para los artefactos
- * Python que NO deben distribuirse en el paquete npm.
- *
- * Por qué existe:
- *   Tanto `scripts/limpiar-artefactos-python.js` (prepack) como
- *   `scripts/publicar.js` (copiarDir hacia tmpDir del mirror GH)
- *   necesitan saber qué directorios y extensiones excluir. Tener la
- *   lista hardcodeada en cada archivo es violación DRY de conocimiento
- *   — agregar `.pyd` o `.mypy_cache_v2` exigiría editar dos archivos
- *   y mantenerlos sincronizados.
- */
-
-const DIRS_ARTEFACTOS_PYTHON = Object.freeze(new Set([
-  '__pycache__',
-  '.pytest_cache',
-  '.mypy_cache',
-  '.ruff_cache',
-]));
-
-const EXTS_ARTEFACTOS_PYTHON = Object.freeze(new Set([
-  '.pyc',
-  '.pyo',
-]));
-
-function esDirArtefacto(nombre) {
-  return DIRS_ARTEFACTOS_PYTHON.has(nombre);
-}
-
-function esArchivoArtefacto(nombre) {
-  const dot = nombre.lastIndexOf('.');
-  if (dot < 0) return false;
-  return EXTS_ARTEFACTOS_PYTHON.has(nombre.slice(dot).toLowerCase());
-}
-
-module.exports = {
-  DIRS_ARTEFACTOS_PYTHON,
-  EXTS_ARTEFACTOS_PYTHON,
-  esDirArtefacto,
-  esArchivoArtefacto,
-};
+'use strict';
+
+/**
+ * artefactos-python.js — fuente única de verdad para los artefactos
+ * Python que NO deben distribuirse en el paquete npm.
+ *
+ * Por qué existe:
+ *   Tanto `scripts/limpiar-artefactos-python.js` (prepack) como
+ *   `scripts/publicar.js` (copiarDir hacia tmpDir del mirror GH)
+ *   necesitan saber qué directorios y extensiones excluir. Tener la
+ *   lista hardcodeada en cada archivo es violación DRY de conocimiento
+ *   — agregar `.pyd` o `.mypy_cache_v2` exigiría editar dos archivos
+ *   y mantenerlos sincronizados.
+ */
+
+const DIRS_ARTEFACTOS_PYTHON = Object.freeze(new Set([
+  '__pycache__',
+  '.pytest_cache',
+  '.mypy_cache',
+  '.ruff_cache',
+]));
+
+const EXTS_ARTEFACTOS_PYTHON = Object.freeze(new Set([
+  '.pyc',
+  '.pyo',
+]));
+
+function esDirArtefacto(nombre) {
+  return DIRS_ARTEFACTOS_PYTHON.has(nombre);
+}
+
+function esArchivoArtefacto(nombre) {
+  const dot = nombre.lastIndexOf('.');
+  if (dot < 0) return false;
+  return EXTS_ARTEFACTOS_PYTHON.has(nombre.slice(dot).toLowerCase());
+}
+
+module.exports = {
+  DIRS_ARTEFACTOS_PYTHON,
+  EXTS_ARTEFACTOS_PYTHON,
+  esDirArtefacto,
+  esArchivoArtefacto,
+};

package/scripts/lib/benchmark-metrics.js

@@ -1,160 +1,160 @@
-'use strict';
-
-/**
- * benchmark-metrics.js — Métricas de retrieval para benchmark de memoria SWL.
- *
- * Patrón adoptado de `temp/agentmemory-main/benchmark/longmemeval-bench.ts`.
- * Funciones puras zero-deps. Adaptado a IDs SWL (aprendizaje, sesion,
- * instinto) en lugar de session_id de agentmemory.
- *
- * Métricas:
- *   - recallAt(k): 1.0 si al menos un gold ID está en los top-k, sino 0.0
- *   - precisionAt(k): proporción de top-k que son gold
- *   - mrr: Mean Reciprocal Rank (1/rank del primer gold encontrado)
- *   - ndcgAt(k): Normalized Discounted Cumulative Gain
- *
- * @module scripts/lib/benchmark-metrics
- */
-
-// ── helpers ───────────────────────────────────────────────────────────────────
-
-function asSet(arr) {
-  return new Set(Array.isArray(arr) ? arr : []);
-}
-
-// ── métricas individuales ─────────────────────────────────────────────────────
-
-/**
- * Recall @ k: 1.0 si ALGÚN id gold está en los primeros k retrieved.
- *
- * @param {string[]} retrievedIds - IDs ordenados (mejor primero).
- * @param {string[]} goldIds - IDs correctos esperados.
- * @param {number} k
- * @returns {number} 0 o 1
- */
-function recallAt(retrievedIds, goldIds, k) {
-  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds)) return 0;
-  const topK = new Set(retrievedIds.slice(0, k));
-  return goldIds.some(g => topK.has(g)) ? 1.0 : 0.0;
-}
-
-/**
- * Precision @ k: proporción de los primeros k retrieved que son gold.
- *
- * @param {string[]} retrievedIds
- * @param {string[]} goldIds
- * @param {number} k
- * @returns {number} en [0, 1]
- */
-function precisionAt(retrievedIds, goldIds, k) {
-  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds) || k <= 0) return 0;
-  const goldSet = asSet(goldIds);
-  const topK = retrievedIds.slice(0, k);
-  if (topK.length === 0) return 0;
-  const hits = topK.filter(id => goldSet.has(id)).length;
-  return hits / topK.length;
-}
-
-/**
- * Mean Reciprocal Rank: 1/rank del primer gold encontrado, o 0 si ninguno.
- *
- * @param {string[]} retrievedIds
- * @param {string[]} goldIds
- * @returns {number} en [0, 1]
- */
-function mrr(retrievedIds, goldIds) {
-  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds)) return 0;
-  const goldSet = asSet(goldIds);
-  for (let i = 0; i < retrievedIds.length; i++) {
-    if (goldSet.has(retrievedIds[i])) {
-      return 1 / (i + 1);
-    }
-  }
-  return 0;
-}
-
-function dcg(relevancias, k) {
-  let suma = 0;
-  for (let i = 0; i < Math.min(k, relevancias.length); i++) {
-    suma += (relevancias[i] ? 1 : 0) / Math.log2(i + 2);
-  }
-  return suma;
-}
-
-/**
- * Normalized Discounted Cumulative Gain @ k.
- *
- * @param {string[]} retrievedIds
- * @param {string[]} goldIds
- * @param {number} k
- * @returns {number} en [0, 1]
- */
-function ndcgAt(retrievedIds, goldIds, k) {
-  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds) || k <= 0) return 0;
-  const goldSet = asSet(goldIds);
-  const rels = retrievedIds.slice(0, k).map(id => goldSet.has(id));
-  const idealRels = Array.from({ length: Math.min(k, goldSet.size) }, () => true);
-  const idealDCG = dcg(idealRels, k);
-  if (idealDCG === 0) return 0;
-  return dcg(rels, k) / idealDCG;
-}
-
-// ── agregados ─────────────────────────────────────────────────────────────────
-
-/**
- * Calcula el conjunto completo de métricas para una query.
- *
- * @param {string[]} retrievedIds
- * @param {string[]} goldIds
- * @returns {{ recall_at_5, recall_at_10, recall_at_20, mrr, ndcg_at_10, precision_at_5 }}
- */
-function calcularMetricas(retrievedIds, goldIds) {
-  return {
-    recall_at_5:    recallAt(retrievedIds, goldIds, 5),
-    recall_at_10:   recallAt(retrievedIds, goldIds, 10),
-    recall_at_20:   recallAt(retrievedIds, goldIds, 20),
-    mrr:            mrr(retrievedIds, goldIds),
-    ndcg_at_10:     ndcgAt(retrievedIds, goldIds, 10),
-    precision_at_5: precisionAt(retrievedIds, goldIds, 5),
-  };
-}
-
-/**
- * Promedia métricas sobre múltiples queries.
- *
- * @param {Array<object>} resultados - Array de objetos producidos por calcularMetricas().
- * @returns {object} Promedios con campo `n` (cantidad de queries).
- */
-function promediar(resultados) {
-  if (!Array.isArray(resultados) || resultados.length === 0) {
-    return {
-      n: 0,
-      recall_at_5: 0,
-      recall_at_10: 0,
-      recall_at_20: 0,
-      mrr: 0,
-      ndcg_at_10: 0,
-      precision_at_5: 0,
-    };
-  }
-
-  const claves = ['recall_at_5', 'recall_at_10', 'recall_at_20', 'mrr', 'ndcg_at_10', 'precision_at_5'];
-  const promedio = { n: resultados.length };
-  for (const k of claves) {
-    const sum = resultados.reduce((a, r) => a + (r[k] || 0), 0);
-    promedio[k] = sum / resultados.length;
-  }
-  return promedio;
-}
-
-// ── exports ───────────────────────────────────────────────────────────────────
-
-module.exports = {
-  recallAt,
-  precisionAt,
-  mrr,
-  ndcgAt,
-  dcg,
-  calcularMetricas,
-  promediar,
-};
+'use strict';
+
+/**
+ * benchmark-metrics.js — Métricas de retrieval para benchmark de memoria SWL.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/benchmark/longmemeval-bench.ts`.
+ * Funciones puras zero-deps. Adaptado a IDs SWL (aprendizaje, sesion,
+ * instinto) en lugar de session_id de agentmemory.
+ *
+ * Métricas:
+ *   - recallAt(k): 1.0 si al menos un gold ID está en los top-k, sino 0.0
+ *   - precisionAt(k): proporción de top-k que son gold
+ *   - mrr: Mean Reciprocal Rank (1/rank del primer gold encontrado)
+ *   - ndcgAt(k): Normalized Discounted Cumulative Gain
+ *
+ * @module scripts/lib/benchmark-metrics
+ */
+
+// ── helpers ───────────────────────────────────────────────────────────────────
+
+function asSet(arr) {
+  return new Set(Array.isArray(arr) ? arr : []);
+}
+
+// ── métricas individuales ─────────────────────────────────────────────────────
+
+/**
+ * Recall @ k: 1.0 si ALGÚN id gold está en los primeros k retrieved.
+ *
+ * @param {string[]} retrievedIds - IDs ordenados (mejor primero).
+ * @param {string[]} goldIds - IDs correctos esperados.
+ * @param {number} k
+ * @returns {number} 0 o 1
+ */
+function recallAt(retrievedIds, goldIds, k) {
+  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds)) return 0;
+  const topK = new Set(retrievedIds.slice(0, k));
+  return goldIds.some(g => topK.has(g)) ? 1.0 : 0.0;
+}
+
+/**
+ * Precision @ k: proporción de los primeros k retrieved que son gold.
+ *
+ * @param {string[]} retrievedIds
+ * @param {string[]} goldIds
+ * @param {number} k
+ * @returns {number} en [0, 1]
+ */
+function precisionAt(retrievedIds, goldIds, k) {
+  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds) || k <= 0) return 0;
+  const goldSet = asSet(goldIds);
+  const topK = retrievedIds.slice(0, k);
+  if (topK.length === 0) return 0;
+  const hits = topK.filter(id => goldSet.has(id)).length;
+  return hits / topK.length;
+}
+
+/**
+ * Mean Reciprocal Rank: 1/rank del primer gold encontrado, o 0 si ninguno.
+ *
+ * @param {string[]} retrievedIds
+ * @param {string[]} goldIds
+ * @returns {number} en [0, 1]
+ */
+function mrr(retrievedIds, goldIds) {
+  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds)) return 0;
+  const goldSet = asSet(goldIds);
+  for (let i = 0; i < retrievedIds.length; i++) {
+    if (goldSet.has(retrievedIds[i])) {
+      return 1 / (i + 1);
+    }
+  }
+  return 0;
+}
+
+function dcg(relevancias, k) {
+  let suma = 0;
+  for (let i = 0; i < Math.min(k, relevancias.length); i++) {
+    suma += (relevancias[i] ? 1 : 0) / Math.log2(i + 2);
+  }
+  return suma;
+}
+
+/**
+ * Normalized Discounted Cumulative Gain @ k.
+ *
+ * @param {string[]} retrievedIds
+ * @param {string[]} goldIds
+ * @param {number} k
+ * @returns {number} en [0, 1]
+ */
+function ndcgAt(retrievedIds, goldIds, k) {
+  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds) || k <= 0) return 0;
+  const goldSet = asSet(goldIds);
+  const rels = retrievedIds.slice(0, k).map(id => goldSet.has(id));
+  const idealRels = Array.from({ length: Math.min(k, goldSet.size) }, () => true);
+  const idealDCG = dcg(idealRels, k);
+  if (idealDCG === 0) return 0;
+  return dcg(rels, k) / idealDCG;
+}
+
+// ── agregados ─────────────────────────────────────────────────────────────────
+
+/**
+ * Calcula el conjunto completo de métricas para una query.
+ *
+ * @param {string[]} retrievedIds
+ * @param {string[]} goldIds
+ * @returns {{ recall_at_5, recall_at_10, recall_at_20, mrr, ndcg_at_10, precision_at_5 }}
+ */
+function calcularMetricas(retrievedIds, goldIds) {
+  return {
+    recall_at_5:    recallAt(retrievedIds, goldIds, 5),
+    recall_at_10:   recallAt(retrievedIds, goldIds, 10),
+    recall_at_20:   recallAt(retrievedIds, goldIds, 20),
+    mrr:            mrr(retrievedIds, goldIds),
+    ndcg_at_10:     ndcgAt(retrievedIds, goldIds, 10),
+    precision_at_5: precisionAt(retrievedIds, goldIds, 5),
+  };
+}
+
+/**
+ * Promedia métricas sobre múltiples queries.
+ *
+ * @param {Array<object>} resultados - Array de objetos producidos por calcularMetricas().
+ * @returns {object} Promedios con campo `n` (cantidad de queries).
+ */
+function promediar(resultados) {
+  if (!Array.isArray(resultados) || resultados.length === 0) {
+    return {
+      n: 0,
+      recall_at_5: 0,
+      recall_at_10: 0,
+      recall_at_20: 0,
+      mrr: 0,
+      ndcg_at_10: 0,
+      precision_at_5: 0,
+    };
+  }
+
+  const claves = ['recall_at_5', 'recall_at_10', 'recall_at_20', 'mrr', 'ndcg_at_10', 'precision_at_5'];
+  const promedio = { n: resultados.length };
+  for (const k of claves) {
+    const sum = resultados.reduce((a, r) => a + (r[k] || 0), 0);
+    promedio[k] = sum / resultados.length;
+  }
+  return promedio;
+}
+
+// ── exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  recallAt,
+  precisionAt,
+  mrr,
+  ndcgAt,
+  dcg,
+  calcularMetricas,
+  promediar,
+};