@saulwade/swl-ses 1.5.1 → 1.6.0

package/hooks/lib/agent-routing.js

@@ -1,107 +1,107 @@
-'use strict';
-
-/**
- * agent-routing.js — Helper para inferir fase y dominio del routing.
- *
- * Lee el frontmatter del agente (agentes/<nombre>.md) y extrae los campos
- * `fase` y `dominio` introducidos en v1.1.0 (ADR 0012). El orquestador no
- * registra explícitamente "qué fase/dominio motivó la elección" — pero
- * cuando elige un agente, podemos asumir que lo eligió porque su fase y
- * dominio matcheaban. Por lo tanto, leer el frontmatter del agente
- * efectivamente invocado nos da la celda fase×dominio del routing.
- *
- * Esto es proxy de precisión, no precisión absoluta:
- *   - Tasa de éxito por celda (fase, dominio) sirve como indicador de
- *     que el routing está enviando trabajo correctamente al agente
- *     adecuado.
- *   - Una celda con tasa de éxito baja sugiere routing impreciso (el
- *     agente recibe trabajo que no le compete) o agente sub-óptimo.
- *
- * Cache simple en memoria del proceso para evitar I/O repetida (cada
- * invocación de hook es proceso fresco, así que el cache no persiste,
- * pero protege dentro de la misma invocación).
- *
- * @module hooks/lib/agent-routing
- */
-
-const fs   = require('fs');
-const path = require('path');
-
-const _cache = Object.create(null);
-
-/**
- * Resuelve la ruta del archivo de agente. Acepta tanto el repo madre como
- * proyectos consumidores (donde los agentes pueden estar en otras rutas).
- *
- * @param {string} agentName - p.ej. "backend-python-swl"
- * @param {string} [cwd]     - Directorio de proyecto (default process.cwd())
- * @returns {string|null}    - Ruta absoluta o null si no existe
- */
-function resolveAgentPath(agentName, cwd) {
-  const baseDir = cwd || process.cwd();
-  const candidates = [
-    path.join(baseDir, 'agentes', `${agentName}.md`),
-    path.join(baseDir, '.claude', 'agents', `${agentName}.md`),
-  ];
-  for (const c of candidates) {
-    try { if (fs.statSync(c).isFile()) return c; } catch { /* siguiente */ }
-  }
-  return null;
-}
-
-/**
- * Extrae fase y dominio del frontmatter de un agente.
- *
- * @param {string} agentName - Nombre del agente sin extensión
- * @param {string} [cwd]
- * @returns {{ fase: string|null, dominio: string|null, source: string }}
- *   - source: 'frontmatter' | 'cache' | 'unknown'
- */
-function getRouting(agentName, cwd) {
-  if (!agentName) return { fase: null, dominio: null, source: 'unknown' };
-  if (_cache[agentName]) {
-    return { ..._cache[agentName], source: 'cache' };
-  }
-
-  const agentPath = resolveAgentPath(agentName, cwd);
-  if (!agentPath) {
-    const result = { fase: null, dominio: null, source: 'unknown' };
-    _cache[agentName] = { fase: null, dominio: null };
-    return result;
-  }
-
-  let raw;
-  try {
-    raw = fs.readFileSync(agentPath, 'utf8');
-  } catch {
-    return { fase: null, dominio: null, source: 'unknown' };
-  }
-
-  const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!fmMatch) {
-    _cache[agentName] = { fase: null, dominio: null };
-    return { fase: null, dominio: null, source: 'unknown' };
-  }
-  const fm = fmMatch[1];
-
-  // Parser minimalista — solo busca las dos líneas que necesitamos.
-  // Evitamos depender de un parser YAML completo (zero-deps).
-  const faseMatch    = fm.match(/^fase:\s*(\S+)/m);
-  const dominioMatch = fm.match(/^dominio:\s*(\S+)/m);
-
-  const result = {
-    fase:    faseMatch    ? faseMatch[1].trim()    : null,
-    dominio: dominioMatch ? dominioMatch[1].trim() : null,
-  };
-  _cache[agentName] = result;
-  return { ...result, source: 'frontmatter' };
-}
-
-/**
- * Limpia el cache (para tests o tras modificar agentes).
- */
-function clearCache() {
-  for (const k of Object.keys(_cache)) delete _cache[k];
-}
-
-module.exports = { getRouting, resolveAgentPath, clearCache };
+'use strict';
+
+/**
+ * agent-routing.js — Helper para inferir fase y dominio del routing.
+ *
+ * Lee el frontmatter del agente (agentes/<nombre>.md) y extrae los campos
+ * `fase` y `dominio` introducidos en v1.1.0 (ADR 0012). El orquestador no
+ * registra explícitamente "qué fase/dominio motivó la elección" — pero
+ * cuando elige un agente, podemos asumir que lo eligió porque su fase y
+ * dominio matcheaban. Por lo tanto, leer el frontmatter del agente
+ * efectivamente invocado nos da la celda fase×dominio del routing.
+ *
+ * Esto es proxy de precisión, no precisión absoluta:
+ *   - Tasa de éxito por celda (fase, dominio) sirve como indicador de
+ *     que el routing está enviando trabajo correctamente al agente
+ *     adecuado.
+ *   - Una celda con tasa de éxito baja sugiere routing impreciso (el
+ *     agente recibe trabajo que no le compete) o agente sub-óptimo.
+ *
+ * Cache simple en memoria del proceso para evitar I/O repetida (cada
+ * invocación de hook es proceso fresco, así que el cache no persiste,
+ * pero protege dentro de la misma invocación).
+ *
+ * @module hooks/lib/agent-routing
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const _cache = Object.create(null);
+
+/**
+ * Resuelve la ruta del archivo de agente. Acepta tanto el repo madre como
+ * proyectos consumidores (donde los agentes pueden estar en otras rutas).
+ *
+ * @param {string} agentName - p.ej. "backend-python-swl"
+ * @param {string} [cwd]     - Directorio de proyecto (default process.cwd())
+ * @returns {string|null}    - Ruta absoluta o null si no existe
+ */
+function resolveAgentPath(agentName, cwd) {
+  const baseDir = cwd || process.cwd();
+  const candidates = [
+    path.join(baseDir, 'agentes', `${agentName}.md`),
+    path.join(baseDir, '.claude', 'agents', `${agentName}.md`),
+  ];
+  for (const c of candidates) {
+    try { if (fs.statSync(c).isFile()) return c; } catch { /* siguiente */ }
+  }
+  return null;
+}
+
+/**
+ * Extrae fase y dominio del frontmatter de un agente.
+ *
+ * @param {string} agentName - Nombre del agente sin extensión
+ * @param {string} [cwd]
+ * @returns {{ fase: string|null, dominio: string|null, source: string }}
+ *   - source: 'frontmatter' | 'cache' | 'unknown'
+ */
+function getRouting(agentName, cwd) {
+  if (!agentName) return { fase: null, dominio: null, source: 'unknown' };
+  if (_cache[agentName]) {
+    return { ..._cache[agentName], source: 'cache' };
+  }
+
+  const agentPath = resolveAgentPath(agentName, cwd);
+  if (!agentPath) {
+    const result = { fase: null, dominio: null, source: 'unknown' };
+    _cache[agentName] = { fase: null, dominio: null };
+    return result;
+  }
+
+  let raw;
+  try {
+    raw = fs.readFileSync(agentPath, 'utf8');
+  } catch {
+    return { fase: null, dominio: null, source: 'unknown' };
+  }
+
+  const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!fmMatch) {
+    _cache[agentName] = { fase: null, dominio: null };
+    return { fase: null, dominio: null, source: 'unknown' };
+  }
+  const fm = fmMatch[1];
+
+  // Parser minimalista — solo busca las dos líneas que necesitamos.
+  // Evitamos depender de un parser YAML completo (zero-deps).
+  const faseMatch    = fm.match(/^fase:\s*(\S+)/m);
+  const dominioMatch = fm.match(/^dominio:\s*(\S+)/m);
+
+  const result = {
+    fase:    faseMatch    ? faseMatch[1].trim()    : null,
+    dominio: dominioMatch ? dominioMatch[1].trim() : null,
+  };
+  _cache[agentName] = result;
+  return { ...result, source: 'frontmatter' };
+}
+
+/**
+ * Limpia el cache (para tests o tras modificar agentes).
+ */
+function clearCache() {
+  for (const k of Object.keys(_cache)) delete _cache[k];
+}
+
+module.exports = { getRouting, resolveAgentPath, clearCache };