@saulwade/swl-ses 2.6.0 → 2.8.0

package/scripts/lib/detectar-host-swl.js

@@ -1,175 +1,175 @@
-'use strict';
-
-/**
- * detectar-host-swl.js
- *
- * Determina si un directorio es el REPO HOST del sistema SWL (donde viven los
- * componentes: agentes/, habilidades/, comandos/swl/, reglas/, hooks/) o un
- * PROYECTO CONSUMIDOR que solo usa las convenciones SWL vía `~/.claude/`.
- *
- * Motivación: `/swl:status salud` audita los componentes del sistema SWL con un
- * score ponderado (agentes×0.30 + skills×0.25 + comandos×0.20 + reglas×0.15 +
- * hooks×0.10). En un proyecto consumidor esos directorios no existen → el score
- * sería 0/100, señal falsa. Antes esta distinción dependía del juicio del agente
- * de turno; este módulo la vuelve determinista (regla: salud usa verificaciones
- * deterministas, no juicio subjetivo).
- *
- * Función pura zero-deps. Entrypoint CLI con `--json` para consumo desde el
- * comando /swl:status salud.
- */
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-// Marca canónica del paquete en plugin.json (acepta forma con y sin scope npm).
-const NOMBRES_HOST = new Set(['swl-ses', '@saulwade/swl-ses']);
-
-// Subcomandos de /swl:status que SÍ aplican a un proyecto consumidor.
-const SUGERENCIAS_CONSUMIDOR = [
-  '/swl:status metricas — tokens/costo de la sesión actual',
-  '/swl:status metricas fases — progreso de fases (si usa .planning/HOJA-RUTA.md)',
-  '/swl:status loops — telemetría de loops iterativos',
-  '/swl:status evolucion — ciclo de auto-evolución (si corre en este proyecto)',
-  '/swl:status dashboard — consumo multi-sesión',
-];
-
-/**
- * Cuenta archivos de un componente sin recursión profunda innecesaria.
- * @returns {number}
- */
-function contarComponente(baseDir, rel, filtro) {
-  const dir = path.join(baseDir, rel);
-  let entradas;
-  try {
-    entradas = fs.readdirSync(dir, { withFileTypes: true });
-  } catch {
-    return 0;
-  }
-  return entradas.filter((e) => filtro(e)).length;
-}
-
-/**
- * Cuenta los 5 componentes del sistema SWL en baseDir.
- * @returns {{agentes:number, habilidades:number, comandos:number, reglas:number, hooks:number}}
- */
-function contarComponentes(baseDir) {
-  return {
-    // Agentes: agentes/*.md excluyendo fragmentos compartidos (_*.md).
-    agentes: contarComponente(
-      baseDir,
-      'agentes',
-      (e) => e.isFile() && e.name.endsWith('.md') && !e.name.startsWith('_')
-    ),
-    // Skills: habilidades/<nombre>/ (cada subdirectorio es un skill).
-    habilidades: contarComponente(baseDir, 'habilidades', (e) => e.isDirectory()),
-    // Comandos: comandos/swl/*.md.
-    comandos: contarComponente(
-      baseDir,
-      path.join('comandos', 'swl'),
-      (e) => e.isFile() && e.name.endsWith('.md')
-    ),
-    // Reglas: reglas/*.md (base; las por-lenguaje viven en subdirectorios).
-    reglas: contarComponente(
-      baseDir,
-      'reglas',
-      (e) => e.isFile() && e.name.endsWith('.md')
-    ),
-    // Hooks: hooks/*.js.
-    hooks: contarComponente(
-      baseDir,
-      'hooks',
-      (e) => e.isFile() && e.name.endsWith('.js')
-    ),
-  };
-}
-
-/**
- * Lee el nombre declarado en plugin.json si existe y es legible.
- * @returns {string|null}
- */
-function leerNombrePlugin(baseDir) {
-  try {
-    const raw = fs.readFileSync(path.join(baseDir, 'plugin.json'), 'utf-8');
-    const json = JSON.parse(raw);
-    return typeof json.name === 'string' ? json.name : null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Detecta si baseDir es el repo host del sistema SWL.
- *
- * Criterio (cualquiera de los dos basta):
- *   1. plugin.json con name ∈ {swl-ses, @saulwade/swl-ses}.
- *   2. Presencia de los 3 directorios nucleares de componentes con contenido
- *      (agentes/, habilidades/, comandos/swl/) — cubre forks renombrados.
- *
- * @param {string} [baseDir=process.cwd()]
- * @returns {{esHost:boolean, razon:string, nombrePlugin:(string|null),
- *            componentes:object, sugerencias:string[]}}
- */
-function detectarHostSwl(baseDir = process.cwd()) {
-  const nombrePlugin = leerNombrePlugin(baseDir);
-  const componentes = contarComponentes(baseDir);
-
-  const tienePluginHost = nombrePlugin !== null && NOMBRES_HOST.has(nombrePlugin);
-  const tieneNucleo =
-    componentes.agentes > 0 &&
-    componentes.habilidades > 0 &&
-    componentes.comandos > 0;
-
-  const esHost = tienePluginHost || tieneNucleo;
-
-  let razon;
-  if (tienePluginHost) {
-    razon = `plugin.json declara name="${nombrePlugin}" (repo host del sistema SWL).`;
-  } else if (tieneNucleo) {
-    razon =
-      'Presencia de componentes nucleares (agentes/, habilidades/, comandos/swl/) ' +
-      'sin plugin.json canónico — posible fork del sistema SWL.';
-  } else {
-    razon =
-      'Sin plugin.json del sistema y sin directorios de componentes ' +
-      '(agentes/, habilidades/, comandos/swl/): proyecto consumidor de SWL, ' +
-      'no host. El subcomando `salud` audita componentes que aquí no existen ' +
-      'por diseño — un score 0/100 sería engañoso.';
-  }
-
-  return {
-    esHost,
-    razon,
-    nombrePlugin,
-    componentes,
-    sugerencias: esHost ? [] : SUGERENCIAS_CONSUMIDOR.slice(),
-  };
-}
-
-module.exports = {
-  detectarHostSwl,
-  contarComponentes,
-  NOMBRES_HOST,
-  SUGERENCIAS_CONSUMIDOR,
-};
-
-// Entrypoint CLI: `node scripts/lib/detectar-host-swl.js [--json] [baseDir]`
-if (!require.main || require.main === module) {
-  const args = process.argv.slice(2);
-  const json = args.includes('--json');
-  const dirArg = args.find((a) => !a.startsWith('--'));
-  const resultado = detectarHostSwl(dirArg || process.cwd());
-
-  if (json) {
-    process.stdout.write(JSON.stringify(resultado, null, 2) + '\n');
-  } else if (resultado.esHost) {
-    process.stdout.write(`[host] ${resultado.razon}\n`);
-  } else {
-    process.stdout.write(`[consumidor] ${resultado.razon}\n`);
-    process.stdout.write('Subcomandos de /swl:status aplicables aquí:\n');
-    for (const s of resultado.sugerencias) {
-      process.stdout.write(`  - ${s}\n`);
-    }
-  }
-  // Exit 0 siempre: es diagnóstico, no gate bloqueante.
-  process.exit(0);
-}
+'use strict';
+
+/**
+ * detectar-host-swl.js
+ *
+ * Determina si un directorio es el REPO HOST del sistema SWL (donde viven los
+ * componentes: agentes/, habilidades/, comandos/swl/, reglas/, hooks/) o un
+ * PROYECTO CONSUMIDOR que solo usa las convenciones SWL vía `~/.claude/`.
+ *
+ * Motivación: `/swl:status salud` audita los componentes del sistema SWL con un
+ * score ponderado (agentes×0.30 + skills×0.25 + comandos×0.20 + reglas×0.15 +
+ * hooks×0.10). En un proyecto consumidor esos directorios no existen → el score
+ * sería 0/100, señal falsa. Antes esta distinción dependía del juicio del agente
+ * de turno; este módulo la vuelve determinista (regla: salud usa verificaciones
+ * deterministas, no juicio subjetivo).
+ *
+ * Función pura zero-deps. Entrypoint CLI con `--json` para consumo desde el
+ * comando /swl:status salud.
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+// Marca canónica del paquete en plugin.json (acepta forma con y sin scope npm).
+const NOMBRES_HOST = new Set(['swl-ses', '@saulwade/swl-ses']);
+
+// Subcomandos de /swl:status que SÍ aplican a un proyecto consumidor.
+const SUGERENCIAS_CONSUMIDOR = [
+  '/swl:status metricas — tokens/costo de la sesión actual',
+  '/swl:status metricas fases — progreso de fases (si usa .planning/HOJA-RUTA.md)',
+  '/swl:status loops — telemetría de loops iterativos',
+  '/swl:status evolucion — ciclo de auto-evolución (si corre en este proyecto)',
+  '/swl:status dashboard — consumo multi-sesión',
+];
+
+/**
+ * Cuenta archivos de un componente sin recursión profunda innecesaria.
+ * @returns {number}
+ */
+function contarComponente(baseDir, rel, filtro) {
+  const dir = path.join(baseDir, rel);
+  let entradas;
+  try {
+    entradas = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return 0;
+  }
+  return entradas.filter((e) => filtro(e)).length;
+}
+
+/**
+ * Cuenta los 5 componentes del sistema SWL en baseDir.
+ * @returns {{agentes:number, habilidades:number, comandos:number, reglas:number, hooks:number}}
+ */
+function contarComponentes(baseDir) {
+  return {
+    // Agentes: agentes/*.md excluyendo fragmentos compartidos (_*.md).
+    agentes: contarComponente(
+      baseDir,
+      'agentes',
+      (e) => e.isFile() && e.name.endsWith('.md') && !e.name.startsWith('_')
+    ),
+    // Skills: habilidades/<nombre>/ (cada subdirectorio es un skill).
+    habilidades: contarComponente(baseDir, 'habilidades', (e) => e.isDirectory()),
+    // Comandos: comandos/swl/*.md.
+    comandos: contarComponente(
+      baseDir,
+      path.join('comandos', 'swl'),
+      (e) => e.isFile() && e.name.endsWith('.md')
+    ),
+    // Reglas: reglas/*.md (base; las por-lenguaje viven en subdirectorios).
+    reglas: contarComponente(
+      baseDir,
+      'reglas',
+      (e) => e.isFile() && e.name.endsWith('.md')
+    ),
+    // Hooks: hooks/*.js.
+    hooks: contarComponente(
+      baseDir,
+      'hooks',
+      (e) => e.isFile() && e.name.endsWith('.js')
+    ),
+  };
+}
+
+/**
+ * Lee el nombre declarado en plugin.json si existe y es legible.
+ * @returns {string|null}
+ */
+function leerNombrePlugin(baseDir) {
+  try {
+    const raw = fs.readFileSync(path.join(baseDir, 'plugin.json'), 'utf-8');
+    const json = JSON.parse(raw);
+    return typeof json.name === 'string' ? json.name : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Detecta si baseDir es el repo host del sistema SWL.
+ *
+ * Criterio (cualquiera de los dos basta):
+ *   1. plugin.json con name ∈ {swl-ses, @saulwade/swl-ses}.
+ *   2. Presencia de los 3 directorios nucleares de componentes con contenido
+ *      (agentes/, habilidades/, comandos/swl/) — cubre forks renombrados.
+ *
+ * @param {string} [baseDir=process.cwd()]
+ * @returns {{esHost:boolean, razon:string, nombrePlugin:(string|null),
+ *            componentes:object, sugerencias:string[]}}
+ */
+function detectarHostSwl(baseDir = process.cwd()) {
+  const nombrePlugin = leerNombrePlugin(baseDir);
+  const componentes = contarComponentes(baseDir);
+
+  const tienePluginHost = nombrePlugin !== null && NOMBRES_HOST.has(nombrePlugin);
+  const tieneNucleo =
+    componentes.agentes > 0 &&
+    componentes.habilidades > 0 &&
+    componentes.comandos > 0;
+
+  const esHost = tienePluginHost || tieneNucleo;
+
+  let razon;
+  if (tienePluginHost) {
+    razon = `plugin.json declara name="${nombrePlugin}" (repo host del sistema SWL).`;
+  } else if (tieneNucleo) {
+    razon =
+      'Presencia de componentes nucleares (agentes/, habilidades/, comandos/swl/) ' +
+      'sin plugin.json canónico — posible fork del sistema SWL.';
+  } else {
+    razon =
+      'Sin plugin.json del sistema y sin directorios de componentes ' +
+      '(agentes/, habilidades/, comandos/swl/): proyecto consumidor de SWL, ' +
+      'no host. El subcomando `salud` audita componentes que aquí no existen ' +
+      'por diseño — un score 0/100 sería engañoso.';
+  }
+
+  return {
+    esHost,
+    razon,
+    nombrePlugin,
+    componentes,
+    sugerencias: esHost ? [] : SUGERENCIAS_CONSUMIDOR.slice(),
+  };
+}
+
+module.exports = {
+  detectarHostSwl,
+  contarComponentes,
+  NOMBRES_HOST,
+  SUGERENCIAS_CONSUMIDOR,
+};
+
+// Entrypoint CLI: `node scripts/lib/detectar-host-swl.js [--json] [baseDir]`
+if (!require.main || require.main === module) {
+  const args = process.argv.slice(2);
+  const json = args.includes('--json');
+  const dirArg = args.find((a) => !a.startsWith('--'));
+  const resultado = detectarHostSwl(dirArg || process.cwd());
+
+  if (json) {
+    process.stdout.write(JSON.stringify(resultado, null, 2) + '\n');
+  } else if (resultado.esHost) {
+    process.stdout.write(`[host] ${resultado.razon}\n`);
+  } else {
+    process.stdout.write(`[consumidor] ${resultado.razon}\n`);
+    process.stdout.write('Subcomandos de /swl:status aplicables aquí:\n');
+    for (const s of resultado.sugerencias) {
+      process.stdout.write(`  - ${s}\n`);
+    }
+  }
+  // Exit 0 siempre: es diagnóstico, no gate bloqueante.
+  process.exit(0);
+}

package/scripts/lib/detectar-runtime.js

@@ -2,12 +2,18 @@
 
 /**
  * Detecta el runtime de IA disponible en el sistema.
- * Soporta: Claude Code, OpenClaude, Copilot, OpenCode, Codex, Gemini CLI
+ * Reconoce: Claude Code, OpenClaude, Copilot, OpenCode, Codex, Gemini CLI y Cursor.
  */
 
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const {
+  cargarConformance,
+  derivarSupportLabel,
+} = require('./runtime-conformance');
+
+const CONFORMANCE = cargarConformance();
 
 const RUNTIMES = {
   claude: {
@@ -44,7 +50,6 @@ const RUNTIMES = {
     formatoAgente: 'markdown-frontmatter',
     soportaHooks: true,
     hookConfig: 'settings.json',       // mismo formato que Claude Code
-    soporte: 'completo',
     archivoPrincipal: null,            // Lee CLAUDE.md igual que Claude Code
     tiposSoportados: ['agentes', 'habilidades', 'comandos', 'reglas', 'hooks'],
     notas: 'Comparte .claude/ con Claude Code. Instalar en uno aplica al otro si usan el mismo proyecto.',
@@ -60,7 +65,6 @@ const RUNTIMES = {
     dirReglas: null,
     formatoAgente: 'markdown-frontmatter',
     soportaHooks: false,
-    soporte: 'parcial', // Solo agentes y reglas consolidadas (limitacion de plataforma)
     archivoPrincipal: 'copilot-instructions.md',
     tiposSoportados: ['agentes', 'reglas'],
   },
@@ -76,7 +80,6 @@ const RUNTIMES = {
     formatoAgente: 'markdown-frontmatter',
     soportaHooks: true,
     hookConfig: 'config.json',
-    soporte: 'completo',
     archivoPrincipal: 'AGENTS.md',
     tiposSoportados: ['agentes', 'habilidades', 'comandos', 'reglas', 'hooks'],
   },
@@ -100,7 +103,6 @@ const RUNTIMES = {
     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', '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.',
@@ -117,7 +119,6 @@ const RUNTIMES = {
     formatoAgente: 'markdown-frontmatter',
     soportaHooks: true,
     hookConfig: 'settings.json',
-    soporte: 'completo',
     archivoPrincipal: 'GEMINI.md',
     tiposSoportados: ['agentes', 'habilidades', 'comandos', 'reglas', 'hooks'],
   },
@@ -144,7 +145,6 @@ const RUNTIMES = {
     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>).',
@@ -290,6 +290,16 @@ function calcularRutas(runtimeId, opciones = {}) {
   return rutas;
 }
 
+/**
+ * Deriva la etiqueta pública desde el manifiesto sin alterar la configuración
+ * operativa ni usar disponibilidad local como evidencia de conformidad.
+ */
+function obtenerEtiquetaConformidad(target) {
+  const claim = CONFORMANCE.runtimes.find((runtime) => runtime.installerTarget === target);
+  if (!claim) throw new TypeError(`target sin claim de conformidad: ${target}`);
+  return `${derivarSupportLabel(claim)}/${claim.certificationStatus}`;
+}
+
 /**
  * Resumen de detección para mostrar al usuario
  */
@@ -300,18 +310,17 @@ function resumenDeteccion() {
   if (detectados.length === 0) {
     lineas.push('  (ninguno encontrado)');
     lineas.push('');
-    lineas.push('Runtimes soportados:');
+    lineas.push('Targets reconocidos:');
     for (const [id, config] of Object.entries(RUNTIMES)) {
-      const marca = config.soporte === 'parcial' ? ' [soporte parcial]' : '';
-      lineas.push(`  - ${id}: ${config.nombre}${marca}`);
+      lineas.push(`  - ${id}: ${config.nombre} [${obtenerEtiquetaConformidad(id)}]`);
     }
   } else {
     for (const r of detectados) {
       const ubicacion = [];
       if (r.globalExiste) ubicacion.push('global');
       if (r.localExiste) ubicacion.push('local');
-      const marca = r.soporte === 'parcial' ? ' [soporte parcial]' : '';
-      lineas.push(`  + ${r.id}: ${r.nombre} (${ubicacion.join(', ')})${marca}`);
+      const etiqueta = obtenerEtiquetaConformidad(r.id);
+      lineas.push(`  + ${r.id}: ${r.nombre} (${ubicacion.join(', ')}) [${etiqueta}]`);
     }
   }
 
@@ -364,8 +373,7 @@ function detectarInstalacionesDuales(runtimeId, opciones = {}) {
 }
 
 /**
- * Lista los IDs de runtimes "instalables" — es decir, los que tienen
- * transformador disponible y soporte declarado (completo o parcial).
+ * Lista los IDs de targets instalables con transformador disponible.
  *
  * Se usa para expandir `--all-runtimes` en multi-target install (ADR-0019 Sub-fase 2.5).
  *
@@ -381,12 +389,12 @@ function detectarInstalacionesDuales(runtimeId, opciones = {}) {
 function listarRuntimesInstalables(opciones = {}) {
   const existeDir = opciones.existeDir || fs.existsSync;
   const base = [
-    '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
+    'claude',
+    'cursor',
+    'codex',
+    'opencode',
+    'gemini',
+    'copilot',
   ];
   // OpenClaude comparte el dir de PROYECTO (.claude/) con Claude Code, así
   // que NO se bootstrapea por default (evita duplicados para quien no lo
@@ -407,6 +415,7 @@ module.exports = {
   detectarInstalacionesDuales,
   obtenerRuntime,
   calcularRutas,
+  obtenerEtiquetaConformidad,
   resumenDeteccion,
   listarRuntimesInstalables,
 };