@@ -31,6 +31,18 @@ __pycache__/
 # Se conserva localmente en docs/legado/ pero no se publica en GitHub.
 docs/legado/
 
+# PDFs de bibliografía académica (libros de texto con copyright) para
+# referencia del curso y el indexado RAG de TutorAgent. Se conservan
+# localmente, nunca se publican — mismo criterio que docs/legado/. El
+# README.md de la carpeta sí se versiona.
+bibliografia/*.pdf
+bibliografia/*.epub
+
+# Paquete de distribución de bibliografía (PDFs + índice ChromaDB
+# pre-generado) -- se genera localmente con
+# scripts/empaquetar_distribucion_bibliografia.py, nunca se publica.
+dist/
+
 # Worktrees locales para trabajo aislado (sandboxes de desarrollo)
 .worktrees/
 
 
@@ -0,0 +1,51 @@
+# Bibliografía
+
+## Qué va aquí
+
+Libros de texto de referencia para el curso. PDFs actualmente presentes en esta carpeta:
+
+- *Lógica de Programación* (Omar Iván Trejos Buriticá)
+- *Algoritmos Resueltos con Diagramas de Flujo y Pseudocódigo* (Francisco Javier Pinales Delgado, César Adolfo Serrano Escamilla)
+- *Numerical Python: Scientific Computing and Data Science Applications with NumPy, SciPy and Matplotlib*
+
+## Uso con `TutorAgent`
+
+`TutorAgent` indexa estos PDFs automáticamente en una colección ChromaDB
+separada (`bibliografia_curso`), distinta de la colección de lecciones
+(`lecciones_curso`). La indexación ocurre la primera vez que se instancia
+el agente (`bibliografia_collection.count() > 0` evita reprocesar en
+instancias siguientes) y usa `pdf_indexer.py` (extracción con `pypdf`,
+chunking por página).
+
+`_search_local_docs` combina 3 resultados de lecciones + 1 de bibliografía
+en cada consulta, para que el contexto pedagógico de las lecciones del
+curso nunca quede ahogado por el volumen de los libros completos.
+
+Un PDF escaneado (sin texto seleccionable) o corrupto se omite sin
+detener la indexación de los demás — se loguea como warning/error.
+
+## Pre-generar el índice (para distribuir a los alumnos)
+
+Indexar los PDFs desde cero puede tardar varios minutos. Para no obligar
+a cada alumno a esperar esa indexación la primera vez que usa `TutorAgent`,
+se puede pre-generar el índice y empaquetarlo:
+
+```bash
+# Indexa bibliografia/ en lecciones/.chroma (el índice de trabajo de este repo)
+python scripts/pregenerar_indice_bibliografia.py
+
+# Empaqueta bibliografia/*.pdf + un índice ChromaDB pre-generado en
+# dist/bibliografia_paquete.zip, listo para distribuir (Classroom, Drive, USB)
+python scripts/empaquetar_distribucion_bibliografia.py
+```
+
+El alumno solo necesita descomprimir `bibliografia_paquete.zip` dentro de
+la carpeta del curso (reemplazando/creando `bibliografia/` y `lecciones/.chroma`)
+para tener el índice ya construido, sin esperar la indexación.
+
+## Por qué está gitignored
+
+Los PDFs de libros de texto tienen copyright — mismo criterio que
+`docs/legado/` (material institucional): se conservan localmente para uso
+del curso, nunca se publican en el repo público. El `README.md` de esta
+carpeta sí se versiona.
@@ -0,0 +1,109 @@
+"""
+Empaqueta bibliografia/*.pdf + un índice ChromaDB pre-generado en un .zip
+listo para distribuir a los alumnos (evita que cada alumno tenga que
+reindexar los libros completos desde cero, proceso que puede tardar
+varios minutos).
+
+A diferencia de scripts/pregenerar_indice_bibliografia.py (que indexa
+sobre lecciones/.chroma, el índice de trabajo de este repo), este script
+construye el índice en dist/bibliografia_paquete/.chroma -- una ruta
+ASCII-safe dentro del repo, para que quede embebido en el paquete sin
+depender de rutas de esta máquina.
+
+Los PDFs tienen copyright y dist/ está en .gitignore: este script nunca
+publica nada en git, solo genera un artefacto local para distribuir por
+fuera (Drive, Classroom, USB).
+
+Uso: python scripts/empaquetar_distribucion_bibliografia.py
+"""
+
+import logging
+import shutil
+import sys
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+SCRIPTS_DIR = Path(__file__).resolve().parent
+if str(REPO_ROOT) not in sys.path:
+    sys.path.insert(0, str(REPO_ROOT))
+if str(SCRIPTS_DIR) not in sys.path:
+    sys.path.insert(0, str(SCRIPTS_DIR))
+
+from pregenerar_indice_bibliografia import BIBLIOGRAFIA_DIR
+from pregenerar_indice_bibliografia import main as indexar_bibliografia
+
+logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s")
+logger = logging.getLogger(__name__)
+
+DIST_DIR = REPO_ROOT / "dist"
+PAQUETE_DIR = DIST_DIR / "bibliografia_paquete"
+PAQUETE_CHROMA_PATH = PAQUETE_DIR / ".chroma"
+PAQUETE_BIBLIOGRAFIA_DIR = PAQUETE_DIR / "bibliografia"
+ZIP_BASENAME = DIST_DIR / "bibliografia_paquete"
+
+
+def _copiar_pdfs(origen: Path, destino: Path) -> int:
+    """Copia los PDFs de `origen` a `destino`, creando el directorio
+    destino si no existe. Devuelve cuántos PDFs se copiaron."""
+    destino.mkdir(parents=True, exist_ok=True)
+    pdfs = sorted(origen.glob("*.pdf"))
+    for pdf in pdfs:
+        shutil.copy2(pdf, destino / pdf.name)
+    return len(pdfs)
+
+
+def main() -> None:
+    if not BIBLIOGRAFIA_DIR.is_dir() or not list(BIBLIOGRAFIA_DIR.glob("*.pdf")):
+        logger.error("No hay PDFs en %s -- nada que empaquetar.", BIBLIOGRAFIA_DIR)
+        return
+
+    # Se limpia PAQUETE_DIR completo antes de reconstruirlo: si un PDF fue
+    # eliminado o renombrado en bibliografia/ desde el último empaquetado,
+    # su entrada vieja en el índice de una corrida anterior nunca se
+    # borraría por sí sola (el upsert solo actualiza/agrega, nunca
+    # elimina) y quedaría como contenido "fantasma" en el .zip distribuido
+    # sin que nada lo detecte. Es seguro borrar PAQUETE_DIR por completo:
+    # vive bajo dist/ (gitignored, artefacto desechable) y se reconstruye
+    # aquí mismo en cada corrida.
+    if PAQUETE_DIR.exists():
+        shutil.rmtree(PAQUETE_DIR)
+
+    logger.info("Copiando PDFs a %s ...", PAQUETE_BIBLIOGRAFIA_DIR)
+    n_copiados = _copiar_pdfs(BIBLIOGRAFIA_DIR, PAQUETE_BIBLIOGRAFIA_DIR)
+    logger.info("Copiados %d PDFs.", n_copiados)
+
+    logger.info(
+        "Construyendo índice ChromaDB en %s (esto puede tardar varios " "minutos)...",
+        PAQUETE_CHROMA_PATH,
+    )
+    pdfs_fallidos = indexar_bibliografia(
+        bibliografia_dir=PAQUETE_BIBLIOGRAFIA_DIR, chroma_path=PAQUETE_CHROMA_PATH
+    )
+    if pdfs_fallidos:
+        logger.error(
+            "Abortando empaquetado: %d PDF(s) no se pudieron indexar (%s). "
+            "El paquete distribuiría un índice incompleto sin que sea "
+            "evidente para el alumno. Vuelve a correr este script para "
+            "reintentar (upsert no duplica los PDFs ya indexados).",
+            len(pdfs_fallidos),
+            ", ".join(pdfs_fallidos),
+        )
+        return
+
+    logger.info("Comprimiendo paquete en %s.zip ...", ZIP_BASENAME)
+    ruta_zip = shutil.make_archive(
+        base_name=str(ZIP_BASENAME), format="zip", root_dir=str(PAQUETE_DIR)
+    )
+
+    tamano_mb = Path(ruta_zip).stat().st_size / (1024 * 1024)
+    logger.info(
+        "Paquete listo: %s (%.1f MB). Contiene bibliografia/*.pdf + .chroma "
+        "ya indexado -- los alumnos solo necesitan descomprimirlo dentro de "
+        "la carpeta del curso.",
+        ruta_zip,
+        tamano_mb,
+    )
+
+
+if __name__ == "__main__":
+    main()