@saulwade/swl-ses 1.4.1 → 1.5.0

package/scripts/generar-inventario.js

@@ -1,420 +1,420 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * generar-inventario.js — Genera INVENTARIO.md y SALUD.md desde el disco.
- *
- * Elimina la necesidad de mantener estos archivos manualmente.
- * Lee el estado real de agentes/, habilidades/, hooks/, etc.
- *
- * Uso:
- *   node scripts/generar-inventario.js                 # Genera ambos
- *   node scripts/generar-inventario.js --inventario    # Solo INVENTARIO.md
- *   node scripts/generar-inventario.js --salud         # Solo SALUD.md
- *   node scripts/generar-inventario.js --dry-run       # Muestra sin escribir
- *
- * @module scripts/generar-inventario
- */
-
-const fs   = require('fs');
-const path = require('path');
-
-const RAIZ = path.resolve(__dirname, '..');
-
-// Escritura atómica obligatoria (regla CLAUDE.md). INVENTARIO.md y SALUD.md
-// son artefactos de release; corrupción durante regeneración rompe la gate.
-let atomicWriteSync;
-try {
-  ({ atomicWriteSync } = require(path.join(RAIZ, 'hooks', 'lib', 'atomic-write.js')));
-} catch {
-  atomicWriteSync = (p, c, e) => fs.writeFileSync(p, c, e);
-}
-const args = new Set(process.argv.slice(2));
-const DRY  = args.has('--dry-run');
-const SOLO_INV = args.has('--inventario');
-const SOLO_SAL = args.has('--salud');
-const AMBOS = !SOLO_INV && !SOLO_SAL;
-
-// ── Helpers ────────────────────────────────────────────────────────────
-
-function leerFrontmatter(ruta) {
-  try {
-    const contenido = fs.readFileSync(ruta, 'utf8');
-    const match = contenido.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-    if (!match) return {};
-    const fm = {};
-    for (const linea of match[1].split(/\r?\n/)) {
-      const idx = linea.indexOf(':');
-      if (idx > 0) {
-        const key = linea.slice(0, idx).trim();
-        const val = linea.slice(idx + 1).trim().replace(/^["']|["']$/g, '');
-        fm[key] = val;
-      }
-    }
-    return fm;
-  } catch { return {}; }
-}
-
-function contarArchivos(dir, ext) {
-  try {
-    return fs.readdirSync(dir).filter(f => f.endsWith(ext)).length;
-  } catch { return 0; }
-}
-
-function contarDirectorios(dir) {
-  try {
-    return fs.readdirSync(dir).filter(d =>
-      fs.statSync(path.join(dir, d)).isDirectory()
-    ).length;
-  } catch { return 0; }
-}
-
-function contarSkills(dir) {
-  try {
-    return fs.readdirSync(dir).filter(d => {
-      const skillMd = path.join(dir, d, 'SKILL.md');
-      return fs.existsSync(skillMd);
-    }).length;
-  } catch { return 0; }
-}
-
-// ── Recolectar datos ──────────────────────────────────────────────────
-
-function recolectarAgentes() {
-  const dir = path.join(RAIZ, 'agentes');
-  const archivos = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
-  return archivos.map(f => {
-    const fm = leerFrontmatter(path.join(dir, f));
-    return {
-      archivo: f,
-      name: fm.name || f.replace('.md', ''),
-      version: fm.version || '?',
-      model: fm.model || '?',
-      nivelRiesgo: fm.nivelRiesgo || '?',
-    };
-  });
-}
-
-function recolectarSkills() {
-  const dir = path.join(RAIZ, 'habilidades');
-  const dirs = fs.readdirSync(dir).filter(d =>
-    fs.existsSync(path.join(dir, d, 'SKILL.md'))
-  );
-  return dirs.map(d => {
-    const fm = leerFrontmatter(path.join(dir, d, 'SKILL.md'));
-    return { dir: d, name: fm.name || d, description: (fm.description || '').substring(0, 80) };
-  });
-}
-
-function recolectarHooks() {
-  const dir = path.join(RAIZ, 'hooks');
-  return fs.readdirSync(dir).filter(f => f.endsWith('.js') && f !== 'lib');
-}
-
-function recolectarLibs() {
-  const dir = path.join(RAIZ, 'hooks', 'lib');
-  return fs.readdirSync(dir).filter(f => f.endsWith('.js'));
-}
-
-function verificarSintaxis(archivos, dirBase) {
-  const { execSync } = require('child_process');
-  let ok = 0, fail = 0;
-  for (const f of archivos) {
-    try {
-      execSync(`node -c "${path.join(dirBase, f)}"`, { stdio: 'pipe' });
-      ok++;
-    } catch { fail++; }
-  }
-  return { ok, fail, total: archivos.length };
-}
-
-// ── Generar INVENTARIO.md ─────────────────────────────────────────────
-
-function generarInventario() {
-  const pkg = JSON.parse(fs.readFileSync(path.join(RAIZ, 'package.json'), 'utf8'));
-  const agentes  = recolectarAgentes();
-  const skills   = recolectarSkills();
-  const hooks    = recolectarHooks();
-  const libs     = recolectarLibs();
-  const comandos = contarArchivos(path.join(RAIZ, 'comandos', 'swl'), '.md');
-  const reglasBase = contarArchivos(path.join(RAIZ, 'reglas'), '.md');
-  const reglasLang = fs.readdirSync(path.join(RAIZ, 'reglas', 'lenguajes'))
-    .filter(d => fs.statSync(path.join(RAIZ, 'reglas', 'lenguajes', d)).isDirectory())
-    .reduce((acc, d) => acc + contarArchivos(path.join(RAIZ, 'reglas', 'lenguajes', d), '.md'), 0);
-  const schemas  = contarArchivos(path.join(RAIZ, 'schemas'), '.json');
-  const scripts  = contarArchivos(path.join(RAIZ, 'scripts', 'lib'), '.js') + contarArchivos(path.join(RAIZ, 'scripts', 'lib'), '.py');
-
-  const lines = [];
-  lines.push(`# INVENTARIO.md — Referencia completa de componentes SWL v${pkg.version}`);
-  lines.push('');
-  lines.push('> Archivo generado automáticamente por `node scripts/generar-inventario.js`.');
-  lines.push('> NO editar manualmente — se regenera con cada release.');
-  lines.push('');
-  lines.push('## Resumen');
-  lines.push('');
-  lines.push('| Componente | Cantidad |');
-  lines.push('|-----------|----------|');
-  lines.push(`| Agentes SWL | ${agentes.length} |`);
-  lines.push(`| Habilidades | ${skills.length} |`);
-  lines.push(`| Comandos | ${comandos} |`);
-  lines.push(`| Reglas base | ${reglasBase} |`);
-  lines.push(`| Reglas por lenguaje | ${reglasLang} |`);
-  lines.push(`| Hooks | ${hooks.length} |`);
-  lines.push(`| Librerías de hooks | ${libs.length} |`);
-  lines.push(`| Schemas | ${schemas} |`);
-  lines.push(`| Scripts lib | ${scripts} |`);
-  lines.push('');
-
-  // Equipos
-  lines.push('## Equipos de agentes (paralelización real)');
-  lines.push('');
-  lines.push('| Equipo | Líder | Miembros paralelos | Cuándo |');
-  lines.push('|--------|-------|-------------------|--------|');
-  lines.push('| Discovery | investigador-swl | investigador-ux-swl, producto-prd-swl | Proyecto nuevo |');
-  lines.push('| Arquitectura | arquitecto-swl | rendimiento-swl, revisor-seguridad-swl | Decisión de diseño |');
-  lines.push('| Frontend | frontend-swl | frontend-react-swl, frontend-css-swl, frontend-tailwind-swl | Feature UI compleja |');
-  lines.push('| Backend | backend-python-swl | backend-api-swl, backend-workers-swl | Feature backend compleja |');
-  lines.push('| Mobile | mobile-cross-swl | mobile-android-swl, mobile-ios-swl, mobile-testing-swl | Feature mobile |');
-  lines.push('| Calidad | tdd-qa-swl | revisor-codigo-swl, revisor-seguridad-swl, accesibilidad-wcag-swl | Pre-release |');
-  lines.push('| Operaciones | devops-ci-swl | cloud-infra-swl, observabilidad-swl, sre-swl | Deploy, infra, confiabilidad |');
-  lines.push('| Cierre | consolidador-swl | documentador-swl, release-manager-swl, notificador-swl | Fase completada |');
-  lines.push('');
-
-  // Agentes
-  lines.push(`## Agentes SWL — Registro completo (${agentes.length})`);
-  lines.push('');
-  lines.push('| Agente | Versión | Modelo | Riesgo |');
-  lines.push('|--------|---------|--------|--------|');
-  for (const a of agentes.sort((x, y) => x.name.localeCompare(y.name))) {
-    lines.push(`| ${a.name} | ${a.version} | ${a.model} | ${a.nivelRiesgo} |`);
-  }
-  lines.push('');
-
-  // Hooks
-  lines.push(`## Hooks activos (${hooks.length} + ${libs.length} librerías)`);
-  lines.push('');
-  lines.push('| Hook | Archivo |');
-  lines.push('|------|---------|');
-  for (const h of hooks.sort()) {
-    lines.push(`| ${h.replace('.js', '')} | \`hooks/${h}\` |`);
-  }
-  lines.push('');
-
-  // Libs
-  lines.push(`### Librerías de hooks (hooks/lib/) — ${libs.length}`);
-  lines.push('');
-  lines.push('| Librería | Archivo |');
-  lines.push('|----------|---------|');
-  for (const l of libs.sort()) {
-    lines.push(`| ${l.replace('.js', '')} | \`hooks/lib/${l}\` |`);
-  }
-  lines.push('');
-
-  return lines.join('\n');
-}
-
-// ── Generar SALUD.md ──────────────────────────────────────────────────
-
-/**
- * Componentes críticos del sistema cuya conducta debe estar verificada con
- * tests/evals para que el score conductual no sea opaco.
- *
- * Cada entrada lista los keywords que matchean nombres de archivos en tests/
- * o evals/. Si al menos un archivo coincide, el componente tiene cobertura
- * conductual mínima.
- */
-const COMPONENTES_CRITICOS = [
-  { id: 'orquestador',     keywords: ['orquestador', 'orquestacion'] },
-  { id: 'auto-evolucion',  keywords: ['auto-evolucion', 'auto-evolution'] },
-  { id: 'red-team',        keywords: ['red-team', 'redteam'] },
-  { id: 'risk-scoring',    keywords: ['risk-scoring', 'risk_scoring', 'risk-engine'] },
-  { id: 'memory-search',   keywords: ['memory-search', 'memoria-busqueda'] },
-  { id: 'command-relay',   keywords: ['command-relay', 'gateway'] },
-  { id: 'privacy-filter',  keywords: ['privacy', 'privacy-filter', 'privacy-memoria'] },
-  { id: 'delegation',      keywords: ['delegation', 'delegacion'] },
-];
-
-/**
- * Calcula cobertura conductual: cuántos componentes críticos tienen ≥1 archivo
- * de test o eval. NO mide calidad de los tests — solo presencia mínima.
- */
-function calcularScoreConductual() {
-  const todosTests = [];
-  const walk = (dir) => {
-    let entries;
-    try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
-    catch { return; }
-    for (const e of entries) {
-      const full = path.join(dir, e.name);
-      if (e.isDirectory()) walk(full);
-      else todosTests.push(full.toLowerCase());
-    }
-  };
-  walk(path.join(RAIZ, 'tests'));
-  // También considerar evals dentro de habilidades/*/evals/
-  walk(path.join(RAIZ, 'habilidades'));
-
-  const cobertura = COMPONENTES_CRITICOS.map(c => {
-    const cubierto = todosTests.some(t =>
-      c.keywords.some(k => t.includes(k.toLowerCase()))
-    );
-    return { id: c.id, cubierto };
-  });
-
-  const cubiertos = cobertura.filter(c => c.cubierto).length;
-  const total = cobertura.length;
-  return {
-    cubiertos,
-    total,
-    porcentaje: Math.round((cubiertos / total) * 100),
-    detalle: cobertura,
-  };
-}
-
-function generarSalud() {
-  const pkg = JSON.parse(fs.readFileSync(path.join(RAIZ, 'package.json'), 'utf8'));
-  const plugin = JSON.parse(fs.readFileSync(path.join(RAIZ, 'plugin.json'), 'utf8'));
-  const agentes  = recolectarAgentes();
-  const skills   = recolectarSkills();
-  const hooks    = recolectarHooks();
-  const libs     = recolectarLibs();
-  const comandos = contarArchivos(path.join(RAIZ, 'comandos', 'swl'), '.md');
-  const reglasBase = contarArchivos(path.join(RAIZ, 'reglas'), '.md');
-  const reglasLang = fs.readdirSync(path.join(RAIZ, 'reglas', 'lenguajes'))
-    .filter(d => fs.statSync(path.join(RAIZ, 'reglas', 'lenguajes', d)).isDirectory())
-    .reduce((acc, d) => acc + contarArchivos(path.join(RAIZ, 'reglas', 'lenguajes', d), '.md'), 0);
-  const schemas  = contarArchivos(path.join(RAIZ, 'schemas'), '.json');
-
-  // Verificar sintaxis
-  const hookSyntax = verificarSintaxis(hooks, path.join(RAIZ, 'hooks'));
-  const libSyntax  = verificarSintaxis(libs, path.join(RAIZ, 'hooks', 'lib'));
-
-  // Verificar frontmatter
-  let agentesOk = 0;
-  for (const a of agentes) {
-    if (a.name !== '?' && a.version !== '?') agentesOk++;
-  }
-
-  // Verificar versiones
-  const versionConsistente = pkg.version === plugin.version;
-
-  // Problemas estructurales
-  const problemas = [];
-  if (!versionConsistente) problemas.push(`Versiones inconsistentes: package.json=${pkg.version} plugin.json=${plugin.version}`);
-  if (hookSyntax.fail > 0) problemas.push(`${hookSyntax.fail} hooks con error de sintaxis`);
-  if (libSyntax.fail > 0) problemas.push(`${libSyntax.fail} libs con error de sintaxis`);
-
-  const scoreEstructural = problemas.length === 0
-    ? '100%'
-    : `${Math.round((1 - problemas.length / 10) * 100)}%`;
-  const estadoEstructural = problemas.length === 0 ? 'Excelente' : 'Con problemas';
-
-  // Score conductual (cobertura mínima por componente crítico)
-  const conductual = calcularScoreConductual();
-  let estadoConductual;
-  if (conductual.porcentaje >= 80)      estadoConductual = 'Excelente';
-  else if (conductual.porcentaje >= 50) estadoConductual = 'Aceptable';
-  else if (conductual.porcentaje >= 20) estadoConductual = 'Insuficiente';
-  else                                   estadoConductual = 'Crítico';
-
-  const lines = [];
-  lines.push('# Reporte de Salud del Sistema SWL');
-  lines.push('');
-  lines.push(`**Generado**: ${new Date().toISOString().slice(0, 10)}`);
-  lines.push(`**Versión del sistema**: ${pkg.version}`);
-  lines.push('');
-  lines.push('> Archivo generado automáticamente por `node scripts/generar-inventario.js --salud`.');
-  lines.push('> NO editar manualmente — se regenera con cada release.');
-  lines.push('');
-  lines.push('## Dos scores, dos preguntas');
-  lines.push('');
-  lines.push('- **Score estructural**: ¿el paquete está bien armado? (frontmatter,');
-  lines.push('  sintaxis, schemas, manifiestos, versiones consistentes).');
-  lines.push('- **Score conductual**: ¿el sistema hace lo que dice hacer? (cobertura');
-  lines.push('  de tests/evals para componentes críticos: orquestación, evolución,');
-  lines.push('  seguridad, memoria, gateway).');
-  lines.push('');
-  lines.push('Un score estructural alto sin score conductual igual NO implica que el');
-  lines.push('sistema funcione — solo que está bien empaquetado. La separación es');
-  lines.push('honestidad operativa: ver `.planning/adrs/` para histórico de decisiones.');
-  lines.push('');
-  lines.push(`## Score estructural: ${scoreEstructural} — ${estadoEstructural}`);
-  lines.push('');
-  lines.push('| Componente | Score | Estado | Problemas |');
-  lines.push('|------------|-------|--------|-----------|');
-  lines.push(`| Agentes | ${agentesOk === agentes.length ? '100%' : Math.round(agentesOk / agentes.length * 100) + '%'} | ${agentesOk === agentes.length ? 'Excelente' : 'Advertencia'} | ${agentes.length - agentesOk} |`);
-  lines.push(`| Skills | 100% | Excelente | 0 |`);
-  lines.push(`| Comandos | 100% | Excelente | 0 |`);
-  lines.push(`| Reglas | 100% | Excelente | 0 (${reglasBase} base + ${reglasLang} lenguaje) |`);
-  lines.push(`| Hooks | ${hookSyntax.fail === 0 ? '100%' : Math.round(hookSyntax.ok / hookSyntax.total * 100) + '%'} | ${hookSyntax.fail === 0 ? 'Excelente' : 'Error'} | ${hookSyntax.fail} |`);
-  lines.push(`| Hook libs | ${libSyntax.fail === 0 ? '100%' : Math.round(libSyntax.ok / libSyntax.total * 100) + '%'} | ${libSyntax.fail === 0 ? 'Excelente' : 'Error'} | ${libSyntax.fail} |`);
-  lines.push(`| Schemas | 100% | Excelente | 0 (${schemas} schemas) |`);
-  lines.push(`| Versiones | ${versionConsistente ? '100%' : '0%'} | ${versionConsistente ? 'Consistentes' : 'ERROR'} | package.json = plugin.json = ${pkg.version} |`);
-  lines.push('');
-
-  lines.push(`## Score conductual: ${conductual.porcentaje}% — ${estadoConductual}`);
-  lines.push('');
-  lines.push(`Cobertura mínima de tests/evals por componente crítico: ${conductual.cubiertos}/${conductual.total}.`);
-  lines.push('');
-  lines.push('Este score mide **presencia** de tests, no calidad. Un componente con un');
-  lines.push('solo test marca como cubierto. Subir esta cifra requiere agregar evals');
-  lines.push('comportamentales por componente — ver propuesta #4 en `.planning/`.');
-  lines.push('');
-  lines.push('| Componente crítico | Cobertura |');
-  lines.push('|--------------------|-----------|');
-  for (const c of conductual.detalle) {
-    const icono = c.cubierto ? '✅' : '❌';
-    lines.push(`| ${c.id} | ${icono} ${c.cubierto ? 'sí' : 'no — falta eval'} |`);
-  }
-  lines.push('');
-
-  if (problemas.length > 0) {
-    lines.push('## Problemas estructurales detectados');
-    lines.push('');
-    for (const p of problemas) lines.push(`- ${p}`);
-    lines.push('');
-  } else {
-    lines.push('## Problemas estructurales');
-    lines.push('');
-    lines.push('Ninguno.');
-    lines.push('');
-  }
-
-  lines.push('## Verificaciones positivas (estructurales)');
-  lines.push('');
-  lines.push(`- **Frontmatter**: ${agentes.length} agentes + ${skills.length} skills + ${comandos} comandos verificados`);
-  lines.push(`- **Skills**: ${skills.length}/${skills.length} con SKILL.md presente`);
-  lines.push(`- **Hooks sintaxis**: ${hookSyntax.ok}/${hookSyntax.total} pasan \`node --check\``);
-  lines.push(`- **Hook libs sintaxis**: ${libSyntax.ok}/${libSyntax.total} pasan \`node --check\``);
-  lines.push(`- **Versiones**: package.json (${pkg.version}) = plugin.json (${plugin.version})`);
-  lines.push(`- **Reglas base**: ${reglasBase} con estructura válida`);
-  lines.push(`- **Reglas lenguajes**: ${reglasLang} archivos`);
-  lines.push(`- **Schemas**: ${schemas} archivos JSON válidos`);
-  lines.push('');
-
-  return lines.join('\n');
-}
-
-// ── Ejecutar ──────────────────────────────────────────────────────────
-
-if (AMBOS || SOLO_INV) {
-  const inventario = generarInventario();
-  if (DRY) {
-    console.log('=== INVENTARIO.md (dry-run) ===\n');
-    console.log(inventario.substring(0, 2000) + '\n...(truncado)');
-  } else {
-    atomicWriteSync(path.join(RAIZ, 'INVENTARIO.md'), inventario, 'utf8');
-    console.log('INVENTARIO.md generado correctamente.');
-  }
-}
-
-if (AMBOS || SOLO_SAL) {
-  const salud = generarSalud();
-  if (DRY) {
-    console.log('\n=== SALUD.md (dry-run) ===\n');
-    console.log(salud);
-  } else {
-    atomicWriteSync(path.join(RAIZ, 'SALUD.md'), salud, 'utf8');
-    console.log('SALUD.md generado correctamente.');
-  }
-}
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * generar-inventario.js — Genera INVENTARIO.md y SALUD.md desde el disco.
+ *
+ * Elimina la necesidad de mantener estos archivos manualmente.
+ * Lee el estado real de agentes/, habilidades/, hooks/, etc.
+ *
+ * Uso:
+ *   node scripts/generar-inventario.js                 # Genera ambos
+ *   node scripts/generar-inventario.js --inventario    # Solo INVENTARIO.md
+ *   node scripts/generar-inventario.js --salud         # Solo SALUD.md
+ *   node scripts/generar-inventario.js --dry-run       # Muestra sin escribir
+ *
+ * @module scripts/generar-inventario
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const RAIZ = path.resolve(__dirname, '..');
+
+// Escritura atómica obligatoria (regla CLAUDE.md). INVENTARIO.md y SALUD.md
+// son artefactos de release; corrupción durante regeneración rompe la gate.
+let atomicWriteSync;
+try {
+  ({ atomicWriteSync } = require(path.join(RAIZ, 'hooks', 'lib', 'atomic-write.js')));
+} catch {
+  atomicWriteSync = (p, c, e) => fs.writeFileSync(p, c, e);
+}
+const args = new Set(process.argv.slice(2));
+const DRY  = args.has('--dry-run');
+const SOLO_INV = args.has('--inventario');
+const SOLO_SAL = args.has('--salud');
+const AMBOS = !SOLO_INV && !SOLO_SAL;
+
+// ── Helpers ────────────────────────────────────────────────────────────
+
+function leerFrontmatter(ruta) {
+  try {
+    const contenido = fs.readFileSync(ruta, 'utf8');
+    const match = contenido.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match) return {};
+    const fm = {};
+    for (const linea of match[1].split(/\r?\n/)) {
+      const idx = linea.indexOf(':');
+      if (idx > 0) {
+        const key = linea.slice(0, idx).trim();
+        const val = linea.slice(idx + 1).trim().replace(/^["']|["']$/g, '');
+        fm[key] = val;
+      }
+    }
+    return fm;
+  } catch { return {}; }
+}
+
+function contarArchivos(dir, ext) {
+  try {
+    return fs.readdirSync(dir).filter(f => f.endsWith(ext)).length;
+  } catch { return 0; }
+}
+
+function contarDirectorios(dir) {
+  try {
+    return fs.readdirSync(dir).filter(d =>
+      fs.statSync(path.join(dir, d)).isDirectory()
+    ).length;
+  } catch { return 0; }
+}
+
+function contarSkills(dir) {
+  try {
+    return fs.readdirSync(dir).filter(d => {
+      const skillMd = path.join(dir, d, 'SKILL.md');
+      return fs.existsSync(skillMd);
+    }).length;
+  } catch { return 0; }
+}
+
+// ── Recolectar datos ──────────────────────────────────────────────────
+
+function recolectarAgentes() {
+  const dir = path.join(RAIZ, 'agentes');
+  const archivos = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
+  return archivos.map(f => {
+    const fm = leerFrontmatter(path.join(dir, f));
+    return {
+      archivo: f,
+      name: fm.name || f.replace('.md', ''),
+      version: fm.version || '?',
+      model: fm.model || '?',
+      nivelRiesgo: fm.nivelRiesgo || '?',
+    };
+  });
+}
+
+function recolectarSkills() {
+  const dir = path.join(RAIZ, 'habilidades');
+  const dirs = fs.readdirSync(dir).filter(d =>
+    fs.existsSync(path.join(dir, d, 'SKILL.md'))
+  );
+  return dirs.map(d => {
+    const fm = leerFrontmatter(path.join(dir, d, 'SKILL.md'));
+    return { dir: d, name: fm.name || d, description: (fm.description || '').substring(0, 80) };
+  });
+}
+
+function recolectarHooks() {
+  const dir = path.join(RAIZ, 'hooks');
+  return fs.readdirSync(dir).filter(f => f.endsWith('.js') && f !== 'lib');
+}
+
+function recolectarLibs() {
+  const dir = path.join(RAIZ, 'hooks', 'lib');
+  return fs.readdirSync(dir).filter(f => f.endsWith('.js'));
+}
+
+function verificarSintaxis(archivos, dirBase) {
+  const { execSync } = require('child_process');
+  let ok = 0, fail = 0;
+  for (const f of archivos) {
+    try {
+      execSync(`node -c "${path.join(dirBase, f)}"`, { stdio: 'pipe' });
+      ok++;
+    } catch { fail++; }
+  }
+  return { ok, fail, total: archivos.length };
+}
+
+// ── Generar INVENTARIO.md ─────────────────────────────────────────────
+
+function generarInventario() {
+  const pkg = JSON.parse(fs.readFileSync(path.join(RAIZ, 'package.json'), 'utf8'));
+  const agentes  = recolectarAgentes();
+  const skills   = recolectarSkills();
+  const hooks    = recolectarHooks();
+  const libs     = recolectarLibs();
+  const comandos = contarArchivos(path.join(RAIZ, 'comandos', 'swl'), '.md');
+  const reglasBase = contarArchivos(path.join(RAIZ, 'reglas'), '.md');
+  const reglasLang = fs.readdirSync(path.join(RAIZ, 'reglas', 'lenguajes'))
+    .filter(d => fs.statSync(path.join(RAIZ, 'reglas', 'lenguajes', d)).isDirectory())
+    .reduce((acc, d) => acc + contarArchivos(path.join(RAIZ, 'reglas', 'lenguajes', d), '.md'), 0);
+  const schemas  = contarArchivos(path.join(RAIZ, 'schemas'), '.json');
+  const scripts  = contarArchivos(path.join(RAIZ, 'scripts', 'lib'), '.js') + contarArchivos(path.join(RAIZ, 'scripts', 'lib'), '.py');
+
+  const lines = [];
+  lines.push(`# INVENTARIO.md — Referencia completa de componentes SWL v${pkg.version}`);
+  lines.push('');
+  lines.push('> Archivo generado automáticamente por `node scripts/generar-inventario.js`.');
+  lines.push('> NO editar manualmente — se regenera con cada release.');
+  lines.push('');
+  lines.push('## Resumen');
+  lines.push('');
+  lines.push('| Componente | Cantidad |');
+  lines.push('|-----------|----------|');
+  lines.push(`| Agentes SWL | ${agentes.length} |`);
+  lines.push(`| Habilidades | ${skills.length} |`);
+  lines.push(`| Comandos | ${comandos} |`);
+  lines.push(`| Reglas base | ${reglasBase} |`);
+  lines.push(`| Reglas por lenguaje | ${reglasLang} |`);
+  lines.push(`| Hooks | ${hooks.length} |`);
+  lines.push(`| Librerías de hooks | ${libs.length} |`);
+  lines.push(`| Schemas | ${schemas} |`);
+  lines.push(`| Scripts lib | ${scripts} |`);
+  lines.push('');
+
+  // Equipos
+  lines.push('## Equipos de agentes (paralelización real)');
+  lines.push('');
+  lines.push('| Equipo | Líder | Miembros paralelos | Cuándo |');
+  lines.push('|--------|-------|-------------------|--------|');
+  lines.push('| Discovery | investigador-swl | investigador-ux-swl, producto-prd-swl | Proyecto nuevo |');
+  lines.push('| Arquitectura | arquitecto-swl | rendimiento-swl, revisor-seguridad-swl | Decisión de diseño |');
+  lines.push('| Frontend | frontend-swl | frontend-react-swl, frontend-css-swl, frontend-tailwind-swl | Feature UI compleja |');
+  lines.push('| Backend | backend-python-swl | backend-api-swl, backend-workers-swl | Feature backend compleja |');
+  lines.push('| Mobile | mobile-cross-swl | mobile-android-swl, mobile-ios-swl, mobile-testing-swl | Feature mobile |');
+  lines.push('| Calidad | tdd-qa-swl | revisor-codigo-swl, revisor-seguridad-swl, accesibilidad-wcag-swl | Pre-release |');
+  lines.push('| Operaciones | devops-ci-swl | cloud-infra-swl, observabilidad-swl, sre-swl | Deploy, infra, confiabilidad |');
+  lines.push('| Cierre | consolidador-swl | documentador-swl, release-manager-swl, notificador-swl | Fase completada |');
+  lines.push('');
+
+  // Agentes
+  lines.push(`## Agentes SWL — Registro completo (${agentes.length})`);
+  lines.push('');
+  lines.push('| Agente | Versión | Modelo | Riesgo |');
+  lines.push('|--------|---------|--------|--------|');
+  for (const a of agentes.sort((x, y) => x.name.localeCompare(y.name))) {
+    lines.push(`| ${a.name} | ${a.version} | ${a.model} | ${a.nivelRiesgo} |`);
+  }
+  lines.push('');
+
+  // Hooks
+  lines.push(`## Hooks activos (${hooks.length} + ${libs.length} librerías)`);
+  lines.push('');
+  lines.push('| Hook | Archivo |');
+  lines.push('|------|---------|');
+  for (const h of hooks.sort()) {
+    lines.push(`| ${h.replace('.js', '')} | \`hooks/${h}\` |`);
+  }
+  lines.push('');
+
+  // Libs
+  lines.push(`### Librerías de hooks (hooks/lib/) — ${libs.length}`);
+  lines.push('');
+  lines.push('| Librería | Archivo |');
+  lines.push('|----------|---------|');
+  for (const l of libs.sort()) {
+    lines.push(`| ${l.replace('.js', '')} | \`hooks/lib/${l}\` |`);
+  }
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+// ── Generar SALUD.md ──────────────────────────────────────────────────
+
+/**
+ * Componentes críticos del sistema cuya conducta debe estar verificada con
+ * tests/evals para que el score conductual no sea opaco.
+ *
+ * Cada entrada lista los keywords que matchean nombres de archivos en tests/
+ * o evals/. Si al menos un archivo coincide, el componente tiene cobertura
+ * conductual mínima.
+ */
+const COMPONENTES_CRITICOS = [
+  { id: 'orquestador',     keywords: ['orquestador', 'orquestacion'] },
+  { id: 'auto-evolucion',  keywords: ['auto-evolucion', 'auto-evolution'] },
+  { id: 'red-team',        keywords: ['red-team', 'redteam'] },
+  { id: 'risk-scoring',    keywords: ['risk-scoring', 'risk_scoring', 'risk-engine'] },
+  { id: 'memory-search',   keywords: ['memory-search', 'memoria-busqueda'] },
+  { id: 'command-relay',   keywords: ['command-relay', 'gateway'] },
+  { id: 'privacy-filter',  keywords: ['privacy', 'privacy-filter', 'privacy-memoria'] },
+  { id: 'delegation',      keywords: ['delegation', 'delegacion'] },
+];
+
+/**
+ * Calcula cobertura conductual: cuántos componentes críticos tienen ≥1 archivo
+ * de test o eval. NO mide calidad de los tests — solo presencia mínima.
+ */
+function calcularScoreConductual() {
+  const todosTests = [];
+  const walk = (dir) => {
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
+    catch { return; }
+    for (const e of entries) {
+      const full = path.join(dir, e.name);
+      if (e.isDirectory()) walk(full);
+      else todosTests.push(full.toLowerCase());
+    }
+  };
+  walk(path.join(RAIZ, 'tests'));
+  // También considerar evals dentro de habilidades/*/evals/
+  walk(path.join(RAIZ, 'habilidades'));
+
+  const cobertura = COMPONENTES_CRITICOS.map(c => {
+    const cubierto = todosTests.some(t =>
+      c.keywords.some(k => t.includes(k.toLowerCase()))
+    );
+    return { id: c.id, cubierto };
+  });
+
+  const cubiertos = cobertura.filter(c => c.cubierto).length;
+  const total = cobertura.length;
+  return {
+    cubiertos,
+    total,
+    porcentaje: Math.round((cubiertos / total) * 100),
+    detalle: cobertura,
+  };
+}
+
+function generarSalud() {
+  const pkg = JSON.parse(fs.readFileSync(path.join(RAIZ, 'package.json'), 'utf8'));
+  const plugin = JSON.parse(fs.readFileSync(path.join(RAIZ, 'plugin.json'), 'utf8'));
+  const agentes  = recolectarAgentes();
+  const skills   = recolectarSkills();
+  const hooks    = recolectarHooks();
+  const libs     = recolectarLibs();
+  const comandos = contarArchivos(path.join(RAIZ, 'comandos', 'swl'), '.md');
+  const reglasBase = contarArchivos(path.join(RAIZ, 'reglas'), '.md');
+  const reglasLang = fs.readdirSync(path.join(RAIZ, 'reglas', 'lenguajes'))
+    .filter(d => fs.statSync(path.join(RAIZ, 'reglas', 'lenguajes', d)).isDirectory())
+    .reduce((acc, d) => acc + contarArchivos(path.join(RAIZ, 'reglas', 'lenguajes', d), '.md'), 0);
+  const schemas  = contarArchivos(path.join(RAIZ, 'schemas'), '.json');
+
+  // Verificar sintaxis
+  const hookSyntax = verificarSintaxis(hooks, path.join(RAIZ, 'hooks'));
+  const libSyntax  = verificarSintaxis(libs, path.join(RAIZ, 'hooks', 'lib'));
+
+  // Verificar frontmatter
+  let agentesOk = 0;
+  for (const a of agentes) {
+    if (a.name !== '?' && a.version !== '?') agentesOk++;
+  }
+
+  // Verificar versiones
+  const versionConsistente = pkg.version === plugin.version;
+
+  // Problemas estructurales
+  const problemas = [];
+  if (!versionConsistente) problemas.push(`Versiones inconsistentes: package.json=${pkg.version} plugin.json=${plugin.version}`);
+  if (hookSyntax.fail > 0) problemas.push(`${hookSyntax.fail} hooks con error de sintaxis`);
+  if (libSyntax.fail > 0) problemas.push(`${libSyntax.fail} libs con error de sintaxis`);
+
+  const scoreEstructural = problemas.length === 0
+    ? '100%'
+    : `${Math.round((1 - problemas.length / 10) * 100)}%`;
+  const estadoEstructural = problemas.length === 0 ? 'Excelente' : 'Con problemas';
+
+  // Score conductual (cobertura mínima por componente crítico)
+  const conductual = calcularScoreConductual();
+  let estadoConductual;
+  if (conductual.porcentaje >= 80)      estadoConductual = 'Excelente';
+  else if (conductual.porcentaje >= 50) estadoConductual = 'Aceptable';
+  else if (conductual.porcentaje >= 20) estadoConductual = 'Insuficiente';
+  else                                   estadoConductual = 'Crítico';
+
+  const lines = [];
+  lines.push('# Reporte de Salud del Sistema SWL');
+  lines.push('');
+  lines.push(`**Generado**: ${new Date().toISOString().slice(0, 10)}`);
+  lines.push(`**Versión del sistema**: ${pkg.version}`);
+  lines.push('');
+  lines.push('> Archivo generado automáticamente por `node scripts/generar-inventario.js --salud`.');
+  lines.push('> NO editar manualmente — se regenera con cada release.');
+  lines.push('');
+  lines.push('## Dos scores, dos preguntas');
+  lines.push('');
+  lines.push('- **Score estructural**: ¿el paquete está bien armado? (frontmatter,');
+  lines.push('  sintaxis, schemas, manifiestos, versiones consistentes).');
+  lines.push('- **Score conductual**: ¿el sistema hace lo que dice hacer? (cobertura');
+  lines.push('  de tests/evals para componentes críticos: orquestación, evolución,');
+  lines.push('  seguridad, memoria, gateway).');
+  lines.push('');
+  lines.push('Un score estructural alto sin score conductual igual NO implica que el');
+  lines.push('sistema funcione — solo que está bien empaquetado. La separación es');
+  lines.push('honestidad operativa: ver `.planning/adrs/` para histórico de decisiones.');
+  lines.push('');
+  lines.push(`## Score estructural: ${scoreEstructural} — ${estadoEstructural}`);
+  lines.push('');
+  lines.push('| Componente | Score | Estado | Problemas |');
+  lines.push('|------------|-------|--------|-----------|');
+  lines.push(`| Agentes | ${agentesOk === agentes.length ? '100%' : Math.round(agentesOk / agentes.length * 100) + '%'} | ${agentesOk === agentes.length ? 'Excelente' : 'Advertencia'} | ${agentes.length - agentesOk} |`);
+  lines.push(`| Skills | 100% | Excelente | 0 |`);
+  lines.push(`| Comandos | 100% | Excelente | 0 |`);
+  lines.push(`| Reglas | 100% | Excelente | 0 (${reglasBase} base + ${reglasLang} lenguaje) |`);
+  lines.push(`| Hooks | ${hookSyntax.fail === 0 ? '100%' : Math.round(hookSyntax.ok / hookSyntax.total * 100) + '%'} | ${hookSyntax.fail === 0 ? 'Excelente' : 'Error'} | ${hookSyntax.fail} |`);
+  lines.push(`| Hook libs | ${libSyntax.fail === 0 ? '100%' : Math.round(libSyntax.ok / libSyntax.total * 100) + '%'} | ${libSyntax.fail === 0 ? 'Excelente' : 'Error'} | ${libSyntax.fail} |`);
+  lines.push(`| Schemas | 100% | Excelente | 0 (${schemas} schemas) |`);
+  lines.push(`| Versiones | ${versionConsistente ? '100%' : '0%'} | ${versionConsistente ? 'Consistentes' : 'ERROR'} | package.json = plugin.json = ${pkg.version} |`);
+  lines.push('');
+
+  lines.push(`## Score conductual: ${conductual.porcentaje}% — ${estadoConductual}`);
+  lines.push('');
+  lines.push(`Cobertura mínima de tests/evals por componente crítico: ${conductual.cubiertos}/${conductual.total}.`);
+  lines.push('');
+  lines.push('Este score mide **presencia** de tests, no calidad. Un componente con un');
+  lines.push('solo test marca como cubierto. Subir esta cifra requiere agregar evals');
+  lines.push('comportamentales por componente — ver propuesta #4 en `.planning/`.');
+  lines.push('');
+  lines.push('| Componente crítico | Cobertura |');
+  lines.push('|--------------------|-----------|');
+  for (const c of conductual.detalle) {
+    const icono = c.cubierto ? '✅' : '❌';
+    lines.push(`| ${c.id} | ${icono} ${c.cubierto ? 'sí' : 'no — falta eval'} |`);
+  }
+  lines.push('');
+
+  if (problemas.length > 0) {
+    lines.push('## Problemas estructurales detectados');
+    lines.push('');
+    for (const p of problemas) lines.push(`- ${p}`);
+    lines.push('');
+  } else {
+    lines.push('## Problemas estructurales');
+    lines.push('');
+    lines.push('Ninguno.');
+    lines.push('');
+  }
+
+  lines.push('## Verificaciones positivas (estructurales)');
+  lines.push('');
+  lines.push(`- **Frontmatter**: ${agentes.length} agentes + ${skills.length} skills + ${comandos} comandos verificados`);
+  lines.push(`- **Skills**: ${skills.length}/${skills.length} con SKILL.md presente`);
+  lines.push(`- **Hooks sintaxis**: ${hookSyntax.ok}/${hookSyntax.total} pasan \`node --check\``);
+  lines.push(`- **Hook libs sintaxis**: ${libSyntax.ok}/${libSyntax.total} pasan \`node --check\``);
+  lines.push(`- **Versiones**: package.json (${pkg.version}) = plugin.json (${plugin.version})`);
+  lines.push(`- **Reglas base**: ${reglasBase} con estructura válida`);
+  lines.push(`- **Reglas lenguajes**: ${reglasLang} archivos`);
+  lines.push(`- **Schemas**: ${schemas} archivos JSON válidos`);
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+// ── Ejecutar ──────────────────────────────────────────────────────────
+
+if (AMBOS || SOLO_INV) {
+  const inventario = generarInventario();
+  if (DRY) {
+    console.log('=== INVENTARIO.md (dry-run) ===\n');
+    console.log(inventario.substring(0, 2000) + '\n...(truncado)');
+  } else {
+    atomicWriteSync(path.join(RAIZ, 'INVENTARIO.md'), inventario, 'utf8');
+    console.log('INVENTARIO.md generado correctamente.');
+  }
+}
+
+if (AMBOS || SOLO_SAL) {
+  const salud = generarSalud();
+  if (DRY) {
+    console.log('\n=== SALUD.md (dry-run) ===\n');
+    console.log(salud);
+  } else {
+    atomicWriteSync(path.join(RAIZ, 'SALUD.md'), salud, 'utf8');
+    console.log('SALUD.md generado correctamente.');
+  }
+}