@saulwade/swl-ses 2.1.0 → 2.2.0

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