@saulwade/swl-ses 1.4.1 → 1.5.0

package/scripts/lib/contadores-inventario.js

@@ -1,217 +1,217 @@
-'use strict';
-
-/**
- * contadores-inventario.js
- *
- * Funciones puras zero-deps para validar consistencia entre los contadores
- * de inventario (agentes, skills, comandos, hooks, reglas) declarados en
- * `INVENTARIO.md` (fuente de verdad regenerada por
- * `scripts/generar-inventario.js`) y los contadores citados en los demás
- * documentos canónicos del repositorio.
- *
- * Motivado por el drift recurrente detectado el 2026-04-29: MAPEO_SKILLS_AGENTES.md
- * decía "153 skills" cuando la realidad eran 150; COMPACTACION.md reportaba
- * "147 skills, 40 comandos, 31 hooks". El hook `verificar-release.js` valida
- * versión pero no contadores. Este módulo cierra ese hueco.
- *
- * Cobertura intencional:
- *   - Patrón resumen "X agentes, Y skills, Z comandos, W reglas, V hooks"
- *     (separadores `,` o `+` o `y`) — valida los 5 números a la vez.
- *   - Patrón "X agentes + Y habilidades + Z comandos + W reglas + V hooks"
- *     común en tablas de perfiles `completo`.
- *   - Patrón "Total de agentes: X" / "Total de skills: X" en MAPEO.
- *
- * Cobertura intencionalmente excluida (falsos positivos clásicos):
- *   - "los 17 skills de Anthropic" (skills externos)
- *   - "8 lenguajes × 5 reglas" (multiplicación)
- *   - perfiles parciales "2 hooks", "6 hooks" (no son totales)
- *   - notas históricas "estimé 28 hooks visualmente y propagué el error"
- *   - referencias a versiones pasadas en MAPEO ("136 skills tras release X")
- *   - filas de tabla histórica con SemVer + fecha ("| 5.4.0 | 2026-04-10 | 57 agentes...")
- *
- * Estas se ignoran porque el patrón resumen es el único que tiene los 5
- * componentes alineados; las menciones aisladas de un solo número se dejan
- * para una auditoría aparte (no bloqueante).
- */
-
-const COMPONENTES = ['agentes', 'skills', 'comandos', 'hooks', 'reglas'];
-
-/**
- * Parsea la sección "## Resumen" de INVENTARIO.md y retorna un mapa con
- * los contadores reales del sistema.
- *
- * Espera tabla del tipo:
- *   ## Resumen
- *   | Componente | Cantidad |
- *   |-----------|----------|
- *   | Agentes SWL | 59 |
- *   | Habilidades | 150 |
- *   | Comandos | 41 |
- *   | Reglas base | 20 |
- *   | Reglas por lenguaje | 40 |
- *   | Hooks | 36 |
- *
- * Retorna `{ agentes, skills, comandos, hooks, reglas }`.
- * `skills` y `habilidades` se mapean al mismo número.
- * `reglas` = base + por_lenguaje.
- */
-function parsearInventario(rawMd) {
-  const lineas = rawMd.split(/\r?\n/);
-  const resumen = {};
-  let enResumen = false;
-  for (const linea of lineas) {
-    if (/^##\s+Resumen\s*$/.test(linea)) { enResumen = true; continue; }
-    if (enResumen && /^##\s+/.test(linea)) break;
-    if (!enResumen) continue;
-    const m = linea.match(/^\|\s*([^|]+?)\s*\|\s*(\d+)\s*\|/);
-    if (m) resumen[m[1].trim()] = parseInt(m[2], 10);
-  }
-
-  const reglasBase = resumen['Reglas base'] || 0;
-  const reglasLeng = resumen['Reglas por lenguaje'] || 0;
-
-  return {
-    agentes: resumen['Agentes SWL'] || 0,
-    skills: resumen['Habilidades'] || 0,
-    comandos: resumen['Comandos'] || 0,
-    hooks: resumen['Hooks'] || 0,
-    reglas: reglasBase + reglasLeng,
-  };
-}
-
-/**
- * Detecta el patrón resumen en una línea y retorna los números encontrados.
- * Soporta separadores `,`, `+` y `y`. Tolera el orden canónico
- * agentes → skills/habilidades → comandos → reglas → hooks.
- *
- * Ejemplos que matchean:
- *   "59 agentes, 150 skills, 41 comandos, 60 reglas, 36 hooks"
- *   "59 agentes + 150 habilidades + 41 comandos + 60 reglas + 36 hooks"
- *   "59 agentes, 150 skills, 41 comandos, 60 reglas y 36 hooks"
- *   "Frontmatter: 59 agentes + 150 skills + 41 comandos verificados"
- *     (los 3 primeros se validan; los 2 últimos faltan → no full match,
- *      se devuelve match parcial con flags)
- *
- * Retorna `null` si no encuentra al menos `agentes` y un segundo componente.
- */
-function extraerResumenDeLinea(linea) {
-  // Patrón principal: 5 componentes en orden
-  const re5 = /(\d{1,4})\s+agentes?[\s,+y]+\s*(\d{1,4})\s+(?:skills|habilidades)[\s,+y]+\s*(\d{1,4})\s+comandos[\s,+y]+\s*(\d{1,4})\s+reglas[\s,+y]+\s*(\d{1,4})\s+hooks/i;
-  const m5 = linea.match(re5);
-  if (m5) {
-    return {
-      tipo: 'resumen5',
-      texto: m5[0],
-      agentes: parseInt(m5[1], 10),
-      skills: parseInt(m5[2], 10),
-      comandos: parseInt(m5[3], 10),
-      reglas: parseInt(m5[4], 10),
-      hooks: parseInt(m5[5], 10),
-    };
-  }
-
-  // Patrón parcial: 3 componentes (agentes, skills/habilidades, comandos)
-  const re3 = /(\d{1,4})\s+agentes?[\s,+y]+\s*(\d{1,4})\s+(?:skills|habilidades)[\s,+y]+\s*(\d{1,4})\s+comandos/i;
-  const m3 = linea.match(re3);
-  if (m3) {
-    return {
-      tipo: 'resumen3',
-      texto: m3[0],
-      agentes: parseInt(m3[1], 10),
-      skills: parseInt(m3[2], 10),
-      comandos: parseInt(m3[3], 10),
-    };
-  }
-
-  return null;
-}
-
-/**
- * Decide si una línea debe ignorarse por ser obviamente histórica
- * (fila de changelog/timeline con versión SemVer + fecha en formato tabla).
- */
-function esLineaHistorica(linea) {
-  // Tabla con versión SemVer + fecha ISO: "| 5.4.0 | 2026-04-10 | ..."
-  if (/^\s*\|\s*\d+\.\d+\.\d+\s*\|\s*\d{4}-\d{2}-\d{2}/.test(linea)) return true;
-  // "Baseline:" suele ser nota histórica
-  if (/\bBaseline\s*:/i.test(linea)) return true;
-  // "antes de v|previa a|tras release N" sugiere historia
-  if (/\b(?:antes de v|previa a|tras release|en v\d+\.\d+)\b/i.test(linea)) return true;
-  // Línea entre comillas dobles (cita textual de un patrón documentado): "22 hooks"
-  if (/"\s*\d+\s+(?:agentes|skills|habilidades|comandos|hooks|reglas)\s*"/i.test(linea)) return true;
-  return false;
-}
-
-/**
- * Valida un archivo contra los contadores reales.
- * Solo flagea las líneas que contienen patrón resumen identificable.
- *
- * Retorna { ok, lineas_revisadas, discrepancias: [{linea, encontrado, esperado, tipo, contexto}] }
- */
-function validarArchivo(rawMd, contadoresReales) {
-  const lineas = rawMd.split(/\r?\n/);
-  const discrepancias = [];
-  let lineasRevisadas = 0;
-
-  for (let i = 0; i < lineas.length; i++) {
-    if (esLineaHistorica(lineas[i])) continue;
-    const r = extraerResumenDeLinea(lineas[i]);
-    if (!r) continue;
-    lineasRevisadas++;
-
-    const campos = r.tipo === 'resumen5'
-      ? COMPONENTES
-      : ['agentes', 'skills', 'comandos'];
-
-    for (const campo of campos) {
-      if (r[campo] !== contadoresReales[campo]) {
-        discrepancias.push({
-          linea: i + 1,
-          campo,
-          encontrado: r[campo],
-          esperado: contadoresReales[campo],
-          tipo: r.tipo,
-          contexto: lineas[i].trim().slice(0, 110),
-        });
-      }
-    }
-  }
-
-  // Patrón nominal: "**Total de agentes**: N", "**Total de skills**: N"
-  const reTotal = /\*?\*?Total\s+de\s+(agentes|skills|habilidades|comandos|hooks|reglas)\*?\*?\s*:\s*(\d{1,4})/gi;
-  for (let i = 0; i < lineas.length; i++) {
-    if (esLineaHistorica(lineas[i])) continue;
-    let m;
-    reTotal.lastIndex = 0;
-    while ((m = reTotal.exec(lineas[i])) !== null) {
-      const palabra = m[1].toLowerCase();
-      const campo = palabra === 'habilidades' ? 'skills' : palabra;
-      const num = parseInt(m[2], 10);
-      lineasRevisadas++;
-      if (num !== contadoresReales[campo]) {
-        discrepancias.push({
-          linea: i + 1,
-          campo,
-          encontrado: num,
-          esperado: contadoresReales[campo],
-          tipo: 'total_nominal',
-          contexto: lineas[i].trim().slice(0, 110),
-        });
-      }
-    }
-  }
-
-  return {
-    ok: discrepancias.length === 0,
-    lineas_revisadas: lineasRevisadas,
-    discrepancias,
-  };
-}
-
-module.exports = {
-  COMPONENTES,
-  parsearInventario,
-  extraerResumenDeLinea,
-  esLineaHistorica,
-  validarArchivo,
-};
+'use strict';
+
+/**
+ * contadores-inventario.js
+ *
+ * Funciones puras zero-deps para validar consistencia entre los contadores
+ * de inventario (agentes, skills, comandos, hooks, reglas) declarados en
+ * `INVENTARIO.md` (fuente de verdad regenerada por
+ * `scripts/generar-inventario.js`) y los contadores citados en los demás
+ * documentos canónicos del repositorio.
+ *
+ * Motivado por el drift recurrente detectado el 2026-04-29: MAPEO_SKILLS_AGENTES.md
+ * decía "153 skills" cuando la realidad eran 150; COMPACTACION.md reportaba
+ * "147 skills, 40 comandos, 31 hooks". El hook `verificar-release.js` valida
+ * versión pero no contadores. Este módulo cierra ese hueco.
+ *
+ * Cobertura intencional:
+ *   - Patrón resumen "X agentes, Y skills, Z comandos, W reglas, V hooks"
+ *     (separadores `,` o `+` o `y`) — valida los 5 números a la vez.
+ *   - Patrón "X agentes + Y habilidades + Z comandos + W reglas + V hooks"
+ *     común en tablas de perfiles `completo`.
+ *   - Patrón "Total de agentes: X" / "Total de skills: X" en MAPEO.
+ *
+ * Cobertura intencionalmente excluida (falsos positivos clásicos):
+ *   - "los 17 skills de Anthropic" (skills externos)
+ *   - "8 lenguajes × 5 reglas" (multiplicación)
+ *   - perfiles parciales "2 hooks", "6 hooks" (no son totales)
+ *   - notas históricas "estimé 28 hooks visualmente y propagué el error"
+ *   - referencias a versiones pasadas en MAPEO ("136 skills tras release X")
+ *   - filas de tabla histórica con SemVer + fecha ("| 5.4.0 | 2026-04-10 | 57 agentes...")
+ *
+ * Estas se ignoran porque el patrón resumen es el único que tiene los 5
+ * componentes alineados; las menciones aisladas de un solo número se dejan
+ * para una auditoría aparte (no bloqueante).
+ */
+
+const COMPONENTES = ['agentes', 'skills', 'comandos', 'hooks', 'reglas'];
+
+/**
+ * Parsea la sección "## Resumen" de INVENTARIO.md y retorna un mapa con
+ * los contadores reales del sistema.
+ *
+ * Espera tabla del tipo:
+ *   ## Resumen
+ *   | Componente | Cantidad |
+ *   |-----------|----------|
+ *   | Agentes SWL | 59 |
+ *   | Habilidades | 150 |
+ *   | Comandos | 41 |
+ *   | Reglas base | 20 |
+ *   | Reglas por lenguaje | 40 |
+ *   | Hooks | 36 |
+ *
+ * Retorna `{ agentes, skills, comandos, hooks, reglas }`.
+ * `skills` y `habilidades` se mapean al mismo número.
+ * `reglas` = base + por_lenguaje.
+ */
+function parsearInventario(rawMd) {
+  const lineas = rawMd.split(/\r?\n/);
+  const resumen = {};
+  let enResumen = false;
+  for (const linea of lineas) {
+    if (/^##\s+Resumen\s*$/.test(linea)) { enResumen = true; continue; }
+    if (enResumen && /^##\s+/.test(linea)) break;
+    if (!enResumen) continue;
+    const m = linea.match(/^\|\s*([^|]+?)\s*\|\s*(\d+)\s*\|/);
+    if (m) resumen[m[1].trim()] = parseInt(m[2], 10);
+  }
+
+  const reglasBase = resumen['Reglas base'] || 0;
+  const reglasLeng = resumen['Reglas por lenguaje'] || 0;
+
+  return {
+    agentes: resumen['Agentes SWL'] || 0,
+    skills: resumen['Habilidades'] || 0,
+    comandos: resumen['Comandos'] || 0,
+    hooks: resumen['Hooks'] || 0,
+    reglas: reglasBase + reglasLeng,
+  };
+}
+
+/**
+ * Detecta el patrón resumen en una línea y retorna los números encontrados.
+ * Soporta separadores `,`, `+` y `y`. Tolera el orden canónico
+ * agentes → skills/habilidades → comandos → reglas → hooks.
+ *
+ * Ejemplos que matchean:
+ *   "59 agentes, 150 skills, 41 comandos, 60 reglas, 36 hooks"
+ *   "59 agentes + 150 habilidades + 41 comandos + 60 reglas + 36 hooks"
+ *   "59 agentes, 150 skills, 41 comandos, 60 reglas y 36 hooks"
+ *   "Frontmatter: 59 agentes + 150 skills + 41 comandos verificados"
+ *     (los 3 primeros se validan; los 2 últimos faltan → no full match,
+ *      se devuelve match parcial con flags)
+ *
+ * Retorna `null` si no encuentra al menos `agentes` y un segundo componente.
+ */
+function extraerResumenDeLinea(linea) {
+  // Patrón principal: 5 componentes en orden
+  const re5 = /(\d{1,4})\s+agentes?[\s,+y]+\s*(\d{1,4})\s+(?:skills|habilidades)[\s,+y]+\s*(\d{1,4})\s+comandos[\s,+y]+\s*(\d{1,4})\s+reglas[\s,+y]+\s*(\d{1,4})\s+hooks/i;
+  const m5 = linea.match(re5);
+  if (m5) {
+    return {
+      tipo: 'resumen5',
+      texto: m5[0],
+      agentes: parseInt(m5[1], 10),
+      skills: parseInt(m5[2], 10),
+      comandos: parseInt(m5[3], 10),
+      reglas: parseInt(m5[4], 10),
+      hooks: parseInt(m5[5], 10),
+    };
+  }
+
+  // Patrón parcial: 3 componentes (agentes, skills/habilidades, comandos)
+  const re3 = /(\d{1,4})\s+agentes?[\s,+y]+\s*(\d{1,4})\s+(?:skills|habilidades)[\s,+y]+\s*(\d{1,4})\s+comandos/i;
+  const m3 = linea.match(re3);
+  if (m3) {
+    return {
+      tipo: 'resumen3',
+      texto: m3[0],
+      agentes: parseInt(m3[1], 10),
+      skills: parseInt(m3[2], 10),
+      comandos: parseInt(m3[3], 10),
+    };
+  }
+
+  return null;
+}
+
+/**
+ * Decide si una línea debe ignorarse por ser obviamente histórica
+ * (fila de changelog/timeline con versión SemVer + fecha en formato tabla).
+ */
+function esLineaHistorica(linea) {
+  // Tabla con versión SemVer + fecha ISO: "| 5.4.0 | 2026-04-10 | ..."
+  if (/^\s*\|\s*\d+\.\d+\.\d+\s*\|\s*\d{4}-\d{2}-\d{2}/.test(linea)) return true;
+  // "Baseline:" suele ser nota histórica
+  if (/\bBaseline\s*:/i.test(linea)) return true;
+  // "antes de v|previa a|tras release N" sugiere historia
+  if (/\b(?:antes de v|previa a|tras release|en v\d+\.\d+)\b/i.test(linea)) return true;
+  // Línea entre comillas dobles (cita textual de un patrón documentado): "22 hooks"
+  if (/"\s*\d+\s+(?:agentes|skills|habilidades|comandos|hooks|reglas)\s*"/i.test(linea)) return true;
+  return false;
+}
+
+/**
+ * Valida un archivo contra los contadores reales.
+ * Solo flagea las líneas que contienen patrón resumen identificable.
+ *
+ * Retorna { ok, lineas_revisadas, discrepancias: [{linea, encontrado, esperado, tipo, contexto}] }
+ */
+function validarArchivo(rawMd, contadoresReales) {
+  const lineas = rawMd.split(/\r?\n/);
+  const discrepancias = [];
+  let lineasRevisadas = 0;
+
+  for (let i = 0; i < lineas.length; i++) {
+    if (esLineaHistorica(lineas[i])) continue;
+    const r = extraerResumenDeLinea(lineas[i]);
+    if (!r) continue;
+    lineasRevisadas++;
+
+    const campos = r.tipo === 'resumen5'
+      ? COMPONENTES
+      : ['agentes', 'skills', 'comandos'];
+
+    for (const campo of campos) {
+      if (r[campo] !== contadoresReales[campo]) {
+        discrepancias.push({
+          linea: i + 1,
+          campo,
+          encontrado: r[campo],
+          esperado: contadoresReales[campo],
+          tipo: r.tipo,
+          contexto: lineas[i].trim().slice(0, 110),
+        });
+      }
+    }
+  }
+
+  // Patrón nominal: "**Total de agentes**: N", "**Total de skills**: N"
+  const reTotal = /\*?\*?Total\s+de\s+(agentes|skills|habilidades|comandos|hooks|reglas)\*?\*?\s*:\s*(\d{1,4})/gi;
+  for (let i = 0; i < lineas.length; i++) {
+    if (esLineaHistorica(lineas[i])) continue;
+    let m;
+    reTotal.lastIndex = 0;
+    while ((m = reTotal.exec(lineas[i])) !== null) {
+      const palabra = m[1].toLowerCase();
+      const campo = palabra === 'habilidades' ? 'skills' : palabra;
+      const num = parseInt(m[2], 10);
+      lineasRevisadas++;
+      if (num !== contadoresReales[campo]) {
+        discrepancias.push({
+          linea: i + 1,
+          campo,
+          encontrado: num,
+          esperado: contadoresReales[campo],
+          tipo: 'total_nominal',
+          contexto: lineas[i].trim().slice(0, 110),
+        });
+      }
+    }
+  }
+
+  return {
+    ok: discrepancias.length === 0,
+    lineas_revisadas: lineasRevisadas,
+    discrepancias,
+  };
+}
+
+module.exports = {
+  COMPONENTES,
+  parsearInventario,
+  extraerResumenDeLinea,
+  esLineaHistorica,
+  validarArchivo,
+};

package/scripts/lib/detectar-runtime.js

@@ -81,19 +81,29 @@ const RUNTIMES = {
     tiposSoportados: ['agentes', 'habilidades', 'comandos', 'reglas', 'hooks'],
   },
   codex: {
+    // ADR-0019 Sub-fase 1 → ampliada en Sub-fase 8 (mismo v1.5.0).
+    // Codex CLI lee:
+    //   - AGENTS.md jerárquico (project + ~/.codex/AGENTS.md global)
+    //   - ${CODEX_HOME:-$HOME/.codex}/skills/<name>/SKILL.md (skills propias)
+    //   - ~/.codex/config.toml con [mcp_servers.NAME] (MCP)
+    //   - hooks.json con PreToolUse/PostToolUse/Stop (NO mapeado por SWL — formato distinto)
+    // Codex NO expone agents/ individual desde filesystem — los agentes SWL
+    // van consolidados en AGENTS.md como tabla referencial.
     nombre: 'Codex CLI',
     global: path.join(os.homedir(), '.codex'),
     local: '.codex',
-    archivosConfig: [],
-    dirAgentes: null,
-    dirHabilidades: null,
-    dirComandos: null,
-    dirReglas: null,
-    formatoAgente: 'consolidado',
-    soportaHooks: false,
-    soporte: 'parcial', // Solo agentes consolidados y reglas (limitacion de plataforma)
+    archivosConfig: ['config.toml'],
+    dirAgentes: 'agents',       // ~/.codex/agents/<name>.toml — Sub-fase 11 v1.5.0 (formato TOML)
+    dirHabilidades: 'skills',   // path real `~/.agents/skills/` resuelto por transformador (Sub-fase 10)
+    dirComandos: null,          // Codex no soporta slash custom filesystem
+    dirReglas: null,            // consolidado en AGENTS.md (Codex rules son Starlark, no portable)
+    formatoAgente: 'toml',      // Sub-fase 11: cada agente es un .toml individual
+    soportaHooks: true,         // Sub-fase 10: ~/.codex/hooks.json (6 eventos)
+    hookConfig: 'hooks.json',
+    soporte: 'completo',
     archivoPrincipal: 'AGENTS.md',
-    tiposSoportados: ['agentes', 'reglas'],
+    tiposSoportados: ['agentes', 'habilidades', 'reglas', 'hooks'],
+    notas: 'Agentes en ~/.codex/agents/<name>.toml (formato TOML — Sub-fase 11). Skills en ~/.agents/skills/ (path oficial OpenAI — Sub-fase 10). Hooks en ~/.codex/hooks.json. MCP server en ~/.codex/config.toml. AGENTS.md sigue conteniendo tabla referencial como índice.',
   },
   gemini: {
     nombre: 'Gemini CLI',
@@ -111,6 +121,34 @@ const RUNTIMES = {
     archivoPrincipal: 'GEMINI.md',
     tiposSoportados: ['agentes', 'habilidades', 'comandos', 'reglas', 'hooks'],
   },
+  cursor: {
+    // ADR-0019 Sub-fase 2 → refinada en Sub-fase 7 (mismo v1.5.0).
+    // Tras verificar docs oficiales de Cursor (cursor.com/es/docs/{subagents,skills,rules,mcp}):
+    // Cursor SÍ soporta subagents y skills filesystem nativamente.
+    //   - `.cursor/agents/<name>.md` con frontmatter Claude-compatible
+    //     (name, description, model=inherit, readonly, is_background).
+    //     Legacy: lee `.claude/agents/`, `.codex/agents/`.
+    //   - `.cursor/skills/<name>/SKILL.md` (mismo formato Anthropic Skills).
+    //     Legacy: lee `.agents/skills/`, `.claude/skills/`, `.codex/skills/`.
+    //   - `.cursor/rules/*.mdc` con frontmatter description/alwaysApply/globs.
+    //   - `.cursor/mcp.json` o `~/.cursor/mcp.json` para MCP servers.
+    //   - NO soporta nativamente: slash commands custom, hooks (PreToolUse, etc).
+    nombre: 'Cursor',
+    global: path.join(os.homedir(), '.cursor'),
+    local: '.cursor',
+    archivosConfig: ['mcp.json'],
+    dirAgentes: 'agents',           // .cursor/agents/<name>.md
+    dirHabilidades: 'skills',       // .cursor/skills/<name>/SKILL.md
+    dirComandos: null,              // Cursor no tiene slash custom filesystem (skills cumplen ese rol)
+    dirReglas: 'rules',             // .cursor/rules/*.mdc
+    formatoAgente: 'markdown-frontmatter',
+    soportaHooks: true,             // Sub-fase 10: .cursor/hooks.json (17 eventos)
+    hookConfig: 'hooks.json',
+    soporte: 'completo',
+    archivoPrincipal: null,
+    tiposSoportados: ['agentes', 'habilidades', 'reglas', 'hooks'],
+    notas: 'Subagents en .cursor/agents/, skills en .cursor/skills/<name>/SKILL.md, reglas en .cursor/rules/*.mdc, hooks en .cursor/hooks.json (17 eventos camelCase), MCP en .cursor/mcp.json. Slash commands custom: usar skills (se invocan con /<name>).',
+  },
 };
 
 /**
@@ -269,6 +307,33 @@ function detectarInstalacionesDuales(runtimeId, opciones = {}) {
   };
 }
 
+/**
+ * Lista los IDs de runtimes "instalables" — es decir, los que tienen
+ * transformador disponible y soporte declarado (completo o parcial).
+ *
+ * Se usa para expandir `--all-runtimes` en multi-target install (ADR-0019 Sub-fase 2.5).
+ *
+ * Excluye alias (openclaude comparte el dir .claude/ con claude — incluirlo en
+ * --all-runtimes produciría doble instalación al mismo destino).
+ *
+ * Orden estable: el orden de la lista importa porque define el orden de
+ * ejecución de --all-runtimes. Si un target falla los siguientes igual se
+ * intentan (ADR-0019 punto 9: atomicidad por target, no rollback).
+ *
+ * @returns {string[]} Lista de runtime IDs ordenada de "más usado" a "menos usado".
+ */
+function listarRuntimesInstalables() {
+  return [
+    'claude',     // Soporte completo, primer ciudadano
+    'cursor',     // Soporte parcial — reglas + MCP
+    'codex',      // Soporte parcial — AGENTS.md + MCP (v1.5.0+)
+    'opencode',   // Soporte completo
+    'gemini',     // Soporte completo
+    'copilot',    // Soporte parcial — agentes consolidados
+    // 'openclaude' intencionalmente excluido — comparte dir con claude
+  ];
+}
+
 module.exports = {
   RUNTIMES,
   detectarRuntimes,
@@ -276,4 +341,5 @@ module.exports = {
   obtenerRuntime,
   calcularRutas,
   resumenDeteccion,
+  listarRuntimesInstalables,
 };