@saulwade/swl-ses 2.6.1 → 2.8.0

package/scripts/cli/liberar-fase.js

@@ -1,42 +1,42 @@
-'use strict';
-
-/**
- * Subcomando `swl-ses liberar-fase` — cierra el gate G0 borrando
- * .planning/locks/fase-activa.json. Lo usa /swl:ejecutar-fase al terminar una
- * fase para que spec-gate.js vuelva a advertir si se reanuda trabajo.
- *
- * Reemplaza el `node -e "...unlinkSync('.planning/locks/fase-activa.json')"`
- * inline (relativo al proyecto). Busca el archivo ascendiendo desde el CWD para
- * funcionar aunque el comando se ejecute desde un subdirectorio.
- *
- * Uso: swl-ses liberar-fase
- */
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-function liberarFase(opciones = {}) {
-  let dir = (opciones && opciones.cwd) || process.cwd();
-  let target = null;
-  while (dir !== path.dirname(dir)) {
-    const cand = path.join(dir, '.planning', 'locks', 'fase-activa.json');
-    if (fs.existsSync(cand)) {
-      target = cand;
-      break;
-    }
-    dir = path.dirname(dir);
-  }
-
-  if (target) {
-    fs.unlinkSync(target);
-    console.log(JSON.stringify({ ok: true, liberado: target }));
-  } else {
-    console.log(
-      JSON.stringify({ ok: true, liberado: null, motivo: 'sin fase activa que liberar' })
-    );
-  }
-}
-
-module.exports = liberarFase;
-
-if (require.main === module) liberarFase();
+'use strict';
+
+/**
+ * Subcomando `swl-ses liberar-fase` — cierra el gate G0 borrando
+ * .planning/locks/fase-activa.json. Lo usa /swl:ejecutar-fase al terminar una
+ * fase para que spec-gate.js vuelva a advertir si se reanuda trabajo.
+ *
+ * Reemplaza el `node -e "...unlinkSync('.planning/locks/fase-activa.json')"`
+ * inline (relativo al proyecto). Busca el archivo ascendiendo desde el CWD para
+ * funcionar aunque el comando se ejecute desde un subdirectorio.
+ *
+ * Uso: swl-ses liberar-fase
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function liberarFase(opciones = {}) {
+  let dir = (opciones && opciones.cwd) || process.cwd();
+  let target = null;
+  while (dir !== path.dirname(dir)) {
+    const cand = path.join(dir, '.planning', 'locks', 'fase-activa.json');
+    if (fs.existsSync(cand)) {
+      target = cand;
+      break;
+    }
+    dir = path.dirname(dir);
+  }
+
+  if (target) {
+    fs.unlinkSync(target);
+    console.log(JSON.stringify({ ok: true, liberado: target }));
+  } else {
+    console.log(
+      JSON.stringify({ ok: true, liberado: null, motivo: 'sin fase activa que liberar' })
+    );
+  }
+}
+
+module.exports = liberarFase;
+
+if (require.main === module) liberarFase();

package/scripts/cli/mark-evolved.js

@@ -1,56 +1,56 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses mark-evolved` — marca un componente SWL como evolucionado
- * (frontmatter evolved: true + metadatos). Reemplaza el inline
- * `require('./hooks/lib/evolution-tracker')` relativo al proyecto (roto
- * downstream; ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses mark-evolved <ruta> [--from=VER] [--by=aprender]
- *                           [--note="..."] [--rounds=N] [--score="A% → B%"]
- */
-
-const path = require('node:path');
-const { markAsEvolved } = require('../../hooks/lib/evolution-tracker');
-
-function markEvolved(opciones = {}) {
-  const ruta = (opciones._args && opciones._args[0]) || opciones.ruta;
-  if (!ruta) {
-    console.error('Error: falta <ruta> del archivo a marcar');
-    process.exitCode = 1;
-    return;
-  }
-  // Guard anti path-traversal: la ruta debe resolver dentro del proyecto actual
-  // y ser un componente del sistema (.md/.json). Evita sobrescribir archivos
-  // arbitrarios con frontmatter si el flag se sintetiza desde input no confiable.
-  const cwd = process.cwd();
-  const resuelta = path.resolve(cwd, ruta);
-  if (resuelta !== cwd && !resuelta.startsWith(cwd + path.sep)) {
-    console.error('Error: la ruta debe estar dentro del proyecto actual');
-    process.exitCode = 1;
-    return;
-  }
-  if (!/\.(md|json)$/i.test(resuelta)) {
-    console.error('Error: solo se pueden marcar componentes .md o .json');
-    process.exitCode = 1;
-    return;
-  }
-  let from = opciones.from;
-  if (!from) {
-    try {
-      from = require(path.resolve(process.cwd(), 'package.json')).version;
-    } catch {
-      from = undefined;
-    }
-  }
-  const meta = { from, by: opciones.by || 'aprender' };
-  if (opciones.note) meta.note = opciones.note;
-  if (opciones.rounds) meta.rounds = Number(opciones.rounds);
-  if (opciones.score) meta.score = opciones.score;
-
-  const r = markAsEvolved(ruta, meta);
-  console.log(r.marked ? 'Marcado como evolucionado' : 'Error: ' + r.error);
-  if (!r.marked) process.exitCode = 1;
-}
-
-module.exports = markEvolved;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses mark-evolved` — marca un componente SWL como evolucionado
+ * (frontmatter evolved: true + metadatos). Reemplaza el inline
+ * `require('./hooks/lib/evolution-tracker')` relativo al proyecto (roto
+ * downstream; ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses mark-evolved <ruta> [--from=VER] [--by=aprender]
+ *                           [--note="..."] [--rounds=N] [--score="A% → B%"]
+ */
+
+const path = require('node:path');
+const { markAsEvolved } = require('../../hooks/lib/evolution-tracker');
+
+function markEvolved(opciones = {}) {
+  const ruta = (opciones._args && opciones._args[0]) || opciones.ruta;
+  if (!ruta) {
+    console.error('Error: falta <ruta> del archivo a marcar');
+    process.exitCode = 1;
+    return;
+  }
+  // Guard anti path-traversal: la ruta debe resolver dentro del proyecto actual
+  // y ser un componente del sistema (.md/.json). Evita sobrescribir archivos
+  // arbitrarios con frontmatter si el flag se sintetiza desde input no confiable.
+  const cwd = process.cwd();
+  const resuelta = path.resolve(cwd, ruta);
+  if (resuelta !== cwd && !resuelta.startsWith(cwd + path.sep)) {
+    console.error('Error: la ruta debe estar dentro del proyecto actual');
+    process.exitCode = 1;
+    return;
+  }
+  if (!/\.(md|json)$/i.test(resuelta)) {
+    console.error('Error: solo se pueden marcar componentes .md o .json');
+    process.exitCode = 1;
+    return;
+  }
+  let from = opciones.from;
+  if (!from) {
+    try {
+      from = require(path.resolve(process.cwd(), 'package.json')).version;
+    } catch {
+      from = undefined;
+    }
+  }
+  const meta = { from, by: opciones.by || 'aprender' };
+  if (opciones.note) meta.note = opciones.note;
+  if (opciones.rounds) meta.rounds = Number(opciones.rounds);
+  if (opciones.score) meta.score = opciones.score;
+
+  const r = markAsEvolved(ruta, meta);
+  console.log(r.marked ? 'Marcado como evolucionado' : 'Error: ' + r.error);
+  if (!r.marked) process.exitCode = 1;
+}
+
+module.exports = markEvolved;

package/scripts/cli/metricas-dora.js

@@ -1,26 +1,26 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses metricas-dora` — calcula métricas DORA del repo actual.
- * Reemplaza `node scripts/lib/metricas-dora.js` relativo al proyecto (roto
- * downstream; ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses metricas-dora [--json] [--dias=N]
- */
-
-const { calcularDora, persistir } = require('../lib/metricas-dora');
-
-function metricasDora(opciones = {}) {
-  const dias = Number(opciones.dias);
-  const ventanaDias = Math.max(1, Math.min(365, Number.isFinite(dias) && dias > 0 ? dias : 30));
-  const baseDir = process.cwd();
-  const dora = calcularDora(baseDir, { ventanaDias });
-  try {
-    persistir(baseDir, dora);
-  } catch {
-    /* persistencia best-effort: no romper el informe si el disco falla */
-  }
-  console.log(JSON.stringify(dora, null, 2));
-}
-
-module.exports = metricasDora;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses metricas-dora` — calcula métricas DORA del repo actual.
+ * Reemplaza `node scripts/lib/metricas-dora.js` relativo al proyecto (roto
+ * downstream; ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses metricas-dora [--json] [--dias=N]
+ */
+
+const { calcularDora, persistir } = require('../lib/metricas-dora');
+
+function metricasDora(opciones = {}) {
+  const dias = Number(opciones.dias);
+  const ventanaDias = Math.max(1, Math.min(365, Number.isFinite(dias) && dias > 0 ? dias : 30));
+  const baseDir = process.cwd();
+  const dora = calcularDora(baseDir, { ventanaDias });
+  try {
+    persistir(baseDir, dora);
+  } catch {
+    /* persistencia best-effort: no romper el informe si el disco falla */
+  }
+  console.log(JSON.stringify(dora, null, 2));
+}
+
+module.exports = metricasDora;

package/scripts/cli/near-duplicate.js

@@ -1,55 +1,55 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses near-duplicate` — detecta si un aprendizaje nuevo es
- * duplicado cercano de los existentes en APRENDIZAJES.md. Reemplaza el inline
- * `require('./hooks/lib/fingerprint-id')` relativo al proyecto (roto downstream;
- * ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses near-duplicate --texto="..." [--archivo=ruta] [--threshold=0.6]
- *      echo "texto..." | swl-ses near-duplicate [--archivo=ruta]
- */
-
-const fs = require('node:fs');
-const path = require('node:path');
-const { isNearDuplicate } = require('../../hooks/lib/fingerprint-id');
-
-function nearDuplicate(opciones = {}) {
-  const archivo = opciones.archivo || '.planning/APRENDIZAJES.md';
-  let nuevo = opciones.texto;
-  if (!nuevo && !process.stdin.isTTY) {
-    try {
-      nuevo = fs.readFileSync(0, 'utf8');
-    } catch {
-      nuevo = '';
-    }
-  }
-  if (!nuevo) {
-    console.error('Error: falta --texto="..." o entrada por stdin');
-    process.exitCode = 1;
-    return;
-  }
-  // Guard anti path-traversal: --archivo debe resolver dentro del proyecto.
-  const cwd = process.cwd();
-  const resuelta = path.resolve(cwd, archivo);
-  if (resuelta !== cwd && !resuelta.startsWith(cwd + path.sep)) {
-    console.error('Error: --archivo debe estar dentro del proyecto actual');
-    process.exitCode = 1;
-    return;
-  }
-  let existentes = [];
-  try {
-    existentes = fs.readFileSync(resuelta, 'utf8').split(/^## /m).filter(Boolean);
-  } catch (e) {
-    // Sin archivo de aprendizajes legible: avisar (no degradar en silencio) y
-    // tratar todo como único.
-    if (e.code !== 'ENOENT') console.error('[near-duplicate] aviso: ' + e.code);
-  }
-  const t = Number(opciones.threshold);
-  const threshold = Number.isFinite(t) && t > 0 ? t : 0.6;
-
-  const r = isNearDuplicate(nuevo, existentes, threshold);
-  console.log(r.nearDuplicate ? 'DUPLICADO (sim=' + r.similarity + ')' : 'ÚNICO');
-}
-
-module.exports = nearDuplicate;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses near-duplicate` — detecta si un aprendizaje nuevo es
+ * duplicado cercano de los existentes en APRENDIZAJES.md. Reemplaza el inline
+ * `require('./hooks/lib/fingerprint-id')` relativo al proyecto (roto downstream;
+ * ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses near-duplicate --texto="..." [--archivo=ruta] [--threshold=0.6]
+ *      echo "texto..." | swl-ses near-duplicate [--archivo=ruta]
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { isNearDuplicate } = require('../../hooks/lib/fingerprint-id');
+
+function nearDuplicate(opciones = {}) {
+  const archivo = opciones.archivo || '.planning/APRENDIZAJES.md';
+  let nuevo = opciones.texto;
+  if (!nuevo && !process.stdin.isTTY) {
+    try {
+      nuevo = fs.readFileSync(0, 'utf8');
+    } catch {
+      nuevo = '';
+    }
+  }
+  if (!nuevo) {
+    console.error('Error: falta --texto="..." o entrada por stdin');
+    process.exitCode = 1;
+    return;
+  }
+  // Guard anti path-traversal: --archivo debe resolver dentro del proyecto.
+  const cwd = process.cwd();
+  const resuelta = path.resolve(cwd, archivo);
+  if (resuelta !== cwd && !resuelta.startsWith(cwd + path.sep)) {
+    console.error('Error: --archivo debe estar dentro del proyecto actual');
+    process.exitCode = 1;
+    return;
+  }
+  let existentes = [];
+  try {
+    existentes = fs.readFileSync(resuelta, 'utf8').split(/^## /m).filter(Boolean);
+  } catch (e) {
+    // Sin archivo de aprendizajes legible: avisar (no degradar en silencio) y
+    // tratar todo como único.
+    if (e.code !== 'ENOENT') console.error('[near-duplicate] aviso: ' + e.code);
+  }
+  const t = Number(opciones.threshold);
+  const threshold = Number.isFinite(t) && t > 0 ? t : 0.6;
+
+  const r = isNearDuplicate(nuevo, existentes, threshold);
+  console.log(r.nearDuplicate ? 'DUPLICADO (sim=' + r.similarity + ')' : 'ÚNICO');
+}
+
+module.exports = nearDuplicate;

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;