@saulwade/swl-ses 2.3.0 → 2.4.1

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);
+}