@saulwade/swl-ses 2.6.0 → 2.6.1

package/scripts/lib/ciclo-autonomo/drenador-feedback.js

@@ -1,174 +1,174 @@
-'use strict';
-
-/**
- * drenador-feedback.js — Drena `.planning/evolution/feedback-queue.jsonl`
- * hacia `instintos/perfil-usuario.yaml` como señales draft (Fase 21 T-05,
- * ADR-0041/0042, REQ-21-03/REQ-21-04).
- *
- * Ventana de 90 días sobre `ts`: lo reciente se consolida como señal draft
- * de baja confianza (0.3 — nunca se inyecta a contexto, umbral en
- * `hooks/inyeccion-contexto.js`); lo viejo se archiva SIN procesar. La cola
- * activa se reescribe al final solo con lo que no pudo clasificarse (en la
- * práctica, nada) — nunca crece sin límite.
- *
- * Tolerancia a líneas corruptas (patrón de `scripts/lib/evidencia-valor.js`
- * función `leerNudges`): JSON inválido o sin `ts` parseable → se cuenta y
- * se descarta, NUNCA crashea el drenado completo por una línea mala.
- *
- * Zero-deps, CommonJS.
- *
- * @module scripts/lib/ciclo-autonomo/drenador-feedback
- */
-
-const fs = require('fs');
-const path = require('path');
-const { atomicWriteSync } = require('../../../hooks/lib/atomic-write');
-const { agregarSenalesPerfil } = require('./yaml-instintos');
-
-const DIA_MS = 24 * 60 * 60 * 1000;
-const VENTANA_DIAS = 90;
-const CONFIDENCE_DRAFT = 0.3;
-
-const RUTA_COLA_RELATIVA = path.join('.planning', 'evolution', 'feedback-queue.jsonl');
-const RUTA_ARCHIVE_RELATIVA = path.join('.planning', 'evolution', 'feedback-queue.archive.jsonl');
-const RUTA_PERFIL_RELATIVA = path.join('instintos', 'perfil-usuario.yaml');
-
-/**
- * Mapa `tipo` de señal → sección real de `perfil-usuario.yaml`.
- *
- * `preferencia` apunta a `preferencias_comunicacion`, que en el YAML real es
- * un objeto de campos fijos (no una lista) — `agregarSenalesPerfil` lo trata
- * como merge superficial de patch. `prohibicion`/`limite` apuntan a
- * `limites_explicitos.no_sugerir`: el YAML real NO tiene una sub-lista
- * `no_hacer` (solo `no_guardar`/`no_sugerir`); `no_sugerir` es la más
- * genérica de las dos para una señal de "evitar X" sin más contexto.
- */
-const MAPA_SECCION_POR_TIPO = {
-  correccion: 'correcciones_repetidas',
-  preferencia: 'preferencias_comunicacion',
-  prohibicion: 'limites_explicitos.no_sugerir',
-  limite: 'limites_explicitos.no_sugerir',
-  accion: 'patrones_trabajo',
-};
-const SECCION_POR_DEFECTO = 'patrones_trabajo';
-
-function rutaCola(baseDir) { return path.join(baseDir, RUTA_COLA_RELATIVA); }
-function rutaArchive(baseDir) { return path.join(baseDir, RUTA_ARCHIVE_RELATIVA); }
-function rutaPerfil(baseDir) { return path.join(baseDir, RUTA_PERFIL_RELATIVA); }
-
-function seccionParaTipo(tipo) {
-  return MAPA_SECCION_POR_TIPO[tipo] || SECCION_POR_DEFECTO;
-}
-
-/** Resumen legible de la señal para dedupe y para el campo `texto` del draft. */
-function resumenSenal(entrada) {
-  const partes = [entrada.accion, entrada.archivo].filter(Boolean);
-  if (partes.length > 0) return partes.join(' — ');
-  return String(entrada.tipo || 'señal');
-}
-
-/**
- * Drena la cola de feedback hacia `perfil-usuario.yaml` con ventana de 90
- * días y rotación de la cola.
- *
- * @param {string} baseDir - Directorio raíz del proyecto.
- * @param {{ ahora?: Date }} [opts]
- * @returns {{ drenados: number, archivados: number, descartados: number }}
- */
-function drenar(baseDir, { ahora = new Date() } = {}) {
-  const resultado = { drenados: 0, archivados: 0, descartados: 0 };
-
-  const rutaColaAbs = rutaCola(baseDir);
-  if (!fs.existsSync(rutaColaAbs)) return resultado;
-
-  const lineas = fs.readFileSync(rutaColaAbs, 'utf8').split(/\r?\n/);
-  const corte = ahora.getTime() - VENTANA_DIAS * DIA_MS;
-
-  const paraArchive = [];
-  // Grupos de dedupe: sección → (texto normalizado → entrada draft acumulada).
-  const gruposPorSeccion = new Map();
-
-  for (const linea of lineas) {
-    if (!linea.trim()) continue;
-
-    let entrada;
-    try {
-      entrada = JSON.parse(linea);
-    } catch (_) {
-      resultado.descartados += 1;
-      continue;
-    }
-    if (!entrada || typeof entrada !== 'object') {
-      resultado.descartados += 1;
-      continue;
-    }
-
-    if (entrada.procesado === true) {
-      // Ya consumida en una corrida previa: solo limpiar de la cola activa.
-      paraArchive.push(linea);
-      continue;
-    }
-
-    const tsMs = Date.parse(entrada.ts);
-    if (Number.isNaN(tsMs)) {
-      resultado.descartados += 1;
-      continue;
-    }
-
-    if (tsMs <= corte) {
-      // >90 días: archivar SIN procesar.
-      paraArchive.push(linea);
-      resultado.archivados += 1;
-      continue;
-    }
-
-    // ≤90 días: consolidar como señal draft.
-    const seccion = seccionParaTipo(entrada.tipo);
-    const texto = resumenSenal(entrada);
-    const clave = texto.trim().toLowerCase();
-
-    if (!gruposPorSeccion.has(seccion)) gruposPorSeccion.set(seccion, new Map());
-    const grupo = gruposPorSeccion.get(seccion);
-
-    if (grupo.has(clave)) {
-      grupo.get(clave).ocurrencias += 1;
-    } else {
-      grupo.set(clave, {
-        texto,
-        confidence: CONFIDENCE_DRAFT,
-        origen: 'ciclo-autonomo',
-        fecha: ahora.toLocaleDateString('sv'), // fecha local — gate C1
-        evidencia: entrada.sessionId || null,
-        ocurrencias: 1,
-      });
-    }
-
-    entrada.procesado = true;
-    paraArchive.push(JSON.stringify(entrada));
-    resultado.drenados += 1;
-  }
-
-  if (gruposPorSeccion.size > 0) {
-    const rutaPerfilAbs = rutaPerfil(baseDir);
-    for (const [seccion, grupo] of gruposPorSeccion) {
-      const entradas = [...grupo.values()];
-      const valores = seccion.startsWith('limites_explicitos.')
-        ? entradas.map((e) => e.texto)
-        : entradas;
-      agregarSenalesPerfil(rutaPerfilAbs, seccion, valores);
-    }
-  }
-
-  // Append al archive (JSONL de alta frecuencia — nunca reescritura total).
-  if (paraArchive.length > 0) {
-    fs.appendFileSync(rutaArchive(baseDir), paraArchive.join('\n') + '\n');
-  }
-
-  // Rotación: la cola activa solo conserva lo que no se pudo clasificar
-  // (en la práctica, nada — drenados/archivados/descartados cubren todo).
-  atomicWriteSync(rutaColaAbs, '');
-
-  return resultado;
-}
-
-module.exports = { drenar };
+'use strict';
+
+/**
+ * drenador-feedback.js — Drena `.planning/evolution/feedback-queue.jsonl`
+ * hacia `instintos/perfil-usuario.yaml` como señales draft (Fase 21 T-05,
+ * ADR-0041/0042, REQ-21-03/REQ-21-04).
+ *
+ * Ventana de 90 días sobre `ts`: lo reciente se consolida como señal draft
+ * de baja confianza (0.3 — nunca se inyecta a contexto, umbral en
+ * `hooks/inyeccion-contexto.js`); lo viejo se archiva SIN procesar. La cola
+ * activa se reescribe al final solo con lo que no pudo clasificarse (en la
+ * práctica, nada) — nunca crece sin límite.
+ *
+ * Tolerancia a líneas corruptas (patrón de `scripts/lib/evidencia-valor.js`
+ * función `leerNudges`): JSON inválido o sin `ts` parseable → se cuenta y
+ * se descarta, NUNCA crashea el drenado completo por una línea mala.
+ *
+ * Zero-deps, CommonJS.
+ *
+ * @module scripts/lib/ciclo-autonomo/drenador-feedback
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { atomicWriteSync } = require('../../../hooks/lib/atomic-write');
+const { agregarSenalesPerfil } = require('./yaml-instintos');
+
+const DIA_MS = 24 * 60 * 60 * 1000;
+const VENTANA_DIAS = 90;
+const CONFIDENCE_DRAFT = 0.3;
+
+const RUTA_COLA_RELATIVA = path.join('.planning', 'evolution', 'feedback-queue.jsonl');
+const RUTA_ARCHIVE_RELATIVA = path.join('.planning', 'evolution', 'feedback-queue.archive.jsonl');
+const RUTA_PERFIL_RELATIVA = path.join('instintos', 'perfil-usuario.yaml');
+
+/**
+ * Mapa `tipo` de señal → sección real de `perfil-usuario.yaml`.
+ *
+ * `preferencia` apunta a `preferencias_comunicacion`, que en el YAML real es
+ * un objeto de campos fijos (no una lista) — `agregarSenalesPerfil` lo trata
+ * como merge superficial de patch. `prohibicion`/`limite` apuntan a
+ * `limites_explicitos.no_sugerir`: el YAML real NO tiene una sub-lista
+ * `no_hacer` (solo `no_guardar`/`no_sugerir`); `no_sugerir` es la más
+ * genérica de las dos para una señal de "evitar X" sin más contexto.
+ */
+const MAPA_SECCION_POR_TIPO = {
+  correccion: 'correcciones_repetidas',
+  preferencia: 'preferencias_comunicacion',
+  prohibicion: 'limites_explicitos.no_sugerir',
+  limite: 'limites_explicitos.no_sugerir',
+  accion: 'patrones_trabajo',
+};
+const SECCION_POR_DEFECTO = 'patrones_trabajo';
+
+function rutaCola(baseDir) { return path.join(baseDir, RUTA_COLA_RELATIVA); }
+function rutaArchive(baseDir) { return path.join(baseDir, RUTA_ARCHIVE_RELATIVA); }
+function rutaPerfil(baseDir) { return path.join(baseDir, RUTA_PERFIL_RELATIVA); }
+
+function seccionParaTipo(tipo) {
+  return MAPA_SECCION_POR_TIPO[tipo] || SECCION_POR_DEFECTO;
+}
+
+/** Resumen legible de la señal para dedupe y para el campo `texto` del draft. */
+function resumenSenal(entrada) {
+  const partes = [entrada.accion, entrada.archivo].filter(Boolean);
+  if (partes.length > 0) return partes.join(' — ');
+  return String(entrada.tipo || 'señal');
+}
+
+/**
+ * Drena la cola de feedback hacia `perfil-usuario.yaml` con ventana de 90
+ * días y rotación de la cola.
+ *
+ * @param {string} baseDir - Directorio raíz del proyecto.
+ * @param {{ ahora?: Date }} [opts]
+ * @returns {{ drenados: number, archivados: number, descartados: number }}
+ */
+function drenar(baseDir, { ahora = new Date() } = {}) {
+  const resultado = { drenados: 0, archivados: 0, descartados: 0 };
+
+  const rutaColaAbs = rutaCola(baseDir);
+  if (!fs.existsSync(rutaColaAbs)) return resultado;
+
+  const lineas = fs.readFileSync(rutaColaAbs, 'utf8').split(/\r?\n/);
+  const corte = ahora.getTime() - VENTANA_DIAS * DIA_MS;
+
+  const paraArchive = [];
+  // Grupos de dedupe: sección → (texto normalizado → entrada draft acumulada).
+  const gruposPorSeccion = new Map();
+
+  for (const linea of lineas) {
+    if (!linea.trim()) continue;
+
+    let entrada;
+    try {
+      entrada = JSON.parse(linea);
+    } catch (_) {
+      resultado.descartados += 1;
+      continue;
+    }
+    if (!entrada || typeof entrada !== 'object') {
+      resultado.descartados += 1;
+      continue;
+    }
+
+    if (entrada.procesado === true) {
+      // Ya consumida en una corrida previa: solo limpiar de la cola activa.
+      paraArchive.push(linea);
+      continue;
+    }
+
+    const tsMs = Date.parse(entrada.ts);
+    if (Number.isNaN(tsMs)) {
+      resultado.descartados += 1;
+      continue;
+    }
+
+    if (tsMs <= corte) {
+      // >90 días: archivar SIN procesar.
+      paraArchive.push(linea);
+      resultado.archivados += 1;
+      continue;
+    }
+
+    // ≤90 días: consolidar como señal draft.
+    const seccion = seccionParaTipo(entrada.tipo);
+    const texto = resumenSenal(entrada);
+    const clave = texto.trim().toLowerCase();
+
+    if (!gruposPorSeccion.has(seccion)) gruposPorSeccion.set(seccion, new Map());
+    const grupo = gruposPorSeccion.get(seccion);
+
+    if (grupo.has(clave)) {
+      grupo.get(clave).ocurrencias += 1;
+    } else {
+      grupo.set(clave, {
+        texto,
+        confidence: CONFIDENCE_DRAFT,
+        origen: 'ciclo-autonomo',
+        fecha: ahora.toLocaleDateString('sv'), // fecha local — gate C1
+        evidencia: entrada.sessionId || null,
+        ocurrencias: 1,
+      });
+    }
+
+    entrada.procesado = true;
+    paraArchive.push(JSON.stringify(entrada));
+    resultado.drenados += 1;
+  }
+
+  if (gruposPorSeccion.size > 0) {
+    const rutaPerfilAbs = rutaPerfil(baseDir);
+    for (const [seccion, grupo] of gruposPorSeccion) {
+      const entradas = [...grupo.values()];
+      const valores = seccion.startsWith('limites_explicitos.')
+        ? entradas.map((e) => e.texto)
+        : entradas;
+      agregarSenalesPerfil(rutaPerfilAbs, seccion, valores);
+    }
+  }
+
+  // Append al archive (JSONL de alta frecuencia — nunca reescritura total).
+  if (paraArchive.length > 0) {
+    fs.appendFileSync(rutaArchive(baseDir), paraArchive.join('\n') + '\n');
+  }
+
+  // Rotación: la cola activa solo conserva lo que no se pudo clasificar
+  // (en la práctica, nada — drenados/archivados/descartados cubren todo).
+  atomicWriteSync(rutaColaAbs, '');
+
+  return resultado;
+}
+
+module.exports = { drenar };

package/scripts/lib/ciclo-autonomo/fallback.js

@@ -1,77 +1,77 @@
-'use strict';
-
-/**
- * fallback.js — Predicado puro del fallback de disparo del ciclo autónomo
- * desde `hooks/session-briefing.js` (Fase 21, T-11, REQ-21-11).
- *
- * El scheduler cron (`gateway/cron/jobs.example.json`) es el disparador
- * primario de la Fase A. Este predicado cubre el caso sin scheduler
- * configurado: si el motor está habilitado y pasaron >=24h desde la última
- * corrida exitosa (o nunca corrió), señala que toca disparar. El lock propio
- * del ciclo (`lock.js`, T-02) es quien garantiza la exclusión mutua real
- * entre el scheduler y este fallback — `debeDisparar` NO consulta el estado
- * del lock, solo el reloj.
- *
- * Puro y testeable: recibe `baseDir` y una fecha inyectable (`ahora`), sin
- * spawnear procesos — el caller (el hook) decide cómo lanzar la Fase A.
- *
- * Guard barato PRIMERO (`fs.existsSync` de `.planning/evolution/`): si el
- * directorio de señales no existe, el proyecto no tiene telemetría SWL y se
- * retorna de inmediato SIN requerir `config.js` ni `lock.js` — ese costo no
- * debe pagarse en el hot path de un hook SessionStart (presupuesto <200ms,
- * REQ-12-02). Antes el guard era la existencia de `ciclo-config.json`
- * (opt-in); con el default encendido (decisión del usuario 2026-07-10,
- * opt-out) el config puede no existir y el motor debe correr igual.
- *
- * Zero-deps, CommonJS.
- *
- * @module scripts/lib/ciclo-autonomo/fallback
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/** Ventana mínima entre corridas del fallback: 24 horas en ms. */
-const VENTANA_MS = 24 * 60 * 60 * 1000;
-
-/** Directorio de señales SWL — su existencia es el guard barato del hot path. */
-const EVOLUTION_RELATIVA = path.join('.planning', 'evolution');
-
-/**
- * Decide si el fallback de `session-briefing` debe disparar la Fase A.
- *
- * @param {string} baseDir - Directorio raíz del proyecto.
- * @param {{ahora?: Date}} [opciones]
- * @returns {{disparar: boolean, razon: string}}
- */
-function debeDisparar(baseDir, { ahora } = {}) {
-  const rutaEvolution = path.join(baseDir, EVOLUTION_RELATIVA);
-  if (!fs.existsSync(rutaEvolution)) {
-    return { disparar: false, razon: 'sin-telemetria-swl' };
-  }
-
-  // Solo en proyectos con telemetría SWL se paga el costo de requerir las
-  // libs del ciclo (el default es encendido — opt-out estricto).
-  const config = require('./config');
-  const lock = require('./lock');
-
-  if (!config.estaHabilitado(baseDir)) {
-    return { disparar: false, razon: 'deshabilitado' };
-  }
-
-  const momento = ahora || new Date();
-  const ultimaMs = lock.ultimaCorridaMs(baseDir);
-
-  if (ultimaMs === null) {
-    return { disparar: true, razon: 'sin corridas previas' };
-  }
-
-  const transcurridoMs = momento.getTime() - ultimaMs;
-  if (transcurridoMs >= VENTANA_MS) {
-    return { disparar: true, razon: `>=24h desde última corrida (${transcurridoMs}ms)` };
-  }
-
-  return { disparar: false, razon: `<24h desde última corrida (${transcurridoMs}ms)` };
-}
-
-module.exports = { debeDisparar, VENTANA_MS };
+'use strict';
+
+/**
+ * fallback.js — Predicado puro del fallback de disparo del ciclo autónomo
+ * desde `hooks/session-briefing.js` (Fase 21, T-11, REQ-21-11).
+ *
+ * El scheduler cron (`gateway/cron/jobs.example.json`) es el disparador
+ * primario de la Fase A. Este predicado cubre el caso sin scheduler
+ * configurado: si el motor está habilitado y pasaron >=24h desde la última
+ * corrida exitosa (o nunca corrió), señala que toca disparar. El lock propio
+ * del ciclo (`lock.js`, T-02) es quien garantiza la exclusión mutua real
+ * entre el scheduler y este fallback — `debeDisparar` NO consulta el estado
+ * del lock, solo el reloj.
+ *
+ * Puro y testeable: recibe `baseDir` y una fecha inyectable (`ahora`), sin
+ * spawnear procesos — el caller (el hook) decide cómo lanzar la Fase A.
+ *
+ * Guard barato PRIMERO (`fs.existsSync` de `.planning/evolution/`): si el
+ * directorio de señales no existe, el proyecto no tiene telemetría SWL y se
+ * retorna de inmediato SIN requerir `config.js` ni `lock.js` — ese costo no
+ * debe pagarse en el hot path de un hook SessionStart (presupuesto <200ms,
+ * REQ-12-02). Antes el guard era la existencia de `ciclo-config.json`
+ * (opt-in); con el default encendido (decisión del usuario 2026-07-10,
+ * opt-out) el config puede no existir y el motor debe correr igual.
+ *
+ * Zero-deps, CommonJS.
+ *
+ * @module scripts/lib/ciclo-autonomo/fallback
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/** Ventana mínima entre corridas del fallback: 24 horas en ms. */
+const VENTANA_MS = 24 * 60 * 60 * 1000;
+
+/** Directorio de señales SWL — su existencia es el guard barato del hot path. */
+const EVOLUTION_RELATIVA = path.join('.planning', 'evolution');
+
+/**
+ * Decide si el fallback de `session-briefing` debe disparar la Fase A.
+ *
+ * @param {string} baseDir - Directorio raíz del proyecto.
+ * @param {{ahora?: Date}} [opciones]
+ * @returns {{disparar: boolean, razon: string}}
+ */
+function debeDisparar(baseDir, { ahora } = {}) {
+  const rutaEvolution = path.join(baseDir, EVOLUTION_RELATIVA);
+  if (!fs.existsSync(rutaEvolution)) {
+    return { disparar: false, razon: 'sin-telemetria-swl' };
+  }
+
+  // Solo en proyectos con telemetría SWL se paga el costo de requerir las
+  // libs del ciclo (el default es encendido — opt-out estricto).
+  const config = require('./config');
+  const lock = require('./lock');
+
+  if (!config.estaHabilitado(baseDir)) {
+    return { disparar: false, razon: 'deshabilitado' };
+  }
+
+  const momento = ahora || new Date();
+  const ultimaMs = lock.ultimaCorridaMs(baseDir);
+
+  if (ultimaMs === null) {
+    return { disparar: true, razon: 'sin corridas previas' };
+  }
+
+  const transcurridoMs = momento.getTime() - ultimaMs;
+  if (transcurridoMs >= VENTANA_MS) {
+    return { disparar: true, razon: `>=24h desde última corrida (${transcurridoMs}ms)` };
+  }
+
+  return { disparar: false, razon: `<24h desde última corrida (${transcurridoMs}ms)` };
+}
+
+module.exports = { debeDisparar, VENTANA_MS };