@saulwade/swl-ses 2.5.2 → 2.6.0

package/hooks/lib/consolidation-lock.js

@@ -67,11 +67,18 @@ function isPidAlive(pid) {
 
 /**
  * Ruta del lock file.
+ *
  * @param {string} baseDir - Raíz del proyecto.
+ * @param {object} [opts] - Opciones.
+ * @param {string} [opts.lockFilename] - Nombre de archivo alterno al default
+ *   `.consolidation-lock`. Permite a otros consumidores (ej. el ciclo
+ *   autónomo, Fase 21 T-02) usar un lockfile propio sin colisionar con el
+ *   de auto-consolidación, reutilizando el mismo patrón PID+staleness.
  * @returns {string}
  */
-function lockPath(baseDir) {
-  return path.join(baseDir, '.planning', LOCK_FILENAME);
+function lockPath(baseDir, opts = {}) {
+  const filename = (opts && opts.lockFilename) || LOCK_FILENAME;
+  return path.join(baseDir, '.planning', filename);
 }
 
 // ---------------------------------------------------------------------------
@@ -82,10 +89,11 @@ function lockPath(baseDir) {
  * Obtiene el timestamp de la última consolidación exitosa.
  *
  * @param {string} baseDir - Raíz del proyecto.
+ * @param {object} [opts] - Ver {@link lockPath}.
  * @returns {number} Epoch ms de la última consolidación, 0 si nunca.
  */
-function getLastConsolidatedAt(baseDir) {
-  const lp = lockPath(baseDir);
+function getLastConsolidatedAt(baseDir, opts = {}) {
+  const lp = lockPath(baseDir, opts);
   try {
     const stat = fs.statSync(lp);
     return stat.mtimeMs;
@@ -150,12 +158,13 @@ function countNewSessions(baseDir) {
  * Intenta adquirir el lock de consolidación.
  *
  * @param {string} baseDir
+ * @param {object} [opts] - Ver {@link lockPath}.
  * @returns {{ acquired: boolean, priorMtime: number }}
  *   acquired: true si el lock fue adquirido
  *   priorMtime: mtime anterior (para rollback)
  */
-function tryAcquireLock(baseDir) {
-  const lp = lockPath(baseDir);
+function tryAcquireLock(baseDir, opts = {}) {
+  const lp = lockPath(baseDir, opts);
   const dir = path.dirname(lp);
 
   // Asegurar directorio
@@ -200,9 +209,10 @@ function tryAcquireLock(baseDir) {
  * Libera el lock actualizando el mtime a "ahora" (consolidación exitosa).
  *
  * @param {string} baseDir
+ * @param {object} [opts] - Ver {@link lockPath}.
  */
-function releaseLock(baseDir) {
-  const lp = lockPath(baseDir);
+function releaseLock(baseDir, opts = {}) {
+  const lp = lockPath(baseDir, opts);
   try {
     // Actualizar mtime a ahora = "última consolidación fue ahora"
     const now = Date.now() / 1000;
@@ -216,9 +226,10 @@ function releaseLock(baseDir) {
  *
  * @param {string} baseDir
  * @param {number} priorMtime - Epoch ms del mtime anterior.
+ * @param {object} [opts] - Ver {@link lockPath}.
  */
-function rollbackLock(baseDir, priorMtime) {
-  const lp = lockPath(baseDir);
+function rollbackLock(baseDir, priorMtime, opts = {}) {
+  const lp = lockPath(baseDir, opts);
   try {
     if (priorMtime === 0) {
       // No había lock antes → eliminar

package/hooks/lib/etapa-auto-evolucion.js

@@ -40,6 +40,7 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
 const path = require('path');
 
 // Escritura atómica obligatoria para estado mutable (regla CLAUDE.md).
@@ -74,9 +75,13 @@ try {
 
 let driftDetector;
 try {
-  driftDetector = require('../scripts/lib/drift-detector');
+  driftDetector = require('../scripts/lib/drift-detector'); // repo madre
 } catch {
-  driftDetector = null;
+  try {
+    driftDetector = require('./drift-detector'); // destino: scripts/lib → hooks/lib (siblings)
+  } catch {
+    driftDetector = null;
+  }
 }
 
 let agentRouting;
@@ -105,8 +110,9 @@ const VENTANA_DIAS         = 14;
 const MIN_TOOL_CALLS       = 5;   // por debajo se considera trivial
 const MIN_INVOCACIONES_LOOP = 6;  // mínimo para que el ratio de convergencia sea significativo
 
-const DIR_AUTOEVOL  = path.join(process.cwd(), '.planning', 'auto-evolution');
-const DIR_TRACES    = path.join(process.cwd(), '.planning', 'traces');
+const RAIZ = raizProyecto(process.cwd()); // una sola resolución por proceso
+const DIR_AUTOEVOL  = path.join(RAIZ, '.planning', 'auto-evolution');
+const DIR_TRACES    = path.join(RAIZ, '.planning', 'traces');
 const LOG_PATH      = path.join(DIR_AUTOEVOL, 'agentes.jsonl');
 const NUDGES_PATH   = path.join(DIR_AUTOEVOL, 'nudges.json');
 

package/hooks/lib/etapa-metricas.js

@@ -20,6 +20,7 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
 const path = require('path');
 
 let atomicWriteJSON;
@@ -36,7 +37,7 @@ try {
   nudgeTracker = null;
 }
 
-const CWD = process.cwd();
+const CWD = raizProyecto(process.cwd());
 const DIR_EVOL = path.join(CWD, '.planning', 'evolution');
 const METRICAS_PATH = path.join(DIR_EVOL, 'metricas.json');
 const INSTINTOS_PROYECTO = path.join(CWD, 'instintos', 'proyecto.yaml');

package/hooks/lib/etapa-perfil-usuario.js

@@ -28,6 +28,8 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
+const { conLockRetry } = require('./singleton-guard');
 const path = require('path');
 
 let atomicWriteJSON;
@@ -60,11 +62,14 @@ try {
 // ---------------------------------------------------------------------------
 
 const UMBRAL_NUDGE = parseInt(process.env.SWL_PERFIL_UMBRAL || '3', 10);
-const DIR_PERFIL   = path.join(process.cwd(), '.planning', 'user-profile');
+// Una sola resolución de la raíz por carga del módulo — las 4 rutas comparten
+// ancla; resolverla 4 veces repetía el walk ascendente con su I/O (nemesis S2-3).
+const RAIZ = raizProyecto(process.cwd());
+const DIR_PERFIL   = path.join(RAIZ, '.planning', 'user-profile');
 const DIRTY_PATH   = path.join(DIR_PERFIL, 'dirty.json');
-const PERFIL_PATH  = path.join(process.cwd(), 'instintos', 'perfil-usuario.yaml');
-const APRENDIZAJES_PATH = path.join(process.cwd(), '.planning', 'APRENDIZAJES.md');
-const INSTINTOS_PATH    = path.join(process.cwd(), 'instintos', 'proyecto.yaml');
+const PERFIL_PATH  = path.join(RAIZ, 'instintos', 'perfil-usuario.yaml');
+const APRENDIZAJES_PATH = path.join(RAIZ, '.planning', 'APRENDIZAJES.md');
+const INSTINTOS_PATH    = path.join(RAIZ, 'instintos', 'proyecto.yaml');
 
 // Keywords de corrección (señal fuerte: el usuario está corrigiendo)
 const KEYWORDS_CORRECCION = [
@@ -237,6 +242,17 @@ function extraerPromptsUsuario(inputRaw) {
  * @param {string} inputRaw transcripción de la sesión (payload del hook Stop)
  */
 function ejecutar(inputRaw) {
+  // El cuerpo hace read-modify-write sobre dirty.json (leerDirty → mutar →
+  // escribirDirty). Dos hooks Stop casi-simultáneos podían pisar el contador
+  // (nemesis S2-2). Serializar con lock; bajo contención se OMITE — perder un
+  // incremento de señal es aceptable (la próxima sesión re-dispara).
+  conLockRetry('etapa-perfil-usuario', () => _ejecutarInterno(inputRaw), {
+    maxWaitMs: 500,
+    siNoAdquiere: 'omitir',
+  });
+}
+
+function _ejecutarInterno(inputRaw) {
   try {
     const textoUsuario = extraerPromptsUsuario(inputRaw);
 

package/hooks/lib/evolution-tracker.js

@@ -17,6 +17,7 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
 const path = require('path');
 
 // Escritura atómica obligatoria (regla CLAUDE.md). Fallback defensivo.
@@ -248,7 +249,7 @@ function _readSidecar(filePath) {
  * @returns {boolean}
  */
 function isPackageRoot(cwd) {
-  const dir = cwd || process.cwd();
+  const dir = cwd || raizProyecto(process.cwd());
   try {
     const pkgPath = path.join(dir, 'package.json');
     if (!fs.existsSync(pkgPath)) return false;

package/hooks/lib/gateway-notify.js

@@ -1,179 +1,193 @@
-'use strict';
-
-/**
- * Gateway Notify — Helper para encolar notificaciones al gateway multi-plataforma.
- *
- * Escribe un archivo JSON en .planning/comms/ que el GatewayRunner consume
- * mediante polling (ver gateway/index.js _pollComms). Zero-deps, escritura
- * atómica, opt-in por configuración en manifiestos/gateway-config.json.
- *
- * Uso:
- *   const { notificarGateway } = require('./lib/gateway-notify');
- *   notificarGateway({ tipo: 'session-stop', titulo: 'Sesión terminada', texto: '...' });
- *
- * No bloquea ni lanza: si el gateway está deshabilitado o no hay comms dir,
- * retorna silenciosamente.
- *
- * @module hooks/lib/gateway-notify
- */
-
-const fs   = require('fs');
-const path = require('path');
-const { atomicWriteJSON } = require('./atomic-write');
-
-// Deep links opt-in (ADR-0029). Si el módulo no carga (instalación incompleta),
-// el enriquecimiento se omite silenciosamente — comportamiento default sin
-// cambios respecto a versiones previas.
-let construirDeepLink, formatearEnlace;
-try {
-  ({ construirDeepLink, formatearEnlace } = require('./deep-links'));
-} catch {
-  construirDeepLink = () => null;
-  formatearEnlace   = (_, etiqueta) => etiqueta;
-}
-
-const COMMS_DIR = '.planning/comms';
-const CONFIG_PATH = 'manifiestos/gateway-config.json';
-
-/** Receptores reconocidos para formato de deep link. */
-const RECEPTORES = new Set(['telegram', 'discord', 'slack', 'email', 'plain']);
-
-/**
- * Verifica si el gateway está habilitado en configuración.
- * @returns {boolean}
- */
-function gatewayHabilitado() {
-  try {
-    const cfgPath = path.join(process.cwd(), CONFIG_PATH);
-    if (!fs.existsSync(cfgPath)) return false;
-    const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
-    return cfg && cfg.enabled === true;
-  } catch (_) {
-    return false;
-  }
-}
-
-/**
- * Verifica si un tipo de notificación está habilitado.
- * Lee el mapa notifications de gateway-config.json.
- * @param {string} tipo - session-stop, checkpoint, error, release, build-fail
- * @returns {boolean}
- */
-function tipoHabilitado(tipo) {
-  try {
-    const cfgPath = path.join(process.cwd(), CONFIG_PATH);
-    if (!fs.existsSync(cfgPath)) return true;
-    const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
-    const map = cfg.notifications || {};
-    const claves = {
-      'session-stop': 'onSessionComplete',
-      'checkpoint':   'onCheckpoint',
-      'error':        'onError',
-      'release':      'onRelease',
-      'build-fail':   'onBuildFail',
-    };
-    const clave = claves[tipo];
-    if (!clave) return true;
-    return map[clave] !== false;
-  } catch (_) {
-    return true;
-  }
-}
-
-/**
- * Si el payload incluye `fileRef` + `idePreferido`, retorna el enlace
- * formateado al receptor; en otro caso retorna null. No modifica el payload.
- *
- * Estructura esperada del payload (opt-in, ADR-0029):
- *   payload.fileRef = {
- *     archivo: '/abs/path/al/archivo.js',
- *     linea?: 42,
- *     columna?: 8,
- *     etiqueta?: 'Abrir archivo.js:42',   // default: archivo:linea
- *     proyecto?: 'mi-proyecto',           // requerido solo para JetBrains
- *   }
- *   payload.idePreferido = 'vscode' | 'cursor' | ...
- *
- * @param {object} payload
- * @param {string} receptor - 'telegram' | 'discord' | 'slack' | 'email' | 'plain'
- * @returns {string|null}
- * @private
- */
-function _construirEnlaceFileRef(payload, receptor) {
-  if (!payload || !payload.fileRef || !payload.idePreferido) return null;
-  const { archivo, linea, columna, etiqueta, proyecto } = payload.fileRef;
-  if (!archivo) return null;
-
-  const url = construirDeepLink({
-    ide: payload.idePreferido,
-    rutaAbsoluta: archivo,
-    linea,
-    columna,
-    proyecto,
-  });
-
-  const label = etiqueta || (linea ? `${path.basename(archivo)}:${linea}` : path.basename(archivo));
-  const formato = RECEPTORES.has(receptor) ? receptor : 'plain';
-  return formatearEnlace(url, label, formato);
-}
-
-/**
- * Encola una notificación para el gateway.
- * No bloquea ni lanza. Retorna true si se encoló, false si fue descartada.
- *
- * Enriquecimiento opt-in (ADR-0029): si `params.payload.fileRef` +
- * `params.payload.idePreferido` están presentes, el mensaje agrega el campo
- * `enlace` con un deep link formateado al receptor. Sin esos campos, el
- * comportamiento es idéntico al previo (compatibilidad hacia atrás).
- *
- * @param {object} params
- * @param {string} params.tipo - session-stop, checkpoint, error, release, build-fail, custom
- * @param {string} [params.titulo] - Título corto.
- * @param {string} [params.texto] - Texto del mensaje (soporta Markdown).
- * @param {string} [params.to='all'] - Destino: 'all', 'telegram', 'discord', etc.
- * @param {object} [params.payload] - Payload adicional para el adaptador.
- * @returns {boolean}
- */
-function notificarGateway(params) {
-  try {
-    if (!gatewayHabilitado()) return false;
-    if (!tipoHabilitado(params.tipo)) return false;
-
-    const commsDir = path.join(process.cwd(), COMMS_DIR);
-    if (!fs.existsSync(commsDir)) {
-      fs.mkdirSync(commsDir, { recursive: true });
-    }
-
-    const id = `msg-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
-    const receptor = params.to || 'all';
-    const payloadBase = {
-      tipo:   params.tipo,
-      titulo: params.titulo || '',
-      texto:  params.texto  || '',
-      ...(params.payload || {}),
-    };
-
-    // Enriquecimiento opt-in con deep link (ADR-0029).
-    const enlace = _construirEnlaceFileRef(payloadBase, receptor);
-    if (enlace) payloadBase.enlace = enlace;
-
-    const msg = {
-      id,
-      type:   'gateway_notification',
-      from:   'swl-system',
-      to:     receptor,
-      payload: payloadBase,
-      text: params.texto || '',
-      timestamp: new Date().toISOString(),
-      status: 'pending',
-    };
-
-    const filePath = path.join(commsDir, `${id}.json`);
-    atomicWriteJSON(filePath, msg);
-    return true;
-  } catch (_) {
-    return false;
-  }
-}
-
-module.exports = { notificarGateway, gatewayHabilitado, tipoHabilitado };
+'use strict';
+
+/**
+ * Gateway Notify — Helper para encolar notificaciones al gateway multi-plataforma.
+ *
+ * Escribe un archivo JSON en .planning/comms/ que el GatewayRunner consume
+ * mediante polling (ver gateway/index.js _pollComms). Zero-deps, escritura
+ * atómica, opt-in por configuración en manifiestos/gateway-config.json.
+ *
+ * Uso:
+ *   const { notificarGateway } = require('./lib/gateway-notify');
+ *   notificarGateway({ tipo: 'session-stop', titulo: 'Sesión terminada', texto: '...' });
+ *
+ * No bloquea ni lanza: si el gateway está deshabilitado o no hay comms dir,
+ * retorna silenciosamente.
+ *
+ * @module hooks/lib/gateway-notify
+ */
+
+const fs   = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
+const path = require('path');
+const { atomicWriteJSON } = require('./atomic-write');
+
+// Deep links opt-in (ADR-0029). Si el módulo no carga (instalación incompleta),
+// el enriquecimiento se omite silenciosamente — comportamiento default sin
+// cambios respecto a versiones previas.
+let construirDeepLink, formatearEnlace;
+try {
+  ({ construirDeepLink, formatearEnlace } = require('./deep-links'));
+} catch {
+  construirDeepLink = () => null;
+  formatearEnlace   = (_, etiqueta) => etiqueta;
+}
+
+const COMMS_DIR = '.planning/comms';
+const CONFIG_PATH = 'manifiestos/gateway-config.json';
+
+// Memo de la raíz del proyecto POR cwd: una notificación consulta config +
+// comms en la misma invocación — sin memo el walk ascendente de raizProyecto
+// se repetiría 3 veces con su I/O de existsSync. La clave por cwd evita
+// congelar la raíz cuando el proceso cambia de directorio (tests, daemons).
+let _raizCache = null;
+function raizBase() {
+  const cwd = process.cwd();
+  if (!_raizCache || _raizCache.cwd !== cwd) {
+    _raizCache = { cwd, raiz: raizProyecto(cwd) };
+  }
+  return _raizCache.raiz;
+}
+
+/** Receptores reconocidos para formato de deep link. */
+const RECEPTORES = new Set(['telegram', 'discord', 'slack', 'email', 'plain']);
+
+/**
+ * Verifica si el gateway está habilitado en configuración.
+ * @returns {boolean}
+ */
+function gatewayHabilitado() {
+  try {
+    const cfgPath = path.join(raizBase(), CONFIG_PATH);
+    if (!fs.existsSync(cfgPath)) return false;
+    const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+    return cfg && cfg.enabled === true;
+  } catch (_) {
+    return false;
+  }
+}
+
+/**
+ * Verifica si un tipo de notificación está habilitado.
+ * Lee el mapa notifications de gateway-config.json.
+ * @param {string} tipo - session-stop, checkpoint, error, release, build-fail
+ * @returns {boolean}
+ */
+function tipoHabilitado(tipo) {
+  try {
+    const cfgPath = path.join(raizBase(), CONFIG_PATH);
+    if (!fs.existsSync(cfgPath)) return true;
+    const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+    const map = cfg.notifications || {};
+    const claves = {
+      'session-stop': 'onSessionComplete',
+      'checkpoint':   'onCheckpoint',
+      'error':        'onError',
+      'release':      'onRelease',
+      'build-fail':   'onBuildFail',
+    };
+    const clave = claves[tipo];
+    if (!clave) return true;
+    return map[clave] !== false;
+  } catch (_) {
+    return true;
+  }
+}
+
+/**
+ * Si el payload incluye `fileRef` + `idePreferido`, retorna el enlace
+ * formateado al receptor; en otro caso retorna null. No modifica el payload.
+ *
+ * Estructura esperada del payload (opt-in, ADR-0029):
+ *   payload.fileRef = {
+ *     archivo: '/abs/path/al/archivo.js',
+ *     linea?: 42,
+ *     columna?: 8,
+ *     etiqueta?: 'Abrir archivo.js:42',   // default: archivo:linea
+ *     proyecto?: 'mi-proyecto',           // requerido solo para JetBrains
+ *   }
+ *   payload.idePreferido = 'vscode' | 'cursor' | ...
+ *
+ * @param {object} payload
+ * @param {string} receptor - 'telegram' | 'discord' | 'slack' | 'email' | 'plain'
+ * @returns {string|null}
+ * @private
+ */
+function _construirEnlaceFileRef(payload, receptor) {
+  if (!payload || !payload.fileRef || !payload.idePreferido) return null;
+  const { archivo, linea, columna, etiqueta, proyecto } = payload.fileRef;
+  if (!archivo) return null;
+
+  const url = construirDeepLink({
+    ide: payload.idePreferido,
+    rutaAbsoluta: archivo,
+    linea,
+    columna,
+    proyecto,
+  });
+
+  const label = etiqueta || (linea ? `${path.basename(archivo)}:${linea}` : path.basename(archivo));
+  const formato = RECEPTORES.has(receptor) ? receptor : 'plain';
+  return formatearEnlace(url, label, formato);
+}
+
+/**
+ * Encola una notificación para el gateway.
+ * No bloquea ni lanza. Retorna true si se encoló, false si fue descartada.
+ *
+ * Enriquecimiento opt-in (ADR-0029): si `params.payload.fileRef` +
+ * `params.payload.idePreferido` están presentes, el mensaje agrega el campo
+ * `enlace` con un deep link formateado al receptor. Sin esos campos, el
+ * comportamiento es idéntico al previo (compatibilidad hacia atrás).
+ *
+ * @param {object} params
+ * @param {string} params.tipo - session-stop, checkpoint, error, release, build-fail, custom
+ * @param {string} [params.titulo] - Título corto.
+ * @param {string} [params.texto] - Texto del mensaje (soporta Markdown).
+ * @param {string} [params.to='all'] - Destino: 'all', 'telegram', 'discord', etc.
+ * @param {object} [params.payload] - Payload adicional para el adaptador.
+ * @returns {boolean}
+ */
+function notificarGateway(params) {
+  try {
+    if (!gatewayHabilitado()) return false;
+    if (!tipoHabilitado(params.tipo)) return false;
+
+    const commsDir = path.join(raizBase(), COMMS_DIR);
+    if (!fs.existsSync(commsDir)) {
+      fs.mkdirSync(commsDir, { recursive: true });
+    }
+
+    const id = `msg-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+    const receptor = params.to || 'all';
+    const payloadBase = {
+      tipo:   params.tipo,
+      titulo: params.titulo || '',
+      texto:  params.texto  || '',
+      ...(params.payload || {}),
+    };
+
+    // Enriquecimiento opt-in con deep link (ADR-0029).
+    const enlace = _construirEnlaceFileRef(payloadBase, receptor);
+    if (enlace) payloadBase.enlace = enlace;
+
+    const msg = {
+      id,
+      type:   'gateway_notification',
+      from:   'swl-system',
+      to:     receptor,
+      payload: payloadBase,
+      text: params.texto || '',
+      timestamp: new Date().toISOString(),
+      status: 'pending',
+    };
+
+    const filePath = path.join(commsDir, `${id}.json`);
+    atomicWriteJSON(filePath, msg);
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+
+module.exports = { notificarGateway, gatewayHabilitado, tipoHabilitado };

package/hooks/lib/loop-telemetry.js

@@ -29,6 +29,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
 const path = require('path');
 const { atomicWriteSync, atomicWriteJSON } = require('./atomic-write');
 
@@ -60,11 +61,11 @@ function timestampCompacto(fecha) {
  * @param {string} opciones.tipo - Identificador del loop (ej: 'autoresearch', 'nemesis', 'verificar').
  * @param {string} [opciones.direccion='higher_is_better'] - Dirección de la métrica.
  * @param {string[]} [opciones.columnas] - Columnas del TSV (default COLUMNAS_DEFAULT).
- * @param {string} [opciones.raiz=process.cwd()] - Raíz del proyecto.
+ * @param {string} [opciones.raiz=raizProyecto(process.cwd())] - Raíz del proyecto.
  * @param {object} [opciones.config={}] - Config inicial persistida en meta.json.
  * @returns {{dir: string, tsvPath: string}}
  */
-function iniciarCorrida({ tipo, direccion = 'higher_is_better', columnas, raiz = process.cwd(), config = {} }) {
+function iniciarCorrida({ tipo, direccion = 'higher_is_better', columnas, raiz = raizProyecto(process.cwd()), config = {} }) {
   if (!tipo || !/^[a-z0-9-]+$/.test(tipo)) {
     throw new TypeError(`loop-telemetry: tipo inválido "${tipo}" — usar kebab-case (ej: "autoresearch")`);
   }
@@ -269,12 +270,12 @@ function leerHandoff(dir) {
  * Encuentra la corrida activa más reciente: directorio en .planning/loops/
  * cuyo iteraciones.tsv fue modificado hace menos de maxEdadMin minutos.
  *
- * @param {string} [raiz=process.cwd()]
+ * @param {string} [raiz=raizProyecto(process.cwd())]
  * @param {object} [opciones]
  * @param {number} [opciones.maxEdadMin=30]
  * @returns {{dir: string, tipo: string, ultimasFilas: object[], totalFilas: number}|null}
  */
-function corridaActiva(raiz = process.cwd(), { maxEdadMin = 30 } = {}) {
+function corridaActiva(raiz = raizProyecto(process.cwd()), { maxEdadMin = 30 } = {}) {
   const base = path.join(raiz, DIR_LOOPS);
   let candidatos;
   try {

package/hooks/lib/mcp-health.js

@@ -17,6 +17,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
 const path = require('path');
 const os = require('os');
 
@@ -151,7 +152,7 @@ function getHealthReport() {
  * @returns {string[]} Nombres de servidores MCP configurados.
  */
 function detectConfiguredMCPs(cwd) {
-  const dir = cwd || process.cwd();
+  const dir = cwd || raizProyecto(process.cwd());
   const mcpPath = path.join(dir, '.mcp.json');
   try {
     const config = JSON.parse(fs.readFileSync(mcpPath, 'utf8'));

package/hooks/lib/memory-search.js

@@ -246,6 +246,10 @@ function _buscarEnSesionesFallback(baseDir, terminos) {
  * @returns {object|null}
  */
 function obtenerSesion(baseDir, id) {
+  // El id interpola en un path: solo caracteres de id legítimo (ses-...,
+  // apr-N) — sin separadores ni '..' que resuelvan fuera de sessions/
+  // (defensa en profundidad para el CLI `swl-ses memoria-search fetch`).
+  if (!/^[a-zA-Z0-9_-]+$/.test(String(id))) return null;
   const sessionPath = path.join(baseDir, '.planning', 'sessions', `${id}.json`);
   if (!fs.existsSync(sessionPath)) return null;