@saulwade/swl-ses 1.5.1 → 1.6.0

package/scripts/generar-matriz-lenguajes.js

@@ -1,271 +1,271 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * generar-matriz-lenguajes.js
- *
- * Recorre `agentes/`, `habilidades/` y `reglas/lenguajes/` y produce una
- * matriz de cobertura por lenguaje en `.planning/cobertura-lenguajes.md`.
- *
- * Para cada lenguaje detectado, reporta:
- *   - Agentes (backend/frontend/mobile/revisor) que lo cubren.
- *   - Skills (experto, patrones, testing, build-errors).
- *   - Subdirectorio en reglas/lenguajes/.
- *   - Status de cobertura: completo (≥4 elementos) | parcial (1-3) | faltante (0).
- *
- * Uso: ejecutar como parte de `/swl:salud` o pre-release.
- *   node scripts/generar-matriz-lenguajes.js
- *
- * Zero-deps. Idempotente.
- */
-
-const fs   = require('fs');
-const path = require('path');
-
-const ROOT = process.cwd();
-const SALIDA = path.join(ROOT, '.planning', 'cobertura-lenguajes.md');
-
-// Cargar atomic-write desde hooks/lib/ (regla obligatoria de CLAUDE.md:
-// escrituras atómicas para archivos de estado y artefactos en .planning/).
-const { atomicWriteSync } = require(path.join(ROOT, 'hooks', 'lib', 'atomic-write.js'));
-
-// ---------------------------------------------------------------------------
-// Lenguajes a evaluar (taxonomía SWL)
-// ---------------------------------------------------------------------------
-
-/**
- * Cada entrada define:
- *   - clave: nombre interno usado para matchear archivos.
- *   - etiqueta: nombre humano para el reporte.
- *   - agentesEsperados: prefijos/sufijos en agentes/.
- *   - skillsEsperados: prefijos en habilidades/.
- *   - reglaSubdir: nombre esperado en reglas/lenguajes/ (null si no aplica).
- *   - smokeMin: ejemplo mínimo de smoke test en CI.
- */
-const LENGUAJES = [
-  { clave: 'python',  etiqueta: 'Python',
-    agentesEsperados: ['backend-python-swl'],
-    skillsKeywords:   ['async-python', 'django', 'fastapi', 'python', 'sqlalchemy'],
-    revisor:          null,
-    reglaSubdir:      null,
-    smokeMin:         '`pytest -x` + smoke import de paquete principal.' },
-  { clave: 'node',    etiqueta: 'Node/TypeScript',
-    agentesEsperados: ['backend-node-swl'],
-    skillsKeywords:   ['typescript', 'node-experto', 'fastify', 'express', 'nestjs', 'prisma'],
-    revisor:          'revisor-typescript-swl',
-    reglaSubdir:      null,
-    smokeMin:         '`vitest run` o `jest --ci` + `tsc --noEmit`.' },
-  { clave: 'java',    etiqueta: 'Java',
-    agentesEsperados: ['backend-java-swl'],
-    skillsKeywords:   ['java-experto', 'java-patrones', 'java-testing', 'build-errors-java', 'spring'],
-    revisor:          'revisor-java-swl',
-    reglaSubdir:      'java',
-    smokeMin:         '`mvn test` o `gradle test` con cobertura mínima de JaCoCo.' },
-  { clave: 'go',      etiqueta: 'Go',
-    agentesEsperados: ['backend-go-swl'],
-    skillsKeywords:   ['go-experto', 'go-patrones', 'go-testing', 'build-errors-go'],
-    revisor:          'revisor-go-swl',
-    reglaSubdir:      'go',
-    smokeMin:         '`go test ./... -race -count=1`.' },
-  { clave: 'rust',    etiqueta: 'Rust',
-    agentesEsperados: ['backend-rust-swl'],
-    skillsKeywords:   ['rust-experto', 'rust-patrones', 'rust-testing', 'build-errors-rust', 'axum', 'actix'],
-    revisor:          'revisor-rust-swl',
-    reglaSubdir:      'rust',
-    smokeMin:         '`cargo test` + `cargo clippy -- -D warnings`.' },
-  { clave: 'csharp',  etiqueta: 'C# / .NET',
-    agentesEsperados: ['backend-csharp-swl'],
-    skillsKeywords:   ['csharp-experto', 'csharp-patrones', 'csharp-testing', 'build-errors-csharp', 'efcore'],
-    revisor:          'revisor-csharp-swl',
-    reglaSubdir:      'csharp',
-    smokeMin:         '`dotnet test --no-build` con xUnit/NUnit y coverlet.' },
-  { clave: 'php',     etiqueta: 'PHP / Laravel',
-    agentesEsperados: [],
-    skillsKeywords:   ['php-experto', 'php-patrones', 'php-testing', 'build-errors-php', 'laravel'],
-    revisor:          'revisor-php-swl',
-    reglaSubdir:      'php',
-    smokeMin:         '`vendor/bin/phpunit` o `pest` + `phpstan analyse`.' },
-  { clave: 'kotlin',  etiqueta: 'Kotlin (Android)',
-    agentesEsperados: ['mobile-android-swl'],
-    skillsKeywords:   ['kotlin-compose', 'kotlin-experto', 'kotlin-testing', 'build-errors-kotlin'],
-    revisor:          'revisor-kotlin-swl',
-    reglaSubdir:      'kotlin',
-    smokeMin:         '`./gradlew test connectedAndroidTest` (al menos JVM tests).' },
-  { clave: 'swift',   etiqueta: 'Swift (iOS)',
-    agentesEsperados: ['mobile-ios-swl'],
-    skillsKeywords:   ['swift-experto', 'swift-patrones', 'swift-testing', 'build-errors-swift', 'swiftui'],
-    revisor:          'revisor-swift-swl',
-    reglaSubdir:      'swift',
-    smokeMin:         '`swift test` o `xcodebuild test` en scheme primario.' },
-  { clave: 'react',   etiqueta: 'React',
-    agentesEsperados: ['frontend-react-swl'],
-    skillsKeywords:   ['react', 'frontend-react'],
-    revisor:          'revisor-react-swl',
-    reglaSubdir:      null,
-    smokeMin:         'React Testing Library con cobertura mínima de smoke render.' },
-  { clave: 'angular', etiqueta: 'Angular',
-    agentesEsperados: ['frontend-angular-swl'],
-    skillsKeywords:   ['angular-avanzado', 'angular-moderno'],
-    revisor:          'revisor-angular-swl',
-    reglaSubdir:      null,
-    smokeMin:         '`ng test --watch=false --no-progress` con headless Chrome.' },
-  { clave: 'nextjs',  etiqueta: 'Next.js',
-    agentesEsperados: [],
-    skillsKeywords:   ['nextjs-experto', 'nextjs-patrones', 'nextjs-testing', 'build-errors-nextjs'],
-    revisor:          'revisor-nextjs-swl',
-    reglaSubdir:      'nextjs',
-    smokeMin:         '`next build` + Playwright sobre rutas críticas.' },
-  { clave: 'reactnative', etiqueta: 'React Native / Flutter',
-    agentesEsperados: ['mobile-cross-swl'],
-    skillsKeywords:   ['mobile-react-native', 'mobile-flutter', 'mobile-cross'],
-    revisor:          null,
-    reglaSubdir:      null,
-    smokeMin:         '`detox test` (RN) o `flutter test` + `flutter analyze`.' },
-];
-
-// ---------------------------------------------------------------------------
-// Detección
-// ---------------------------------------------------------------------------
-
-function listarSeguro(dir) {
-  try { return fs.readdirSync(path.join(ROOT, dir)); }
-  catch { return []; }
-}
-
-function detectarCobertura(lang) {
-  const agentesDisco = listarSeguro('agentes');
-  const skillsDisco  = listarSeguro('habilidades');
-  const reglasDisco  = listarSeguro('reglas/lenguajes');
-
-  const agentes = lang.agentesEsperados.filter(a =>
-    agentesDisco.includes(a + '.md'));
-  const revisor = lang.revisor && agentesDisco.includes(lang.revisor + '.md')
-    ? lang.revisor
-    : null;
-  const skills  = skillsDisco.filter(s =>
-    lang.skillsKeywords.some(k => s.toLowerCase().includes(k.toLowerCase())));
-  const regla   = lang.reglaSubdir && reglasDisco.includes(lang.reglaSubdir)
-    ? lang.reglaSubdir
-    : null;
-
-  const elementos = agentes.length + (revisor ? 1 : 0) + skills.length + (regla ? 1 : 0);
-  let status;
-  if (elementos === 0)        status = 'faltante';
-  else if (elementos < 4)     status = 'parcial';
-  else                        status = 'completo';
-
-  return { agentes, revisor, skills, regla, elementos, status };
-}
-
-// ---------------------------------------------------------------------------
-// Render
-// ---------------------------------------------------------------------------
-
-function renderTabla() {
-  const filas = LENGUAJES.map(lang => {
-    const cov = detectarCobertura(lang);
-    const icono = cov.status === 'completo' ? '✅' : cov.status === 'parcial' ? '⚠️' : '❌';
-    const agenteCelda = cov.agentes.length > 0 ? cov.agentes.join(', ') : '—';
-    const revisorCelda = cov.revisor || '—';
-    const skillsCelda = cov.skills.length > 0 ? `${cov.skills.length} skill(s)` : '—';
-    const reglaCelda = cov.regla ? `reglas/lenguajes/${cov.regla}/` : '—';
-    return `| ${icono} ${lang.etiqueta} | ${agenteCelda} | ${revisorCelda} | ${skillsCelda} | ${reglaCelda} | ${cov.status} |`;
-  });
-
-  return [
-    '| Lenguaje | Agente(s) | Revisor | Skills | Regla por-lenguaje | Status |',
-    '|----------|-----------|---------|--------|--------------------|--------|',
-    ...filas,
-  ].join('\n');
-}
-
-function renderSmoke() {
-  return LENGUAJES.map(lang => {
-    const cov = detectarCobertura(lang);
-    const tag = cov.status === 'faltante'
-      ? '_(sin cobertura SWL — el smoke aplica solo si el proyecto del usuario lo usa)_'
-      : '';
-    return `### ${lang.etiqueta}\n\n- Smoke mínimo: ${lang.smokeMin}\n${tag ? '- ' + tag + '\n' : ''}`;
-  }).join('\n');
-}
-
-function renderResumen() {
-  const total = LENGUAJES.length;
-  const completos = LENGUAJES.filter(l => detectarCobertura(l).status === 'completo').length;
-  const parciales = LENGUAJES.filter(l => detectarCobertura(l).status === 'parcial').length;
-  const faltantes = LENGUAJES.filter(l => detectarCobertura(l).status === 'faltante').length;
-  return [
-    `**Total lenguajes evaluados**: ${total}`,
-    `**Cobertura completa** (≥4 elementos: agente + revisor + skills + regla): ${completos}`,
-    `**Cobertura parcial** (1-3 elementos): ${parciales}`,
-    `**Sin cobertura SWL**: ${faltantes}`,
-  ].join('\n');
-}
-
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-
-function main() {
-  const fecha = new Date().toISOString().slice(0, 10);
-  const contenido = `# Matriz de cobertura SWL × lenguaje
-
-> **Generado automáticamente** por \`scripts/generar-matriz-lenguajes.js\`.
-> Última generación: ${fecha}.
-> NO editar a mano — re-ejecutar el script.
-
-Esta matriz documenta qué lenguajes del stack polyglot SWL tienen cobertura
-completa de **agentes + skills + reglas + revisores**, y qué smoke test mínimo
-debería ejecutarse en CI antes de release de un proyecto que use cada lenguaje.
-
-Aplica a:
-
-- **Pre-release del repo madre swl-ses**: validar que ningún lenguaje
-  declarado oficialmente perdió componentes desde el último release.
-- **Proyectos usuario**: usar la columna "Smoke mínimo" como guía de qué
-  ejecutar como mínimo antes de \`/swl:release\` en su proyecto.
-
-## Resumen
-
-${renderResumen()}
-
-## Cobertura por lenguaje
-
-${renderTabla()}
-
-**Leyenda**:
-- ✅ **completo**: ≥4 elementos (agente backend/frontend/mobile + revisor + skills + regla por-lenguaje).
-- ⚠️ **parcial**: 1-3 elementos. Aceptable si el lenguaje es de uso secundario.
-- ❌ **faltante**: ningún elemento detectado. Si el proyecto declara este lenguaje, la cobertura SWL es inadecuada.
-
-## Smoke test mínimo recomendado por lenguaje
-
-${renderSmoke()}
-
-## Cómo se usa esta matriz
-
-1. **Pre-release de swl-ses**: \`/swl:release\` invoca este script. Si algún
-   lenguaje pasó de **completo** a **parcial** o de **parcial** a **faltante**
-   sin ADR documentado, el release se bloquea.
-2. **CI de proyecto usuario**: el comando \`/swl:configurar-ci\` genera el
-   workflow incluyendo el smoke mínimo del lenguaje detectado.
-3. **Auditoría**: ejecutar \`node scripts/generar-matriz-lenguajes.js\` cuando
-   se agrega/elimina un agente, skill o regla por-lenguaje. La salida actualizada
-   debe commitearse junto al cambio.
-
-## Política de cierre por categoría
-
-- **Lenguaje completo (✅)**: cualquier eliminación de componente requiere ADR
-  en \`.planning/adrs/\` justificando la regresión.
-- **Lenguaje parcial (⚠️)**: documentar en este archivo el plan para llegar a
-  cobertura completa, o decisión explícita de mantener parcial (con razón).
-- **Lenguaje faltante (❌)**: el repo no debe afirmar soporte oficial. Mover
-  cualquier mención a "stack polyglot soportado" hasta que pase a parcial.
-`;
-
-  atomicWriteSync(SALIDA, contenido, 'utf8');
-  console.log(`Matriz generada: ${path.relative(ROOT, SALIDA)}`);
-  console.log(renderResumen());
-}
-
-main();
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * generar-matriz-lenguajes.js
+ *
+ * Recorre `agentes/`, `habilidades/` y `reglas/lenguajes/` y produce una
+ * matriz de cobertura por lenguaje en `.planning/cobertura-lenguajes.md`.
+ *
+ * Para cada lenguaje detectado, reporta:
+ *   - Agentes (backend/frontend/mobile/revisor) que lo cubren.
+ *   - Skills (experto, patrones, testing, build-errors).
+ *   - Subdirectorio en reglas/lenguajes/.
+ *   - Status de cobertura: completo (≥4 elementos) | parcial (1-3) | faltante (0).
+ *
+ * Uso: ejecutar como parte de `/swl:salud` o pre-release.
+ *   node scripts/generar-matriz-lenguajes.js
+ *
+ * Zero-deps. Idempotente.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const ROOT = process.cwd();
+const SALIDA = path.join(ROOT, '.planning', 'cobertura-lenguajes.md');
+
+// Cargar atomic-write desde hooks/lib/ (regla obligatoria de CLAUDE.md:
+// escrituras atómicas para archivos de estado y artefactos en .planning/).
+const { atomicWriteSync } = require(path.join(ROOT, 'hooks', 'lib', 'atomic-write.js'));
+
+// ---------------------------------------------------------------------------
+// Lenguajes a evaluar (taxonomía SWL)
+// ---------------------------------------------------------------------------
+
+/**
+ * Cada entrada define:
+ *   - clave: nombre interno usado para matchear archivos.
+ *   - etiqueta: nombre humano para el reporte.
+ *   - agentesEsperados: prefijos/sufijos en agentes/.
+ *   - skillsEsperados: prefijos en habilidades/.
+ *   - reglaSubdir: nombre esperado en reglas/lenguajes/ (null si no aplica).
+ *   - smokeMin: ejemplo mínimo de smoke test en CI.
+ */
+const LENGUAJES = [
+  { clave: 'python',  etiqueta: 'Python',
+    agentesEsperados: ['backend-python-swl'],
+    skillsKeywords:   ['async-python', 'django', 'fastapi', 'python', 'sqlalchemy'],
+    revisor:          null,
+    reglaSubdir:      null,
+    smokeMin:         '`pytest -x` + smoke import de paquete principal.' },
+  { clave: 'node',    etiqueta: 'Node/TypeScript',
+    agentesEsperados: ['backend-node-swl'],
+    skillsKeywords:   ['typescript', 'node-experto', 'fastify', 'express', 'nestjs', 'prisma'],
+    revisor:          'revisor-typescript-swl',
+    reglaSubdir:      null,
+    smokeMin:         '`vitest run` o `jest --ci` + `tsc --noEmit`.' },
+  { clave: 'java',    etiqueta: 'Java',
+    agentesEsperados: ['backend-java-swl'],
+    skillsKeywords:   ['java-experto', 'java-patrones', 'java-testing', 'build-errors-java', 'spring'],
+    revisor:          'revisor-java-swl',
+    reglaSubdir:      'java',
+    smokeMin:         '`mvn test` o `gradle test` con cobertura mínima de JaCoCo.' },
+  { clave: 'go',      etiqueta: 'Go',
+    agentesEsperados: ['backend-go-swl'],
+    skillsKeywords:   ['go-experto', 'go-patrones', 'go-testing', 'build-errors-go'],
+    revisor:          'revisor-go-swl',
+    reglaSubdir:      'go',
+    smokeMin:         '`go test ./... -race -count=1`.' },
+  { clave: 'rust',    etiqueta: 'Rust',
+    agentesEsperados: ['backend-rust-swl'],
+    skillsKeywords:   ['rust-experto', 'rust-patrones', 'rust-testing', 'build-errors-rust', 'axum', 'actix'],
+    revisor:          'revisor-rust-swl',
+    reglaSubdir:      'rust',
+    smokeMin:         '`cargo test` + `cargo clippy -- -D warnings`.' },
+  { clave: 'csharp',  etiqueta: 'C# / .NET',
+    agentesEsperados: ['backend-csharp-swl'],
+    skillsKeywords:   ['csharp-experto', 'csharp-patrones', 'csharp-testing', 'build-errors-csharp', 'efcore'],
+    revisor:          'revisor-csharp-swl',
+    reglaSubdir:      'csharp',
+    smokeMin:         '`dotnet test --no-build` con xUnit/NUnit y coverlet.' },
+  { clave: 'php',     etiqueta: 'PHP / Laravel',
+    agentesEsperados: [],
+    skillsKeywords:   ['php-experto', 'php-patrones', 'php-testing', 'build-errors-php', 'laravel'],
+    revisor:          'revisor-php-swl',
+    reglaSubdir:      'php',
+    smokeMin:         '`vendor/bin/phpunit` o `pest` + `phpstan analyse`.' },
+  { clave: 'kotlin',  etiqueta: 'Kotlin (Android)',
+    agentesEsperados: ['mobile-android-swl'],
+    skillsKeywords:   ['kotlin-compose', 'kotlin-experto', 'kotlin-testing', 'build-errors-kotlin'],
+    revisor:          'revisor-kotlin-swl',
+    reglaSubdir:      'kotlin',
+    smokeMin:         '`./gradlew test connectedAndroidTest` (al menos JVM tests).' },
+  { clave: 'swift',   etiqueta: 'Swift (iOS)',
+    agentesEsperados: ['mobile-ios-swl'],
+    skillsKeywords:   ['swift-experto', 'swift-patrones', 'swift-testing', 'build-errors-swift', 'swiftui'],
+    revisor:          'revisor-swift-swl',
+    reglaSubdir:      'swift',
+    smokeMin:         '`swift test` o `xcodebuild test` en scheme primario.' },
+  { clave: 'react',   etiqueta: 'React',
+    agentesEsperados: ['frontend-react-swl'],
+    skillsKeywords:   ['react', 'frontend-react'],
+    revisor:          'revisor-react-swl',
+    reglaSubdir:      null,
+    smokeMin:         'React Testing Library con cobertura mínima de smoke render.' },
+  { clave: 'angular', etiqueta: 'Angular',
+    agentesEsperados: ['frontend-angular-swl'],
+    skillsKeywords:   ['angular-avanzado', 'angular-moderno'],
+    revisor:          'revisor-angular-swl',
+    reglaSubdir:      null,
+    smokeMin:         '`ng test --watch=false --no-progress` con headless Chrome.' },
+  { clave: 'nextjs',  etiqueta: 'Next.js',
+    agentesEsperados: [],
+    skillsKeywords:   ['nextjs-experto', 'nextjs-patrones', 'nextjs-testing', 'build-errors-nextjs'],
+    revisor:          'revisor-nextjs-swl',
+    reglaSubdir:      'nextjs',
+    smokeMin:         '`next build` + Playwright sobre rutas críticas.' },
+  { clave: 'reactnative', etiqueta: 'React Native / Flutter',
+    agentesEsperados: ['mobile-cross-swl'],
+    skillsKeywords:   ['mobile-react-native', 'mobile-flutter', 'mobile-cross'],
+    revisor:          null,
+    reglaSubdir:      null,
+    smokeMin:         '`detox test` (RN) o `flutter test` + `flutter analyze`.' },
+];
+
+// ---------------------------------------------------------------------------
+// Detección
+// ---------------------------------------------------------------------------
+
+function listarSeguro(dir) {
+  try { return fs.readdirSync(path.join(ROOT, dir)); }
+  catch { return []; }
+}
+
+function detectarCobertura(lang) {
+  const agentesDisco = listarSeguro('agentes');
+  const skillsDisco  = listarSeguro('habilidades');
+  const reglasDisco  = listarSeguro('reglas/lenguajes');
+
+  const agentes = lang.agentesEsperados.filter(a =>
+    agentesDisco.includes(a + '.md'));
+  const revisor = lang.revisor && agentesDisco.includes(lang.revisor + '.md')
+    ? lang.revisor
+    : null;
+  const skills  = skillsDisco.filter(s =>
+    lang.skillsKeywords.some(k => s.toLowerCase().includes(k.toLowerCase())));
+  const regla   = lang.reglaSubdir && reglasDisco.includes(lang.reglaSubdir)
+    ? lang.reglaSubdir
+    : null;
+
+  const elementos = agentes.length + (revisor ? 1 : 0) + skills.length + (regla ? 1 : 0);
+  let status;
+  if (elementos === 0)        status = 'faltante';
+  else if (elementos < 4)     status = 'parcial';
+  else                        status = 'completo';
+
+  return { agentes, revisor, skills, regla, elementos, status };
+}
+
+// ---------------------------------------------------------------------------
+// Render
+// ---------------------------------------------------------------------------
+
+function renderTabla() {
+  const filas = LENGUAJES.map(lang => {
+    const cov = detectarCobertura(lang);
+    const icono = cov.status === 'completo' ? '✅' : cov.status === 'parcial' ? '⚠️' : '❌';
+    const agenteCelda = cov.agentes.length > 0 ? cov.agentes.join(', ') : '—';
+    const revisorCelda = cov.revisor || '—';
+    const skillsCelda = cov.skills.length > 0 ? `${cov.skills.length} skill(s)` : '—';
+    const reglaCelda = cov.regla ? `reglas/lenguajes/${cov.regla}/` : '—';
+    return `| ${icono} ${lang.etiqueta} | ${agenteCelda} | ${revisorCelda} | ${skillsCelda} | ${reglaCelda} | ${cov.status} |`;
+  });
+
+  return [
+    '| Lenguaje | Agente(s) | Revisor | Skills | Regla por-lenguaje | Status |',
+    '|----------|-----------|---------|--------|--------------------|--------|',
+    ...filas,
+  ].join('\n');
+}
+
+function renderSmoke() {
+  return LENGUAJES.map(lang => {
+    const cov = detectarCobertura(lang);
+    const tag = cov.status === 'faltante'
+      ? '_(sin cobertura SWL — el smoke aplica solo si el proyecto del usuario lo usa)_'
+      : '';
+    return `### ${lang.etiqueta}\n\n- Smoke mínimo: ${lang.smokeMin}\n${tag ? '- ' + tag + '\n' : ''}`;
+  }).join('\n');
+}
+
+function renderResumen() {
+  const total = LENGUAJES.length;
+  const completos = LENGUAJES.filter(l => detectarCobertura(l).status === 'completo').length;
+  const parciales = LENGUAJES.filter(l => detectarCobertura(l).status === 'parcial').length;
+  const faltantes = LENGUAJES.filter(l => detectarCobertura(l).status === 'faltante').length;
+  return [
+    `**Total lenguajes evaluados**: ${total}`,
+    `**Cobertura completa** (≥4 elementos: agente + revisor + skills + regla): ${completos}`,
+    `**Cobertura parcial** (1-3 elementos): ${parciales}`,
+    `**Sin cobertura SWL**: ${faltantes}`,
+  ].join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+function main() {
+  const fecha = new Date().toISOString().slice(0, 10);
+  const contenido = `# Matriz de cobertura SWL × lenguaje
+
+> **Generado automáticamente** por \`scripts/generar-matriz-lenguajes.js\`.
+> Última generación: ${fecha}.
+> NO editar a mano — re-ejecutar el script.
+
+Esta matriz documenta qué lenguajes del stack polyglot SWL tienen cobertura
+completa de **agentes + skills + reglas + revisores**, y qué smoke test mínimo
+debería ejecutarse en CI antes de release de un proyecto que use cada lenguaje.
+
+Aplica a:
+
+- **Pre-release del repo madre swl-ses**: validar que ningún lenguaje
+  declarado oficialmente perdió componentes desde el último release.
+- **Proyectos usuario**: usar la columna "Smoke mínimo" como guía de qué
+  ejecutar como mínimo antes de \`/swl:release\` en su proyecto.
+
+## Resumen
+
+${renderResumen()}
+
+## Cobertura por lenguaje
+
+${renderTabla()}
+
+**Leyenda**:
+- ✅ **completo**: ≥4 elementos (agente backend/frontend/mobile + revisor + skills + regla por-lenguaje).
+- ⚠️ **parcial**: 1-3 elementos. Aceptable si el lenguaje es de uso secundario.
+- ❌ **faltante**: ningún elemento detectado. Si el proyecto declara este lenguaje, la cobertura SWL es inadecuada.
+
+## Smoke test mínimo recomendado por lenguaje
+
+${renderSmoke()}
+
+## Cómo se usa esta matriz
+
+1. **Pre-release de swl-ses**: \`/swl:release\` invoca este script. Si algún
+   lenguaje pasó de **completo** a **parcial** o de **parcial** a **faltante**
+   sin ADR documentado, el release se bloquea.
+2. **CI de proyecto usuario**: el comando \`/swl:configurar-ci\` genera el
+   workflow incluyendo el smoke mínimo del lenguaje detectado.
+3. **Auditoría**: ejecutar \`node scripts/generar-matriz-lenguajes.js\` cuando
+   se agrega/elimina un agente, skill o regla por-lenguaje. La salida actualizada
+   debe commitearse junto al cambio.
+
+## Política de cierre por categoría
+
+- **Lenguaje completo (✅)**: cualquier eliminación de componente requiere ADR
+  en \`.planning/adrs/\` justificando la regresión.
+- **Lenguaje parcial (⚠️)**: documentar en este archivo el plan para llegar a
+  cobertura completa, o decisión explícita de mantener parcial (con razón).
+- **Lenguaje faltante (❌)**: el repo no debe afirmar soporte oficial. Mover
+  cualquier mención a "stack polyglot soportado" hasta que pase a parcial.
+`;
+
+  atomicWriteSync(SALIDA, contenido, 'utf8');
+  console.log(`Matriz generada: ${path.relative(ROOT, SALIDA)}`);
+  console.log(renderResumen());
+}
+
+main();

package/scripts/instalador.js

@@ -42,6 +42,24 @@ const { actualizarGitignore, entradasParaRuntime, limpiarTracked, leerManifest,
 const RAIZ_PKG = path.resolve(__dirname, '..');
 const VERSION = require('../package.json').version;
 
+/**
+ * Contrato adicional: `opciones.onProgress(evento)`
+ *
+ * Si se pasa una función `opciones.onProgress`, el instalador deja de imprimir
+ * cada archivo copiado/backup/symlink a stdout y en su lugar emite eventos
+ * estructurados que el caller (típicamente la TUI) puede consumir para mostrar
+ * barra de progreso + contadores por categoría.
+ *
+ * Eventos emitidos:
+ *   { tipo: 'archivo-copiado', componente: 'agentes'|'habilidades'|... , archivo: 'nombre.md' }
+ *   { tipo: 'backup',          componente: <tipo>, archivo, rutaBackup }
+ *   { tipo: 'symlink',         componente: <tipo>, archivo }
+ *   { tipo: 'colision',        componente: <tipo>, archivo }
+ *   { tipo: 'log',             linea: 'mensaje libre' }   — para mensajes informativos
+ *
+ * Backward compat: si onProgress NO se pasa, los console.log siguen iguales.
+ * El comportamiento sin TUI no cambia.
+ */
 async function install(opciones) {
   // Leer manifest .swl-ses si existe — sus valores son defaults que el CLI puede sobreescribir
   const manifest = leerManifest(process.cwd());
@@ -990,7 +1008,15 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
 
   // Verificar colisión
   if (fs.existsSync(destino) && !opciones.force) {
-    console.log(`  - Colisión: ${nombreArchivo} (usa --force para sobreescribir)`);
+    if (typeof opciones.onProgress === 'function') {
+      opciones.onProgress({
+        tipo: 'colision',
+        componente: archivo.tipo,
+        archivo: nombreArchivo,
+      });
+    } else {
+      console.log(`  - Colisión: ${nombreArchivo} (usa --force para sobreescribir)`);
+    }
     return { instalado: false, colision: true };
   }
 
@@ -998,7 +1024,16 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
   if (fs.existsSync(destino) && opciones.force && opciones.versionAnterior) {
     const backup = crearBackup(process.cwd(), destino, opciones.versionAnterior);
     if (backup.respaldado) {
-      console.log(`  ↩ Backup: ${nombreArchivo} → ${path.relative(process.cwd(), backup.rutaBackup)}`);
+      if (typeof opciones.onProgress === 'function') {
+        opciones.onProgress({
+          tipo: 'backup',
+          componente: archivo.tipo,
+          archivo: nombreArchivo,
+          rutaBackup: backup.rutaBackup,
+        });
+      } else {
+        console.log(`  ↩ Backup: ${nombreArchivo} → ${path.relative(process.cwd(), backup.rutaBackup)}`);
+      }
       if (opciones.estado) {
         registrarBackup(opciones.estado, {
           rutaOriginal: destino,
@@ -1027,7 +1062,15 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
         }
         const origenAbsoluto = path.resolve(archivo.origen);
         fs.symlinkSync(origenAbsoluto, destino, stat.isDirectory() ? 'junction' : 'file');
-        console.log(`  ~ ${path.relative(rutas.base, destino)} (symlink)`);
+        if (typeof opciones.onProgress === 'function') {
+          opciones.onProgress({
+            tipo: 'symlink',
+            componente: archivo.tipo,
+            archivo: nombreArchivo,
+          });
+        } else {
+          console.log(`  ~ ${path.relative(rutas.base, destino)} (symlink)`);
+        }
         return { instalado: true, destino };
       } catch (symlinkErr) {
         // Fallback a copy si symlink falla (permisos, filesystem)
@@ -1045,7 +1088,15 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
     } else {
       fs.copyFileSync(archivo.origen, destino);
     }
-    console.log(`  + ${path.relative(rutas.base, destino)}`);
+    if (typeof opciones.onProgress === 'function') {
+      opciones.onProgress({
+        tipo: 'archivo-copiado',
+        componente: archivo.tipo,
+        archivo: nombreArchivo,
+      });
+    } else {
+      console.log(`  + ${path.relative(rutas.base, destino)}`);
+    }
     return { instalado: true, destino };
   } else {
     return { instalado: false, razon: 'origen no existe' };