@josetra/dutic-mcp 0.1.0 → 0.1.1

package/README.md

@@ -1,223 +1,226 @@
-# dutic-mcp
-
-**Servidor MCP + CLI para el aula virtual DUTIC (Moodle) de la UNSA.**
-Tus tareas —incluidas las **ocultas**—, notas, materiales de estudio y compañeros, en la terminal
-y disponibles para agentes de IA (Claude Code, Antigravity, OpenCode, mimocode…).
-
-```
-┌─────────────────────────────────────────────┐
-│ 24 tareas · 10 SIN ENTREGAR                 │
-│ 18 ocultas que el calendario no te muestra  │
-└─────────────────────────────────────────────┘
-```
-
-## Por qué existe
-
-El timeline de Moodle sólo muestra tareas **accionables** (futuras y sin entregar). Las tareas sin
-fecha de calendario, ya vencidas o ya entregadas **desaparecen de la vista** — y así se pierden
-entregas. `dutic` barre todos los cursos, encuentra esas tareas, las marca como `OCULTA` y ordena
-lo pendiente por urgencia.
-
----
-
-## Instalación
-
-**Requisitos:** [Node.js](https://nodejs.org) ≥ 20 y Google Chrome (o Edge) instalado.
-No hace falta descargar Chromium: se usa el navegador que ya tienes.
-
-### Un solo comando
-
-```bash
-npm install -g @joswetra/dutic-mcp
-```
-
-Esto deja `dutic` y `dutic-mcp` en tu PATH.
-
-<details>
-<summary>Instalar desde el código fuente</summary>
-
-```bash
-git clone https://github.com/JOSETRA44/dutic-mcp.git
-cd dutic-mcp
-npm install        # compila automáticamente (script prepare)
-npm install -g .   # deja los comandos en el PATH
-```
-</details>
-
----
-
-## Primeros pasos
-
-### 1. Configura tus agentes (una vez)
-
-```bash
-dutic setup
-```
-
-Registra el servidor MCP en los agentes que tengas instalados y copia la skill `dutic` a sus
-directorios. Hace copia de seguridad (`*.dutic-bak`) y **no toca** el resto de tu configuración.
-
-```
-[OK] Claude Code (MCP)    C:\Users\tu-usuario\.claude.json
-[OK] Antigravity (MCP)    ...\.antigravity\config\mcp_config.json
-[OK] OpenCode (MCP)       ...\.config\opencode\opencode.jsonc
-[OK] mimocode (MCP)       ...\.config\mimocode\mimocode.jsonc
-[OK] Claude Code (skill)  ...\.claude\skills\dutic
-```
-
-> Reinicia cada agente para que cargue el servidor.
-
-### 2. Inicia sesión (una vez)
-
-```bash
-dutic login
-```
-
-Se abre tu Chrome en el aula virtual. Pulsa **«Ingresar con Correo UNSA»**, elige tu cuenta de
-Google y espera: la ventana se cierra sola al capturar la sesión. El perfil del navegador queda
-guardado, así que las renovaciones posteriores suelen ser automáticas.
-
-### 3. Compruébalo
-
-```bash
-dutic status          # ¿sesión válida?
-dutic tasks --all     # tus tareas, incluidas las ocultas
-```
-
-Si ves tus tareas, ya está todo listo. Pídeselo también a tu agente:
-*«¿tengo alguna tarea pendiente en el aula virtual?»*
-
----
-
-## Uso — CLI
-
-| Comando | Qué hace |
-|---|---|
-| `dutic tasks` | Tareas próximas del timeline (rápido) |
-| `dutic tasks --all` | **+ barrido de cursos → incluye las ocultas** |
-| `dutic tasks --hidden` | Sólo las ocultas |
-| `dutic task <cmid>` | Detalle: consigna, fechas, adjuntos, conflicto de fechas |
-| `dutic grades [id]` | Notas: resumen de todos los cursos, o detalle de uno |
-| `dutic courses` | Cursos matriculados |
-| `dutic materials <id> [--section "Tema 2"]` | Archivos del curso, por unidad |
-| `dutic study <id> [--section "Tema 2"]` | Baja materiales y convierte PDFs a Markdown |
-| `dutic read <url>` | Lee un recurso (PDF→Markdown) para analizarlo |
-| `dutic md <archivo.pdf>` | Convierte un PDF local a Markdown |
-| `dutic people <id> [--email]` | Compañeros del curso (con correo) |
-| `dutic person <texto>` | Busca a alguien por nombre o correo |
-| `dutic teachers <id>` | Docentes del curso |
-| `dutic pull <id>` | Descarga todos los materiales |
-| `dutic setup` / `dutic login` / `dutic status` | Configuración y sesión |
-
-Añade `--json` a la mayoría de comandos para salida estructurada.
-
-### Ejemplos
-
-```bash
-# ¿Qué me falta entregar?
-dutic tasks --all
-
-# Preparar sólo la unidad que voy a estudiar
-dutic study 2279 --section "Tema 2" --dest ./materiales
-
-# ¿Qué pide exactamente esta tarea?
-dutic task 385686
-
-# El correo de mi compañero de grupo
-dutic person "Piero"
-```
-
----
-
-## Uso — con agentes (MCP)
-
-Tras `dutic setup` no hay nada más que hacer: pregúntale a tu agente por tus tareas, notas o
-materiales y usará las herramientas del servidor.
-
-<details>
-<summary>Configuración manual (otros clientes MCP)</summary>
-
-```json
-{
-  "mcpServers": {
-    "dutic": {
-      "command": "dutic-mcp",
-      "env": { "DUTIC_SEMESTER": "2026A" }
-    }
-  }
-}
-```
-
-Si tu cliente no resuelve comandos del PATH, usa la ruta absoluta que imprime `dutic setup`:
-`{ "command": "node", "args": ["<ruta>/dist/mcp/server.js"] }`
-</details>
-
-**19 herramientas**: tareas (`dutic_list_tasks`, `dutic_get_assignment_detail`, …), notas
-(`dutic_get_grades`), materiales (`dutic_list_course_materials`, `dutic_study_course`,
-`dutic_read_resource`, `dutic_pdf_to_markdown`), personas (`dutic_list_participants`,
-`dutic_find_person`, `dutic_get_course_teachers`) y sesión.
-
----
-
-## Configuración
-
-| Variable | Para qué | Por defecto |
-|---|---|---|
-| `DUTIC_SEMESTER` | Semestre en la URL del aula (`2026A`, `2026B`…) | `2026A` |
-| `DUTIC_BROWSER_CHANNEL` | Navegador para el login: `chrome`, `msedge`, `chromium` | `chrome` |
-| `DUTIC_DATA_DIR` | Dónde guardar sesión y perfil | `~/.dutic` |
-
-El semestre sólo se usa para la URL de login: tras iniciar sesión **se auto-detecta** del propio
-aula, así que al cambiar de período normalmente no hay que tocar nada.
-
----
-
-## Cómo funciona
-
-No usa la API pública de web services (la UNSA la tiene bloqueada). Captura la cookie
-`MoodleSession` y el token `sesskey` tras el login de Google (Playwright manejando tu Chrome) y con
-ellos llama al endpoint AJAX interno de Moodle, complementado con scraping donde hace falta.
-
-| Necesidad | Fuente | Estado |
-|---|---|---|
-| Descubrir todas las tareas | `core_courseformat_get_state` | ✅ |
-| Cursos matriculados | `core_course_get_enrolled_courses_by_timeline_classification` | ✅ |
-| Timeline y fechas | `core_calendar_get_action_events_by_timesort` | ✅ (sólo accionables) |
-| Estado de entrega, consigna, adjuntos | scraping de `mod/assign/view.php` | ✅ |
-| Notas | scraping de `grade/report/user/index.php` | ✅ |
-| Personas y correos | scraping de `user/index.php` y `user/view.php` | ✅ |
-| `core_course_get_contents`, `mod_assign_*`, `gradereport_*` | — | ❌ bloqueadas por la UNSA |
-
-**Fechas contradictorias:** algunas consignas mencionan una fecha distinta a la configurada en
-Moodle. `dutic task <cmid>` compara ambas y avisa (`dateConflict`) — es la causa típica de entregas
-perdidas.
-
----
-
-## Publicar en npm
-
-```bash
-npm login                 # cuenta de npm
-npm version patch         # o minor / major
-npm publish               # el paquete es scoped y público (publishConfig.access)
-git push --follow-tags
-```
-
-`prepublishOnly` compila antes de publicar y `files` limita el tarball a `dist/` y `skills/`.
-
-> Si tu scope de npm no es `@joswetra`, cambia el campo `name` en `package.json` por
-> `@tu-scope/dutic-mcp` (o un nombre sin scope que esté libre).
-
----
-
-## Privacidad y seguridad
-
-- La sesión (`~/.dutic/session.json`) y el perfil del navegador contienen credenciales de tu
-  cuenta: no se versionan y el archivo se crea con permisos restrictivos.
-- El certificado de `aulavirtual.unsa.edu.pe` (CA privada de la UNSA) se acepta **sólo** para ese host.
-- La herramienta accede únicamente a lo que tú ya ves en el aula. Donde Moodle oculta información
-  (docentes en el listado, compañeros de otros grupos) se respeta esa restricción.
-
-## Licencia
-
-MIT © JOSETRA44
+# dutic-mcp
+
+**Servidor MCP + CLI para el aula virtual DUTIC (Moodle) de la UNSA.**
+Tus tareas —incluidas las **ocultas**—, notas, materiales de estudio y compañeros, en la terminal
+y disponibles para agentes de IA (Claude Code, Antigravity, OpenCode, mimocode…).
+
+```
+┌─────────────────────────────────────────────┐
+│ 24 tareas · 10 SIN ENTREGAR                 │
+│ 18 ocultas que el calendario no te muestra  │
+└─────────────────────────────────────────────┘
+```
+
+## Por qué existe
+
+El timeline de Moodle sólo muestra tareas **accionables** (futuras y sin entregar). Las tareas sin
+fecha de calendario, ya vencidas o ya entregadas **desaparecen de la vista** — y así se pierden
+entregas. `dutic` barre todos los cursos, encuentra esas tareas, las marca como `OCULTA` y ordena
+lo pendiente por urgencia.
+
+---
+
+## Instalación
+
+**Requisitos:** [Node.js](https://nodejs.org) ≥ 20 y Google Chrome (o Edge) instalado.
+No hace falta descargar Chromium: se usa el navegador que ya tienes.
+
+### Un solo comando
+
+```bash
+npm install -g @josetra/dutic-mcp
+```
+
+Esto deja `dutic` y `dutic-mcp` en tu PATH.
+
+<details>
+<summary>Instalar desde el código fuente</summary>
+
+```bash
+git clone https://github.com/JOSETRA44/dutic-mcp.git
+cd dutic-mcp
+npm install        # compila automáticamente (script prepare)
+npm install -g .   # deja los comandos en el PATH
+```
+</details>
+
+---
+
+## Primeros pasos
+
+### 1. Configura tus agentes (una vez)
+
+```bash
+dutic setup
+```
+
+Registra el servidor MCP en los agentes que tengas instalados y copia la skill `dutic` a sus
+directorios. Hace copia de seguridad (`*.dutic-bak`) y **no toca** el resto de tu configuración.
+
+```
+[OK] Claude Code (MCP)    C:\Users\tu-usuario\.claude.json
+[OK] Antigravity (MCP)    ...\.antigravity\config\mcp_config.json
+[OK] OpenCode (MCP)       ...\.config\opencode\opencode.jsonc
+[OK] mimocode (MCP)       ...\.config\mimocode\mimocode.jsonc
+[OK] Claude Code (skill)  ...\.claude\skills\dutic
+```
+
+> Reinicia cada agente para que cargue el servidor.
+
+### 2. Inicia sesión (una vez)
+
+```bash
+dutic login
+```
+
+Se abre tu Chrome en el aula virtual. Pulsa **«Ingresar con Correo UNSA»**, elige tu cuenta de
+Google y espera: la ventana se cierra sola al capturar la sesión. El perfil del navegador queda
+guardado, así que las renovaciones posteriores suelen ser automáticas.
+
+### 3. Compruébalo
+
+```bash
+dutic status          # ¿sesión válida?
+dutic tasks --all     # tus tareas, incluidas las ocultas
+```
+
+Si ves tus tareas, ya está todo listo. Pídeselo también a tu agente:
+*«¿tengo alguna tarea pendiente en el aula virtual?»*
+
+---
+
+## Uso — CLI
+
+| Comando | Qué hace |
+|---|---|
+| `dutic tasks` | Tareas próximas del timeline (rápido) |
+| `dutic tasks --all` | **+ barrido de cursos → incluye las ocultas** |
+| `dutic tasks --hidden` | Sólo las ocultas |
+| `dutic task <cmid>` | Detalle: consigna, fechas, adjuntos, conflicto de fechas |
+| `dutic grades [id]` | Notas: resumen de todos los cursos, o detalle de uno |
+| `dutic courses` | Cursos matriculados |
+| `dutic materials <id> [--section "Tema 2"]` | Archivos del curso, por unidad |
+| `dutic study <id> [--section "Tema 2"]` | Baja materiales y convierte PDFs a Markdown |
+| `dutic read <url>` | Lee un recurso (PDF→Markdown) para analizarlo |
+| `dutic md <archivo.pdf>` | Convierte un PDF local a Markdown |
+| `dutic people <id>` | Todos los compañeros del curso, con correo (`--no-email` para omitir) |
+| `dutic person <texto>` | Busca por nombre/correo: su correo y **sus cursos reales** (con grupo), marcando cuáles compartes |
+| `dutic profile <userId>` | Perfil de cualquier id (docentes incluidos): correo y sus cursos |
+| `dutic fetch <url>` | Explora cualquier página del aula por URL (cambiar ids, ver lo que no tiene botón) |
+| `dutic teachers <id>` | Docentes del curso |
+| `dutic pull <id>` | Descarga todos los materiales |
+| `dutic setup` / `dutic login` / `dutic status` | Configuración y sesión |
+
+Añade `--json` a la mayoría de comandos para salida estructurada.
+
+### Ejemplos
+
+```bash
+# ¿Qué me falta entregar?
+dutic tasks --all
+
+# Preparar sólo la unidad que voy a estudiar
+dutic study 2279 --section "Tema 2" --dest ./materiales
+
+# ¿Qué pide exactamente esta tarea?
+dutic task 385686
+
+# ¿Quién es y en qué cursos coincido con él? (correo + todos los cursos compartidos)
+dutic person "Piero"
+```
+
+---
+
+## Uso — con agentes (MCP)
+
+Tras `dutic setup` no hay nada más que hacer: pregúntale a tu agente por tus tareas, notas o
+materiales y usará las herramientas del servidor.
+
+<details>
+<summary>Configuración manual (otros clientes MCP)</summary>
+
+```json
+{
+  "mcpServers": {
+    "dutic": {
+      "command": "dutic-mcp",
+      "env": { "DUTIC_SEMESTER": "2026A" }
+    }
+  }
+}
+```
+
+Si tu cliente no resuelve comandos del PATH, usa la ruta absoluta que imprime `dutic setup`:
+`{ "command": "node", "args": ["<ruta>/dist/mcp/server.js"] }`
+</details>
+
+**20 herramientas**: tareas (`dutic_list_tasks`, `dutic_get_assignment_detail`, …), notas
+(`dutic_get_grades`), materiales (`dutic_list_course_materials`, `dutic_study_course`,
+`dutic_read_resource`, `dutic_pdf_to_markdown`), personas (`dutic_list_participants`,
+`dutic_find_person`, `dutic_get_person_profile`, `dutic_get_course_teachers`), exploración por URL
+(`dutic_fetch_page`) y sesión.
+
+---
+
+## Configuración
+
+| Variable | Para qué | Por defecto |
+|---|---|---|
+| `DUTIC_SEMESTER` | Semestre en la URL del aula (`2026A`, `2026B`…) | `2026A` |
+| `DUTIC_BROWSER_CHANNEL` | Navegador para el login: `chrome`, `msedge`, `chromium` | `chrome` |
+| `DUTIC_DATA_DIR` | Dónde guardar sesión y perfil | `~/.dutic` |
+
+El semestre sólo se usa para la URL de login: tras iniciar sesión **se auto-detecta** del propio
+aula, así que al cambiar de período normalmente no hay que tocar nada.
+
+---
+
+## Cómo funciona
+
+No usa la API pública de web services (la UNSA la tiene bloqueada). Captura la cookie
+`MoodleSession` y el token `sesskey` tras el login de Google (Playwright manejando tu Chrome) y con
+ellos llama al endpoint AJAX interno de Moodle, complementado con scraping donde hace falta.
+
+| Necesidad | Fuente | Estado |
+|---|---|---|
+| Descubrir todas las tareas | `core_courseformat_get_state` | ✅ |
+| Cursos matriculados | `core_course_get_enrolled_courses_by_timeline_classification` | ✅ |
+| Timeline y fechas | `core_calendar_get_action_events_by_timesort` | ✅ (sólo accionables) |
+| Estado de entrega, consigna, adjuntos | scraping de `mod/assign/view.php` | ✅ |
+| Notas | scraping de `grade/report/user/index.php` | ✅ |
+| Personas y correos | scraping de `user/index.php` y `user/view.php` | ✅ |
+| `core_course_get_contents`, `mod_assign_*`, `gradereport_*` | — | ❌ bloqueadas por la UNSA |
+
+**Fechas contradictorias:** algunas consignas mencionan una fecha distinta a la configurada en
+Moodle. `dutic task <cmid>` compara ambas y avisa (`dateConflict`) — es la causa típica de entregas
+perdidas.
+
+---
+
+## Publicar en npm
+
+```bash
+npm login                 # cuenta de npm
+npm version patch         # o minor / major
+npm publish               # el paquete es scoped y público (publishConfig.access)
+git push --follow-tags
+```
+
+`prepublishOnly` compila antes de publicar y `files` limita el tarball a `dist/` y `skills/`.
+
+> Si tu scope de npm no es `@joswetra`, cambia el campo `name` en `package.json` por
+> `@tu-scope/dutic-mcp` (o un nombre sin scope que esté libre).
+
+---
+
+## Privacidad y seguridad
+
+- La sesión (`~/.dutic/session.json`) y el perfil del navegador contienen credenciales de tu
+  cuenta: no se versionan y el archivo se crea con permisos restrictivos.
+- El certificado de `aulavirtual.unsa.edu.pe` (CA privada de la UNSA) se acepta **sólo** para ese host.
+- La herramienta accede únicamente a lo que tú ya ves en el aula. Donde Moodle oculta información
+  (docentes en el listado, compañeros de otros grupos) se respeta esa restricción.
+
+## Licencia
+
+MIT © JOSETRA44

package/dist/cli/index.js

@@ -12,8 +12,11 @@ import { convertLocalPdfToMarkdown, readResourceAsMarkdown, studyCourseMaterials
 import { getAllGrades, getCourseGrades } from "../domain/grades.js";
 import { getAssignDetail } from "../domain/assign.js";
 import { findPeople, getCourseTeachers, getPersonProfile, listCourseParticipants, } from "../domain/people.js";
+import { fetchAulaPage } from "../domain/fetch.js";
+import { parseCourseName } from "../core/coursename.js";
+import { humanizeAgo } from "../core/dates.js";
 import { formatTaskLine } from "./format.js";
-import { banner, c, mark, progressBar, rule, table } from "./ui.js";
+import { banner, c, mark, progressBar, rule, statusLine, table } from "./ui.js";
 import { MCP_SERVER_PATH, runSetup } from "./setup.js";
 import { readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
@@ -158,20 +161,18 @@ program
 });
 program
     .command("people <courseId>")
-    .description("Participantes visibles del curso (compañeros de tu grupo).")
-    .option("--email", "Resuelve el correo de cada uno (más lento).")
+    .description("Participantes del curso, con su correo (recorre todas las páginas).")
+    .option("--no-email", "No resolver los correos (más rápido).")
     .option("--json", "Salida en JSON.")
     .action(async (courseId, opts) => {
     await withSession(async (session) => {
-        const ppl = await listCourseParticipants(session, Number(courseId));
-        const rows = await Promise.all(ppl.map(async (p) => {
-            let email = "";
-            if (opts.email) {
-                const prof = await getPersonProfile(session, p.userId, Number(courseId), p.name).catch(() => null);
-                email = prof?.email ?? "—";
-            }
-            return [p.name, p.role ?? "—", p.group ?? "—", p.lastAccess ?? "—", ...(opts.email ? [email] : [])];
-        }));
+        const withEmail = opts.email !== false; // commander: --no-email ⇒ opts.email === false
+        const status = statusLine();
+        const ppl = await listCourseParticipants(session, Number(courseId), {
+            withEmail,
+            onProgress: ({ phase, done, total, label }) => status.set(`${phase} ${done}/${total} ${c.dim((label ?? "").slice(0, 34))}`),
+        });
+        status.done();
         if (opts.json)
             return out(JSON.stringify(ppl, null, 2));
         out(banner("Participantes", `${ppl.length} · curso ${courseId}`));
@@ -180,8 +181,14 @@ program
             { header: "rol", color: c.dim },
             { header: "grupo", color: c.dim },
             { header: "último acceso", color: c.dim },
-            ...(opts.email ? [{ header: "correo", color: c.cyan }] : []),
-        ], rows));
+            ...(withEmail ? [{ header: "correo", color: c.cyan }] : []),
+        ], ppl.map((p) => [
+            p.name,
+            p.role ?? "—",
+            p.group ?? "—",
+            p.lastAccess ?? "—",
+            ...(withEmail ? [p.email ?? "—"] : []),
+        ])));
     }, { login: { onStatus: log } });
 });
 program
@@ -190,16 +197,68 @@ program
     .option("--json", "Salida en JSON.")
     .action(async (query, opts) => {
     await withSession(async (session) => {
-        const found = await findPeople(session, query);
+        const status = statusLine();
+        const found = await findPeople(session, query, {
+            onProgress: ({ phase, done, total, label }) => status.set(`${phase} ${done}/${total} ${c.dim((label ?? "").slice(0, 38))}`),
+        });
+        status.done();
         if (opts.json)
             return out(JSON.stringify(found, null, 2));
         out(banner("Personas", `"${query}" · ${found.length} resultado(s)`));
         for (const p of found) {
-            out(`${mark.arrow()} ${c.bold(p.name)}`);
-            out(`  ${c.dim("curso:")} ${p.courseName}  ${c.dim("grupo:")} ${p.group ?? "—"}`);
-            if (p.email)
-                out(`  ${c.dim("correo:")} ${c.cyan(p.email)}`);
-            out(`  ${c.dim("último acceso:")} ${p.lastAccess ?? "—"}`);
+            out(`\n${mark.arrow()} ${c.bold(p.name)}`);
+            out(`  ${c.dim("correo:")}        ${p.email ? c.cyan(p.email) : c.gray("no visible")}`);
+            out(`  ${c.dim("visto:")}         ${p.lastAccess ?? c.gray("—")}` +
+                ` ${c.dim(`(${humanizeAgo(p.lastSeenAgoSeconds)}, lo más reciente)`)}`);
+            out(`  ${c.dim("cursos:")}        ${c.bold(String(p.courses.length))} en total · ` +
+                `${c.green(String(p.sharedCount))} contigo`);
+            for (const cr of p.courses) {
+                const grp = cr.group ? c.dim(` · ${cr.group}`) : "";
+                const flag = cr.shared ? c.green("✓ contigo") : c.gray("· su curso");
+                const acc = cr.shared && cr.lastAccess ? c.dim(`  visto ${cr.lastAccess}`) : "";
+                out(`    ${cr.shared ? c.green("●") : c.gray("○")} ${cr.subject}${grp}  ${flag}${acc}`);
+            }
+        }
+    }, { login: { onStatus: log } });
+});
+program
+    .command("profile <userId>")
+    .description("Perfil de cualquier usuario por id: correo y sus cursos (sirve para docentes).")
+    .option("--course <id>", "Curso de contexto que revela sus cursos (usa uno que compartas).")
+    .option("--json", "Salida en JSON.")
+    .action(async (userId, opts) => {
+    await withSession(async (session) => {
+        const prof = await getPersonProfile(session, Number(userId), opts.course ? Number(opts.course) : undefined);
+        if (opts.json)
+            return out(JSON.stringify(prof, null, 2));
+        out(banner("Perfil", prof.name));
+        out(`  ${c.dim("id:")}     ${prof.userId}`);
+        out(`  ${c.dim("correo:")} ${prof.email ? c.cyan(prof.email) : c.gray("no visible")}`);
+        out(`  ${c.dim("zona:")}   ${prof.timezone ?? "—"}`);
+        out(`  ${c.dim("cursos:")} ${c.bold(String(prof.courses.length))}`);
+        for (const cr of prof.courses) {
+            out(`    ${mark.bullet()} ${cr.subject}${cr.group ? c.dim(` · ${cr.group}`) : ""} ${c.gray(`(id ${cr.courseId})`)}`);
+        }
+        if (!prof.courses.length) {
+            log(c.dim("  (sin cursos visibles; prueba --course <id de un curso que compartas>)"));
+        }
+    }, { login: { onStatus: log } });
+});
+program
+    .command("fetch <url>")
+    .description("Descarga cualquier página del aula con tu sesión (explorar por URL, cambiar ids…).")
+    .option("--format <f>", "text | html | links", "text")
+    .option("--max <n>", "Máximo de caracteres.", "20000")
+    .action(async (url, opts) => {
+    await withSession(async (session) => {
+        const r = await fetchAulaPage(session, url, opts.format, Number(opts.max));
+        log(c.dim(`# ${r.finalUrl} (${r.status})`));
+        if (opts.format === "links" && r.links) {
+            for (const l of r.links)
+                out(`${c.cyan(l.href)}  ${c.dim(l.text)}`);
+        }
+        else {
+            out(r.content);
         }
     }, { login: { onStatus: log } });
 });
@@ -249,8 +308,17 @@ program
         out(table([
             { header: "id", align: "right", color: c.dim },
             { header: "curso" },
+            { header: "grupo", color: c.dim },
             { header: "docente(s)", color: c.dim },
-        ], courses.map((cr) => [String(cr.id), cr.fullname, cr.contacts.join(", ") || "—"])));
+        ], courses.map((cr) => {
+            const parsed = parseCourseName(cr.fullname);
+            return [
+                String(cr.id),
+                parsed.subject,
+                parsed.group ?? "—",
+                cr.contacts.join(", ") || "—",
+            ];
+        })));
     }, { login: { onStatus: log } });
 });
 const course = program.command("course").description("Operaciones sobre un curso.");