@saulwade/swl-ses 2.6.0 → 2.8.0

package/scripts/cli/execution-state.js

@@ -1,18 +1,18 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses execution-state` — imprime el resumen estructurado del
- * estado de ejecución (.planning/execution-state.json). Reemplaza el inline
- * `require('./hooks/lib/execution-state')` relativo al proyecto (roto downstream;
- * ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses execution-state
- */
-
-const es = require('../../hooks/lib/execution-state');
-
-function executionState() {
-  console.log(es.formatearResumen(process.cwd()));
-}
-
-module.exports = executionState;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses execution-state` — imprime el resumen estructurado del
+ * estado de ejecución (.planning/execution-state.json). Reemplaza el inline
+ * `require('./hooks/lib/execution-state')` relativo al proyecto (roto downstream;
+ * ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses execution-state
+ */
+
+const es = require('../../hooks/lib/execution-state');
+
+function executionState() {
+  console.log(es.formatearResumen(process.cwd()));
+}
+
+module.exports = executionState;

package/scripts/cli/gateway-notify.js

@@ -1,41 +1,41 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses gateway-notify` — encola una notificación de vuelta al
- * canal origen del gateway (Telegram, Discord). Reemplaza el inline
- * `require('./hooks/lib/gateway-notify')` relativo al proyecto (roto downstream;
- * ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses gateway-notify --texto="✅ ..." [--tipo=custom] [--to=telegram]
- *                             [--reply-to=<chatId>]
- */
-
-const { notificarGateway } = require('../../hooks/lib/gateway-notify');
-
-function gatewayNotify(opciones = {}) {
-  if (!opciones.texto) {
-    console.error('Error: falta --texto="mensaje"');
-    process.exitCode = 1;
-    return;
-  }
-  // --reply-to debe ser un chatId numérico: evita redirigir la notificación a
-  // un chat arbitrario cuando el flag se sintetiza desde input no confiable.
-  if (opciones['reply-to'] !== undefined && !/^-?\d+$/.test(String(opciones['reply-to']))) {
-    console.error('Error: --reply-to debe ser un chatId numérico');
-    process.exitCode = 1;
-    return;
-  }
-  const params = { tipo: opciones.tipo || 'custom', texto: opciones.texto };
-  if (opciones.to) params.to = opciones.to;
-  if (opciones['reply-to'] !== undefined) params.payload = { replyTo: opciones['reply-to'] };
-
-  const r = notificarGateway(params);
-  if (r === false) {
-    console.log(JSON.stringify({ ok: false, motivo: 'gateway deshabilitado o tipo no habilitado' }, null, 2));
-    process.exitCode = 1;
-    return;
-  }
-  console.log(JSON.stringify(r ?? { ok: true }, null, 2));
-}
-
-module.exports = gatewayNotify;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses gateway-notify` — encola una notificación de vuelta al
+ * canal origen del gateway (Telegram, Discord). Reemplaza el inline
+ * `require('./hooks/lib/gateway-notify')` relativo al proyecto (roto downstream;
+ * ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses gateway-notify --texto="✅ ..." [--tipo=custom] [--to=telegram]
+ *                             [--reply-to=<chatId>]
+ */
+
+const { notificarGateway } = require('../../hooks/lib/gateway-notify');
+
+function gatewayNotify(opciones = {}) {
+  if (!opciones.texto) {
+    console.error('Error: falta --texto="mensaje"');
+    process.exitCode = 1;
+    return;
+  }
+  // --reply-to debe ser un chatId numérico: evita redirigir la notificación a
+  // un chat arbitrario cuando el flag se sintetiza desde input no confiable.
+  if (opciones['reply-to'] !== undefined && !/^-?\d+$/.test(String(opciones['reply-to']))) {
+    console.error('Error: --reply-to debe ser un chatId numérico');
+    process.exitCode = 1;
+    return;
+  }
+  const params = { tipo: opciones.tipo || 'custom', texto: opciones.texto };
+  if (opciones.to) params.to = opciones.to;
+  if (opciones['reply-to'] !== undefined) params.payload = { replyTo: opciones['reply-to'] };
+
+  const r = notificarGateway(params);
+  if (r === false) {
+    console.log(JSON.stringify({ ok: false, motivo: 'gateway deshabilitado o tipo no habilitado' }, null, 2));
+    process.exitCode = 1;
+    return;
+  }
+  console.log(JSON.stringify(r ?? { ok: true }, null, 2));
+}
+
+module.exports = gatewayNotify;

package/scripts/cli/guardrail-metrics.js

@@ -1,39 +1,39 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses guardrail-metrics` — métricas y diagnóstico de los
- * guardrails de la sesión (bridge en tmpdir por sessionId). Reemplaza el
- * `node -e "require('./hooks/lib/guardrail-metrics')..."` relativo al
- * proyecto que swl-dashboard instruía — roto downstream (ver
- * docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses guardrail-metrics [--session=ID] [--json]
- *   --session  default: env CLAUDE_SESSION_ID o "default"
- *   --json     imprime {metricas, advertencias} crudo
- */
-
-const { getMetrics, formatearResumen, diagnosticar } = require('../../hooks/lib/guardrail-metrics');
-
-function guardrailMetrics(opciones = {}) {
-  const sessionId = (opciones.session != null && opciones.session !== true)
-    ? String(opciones.session)
-    : (process.env.CLAUDE_SESSION_ID || 'default');
-
-  const metricas = getMetrics(sessionId);
-  const advertencias = diagnosticar(metricas);
-
-  if (opciones.json) {
-    console.log(JSON.stringify({ metricas, advertencias }, null, 2));
-    return;
-  }
-
-  console.log(formatearResumen(metricas));
-  if (advertencias.length > 0) {
-    console.log('\n⚠ Diagnóstico:');
-    for (const a of advertencias) console.log('  - ' + a);
-  } else {
-    console.log('\n✓ Guardrails sin anomalías detectadas.');
-  }
-}
-
-module.exports = guardrailMetrics;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses guardrail-metrics` — métricas y diagnóstico de los
+ * guardrails de la sesión (bridge en tmpdir por sessionId). Reemplaza el
+ * `node -e "require('./hooks/lib/guardrail-metrics')..."` relativo al
+ * proyecto que swl-dashboard instruía — roto downstream (ver
+ * docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses guardrail-metrics [--session=ID] [--json]
+ *   --session  default: env CLAUDE_SESSION_ID o "default"
+ *   --json     imprime {metricas, advertencias} crudo
+ */
+
+const { getMetrics, formatearResumen, diagnosticar } = require('../../hooks/lib/guardrail-metrics');
+
+function guardrailMetrics(opciones = {}) {
+  const sessionId = (opciones.session != null && opciones.session !== true)
+    ? String(opciones.session)
+    : (process.env.CLAUDE_SESSION_ID || 'default');
+
+  const metricas = getMetrics(sessionId);
+  const advertencias = diagnosticar(metricas);
+
+  if (opciones.json) {
+    console.log(JSON.stringify({ metricas, advertencias }, null, 2));
+    return;
+  }
+
+  console.log(formatearResumen(metricas));
+  if (advertencias.length > 0) {
+    console.log('\n⚠ Diagnóstico:');
+    for (const a of advertencias) console.log('  - ' + a);
+  } else {
+    console.log('\n✓ Guardrails sin anomalías detectadas.');
+  }
+}
+
+module.exports = guardrailMetrics;

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/memoria-search.js

@@ -1,69 +1,69 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses memoria-search <op>` — búsqueda en la memoria del
- * proyecto (.planning/sessions/, APRENDIZAJES.md, diary). Reemplaza los
- * `require('./hooks/lib/memory-search')` relativos al proyecto que
- * memoria-busqueda y benchmark-memoria instruían — rotos downstream (ver
- * docs/invocacion-cli-cross-scope.md).
- *
- * Ops:
- *   search   --query="..." [--limit=N] [--tipo=aprendizaje|sesion|instinto]
- *            [--desde=YYYY-MM-DD] [--hasta=YYYY-MM-DD]   (default)
- *   timeline --ids=id1,id2,...
- *   fetch    --id=<id>
- *
- * Salida: JSON a stdout. La base es la RAÍZ del proyecto (raizProyecto),
- * no el cwd crudo — misma semántica que los hooks (DT-HOOKS-RAIZ-GIT).
- */
-
-const ms = require('../../hooks/lib/memory-search');
-const { raizProyecto } = require('../../hooks/lib/raiz-proyecto');
-
-function memoriaSearch(opciones = {}) {
-  const op = (opciones._args && opciones._args[0]) || 'search';
-  const base = raizProyecto(process.cwd());
-
-  if (op === 'search') {
-    const query = opciones.query != null && opciones.query !== true ? String(opciones.query) : '';
-    if (!query) {
-      console.error('Error: falta --query="<términos>"');
-      process.exitCode = 1;
-      return;
-    }
-    const filtros = {};
-    const limit = parseInt(opciones.limit, 10);
-    if (!isNaN(limit) && limit > 0) filtros.limit = limit;
-    if (opciones.tipo != null && opciones.tipo !== true) filtros.tipo = String(opciones.tipo);
-    if (opciones.desde != null && opciones.desde !== true) filtros.fecha_desde = String(opciones.desde);
-    if (opciones.hasta != null && opciones.hasta !== true) filtros.fecha_hasta = String(opciones.hasta);
-    console.log(JSON.stringify(ms.search(base, query, filtros), null, 2));
-    return;
-  }
-
-  if (op === 'timeline') {
-    const ids = String(opciones.ids || '').split(',').map(s => s.trim()).filter(Boolean);
-    if (ids.length === 0) {
-      console.error('Error: falta --ids=id1,id2,...');
-      process.exitCode = 1;
-      return;
-    }
-    console.log(JSON.stringify(ms.timeline(base, ids), null, 2));
-    return;
-  }
-
-  if (op === 'fetch') {
-    if (opciones.id == null || opciones.id === true) {
-      console.error('Error: falta --id=<id>');
-      process.exitCode = 1;
-      return;
-    }
-    console.log(JSON.stringify(ms.fetch(base, String(opciones.id)), null, 2));
-    return;
-  }
-
-  console.error(`Error: op desconocida "${op}" (usa search|timeline|fetch)`);
-  process.exitCode = 1;
-}
-
-module.exports = memoriaSearch;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses memoria-search <op>` — búsqueda en la memoria del
+ * proyecto (.planning/sessions/, APRENDIZAJES.md, diary). Reemplaza los
+ * `require('./hooks/lib/memory-search')` relativos al proyecto que
+ * memoria-busqueda y benchmark-memoria instruían — rotos downstream (ver
+ * docs/invocacion-cli-cross-scope.md).
+ *
+ * Ops:
+ *   search   --query="..." [--limit=N] [--tipo=aprendizaje|sesion|instinto]
+ *            [--desde=YYYY-MM-DD] [--hasta=YYYY-MM-DD]   (default)
+ *   timeline --ids=id1,id2,...
+ *   fetch    --id=<id>
+ *
+ * Salida: JSON a stdout. La base es la RAÍZ del proyecto (raizProyecto),
+ * no el cwd crudo — misma semántica que los hooks (DT-HOOKS-RAIZ-GIT).
+ */
+
+const ms = require('../../hooks/lib/memory-search');
+const { raizProyecto } = require('../../hooks/lib/raiz-proyecto');
+
+function memoriaSearch(opciones = {}) {
+  const op = (opciones._args && opciones._args[0]) || 'search';
+  const base = raizProyecto(process.cwd());
+
+  if (op === 'search') {
+    const query = opciones.query != null && opciones.query !== true ? String(opciones.query) : '';
+    if (!query) {
+      console.error('Error: falta --query="<términos>"');
+      process.exitCode = 1;
+      return;
+    }
+    const filtros = {};
+    const limit = parseInt(opciones.limit, 10);
+    if (!isNaN(limit) && limit > 0) filtros.limit = limit;
+    if (opciones.tipo != null && opciones.tipo !== true) filtros.tipo = String(opciones.tipo);
+    if (opciones.desde != null && opciones.desde !== true) filtros.fecha_desde = String(opciones.desde);
+    if (opciones.hasta != null && opciones.hasta !== true) filtros.fecha_hasta = String(opciones.hasta);
+    console.log(JSON.stringify(ms.search(base, query, filtros), null, 2));
+    return;
+  }
+
+  if (op === 'timeline') {
+    const ids = String(opciones.ids || '').split(',').map(s => s.trim()).filter(Boolean);
+    if (ids.length === 0) {
+      console.error('Error: falta --ids=id1,id2,...');
+      process.exitCode = 1;
+      return;
+    }
+    console.log(JSON.stringify(ms.timeline(base, ids), null, 2));
+    return;
+  }
+
+  if (op === 'fetch') {
+    if (opciones.id == null || opciones.id === true) {
+      console.error('Error: falta --id=<id>');
+      process.exitCode = 1;
+      return;
+    }
+    console.log(JSON.stringify(ms.fetch(base, String(opciones.id)), null, 2));
+    return;
+  }
+
+  console.error(`Error: op desconocida "${op}" (usa search|timeline|fetch)`);
+  process.exitCode = 1;
+}
+
+module.exports = memoriaSearch;

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;