@saulwade/swl-ses 1.5.1 → 1.6.0

package/scripts/field-report.js

@@ -1,199 +1,199 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * field-report.js — Generador de reportes de validación en campo.
- *
- * Analiza sesiones JSONL de Claude Code para extraer métricas reales de uso
- * de skills y agentes SWL en proyectos de usuario.
- *
- * Uso:
- *   node scripts/field-report.js                    # Todas las sesiones
- *   node scripts/field-report.js --days=30          # Últimos 30 días
- *   node scripts/field-report.js --project=/path    # Proyecto específico
- *   node scripts/field-report.js --output=json      # Salida JSON
- *
- * Métricas extraídas:
- *   - Skills invocados (Skill("nombre"))
- *   - Agentes delegados (Agent con description)
- *   - Comandos /swl:* ejecutados
- *   - Proyectos donde se usó swl-ses
- *   - Frecuencia de uso por componente
- *   - Skills nunca usados (candidatos a poda)
- *
- * @module scripts/field-report
- */
-
-const fs   = require('fs');
-const path = require('path');
-const os   = require('os');
-
-// ── Argumentos ────────────────────────────────────────────────────────
-
-const args = process.argv.slice(2).reduce((acc, arg) => {
-  const [k, v] = arg.replace(/^--/, '').split('=');
-  acc[k] = v || true;
-  return acc;
-}, {});
-
-const DAYS       = parseInt(args.days) || 0;
-const PROJECT    = args.project || null;
-const OUTPUT     = args.output || 'md';
-const CLAUDE_DIR = path.join(os.homedir(), '.claude', 'projects');
-
-// ── Explorar sesiones ─────────────────────────────────────────────────
-
-function buscarSesiones() {
-  const sesiones = [];
-  if (!fs.existsSync(CLAUDE_DIR)) {
-    console.error(`No se encontró ${CLAUDE_DIR}`);
-    return sesiones;
-  }
-
-  const proyectos = fs.readdirSync(CLAUDE_DIR).filter(d =>
-    fs.statSync(path.join(CLAUDE_DIR, d)).isDirectory()
-  );
-
-  for (const proy of proyectos) {
-    if (PROJECT && !proy.includes(PROJECT.replace(/[/\\:]/g, '-'))) continue;
-    const dir = path.join(CLAUDE_DIR, proy);
-    const archivos = fs.readdirSync(dir).filter(f => f.endsWith('.jsonl'));
-    for (const archivo of archivos) {
-      const ruta = path.join(dir, archivo);
-      const stat = fs.statSync(ruta);
-      if (DAYS > 0) {
-        const hace = Date.now() - DAYS * 86400000;
-        if (stat.mtimeMs < hace) continue;
-      }
-      sesiones.push({ proyecto: proy, ruta, fecha: stat.mtime });
-    }
-  }
-
-  return sesiones;
-}
-
-function analizarSesion(ruta) {
-  const stats = { skills: {}, agentes: {}, comandos: {}, toolCalls: 0 };
-  try {
-    const contenido = fs.readFileSync(ruta, 'utf8');
-    const lineas = contenido.split('\n').filter(Boolean);
-
-    for (const linea of lineas) {
-      try {
-        const entry = JSON.parse(linea);
-        const msg = entry.message || entry;
-
-        // Buscar Skill("nombre") en contenido
-        const texto = JSON.stringify(msg);
-        const skillMatches = texto.matchAll(/Skill\s*\(\s*["']([^"']+)["']\s*\)/g);
-        for (const m of skillMatches) {
-          stats.skills[m[1]] = (stats.skills[m[1]] || 0) + 1;
-        }
-
-        // Buscar agentes delegados
-        const agentMatches = texto.matchAll(/"description"\s*:\s*"([^"]*swl[^"]*)"/gi);
-        for (const m of agentMatches) {
-          const nombre = m[1].substring(0, 60);
-          stats.agentes[nombre] = (stats.agentes[nombre] || 0) + 1;
-        }
-
-        // Buscar comandos /swl:*
-        const cmdMatches = texto.matchAll(/\/swl:([a-z-]+)/g);
-        for (const m of cmdMatches) {
-          const cmd = `/swl:${m[1]}`;
-          stats.comandos[cmd] = (stats.comandos[cmd] || 0) + 1;
-        }
-
-        // Contar tool calls
-        if (msg.type === 'tool_use' || msg.tool_name) stats.toolCalls++;
-      } catch { /* línea JSONL inválida, ignorar */ }
-    }
-  } catch { /* archivo ilegible, ignorar */ }
-
-  return stats;
-}
-
-// ── Generar reporte ───────────────────────────────────────────────────
-
-function generarReporte() {
-  const sesiones = buscarSesiones();
-  if (sesiones.length === 0) {
-    console.log('No se encontraron sesiones para analizar.');
-    console.log(`Directorio buscado: ${CLAUDE_DIR}`);
-    return;
-  }
-
-  const totales = { skills: {}, agentes: {}, comandos: {}, sesiones: sesiones.length, proyectos: new Set(), toolCalls: 0 };
-
-  for (const sesion of sesiones) {
-    totales.proyectos.add(sesion.proyecto);
-    const stats = analizarSesion(sesion.ruta);
-    totales.toolCalls += stats.toolCalls;
-
-    for (const [k, v] of Object.entries(stats.skills))   totales.skills[k]   = (totales.skills[k] || 0) + v;
-    for (const [k, v] of Object.entries(stats.agentes))  totales.agentes[k]  = (totales.agentes[k] || 0) + v;
-    for (const [k, v] of Object.entries(stats.comandos)) totales.comandos[k] = (totales.comandos[k] || 0) + v;
-  }
-
-  // Cargar inventario de skills
-  const skillsDir = path.join(__dirname, '..', 'habilidades');
-  const todosSkills = fs.existsSync(skillsDir)
-    ? fs.readdirSync(skillsDir).filter(d => fs.statSync(path.join(skillsDir, d)).isDirectory())
-    : [];
-
-  const skillsUsados   = new Set(Object.keys(totales.skills));
-  const skillsNoUsados = todosSkills.filter(s => !skillsUsados.has(s));
-
-  if (OUTPUT === 'json') {
-    console.log(JSON.stringify({
-      fecha: new Date().toISOString(),
-      sesiones: totales.sesiones,
-      proyectos: [...totales.proyectos],
-      toolCalls: totales.toolCalls,
-      skills: Object.entries(totales.skills).sort((a, b) => b[1] - a[1]),
-      agentes: Object.entries(totales.agentes).sort((a, b) => b[1] - a[1]),
-      comandos: Object.entries(totales.comandos).sort((a, b) => b[1] - a[1]),
-      skillsNoUsados,
-      cobertura: `${skillsUsados.size}/${todosSkills.length}`,
-    }, null, 2));
-    return;
-  }
-
-  // Markdown
-  const sorted = (obj) => Object.entries(obj).sort((a, b) => b[1] - a[1]);
-
-  console.log('# Reporte de Validación en Campo — swl-ses');
-  console.log(`\n**Fecha**: ${new Date().toISOString().slice(0, 10)}`);
-  console.log(`**Sesiones analizadas**: ${totales.sesiones}`);
-  console.log(`**Proyectos**: ${totales.proyectos.size}`);
-  console.log(`**Tool calls totales**: ${totales.toolCalls}`);
-  console.log(`**Cobertura de skills**: ${skillsUsados.size}/${todosSkills.length} (${Math.round(skillsUsados.size / todosSkills.length * 100)}%)`);
-
-  console.log('\n## Skills más usados\n');
-  console.log('| Skill | Invocaciones |');
-  console.log('|-------|-------------|');
-  for (const [s, c] of sorted(totales.skills).slice(0, 30)) {
-    console.log(`| ${s} | ${c} |`);
-  }
-
-  console.log('\n## Comandos /swl:* más usados\n');
-  console.log('| Comando | Invocaciones |');
-  console.log('|---------|-------------|');
-  for (const [s, c] of sorted(totales.comandos).slice(0, 20)) {
-    console.log(`| ${s} | ${c} |`);
-  }
-
-  if (skillsNoUsados.length > 0) {
-    console.log('\n## Skills nunca usados (candidatos a evaluación)\n');
-    console.log('| Skill |');
-    console.log('|-------|');
-    for (const s of skillsNoUsados.sort()) {
-      console.log(`| ${s} |`);
-    }
-  }
-
-  console.log('\n---');
-  console.log(`\n> Generado por \`node scripts/field-report.js\``);
-}
-
-generarReporte();
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * field-report.js — Generador de reportes de validación en campo.
+ *
+ * Analiza sesiones JSONL de Claude Code para extraer métricas reales de uso
+ * de skills y agentes SWL en proyectos de usuario.
+ *
+ * Uso:
+ *   node scripts/field-report.js                    # Todas las sesiones
+ *   node scripts/field-report.js --days=30          # Últimos 30 días
+ *   node scripts/field-report.js --project=/path    # Proyecto específico
+ *   node scripts/field-report.js --output=json      # Salida JSON
+ *
+ * Métricas extraídas:
+ *   - Skills invocados (Skill("nombre"))
+ *   - Agentes delegados (Agent con description)
+ *   - Comandos /swl:* ejecutados
+ *   - Proyectos donde se usó swl-ses
+ *   - Frecuencia de uso por componente
+ *   - Skills nunca usados (candidatos a poda)
+ *
+ * @module scripts/field-report
+ */
+
+const fs   = require('fs');
+const path = require('path');
+const os   = require('os');
+
+// ── Argumentos ────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2).reduce((acc, arg) => {
+  const [k, v] = arg.replace(/^--/, '').split('=');
+  acc[k] = v || true;
+  return acc;
+}, {});
+
+const DAYS       = parseInt(args.days) || 0;
+const PROJECT    = args.project || null;
+const OUTPUT     = args.output || 'md';
+const CLAUDE_DIR = path.join(os.homedir(), '.claude', 'projects');
+
+// ── Explorar sesiones ─────────────────────────────────────────────────
+
+function buscarSesiones() {
+  const sesiones = [];
+  if (!fs.existsSync(CLAUDE_DIR)) {
+    console.error(`No se encontró ${CLAUDE_DIR}`);
+    return sesiones;
+  }
+
+  const proyectos = fs.readdirSync(CLAUDE_DIR).filter(d =>
+    fs.statSync(path.join(CLAUDE_DIR, d)).isDirectory()
+  );
+
+  for (const proy of proyectos) {
+    if (PROJECT && !proy.includes(PROJECT.replace(/[/\\:]/g, '-'))) continue;
+    const dir = path.join(CLAUDE_DIR, proy);
+    const archivos = fs.readdirSync(dir).filter(f => f.endsWith('.jsonl'));
+    for (const archivo of archivos) {
+      const ruta = path.join(dir, archivo);
+      const stat = fs.statSync(ruta);
+      if (DAYS > 0) {
+        const hace = Date.now() - DAYS * 86400000;
+        if (stat.mtimeMs < hace) continue;
+      }
+      sesiones.push({ proyecto: proy, ruta, fecha: stat.mtime });
+    }
+  }
+
+  return sesiones;
+}
+
+function analizarSesion(ruta) {
+  const stats = { skills: {}, agentes: {}, comandos: {}, toolCalls: 0 };
+  try {
+    const contenido = fs.readFileSync(ruta, 'utf8');
+    const lineas = contenido.split('\n').filter(Boolean);
+
+    for (const linea of lineas) {
+      try {
+        const entry = JSON.parse(linea);
+        const msg = entry.message || entry;
+
+        // Buscar Skill("nombre") en contenido
+        const texto = JSON.stringify(msg);
+        const skillMatches = texto.matchAll(/Skill\s*\(\s*["']([^"']+)["']\s*\)/g);
+        for (const m of skillMatches) {
+          stats.skills[m[1]] = (stats.skills[m[1]] || 0) + 1;
+        }
+
+        // Buscar agentes delegados
+        const agentMatches = texto.matchAll(/"description"\s*:\s*"([^"]*swl[^"]*)"/gi);
+        for (const m of agentMatches) {
+          const nombre = m[1].substring(0, 60);
+          stats.agentes[nombre] = (stats.agentes[nombre] || 0) + 1;
+        }
+
+        // Buscar comandos /swl:*
+        const cmdMatches = texto.matchAll(/\/swl:([a-z-]+)/g);
+        for (const m of cmdMatches) {
+          const cmd = `/swl:${m[1]}`;
+          stats.comandos[cmd] = (stats.comandos[cmd] || 0) + 1;
+        }
+
+        // Contar tool calls
+        if (msg.type === 'tool_use' || msg.tool_name) stats.toolCalls++;
+      } catch { /* línea JSONL inválida, ignorar */ }
+    }
+  } catch { /* archivo ilegible, ignorar */ }
+
+  return stats;
+}
+
+// ── Generar reporte ───────────────────────────────────────────────────
+
+function generarReporte() {
+  const sesiones = buscarSesiones();
+  if (sesiones.length === 0) {
+    console.log('No se encontraron sesiones para analizar.');
+    console.log(`Directorio buscado: ${CLAUDE_DIR}`);
+    return;
+  }
+
+  const totales = { skills: {}, agentes: {}, comandos: {}, sesiones: sesiones.length, proyectos: new Set(), toolCalls: 0 };
+
+  for (const sesion of sesiones) {
+    totales.proyectos.add(sesion.proyecto);
+    const stats = analizarSesion(sesion.ruta);
+    totales.toolCalls += stats.toolCalls;
+
+    for (const [k, v] of Object.entries(stats.skills))   totales.skills[k]   = (totales.skills[k] || 0) + v;
+    for (const [k, v] of Object.entries(stats.agentes))  totales.agentes[k]  = (totales.agentes[k] || 0) + v;
+    for (const [k, v] of Object.entries(stats.comandos)) totales.comandos[k] = (totales.comandos[k] || 0) + v;
+  }
+
+  // Cargar inventario de skills
+  const skillsDir = path.join(__dirname, '..', 'habilidades');
+  const todosSkills = fs.existsSync(skillsDir)
+    ? fs.readdirSync(skillsDir).filter(d => fs.statSync(path.join(skillsDir, d)).isDirectory())
+    : [];
+
+  const skillsUsados   = new Set(Object.keys(totales.skills));
+  const skillsNoUsados = todosSkills.filter(s => !skillsUsados.has(s));
+
+  if (OUTPUT === 'json') {
+    console.log(JSON.stringify({
+      fecha: new Date().toISOString(),
+      sesiones: totales.sesiones,
+      proyectos: [...totales.proyectos],
+      toolCalls: totales.toolCalls,
+      skills: Object.entries(totales.skills).sort((a, b) => b[1] - a[1]),
+      agentes: Object.entries(totales.agentes).sort((a, b) => b[1] - a[1]),
+      comandos: Object.entries(totales.comandos).sort((a, b) => b[1] - a[1]),
+      skillsNoUsados,
+      cobertura: `${skillsUsados.size}/${todosSkills.length}`,
+    }, null, 2));
+    return;
+  }
+
+  // Markdown
+  const sorted = (obj) => Object.entries(obj).sort((a, b) => b[1] - a[1]);
+
+  console.log('# Reporte de Validación en Campo — swl-ses');
+  console.log(`\n**Fecha**: ${new Date().toISOString().slice(0, 10)}`);
+  console.log(`**Sesiones analizadas**: ${totales.sesiones}`);
+  console.log(`**Proyectos**: ${totales.proyectos.size}`);
+  console.log(`**Tool calls totales**: ${totales.toolCalls}`);
+  console.log(`**Cobertura de skills**: ${skillsUsados.size}/${todosSkills.length} (${Math.round(skillsUsados.size / todosSkills.length * 100)}%)`);
+
+  console.log('\n## Skills más usados\n');
+  console.log('| Skill | Invocaciones |');
+  console.log('|-------|-------------|');
+  for (const [s, c] of sorted(totales.skills).slice(0, 30)) {
+    console.log(`| ${s} | ${c} |`);
+  }
+
+  console.log('\n## Comandos /swl:* más usados\n');
+  console.log('| Comando | Invocaciones |');
+  console.log('|---------|-------------|');
+  for (const [s, c] of sorted(totales.comandos).slice(0, 20)) {
+    console.log(`| ${s} | ${c} |`);
+  }
+
+  if (skillsNoUsados.length > 0) {
+    console.log('\n## Skills nunca usados (candidatos a evaluación)\n');
+    console.log('| Skill |');
+    console.log('|-------|');
+    for (const s of skillsNoUsados.sort()) {
+      console.log(`| ${s} |`);
+    }
+  }
+
+  console.log('\n---');
+  console.log(`\n> Generado por \`node scripts/field-report.js\``);
+}
+
+generarReporte();