@saulwade/swl-ses 2.6.1 → 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,7 +23,7 @@ const path = require('node:path');
 
 const { cargarConfig, estaMuted } = require('./lib/telegram-config');
 const { enviarMensaje, escaparHtml } = require('./lib/telegram-cliente');
-const { resumirParaNotificacion } = require('./lib/notificacion-formato');
+const { resumirParaNotificacion, clasificarNotificacion } = require('./lib/notificacion-formato');
 
 // ----------------------------------------------------------------
 // Utilidades de logging
@@ -126,20 +126,14 @@ function construirCampos(nombreEvento, nombreProyecto, transcriptPath, evt) {
 
   } 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 {

package/hooks/session-briefing.js

@@ -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/instintos/autonomia.yaml

@@ -1,27 +1,27 @@
-# Dial de autonomía — SWL-SES (Fase 13, ADR-0037)
-#
-# Presupuesto de autonomía por clase de riesgo. Consumido por hooks/lib/autonomia.js
-# (orquestador y agentes ALTO leen el dial como GUÍA; no es un gate bloqueante en v1).
-#
-# Defaults = los controles vigentes de reglas/seguridad-agentes.md. Este archivo
-# NO relaja ningún control: lo hace visible y ajustable. El dial sube SOLO por
-# decisión explícita del usuario, nunca por conveniencia del agente.
-#
-# Niveles válidos por clase:
-#   total                -> acción autónoma sin checkpoint (lectura/análisis).
-#   con_auto_checkpoint  -> autónoma, pero registra un auto-checkpoint antes de actuar.
-#   hitl                 -> requiere confirmación humana siempre.
-# Cualquier valor desconocido se degrada a 'hitl' (nunca relaja).
-#
-# Estructura PLANA obligatoria (1 nivel bajo `clases:`) — ver 13-PLAN.md.
-
-version: "1.0"
-generado: "2026-06-11"
-defaults: seguridad-agentes.md
-clases:
-  lectura_analisis: total
-  # Subido a `total` por decisión explícita del usuario (2026-06-11, cierre Fase 13):
-  # cambios reversibles autónomos sin auto-checkpoint. Los commits atómicos siguen
-  # siendo el mecanismo de rollback. Default de seguridad-agentes.md era con_auto_checkpoint.
-  cambio_reversible: total
-  migracion_auth_push_publish: hitl
+# Dial de autonomía — SWL-SES (Fase 13, ADR-0037)
+#
+# Presupuesto de autonomía por clase de riesgo. Consumido por hooks/lib/autonomia.js
+# (orquestador y agentes ALTO leen el dial como GUÍA; no es un gate bloqueante en v1).
+#
+# Defaults = los controles vigentes de reglas/seguridad-agentes.md. Este archivo
+# NO relaja ningún control: lo hace visible y ajustable. El dial sube SOLO por
+# decisión explícita del usuario, nunca por conveniencia del agente.
+#
+# Niveles válidos por clase:
+#   total                -> acción autónoma sin checkpoint (lectura/análisis).
+#   con_auto_checkpoint  -> autónoma, pero registra un auto-checkpoint antes de actuar.
+#   hitl                 -> requiere confirmación humana siempre.
+# Cualquier valor desconocido se degrada a 'hitl' (nunca relaja).
+#
+# Estructura PLANA obligatoria (1 nivel bajo `clases:`) — ver 13-PLAN.md.
+
+version: "1.0"
+generado: "2026-06-11"
+defaults: seguridad-agentes.md
+clases:
+  lectura_analisis: total
+  # Subido a `total` por decisión explícita del usuario (2026-06-11, cierre Fase 13):
+  # cambios reversibles autónomos sin auto-checkpoint. Los commits atómicos siguen
+  # siendo el mecanismo de rollback. Default de seguridad-agentes.md era con_auto_checkpoint.
+  cambio_reversible: total
+  migracion_auth_push_publish: hitl