@saulwade/swl-ses 2.3.0 → 2.4.1

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

@@ -26,6 +26,7 @@ const { obtenerTransformador } = require('./lib/transformadores');
 const {
   esProtegido,
   crearBackup,
+  rutaBackupSegura,
   registrarBackup,
   limpiarBackups,
   mergeInstintos,
@@ -1245,7 +1246,9 @@ function instalarArchivo(archivo, rutas, runtime, opciones = {}) {
           // ALTO (nemesis O6): respaldar el DIRECTORIO COMPLETO (recursos incluidos)
           // antes de sobrescribir — el usuario pudo modificar recursos/ aunque no
           // tocara el SKILL.md. Overwrite controlado en-bloque (no fall-through).
-          const backupDir = path.join(process.cwd(), '.planning', 'backups', `v${versionBackup}`, path.relative(process.cwd(), destino));
+          // rutaBackupSegura contiene el backup dentro del dir versionado incluso
+          // cuando destino está fuera del cwd (install --global — bug 2026-07-03).
+          const backupDir = rutaBackupSegura(process.cwd(), versionBackup, destino);
           let backupOk = false;
           try { copiarDirectorio(destino, backupDir); backupOk = true; } catch (e) { console.log(`  ⚠ Backup de directorio falló (${e.message})`); }
           if (!backupOk) {

package/scripts/lib/artefactos-python.js

@@ -1,43 +1,43 @@
-'use strict';
-
-/**
- * artefactos-python.js — fuente única de verdad para los artefactos
- * Python que NO deben distribuirse en el paquete npm.
- *
- * Por qué existe:
- *   Tanto `scripts/limpiar-artefactos-python.js` (prepack) como
- *   `scripts/publicar.js` (copiarDir hacia tmpDir del mirror GH)
- *   necesitan saber qué directorios y extensiones excluir. Tener la
- *   lista hardcodeada en cada archivo es violación DRY de conocimiento
- *   — agregar `.pyd` o `.mypy_cache_v2` exigiría editar dos archivos
- *   y mantenerlos sincronizados.
- */
-
-const DIRS_ARTEFACTOS_PYTHON = Object.freeze(new Set([
-  '__pycache__',
-  '.pytest_cache',
-  '.mypy_cache',
-  '.ruff_cache',
-]));
-
-const EXTS_ARTEFACTOS_PYTHON = Object.freeze(new Set([
-  '.pyc',
-  '.pyo',
-]));
-
-function esDirArtefacto(nombre) {
-  return DIRS_ARTEFACTOS_PYTHON.has(nombre);
-}
-
-function esArchivoArtefacto(nombre) {
-  const dot = nombre.lastIndexOf('.');
-  if (dot < 0) return false;
-  return EXTS_ARTEFACTOS_PYTHON.has(nombre.slice(dot).toLowerCase());
-}
-
-module.exports = {
-  DIRS_ARTEFACTOS_PYTHON,
-  EXTS_ARTEFACTOS_PYTHON,
-  esDirArtefacto,
-  esArchivoArtefacto,
-};
+'use strict';
+
+/**
+ * artefactos-python.js — fuente única de verdad para los artefactos
+ * Python que NO deben distribuirse en el paquete npm.
+ *
+ * Por qué existe:
+ *   Tanto `scripts/limpiar-artefactos-python.js` (prepack) como
+ *   `scripts/publicar.js` (copiarDir hacia tmpDir del mirror GH)
+ *   necesitan saber qué directorios y extensiones excluir. Tener la
+ *   lista hardcodeada en cada archivo es violación DRY de conocimiento
+ *   — agregar `.pyd` o `.mypy_cache_v2` exigiría editar dos archivos
+ *   y mantenerlos sincronizados.
+ */
+
+const DIRS_ARTEFACTOS_PYTHON = Object.freeze(new Set([
+  '__pycache__',
+  '.pytest_cache',
+  '.mypy_cache',
+  '.ruff_cache',
+]));
+
+const EXTS_ARTEFACTOS_PYTHON = Object.freeze(new Set([
+  '.pyc',
+  '.pyo',
+]));
+
+function esDirArtefacto(nombre) {
+  return DIRS_ARTEFACTOS_PYTHON.has(nombre);
+}
+
+function esArchivoArtefacto(nombre) {
+  const dot = nombre.lastIndexOf('.');
+  if (dot < 0) return false;
+  return EXTS_ARTEFACTOS_PYTHON.has(nombre.slice(dot).toLowerCase());
+}
+
+module.exports = {
+  DIRS_ARTEFACTOS_PYTHON,
+  EXTS_ARTEFACTOS_PYTHON,
+  esDirArtefacto,
+  esArchivoArtefacto,
+};