@wilm-ai/wilma-cli 0.0.11 → 1.2.0

package/README.md

@@ -16,11 +16,59 @@ 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] [--date YYYY-MM-DD] [--weekday mon|tue|wed|thu|fri|sat|sun] [--student <id|name>] [--all-students] [--json]
+```
+
+Examples:
+```bash
+# Specific day by date
+wilma schedule list --date 2026-02-25 --student "Stella" --json
+
+# Next Thursday (also accepts Finnish short forms like to/ke/pe)
+wilma schedule list --weekday thu --student "Stella" --json
+
+# Tomorrow
+wilma schedule list --when tomorrow --student "Stella" --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 +77,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

@@ -11,8 +11,13 @@ 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" },
 ];
@@ -140,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" },
@@ -151,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({
@@ -175,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" },
@@ -365,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) {
@@ -382,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) {
@@ -407,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) {
@@ -424,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) {
@@ -466,33 +495,113 @@ 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> [--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> [--student <id|name>] [--json]");
-    console.log("  wilma exams list [--limit 20] [--student <id|name>] [--all-students] [--json]");
-    console.log("  wilma update");
-    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",
+            date: flags.date,
+            weekday: flags.weekday,
+            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] [--date YYYY-MM-DD] [--weekday mon|tue|wed|thu|fri|sat|sun] [--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> [--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> [--student <id|name>] [--json]");
-    console.log("  wilma exams list [--limit 20] [--student <id|name>] [--all-students] [--json]");
     console.log("  wilma update");
     console.log("  wilma config clear");
     console.log("  wilma --help | -h");
@@ -522,7 +631,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) {
@@ -560,6 +672,29 @@ 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 (arg === "--date") {
+            flags.date = rest[i + 1];
+            i += 2;
+            continue;
+        }
+        if (arg === "--weekday") {
+            flags.weekday = rest[i + 1];
+            i += 2;
+            continue;
+        }
         if (!flags.id && !arg.startsWith("--")) {
             flags.id = arg;
             i += 1;
@@ -569,6 +704,83 @@ 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;
+}
+function parseIsoDateOrExit(raw) {
+    const value = (raw ?? "").trim();
+    // Accept YYYY-MM-DD only.
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        console.error(`Invalid date "${raw}". Expected YYYY-MM-DD.`);
+        process.exit(1);
+    }
+    // Validate date is real.
+    const d = new Date(value + "T12:00:00Z");
+    if (Number.isNaN(d.getTime())) {
+        console.error(`Invalid date "${raw}". Expected a real calendar date.`);
+        process.exit(1);
+    }
+    const iso = d.toISOString().slice(0, 10);
+    if (iso !== value) {
+        console.error(`Invalid date "${raw}". Expected a real calendar date.`);
+        process.exit(1);
+    }
+    return value;
+}
+function normalizeWeekdayOrExit(raw) {
+    const v = (raw ?? "").trim().toLowerCase();
+    const map = {
+        sun: 0,
+        su: 0,
+        sunday: 0,
+        mon: 1,
+        ma: 1,
+        monday: 1,
+        tue: 2,
+        ti: 2,
+        tuesday: 2,
+        wed: 3,
+        ke: 3,
+        wednesday: 3,
+        thu: 4,
+        to: 4,
+        thursday: 4,
+        fri: 5,
+        pe: 5,
+        friday: 5,
+        sat: 6,
+        la: 6,
+        saturday: 6,
+    };
+    const day = map[v];
+    if (day === undefined) {
+        console.error(`Invalid weekday "${raw}". Use mon|tue|wed|thu|fri|sat|sun (also accepts fi: ma|ti|ke|to|pe|la|su).`);
+        process.exit(1);
+    }
+    return day;
+}
+function nextDateForWeekday(rawWeekday) {
+    const target = normalizeWeekdayOrExit(rawWeekday);
+    const now = new Date();
+    // Use local time.
+    const today = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 12, 0, 0);
+    const current = today.getDay();
+    let delta = (target - current + 7) % 7;
+    // If you ask for e.g. "thu" on a Saturday, you'll get next Thursday.
+    // If you ask for today's weekday, you'll get today.
+    const d = new Date(today);
+    d.setDate(d.getDate() + delta);
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
 async function readPackageVersion() {
     const pkgPath = resolve(dirname(new URL(import.meta.url).pathname), "..", "package.json");
     const raw = await readFile(pkgPath, "utf-8");
@@ -726,6 +938,243 @@ 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 (opts.date && opts.weekday) {
+        console.error("Use either --date or --weekday, not both.");
+        process.exit(1);
+    }
+    if (opts.date) {
+        const parsed = parseIsoDateOrExit(opts.date);
+        startDate = endDate = parsed;
+    }
+    else if (opts.weekday) {
+        const parsed = nextDateForWeekday(opts.weekday);
+        startDate = endDate = parsed;
+    }
+    else 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 = !opts.date && !opts.weekday && when === "week"
+            ? { when, weekStart: startDate, weekEnd: endDate, lessons }
+            : { when: opts.date ? "date" : (opts.weekday ? "weekday" : when), date: startDate, lessons };
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    const prefix = opts.label ? `[${opts.label}] ` : "";
+    if (opts.date || opts.weekday) {
+        console.log(`\n${prefix}Schedule for ${startDate}`);
+    }
+    else 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);
@@ -909,6 +1358,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;
@@ -976,8 +1429,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));
@@ -986,11 +1439,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.11",
+  "version": "1.2.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,9 +8,17 @@
     "wilmai": "dist/index.js",
     "wilma": "dist/index.js"
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "echo 'add lint'",
+    "test": "echo 'add tests'",
+    "start": "node dist/index.js",
+    "prepack": "pnpm --filter @wilm-ai/wilma-client build && pnpm --filter @wilm-ai/wilma-cli build",
+    "test:live": "tsc -p tsconfig.json && node test/live.spec.mjs"
+  },
   "dependencies": {
     "@inquirer/prompts": "^5.3.8",
-    "@wilm-ai/wilma-client": "^0.0.4"
+    "@wilm-ai/wilma-client": "workspace:^"
   },
   "devDependencies": {
     "typescript": "^5.6.3"
@@ -21,12 +29,5 @@
   ],
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "lint": "echo 'add lint'",
-    "test": "echo 'add tests'",
-    "start": "node dist/index.js",
-    "test:live": "tsc -p tsconfig.json && node test/live.spec.mjs"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Wilm.ai
-
-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.