@saulwade/swl-ses 1.3.7 → 1.4.0

package/scripts/run-eval.js

@@ -1,141 +1,141 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * run-eval.js — CLI para ejecutar evaluaciones del eval framework.
- *
- * Uso:
- *   node scripts/run-eval.js <ruta-eval.json>
- *
- * Formato del archivo JSON de eval:
- * {
- *   "functionId": "memoria-busqueda::search",
- *   "schemaName": "MEMORY_SEARCH_RESULT_SCHEMA",   // opcional, valida output
- *   "qualityScorer": "scoreObservacion",           // opcional, calcula calidad
- *   "input":  { ... },                              // datos de entrada
- *   "expectedKeys": ["id", "tipo", "titulo"],       // opcional, valida presencia
- *   "output": { ... }                               // output a evaluar
- * }
- *
- * Exit codes:
- *   0 - eval pasa (valid: true)
- *   1 - eval falla (valid: false) o error de I/O
- *   2 - error de uso (argumentos inválidos)
- */
-
-const fs   = require('fs');
-const path = require('path');
-
-const schemas         = require('./lib/eval-schemas');
-const validator       = require('./lib/eval-validator');
-const quality         = require('./lib/eval-quality');
-const metricsStore    = require('./lib/eval-metrics-store');
-
-function uso() {
-  console.error('Uso: node scripts/run-eval.js <ruta-eval.json>');
-  console.error('     node scripts/run-eval.js --rebuild-aggregate');
-  process.exit(2);
-}
-
-function ejecutarEval(ruta) {
-  if (!fs.existsSync(ruta)) {
-    console.error(`Archivo no existe: ${ruta}`);
-    return 1;
-  }
-
-  let definicion;
-  try {
-    definicion = JSON.parse(fs.readFileSync(ruta, 'utf8'));
-  } catch (err) {
-    console.error(`Error parseando ${ruta}: ${err.message}`);
-    return 1;
-  }
-
-  const { functionId, schemaName, qualityScorer, output } = definicion;
-  if (!functionId || typeof functionId !== 'string') {
-    console.error('functionId requerido en el archivo de eval');
-    return 1;
-  }
-
-  const inicio = Date.now();
-  let valid = true;
-  let errors = [];
-  let qualityScore = null;
-
-  // Validar contra schema si se especifica
-  if (schemaName) {
-    const schema = schemas[schemaName];
-    if (!schema) {
-      console.error(`Schema desconocido: ${schemaName}. Disponibles: ${Object.keys(schemas).filter(k => k.endsWith('_SCHEMA')).join(', ')}`);
-      return 1;
-    }
-    const r = validator.validar(output, schema);
-    valid = valid && r.valid;
-    if (!r.valid) errors.push(...r.errors);
-  }
-
-  // Validar campos esperados si se especifican
-  if (Array.isArray(definicion.expectedKeys)) {
-    for (const key of definicion.expectedKeys) {
-      if (!output || !(key in output)) {
-        valid = false;
-        errors.push(`expectedKey faltante: ${key}`);
-      }
-    }
-  }
-
-  // Calcular quality score si se especifica
-  if (qualityScorer) {
-    const scorer = quality[qualityScorer];
-    if (typeof scorer !== 'function') {
-      console.error(`Quality scorer desconocido: ${qualityScorer}. Disponibles: ${Object.keys(quality).join(', ')}`);
-      return 1;
-    }
-    qualityScore = scorer(output);
-  }
-
-  const latencyMs = Date.now() - inicio;
-  const exito = valid;
-
-  // Persistir resultado
-  const baseDir = process.cwd();
-  metricsStore.registrar(baseDir, {
-    functionId,
-    latencyMs,
-    success: exito,
-    qualityScore,
-    metadata: { schemaName, qualityScorer, evalFile: path.basename(ruta) },
-  });
-
-  // Reportar
-  console.log(JSON.stringify({
-    functionId,
-    valid,
-    errors: errors.length > 0 ? errors : undefined,
-    qualityScore,
-    latencyMs,
-  }, null, 2));
-
-  return valid ? 0 : 1;
-}
-
-function main() {
-  const args = process.argv.slice(2);
-  if (args.length === 0) uso();
-
-  if (args[0] === '--rebuild-aggregate') {
-    const r = metricsStore.reconstruirAgregado(process.cwd());
-    console.log(`Agregado reconstruido: ${r.rebuilt} eventos, ${r.functions} funciones únicas.`);
-    process.exit(0);
-  }
-
-  process.exit(ejecutarEval(args[0]));
-}
-
-if (require.main === module) {
-  main();
-}
-
-module.exports = {
-  ejecutarEval,
-};
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * run-eval.js — CLI para ejecutar evaluaciones del eval framework.
+ *
+ * Uso:
+ *   node scripts/run-eval.js <ruta-eval.json>
+ *
+ * Formato del archivo JSON de eval:
+ * {
+ *   "functionId": "memoria-busqueda::search",
+ *   "schemaName": "MEMORY_SEARCH_RESULT_SCHEMA",   // opcional, valida output
+ *   "qualityScorer": "scoreObservacion",           // opcional, calcula calidad
+ *   "input":  { ... },                              // datos de entrada
+ *   "expectedKeys": ["id", "tipo", "titulo"],       // opcional, valida presencia
+ *   "output": { ... }                               // output a evaluar
+ * }
+ *
+ * Exit codes:
+ *   0 - eval pasa (valid: true)
+ *   1 - eval falla (valid: false) o error de I/O
+ *   2 - error de uso (argumentos inválidos)
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const schemas         = require('./lib/eval-schemas');
+const validator       = require('./lib/eval-validator');
+const quality         = require('./lib/eval-quality');
+const metricsStore    = require('./lib/eval-metrics-store');
+
+function uso() {
+  console.error('Uso: node scripts/run-eval.js <ruta-eval.json>');
+  console.error('     node scripts/run-eval.js --rebuild-aggregate');
+  process.exit(2);
+}
+
+function ejecutarEval(ruta) {
+  if (!fs.existsSync(ruta)) {
+    console.error(`Archivo no existe: ${ruta}`);
+    return 1;
+  }
+
+  let definicion;
+  try {
+    definicion = JSON.parse(fs.readFileSync(ruta, 'utf8'));
+  } catch (err) {
+    console.error(`Error parseando ${ruta}: ${err.message}`);
+    return 1;
+  }
+
+  const { functionId, schemaName, qualityScorer, output } = definicion;
+  if (!functionId || typeof functionId !== 'string') {
+    console.error('functionId requerido en el archivo de eval');
+    return 1;
+  }
+
+  const inicio = Date.now();
+  let valid = true;
+  let errors = [];
+  let qualityScore = null;
+
+  // Validar contra schema si se especifica
+  if (schemaName) {
+    const schema = schemas[schemaName];
+    if (!schema) {
+      console.error(`Schema desconocido: ${schemaName}. Disponibles: ${Object.keys(schemas).filter(k => k.endsWith('_SCHEMA')).join(', ')}`);
+      return 1;
+    }
+    const r = validator.validar(output, schema);
+    valid = valid && r.valid;
+    if (!r.valid) errors.push(...r.errors);
+  }
+
+  // Validar campos esperados si se especifican
+  if (Array.isArray(definicion.expectedKeys)) {
+    for (const key of definicion.expectedKeys) {
+      if (!output || !(key in output)) {
+        valid = false;
+        errors.push(`expectedKey faltante: ${key}`);
+      }
+    }
+  }
+
+  // Calcular quality score si se especifica
+  if (qualityScorer) {
+    const scorer = quality[qualityScorer];
+    if (typeof scorer !== 'function') {
+      console.error(`Quality scorer desconocido: ${qualityScorer}. Disponibles: ${Object.keys(quality).join(', ')}`);
+      return 1;
+    }
+    qualityScore = scorer(output);
+  }
+
+  const latencyMs = Date.now() - inicio;
+  const exito = valid;
+
+  // Persistir resultado
+  const baseDir = process.cwd();
+  metricsStore.registrar(baseDir, {
+    functionId,
+    latencyMs,
+    success: exito,
+    qualityScore,
+    metadata: { schemaName, qualityScorer, evalFile: path.basename(ruta) },
+  });
+
+  // Reportar
+  console.log(JSON.stringify({
+    functionId,
+    valid,
+    errors: errors.length > 0 ? errors : undefined,
+    qualityScore,
+    latencyMs,
+  }, null, 2));
+
+  return valid ? 0 : 1;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0) uso();
+
+  if (args[0] === '--rebuild-aggregate') {
+    const r = metricsStore.reconstruirAgregado(process.cwd());
+    console.log(`Agregado reconstruido: ${r.rebuilt} eventos, ${r.functions} funciones únicas.`);
+    process.exit(0);
+  }
+
+  process.exit(ejecutarEval(args[0]));
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  ejecutarEval,
+};

package/scripts/validar-manifest.js

@@ -1,195 +1,195 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * Gate de sincronización manifiestos ↔ disco.
- *
- * Verifica que cada archivo de componente presente en disco esté declarado
- * en manifiestos/modulos.json (fuente de verdad del instalador). Atrapa el
- * bug recurrente "archivo existe en el repo pero el instalador no lo copia
- * al destino" que causó v5.7.3 (check-update.js) y v5.7.4 (adoptar-proyecto.md,
- * contribuir.md).
- *
- * Convenciones del manifest (validadas vs disco):
- *   agentes/X.md                → declarado como 'agentes/X.md'
- *   comandos/swl/X.md           → declarado como 'comandos/swl/X.md'
- *   habilidades/X/SKILL.md      → declarado como 'habilidades/X' (solo el dir)
- *   hooks/X.js (ejecutable)     → declarado como 'hooks/X.js' + hooks-config.json
- *   reglas/**.md                → declarado como 'reglas/<path>.md'
- *   schemas/X.json              → declarado como 'schemas/X.json'
- *
- * Exclusiones intencionales:
- *   hooks/lib/   — helpers internos; se declaran solo las libs que un hook
- *                  copiado necesita en su módulo. No van 1:1 con disco.
- *   scripts/     — herramientas de desarrollo, no componentes distribuibles.
- *   schemas/     — definiciones JSON Schema para validación interna del repo;
- *                  no se copian al destino (los runtimes no las leen).
- *
- * Exit codes: 0 OK, 1 faltan declaraciones.
- *
- * Uso: node scripts/validar-manifest.js [--json]
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const RAIZ = path.resolve(__dirname, '..');
-const MODULOS_PATH = path.join(RAIZ, 'manifiestos', 'modulos.json');
-const HOOKS_CONFIG_PATH = path.join(RAIZ, 'manifiestos', 'hooks-config.json');
-
-const salidaJson = process.argv.includes('--json');
-const errores = [];
-
-function log(msg) { if (!salidaJson) console.log(msg); }
-
-function recolectarDeclarados(modulos) {
-  const declarados = new Set();
-  for (const mod of Object.values(modulos.modulos || {})) {
-    for (const archivo of mod.archivos || []) {
-      declarados.add(archivo);
-    }
-  }
-  return declarados;
-}
-
-function listarArchivos(dirRel, extension, recursivo = false) {
-  const base = path.join(RAIZ, dirRel);
-  if (!fs.existsSync(base)) return [];
-  const resultado = [];
-  function caminar(actual) {
-    for (const entrada of fs.readdirSync(actual, { withFileTypes: true })) {
-      const abs = path.join(actual, entrada.name);
-      if (entrada.isDirectory() && recursivo) {
-        caminar(abs);
-      } else if (entrada.isFile() && entrada.name.endsWith(extension)) {
-        resultado.push(path.relative(RAIZ, abs).replace(/\\/g, '/'));
-      }
-    }
-  }
-  caminar(base);
-  return resultado;
-}
-
-function listarDirectoriosHabilidades() {
-  const base = path.join(RAIZ, 'habilidades');
-  if (!fs.existsSync(base)) return [];
-  const dirs = [];
-  for (const entrada of fs.readdirSync(base, { withFileTypes: true })) {
-    if (!entrada.isDirectory()) continue;
-    // Solo directorios que tienen SKILL.md son habilidades válidas
-    if (fs.existsSync(path.join(base, entrada.name, 'SKILL.md'))) {
-      dirs.push(`habilidades/${entrada.name}`);
-    }
-  }
-  return dirs;
-}
-
-function verificarCategoria(etiqueta, archivosDisco, declarados) {
-  const faltantes = archivosDisco.filter(a => !declarados.has(a));
-  if (faltantes.length === 0) {
-    log(`  [OK]    ${etiqueta}: ${archivosDisco.length}/${archivosDisco.length} declarados`);
-    return true;
-  }
-  log(`  [FALLA] ${etiqueta}: ${faltantes.length} sin declarar en modulos.json`);
-  for (const f of faltantes) {
-    log(`          → ${f}`);
-    errores.push({ categoria: etiqueta, archivo: f, tipo: 'no_declarado_modulos' });
-  }
-  return false;
-}
-
-function verificarHooksEjecutablesEnConfig(archivosHooks, hooksConfig) {
-  // hooks-config.json tiene la estructura { hooks: { "nombre.js": { event, matcher, ... } } }
-  const hooks = hooksConfig.hooks || hooksConfig;
-  const declaradosConfig = new Set(Object.keys(hooks));
-  const faltantes = archivosHooks.filter(a => {
-    const nombre = path.basename(a);
-    return !declaradosConfig.has(nombre);
-  });
-  if (faltantes.length === 0) {
-    log(`  [OK]    hooks-config.json: ${archivosHooks.length}/${archivosHooks.length} hooks ejecutables registrados`);
-    return true;
-  }
-  log(`  [FALLA] hooks-config.json: ${faltantes.length} hook(s) sin declarar`);
-  for (const f of faltantes) {
-    log(`          → ${f}`);
-    errores.push({ categoria: 'hooks-config.json', archivo: f, tipo: 'no_declarado_hooks_config' });
-  }
-  return false;
-}
-
-function verificarDeclarados1a1ExistenEnDisco(declarados) {
-  // Caso inverso: declarados en manifest pero no presentes en disco
-  const rotos = [];
-  for (const decl of declarados) {
-    // Habilidades son directorios
-    if (decl.startsWith('habilidades/') && !decl.includes('/SKILL.md')) {
-      const absDir = path.join(RAIZ, decl);
-      const skillMd = path.join(absDir, 'SKILL.md');
-      if (!fs.existsSync(skillMd)) rotos.push(decl);
-      continue;
-    }
-    const abs = path.join(RAIZ, decl);
-    if (!fs.existsSync(abs)) rotos.push(decl);
-  }
-  if (rotos.length === 0) {
-    log(`  [OK]    Referencias en modulos.json: ${declarados.size}/${declarados.size} existen en disco`);
-    return true;
-  }
-  log(`  [FALLA] modulos.json: ${rotos.length} ruta(s) rotas (declaradas pero no existen)`);
-  for (const r of rotos) {
-    log(`          → ${r}`);
-    errores.push({ categoria: 'modulos.json', archivo: r, tipo: 'declarado_no_existe' });
-  }
-  return false;
-}
-
-function main() {
-  log('Validación de sincronización manifiestos ↔ disco\n');
-
-  const modulos = JSON.parse(fs.readFileSync(MODULOS_PATH, 'utf-8'));
-  const hooksConfig = JSON.parse(fs.readFileSync(HOOKS_CONFIG_PATH, 'utf-8'));
-  const declarados = recolectarDeclarados(modulos);
-
-  const hooksEjecutables = listarArchivos('hooks', '.js').filter(a => !a.startsWith('hooks/lib/'));
-
-  const categorias = [
-    { etiqueta: 'comandos/swl/',       archivos: listarArchivos('comandos/swl', '.md') },
-    { etiqueta: 'hooks/ (ejecutables)', archivos: hooksEjecutables },
-    { etiqueta: 'agentes/',             archivos: listarArchivos('agentes', '.md') },
-    { etiqueta: 'habilidades/ (dirs)',  archivos: listarDirectoriosHabilidades() },
-    { etiqueta: 'reglas/',              archivos: listarArchivos('reglas', '.md', true) },
-  ];
-
-  let todoOk = true;
-  for (const cat of categorias) {
-    const ok = verificarCategoria(cat.etiqueta, cat.archivos, declarados);
-    if (!ok) todoOk = false;
-  }
-
-  const hooksOk = verificarHooksEjecutablesEnConfig(hooksEjecutables, hooksConfig);
-  if (!hooksOk) todoOk = false;
-
-  const inversoOk = verificarDeclarados1a1ExistenEnDisco(declarados);
-  if (!inversoOk) todoOk = false;
-
-  log('');
-  if (todoOk) {
-    log('✓ Todos los manifiestos están sincronizados con el disco.');
-  } else {
-    log(`✗ ${errores.length} problema(s) de sincronización.`);
-    log('');
-    log('  Cómo corregir:');
-    log('  - "no_declarado_modulos": agregar la ruta al módulo apropiado en manifiestos/modulos.json');
-    log('  - "no_declarado_hooks_config": registrar el hook en manifiestos/hooks-config.json');
-    log('  - "declarado_no_existe": eliminar la ruta de modulos.json (archivo borrado) o crear el archivo');
-  }
-
-  if (salidaJson) {
-    console.log(JSON.stringify({ ok: todoOk, totalErrores: errores.length, errores }, null, 2));
-  }
-
-  process.exit(todoOk ? 0 : 1);
-}
-
-main();
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Gate de sincronización manifiestos ↔ disco.
+ *
+ * Verifica que cada archivo de componente presente en disco esté declarado
+ * en manifiestos/modulos.json (fuente de verdad del instalador). Atrapa el
+ * bug recurrente "archivo existe en el repo pero el instalador no lo copia
+ * al destino" que causó v5.7.3 (check-update.js) y v5.7.4 (adoptar-proyecto.md,
+ * contribuir.md).
+ *
+ * Convenciones del manifest (validadas vs disco):
+ *   agentes/X.md                → declarado como 'agentes/X.md'
+ *   comandos/swl/X.md           → declarado como 'comandos/swl/X.md'
+ *   habilidades/X/SKILL.md      → declarado como 'habilidades/X' (solo el dir)
+ *   hooks/X.js (ejecutable)     → declarado como 'hooks/X.js' + hooks-config.json
+ *   reglas/**.md                → declarado como 'reglas/<path>.md'
+ *   schemas/X.json              → declarado como 'schemas/X.json'
+ *
+ * Exclusiones intencionales:
+ *   hooks/lib/   — helpers internos; se declaran solo las libs que un hook
+ *                  copiado necesita en su módulo. No van 1:1 con disco.
+ *   scripts/     — herramientas de desarrollo, no componentes distribuibles.
+ *   schemas/     — definiciones JSON Schema para validación interna del repo;
+ *                  no se copian al destino (los runtimes no las leen).
+ *
+ * Exit codes: 0 OK, 1 faltan declaraciones.
+ *
+ * Uso: node scripts/validar-manifest.js [--json]
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const RAIZ = path.resolve(__dirname, '..');
+const MODULOS_PATH = path.join(RAIZ, 'manifiestos', 'modulos.json');
+const HOOKS_CONFIG_PATH = path.join(RAIZ, 'manifiestos', 'hooks-config.json');
+
+const salidaJson = process.argv.includes('--json');
+const errores = [];
+
+function log(msg) { if (!salidaJson) console.log(msg); }
+
+function recolectarDeclarados(modulos) {
+  const declarados = new Set();
+  for (const mod of Object.values(modulos.modulos || {})) {
+    for (const archivo of mod.archivos || []) {
+      declarados.add(archivo);
+    }
+  }
+  return declarados;
+}
+
+function listarArchivos(dirRel, extension, recursivo = false) {
+  const base = path.join(RAIZ, dirRel);
+  if (!fs.existsSync(base)) return [];
+  const resultado = [];
+  function caminar(actual) {
+    for (const entrada of fs.readdirSync(actual, { withFileTypes: true })) {
+      const abs = path.join(actual, entrada.name);
+      if (entrada.isDirectory() && recursivo) {
+        caminar(abs);
+      } else if (entrada.isFile() && entrada.name.endsWith(extension)) {
+        resultado.push(path.relative(RAIZ, abs).replace(/\\/g, '/'));
+      }
+    }
+  }
+  caminar(base);
+  return resultado;
+}
+
+function listarDirectoriosHabilidades() {
+  const base = path.join(RAIZ, 'habilidades');
+  if (!fs.existsSync(base)) return [];
+  const dirs = [];
+  for (const entrada of fs.readdirSync(base, { withFileTypes: true })) {
+    if (!entrada.isDirectory()) continue;
+    // Solo directorios que tienen SKILL.md son habilidades válidas
+    if (fs.existsSync(path.join(base, entrada.name, 'SKILL.md'))) {
+      dirs.push(`habilidades/${entrada.name}`);
+    }
+  }
+  return dirs;
+}
+
+function verificarCategoria(etiqueta, archivosDisco, declarados) {
+  const faltantes = archivosDisco.filter(a => !declarados.has(a));
+  if (faltantes.length === 0) {
+    log(`  [OK]    ${etiqueta}: ${archivosDisco.length}/${archivosDisco.length} declarados`);
+    return true;
+  }
+  log(`  [FALLA] ${etiqueta}: ${faltantes.length} sin declarar en modulos.json`);
+  for (const f of faltantes) {
+    log(`          → ${f}`);
+    errores.push({ categoria: etiqueta, archivo: f, tipo: 'no_declarado_modulos' });
+  }
+  return false;
+}
+
+function verificarHooksEjecutablesEnConfig(archivosHooks, hooksConfig) {
+  // hooks-config.json tiene la estructura { hooks: { "nombre.js": { event, matcher, ... } } }
+  const hooks = hooksConfig.hooks || hooksConfig;
+  const declaradosConfig = new Set(Object.keys(hooks));
+  const faltantes = archivosHooks.filter(a => {
+    const nombre = path.basename(a);
+    return !declaradosConfig.has(nombre);
+  });
+  if (faltantes.length === 0) {
+    log(`  [OK]    hooks-config.json: ${archivosHooks.length}/${archivosHooks.length} hooks ejecutables registrados`);
+    return true;
+  }
+  log(`  [FALLA] hooks-config.json: ${faltantes.length} hook(s) sin declarar`);
+  for (const f of faltantes) {
+    log(`          → ${f}`);
+    errores.push({ categoria: 'hooks-config.json', archivo: f, tipo: 'no_declarado_hooks_config' });
+  }
+  return false;
+}
+
+function verificarDeclarados1a1ExistenEnDisco(declarados) {
+  // Caso inverso: declarados en manifest pero no presentes en disco
+  const rotos = [];
+  for (const decl of declarados) {
+    // Habilidades son directorios
+    if (decl.startsWith('habilidades/') && !decl.includes('/SKILL.md')) {
+      const absDir = path.join(RAIZ, decl);
+      const skillMd = path.join(absDir, 'SKILL.md');
+      if (!fs.existsSync(skillMd)) rotos.push(decl);
+      continue;
+    }
+    const abs = path.join(RAIZ, decl);
+    if (!fs.existsSync(abs)) rotos.push(decl);
+  }
+  if (rotos.length === 0) {
+    log(`  [OK]    Referencias en modulos.json: ${declarados.size}/${declarados.size} existen en disco`);
+    return true;
+  }
+  log(`  [FALLA] modulos.json: ${rotos.length} ruta(s) rotas (declaradas pero no existen)`);
+  for (const r of rotos) {
+    log(`          → ${r}`);
+    errores.push({ categoria: 'modulos.json', archivo: r, tipo: 'declarado_no_existe' });
+  }
+  return false;
+}
+
+function main() {
+  log('Validación de sincronización manifiestos ↔ disco\n');
+
+  const modulos = JSON.parse(fs.readFileSync(MODULOS_PATH, 'utf-8'));
+  const hooksConfig = JSON.parse(fs.readFileSync(HOOKS_CONFIG_PATH, 'utf-8'));
+  const declarados = recolectarDeclarados(modulos);
+
+  const hooksEjecutables = listarArchivos('hooks', '.js').filter(a => !a.startsWith('hooks/lib/'));
+
+  const categorias = [
+    { etiqueta: 'comandos/swl/',       archivos: listarArchivos('comandos/swl', '.md') },
+    { etiqueta: 'hooks/ (ejecutables)', archivos: hooksEjecutables },
+    { etiqueta: 'agentes/',             archivos: listarArchivos('agentes', '.md') },
+    { etiqueta: 'habilidades/ (dirs)',  archivos: listarDirectoriosHabilidades() },
+    { etiqueta: 'reglas/',              archivos: listarArchivos('reglas', '.md', true) },
+  ];
+
+  let todoOk = true;
+  for (const cat of categorias) {
+    const ok = verificarCategoria(cat.etiqueta, cat.archivos, declarados);
+    if (!ok) todoOk = false;
+  }
+
+  const hooksOk = verificarHooksEjecutablesEnConfig(hooksEjecutables, hooksConfig);
+  if (!hooksOk) todoOk = false;
+
+  const inversoOk = verificarDeclarados1a1ExistenEnDisco(declarados);
+  if (!inversoOk) todoOk = false;
+
+  log('');
+  if (todoOk) {
+    log('✓ Todos los manifiestos están sincronizados con el disco.');
+  } else {
+    log(`✗ ${errores.length} problema(s) de sincronización.`);
+    log('');
+    log('  Cómo corregir:');
+    log('  - "no_declarado_modulos": agregar la ruta al módulo apropiado en manifiestos/modulos.json');
+    log('  - "no_declarado_hooks_config": registrar el hook en manifiestos/hooks-config.json');
+    log('  - "declarado_no_existe": eliminar la ruta de modulos.json (archivo borrado) o crear el archivo');
+  }
+
+  if (salidaJson) {
+    console.log(JSON.stringify({ ok: todoOk, totalErrores: errores.length, errores }, null, 2));
+  }
+
+  process.exit(todoOk ? 0 : 1);
+}
+
+main();