@saulwade/swl-ses 1.7.4 → 1.8.0

package/reglas/gobernanza.md

@@ -40,7 +40,7 @@ Los skills generados por `auto-evolucion-swl` o `/swl:evolucionar`:
   `agentes/auto-evolucion-swl.md` sección "Gate G8". Origen ADR 0013
   sección 3C.
 - La promoción se registra en `.planning/AUDITORIA.md` con justificación
-  Y en `.planning/evolucion/evoluciones.jsonl` con evento
+  Y en `.planning/evolution/evoluciones.jsonl` con evento
   `tipo: "promocion-skill"` y `score`.
 
 ### Reglas nuevas obligatorias

package/reglas/memoria-consolidada.md

@@ -15,7 +15,7 @@ regla clara, un mismo dato puede terminar en el lugar incorrecto o duplicado.
 | 2 | **`.planning/APRENDIZAJES.md`** | Markdown con entradas `### [YYYY-MM-DD] Título` agrupadas por sección | Conocimiento del dominio (anti-patrones, patrones, decisiones, gotchas) |
 | 3 | **`instintos/proyecto.yaml` / `global.yaml` / `perfil-usuario.yaml`** | YAML estructurado con confidence, scope, evidence_count | Patrones aprendidos inductivamente, con promoción/degradación |
 | 4 | **`.planning/sessions/search-index.json`** | Índice FTS de sesiones pasadas | Búsqueda histórica de trabajo (qué se hizo, cuándo) |
-| 5 | **`.planning/evolucion/*`** | JSONL (nudges, agentes) + JSON (métricas, alertas, evoluciones) | Estado del ciclo de auto-evolución |
+| 5 | **`.planning/evolution/*`** | JSONL (nudges, agentes) + JSON (métricas, alertas, evoluciones) | Estado del ciclo de auto-evolución |
 
 ---
 
@@ -44,11 +44,11 @@ regla clara, un mismo dato puede terminar en el lugar incorrecto o duplicado.
 
 | Tipo de dato | Canal correcto |
 |---|---|
-| Nudge emitido por un hook | 5 (`.planning/evolucion/nudges.jsonl`) |
-| Evento de subagente terminado | 5 (`.planning/auto-evolucion/agentes.jsonl`) |
-| Evolución aplicada/revertida a skill | 5 (`.planning/evolucion/evoluciones.jsonl`) |
-| Alerta persistente (nudges ignorados) | 5 (`.planning/evolucion/alertas-persistentes.json`) |
-| Métricas agregadas (health score) | 5 (`.planning/evolucion/metricas.json`) |
+| Nudge emitido por un hook | 5 (`.planning/evolution/nudges.jsonl`) |
+| Evento de subagente terminado | 5 (`.planning/auto-evolution/agentes.jsonl`) |
+| Evolución aplicada/revertida a skill | 5 (`.planning/evolution/evoluciones.jsonl`) |
+| Alerta persistente (nudges ignorados) | 5 (`.planning/evolution/alertas-persistentes.json`) |
+| Métricas agregadas (health score) | 5 (`.planning/evolution/metricas.json`) |
 | Traza de ejecución de agente | `.planning/traces/` (OTLP-lite) |
 | Audit trail inmutable | `.planning/audit.jsonl` + Merkle |
 
@@ -125,7 +125,7 @@ conocido, datos en canales deprecados.
 
 - **Corrección del usuario escrita a APRENDIZAJES.md** → debe ir al perfil
 - **Anti-patrón técnico escrito al perfil del usuario** → debe ir a APRENDIZAJES
-- **Métrica persistida en APRENDIZAJES.md** → debe ir a `.planning/evolucion/`
+- **Métrica persistida en APRENDIZAJES.md** → debe ir a `.planning/evolution/`
 - **Secreto/credencial en cualquier canal** → bloqueo inmediato (`privacy-memoria`)
 - **Dato duplicado en proyecto.yaml y global.yaml** → uno debe borrarse
   (promover a global SOLO cuando confidence > 0.8 Y validado cross-proyecto)

package/reglas/sin-duplicacion-reglas-globales.md

@@ -96,7 +96,7 @@ node scripts/auditar-claudemd.js
 - **Auditor síncrono**: `scripts/auditar-claudemd.js` (dimensión 7,
   severidad WARN, no bloquea).
 - **Hook async**: `hooks/claudemd-duplicacion-detector.js` (PostToolUse,
-  emite nudge a `.planning/evolucion/nudges.jsonl`).
+  emite nudge a `.planning/evolution/nudges.jsonl`).
 - **Comando**: `/swl:claudemd audit` reporta el conteo; `/swl:claudemd
   refactor` propone el reemplazo concreto.
 

package/scripts/auditar-agentes-gaps.js

@@ -34,7 +34,7 @@ try {
 
 var RAIZ_AGENTES = path.resolve(__dirname, '..', 'agentes');
 var DESTINO_PLANNING = path.resolve(
-  __dirname, '..', '.planning', 'evolucion', 'audit-agentes-gaps.json'
+  __dirname, '..', '.planning', 'evolution', 'audit-agentes-gaps.json'
 );
 
 // Patrones - soportan LF y CRLF (Windows).

package/scripts/auditar-cobertura-frameworks.js

@@ -11,7 +11,7 @@
  * Uso:
  *   node scripts/auditar-cobertura-frameworks.js            # JSON a stdout
  *   node scripts/auditar-cobertura-frameworks.js --resumen  # tabla a stderr
- *   node scripts/auditar-cobertura-frameworks.js --save     # persiste en .planning/evolucion/
+ *   node scripts/auditar-cobertura-frameworks.js --save     # persiste en .planning/evolution/
  *   node scripts/auditar-cobertura-frameworks.js --framework=nist_csf  # solo un framework
  *
  * No falla si un skill no tiene mapeos — solo los skills del dominio de
@@ -35,7 +35,7 @@ try {
 
 const RAIZ_SKILLS = path.resolve(__dirname, '..', 'habilidades');
 const DESTINO = path.resolve(
-  __dirname, '..', '.planning', 'evolucion', 'cobertura-frameworks.json'
+  __dirname, '..', '.planning', 'evolution', 'cobertura-frameworks.json'
 );
 
 const CAMPOS_FRAMEWORK = Object.freeze([

package/scripts/auditar-skills-gaps.js

@@ -10,7 +10,7 @@
  * Uso:
  *   node scripts/auditar-skills-gaps.js             # JSON a stdout
  *   node scripts/auditar-skills-gaps.js --resumen   # solo tabla a stderr
- *   node scripts/auditar-skills-gaps.js --save      # persiste en .planning/evolucion/
+ *   node scripts/auditar-skills-gaps.js --save      # persiste en .planning/evolution/
  *   node scripts/auditar-skills-gaps.js --incluir-excepciones  # incluye gaps excusados en el total
  *
  * Excepciones documentadas: lista inline de skills con gaps justificados por ADR.
@@ -30,7 +30,7 @@ try {
 
 const RAIZ_SKILLS = path.resolve(__dirname, '..', 'habilidades');
 const DESTINO_PLANNING = path.resolve(
-  __dirname, '..', '.planning', 'evolucion', 'audit-skills-gaps.json'
+  __dirname, '..', '.planning', 'evolution', 'audit-skills-gaps.json'
 );
 
 // Patrones de detección

package/scripts/benchmark-memoria.js

@@ -26,7 +26,7 @@
  *   2 - Argumentos inválidos
  *
  * Persistencia opcional: si se setea SWL_BENCHMARK_PERSIST=1, escribe
- * el resultado agregado a `.planning/evolucion/benchmark-memoria.jsonl`
+ * el resultado agregado a `.planning/evolution/benchmark-memoria.jsonl`
  * para tracking histórico.
  */
 
@@ -36,7 +36,7 @@ const path = require('path');
 const { ejecutarDataset } = require('./lib/longmemeval-runner');
 
 const DATASET_DEFAULT = '.planning/benchmark/dataset.jsonl';
-const HISTORICO_PATH  = '.planning/evolucion/benchmark-memoria.jsonl';
+const HISTORICO_PATH  = '.planning/evolution/benchmark-memoria.jsonl';
 
 function uso() {
   console.error('Uso: node scripts/benchmark-memoria.js [--dataset <ruta>] [--limit <n>] [--json] [--verbose]');
@@ -64,7 +64,7 @@ function parseArgs(argv) {
 function persistirHistorico(baseDir, resumen) {
   if (process.env.SWL_BENCHMARK_PERSIST !== '1') return;
   try {
-    const dirEvolucion = path.join(baseDir, '.planning', 'evolucion');
+    const dirEvolucion = path.join(baseDir, '.planning', 'evolution');
     if (!fs.existsSync(dirEvolucion)) fs.mkdirSync(dirEvolucion, { recursive: true });
     const linea = JSON.stringify({
       timestamp: new Date().toISOString(),

package/scripts/inferir-herramientas-permitidas.js

@@ -14,7 +14,7 @@
  *   node scripts/inferir-herramientas-permitidas.js --dry-run --skill=fastapi-experto
  *   node scripts/inferir-herramientas-permitidas.js --aplicar
  *   node scripts/inferir-herramientas-permitidas.js --aplicar --solo-faltantes
- *   node scripts/inferir-herramientas-permitidas.js --aplicar --log=.planning/evolucion/infer-herramientas.log
+ *   node scripts/inferir-herramientas-permitidas.js --aplicar --log=.planning/evolution/infer-herramientas.log
  *
  * @module scripts/inferir-herramientas-permitidas
  */

package/scripts/instalador.js

@@ -416,6 +416,54 @@ async function install(opciones) {
     console.log(`  [migración] ${migracionesAplicadas} archivo(s) de .planning/ migrado(s) de inglés a español`);
   }
 
+  // 6c-bis. Migración de DIRECTORIOS runtime de .planning/ español → inglés.
+  //     Unificación: los paths runtime/técnicos van en inglés (telemetría, perfil,
+  //     logs archivados). NO incluye fases/ (vocabulario GSD de cara al usuario, se
+  //     mantiene español por coherencia con los comandos *-fase). Ver ADR-0031.
+  const MIGRACIONES_DIRS_PLANNING = [
+    { viejo: 'evolucion',      nuevo: 'evolution' },
+    { viejo: 'auto-evolucion', nuevo: 'auto-evolution' },
+    { viejo: 'perfil-usuario', nuevo: 'user-profile' },
+    { viejo: 'archivo',        nuevo: 'archive' },
+  ];
+
+  let dirsMigrados = 0;
+  for (const m of MIGRACIONES_DIRS_PLANNING) {
+    const dirViejo = path.join(process.cwd(), '.planning', m.viejo);
+    const dirNuevo = path.join(process.cwd(), '.planning', m.nuevo);
+
+    if (!fs.existsSync(dirViejo)) continue;
+
+    try {
+      if (!fs.existsSync(dirNuevo)) {
+        // Caso 1: solo existe el viejo → renombrar el directorio completo
+        fs.renameSync(dirViejo, dirNuevo);
+        console.log(`  ✓ Migración dir: .planning/${m.viejo}/ → .planning/${m.nuevo}/`);
+      } else {
+        // Caso 2: ambos existen → mover entradas del viejo al nuevo (sin sobreescribir)
+        let saltadas = 0;
+        for (const entry of fs.readdirSync(dirViejo)) {
+          const src = path.join(dirViejo, entry);
+          const dst = path.join(dirNuevo, entry);
+          if (!fs.existsSync(dst)) fs.renameSync(src, dst);
+          else saltadas++; // conflicto de nombre: se deja en origen (no destructivo)
+        }
+        try { fs.rmdirSync(dirViejo); } catch { /* no vacío: se deja, no destructivo */ }
+        const sufijo = saltadas > 0
+          ? ` (${saltadas} entrada(s) con conflicto dejadas en .planning/${m.viejo}/)`
+          : '';
+        console.log(`  ⊕ Migración dir: .planning/${m.viejo}/ fusionado en .planning/${m.nuevo}/${sufijo}`);
+      }
+      dirsMigrados++;
+    } catch (err) {
+      console.log(`  ! Migración dir ${m.viejo}: ${err.message}`);
+    }
+  }
+
+  if (dirsMigrados > 0) {
+    console.log(`  [migración] ${dirsMigrados} directorio(s) runtime de .planning/ migrado(s) español → inglés`);
+  }
+
   // 6d. Filtrar skills por targets declarados en SKILL.md frontmatter (patrón skillshare)
   //     Si un skill declara targets: [claude, copilot], solo se instala en esos runtimes.
   //     Si no declara targets, se instala en todos (comportamiento por defecto).

package/scripts/lib/dashboard-widgets.js

@@ -122,7 +122,7 @@ const _WIDGET_CATALOG = [
   {
     id: 'nudges-recientes',
     label: 'Nudges Recientes',
-    descripcion: 'Últimos nudges emitidos por hooks de observabilidad (.planning/evolucion/nudges.jsonl)',
+    descripcion: 'Últimos nudges emitidos por hooks de observabilidad (.planning/evolution/nudges.jsonl)',
     categoria: 'evolucion',
     modos: ['offline'],
     tamanoDefault: 'md',
@@ -130,7 +130,7 @@ const _WIDGET_CATALOG = [
   {
     id: 'evoluciones-aplicadas',
     label: 'Evoluciones Aplicadas',
-    descripcion: 'Historial de evoluciones de skills y agentes (.planning/evolucion/evoluciones.jsonl)',
+    descripcion: 'Historial de evoluciones de skills y agentes (.planning/evolution/evoluciones.jsonl)',
     categoria: 'evolucion',
     modos: ['offline'],
     tamanoDefault: 'md',
@@ -138,7 +138,7 @@ const _WIDGET_CATALOG = [
   {
     id: 'alertas-persistentes',
     label: 'Alertas Persistentes',
-    descripcion: 'Alertas activas sin resolver del ciclo AGP (.planning/evolucion/alertas-persistentes.json)',
+    descripcion: 'Alertas activas sin resolver del ciclo AGP (.planning/evolution/alertas-persistentes.json)',
     categoria: 'evolucion',
     modos: ['offline'],
     tamanoDefault: 'md',

package/scripts/lib/drift-detector.js

@@ -17,7 +17,7 @@
  *   - Fuente de datos: JSONL en disco, no SQLite
  *   - Sin dependencias externas (solo Node stdlib: fs, path)
  *   - Métricas configurables via parámetro, no hardcodeadas
- *   - Emite nudge a .planning/evolucion/nudges.jsonl en drift crítico
+ *   - Emite nudge a .planning/evolution/nudges.jsonl en drift crítico
  *
  * @module scripts/lib/drift-detector
  */
@@ -50,7 +50,7 @@ const METRICAS_DEFAULT = [
 
 // Ruta raíz del proyecto (dos niveles arriba de scripts/lib/)
 const RAIZ_PROYECTO = path.resolve(__dirname, '..', '..');
-const RUTA_NUDGES   = path.join(RAIZ_PROYECTO, '.planning', 'evolucion', 'nudges.jsonl');
+const RUTA_NUDGES   = path.join(RAIZ_PROYECTO, '.planning', 'evolution', 'nudges.jsonl');
 
 // ── helpers internos ──────────────────────────────────────────────────────────
 
@@ -202,7 +202,7 @@ function contarNudgesPrevios(metrica, agente) {
 }
 
 /**
- * Emite un nudge a .planning/evolucion/nudges.jsonl cuando se detecta
+ * Emite un nudge a .planning/evolution/nudges.jsonl cuando se detecta
  * drift crítico. Usa fs.appendFileSync (JSONL, no sobreescribe).
  *
  * Aplica repair-loop detection: si el mismo (metrica, agente) ya fue

package/scripts/lib/eval-metrics-store.js

@@ -5,8 +5,8 @@
  *
  * Patrón adoptado de `temp/agentmemory-main/src/eval/metrics-store.ts`.
  * Adaptado a swl-ses: file-based en lugar de SQLite. Persiste:
- *   - JSONL append-only:    `.planning/evolucion/eval-results.jsonl` (cada eval individual)
- *   - JSON agregado:        `.planning/evolucion/eval-metrics.json`  (totales por functionId)
+ *   - JSONL append-only:    `.planning/evolution/eval-results.jsonl` (cada eval individual)
+ *   - JSON agregado:        `.planning/evolution/eval-metrics.json`  (totales por functionId)
  *
  * El JSONL preserva el detalle histórico (un evento por evaluación). El JSON
  * agregado se recalcula incrementalmente: avg latency, avg quality, success
@@ -31,7 +31,7 @@ try {
 
 // ── constantes ────────────────────────────────────────────────────────────────
 
-const DIR_EVOLUCION = path.join('.planning', 'evolucion');
+const DIR_EVOLUCION = path.join('.planning', 'evolution');
 const RUTA_JSONL    = path.join(DIR_EVOLUCION, 'eval-results.jsonl');
 const RUTA_AGREGADO = path.join(DIR_EVOLUCION, 'eval-metrics.json');
 

package/scripts/lib/gitignore-manifest.js

@@ -77,10 +77,10 @@ const ENTRADAS_BASE = [
   // (metricas-evolucion, nudge-tracker, drift-detector, auto-evolucion,
   // singleton-guard, actualizar-perfil-usuario). Output de runtime, no
   // artefactos del proyecto usuario.
-  ".planning/evolucion/",
-  ".planning/auto-evolucion/",
+  ".planning/evolution/",
+  ".planning/auto-evolution/",
   ".planning/locks/",
-  ".planning/perfil-usuario/",
+  ".planning/user-profile/",
 
   // Instintos modificados automáticamente por hooks (degradacion-instintos.js)
   "instintos/",

package/scripts/mcp-server/README.md

@@ -121,7 +121,7 @@ proyecto — sería redundante.
 |---|---|---|
 | Auth | sin auth | opt-in con `SWL_MCP_API_KEY` + Bearer en `params._auth` |
 | Caching | sin caching | mtime-based con TTL configurable |
-| Telemetría | logs stderr | JSONL en `.planning/evolucion/mcp-metrics.jsonl` (opt-in) |
+| Telemetría | logs stderr | JSONL en `.planning/evolution/mcp-metrics.jsonl` (opt-in) |
 | Schema versioning | implícito | `_schemaVersion` en cada tool de `tools/list` |
 | Tests | smoke manual | 38 tests unitarios (`tests/mcp-server/*.test.js`) |
 | Estado | "NO usar en producción" | apto para los proyectos del usuario |

package/scripts/mcp-server/telemetry.js

@@ -4,7 +4,7 @@
  * Telemetría opt-in del swl-mcp-server v1.0.0 (ADR-0019 Sub-fase 3).
  *
  * Cuando `SWL_MCP_METRICS=1` está activo, cada `tools/call` se registra en
- * `.planning/evolucion/mcp-metrics.jsonl` con:
+ * `.planning/evolution/mcp-metrics.jsonl` con:
  *   { ts, tool, durationMs, ok, error?, baseDir }
  *
  * Defaults:
@@ -42,7 +42,7 @@ function construirTelemetria(opciones = {}) {
     };
   }
 
-  const dirEvolucion = path.join(baseDir, '.planning', 'evolucion');
+  const dirEvolucion = path.join(baseDir, '.planning', 'evolution');
   const ruta = path.join(dirEvolucion, 'mcp-metrics.jsonl');
 
   // Asegurar que el directorio existe — si falla, deshabilitamos silenciosamente.

package/scripts/reflect-skills.js

@@ -10,11 +10,11 @@
  *
  * Fuentes:
  *   - ~/.claude/projects/<slug-proyecto>/*.jsonl
- *   - .planning/evolucion/feedback-queue.jsonl (si existe)
+ *   - .planning/evolution/feedback-queue.jsonl (si existe)
  *
  * Salida:
  *   - stdout: reporte de clusters con N >= UMBRAL_REPETICIONES
- *   - .planning/evolucion/reflect-skills-report.json: reporte estructurado
+ *   - .planning/evolution/reflect-skills-report.json: reporte estructurado
  *
  * Uso:
  *   node scripts/reflect-skills.js [--ventana 30] [--umbral 3] [--json]
@@ -229,7 +229,7 @@ function clusterizarPrompts(prompts) {
 // ---------------------------------------------------------------------------
 
 function leerFeedbackQueue(cwd, ventanaMs) {
-  const queuePath = path.join(cwd, '.planning', 'evolucion', 'feedback-queue.jsonl');
+  const queuePath = path.join(cwd, '.planning', 'evolution', 'feedback-queue.jsonl');
   if (!fs.existsSync(queuePath)) return [];
   const cutoff = Date.now() - ventanaMs;
   const items = [];
@@ -373,7 +373,7 @@ function main() {
 
   // Guardar reporte estructurado
   try {
-    const dir = path.join(cwd, '.planning', 'evolucion');
+    const dir = path.join(cwd, '.planning', 'evolution');
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
     fs.writeFileSync(
       path.join(dir, 'reflect-skills-report.json'),

package/scripts/rotar-audit-logs.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 // scripts/rotar-audit-logs.js
 // Rota entradas antiguas de .planning/audit.jsonl y .planning/audit-merkle.jsonl
-// a archivos comprimidos .gz agrupados por mes en .planning/archivo/audit/.
+// a archivos comprimidos .gz agrupados por mes en .planning/archive/audit/.
 // Zero-dependencies (usa fs, zlib, path de Node). CRLF-safe.
 //
 // Política por defecto:
 //   - Entradas con timestamp mayor a RETENCION_DIAS días (default 30) se archivan.
-//   - Destino: .planning/archivo/audit/<nombre>-YYYY-MM.jsonl.gz
+//   - Destino: .planning/archive/audit/<nombre>-YYYY-MM.jsonl.gz
 //   - Las entradas recientes quedan en el archivo activo sin alterar orden.
 //   - audit-merkle.jsonl preserva la cadena de hashes: los archivos comprimidos
 //     conservan cada entrada con su `prev`/`hash`, y el archivo activo sigue

package/scripts/run-skill-evals.js

@@ -8,7 +8,7 @@
  * No ejecuta el LLM — esa parte la hace /swl:evaluar-skill. Este script:
  *   - Valida el JSON contra schemas/skill-evals.schema.json (shape mínima).
  *   - Emite un "plan de evaluación" ejecutable: lista de (id, prompt, expectations).
- *   - Registra el baseline/after en .planning/evolucion/evoluciones.jsonl cuando
+ *   - Registra el baseline/after en .planning/evolution/evoluciones.jsonl cuando
  *     se invoca con --record-baseline o --record-after.
  *
  * Uso:
@@ -33,7 +33,7 @@ const path = require('path');
 const { validarInvariantesDeAgente } = require('./lib/agp-frontmatter');
 
 const CWD = process.cwd();
-const EVOL_DIR = path.join(CWD, '.planning', 'evolucion');
+const EVOL_DIR = path.join(CWD, '.planning', 'evolution');
 const EVOL_LOG = path.join(EVOL_DIR, 'evoluciones.jsonl');
 
 function ensureDir(d) { try { fs.mkdirSync(d, { recursive: true }); } catch { /* ignore */ } }