@saulwade/swl-ses 2.6.0 → 2.6.1

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

@@ -1,174 +1,174 @@
-'use strict';
-
-/**
- * candidatos.js — Detector determinista de candidatos a Fase B del ciclo
- * autónomo (Fase 22, T-02, ADR-0042 gate G-B, REQ-22-01).
- *
- * Tres fuentes deterministas, SIN invocar LLM:
- *   1. Instintos con `candidato_global:true` en `instintos/proyecto.yaml`
- *      (via `yaml-instintos.leerInstintos`, tolerante a archivo ausente).
- *   2. Nudges `kind:'auto-evolucion'` no accionados con evidencia
- *      (`data.diagnosis` o `data.razon` en {fallos, loop}) leídos de
- *      `evolution/nudges.jsonl`.
- *   3. Skills fríos vía `require('../skill-metrics').skillsStale` (require
- *      tolerante → `[]` si la lib no resuelve en el destino de instalación).
- *
- * Persiste SOLO los candidatos nuevos (dedupe por `id`, releyendo el jsonl
- * previo con tolerancia por línea) en `evolution/candidatos-fase-b.jsonl`.
- * Una corrida sin candidatos nuevos NO escribe el archivo (ni lo crea si no
- * existía). Zero-deps, CommonJS.
- *
- * @module scripts/lib/ciclo-autonomo/candidatos
- */
-
-const fs = require('fs');
-const path = require('path');
-const { leerInstintos } = require('./yaml-instintos');
-
-const RUTA_INSTINTOS_RELATIVA = path.join('instintos', 'proyecto.yaml');
-const RUTA_NUDGES_RELATIVA = path.join('.planning', 'evolution', 'nudges.jsonl');
-const RUTA_CANDIDATOS_RELATIVA = path.join('.planning', 'evolution', 'candidatos-fase-b.jsonl');
-
-/** Razones de nudge `auto-evolucion` que cuentan como evidencia suficiente. */
-const RAZONES_CON_EVIDENCIA = new Set(['fallos', 'loop']);
-
-/** Lee un JSONL con tolerancia por línea: línea corrupta se descarta, nunca crashea. */
-function leerJsonlTolerante(ruta) {
-  let crudo;
-  try {
-    crudo = fs.readFileSync(ruta, 'utf8');
-  } catch (_) {
-    return [];
-  }
-  return crudo.split(/\r\n|\n/)
-    .filter((linea) => linea.trim() !== '')
-    .map((linea) => {
-      try {
-        return JSON.parse(linea);
-      } catch (_) {
-        return null;
-      }
-    })
-    .filter(Boolean);
-}
-
-/** Fuente 1: instintos con `candidato_global:true` en instintos/proyecto.yaml. */
-function candidatosDeInstintos(baseDir, ts) {
-  const ruta = path.join(baseDir, RUTA_INSTINTOS_RELATIVA);
-  let datos;
-  try {
-    datos = leerInstintos(ruta);
-  } catch (_) {
-    return []; // archivo ausente o YAML corrupto: sin candidatos de esta fuente
-  }
-
-  return (datos.instintos || [])
-    .filter((instinto) => instinto.candidato_global === true)
-    .map((instinto) => ({
-      id: `instinto:${instinto.id}`,
-      fuente: 'instinto-global',
-      ref: { id: instinto.id, pattern: instinto.pattern || null },
-      ts,
-      origen: 'ciclo-autonomo',
-    }));
-}
-
-/** Fuente 2: nudges `kind:'auto-evolucion'` no accionados con evidencia. */
-function candidatosDeNudges(baseDir, ts) {
-  const ruta = path.join(baseDir, RUTA_NUDGES_RELATIVA);
-
-  return leerJsonlTolerante(ruta)
-    .filter((nudge) => nudge && nudge.kind === 'auto-evolucion' && nudge.accionado !== true)
-    .filter((nudge) => {
-      const data = nudge.data || {};
-      return Boolean(data.diagnosis) || RAZONES_CON_EVIDENCIA.has(data.razon);
-    })
-    .map((nudge) => ({
-      id: `nudge:${nudge.id}`,
-      fuente: 'evolucion-agente',
-      ref: {
-        target: nudge.target || null,
-        razon: (nudge.data || {}).razon || null,
-        tieneDiagnosis: Boolean((nudge.data || {}).diagnosis),
-      },
-      ts,
-      origen: 'ciclo-autonomo',
-    }));
-}
-
-/** Fuente 3: skills fríos vía skill-metrics.skillsStale (require tolerante → []). */
-function candidatosDeSkillsFrios(baseDir, ahora, ts) {
-  let skillsStale;
-  try {
-    ({ skillsStale } = require('../skill-metrics'));
-  } catch (_) {
-    return []; // lib no distribuida en este destino: sin candidatos de esta fuente
-  }
-
-  let frios;
-  try {
-    frios = skillsStale(baseDir, ahora);
-  } catch (_) {
-    return [];
-  }
-
-  return (frios || []).map((frio) => ({
-    id: `skill:${frio.skill}`,
-    fuente: 'skill-stale',
-    ref: { skill: frio.skill, diasInactivo: frio.diasInactivo },
-    ts,
-    origen: 'ciclo-autonomo',
-  }));
-}
-
-/** Ids ya persistidos en `candidatos-fase-b.jsonl` (dedupe, tolerante por línea). */
-function idsConocidos(baseDir) {
-  const ruta = path.join(baseDir, RUTA_CANDIDATOS_RELATIVA);
-  return new Set(leerJsonlTolerante(ruta).map((entrada) => entrada.id).filter(Boolean));
-}
-
-/** Append de los candidatos nuevos (dedupe ya aplicado por el caller); no-op si viene vacío. */
-function persistirNuevos(baseDir, nuevos) {
-  if (nuevos.length === 0) return;
-
-  const ruta = path.join(baseDir, RUTA_CANDIDATOS_RELATIVA);
-  const dir = path.dirname(ruta);
-  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-
-  const lineas = nuevos.map((candidato) => JSON.stringify(candidato)).join('\n') + '\n';
-  fs.appendFileSync(ruta, lineas);
-}
-
-/**
- * Detecta candidatos a Fase B desde las tres fuentes deterministas y
- * persiste (dedupe por id) SOLO los nuevos en `evolution/candidatos-fase-b.jsonl`.
- * Tolerante a la ausencia de cualquier fuente — nunca crashea.
- *
- * @param {string} baseDir - Directorio raíz del proyecto.
- * @param {{ahora?: Date}} [opciones]
- * @returns {{nuevos: number, total: number, candidatos: object[]}}
- */
-function detectar(baseDir, { ahora } = {}) {
-  const momento = ahora || new Date();
-  const ts = momento.toISOString();
-
-  const candidatos = [
-    ...candidatosDeInstintos(baseDir, ts),
-    ...candidatosDeNudges(baseDir, ts),
-    ...candidatosDeSkillsFrios(baseDir, momento, ts),
-  ];
-
-  const conocidos = idsConocidos(baseDir);
-  const vistos = new Set();
-  const nuevosCandidatos = candidatos.filter((candidato) => {
-    if (conocidos.has(candidato.id) || vistos.has(candidato.id)) return false;
-    vistos.add(candidato.id);
-    return true;
-  });
-
-  persistirNuevos(baseDir, nuevosCandidatos);
-
-  return { nuevos: nuevosCandidatos.length, total: candidatos.length, candidatos };
-}
-
-module.exports = { detectar };
+'use strict';
+
+/**
+ * candidatos.js — Detector determinista de candidatos a Fase B del ciclo
+ * autónomo (Fase 22, T-02, ADR-0042 gate G-B, REQ-22-01).
+ *
+ * Tres fuentes deterministas, SIN invocar LLM:
+ *   1. Instintos con `candidato_global:true` en `instintos/proyecto.yaml`
+ *      (via `yaml-instintos.leerInstintos`, tolerante a archivo ausente).
+ *   2. Nudges `kind:'auto-evolucion'` no accionados con evidencia
+ *      (`data.diagnosis` o `data.razon` en {fallos, loop}) leídos de
+ *      `evolution/nudges.jsonl`.
+ *   3. Skills fríos vía `require('../skill-metrics').skillsStale` (require
+ *      tolerante → `[]` si la lib no resuelve en el destino de instalación).
+ *
+ * Persiste SOLO los candidatos nuevos (dedupe por `id`, releyendo el jsonl
+ * previo con tolerancia por línea) en `evolution/candidatos-fase-b.jsonl`.
+ * Una corrida sin candidatos nuevos NO escribe el archivo (ni lo crea si no
+ * existía). Zero-deps, CommonJS.
+ *
+ * @module scripts/lib/ciclo-autonomo/candidatos
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { leerInstintos } = require('./yaml-instintos');
+
+const RUTA_INSTINTOS_RELATIVA = path.join('instintos', 'proyecto.yaml');
+const RUTA_NUDGES_RELATIVA = path.join('.planning', 'evolution', 'nudges.jsonl');
+const RUTA_CANDIDATOS_RELATIVA = path.join('.planning', 'evolution', 'candidatos-fase-b.jsonl');
+
+/** Razones de nudge `auto-evolucion` que cuentan como evidencia suficiente. */
+const RAZONES_CON_EVIDENCIA = new Set(['fallos', 'loop']);
+
+/** Lee un JSONL con tolerancia por línea: línea corrupta se descarta, nunca crashea. */
+function leerJsonlTolerante(ruta) {
+  let crudo;
+  try {
+    crudo = fs.readFileSync(ruta, 'utf8');
+  } catch (_) {
+    return [];
+  }
+  return crudo.split(/\r\n|\n/)
+    .filter((linea) => linea.trim() !== '')
+    .map((linea) => {
+      try {
+        return JSON.parse(linea);
+      } catch (_) {
+        return null;
+      }
+    })
+    .filter(Boolean);
+}
+
+/** Fuente 1: instintos con `candidato_global:true` en instintos/proyecto.yaml. */
+function candidatosDeInstintos(baseDir, ts) {
+  const ruta = path.join(baseDir, RUTA_INSTINTOS_RELATIVA);
+  let datos;
+  try {
+    datos = leerInstintos(ruta);
+  } catch (_) {
+    return []; // archivo ausente o YAML corrupto: sin candidatos de esta fuente
+  }
+
+  return (datos.instintos || [])
+    .filter((instinto) => instinto.candidato_global === true)
+    .map((instinto) => ({
+      id: `instinto:${instinto.id}`,
+      fuente: 'instinto-global',
+      ref: { id: instinto.id, pattern: instinto.pattern || null },
+      ts,
+      origen: 'ciclo-autonomo',
+    }));
+}
+
+/** Fuente 2: nudges `kind:'auto-evolucion'` no accionados con evidencia. */
+function candidatosDeNudges(baseDir, ts) {
+  const ruta = path.join(baseDir, RUTA_NUDGES_RELATIVA);
+
+  return leerJsonlTolerante(ruta)
+    .filter((nudge) => nudge && nudge.kind === 'auto-evolucion' && nudge.accionado !== true)
+    .filter((nudge) => {
+      const data = nudge.data || {};
+      return Boolean(data.diagnosis) || RAZONES_CON_EVIDENCIA.has(data.razon);
+    })
+    .map((nudge) => ({
+      id: `nudge:${nudge.id}`,
+      fuente: 'evolucion-agente',
+      ref: {
+        target: nudge.target || null,
+        razon: (nudge.data || {}).razon || null,
+        tieneDiagnosis: Boolean((nudge.data || {}).diagnosis),
+      },
+      ts,
+      origen: 'ciclo-autonomo',
+    }));
+}
+
+/** Fuente 3: skills fríos vía skill-metrics.skillsStale (require tolerante → []). */
+function candidatosDeSkillsFrios(baseDir, ahora, ts) {
+  let skillsStale;
+  try {
+    ({ skillsStale } = require('../skill-metrics'));
+  } catch (_) {
+    return []; // lib no distribuida en este destino: sin candidatos de esta fuente
+  }
+
+  let frios;
+  try {
+    frios = skillsStale(baseDir, ahora);
+  } catch (_) {
+    return [];
+  }
+
+  return (frios || []).map((frio) => ({
+    id: `skill:${frio.skill}`,
+    fuente: 'skill-stale',
+    ref: { skill: frio.skill, diasInactivo: frio.diasInactivo },
+    ts,
+    origen: 'ciclo-autonomo',
+  }));
+}
+
+/** Ids ya persistidos en `candidatos-fase-b.jsonl` (dedupe, tolerante por línea). */
+function idsConocidos(baseDir) {
+  const ruta = path.join(baseDir, RUTA_CANDIDATOS_RELATIVA);
+  return new Set(leerJsonlTolerante(ruta).map((entrada) => entrada.id).filter(Boolean));
+}
+
+/** Append de los candidatos nuevos (dedupe ya aplicado por el caller); no-op si viene vacío. */
+function persistirNuevos(baseDir, nuevos) {
+  if (nuevos.length === 0) return;
+
+  const ruta = path.join(baseDir, RUTA_CANDIDATOS_RELATIVA);
+  const dir = path.dirname(ruta);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+  const lineas = nuevos.map((candidato) => JSON.stringify(candidato)).join('\n') + '\n';
+  fs.appendFileSync(ruta, lineas);
+}
+
+/**
+ * Detecta candidatos a Fase B desde las tres fuentes deterministas y
+ * persiste (dedupe por id) SOLO los nuevos en `evolution/candidatos-fase-b.jsonl`.
+ * Tolerante a la ausencia de cualquier fuente — nunca crashea.
+ *
+ * @param {string} baseDir - Directorio raíz del proyecto.
+ * @param {{ahora?: Date}} [opciones]
+ * @returns {{nuevos: number, total: number, candidatos: object[]}}
+ */
+function detectar(baseDir, { ahora } = {}) {
+  const momento = ahora || new Date();
+  const ts = momento.toISOString();
+
+  const candidatos = [
+    ...candidatosDeInstintos(baseDir, ts),
+    ...candidatosDeNudges(baseDir, ts),
+    ...candidatosDeSkillsFrios(baseDir, momento, ts),
+  ];
+
+  const conocidos = idsConocidos(baseDir);
+  const vistos = new Set();
+  const nuevosCandidatos = candidatos.filter((candidato) => {
+    if (conocidos.has(candidato.id) || vistos.has(candidato.id)) return false;
+    vistos.add(candidato.id);
+    return true;
+  });
+
+  persistirNuevos(baseDir, nuevosCandidatos);
+
+  return { nuevos: nuevosCandidatos.length, total: candidatos.length, candidatos };
+}
+
+module.exports = { detectar };