@josetra/dutic-mcp 0.1.0

package/dist/mcp/server.js

@@ -0,0 +1,261 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { ensureSession, withSession } from "../core/auth.js";
+import { SessionExpiredError } from "../core/errors.js";
+import { getSemester } from "../core/config.js";
+import { isExpired, isValid, loadSession } from "../core/session.js";
+import { getEnrolledCourses, getCourseContents } from "../domain/courses.js";
+import { getAllTasks, getCourseTasks, getUpcomingTasks } from "../domain/tasks.js";
+import { downloadFile, listCourseFiles, listCourseMaterials, pullCourseFiles, } from "../domain/resources.js";
+import { convertLocalPdfToMarkdown, readResourceAsMarkdown, studyCourseMaterials, } from "../domain/documents.js";
+import { getAllGrades, getCourseGrades, } from "../domain/grades.js";
+import { getAssignDetail } from "../domain/assign.js";
+import { findPeople, getCourseTeachers, getPersonProfile, listCourseParticipants, } from "../domain/people.js";
+/**
+ * En contexto MCP la renovación de sesión es "headless-only": si el SSO de Google sigue
+ * vivo en el perfil persistente, renueva sola; si no, devuelve un error que le pide al
+ * usuario correr `dutic login` en una terminal (donde sí puede abrirse el navegador).
+ */
+const MCP_MODE = "headless-only";
+const server = new McpServer({ name: "dutic-mcp", version: "0.1.0" });
+/** Envuelve un handler traduciendo SessionExpiredError a un mensaje accionable. */
+async function tool(fn) {
+    try {
+        const data = await fn();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+    catch (err) {
+        if (err instanceof SessionExpiredError) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: "Sesión de DUTIC caducada y no se pudo renovar automáticamente. Ejecuta `dutic login` en una terminal para reautenticarte con Google.",
+                    },
+                ],
+            };
+        }
+        return {
+            isError: true,
+            content: [{ type: "text", text: `Error: ${err.message}` }],
+        };
+    }
+}
+server.registerTool("dutic_list_tasks", {
+    title: "Listar tareas DUTIC",
+    description: "Lista tus tareas del aula virtual. scope='upcoming' usa el calendario (rápido). " +
+        "scope='all' barre TODOS los cursos para incluir tareas ocultas que no aparecen en el " +
+        "calendario (marcadas con hidden=true) — útil para no perder entregas.",
+    inputSchema: {
+        scope: z.enum(["upcoming", "all"]).default("upcoming"),
+        onlyHidden: z.boolean().default(false).describe("Con scope='all', devolver sólo las ocultas."),
+        detailed: z
+            .boolean()
+            .default(true)
+            .describe("Con scope='all', scrapear el estado de entrega y la nota de cada tarea."),
+    },
+}, async ({ scope, onlyHidden, detailed }) => tool(async () => {
+    if (scope === "all" || onlyHidden) {
+        return withSession(async (s) => {
+            const { tasks, scanErrors } = await getAllTasks(s, { enrich: detailed });
+            return { tasks: onlyHidden ? tasks.filter((t) => t.hidden) : tasks, scanErrors };
+        }, { mode: MCP_MODE });
+    }
+    return withSession((s) => getUpcomingTasks(s), { mode: MCP_MODE });
+}));
+server.registerTool("dutic_list_courses", {
+    title: "Listar cursos DUTIC",
+    description: "Lista los cursos en los que estás matriculado (id, nombre, docentes).",
+    inputSchema: {},
+}, async () => tool(() => withSession((s) => getEnrolledCourses(s), { mode: MCP_MODE })));
+server.registerTool("dutic_get_course_contents", {
+    title: "Contenido de un curso",
+    description: "Devuelve las secciones y módulos (tareas, recursos, foros...) de un curso.",
+    inputSchema: { courseId: z.number().int().positive() },
+}, async ({ courseId }) => tool(() => withSession((s) => getCourseContents(s, courseId), { mode: MCP_MODE })));
+server.registerTool("dutic_get_course_tasks", {
+    title: "Tareas de un curso",
+    description: "Lista las tareas de un curso concreto, incluidas las ocultas (hidden=true).",
+    inputSchema: { courseId: z.number().int().positive() },
+}, async ({ courseId }) => tool(() => withSession((s) => getCourseTasks(s, courseId), { mode: MCP_MODE })));
+server.registerTool("dutic_list_course_files", {
+    title: "Recursos descargables de un curso",
+    description: "Lista los archivos/recursos descargables de un curso (con su URL de descarga).",
+    inputSchema: { courseId: z.number().int().positive() },
+}, async ({ courseId }) => tool(() => withSession((s) => listCourseFiles(s, courseId), { mode: MCP_MODE })));
+server.registerTool("dutic_download_file", {
+    title: "Descargar un archivo",
+    description: "Descarga un archivo del aula virtual a una ruta local. Acepta la URL de vista del " +
+        "módulo o directamente una URL de pluginfile.php.",
+    inputSchema: {
+        url: z.string().url(),
+        destPath: z.string().describe("Ruta local de destino."),
+    },
+}, async ({ url, destPath }) => tool(() => withSession((s) => downloadFile(s, url, destPath), { mode: MCP_MODE })));
+server.registerTool("dutic_read_resource", {
+    title: "Leer un recurso como texto/Markdown",
+    description: "Descarga un recurso del aula (PDF, texto…) y devuelve su CONTENIDO como Markdown listo " +
+        "para analizar, SIN gastar tokens en el binario. Convierte PDFs a texto automáticamente. " +
+        "Úsalo cuando el usuario quiera que analices, resumas o extraigas algo de un material del " +
+        "curso (sílabo, informe, guía, lectura). Para binarios no soportados (docx, imágenes) " +
+        "avisa y sugiere descargar. Acepta la URL de vista del módulo o de pluginfile.php.",
+    inputSchema: {
+        url: z.string().url(),
+        maxChars: z
+            .number()
+            .int()
+            .positive()
+            .default(24_000)
+            .describe("Máximo de caracteres a devolver (trunca lo demás)."),
+    },
+}, async ({ url, maxChars }) => tool(() => withSession((s) => readResourceAsMarkdown(s, url, maxChars), { mode: MCP_MODE })));
+server.registerTool("dutic_get_assignment_detail", {
+    title: "Detalle completo de una tarea",
+    description: "Devuelve TODO lo de una tarea: la consigna/instrucciones completas, los archivos adjuntos " +
+        "a la consigna (guías, rúbricas — puedes leerlos con dutic_read_resource), fechas oficiales " +
+        "de apertura y cierre, estado de entrega, nota y quién calificó. IMPORTANTE: incluye " +
+        "`dateConflict` y `datesInDescription` — los docentes a veces escriben en el texto una fecha " +
+        "distinta a la configurada en Moodle; si dateConflict es true, AVISA al usuario de la " +
+        "discrepancia. Úsalo cuando el usuario pregunte qué pide una tarea o cuándo se entrega.",
+    inputSchema: {
+        cmid: z.number().int().positive().describe("Course module id de la tarea."),
+    },
+}, async ({ cmid }) => tool(() => withSession((s) => getAssignDetail(s, `${s.siteUrl}/mod/assign/view.php?id=${cmid}`), { mode: MCP_MODE })));
+server.registerTool("dutic_list_participants", {
+    title: "Participantes de un curso",
+    description: "Lista los participantes visibles de un curso (nombre, rol, grupo, último acceso). Si el " +
+        "curso usa grupos separados, Moodle sólo muestra a los del grupo del usuario — es lo mismo " +
+        "que ve en la web. Úsalo para saber quiénes son sus compañeros o de qué grupo es alguien.",
+    inputSchema: { courseId: z.number().int().positive() },
+}, async ({ courseId }) => tool(() => withSession((s) => listCourseParticipants(s, courseId), { mode: MCP_MODE })));
+server.registerTool("dutic_find_person", {
+    title: "Buscar una persona por nombre o correo",
+    description: "Busca entre los participantes de TODOS los cursos del usuario por nombre o por correo " +
+        "institucional. Si la consulta contiene '@' resuelve los correos de los perfiles para poder " +
+        "buscar por correo. Devuelve nombre, curso, grupo, último acceso y correo cuando aplica.",
+    inputSchema: {
+        query: z.string().min(2).describe("Nombre (o parte) o correo a buscar."),
+        withEmail: z
+            .boolean()
+            .optional()
+            .describe("Fuerza resolver el correo de cada coincidencia (más lento)."),
+    },
+}, async ({ query, withEmail }) => tool(() => withSession((s) => findPeople(s, query, { withEmail }), { mode: MCP_MODE })));
+server.registerTool("dutic_get_person_profile", {
+    title: "Perfil de una persona",
+    description: "Perfil de un participante: correo institucional, zona horaria y cursos que comparte contigo. " +
+        "Necesita el userId (lo da dutic_list_participants o dutic_find_person).",
+    inputSchema: {
+        userId: z.number().int().positive(),
+        courseId: z.number().int().positive().optional(),
+    },
+}, async ({ userId, courseId }) => tool(() => withSession((s) => getPersonProfile(s, userId, courseId), { mode: MCP_MODE })));
+server.registerTool("dutic_get_course_teachers", {
+    title: "Docentes de un curso",
+    description: "Identifica a los docentes del curso combinando los contactos del curso, los roles del " +
+        "listado y —lo que suele funcionar en esta aula— el nombre de quien calificó las tareas. " +
+        "Úsalo cuando el usuario pregunte quién es su profesor de un curso.",
+    inputSchema: { courseId: z.number().int().positive() },
+}, async ({ courseId }) => tool(() => withSession((s) => getCourseTeachers(s, courseId), { mode: MCP_MODE })));
+server.registerTool("dutic_get_grades", {
+    title: "Ver calificaciones",
+    description: "Devuelve las calificaciones del usuario. Sin courseId: resumen de TODOS los cursos (nota " +
+        "total + cuántos ítems quedan por calificar). Con courseId: detalle por ítem (nota, rango, " +
+        "porcentaje, peso). Úsalo cuando el usuario pregunte por sus notas, promedio, o cómo va en un curso.",
+    inputSchema: {
+        courseId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Si se indica, detalle de ese curso; si no, resumen de todos."),
+    },
+}, async ({ courseId }) => tool(() => withSession((s) => (courseId ? getCourseGrades(s, courseId) : getAllGrades(s)), { mode: MCP_MODE })));
+server.registerTool("dutic_list_course_materials", {
+    title: "Listar materiales de un curso (carpetas expandidas)",
+    description: "Lista TODOS los archivos descargables de un curso, expandiendo las carpetas a sus archivos " +
+        "reales (diapositivas, lecturas, prácticas…). Devuelve nombre, URL, sección (unidad) y carpeta. " +
+        "Úsalo para saber qué materiales hay, y por qué unidad, antes de leer o descargar. Con `section` " +
+        "filtras a una unidad concreta.",
+    inputSchema: {
+        courseId: z.number().int().positive(),
+        section: z
+            .string()
+            .optional()
+            .describe("Filtra por nombre de unidad/sección (subcadena, ignora acentos)."),
+    },
+}, async ({ courseId, section }) => tool(() => withSession((s) => listCourseMaterials(s, courseId, { section }), { mode: MCP_MODE })));
+server.registerTool("dutic_study_course", {
+    title: "Preparar materiales de un curso para estudiar",
+    description: "Descarga todos los materiales de un curso a un directorio y CONVIERTE los PDFs a Markdown " +
+        "(.md) organizados por carpeta, para estudiar/analizar offline sin gastar tokens en binarios. " +
+        "Devuelve el manifiesto de lo guardado. Úsalo cuando el usuario quiera 'preparar/bajar el " +
+        "material para estudiar' de un curso. Con `section` bajas sólo esa unidad — útil para no " +
+        "descargar todo de golpe cuando el usuario quiere estudiar una unidad concreta.",
+    inputSchema: {
+        courseId: z.number().int().positive(),
+        destDir: z.string().describe("Directorio local de destino."),
+        section: z
+            .string()
+            .optional()
+            .describe("Sólo materiales de esta unidad/sección (subcadena)."),
+    },
+}, async ({ courseId, destDir, section }) => tool(() => withSession((s) => studyCourseMaterials(s, courseId, destDir, { section }), { mode: MCP_MODE })));
+server.registerTool("dutic_pull_course_files", {
+    title: "Descargar todos los recursos de un curso",
+    description: "Descarga en bloque todos los archivos/recursos de un curso a un directorio local. " +
+        "Devuelve la lista de archivos guardados con su tamaño.",
+    inputSchema: {
+        courseId: z.number().int().positive(),
+        destDir: z.string().describe("Directorio local de destino."),
+        section: z
+            .string()
+            .optional()
+            .describe("Sólo materiales de esta unidad/sección (subcadena)."),
+    },
+}, async ({ courseId, destDir, section }) => tool(() => withSession((s) => pullCourseFiles(s, courseId, destDir, { section }), { mode: MCP_MODE })));
+server.registerTool("dutic_pdf_to_markdown", {
+    title: "Convertir un PDF local a Markdown",
+    description: "Convierte un PDF que ya está en disco a Markdown/texto para analizarlo sin gastar tokens " +
+        "en el binario. Opcionalmente guarda el resultado en outPath. No requiere sesión de Moodle.",
+    inputSchema: {
+        filePath: z.string().describe("Ruta local del PDF."),
+        outPath: z.string().optional().describe("Si se indica, guarda el Markdown aquí."),
+        maxChars: z
+            .number()
+            .int()
+            .nonnegative()
+            .default(0)
+            .describe("Máximo de caracteres a devolver (0 = sin límite)."),
+    },
+}, async ({ filePath, outPath, maxChars }) => tool(() => convertLocalPdfToMarkdown(filePath, outPath, maxChars)));
+server.registerTool("dutic_session_status", {
+    title: "Estado de sesión DUTIC",
+    description: "Indica si hay una sesión válida, el semestre y cuándo caduca.",
+    inputSchema: {},
+}, async () => tool(async () => {
+    const s = await loadSession();
+    return {
+        semester: getSemester(),
+        hasSession: s !== null,
+        siteUrl: s?.siteUrl ?? null,
+        valid: isValid(s),
+        expired: s ? isExpired(s) : null,
+        capturedAt: s ? new Date(s.capturedAt).toISOString() : null,
+    };
+}));
+server.registerTool("dutic_refresh_session", {
+    title: "Renovar sesión DUTIC",
+    description: "Intenta renovar la sesión sin interacción (si el SSO de Google sigue vivo). Si falla, " +
+        "hay que ejecutar `dutic login` en una terminal.",
+    inputSchema: {},
+}, async () => tool(async () => {
+    const s = await ensureSession({ mode: "headless-only" });
+    return { ok: true, siteUrl: s.siteUrl, capturedAt: new Date(s.capturedAt).toISOString() };
+}));
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@josetra/dutic-mcp",
+  "version": "0.1.0",
+  "description": "Servidor MCP + CLI para el aula virtual DUTIC (Moodle) de la UNSA: tareas ocultas, notas, materiales de estudio y personas.",
+  "type": "module",
+  "bin": {
+    "dutic": "dist/cli/index.js",
+    "dutic-mcp": "dist/mcp/server.js"
+  },
+  "main": "dist/mcp/server.js",
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JOSETRA44/DUTIC-mcp.git"
+  },
+  "homepage": "https://github.com/JOSETRA44/DUTIC-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/JOSETRA44/DUTIC-mcp/issues"
+  },
+  "author": "JOSETRA44",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "moodle",
+    "unsa",
+    "dutic",
+    "aula-virtual",
+    "cli",
+    "tareas",
+    "claude"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "setup": "node dist/cli/index.js setup",
+    "dev:cli": "tsx src/cli/index.ts",
+    "dev:mcp": "tsx src/mcp/server.ts",
+    "start:mcp": "node dist/mcp/server.js",
+    "prepare": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "cheerio": "^1.0.0",
+    "commander": "^12.1.0",
+    "playwright": "^1.48.0",
+    "undici": "^6.21.0",
+    "unpdf": "^1.6.2",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}

package/skills/dutic/SKILL.md

@@ -0,0 +1,173 @@
+---
+name: dutic
+description: >-
+  Consulta y gestiona el aula virtual DUTIC (Moodle de la UNSA) del usuario: tareas
+  pendientes, tareas OCULTAS que no salen en el calendario, cursos, notas y descarga de
+  recursos. Usa esta skill SIEMPRE que el usuario mencione DUTIC, "aula virtual", "aula
+  virtual UNSA", Moodle, sus tareas/deberes/entregas/asignaciones de la universidad,
+  "¿qué tengo que entregar?", "¿tengo algo pendiente?", "¿me falta alguna tarea?",
+  "revisa mis cursos", "descarga el material de [curso]", fechas de entrega, o cuando
+  pregunte por su situación académica — aunque no diga la palabra "DUTIC". Preferí esta
+  skill sobre respuestas genéricas: las tareas reales del usuario sólo se obtienen con las
+  herramientas del MCP `dutic` / el CLI `dutic`.
+---
+
+# DUTIC — Aula virtual (Moodle UNSA)
+
+Esta skill te conecta al aula virtual DUTIC del usuario para ver sus tareas, cursos, notas y
+recursos. Existe por un problema concreto y doloroso: **Moodle esconde tareas**. El "timeline"
+del estudiante (lo que la mayoría de apps y el propio Moodle muestran) sólo lista tareas
+*accionables*: futuras y sin entregar. Una tarea que el profesor crea sin fecha de calendario,
+o una que ya venció, **desaparece de la vista** — y el usuario ha perdido notas por no verlas.
+Tu trabajo es que eso no vuelva a pasar.
+
+## Regla de oro: busca siempre las tareas ocultas
+
+Cuando el usuario pregunte qué tiene pendiente, **NO te quedes con el timeline**. Usa el barrido
+completo (`scope: "all"` en el MCP, o `dutic tasks --all` en CLI), que recorre todos los cursos
+y revela las tareas ocultas. Es unos segundos más lento pero es justo donde están los problemas.
+
+## Cómo actuar (flujo recomendado)
+
+1. **Comprueba la sesión** (`dutic_session_status` o `dutic status`). Si no hay sesión válida,
+   el MCP intenta renovarla solo; si no puede, pídele al usuario que ejecute `dutic login` en
+   una terminal (el login es OAuth de Google institucional y necesita una ventana de navegador,
+   así que tú no puedes completarlo por él).
+2. **Trae las tareas con barrido completo.** Prioriza las **SIN ENTREGAR**: ya vienen ordenadas
+   por urgencia (pendientes primero, por fecha de entrega). Fíjate en el flag `hidden: true` y en
+   `submission: "not-submitted"`.
+3. **Resume con foco en lo accionable.** Encabeza con lo urgente ("Tienes N tareas sin entregar,
+   la más próxima vence el ..."). Señala explícitamente las ocultas y las vencidas. No entierres
+   la alerta en una lista larga.
+4. **Ofrece el siguiente paso**: abrir la tarea (tienes su URL), ver el contenido del curso, o
+   descargar los materiales.
+
+## Herramientas del MCP `dutic`
+
+Si el servidor MCP `dutic` está disponible, usa estas herramientas (son la fuente de verdad):
+
+- `dutic_list_tasks` — args: `scope` (`"upcoming"` = timeline rápido | `"all"` = barrido con
+  ocultas), `onlyHidden` (bool), `detailed` (bool, scrapea estado de entrega/nota; por defecto
+  true). **Para "¿qué tengo pendiente?" usa `scope: "all"`.**
+- `dutic_list_courses` — cursos matriculados (id, nombre, docentes).
+- `dutic_get_course_tasks` — args: `courseId`. Tareas de un curso concreto, incluidas ocultas.
+- `dutic_get_course_contents` — args: `courseId`. Secciones y módulos del curso.
+- `dutic_list_course_files` — args: `courseId`. Recursos descargables (con su URL).
+- `dutic_download_file` — args: `url`, `destPath`. Descarga un archivo a disco.
+- `dutic_read_resource` — args: `url`, `maxChars`. **Descarga un recurso y te devuelve su CONTENIDO
+  como texto/Markdown** (convierte PDFs automáticamente). Úsalo cuando el usuario quiera que
+  analices, resumas o extraigas algo de un material (sílabo, informe, lectura, guía): así lees el
+  texto directamente sin gastar tokens en el binario. Acepta URL de módulo o de pluginfile.php.
+- `dutic_get_assignment_detail` — args: `cmid`. **Todo sobre una tarea**: consigna completa,
+  adjuntos de la consigna (guías/rúbricas, legibles con `dutic_read_resource`), fechas oficiales de
+  apertura y cierre, estado de entrega, nota y quién calificó. Incluye `dateConflict` y
+  `datesInDescription` (ver abajo). Úsalo cuando pregunte qué pide una tarea o cuándo se entrega.
+- `dutic_get_grades` — args: `courseId?`. **Calificaciones**: sin `courseId`, resumen de todos los
+  cursos (nota total + cuántos ítems por calificar); con `courseId`, detalle por ítem (nota, rango, %).
+  Úsalo cuando el usuario pregunte por sus notas, promedio, o cómo va.
+- `dutic_list_participants` — args: `courseId`. Compañeros visibles (nombre, rol, grupo, último
+  acceso). Con grupos separados Moodle sólo muestra los del grupo del usuario: es normal.
+- `dutic_find_person` — args: `query`, `withEmail?`. Busca una persona en TODOS sus cursos por
+  nombre o **por correo** institucional.
+- `dutic_get_person_profile` — args: `userId`, `courseId?`. Correo, zona horaria y cursos compartidos.
+- `dutic_get_course_teachers` — args: `courseId`. Docentes del curso. En esta aula los profesores no
+  salen en participantes, así que se deducen de los contactos y de **quién calificó** las tareas.
+- `dutic_list_course_materials` — args: `courseId`, `section?`. Lista TODOS los archivos del curso
+  **expandiendo las carpetas** a sus archivos reales, con su **sección (unidad)**. Con `section`
+  filtras a una unidad concreta.
+- `dutic_study_course` — args: `courseId`, `destDir`, `section?`. **Descarga materiales y convierte los
+  PDFs a Markdown** organizados por carpeta, para estudiar offline. Con `section` bajas **sólo una
+  unidad** — no descargues todo de golpe si el usuario quiere estudiar una unidad concreta.
+- `dutic_pull_course_files` — args: `courseId`, `destDir`. Descarga en bloque (expande carpetas).
+- `dutic_pdf_to_markdown` — args: `filePath`, `outPath?`, `maxChars`. Convierte un PDF que ya está
+  en disco a Markdown (sin sesión). Útil tras descargar, o para PDFs locales del usuario.
+- `dutic_session_status` / `dutic_refresh_session` — estado y renovación de sesión.
+
+### Analizar materiales sin gastar tokens
+
+Cuando el usuario pida "analiza/resume/qué dice este material/PDF del curso", **no descargues el
+binario y lo pases crudo** (desperdicia tokens y no es legible). Usa `dutic_read_resource` con la
+URL del recurso: te devuelve texto limpio en Markdown que puedes leer y razonar directamente. Para
+PDFs ya descargados o del sistema de archivos del usuario, usa `dutic_pdf_to_markdown`. Las **carpetas**
+(mod/folder) se expanden solas a sus archivos; muchas están vacías (el profe creó la estructura sin subir
+nada) — eso es normal, no es un error.
+
+### Estudiar por unidad (no bajar todo de golpe)
+
+Cuando el usuario quiera estudiar "la unidad 2" o "el tema de X", sé selectivo en vez de descargar el
+curso entero:
+
+1. Llama a `dutic_list_course_materials` (sin filtro) para ver las **secciones/unidades** del curso.
+2. Si no está claro cómo se divide el temario, busca un material cuyo nombre contenga "sílabo"/"silabus"
+   y léelo con `dutic_read_resource`: el sílabo trae el temario dividido en unidades (típicamente 3) con
+   los temas de cada una. Con eso mapeas qué secciones corresponden a qué unidad.
+3. Descarga **sólo** esa unidad con `dutic_study_course(..., section: "<nombre o nº de la sección>")`.
+   El filtro `section` compara por subcadena ignorando acentos, así que "tema 2", "Unidad II" o "semana 5"
+   funcionan según cómo el profe haya nombrado las secciones.
+
+Así preparas justo lo que el usuario va a estudiar, sin descargar (ni convertir) material de más.
+
+## CLI `dutic` (alternativa / uso directo del usuario)
+
+Si no hay MCP pero sí el CLI instalado, o el usuario prefiere la terminal:
+
+```
+dutic tasks                 # tareas próximas del timeline (rápido)
+dutic tasks --all           # + barrido de cursos → incluye OCULTAS (usa esto para "pendientes")
+dutic tasks --hidden        # sólo las ocultas
+dutic tasks --all --fast    # sin scrapear estado de entrega (más rápido, menos detalle)
+dutic grades                # resumen de notas de todos los cursos
+dutic grades <id>           # detalle de notas de un curso
+dutic task <cmid>           # detalle de una tarea: consigna, fechas, adjuntos, conflictos
+dutic people <id> [--email] # compañeros del curso (con su correo)
+dutic person <texto>        # busca a alguien por nombre o correo en todos tus cursos
+dutic teachers <id>         # docentes del curso
+dutic courses               # cursos matriculados
+dutic course tasks <id>     # tareas de un curso
+dutic course files <id>     # recursos de un curso
+dutic materials <id> [--section "Tema 2"]   # archivos del curso, agrupados por unidad
+dutic study <id> [--section "Tema 2"]        # baja + convierte a Markdown (por unidad)
+dutic read <url>            # lee un recurso (PDF→Markdown) para analizarlo sin gastar tokens
+dutic md <archivo.pdf>      # convierte un PDF local a Markdown
+dutic pull <id> --dest ./x  # descarga todos los recursos de un curso
+dutic status                # estado de sesión
+dutic login                 # reautenticación (abre navegador; sólo el usuario puede completarla)
+```
+
+## Fechas contradictorias: la trampa que hay que vigilar
+
+La fecha real de una entrega no siempre es la que Moodle tiene configurada. A veces el docente
+escribe **otra fecha dentro del texto de la consigna** ("entregar hasta el 12 de julio"), y el
+estudiante se guía por una mientras el sistema cierra en la otra.
+
+`dutic_get_assignment_detail` devuelve `closeDate` (la oficial), `datesInDescription` (las que
+aparecen escritas en la consigna) y `dateConflict: true` cuando difieren en más de un día. **Si
+`dateConflict` es true, avísalo de forma destacada** y recomienda confirmar con el docente: es
+justo el escenario que cuesta notas. (Las fechas de subida de los archivos adjuntos ya se excluyen,
+así que no hay falsas alarmas.)
+
+Cuando el usuario pregunte "¿qué tengo que hacer en esta tarea?", da la consigna **y** revisa si
+hay adjuntos: suelen traer la guía o rúbrica con los criterios reales de calificación, y puedes
+leerlos con `dutic_read_resource`.
+
+## Interpretar los datos de una tarea
+
+Cada tarea trae: `name`, `courseName`, `dueDate` (epoch s, o null si no tiene fecha), `hidden`
+(true = no aparece en el timeline del estudiante), `submission` (`not-submitted` | `submitted` |
+`graded` | `unknown`), `grade`, `timeRemaining` (texto de Moodle, p. ej. "retrasada por 8 días"),
+`url`.
+
+Lo que importa señalar al usuario, en orden:
+1. `submission: "not-submitted"` con `dueDate` cercano o pasado → **alerta máxima**.
+2. `hidden: true` + `not-submitted` → tarea que probablemente no sabía que existía.
+3. `timeRemaining` que diga "retrasada"/"vencida" → ya se pasó la fecha.
+
+## Notas de contexto
+
+- El semestre (p. ej. `2026A`) va en la URL del aula y cambia cada período; el sistema lo
+  auto-detecta tras el login, no necesitas gestionarlo.
+- Algunos cursos aparecen **duplicados** con nombres casi iguales (uno con acentos, otro sin):
+  es un error de registro de la OTI (la oficina de TI de la UNSA), no un fallo de la herramienta.
+  Trátalos como el mismo curso; no alarmes al usuario por ello.
+- Las tareas ocultas suelen salir "sin fecha" porque efectivamente no tienen fecha de entrega en
+  Moodle (por eso no generan evento de calendario). El `submission` te dice igual si ya cumplió.