Library Manager

Funcionalidades

1. Smart Ingest (Capa 1)

Mueve un archivo desde una ubicación temporal a la estructura estándar y lo registra en Notion.

FLUJO:
1. Recibir archivo + curso destino
2. Determinar ruta destino:
   → carrera/semestres/2026-1/cursos/{curso}/materiales/{tipo}/
3. Clasificar tipo de archivo:
   → PDF → materiales/lecturas/
   → PPT/PPTX → materiales/diapositivas/
   → DOCX → materiales/documentos/
   → Otro → materiales/otros/
4. Mover archivo a ruta destino
5. Registrar en Notion BD_RECURSOS:
   → Título: nombre del archivo
   → Curso: curso destino
   → Tipo: clasificación automática
   → Ruta_local: ruta completa
   → Capa: 1 (captura)
   → Fecha_ingreso: timestamp actual
6. Confirmar al usuario

Output esperado:

✅ Archivo guardado:
   📄 "01-Programación Lineal.pdf"
   📁 carrera/semestres/2026-1/cursos/inv_operativa/materiales/lecturas/
   📊 Registrado en BD_RECURSOS (Capa 1: Captura)

2. Progressive Summarization

Sistema de 4 capas incrementales para procesar materiales de estudio:

FLUJO PROGRESSIVE SUMMARIZATION:

INPUT:  Archivo + capa actual (consultada en BD_RECURSOS)

SI capa_actual == 1:
   → Leer archivo completo
   → Identificar ideas principales (máx 30% del texto)
   → Generar versión con **negritas** en conceptos clave
   → Actualizar BD_RECURSOS → capa: 2

SI capa_actual == 2:
   → Leer versión con negritas
   → De las negritas, resaltar solo lo esencial (máx 10% del texto)
   → Generar versión con ==resaltado== sobre las negritas
   → Actualizar BD_RECURSOS → capa: 3

SI capa_actual == 3:
   → Leer versión resaltada
   → Generar resumen ejecutivo (3-5 oraciones)
   → Generar 3-5 preguntas de Active Recall (Bloom nivel 3-4)
   → Guardar resumen en materiales/resumenes/{nombre}_resumen.md
   → Actualizar BD_RECURSOS → capa: 4

SI capa_actual == 4:
   → "Este material ya tiene resumen completo."
   → Ofrecer: "¿Quieres regenerar el resumen?"

3. Consulta de Recursos

FLUJO:
1. Recibir query (curso y/o tema)
2. Consultar BD_RECURSOS con filtros:
   → Por curso: filter[Curso] == curso
   → Por tema: search en título/tags
3. Formatear resultado como tabla
4. Mostrar capa actual de cada recurso

OUTPUT:
| # | Material | Tipo | Capa | Última Actualización |
|---|----------|------|:----:|---------------------|
| 1 | Programación Lineal.pdf | Lectura | 🟢 4/4 | 2026-02-20 |
| 2 | Método Simplex.pptx | Diapositiva | 🟡 2/4 | 2026-02-15 |
| 3 | Ejercicios Resueltos.pdf | Lectura | 🔴 1/4 | 2026-02-10 |

Manejo de Errores

Integración con Brain OS

Archivos de la Skill

skills/library-manager/
├── SKILL.md                    ← Este archivo
└── scripts/
    ├── ingest_file.py          ← Lógica de ingest y clasificación
    └── notion_adapter.py       ← Helper para queries a Notion BD_RECURSOS

🧪 Escenarios de Prueba

Test 1: Ingest básico

Input:    "Guarda 01-Lectura.pdf en Investigación Operativa"
Espera:   Archivo movido + registrado en Notion
Verifica: - Archivo en carrera/.../inv_operativa/materiales/lecturas/
          - Entrada en BD_RECURSOS con capa: 1
Output:   Confirmación con ruta + emoji de tipo

Test 2: Archivo duplicado

Input:    "Guarda 01-Lectura.pdf en IO" (ya existe)
Espera:   Detecta duplicado, pregunta al usuario
Verifica: NO sobrescribe sin confirmación
Output:   "⚠️ Ya existe. ¿Reemplazar, renombrar, o cancelar?"

Test 3: Progressive Summarization Capa 2→3

Input:    "Resume progresivamente 01-Lectura.pdf"
Espera:   Lee BD_RECURSOS → capa actual es 2 → genera Capa 3
Verifica: - Resaltado generado correctamente
          - BD_RECURSOS actualizado a capa: 3
Output:   Versión resaltada + nota de progreso

Test 4: Consulta de recursos

Input:    "¿Qué materiales tengo de Economía Ambiental?"
Espera:   Tabla con materiales filtrados por curso
Verifica: Tabla tiene columnas: Material, Tipo, Capa, Fecha
Output:   Tabla formateada con indicadores de capa (🟢/🟡/🔴)

Test 5: Modo offline

Input:    "Guarda archivo.pdf en IO" (sin conexión a Notion)
Espera:   Archivo se mueve correctamente, registro pendiente
Verifica: - Archivo en carpeta correcta
          - Log de "pendiente de sync" generado
Output:   "✅ Archivo guardado. ⚠️ Registro en Notion pendiente (sin conexión)"