@saulwade/swl-ses 2.6.1 → 2.8.0

package/scripts/lib/detector-autoduplicacion-intra-archivo.js

@@ -1,234 +1,234 @@
-'use strict';
-
-/**
- * scripts/lib/detector-autoduplicacion-intra-archivo.js
- *
- * Dimensión 9 del auditor CLAUDE.md (v1.7.2). Detecta auto-duplicación
- * INTRA-archivo: cuando 2+ secciones H2 del mismo CLAUDE.md citan el
- * mismo archivo de regla global de ~/.claude/rules/. Complementa la
- * dimensión 8 (detector-reglas-duplicadas.js) que detecta duplicación
- * INTER-archivo (paráfrasis de regla global).
- *
- * Caso de uso típico:
- *   ## Reglas obligatorias
- *   ...referencia a usar-sistema-swl.md...
- *
- *   ## Flujo de trabajo
- *   ...referencia a usar-sistema-swl.md + matiz local...
- *
- * Diagnóstico: ambas secciones citan la misma regla. Una probablemente
- * es boilerplate sin contenido propio; consolidar en UNA sola sección
- * con referencia + matiz local (si lo hay).
- *
- * Excepciones (no cuenta como duplicación):
- *   - Citas dentro de tabla Markdown (catálogo organizado intencional):
- *     `| usar-sistema-swl.md | Siempre — matriz operacional |`
- *   - Archivos < 20 LOC.
- *   - User-level (~/.claude/CLAUDE.md): preferencias personales aceptadas.
- *
- * Public API:
- *   detectarAutoduplicacionIntraArchivo(contenido, opciones) → { autoduplicaciones }
- *   parsearSeccionesH2(contenido) → [{titulo, lineaInicio, contenido, fin}]
- *
- * Zero-dependency (solo fs/path).
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const RUTA_CATALOGO_DEFAULT = path.join(__dirname, 'reglas-globales-conocidas.json');
-
-function cargarCatalogo(rutaJson = RUTA_CATALOGO_DEFAULT) {
-  if (!fs.existsSync(rutaJson)) {
-    throw new Error(`Catálogo no encontrado: ${rutaJson}`);
-  }
-  return JSON.parse(fs.readFileSync(rutaJson, 'utf8'));
-}
-
-/**
- * Parsea el contenido en secciones H2 (encabezados `## `). Cada sección
- * incluye todo el contenido hasta el siguiente H2 (o EOF), incluyendo
- * sub-secciones H3/H4 anidadas.
- *
- * Sección virtual "preludio" si el archivo tiene contenido antes del
- * primer H2 (típicamente H1 + descripción).
- *
- * @returns {Array} secciones con {titulo, lineaInicio, lineaFin, contenido}
- */
-function parsearSeccionesH2(contenido) {
-  const lineas = contenido.split(/\r?\n/);
-  const secciones = [];
-  let actual = {
-    titulo: '__preludio__',
-    lineaInicio: 1,
-    inicio: 0,
-    fin: null,
-    contenido: '',
-  };
-
-  for (let i = 0; i < lineas.length; i++) {
-    const linea = lineas[i];
-    // H2 exacto (## seguido de espacio, NO ### ni más)
-    const matchH2 = linea.match(/^##\s+(?!#)(.+?)\s*$/);
-    if (matchH2) {
-      // cerrar la sección actual antes de abrir la nueva
-      actual.fin = i;
-      actual.contenido = lineas.slice(actual.inicio, actual.fin).join('\n');
-      if (actual.titulo !== '__preludio__' || actual.contenido.trim().length > 0) {
-        secciones.push(actual);
-      }
-      actual = {
-        titulo: matchH2[1].trim(),
-        lineaInicio: i + 1,
-        inicio: i,
-        fin: null,
-        contenido: '',
-      };
-    }
-  }
-  // cerrar última sección
-  actual.fin = lineas.length;
-  actual.contenido = lineas.slice(actual.inicio, actual.fin).join('\n');
-  if (actual.titulo !== '__preludio__' || actual.contenido.trim().length > 0) {
-    secciones.push(actual);
-  }
-  return secciones;
-}
-
-/**
- * Verifica si TODAS las menciones del archivo de regla en una sección
- * están dentro de patrones excluidos (no son prosa boilerplate). Si todas
- * están excluidas, la sección NO cuenta como mención sustantiva.
- *
- * Patrones excluidos:
- *   1. Mención dentro de tabla Markdown (línea empieza con `|`)
- *      → catálogo organizado intencional, no boilerplate
- *   2. Mención como @-reference standalone (línea entera es `@path/X.md`)
- *      → @-include que carga el contenido de la regla, no descripción
- *
- * Una sección con todas sus menciones excluidas se considera "catálogo o
- * include" y no entra en el conteo de auto-duplicación intra-archivo.
- */
-function todasLasMencionesEstanExcluidas(seccionContenido, reglaArchivo) {
-  const lineas = seccionContenido.split(/\r?\n/);
-  let totalMenciones = 0;
-  let mencionesExcluidas = 0;
-  const reFilename = new RegExp('\\b' + escapeRegex(reglaArchivo), 'i');
-
-  for (const linea of lineas) {
-    if (!reFilename.test(linea)) continue;
-    totalMenciones++;
-    const trimmed = linea.trim();
-    // Excepción 1: línea de tabla Markdown
-    if (/^\|/.test(trimmed)) {
-      mencionesExcluidas++;
-      continue;
-    }
-    // Excepción 2: @-reference standalone (línea entera es @path/X.md)
-    if (/^@[\w./~\-]+\.md\s*$/.test(trimmed)) {
-      mencionesExcluidas++;
-      continue;
-    }
-  }
-  return totalMenciones > 0 && mencionesExcluidas === totalMenciones;
-}
-
-/**
- * Detecta auto-duplicación intra-archivo.
- *
- * @param {string} contenido - CLAUDE.md completo
- * @param {object} [opciones]
- * @param {boolean} [opciones.skipUserLevel=true]
- * @param {boolean} [opciones.esUserLevel=false]
- * @param {object} [opciones.catalogo] - catálogo precargado (opcional)
- * @returns {object} { evaluado, autoduplicaciones, total_secciones }
- */
-function detectarAutoduplicacionIntraArchivo(contenido, opciones = {}) {
-  const skipUserLevel = opciones.skipUserLevel !== false;
-  const esUserLevel = opciones.esUserLevel === true;
-
-  if (skipUserLevel && esUserLevel) {
-    return {
-      evaluado: false,
-      razon: 'user-level — no evaluado',
-      autoduplicaciones: [],
-      total_secciones: 0,
-    };
-  }
-
-  const catalogo = opciones.catalogo || cargarCatalogo();
-  const minLineas = catalogo.configuracion?.min_lineas_archivo ?? 20;
-  const lineas = contenido.split(/\r?\n/);
-
-  if (lineas.length < minLineas) {
-    return {
-      evaluado: false,
-      razon: `archivo < ${minLineas} LOC — no acumula auto-duplicaciones`,
-      autoduplicaciones: [],
-      total_secciones: 0,
-    };
-  }
-
-  const secciones = parsearSeccionesH2(contenido);
-
-  if (secciones.length < 2) {
-    return {
-      evaluado: true,
-      autoduplicaciones: [],
-      total_secciones: secciones.length,
-    };
-  }
-
-  const autoduplicaciones = [];
-
-  for (const regla of catalogo.reglas) {
-    const reFilename = new RegExp('\\b' + escapeRegex(regla.regla_global), 'i');
-    const seccionesQueLaCitan = [];
-
-    for (const sec of secciones) {
-      if (!reFilename.test(sec.contenido)) continue;
-      // Excluir si TODAS las menciones en esta sección están en tabla
-      if (todasLasMencionesEstanExcluidas(sec.contenido, regla.regla_global)) continue;
-      seccionesQueLaCitan.push({
-        titulo: sec.titulo,
-        linea: sec.lineaInicio,
-      });
-    }
-
-    if (seccionesQueLaCitan.length >= 2) {
-      autoduplicaciones.push({
-        id: regla.id,
-        regla_global: regla.regla_global,
-        referencia_canonica: regla.referencia_canonica,
-        secciones: seccionesQueLaCitan,
-        cantidad_secciones: seccionesQueLaCitan.length,
-        remediacion:
-          `${seccionesQueLaCitan.length} secciones del mismo CLAUDE.md citan ` +
-          `\`${regla.regla_global}\`: ${seccionesQueLaCitan.map(s => `"${s.titulo}" (L${s.linea})`).join(', ')}. ` +
-          `Consolidar en UNA sola sección con referencia canónica + matiz local ` +
-          `(si lo hay). Si ninguna sección agrega matiz operacional propio sobre ` +
-          `la regla global, eliminar todas menos una.`,
-        severidad: catalogo.configuracion?.severidad_default || 'WARN',
-      });
-    }
-  }
-
-  return {
-    evaluado: true,
-    autoduplicaciones,
-    total_secciones: secciones.length,
-  };
-}
-
-function escapeRegex(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-module.exports = {
-  cargarCatalogo,
-  parsearSeccionesH2,
-  detectarAutoduplicacionIntraArchivo,
-  // exports privados para tests
-  _todasLasMencionesEstanExcluidas: todasLasMencionesEstanExcluidas,
-  RUTA_CATALOGO_DEFAULT,
-};
+'use strict';
+
+/**
+ * scripts/lib/detector-autoduplicacion-intra-archivo.js
+ *
+ * Dimensión 9 del auditor CLAUDE.md (v1.7.2). Detecta auto-duplicación
+ * INTRA-archivo: cuando 2+ secciones H2 del mismo CLAUDE.md citan el
+ * mismo archivo de regla global de ~/.claude/rules/. Complementa la
+ * dimensión 8 (detector-reglas-duplicadas.js) que detecta duplicación
+ * INTER-archivo (paráfrasis de regla global).
+ *
+ * Caso de uso típico:
+ *   ## Reglas obligatorias
+ *   ...referencia a usar-sistema-swl.md...
+ *
+ *   ## Flujo de trabajo
+ *   ...referencia a usar-sistema-swl.md + matiz local...
+ *
+ * Diagnóstico: ambas secciones citan la misma regla. Una probablemente
+ * es boilerplate sin contenido propio; consolidar en UNA sola sección
+ * con referencia + matiz local (si lo hay).
+ *
+ * Excepciones (no cuenta como duplicación):
+ *   - Citas dentro de tabla Markdown (catálogo organizado intencional):
+ *     `| usar-sistema-swl.md | Siempre — matriz operacional |`
+ *   - Archivos < 20 LOC.
+ *   - User-level (~/.claude/CLAUDE.md): preferencias personales aceptadas.
+ *
+ * Public API:
+ *   detectarAutoduplicacionIntraArchivo(contenido, opciones) → { autoduplicaciones }
+ *   parsearSeccionesH2(contenido) → [{titulo, lineaInicio, contenido, fin}]
+ *
+ * Zero-dependency (solo fs/path).
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const RUTA_CATALOGO_DEFAULT = path.join(__dirname, 'reglas-globales-conocidas.json');
+
+function cargarCatalogo(rutaJson = RUTA_CATALOGO_DEFAULT) {
+  if (!fs.existsSync(rutaJson)) {
+    throw new Error(`Catálogo no encontrado: ${rutaJson}`);
+  }
+  return JSON.parse(fs.readFileSync(rutaJson, 'utf8'));
+}
+
+/**
+ * Parsea el contenido en secciones H2 (encabezados `## `). Cada sección
+ * incluye todo el contenido hasta el siguiente H2 (o EOF), incluyendo
+ * sub-secciones H3/H4 anidadas.
+ *
+ * Sección virtual "preludio" si el archivo tiene contenido antes del
+ * primer H2 (típicamente H1 + descripción).
+ *
+ * @returns {Array} secciones con {titulo, lineaInicio, lineaFin, contenido}
+ */
+function parsearSeccionesH2(contenido) {
+  const lineas = contenido.split(/\r?\n/);
+  const secciones = [];
+  let actual = {
+    titulo: '__preludio__',
+    lineaInicio: 1,
+    inicio: 0,
+    fin: null,
+    contenido: '',
+  };
+
+  for (let i = 0; i < lineas.length; i++) {
+    const linea = lineas[i];
+    // H2 exacto (## seguido de espacio, NO ### ni más)
+    const matchH2 = linea.match(/^##\s+(?!#)(.+?)\s*$/);
+    if (matchH2) {
+      // cerrar la sección actual antes de abrir la nueva
+      actual.fin = i;
+      actual.contenido = lineas.slice(actual.inicio, actual.fin).join('\n');
+      if (actual.titulo !== '__preludio__' || actual.contenido.trim().length > 0) {
+        secciones.push(actual);
+      }
+      actual = {
+        titulo: matchH2[1].trim(),
+        lineaInicio: i + 1,
+        inicio: i,
+        fin: null,
+        contenido: '',
+      };
+    }
+  }
+  // cerrar última sección
+  actual.fin = lineas.length;
+  actual.contenido = lineas.slice(actual.inicio, actual.fin).join('\n');
+  if (actual.titulo !== '__preludio__' || actual.contenido.trim().length > 0) {
+    secciones.push(actual);
+  }
+  return secciones;
+}
+
+/**
+ * Verifica si TODAS las menciones del archivo de regla en una sección
+ * están dentro de patrones excluidos (no son prosa boilerplate). Si todas
+ * están excluidas, la sección NO cuenta como mención sustantiva.
+ *
+ * Patrones excluidos:
+ *   1. Mención dentro de tabla Markdown (línea empieza con `|`)
+ *      → catálogo organizado intencional, no boilerplate
+ *   2. Mención como @-reference standalone (línea entera es `@path/X.md`)
+ *      → @-include que carga el contenido de la regla, no descripción
+ *
+ * Una sección con todas sus menciones excluidas se considera "catálogo o
+ * include" y no entra en el conteo de auto-duplicación intra-archivo.
+ */
+function todasLasMencionesEstanExcluidas(seccionContenido, reglaArchivo) {
+  const lineas = seccionContenido.split(/\r?\n/);
+  let totalMenciones = 0;
+  let mencionesExcluidas = 0;
+  const reFilename = new RegExp('\\b' + escapeRegex(reglaArchivo), 'i');
+
+  for (const linea of lineas) {
+    if (!reFilename.test(linea)) continue;
+    totalMenciones++;
+    const trimmed = linea.trim();
+    // Excepción 1: línea de tabla Markdown
+    if (/^\|/.test(trimmed)) {
+      mencionesExcluidas++;
+      continue;
+    }
+    // Excepción 2: @-reference standalone (línea entera es @path/X.md)
+    if (/^@[\w./~\-]+\.md\s*$/.test(trimmed)) {
+      mencionesExcluidas++;
+      continue;
+    }
+  }
+  return totalMenciones > 0 && mencionesExcluidas === totalMenciones;
+}
+
+/**
+ * Detecta auto-duplicación intra-archivo.
+ *
+ * @param {string} contenido - CLAUDE.md completo
+ * @param {object} [opciones]
+ * @param {boolean} [opciones.skipUserLevel=true]
+ * @param {boolean} [opciones.esUserLevel=false]
+ * @param {object} [opciones.catalogo] - catálogo precargado (opcional)
+ * @returns {object} { evaluado, autoduplicaciones, total_secciones }
+ */
+function detectarAutoduplicacionIntraArchivo(contenido, opciones = {}) {
+  const skipUserLevel = opciones.skipUserLevel !== false;
+  const esUserLevel = opciones.esUserLevel === true;
+
+  if (skipUserLevel && esUserLevel) {
+    return {
+      evaluado: false,
+      razon: 'user-level — no evaluado',
+      autoduplicaciones: [],
+      total_secciones: 0,
+    };
+  }
+
+  const catalogo = opciones.catalogo || cargarCatalogo();
+  const minLineas = catalogo.configuracion?.min_lineas_archivo ?? 20;
+  const lineas = contenido.split(/\r?\n/);
+
+  if (lineas.length < minLineas) {
+    return {
+      evaluado: false,
+      razon: `archivo < ${minLineas} LOC — no acumula auto-duplicaciones`,
+      autoduplicaciones: [],
+      total_secciones: 0,
+    };
+  }
+
+  const secciones = parsearSeccionesH2(contenido);
+
+  if (secciones.length < 2) {
+    return {
+      evaluado: true,
+      autoduplicaciones: [],
+      total_secciones: secciones.length,
+    };
+  }
+
+  const autoduplicaciones = [];
+
+  for (const regla of catalogo.reglas) {
+    const reFilename = new RegExp('\\b' + escapeRegex(regla.regla_global), 'i');
+    const seccionesQueLaCitan = [];
+
+    for (const sec of secciones) {
+      if (!reFilename.test(sec.contenido)) continue;
+      // Excluir si TODAS las menciones en esta sección están en tabla
+      if (todasLasMencionesEstanExcluidas(sec.contenido, regla.regla_global)) continue;
+      seccionesQueLaCitan.push({
+        titulo: sec.titulo,
+        linea: sec.lineaInicio,
+      });
+    }
+
+    if (seccionesQueLaCitan.length >= 2) {
+      autoduplicaciones.push({
+        id: regla.id,
+        regla_global: regla.regla_global,
+        referencia_canonica: regla.referencia_canonica,
+        secciones: seccionesQueLaCitan,
+        cantidad_secciones: seccionesQueLaCitan.length,
+        remediacion:
+          `${seccionesQueLaCitan.length} secciones del mismo CLAUDE.md citan ` +
+          `\`${regla.regla_global}\`: ${seccionesQueLaCitan.map(s => `"${s.titulo}" (L${s.linea})`).join(', ')}. ` +
+          `Consolidar en UNA sola sección con referencia canónica + matiz local ` +
+          `(si lo hay). Si ninguna sección agrega matiz operacional propio sobre ` +
+          `la regla global, eliminar todas menos una.`,
+        severidad: catalogo.configuracion?.severidad_default || 'WARN',
+      });
+    }
+  }
+
+  return {
+    evaluado: true,
+    autoduplicaciones,
+    total_secciones: secciones.length,
+  };
+}
+
+function escapeRegex(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+module.exports = {
+  cargarCatalogo,
+  parsearSeccionesH2,
+  detectarAutoduplicacionIntraArchivo,
+  // exports privados para tests
+  _todasLasMencionesEstanExcluidas: todasLasMencionesEstanExcluidas,
+  RUTA_CATALOGO_DEFAULT,
+};