@saulwade/swl-ses 2.3.0 → 2.4.1

package/hooks/contexto-subagente.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Hook: contexto-subagente.js
+ * Tipo: SubagentStart (aplica a todos los subagentes Task/Agent)
+ *
+ * El contexto emitido por hooks de SessionStart es solo del hilo padre y
+ * NUNCA llega a los subagentes: cada agente spawneado vía Task/Agent corre
+ * sin las disciplinas activas de la sesión (patrón documentado en ponytail
+ * issue #252 — mismo gap verificado en swl-ses el 2026-07-03: 0 usos de
+ * SubagentStart hasta este hook).
+ *
+ * Re-inyecta a cada subagente un bloque compacto (~120 tokens) con las
+ * disciplinas transversales no negociables: idioma es-MX, escalera de código
+ * mínimo con guardas intocables, y la convención de marcador `simplificado:`.
+ * Deliberadamente mínimo — el costo se paga en CADA spawn de subagente.
+ *
+ * Opt-out: SWL_CONTEXTO_SUBAGENTE=0 desactiva la inyección.
+ * Formato de salida: SubagentStart requiere la forma JSON hookSpecificOutput
+ * (stdout crudo se descarta en este evento — a diferencia de SessionStart).
+ */
+
+/**
+ * Construye el bloque de disciplinas que se inyecta al subagente.
+ *
+ * @returns {string} Contexto compacto en es-MX.
+ */
+function construirContexto() {
+  return [
+    'DISCIPLINAS SWL ACTIVAS (heredadas de la sesión padre):',
+    '- Idioma: español de México en todo output (código, comentarios, commits, reportes).',
+    '- Código mínimo — escalera antes de escribir: ¿necesita existir (YAGNI)? →',
+    '  ¿ya existe en este codebase? → ¿stdlib? → ¿feature nativa de la plataforma? →',
+    '  ¿dependencia ya instalada? → ¿una línea? → solo entonces, el mínimo que funciona.',
+    '- Guardas intocables (nunca simplificar): validación en trust boundaries,',
+    '  manejo de errores que previene pérdida de datos, seguridad, accesibilidad.',
+    '- Simplificación deliberada se marca: `simplificado: <techo>, <trigger de upgrade>`.',
+    '- Bug fix = causa raíz: grep de todos los callers antes de parchar uno.',
+    'Detalle completo: Skill("prevencion-sobreingenieria").',
+  ].join('\n');
+}
+
+/**
+ * Emite el contexto en el formato JSON que SubagentStart exige.
+ * Nunca falla hacia afuera: un stdout roto no debe reportarse como hook error.
+ */
+function main() {
+  if (process.env.SWL_CONTEXTO_SUBAGENTE === '0') return;
+  try {
+    process.stdout.write(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: 'SubagentStart',
+        additionalContext: construirContexto(),
+      },
+    }));
+  } catch (_) {
+    // Silencioso — no interrumpir el spawn del subagente.
+  }
+}
+
+// Entrypoint directo o wrapper `node -e "require(...)"` (require.main undefined).
+// No consume stdin: emite y termina — sin listeners, el proceso sale solo.
+if (!require.main || require.main === module) {
+  main();
+}
+
+module.exports = { construirContexto };

package/hooks/guardrail-modelo.js

@@ -29,7 +29,12 @@ const path = require('path');
 // Guard de opt-in — zero-config por defecto
 // ---------------------------------------------------------------------------
 
-if (!process.env.SWL_GUARDRAIL_MODELO) {
+// Entrypoint: ejecución directa o wrapper `node -e "require(...)"` de
+// settings.json, donde require.main es undefined. Al requerir desde tests,
+// require.main es el runner (definido y ≠ este módulo) → sin efectos.
+const ES_ENTRYPOINT = !require.main || require.main === module;
+
+if (ES_ENTRYPOINT && !process.env.SWL_GUARDRAIL_MODELO) {
   process.exit(0);
 }
 
@@ -102,12 +107,13 @@ function razonTripwire(texto, trivialLen, tareaLigera) {
 /**
  * Determina el modelo sugerido por degradación según modelo actual del agente.
  *
- * @param {string} modeloActual - Identificador del modelo actual ('opus'|'sonnet'|'haiku'|...).
+ * @param {string} modeloActual - Identificador del modelo actual ('fable'|'opus'|'sonnet'|'haiku'|...).
  * @returns {string} Modelo sugerido.
  */
 function modeloSugerido(modeloActual) {
   const m = (modeloActual || '').toLowerCase();
-  if (m.includes('opus'))   return 'claude-sonnet-4-6';
+  if (m.includes('fable'))  return 'claude-opus-4-8';
+  if (m.includes('opus'))   return 'claude-sonnet-5';
   if (m.includes('sonnet')) return 'claude-haiku-4-5-20251001';
   // haiku o inherit — no hay degradación posible
   return modeloActual || 'claude-haiku-4-5-20251001';
@@ -244,4 +250,8 @@ async function main() {
   process.exit(0);
 }
 
-main().catch(() => process.exit(0));
+if (ES_ENTRYPOINT) {
+  main().catch(() => process.exit(0));
+}
+
+module.exports = { modeloSugerido, esTrivialPorLongitud, esTareaLigera };

package/hooks/inyeccion-contexto.js

@@ -34,7 +34,6 @@ let _techDetector = null;
 try { _techDetector = require('./lib/tech-skills-map'); } catch (_) {}
 
 // Solo inyectar en la primera invocación
-const MAX_INVOCACION_PARA_INYECTAR = 1;
 
 function leerSesionAnterior(cwd) {
   const latestPath = path.join(cwd, '.planning', 'sessions', 'latest.json');
@@ -192,16 +191,17 @@ process.stdin.on('end', () => {
     const data = JSON.parse(inputRaw);
     const sessionId = String(data.session_id || 'default');
 
-    // Leer bridge para verificar si ya inyectamos
-    const bridgePath = path.join(os.tmpdir(), `swl-ctx-${sessionId}.json`);
-    let bridge = {};
+    // Estado propio del hook (una inyección por sesión). Histórico: hasta
+    // 2026-07-03 leía el bridge swl-ctx-* de linea-estado.js (hook eliminado);
+    // ahora este archivo es de su exclusiva propiedad.
+    const estadoPath = path.join(os.tmpdir(), `swl-inyeccion-${sessionId}.json`);
+    let estado = {};
     try {
-      bridge = JSON.parse(fs.readFileSync(bridgePath, 'utf8'));
+      estado = JSON.parse(fs.readFileSync(estadoPath, 'utf8'));
     } catch (_) {}
 
-    // Solo inyectar en la primera invocacion
-    const invocaciones = bridge.invocaciones || 0;
-    if (invocaciones > MAX_INVOCACION_PARA_INYECTAR || bridge.contextoInyectado) {
+    // Solo inyectar una vez por sesión
+    if (estado.contextoInyectado) {
       return;
     }
 
@@ -230,11 +230,11 @@ process.stdin.on('end', () => {
       contexto = scanResult.content; // Original o con advertencia
     }
 
-    // Marcar como inyectado en bridge
+    // Marcar como inyectado en el estado propio
     try {
-      bridge.contextoInyectado = true;
-      bridge.contextoTimestamp = new Date().toISOString();
-      fs.writeFileSync(bridgePath, JSON.stringify(bridge, null, 2), 'utf8');
+      estado.contextoInyectado = true;
+      estado.contextoTimestamp = new Date().toISOString();
+      fs.writeFileSync(estadoPath, JSON.stringify(estado, null, 2), 'utf8');
     } catch (_) {}
 
     // Emitir contexto de sesión anterior

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 };