@wilm-ai/wilma-cli 1.1.0 → 1.2.0

package/README.md

@@ -26,7 +26,19 @@ Combines today's and tomorrow's schedule, upcoming exams, recent homework, news,
 
 ### Schedule
 ```bash
-wilma schedule list [--when today|tomorrow|week] [--student <id|name>] [--all-students] [--json]
+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

package/dist/index.js

@@ -518,6 +518,8 @@ async function handleCommand(args, config) {
         });
         await outputSchedule(perStudentClient, {
             when: flags.when ?? "week",
+            date: flags.date,
+            weekday: flags.weekday,
             json: flags.json,
             label: studentInfo?.name ?? undefined,
         });
@@ -591,7 +593,7 @@ async function handleCommand(args, config) {
 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 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]");
@@ -683,6 +685,16 @@ function parseArgs(args) {
             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;
@@ -704,6 +716,71 @@ function parseReadId(raw, entity) {
     }
     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");
@@ -894,7 +971,19 @@ async function outputSchedule(client, opts) {
     const when = opts.when || "week";
     let startDate;
     let endDate;
-    if (when === "today") {
+    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") {
@@ -905,14 +994,17 @@ async function outputSchedule(client, opts) {
     }
     const lessons = overview.schedule.filter((l) => l.date >= startDate && l.date <= endDate);
     if (opts.json) {
-        const result = when === "week"
+        const result = !opts.date && !opts.weekday && when === "week"
             ? { when, weekStart: startDate, weekEnd: endDate, lessons }
-            : { when, date: startDate, 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 (when === "today") {
+    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") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wilm-ai/wilma-cli",
-  "version": "1.1.0",
+  "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": "^1.1.0"
+    "@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.