@saulwade/swl-ses 2.6.0 → 2.8.0

package/hooks/lib/toon-compressor.js

@@ -1,245 +1,245 @@
-'use strict';
-
-/**
- * TOON Compressor — Compresión de schemas y documentos estructurados.
- *
- * Patrón adoptado de CC Workflow Studio (generate-toon-schema.ts).
- * Reduce el tamaño de JSON schemas y documentos estructurados ~20-25%
- * eliminando redundancia sin perder información semántica.
- *
- * Técnicas aplicadas:
- *   1. Eliminar whitespace y formateo innecesario
- *   2. Abreviar claves repetitivas con diccionario
- *   3. Colapsar descripciones a una línea
- *   4. Eliminar campos opcionales con valor default
- *   5. Usar notación compacta para tipos simples
- *
- * Zero dependencias externas.
- *
- * Uso:
- *   const { comprimirSchema, descomprimirSchema, comprimirTexto } = require('./lib/toon-compressor');
- *   const compacto = comprimirSchema(schemaJSON);
- *   console.log(`Reducción: ${compacto.reduccionPorcentaje}%`);
- *
- * @module hooks/lib/toon-compressor
- */
-
-// ---------------------------------------------------------------------------
-// Diccionario de abreviaciones para claves JSON Schema
-// ---------------------------------------------------------------------------
-
-/**
- * Mapeo de claves largas a abreviaciones cortas.
- * Solo para claves que aparecen ≥3 veces en un schema típico.
- */
-const ABREVIACIONES = {
-  description: 'desc',
-  properties: 'props',
-  required: 'req',
-  additionalProperties: 'addl',
-  type: 't',
-  items: 'it',
-  default: 'def',
-  enum: 'en',
-  maxLength: 'maxL',
-  minLength: 'minL',
-  minimum: 'min',
-  maximum: 'max',
-  pattern: 'pat',
-  oneOf: '1of',
-  anyOf: 'aof',
-  allOf: 'allof',
-};
-
-/** Mapeo inverso para descompresión. */
-const ABREVIACIONES_INV = Object.fromEntries(
-  Object.entries(ABREVIACIONES).map(([k, v]) => [v, k])
-);
-
-// ---------------------------------------------------------------------------
-// Funciones core
-// ---------------------------------------------------------------------------
-
-/**
- * Comprime un objeto JSON Schema reemplazando claves por abreviaciones.
- *
- * @param {object} obj - Objeto a comprimir (se clona internamente)
- * @returns {object} Objeto con claves abreviadas
- */
-function _abreviarClaves(obj) {
-  if (Array.isArray(obj)) {
-    return obj.map(_abreviarClaves);
-  }
-  if (obj !== null && typeof obj === 'object') {
-    const resultado = {};
-    for (const [clave, valor] of Object.entries(obj)) {
-      const claveCorta = ABREVIACIONES[clave] || clave;
-      resultado[claveCorta] = _abreviarClaves(valor);
-    }
-    return resultado;
-  }
-  return obj;
-}
-
-/**
- * Descomprime un objeto con claves abreviadas a sus nombres originales.
- *
- * @param {object} obj - Objeto con claves abreviadas
- * @returns {object} Objeto con claves originales
- */
-function _expandirClaves(obj) {
-  if (Array.isArray(obj)) {
-    return obj.map(_expandirClaves);
-  }
-  if (obj !== null && typeof obj === 'object') {
-    const resultado = {};
-    for (const [clave, valor] of Object.entries(obj)) {
-      const claveLarga = ABREVIACIONES_INV[clave] || clave;
-      resultado[claveLarga] = _expandirClaves(valor);
-    }
-    return resultado;
-  }
-  return obj;
-}
-
-/**
- * Elimina campos opcionales con valor default conocido.
- *
- * @param {object} obj - Schema JSON
- * @returns {object} Schema sin defaults redundantes
- */
-function _eliminarDefaults(obj) {
-  if (Array.isArray(obj)) {
-    return obj.map(_eliminarDefaults);
-  }
-  if (obj !== null && typeof obj === 'object') {
-    const resultado = {};
-    for (const [clave, valor] of Object.entries(obj)) {
-      // Eliminar additionalProperties: true (es el default)
-      if (clave === 'additionalProperties' && valor === true) continue;
-      // Eliminar required: [] (vacío = sin requeridos)
-      if (clave === 'required' && Array.isArray(valor) && valor.length === 0) continue;
-      // Eliminar description vacía
-      if (clave === 'description' && valor === '') continue;
-      resultado[clave] = _eliminarDefaults(valor);
-    }
-    return resultado;
-  }
-  return obj;
-}
-
-/**
- * Colapsa descripciones multi-línea a una sola línea.
- *
- * @param {object} obj
- * @returns {object}
- */
-function _colapsarDescripciones(obj) {
-  if (Array.isArray(obj)) {
-    return obj.map(_colapsarDescripciones);
-  }
-  if (obj !== null && typeof obj === 'object') {
-    const resultado = {};
-    for (const [clave, valor] of Object.entries(obj)) {
-      if (clave === 'description' && typeof valor === 'string') {
-        resultado[clave] = valor.replace(/\s+/g, ' ').trim();
-      } else {
-        resultado[clave] = _colapsarDescripciones(valor);
-      }
-    }
-    return resultado;
-  }
-  return obj;
-}
-
-// ---------------------------------------------------------------------------
-// API pública
-// ---------------------------------------------------------------------------
-
-/**
- * Comprime un JSON Schema aplicando todas las técnicas de reducción.
- *
- * @param {object|string} schema - JSON Schema (objeto o string JSON)
- * @returns {{ comprimido: string, original: number, reducido: number, reduccionPorcentaje: number }}
- */
-function comprimirSchema(schema) {
-  const obj = typeof schema === 'string' ? JSON.parse(schema) : schema;
-  const original = JSON.stringify(obj);
-
-  let procesado = _eliminarDefaults(obj);
-  procesado = _colapsarDescripciones(procesado);
-  procesado = _abreviarClaves(procesado);
-
-  const comprimido = JSON.stringify(procesado);
-
-  const tamOriginal = original.length;
-  const tamReducido = comprimido.length;
-  const reduccion = ((tamOriginal - tamReducido) / tamOriginal) * 100;
-
-  return {
-    comprimido,
-    original: tamOriginal,
-    reducido: tamReducido,
-    reduccionPorcentaje: Math.round(reduccion * 10) / 10,
-  };
-}
-
-/**
- * Descomprime un JSON Schema con claves abreviadas.
- *
- * @param {string|object} comprimido - Schema comprimido
- * @returns {object} Schema original con claves expandidas
- */
-function descomprimirSchema(comprimido) {
-  const obj = typeof comprimido === 'string' ? JSON.parse(comprimido) : comprimido;
-  return _expandirClaves(obj);
-}
-
-/**
- * Comprime texto Markdown eliminando redundancia para reducir tokens.
- *
- * Técnicas:
- *   - Colapsar múltiples líneas vacías a una
- *   - Eliminar trailing whitespace
- *   - Comprimir tablas (eliminar padding)
- *   - Eliminar comentarios HTML
- *
- * @param {string} texto - Texto Markdown
- * @returns {{ comprimido: string, original: number, reducido: number, reduccionPorcentaje: number }}
- */
-function comprimirTexto(texto) {
-  const original = texto.length;
-
-  let resultado = texto;
-  // Colapsar 3+ líneas vacías a 2
-  resultado = resultado.replace(/\n{3,}/g, '\n\n');
-  // Eliminar trailing whitespace
-  resultado = resultado.replace(/[ \t]+$/gm, '');
-  // Eliminar comentarios HTML
-  resultado = resultado.replace(/<!--[\s\S]*?-->/g, '');
-  // Comprimir padding en tablas (múltiples espacios → uno)
-  resultado = resultado.replace(/\|[ \t]{2,}/g, '| ');
-  resultado = resultado.replace(/[ \t]{2,}\|/g, ' |');
-
-  const reducido = resultado.length;
-  const reduccion = ((original - reducido) / original) * 100;
-
-  return {
-    comprimido: resultado,
-    original,
-    reducido,
-    reduccionPorcentaje: Math.round(reduccion * 10) / 10,
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Exports
-// ---------------------------------------------------------------------------
-
-module.exports = {
-  comprimirSchema,
-  descomprimirSchema,
-  comprimirTexto,
-  // Exponer diccionario para tests
-  ABREVIACIONES,
-};
+'use strict';
+
+/**
+ * TOON Compressor — Compresión de schemas y documentos estructurados.
+ *
+ * Patrón adoptado de CC Workflow Studio (generate-toon-schema.ts).
+ * Reduce el tamaño de JSON schemas y documentos estructurados ~20-25%
+ * eliminando redundancia sin perder información semántica.
+ *
+ * Técnicas aplicadas:
+ *   1. Eliminar whitespace y formateo innecesario
+ *   2. Abreviar claves repetitivas con diccionario
+ *   3. Colapsar descripciones a una línea
+ *   4. Eliminar campos opcionales con valor default
+ *   5. Usar notación compacta para tipos simples
+ *
+ * Zero dependencias externas.
+ *
+ * Uso:
+ *   const { comprimirSchema, descomprimirSchema, comprimirTexto } = require('./lib/toon-compressor');
+ *   const compacto = comprimirSchema(schemaJSON);
+ *   console.log(`Reducción: ${compacto.reduccionPorcentaje}%`);
+ *
+ * @module hooks/lib/toon-compressor
+ */
+
+// ---------------------------------------------------------------------------
+// Diccionario de abreviaciones para claves JSON Schema
+// ---------------------------------------------------------------------------
+
+/**
+ * Mapeo de claves largas a abreviaciones cortas.
+ * Solo para claves que aparecen ≥3 veces en un schema típico.
+ */
+const ABREVIACIONES = {
+  description: 'desc',
+  properties: 'props',
+  required: 'req',
+  additionalProperties: 'addl',
+  type: 't',
+  items: 'it',
+  default: 'def',
+  enum: 'en',
+  maxLength: 'maxL',
+  minLength: 'minL',
+  minimum: 'min',
+  maximum: 'max',
+  pattern: 'pat',
+  oneOf: '1of',
+  anyOf: 'aof',
+  allOf: 'allof',
+};
+
+/** Mapeo inverso para descompresión. */
+const ABREVIACIONES_INV = Object.fromEntries(
+  Object.entries(ABREVIACIONES).map(([k, v]) => [v, k])
+);
+
+// ---------------------------------------------------------------------------
+// Funciones core
+// ---------------------------------------------------------------------------
+
+/**
+ * Comprime un objeto JSON Schema reemplazando claves por abreviaciones.
+ *
+ * @param {object} obj - Objeto a comprimir (se clona internamente)
+ * @returns {object} Objeto con claves abreviadas
+ */
+function _abreviarClaves(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(_abreviarClaves);
+  }
+  if (obj !== null && typeof obj === 'object') {
+    const resultado = {};
+    for (const [clave, valor] of Object.entries(obj)) {
+      const claveCorta = ABREVIACIONES[clave] || clave;
+      resultado[claveCorta] = _abreviarClaves(valor);
+    }
+    return resultado;
+  }
+  return obj;
+}
+
+/**
+ * Descomprime un objeto con claves abreviadas a sus nombres originales.
+ *
+ * @param {object} obj - Objeto con claves abreviadas
+ * @returns {object} Objeto con claves originales
+ */
+function _expandirClaves(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(_expandirClaves);
+  }
+  if (obj !== null && typeof obj === 'object') {
+    const resultado = {};
+    for (const [clave, valor] of Object.entries(obj)) {
+      const claveLarga = ABREVIACIONES_INV[clave] || clave;
+      resultado[claveLarga] = _expandirClaves(valor);
+    }
+    return resultado;
+  }
+  return obj;
+}
+
+/**
+ * Elimina campos opcionales con valor default conocido.
+ *
+ * @param {object} obj - Schema JSON
+ * @returns {object} Schema sin defaults redundantes
+ */
+function _eliminarDefaults(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(_eliminarDefaults);
+  }
+  if (obj !== null && typeof obj === 'object') {
+    const resultado = {};
+    for (const [clave, valor] of Object.entries(obj)) {
+      // Eliminar additionalProperties: true (es el default)
+      if (clave === 'additionalProperties' && valor === true) continue;
+      // Eliminar required: [] (vacío = sin requeridos)
+      if (clave === 'required' && Array.isArray(valor) && valor.length === 0) continue;
+      // Eliminar description vacía
+      if (clave === 'description' && valor === '') continue;
+      resultado[clave] = _eliminarDefaults(valor);
+    }
+    return resultado;
+  }
+  return obj;
+}
+
+/**
+ * Colapsa descripciones multi-línea a una sola línea.
+ *
+ * @param {object} obj
+ * @returns {object}
+ */
+function _colapsarDescripciones(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(_colapsarDescripciones);
+  }
+  if (obj !== null && typeof obj === 'object') {
+    const resultado = {};
+    for (const [clave, valor] of Object.entries(obj)) {
+      if (clave === 'description' && typeof valor === 'string') {
+        resultado[clave] = valor.replace(/\s+/g, ' ').trim();
+      } else {
+        resultado[clave] = _colapsarDescripciones(valor);
+      }
+    }
+    return resultado;
+  }
+  return obj;
+}
+
+// ---------------------------------------------------------------------------
+// API pública
+// ---------------------------------------------------------------------------
+
+/**
+ * Comprime un JSON Schema aplicando todas las técnicas de reducción.
+ *
+ * @param {object|string} schema - JSON Schema (objeto o string JSON)
+ * @returns {{ comprimido: string, original: number, reducido: number, reduccionPorcentaje: number }}
+ */
+function comprimirSchema(schema) {
+  const obj = typeof schema === 'string' ? JSON.parse(schema) : schema;
+  const original = JSON.stringify(obj);
+
+  let procesado = _eliminarDefaults(obj);
+  procesado = _colapsarDescripciones(procesado);
+  procesado = _abreviarClaves(procesado);
+
+  const comprimido = JSON.stringify(procesado);
+
+  const tamOriginal = original.length;
+  const tamReducido = comprimido.length;
+  const reduccion = ((tamOriginal - tamReducido) / tamOriginal) * 100;
+
+  return {
+    comprimido,
+    original: tamOriginal,
+    reducido: tamReducido,
+    reduccionPorcentaje: Math.round(reduccion * 10) / 10,
+  };
+}
+
+/**
+ * Descomprime un JSON Schema con claves abreviadas.
+ *
+ * @param {string|object} comprimido - Schema comprimido
+ * @returns {object} Schema original con claves expandidas
+ */
+function descomprimirSchema(comprimido) {
+  const obj = typeof comprimido === 'string' ? JSON.parse(comprimido) : comprimido;
+  return _expandirClaves(obj);
+}
+
+/**
+ * Comprime texto Markdown eliminando redundancia para reducir tokens.
+ *
+ * Técnicas:
+ *   - Colapsar múltiples líneas vacías a una
+ *   - Eliminar trailing whitespace
+ *   - Comprimir tablas (eliminar padding)
+ *   - Eliminar comentarios HTML
+ *
+ * @param {string} texto - Texto Markdown
+ * @returns {{ comprimido: string, original: number, reducido: number, reduccionPorcentaje: number }}
+ */
+function comprimirTexto(texto) {
+  const original = texto.length;
+
+  let resultado = texto;
+  // Colapsar 3+ líneas vacías a 2
+  resultado = resultado.replace(/\n{3,}/g, '\n\n');
+  // Eliminar trailing whitespace
+  resultado = resultado.replace(/[ \t]+$/gm, '');
+  // Eliminar comentarios HTML
+  resultado = resultado.replace(/<!--[\s\S]*?-->/g, '');
+  // Comprimir padding en tablas (múltiples espacios → uno)
+  resultado = resultado.replace(/\|[ \t]{2,}/g, '| ');
+  resultado = resultado.replace(/[ \t]{2,}\|/g, ' |');
+
+  const reducido = resultado.length;
+  const reduccion = ((original - reducido) / original) * 100;
+
+  return {
+    comprimido: resultado,
+    original,
+    reducido,
+    reduccionPorcentaje: Math.round(reduccion * 10) / 10,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+
+module.exports = {
+  comprimirSchema,
+  descomprimirSchema,
+  comprimirTexto,
+  // Exponer diccionario para tests
+  ABREVIACIONES,
+};

package/hooks/notificacion-telegram.js

@@ -23,6 +23,7 @@ const path = require('node:path');
 
 const { cargarConfig, estaMuted } = require('./lib/telegram-config');
 const { enviarMensaje, escaparHtml } = require('./lib/telegram-cliente');
+const { resumirParaNotificacion, clasificarNotificacion } = require('./lib/notificacion-formato');
 
 // ----------------------------------------------------------------
 // Utilidades de logging
@@ -121,24 +122,18 @@ function construirCampos(nombreEvento, nombreProyecto, transcriptPath, evt) {
   if (nombreEvento === 'Stop' || nombreEvento === 'SubagentStop') {
     tituloBase = nombreEvento === 'SubagentStop' ? 'Subagente terminó' : 'Claude terminó';
     subtitulo  = 'Turno completado';
-    cuerpo     = leerUltimoMensajeAsistente(transcriptPath) || 'Claude terminó el turno.';
+    cuerpo     = resumirParaNotificacion(leerUltimoMensajeAsistente(transcriptPath)) || 'Claude terminó el turno.';
 
   } else if (nombreEvento === 'Notification') {
     tituloBase = 'Claude espera respuesta';
-    const mensaje = (evt.message || '').toLowerCase();
-    if (mensaje.includes('permission') || mensaje.includes('permiso')) {
-      subtitulo = 'Permisos pendientes';
-    } else if (mensaje.includes('idle') || mensaje.includes('waiting') || mensaje.includes('esperando')) {
-      subtitulo = 'Esperando respuesta';
-    } else {
-      subtitulo = 'Atención requerida';
-    }
-    cuerpo = evt.message || 'Claude requiere tu atención.';
+    // Cuerpo y subtítulo en español — NUNCA el evt.message inglés de Claude Code
+    // ("Claude needs your permission"), que mezclaba idiomas (regla es-MX).
+    ({ subtitulo, cuerpo } = clasificarNotificacion(evt.message));
 
   } else {
     tituloBase = `Evento ${nombreEvento}`;
     subtitulo  = 'Evento';
-    cuerpo     = evt.message || `Evento ${nombreEvento}`;
+    cuerpo     = 'Claude generó un evento que requiere tu atención.';
   }
 
   return {
@@ -262,14 +257,23 @@ async function run() {
     `<b>Estado:</b> ${escaparHtml(subtitulo)}\n\n` +
     `${escaparHtml(cuerpo)}`;
 
-  // Enviar notificación Telegram
+  // Enviar notificación Telegram. escaparContenido:false porque `texto` YA es
+  // HTML listo (tags <b> + contenido escapado arriba); re-escaparlo mostraría
+  // los tags literales en Telegram (doble escape, bug 2026-07-15).
   const resultado = await enviarMensaje(
     config.TELEGRAM_BOT_TOKEN,
     config.TELEGRAM_CHAT_ID,
-    texto
+    texto,
+    { escaparContenido: false }
   );
 
   log('telegram resultado', resultado.ok ? 'ok' : resultado.error);
 }
 
+// Sin gate de entrypoint: los hooks se invocan vía el wrapper
+// `node -e "require('./hooks/notificacion-telegram.js')"` de settings.json (y
+// desde los wrappers -notification/-subagent), donde require.main es undefined;
+// un gate de entrypoint dejaría el hook muerto en producción (audit
+// entrypoint-wrapper.test.js). Las funciones puras testeables viven en
+// ./lib/notificacion-formato.js.
 run().catch(e => log('run error', e && e.message));

package/hooks/preservar-estado-pre-compact.js

@@ -20,7 +20,7 @@
  */
 
 const fs   = require('fs');
-const { raizProyecto } = require('./lib/raiz-proyecto');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 
 // Atomic write para backups pre-compact (.planning/backups/). Si la

package/hooks/registro-turnos.js

@@ -54,7 +54,7 @@
  */
 
 const fs = require('fs');
-const { raizProyecto } = require('./lib/raiz-proyecto');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 
 const LIMITE_TURNOS = parseInt(process.env.SWL_REGISTRO_TURNOS_LIMITE || '1000', 10);

package/hooks/resumen-sesion.js

@@ -18,7 +18,7 @@
  */
 
 const fs     = require('fs');
-const { raizProyecto } = require('./lib/raiz-proyecto');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path   = require('path');
 const os     = require('os');
 const { execFile } = require('child_process');

package/hooks/risk-scoring.js

@@ -26,7 +26,7 @@
  */
 
 const fs   = require('fs');
-const { raizProyecto } = require('./lib/raiz-proyecto');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const os   = require('os');
 

package/hooks/session-briefing.js

@@ -19,7 +19,7 @@
  */
 
 const fs = require('fs');
-const { raizProyecto } = require('./lib/raiz-proyecto');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const { spawn } = require('child_process');
 
@@ -91,14 +91,22 @@ function resolverRutaCliCiclo() {
  * Dispara la Fase A del ciclo autónomo en un proceso separado
  * (fire-and-forget, `detached` + `unref`) cuando el motor está habilitado y
  * pasaron >=24h desde la última corrida (o nunca corrió). Guard barato
- * PRIMERO: si no existe `.planning/evolution/ciclo-config.json`, retorna sin
- * requerir ninguna lib del ciclo — la inmensa mayoría de proyectos nunca lo
- * habilitó y el presupuesto de este hook (<200ms) no debe pagar ese costo.
+ * PRIMERO: si no existe el DIRECTORIO `.planning/evolution/`, el proyecto no
+ * tiene telemetría SWL y se retorna sin requerir ninguna lib del ciclo (el
+ * presupuesto de este hook <200ms no debe pagar ese costo).
+ *
+ * NO se gatea por la existencia de `ciclo-config.json` (era el guard del
+ * diseño opt-in viejo): el motor NACE ENCENDIDO (opt-out estricto, decisión
+ * del usuario 2026-07-10), así que `debeDisparar` honra `estaHabilitado`
+ * on-by-default aunque el config no exista — gatear por el archivo lo dejaba
+ * de facto opt-in y el ciclo nunca corría en proyectos que jamás ejecutaron
+ * `/swl:evolucion-continua on` (bug 2026-07-15).
+ *
  * El hook NO espera el resultado; el lock propio del ciclo (T-02) garantiza
  * que no haya doble corrida con el scheduler cron.
  */
 function dispararCicloAutonomoSiToca(cwd, hoy) {
-  if (!fs.existsSync(path.join(cwd, '.planning', 'evolution', 'ciclo-config.json'))) return;
+  if (!fs.existsSync(path.join(cwd, '.planning', 'evolution'))) return;
 
   const fallback = resolverFallbackCiclo();
   if (!fallback) return;

package/hooks/spec-gate.js

@@ -32,7 +32,7 @@
  */
 
 const fs = require('fs');
-const { raizProyecto } = require('./lib/raiz-proyecto');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const crypto = require('crypto');
 

package/hooks/sugerir-regenerar-inventario.js

@@ -27,7 +27,7 @@
  */
 
 const fs = require('fs');
-const { raizProyecto } = require('./lib/raiz-proyecto');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 
 // Carpetas cuyo cambio invalida los contadores de INVENTARIO.md

package/hooks/tdd-gate.js

@@ -30,7 +30,7 @@
  */
 
 const fs = require('fs');
-const { raizProyecto } = require('./lib/raiz-proyecto');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const { execFileSync } = require('child_process');