@saulwade/swl-ses 1.3.1 → 1.3.3

package/comandos/swl/configurar-ci.md

@@ -1,227 +1,227 @@
----
-name: swl:configurar-ci
-description: Instala y gestiona los workflows CI/CD de swl-ses en proyectos de usuarios. Subcomandos init (flujo interactivo completo), status (muestra qué está instalado) y uninstall (quita los workflows). Para setup automatizado de GitHub Actions con revisión de seguridad Claude, CI genérico y release automatizado.
-allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
-user-invocable: true
-version: "1.0.0"
----
-
-# /swl:configurar-ci — Setup de CI/CD en tu proyecto
-
-Orquesta la instalación de los workflows GitHub Actions de swl-ses en el proyecto donde estés trabajando.
-
-## Subcomandos
-
-| Subcomando | Descripción |
-|-----------|-------------|
-| `init` | Flujo interactivo completo (default) |
-| `status` | Muestra qué workflows están instalados y qué secrets se necesitan |
-| `uninstall` | Quita los workflows SWL del proyecto |
-
-Si se invoca sin subcomando, ejecutar `init`.
-
----
-
-## /swl:configurar-ci init
-
-Flujo interactivo paso a paso. Detecta el proyecto en el directorio actual.
-
-### Paso 1 — Verificar contexto
-
-```bash
-node -e "const p=require('./package.json');console.log('Proyecto:',p.name,'v'+p.version)" 2>/dev/null || echo "Sin package.json"
-ls .github/workflows/ 2>/dev/null && echo "Directorio .github/workflows existe" || echo "Directorio .github/workflows no existe"
-```
-
-Mostrar al usuario qué se detectó y confirmar que es el proyecto correcto.
-
-### Paso 2 — Preguntar qué workflows instalar (si TTY)
-
-```
-¿Qué workflows quieres instalar? (Enter para activar, espacio para omitir)
-
-[x] swl-security.yml — Revisión de seguridad con Claude en cada PR
-    REQUIERE: secret CLAUDE_API_KEY en GitHub Settings → Secrets
-
-[x] swl-ci.yml — CI estándar (lint + test) en push y PRs
-    Sin secrets adicionales
-
-[ ] release-please.yml — Releases automáticos desde conventional commits
-    Sin secrets adicionales. Requiere conventional commits.
-```
-
-Si el usuario omite `init` e invoca con flags directos, respetar esos flags sin preguntar:
-- `--with-security` / `--no-security`
-- `--with-ci` / `--no-ci`
-- `--with-release-please`
-- `--dry-run`
-- `--force`
-
-### Paso 3 — Copiar workflows
-
-Invocar `scripts/lib/configurar-ci.js` con las opciones seleccionadas:
-
-```javascript
-const { init } = require('./scripts/lib/configurar-ci');
-const resultado = init({
-  withSecurity: true,
-  withCi: true,
-  withReleasePlease: false,
-  // dryRun: true,  // con --dry-run
-});
-```
-
-Si hay archivos existentes en `resultado.existentes`, preguntar:
-```
-Los siguientes workflows ya existen en .github/workflows/:
-  - swl-security.yml
-¿Sobreescribir? (s/N)
-```
-
-Si el usuario dice que sí, volver a llamar `init` con `force: true`.
-
-### Paso 4 — Configurar CLAUDE_API_KEY (solo si se instaló swl-security.yml)
-
-Preguntar:
-```
-swl-security.yml requiere el secret CLAUDE_API_KEY en GitHub.
-
-¿Quieres configurarlo ahora con gh CLI? (s/N)
-```
-
-Si dice sí, verificar que `gh` esté disponible:
-
-```bash
-gh auth status 2>&1 | head -3
-```
-
-Si está autenticado, guiar al usuario para que pegue su API key (sin almacenarla):
-
-```
-Pega tu CLAUDE_API_KEY (la input estará oculta):
-```
-
-Luego ejecutar:
-```bash
-gh secret set CLAUDE_API_KEY
-# gh leerá el valor desde stdin de forma segura
-```
-
-Si `gh` no está disponible o el usuario dice que no, mostrar el link para hacerlo manualmente:
-```
-Para configurar manualmente:
-  https://github.com/<owner>/<repo>/settings/secrets/actions/new
-  Nombre: CLAUDE_API_KEY
-  Valor:  tu clave de https://console.anthropic.com
-```
-
-### Paso 5 — Configurar branch protection (opcional)
-
-Preguntar:
-```
-¿Aplicar branch protection en main?
-Esto requiere gh CLI autenticado y permisos de admin en el repo.
-(s/N)
-```
-
-Si dice sí:
-```bash
-node scripts/configurar-branch-protection.js --dry-run
-# Mostrar el plan al usuario
-# Si confirma:
-node scripts/configurar-branch-protection.js
-```
-
-**NOTA**: el script de branch protection vive en el repo swl-ses. Si el usuario está en su propio proyecto, advertir que debe copiar el script o usar la guía manual de GitHub Settings → Branches.
-
-### Paso 6 — Resumen final
-
-```
-Setup completado:
-  ✓ .github/workflows/swl-security.yml
-  ✓ .github/workflows/swl-ci.yml
-  - release-please.yml (omitido)
-
-Próximos pasos:
-  1. git add .github/workflows/ && git commit -m "ci: agregar workflows CI/CD swl-ses"
-  2. Abrir un PR para ver el workflow en acción
-  3. Verificar que CLAUDE_API_KEY esté en GitHub Settings → Secrets
-```
-
----
-
-## /swl:configurar-ci status
-
-Muestra el estado actual de los workflows SWL en el proyecto.
-
-```javascript
-const { status } = require('./scripts/lib/configurar-ci');
-const resultado = status();
-```
-
-Formato de salida:
-
-```
-Workflows SWL en .github/workflows/:
-
-Instalados:
-  ✓ swl-security.yml
-    Secrets requeridos: CLAUDE_API_KEY (verificar en GitHub Settings)
-  ✓ swl-ci.yml
-    Sin secrets adicionales
-
-No instalados:
-  - release-please.yml
-
-Para instalar los faltantes: /swl:configurar-ci init
-```
-
-Si `gh` está disponible, intentar verificar si el secret existe:
-```bash
-gh secret list 2>/dev/null | grep CLAUDE_API_KEY
-```
-
----
-
-## /swl:configurar-ci uninstall
-
-Elimina los workflows gestionados por swl-ses. No toca branch protection ni otros workflows.
-
-```javascript
-const { uninstall } = require('./scripts/lib/configurar-ci');
-
-// Primero listar qué se eliminaría (sin confirmar)
-const plan = uninstall({ confirmar: false });
-```
-
-Mostrar:
-```
-Los siguientes workflows serán eliminados:
-  - .github/workflows/swl-security.yml
-  - .github/workflows/swl-ci.yml
-
-¿Confirmar? (s/N)
-```
-
-Si el usuario confirma:
-```javascript
-const resultado = uninstall({ confirmar: true });
-```
-
-Mostrar confirmación de archivos eliminados. Recordar que la branch protection NO se toca.
-
----
-
-## Flags globales
-
-| Flag | Descripción |
-|------|-------------|
-| `--dry-run` | Muestra qué se haría sin modificar nada |
-| `--force` | Sobreescribe archivos existentes sin preguntar |
-| `--with-release-please` | Incluir release-please.yml |
-| `--no-security` | Omitir swl-security.yml |
-| `--no-ci` | Omitir swl-ci.yml |
-
-## Skill de referencia
-
-Para troubleshooting, gotchas y guía avanzada: `Skill("infra-github-actions")`.
+---
+name: swl:configurar-ci
+description: Instala y gestiona los workflows CI/CD de swl-ses en proyectos de usuarios. Subcomandos init (flujo interactivo completo), status (muestra qué está instalado) y uninstall (quita los workflows). Para setup automatizado de GitHub Actions con revisión de seguridad Claude, CI genérico y release automatizado.
+allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
+user-invocable: true
+version: "1.0.0"
+---
+
+# /swl:configurar-ci — Setup de CI/CD en tu proyecto
+
+Orquesta la instalación de los workflows GitHub Actions de swl-ses en el proyecto donde estés trabajando.
+
+## Subcomandos
+
+| Subcomando | Descripción |
+|-----------|-------------|
+| `init` | Flujo interactivo completo (default) |
+| `status` | Muestra qué workflows están instalados y qué secrets se necesitan |
+| `uninstall` | Quita los workflows SWL del proyecto |
+
+Si se invoca sin subcomando, ejecutar `init`.
+
+---
+
+## /swl:configurar-ci init
+
+Flujo interactivo paso a paso. Detecta el proyecto en el directorio actual.
+
+### Paso 1 — Verificar contexto
+
+```bash
+node -e "const p=require('./package.json');console.log('Proyecto:',p.name,'v'+p.version)" 2>/dev/null || echo "Sin package.json"
+ls .github/workflows/ 2>/dev/null && echo "Directorio .github/workflows existe" || echo "Directorio .github/workflows no existe"
+```
+
+Mostrar al usuario qué se detectó y confirmar que es el proyecto correcto.
+
+### Paso 2 — Preguntar qué workflows instalar (si TTY)
+
+```
+¿Qué workflows quieres instalar? (Enter para activar, espacio para omitir)
+
+[x] swl-security.yml — Revisión de seguridad con Claude en cada PR
+    REQUIERE: secret CLAUDE_API_KEY en GitHub Settings → Secrets
+
+[x] swl-ci.yml — CI estándar (lint + test) en push y PRs
+    Sin secrets adicionales
+
+[ ] release-please.yml — Releases automáticos desde conventional commits
+    Sin secrets adicionales. Requiere conventional commits.
+```
+
+Si el usuario omite `init` e invoca con flags directos, respetar esos flags sin preguntar:
+- `--with-security` / `--no-security`
+- `--with-ci` / `--no-ci`
+- `--with-release-please`
+- `--dry-run`
+- `--force`
+
+### Paso 3 — Copiar workflows
+
+Invocar `scripts/lib/configurar-ci.js` con las opciones seleccionadas:
+
+```javascript
+const { init } = require('./scripts/lib/configurar-ci');
+const resultado = init({
+  withSecurity: true,
+  withCi: true,
+  withReleasePlease: false,
+  // dryRun: true,  // con --dry-run
+});
+```
+
+Si hay archivos existentes en `resultado.existentes`, preguntar:
+```
+Los siguientes workflows ya existen en .github/workflows/:
+  - swl-security.yml
+¿Sobreescribir? (s/N)
+```
+
+Si el usuario dice que sí, volver a llamar `init` con `force: true`.
+
+### Paso 4 — Configurar CLAUDE_API_KEY (solo si se instaló swl-security.yml)
+
+Preguntar:
+```
+swl-security.yml requiere el secret CLAUDE_API_KEY en GitHub.
+
+¿Quieres configurarlo ahora con gh CLI? (s/N)
+```
+
+Si dice sí, verificar que `gh` esté disponible:
+
+```bash
+gh auth status 2>&1 | head -3
+```
+
+Si está autenticado, guiar al usuario para que pegue su API key (sin almacenarla):
+
+```
+Pega tu CLAUDE_API_KEY (la input estará oculta):
+```
+
+Luego ejecutar:
+```bash
+gh secret set CLAUDE_API_KEY
+# gh leerá el valor desde stdin de forma segura
+```
+
+Si `gh` no está disponible o el usuario dice que no, mostrar el link para hacerlo manualmente:
+```
+Para configurar manualmente:
+  https://github.com/<owner>/<repo>/settings/secrets/actions/new
+  Nombre: CLAUDE_API_KEY
+  Valor:  tu clave de https://console.anthropic.com
+```
+
+### Paso 5 — Configurar branch protection (opcional)
+
+Preguntar:
+```
+¿Aplicar branch protection en main?
+Esto requiere gh CLI autenticado y permisos de admin en el repo.
+(s/N)
+```
+
+Si dice sí:
+```bash
+npx -y @saulwade/swl-ses@latest configure-branch-protection --dry-run
+# Mostrar el plan al usuario
+# Si confirma:
+npx -y @saulwade/swl-ses@latest configure-branch-protection
+```
+
+El subcomando `configure-branch-protection` del CLI funciona desde cualquier proyecto: detecta el repo actual con `gh repo view`, aplica las reglas a su rama `main` y reporta resultado. No depende de la ubicación del paquete swl-ses.
+
+### Paso 6 — Resumen final
+
+```
+Setup completado:
+  ✓ .github/workflows/swl-security.yml
+  ✓ .github/workflows/swl-ci.yml
+  - release-please.yml (omitido)
+
+Próximos pasos:
+  1. git add .github/workflows/ && git commit -m "ci: agregar workflows CI/CD swl-ses"
+  2. Abrir un PR para ver el workflow en acción
+  3. Verificar que CLAUDE_API_KEY esté en GitHub Settings → Secrets
+```
+
+---
+
+## /swl:configurar-ci status
+
+Muestra el estado actual de los workflows SWL en el proyecto.
+
+```javascript
+const { status } = require('./scripts/lib/configurar-ci');
+const resultado = status();
+```
+
+Formato de salida:
+
+```
+Workflows SWL en .github/workflows/:
+
+Instalados:
+  ✓ swl-security.yml
+    Secrets requeridos: CLAUDE_API_KEY (verificar en GitHub Settings)
+  ✓ swl-ci.yml
+    Sin secrets adicionales
+
+No instalados:
+  - release-please.yml
+
+Para instalar los faltantes: /swl:configurar-ci init
+```
+
+Si `gh` está disponible, intentar verificar si el secret existe:
+```bash
+gh secret list 2>/dev/null | grep CLAUDE_API_KEY
+```
+
+---
+
+## /swl:configurar-ci uninstall
+
+Elimina los workflows gestionados por swl-ses. No toca branch protection ni otros workflows.
+
+```javascript
+const { uninstall } = require('./scripts/lib/configurar-ci');
+
+// Primero listar qué se eliminaría (sin confirmar)
+const plan = uninstall({ confirmar: false });
+```
+
+Mostrar:
+```
+Los siguientes workflows serán eliminados:
+  - .github/workflows/swl-security.yml
+  - .github/workflows/swl-ci.yml
+
+¿Confirmar? (s/N)
+```
+
+Si el usuario confirma:
+```javascript
+const resultado = uninstall({ confirmar: true });
+```
+
+Mostrar confirmación de archivos eliminados. Recordar que la branch protection NO se toca.
+
+---
+
+## Flags globales
+
+| Flag | Descripción |
+|------|-------------|
+| `--dry-run` | Muestra qué se haría sin modificar nada |
+| `--force` | Sobreescribe archivos existentes sin preguntar |
+| `--with-release-please` | Incluir release-please.yml |
+| `--no-security` | Omitir swl-security.yml |
+| `--no-ci` | Omitir swl-ci.yml |
+
+## Skill de referencia
+
+Para troubleshooting, gotchas y guía avanzada: `Skill("infra-github-actions")`.

package/comandos/swl/evolucion-estado.md

@@ -149,7 +149,7 @@ Template de salida:
 Al final del dashboard, sugerir acciones según las métricas:
 
 - Si `instintos.proyecto === 0` y `aprendizajes_totales > 10`:
-  → `node scripts/bootstrap-instintos.js` (pobla desde APRENDIZAJES.md)
+  → `npx -y @saulwade/swl-ses@latest bootstrap-instincts` (pobla desde APRENDIZAJES.md)
 
 - Si `nudges.tasaAccion < 0.3` y `nudges.total > 5`:
   → "Muchos nudges ignorados. Revisa `.planning/evolucion/alertas-persistentes.json`"

package/comandos/swl/evolucionar.md

@@ -172,7 +172,7 @@ garantizar que la evolución no degradó el skill/agente:
 ### 6.5.1 — Verificar si existe archivo de evals
 
 ```bash
-node scripts/run-skill-evals.js <nombre> --list 2>/dev/null | grep "<nombre>"
+npx -y @saulwade/swl-ses@latest run-skill-evals <nombre> --list 2>/dev/null | grep "<nombre>"
 ```
 
 Si NO hay evals: saltar este paso y registrar en CHANGELOG:
@@ -193,7 +193,7 @@ score_baseline = (evals_pass / evals_total) * 100 × factor_peso
 Registrar:
 
 ```bash
-node scripts/run-skill-evals.js <nombre> --record-baseline --score=<N>
+npx -y @saulwade/swl-ses@latest run-skill-evals <nombre> --record-baseline --score=<N>
 ```
 
 ### 6.5.3 — Aplicar el cambio (lo que ya hacía el Paso 6)
@@ -210,7 +210,7 @@ score_after = (evals_pass / evals_total) * 100 × factor_peso
 
 | Condición | Acción |
 |---|---|
-| `score_after >= score_baseline` | **Aceptar** — `node scripts/run-skill-evals.js <nombre> --record-after --score=<N>` |
+| `score_after >= score_baseline` | **Aceptar** — `npx -y @saulwade/swl-ses@latest run-skill-evals <nombre> --record-after --score=<N>` |
 | `score_after < score_baseline - 5` | **Revertir** — restaurar el archivo anterior + `--record-revert --score=<N>` |
 | `score_baseline - 5 <= score_after < score_baseline` | **Requiere revisión humana** — reportar diferencia; usuario decide si acepta la regresión menor o revierte |
 

package/comandos/swl/inbox.md

@@ -89,7 +89,7 @@ Si tu sesión de Claude Code corre dentro de `tmux`, puedes usar el daemon opt-i
 
 ```bash
 # Correr en una terminal separada
-node scripts/inbox-tmux-inject.js --session claude --poll 2
+npx -y @saulwade/swl-ses@latest inbox-tmux-inject --session=claude --poll=2
 ```
 
 Ese daemon monitorea `.planning/inbox/` y usa `tmux send-keys` para inyectar el comando a la sesión Claude. No funciona en Windows (no hay tmux).

package/comandos/swl/reflect-skills.md

@@ -31,7 +31,7 @@ Complementa a `/swl:aprender` (que trabaja sobre la sesión actual) y a `/swl:ev
 Corre el script determinista que lee los JSONL del proyecto actual y clusteriza intenciones:
 
 ```bash
-node scripts/reflect-skills.js --ventana 30 --umbral 3
+npx -y @saulwade/swl-ses@latest reflect-skills --ventana=30 --umbral=3
 ```
 
 Parámetros:

package/comandos/swl/salud.md

@@ -227,7 +227,7 @@ Si la variable de entorno `SWL_AUDIT_FRAMEWORKS=1` está presente, ejecutar el
 auditor de cobertura:
 
 ```bash
-node scripts/auditar-cobertura-frameworks.js --resumen
+npx -y @saulwade/swl-ses@latest audit-coverage-frameworks --resumen
 ```
 
 Propósito: reportar cuántos skills declaran mapeos a los 5 frameworks de
@@ -249,13 +249,13 @@ cada framework.
 **Filtrado por framework**:
 
 ```bash
-SWL_AUDIT_FRAMEWORKS=1 node scripts/auditar-cobertura-frameworks.js --framework=nist_ai_rmf --resumen
+SWL_AUDIT_FRAMEWORKS=1 npx -y @saulwade/swl-ses@latest audit-coverage-frameworks --framework=nist_ai_rmf --resumen
 ```
 
 **Persistir snapshot**:
 
 ```bash
-node scripts/auditar-cobertura-frameworks.js --save
+npx -y @saulwade/swl-ses@latest audit-coverage-frameworks --save
 ```
 
 Persiste en `.planning/evolucion/cobertura-frameworks.json` para comparación
@@ -271,7 +271,7 @@ Si la variable de entorno `SWL_AUDIT_AGENTES=1` está presente, ejecutar el
 auditor de agentes:
 
 ```bash
-node scripts/auditar-agentes-gaps.js --resumen
+npx -y @saulwade/swl-ses@latest audit-agents-gaps --resumen
 ```
 
 Propósito: reportar cuántos agentes carecen de Exclusion Clause (campo
@@ -294,7 +294,7 @@ monolíticos, secciones canónicas (Stack/Comandos/Code style/Conventions),
 uso de `@references`, placeholders sin reemplazar.
 
 ```bash
-node scripts/auditar-claudemd.js --json
+npx -y @saulwade/swl-ses@latest audit-claudemd --json
 ```
 
 Veredictos posibles:
@@ -322,7 +322,7 @@ Si existe `manifiestos/skills-lock.json`, comparar el hash actual de cada
 skills entre release y release.
 
 ```bash
-node scripts/generar-skills-lock.js --check
+npx -y @saulwade/swl-ses@latest generate-skills-lock --check
 ```
 
 Estados posibles:
@@ -333,7 +333,7 @@ Estados posibles:
 | `✗ skills-lock DRIFT detectado` | Skills modificados, nuevos o faltantes | Listar diferencias y proponer regenerar |
 
 Si NO existe el lock (proyecto fresco o pre-1.1.0), este paso se omite y
-emite advertencia sugerente: `node scripts/generar-skills-lock.js`.
+emite advertencia sugerente: `npx -y @saulwade/swl-ses@latest generate-skills-lock`.
 
 El lock se regenera automáticamente como parte de `/swl:release`. Drift
 fuera de release indica ediciones manuales no committed.

package/comandos/swl/skill-search.md

@@ -32,16 +32,16 @@ Si falta, indicar al usuario que actualice SWL con `/swl:actualizar`.
 ### Sin query (catálogo completo)
 
 ```bash
-node scripts/lib/skill-discovery.js
+npx -y @saulwade/swl-ses@latest skill-discovery
 ```
 
 ### Con query (búsqueda filtrada)
 
 ```bash
-node scripts/lib/skill-discovery.js "<query>"
+npx -y @saulwade/swl-ses@latest skill-discovery "<query>"
 ```
 
-Ejemplo: `node scripts/lib/skill-discovery.js "typescript"` muestra skills de TypeScript.
+Ejemplo: `npx -y @saulwade/swl-ses@latest skill-discovery "typescript"` muestra skills de TypeScript.
 
 ### Búsqueda por intent (--intent)
 
@@ -75,7 +75,7 @@ o por las keywords del dominio en la descripción.
 ### Reconstruir índice
 
 ```bash
-node scripts/lib/skill-discovery.js --rebuild
+npx -y @saulwade/swl-ses@latest skill-discovery --rebuild
 ```
 
 ## Paso 3 — Presentar resultados

package/manifiestos/perfiles.json

@@ -398,7 +398,8 @@
         "hooks-multica",
         "graphify-swl",
         "mcp-swl",
-        "mcp-server-swl"
+        "mcp-server-swl",
+        "claudemd-auditor"
       ]
     }
   }