@saulwade/swl-ses 2.5.1 → 2.5.3

package/manifiestos/skills-lock.json

@@ -1,8 +1,8 @@
 {
   "lockfileVersion": 1,
-  "generatedAt": "2026-07-09T05:48:39.413Z",
+  "generatedAt": "2026-07-09T21:51:05.079Z",
   "skillsCount": 181,
-  "lockHash": "sha256:60e8d0c732526f1329974a4bae2894a493e92a6b506ce192ca7cd5b04f2609da",
+  "lockHash": "sha256:016f7b1362443918147698bca6428463dcc70770d3acb61b84bb65267b195cf4",
   "skills": [
     {
       "nombre": "accesibilidad-a11y",
@@ -602,9 +602,9 @@
     {
       "nombre": "harness-claude-code",
       "path": "habilidades/harness-claude-code/SKILL.md",
-      "hash": "sha256:90a45cb0d932ccd38bbb2fc09ef86149d640dd073ab6d21a841db33a6baf41db",
-      "bytes": 17714,
-      "version": "\"1.0.4\""
+      "hash": "sha256:d4c7d4283a35fb5d1dcfcf18d2c0f45dca012bbc518fa2f5df8c3a88517069b0",
+      "bytes": 18370,
+      "version": "\"1.0.5\""
     },
     {
       "nombre": "iam-secretos",
@@ -1043,9 +1043,9 @@
     {
       "nombre": "release-semver",
       "path": "habilidades/release-semver/SKILL.md",
-      "hash": "sha256:37d4ef6228c83dfc5333188c85c7e910949d3bdcd3f49a5a2b8dd21a4835539d",
-      "bytes": 17761,
-      "version": "\"1.0.3\""
+      "hash": "sha256:c77cc73cc1f6ef635f9f79d9d008c5ee05f5de557b5f94ffa85b67575b2e9a33",
+      "bytes": 18514,
+      "version": "\"1.0.4\""
     },
     {
       "nombre": "rust-experto",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saulwade/swl-ses",
-  "version": "2.5.1",
+  "version": "2.5.3",
   "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot con 61 agentes, 181 habilidades, 47 comandos, 77 reglas y 49 hooks. Soporta 11 lenguajes y 7 runtimes: Claude Code, OpenClaude, OpenCode, Gemini CLI, Cursor, Codex CLI (soporte completo); GitHub Copilot (soporte parcial). 100% en espanol (Mexico). Multi-target install (--target CSV / --all-runtimes), autoconfig MCP en Cursor/Codex con --with-mcp, agentes Codex en TOML, hooks Cursor (17 eventos) y Codex (6 eventos). Gateway bidireccional con relay Telegram y auditoria profunda Nemesis con loop evaluator-optimizer opt-in (ADR-0021) y 8 tools ejecutables. v1.8.0 unifica los directorios runtime de .planning/ al ingles (evolution/, auto-evolution/, user-profile/, archive/), manteniendo fases/ en espanol, con guard validar-planning-paths y allowlist canonica (ADR-0031). Hereda de v1.7.4: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
   "bin": {
     "swl-ses": "bin/swl-ses.js",

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "swl-ses",
-  "version": "2.5.1",
+  "version": "2.5.3",
   "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 61 agentes, 181 habilidades, 47 comandos, 77 reglas y 49 hooks. 76 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021). v1.8.0 unifica los directorios runtime de .planning/ al ingles (evolution/, auto-evolution/, user-profile/, archive/), manteniendo fases/ en espanol, con guard validar-planning-paths y allowlist canonica (ADR-0031). Hereda de v1.7.4: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
   "author": "Saul Wade Leon",
   "license": "MIT",

package/scripts/evidencia-valor.js

@@ -18,11 +18,14 @@
 
 const { panelEvidencia } = require('./lib/evidencia-valor.js');
 
-function main() {
-  const argv = process.argv.slice(2);
-  const json = argv.includes('--json');
-  const idx = argv.indexOf('--dias');
-  const ventanaDias = idx !== -1 ? parseInt(argv[idx + 1], 10) || 30 : 30;
+/**
+ * Contrato del CLI (bin/swl-ses.js): exportar UNA función(opciones) sin
+ * efectos al require. Violarlo = "modulo is not a function" tras imprimir
+ * el panel (caso real: SIGM, 2026-07-09).
+ */
+function valor(opciones = {}) {
+  const json = !!opciones.json;
+  const ventanaDias = parseInt(opciones.dias, 10) || 30;
 
   const p = panelEvidencia(process.cwd(), { ventanaDias });
 
@@ -90,4 +93,9 @@ function main() {
   console.log('Compartir agregados con el autor (opt-in): swl-ses field-report — ver docs/evidencia-valor.md');
 }
 
-main();
+module.exports = valor;
+
+if (require.main === module) {
+  const { parsearOpciones } = require('./lib/parsear-opciones.js');
+  valor(parsearOpciones(process.argv.slice(2)));
+}

package/scripts/field-report.js

@@ -196,4 +196,20 @@ function generarReporte() {
   console.log(`\n> Generado por \`node scripts/field-report.js\``);
 }
 
-generarReporte();
+function fieldReport(opciones = {}) {
+  DAYS = parseInt(opciones.days || opciones.dias, 10) || 0;
+  PROJECT = opciones.project || null;
+  OUTPUT = opciones.output || 'md';
+  generarReporte();
+}
+
+module.exports = fieldReport;
+
+if (require.main === module) {
+  const args = process.argv.slice(2).reduce((acc, arg) => {
+    const [k, v] = arg.replace(/^--/, '').split('=');
+    acc[k] = v || true;
+    return acc;
+  }, {});
+  fieldReport(args);
+}

package/scripts/instalador.js

@@ -84,6 +84,27 @@ function nombreLegibleEvolucion(rutaAbs) {
  * El comportamiento sin TUI no cambia.
  */
 async function install(opciones) {
+  // Camino "solo hooks" (DT-HOOKS-SOLO-PROYECTO): registra en el settings.json
+  // del PROYECTO los hooks del scope GLOBAL ya instalado, sin copiar ningún
+  // componente — evita duplicar agentes/comandos en la UI de Claude Code
+  // (que lee ambos scopes) solo para encender la telemetría.
+  if (opciones['solo-hooks'] || opciones.solo_hooks) {
+    const { activarHooksProyecto } = require('./lib/activar-hooks-proyecto');
+    const r = activarHooksProyecto({ target: opciones.target || 'claude' });
+    if (!r.ok) {
+      console.error(`\n✘ --solo-hooks: ${r.error}`);
+      process.exitCode = 1;
+      return r;
+    }
+    console.log('\n✔ Hooks activados a nivel proyecto SIN copiar componentes:');
+    console.log(`  settings:  ${r.settingsPath}`);
+    console.log(`  hooks de:  ${r.hooksDirGlobal} (scope global — update global los refresca aquí también)`);
+    console.log(`  registrados: ${r.registrados} | externos preservados: ${r.preservados}`);
+    console.log('\n  La telemetría (.planning/evolution/nudges.jsonl, skill-metrics.json)');
+    console.log('  empieza a acumularse desde la siguiente sesión de Claude en este proyecto.');
+    return r;
+  }
+
   // Leer manifest .swl-ses si existe — sus valores son defaults que el CLI puede sobreescribir
   const manifest = leerManifest(process.cwd());
   if (manifest && !opciones.target && !opciones.profile) {

package/scripts/instalar-git-hook.js

@@ -119,4 +119,11 @@ function main() {
 
 if (require.main === module) main();
 
-module.exports = { instalar, MARCADOR, LINEA_CHECK };
+// Contrato del CLI (bin/swl-ses.js): el export default es UNA función que el
+// bin invoca como modulo(opciones); main re-lee process.argv, que en la
+// invocación vía bin ya trae los flags. Los named exports se preservan como
+// propiedades para los tests existentes.
+module.exports = main;
+module.exports.instalar = instalar;
+module.exports.MARCADOR = MARCADOR;
+module.exports.LINEA_CHECK = LINEA_CHECK;

package/scripts/lib/activar-hooks-proyecto.js

@@ -0,0 +1,104 @@
+'use strict';
+
+/**
+ * activar-hooks-proyecto.js — Camino "solo hooks" (DT-HOOKS-SOLO-PROYECTO).
+ *
+ * Registra en el `.claude/settings.json` del PROYECTO los hooks del scope
+ * GLOBAL ya instalado, sin copiar ningún componente. Cierra el dilema del
+ * install local: los hooks solo funcionan registrados a nivel proyecto
+ * (ADR-0009), pero el install local completo duplica agentes/comandos en la
+ * UI de Claude Code (lee ambos scopes). Con este camino:
+ *
+ *   - Los comandos del settings apuntan con ruta ABSOLUTA al hooks/ global
+ *     (esGlobal: true en registrarHooks) → cero archivos copiados.
+ *   - `swl-ses update` del global refresca los hooks de TODOS los proyectos
+ *     activados así, gratis (apuntan a los mismos archivos).
+ *   - Hooks externos (no-SWL) del settings del proyecto se preservan
+ *     (garantía de registrarHooks).
+ *
+ * Uso: `swl-ses install --target claude --solo-hooks` (en la raíz del
+ * proyecto). Requiere instalación global previa del runtime.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const RUNTIMES_SOPORTADOS = new Set(['claude', 'openclaude']);
+
+/**
+ * @param {object} opciones
+ * @param {string} [opciones.target='claude']     Runtime (claude|openclaude — formato de settings de Claude Code)
+ * @param {string} [opciones.dirProyecto=cwd]     Raíz del proyecto destino
+ * @param {string} [opciones.hooksDirGlobal]      Override del hooks/ global (tests)
+ * @param {object} [opciones.deps]                Inyección para tests: { registrarHooks, registrarOptimizaciones, cargarHooksConfig, scopesReales, obtenerRuntime }
+ * @returns {{ok: boolean, error?: string, settingsPath?: string, hooksDirGlobal?: string, registrados?: number, preservados?: number}}
+ */
+function activarHooksProyecto(opciones = {}) {
+  const target = opciones.target || 'claude';
+  if (!RUNTIMES_SOPORTADOS.has(target)) {
+    return { ok: false, error: `--solo-hooks soporta por ahora targets con settings formato Claude Code (claude, openclaude); recibido: "${target}".` };
+  }
+
+  const deps = opciones.deps || {};
+  const hs = require('./hooks-settings');
+  const registrarHooks = deps.registrarHooks || hs.registrarHooks;
+  const registrarOptimizaciones = deps.registrarOptimizaciones || hs.registrarOptimizaciones;
+  const cargarHooksConfig = deps.cargarHooksConfig || hs.cargarHooksConfig;
+
+  // 1. Localizar el hooks/ del scope GLOBAL del runtime.
+  let hooksDirGlobal = opciones.hooksDirGlobal;
+  if (!hooksDirGlobal) {
+    try {
+      const dr = require('./detectar-runtime');
+      const obtenerRuntime = deps.obtenerRuntime || dr.obtenerRuntime;
+      const scopesReales = deps.scopesReales || dr.scopesReales;
+      const runtime = obtenerRuntime(target);
+      const global = scopesReales(runtime).find(s => s.esGlobal);
+      if (!global) return { ok: false, error: `No se pudo resolver el scope global del runtime "${target}".` };
+      hooksDirGlobal = path.join(global.dir, 'hooks');
+    } catch (err) {
+      return { ok: false, error: `No se pudo detectar el runtime "${target}": ${err.message}` };
+    }
+  }
+  if (!fs.existsSync(hooksDirGlobal)) {
+    return { ok: false, error: `No hay instalación global con hooks en ${hooksDirGlobal}. Instala primero el global: npx -y @saulwade/swl-ses@latest install --target ${target} --global --perfil completo` };
+  }
+
+  // 2. Hooks disponibles = archivos del global ∩ hooks-config del paquete.
+  const hooksConfig = cargarHooksConfig();
+  const hookFiles = fs.readdirSync(hooksDirGlobal)
+    .filter(f => f.endsWith('.js') && hooksConfig[f]);
+  if (hookFiles.length === 0) {
+    return { ok: false, error: `El hooks/ global (${hooksDirGlobal}) no contiene hooks reconocidos por hooks-config.json — instalación global corrupta o muy antigua; corre update primero.` };
+  }
+
+  // 3. Registrar en el settings.json del PROYECTO, apuntando al global.
+  const dirProyecto = opciones.dirProyecto || process.cwd();
+  const dirClaude = path.join(dirProyecto, '.claude');
+  fs.mkdirSync(dirClaude, { recursive: true });
+  const settingsPath = path.join(dirClaude, 'settings.json');
+
+  const r = registrarHooks({
+    settingsPath,
+    hooksDir: hooksDirGlobal,
+    esGlobal: true, // semántica: comandos con ruta ABSOLUTA al hooksDir (que es el global)
+    hookFiles,
+  });
+
+  let optimizaciones = 0;
+  try {
+    const opt = registrarOptimizaciones(settingsPath);
+    optimizaciones = (opt && opt.registradas) || 0;
+  } catch { /* opcional — no bloquea la activación */ }
+
+  return {
+    ok: true,
+    settingsPath,
+    hooksDirGlobal,
+    registrados: r.registrados,
+    preservados: r.preservados,
+    optimizaciones,
+  };
+}
+
+module.exports = { activarHooksProyecto, RUNTIMES_SOPORTADOS };

package/scripts/lib/evidencia-valor.js

@@ -44,9 +44,31 @@ const TIPOS_INTERVENCION = new Set([
 
 // ─── 1. Intercepciones (nudges.jsonl) ────────────────────────────────────────
 
+/**
+ * Diagnóstico de POR QUÉ no hay telemetría: los hooks solo se registran a
+ * nivel PROYECTO (ADR-0009 — un install --global copia los archivos pero NO
+ * los registra en ~/.claude/settings.json, para no correr 49 hooks en cada
+ * sesión de cualquier proyecto). Sin registro local, nudges.jsonl y
+ * skill-metrics.json jamás aparecerán — el panel debe decir CÓMO activarlo,
+ * no solo "no disponible" (reporte de campo SIGM, 2026-07-09).
+ */
+function hooksRegistradosEnProyecto(raiz) {
+  try {
+    const s = JSON.parse(fs.readFileSync(path.join(raiz, '.claude', 'settings.json'), 'utf8'));
+    return Object.values(s.hooks || {}).some(m => Array.isArray(m) && m.length > 0);
+  } catch { return false; }
+}
+
+const HINT_ACTIVACION = 'hooks sin registrar a nivel proyecto (el install --global no los registra por diseño, ADR-0009) — activar SIN duplicar componentes con: npx -y @saulwade/swl-ses@latest install --target claude --solo-hooks (en la raíz del proyecto)';
+
 function leerNudges(raiz, { ventanaDias = 30, hoy = new Date() } = {}) {
   const ruta = path.join(raiz, '.planning', 'evolution', 'nudges.jsonl');
-  if (!fs.existsSync(ruta)) return { disponible: false, razon: 'sin nudges.jsonl (proyecto sin actividad de hooks o telemetría desactivada)', eventos: [] };
+  if (!fs.existsSync(ruta)) {
+    const razon = hooksRegistradosEnProyecto(raiz)
+      ? 'sin nudges.jsonl aún (hooks registrados; se acumula con el uso de sesiones)'
+      : HINT_ACTIVACION;
+    return { disponible: false, razon, eventos: [] };
+  }
   const corte = hoy.getTime() - ventanaDias * DIA_MS;
   const eventos = [];
   for (const linea of fs.readFileSync(ruta, 'utf8').split(/\r?\n/)) {
@@ -102,6 +124,10 @@ function presionDefectos(raiz, { ventanaDias = 30, hoy = new Date(), git = ejecu
 
   // Escape aproximado: fixes con fecha POSTERIOR a la última verificación de
   // fase (VERIFICACION.md más reciente). Sin fases verificadas → no aplica.
+  // La fecha se toma de GIT (autoría del último commit que tocó el archivo),
+  // no del mtime del filesystem: tras un clone/checkout todos los archivos
+  // comparten el mtime de la operación y el proxy daba falso negativo
+  // (reporte de campo SIGM, 2026-07-09). Fallback a mtime fuera de git.
   let escapes = { disponible: false, razon: 'sin VERIFICACION.md en .planning/fases/ (proyecto sin ciclo GSD verificado)' };
   try {
     const dirFases = path.join(raiz, '.planning', 'fases');
@@ -109,7 +135,15 @@ function presionDefectos(raiz, { ventanaDias = 30, hoy = new Date(), git = ejecu
     if (fs.existsSync(dirFases)) {
       for (const fase of fs.readdirSync(dirFases)) {
         const v = path.join(dirFases, fase, 'VERIFICACION.md');
-        if (fs.existsSync(v)) ultimaVerificacion = Math.max(ultimaVerificacion, fs.statSync(v).mtimeMs);
+        if (!fs.existsSync(v)) continue;
+        let fecha = 0;
+        try {
+          const rel = path.relative(raiz, v);
+          const ct = parseInt(git(raiz, ['log', '-1', '--format=%ct', '--', rel]).trim(), 10);
+          if (Number.isFinite(ct) && ct > 0) fecha = ct * 1000;
+        } catch { /* fuera de git o archivo sin commits → fallback mtime */ }
+        if (fecha === 0) fecha = fs.statSync(v).mtimeMs;
+        ultimaVerificacion = Math.max(ultimaVerificacion, fecha);
       }
     }
     if (ultimaVerificacion > 0) {
@@ -152,7 +186,12 @@ function doraCi(raiz, { ventanaDias = 30, hoy = new Date() } = {}) {
 
 function usoSistema(raiz) {
   const ruta = path.join(raiz, '.planning', 'skill-metrics.json');
-  if (!fs.existsSync(ruta)) return { disponible: false, razon: 'sin skill-metrics.json (telemetría de routing sin datos)' };
+  if (!fs.existsSync(ruta)) {
+    const razon = hooksRegistradosEnProyecto(raiz)
+      ? 'sin skill-metrics.json aún (hooks registrados; se acumula con el uso de skills)'
+      : HINT_ACTIVACION;
+    return { disponible: false, razon };
+  }
   try {
     // Forma real: { version, entries: [{skill, estado, timestamp}, ...] }
     // (eventos individuales del hook telemetria-skill-routing) — agregamos aquí.

package/scripts/tui/index.js

@@ -118,7 +118,16 @@ async function _flujoInstall() {
     }
     return { ok: false };
   }
-  return ejecutarInstall(w.opciones);
+  // Multi-runtime: una corrida del instalador por runtime marcado en el paso 1.
+  const targets = w.opciones.targets && w.opciones.targets.length > 0
+    ? w.opciones.targets
+    : [w.opciones.target];
+  let ultimo = { ok: true };
+  for (const target of targets) {
+    ultimo = await ejecutarInstall({ ...w.opciones, target });
+    if (!ultimo.ok) return ultimo; // reporta el runtime que falló, sin continuar a ciegas
+  }
+  return ultimo;
 }
 
 async function _flujoUpdate() {

package/scripts/tui/pantallas/inspect.js

@@ -23,7 +23,7 @@ const teclas = require('../lib/teclas');
 const { colores, semantico, iconos } = require('../lib/colores');
 
 function _cargarDatosInstalaciones() {
-  let detectarRuntimes, cargarEstado;
+  let detectarRuntimes, scopesReales, cargarEstado;
   try {
     ({ detectarRuntimes, scopesReales } = require('../../lib/detectar-runtime'));
     ({ cargarEstado } = require('../../lib/estado'));

package/scripts/tui/pantallas/install-wizard.js

@@ -170,7 +170,7 @@ function pantallaPreview(opciones, perfiles) {
       render.escribirEn(3, 3, colores.dim('Revisa antes de confirmar:'));
 
       const filas = [
-        ['Runtime',     opciones.target],
+        ['Runtime(s)',  (opciones.targets || [opciones.target]).join(', ')],
         ['Perfil',      opciones.profile],
         ['Scope',       opciones.global ? 'global (~/.claude)' : 'proyecto (./.claude)'],
         ['With MCP',    opciones.with_mcp ? 'sí' : 'no'],
@@ -243,13 +243,25 @@ async function ejecutarWizardInstall() {
     return { exito: false, error: 'No se pudo cargar manifiestos/perfiles.json' };
   }
 
-  // 1. Runtime
-  const target = await selectorUnico({
-    titulo: 'Paso 1/6 — ¿En qué runtime instalas SWL?',
-    items: RUNTIMES,
-    indiceDefault: 0,
-  });
-  if (!target) return { exito: false, cancelado: true };
+  // 1. Runtime(s) — multiselección: instala en varios runtimes en una corrida
+  // (fix 2026-07-09: era selector único; el flujo multi-runtime obligaba a
+  // repetir el wizard completo por cada runtime).
+  let targets = null;
+  let tituloPaso1 = 'Paso 1/6 — ¿En qué runtime(s) instalas SWL? (espacio para marcar)';
+  for (;;) {
+    targets = await selectorMulti({ titulo: tituloPaso1, items: RUNTIMES });
+    if (targets === null) return { exito: false, cancelado: true };
+    if (targets.length > 0) break;
+    // no-TTY: selectorMulti resuelve [] al instante — re-preguntar sería un
+    // spin infinito en caliente (colgó la suite 2.7h el 2026-07-09). Default:
+    // primer runtime, igual que hacía el selector único.
+    if (!render.ES_TTY || !process.stdin.isTTY) {
+      targets = [RUNTIMES[0].valor];
+      break;
+    }
+    tituloPaso1 = 'Paso 1/6 — Marca AL MENOS un runtime con espacio (Esc para cancelar)';
+  }
+  const target = targets[0]; // compat: preview/ejecutores leen .target
 
   // 2. Perfil
   const profile = await selectorUnico({
@@ -287,6 +299,7 @@ async function ejecutarWizardInstall() {
 
   const opciones = {
     target,
+    targets,
     profile,
     global: scope === 'global',
     with_mcp: flagsSeleccionados.includes('with-mcp'),

package/scripts/tui/pantallas/uninstall-wizard.js

@@ -21,7 +21,7 @@ const teclas = require('../lib/teclas');
 const { colores, semantico, iconos } = require('../lib/colores');
 
 function _cargarInstalaciones() {
-  let detectarRuntimes, cargarEstado;
+  let detectarRuntimes, scopesReales, cargarEstado;
   try {
     ({ detectarRuntimes, scopesReales } = require('../../lib/detectar-runtime'));
     ({ cargarEstado } = require('../../lib/estado'));

package/scripts/tui/pantallas/update-wizard.js

@@ -40,7 +40,7 @@ const CATEGORIAS = [
 // ---------------------------------------------------------------------------
 
 function _detectarInstalaciones() {
-  let detectarRuntimes, cargarEstado;
+  let detectarRuntimes, scopesReales, cargarEstado;
   try {
     ({ detectarRuntimes, scopesReales } = require('../../lib/detectar-runtime'));
     ({ cargarEstado } = require('../../lib/estado'));

package/scripts/tui/pantallas/welcome.js

@@ -33,8 +33,7 @@ const SUBTITULO = 'Sistema de ingeniería de software auto-evolutivo multi-runti
  * No falla si la lib no está disponible — devuelve array vacío.
  */
 function detectarInstalaciones() {
-  let detectarRuntimes;
-  let cargarEstado;
+  let detectarRuntimes, scopesReales, cargarEstado;
   try {
     ({ detectarRuntimes, scopesReales } = require('../../lib/detectar-runtime'));
     ({ cargarEstado } = require('../../lib/estado'));