@saulwade/swl-ses 2.5.3 → 2.6.0

package/habilidades/proceso-ddia-fundamentos/SKILL.md

@@ -175,8 +175,9 @@ SWL tiene 14 archivos `schemas/*.schema.json`. Reglas operativas:
 
 ### Detección de breaking changes
 
-Helper `scripts/lib/schema-version.js` (creado en F4) implementa estas
-reglas. Uso esperado:
+Helper `scripts/lib/schema-version.js` (creado en F4, layout del repo madre;
+en instalaciones destino vive aplanado junto a los hooks) implementa estas
+reglas. Referencia de API — uso esperado:
 
 ```js
 const { verificarCompatibilidad } = require('./scripts/lib/schema-version');

package/habilidades/swl-claudemd/SKILL.md

@@ -53,13 +53,12 @@ Más dos prácticas auxiliares del video:
 Ejecuta el auditor determinista:
 
 ```bash
-# Repo de swl-ses (script local): node scripts/auditar-claudemd.js [--json|--strict]
-# Proyecto downstream (NO existe el script local): usar el subcomando del CLI:
-npx -y @saulwade/swl-ses@latest audit-claudemd [--json|--strict]
+# CLI cross-scope: en el repo madre resuelve al script local, en proyectos
+# downstream al paquete instalado/npx. Mismo auditor en ambos casos.
+swl-ses audit-claudemd [--json|--strict]
 ```
 
-Regla: si `scripts/auditar-claudemd.js` no existe en el CWD, usar SIEMPRE
-`npx ... audit-claudemd` — ambas rutas ejecutan el mismo auditor.
+Si `swl-ses` no está en PATH: `npx -y @saulwade/swl-ses@latest audit-claudemd`.
 
 El auditor verifica nueve dimensiones (la fila `@references rotos` caza el `@reglas/...` roto downstream):
 
@@ -205,8 +204,8 @@ y mensaje WARN — project-level >50 LOC sin mención a los 4 principios).
 `/swl:aprender` **muta** CLAUDE.md; `/swl:claudemd` **prescribe contrato**.
 Todo comando SWL que escriba a CLAUDE.md del proyecto (`aprender`,
 `adoptar-proyecto`, `nuevo-proyecto`, `claudemd init-project`, futuros) DEBE
-ejecutar el auditor síncrono tras escribir (`node scripts/auditar-claudemd.js
---json`), evaluar el veredicto (OK→continuar; WARN→proponer condensar/extraer;
+ejecutar el auditor síncrono tras escribir (`swl-ses audit-claudemd --json`,
+CLI cross-scope), evaluar el veredicto (OK→continuar; WARN→proponer condensar/extraer;
 `ERROR placeholders`→**DETENER y revertir**) y re-auditar hasta OK/WARN aceptable.
 
 Doble red: capa síncrona (Paso 6.5 de aprender — proactiva, bloquea el comando)

package/habilidades/swl-dashboard/SKILL.md

@@ -243,51 +243,15 @@ Muestra en terminal las métricas de activación y bloqueo de los guardrails (ho
 de la sesión actual. Los datos provienen de `hooks/lib/guardrail-metrics.js`.
 
 ```bash
-# Leer métricas de guardrails de la sesión actual desde /tmp/
-SESSION_ID="${CLAUDE_SESSION_ID:-default}"
-BRIDGE_FILE="/tmp/swl-guardrail-metrics-${SESSION_ID}.json"
-
-if [ -f "$BRIDGE_FILE" ]; then
-  node -e "
-    const m = require('$BRIDGE_FILE');
-    const hooks = m.hooks || {};
-    const entries = Object.entries(hooks).sort(([,a],[,b]) => b.bloqueos - a.bloqueos);
-    if (entries.length === 0) {
-      console.log('Ningún guardrail se activó en esta sesión.');
-    } else {
-      console.log('\\nGuardrails — Activaciones de la sesión\\n');
-      console.log('Hook'.padEnd(30) + 'Activaciones'.padStart(13) + 'Bloqueos'.padStart(9) + 'Warnings'.padStart(9) + 'Tasa'.padStart(7));
-      console.log('-'.repeat(68));
-      for (const [nombre, datos] of entries) {
-        const tasa = datos.activaciones > 0 ? Math.round(datos.bloqueos / datos.activaciones * 100) + '%' : '0%';
-        console.log(nombre.replace('.js','').padEnd(30) + String(datos.activaciones).padStart(13) + String(datos.bloqueos).padStart(9) + String(datos.warnings).padStart(9) + tasa.padStart(7));
-      }
-    }
-  "
-else
-  echo "Sin datos de guardrails para esta sesión. (bridge: $BRIDGE_FILE)"
-  echo "Los guardrails registran métricas cuando se activan durante la sesión."
-fi
+# Tabla de activaciones + diagnóstico automático de la sesión actual
+# (--session=ID para otra sesión; --json para salida cruda)
+swl-ses guardrail-metrics
 ```
 
-Después de mostrar la tabla, ejecutar diagnóstico automático:
-
-```bash
-node -e "
-  try {
-    const { getMetrics, diagnosticar } = require('./hooks/lib/guardrail-metrics');
-    const SESSION_ID = process.env.CLAUDE_SESSION_ID || 'default';
-    const metricas = getMetrics(SESSION_ID);
-    const advertencias = diagnosticar(metricas);
-    if (advertencias.length > 0) {
-      console.log('\\n⚠ Diagnóstico:');
-      advertencias.forEach(a => console.log('  - ' + a));
-    } else {
-      console.log('\\n✓ Guardrails sin anomalías detectadas.');
-    }
-  } catch(e) { console.log('(sin datos disponibles)'); }
-"
-```
+El subcomando lee el bridge de la sesión (tmpdir del SO, portable
+Windows/POSIX), imprime la tabla de activaciones/bloqueos/warnings por hook
+y ejecuta el diagnóstico de tasas anómalas — sin datos de sesión muestra el
+resumen vacío.
 
 > El resumen de guardrails también aparece automáticamente al final de cada sesión
 > (hook `resumen-sesion.js`) cuando hay advertencias de tasa anómala.
@@ -314,6 +278,10 @@ Modos: `offline` = funciona leyendo archivos locales; `online` = requiere conexi
 
 ### Uso básico
 
+API del módulo (layout del repo madre; en instalaciones destino vive aplanado
+junto a los hooks instalados — es documentación de referencia, no un comando
+a ejecutar en proyectos consumidores):
+
 ```javascript
 const { listarPorCategoria, listarPorModo, obtenerWidget, obtenerLayoutDefault } =
   require('./scripts/lib/dashboard-widgets');