@saulwade/swl-ses 2.6.1 → 2.8.0

package/hooks/lib/notificacion-formato.js

@@ -14,18 +14,21 @@
  */
 
 /**
- * Resume el último mensaje del asistente para una notificación: una alerta debe
- * ser un extracto BREVE y legible, no el volcado crudo del mensaje completo (que
- * mete tablas markdown, encabezados y cientos de líneas). Quita el ruido
- * estructural de markdown (fences de código, filas de tabla, reglas horizontales)
- * y el markdown inline (negritas, itálicas, código, enlaces, viñetas), y trunca a
- * `maxChars`.
+ * Prepara el último mensaje del asistente para una notificación de Telegram:
+ * limpia el ruido de markdown que Telegram no renderiza (fences de código, filas
+ * de tabla, reglas horizontales) y el markdown inline (negritas, itálicas,
+ * código, enlaces, viñetas), preservando el TEXTO COMPLETO. Solo trunca mensajes
+ * ENORMES que no caben en Telegram (~3500 chars el mensaje completo con el
+ * wrapper), y en ese caso corta en un límite natural (fin de línea u oración),
+ * nunca a media palabra. El default alto evita el corte agresivo previo (400
+ * chars) que dejaba mensajes útiles truncados (feedback 2026-07-15).
  *
  * @param {string} texto - Mensaje completo del asistente (markdown).
- * @param {number} [maxChars=400] - Largo máximo del extracto.
- * @returns {string} Extracto limpio y corto en texto plano.
+ * @param {number} [maxChars=3300] - Largo máximo del cuerpo (deja margen para el
+ *   título/labels dentro del límite de 3500 del cliente Telegram).
+ * @returns {string} Texto limpio (completo salvo mensajes enormes).
  */
-function resumirParaNotificacion(texto, maxChars = 400) {
+function resumirParaNotificacion(texto, maxChars = 3300) {
   if (!texto) return '';
   const limpias = [];
   let enFence = false;
@@ -52,7 +55,38 @@ function resumirParaNotificacion(texto, maxChars = 400) {
   }
   const resumen = limpias.join('\n').replace(/\n{3,}/g, '\n\n').trim();
   if (resumen.length <= maxChars) return resumen;
-  return resumen.slice(0, maxChars - 1).trimEnd() + '…';
+  // Mensaje enorme: cortar en el último límite natural antes de maxChars.
+  const corte = resumen.slice(0, maxChars - 1);
+  const limite = Math.max(
+    corte.lastIndexOf('\n'),
+    corte.lastIndexOf('. '),
+    corte.lastIndexOf('! '),
+    corte.lastIndexOf('? ')
+  );
+  const base = limite > (maxChars - 1) * 0.6 ? corte.slice(0, limite + 1) : corte;
+  return base.trimEnd() + '…';
 }
 
-module.exports = { resumirParaNotificacion };
+/**
+ * Clasifica el `message` de un evento Notification de Claude Code y devuelve
+ * subtítulo + cuerpo EN ESPAÑOL (regla es-MX de brevedad-output). El mensaje
+ * nativo de Claude Code viene en inglés ("Claude needs your permission",
+ * "Claude is waiting for your input"); volcarlo crudo mezclaba idiomas en la
+ * notificación (bug 2026-07-15). Se detecta la categoría por keyword (en/es) y
+ * se emite texto es-MX propio, nunca el `message` inglés.
+ *
+ * @param {string} mensaje - evt.message del evento Notification (puede venir en inglés).
+ * @returns {{subtitulo: string, cuerpo: string}} Ambos en español.
+ */
+function clasificarNotificacion(mensaje) {
+  const m = String(mensaje || '').toLowerCase();
+  if (m.includes('permission') || m.includes('permiso')) {
+    return { subtitulo: 'Permisos pendientes', cuerpo: 'Claude necesita tu permiso para continuar.' };
+  }
+  if (m.includes('idle') || m.includes('waiting') || m.includes('esperando')) {
+    return { subtitulo: 'Esperando respuesta', cuerpo: 'Claude está esperando tu respuesta.' };
+  }
+  return { subtitulo: 'Atención requerida', cuerpo: 'Claude requiere tu atención.' };
+}
+
+module.exports = { resumirParaNotificacion, clasificarNotificacion };

package/hooks/lib/provenance-tracker.js

@@ -1,191 +1,191 @@
-'use strict';
-
-/**
- * Provenance Tracker — Rastreo de proveniencia de skills y componentes.
- *
- * Registra de dónde viene cada skill/agente instalado: si es del core SWL,
- * de un repo externo, de auto-evolución, o de la comunidad. Genera y lee
- * archivos meta.json por componente.
- *
- * Patrón adoptado de skillshare (internal/install/meta.go).
- *
- * Zero dependencias externas.
- *
- * Uso:
- *   const { registrarProveniencia, leerProveniencia, listarProveniencias } = require('./lib/provenance-tracker');
- *
- *   registrarProveniencia('/ruta/skill', {
- *     origin: 'core',
- *     repoUrl: 'https://github.com/saulwadeleon/swl-ses',
- *     version: '5.6.3',
- *   });
- *
- *   const meta = leerProveniencia('/ruta/skill');
- *   // { origin: 'core', repoUrl: '...', version: '5.6.3', installedAt: '...' }
- *
- * @module hooks/lib/provenance-tracker
- */
-
-const fs   = require('fs');
-const path = require('path');
-
-// Escritura atómica obligatoria para meta.json (regla CLAUDE.md).
-let atomicWriteJSON;
-try {
-  ({ atomicWriteJSON } = require('./atomic-write'));
-} catch {
-  atomicWriteJSON = (p, o) => fs.writeFileSync(p, JSON.stringify(o, null, 2), 'utf8');
-}
-
-// ---------------------------------------------------------------------------
-// Constantes
-// ---------------------------------------------------------------------------
-
-const META_FILENAME = 'meta.json';
-
-/**
- * Orígenes válidos de un componente.
- * @readonly
- */
-const ORIGENES = Object.freeze({
-  CORE:           'core',           // Del paquete swl-ses
-  AUTO_EVOLUTION: 'auto-evolution', // Generado por /swl:evolucionar
-  IMPORTED:       'imported',       // Importado de repo externo
-  COMMUNITY:      'community',     // De skills.sh o similares
-  USERLAND:       'userland',       // Del usuario (_userland/)
-  ANTHROPIC:      'anthropic',      // De anthropics/skills
-});
-
-// ---------------------------------------------------------------------------
-// API pública
-// ---------------------------------------------------------------------------
-
-/**
- * Registra la proveniencia de un componente instalado.
- *
- * Crea o actualiza meta.json en el directorio del componente.
- *
- * @param {string} componentDir - Ruta al directorio del componente
- * @param {object} datos
- * @param {string} datos.origin     - Origen (ver ORIGENES)
- * @param {string} [datos.repoUrl]  - URL del repo de origen
- * @param {string} [datos.commit]   - Commit hash del origen
- * @param {string} [datos.version]  - Versión del sistema al instalar
- * @param {string} [datos.author]   - Autor o equipo
- * @param {string} [datos.note]     - Nota libre
- */
-function registrarProveniencia(componentDir, datos) {
-  const metaPath = path.join(componentDir, META_FILENAME);
-
-  const meta = {
-    origin: datos.origin || ORIGENES.CORE,
-    repoUrl: datos.repoUrl || null,
-    commit: datos.commit || null,
-    version: datos.version || null,
-    author: datos.author || null,
-    note: datos.note || null,
-    installedAt: new Date().toISOString(),
-    installedBy: `swl-ses v${datos.version || 'unknown'}`,
-  };
-
-  // Si ya existe, preservar datos anteriores y agregar historial
-  if (fs.existsSync(metaPath)) {
-    try {
-      const existing = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
-      // Mover datos anteriores a historial
-      if (!existing.history) existing.history = [];
-      const { history, ...prevData } = existing;
-      existing.history.push({ ...prevData, replacedAt: meta.installedAt });
-
-      // Actualizar con nuevos datos
-      Object.assign(existing, meta);
-      existing.history = existing.history.slice(-5); // Máximo 5 entradas de historial
-
-      atomicWriteJSON(metaPath, existing);
-    } catch {
-      // Error leyendo existente — sobrescribir
-      atomicWriteJSON(metaPath, meta);
-    }
-  } else {
-    atomicWriteJSON(metaPath, meta);
-  }
-}
-
-/**
- * Lee la proveniencia de un componente.
- *
- * @param {string} componentDir - Ruta al directorio del componente
- * @returns {object|null} Datos de proveniencia o null si no existe
- */
-function leerProveniencia(componentDir) {
-  const metaPath = path.join(componentDir, META_FILENAME);
-  if (!fs.existsSync(metaPath)) return null;
-
-  try {
-    return JSON.parse(fs.readFileSync(metaPath, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Lista la proveniencia de todos los componentes en un directorio.
- *
- * @param {string} parentDir - Directorio padre (ej: habilidades/)
- * @returns {Array<{ name: string, origin: string, version: string, installedAt: string }>}
- */
-function listarProveniencias(parentDir) {
-  if (!fs.existsSync(parentDir)) return [];
-
-  const resultado = [];
-  const entries = fs.readdirSync(parentDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const meta = leerProveniencia(path.join(parentDir, entry.name));
-    resultado.push({
-      name: entry.name,
-      origin: meta ? meta.origin : 'unknown',
-      version: meta ? meta.version : null,
-      installedAt: meta ? meta.installedAt : null,
-      repoUrl: meta ? meta.repoUrl : null,
-    });
-  }
-
-  return resultado;
-}
-
-/**
- * Genera un resumen de proveniencia por origen.
- *
- * @param {string} parentDir - Directorio padre
- * @returns {{ total: number, byOrigin: Object<string, number>, unknown: number }}
- */
-function resumenProveniencia(parentDir) {
-  const lista = listarProveniencias(parentDir);
-  const byOrigin = {};
-  let unknown = 0;
-
-  for (const item of lista) {
-    if (item.origin === 'unknown') {
-      unknown++;
-    } else {
-      byOrigin[item.origin] = (byOrigin[item.origin] || 0) + 1;
-    }
-  }
-
-  return { total: lista.length, byOrigin, unknown };
-}
-
-// ---------------------------------------------------------------------------
-// Exports
-// ---------------------------------------------------------------------------
-
-module.exports = {
-  registrarProveniencia,
-  leerProveniencia,
-  listarProveniencias,
-  resumenProveniencia,
-  ORIGENES,
-  META_FILENAME,
-};
+'use strict';
+
+/**
+ * Provenance Tracker — Rastreo de proveniencia de skills y componentes.
+ *
+ * Registra de dónde viene cada skill/agente instalado: si es del core SWL,
+ * de un repo externo, de auto-evolución, o de la comunidad. Genera y lee
+ * archivos meta.json por componente.
+ *
+ * Patrón adoptado de skillshare (internal/install/meta.go).
+ *
+ * Zero dependencias externas.
+ *
+ * Uso:
+ *   const { registrarProveniencia, leerProveniencia, listarProveniencias } = require('./lib/provenance-tracker');
+ *
+ *   registrarProveniencia('/ruta/skill', {
+ *     origin: 'core',
+ *     repoUrl: 'https://github.com/saulwadeleon/swl-ses',
+ *     version: '5.6.3',
+ *   });
+ *
+ *   const meta = leerProveniencia('/ruta/skill');
+ *   // { origin: 'core', repoUrl: '...', version: '5.6.3', installedAt: '...' }
+ *
+ * @module hooks/lib/provenance-tracker
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+// Escritura atómica obligatoria para meta.json (regla CLAUDE.md).
+let atomicWriteJSON;
+try {
+  ({ atomicWriteJSON } = require('./atomic-write'));
+} catch {
+  atomicWriteJSON = (p, o) => fs.writeFileSync(p, JSON.stringify(o, null, 2), 'utf8');
+}
+
+// ---------------------------------------------------------------------------
+// Constantes
+// ---------------------------------------------------------------------------
+
+const META_FILENAME = 'meta.json';
+
+/**
+ * Orígenes válidos de un componente.
+ * @readonly
+ */
+const ORIGENES = Object.freeze({
+  CORE:           'core',           // Del paquete swl-ses
+  AUTO_EVOLUTION: 'auto-evolution', // Generado por /swl:evolucionar
+  IMPORTED:       'imported',       // Importado de repo externo
+  COMMUNITY:      'community',     // De skills.sh o similares
+  USERLAND:       'userland',       // Del usuario (_userland/)
+  ANTHROPIC:      'anthropic',      // De anthropics/skills
+});
+
+// ---------------------------------------------------------------------------
+// API pública
+// ---------------------------------------------------------------------------
+
+/**
+ * Registra la proveniencia de un componente instalado.
+ *
+ * Crea o actualiza meta.json en el directorio del componente.
+ *
+ * @param {string} componentDir - Ruta al directorio del componente
+ * @param {object} datos
+ * @param {string} datos.origin     - Origen (ver ORIGENES)
+ * @param {string} [datos.repoUrl]  - URL del repo de origen
+ * @param {string} [datos.commit]   - Commit hash del origen
+ * @param {string} [datos.version]  - Versión del sistema al instalar
+ * @param {string} [datos.author]   - Autor o equipo
+ * @param {string} [datos.note]     - Nota libre
+ */
+function registrarProveniencia(componentDir, datos) {
+  const metaPath = path.join(componentDir, META_FILENAME);
+
+  const meta = {
+    origin: datos.origin || ORIGENES.CORE,
+    repoUrl: datos.repoUrl || null,
+    commit: datos.commit || null,
+    version: datos.version || null,
+    author: datos.author || null,
+    note: datos.note || null,
+    installedAt: new Date().toISOString(),
+    installedBy: `swl-ses v${datos.version || 'unknown'}`,
+  };
+
+  // Si ya existe, preservar datos anteriores y agregar historial
+  if (fs.existsSync(metaPath)) {
+    try {
+      const existing = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+      // Mover datos anteriores a historial
+      if (!existing.history) existing.history = [];
+      const { history, ...prevData } = existing;
+      existing.history.push({ ...prevData, replacedAt: meta.installedAt });
+
+      // Actualizar con nuevos datos
+      Object.assign(existing, meta);
+      existing.history = existing.history.slice(-5); // Máximo 5 entradas de historial
+
+      atomicWriteJSON(metaPath, existing);
+    } catch {
+      // Error leyendo existente — sobrescribir
+      atomicWriteJSON(metaPath, meta);
+    }
+  } else {
+    atomicWriteJSON(metaPath, meta);
+  }
+}
+
+/**
+ * Lee la proveniencia de un componente.
+ *
+ * @param {string} componentDir - Ruta al directorio del componente
+ * @returns {object|null} Datos de proveniencia o null si no existe
+ */
+function leerProveniencia(componentDir) {
+  const metaPath = path.join(componentDir, META_FILENAME);
+  if (!fs.existsSync(metaPath)) return null;
+
+  try {
+    return JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Lista la proveniencia de todos los componentes en un directorio.
+ *
+ * @param {string} parentDir - Directorio padre (ej: habilidades/)
+ * @returns {Array<{ name: string, origin: string, version: string, installedAt: string }>}
+ */
+function listarProveniencias(parentDir) {
+  if (!fs.existsSync(parentDir)) return [];
+
+  const resultado = [];
+  const entries = fs.readdirSync(parentDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const meta = leerProveniencia(path.join(parentDir, entry.name));
+    resultado.push({
+      name: entry.name,
+      origin: meta ? meta.origin : 'unknown',
+      version: meta ? meta.version : null,
+      installedAt: meta ? meta.installedAt : null,
+      repoUrl: meta ? meta.repoUrl : null,
+    });
+  }
+
+  return resultado;
+}
+
+/**
+ * Genera un resumen de proveniencia por origen.
+ *
+ * @param {string} parentDir - Directorio padre
+ * @returns {{ total: number, byOrigin: Object<string, number>, unknown: number }}
+ */
+function resumenProveniencia(parentDir) {
+  const lista = listarProveniencias(parentDir);
+  const byOrigin = {};
+  let unknown = 0;
+
+  for (const item of lista) {
+    if (item.origin === 'unknown') {
+      unknown++;
+    } else {
+      byOrigin[item.origin] = (byOrigin[item.origin] || 0) + 1;
+    }
+  }
+
+  return { total: lista.length, byOrigin, unknown };
+}
+
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+
+module.exports = {
+  registrarProveniencia,
+  leerProveniencia,
+  listarProveniencias,
+  resumenProveniencia,
+  ORIGENES,
+  META_FILENAME,
+};

package/hooks/lib/raiz-proyecto.js

@@ -87,13 +87,14 @@ function canonicalizar(p) {
 }
 
 /**
- * Resuelve la raíz del proyecto a la que deben anclarse las escrituras
- * de `.planning/`.
+ * Ancla base: asciende desde `desde` buscando la raíz del proyecto (marcadores
+ * o `.git`), con frontera del HOME. Ver reglas de resolución en el docstring
+ * del módulo. Sin post-proceso de redirección (eso lo hace raizProyecto).
  *
  * @param {string} [desde] - Directorio de partida (default: process.cwd()).
- * @returns {string} Ruta absoluta de la raíz del proyecto.
+ * @returns {string} Ruta absoluta del ancla base.
  */
-function raizProyecto(desde) {
+function _anclaBase(desde) {
   const inicio = path.resolve(desde || process.cwd());
   let actual = inicio;
   let homedirCanon = null;
@@ -124,4 +125,34 @@ function raizProyecto(desde) {
   return inicio;
 }
 
+/**
+ * Resuelve la raíz del proyecto a la que deben anclarse las escrituras
+ * de `.planning/`.
+ *
+ * Redirección de telemetría (fix 2026-07-15): si el ancla resuelta es el HOME
+ * del usuario y el HOME NO es un proyecto SWL real (solo un `.git` de dotfiles
+ * o un fallback sin proyecto), NINGÚN hook debe sembrar `.planning/` en la raíz
+ * del HOME — se contiene en `~/.claude/` (mismo scope que los backups del
+ * install global, A3). Esto arregla los 33 hooks que anclan vía esta función
+ * en un solo punto, sin tocarlos. Un proyecto SWL real EN el HOME (con
+ * marcadores de proyecto) se respeta.
+ *
+ * @param {string} [desde] - Directorio de partida (default: process.cwd()).
+ * @returns {string} Ruta absoluta de la raíz del proyecto (o ~/.claude si el
+ *   HOME no es un proyecto).
+ */
+function raizProyecto(desde) {
+  const raiz = _anclaBase(desde);
+  let homedirCanon = null;
+  try {
+    homedirCanon = canonicalizar(path.resolve(os.homedir()));
+  } catch (_) {
+    return raiz; // sin home resolvible — no redirigir
+  }
+  if (canonicalizar(raiz) === homedirCanon && !tienePlanningReal(raiz)) {
+    try { return path.join(os.homedir(), '.claude'); } catch (_) { return raiz; }
+  }
+  return raiz;
+}
+
 module.exports = { raizProyecto, tienePlanningReal, canonicalizar };