@saulwade/swl-ses 1.8.0 → 2.0.0

package/hooks/contexto-iteracion.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Hook: contexto-iteracion.js
+ * Tipo: UserPromptSubmit (matcher vacío)
+ *
+ * Anti-context-rot para loops iterativos: cuando hay una corrida activa en
+ * .planning/loops/ (autoresearch, nemesis --remediar, verificar
+ * --until-converge, debate adversarial), inyecta al contexto un bloque
+ * compacto con el estado del loop — iteración actual, últimas 3 filas del
+ * TSV y la recomendación de trayectoria (continuar / detener por plateau /
+ * cambiar estrategia).
+ *
+ * En sesiones largas el modelo pierde de vista en qué iteración va y si la
+ * métrica sigue mejorando; este hook re-ancla ese estado sin que el agente
+ * tenga que releer archivos. Patrón adoptado del análisis de autoresearch
+ * v2.1 (hook iteration-context), adaptado a SWL: estado en el directorio de
+ * la corrida (no /tmp) y throttle por tiempo (no por conteo de prompts).
+ *
+ * Throttle: máximo 1 inyección cada 4 minutos por corrida (estado en
+ * .inject-state.json dentro del directorio de la corrida — se limpia solo
+ * con la corrida). 4 min < TTL del prompt cache (5 min): la inyección no
+ * coincide dos veces dentro de la misma ventana de cache.
+ *
+ * Zero-deps (solo hooks/lib/loop-telemetry). Nunca bloquea.
+ * Opt-out: SWL_CONTEXTO_ITERACION=0
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const { atomicWriteJSON } = require('./lib/atomic-write');
+const { corridaActiva, analizarTrayectoria } = require('./lib/loop-telemetry');
+
+/** Intervalo mínimo entre inyecciones para la misma corrida (4 minutos). */
+const THROTTLE_MS = 4 * 60 * 1000;
+
+const ARCHIVO_ESTADO = '.inject-state.json';
+
+/**
+ * Decide si toca inyectar según el estado de throttle de la corrida.
+ * @param {string} dirCorrida - Directorio de la corrida activa.
+ * @param {number} [ahora=Date.now()]
+ * @returns {boolean}
+ */
+function debeInyectar(dirCorrida, ahora = Date.now()) {
+  try {
+    const estado = JSON.parse(
+      fs.readFileSync(path.join(dirCorrida, ARCHIVO_ESTADO), 'utf8')
+    );
+    return ahora - (estado.ultimaInyeccion || 0) > THROTTLE_MS;
+  } catch {
+    return true; // sin estado = primera inyección
+  }
+}
+
+/** Registra la inyección para el throttle. Best-effort, escritura atómica. */
+function registrarInyeccion(dirCorrida, ahora = Date.now()) {
+  try {
+    atomicWriteJSON(
+      path.join(dirCorrida, ARCHIVO_ESTADO),
+      { ultimaInyeccion: ahora }
+    );
+  } catch { /* silencioso */ }
+}
+
+/**
+ * Construye el bloque de contexto a inyectar.
+ * @param {{dir: string, tipo: string, ultimasFilas: object[], totalFilas: number}} activa
+ * @param {object} trayectoria - Resultado de analizarTrayectoria.
+ * @returns {string}
+ */
+function construirBloque(activa, trayectoria) {
+  const lineas = [];
+  lineas.push(`🔁 Loop activo: \`${activa.tipo}\` (${path.basename(activa.dir)})`);
+  lineas.push(
+    `Iteraciones: ${trayectoria.totalIteraciones} | keep: ${trayectoria.keeps} | ` +
+    `revert: ${trayectoria.reverts} | métrica: ${trayectoria.metricaInicial} → ${trayectoria.metricaFinal}`
+  );
+
+  if (activa.ultimasFilas.length > 0) {
+    lineas.push('Últimas iteraciones:');
+    for (const fila of activa.ultimasFilas) {
+      const desc = (fila.descripcion || '').slice(0, 80);
+      lineas.push(`  ${fila.iteracion ?? '?'}. [${fila.estado || '?'}] métrica=${fila.metrica ?? '?'} — ${desc}`);
+    }
+  }
+
+  if (trayectoria.plateau) {
+    lineas.push(
+      '⚠️ PLATEAU detectado: las últimas iteraciones no mejoran la métrica. ' +
+      'Considera cerrar el loop y reportar el mejor estado alcanzado en lugar de seguir iterando.'
+    );
+  } else {
+    lineas.push(`Recomendación de trayectoria: ${trayectoria.recomendacion}.`);
+  }
+  lineas.push(`Registro completo: ${path.join(activa.dir, 'iteraciones.tsv')}`);
+
+  return lineas.join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// Entrypoint
+// ---------------------------------------------------------------------------
+
+function main() {
+  let inputRaw = '';
+  process.stdin.on('data', (c) => { inputRaw += c; });
+
+  process.stdin.on('end', () => {
+    try {
+      if (process.env.SWL_CONTEXTO_ITERACION === '0') return;
+
+      const activa = corridaActiva(process.cwd(), { maxEdadMin: 30 });
+      if (!activa) return;
+      if (!debeInyectar(activa.dir)) return;
+
+      const trayectoria = analizarTrayectoria(activa.dir);
+      // Sin iteraciones más allá del baseline no hay nada útil que anclar
+      if (trayectoria.totalIteraciones === 0) return;
+
+      const output = {
+        hookSpecificOutput: {
+          hookEventName: 'UserPromptSubmit',
+          additionalContext: construirBloque(activa, trayectoria),
+        },
+      };
+      // Marcar el throttle SOLO tras un write exitoso: si stdout falla
+      // (broken pipe, harness cerró el canal), no registrar la inyección
+      // para que el próximo prompt reintente en vez de saltarse 4 min con
+      // un mensaje que nunca llegó. Best-effort: el hook nunca bloquea.
+      process.stdout.write(JSON.stringify(output), (err) => {
+        if (!err) {
+          try { registrarInyeccion(activa.dir); } catch { /* throttle best-effort */ }
+        }
+      });
+    } catch { /* nunca bloquea */ }
+  });
+}
+
+if (require.main === module) main();
+
+module.exports = { debeInyectar, registrarInyeccion, construirBloque, THROTTLE_MS, ARCHIVO_ESTADO };

package/hooks/extraccion-aprendizajes.js

@@ -663,6 +663,19 @@ const PATRONES_ARCHIVO_SWL_EXCLUIDO = [
   /[\\/]package\.json$/,
   /[\\/]plugin\.json$/,
   /[\\/]package-lock\.json$/,
+  // Scripts temporales del agente (convención .tmp-*.js|.md en la raíz del
+  // repo, borrados en el mismo turno). Sus comentarios de cabecera describen
+  // la operación con keywords narrativas ("sustitución", "idempotente",
+  // "reescribe") que el hook confunde con descubrimientos. Detectado
+  // 2026-06-11: el comentario de .tmp-fusion-status.js se promovió como
+  // entrada "descubrimiento" a APRENDIZAJES.md.
+  /(?:^|[\\/])\.tmp-[^\\/]+$/,
+  // Reglas globales instaladas del usuario (~/.claude/rules/): editar esas
+  // copias es mantenimiento de configuración, no descubrimiento. El patrón
+  // /reglas[\\/]/ de arriba no las cubre porque el directorio se llama
+  // "rules" (inglés). Detectado 2026-06-11: fragmentos de una edición a
+  // verificar-citas-normativas.md (global) se promovieron como "patrón".
+  /(?:^|[\\/])\.claude[\\/]rules[\\/]/,
 ];
 
 /**

package/hooks/lib/ciclo-evolucion.js

@@ -0,0 +1,47 @@
+'use strict';
+
+/**
+ * hooks/lib/ciclo-evolucion.js — Lib de dominio del ciclo de evolución (Fase 11).
+ *
+ * Consolida las 3 etapas que antes eran hooks independientes
+ * (`metricas-evolucion.js`, `actualizar-perfil-usuario.js`,
+ * `auto-evolucion.js`). Cada etapa preserva su lógica intacta en
+ * `etapa-*.js`; esta lib solo las compone para reducir procesos de arranque.
+ *
+ * Mapeo a entry points:
+ *   - hooks/ciclo-evolucion.js          (Stop)        → metricas + perfil-usuario
+ *   - hooks/ciclo-evolucion-subagente.js (SubagentStop) → auto-evolucion
+ *
+ * `auto-consolidacion.js` queda FUERA por diseño: pertenece al dominio de
+ * consolidación de aprendizajes (/swl:aprender), no al de evolución (D-12).
+ */
+
+const etapaMetricas = require('./etapa-metricas');
+const etapaPerfilUsuario = require('./etapa-perfil-usuario');
+const etapaAutoEvolucion = require('./etapa-auto-evolucion');
+
+/**
+ * Sub-etapas del evento Stop: métricas del ciclo + perfil de usuario.
+ * Cada etapa es best-effort (nunca lanza); un fallo en una no impide la otra.
+ * @param {string} inputRaw payload del hook Stop
+ */
+function ejecutarStop(inputRaw) {
+  try { etapaMetricas.ejecutar(inputRaw); } catch { /* best-effort */ }
+  try { etapaPerfilUsuario.ejecutar(inputRaw); } catch { /* best-effort */ }
+}
+
+/**
+ * Sub-etapa del evento SubagentStop: auto-evolución de agentes.
+ * @param {string} inputRaw payload del hook SubagentStop
+ */
+function ejecutarSubagentStop(inputRaw) {
+  try { etapaAutoEvolucion.ejecutar(inputRaw); } catch { /* best-effort */ }
+}
+
+module.exports = {
+  ejecutarStop,
+  ejecutarSubagentStop,
+  etapaMetricas,
+  etapaPerfilUsuario,
+  etapaAutoEvolucion,
+};