@josetra/dutic-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JOSETRA44
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,223 @@
+# 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

package/dist/cli/format.js

@@ -0,0 +1,69 @@
+import { c } from "./ui.js";
+export function formatDate(epochSeconds) {
+    if (epochSeconds == null)
+        return "sin fecha";
+    const d = new Date(epochSeconds * 1000);
+    return d.toLocaleString("es-PE", {
+        day: "2-digit",
+        month: "2-digit",
+        year: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+    });
+}
+export function relativeDue(epochSeconds) {
+    if (epochSeconds == null)
+        return "";
+    const diffMs = epochSeconds * 1000 - Date.now();
+    const days = Math.round(diffMs / 86_400_000);
+    if (days < 0)
+        return `vencida hace ${Math.abs(days)}d`;
+    if (days === 0)
+        return "¡hoy!";
+    if (days === 1)
+        return "mañana";
+    return `en ${days}d`;
+}
+const SUBMISSION = {
+    submitted: c.green,
+    "not-submitted": c.boldRed,
+    graded: c.cyan,
+    unknown: c.gray,
+};
+const SUBMISSION_LABEL = {
+    submitted: "ENTREGADA",
+    "not-submitted": "SIN ENTREGAR",
+    graded: "CALIFICADA",
+    unknown: "—",
+};
+/**
+ * Renderiza una tarea como bloque de líneas alineadas. Marca de estado a la izquierda:
+ * ● (pendiente, rojo) resalta lo urgente sin emojis.
+ */
+export function formatTaskLine(t) {
+    const paint = SUBMISSION[t.submission] ?? c.gray;
+    const dot = t.submission === "not-submitted" ? c.boldRed("●") : c.gray("○");
+    const scope = t.hidden ? c.yellow("OCULTA") : c.dim("timeline");
+    const state = paint(SUBMISSION_LABEL[t.submission] ?? "—");
+    const grade = t.grade ? c.dim(` · nota ${t.grade}`) : "";
+    const due = `${formatDate(t.dueDate)}${t.dueDate != null ? c.dim(` (${relativeDue(t.dueDate)})`) : ""}`;
+    const lines = [
+        `${dot} ${c.bold(t.name)}  ${c.gray("[")}${scope}${c.gray("]")}`,
+        `  ${c.dim("curso:")}   ${t.courseName}`,
+        `  ${c.dim("entrega:")} ${due}`,
+        `  ${c.dim("estado:")}  ${state}${grade}`,
+    ];
+    if (t.timeRemaining)
+        lines.push(`  ${c.dim("resta:")}   ${t.timeRemaining}`);
+    if (t.dateConflict) {
+        const mencionadas = t.datesInDescription.map((d) => d.text).join(", ");
+        lines.push(`  ${c.boldRed("[!] OJO:")} la consigna menciona ${c.yellow(mencionadas)} — distinta a la fecha oficial`);
+    }
+    if (t.attachments.length) {
+        lines.push(`  ${c.dim("adjuntos:")} ${t.attachments.map((a) => a.filename).join(", ")}`);
+    }
+    if (t.url)
+        lines.push(`  ${c.gray(t.url)}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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