@saulwade/swl-ses 2.5.2 → 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/release-semver/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: release-semver
 description: Versionado semántico (SemVer). Cuándo bumpar major/minor/patch, changelogs convencionales, estrategia de tags y proceso de release completo.
-version: "1.0.3"
+version: "1.0.4"
 herramientasPermitidas: [Read, Bash]
 exclusiones:
   - "No cargar para versionar el sistema SWL — el bump de versión de swl-ses sigue el checklist de 15 ubicaciones documentado en `/swl:release`; este skill cubre SemVer general para proyectos de usuario, no el proceso interno de release del sistema."
@@ -318,7 +318,9 @@ de token inválido.
 - `semantic-release` ya está configurado en CI — si el release está automatizado, el número de versión se calcula desde los commits sin intervención manual; cargar este skill duplicaría el trabajo.
 - El proyecto es una herramienta interna sin consumidores que dependan de compatibilidad de versión — SemVer completo compensa cuando hay consumidores que confían en los números de versión para evaluar breaking changes.
 
-## Gotchas / Errores comunes no obvios
+## Gotchas / Errores comunes no obvios
+
+- **El registry espejo NUNCA publica cuando el canónico falló sus gates** [caso real: v2.5.0 y v2.5.1 quedaron huérfanas en GitHub Packages, 2026-07-08/09]: un publisher dual que publica el mirror desde un directorio temporal preparado (donde `prepublishOnly`/gates NO corren) debe condicionar el paso 2 al éxito del paso 1 — si el canónico falló, el mirror se OMITE con aviso visible. Publicar tras el fallo sube un tarball sin validar y desalinea los registries: la misma versión no puede re-subirse, forzando un "republish de coordinación" (bump PATCH) que es puro costo. Verificar además que el flujo del mirror realmente corre gates en alguna parte — "los pre-publish ya pasaron en el intento 1" es una suposición, no una garantía.
 
 - **Tag ligero creado en lugar de anotado para el release**: `git tag v2.1.0` sin la flag `-a` crea un tag ligero que no incluye metadata de autor, fecha ni mensaje. Causa: olvidar la flag `-a` o la costumbre de usar tags ligeros para marcado temporal. Solución: siempre `git tag -a v2.1.0 -m "Release v2.1.0"` para releases — los tags anotados son los que `git describe` y las herramientas de changelog usan correctamente.
 - **MAJOR evitado por considerar el breaking change "pequeño"**: el equipo sube de `1.4.2` a `1.5.0` un endpoint que cambió su contrato de respuesta. Causa: subestimar el impacto del breaking change para evitar el salto de versión mayor. Solución: si un consumidor tiene que actualizar su código para seguir funcionando, es MAJOR sin importar el tamaño del cambio — el anti-patrón "Nunca saltarse MAJOR por miedo" es explícito en el skill.

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');