@saulwade/swl-ses 2.2.4 → 2.3.0

package/scripts/lib/skill-metrics.js

@@ -199,11 +199,38 @@ function resumen(cwd) {
   };
 }
 
+const MS_DIA = 86400000;
+
+/**
+ * Skills "fríos": tuvieron uso previo pero su último uso es más antiguo que `dias`.
+ * Los skills NUNCA usados NO aparecen (obtenerMetricas solo incluye skills con ≥1
+ * entrada) — eso es bloat, dominio distinto a staleness (Fase 20 / análisis self-learning).
+ *
+ * @param {string} cwd
+ * @param {Date}   [hoy=new Date()]
+ * @param {{dias?: number}} [opts]  umbral en días (default SWL_SKILL_STALE_DIAS o 90)
+ * @returns {Array<{skill: string, ultimoUso: string, diasInactivo: number}>}
+ *          ordenado por diasInactivo descendente.
+ */
+function skillsStale(cwd, hoy = new Date(), opts = {}) {
+  const dias = Number(opts.dias) || Number(process.env.SWL_SKILL_STALE_DIAS) || 90;
+  const ahora = (hoy instanceof Date ? hoy : new Date(hoy)).getTime();
+  const out = [];
+  for (const m of obtenerMetricas(cwd)) {
+    if (!m.ultimoUso) continue;
+    const t = new Date(m.ultimoUso).getTime();
+    if (Number.isNaN(t)) continue;
+    const diasInactivo = Math.floor((ahora - t) / MS_DIA);
+    if (diasInactivo > dias) out.push({ skill: m.skill, ultimoUso: m.ultimoUso, diasInactivo });
+  }
+  return out.sort((a, b) => b.diasInactivo - a.diasInactivo);
+}
+
 // ---------------------------------------------------------------------------
 // Exports
 // ---------------------------------------------------------------------------
 
-module.exports = { registrarUso, obtenerMetricas, topFallidos, topLentos, resumen };
+module.exports = { registrarUso, obtenerMetricas, topFallidos, topLentos, resumen, skillsStale };
 
 // ---------------------------------------------------------------------------
 // CLI dual-use
@@ -218,6 +245,19 @@ if (require.main === module) {
     process.exit(0);
   }
 
+  if (cmd === '--stale' || cmd === 'stale') {
+    const stale = skillsStale(cwd);
+    if (stale.length === 0) {
+      process.stdout.write('Sin skills fríos (todos con uso reciente o sin métricas).\n');
+    } else {
+      process.stdout.write('\nSkills fríos (uso previo, inactivos > umbral):\n');
+      for (const s of stale) {
+        process.stdout.write(`  ${s.skill.padEnd(36)} ${String(s.diasInactivo).padStart(4)}d sin uso  → /swl:evaluar-skill ${s.skill}\n`);
+      }
+    }
+    process.exit(0);
+  }
+
   // Modo resumen (default)
   const r = resumen(cwd);
   process.stdout.write('\nMétricas de habilidades SWL\n');