@saulwade/swl-ses 2.4.1 → 2.4.2

package/scripts/actualizar.js

@@ -1,254 +1,253 @@
-'use strict';
-
-/**
- * swl-ses update
- * Actualiza componentes instalados preservando _userland/.
- * Interactivo: muestra versiones, pide confirmación, muestra progreso.
- * No-interactivo con --force o sin TTY.
- *
- * Modo --check (read-only):
- *   Solo muestra el estado actual de versiones (local vs npm vs runtimes instalados).
- *   No pide confirmación. No actualiza nada. Util para el autor o usuarios que
- *   quieren verificar si están al dia sin esperar al hook automatico.
- */
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { detectarRuntimes } = require('./lib/detectar-runtime');
-const { cargarEstado } = require('./lib/estado');
-const {
-  color, icono, encabezado, formatearPaso, formatearAdvertencia,
-  spinner, preguntarSiNo, lineaSeparadora, ES_TTY,
-} = require('./lib/ui');
-const { versionRemotaParalela, compararSemver } = require('./lib/npm-version');
-
-const VERSION_LOCAL = require('../package.json').version;
-
-/**
- * Consulta la versión más reciente publicada en npm. Si la consulta falla
- * (sin red, timeout), retorna la versión local como fallback razonable.
- */
-async function obtenerVersionRemota() {
-  const r = await versionRemotaParalela({ timeoutMs: 10000 });
-  return r.version || VERSION_LOCAL;
-}
-
-/**
- * Modo --check: muestra el estado actual sin actualizar. Read-only.
- *
- * Salida:
- *   - Version del paquete que esta ejecutando este CLI (VERSION_LOCAL).
- *   - Version mas reciente publicada en npm.
- *   - Comparacion semver: al dia / adelantado / atras.
- *   - Estado del hook check-update.js: ultima verificacion automatica.
- *   - Tabla por runtime instalado (si los detecta) con su versionSistema.
- */
-async function checkStatus() {
-  console.log(encabezado('swl-ses update --check', VERSION_LOCAL));
-
-  // Resolver version remota con timeout corto
-  const remota = await obtenerVersionRemota();
-  const cmp = compararSemver(VERSION_LOCAL, remota);
-
-  let estadoVersion;
-  if (cmp === null) {
-    estadoVersion = color.amarillo('Comparacion no disponible (formato inesperado)');
-  } else if (cmp === 0) {
-    estadoVersion = color.verde('Al dia');
-  } else if (cmp < 0) {
-    estadoVersion = color.amarillo(`Nueva version disponible (${remota})`);
-  } else {
-    estadoVersion = color.dim(`Local mas reciente que npm (${VERSION_LOCAL} > ${remota}, publicacion pendiente)`);
-  }
-
-  console.log(`  Paquete ejecutado:  ${color.negrita('v' + VERSION_LOCAL)}`);
-  console.log(`  Version en npm:     ${color.negrita('v' + remota)}`);
-  console.log(`  Estado:             ${estadoVersion}`);
-  console.log('');
-
-  // Estado del hook automatico (check-update.js).
-  // SWL_UPDATE_FLAG_PATH override solo para tests (evita race con flag único).
-  const flagPath = process.env.SWL_UPDATE_FLAG_PATH || path.join(os.tmpdir(), 'swl-ses-update-check.json');
-  try {
-    const flag = JSON.parse(fs.readFileSync(flagPath, 'utf8'));
-    const horas = ((Date.now() - flag.timestamp) / 3600000).toFixed(1);
-    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
-    console.log(`    Ultima verificacion: hace ${horas}h`);
-    console.log(`    Local registrada:    ${flag.local}`);
-    console.log(`    Remota registrada:   ${flag.remota || color.dim('(no resuelta)')}`);
-    console.log(`    hayNueva:            ${flag.hayNueva ? color.amarillo('si') : color.verde('no')}`);
-    console.log(`    Flag:                ${flagPath}`);
-  } catch {
-    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
-    console.log(`    ${color.dim('Sin flag de throttle — el hook nunca se ha ejecutado en este equipo,')}`);
-    console.log(`    ${color.dim('o el archivo temp/swl-ses-update-check.json fue removido.')}`);
-  }
-  console.log('');
-
-  // Estado por runtime instalado
-  const runtimes = detectarRuntimes();
-  if (runtimes.length === 0) {
-    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalacion SWL'));
-    console.log('');
-    return;
-  }
-
-  console.log(`  ${color.negrita('Runtimes detectados:')}`);
-  let totalRuntimes = 0;
-  for (const runtime of runtimes) {
-    const dirs = [runtime.global, path.resolve(runtime.local)];
-    for (const dir of dirs) {
-      if (!fs.existsSync(dir)) continue;
-      const estado = cargarEstado(dir);
-      if (!estado) continue;
-
-      const esGlobal = dir === runtime.global;
-      const ubicacion = esGlobal ? 'global' : 'proyecto';
-      const v = estado.versionSistema || 'desconocida';
-
-      const cmpRuntime = compararSemver(v, remota);
-      let etiqueta;
-      if (cmpRuntime === null) {
-        etiqueta = color.dim('(version no reconocida)');
-      } else if (cmpRuntime === 0) {
-        etiqueta = color.verde('al dia');
-      } else if (cmpRuntime < 0) {
-        etiqueta = color.amarillo(`atrasada (npm: ${remota})`);
-      } else {
-        etiqueta = color.dim('adelantada');
-      }
-
-      console.log(`    ${runtime.nombre} (${ubicacion}): v${v}  ${etiqueta}`);
-      totalRuntimes++;
-    }
-  }
-  if (totalRuntimes === 0) {
-    console.log(`    ${color.dim('(ninguno con .swl-install-state.json valido)')}`);
-  }
-  console.log('');
-  console.log(`  ${color.dim('Modo --check es read-only. Para actualizar:')} npx -y @saulwade/swl-ses@latest update`);
-  console.log('');
-}
-
-async function update(opciones) {
-  // Modo read-only: solo reportar estado, no tocar nada
-  if (opciones.check) {
-    await checkStatus();
-    return;
-  }
-
-  const force = opciones.force || !ES_TTY;
-
-  // Obtener la versión más reciente del registro npm
-  const VERSION = await obtenerVersionRemota();
-
-  console.log(encabezado('swl-ses update', VERSION_LOCAL));
-
-  // 1. Detectar runtimes
-  const runtimes = detectarRuntimes();
-
-  if (runtimes.length === 0) {
-    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalación SWL'));
-    console.log(`\n  Ejecuta primero: npx @saulwade/swl-ses@latest install --target claude`);
-    process.exit(1);
-  }
-
-  let actualizados = 0;
-  let omitidos = 0;
-
-  // 2. Iterar runtimes
-  for (const runtime of runtimes) {
-    const dirs = [runtime.global, path.resolve(runtime.local)];
-    for (const dir of dirs) {
-      if (!fs.existsSync(dir)) continue;
-
-      const estado = cargarEstado(dir);
-      if (!estado) continue;
-
-      const versionInstalada = estado.versionSistema || 'desconocida';
-      const esGlobal = dir === runtime.global;
-      const ubicacion = esGlobal ? 'global' : 'proyecto';
-
-      const necesitaActualizar = versionInstalada !== VERSION;
-      const paqueteDesactualizado = VERSION_LOCAL !== VERSION;
-
-      console.log(`  ${color.negrita(`Runtime: ${runtime.nombre}`)} ${color.dim(`(${ubicacion})`)}`);
-      console.log(`  Versión instalada:  ${necesitaActualizar ? color.amarillo(versionInstalada) : color.verde(versionInstalada)}`);
-      console.log(`  Versión disponible: ${color.verde(VERSION)}${paqueteDesactualizado ? color.dim(` (ejecutando con v${VERSION_LOCAL})`) : ''}`);
-      console.log(`  Perfil:             ${estado.perfil}`);
-      console.log(`  Componentes:        ${estado.componentesInstalados.length}`);
-      console.log(`  Archivos:           ${estado.archivosInstalados.length}`);
-      console.log('');
-
-      // Si la versión disponible es más reciente pero el paquete ejecutándose es viejo,
-      // indicar al usuario que use @latest
-      if (paqueteDesactualizado && necesitaActualizar) {
-        console.log(formatearAdvertencia(runtime.nombre,
-          `Este paquete es v${VERSION_LOCAL} pero la v${VERSION} está disponible.\n` +
-          `  Para actualizar, ejecuta: npx @saulwade/swl-ses@latest update --force`));
-        console.log('');
-        omitidos++;
-        continue;
-      }
-
-      // Verificar si ya está actualizado
-      if (!necesitaActualizar && !force) {
-        console.log(formatearPaso(runtime.nombre, 'Ya está en la versión más reciente'));
-        console.log('');
-        omitidos++;
-        continue;
-      }
-
-      // Confirmar
-      if (!force) {
-        const confirmar = await preguntarSiNo(
-          !necesitaActualizar
-            ? `¿Re-instalar ${runtime.nombre} v${VERSION}?`
-            : `¿Actualizar ${runtime.nombre} de ${versionInstalada} a ${VERSION}?`
-        );
-        console.log('');
-
-        if (!confirmar) {
-          console.log(formatearAdvertencia(runtime.nombre, 'Actualización cancelada por el usuario'));
-          console.log('');
-          omitidos++;
-          continue;
-        }
-      }
-
-      // Ejecutar actualización con spinner
-      const sp = spinner(`Actualizando ${runtime.nombre}...`);
-
-      try {
-        const instalador = require('./instalador');
-        await instalador({
-          target: runtime.id,
-          profile: estado.perfil,
-          global: estado.global,
-          force: true,
-        });
-
-        sp.exito(`${runtime.nombre} actualizado a v${VERSION} (${estado.archivosInstalados.length} archivos)`);
-        actualizados++;
-      } catch (err) {
-        sp.fallo(`Error actualizando ${runtime.nombre}: ${err.message}`);
-      }
-
-      console.log('');
-    }
-  }
-
-  // 3. Reporte final
-  console.log(`  ${lineaSeparadora()}`);
-  if (actualizados > 0) {
-    console.log(formatearPaso('Resultado', `${actualizados} runtime(s) actualizado(s)${omitidos > 0 ? `, ${omitidos} omitido(s)` : ''}`));
-  } else if (omitidos > 0) {
-    console.log(formatearPaso('Resultado', 'Todo está actualizado'));
-  } else {
-    console.log(formatearAdvertencia('Resultado', 'Ningún runtime fue actualizado'));
-  }
-  console.log('');
-}
-
-module.exports = update;
+'use strict';
+
+/**
+ * swl-ses update
+ * Actualiza componentes instalados preservando _userland/.
+ * Interactivo: muestra versiones, pide confirmación, muestra progreso.
+ * No-interactivo con --force o sin TTY.
+ *
+ * Modo --check (read-only):
+ *   Solo muestra el estado actual de versiones (local vs npm vs runtimes instalados).
+ *   No pide confirmación. No actualiza nada. Util para el autor o usuarios que
+ *   quieren verificar si están al dia sin esperar al hook automatico.
+ */
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { detectarRuntimes, scopesReales } = require('./lib/detectar-runtime');
+const { cargarEstado } = require('./lib/estado');
+const {
+  color, icono, encabezado, formatearPaso, formatearAdvertencia,
+  spinner, preguntarSiNo, lineaSeparadora, ES_TTY,
+} = require('./lib/ui');
+const { versionRemotaParalela, compararSemver } = require('./lib/npm-version');
+
+const VERSION_LOCAL = require('../package.json').version;
+
+/**
+ * Consulta la versión más reciente publicada en npm. Si la consulta falla
+ * (sin red, timeout), retorna la versión local como fallback razonable.
+ */
+async function obtenerVersionRemota() {
+  const r = await versionRemotaParalela({ timeoutMs: 10000 });
+  return r.version || VERSION_LOCAL;
+}
+
+/**
+ * Modo --check: muestra el estado actual sin actualizar. Read-only.
+ *
+ * Salida:
+ *   - Version del paquete que esta ejecutando este CLI (VERSION_LOCAL).
+ *   - Version mas reciente publicada en npm.
+ *   - Comparacion semver: al dia / adelantado / atras.
+ *   - Estado del hook check-update.js: ultima verificacion automatica.
+ *   - Tabla por runtime instalado (si los detecta) con su versionSistema.
+ */
+async function checkStatus() {
+  console.log(encabezado('swl-ses update --check', VERSION_LOCAL));
+
+  // Resolver version remota con timeout corto
+  const remota = await obtenerVersionRemota();
+  const cmp = compararSemver(VERSION_LOCAL, remota);
+
+  let estadoVersion;
+  if (cmp === null) {
+    estadoVersion = color.amarillo('Comparacion no disponible (formato inesperado)');
+  } else if (cmp === 0) {
+    estadoVersion = color.verde('Al dia');
+  } else if (cmp < 0) {
+    estadoVersion = color.amarillo(`Nueva version disponible (${remota})`);
+  } else {
+    estadoVersion = color.dim(`Local mas reciente que npm (${VERSION_LOCAL} > ${remota}, publicacion pendiente)`);
+  }
+
+  console.log(`  Paquete ejecutado:  ${color.negrita('v' + VERSION_LOCAL)}`);
+  console.log(`  Version en npm:     ${color.negrita('v' + remota)}`);
+  console.log(`  Estado:             ${estadoVersion}`);
+  console.log('');
+
+  // Estado del hook automatico (check-update.js).
+  // SWL_UPDATE_FLAG_PATH override solo para tests (evita race con flag único).
+  const flagPath = process.env.SWL_UPDATE_FLAG_PATH || path.join(os.tmpdir(), 'swl-ses-update-check.json');
+  try {
+    const flag = JSON.parse(fs.readFileSync(flagPath, 'utf8'));
+    const horas = ((Date.now() - flag.timestamp) / 3600000).toFixed(1);
+    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
+    console.log(`    Ultima verificacion: hace ${horas}h`);
+    console.log(`    Local registrada:    ${flag.local}`);
+    console.log(`    Remota registrada:   ${flag.remota || color.dim('(no resuelta)')}`);
+    console.log(`    hayNueva:            ${flag.hayNueva ? color.amarillo('si') : color.verde('no')}`);
+    console.log(`    Flag:                ${flagPath}`);
+  } catch {
+    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
+    console.log(`    ${color.dim('Sin flag de throttle — el hook nunca se ha ejecutado en este equipo,')}`);
+    console.log(`    ${color.dim('o el archivo temp/swl-ses-update-check.json fue removido.')}`);
+  }
+  console.log('');
+
+  // Estado por runtime instalado
+  const runtimes = detectarRuntimes();
+  if (runtimes.length === 0) {
+    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalacion SWL'));
+    console.log('');
+    return;
+  }
+
+  console.log(`  ${color.negrita('Runtimes detectados:')}`);
+  let totalRuntimes = 0;
+  for (const runtime of runtimes) {
+    // Dedup + guard anti-fantasma (ver scopesReales): desde HOME el local
+    // colapsa con el global propio o con el de otro runtime.
+    for (const { dir, esGlobal } of scopesReales(runtime)) {
+      if (!fs.existsSync(dir)) continue;
+      const estado = cargarEstado(dir);
+      if (!estado) continue;
+
+      const ubicacion = esGlobal ? 'global' : 'proyecto';
+      const v = estado.versionSistema || 'desconocida';
+
+      const cmpRuntime = compararSemver(v, remota);
+      let etiqueta;
+      if (cmpRuntime === null) {
+        etiqueta = color.dim('(version no reconocida)');
+      } else if (cmpRuntime === 0) {
+        etiqueta = color.verde('al dia');
+      } else if (cmpRuntime < 0) {
+        etiqueta = color.amarillo(`atrasada (npm: ${remota})`);
+      } else {
+        etiqueta = color.dim('adelantada');
+      }
+
+      console.log(`    ${runtime.nombre} (${ubicacion}): v${v}  ${etiqueta}`);
+      totalRuntimes++;
+    }
+  }
+  if (totalRuntimes === 0) {
+    console.log(`    ${color.dim('(ninguno con .swl-install-state.json valido)')}`);
+  }
+  console.log('');
+  console.log(`  ${color.dim('Modo --check es read-only. Para actualizar:')} npx -y @saulwade/swl-ses@latest update`);
+  console.log('');
+}
+
+async function update(opciones) {
+  // Modo read-only: solo reportar estado, no tocar nada
+  if (opciones.check) {
+    await checkStatus();
+    return;
+  }
+
+  const force = opciones.force || !ES_TTY;
+
+  // Obtener la versión más reciente del registro npm
+  const VERSION = await obtenerVersionRemota();
+
+  console.log(encabezado('swl-ses update', VERSION_LOCAL));
+
+  // 1. Detectar runtimes
+  const runtimes = detectarRuntimes();
+
+  if (runtimes.length === 0) {
+    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalación SWL'));
+    console.log(`\n  Ejecuta primero: npx @saulwade/swl-ses@latest install --target claude`);
+    process.exit(1);
+  }
+
+  let actualizados = 0;
+  let omitidos = 0;
+
+  // 2. Iterar runtimes
+  for (const runtime of runtimes) {
+    // Dedup + guard anti-fantasma (ver scopesReales).
+    for (const { dir, esGlobal } of scopesReales(runtime)) {
+      if (!fs.existsSync(dir)) continue;
+
+      const estado = cargarEstado(dir);
+      if (!estado) continue;
+
+      const versionInstalada = estado.versionSistema || 'desconocida';
+      const ubicacion = esGlobal ? 'global' : 'proyecto';
+
+      const necesitaActualizar = versionInstalada !== VERSION;
+      const paqueteDesactualizado = VERSION_LOCAL !== VERSION;
+
+      console.log(`  ${color.negrita(`Runtime: ${runtime.nombre}`)} ${color.dim(`(${ubicacion})`)}`);
+      console.log(`  Versión instalada:  ${necesitaActualizar ? color.amarillo(versionInstalada) : color.verde(versionInstalada)}`);
+      console.log(`  Versión disponible: ${color.verde(VERSION)}${paqueteDesactualizado ? color.dim(` (ejecutando con v${VERSION_LOCAL})`) : ''}`);
+      console.log(`  Perfil:             ${estado.perfil}`);
+      console.log(`  Componentes:        ${estado.componentesInstalados.length}`);
+      console.log(`  Archivos:           ${estado.archivosInstalados.length}`);
+      console.log('');
+
+      // Si la versión disponible es más reciente pero el paquete ejecutándose es viejo,
+      // indicar al usuario que use @latest
+      if (paqueteDesactualizado && necesitaActualizar) {
+        console.log(formatearAdvertencia(runtime.nombre,
+          `Este paquete es v${VERSION_LOCAL} pero la v${VERSION} está disponible.\n` +
+          `  Para actualizar, ejecuta: npx @saulwade/swl-ses@latest update --force`));
+        console.log('');
+        omitidos++;
+        continue;
+      }
+
+      // Verificar si ya está actualizado
+      if (!necesitaActualizar && !force) {
+        console.log(formatearPaso(runtime.nombre, 'Ya está en la versión más reciente'));
+        console.log('');
+        omitidos++;
+        continue;
+      }
+
+      // Confirmar
+      if (!force) {
+        const confirmar = await preguntarSiNo(
+          !necesitaActualizar
+            ? `¿Re-instalar ${runtime.nombre} v${VERSION}?`
+            : `¿Actualizar ${runtime.nombre} de ${versionInstalada} a ${VERSION}?`
+        );
+        console.log('');
+
+        if (!confirmar) {
+          console.log(formatearAdvertencia(runtime.nombre, 'Actualización cancelada por el usuario'));
+          console.log('');
+          omitidos++;
+          continue;
+        }
+      }
+
+      // Ejecutar actualización con spinner
+      const sp = spinner(`Actualizando ${runtime.nombre}...`);
+
+      try {
+        const instalador = require('./instalador');
+        await instalador({
+          target: runtime.id,
+          profile: estado.perfil,
+          global: estado.global,
+          force: true,
+        });
+
+        sp.exito(`${runtime.nombre} actualizado a v${VERSION} (${estado.archivosInstalados.length} archivos)`);
+        actualizados++;
+      } catch (err) {
+        sp.fallo(`Error actualizando ${runtime.nombre}: ${err.message}`);
+      }
+
+      console.log('');
+    }
+  }
+
+  // 3. Reporte final
+  console.log(`  ${lineaSeparadora()}`);
+  if (actualizados > 0) {
+    console.log(formatearPaso('Resultado', `${actualizados} runtime(s) actualizado(s)${omitidos > 0 ? `, ${omitidos} omitido(s)` : ''}`));
+  } else if (omitidos > 0) {
+    console.log(formatearPaso('Resultado', 'Todo está actualizado'));
+  } else {
+    console.log(formatearAdvertencia('Resultado', 'Ningún runtime fue actualizado'));
+  }
+  console.log('');
+}
+
+module.exports = update;

package/scripts/doctor.js

@@ -10,7 +10,7 @@
 const fs = require('fs');
 const path = require('path');
 
-const { detectarRuntimes, detectarInstalacionesDuales } = require('./lib/detectar-runtime');
+const { detectarRuntimes, detectarInstalacionesDuales, esDirGlobalDeAlgunRuntime, scopesReales } = require('./lib/detectar-runtime');
 const { cargarEstado, verificarIntegridad } = require('./lib/estado');
 const { verificarHooks, repararHooks, rutaSettings, cargarHooksConfig, desregistrarHooks, esHookSWL, verificarOptimizaciones, registrarOptimizaciones, validarEstructuraSettings } = require('./lib/hooks-settings');
 const {
@@ -106,7 +106,10 @@ async function doctor(opciones = {}) {
   try {
     const runtimesParaDrift = detectarRuntimes();
     for (const runtime of runtimesParaDrift) {
-      for (const dir of [runtime.global, path.resolve(runtime.local)]) {
+      // Dedup + guard anti-fantasma: desde HOME, global y local colapsan al
+      // mismo dir (reporte doble) o el local resuelve al GLOBAL de otro
+      // runtime (drift "proyecto" espurio). Caso real doctor 2026-07-03.
+      for (const { dir, esGlobal } of scopesReales(runtime)) {
         if (!fs.existsSync(dir)) continue;
         const estado = cargarEstado(dir);
         if (!estado || !estado.versionSistema) continue;
@@ -115,7 +118,7 @@ async function doctor(opciones = {}) {
           driftsDetectados.push({
             runtime: runtime.nombre,
             runtimeId: runtime.id,
-            scope: dir === runtime.global ? 'global' : 'proyecto',
+            scope: esGlobal ? 'global' : 'proyecto',
             dir,
             versionInstalada: estado.versionSistema,
             perfil: estado.perfil || 'desconocido',
@@ -259,13 +262,10 @@ async function doctor(opciones = {}) {
 
   // 5. Verificar estado de instalación por runtime
   for (const runtime of runtimes) {
-    // Deduplicar: cuando global y local resuelven al mismo path (ej: running desde home dir)
-    const dirsRaw = [runtime.global, path.resolve(runtime.local)];
-    const dirs = [...new Set(dirsRaw)];
-    for (const dir of dirs) {
+    // Deduplicar + descartar locales que resuelven al global de otro runtime
+    // (ej: doctor corrido desde el home dir)
+    for (const { dir, esGlobal } of scopesReales(runtime)) {
       if (!fs.existsSync(dir)) continue;
-
-      const esGlobal = dir === runtime.global;
       const estado = cargarEstado(dir);
       if (estado) {
         const { integro, problemas } = verificarIntegridad(estado);
@@ -379,11 +379,7 @@ async function doctor(opciones = {}) {
   // Sub-fase 12 v1.5.0: deduplicar paths cuando cwd === homedir (runtime.local
   // y runtime.global colapsan al mismo directorio) — evita reporte doble.
   for (const runtime of runtimes) {
-    const dirsUnicos = Array.from(new Set([
-      path.resolve(runtime.global),
-      path.resolve(runtime.local),
-    ]));
-    for (const dir of dirsUnicos) {
+    for (const { dir } of scopesReales(runtime)) {
     if (!fs.existsSync(dir)) continue;
     const estado = cargarEstado(dir);
     if (!estado || !estado.perfil) continue;
@@ -559,12 +555,20 @@ async function doctor(opciones = {}) {
   for (const runtime of runtimes) {
     const dir = path.resolve(runtime.local);
     if (!fs.existsSync(dir)) continue;
+    // Local que resuelve al global de OTRO runtime = scope fantasma (ver scopesReales)
+    if (esDirGlobalDeAlgunRuntime(dir) && dir !== path.resolve(runtime.global)) continue;
     const estado = cargarEstado(dir);
     if (!estado) continue;
 
     const settingsPath = rutaSettings(runtime, dir);
     if (fs.existsSync(settingsPath)) {
-      const structResult = validarEstructuraSettings(settingsPath);
+      // Cursor usa hooks.json con eventos camelCase propios y entradas PLANAS
+      // ({command, type}) — el esquema Claude produce falsos errores
+      // ("afterFileEdit: evento no reconocido", "[0].hooks debe ser array").
+      // Codex también usa hooks.json pero con FORMA Claude ({matcher,
+      // hooks:[...]}, eventos PascalCase) — ver transformadores/codex.js.
+      const formatoHooks = runtime.id === 'cursor' ? 'plano' : 'claude';
+      const structResult = validarEstructuraSettings(settingsPath, { formatoHooks });
       if (structResult.ok) {
         console.log(formatearPaso(`Estructura settings ${runtime.nombre}`, 'Formato válido'));
         ok++;
@@ -624,8 +628,7 @@ async function doctor(opciones = {}) {
 
   // 8. Verificar componentes externos
   for (const runtime of runtimes) {
-    const dirs = [runtime.global, path.resolve(runtime.local)];
-    for (const dir of dirs) {
+    for (const { dir } of scopesReales(runtime)) {
       if (!fs.existsSync(dir)) continue;
       const estado = cargarEstado(dir);
       if (estado && estado.componentesExternos && estado.componentesExternos.length > 0) {
@@ -712,6 +715,11 @@ async function doctor(opciones = {}) {
       } else {
         console.log(`  ${reparados} reparado(s), ${color.rojo(`${fallos} fallo(s)`)}.`);
       }
+      // Las reparaciones no se re-verifican en esta corrida: honestidad sobre
+      // el alcance (caso repair-loop 2026-07-03 — un falso positivo del check
+      // se "reparaba" y reaparecía indefinidamente).
+      console.log(`  ${color.dim('Re-ejecuta `doctor` para confirmar. Si el MISMO problema reaparece tras reparar,')}`);
+      console.log(`  ${color.dim('es un falso positivo del check (repórtalo) — no falta de reparación.')}`);
     } else {
       console.log(`  ${color.dim('Reparación cancelada. Usa --force para reparar sin confirmar.')}`);
     }