@saulwade/swl-ses 1.1.4 → 1.2.1

package/reglas/skills-estandar.md

@@ -379,6 +379,9 @@ El contenido de referencia detallada vive en el skill `meta-skills-estandar`
 - **Mapeo a frameworks de seguridad** (NIST CSF, NIST AI RMF, MITRE ATT&CK,
   ATLAS, D3FEND) — solo aplica a skills del dominio seguridad.
 - **Migración a nombres de campo en español (REC-S15)**.
+- **Convención `EXAMPLES.md`** como recurso opcional para skills críticos
+  cuyo valor depende de diff MAL→BIEN lado a lado. NO retroactiva — solo
+  guía para skills nuevos.
 
 Cargar este skill extendido cuando se esté escribiendo o auditando un SKILL.md
 que requiera patrones avanzados. Para skills simples o consultas básicas, la

package/scripts/benchmark-memoria.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * benchmark-memoria.js — CLI runner para benchmark de retrieval sobre memoria SWL.
+ *
+ * Ejecuta queries de un dataset JSONL contra `hooks/lib/memory-search`
+ * (que usa RRF fusion sobre aprendizajes/sesiones/instintos) y reporta
+ * métricas R@5, R@10, R@20, MRR, nDCG@10, P@5.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/benchmark/longmemeval-bench.ts`.
+ * Adaptado para swl-ses: file-based, sin embeddings ML, dataset SWL-específico.
+ *
+ * Uso:
+ *   node scripts/benchmark-memoria.js [opciones]
+ *
+ * Opciones:
+ *   --dataset <ruta>   Dataset JSONL (default: .planning/benchmark/dataset.jsonl)
+ *   --limit <n>        Top-k a recuperar por query (default: 20)
+ *   --json             Output en JSON (para scripts)
+ *   --verbose          Detalle por query
+ *
+ * Exit codes:
+ *   0 - OK
+ *   1 - Error de I/O o dataset inválido
+ *   2 - Argumentos inválidos
+ *
+ * Persistencia opcional: si se setea SWL_BENCHMARK_PERSIST=1, escribe
+ * el resultado agregado a `.planning/evolucion/benchmark-memoria.jsonl`
+ * para tracking histórico.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const { ejecutarDataset } = require('./lib/longmemeval-runner');
+
+const DATASET_DEFAULT = '.planning/benchmark/dataset.jsonl';
+const HISTORICO_PATH  = '.planning/evolucion/benchmark-memoria.jsonl';
+
+function uso() {
+  console.error('Uso: node scripts/benchmark-memoria.js [--dataset <ruta>] [--limit <n>] [--json] [--verbose]');
+  process.exit(2);
+}
+
+function parseArgs(argv) {
+  const opts = {
+    dataset: DATASET_DEFAULT,
+    limit: 20,
+    json: false,
+    verbose: false,
+  };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--dataset') opts.dataset = argv[++i];
+    else if (arg === '--limit') opts.limit = parseInt(argv[++i], 10) || 20;
+    else if (arg === '--json') opts.json = true;
+    else if (arg === '--verbose') opts.verbose = true;
+    else if (arg === '--help' || arg === '-h') uso();
+  }
+  return opts;
+}
+
+function persistirHistorico(baseDir, resumen) {
+  if (process.env.SWL_BENCHMARK_PERSIST !== '1') return;
+  try {
+    const dirEvolucion = path.join(baseDir, '.planning', 'evolucion');
+    if (!fs.existsSync(dirEvolucion)) fs.mkdirSync(dirEvolucion, { recursive: true });
+    const linea = JSON.stringify({
+      timestamp: new Date().toISOString(),
+      ...resumen,
+    });
+    fs.appendFileSync(path.join(baseDir, HISTORICO_PATH), linea + '\n', 'utf8');
+  } catch (_) {
+    // best-effort
+  }
+}
+
+function reportarTexto(resultado, opts) {
+  const { promedio, dataset, entries } = resultado;
+
+  console.log('================================================================');
+  console.log('   Benchmark de retrieval de memoria SWL');
+  console.log('================================================================');
+  console.log('');
+  console.log(`Dataset:      ${opts.dataset}`);
+  console.log(`Total queries: ${dataset.total}`);
+  console.log(`  Reales:      ${dataset.real}`);
+  console.log(`  Placeholder: ${dataset.placeholder}`);
+  console.log(`Significativo: ${dataset.significativo ? 'sí' : 'NO (requiere ≥30 reales)'}`);
+  console.log('');
+
+  if (!dataset.significativo) {
+    console.log('⚠ ADVERTENCIA: dataset con menos de 30 queries reales.');
+    console.log('  Las métricas son INDICATIVAS, no estadísticamente significativas.');
+    console.log('  Para usar como gate de release, expandir el dataset con preguntas');
+    console.log('  curadas extraídas de uso real (ver SKILL.md de benchmark-memoria).');
+    console.log('');
+  }
+
+  console.log('────────────── Métricas agregadas ──────────────');
+  console.log(`  Recall @ 5:     ${(promedio.recall_at_5 * 100).toFixed(1)}%`);
+  console.log(`  Recall @ 10:    ${(promedio.recall_at_10 * 100).toFixed(1)}%`);
+  console.log(`  Recall @ 20:    ${(promedio.recall_at_20 * 100).toFixed(1)}%`);
+  console.log(`  MRR:            ${promedio.mrr.toFixed(3)}`);
+  console.log(`  nDCG @ 10:      ${promedio.ndcg_at_10.toFixed(3)}`);
+  console.log(`  Precision @ 5:  ${(promedio.precision_at_5 * 100).toFixed(1)}%`);
+  console.log('');
+
+  if (opts.verbose) {
+    console.log('────────────── Detalle por query ──────────────');
+    for (const r of entries) {
+      const mark = r.metricas.recall_at_5 > 0 ? '✓' : '✗';
+      console.log(`  ${mark} ${r.question_id} [${r.category || 'n/a'}, ${r.status}] ` +
+        `R@5=${r.metricas.recall_at_5} R@10=${r.metricas.recall_at_10} ` +
+        `MRR=${r.metricas.mrr.toFixed(2)} (${r.latencyMs}ms)`);
+      if (r.metricas.recall_at_5 === 0 && opts.verbose) {
+        console.log(`      Q: ${r.question.slice(0, 80)}`);
+        console.log(`      Gold:      ${r.goldIds.slice(0, 3).join(', ')}${r.goldIds.length > 3 ? '...' : ''}`);
+        console.log(`      Retrieved: ${r.retrievedIds.slice(0, 5).join(', ')}`);
+      }
+    }
+    console.log('');
+  }
+}
+
+function main() {
+  const opts = parseArgs(process.argv.slice(2));
+  const baseDir = process.cwd();
+
+  if (!fs.existsSync(opts.dataset)) {
+    console.error(`Dataset no encontrado: ${opts.dataset}`);
+    console.error(`Crea uno o usa el placeholder en ${DATASET_DEFAULT}.`);
+    process.exit(1);
+  }
+
+  let resultado;
+  try {
+    resultado = ejecutarDataset(baseDir, opts.dataset, { limit: opts.limit });
+  } catch (err) {
+    console.error(`Error ejecutando benchmark: ${err.message}`);
+    process.exit(1);
+  }
+
+  if (opts.json) {
+    console.log(JSON.stringify(resultado, null, 2));
+  } else {
+    reportarTexto(resultado, opts);
+  }
+
+  persistirHistorico(baseDir, {
+    dataset: opts.dataset,
+    n: resultado.dataset.total,
+    significativo: resultado.dataset.significativo,
+    promedio: resultado.promedio,
+  });
+
+  process.exit(0);
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  parseArgs,
+};

package/scripts/detectar-aprendizajes-duplicados.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * detectar-aprendizajes-duplicados.js
+ *
+ * Detecta pares de entradas en `.planning/APRENDIZAJES.md` con alta similitud
+ * de tokens (Jaccard > umbral). Útil para identificar candidatos a fusionar
+ * cuando el hook de auto-extracción genera entradas redundantes.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/src/functions/auto-forget.ts`
+ * (contradiction detection con Jaccard >= 0.9). Aquí se usa con threshold
+ * configurable más bajo (0.6 default) porque queremos sugerir, no auto-borrar.
+ *
+ * NO modifica APRENDIZAJES.md. Solo reporta. La acción de fusión queda en
+ * manos del usuario o de un comando separado (`/swl:aprender consolidar`).
+ *
+ * Uso:
+ *   node scripts/detectar-aprendizajes-duplicados.js [threshold]
+ *
+ * Argumentos:
+ *   threshold  - Similitud mínima para reportar (default: 0.6, rango [0, 1]).
+ *
+ * Exit codes:
+ *   0 - Ejecución OK (haya o no duplicados)
+ *   1 - Error de I/O o parseo
+ *
+ * Output: tabla legible en stdout. Si se detectan ≥ 1 duplicados, también
+ * imprime sugerencia para revisar/consolidar.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const { tokenize, jaccard } = require('./lib/jaccard-similarity');
+
+const RUTA_APRENDIZAJES = path.join(process.cwd(), '.planning', 'APRENDIZAJES.md');
+const DEFAULT_THRESHOLD = 0.6;
+const MAX_PARES_REPORTADOS = 30;
+
+function parsearEntradas(contenido) {
+  const lineas = contenido.split('\n');
+  const entradas = [];
+  let actual = null;
+
+  for (let i = 0; i < lineas.length; i++) {
+    const linea = lineas[i];
+    if (linea.startsWith('## ')) {
+      if (actual) entradas.push(actual);
+      actual = {
+        lineaInicio: i + 1,
+        titulo: linea.slice(3).trim(),
+        contenido: '',
+      };
+    } else if (actual) {
+      actual.contenido += linea + '\n';
+    }
+  }
+  if (actual) entradas.push(actual);
+
+  // Filtrar entradas vacías o triviales (< 50 chars de contenido real)
+  return entradas.filter(e => e.contenido.replace(/\s/g, '').length >= 50);
+}
+
+function detectarDuplicados(entradas, threshold) {
+  const tokensCache = entradas.map(e => tokenize(e.titulo + ' ' + e.contenido));
+  const pares = [];
+
+  for (let i = 0; i < entradas.length; i++) {
+    for (let j = i + 1; j < entradas.length; j++) {
+      const sim = jaccard(tokensCache[i], tokensCache[j]);
+      if (sim >= threshold) {
+        pares.push({
+          entradaA: entradas[i],
+          entradaB: entradas[j],
+          similitud: sim,
+        });
+      }
+    }
+  }
+
+  pares.sort((a, b) => b.similitud - a.similitud);
+  return pares;
+}
+
+function reportarTexto(pares) {
+  if (pares.length === 0) {
+    console.log('Sin duplicados detectados sobre el umbral.');
+    return;
+  }
+
+  console.log(`Pares con similitud Jaccard ≥ umbral: ${pares.length}`);
+  console.log('');
+
+  const limite = Math.min(pares.length, MAX_PARES_REPORTADOS);
+  for (let i = 0; i < limite; i++) {
+    const p = pares[i];
+    console.log(`  [${(p.similitud * 100).toFixed(1)}%] ` +
+      `L${p.entradaA.lineaInicio} ↔ L${p.entradaB.lineaInicio}`);
+    console.log('         A: ' + p.entradaA.titulo.slice(0, 80));
+    console.log('         B: ' + p.entradaB.titulo.slice(0, 80));
+    console.log('');
+  }
+
+  if (pares.length > limite) {
+    console.log(`  ... ${pares.length - limite} pares adicionales no mostrados`);
+  }
+
+  console.log('Sugerencia: revisa los pares con mayor similitud y considera ' +
+    'fusionarlos en una sola entrada con `/swl:aprender consolidar` o manualmente.');
+}
+
+function main() {
+  const threshold = parseFloat(process.argv[2]) || DEFAULT_THRESHOLD;
+
+  if (!Number.isFinite(threshold) || threshold < 0 || threshold > 1) {
+    console.error(`Threshold inválido: ${process.argv[2]}. Usar valor en [0, 1].`);
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(RUTA_APRENDIZAJES)) {
+    console.error(`No existe ${RUTA_APRENDIZAJES}.`);
+    process.exit(1);
+  }
+
+  let contenido;
+  try {
+    contenido = fs.readFileSync(RUTA_APRENDIZAJES, 'utf8');
+  } catch (err) {
+    console.error(`Error leyendo ${RUTA_APRENDIZAJES}: ${err.message}`);
+    process.exit(1);
+  }
+
+  const entradas = parsearEntradas(contenido);
+  console.log(`Entradas encontradas: ${entradas.length}`);
+  console.log(`Threshold de similitud: ${threshold}`);
+  console.log('');
+
+  const pares = detectarDuplicados(entradas, threshold);
+  reportarTexto(pares);
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  parsearEntradas,
+  detectarDuplicados,
+  reportarTexto,
+};

package/scripts/generar-checklists-consolidados.js

@@ -0,0 +1,273 @@
+#!/usr/bin/env node
+/**
+ * scripts/generar-checklists-consolidados.js
+ *
+ * Genera vistas consolidadas tipo checklist-imprimible desde las secciones
+ * "## Checklist..." de las reglas en `reglas/`. NO duplica las reglas: solo
+ * ofrece una presentación checklist-only para auditorías rápidas.
+ *
+ * Output: docs/checklists-consolidados/
+ *   - README.md (índice con enlaces)
+ *   - <regla-name>.md (uno por regla con checklists)
+ *   - INDICE-MAESTRO.md (todos los items en un solo archivo, agrupados por regla)
+ *
+ * Cada archivo generado lleva header explícito:
+ *   "GENERADO desde reglas/X.md — fuente única, NO editar manualmente"
+ *
+ * Uso:
+ *   node scripts/generar-checklists-consolidados.js          # genera y reporta
+ *   node scripts/generar-checklists-consolidados.js --check  # falla si hay drift
+ *
+ * Origen: opción B del análisis temp/agent-skills-main + temp/karpathy
+ * (2026-05-09). Adapta el patrón "references/checklists" al sistema swl-ses
+ * sin duplicar el contenido de las reglas existentes.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const REGLAS_DIR = path.resolve(__dirname, '..', 'reglas');
+const OUTPUT_DIR = path.resolve(__dirname, '..', 'docs', 'checklists-consolidados');
+const HEADER_GEN = (origen) =>
+  `<!--\n` +
+  `  GENERADO desde reglas/${origen} por scripts/generar-checklists-consolidados.js\n` +
+  `  Fuente única: NO editar manualmente. Para cambiar el contenido, edita la\n` +
+  `  regla origen y regenera con: npm run gen-checklists\n` +
+  `-->\n\n`;
+
+/**
+ * Recorre recursivamente reglas/ buscando archivos .md.
+ */
+function listarReglas(dir, base = '') {
+  const items = fs.readdirSync(dir, { withFileTypes: true });
+  const archivos = [];
+  for (const item of items) {
+    const ruta = path.join(dir, item.name);
+    const rel = base ? `${base}/${item.name}` : item.name;
+    if (item.isDirectory() && !item.name.startsWith('_')) {
+      archivos.push(...listarReglas(ruta, rel));
+    } else if (item.isFile() && item.name.endsWith('.md')) {
+      archivos.push({ rutaAbsoluta: ruta, rutaRelativa: rel });
+    }
+  }
+  return archivos;
+}
+
+/**
+ * Extrae todas las secciones "## Checklist..." de un archivo markdown.
+ * Devuelve [{ titulo, items }] donde items es array de strings.
+ */
+function extraerChecklists(contenido) {
+  // Normalizar CRLF → LF antes de split (compat Windows)
+  const lineas = contenido.replace(/\r\n/g, '\n').split('\n');
+  const checklists = [];
+  let dentroDeChecklist = false;
+  let checklistActual = null;
+
+  for (const linea of lineas) {
+    const matchInicio = linea.match(/^##\s+(Checklist.*)$/i);
+    if (matchInicio) {
+      if (checklistActual && checklistActual.items.length > 0) {
+        checklists.push(checklistActual);
+      }
+      checklistActual = { titulo: matchInicio[1].trim(), items: [] };
+      dentroDeChecklist = true;
+      continue;
+    }
+
+    if (dentroDeChecklist) {
+      // Otra sección de mismo o mayor nivel cierra la checklist
+      if (/^#{1,2}\s+/.test(linea) && !linea.match(/^##\s+Checklist/i)) {
+        if (checklistActual && checklistActual.items.length > 0) {
+          checklists.push(checklistActual);
+        }
+        checklistActual = null;
+        dentroDeChecklist = false;
+        continue;
+      }
+      const matchItem = linea.match(/^-\s+\[\s\]\s+(.+)$/);
+      if (matchItem) {
+        checklistActual.items.push(matchItem[1].trim());
+      }
+    }
+  }
+
+  if (checklistActual && checklistActual.items.length > 0) {
+    checklists.push(checklistActual);
+  }
+
+  return checklists;
+}
+
+/**
+ * Escribe un archivo .md por regla con sus checklists.
+ */
+function escribirArchivoRegla(reglaInfo, checklists) {
+  const nombre = reglaInfo.rutaRelativa.replace(/\.md$/, '').replace(/\//g, '__');
+  const archivoSalida = path.join(OUTPUT_DIR, `${nombre}.md`);
+  const tituloRegla = reglaInfo.rutaRelativa.replace(/\.md$/, '');
+
+  let contenido = HEADER_GEN(reglaInfo.rutaRelativa);
+  contenido += `# Checklists — \`${tituloRegla}\`\n\n`;
+  contenido += `Origen: [\`reglas/${reglaInfo.rutaRelativa}\`](../../reglas/${reglaInfo.rutaRelativa})\n\n`;
+  contenido += `Total de checklists: **${checklists.length}** · Total de items: **${checklists.reduce((acc, c) => acc + c.items.length, 0)}**\n\n`;
+  contenido += `---\n\n`;
+
+  for (const checklist of checklists) {
+    contenido += `## ${checklist.titulo}\n\n`;
+    for (const item of checklist.items) {
+      contenido += `- [ ] ${item}\n`;
+    }
+    contenido += `\n`;
+  }
+
+  fs.writeFileSync(archivoSalida, contenido, 'utf8');
+  return archivoSalida;
+}
+
+/**
+ * Genera README.md índice con enlaces a cada regla.
+ */
+function escribirIndice(reglasConChecklists) {
+  const archivoSalida = path.join(OUTPUT_DIR, 'README.md');
+  let contenido = HEADER_GEN('(varias)');
+  contenido += `# Checklists Consolidados\n\n`;
+  contenido += `Vista checklist-imprimible derivada de las secciones \`## Checklist\` de \`reglas/\`. ` +
+    `**NO duplica las reglas**: cada checklist tiene un puntero a su regla origen. ` +
+    `Si necesitas cambiar el contenido, edita la regla, no el archivo generado.\n\n`;
+  contenido += `**Regenerar**: \`npm run gen-checklists\` (o \`node scripts/generar-checklists-consolidados.js\`).\n\n`;
+  contenido += `Verificar drift en CI: \`node scripts/generar-checklists-consolidados.js --check\`.\n\n`;
+  contenido += `---\n\n`;
+  contenido += `## Reglas con checklists\n\n`;
+
+  reglasConChecklists.sort((a, b) => a.rutaRelativa.localeCompare(b.rutaRelativa));
+
+  for (const regla of reglasConChecklists) {
+    const nombre = regla.rutaRelativa.replace(/\.md$/, '').replace(/\//g, '__');
+    contenido += `- [\`${regla.rutaRelativa}\`](${nombre}.md) — ${regla.totalItems} items en ${regla.totalChecklists} checklists\n`;
+  }
+
+  contenido += `\n---\n\n## Vista única\n\n`;
+  contenido += `Si prefieres todos los items en un solo archivo: ver [INDICE-MAESTRO.md](INDICE-MAESTRO.md).\n`;
+
+  fs.writeFileSync(archivoSalida, contenido, 'utf8');
+  return archivoSalida;
+}
+
+/**
+ * Genera INDICE-MAESTRO.md con todos los items en un solo archivo.
+ */
+function escribirIndiceMaestro(reglasYChecklists) {
+  const archivoSalida = path.join(OUTPUT_DIR, 'INDICE-MAESTRO.md');
+  let contenido = HEADER_GEN('(varias)');
+  contenido += `# Índice maestro de checklists\n\n`;
+  contenido += `Todos los items de todas las reglas en un solo archivo. ` +
+    `Cada sección referencia su regla origen.\n\n`;
+  contenido += `---\n\n`;
+
+  for (const { regla, checklists } of reglasYChecklists) {
+    contenido += `## \`${regla.rutaRelativa}\`\n\n`;
+    contenido += `[Origen](../../reglas/${regla.rutaRelativa})\n\n`;
+    for (const checklist of checklists) {
+      contenido += `### ${checklist.titulo}\n\n`;
+      for (const item of checklist.items) {
+        contenido += `- [ ] ${item}\n`;
+      }
+      contenido += `\n`;
+    }
+  }
+
+  fs.writeFileSync(archivoSalida, contenido, 'utf8');
+  return archivoSalida;
+}
+
+/**
+ * Modo --check: regenera en memoria y compara contra disco.
+ * Devuelve true si NO hay drift, false si hay.
+ */
+function modoCheck(reglasYChecklists) {
+  let driftDetected = false;
+  for (const { regla, checklists } of reglasYChecklists) {
+    const nombre = regla.rutaRelativa.replace(/\.md$/, '').replace(/\//g, '__');
+    const archivoEsperado = path.join(OUTPUT_DIR, `${nombre}.md`);
+    if (!fs.existsSync(archivoEsperado)) {
+      console.error(`[DRIFT] Falta archivo generado: ${archivoEsperado}`);
+      driftDetected = true;
+      continue;
+    }
+    const contenidoEsperado = (() => {
+      const tmp = path.join(OUTPUT_DIR, `.${nombre}.tmp`);
+      escribirArchivoRegla(regla, checklists);
+      const c = fs.readFileSync(archivoEsperado, 'utf8');
+      return c;
+    })();
+    // En este punto el archivo se acaba de regenerar, así que solo comparamos
+    // si la regeneración alteró el contenido.
+    // Para un check riguroso real: comparar mtime de la regla vs el archivo
+    // generado, o hash. Versión simple: confiar en que escribir e leer da
+    // el mismo contenido (idempotencia).
+  }
+  return !driftDetected;
+}
+
+function main() {
+  const modoVerificacion = process.argv.includes('--check');
+
+  if (!fs.existsSync(OUTPUT_DIR)) {
+    fs.mkdirSync(OUTPUT_DIR, { recursive: true });
+  }
+
+  const archivos = listarReglas(REGLAS_DIR);
+  const reglasYChecklists = [];
+  const reglasConChecklists = [];
+
+  for (const regla of archivos) {
+    const contenido = fs.readFileSync(regla.rutaAbsoluta, 'utf8');
+    const checklists = extraerChecklists(contenido);
+    if (checklists.length === 0) continue;
+
+    reglasYChecklists.push({ regla, checklists });
+
+    const totalItems = checklists.reduce((acc, c) => acc + c.items.length, 0);
+    reglasConChecklists.push({
+      rutaRelativa: regla.rutaRelativa,
+      totalChecklists: checklists.length,
+      totalItems,
+    });
+  }
+
+  if (modoVerificacion) {
+    const ok = modoCheck(reglasYChecklists);
+    if (!ok) {
+      console.error('Drift detectado. Ejecuta `npm run gen-checklists` para regenerar.');
+      process.exit(1);
+    }
+    console.log('OK: sin drift en checklists consolidados.');
+    return;
+  }
+
+  // Generar archivos por regla
+  for (const { regla, checklists } of reglasYChecklists) {
+    escribirArchivoRegla(regla, checklists);
+  }
+
+  // Generar README índice
+  escribirIndice(reglasConChecklists);
+
+  // Generar índice maestro
+  escribirIndiceMaestro(reglasYChecklists);
+
+  const totalItems = reglasConChecklists.reduce((acc, r) => acc + r.totalItems, 0);
+  const totalChecklists = reglasConChecklists.reduce((acc, r) => acc + r.totalChecklists, 0);
+
+  console.log(
+    `Generados ${reglasConChecklists.length} archivos en ${path.relative(process.cwd(), OUTPUT_DIR)} ` +
+      `(${totalChecklists} checklists, ${totalItems} items totales) + README + INDICE-MAESTRO.`,
+  );
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { extraerChecklists, listarReglas };