@saulwade/swl-ses 2.0.0 → 2.2.0

package/comandos/swl/discutir-fase.md

@@ -218,16 +218,19 @@ Estructura del archivo:
 [descripción de pantallas]
 
 ## Criterios de aceptación (REQ)
-[criterios binarios y verificables con ID estable REQ-NN — trazabilidad G4:
-- **REQ-01**: [criterio binario verificable]
-- **REQ-02**: [criterio binario verificable]
+[criterios binarios y verificables con ID estable namespaceado por fase
+`REQ-<fase>-NN` (DT-IDS-NAMESPACE, fases ≥12) — trazabilidad G4:
+- **REQ-12-01**: [criterio binario verificable]
+- **REQ-12-02**: [criterio binario verificable]
+Las fases 01-11 conservan el formato plano `REQ-NN` (gracia legacy permanente,
+no se renumeran). `verificar-trazabilidad.js` acepta ambos formatos.
 Un REQ emitido NUNCA se renumera ni se reusa: si un criterio se descarta, marcarlo
 "RETIRADO — razón" conservando el número. planear-fase exige que cada tarea T-NN
 declare qué REQ verifica (matriz REQ×T) y aprobar-plan rechaza planes con REQ
 huérfanos. verificar-trazabilidad.js valida la cadena REQ→T→commit→test al cierre.
 Método de verificación: por default cada REQ exige un test con marker
-`verifica: REQ-NN`; los REQ satisfechos por prosa/docs/configuración llevan la
-anotación `(verificación: inspección)` en el criterio — exigen tarea y commit
+`verifica: REQ-<fase>-NN`; los REQ satisfechos por prosa/docs/configuración llevan
+la anotación `(verificación: inspección)` en el criterio — exigen tarea y commit
 pero no test automatizado.]
 
 ## Riesgos identificados

package/comandos/swl/ejecutar-fase.md

@@ -13,6 +13,13 @@ evolved-note: "Paso 4.2 — cota dura 30k tokens al prompt del sub-agente para p
 
 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 +90,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.
@@ -167,6 +174,12 @@ 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 (`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`.
+
 ## Paso 7 — Actualización de HOJA-RUTA.md y ESTADO.md
 
 Marca fase completada en HOJA-RUTA.md con fecha. Actualiza ESTADO.md con estado general.
@@ -176,7 +189,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