@saulwade/swl-ses 1.9.0 → 2.0.0

package/hooks/{actualizar-perfil-usuario.js → lib/etapa-perfil-usuario.js}

@@ -1,364 +1,376 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * Hook: actualizar-perfil-usuario.js
- * Tipo: Stop (async: true — fire-and-forget)
- * Registrado en: Stop (matcher vacío)
- *
- * Detecta señales en la sesión que justifican actualizar el modelo
- * persistente del usuario (instintos/perfil-usuario.yaml).
- *
- * No modifica el perfil directamente — solo acumula señales en un
- * "dirty-bit" (.planning/user-profile/dirty.json) y, cuando el umbral
- * se cruza, emite un nudge por stderr sugiriendo invocar el agente
- * perfilador-usuario-swl.
- *
- * Señales detectadas (en input stdin con la transcripción de la sesión):
- *   1. Correcciones del usuario: "no así", "mejor", "en vez de",
- *      "en lugar de", "evita", "nunca", "siempre quiero", "prefiero".
- *   2. Preferencias explícitas: "me gusta", "quiero que", "recuerda que",
- *      "a partir de ahora".
- *   3. Aprendizajes nuevos en .planning/APRENDIZAJES.md desde la última corrida.
- *   4. Instintos con evidence_count >= 3 en instintos/proyecto.yaml.
- *
- * Umbral por defecto: 3 señales acumuladas → nudge.
- *
- * El hook nunca bloquea (siempre exit 0). Zero-dependencies.
- */
-
-const fs   = require('fs');
-const path = require('path');
-
-let atomicWriteJSON;
-try {
-  ({ atomicWriteJSON } = require('./lib/atomic-write'));
-} catch {
-  // Fallback sin atomic-write si la librería no está (ej. en test aislado)
-  atomicWriteJSON = (p, obj) => fs.writeFileSync(p, JSON.stringify(obj, null, 2), 'utf8');
-}
-
-// Scanner de prompt injection — patrón adoptado de Hermes memory_tool.py.
-// Si la librería no está disponible (test aislado), fallback permisivo.
-let scanInjection;
-try {
-  ({ scan: scanInjection } = require('./lib/prompt-injection-scanner'));
-} catch {
-  scanInjection = () => ({ safe: true, threats: [], criticalCount: 0, highCount: 0 });
-}
-
-// Nudge tracker — registra cada nudge para medir tasa de acción.
-let nudgeTracker;
-try {
-  nudgeTracker = require('./lib/nudge-tracker');
-} catch {
-  nudgeTracker = null;
-}
-
-// ---------------------------------------------------------------------------
-// Configuración
-// ---------------------------------------------------------------------------
-
-const UMBRAL_NUDGE = parseInt(process.env.SWL_PERFIL_UMBRAL || '3', 10);
-const DIR_PERFIL   = path.join(process.cwd(), '.planning', 'user-profile');
-const DIRTY_PATH   = path.join(DIR_PERFIL, 'dirty.json');
-const PERFIL_PATH  = path.join(process.cwd(), 'instintos', 'perfil-usuario.yaml');
-const APRENDIZAJES_PATH = path.join(process.cwd(), '.planning', 'APRENDIZAJES.md');
-const INSTINTOS_PATH    = path.join(process.cwd(), 'instintos', 'proyecto.yaml');
-
-// Keywords de corrección (señal fuerte: el usuario está corrigiendo)
-const KEYWORDS_CORRECCION = [
-  'no así', 'no asi', 'mejor', 'en vez de', 'en lugar de',
-  'evita', 'evites', 'no uses', 'nunca uses', 'nunca hagas',
-  'siempre quiero', 'siempre usa', 'prefiero', 'prefiere',
-  'no me gusta', 'deja de',
-];
-
-// Keywords de preferencia explícita (señal media)
-const KEYWORDS_PREFERENCIA = [
-  'me gusta', 'quiero que', 'recuerda que', 'a partir de ahora',
-  'de ahora en adelante', 'ten en cuenta',
-];
-
-// ---------------------------------------------------------------------------
-// Utilidades
-// ---------------------------------------------------------------------------
-
-function ensureDir(dir) {
-  try { fs.mkdirSync(dir, { recursive: true }); } catch { /* ignore */ }
-}
-
-function leerDirty() {
-  try {
-    const raw = fs.readFileSync(DIRTY_PATH, 'utf8');
-    return JSON.parse(raw);
-  } catch {
-    // Primera corrida: inicializar snapshot al estado actual para no
-    // generar falsos "nuevos" por el histórico preexistente.
-    return {
-      version: '1.0',
-      creado: new Date().toISOString(),
-      senales: [],
-      ultima_nudge: null,
-      snapshot: {
-        aprendizajes_headers: contarAprendizajesNuevos(0),
-        instintos_maduros: contarInstintosMaduros(),
-      },
-      primera_corrida: true,
-    };
-  }
-}
-
-function escribirDirty(estado) {
-  ensureDir(DIR_PERFIL);
-  atomicWriteJSON(DIRTY_PATH, estado);
-}
-
-function contarLineasArchivo(p) {
-  try {
-    return fs.readFileSync(p, 'utf8').split(/\r?\n/).length;
-  } catch {
-    return 0;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Detectores de señales
-// ---------------------------------------------------------------------------
-
-/**
- * Busca keywords de corrección/preferencia en el texto.
- * @returns {Array<{tipo:string, keyword:string, snippet:string}>}
- */
-function detectarKeywords(texto) {
-  if (!texto || typeof texto !== 'string') return [];
-  const textoLow = texto.toLowerCase();
-  const señales = [];
-
-  for (const kw of KEYWORDS_CORRECCION) {
-    const idx = textoLow.indexOf(kw);
-    if (idx !== -1) {
-      señales.push({
-        tipo: 'correccion',
-        keyword: kw,
-        snippet: texto.slice(Math.max(0, idx - 20), idx + kw.length + 60).trim(),
-      });
-    }
-  }
-  for (const kw of KEYWORDS_PREFERENCIA) {
-    const idx = textoLow.indexOf(kw);
-    if (idx !== -1) {
-      señales.push({
-        tipo: 'preferencia',
-        keyword: kw,
-        snippet: texto.slice(Math.max(0, idx - 20), idx + kw.length + 60).trim(),
-      });
-    }
-  }
-
-  return señales;
-}
-
-/**
- * Cuenta entradas en APRENDIZAJES.md desde una línea de referencia.
- * @returns {number} cantidad de entradas nuevas
- */
-function contarAprendizajesNuevos(lineaReferencia) {
-  try {
-    const contenido = fs.readFileSync(APRENDIZAJES_PATH, 'utf8');
-    const lineas = contenido.split(/\r?\n/);
-    const headers = lineas.filter(l => /^##\s+\[\d{4}-\d{2}-\d{2}\]/.test(l));
-    const headersAntes = Math.max(0, lineaReferencia);
-    return Math.max(0, headers.length - headersAntes);
-  } catch {
-    return 0;
-  }
-}
-
-/**
- * Cuenta instintos con evidence_count >= 3 en instintos/proyecto.yaml.
- * @returns {number}
- */
-function contarInstintosMaduros() {
-  try {
-    const contenido = fs.readFileSync(INSTINTOS_PATH, 'utf8');
-    const matches = contenido.match(/evidence_count:\s*([3-9]|\d{2,})/g);
-    return matches ? matches.length : 0;
-  } catch {
-    return 0;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Extracción del texto del usuario desde stdin del hook
-// ---------------------------------------------------------------------------
-
-/**
- * Extrae los prompts del usuario de la transcripción que Claude Code pasa
- * al hook Stop. El input viene como JSON con un array de mensajes.
- *
- * @param {string} inputRaw
- * @returns {string} concatenación de prompts del usuario
- */
-function extraerPromptsUsuario(inputRaw) {
-  if (!inputRaw) return '';
-  try {
-    const data = JSON.parse(inputRaw);
-    // Estructuras comunes: { messages: [...] } o { transcript: [...] }
-    const mensajes = data.messages || data.transcript || data.conversation || [];
-    if (!Array.isArray(mensajes)) return '';
-
-    return mensajes
-      .filter(m => m && (m.role === 'user' || m.type === 'user'))
-      .map(m => {
-        if (typeof m.content === 'string') return m.content;
-        if (Array.isArray(m.content)) {
-          return m.content
-            .filter(c => c && c.type === 'text' && typeof c.text === 'string')
-            .map(c => c.text)
-            .join('\n');
-        }
-        return '';
-      })
-      .join('\n\n');
-  } catch {
-    return '';
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Entrypoint
-// ---------------------------------------------------------------------------
-
-let inputRaw = '';
-process.stdin.on('data', chunk => { inputRaw += chunk; });
-
-process.stdin.on('end', () => {
-  try {
-    const textoUsuario = extraerPromptsUsuario(inputRaw);
-
-    const estado = leerDirty();
-    const totalPrevio = estado.senales.length;
-
-    // 1. Señales desde el texto del usuario, con escaneo de prompt injection
-    //    sobre cada snippet antes de persistir. Patrón adoptado de
-    //    Hermes memory_tool.py: el contenido que entra a memoria persistente
-    //    debe escanearse por inyección — de lo contrario un atacante con
-    //    acceso al prompt puede inyectar instrucciones que luego se recargan
-    //    cada sesión.
-    const señalesKw = detectarKeywords(textoUsuario)
-      .map(s => {
-        const r = scanInjection(s.snippet, 'perfil-usuario/dirty.json');
-        return { ...s, _scan: r };
-      })
-      .filter(s => {
-        // Descartar snippets con amenazas CRÍTICAS (prompt injection directa)
-        if (s._scan.criticalCount > 0) {
-          process.stderr.write(
-            `[perfil-usuario] señal descartada por injection crítica (${s._scan.threats[0]?.type}): keyword="${s.keyword}"\n`
-          );
-          return false;
-        }
-        return true;
-      })
-      .map(s => {
-        // Conservar snippet pero marcar si hubo patrones high (no críticos)
-        const out = { tipo: s.tipo, keyword: s.keyword, snippet: s.snippet };
-        if (s._scan.highCount > 0) {
-          out.warnings = s._scan.threats
-            .filter(t => t.severity === 'high')
-            .map(t => t.type);
-        }
-        return out;
-      });
-
-    // 2. Aprendizajes nuevos (delta desde el último snapshot)
-    //    En la primera corrida NO contamos histórico como "nuevo".
-    const snapshot = estado.snapshot || { aprendizajes_headers: 0, instintos_maduros: 0 };
-    const instintosMadurosActual = contarInstintosMaduros();
-    const aprendizajesNuevos = estado.primera_corrida
-      ? 0
-      : contarAprendizajesNuevos(snapshot.aprendizajes_headers);
-    const instintosNuevos = estado.primera_corrida
-      ? 0
-      : Math.max(0, instintosMadurosActual - snapshot.instintos_maduros);
-
-    delete estado.primera_corrida;
-
-    // 3. Agregar al dirty-bit
-    const ahora = new Date().toISOString();
-    const nuevas = [
-      ...señalesKw.map(s => ({ ...s, ts: ahora })),
-      ...(aprendizajesNuevos > 0
-        ? [{ tipo: 'aprendizaje-nuevo', count: aprendizajesNuevos, ts: ahora }]
-        : []),
-      ...(instintosNuevos > 0
-        ? [{ tipo: 'instinto-maduro', count: instintosNuevos, ts: ahora }]
-        : []),
-    ];
-
-    if (nuevas.length === 0) {
-      // Nada que registrar — actualizar snapshot y salir
-      estado.snapshot = {
-        aprendizajes_headers: contarAprendizajesNuevos(0),
-        instintos_maduros: instintosMadurosActual,
-      };
-      escribirDirty(estado);
-      return;
-    }
-
-    estado.senales.push(...nuevas);
-    estado.snapshot = {
-      aprendizajes_headers: contarAprendizajesNuevos(0),
-      instintos_maduros: instintosMadurosActual,
-    };
-
-    // 4. Verificar umbral para nudge
-    const total = estado.senales.length;
-    const cruzaUmbral = totalPrevio < UMBRAL_NUDGE && total >= UMBRAL_NUDGE;
-
-    // Evitar nudges repetidos: solo uno por día
-    let hacerNudge = cruzaUmbral;
-    if (hacerNudge && estado.ultima_nudge) {
-      const horas = (Date.now() - new Date(estado.ultima_nudge).getTime()) / 3600000;
-      if (horas < 24) hacerNudge = false;
-    }
-
-    if (hacerNudge) {
-      estado.ultima_nudge = ahora;
-
-      const perfilExiste = fs.existsSync(PERFIL_PATH);
-      const accion = perfilExiste
-        ? 'actualizar tu perfil de usuario'
-        : 'inicializar tu perfil de usuario';
-
-      const mensaje = [
-        '',
-        `[perfil-usuario] ${total} señales acumuladas sin consolidar.`,
-        `  Para ${accion}, invoca el agente:`,
-        `    "actualiza mi perfil de usuario"`,
-        `  (ejecuta el agente perfilador-usuario-swl)`,
-        '',
-      ].join('\n');
-
-      process.stderr.write(mensaje);
-
-      // Registrar en nudge-tracker para medir tasa de acción
-      if (nudgeTracker) {
-        try {
-          nudgeTracker.emit({
-            kind: 'perfil-usuario',
-            target: 'perfilador-usuario-swl',
-            message: mensaje.trim(),
-            source: 'hooks/actualizar-perfil-usuario.js',
-            data: { senalesAcumuladas: total },
-          });
-        } catch { /* silencioso */ }
-      }
-    }
-
-    escribirDirty(estado);
-  } catch {
-    // Nunca bloquear por error interno
-  }
-});
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Hook: actualizar-perfil-usuario.js
+ * Tipo: Stop (async: true — fire-and-forget)
+ * Registrado en: Stop (matcher vacío)
+ *
+ * Detecta señales en la sesión que justifican actualizar el modelo
+ * persistente del usuario (instintos/perfil-usuario.yaml).
+ *
+ * No modifica el perfil directamente — solo acumula señales en un
+ * "dirty-bit" (.planning/user-profile/dirty.json) y, cuando el umbral
+ * se cruza, emite un nudge por stderr sugiriendo invocar el agente
+ * perfilador-usuario-swl.
+ *
+ * Señales detectadas (en input stdin con la transcripción de la sesión):
+ *   1. Correcciones del usuario: "no así", "mejor", "en vez de",
+ *      "en lugar de", "evita", "nunca", "siempre quiero", "prefiero".
+ *   2. Preferencias explícitas: "me gusta", "quiero que", "recuerda que",
+ *      "a partir de ahora".
+ *   3. Aprendizajes nuevos en .planning/APRENDIZAJES.md desde la última corrida.
+ *   4. Instintos con evidence_count >= 3 en instintos/proyecto.yaml.
+ *
+ * Umbral por defecto: 3 señales acumuladas → nudge.
+ *
+ * El hook nunca bloquea (siempre exit 0). Zero-dependencies.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+let atomicWriteJSON;
+try {
+  ({ atomicWriteJSON } = require('./atomic-write'));
+} catch {
+  // Fallback sin atomic-write si la librería no está (ej. en test aislado)
+  atomicWriteJSON = (p, obj) => fs.writeFileSync(p, JSON.stringify(obj, null, 2), 'utf8');
+}
+
+// Scanner de prompt injection — patrón adoptado de Hermes memory_tool.py.
+// Si la librería no está disponible (test aislado), fallback permisivo.
+let scanInjection;
+try {
+  ({ scan: scanInjection } = require('./prompt-injection-scanner'));
+} catch {
+  scanInjection = () => ({ safe: true, threats: [], criticalCount: 0, highCount: 0 });
+}
+
+// Nudge tracker — registra cada nudge para medir tasa de acción.
+let nudgeTracker;
+try {
+  nudgeTracker = require('./nudge-tracker');
+} catch {
+  nudgeTracker = null;
+}
+
+// ---------------------------------------------------------------------------
+// Configuración
+// ---------------------------------------------------------------------------
+
+const UMBRAL_NUDGE = parseInt(process.env.SWL_PERFIL_UMBRAL || '3', 10);
+const DIR_PERFIL   = path.join(process.cwd(), '.planning', 'user-profile');
+const DIRTY_PATH   = path.join(DIR_PERFIL, 'dirty.json');
+const PERFIL_PATH  = path.join(process.cwd(), 'instintos', 'perfil-usuario.yaml');
+const APRENDIZAJES_PATH = path.join(process.cwd(), '.planning', 'APRENDIZAJES.md');
+const INSTINTOS_PATH    = path.join(process.cwd(), 'instintos', 'proyecto.yaml');
+
+// Keywords de corrección (señal fuerte: el usuario está corrigiendo)
+const KEYWORDS_CORRECCION = [
+  'no así', 'no asi', 'mejor', 'en vez de', 'en lugar de',
+  'evita', 'evites', 'no uses', 'nunca uses', 'nunca hagas',
+  'siempre quiero', 'siempre usa', 'prefiero', 'prefiere',
+  'no me gusta', 'deja de',
+];
+
+// Keywords de preferencia explícita (señal media)
+const KEYWORDS_PREFERENCIA = [
+  'me gusta', 'quiero que', 'recuerda que', 'a partir de ahora',
+  'de ahora en adelante', 'ten en cuenta',
+];
+
+// ---------------------------------------------------------------------------
+// Utilidades
+// ---------------------------------------------------------------------------
+
+function ensureDir(dir) {
+  try { fs.mkdirSync(dir, { recursive: true }); } catch { /* ignore */ }
+}
+
+function leerDirty() {
+  try {
+    const raw = fs.readFileSync(DIRTY_PATH, 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    // Primera corrida: inicializar snapshot al estado actual para no
+    // generar falsos "nuevos" por el histórico preexistente.
+    return {
+      version: '1.0',
+      creado: new Date().toISOString(),
+      senales: [],
+      ultima_nudge: null,
+      snapshot: {
+        aprendizajes_headers: contarAprendizajesNuevos(0),
+        instintos_maduros: contarInstintosMaduros(),
+      },
+      primera_corrida: true,
+    };
+  }
+}
+
+function escribirDirty(estado) {
+  ensureDir(DIR_PERFIL);
+  atomicWriteJSON(DIRTY_PATH, estado);
+}
+
+function contarLineasArchivo(p) {
+  try {
+    return fs.readFileSync(p, 'utf8').split(/\r?\n/).length;
+  } catch {
+    return 0;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Detectores de señales
+// ---------------------------------------------------------------------------
+
+/**
+ * Busca keywords de corrección/preferencia en el texto.
+ * @returns {Array<{tipo:string, keyword:string, snippet:string}>}
+ */
+function detectarKeywords(texto) {
+  if (!texto || typeof texto !== 'string') return [];
+  const textoLow = texto.toLowerCase();
+  const señales = [];
+
+  for (const kw of KEYWORDS_CORRECCION) {
+    const idx = textoLow.indexOf(kw);
+    if (idx !== -1) {
+      señales.push({
+        tipo: 'correccion',
+        keyword: kw,
+        snippet: texto.slice(Math.max(0, idx - 20), idx + kw.length + 60).trim(),
+      });
+    }
+  }
+  for (const kw of KEYWORDS_PREFERENCIA) {
+    const idx = textoLow.indexOf(kw);
+    if (idx !== -1) {
+      señales.push({
+        tipo: 'preferencia',
+        keyword: kw,
+        snippet: texto.slice(Math.max(0, idx - 20), idx + kw.length + 60).trim(),
+      });
+    }
+  }
+
+  return señales;
+}
+
+/**
+ * Cuenta entradas en APRENDIZAJES.md desde una línea de referencia.
+ * @returns {number} cantidad de entradas nuevas
+ */
+function contarAprendizajesNuevos(lineaReferencia) {
+  try {
+    const contenido = fs.readFileSync(APRENDIZAJES_PATH, 'utf8');
+    const lineas = contenido.split(/\r?\n/);
+    const headers = lineas.filter(l => /^##\s+\[\d{4}-\d{2}-\d{2}\]/.test(l));
+    const headersAntes = Math.max(0, lineaReferencia);
+    return Math.max(0, headers.length - headersAntes);
+  } catch {
+    return 0;
+  }
+}
+
+/**
+ * Cuenta instintos con evidence_count >= 3 en instintos/proyecto.yaml.
+ * @returns {number}
+ */
+function contarInstintosMaduros() {
+  try {
+    const contenido = fs.readFileSync(INSTINTOS_PATH, 'utf8');
+    const matches = contenido.match(/evidence_count:\s*([3-9]|\d{2,})/g);
+    return matches ? matches.length : 0;
+  } catch {
+    return 0;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Extracción del texto del usuario desde stdin del hook
+// ---------------------------------------------------------------------------
+
+/**
+ * Extrae los prompts del usuario de la transcripción que Claude Code pasa
+ * al hook Stop. El input viene como JSON con un array de mensajes.
+ *
+ * @param {string} inputRaw
+ * @returns {string} concatenación de prompts del usuario
+ */
+function extraerPromptsUsuario(inputRaw) {
+  if (!inputRaw) return '';
+  try {
+    const data = JSON.parse(inputRaw);
+    // Estructuras comunes: { messages: [...] } o { transcript: [...] }
+    const mensajes = data.messages || data.transcript || data.conversation || [];
+    if (!Array.isArray(mensajes)) return '';
+
+    return mensajes
+      .filter(m => m && (m.role === 'user' || m.type === 'user'))
+      .map(m => {
+        if (typeof m.content === 'string') return m.content;
+        if (Array.isArray(m.content)) {
+          return m.content
+            .filter(c => c && c.type === 'text' && typeof c.text === 'string')
+            .map(c => c.text)
+            .join('\n');
+        }
+        return '';
+      })
+      .join('\n\n');
+  } catch {
+    return '';
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Entrypoint
+// ---------------------------------------------------------------------------
+
+/**
+ * Etapa de actualización del perfil de usuario (sub-etapa de hooks/ciclo-evolucion.js).
+ * Consume la transcripción de stdin para detectar señales del usuario.
+ * Best-effort: nunca lanza.
+ * @param {string} inputRaw transcripción de la sesión (payload del hook Stop)
+ */
+function ejecutar(inputRaw) {
+  try {
+    const textoUsuario = extraerPromptsUsuario(inputRaw);
+
+    const estado = leerDirty();
+    const totalPrevio = estado.senales.length;
+
+    // 1. Señales desde el texto del usuario, con escaneo de prompt injection
+    //    sobre cada snippet antes de persistir. Patrón adoptado de
+    //    Hermes memory_tool.py: el contenido que entra a memoria persistente
+    //    debe escanearse por inyección — de lo contrario un atacante con
+    //    acceso al prompt puede inyectar instrucciones que luego se recargan
+    //    cada sesión.
+    const señalesKw = detectarKeywords(textoUsuario)
+      .map(s => {
+        const r = scanInjection(s.snippet, 'perfil-usuario/dirty.json');
+        return { ...s, _scan: r };
+      })
+      .filter(s => {
+        // Descartar snippets con amenazas CRÍTICAS (prompt injection directa)
+        if (s._scan.criticalCount > 0) {
+          process.stderr.write(
+            `[perfil-usuario] señal descartada por injection crítica (${s._scan.threats[0]?.type}): keyword="${s.keyword}"\n`
+          );
+          return false;
+        }
+        return true;
+      })
+      .map(s => {
+        // Conservar snippet pero marcar si hubo patrones high (no críticos)
+        const out = { tipo: s.tipo, keyword: s.keyword, snippet: s.snippet };
+        if (s._scan.highCount > 0) {
+          out.warnings = s._scan.threats
+            .filter(t => t.severity === 'high')
+            .map(t => t.type);
+        }
+        return out;
+      });
+
+    // 2. Aprendizajes nuevos (delta desde el último snapshot)
+    //    En la primera corrida NO contamos histórico como "nuevo".
+    const snapshot = estado.snapshot || { aprendizajes_headers: 0, instintos_maduros: 0 };
+    const instintosMadurosActual = contarInstintosMaduros();
+    const aprendizajesNuevos = estado.primera_corrida
+      ? 0
+      : contarAprendizajesNuevos(snapshot.aprendizajes_headers);
+    const instintosNuevos = estado.primera_corrida
+      ? 0
+      : Math.max(0, instintosMadurosActual - snapshot.instintos_maduros);
+
+    delete estado.primera_corrida;
+
+    // 3. Agregar al dirty-bit
+    const ahora = new Date().toISOString();
+    const nuevas = [
+      ...señalesKw.map(s => ({ ...s, ts: ahora })),
+      ...(aprendizajesNuevos > 0
+        ? [{ tipo: 'aprendizaje-nuevo', count: aprendizajesNuevos, ts: ahora }]
+        : []),
+      ...(instintosNuevos > 0
+        ? [{ tipo: 'instinto-maduro', count: instintosNuevos, ts: ahora }]
+        : []),
+    ];
+
+    if (nuevas.length === 0) {
+      // Nada que registrar — actualizar snapshot y salir
+      estado.snapshot = {
+        aprendizajes_headers: contarAprendizajesNuevos(0),
+        instintos_maduros: instintosMadurosActual,
+      };
+      escribirDirty(estado);
+      return;
+    }
+
+    estado.senales.push(...nuevas);
+    estado.snapshot = {
+      aprendizajes_headers: contarAprendizajesNuevos(0),
+      instintos_maduros: instintosMadurosActual,
+    };
+
+    // 4. Verificar umbral para nudge
+    const total = estado.senales.length;
+    const cruzaUmbral = totalPrevio < UMBRAL_NUDGE && total >= UMBRAL_NUDGE;
+
+    // Evitar nudges repetidos: solo uno por día
+    let hacerNudge = cruzaUmbral;
+    if (hacerNudge && estado.ultima_nudge) {
+      const horas = (Date.now() - new Date(estado.ultima_nudge).getTime()) / 3600000;
+      if (horas < 24) hacerNudge = false;
+    }
+
+    if (hacerNudge) {
+      estado.ultima_nudge = ahora;
+
+      const perfilExiste = fs.existsSync(PERFIL_PATH);
+      const accion = perfilExiste
+        ? 'actualizar tu perfil de usuario'
+        : 'inicializar tu perfil de usuario';
+
+      const mensaje = [
+        '',
+        `[perfil-usuario] ${total} señales acumuladas sin consolidar.`,
+        `  Para ${accion}, invoca el agente:`,
+        `    "actualiza mi perfil de usuario"`,
+        `  (ejecuta el agente perfilador-usuario-swl)`,
+        '',
+      ].join('\n');
+
+      process.stderr.write(mensaje);
+
+      // Registrar en nudge-tracker para medir tasa de acción
+      if (nudgeTracker) {
+        try {
+          nudgeTracker.emit({
+            kind: 'perfil-usuario',
+            target: 'perfilador-usuario-swl',
+            message: mensaje.trim(),
+            source: 'hooks/actualizar-perfil-usuario.js',
+            data: { senalesAcumuladas: total },
+          });
+        } catch { /* silencioso */ }
+      }
+    }
+
+    escribirDirty(estado);
+  } catch {
+    // Nunca bloquear por error interno
+  }
+}
+
+module.exports = { ejecutar };
+
+// Ejecución directa (compat: sigue invocable standalone para diagnóstico).
+if (require.main === module) {
+  let inputRaw = '';
+  process.stdin.on('data', chunk => { inputRaw += chunk; });
+  process.stdin.on('end', () => ejecutar(inputRaw));
+}