@wilm-ai/wilma-cli 0.0.10 → 1.1.0

package/README.md

@@ -16,11 +16,47 @@ wilma
 wilmai
 ```
 
-## Non-interactive (agent-friendly)
+## Commands
+
+### Daily briefing
+```bash
+wilma summary [--days 7] [--student <id|name>] [--all-students] [--json]
+```
+Combines today's and tomorrow's schedule, upcoming exams, recent homework, news, and messages into one view. Designed for AI agents to surface what matters.
+
+### Schedule
+```bash
+wilma schedule list [--when today|tomorrow|week] [--student <id|name>] [--all-students] [--json]
+```
+
+### Homework
+```bash
+wilma homework list [--limit 10] [--student <id|name>] [--all-students] [--json]
+```
+
+### Upcoming exams
+```bash
+wilma exams list [--limit 20] [--student <id|name>] [--all-students] [--json]
+```
+
+### Exam grades
+```bash
+wilma grades list [--limit 20] [--student <id|name>] [--all-students] [--json]
+```
+
+### News and messages
+```bash
+wilma news list [--limit 20] [--student <id|name>] [--all-students] [--json]
+wilma news read <id> [--student <id|name>] [--json]
+wilma messages list [--folder inbox] [--limit 20] [--student <id|name>] [--all-students] [--json]
+wilma messages read <id> [--student <id|name>] [--json]
+```
+
+### Other
 ```bash
-wilma kids list --json
-wilma news list --all --json
-wilma messages list --folder inbox --all --json
+wilma kids list [--json]
+wilma update
+wilma config clear
 ```
 
 ## Config
@@ -29,4 +65,5 @@ Use `wilma config clear` to remove it. Override with `WILMAI_CONFIG_PATH`.
 
 ## Notes
 - Credentials are stored with lightweight obfuscation for convenience.
-- For multi-child accounts, you can pass `--student <id>` or `--all`.
+- For multi-child accounts, you can pass `--student <id|name>` or `--all-students`.
+- All list commands support `--json` for agent-friendly structured output.

package/dist/index.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import { emitKeypressEvents } from "node:readline";
 import { select, input, password } from "@inquirer/prompts";
-import { readFile } from "node:fs/promises";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { spawn } from "node:child_process";
 import { dirname, resolve } from "node:path";
 import { WilmaClient, listTenants, } from "@wilm-ai/wilma-client";
 import { clearConfig, getConfigPath, loadConfig, obfuscateSecret, revealSecret, saveConfig, } from "./config.js";
@@ -10,20 +11,33 @@ if (process.stdin.isTTY) {
     emitKeypressEvents(process.stdin);
 }
 const ACTIONS = [
+    { value: "summary", name: "Daily summary" },
+    { value: "schedule-today", name: "Today's schedule" },
+    { value: "schedule-tomorrow", name: "Tomorrow's schedule" },
+    { value: "homework", name: "Recent homework" },
+    { value: "exams", name: "Upcoming exams" },
+    { value: "grades", name: "Exam grades" },
     { value: "news", name: "List news" },
-    { value: "exams", name: "List exams" },
     { value: "messages", name: "List messages" },
     { value: "exit", name: "Exit" },
 ];
 async function main() {
     const args = process.argv.slice(2);
+    // Fire version check early (non-blocking)
+    const updateCheck = checkForUpdate();
     if (args.includes("--help") || args.includes("-h")) {
         printUsage();
+        await showUpdateNotice(updateCheck);
         return;
     }
     if (args.includes("--version") || args.includes("-v")) {
         const version = await readPackageVersion();
         console.log(version);
+        await showUpdateNotice(updateCheck);
+        return;
+    }
+    if (args[0] === "update") {
+        await handleUpdate();
         return;
     }
     if (args[0] === "config" && args[1] === "clear") {
@@ -34,9 +48,11 @@ async function main() {
     const config = await loadConfig();
     if (args.length) {
         await handleCommand(args, config);
+        await showUpdateNotice(updateCheck);
         return;
     }
     await runInteractive(config);
+    await showUpdateNotice(updateCheck);
 }
 async function chooseProfile(config) {
     if (config.profiles.length) {
@@ -129,6 +145,7 @@ async function runInteractive(config) {
         const client = await WilmaClient.login(profile);
         let nextAction = await selectOrCancel({
             message: "What do you want to view?",
+            pageSize: 15,
             choices: [
                 ...ACTIONS.filter((a) => a.value !== "exit"),
                 { value: "back", name: "Back to students" },
@@ -140,12 +157,32 @@ async function runInteractive(config) {
             continue;
         }
         while (nextAction !== "exit" && nextAction !== "back") {
-            if (nextAction === "news") {
-                await selectNewsToRead(client);
+            if (nextAction === "summary") {
+                console.clear();
+                await outputSummary(client, { days: 7, json: false });
+            }
+            if (nextAction === "schedule-today") {
+                console.clear();
+                await outputSchedule(client, { when: "today", json: false });
+            }
+            if (nextAction === "schedule-tomorrow") {
+                console.clear();
+                await outputSchedule(client, { when: "tomorrow", json: false });
+            }
+            if (nextAction === "homework") {
+                console.clear();
+                await outputHomework(client, { limit: 10, json: false });
             }
             if (nextAction === "exams") {
                 console.clear();
-                await outputExams(client, { limit: 20, json: false });
+                await outputUpcomingExams(client, { limit: 20, json: false });
+            }
+            if (nextAction === "grades") {
+                console.clear();
+                await outputGrades(client, { limit: 20, json: false });
+            }
+            if (nextAction === "news") {
+                await selectNewsToRead(client);
             }
             if (nextAction === "messages") {
                 const folder = await selectOrCancel({
@@ -164,6 +201,7 @@ async function runInteractive(config) {
             }
             nextAction = await selectOrCancel({
                 message: "What next?",
+                pageSize: 15,
                 choices: [
                     ...ACTIONS.filter((a) => a.value !== "exit"),
                     { value: "back", name: "Back to students" },
@@ -354,6 +392,7 @@ async function handleCommand(args, config) {
     }
     if (command === "news") {
         if (subcommand === "read" && flags.id) {
+            const newsId = parseReadId(flags.id, "news");
             if (!flags.student) {
                 const students = await getStudentsForCommand(profile, config);
                 if (students.length > 1) {
@@ -371,7 +410,7 @@ async function handleCommand(args, config) {
                 ...profile,
                 studentNumber: studentInfo?.studentNumber ?? profile.studentNumber,
             });
-            await outputNewsItem(perStudentClient, Number(flags.id), flags.json);
+            await outputNewsItem(perStudentClient, newsId, flags.json);
             return;
         }
         if (flags.allStudents) {
@@ -396,6 +435,7 @@ async function handleCommand(args, config) {
     }
     if (command === "messages") {
         if (subcommand === "read" && flags.id) {
+            const messageId = parseReadId(flags.id, "message");
             if (!flags.student) {
                 const students = await getStudentsForCommand(profile, config);
                 if (students.length > 1) {
@@ -413,7 +453,7 @@ async function handleCommand(args, config) {
                 ...profile,
                 studentNumber: studentInfo?.studentNumber ?? profile.studentNumber,
             });
-            await outputMessageItem(perStudentClient, Number(flags.id), flags.json);
+            await outputMessageItem(perStudentClient, messageId, flags.json);
             return;
         }
         if (flags.allStudents) {
@@ -455,32 +495,112 @@ async function handleCommand(args, config) {
             ...profile,
             studentNumber: studentInfo?.studentNumber ?? profile.studentNumber,
         });
-        await outputExams(perStudentClient, {
+        await outputUpcomingExams(perStudentClient, {
             limit: flags.limit ?? 20,
             json: flags.json,
             label: studentInfo?.name ?? undefined,
         });
         return;
     }
-    console.log("Usage:");
-    console.log("  wilma kids list [--json]");
-    console.log("  wilma news list [--limit 20] [--student <id|name>] [--all-students] [--json]");
-    console.log("  wilma news read <id> [--json]");
-    console.log("  wilma messages list [--folder inbox] [--limit 20] [--student <id|name>] [--all-students] [--json]");
-    console.log("  wilma messages read <id> [--json]");
-    console.log("  wilma exams list [--limit 20] [--student <id|name>] [--all-students] [--json]");
-    console.log("  wilma config clear");
-    console.log("  wilma --help | -h");
-    console.log("  wilma --version | -v");
+    if (command === "schedule") {
+        if (flags.allStudents) {
+            await outputAllOverviewCommand(profile, config, "schedule", flags);
+            return;
+        }
+        const studentInfo = await resolveStudentForFlags(profile, config, flags.student);
+        if (!studentInfo && !profile.studentNumber) {
+            await printStudentSelectionHelp(profile, config);
+            return;
+        }
+        const perStudentClient = await WilmaClient.login({
+            ...profile,
+            studentNumber: studentInfo?.studentNumber ?? profile.studentNumber,
+        });
+        await outputSchedule(perStudentClient, {
+            when: flags.when ?? "week",
+            json: flags.json,
+            label: studentInfo?.name ?? undefined,
+        });
+        return;
+    }
+    if (command === "homework") {
+        if (flags.allStudents) {
+            await outputAllOverviewCommand(profile, config, "homework", flags);
+            return;
+        }
+        const studentInfo = await resolveStudentForFlags(profile, config, flags.student);
+        if (!studentInfo && !profile.studentNumber) {
+            await printStudentSelectionHelp(profile, config);
+            return;
+        }
+        const perStudentClient = await WilmaClient.login({
+            ...profile,
+            studentNumber: studentInfo?.studentNumber ?? profile.studentNumber,
+        });
+        await outputHomework(perStudentClient, {
+            limit: flags.limit ?? 10,
+            json: flags.json,
+            label: studentInfo?.name ?? undefined,
+        });
+        return;
+    }
+    if (command === "grades") {
+        if (flags.allStudents) {
+            await outputAllOverviewCommand(profile, config, "grades", flags);
+            return;
+        }
+        const studentInfo = await resolveStudentForFlags(profile, config, flags.student);
+        if (!studentInfo && !profile.studentNumber) {
+            await printStudentSelectionHelp(profile, config);
+            return;
+        }
+        const perStudentClient = await WilmaClient.login({
+            ...profile,
+            studentNumber: studentInfo?.studentNumber ?? profile.studentNumber,
+        });
+        await outputGrades(perStudentClient, {
+            limit: flags.limit ?? 20,
+            json: flags.json,
+            label: studentInfo?.name ?? undefined,
+        });
+        return;
+    }
+    if (command === "summary") {
+        if (flags.allStudents) {
+            await outputAllOverviewCommand(profile, config, "summary", flags);
+            return;
+        }
+        const studentInfo = await resolveStudentForFlags(profile, config, flags.student);
+        if (!studentInfo && !profile.studentNumber) {
+            await printStudentSelectionHelp(profile, config);
+            return;
+        }
+        const perStudentClient = await WilmaClient.login({
+            ...profile,
+            studentNumber: studentInfo?.studentNumber ?? profile.studentNumber,
+        });
+        await outputSummary(perStudentClient, {
+            days: flags.days ?? 7,
+            json: flags.json,
+            label: studentInfo?.name ?? undefined,
+        });
+        return;
+    }
+    printUsage();
 }
 function printUsage() {
     console.log("Usage:");
+    console.log("  wilma summary [--days 7] [--student <id|name>] [--all-students] [--json]");
+    console.log("  wilma schedule list [--when today|tomorrow|week] [--student <id|name>] [--all-students] [--json]");
+    console.log("  wilma homework list [--limit 10] [--student <id|name>] [--all-students] [--json]");
+    console.log("  wilma exams list [--limit 20] [--student <id|name>] [--all-students] [--json]");
+    console.log("  wilma grades list [--limit 20] [--student <id|name>] [--all-students] [--json]");
     console.log("  wilma kids list [--json]");
     console.log("  wilma news list [--limit 20] [--student <id|name>] [--all-students] [--json]");
-    console.log("  wilma news read <id> [--json]");
+    console.log("  wilma news read <id> [--student <id|name>] [--json]");
     console.log("  wilma messages list [--folder inbox] [--limit 20] [--student <id|name>] [--all-students] [--json]");
-    console.log("  wilma messages read <id> [--json]");
-    console.log("  wilma exams list [--limit 20] [--student <id|name>] [--all-students] [--json]");
+    console.log("  wilma messages read <id> [--student <id|name>] [--json]");
+    console.log("  wilma update");
     console.log("  wilma config clear");
     console.log("  wilma --help | -h");
     console.log("  wilma --version | -v");
@@ -509,7 +629,10 @@ async function getProfileForCommandNonInteractive(config, flags) {
     };
 }
 function parseArgs(args) {
-    const [command, subcommand, ...rest] = args;
+    const [command, rawSubcommand, ...rawRest] = args;
+    // If "subcommand" is actually a flag, push it back into rest
+    const subcommand = rawSubcommand?.startsWith("--") ? undefined : rawSubcommand;
+    const rest = rawSubcommand?.startsWith("--") ? [rawSubcommand, ...rawRest] : rawRest;
     const flags = {};
     let i = 0;
     while (i < rest.length) {
@@ -547,6 +670,19 @@ function parseArgs(args) {
             i += 2;
             continue;
         }
+        if (arg === "--when") {
+            flags.when = rest[i + 1];
+            i += 2;
+            continue;
+        }
+        if (arg === "--days") {
+            const value = Number(rest[i + 1]);
+            if (!Number.isNaN(value)) {
+                flags.days = value;
+            }
+            i += 2;
+            continue;
+        }
         if (!flags.id && !arg.startsWith("--")) {
             flags.id = arg;
             i += 1;
@@ -556,12 +692,133 @@ function parseArgs(args) {
     }
     return { command, subcommand, flags };
 }
+function parseReadId(raw, entity) {
+    if (!raw) {
+        console.error(`Missing ${entity} id.`);
+        process.exit(1);
+    }
+    const id = Number(raw);
+    if (!Number.isInteger(id) || id <= 0) {
+        console.error(`Invalid ${entity} id "${raw}". Expected a positive integer.`);
+        process.exit(1);
+    }
+    return id;
+}
 async function readPackageVersion() {
     const pkgPath = resolve(dirname(new URL(import.meta.url).pathname), "..", "package.json");
     const raw = await readFile(pkgPath, "utf-8");
     const data = JSON.parse(raw);
     return data.version ?? "unknown";
 }
+async function handleUpdate() {
+    const currentVersion = await readPackageVersion();
+    console.log(`Current version: ${currentVersion}`);
+    console.log("Updating @wilm-ai/wilma-cli...\n");
+    return new Promise((resolve, reject) => {
+        const child = spawn("npm", ["install", "-g", "@wilm-ai/wilma-cli@latest"], {
+            stdio: "inherit",
+            shell: true,
+        });
+        child.on("error", (err) => {
+            if (err.code === "ENOENT") {
+                console.error("Error: npm not found. Please install npm and try again.");
+            }
+            else {
+                console.error("Update failed:", err.message);
+            }
+            reject(err);
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                console.log("\nUpdate complete.");
+                resolve();
+            }
+            else {
+                console.error(`\nnpm exited with code ${code}`);
+                reject(new Error(`npm exited with code ${code}`));
+            }
+        });
+    });
+}
+// --- Version check / update notification ---
+const VERSION_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+function getVersionCachePath() {
+    return resolve(dirname(getConfigPath()), "version-check.json");
+}
+async function readVersionCache() {
+    try {
+        const raw = await readFile(getVersionCachePath(), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeVersionCache(cache) {
+    const cachePath = getVersionCachePath();
+    await mkdir(dirname(cachePath), { recursive: true });
+    await writeFile(cachePath, JSON.stringify(cache), "utf-8");
+}
+async function checkForUpdate() {
+    try {
+        const cache = await readVersionCache();
+        if (cache && Date.now() - cache.checkedAt < VERSION_CHECK_INTERVAL_MS) {
+            return cache.latestVersion;
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000);
+        try {
+            const response = await fetch("https://registry.npmjs.org/@wilm-ai/wilma-cli/latest", { signal: controller.signal });
+            clearTimeout(timeout);
+            if (!response.ok)
+                return cache?.latestVersion ?? null;
+            const data = (await response.json());
+            const latestVersion = data.version ?? null;
+            if (latestVersion) {
+                await writeVersionCache({ latestVersion, checkedAt: Date.now() });
+            }
+            return latestVersion;
+        }
+        catch {
+            clearTimeout(timeout);
+            return cache?.latestVersion ?? null;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+function isNewerVersion(latest, current) {
+    const latestParts = latest.split(".").map(Number);
+    const currentParts = current.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        const l = latestParts[i] ?? 0;
+        const c = currentParts[i] ?? 0;
+        if (l > c)
+            return true;
+        if (l < c)
+            return false;
+    }
+    return false;
+}
+async function showUpdateNotice(versionCheckPromise) {
+    try {
+        const latestVersion = await Promise.race([
+            versionCheckPromise,
+            new Promise((resolve) => setTimeout(() => resolve(null), 1000)),
+        ]);
+        if (!latestVersion)
+            return;
+        const currentVersion = await readPackageVersion();
+        if (isNewerVersion(latestVersion, currentVersion)) {
+            process.stderr.write(`\nUpdate available: ${currentVersion} → ${latestVersion}\n` +
+                `Run "wilma update" to update.\n`);
+        }
+    }
+    catch {
+        // Silently ignore any errors
+    }
+}
 async function outputNews(client, opts) {
     const news = await client.news.list();
     const slice = news.slice(0, opts.limit);
@@ -604,6 +861,228 @@ async function outputExams(client, opts) {
         console.log(`- ${prefix}${date} ${compactText(exam.subject)}`);
     });
 }
+/* ------------------------------------------------------------------ */
+/*  Overview-powered output functions                                  */
+/* ------------------------------------------------------------------ */
+function todayString() {
+    const d = new Date();
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+function nextSchoolDay(from) {
+    const d = from ? new Date(from + "T12:00:00") : new Date();
+    d.setDate(d.getDate() + 1);
+    // Skip Saturday (6) and Sunday (0)
+    while (d.getDay() === 0 || d.getDay() === 6) {
+        d.setDate(d.getDate() + 1);
+    }
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+function currentWeekBounds() {
+    const now = new Date();
+    const dayOfWeek = now.getDay(); // 0=Sun, 1=Mon, ...
+    const diffToMonday = dayOfWeek === 0 ? -6 : 1 - dayOfWeek;
+    const monday = new Date(now);
+    monday.setDate(now.getDate() + diffToMonday);
+    const friday = new Date(monday);
+    friday.setDate(monday.getDate() + 4);
+    const fmt = (d) => `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+    return [fmt(monday), fmt(friday)];
+}
+const DAY_NAMES = ["Su", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+async function outputSchedule(client, opts) {
+    const overview = await client.overview.get();
+    const when = opts.when || "week";
+    let startDate;
+    let endDate;
+    if (when === "today") {
+        startDate = endDate = todayString();
+    }
+    else if (when === "tomorrow") {
+        startDate = endDate = nextSchoolDay();
+    }
+    else {
+        [startDate, endDate] = currentWeekBounds();
+    }
+    const lessons = overview.schedule.filter((l) => l.date >= startDate && l.date <= endDate);
+    if (opts.json) {
+        const result = when === "week"
+            ? { when, weekStart: startDate, weekEnd: endDate, lessons }
+            : { when, date: startDate, lessons };
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    const prefix = opts.label ? `[${opts.label}] ` : "";
+    if (when === "today") {
+        console.log(`\n${prefix}Schedule for today (${startDate})`);
+    }
+    else if (when === "tomorrow") {
+        console.log(`\n${prefix}Schedule for tomorrow (${startDate})`);
+    }
+    else {
+        console.log(`\n${prefix}Schedule for ${startDate} – ${endDate}`);
+    }
+    if (!lessons.length) {
+        console.log("  No lessons found.");
+        return;
+    }
+    let currentDate = "";
+    for (const l of lessons) {
+        if (l.date !== currentDate) {
+            currentDate = l.date;
+            const d = new Date(l.date + "T12:00:00");
+            console.log(`  ${DAY_NAMES[d.getDay()]} ${l.date}`);
+        }
+        const teacher = l.teacherCode ? ` - ${l.teacher}` : "";
+        console.log(`    ${l.start}-${l.end}  ${l.subject}${teacher}`);
+    }
+}
+async function outputHomework(client, opts) {
+    const overview = await client.overview.get();
+    const slice = overview.homework.slice(0, opts.limit);
+    if (opts.json) {
+        console.log(JSON.stringify(slice, null, 2));
+        return;
+    }
+    const prefix = opts.label ? `[${opts.label}] ` : "";
+    console.log(`\n${prefix}Homework (${overview.homework.length})`);
+    slice.forEach((hw) => {
+        const text = compactText(hw.homework);
+        console.log(`- ${hw.date}  ${hw.subject}: ${text}`);
+    });
+}
+async function outputUpcomingExams(client, opts) {
+    const overview = await client.overview.get();
+    const slice = overview.upcomingExams.slice(0, opts.limit);
+    if (opts.json) {
+        console.log(JSON.stringify(slice, null, 2));
+        return;
+    }
+    const prefix = opts.label ? `[${opts.label}] ` : "";
+    console.log(`\n${prefix}Upcoming exams (${overview.upcomingExams.length})`);
+    slice.forEach((exam) => {
+        const topic = exam.topic ? ` — ${compactText(exam.topic)}` : "";
+        console.log(`- ${exam.date}  ${exam.subject}: ${exam.name}${topic}`);
+    });
+}
+async function outputGrades(client, opts) {
+    const overview = await client.overview.get();
+    const slice = overview.grades.slice(0, opts.limit);
+    if (opts.json) {
+        console.log(JSON.stringify(slice, null, 2));
+        return;
+    }
+    const prefix = opts.label ? `[${opts.label}] ` : "";
+    console.log(`\n${prefix}Grades (${overview.grades.length})`);
+    slice.forEach((g) => {
+        console.log(`- ${g.date}  ${g.subject}: ${g.name} — ${g.grade}`);
+    });
+}
+async function outputSummary(client, opts) {
+    const [overview, news, messages] = await Promise.all([
+        client.overview.get(),
+        client.news.list(),
+        client.messages.list("inbox"),
+    ]);
+    const summary = buildSummaryData(overview, news, messages, opts.days, opts.label);
+    if (opts.json) {
+        console.log(JSON.stringify(summary, null, 2));
+        return;
+    }
+    const label = summary.student ? ` for ${summary.student}` : "";
+    console.log(`\nSummary${label} (${summary.today})`);
+    console.log(`\nTODAY (${summary.today})`);
+    if (summary.todaySchedule.length) {
+        summary.todaySchedule.forEach((l) => {
+            console.log(`  ${l.start}-${l.end}  ${l.subject} (${l.subjectCode})`);
+        });
+    }
+    else {
+        console.log("  No lessons today.");
+    }
+    console.log(`\nTOMORROW (${summary.tomorrow})`);
+    if (summary.tomorrowSchedule.length) {
+        summary.tomorrowSchedule.forEach((l) => {
+            console.log(`  ${l.start}-${l.end}  ${l.subject} (${l.subjectCode})`);
+        });
+    }
+    else {
+        console.log("  No lessons tomorrow.");
+    }
+    if (summary.upcomingExams.length) {
+        console.log("\nUPCOMING EXAMS");
+        summary.upcomingExams.forEach((exam) => {
+            const topic = exam.topic ? ` — ${compactText(exam.topic)}` : "";
+            console.log(`  ${exam.date}  ${exam.subject}: ${exam.name}${topic}`);
+        });
+    }
+    if (summary.recentHomework.length) {
+        console.log("\nRECENT HOMEWORK");
+        summary.recentHomework.forEach((hw) => {
+            console.log(`  ${hw.date}  ${hw.subject}: ${compactText(hw.homework)}`);
+        });
+    }
+    if (summary.recentNews.length) {
+        console.log(`\nNEWS (last ${opts.days} days)`);
+        summary.recentNews.forEach((n) => {
+            const date = n.published ? n.published.slice(0, 10) : "";
+            console.log(`  ${date}  ${compactText(n.title)} (id:${n.wilmaId})`);
+        });
+    }
+    if (summary.recentMessages.length) {
+        console.log(`\nMESSAGES (last ${opts.days} days)`);
+        summary.recentMessages.forEach((m) => {
+            const date = m.sentAt.slice(0, 10);
+            console.log(`  ${date}  ${compactText(m.subject)} (id:${m.wilmaId})`);
+        });
+    }
+}
+function buildSummaryData(overview, news, messages, days, studentLabel) {
+    const today = todayString();
+    const tomorrow = nextSchoolDay();
+    const cutoffDate = (() => {
+        const d = new Date();
+        d.setDate(d.getDate() - days);
+        return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+    })();
+    const homeworkCutoff = (() => {
+        const d = new Date();
+        d.setDate(d.getDate() - 3);
+        return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+    })();
+    const todaySchedule = overview.schedule.filter((l) => l.date === today);
+    const tomorrowSchedule = overview.schedule.filter((l) => l.date === tomorrow);
+    const upcomingExams = overview.upcomingExams;
+    const recentHomework = overview.homework.filter((h) => h.date >= homeworkCutoff);
+    const recentNews = news
+        .filter((n) => n.published && n.published.toISOString().slice(0, 10) >= cutoffDate)
+        .slice(0, 5)
+        .map((n) => ({
+        wilmaId: n.wilmaId,
+        title: n.title,
+        published: n.published?.toISOString() ?? null,
+    }));
+    const recentMessages = messages
+        .filter((m) => m.sentAt.toISOString().slice(0, 10) >= cutoffDate)
+        .slice(0, 5)
+        .map((m) => ({
+        wilmaId: m.wilmaId,
+        subject: m.subject,
+        sentAt: m.sentAt.toISOString(),
+        senderName: m.senderName ?? null,
+    }));
+    return {
+        generatedAt: new Date().toISOString(),
+        student: studentLabel ?? null,
+        today,
+        tomorrow,
+        todaySchedule,
+        tomorrowSchedule,
+        upcomingExams,
+        recentHomework,
+        recentNews,
+        recentMessages,
+    };
+}
 async function outputMessages(client, opts) {
     const messages = await client.messages.list(opts.folder);
     const slice = messages.slice(0, opts.limit);
@@ -787,6 +1266,10 @@ async function resolveStudentForFlags(profile, config, student) {
         const exact = students.find((s) => s.studentNumber === student);
         if (exact)
             return exact;
+        const needle = student.toLowerCase();
+        const substring = students.find((s) => s.name.toLowerCase().includes(needle));
+        if (substring)
+            return substring;
         const match = students.find((s) => fuzzyIncludes(s.name, student));
         if (match)
             return match;
@@ -854,8 +1337,8 @@ async function outputAllExams(profile, config, limit, json) {
     const results = [];
     for (const student of students) {
         const client = await WilmaClient.login({ ...profile, studentNumber: student.studentNumber });
-        const exams = await client.exams.list();
-        results.push({ student, items: exams.slice(0, limit) });
+        const overview = await client.overview.get();
+        results.push({ student, items: overview.upcomingExams.slice(0, limit) });
     }
     if (json) {
         console.log(JSON.stringify({ students: results }, null, 2));
@@ -864,11 +1347,101 @@ async function outputAllExams(profile, config, limit, json) {
     results.forEach((entry) => {
         console.log(`\n[${entry.student.name}]`);
         entry.items.forEach((exam) => {
-            const date = exam.examDate.toISOString().slice(0, 10);
-            console.log(`- ${date} ${exam.subject}`);
+            const topic = exam.topic ? ` — ${compactText(exam.topic)}` : "";
+            console.log(`- ${exam.date} ${exam.subject}: ${exam.name}${topic}`);
         });
     });
 }
+async function outputAllOverviewCommand(profile, config, command, flags) {
+    const students = await getStudentsForCommand(profile, config);
+    if (command === "summary") {
+        if (flags.json) {
+            const summaries = [];
+            for (const student of students) {
+                const client = await WilmaClient.login({ ...profile, studentNumber: student.studentNumber });
+                const [overview, news, messages] = await Promise.all([
+                    client.overview.get(),
+                    client.news.list(),
+                    client.messages.list("inbox"),
+                ]);
+                summaries.push({
+                    student,
+                    summary: buildSummaryData(overview, news, messages, flags.days ?? 7, student.name),
+                });
+            }
+            console.log(JSON.stringify({
+                generatedAt: new Date().toISOString(),
+                students: summaries,
+            }, null, 2));
+            return;
+        }
+        // Human-readable summary output per student
+        for (const student of students) {
+            const client = await WilmaClient.login({ ...profile, studentNumber: student.studentNumber });
+            await outputSummary(client, {
+                days: flags.days ?? 7,
+                json: false,
+                label: student.name,
+            });
+        }
+        return;
+    }
+    const results = [];
+    for (const student of students) {
+        const client = await WilmaClient.login({ ...profile, studentNumber: student.studentNumber });
+        const overview = await client.overview.get();
+        if (command === "schedule") {
+            const when = flags.when || "week";
+            let startDate, endDate;
+            if (when === "today") {
+                startDate = endDate = todayString();
+            }
+            else if (when === "tomorrow") {
+                startDate = endDate = nextSchoolDay();
+            }
+            else {
+                [startDate, endDate] = currentWeekBounds();
+            }
+            results.push({
+                student,
+                data: overview.schedule.filter((l) => l.date >= startDate && l.date <= endDate),
+            });
+        }
+        else if (command === "homework") {
+            results.push({ student, data: overview.homework.slice(0, flags.limit ?? 10) });
+        }
+        else if (command === "grades") {
+            results.push({ student, data: overview.grades.slice(0, flags.limit ?? 20) });
+        }
+    }
+    if (flags.json) {
+        console.log(JSON.stringify({ students: results.map((r) => ({ student: r.student, items: r.data })) }, null, 2));
+        return;
+    }
+    for (const r of results) {
+        console.log(`\n[${r.student.name}]`);
+        const items = r.data;
+        if (!items.length) {
+            console.log("  (none)");
+            continue;
+        }
+        if (command === "schedule") {
+            for (const l of items) {
+                console.log(`  ${l.date} ${l.start}-${l.end}  ${l.subject} - ${l.teacher}`);
+            }
+        }
+        else if (command === "homework") {
+            for (const hw of items) {
+                console.log(`  ${hw.date}  ${hw.subject}: ${compactText(hw.homework)}`);
+            }
+        }
+        else if (command === "grades") {
+            for (const g of items) {
+                console.log(`  ${g.date}  ${g.subject}: ${g.name} — ${g.grade}`);
+            }
+        }
+    }
+}
 async function printStudentSelectionHelp(profile, config) {
     const students = await getStudentsForCommand(profile, config);
     console.error("Multiple students found. Use --student <id|name> or --all-students.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wilm-ai/wilma-cli",
-  "version": "0.0.10",
+  "version": "1.1.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^5.3.8",
-    "@wilm-ai/wilma-client": "^0.0.4"
+    "@wilm-ai/wilma-client": "^1.1.0"
   },
   "devDependencies": {
     "typescript": "^5.6.3"