@saulwade/swl-ses 2.1.0 → 2.2.1

package/comandos/swl/configurar-ci.md

@@ -59,16 +59,14 @@ Si el usuario omite `init` e invoca con flags directos, respetar esos flags sin
 
 ### Paso 3 — Copiar workflows
 
-Invocar `scripts/lib/configurar-ci.js` con las opciones seleccionadas:
+Invocar el subcomando del CLI (resuelve cross-scope; ver
+`docs/invocacion-cli-cross-scope.md`). Imprime el resultado como JSON
+(`copiados`, `existentes`, `error`):
 
-```javascript
-const { init } = require('./scripts/lib/configurar-ci');
-const resultado = init({
-  withSecurity: true,
-  withCi: true,
-  withReleasePlease: false,
-  // dryRun: true,  // con --dry-run
-});
+```bash
+swl-ses configurar-ci init
+# flags: --no-security  --no-ci  --with-release-please  --dry-run  --force
+# fallback: npx -y @saulwade/swl-ses@latest configurar-ci init
 ```
 
 Si hay archivos existentes en `resultado.existentes`, preguntar:
@@ -78,7 +76,7 @@ Los siguientes workflows ya existen en .github/workflows/:
 ¿Sobreescribir? (s/N)
 ```
 
-Si el usuario dice que sí, volver a llamar `init` con `force: true`.
+Si el usuario dice que sí, volver a llamar el subcomando con `--force`.
 
 ### Paso 4 — Configurar CLAUDE_API_KEY (solo si se instaló swl-security.yml)
 
@@ -152,14 +150,15 @@ Próximos pasos:
 
 ## /swl:configurar-ci status
 
-Muestra el estado actual de los workflows SWL en el proyecto.
+Muestra el estado actual de los workflows SWL en el proyecto. Subcomando del CLI
+(salida JSON con `instalados`, `faltantes`, `secretsFaltantes`):
 
-```javascript
-const { status } = require('./scripts/lib/configurar-ci');
-const resultado = status();
+```bash
+swl-ses configurar-ci status
+# fallback: npx -y @saulwade/swl-ses@latest configurar-ci status
 ```
 
-Formato de salida:
+Formato de salida (presentar al usuario a partir del JSON):
 
 ```
 Workflows SWL en .github/workflows/:
@@ -187,11 +186,13 @@ gh secret list 2>/dev/null | grep CLAUDE_API_KEY
 
 Elimina los workflows gestionados por swl-ses. No toca branch protection ni otros workflows.
 
-```javascript
-const { uninstall } = require('./scripts/lib/configurar-ci');
+Subcomando del CLI (salida JSON). Primero listar qué se eliminaría (sin
+confirmar), luego repetir con `--confirmar`:
 
-// Primero listar qué se eliminaría (sin confirmar)
-const plan = uninstall({ confirmar: false });
+```bash
+swl-ses configurar-ci uninstall            # plan (confirmar: false)
+swl-ses configurar-ci uninstall --confirmar  # ejecuta la eliminación
+# fallback: npx -y @saulwade/swl-ses@latest configurar-ci uninstall [--confirmar]
 ```
 
 Mostrar:

package/comandos/swl/cron.md

@@ -160,21 +160,19 @@ deliverResult(job, result, process.cwd());
 
 ## Parser de lenguaje natural programático (experimental)
 
-El módulo `scripts/lib/schedule-parser.js` proporciona parseo programático de
-frases en inglés a expresiones cron, disponible para scripts y extensiones del
-comando. No requiere dependencias externas.
+El subcomando `swl-ses schedule-parse` parsea frases en inglés a expresiones
+cron (resuelve cross-scope; ver `docs/invocacion-cli-cross-scope.md`). No
+requiere dependencias externas.
 
-Uso desde Node.js:
-```javascript
-const { parseNaturalSchedule, isCronDue } = require('./scripts/lib/schedule-parser');
-
-// "every morning at 9am" → { cron: '0 9 * * *', descripcion: 'Diariamente a las 9:00 AM' }
-const resultado = parseNaturalSchedule('every morning at 9am');
-
-// Verificar si una expresión cron debe ejecutarse ahora
-const pendiente = isCronDue('0 9 * * *', Date.now(), ultimaEjecucionMs);
+```bash
+# "every morning at 9am" → { "cron": "0 9 * * *", "descripcion": "Diariamente a las 9 AM" }
+swl-ses schedule-parse "every morning at 9am"
+# fallback: npx -y @saulwade/swl-ses@latest schedule-parse "every morning at 9am"
 ```
 
+La verificación de si un cron debe ejecutarse ahora (`isCronDue`) la usa el
+motor de scheduling internamente; no se expone como subcomando.
+
 Frases reconocidas:
 - `"hourly"` → `0 * * * *`
 - `"daily"` / `"every day"` → `0 9 * * *`

package/comandos/swl/ejecutar-fase.md

@@ -2,17 +2,19 @@
 name: swl:ejecutar-fase
 description: Recibe el número de una fase y la implementa siguiendo el PLAN.md. Delega al agente implementador-swl, hace commits atómicos por slice, produce RESUMEN.md y actualiza ESTADO.md y HOJA-RUTA.md al terminar.
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
-evolved: true
-evolved-from: "1.6.8"
-evolved-at: "2026-05-22"
-evolved-by: "aprender"
-evolved-note: "Paso 4.2 — cota dura 30k tokens al prompt del sub-agente para prevenir autocompact thrashing (origen SIGAF 2026-05-22)"
 ---
 
 # /swl:ejecutar-fase <n> [--iterative] — Ejecutar implementación de una fase
 
 Eres el coordinador de ejecución SWL. Orquestas la implementación real del código para una fase, delegando al agente implementador-swl, verificando cada slice y manteniendo el estado del proyecto actualizado.
 
+> **Invocación cross-scope** (ver `@docs/invocacion-cli-cross-scope.md`): los
+> gates G0/G1 y el anexo propositivo viven en subcomandos del CLI. Usa la forma
+> `swl-ses <sub>`; si estás en el repo madre usa `node scripts/cli/<sub>.js`; si
+> no hay bin en PATH, `npx -y @saulwade/swl-ses@latest <sub>`. NUNCA invoques
+> `node -e "require('./scripts/lib/...')"` ni `node hooks/lib/...` con ruta
+> relativa al proyecto — no existen downstream.
+
 ## Uso
 
 ```
@@ -83,7 +85,7 @@ Verifica en orden:
 6. **Gate G1 — verificación de integridad del plan firmado**: tras confirmar
    `estado: aprobado`, recomputa el hash del PLAN y compáralo contra su lock:
    ```bash
-   node -e "const {verificarPlan}=require('./scripts/lib/plan-lock'); console.log(JSON.stringify(verificarPlan('.planning/fases/0N-PLAN.md')))"
+   swl-ses verificar-plan --fase=N
    ```
    Interpreta el resultado:
    - `ok: true, modo: "firmado"` → el plan no fue mutado tras su aprobación.
@@ -168,7 +170,7 @@ Según tipo de error:
 Al completar todos los slices, genera `.planning/fases/0N-RESUMEN.md` con: slices implementados (commits, archivos), resultados de tests, desviaciones del plan, decisiones técnicas, deuda técnica, estado final, criterios de aceptación verificados, próximos pasos.
 
 **Anexo propositivo (Fase 13, ADR-0037)**: antes de cerrar, ejecuta el propose-step
-sobre el diff de la fase (`node hooks/lib/propose-step.js --rango=<base>..HEAD`) e
+sobre el diff de la fase (`swl-ses propose-step --rango=<base>..HEAD`) e
 incluye una sección "Anexo propositivo" en el RESUMEN.md **solo si hay ≥1 señal** de
 adyacencia (auth/PII/pagos, migración de schema). Si no hay señal, omite la sección
 (silencio, no sección vacía). El anexo propone, nunca bloquea. Opt-out `SWL_PROPOSE=0`.
@@ -182,7 +184,7 @@ la fase ya no está en ejecución y `hooks/spec-gate.js` debe volver a advertir
 escribe código sin una nueva fase aprobada:
 
 ```bash
-node -e "const fs=require('fs'); const p='.planning/locks/fase-activa.json'; if(fs.existsSync(p)){fs.unlinkSync(p); console.log('fase activa liberada')} else {console.log('sin fase activa que liberar')}"
+swl-ses liberar-fase
 ```
 
 NO eliminar el `.lock` del plan (`0N-PLAN.md.lock`) — ese es evidencia de

package/comandos/swl/evolucionar.md

@@ -134,19 +134,14 @@ Aplica siguiendo las reglas de governance y safety checks del skill:
 
 Respeta la governance: PARCHE auto-aplicable, MENOR requiere revisión, MAYOR requiere aprobación humana. Modificar agentes siempre requiere aprobación humana.
 
-**OBLIGATORIO — Marcar como evolucionado ejecutando este comando Bash**:
+**OBLIGATORIO — Marcar como evolucionado** con el subcomando del CLI (resuelve
+cross-scope; ver `docs/invocacion-cli-cross-scope.md`):
 
 ```bash
-node -e "
-const { markAsEvolved } = require('./hooks/lib/evolution-tracker');
-const pkg = require('./package.json');
-const r = markAsEvolved('[RUTA_ARCHIVO_MODIFICADO]', {
-  from: pkg.version,
-  by: 'evolucionar',
-  note: '[descripción breve del cambio]'
-});
-console.log(r.marked ? 'Marcado como evolucionado' : 'Error: ' + r.error);
-"
+swl-ses mark-evolved "[RUTA_ARCHIVO_MODIFICADO]" \
+  --by=evolucionar \
+  --note="[descripción breve del cambio]"
+# fallback: npx -y @saulwade/swl-ses@latest mark-evolved "[RUTA]" --by=evolucionar --note="..."
 ```
 
 Reemplazar los placeholders entre corchetes con los valores reales.

package/comandos/swl/inbox.md

@@ -58,16 +58,16 @@ node -e "const R = require('./gateway/command-relay'); const fs = require('fs');
 
 ### Paso 4 — Notificar de vuelta al usuario (opcional)
 
-Si el comando merece respuesta al canal origen (Telegram, Discord), encolar un `gateway_notification`:
-
-```javascript
-const { notificarGateway } = require('./hooks/lib/gateway-notify');
-notificarGateway({
-  tipo: 'custom',
-  texto: '✅ Comando procesado: <resumen>',
-  to: 'telegram',  // o el adaptador de donde vino
-  payload: { replyTo: '<chatId>' }
-});
+Si el comando merece respuesta al canal origen (Telegram, Discord), encolar un
+`gateway_notification` con el subcomando del CLI (resuelve cross-scope; ver
+`docs/invocacion-cli-cross-scope.md`):
+
+```bash
+swl-ses gateway-notify \
+  --texto="✅ Comando procesado: <resumen>" \
+  --to=telegram \
+  --reply-to="<chatId>"
+# fallback: npx -y @saulwade/swl-ses@latest gateway-notify --texto="..." --to=telegram --reply-to="<chatId>"
 ```
 
 ### Paso 5 — Auditar

package/comandos/swl/modelo.md

@@ -35,19 +35,17 @@ Si el usuario pasó una descripción entre comillas, usar esa descripción direc
 
 ## Paso 2 — Evaluar complejidad
 
-Cargar la lógica de evaluación usando el módulo `hooks/lib/model-router.js`.
+Evaluar la complejidad con el subcomando del CLI (resuelve cross-scope: repo
+madre / `swl-ses` en PATH / `npx`; ver `docs/invocacion-cli-cross-scope.md`):
 
 ```bash
-node -e "
-const { sugerirModelo } = require('./hooks/lib/model-router.js');
-const desc = process.argv[1] || '';
-const result = sugerirModelo(desc);
-console.log(JSON.stringify(result, null, 2));
-" "DESCRIPCIÓN_DE_LA_TAREA"
+swl-ses sugerir-modelo "DESCRIPCIÓN_DE_LA_TAREA"
+# fallback si swl-ses no está en PATH:
+#   npx -y @saulwade/swl-ses@latest sugerir-modelo "DESCRIPCIÓN_DE_LA_TAREA"
 ```
 
-Si el script falla (el módulo no existe o hay error de Node), aplicar la
-tabla de routing manualmente (ver Paso 3).
+Si el subcomando falla (CLI no disponible), aplicar la tabla de routing
+manualmente (ver Paso 3).
 
 ## Paso 3 — Tabla de routing manual (fallback)
 

package/comandos/swl/notificaciones.md

@@ -191,50 +191,21 @@ Subcomandos disponibles:
 
 ### Paso 2 — Ejecutar según subcomando
 
-**Para `init`**:
+Todos los subcomandos usan el CLI cross-scope (resuelve repo madre / `swl-ses`
+en PATH / `npx`; ver `docs/invocacion-cli-cross-scope.md`). El subcomando
+encapsula el formato de salida y la detección de TTY.
 
-```bash
-node -e "
-const { init } = require('./scripts/lib/notificaciones-telegram');
-init({ esTty: true }).then(r => {
-  console.log('[resultado]', r.resultado, r.detalle || '');
-  process.exit(r.resultado === 'error' ? 1 : 0);
-}).catch(e => { console.error(e.message); process.exit(1); });
-"
-```
+**Para `init`** (requiere TTY; el subcomando detecta su ausencia y guía):
 
-Si el proceso no tiene TTY (modo no interactivo en Claude Code), detectarlo
-y mostrar instrucciones para ejecutar desde terminal:
-
-```
-Este subcomando requiere entrada interactiva (TTY).
-Ejecuta desde tu terminal:
-  node -e "require('./scripts/lib/notificaciones-telegram').init({ esTty: true })"
-O usa el instalador:
-  npx @saulwade/swl-ses@latest install
+```bash
+swl-ses notificaciones init
+# fallback: npx -y @saulwade/swl-ses@latest notificaciones init
 ```
 
 **Para `status`**:
 
 ```bash
-node -e "
-const { status } = require('./scripts/lib/notificaciones-telegram');
-const s = status();
-console.log('');
-console.log('Notificaciones Telegram — estado actual');
-console.log('  .env:             ', s.envExiste ? 'existe' : 'no existe');
-console.log('  token:            ', s.tokenConfigurado ? 'configurado' : 'no configurado');
-console.log('  chat_id:          ', s.chatIdConfigurado ? ('configurado (' + s.chatIdParcial + ')') : 'no configurado');
-const mudos = s.proyectosSilenciados.length
-  ? s.proyectosSilenciados.join(', ')
-  : 'ninguno';
-console.log('  proyectos mudos:  ', mudos);
-const botS = require('./scripts/lib/notificaciones-telegram').botStatus();
-console.log('  bot daemon:       ', botS.activo ? ('activo (PID ' + botS.pid + ')') : 'detenido');
-const autostartLabel = process.platform === 'win32' ? 'Scheduled Task' : (process.platform === 'linux' ? 'systemd --user' : 'LaunchAgent');
-console.log('  autostart:         usar /swl:notificaciones bot enable-autostart (' + autostartLabel + ')');
-console.log('');
-"
+swl-ses notificaciones status
 ```
 
 **Para `disable`**:
@@ -247,122 +218,54 @@ Antes de invocar la lib, pedir confirmación al usuario:
 
 Si responde `n` o vacío: cancelar sin tocar nada.
 
-Si responde `s`:
+Si responde `s` (agregar `--purge` para eliminar también las credenciales, tras
+confirmación adicional del usuario):
 
 ```bash
-node -e "
-const { disable } = require('./scripts/lib/notificaciones-telegram');
-const r = disable({ confirmar: true, conservarEnv: true });
-console.log('[resultado]', r.resultado, r.detalle || '');
-process.exit(r.resultado === 'error' ? 1 : 0);
-"
-```
-
-Si se pasó `--purge`, pedir confirmación adicional:
-```
-¿Eliminar también las credenciales (~/.claude/notifications/.env)? [s/N]
+swl-ses notificaciones disable            # conserva ~/.claude/notifications/.env
+swl-ses notificaciones disable --purge    # elimina también las credenciales
 ```
-Si confirma, llamar con `conservarEnv: false`.
 
 **Para `repair`**:
 
 ```bash
-node -e "
-const { repair } = require('./scripts/lib/notificaciones-telegram');
-repair().then(r => {
-  console.log('[repair]', r.resultado, r.detalle || '');
-  process.exit(r.resultado === 'error' ? 1 : 0);
-}).catch(e => { console.error(e.message); process.exit(1); });
-"
+swl-ses notificaciones repair
 ```
 
 **Para `bot start`**:
 
 ```bash
-node -e "
-const { botStart } = require('./scripts/lib/notificaciones-telegram');
-const r = botStart();
-if (r.ok) {
-  console.log('[bot]', r.mensaje || 'Bot iniciado.');
-} else {
-  console.error('[bot] Error:', r.error);
-  process.exit(1);
-}
-"
+swl-ses notificaciones bot-start
 ```
 
 **Para `bot stop`**:
 
 ```bash
-node -e "
-const { botStop } = require('./scripts/lib/notificaciones-telegram');
-const r = botStop();
-if (r.ok) {
-  console.log('[bot]', r.mensaje || 'Bot detenido.');
-} else {
-  console.error('[bot] Error:', r.error);
-  process.exit(1);
-}
-"
+swl-ses notificaciones bot-stop
 ```
 
 **Para `bot status`**:
 
 ```bash
-node -e "
-const { botStatus } = require('./scripts/lib/notificaciones-telegram');
-const r = botStatus();
-console.log('');
-console.log('Bot daemon — estado actual');
-console.log('  activo:', r.activo ? 'sí' : 'no');
-console.log('  pid:   ', r.pid !== null ? r.pid : 'n/a');
-console.log('');
-"
+swl-ses notificaciones bot-status
 ```
 
 **Para `bot restart`**:
 
 ```bash
-node -e "
-const { botRestart } = require('./scripts/lib/notificaciones-telegram');
-const r = botRestart();
-if (r.ok) {
-  console.log('[bot]', r.mensaje || 'Bot reiniciado.');
-} else {
-  console.error('[bot] Error:', r.error);
-  process.exit(1);
-}
-"
+swl-ses notificaciones bot-restart
 ```
 
 **Para `bot enable-autostart`**:
 
 ```bash
-node -e "
-const { botEnableAutostart } = require('./scripts/lib/notificaciones-telegram');
-const r = botEnableAutostart();
-if (r.ok) {
-  console.log('[autostart]', r.mensaje || 'Autostart habilitado.');
-} else {
-  console.error('[autostart] Error:', r.error);
-  process.exit(1);
-}
-"
+swl-ses notificaciones bot-enable-autostart
 ```
 
 **Para `bot disable-autostart`**:
 
 ```bash
-node -e "
-const { botDisableAutostart } = require('./scripts/lib/notificaciones-telegram');
-const r = botDisableAutostart();
-if (r.ok) {
-  console.log('[autostart]', r.mensaje || 'Autostart deshabilitado.');
-} else {
-  console.error('[autostart] Error:', r.error);
-  process.exit(1);
-}
-"
+swl-ses notificaciones bot-disable-autostart
 ```
 
 ### Paso 3 — Reportar resultado

package/comandos/swl/nuevo-proyecto.md

@@ -2,11 +2,6 @@
 name: swl:nuevo-proyecto
 description: Inicializa un proyecto nuevo desde cero. Hace preguntas al usuario, investiga el stack tecnológico y produce la estructura de planeación completa en .planning/.
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
-evolved: true
-evolved-from: "1.6.8"
-evolved-at: "2026-05-22"
-evolved-by: "aprender"
-evolved-note: "Paso 6 — validación síncrona del auditor tras generar CLAUDE.md inicial (contrato cruzado con /swl:claudemd)"
 ---
 
 # /swl:nuevo-proyecto — Inicializar proyecto nuevo
@@ -149,17 +144,17 @@ primera sección bajo el título:
 ```markdown
 ## Reglas obligatorias
 
-@reglas/usar-sistema-swl.md
+Aplica la regla global `usar-sistema-swl.md` (matriz operacional del sistema
+SWL), auto-cargada desde `.claude/rules/`. NO duplicar su contenido aquí.
 ```
 
-Esta referencia carga la matriz operacional del sistema SWL al inicio de cada
-sesión del proyecto y previene que el agente haga trabajo directo cuando
-existe un componente especializado. Sin ella, el proyecto pierde el contrato
-de uso del sistema SWL.
+Esta mención recuerda la matriz operacional del sistema SWL sin @-include. NO
+usar `@reglas/usar-sistema-swl.md`: la regla se auto-carga desde `.claude/rules/`
+y un `@reglas/...` se rompe en proyectos downstream (ahí no existe `reglas/`).
 
-Si ya existe `CLAUDE.md` (verificado en Paso 1), revisar que incluya
-`@reglas/usar-sistema-swl.md` en la sección de reglas obligatorias. Si NO
-lo incluye, agregarlo en este paso preservando el resto del contenido.
+Si ya existe `CLAUDE.md` (verificado en Paso 1), revisar que mencione la regla
+global `usar-sistema-swl`. Si NO la menciona, agregar la sección preservando el
+resto del contenido.
 
 ### Validación síncrona post-generación (contrato cruzado con /swl:claudemd)
 
@@ -167,7 +162,7 @@ Tras generar el `CLAUDE.md` inicial, ejecutar el auditor síncrono para
 verificar el contrato canónico desde el primer commit:
 
 ```bash
-node scripts/auditar-claudemd.js --json
+swl-ses audit-claudemd --json
 # Fallback:
 npx -y @saulwade/swl-ses@latest audit-claudemd --json
 ```

package/comandos/swl/release.md

@@ -2,11 +2,6 @@
 name: swl:release
 description: Gestión del ciclo de release del proyecto. Genera versión siguiendo SemVer, crea changelog automático desde commits con Conventional Commits, valida que los tests pasan, crea tag de git y genera release notes. Flags: --tipo=patch|minor|major, --dry-run, --skip-tests.
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
-evolved: true
-evolved-from: "5.10.5"
-evolved-at: "2026-04-20"
-evolved-by: "aprender"
-evolved-note: "Paso 10 integra scripts/verificar-release.js como gate anti-gap obligatoria tras 3 releases consecutivos donde el release-manager-swl omitio archivos"
 ---
 
 # /swl:release — Gestión del ciclo de release
@@ -172,6 +167,25 @@ drift silencioso entre releases. Si el lock no cambió respecto al anterior,
 el commit lo refleja como no-op (idempotente). El archivo es pequeño (~37KB)
 y debe versionarse.
 
+## Paso 6.6 — Regenerar canonical-hashes.json (baseline del discriminador A/B)
+
+Regenerar el manifiesto de hashes canónicos para la versión nueva. Es la baseline
+que el instalador usa (Fase 16) para distinguir evolución del usuario (merge) de
+shipped-evolved (actualizable) en cada upgrade. Debe incluir la versión que se
+publica para que clientes que evolucionen desde ella se clasifiquen bien.
+
+```bash
+node scripts/generar-canonical-hashes.js
+git add manifiestos/canonical-hashes.json
+```
+
+Idempotente (no-op si no cambió). El gate `node scripts/verificar-release.js`
+(Paso 10.1) verifica que el manifiesto esté al día y que el fuente no porte
+marcadores `evolved` espurios — si falla, ejecutar
+`node scripts/verificar-evolucion.js --gate-inverso --fix`. El test e2e
+`tests/scripts/release-e2e-evolved.test.js` (en `npm test`) bloquea el release
+si la propagación A/B regresa.
+
 ## Paso 7 — Generar CHANGELOG
 
 Desde v1.6.5 este paso usa el skill `changelog-generator` para parsear

package/comandos/swl/revisar-impacto.md

@@ -2,11 +2,6 @@
 name: swl:revisar-impacto
 description: Analiza el impacto estructural de cambios usando el grafo de dependencias SWL. Proporciona blast radius topológico real, god nodes, comunidades y conexiones sorpresivas. Potenciado por graph-builder.py + graph-analyze.py (graphify-3 patterns).
 allowed_tools: ["Bash", "Read"]
-evolved: true
-evolved-from: "5.3.4"
-evolved-at: "2026-04-09"
-evolved-by: "graphify-integration"
-evolved-note: "Análisis topológico real con networkx — graph-builder + graph-analyze + graph-cluster"
 ---
 
 # /swl:revisar-impacto — Análisis de impacto estructural