@saulwade/swl-ses 2.5.2 → 2.6.0

package/habilidades/validacion-ci-sistema/SKILL.md

@@ -30,7 +30,7 @@ validar y un score de componentes sería engañoso. El gate determinista vive en
 `/swl:status salud` (Paso 0):
 
 ```bash
-node scripts/lib/detectar-host-swl.js --json
+swl-ses detectar-host --json
 ```
 
 Si `esHost: false`, NO ejecutar este skill: reportar que `salud` no aplica y

package/hooks/agente-lifecycle.js

@@ -21,9 +21,10 @@
  */
 
 const { desdePayloadHook, emitirCompletado } = require('./lib/agent-backend');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const es = require('./lib/execution-state');
 
-const CWD = process.cwd();
+const CWD = raizProyecto(process.cwd());
 
 // ---------------------------------------------------------------------------
 // Entrypoint

package/hooks/aiisms-detector.js

@@ -34,6 +34,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const { spawnSync, randomUUID } = require('child_process');
 const crypto = require('crypto');
@@ -92,10 +93,18 @@ if (!fs.existsSync(filePath)) {
   process.exit(0);
 }
 
-// Ruta del detector (zero-deps, stdlib Python)
-const CWD = process.cwd();
-const detector = path.join(CWD, 'habilidades', 'estilo-sin-ai-isms', 'scripts', 'detectar_aiisms.py');
-if (!fs.existsSync(detector)) {
+// Ancla de DATOS (nudges, rutas relativas): raíz del proyecto.
+const CWD = raizProyecto(process.cwd());
+// El detector es EJECUTABLE de la distribución SWL: se resuelve SOLO desde
+// la ubicación instalada del hook (__dirname), NUNCA desde el árbol del
+// proyecto — un repo no confiable podría plantar el script (hallazgo
+// revisor-seguridad 2026-07-10, clase spawn/require-desde-raíz).
+const detector = [
+  path.join(__dirname, '..', 'habilidades', 'estilo-sin-ai-isms', 'scripts', 'detectar_aiisms.py'),       // repo madre
+  path.join(__dirname, '..', 'skills', 'estilo-sin-ai-isms', 'scripts', 'detectar_aiisms.py'),            // destino global (~/.claude/hooks ~ skills hermanos)
+  path.join(__dirname, '..', '.claude', 'skills', 'estilo-sin-ai-isms', 'scripts', 'detectar_aiisms.py'), // destino local (<proyecto>/hooks + <proyecto>/.claude/skills)
+].find(p => { try { return fs.existsSync(p); } catch (_) { return false; } });
+if (!detector) {
   process.exit(0);
 }
 

package/hooks/audit-trail.js

@@ -19,13 +19,14 @@
  */
 
 const fs    = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path  = require('path');
 const http  = require('http');
 const https = require('https');
 
 const { appendAudit: merkleAppend } = require(path.join(__dirname, 'lib', 'merkle-audit'));
 
-const CWD        = process.cwd();
+const CWD        = raizProyecto(process.cwd());
 const AUDIT_FILE = path.join(CWD, '.planning', 'audit.jsonl');
 const MERKLE_FILE = path.join(CWD, '.planning', 'audit-merkle.jsonl');
 

package/hooks/auto-consolidacion.js

@@ -29,6 +29,7 @@
  */
 
 const path = require('path');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const fs   = require('fs');
 const os   = require('os');
 
@@ -97,7 +98,7 @@ process.stdin.on('end', () => {
     // Anti-spam: solo ejecutar 1 vez por sesión
     if (alreadyRan()) return;
 
-    const baseDir = process.cwd();
+    const baseDir = raizProyecto(process.cwd());
 
     // Verificar las 3 gates
     const gates = checkAllGates(baseDir, {

package/hooks/captura-acciones-post.js

@@ -19,6 +19,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const { execFileSync } = require('child_process');
 
@@ -142,7 +143,7 @@ if (!require.main || require.main === module) {
   process.stdin.on('end', () => {
     try {
       const data = JSON.parse(inputRaw);
-      procesarTurno(data, process.cwd());
+      procesarTurno(data, raizProyecto(process.cwd()));
     } catch (_) {
       /* silencioso */
     }

package/hooks/captura-acciones-session.js

@@ -20,6 +20,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const { execFileSync } = require('child_process');
 
@@ -145,7 +146,7 @@ if (!require.main || require.main === module) {
   process.stdin.on('data', (c) => { inputRaw += c; });
   process.stdin.on('end', () => {
     try {
-      inspeccionar(process.cwd());
+      inspeccionar(raizProyecto(process.cwd()));
     } catch (_) {
       /* silencioso: el hook nunca bloquea la sesión */
     }

package/hooks/captura-feedback-usuario.js

@@ -25,6 +25,7 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 
 // ---------------------------------------------------------------------------
@@ -104,7 +105,7 @@ function detectarFeedback(prompt) {
  */
 function encolar(hallazgo, meta) {
   try {
-    const dir = path.join(process.cwd(), '.planning', 'evolution');
+    const dir = path.join(raizProyecto(process.cwd()), '.planning', 'evolution');
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
 
     const entrada = {
@@ -140,7 +141,7 @@ process.stdin.on('end', () => {
     if (hallazgos.length === 0) return;
 
     for (const h of hallazgos) {
-      encolar(h, { sessionId, cwd: process.cwd() });
+      encolar(h, { sessionId, cwd: raizProyecto(process.cwd()) });
     }
   } catch (_) { /* silencioso */ }
 });

package/hooks/claudemd-bloat-detector.js

@@ -36,6 +36,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const crypto = require('crypto');
 
@@ -93,9 +94,17 @@ if (!fs.existsSync(filePath)) {
 }
 
 // ─── Ejecutar auditor (módulo, no subproceso) ─────────────────────────────
-const CWD = process.cwd();
-const auditorPath = path.join(CWD, 'scripts', 'auditar-claudemd.js');
-if (!fs.existsSync(auditorPath)) {
+// Ancla de DATOS (nudges, rutas relativas): raíz del proyecto.
+const CWD = raizProyecto(process.cwd());
+// El auditor es MÓDULO de la distribución SWL: se resuelve SOLO desde la
+// ubicación instalada del hook (__dirname), NUNCA desde el árbol del
+// proyecto — un require() de un path plantado por un repo no confiable es
+// ejecución de código (hallazgo revisor-seguridad 2026-07-10).
+const auditorPath = [
+  path.join(__dirname, '..', 'scripts', 'auditar-claudemd.js'), // repo madre
+  path.join(__dirname, 'auditar-claudemd.js'),                  // destino aplanado
+].find(p => { try { return fs.existsSync(p); } catch (_) { return false; } });
+if (!auditorPath) {
   // No hay auditor instalado en este destino; salir silenciosamente
   process.exit(0);
 }

package/hooks/claudemd-duplicacion-detector.js

@@ -39,6 +39,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const os = require('os');
 const crypto = require('crypto');
@@ -102,9 +103,18 @@ if (!fs.existsSync(filePath)) {
 }
 
 // ─── Cargar detector ──────────────────────────────────────────────────────
-const CWD = process.cwd();
-const detectorPath = path.join(CWD, 'scripts', 'lib', 'detector-reglas-duplicadas.js');
-if (!fs.existsSync(detectorPath)) {
+// Ancla de DATOS (nudges, rutas relativas): raíz del proyecto.
+const CWD = raizProyecto(process.cwd());
+// El detector es MÓDULO de la distribución SWL: se resuelve SOLO desde la
+// ubicación instalada del hook (__dirname), NUNCA desde el árbol del
+// proyecto — un require() de un path plantado por un repo no confiable es
+// ejecución de código (hallazgo revisor-seguridad 2026-07-10).
+const detectorPath = [
+  path.join(__dirname, '..', 'scripts', 'lib', 'detector-reglas-duplicadas.js'), // repo madre
+  path.join(__dirname, 'lib', 'detector-reglas-duplicadas.js'),                  // destino (scripts/lib → hooks/lib)
+  path.join(__dirname, 'detector-reglas-duplicadas.js'),                         // destino legado aplanado
+].find(p => { try { return fs.existsSync(p); } catch (_) { return false; } });
+if (!detectorPath) {
   // No hay detector instalado en este destino; salir silenciosamente
   process.exit(0);
 }

package/hooks/contexto-iteracion.js

@@ -28,6 +28,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 
 const { atomicWriteJSON } = require('./lib/atomic-write');
@@ -112,7 +113,7 @@ function main() {
     try {
       if (process.env.SWL_CONTEXTO_ITERACION === '0') return;
 
-      const activa = corridaActiva(process.cwd(), { maxEdadMin: 30 });
+      const activa = corridaActiva(raizProyecto(process.cwd()), { maxEdadMin: 30 });
       if (!activa) return;
       if (!debeInyectar(activa.dir)) return;
 

package/hooks/degradacion-instintos.js

@@ -20,6 +20,7 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 
 const { atomicWriteSync } = require('./lib/atomic-write');
@@ -28,7 +29,7 @@ const { atomicWriteSync } = require('./lib/atomic-write');
 // Constantes
 // ---------------------------------------------------------------------------
 
-const RUTA_APRENDIZAJES = path.join(process.cwd(), '.planning', 'APRENDIZAJES.md');
+const RUTA_APRENDIZAJES = path.join(raizProyecto(process.cwd()), '.planning', 'APRENDIZAJES.md');
 const MAX_CONTRADICCIONES = 3;
 
 // Palabras clave que indican exito en el output del agente

package/hooks/extraccion-aprendizajes.js

@@ -31,6 +31,8 @@ const path = require('path');
 const os   = require('os');
 
 const { atomicWriteSync } = require('./lib/atomic-write');
+const { raizProyecto } = require('./lib/raiz-proyecto');
+const { conLockRetry } = require('./lib/singleton-guard');
 
 // ---------------------------------------------------------------------------
 // Constantes de configuración
@@ -38,9 +40,13 @@ const { atomicWriteSync } = require('./lib/atomic-write');
 
 /**
  * Ruta del archivo donde se acumulan los aprendizajes.
- * Se resuelve relativa al CWD del proceso (raíz del proyecto).
+ * Se re-resuelve en el entrypoint con la RAÍZ DEL PROYECTO (raizProyecto:
+ * primer .planning/ real ascendiendo, o raíz del repo git, o fallback cwd) —
+ * NUNCA con el CWD crudo de la sesión: en monorepos con sesión abierta en un
+ * subdirectorio eso fragmentaba la memoria en árboles .planning/ huérfanos
+ * (DT-HOOKS-RAIZ-GIT, reportes de campo sigm + oic 2026-07-10).
  */
-const RUTA_APRENDIZAJES = path.join(process.cwd(), '.planning', 'APRENDIZAJES.md');
+let RUTA_APRENDIZAJES = path.join(raizProyecto(process.cwd()), '.planning', 'APRENDIZAJES.md');
 
 /**
  * Número de líneas de contexto a extraer alrededor del keyword detectado.
@@ -364,9 +370,15 @@ function extraerTextoYAgente(data) {
  *   4. Clasificar por el tipo de keyword que disparó la detección.
  *
  * @param {string} texto
+ * @param {object} [opts]
+ * @param {boolean} [opts.descartarFragmentos=false] - Descarta candidatos cuya
+ *   descripción quedó TRUNCADA a media frase (termina en '…' sin oración
+ *   completa). Obligatorio para fuentes Write/Edit: los comentarios de código
+ *   de dominio largos producían entradas cortadas a medias que no son
+ *   aprendizajes (reporte de campo sigm 2026-07-10).
  * @returns {Aprendizaje|null}
  */
-function detectarAprendizaje(texto) {
+function detectarAprendizaje(texto, opts = {}) {
   if (!texto || texto.trim().length < MIN_CHARS_DESCRIPCION) return null;
 
   const lineas = texto.split('\n');
@@ -395,12 +407,28 @@ function detectarAprendizaje(texto) {
         // Descripción: la línea del keyword, limpiada de símbolos de código.
         // Preferir cortar al final de la primera oración si cabe en 120 chars;
         // si no, al último espacio antes del límite.
-        const lineaLimpia = lineas[i]
+        const limpiarLinea = l => l
           .trim()
           .replace(/^[#*\/\-–•]+\s*/, '') // Quitar prefijos de comentario/lista
           .replace(/\*\*/g, '')            // Quitar marcadores de negrita Markdown
           .replace(/`+/g, '');             // Quitar backticks
 
+        let lineaLimpia = limpiarLinea(lineas[i]);
+
+        // Wrap del editor ≠ fin del pensamiento: si la línea del keyword no
+        // cierra oración, unir hasta 2 líneas siguientes antes de buscar el
+        // corte — los comentarios largos envuelven la frase y cortar en el
+        // wrap producía títulos a media frase (ticket de campo sigm
+        // 2026-07-10: "...pueden cerrar la 'corrección' apuntando a").
+        if (!/[.!?]/.test(lineaLimpia)) {
+          for (let j = i + 1; j < Math.min(i + 3, lineas.length); j++) {
+            const continuacion = limpiarLinea(lineas[j]);
+            if (!continuacion) break;
+            lineaLimpia += ' ' + continuacion;
+            if (/[.!?]/.test(continuacion)) break;
+          }
+        }
+
         // Si la línea tiene un punto temprano, usarlo como fin natural
         const matchOracion = lineaLimpia.match(/^[^.!?]*[.!?]/);
         const descripcionBase = matchOracion
@@ -411,6 +439,12 @@ function detectarAprendizaje(texto) {
 
         if (descripcion.length < 10) continue;
 
+        // Fragmento a media frase: ni la línea ni sus continuaciones cierran
+        // oración Y hubo que truncar — para fuentes de escritura de código
+        // eso es ruido. Una oración completa truncada elegante (corte en
+        // frontera de cláusula con '…') SÍ es título legítimo.
+        if (opts.descartarFragmentos && !matchOracion && descripcion.endsWith('…')) continue;
+
         return { tipo, contexto: contextoFinal, descripcion };
       }
     }
@@ -540,6 +574,27 @@ function formatearEntrada(fecha, tipo, descripcion, agente, contexto) {
  * @param {string} agente
  */
 function escribirAprendizaje(aprendizaje, agente) {
+  // Read-modify-write sobre APRENDIZAJES.md (leer todo → dedup → reescribir
+  // todo). Dos hooks concurrentes leían la misma base y el segundo write
+  // pisaba la entrada del primero → aprendizaje perdido (nemesis S2-2).
+  // El lock O_EXCL serializa el CASO COMÚN (secciones críticas de <<1s): dos
+  // hooks casi-simultáneos se ordenan, sin pérdida. La lectura ocurre DENTRO de
+  // la sección crítica para ver base fresca.
+  //
+  // Límite honesto (re-auditoría nemesis iter-2): siNoAdquiere:'ejecutar'
+  // significa que si tras maxWaitMs NO se adquiere el lock —solo posible con un
+  // holder VIVO ocupando el lock >1s, patológico para un archivo de KB (un
+  // holder muerto se reclama al instante vía pidVivo)— se corre igual SIN lock.
+  // En ese caso extremo el rewrite-whole-file PUEDE pisar la entrada de otro
+  // proceso. Se prefiere ese riesgo casi-inalcanzable a OMITIR y descartar el
+  // aprendizaje actual con certeza.
+  conLockRetry('extraccion-aprendizajes-md', () => _escribirAprendizajeInterno(aprendizaje, agente), {
+    maxWaitMs: 1000,
+    siNoAdquiere: 'ejecutar',
+  });
+}
+
+function _escribirAprendizajeInterno(aprendizaje, agente) {
   asegurarDirectorio();
 
   const { contenidoExistente, descripciones } = leerAprendizajesExistentes();
@@ -676,6 +731,11 @@ const PATRONES_ARCHIVO_SWL_EXCLUIDO = [
   // "rules" (inglés). Detectado 2026-06-11: fragmentos de una edición a
   // verificar-citas-normativas.md (global) se promovieron como "patrón".
   /(?:^|[\\/])\.claude[\\/]rules[\\/]/,
+  // Workflows y config de CI (.github/): sus comentarios YAML describen el
+  // proceso con keywords narrativas ("decisión", "aprobación") que el hook
+  // confunde con descubrimientos. Detectado 2026-07-10: el comentario del
+  // environment de publish-npm.yml se promovió como entrada "decisión".
+  /(?:^|[\\/])\.github[\\/]/,
 ];
 
 /**
@@ -715,6 +775,16 @@ function pareceContenidoEstructuralSwl(contexto) {
     return true;
   }
 
+  // Bold-labels de docs sin cuerpo: líneas que son SOLO una etiqueta en
+  // negritas ("**Uso:**", "**¿Cuándo usarlo?**"), con o sin valor corto de
+  // código a continuación. Junto con los headings (abajo) cubren fragmentos
+  // estructurales de manuales/skills que el hook confundía con aprendizajes
+  // (detectado 2026-07-10: headings y labels de MANUAL_USO promovidos como
+  // "gotcha"/"patrón").
+  const esLineaEstructural = l =>
+    /^(>\s*)?#{1,6}\s+\S/.test(l) ||
+    /^(>\s*)?\*\*[^*]{1,60}\*\*:?\s*(`[^`]*`\s*)?$/.test(l);
+
   // Enumeración de encabezados sin cuerpo sustantivo
   // (3+ líneas tipo "## [fecha] tipo — descripción" juntas)
   const encabezadosFecha = lineas.filter(l => /^##\s+\[\d{4}-\d{2}-\d{2}\]/.test(l));
@@ -722,15 +792,15 @@ function pareceContenidoEstructuralSwl(contexto) {
     return true;
   }
 
-  // Contexto compuesto mayoritariamente de headings sin cuerpo. Detecta
-  // placeholders auto-generados al hacer Write de archivos meta (RELEASE-NOTES,
-  // RESUMEN, PLAN) cuya estructura es solo `## Sección 1`, `## Sección 2`...
-  // sin párrafos sustantivos. Acepta tanto headings desnudos (`## Titulo`)
-  // como indentados como blockquote (`> ## Titulo`) porque el hook envuelve
-  // el contexto con `> ` antes de evaluar el resultado.
+  // Contexto compuesto mayoritariamente de headings/bold-labels sin cuerpo.
+  // Detecta placeholders auto-generados al hacer Write de archivos meta
+  // (RELEASE-NOTES, RESUMEN, PLAN) y fragmentos de docs de comandos cuya
+  // estructura es solo `## Sección`, `**Uso:**`... sin párrafos sustantivos.
+  // Acepta tanto líneas desnudas como indentadas como blockquote (`> ## X`)
+  // porque el hook envuelve el contexto con `> ` antes de evaluar.
   if (noVacias.length >= 3) {
-    const headings = noVacias.filter(l => /^(>\s*)?#{1,6}\s+\S/.test(l));
-    if (headings.length / noVacias.length > 0.6) {
+    const estructurales = noVacias.filter(esLineaEstructural);
+    if (estructurales.length / noVacias.length > 0.6) {
       return true;
     }
   }
@@ -781,15 +851,36 @@ process.stdin.on('end', () => {
       return;
     }
 
+    // Anclar la memoria a la RAÍZ DEL PROYECTO, no al CWD de la sesión
+    // (DT-HOOKS-RAIZ-GIT): una sesión abierta en backend/ de un monorepo
+    // escribía backend/.planning/APRENDIZAJES.md huérfano.
+    const baseCwd = String(data.cwd || process.cwd());
+    const raiz = raizProyecto(baseCwd);
+    RUTA_APRENDIZAJES = path.join(raiz, '.planning', 'APRENDIZAJES.md');
+
+    const esFuenteEscritura =
+      toolName === 'Write' || toolName === 'Edit' || toolName === 'MultiEdit';
+
     // Filtrar Write/Edit sobre archivos del sistema SWL (auto-referencia).
     // Editar habilidades/, agentes/, reglas/, CHANGELOG, CLAUDE.md, etc. es
     // mantenimiento del sistema, no descubrimiento en tiempo de ejecución.
-    if (toolName === 'Write' || toolName === 'Edit' || toolName === 'MultiEdit') {
+    if (esFuenteEscritura) {
       const toolInput = data.tool_input || data.tool?.input || {};
       const filePath = String(toolInput.file_path || toolInput.path || '');
       if (esArchivoSwlExcluido(filePath)) {
         return;
       }
+      // Escrituras FUERA de la raíz del proyecto (scratchpad del harness,
+      // temp, otros repos) no son descubrimiento de ESTE proyecto — su
+      // contenido meta (borradores, docs en construcción) generaba entradas
+      // espurias (detectado 2026-07-10 con archivos de trabajo en scratchpad).
+      if (filePath) {
+        const abs = path.resolve(baseCwd, filePath);
+        const rel = path.relative(raiz, abs);
+        if (rel.startsWith('..') || path.isAbsolute(rel)) {
+          return;
+        }
+      }
     }
 
     // Extraer texto y nombre del agente del payload
@@ -800,8 +891,11 @@ process.stdin.on('end', () => {
       return;
     }
 
-    // Detectar aprendizaje en el texto
-    const aprendizaje = detectarAprendizaje(texto);
+    // Detectar aprendizaje en el texto. Las fuentes de escritura de código
+    // exigen descripción con oración completa (sin fragmentos truncados).
+    const aprendizaje = detectarAprendizaje(texto, {
+      descartarFragmentos: esFuenteEscritura,
+    });
 
     if (!aprendizaje) {
       // Sin aprendizaje detectado — salir silenciosamente

package/hooks/grafo-contexto.js

@@ -19,9 +19,10 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 
-const CWD         = process.env.PWD || process.cwd();
+const CWD         = raizProyecto(process.env.PWD || process.cwd());
 const REPORT_FILE = path.join(CWD, '.planning', 'REPORTE-GRAFO.md');
 const GRAPH_FILE  = path.join(CWD, '.planning', 'graph.json');
 

package/hooks/guardrail-modelo.js

@@ -23,6 +23,7 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 
 // ---------------------------------------------------------------------------
@@ -42,7 +43,7 @@ if (ES_ENTRYPOINT && !process.env.SWL_GUARDRAIL_MODELO) {
 // Rutas
 // ---------------------------------------------------------------------------
 
-const CWD          = process.cwd();
+const CWD          = raizProyecto(process.cwd());
 const DIR_EVOL     = path.join(CWD, '.planning', 'evolution');
 const GUARDRAIL_LOG = path.join(DIR_EVOL, 'guardrail-observaciones.jsonl');
 

package/hooks/inbox-aviso.js

@@ -16,6 +16,7 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 
 const INBOX_DIR = '.planning/inbox';
@@ -51,7 +52,7 @@ process.stdin.on('end', () => {
   try {
     if (process.env.SWL_INBOX_AVISO === '0') return;
 
-    const { total, preview } = contarPendientes(process.cwd());
+    const { total, preview } = contarPendientes(raizProyecto(process.cwd()));
     if (total === 0) return;
 
     const lineas = [];

package/hooks/inyeccion-contexto.js

@@ -23,6 +23,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./lib/raiz-proyecto');
 const path = require('path');
 const os = require('os');
 
@@ -205,7 +206,7 @@ process.stdin.on('end', () => {
       return;
     }
 
-    const cwd = process.cwd();
+    const cwd = raizProyecto(process.cwd());
     const sesion = leerSesionAnterior(cwd);
 
     // Solo inyectar si la sesion anterior tiene contenido util

package/hooks/lib/agent-matcher.js

@@ -16,6 +16,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
 const path = require('path');
 
 // ---------------------------------------------------------------------------
@@ -123,7 +124,7 @@ function loadAgents(agentesDir) {
  * @returns {Array<{name: string, score: number, skills: string[]}>} Ordenado por score descendente.
  */
 function matchAgents(taskText, agentesDir) {
-  const dir = agentesDir || path.join(process.cwd(), 'agentes');
+  const dir = agentesDir || path.join(raizProyecto(process.cwd()), 'agentes');
   const agents = loadAgents(dir);
   const taskKeywords = extractKeywords(taskText);
 

package/hooks/lib/agent-routing.js

@@ -25,6 +25,7 @@
  */
 
 const fs   = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
 const path = require('path');
 
 const _cache = Object.create(null);
@@ -38,7 +39,7 @@ const _cache = Object.create(null);
  * @returns {string|null}    - Ruta absoluta o null si no existe
  */
 function resolveAgentPath(agentName, cwd) {
-  const baseDir = cwd || process.cwd();
+  const baseDir = cwd || raizProyecto(process.cwd());
   const candidates = [
     path.join(baseDir, 'agentes', `${agentName}.md`),
     path.join(baseDir, '.claude', 'agents', `${agentName}.md`),

package/hooks/lib/autonomia.js

@@ -22,6 +22,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
 const path = require('path');
 const { execFileSync } = require('child_process');
 
@@ -89,7 +90,7 @@ function _normalizarNivel(valor) {
  * @returns {{version?:string, defaults?:string, clases:Object}}
  */
 function cargarDial(baseDir) {
-  const ruta = path.join(baseDir || process.cwd(), ...YAML_PATH);
+  const ruta = path.join(baseDir || raizProyecto(process.cwd()), ...YAML_PATH);
   let parsed = {};
   try {
     parsed = _parsearYamlPlano(fs.readFileSync(ruta, 'utf8'));
@@ -153,7 +154,7 @@ function _archivosModificados(baseDir) {
 const MAX_ACCION_LEN = 512; // tope para que el JSONL no crezca sin límite
 
 function autoCheckpoint(baseDir, accion, tsISO) {
-  const base = baseDir || process.cwd();
+  const base = baseDir || raizProyecto(process.cwd());
   const registro = {
     ts: tsISO || new Date().toISOString(),
     accion: String(accion || '').slice(0, MAX_ACCION_LEN),
@@ -186,7 +187,7 @@ function _parseAccion(args) {
 
 function main(argv) {
   const accion = _parseAccion(argv.slice(2));
-  const baseDir = process.cwd();
+  const baseDir = raizProyecto(process.cwd());
   const dial = cargarDial(baseDir);
   if (requiereAutoCheckpoint(dial, 'cambio_reversible')) {
     const reg = autoCheckpoint(baseDir, accion || '(sin descripción)');
@@ -204,5 +205,6 @@ module.exports = {
   cargarDial,
   requiereAutoCheckpoint,
   autoCheckpoint,
+  main,
   _parsearYamlPlano,
 };

package/hooks/lib/captura-acciones.js

@@ -27,6 +27,7 @@
  */
 
 const fs = require('fs');
+const { raizProyecto } = require('./raiz-proyecto');
 const path = require('path');
 const crypto = require('crypto');
 
@@ -384,7 +385,7 @@ module.exports = {
 if (require.main === module) {
   try {
     if (process.argv.includes('--conteo')) {
-      process.stdout.write(JSON.stringify(contarPorSubtipo(process.cwd()), null, 2) + '\n');
+      process.stdout.write(JSON.stringify(contarPorSubtipo(raizProyecto(process.cwd())), null, 2) + '\n');
     }
   } catch (_) {
     /* exit 0 siempre */