@saulwade/swl-ses 2.5.3 → 2.6.0

package/agentes/auto-evolucion-swl.md

@@ -15,7 +15,7 @@ modeloAlterno: haiku
 ventanaContexto: 200k
 permissionMode: acceptEdits
 color: gold
-version: 1.6.0
+version: 1.6.1
 nivelRiesgo: ALTO
 skillsInvocables: [auto-evolucion-protocolo, aprendizaje-continuo, validacion-ci-sistema, extractor-de-aprendizajes, autoresearch, evaluacion-agentes, seguridad-skills-ia]
 skillsRestringidos: [fastapi-python, angular-component, django-expert, postgresql-table-design]
@@ -173,17 +173,41 @@ probablemente no resolverá el problema observado. El `score_after` caerá y el
 gate revertirá. Deja claro en la hipótesis por qué el cambio aborda el tipo de
 fallo reportado.
 
+### Cierre del nudge atendido (obligatorio)
+
+Al terminar una evolución disparada por un nudge, márcalo como accionado con
+`swl-ses nudge-accionar <id> --por auto-evolucion-swl` (el `id` viene en el
+JSONL del nudge). Sin este cierre, `session-briefing` seguirá reportándolo
+como pendiente y el escalamiento a alerta persistente contará ruido.
+
 ### Formato de hipótesis a registrar en `evoluciones.jsonl`
 
 Al llamar a `run-skill-evals.js --record-baseline` y `--record-after`, usa
-`--hypothesis=` con un enunciado causal explícito:
+`--hypothesis=` con un enunciado causal explícito.
+
+**Anti-gaming (obligatorio — regla `seguridad-agentes.md § Anti-gaming`)**:
+NUNCA declares tú el score de `--record-after`. El score que aprueba una
+evolución debe venir del artefacto de evaluación con procedencia que emite
+`/swl:evaluar-skill` (actor independiente). El flujo correcto:
 
 ```bash
-node scripts/run-skill-evals.js TU_TARGET --record-after --score=87 \
+# 1. Evaluación INDEPENDIENTE del target (no la corres tú sobre tu propio
+#    cambio — la ejecuta /swl:evaluar-skill, que emite el artefacto):
+#    /swl:evaluar-skill TU_TARGET
+#    → escribe .planning/evolution/evaluaciones/TU_TARGET.json
+
+# 2. Registro del after: el score se LEE del artefacto (sin --score):
+node scripts/run-skill-evals.js TU_TARGET --record-after \
   --hypothesis="reforce seccion OUTPUT con template explicito; esperaba reducir bad_output_format" \
   --check-invariants
 ```
 
+`--record-after` FALLA (exit 8) si el artefacto no existe, está vencido
+(>7 días) o declara `producido_por` igual al target; y FALLA (exit 9) si
+pasas un `--score` que discrepa del artefacto. El evento en
+`evoluciones.jsonl` registra `producido_por`, `evaluacion_path` y
+`evaluacion_fecha` — la cadena de procedencia que audita `validar.js`.
+
 El texto de la hipótesis queda en el log y será consultado después por
 `/swl:status evolucion` y por la consolidación de aprendizajes.
 

package/bin/swl-ses.js

@@ -106,8 +106,8 @@ const COMANDOS = {
   doctor: '../scripts/doctor.js',
   update: '../scripts/actualizar.js',
   uninstall: '../scripts/desinstalar.js',
-  prune: '../scripts/prune.js',
-  valor: '../scripts/evidencia-valor.js',
+  prune: '../scripts/prune.js',
+  valor: '../scripts/evidencia-valor.js',
   'field-report': '../scripts/field-report.js',
   'check-update': '../scripts/check-update.js',
   'install-git-hook': '../scripts/instalar-git-hook.js',
@@ -141,7 +141,14 @@ const COMANDOS = {
   'loop-telemetry': '../scripts/cli/loop-telemetry.js',
   'configurar-ci': '../scripts/cli/configurar-ci.js',
   'ciclo-evolucion': '../scripts/cli/ciclo-evolucion.js',
+  'ciclo-autonomo': '../scripts/cli/ciclo-autonomo.js',
+  'ciclo-fase-b': '../scripts/cli/ciclo-fase-b.js',
   notificaciones: '../scripts/cli/notificaciones.js',
+  autonomia: '../scripts/cli/autonomia.js',
+  'memoria-search': '../scripts/cli/memoria-search.js',
+  'guardrail-metrics': '../scripts/cli/guardrail-metrics.js',
+  'run-eval': '../scripts/cli/run-eval.js',
+  'benchmark-memoria': '../scripts/cli/benchmark-memoria.js',
 };
 
 // Comandos con subcomandos (nivel 2)
@@ -164,9 +171,9 @@ COMANDOS PRINCIPALES:
   doctor                        Diagnóstica problemas de instalación
   update                        Actualiza componentes instalados
   uninstall                     Desinstala componentes del runtime
-  prune                         Purga componentes retirados del paquete (dry-run; --confirmar ejecuta)
-  valor                         Panel de evidencia de valor del harness (intercepciones, defectos, DORA/CI, uso; --json, --dias N)
-  install --solo-hooks          Activa hooks (telemetría) a nivel proyecto apuntando al scope global — sin duplicar componentes en la UI
+  prune                         Purga componentes retirados del paquete (dry-run; --confirmar ejecuta)
+  valor                         Panel de evidencia de valor del harness (intercepciones, defectos, DORA/CI, uso; --json, --dias N)
+  install --solo-hooks          Activa hooks (telemetría) a nivel proyecto apuntando al scope global — sin duplicar componentes en la UI
   field-report                  Reporte de agregados anónimos para compartir con el autor (opt-in, revisión manual)
   check-update                  Fuerza consulta inmediata de nueva versión en npm (sin throttle)
   install-git-hook [--force]    Instala pre-commit hook que avisa de nuevas versiones.
@@ -244,9 +251,26 @@ COMANDOS PRINCIPALES:
                                 Usado por /swl:configurar-ci.
   ciclo-evolucion               Regenera .planning/evolution/metricas.json.
                                 Usado por /swl:status.
+  ciclo-autonomo [on|off|status] Motor determinista de aprendizaje (Fase A,
+                                ADR-0041). Nace encendido; off = kill-switch.
+                                Usado por /swl:evolucion-continua.
+  ciclo-fase-b [--dry-run|status] Runner headless de Fase B (ADR-0042 gate
+                                G-B). En esta versión siempre dry-run.
+  nudge-accionar <id> [--por X] Marca un nudge como accionado (cierra el
+                                ciclo). Usado por /swl:aprender y /swl:evolucionar.
   notificaciones <op>           Telegram: init|status|disable|repair|bot-start|
                                 bot-stop|bot-status|bot-restart|bot-enable-autostart|
                                 bot-disable-autostart. Usado por /swl:notificaciones.
+  autonomia --accion="..."      Registra auto-checkpoint según el dial de
+                                autonomía. Usado por ejecutar-fase.
+  memoria-search <op>           Búsqueda en memoria del proyecto: search|timeline|
+                                fetch (JSON). Usado por memoria-busqueda.
+  guardrail-metrics [--json]    Métricas + diagnóstico de guardrails de la sesión.
+                                Usado por /swl:status (dashboard).
+  run-eval <eval.json>          Ejecuta un eval del framework de validación de
+                                outputs. --rebuild-aggregate reconstruye métricas.
+  benchmark-memoria [--json]    Benchmark de retrieval de memoria (--dataset,
+                                --limit, --verbose).
   info    [--target <runtime>]  Muestra información del sistema instalado
   help                          Muestra esta ayuda (alias de --help)
   list    [--target <runtime>]  Lista todos los agentes y skills instalados
@@ -263,8 +287,9 @@ OPCIONES DE INSTALL:
   --target <runtime>     Runtime destino: claude|openclaude|copilot|opencode|codex|gemini|cursor (default: claude)
   --profile <perfil>     Perfil: core|backend-python|backend-node|frontend-react|frontend-angular|
                          fullstack-python-angular|fullstack-node-react|mobile|devops|completo (default: completo)
-  --with <componentes>   Incluir componentes adicionales (separados por coma)
-  --without <comps>      Excluir componentes (separados por coma)
+  --with <modulos>       Incluir módulos adicionales, incluidos los opt-in fuera de todo perfil
+                         (p. ej. reglas-personales). Quedan en el install-state y update los preserva
+  --without <modulos>    Excluir módulos (separados por coma; también quita extras preservados)
   --global               Instalar en directorio global del runtime (~/.claude, etc.)
   --local                Instalar en directorio local del proyecto (.claude/, etc.)
   --dry-run              Mostrar plan sin aplicar cambios

package/comandos/swl/actualizar.md

@@ -1,174 +1,174 @@
----
-name: swl:actualizar
-description: Actualiza el sistema SWL a la última versión disponible. Detecta automáticamente el perfil instalado y re-instala con --force preservando la configuración del usuario. No requiere desinstalar primero.
-allowed_tools: ["Read", "Bash", "Glob"]
----
-
-# /swl:actualizar — Actualizar sistema SWL
-
-Eres el actualizador del sistema SWL dentro de Claude Code. Tu misión es actualizar los componentes instalados a la última versión disponible sin perder la configuración del usuario ni requerir desinstalación previa.
-
-## Cuándo usar este comando
-
-- Cuando se publicó una nueva versión del sistema SWL y quieres obtener las mejoras
-- Después de que `/swl:status salud` reporta que la versión instalada está desactualizada
-- Cuando otro miembro del equipo indica que hay actualización disponible
-- Para re-instalar el mismo perfil después de modificaciones manuales que dejaron el sistema inconsistente
-
-No usar si SWL no está instalado — en ese caso usar `/swl:instalar`.
-
-## Paso 0 — Verificar que SWL está instalado
-
-```bash
-cat .claude/.swl-install-state.json 2>/dev/null
-```
-
-Si NO existe archivo de estado:
-- Informa: "No se encontró una instalación de SWL en este proyecto."
-- Sugiere: "Usa `/swl:instalar` para instalar SWL por primera vez."
-- DETENTE.
-
-Si existe, extrae:
-- `perfil`: el perfil actualmente instalado
-- `versionSistema`: la versión instalada
-- `global`: si fue instalación global
-- `archivosInstalados`: cantidad de archivos
-
-Informa al usuario:
-```
-SWL instalado:
-  Versión:  <versionSistema>
-  Perfil:   <perfil>
-  Archivos: <N>
-  Tipo:     <local|global>
-```
-
-## Paso 1 — Verificar versión disponible
-
-```bash
-npm view @saulwade/swl-ses version 2>/dev/null \
-  || npm view @saul-wade/swl-ses version --registry=https://npm.pkg.github.com 2>/dev/null
-```
-
-Si hay una versión más nueva, informa:
-- "Versión instalada: **X**. Versión disponible: **Y**."
-
-Si ya está en la última versión:
-- "Ya tienes la última versión (**X**). ¿Deseas re-instalar de todos modos?"
-- Si el usuario dice no, DETENTE.
-
-## Paso 1.5 — Descubrimiento de features nuevas
-
-Cuando hay una versión nueva disponible, mostrar qué cambió entre la versión
-instalada y la disponible para que el usuario tome una decisión informada.
-
-```bash
-# Obtener changelog entre versiones (si está disponible localmente o via npm)
-CURRENT="<version_instalada>"
-AVAILABLE="<version_disponible>"
-
-# Opción 1: Si el repo SWL está disponible como referencia
-if [ -f "CHANGELOG.md" ]; then
-  # Extraer entradas del changelog entre las dos versiones
-  sed -n "/## \[$AVAILABLE\]/,/## \[$CURRENT\]/p" CHANGELOG.md | head -50
-fi
-```
-
-Presentar al usuario un resumen categorizado:
-
-```
-=== Novedades entre v<CURRENT> y v<AVAILABLE> ===
-
-📦 Componentes nuevos:
-  - [agentes/skills/hooks/comandos nuevos]
-
-🔧 Mejoras:
-  - [mejoras a componentes existentes]
-
-🐛 Correcciones:
-  - [bugs corregidos]
-
-⚠ Cambios que requieren atención:
-  - [breaking changes o migraciones necesarias]
-  - [reglas nuevas obligatorias]
-  - [hooks nuevos que podrían afectar el flujo]
-
-💡 Guía de migración:
-  - [Si hay cambios breaking, pasos concretos para adaptar el proyecto]
-  - [Si hay hooks nuevos, cómo configurarlos]
-```
-
-Si no se puede obtener el changelog, informar:
-```
-No se pudo obtener el detalle de cambios entre versiones.
-Consulta el CHANGELOG.md del repositorio SWL para ver las novedades.
-```
-
-## Paso 2 — Confirmar actualización
-
-```
-=== Actualización SWL ===
-
-Versión actual:     <version instalada>
-Versión disponible: <version nueva>
-Perfil:             <perfil>
-Tipo:               <local|global>
-
-La actualización:
-  - Sobrescribe agentes, skills, comandos, reglas y hooks
-  - Actualiza hooks en settings.json
-  - Preserva _userland/ (extensiones del usuario)
-  - Preserva .planning/ (estado del proyecto)
-
-¿Proceder?
-```
-
-Espera confirmación del usuario.
-
-## Paso 3 — Ejecutar actualización
-
-```bash
-npx @saulwade/swl-ses@latest install --target claude --profile <PERFIL> [--global] --force
-```
-
-Usa el mismo perfil y ubicación de la instalación original.
-
-## Paso 4 — Ejecutar doctor
-
-```bash
-npx @saulwade/swl-ses@latest doctor
-```
-
-## Paso 5 — Reportar resultado
-
-```
-=== Actualización SWL completada ===
-
-Versión anterior: <X>
-Versión nueva:    <Y>
-Perfil:           <perfil>
-Archivos:         <N> actualizados
-
-Doctor: <resultado>
-```
-
-## Cambio de perfil durante actualización
-
-Si el usuario dice algo como "actualiza y cambia a perfil completo", ejecuta:
-
-```bash
-npx @saulwade/swl-ses@latest install --target claude --profile <NUEVO_PERFIL> [--global] --force
-```
-
-Informa que el cambio de perfil puede agregar componentes nuevos pero no elimina los del perfil anterior. Si quiere una instalación limpia con otro perfil, sugiere:
-1. `npx swl-ses uninstall --target claude`
-2. `/swl:instalar` con el nuevo perfil
-
-## Reglas de comportamiento
-
-- SIEMPRE verifica que SWL está instalado antes de intentar actualizar.
-- SIEMPRE muestra versión actual vs disponible.
-- SIEMPRE confirma antes de ejecutar.
-- NUNCA cambia el perfil sin que el usuario lo pida explícitamente.
-- Preserva `_userland/` y `.planning/` siempre.
-- Si la actualización falla, el sistema queda en el estado anterior (los archivos existentes no se borran antes de copiar los nuevos).
+---
+name: swl:actualizar
+description: Actualiza el sistema SWL a la última versión disponible. Detecta automáticamente el perfil instalado y re-instala con --force preservando la configuración del usuario. No requiere desinstalar primero.
+allowed_tools: ["Read", "Bash", "Glob"]
+---
+
+# /swl:actualizar — Actualizar sistema SWL
+
+Eres el actualizador del sistema SWL dentro de Claude Code. Tu misión es actualizar los componentes instalados a la última versión disponible sin perder la configuración del usuario ni requerir desinstalación previa.
+
+## Cuándo usar este comando
+
+- Cuando se publicó una nueva versión del sistema SWL y quieres obtener las mejoras
+- Después de que `/swl:status salud` reporta que la versión instalada está desactualizada
+- Cuando otro miembro del equipo indica que hay actualización disponible
+- Para re-instalar el mismo perfil después de modificaciones manuales que dejaron el sistema inconsistente
+
+No usar si SWL no está instalado — en ese caso usar `/swl:instalar`.
+
+## Paso 0 — Verificar que SWL está instalado
+
+```bash
+cat .claude/.swl-install-state.json 2>/dev/null
+```
+
+Si NO existe archivo de estado:
+- Informa: "No se encontró una instalación de SWL en este proyecto."
+- Sugiere: "Usa `/swl:instalar` para instalar SWL por primera vez."
+- DETENTE.
+
+Si existe, extrae:
+- `perfil`: el perfil actualmente instalado
+- `versionSistema`: la versión instalada
+- `global`: si fue instalación global
+- `archivosInstalados`: cantidad de archivos
+
+Informa al usuario:
+```
+SWL instalado:
+  Versión:  <versionSistema>
+  Perfil:   <perfil>
+  Archivos: <N>
+  Tipo:     <local|global>
+```
+
+## Paso 1 — Verificar versión disponible
+
+```bash
+npm view @saulwade/swl-ses version 2>/dev/null \
+  || npm view @saul-wade/swl-ses version --registry=https://npm.pkg.github.com 2>/dev/null
+```
+
+Si hay una versión más nueva, informa:
+- "Versión instalada: **X**. Versión disponible: **Y**."
+
+Si ya está en la última versión:
+- "Ya tienes la última versión (**X**). ¿Deseas re-instalar de todos modos?"
+- Si el usuario dice no, DETENTE.
+
+## Paso 1.5 — Descubrimiento de features nuevas
+
+Cuando hay una versión nueva disponible, mostrar qué cambió entre la versión
+instalada y la disponible para que el usuario tome una decisión informada.
+
+```bash
+# Obtener changelog entre versiones (si está disponible localmente o via npm)
+CURRENT="<version_instalada>"
+AVAILABLE="<version_disponible>"
+
+# Opción 1: Si el repo SWL está disponible como referencia
+if [ -f "CHANGELOG.md" ]; then
+  # Extraer entradas del changelog entre las dos versiones
+  sed -n "/## \[$AVAILABLE\]/,/## \[$CURRENT\]/p" CHANGELOG.md | head -50
+fi
+```
+
+Presentar al usuario un resumen categorizado:
+
+```
+=== Novedades entre v<CURRENT> y v<AVAILABLE> ===
+
+📦 Componentes nuevos:
+  - [agentes/skills/hooks/comandos nuevos]
+
+🔧 Mejoras:
+  - [mejoras a componentes existentes]
+
+🐛 Correcciones:
+  - [bugs corregidos]
+
+⚠ Cambios que requieren atención:
+  - [breaking changes o migraciones necesarias]
+  - [reglas nuevas obligatorias]
+  - [hooks nuevos que podrían afectar el flujo]
+
+💡 Guía de migración:
+  - [Si hay cambios breaking, pasos concretos para adaptar el proyecto]
+  - [Si hay hooks nuevos, cómo configurarlos]
+```
+
+Si no se puede obtener el changelog, informar:
+```
+No se pudo obtener el detalle de cambios entre versiones.
+Consulta el CHANGELOG.md del repositorio SWL para ver las novedades.
+```
+
+## Paso 2 — Confirmar actualización
+
+```
+=== Actualización SWL ===
+
+Versión actual:     <version instalada>
+Versión disponible: <version nueva>
+Perfil:             <perfil>
+Tipo:               <local|global>
+
+La actualización:
+  - Sobrescribe agentes, skills, comandos, reglas y hooks
+  - Actualiza hooks en settings.json
+  - Preserva _userland/ (extensiones del usuario)
+  - Preserva .planning/ (estado del proyecto)
+
+¿Proceder?
+```
+
+Espera confirmación del usuario.
+
+## Paso 3 — Ejecutar actualización
+
+```bash
+npx -y @saulwade/swl-ses@latest install --target claude --profile <PERFIL> [--global] --force
+```
+
+Usa el mismo perfil y ubicación de la instalación original.
+
+## Paso 4 — Ejecutar doctor
+
+```bash
+npx -y @saulwade/swl-ses@latest doctor
+```
+
+## Paso 5 — Reportar resultado
+
+```
+=== Actualización SWL completada ===
+
+Versión anterior: <X>
+Versión nueva:    <Y>
+Perfil:           <perfil>
+Archivos:         <N> actualizados
+
+Doctor: <resultado>
+```
+
+## Cambio de perfil durante actualización
+
+Si el usuario dice algo como "actualiza y cambia a perfil completo", ejecuta:
+
+```bash
+npx -y @saulwade/swl-ses@latest install --target claude --profile <NUEVO_PERFIL> [--global] --force
+```
+
+Informa que el cambio de perfil puede agregar componentes nuevos pero no elimina los del perfil anterior. Si quiere una instalación limpia con otro perfil, sugiere:
+1. `npx swl-ses uninstall --target claude`
+2. `/swl:instalar` con el nuevo perfil
+
+## Reglas de comportamiento
+
+- SIEMPRE verifica que SWL está instalado antes de intentar actualizar.
+- SIEMPRE muestra versión actual vs disponible.
+- SIEMPRE confirma antes de ejecutar.
+- NUNCA cambia el perfil sin que el usuario lo pida explícitamente.
+- Preserva `_userland/` y `.planning/` siempre.
+- Si la actualización falla, el sistema queda en el estado anterior (los archivos existentes no se borran antes de copiar los nuevos).