@saulwade/swl-ses 2.3.0 → 2.4.1

package/scripts/cli/notificaciones.js

@@ -1,123 +1,123 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses notificaciones <op>` — gestiona las notificaciones
- * Telegram y su bot daemon. Reemplaza los inline
- * `require('./scripts/lib/notificaciones-telegram')` relativos al proyecto
- * (rotos downstream; ver docs/invocacion-cli-cross-scope.md). Encapsula también
- * el formato de salida que antes vivía en el comando.
- *
- * Ops:
- *   init                  (requiere TTY)        bot-start
- *   status                                      bot-stop
- *   disable [--purge]                           bot-status
- *   repair                                      bot-restart
- *                                               bot-enable-autostart
- *                                               bot-disable-autostart
- */
-
-const nt = require('../lib/notificaciones-telegram');
-
-function imprimirStatus() {
-  const s = nt.status();
-  const botS = nt.botStatus();
-  const autostartLabel =
-    process.platform === 'win32'
-      ? 'Scheduled Task'
-      : process.platform === 'linux'
-        ? 'systemd --user'
-        : 'LaunchAgent';
-  const mudos = s.proyectosSilenciados.length
-    ? s.proyectosSilenciados.join(', ')
-    : 'ninguno';
-  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'
-  );
-  console.log('  proyectos mudos:  ', mudos);
-  console.log('  bot daemon:       ', botS.activo ? 'activo (PID ' + botS.pid + ')' : 'detenido');
-  console.log('  autostart:         usar /swl:notificaciones bot enable-autostart (' + autostartLabel + ')');
-  console.log('');
-}
-
-function imprimirBotStatus() {
-  const r = nt.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('');
-}
-
-function reportarOk(prefijo, r, mensajeDefault) {
-  if (r.ok) {
-    console.log('[' + prefijo + ']', r.mensaje || mensajeDefault);
-  } else {
-    console.error('[' + prefijo + '] Error:', r.error);
-    process.exitCode = 1;
-  }
-}
-
-// Tabla de dispatch de los ops del bot daemon: [prefijo, fn, mensajeDefault].
-const BOT_OPS = {
-  'bot-start': ['bot', () => nt.botStart(), 'Bot iniciado.'],
-  'bot-stop': ['bot', () => nt.botStop(), 'Bot detenido.'],
-  'bot-restart': ['bot', () => nt.botRestart(), 'Bot reiniciado.'],
-  'bot-enable-autostart': ['autostart', () => nt.botEnableAutostart(), 'Autostart habilitado.'],
-  'bot-disable-autostart': ['autostart', () => nt.botDisableAutostart(), 'Autostart deshabilitado.'],
-};
-
-async function notificaciones(opciones = {}) {
-  const op = (opciones._args && opciones._args[0]) || opciones.op || 'status';
-
-  if (BOT_OPS[op]) {
-    const [prefijo, fn, msg] = BOT_OPS[op];
-    reportarOk(prefijo, fn(), msg);
-    return;
-  }
-
-  switch (op) {
-    case 'init': {
-      if (!process.stdin.isTTY) {
-        console.log('Este subcomando requiere entrada interactiva (TTY).');
-        console.log('Ejecuta desde tu terminal:');
-        console.log('  swl-ses notificaciones init');
-        console.log('O usa el instalador:');
-        console.log('  npx -y @saulwade/swl-ses@latest install');
-        return;
-      }
-      const r = await nt.init({ esTty: true });
-      console.log('[resultado]', r.resultado, r.detalle || '');
-      if (r.resultado === 'error') process.exitCode = 1;
-      return;
-    }
-    case 'status':
-      imprimirStatus();
-      return;
-    case 'disable': {
-      const r = nt.disable({ confirmar: true, conservarEnv: !opciones.purge });
-      console.log('[resultado]', r.resultado, r.detalle || '');
-      if (r.resultado === 'error') process.exitCode = 1;
-      return;
-    }
-    case 'repair': {
-      const r = await nt.repair();
-      console.log('[repair]', r.resultado, r.detalle || '');
-      if (r.resultado === 'error') process.exitCode = 1;
-      return;
-    }
-    case 'bot-status':
-      imprimirBotStatus();
-      return;
-    default:
-      console.error('Op desconocida: ' + op);
-      console.error('Ops: init|status|disable|repair|bot-start|bot-stop|bot-status|bot-restart|bot-enable-autostart|bot-disable-autostart');
-      process.exitCode = 1;
-  }
-}
-
-module.exports = notificaciones;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses notificaciones <op>` — gestiona las notificaciones
+ * Telegram y su bot daemon. Reemplaza los inline
+ * `require('./scripts/lib/notificaciones-telegram')` relativos al proyecto
+ * (rotos downstream; ver docs/invocacion-cli-cross-scope.md). Encapsula también
+ * el formato de salida que antes vivía en el comando.
+ *
+ * Ops:
+ *   init                  (requiere TTY)        bot-start
+ *   status                                      bot-stop
+ *   disable [--purge]                           bot-status
+ *   repair                                      bot-restart
+ *                                               bot-enable-autostart
+ *                                               bot-disable-autostart
+ */
+
+const nt = require('../lib/notificaciones-telegram');
+
+function imprimirStatus() {
+  const s = nt.status();
+  const botS = nt.botStatus();
+  const autostartLabel =
+    process.platform === 'win32'
+      ? 'Scheduled Task'
+      : process.platform === 'linux'
+        ? 'systemd --user'
+        : 'LaunchAgent';
+  const mudos = s.proyectosSilenciados.length
+    ? s.proyectosSilenciados.join(', ')
+    : 'ninguno';
+  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'
+  );
+  console.log('  proyectos mudos:  ', mudos);
+  console.log('  bot daemon:       ', botS.activo ? 'activo (PID ' + botS.pid + ')' : 'detenido');
+  console.log('  autostart:         usar /swl:notificaciones bot enable-autostart (' + autostartLabel + ')');
+  console.log('');
+}
+
+function imprimirBotStatus() {
+  const r = nt.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('');
+}
+
+function reportarOk(prefijo, r, mensajeDefault) {
+  if (r.ok) {
+    console.log('[' + prefijo + ']', r.mensaje || mensajeDefault);
+  } else {
+    console.error('[' + prefijo + '] Error:', r.error);
+    process.exitCode = 1;
+  }
+}
+
+// Tabla de dispatch de los ops del bot daemon: [prefijo, fn, mensajeDefault].
+const BOT_OPS = {
+  'bot-start': ['bot', () => nt.botStart(), 'Bot iniciado.'],
+  'bot-stop': ['bot', () => nt.botStop(), 'Bot detenido.'],
+  'bot-restart': ['bot', () => nt.botRestart(), 'Bot reiniciado.'],
+  'bot-enable-autostart': ['autostart', () => nt.botEnableAutostart(), 'Autostart habilitado.'],
+  'bot-disable-autostart': ['autostart', () => nt.botDisableAutostart(), 'Autostart deshabilitado.'],
+};
+
+async function notificaciones(opciones = {}) {
+  const op = (opciones._args && opciones._args[0]) || opciones.op || 'status';
+
+  if (BOT_OPS[op]) {
+    const [prefijo, fn, msg] = BOT_OPS[op];
+    reportarOk(prefijo, fn(), msg);
+    return;
+  }
+
+  switch (op) {
+    case 'init': {
+      if (!process.stdin.isTTY) {
+        console.log('Este subcomando requiere entrada interactiva (TTY).');
+        console.log('Ejecuta desde tu terminal:');
+        console.log('  swl-ses notificaciones init');
+        console.log('O usa el instalador:');
+        console.log('  npx -y @saulwade/swl-ses@latest install');
+        return;
+      }
+      const r = await nt.init({ esTty: true });
+      console.log('[resultado]', r.resultado, r.detalle || '');
+      if (r.resultado === 'error') process.exitCode = 1;
+      return;
+    }
+    case 'status':
+      imprimirStatus();
+      return;
+    case 'disable': {
+      const r = nt.disable({ confirmar: true, conservarEnv: !opciones.purge });
+      console.log('[resultado]', r.resultado, r.detalle || '');
+      if (r.resultado === 'error') process.exitCode = 1;
+      return;
+    }
+    case 'repair': {
+      const r = await nt.repair();
+      console.log('[repair]', r.resultado, r.detalle || '');
+      if (r.resultado === 'error') process.exitCode = 1;
+      return;
+    }
+    case 'bot-status':
+      imprimirBotStatus();
+      return;
+    default:
+      console.error('Op desconocida: ' + op);
+      console.error('Ops: init|status|disable|repair|bot-start|bot-stop|bot-status|bot-restart|bot-enable-autostart|bot-disable-autostart');
+      process.exitCode = 1;
+  }
+}
+
+module.exports = notificaciones;

package/scripts/cli/propose-step.js

@@ -1,29 +1,29 @@
-'use strict';
-
-/**
- * Wrapper CLI para `swl-ses propose-step` — anexo propositivo del RESUMEN de
- * fase (ADR-0037). Envuelve hooks/lib/propose-step.js (que lee process.argv).
- *
- * Reemplaza el `node hooks/lib/propose-step.js --rango=...` relativo al proyecto
- * que /swl:ejecutar-fase invocaba — roto downstream (ver
- * docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses propose-step --rango=<base>..HEAD   (opt-out SWL_PROPOSE=0)
- */
-
-const { main } = require('../../hooks/lib/propose-step.js');
-
-function proposeStep(opciones = {}) {
-  opciones = opciones || {};
-  const args = ['node', 'propose-step'];
-  if (opciones.rango) args.push(`--rango=${opciones.rango}`);
-  const argvOriginal = process.argv;
-  process.argv = args;
-  try {
-    return main(process.argv);
-  } finally {
-    process.argv = argvOriginal;
-  }
-}
-
-module.exports = proposeStep;
+'use strict';
+
+/**
+ * Wrapper CLI para `swl-ses propose-step` — anexo propositivo del RESUMEN de
+ * fase (ADR-0037). Envuelve hooks/lib/propose-step.js (que lee process.argv).
+ *
+ * Reemplaza el `node hooks/lib/propose-step.js --rango=...` relativo al proyecto
+ * que /swl:ejecutar-fase invocaba — roto downstream (ver
+ * docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses propose-step --rango=<base>..HEAD   (opt-out SWL_PROPOSE=0)
+ */
+
+const { main } = require('../../hooks/lib/propose-step.js');
+
+function proposeStep(opciones = {}) {
+  opciones = opciones || {};
+  const args = ['node', 'propose-step'];
+  if (opciones.rango) args.push(`--rango=${opciones.rango}`);
+  const argvOriginal = process.argv;
+  process.argv = args;
+  try {
+    return main(process.argv);
+  } finally {
+    process.argv = argvOriginal;
+  }
+}
+
+module.exports = proposeStep;

package/scripts/cli/schedule-parse.js

@@ -1,19 +1,19 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses schedule-parse` — parsea una frase en inglés a expresión
- * cron. Reemplaza el inline `require('./scripts/lib/schedule-parser')` relativo
- * al proyecto (roto downstream; ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses schedule-parse "every morning at 9am"
- */
-
-const { parseNaturalSchedule } = require('../lib/schedule-parser');
-
-function scheduleParse(opciones = {}) {
-  const frase =
-    (opciones._args && opciones._args.join(' ')) || opciones.texto || '';
-  console.log(JSON.stringify(parseNaturalSchedule(frase), null, 2));
-}
-
-module.exports = scheduleParse;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses schedule-parse` — parsea una frase en inglés a expresión
+ * cron. Reemplaza el inline `require('./scripts/lib/schedule-parser')` relativo
+ * al proyecto (roto downstream; ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses schedule-parse "every morning at 9am"
+ */
+
+const { parseNaturalSchedule } = require('../lib/schedule-parser');
+
+function scheduleParse(opciones = {}) {
+  const frase =
+    (opciones._args && opciones._args.join(' ')) || opciones.texto || '';
+  console.log(JSON.stringify(parseNaturalSchedule(frase), null, 2));
+}
+
+module.exports = scheduleParse;

package/scripts/cli/sugerir-modelo.js

@@ -1,20 +1,20 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses sugerir-modelo` — evalúa la complejidad de una tarea y
- * sugiere el modelo (opus/sonnet/haiku). Reemplaza el inline
- * `require('./hooks/lib/model-router.js')` relativo al proyecto (roto downstream;
- * ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses sugerir-modelo "<descripción de la tarea>"
- */
-
-const { sugerirModelo } = require('../../hooks/lib/model-router.js');
-
-function sugerirModeloCli(opciones = {}) {
-  const desc =
-    (opciones._args && opciones._args.join(' ')) || opciones.desc || '';
-  console.log(JSON.stringify(sugerirModelo(desc), null, 2));
-}
-
-module.exports = sugerirModeloCli;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses sugerir-modelo` — evalúa la complejidad de una tarea y
+ * sugiere el modelo (opus/sonnet/haiku). Reemplaza el inline
+ * `require('./hooks/lib/model-router.js')` relativo al proyecto (roto downstream;
+ * ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses sugerir-modelo "<descripción de la tarea>"
+ */
+
+const { sugerirModelo } = require('../../hooks/lib/model-router.js');
+
+function sugerirModeloCli(opciones = {}) {
+  const desc =
+    (opciones._args && opciones._args.join(' ')) || opciones.desc || '';
+  console.log(JSON.stringify(sugerirModelo(desc), null, 2));
+}
+
+module.exports = sugerirModeloCli;

package/scripts/cli/verificar-plan.js

@@ -1,36 +1,36 @@
-'use strict';
-
-/**
- * Subcomando `swl-ses verificar-plan --fase=N` — verificación read-only del lock
- * de un PLAN (gate G1). Lo usa /swl:ejecutar-fase antes de implementar y
- * /swl:aprobar-plan Paso 2 para detectar planes ya firmados/mutados/legacy.
- *
- * Reemplaza el `node -e "require('./scripts/lib/plan-lock')"` inline que se
- * rompía downstream (ver docs/invocacion-cli-cross-scope.md).
- *
- * Exit 0 si ok (firmado o legacy); exit 1 si mutado/sin-firmar/corrupto.
- *
- * Uso: swl-ses verificar-plan --fase=N [--plan=<ruta>]
- */
-
-const { verificarPlan } = require('../lib/plan-lock');
-const { resolverPlanPath } = require('../lib/resolver-plan-fase');
-
-function verificarPlanCli(opciones = {}) {
-  opciones = opciones || {};
-  const planPath = resolverPlanPath(opciones);
-  if (!planPath) {
-    console.error('Uso: swl-ses verificar-plan --fase=N [--plan=<ruta>]');
-    process.exit(1);
-  }
-  const r = verificarPlan(planPath);
-  console.log(JSON.stringify(r, null, 2));
-  process.exit(r.ok ? 0 : 1);
-}
-
-module.exports = verificarPlanCli;
-
-if (require.main === module) {
-  const { parsearOpciones } = require('../lib/parsear-opciones');
-  verificarPlanCli(parsearOpciones(process.argv.slice(2)));
-}
+'use strict';
+
+/**
+ * Subcomando `swl-ses verificar-plan --fase=N` — verificación read-only del lock
+ * de un PLAN (gate G1). Lo usa /swl:ejecutar-fase antes de implementar y
+ * /swl:aprobar-plan Paso 2 para detectar planes ya firmados/mutados/legacy.
+ *
+ * Reemplaza el `node -e "require('./scripts/lib/plan-lock')"` inline que se
+ * rompía downstream (ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Exit 0 si ok (firmado o legacy); exit 1 si mutado/sin-firmar/corrupto.
+ *
+ * Uso: swl-ses verificar-plan --fase=N [--plan=<ruta>]
+ */
+
+const { verificarPlan } = require('../lib/plan-lock');
+const { resolverPlanPath } = require('../lib/resolver-plan-fase');
+
+function verificarPlanCli(opciones = {}) {
+  opciones = opciones || {};
+  const planPath = resolverPlanPath(opciones);
+  if (!planPath) {
+    console.error('Uso: swl-ses verificar-plan --fase=N [--plan=<ruta>]');
+    process.exit(1);
+  }
+  const r = verificarPlan(planPath);
+  console.log(JSON.stringify(r, null, 2));
+  process.exit(r.ok ? 0 : 1);
+}
+
+module.exports = verificarPlanCli;
+
+if (require.main === module) {
+  const { parsearOpciones } = require('../lib/parsear-opciones');
+  verificarPlanCli(parsearOpciones(process.argv.slice(2)));
+}

package/scripts/cli/verificar-trazabilidad.js

@@ -1,35 +1,35 @@
-'use strict';
-
-/**
- * Wrapper CLI para el subcomando `swl-ses verificar-trazabilidad`.
- *
- * Traduce las opciones parseadas del bin a las flags que espera el script
- * standalone `scripts/verificar-trazabilidad.js` (que lee process.argv y hace
- * su propio process.exit). Mismo patrón que scripts/cli/audit-claudemd.js.
- *
- * Reemplaza el `node scripts/verificar-trazabilidad.js` relativo al proyecto que
- * /swl:aprobar-plan invocaba — roto downstream (ver
- * docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses verificar-trazabilidad --fase=N [--solo-plan] [--json]
- */
-
-const { main } = require('../verificar-trazabilidad.js');
-
-function verificarTrazabilidad(opciones = {}) {
-  opciones = opciones || {};
-  const args = [];
-  if (opciones.fase != null && opciones.fase !== true) args.push(`--fase=${opciones.fase}`);
-  if (opciones['solo-plan'] || opciones.solo_plan) args.push('--solo-plan');
-  if (opciones.json) args.push('--json');
-
-  const argvOriginal = process.argv;
-  process.argv = ['node', 'verificar-trazabilidad.js', ...args];
-  try {
-    main();
-  } finally {
-    process.argv = argvOriginal;
-  }
-}
-
-module.exports = verificarTrazabilidad;
+'use strict';
+
+/**
+ * Wrapper CLI para el subcomando `swl-ses verificar-trazabilidad`.
+ *
+ * Traduce las opciones parseadas del bin a las flags que espera el script
+ * standalone `scripts/verificar-trazabilidad.js` (que lee process.argv y hace
+ * su propio process.exit). Mismo patrón que scripts/cli/audit-claudemd.js.
+ *
+ * Reemplaza el `node scripts/verificar-trazabilidad.js` relativo al proyecto que
+ * /swl:aprobar-plan invocaba — roto downstream (ver
+ * docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses verificar-trazabilidad --fase=N [--solo-plan] [--json]
+ */
+
+const { main } = require('../verificar-trazabilidad.js');
+
+function verificarTrazabilidad(opciones = {}) {
+  opciones = opciones || {};
+  const args = [];
+  if (opciones.fase != null && opciones.fase !== true) args.push(`--fase=${opciones.fase}`);
+  if (opciones['solo-plan'] || opciones.solo_plan) args.push('--solo-plan');
+  if (opciones.json) args.push('--json');
+
+  const argvOriginal = process.argv;
+  process.argv = ['node', 'verificar-trazabilidad.js', ...args];
+  try {
+    main();
+  } finally {
+    process.argv = argvOriginal;
+  }
+}
+
+module.exports = verificarTrazabilidad;