luna-clasificador 1.2.0 → 1.2.2

package/BD/luna_db.json

@@ -1238,6 +1238,7 @@
         "contra el destino": { "nombreOficial": "Contra el Destino", "confianza": 1.0 },
         "destino": { "nombreOficial": "Destino", "confianza": 0.8 },
         "dueña de mi": { "nombreOficial": "Dueña de Mí", "confianza": 1.0 },
+        "dueñ de mi": { "nombreOficial": "Dueña de Mí", "confianza": 1.0 },
         "Dueñ De Mi": { "nombreOficial": "Dueña de Mí", "confianza": 1.0 },
         "el arbol de los secretos": { "nombreOficial": "El Árbol de los Secretos", "confianza": 1.0 },
         "el extraño en el espejo": { "nombreOficial": "El Extraño en el Espejo", "confianza": 1.0 },

package/LUNA_clasificador.js

@@ -14,7 +14,7 @@ const path = require('path');
 const { setBinariosFromFolder, procesarDuracionMediainfo } = require('./Servicios/ProcesosCore.js');
 const Clasificador = require('./Clasificacion.js');
 const { guardarLogDebug } = require('./Debug/LUNA_Logger.js');
-const VERSION_LUNA = '1.2.0';
+const VERSION_LUNA = '1.2.1';
 var seEjecuto = false;
 var seEjecutoIPC = false;
 
@@ -665,6 +665,24 @@ function normalizarClaveDB(nombre) {
         .toLowerCase();
 }
 
+function variantesClaveDB(nombre) {
+    const base = normalizarClaveDB(nombre);
+    if (!base) return [];
+
+    const variantes = new Set([base]);
+
+    // Variante útil para títulos con la 'a' faltante tras quitar tildes
+    // (ej. "Dueñ De Mi" -> "Duena De Mi")
+    const conA = base
+        .split(/\s+/)
+        .map(palabra => /^[a-z]+n$/i.test(palabra) ? palabra + 'a' : palabra)
+        .join(' ');
+
+    if (conA && conA !== base) variantes.add(conA);
+
+    return [...variantes];
+}
+
 // Busca un nombre en una categoria concreta.
 // Estrategia:
 //   1. aliases (global, fuera de categoria) -> nombre canonico
@@ -675,46 +693,48 @@ function buscarEnCategoriaDB(db, nombreLimpio, categoria) {
     const bucket = db.categorias[categoria];
     if (!bucket || !bucket.nombres) return null;
 
-    const claveOriginal = normalizarClaveDB(nombreLimpio);
-    if (!claveOriginal) return null;
-
-    // 1. Resolver aliases (pueden encadenarse, max 3 saltos)
-    let clave = claveOriginal;
-    if (db.aliases) {
-        for (let salto = 0; salto < 3; salto++) {
-            const destino = db.aliases[clave];
-            if (!destino) break;
-            const destinoNorm = normalizarClaveDB(destino);
-            if (!destinoNorm || destinoNorm === clave) break;
-            clave = destinoNorm;
+    const claves = variantesClaveDB(nombreLimpio);
+    if (!claves.length) return null;
+
+    for (const claveOriginal of claves) {
+        // 1. Resolver aliases (pueden encadenarse, max 3 saltos)
+        let clave = claveOriginal;
+        if (db.aliases) {
+            for (let salto = 0; salto < 3; salto++) {
+                const destino = db.aliases[clave] || Object.entries(db.aliases).find(([k]) => normalizarClaveDB(k) === clave)?.[1];
+                if (!destino) break;
+                const destinoNorm = normalizarClaveDB(destino);
+                if (!destinoNorm || destinoNorm === clave) break;
+                clave = destinoNorm;
+            }
         }
-    }
 
-    // 2. Match exacto
-    const entrada = bucket.nombres[clave];
-    if (entrada) {
-        return {
-            categoria,
-            nombreOficial: entrada.nombreOficial || clave,
-            confianza: entrada.confianza || 1.0,
-            viaAlias: clave !== claveOriginal
-        };
-    }
+        // 2. Match exacto por clave normalizada
+        for (const [keyCatalogo, entrada] of Object.entries(bucket.nombres)) {
+            const keyNorm = normalizarClaveDB(keyCatalogo);
+            if (keyNorm === clave) {
+                return {
+                    categoria,
+                    nombreOficial: entrada.nombreOficial || keyCatalogo,
+                    confianza: entrada.confianza || 1.0,
+                    viaAlias: clave !== claveOriginal
+                };
+            }
+        }
 
-    // 3. Match por prefijo (solo si el nombre empieza por una clave de la DB
-    //    seguida de espacio). Evita falsos positivos tipo "el" que matchearia
-    //    media DB.
-    for (const key of Object.keys(bucket.nombres)) {
-        if (key.length < 4) continue;
-        if (clave.startsWith(key + ' ')) {
-            const e = bucket.nombres[key];
-            return {
-                categoria,
-                nombreOficial: e.nombreOficial || key,
-                confianza: e.confianza || 1.0,
-                viaAlias: false,
-                viaPrefijo: true
-            };
+        // 3. Match por prefijo comparando versiones normalizadas
+        for (const [keyCatalogo, entrada] of Object.entries(bucket.nombres)) {
+            const keyNorm = normalizarClaveDB(keyCatalogo);
+            if (keyNorm.length < 4) continue;
+            if (clave.startsWith(keyNorm + ' ')) {
+                return {
+                    categoria,
+                    nombreOficial: entrada.nombreOficial || keyCatalogo,
+                    confianza: entrada.confianza || 1.0,
+                    viaAlias: false,
+                    viaPrefijo: true
+                };
+            }
         }
     }
 
@@ -784,22 +804,55 @@ function tomarDecision(paquete) {
             const pPeli  = (rep.pelicula && rep.pelicula.puntos) || 0;
             const pSerie = (rep.serie    && rep.serie.puntos)    || 0;
             let pVari  = (rep.variado  && rep.variado.puntos)  || 0;
-            let pPeliFinal = pPeli;
             let elegido = null;
 
-                        // === NUEVO: Chequeo de DB para VARIADO (350 puntos) ===
+            // === DB override primero: si el nombre limpio coincide con una categoria
+            // de la DB, gana esa categoria antes del desempate por puntuacion.
+            // Esto corrige casos como 'La Novia' / 'Dueña de Mi' que son novelas.
+            try {
+                const db = cargarDB();
+                if (db && archivo.info && archivo.info.nombreLimpio) {
+                    const prioridad = ['novela', 'programa', 'pelicula', 'variado'];
+                    for (const categoria of prioridad) {
+                        const matchDB = buscarEnCategoriaDB(db, archivo.info.nombreLimpio, categoria);
+                        if (!matchDB) continue;
+
+                        const mapa = {
+                            novela: 'esNOVELA',
+                            programa: 'esPROGRAM',
+                            pelicula: 'esPELI',
+                            variado: 'esVARIADO'
+                        };
+
+                        elegido = mapa[categoria];
+                        archivo.info.DBmetadata = {
+                            fuente: db.fuente || null,
+                            version: db.version || null,
+                            categoriaDB: categoria,
+                            nombreOficial: matchDB.nombreOficial,
+                            viaAlias: !!matchDB.viaAlias,
+                            viaPrefijo: !!matchDB.viaPrefijo
+                        };
+                        break;
+                    }
+                }
+            } catch (e) {
+                paquete.errores.push({
+                    etapa: 'tomarDecision.dbOverride',
+                    ruta: archivo.ruta,
+                    mensaje: e.message
+                });
+            }
+
+            // === NUEVO: Chequeo de DB para VARIADO (350 puntos) ===
             let esVariadoDB = false;
             try {
                 const db = cargarDB();
                 if (db && archivo.info && archivo.info.nombreLimpio) {
-                    // Usamos la misma función de búsqueda, pero en la categoría 'variado'
                     const matchDB = buscarEnCategoriaDB(db, archivo.info.nombreLimpio, 'variado');
                     if (matchDB) {
-                        // Si la DB dice que es variado, le damos 350 puntos.
-                        pVari += 350; 
+                        pVari += 350;
                         esVariadoDB = true;
-                        
-                        // Guardamos la metadata para que el usuario sepa por qué
                         archivo.info.DBmetadata = {
                             fuente: db.fuente || null,
                             version: db.version || null,
@@ -811,7 +864,6 @@ function tomarDecision(paquete) {
                     }
                 }
             } catch (e) {
-                // Si falla la DB, no rompemos el pipeline
                 paquete.errores.push({
                     etapa: 'tomarDecision.dbVariado',
                     ruta: archivo.ruta,
@@ -819,16 +871,15 @@ function tomarDecision(paquete) {
                 });
             }
 
-                        // === NUEVO: Chequeo de DB para PELICULA (350 puntos) ===
+            // === NUEVO: Chequeo de DB para PELICULA (350 puntos) ===
             let esPeliDB = false;
             try {
                 const db = cargarDB();
                 if (db && archivo.info && archivo.info.nombreLimpio) {
                     const matchDB = buscarEnCategoriaDB(db, archivo.info.nombreLimpio, 'pelicula');
                     if (matchDB) {
-                        pPeliFinal += 350; // <-- Le sumamos a la variable nueva
+                        pPeli += 350;
                         esPeliDB = true;
-                        
                         archivo.info.DBmetadata = {
                             fuente: db.fuente || null,
                             version: db.version || null,
@@ -847,10 +898,9 @@ function tomarDecision(paquete) {
                 });
             }
 
-
-            if (pPeli > pSerie && pPeli > pVari) elegido = 'esPELI';
-            else if (pSerie > pPeli && pSerie > pVari) elegido = 'esSERIE';
-            else if (pVari > pPeli && pVari > pSerie) elegido = 'esVARIADO';
+            if (elegido === null && pPeli > pSerie && pPeli > pVari) elegido = 'esPELI';
+            else if (elegido === null && pSerie > pPeli && pSerie > pVari) elegido = 'esSERIE';
+            else if (elegido === null && pVari > pPeli && pVari > pSerie) elegido = 'esVARIADO';
 
             // NUEVO: Si la DB lo marcó como variado, forzamos la decisión.
             if (esVariadoDB) {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "luna-clasificador",
-  "version": "1.2.0",
+  "version": "1.2.2",
+  "icon": "assets/icons.png",
   "description": "Clasificador local de archivos multimedia (película, serie, variado, programa, novela)",
   "main": "LUNA.js",
   "files": [
@@ -8,6 +9,9 @@
     "Clasificacion.js",
     "Debug/LUNA_Logger.js",
     "tests/probe_LUNA.js",
+    "tests/luna_dashboard_server.js",
+    "tests/luna_dashboard.html",
+    "assets/icons.png",
     "LUNA.js",
     "Servicios/ProcesosCore.js",
     "Servicios/ResolverPathffmpeg.js",
@@ -16,11 +20,20 @@
   "optionalDependencies": {
     "ffmpeg-static": "^5.3.0"
   },
+  "keywords": [
+    "clasificador",
+    "multimedia",
+    "peliculas",
+    "series",
+    "ffmpeg",
+    "nodejs",
+    "file-organizer",
+    "media-classifier"
+  ],
   "engines": {
     "node": ">=18"
   },
   "author": "Abraham de Jesús Piñirí Megret",
-  "keywords": ["multimedia", "clasificador", "video", "ffmpeg", "series", "peliculas"],
   "license": "MIT",
   "repository": {
     "type": "git",

package/readme.md

@@ -1,6 +1,14 @@
 
+<p align="center">
+  <img src="./assets/icons.png" width="120" alt="Logo del proyecto">
+</p>
+
 # 📘 README — Proyecto LUNA
 
+<!-- Banner -->
+<p align="center">
+  <img src="./assets/banner.png" width="100%">
+</p>
 > **Clasificador local de archivos multimedia** (película / serie / variado) con sistema de banderas puntuables, rescate por contexto de carpeta y reclasificación mediante base de datos de nombres conocidos.
 
 ---
@@ -25,12 +33,13 @@
 8. [Sistema de puntajes y decisión](#-sistema-de-puntajes-y-decisión)
 9. [Rescate y reclasificación](#-rescate-y-reclasificación)
 10. [API pública](#-api-pública)
-11. [Ejemplos de uso](#-ejemplos-de-uso)
+11. [Ejemplos reales de uso](#-ejemplos-reales-de-uso)
 12. [Instalación y dependencias](#-instalación-y-dependencias)
 13. [Cómo ejecutar el probe](#-cómo-ejecutar-el-probe)
-14. [Historial de fixes](#-historial-de-fixes)
-15. [Limitaciones conocidas](#-limitaciones-conocidas)
-16. [Autoría y licencia](#-autoría-y-licencia)
+14. [Novedades v1.2.1](#-novedades-en-v121)
+15. [Historial de fixes](#-historial-de-fixes)
+16. [Limitaciones conocidas](#-limitaciones-conocidas)
+17. [Autoría y licencia](#-autoría-y-licencia)
 
 ---
 
@@ -44,9 +53,28 @@
 - `esNOVELA` → telenovela
 - `esVARIADO` → video suelto, clip, personal, documental, deporte
 
-Además devuelve metadata enriquecida: **nombre limpio**, **temporada**, **capítulo**, **año**, **duración**, y **puntaje de confianza**.
+Además devuelve metadata enriquecida: **nombre limpio**, **temporada**, **capítulo**, **año**, **duración**, **fecha extra**, **tipo de archivo** y **puntaje de confianza**.
+
+Fue diseñado para ordenar discos duros llenos de series, películas, novelas y videos personales, respetando nombres "sucios" típicos de la piratería, releases, grabaciones de TV y nombres manuales de series extranjeras.
+
+> Versión actual del proyecto: **1.2.1**
+> Base de datos actual: **1.0.0**
+
+---
+
+## 🆕 Novedades en v1.2.1
+
+Esta versión deja el sistema mucho más estable y útil en escenarios reales:
 
-Fue diseñado para ordenar discos duros llenos de series, películas y videos personales, respetando nombres "sucios" típicos de la piratería, releases, grabaciones de TV, etc.
+- `infoDBMetadata()` cuenta correctamente el número total de registros de todas las categorías de `luna_db.json`.
+- El banner muestra una línea con `DB registros: X`.
+- El override de la DB ya se aplica antes del desempate, evitando que series/películas/novelas se queden en una categoría equivocada por heurísticas.
+- La comparación normalizada contra la DB corrige nombres con tildes, puntos, espacios y variantes como `Dueñ De Mi`, `La Novia`, etc.
+- La salida final expone `extension` y `tipoArchivo` de forma segura (`mkv`, `mp4`, `video`, `audio`).
+- Se mantiene compatibilidad con `archivo.info.extension`, `archivo.info.tipoArchivo` y la salida final.
+- La lógica de separación de título y nombre limpia siguió refinándose para evitar que capítulos y temporadas se queden pegados en `nombreLimpio`.
+
+---
 
 ---
 
@@ -61,6 +89,9 @@ Fue diseñado para ordenar discos duros llenos de series, películas y videos pe
 | **DB como último recurso**           | `luna_db.json` no suma puntos: solo reclasifica `esSERIE → esPROGRAM / esNOVELA` si el nombre coincide. |
 | **No romper con entradas inválidas** | `null`, `{}`, `123`, `[]` deben devolver error controlado, no lanzar excepción.                     |
 
+<p align="center">
+  <img src="./assets/1.png" width="100%">
+</p>
 ---
 
 ## 🏗 Arquitectura general
@@ -391,6 +422,10 @@ Usado por Cine, convertidor y el IPC del render para no cargar LUNA hasta que re
 - Si el JSON está corrupto, se resetea a `[]`.
 - Nunca lanza excepción hacia arriba.
 
+<p align="center">
+  <img src="./assets/2.png" width="100%">
+</p>
+
 **Estructura de cada registro:**
 
 ```js
@@ -674,60 +709,189 @@ Igual que `infoDBMetadata` + `versionLUNA`, `Creador`, `Comentario`.
 
 ---
 
-## 💡 Ejemplos de uso
+## 🧪 Ejemplos reales de uso
+
+A continuación te dejo ejemplos reales de cómo yo lo uso en proyectos de Node y Electron. Están pensados para que veas exactamente qué entra y qué sale.
 
-### Uso básico
+### 1) Uso básico en Node.js
 
 ```js
-const { LUNA } = require('./LUNA_clasificador');
+const { getLUNA } = require('luna-clasificador');
+const LUNA = getLUNA();
 
 (async () => {
-  const res = await LUNA('D:\\ANIME\\Silo [Temp 1]\\Silo - S01E03.mkv');
-  console.log(res.salida.esCC);              // 'esSERIE'
-  console.log(res.salida.info.nombreLimpio); // 'Silo'
-  console.log(res.salida.info.temporada);    // 1
-  console.log(res.salida.info.capituloNumero);// 3
+  const resultado = await LUNA.LUNA('D:\\ANIME\\La Novia - 107 [15-10-2026].mp4');
+
+  console.log(resultado.exito);
+  console.log(resultado.salida.esCC);            // esNOVELA
+  console.log(resultado.salida.nombreLimpio);   // La Novia
+  console.log(resultado.salida.info.serie);     // La Novia
+  console.log(resultado.salida.info.capituloNumero); // 107
+  console.log(resultado.salida.extension);       // mp4
+  console.log(resultado.salida.tipoArchivo);     // video
 })();
 ```
 
-### Uso por lotes
+### 2) Uso con `getFFmpegPath()` y configurando la ruta del binario
+
+Este es un patrón real que uso cuando el proyecto ya tiene ffmpeg en una ubicación custom.
 
 ```js
-const rutas = [
-  'D:\\Pelis\\Superman (2025).mkv',
-  'D:\\Novelas\\Ciudad Lejana 137.mp4',
-  'D:\\Varios\\VID_20240101.mp4'
-];
-const res = await LUNA(rutas);
-res.salida.forEach(s => console.log(s.esCC, s.nombreLimpio));
-// esPELI    Superman
-// esNOVELA  Ciudad Lejana
-// esVARIADO VID 20240101
+const path = require('path');
+const { getLUNA } = require('luna-clasificador');
+const { getFFmpegPath } = require('./ResolverPathFFmpeg.js');
+
+const LUNA = getLUNA();
+const ffmpegExe = getFFmpegPath();
+const carpeta = path.dirname(ffmpegExe) + path.sep;
+
+LUNA.setBinariosFromFolder(carpeta);
+
+(async () => {
+  const res = await LUNA.LUNA('D:\\ANIME\\Peliculas\\John Wick 4.mkv');
+  console.log(JSON.stringify(res, null, 2));
+})();
 ```
 
-### Con singleton
+### 3) Uso clásico en una app Node / backend
 
 ```js
-const { getLUNA } = require('./luna_enchufle');
-const LUNA = getLUNA();
-const res = await LUNA.LUNA('D:\\archivo.mp4');
+const { getLUNA, LUNA_PATH } = require('luna-clasificador');
+const {
+  LUNA,
+  reclasificarDesdeDB,
+  cargarDB,
+  infoDBMetadata
+} = getLUNA();
+
+const ffmpegExe = getFFmpegPath();
+const carpeta = path.dirname(ffmpegExe) + path.sep;
+LUNA.setBinariosFromFolder(carpeta);
+
+(async () => {
+  const meta = infoDBMetadata();
+  console.log('DB:', meta);
+
+  const salida = await LUNA('D:\\ANIME\\Thunder 3 [Temp 1] [2026] [Caps 12]\\Dueña de Mi - 139 [16-10-2026].mp4');
+  console.log(salida.salida.esCC); // esNOVELA
+  console.log(salida.salida.info.DBmetadata);
+})();
 ```
 
-### Solo clasificación (sin duración)
+### 4) Uso en Electron / proceso principal (`main`)
 
 ```js
-const Clasificacion = require('./Clasificacion');
+const path = require('path');
+const { ipcMain } = require('electron');
+const { getLUNA } = require('luna-clasificador');
+const { getFFmpegPath } = require('./ResolverPathFFmpeg.js');
+
+const LUNA = getLUNA();
+let lunaInicializado = false;
+
+ipcMain.handle('luna:clasificar', async (event, entrada) => {
+  try {
+    if (!lunaInicializado) {
+      const ffmpegExe = getFFmpegPath();
+      const carpeta = path.dirname(ffmpegExe) + path.sep;
+      LUNA.setBinariosFromFolder(carpeta);
+      lunaInicializado = true;
+      await new Promise(resolve => setTimeout(resolve, 500));
+    }
 
-const reporte = await Clasificacion.clasificarArchivo({
-  nombreOriginal: 'Silo - S01E03.mkv',
-  ruta: 'D:\\Series\\Silo\\S01E03.mkv',
-  duracion: 2700
+    if (entrada === 'info') {
+      return await LUNA.LUNAVersion();
+    }
+
+    return await LUNA.LUNA(entrada);
+  } catch (error) {
+    console.error('[LUNA:IPC] Error:', error);
+    return {
+      exito: false,
+      salida: null,
+      errores: [{ etapa: 'ipc', mensaje: error.message }]
+    };
+  }
 });
+```
+
+### 5) Uso real de ejemplo de mi app con cache de versión
+
+```js
+const { getLUNA, LUNA_PATH } = require('luna-clasificador');
+
+const LUNA = getLUNA();
+
+const ffmpegExe = getFFmpegPath();
+const carpeta = path.dirname(ffmpegExe) + path.sep;
+LUNA.setBinariosFromFolder(carpeta);
+
+let _lunaVersion = null;
+function obtenerVersionLUNA() {
+  if (_lunaVersion !== null) return _lunaVersion;
+
+  try {
+    if (typeof LUNA.LUNAVersion === 'function') {
+      const v = LUNA.LUNAVersion();
+      _lunaVersion = (v && typeof v === 'object') ? (v.versionLUNA || null) : (typeof v === 'string' ? v : null);
+    }
+
+    if (!_lunaVersion) {
+      const meta = typeof LUNA.infoDBMetadata === 'function' ? LUNA.infoDBMetadata() : null;
+      if (meta && meta.versionLUNA) _lunaVersion = meta.versionLUNA;
+    }
+  } catch (e) {
+    console.warn('[CINE] No se pudo obtener la versión de LUNA:', e.message);
+  }
 
-console.log(reporte.serie.puntos);            // ej. 130
-console.log(reporte.serie.banderasQueSumaron); // [{ nombre: 'serie_sxxexx', puntos: 50, ... }, ...]
+  if (!_lunaVersion) _lunaVersion = 'unknown';
+  return _lunaVersion;
+}
 ```
 
+### 6) Qué devuelve LUNA
+
+La salida típica es este formato:
+
+```js
+{
+  exito: true,
+  salida: {
+    nombreOriginal: 'La Novia - 107 [15-10-2026].mp4',
+    nombreLimpio: 'La Novia',
+    tituloLimpio: null,
+    fechaExtra: '15-10-2026',
+    ruta: 'D:\\ANIME\\Thunder 3 [Temp 1] [2026] [Caps 12]\\La Novia - 107 [15-10-2026].mp4',
+    info: {
+      nombreLimpio: 'La Novia',
+      serie: 'La Novia',
+      temporada: 1,
+      capituloNumero: 107,
+      anio: null,
+      extension: 'mp4',
+      tipoArchivo: 'video',
+      categoriaGanadora: 'serie',
+      DBmetadata: {
+        categoriaDB: 'novela',
+        nombreOficial: 'La Novia'
+      }
+    },
+    extension: 'mp4',
+    tipoArchivo: 'video',
+    duracion: 1447.26,
+    esCC: 'esNOVELA'
+  },
+  errores: [],
+  meta: {
+    inicio: 172..., 
+    fin: 172..., 
+    duracionMs: 120
+  }
+}
+```
+
+> LUNA acepta `string`, `objeto de configuración`, `array de strings` y `array de configuraciones`. Siempre devuelve un objeto con `exito`, `salida` y `errores`.
+
 ---
 
 ## 📦 Instalación y dependencias
@@ -821,6 +985,10 @@ Exatlon Mexico [T10] - [TX] [037].mp4               | esPROGRAM| 2530       | tr
 
 ---
 
+<p align="center">
+  <img src="./assets/3.png" width="100%">
+</p>
+
 ## ⚠️ Limitaciones conocidas
 
 1. **`ProcesosCore.js` tiene un `setTimeout` de prueba** que ejecuta ffmpeg sobre un archivo hardcodeado. **Eliminar en producción.**
@@ -841,7 +1009,7 @@ Exatlon Mexico [T10] - [TX] [037].mp4               | esPROGRAM| 2530       | tr
 - **Autor:** Abraham de Jesús Piñirí Megret
 - **Agradecimientos:** DeepSeek
 - **Licencia:** MIT
-- **Versión LUNA:** `1.0.0`
+- **Versión LUNA:** `1.2.1`
 - **Versión DB:** `1.0.0`
 - **Fecha DB:** `2026-10-19`
 
@@ -868,6 +1036,8 @@ Exatlon Mexico [T10] - [TX] [037].mp4               | esPROGRAM| 2530       | tr
 
 Esta versión trae mejoras importantes en cómo LUNA limpia y estructura los nombres de los archivos, separando la información de la obra de la información del capítulo.
 
+> Si estás leyendo esto desde el README actual, ten en cuenta que la versión activa del proyecto es 1.2.1. La sección de v1.1.0 queda como referencia histórica del proyecto, no como versión actual.
+
 ### 1. Nuevo campo `tituloLimpio`
 Ahora LUNA es capaz de separar el nombre base (serie o película) de su título de capítulo/saga, usando el guion espaciado (` - `) como separador universal.
 

package/tests/luna_dashboard.html

@@ -0,0 +1,175 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>LUNA · Análisis</title>
+  <style>
+    :root {
+      --bg: #f8fafc;
+      --surface: #ffffff;
+      --text: #0f172a;
+      --muted: #64748b;
+      --accent: #3b82f6;
+      --border: #e2e8f0;
+      --success: #10b981;
+      --warning: #f59e0b;
+      --danger: #ef4444;
+    }
+    * { box-sizing: border-box; margin: 0; }
+    body { font-family: 'Inter', system-ui, sans-serif; background: var(--bg); color: var(--text); padding: 40px 20px; }
+    .app { max-width: 1200px; margin: 0 auto; }
+
+    /* Header & Inputs */
+    .header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 32px; }
+    .brand h1 { font-size: 1.8rem; font-weight: 800; }
+    .brand p { color: var(--muted); font-size: 0.9rem; }
+    
+    .controls { background: var(--surface); padding: 24px; border-radius: 16px; border: 1px solid var(--border); margin-bottom: 32px; }
+    .input-row { display: flex; gap: 12px; margin-bottom: 12px; }
+    .input-row input { flex: 1; padding: 12px; border: 1px solid var(--border); border-radius: 8px; }
+    .btn { padding: 10px 20px; border: none; border-radius: 8px; font-weight: 600; cursor: pointer; }
+    .btn-primary { background: var(--accent); color: white; }
+    .btn-secondary { background: #f1f5f9; color: var(--text); }
+
+    /* Grid & Cards */
+    .grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 20px; }
+    .card { 
+      background: var(--surface); border-radius: 16px; border: 1px solid var(--border); 
+      padding: 20px; display: flex; flex-direction: column; gap: 16px;
+      box-shadow: 0 4px 6px -1px rgb(0 0 0 / 0.05);
+    }
+    .card-header { display: flex; flex-direction: column; gap: 4px; }
+    .card-cat { font-size: 0.75rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.05em; color: var(--accent); }
+    .card-title { font-size: 1.2rem; font-weight: 700; line-height: 1.3; }
+    .card-subtitle { font-size: 0.9rem; color: var(--muted); font-weight: 500; }
+    
+    .card-body { display: flex; flex-wrap: wrap; gap: 12px; border-top: 1px solid var(--border); padding-top: 16px; }
+    .data-item { display: flex; flex-direction: column; gap: 2px; }
+    .data-label { font-size: 0.7rem; font-weight: 600; color: var(--muted); text-transform: uppercase; }
+    .data-value { font-size: 0.9rem; font-weight: 500; }
+    
+    .card-footer { font-size: 0.75rem; color: var(--muted); background: #f8fafc; padding: 8px; border-radius: 6px; word-break: break-all; margin-top: auto; }
+
+    .badge { padding: 4px 8px; border-radius: 6px; font-size: 0.7rem; font-weight: 700; }
+    .badge.ok { background: #d1fae5; color: #065f46; }
+    .badge.warn { background: #fef3c7; color: #92400e; }
+    .badge.err { background: #fee2e2; color: #991b1b; }
+  </style>
+</head>
+<body>
+  <div class="app">
+    <div class="header">
+      <div class="brand">
+        <h1>LUNA</h1>
+        <p>Clasificador inteligente de archivos</p>
+      </div>
+      <button class="btn btn-primary" id="runBtn">Ejecutar 20 casos</button>
+    </div>
+
+    <div class="controls">
+      <div id="customInputs"></div>
+      <div style="display:flex; gap:12px; margin-top:12px;">
+        <button class="btn btn-secondary" id="addRowBtn">+ Añadir ruta</button>
+        <button class="btn btn-primary" id="runCustomBtn">Analizar rutas</button>
+      </div>
+    </div>
+
+    <div class="grid" id="resultsGrid">
+      <div style="grid-column: 1/-1; text-align:center; color:var(--muted);">Esperando análisis...</div>
+    </div>
+  </div>
+
+  <script>
+    const resultsGrid = document.getElementById('resultsGrid');
+    const customInputs = document.getElementById('customInputs');
+
+    // --- Renderizado de Tarjeta ---
+    function renderCard(item) {
+      const badge = item.estado === 'ok' ? 'ok' : item.estado === 'warning' ? 'warn' : 'err';
+      const badgeText = item.estado === 'ok' ? 'OK' : item.estado === 'warning' ? 'Aviso' : 'Error';
+      
+      // Construir HTML de detalles (solo si hay datos)
+      let detallesHtml = '';
+      if (item.detalles && item.detalles.length > 0) {
+        detallesHtml = item.detalles.map(d => `
+          <div class="data-item">
+            <span class="data-label">${d.etiqueta}</span>
+            <span class="data-value">${d.valor}</span>
+          </div>
+        `).join('');
+      }
+
+      // Subtítulo opcional
+      const subtituloHtml = item.subtitulo ? `<div class="card-subtitle">${item.subtitulo}</div>` : '';
+      
+      // Título (si es null, usamos el nombre del archivo)
+      const titulo = item.titulo || 'Archivo sin nombre claro';
+
+      return `
+        <div class="card">
+          <div class="card-header">
+            <div style="display:flex; justify-content:space-between;">
+              <span class="card-cat">${item.categoriaHumana || 'Desconocido'}</span>
+              <span class="badge ${badge}">${badgeText}</span>
+            </div>
+            <div class="card-title">${titulo}</div>
+            ${subtituloHtml}
+          </div>
+          
+          ${detallesHtml ? `<div class="card-body">${detallesHtml}</div>` : ''}
+          
+          <div class="card-footer">${item.ruta}</div>
+          ${item.error ? `<div style="color:var(--danger); font-size:0.8rem; margin-top:8px;">${item.error}</div>` : ''}
+        </div>
+      `;
+    }
+
+    // --- Lógica de la UI ---
+    async function runSuite() {
+      resultsGrid.innerHTML = '<div style="grid-column:1/-1; text-align:center;">Analizando...</div>';
+      try {
+        const res = await fetch('/api/run');
+        const data = await res.json();
+        if (!data.resultados) throw new Error('Sin datos');
+        resultsGrid.innerHTML = data.resultados.map(renderCard).join('');
+      } catch (e) {
+        resultsGrid.innerHTML = `<div style="color:var(--danger);">Error: ${e.message}</div>`;
+      }
+    }
+
+    async function runCustom() {
+      const inputs = customInputs.querySelectorAll('input');
+      const casos = Array.from(inputs).map(i => ({ ruta: i.value.trim() })).filter(c => c.ruta);
+      if (casos.length === 0) return alert('Añade alguna ruta');
+
+      resultsGrid.innerHTML = '<div style="grid-column:1/-1; text-align:center;">Analizando...</div>';
+      try {
+        const res = await fetch('/api/run-custom', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ casos })
+        });
+        const data = await res.json();
+        if (!data.resultados) throw new Error('Sin datos');
+        resultsGrid.innerHTML = data.resultados.map(renderCard).join('');
+      } catch (e) {
+        resultsGrid.innerHTML = `<div style="color:var(--danger);">Error: ${e.message}</div>`;
+      }
+    }
+
+    // --- Inputs Dinámicos ---
+    function addInput() {
+      const div = document.createElement('div');
+      div.className = 'input-row';
+      div.innerHTML = `<input type="text" placeholder="Ej: D:\\SERIES\\Silo\\Silo - 204.mkv"><button class="btn btn-secondary" onclick="this.parentElement.remove()">×</button>`;
+      customInputs.appendChild(div);
+    }
+
+    addInput(); addInput(); addInput();
+    document.getElementById('addRowBtn').onclick = addInput;
+    document.getElementById('runBtn').onclick = runSuite;
+    document.getElementById('runCustomBtn').onclick = runCustom;
+  </script>
+</body>
+</html>

package/tests/luna_dashboard_server.js

@@ -0,0 +1,292 @@
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const { getFFmpegPath } = require('../Servicios/ResolverPathffmpeg.js');
+const LUNA = require('../LUNA_clasificador.js');
+
+const PORT = 3466;
+const HTML_PATH = path.join(__dirname, 'luna_dashboard.html');
+
+//http://localhost:3466/
+
+// Solo id + ruta. El nombre se deriva del nombre de archivo.
+function getRandomizedCases() {
+  const rutas = [
+    'D:\\ANIME\\Thunder 3 [Temp 1] [2026] [Caps 12]\\La Novia - 107 [15-10-2026] [Corregido].mp4',
+    'D:\\ANIME\\Thunder 3 [Temp 1] [2026] [Caps 12]\\Dueña de Mi - 139 [16-10-2026].mp4',
+    'D:\\ANIME\\Peliculas\\John Wick 4.mkv',
+    'D:\\ANIME\\Peliculas\\Harry Potter La Piedra Filosofal.mkv',
+    'D:\\ANIME\\Code Geass 2\\[D-SnF] Code Geass - Lelouch of the Rebellion R2 - 11 [BD 1080p].mkv',
+    'D:\\TV\\The Bear\\The Bear - S02E07.mkv',
+    'D:\\SERIES\\Silo\\Season 2\\Silo - 204.mkv',
+    'D:\\PROGRAMAS\\MasterChef\\MasterChef - 008 [HD].mp4',
+    'D:\\PERSONAL\\VID_20240101_214500.mp4',
+    'D:\\VIDEOS\\clip_demo.mp4',
+    'D:\\SERIES\\One Piece\\One Piece - 1034.mp4',
+    'D:\\ANIME\\Shingeki no Kyojin\\Shingeki no Kyojin - 012 [1080p].mkv',
+    'D:\\SHOWS\\La Voz\\La Voz - 010 [TV].mp4',
+    'D:\\PELICULAS\\Dune Part Two (2024).mkv',
+    'D:\\NOVELAS\\La Promesa 18.mp4',
+    'D:\\MISC\\sample_01.mp4',
+    'D:\\SECCION CUBA\\Novelas\\La Vida Que Me Robaste 21.mp4',
+    'D:\\FOTOS\\WhatsApp Video 2024-10-10 at 20.00.00.mp4',
+    'D:\\Anime\\Blue Lock\\Blue Lock - S01E03 [Sub].mkv',
+    'D:\\Cine\\The Batman [4K UHD] [2022].mkv'
+  ];
+
+  return rutas
+    .map((ruta, i) => ({ id: `case-${String(i + 1).padStart(2, '0')}`, ruta }))
+    .sort(() => Math.random() - 0.5)
+    .slice(0, 20);
+}
+
+function nombreDesdeRuta(ruta) {
+  if (!ruta) return '—';
+  const base = ruta.split(/[\\/]/).pop() || ruta;
+  return base.replace(/\.[^.]+$/, '');
+}
+
+// Normaliza la salida de LUNA a un objeto plano y consistente.
+// No inventa datos: solo propaga lo que LUNA devuelve.
+function serializeResult(item, data) {
+  const base = {
+    id: item.id,
+    ruta: item.ruta,
+    estado: 'ok',
+    titulo: null,
+    subtitulo: null,
+    categoriaHumana: null,
+    detalles: [], // Solo datos reales
+    error: null
+  };
+
+  if (!data || !data.salida) {
+    base.estado = 'error';
+    base.error = 'No hubo salida de LUNA';
+    return base;
+  }
+
+  const s = data.salida || {};
+  const info = s.info || {};
+
+  // Traducir la categoría técnica a lenguaje humano
+  const catMap = {
+    'esPELI': 'Película',
+    'esSERIE': 'Serie',
+    'esPROGRAM': 'Programa',
+    'esNOVELA': 'Novela',
+    'esVARIADO': 'Variado'
+  };
+  base.categoriaHumana = catMap[s.esCC] || null;
+
+  // El título principal: nombreLimpio (ej: "La Vida Que Me Robaste")
+  base.titulo = s.nombreLimpio || info.nombreLimpio || null;
+
+  // El subtítulo: Puede ser el título del episodio O la temporada/capítulo
+  let subParts = [];
+  if (info.tituloLimpio) subParts.push(info.tituloLimpio); // Ej: "Lelouch of the Rebellion"
+  
+  if (info.temporada) subParts.push(`Temporada ${info.temporada}`);
+  if (info.capituloNumero) subParts.push(`Capítulo ${info.capituloNumero}`);
+  
+  if (subParts.length > 0) {
+    base.subtitulo = subParts.join(' · ');
+  }
+
+  // Detalles: Solo lo que existe y es útil
+  if (info.serie) base.detalles.push({ etiqueta: 'Serie', valor: info.serie });
+  if (info.anio) base.detalles.push({ etiqueta: 'Año', valor: info.anio });
+  if (s.fechaExtra) base.detalles.push({ etiqueta: 'Fecha', valor: s.fechaExtra });
+  
+  if (s.duracion && s.duracion > 0) {
+    const mins = Math.floor(s.duracion / 60);
+    base.detalles.push({ etiqueta: 'Duración', valor: `${mins} min` });
+  }
+  
+  if (s.extension) base.detalles.push({ etiqueta: 'Formato', valor: s.extension.toUpperCase() });
+  if (s.esCC === 'esSERIE' || s.esCC === 'esNOVELA') {
+     if (info.DBmetadata && info.DBmetadata.nombreOficial) {
+         base.detalles.push({ etiqueta: 'Nombre Oficial', valor: info.DBmetadata.nombreOficial });
+     }
+  }
+
+  if (data.errores && data.errores.length) {
+    base.estado = 'warning';
+    base.error = data.errores[0].mensaje || 'Hay errores';
+  }
+
+  return base;
+}
+
+async function ejecutarCasos(casos) {
+  const resultados = [];
+
+  for (const caso of casos) {
+    try {
+      const resultado = await LUNA.LUNA(caso.ruta);
+      resultados.push(serializeResult(caso, resultado));
+    } catch (error) {
+      resultados.push({
+        id: caso.id,
+        ruta: caso.ruta,
+        estado: 'error',
+        categoria: null,
+        esCC: null,
+        nombreLimpio: null,
+        extension: null,
+        tipoArchivo: null,
+        duracion: null,
+        fechaExtra: null,
+        serie: null,
+        temporada: null,
+        capitulo: null,
+        pelicula: null,
+        programa: null,
+        novela: null,
+        error: error.message || 'Error desconocido'
+      });
+    }
+  }
+
+  return {
+    ejecutado: new Date().toISOString(),
+    total: resultados.length,
+    ok: resultados.filter(r => r.estado === 'ok').length,
+    warning: resultados.filter(r => r.estado === 'warning').length,
+    error: resultados.filter(r => r.estado === 'error').length,
+    resultados
+  };
+}
+
+async function ejecutarSuite() {
+  return ejecutarCasos(getRandomizedCases());
+}
+
+// ---------------------------------------------------------------
+// FFmpeg: se intenta cargar, pero si falla LUNA sigue funcionando
+// por nombre (sin duración). No se lanza excepción hacia arriba.
+// ---------------------------------------------------------------
+function configurarFFmpeg() {
+  try {
+    //const ffmpegExe = getFFmpegPath();
+    //const carpeta = path.dirname(ffmpegExe) + path.sep;
+    LUNA.setBinariosFromFolder('D:\\NAtifevierddd\\ffmpeg-static');
+    console.log('[dashboard] FFmpeg configurado correctamente.');
+    return true;
+  } catch (e) {
+    console.warn('[dashboard] FFmpeg no disponible, LUNA seguirá funcionando por nombre:', e.message);
+    return false;
+  }
+}
+
+configurarFFmpeg();
+
+function leerBodyJSON(req) {
+  return new Promise((resolve, reject) => {
+    let body = '';
+    req.on('data', chunk => {
+      body += chunk;
+      if (body.length > 1e6) {
+        reject(new Error('Cuerpo demasiado grande'));
+        req.destroy();
+      }
+    });
+    req.on('end', () => {
+      if (!body) return resolve({});
+      try { resolve(JSON.parse(body)); }
+      catch (e) { reject(new Error('JSON inválido')); }
+    });
+    req.on('error', reject);
+  });
+}
+
+const server = http.createServer(async (req, res) => {
+  const url = new URL(req.url, 'http://localhost');
+
+  // ---- Suite de 20 casos fijos ----
+  if (req.method === 'GET' && url.pathname === '/api/run') {
+    try {
+      const payload = await ejecutarSuite();
+      res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' });
+      res.end(JSON.stringify(payload));
+    } catch (error) {
+      res.writeHead(500, { 'Content-Type': 'application/json; charset=utf-8' });
+      res.end(JSON.stringify({ error: error.message }));
+    }
+    return;
+  }
+
+  // ---- Casos personalizados desde el HTML (POST) ----
+  if (req.method === 'POST' && url.pathname === '/api/run-custom') {
+    try {
+      const body = await leerBodyJSON(req);
+      const casos = Array.isArray(body.casos) ? body.casos : [];
+
+      const limpios = casos
+        .map((c, i) => {
+          const ruta = typeof c?.ruta === 'string' ? c.ruta.trim() : '';
+          if (!ruta) return null;
+          return { id: `custom-${i + 1}`, ruta };
+        })
+        .filter(Boolean);
+
+      if (limpios.length === 0) {
+        res.writeHead(400, { 'Content-Type': 'application/json; charset=utf-8' });
+        res.end(JSON.stringify({ error: 'No se recibieron rutas válidas.' }));
+        return;
+      }
+
+      const payload = await ejecutarCasos(limpios);
+      res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' });
+      res.end(JSON.stringify(payload));
+    } catch (error) {
+      res.writeHead(400, { 'Content-Type': 'application/json; charset=utf-8' });
+      res.end(JSON.stringify({ error: error.message }));
+    }
+    return;
+  }
+
+  // ---- Metadata de la DB ----
+  if (req.method === 'GET' && url.pathname === '/api/meta') {
+    try {
+      const meta = typeof LUNA.infoDBMetadata === 'function' ? LUNA.infoDBMetadata() : null;
+      res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+      res.end(JSON.stringify({ ok: true, meta }));
+    } catch (error) {
+      res.writeHead(500, { 'Content-Type': 'application/json; charset=utf-8' });
+      res.end(JSON.stringify({ ok: false, error: error.message }));
+    }
+    return;
+  }
+
+  // ---- Health ----
+  if (req.method === 'GET' && url.pathname === '/health') {
+    res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+    res.end(JSON.stringify({ ok: true, service: 'luna-dashboard', port: PORT }));
+    return;
+  }
+
+  // ---- HTML ----
+  if (req.method === 'GET') {
+    fs.readFile(HTML_PATH, 'utf8', (err, html) => {
+      if (err) {
+        res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
+        res.end('No se pudo cargar la vista HTML.');
+        return;
+      }
+      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+      res.end(html);
+    });
+    return;
+  }
+
+  res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
+  res.end('404');
+});
+
+server.listen(PORT, () => {
+  console.log(`\n====================================================`);
+  console.log(`LUNA dashboard activo en: http://localhost:${PORT}`);
+  console.log(`Prueba visual en: http://localhost:${PORT}`);
+  console.log(`====================================================\n`);
+});