@saulwade/swl-ses 1.0.0

package/schemas/skill-frontmatter.schema.json

@@ -0,0 +1,170 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/skill-frontmatter.json",
+  "title": "SWL Skill Frontmatter",
+  "description": "Schema de validacion para el frontmatter YAML de skills del sistema SWL",
+  "type": "object",
+  "required": ["name", "description"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]+$",
+      "maxLength": 64,
+      "description": "Nombre en kebab-case que coincide con el directorio"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 20,
+      "maxLength": 1024,
+      "description": "Descripcion que incluye QUE hace y CUANDO cargarla"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "provenance": {
+      "type": "object",
+      "description": "Campo legacy. Equivalente espanol: 'procedencia'. Si ambos presentes deben coincidir (W010).",
+      "properties": {
+        "origin": {
+          "type": "string",
+          "enum": ["manual", "auto-evolution", "imported", "community"]
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "author": {
+          "type": "string"
+        }
+      }
+    },
+    "procedencia": {
+      "type": "object",
+      "description": "Alias en espanol de 'provenance'. Campo propio de swl-ses. Si ambos presentes, deben coincidir (W010).",
+      "properties": {
+        "origin": {
+          "type": "string",
+          "enum": ["manual", "auto-evolution", "imported", "community"]
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "author": {
+          "type": "string"
+        }
+      }
+    },
+    "targets": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["claude", "openclaude", "copilot", "opencode", "codex", "gemini"]
+      },
+      "description": "Campo legacy. Equivalente espanol: 'destinos'. Runtimes a los que se sincroniza este skill. Patron adoptado de skillshare (targets.yaml). Si ambos presentes deben coincidir (W010)."
+    },
+    "destinos": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["claude", "openclaude", "copilot", "opencode", "codex", "gemini"]
+      },
+      "description": "Alias en espanol de 'targets'. Campo propio de swl-ses. Runtimes a los que se sincroniza este skill."
+    },
+    "user-invocable": {
+      "type": "boolean",
+      "description": "Si el usuario puede invocar este skill directamente con Skill(nombre)"
+    },
+    "license": {
+      "type": "string",
+      "description": "Licencia del skill si es externo o adaptado"
+    },
+    "evolvable": {
+      "type": "boolean",
+      "description": "Campo legacy. Equivalente espanol: 'evolucionable'. Marca AGP learnability. Si false, el loop de auto-evolucion NO debe proponer cambios a este skill. Recomendado: false para skills criticos. Si ambos presentes deben coincidir (W010)."
+    },
+    "evolucionable": {
+      "type": "boolean",
+      "description": "Alias en espanol de 'evolvable'. Campo propio de swl-ses. Marca AGP learnability. Si false, el loop de auto-evolucion NO propone cambios a este skill."
+    },
+    "evolvable_scope": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["description", "content", "examples", "references", "anti-patterns"]
+      },
+      "description": "Campo legacy. Equivalente espanol: 'evolucionable_alcance'. Si evolvable=true, limita las secciones del SKILL.md que pueden modificarse. Ausente implica 'content' y 'examples' unicamente. Si ambos presentes deben coincidir (W010)."
+    },
+    "evolucionable_alcance": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["description", "content", "examples", "references", "anti-patterns"]
+      },
+      "description": "Alias en espanol de 'evolvable_scope'. Campo propio de swl-ses. Si evolucionable=true, limita las secciones modificables."
+    },
+    "when_to_use": {
+      "type": "string",
+      "maxLength": 512,
+      "description": "Campo del protocolo Anthropic. Contexto adicional sobre cuando activar la skill, leido por Claude Code como bloque combinado con description (total max 1536 chars). Usar cuando description ocupa mas de 900 chars y aun hay triggers que no caben."
+    },
+    "exclusiones": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Situaciones donde esta skill NO debe activarse aunque parezca relevante superficialmente. Campo propio de swl-ses; previene skill hijacking por similitud de terminos. Equivalente estructural de la seccion 'Cuando NO cargar' en el cuerpo de SKILL.md, legible por herramientas de analisis sin parsear markdown."
+    },
+    "allowed-tools": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["Read", "Write", "Edit", "Bash", "Glob", "Grep", "WebSearch", "WebFetch"]
+      },
+      "description": "Campo del protocolo Anthropic. Pre-aprobacion de UX leida por Claude Code. NO es restriccion de seguridad real. Las restricciones reales provienen de permission rules en .claude/settings.json o del matcher en hooks."
+    },
+    "herramientasPermitidas": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["Read", "Write", "Edit", "Bash", "Glob", "Grep", "WebSearch", "WebFetch"]
+      },
+      "description": "Campo propio de swl-ses. Alias semantico de allowed-tools, usado por las herramientas internas (evaluar-skill, validadores). Debe coincidir con allowed-tools cuando ambos estan presentes. Si divergen, el validador emite W011. Para skills nuevos en swl-ses, declarar solo este campo; una herramienta de sincronizacion propagara el valor a allowed-tools al construir artefactos para Claude Code."
+    },
+    "nist_csf": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^(GV|ID|PR|DE|RS|RC)\\.[A-Z]{2}(-[0-9]{2})?$" },
+      "description": "Campo propio de swl-ses. Mapeo a NIST Cybersecurity Framework 2.0. Cada entrada es un ID de subcategoria tipo 'GV.SC-07', 'PR.PS-01', 'DE.CM-01'. Opcional. Usado para reportes de cobertura en /swl:salud y /swl:dashboard. Referencia: https://www.nist.gov/cyberframework"
+    },
+    "nist_ai_rmf": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^(GOVERN|MAP|MEASURE|MANAGE)(-[0-9]+(\\.[0-9]+)?)?$" },
+      "description": "Campo propio de swl-ses. Mapeo a NIST AI Risk Management Framework 1.0. Cada entrada es un ID de subcategoria tipo 'GOVERN-1.1', 'MAP-5.1', 'MEASURE-2.7'. Opcional. Particularmente relevante para skills de seguridad de sistemas agenticos. Referencia: https://airc.nist.gov/AI_RMF"
+    },
+    "atlas_techniques": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^AML\\.T[0-9]{4}(\\.[0-9]{3})?$" },
+      "description": "Campo propio de swl-ses. Mapeo a MITRE ATLAS v5.4 (Adversarial Threat Landscape for AI Systems). Cada entrada es una tecnica tipo 'AML.T0051' (LLM Prompt Injection), 'AML.T0080' (AI Agent Context Poisoning). Opcional. Critico para skills que protegen el sistema agentico mismo. Referencia: https://atlas.mitre.org"
+    },
+    "attack_techniques": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^T[0-9]{4}(\\.[0-9]{3})?$" },
+      "description": "Campo propio de swl-ses. Mapeo a MITRE ATT&CK v18. Cada entrada es una tecnica tipo 'T1071' (Application Layer Protocol), 'T1190' (Exploit Public-Facing Application). Opcional. Mas aplicable a skills de defensa de infraestructura o deteccion de amenazas en el sistema desplegado. Referencia: https://attack.mitre.org"
+    },
+    "d3fend_techniques": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^D3-[A-Z]+$" },
+      "description": "Campo propio de swl-ses. Mapeo a MITRE D3FEND v1.3 (Defensive countermeasures). Cada entrada es una tecnica tipo 'D3-NTA' (Network Traffic Analysis), 'D3-PSA' (Process Spawn Analysis). Opcional. Referencia: https://d3fend.mitre.org"
+    }
+  },
+  "additionalProperties": true
+}

package/scripts/actualizar.js

@@ -0,0 +1,145 @@
+'use strict';
+
+/**
+ * swl-ses update
+ * Actualiza componentes instalados preservando _userland/.
+ * Interactivo: muestra versiones, pide confirmación, muestra progreso.
+ * No-interactivo con --force o sin TTY.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { detectarRuntimes } = require('./lib/detectar-runtime');
+const { cargarEstado } = require('./lib/estado');
+const {
+  color, icono, encabezado, formatearPaso, formatearAdvertencia,
+  spinner, preguntarSiNo, lineaSeparadora, ES_TTY,
+} = require('./lib/ui');
+const { versionRemotaParalela } = require('./lib/npm-version');
+
+const VERSION_LOCAL = require('../package.json').version;
+
+/**
+ * Consulta la versión más reciente publicada en npm. Si la consulta falla
+ * (sin red, timeout), retorna la versión local como fallback razonable.
+ */
+async function obtenerVersionRemota() {
+  const r = await versionRemotaParalela({ timeoutMs: 10000 });
+  return r.version || VERSION_LOCAL;
+}
+
+async function update(opciones) {
+  const force = opciones.force || !ES_TTY;
+
+  // Obtener la versión más reciente del registro npm
+  const VERSION = await obtenerVersionRemota();
+
+  console.log(encabezado('swl-ses update', VERSION_LOCAL));
+
+  // 1. Detectar runtimes
+  const runtimes = detectarRuntimes();
+
+  if (runtimes.length === 0) {
+    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalación SWL'));
+    console.log(`\n  Ejecuta primero: npx @saulwade/swl-ses@latest install --target claude`);
+    process.exit(1);
+  }
+
+  let actualizados = 0;
+  let omitidos = 0;
+
+  // 2. Iterar runtimes
+  for (const runtime of runtimes) {
+    const dirs = [runtime.global, path.resolve(runtime.local)];
+    for (const dir of dirs) {
+      if (!fs.existsSync(dir)) continue;
+
+      const estado = cargarEstado(dir);
+      if (!estado) continue;
+
+      const versionInstalada = estado.versionSistema || 'desconocida';
+      const esGlobal = dir === runtime.global;
+      const ubicacion = esGlobal ? 'global' : 'proyecto';
+
+      const necesitaActualizar = versionInstalada !== VERSION;
+      const paqueteDesactualizado = VERSION_LOCAL !== VERSION;
+
+      console.log(`  ${color.negrita(`Runtime: ${runtime.nombre}`)} ${color.dim(`(${ubicacion})`)}`);
+      console.log(`  Versión instalada:  ${necesitaActualizar ? color.amarillo(versionInstalada) : color.verde(versionInstalada)}`);
+      console.log(`  Versión disponible: ${color.verde(VERSION)}${paqueteDesactualizado ? color.dim(` (ejecutando con v${VERSION_LOCAL})`) : ''}`);
+      console.log(`  Perfil:             ${estado.perfil}`);
+      console.log(`  Componentes:        ${estado.componentesInstalados.length}`);
+      console.log(`  Archivos:           ${estado.archivosInstalados.length}`);
+      console.log('');
+
+      // Si la versión disponible es más reciente pero el paquete ejecutándose es viejo,
+      // indicar al usuario que use @latest
+      if (paqueteDesactualizado && necesitaActualizar) {
+        console.log(formatearAdvertencia(runtime.nombre,
+          `Este paquete es v${VERSION_LOCAL} pero la v${VERSION} está disponible.\n` +
+          `  Para actualizar, ejecuta: npx @saulwade/swl-ses@latest update --force`));
+        console.log('');
+        omitidos++;
+        continue;
+      }
+
+      // Verificar si ya está actualizado
+      if (!necesitaActualizar && !force) {
+        console.log(formatearPaso(runtime.nombre, 'Ya está en la versión más reciente'));
+        console.log('');
+        omitidos++;
+        continue;
+      }
+
+      // Confirmar
+      if (!force) {
+        const confirmar = await preguntarSiNo(
+          !necesitaActualizar
+            ? `¿Re-instalar ${runtime.nombre} v${VERSION}?`
+            : `¿Actualizar ${runtime.nombre} de ${versionInstalada} a ${VERSION}?`
+        );
+        console.log('');
+
+        if (!confirmar) {
+          console.log(formatearAdvertencia(runtime.nombre, 'Actualización cancelada por el usuario'));
+          console.log('');
+          omitidos++;
+          continue;
+        }
+      }
+
+      // Ejecutar actualización con spinner
+      const sp = spinner(`Actualizando ${runtime.nombre}...`);
+
+      try {
+        const instalador = require('./instalador');
+        await instalador({
+          target: runtime.id,
+          profile: estado.perfil,
+          global: estado.global,
+          force: true,
+        });
+
+        sp.exito(`${runtime.nombre} actualizado a v${VERSION} (${estado.archivosInstalados.length} archivos)`);
+        actualizados++;
+      } catch (err) {
+        sp.fallo(`Error actualizando ${runtime.nombre}: ${err.message}`);
+      }
+
+      console.log('');
+    }
+  }
+
+  // 3. Reporte final
+  console.log(`  ${lineaSeparadora()}`);
+  if (actualizados > 0) {
+    console.log(formatearPaso('Resultado', `${actualizados} runtime(s) actualizado(s)${omitidos > 0 ? `, ${omitidos} omitido(s)` : ''}`));
+  } else if (omitidos > 0) {
+    console.log(formatearPaso('Resultado', 'Todo está actualizado'));
+  } else {
+    console.log(formatearAdvertencia('Resultado', 'Ningún runtime fue actualizado'));
+  }
+  console.log('');
+}
+
+module.exports = update;

package/scripts/audit-skills.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# scripts/audit-skills.sh — Auditoría opt-in de skills usando snyk-agent-scan.
+#
+# Analiza el directorio habilidades/ buscando: prompt injection, secretos
+# hardcodeados, URLs sospechosas y estructura inválida de SKILL.md.
+#
+# Opt-in: solo ejecuta si SWL_AUDIT_SKILLS=1.
+# Sin la variable, imprime instrucciones y sale con código 0 (no rompe /swl:salud).
+#
+# Uso:
+#   SWL_AUDIT_SKILLS=1 bash scripts/audit-skills.sh
+#
+# Requisito: pip install uv  (o pipx install uv)
+
+set -euo pipefail
+
+PREFIX="[audit-skills]"
+
+# ---------------------------------------------------------------------------
+# Guard de opt-in
+# ---------------------------------------------------------------------------
+
+if [ -z "${SWL_AUDIT_SKILLS:-}" ]; then
+  echo "$PREFIX Auditoría de skills deshabilitada (opt-in)."
+  echo "$PREFIX Para activar: SWL_AUDIT_SKILLS=1 bash scripts/audit-skills.sh"
+  echo "$PREFIX Requiere: pip install uv"
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Verificar disponibilidad de uvx / uv
+# ---------------------------------------------------------------------------
+
+if command -v uvx >/dev/null 2>&1; then
+  RUNNER="uvx"
+elif command -v uv >/dev/null 2>&1; then
+  RUNNER="uv run"
+else
+  echo "$PREFIX uvx/uv no disponible."
+  echo "$PREFIX Instalar con: pip install uv  (o: pipx install uv)"
+  echo "$PREFIX La auditoría de skills no se ejecutó — continúa sin error."
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Detectar directorio de habilidades
+# ---------------------------------------------------------------------------
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+SKILLS_DIR="$REPO_ROOT/habilidades"
+
+if [ ! -d "$SKILLS_DIR" ]; then
+  echo "$PREFIX Directorio habilidades/ no encontrado en $REPO_ROOT"
+  echo "$PREFIX La auditoría de skills no se ejecutó — continúa sin error."
+  exit 0
+fi
+
+echo "$PREFIX Iniciando auditoría de skills en $SKILLS_DIR ..."
+echo "$PREFIX Runner: $RUNNER"
+
+# ---------------------------------------------------------------------------
+# Ejecutar snyk-agent-scan inspect
+# ---------------------------------------------------------------------------
+
+if ! $RUNNER snyk-agent-scan@latest inspect --skills "$SKILLS_DIR" 2>&1; then
+  echo ""
+  echo "$PREFIX El comando snyk-agent-scan terminó con error o no está publicado."
+  echo "$PREFIX Posibles causas:"
+  echo "$PREFIX   - El paquete 'snyk-agent-scan' no está disponible en PyPI."
+  echo "$PREFIX   - Fallo de red durante la descarga."
+  echo "$PREFIX   - La versión @latest no es compatible con el runtime actual."
+  echo "$PREFIX La auditoría de skills no se completó — continúa sin error."
+  exit 0
+fi
+
+echo ""
+echo "$PREFIX Auditoría completada."

package/scripts/auditar-agentes-gaps.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * scripts/auditar-agentes-gaps.js
+ * Audita los agentes de agentes/ y detecta gaps SAP-Agents: Exclusion Clause
+ * y Gotchas.
+ *
+ * Hereda el diseno de scripts/auditar-skills-gaps.js adaptado al dominio de
+ * agentes (archivos agentes/X.md en lugar de habilidades/X/SKILL.md).
+ *
+ * Zero-deps. Salida: JSON por stdout + resumen por stderr.
+ *
+ * Uso:
+ *   node scripts/auditar-agentes-gaps.js             # JSON a stdout
+ *   node scripts/auditar-agentes-gaps.js --resumen   # tabla a stderr
+ *   node scripts/auditar-agentes-gaps.js --save      # persiste en .planning/
+ *   node scripts/auditar-agentes-gaps.js --incluir-excepciones
+ *
+ * Referencia: .planning/knowledge/outputs/propuesta-sap-agents-2026-04-20.md
+ * ADR relacionado: ADR-0004.
+ */
+
+var fs = require('fs');
+var path = require('path');
+
+var RAIZ_AGENTES = path.resolve(__dirname, '..', 'agentes');
+var DESTINO_PLANNING = path.resolve(
+  __dirname, '..', '.planning', 'evolucion', 'audit-agentes-gaps.json'
+);
+
+// Patrones - soportan LF y CRLF (Windows).
+var PATRON_EXCLUSION_CUERPO = /cuando no|cu\u00e1ndo no|no cargar|no invocar|no usar|NO se debe/i;
+var PATRON_GOTCHAS = /gotcha|errores comunes|trampas|errores no obvios|fallas conocidas/i;
+var PATRON_FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---/;
+
+var EXCEPCIONES_DOCUMENTADAS = Object.freeze({});
+
+function listarAgentes() {
+  if (!fs.existsSync(RAIZ_AGENTES)) return [];
+  return fs.readdirSync(RAIZ_AGENTES, { withFileTypes: true })
+    .filter(function (f) { return f.isFile() && f.name.endsWith('.md'); })
+    .map(function (f) { return f.name.replace(/\.md$/, ''); });
+}
+
+function leerAgente(nombre) {
+  var ruta = path.join(RAIZ_AGENTES, nombre + '.md');
+  if (!fs.existsSync(ruta)) return null;
+  var contenido = fs.readFileSync(ruta, 'utf8');
+  var fmMatch = contenido.match(PATRON_FRONTMATTER);
+  var frontmatterRaw = fmMatch ? fmMatch[1] : '';
+  var cuerpo = fmMatch ? contenido.slice(fmMatch[0].length) : contenido;
+  return { ruta: ruta, contenido: contenido, frontmatterRaw: frontmatterRaw, cuerpo: cuerpo };
+}
+
+function detectarGaps(agente) {
+  var gaps = [];
+  var tieneExclusionFm = /^exclusiones:\s*\[?[^\]]*\]?/im.test(agente.frontmatterRaw);
+  var tieneExclusionCuerpo = PATRON_EXCLUSION_CUERPO.test(agente.cuerpo);
+  if (!tieneExclusionFm && !tieneExclusionCuerpo) gaps.push('sin-exclusion');
+  if (!PATRON_GOTCHAS.test(agente.cuerpo)) gaps.push('sin-gotchas');
+  return gaps;
+}
+
+function clasificarGaps(nombre, gaps) {
+  var excepcion = EXCEPCIONES_DOCUMENTADAS[nombre];
+  if (!excepcion) return { reales: gaps, excusados: [] };
+  var excusadosSet = new Set(excepcion.gaps_excusados);
+  var reales = gaps.filter(function (g) { return !excusadosSet.has(g); });
+  var excusados = gaps.filter(function (g) { return excusadosSet.has(g); });
+  return { reales: reales, excusados: excusados, adr: excepcion.adr, razon: excepcion.razon };
+}
+
+function auditar(opts) {
+  opts = opts || {};
+  var incluirExcepciones = opts.incluirExcepciones === true;
+  var agentes = listarAgentes();
+  var resultado = {
+    timestamp: new Date().toISOString(),
+    total_agentes: agentes.length,
+    agentes_con_gaps: [],
+    excepciones_documentadas: [],
+    resumen: { sin_exclusion: 0, sin_gotchas: 0, excepciones_activas: 0 }
+  };
+
+  for (var i = 0; i < agentes.length; i++) {
+    var nombre = agentes[i];
+    var agente = leerAgente(nombre);
+    if (!agente) continue;
+    var gaps = detectarGaps(agente);
+    if (gaps.length === 0) continue;
+    var clasif = clasificarGaps(nombre, gaps);
+    if (clasif.reales.length > 0) {
+      resultado.agentes_con_gaps.push({ nombre: nombre, gaps: clasif.reales });
+      if (clasif.reales.indexOf('sin-exclusion') !== -1) resultado.resumen.sin_exclusion++;
+      if (clasif.reales.indexOf('sin-gotchas') !== -1) resultado.resumen.sin_gotchas++;
+    }
+    if (clasif.excusados.length > 0) {
+      resultado.excepciones_documentadas.push({
+        nombre: nombre, gaps_excusados: clasif.excusados, adr: clasif.adr, razon: clasif.razon
+      });
+      resultado.resumen.excepciones_activas++;
+      if (incluirExcepciones) {
+        if (clasif.excusados.indexOf('sin-exclusion') !== -1) resultado.resumen.sin_exclusion++;
+        if (clasif.excusados.indexOf('sin-gotchas') !== -1) resultado.resumen.sin_gotchas++;
+      }
+    }
+  }
+  return resultado;
+}
+
+function pct(n, total) {
+  if (total <= 0) return '0.0';
+  return ((n / total) * 100).toFixed(1);
+}
+
+function imprimirResumen(r) {
+  var total = r.total_agentes;
+  var conGaps = r.agentes_con_gaps.length;
+  process.stderr.write('\nAuditoria SAP-Agents - ' + total + ' agentes - ' + r.timestamp + '\n');
+  process.stderr.write('  Sin Exclusion Clause:   ' + r.resumen.sin_exclusion + '/' + total + ' (' + pct(r.resumen.sin_exclusion, total) + '%)\n');
+  process.stderr.write('  Sin Gotchas:            ' + r.resumen.sin_gotchas + '/' + total + ' (' + pct(r.resumen.sin_gotchas, total) + '%)\n');
+  process.stderr.write('  Agentes con >=1 gap:    ' + conGaps + '/' + total + '\n');
+  if (r.resumen.excepciones_activas > 0) {
+    process.stderr.write('  Excepciones documentadas: ' + r.resumen.excepciones_activas + '\n');
+    for (var i = 0; i < r.excepciones_documentadas.length; i++) {
+      var e = r.excepciones_documentadas[i];
+      process.stderr.write('    - ' + e.nombre + ': ' + e.gaps_excusados.join(', ') + ' [' + e.adr + ']\n');
+    }
+  }
+  process.stderr.write('\n');
+}
+
+var argv = process.argv.slice(2);
+var opts = { incluirExcepciones: argv.indexOf('--incluir-excepciones') !== -1 };
+var resultado = auditar(opts);
+
+if (argv.indexOf('--resumen') !== -1) {
+  imprimirResumen(resultado);
+} else if (argv.indexOf('--save') !== -1) {
+  var dir = path.dirname(DESTINO_PLANNING);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(DESTINO_PLANNING, JSON.stringify(resultado, null, 2), 'utf8');
+  imprimirResumen(resultado);
+  process.stderr.write('Inventario persistido en: ' + DESTINO_PLANNING + '\n');
+} else {
+  process.stdout.write(JSON.stringify(resultado, null, 2));
+  imprimirResumen(resultado);
+}