@wilm-ai/wilma-cli 2.1.0 → 2.1.1

package/README.md

@@ -72,7 +72,7 @@ wilma find-school <city or school>
 
 ## Other
 ```bash
-wilma update                       # commands say on stderr when a newer version is out (checked once a day; WILMAI_NO_UPDATE_CHECK=1 turns it off)
+wilma update                       # when a newer version is out, a command says so on stderr, at most once a day (WILMAI_NO_UPDATE_CHECK=1 turns it off)
 wilma config clear                 # deletes every saved login and session
 wilma --version
 ```

package/dist/index.js

@@ -17,7 +17,7 @@ import { ENV_VARS, isMfaFailure, mfaCallbackFor, resolveAccounts, saveLogin, ver
 import { createUniqueDownloadFile } from "./downloads.js";
 import { openBrowser, startLoginServer } from "./login-server.js";
 import { runMcpServer } from "./mcp.js";
-import { cliUpdateNotice, isNewerVersion, latestWithin, startUpdateCheck, updateChecksEnabled } from "./update-check.js";
+import { claimNotice, cliUpdateNotice, isNewerVersion, latestWithin, startUpdateCheck, updateChecksEnabled } from "./update-check.js";
 import { toAgentJson } from "./output-json.js";
 import { clearSessions, fileSessionStore } from "./session-store.js";
 import { normalizeTenantUrl, resolveTenant, searchTenants } from "./tenant-search.js";
@@ -757,7 +757,7 @@ async function showUpdateNotice(check) {
         if (!latestVersion)
             return;
         const currentVersion = await readPackageVersion();
-        if (isNewerVersion(latestVersion, currentVersion)) {
+        if (isNewerVersion(latestVersion, currentVersion) && (await claimNotice(latestVersion))) {
             process.stderr.write(`\n${cliUpdateNotice(currentVersion, latestVersion)}\n`);
         }
     }

package/dist/update-check.d.ts

@@ -8,6 +8,8 @@ export declare function installKind(env?: NodeJS.ProcessEnv, scriptPath?: string
 export declare function updateChecksEnabled(env?: NodeJS.ProcessEnv): boolean;
 export declare function isNewerVersion(latest: string, current: string): boolean;
 /** The CLI's notice, for a person or an agent reading stderr. */
+/** Release notes: a wilm.ai redirect, so the target can move without a CLI release. */
+export declare const CHANGES_URL = "https://wilm.ai/changes";
 export declare function cliUpdateNotice(current: string, latest: string): string;
 /** The note the MCP server adds for the assistant, who passes it on. */
 export declare function mcpUpdateNote(kind: InstallKind, current: string, latest: string): string;
@@ -23,5 +25,11 @@ export interface UpdateCheck {
  * a timeout on every command.
  */
 export declare function startUpdateCheck(): UpdateCheck;
+/**
+ * Whether to show the CLI's notice for `latest` now, and if so, record it: at
+ * most once a day, and right away for a version not announced before. An
+ * agent's morning run of ten commands should see it once, not ten times.
+ */
+export declare function claimNotice(latest: string, now?: number): Promise<boolean>;
 /** The latest version if the check has an answer within `waitMs`, else null. */
 export declare function latestWithin(check: UpdateCheck, waitMs: number): Promise<string | null>;

package/dist/update-check.js

@@ -3,10 +3,10 @@ import { dirname, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { getConfigPath } from "./config.js";
 /*
- * "A newer WilmAI is available." The CLI prints it on stderr (people in a
- * terminal and agents like OpenClaw both read it there); the MCP server adds it
- * once to a tool result so the assistant can tell the user. How to update
- * depends on how WilmAI was installed.
+ * "A newer WilmAI is available." The CLI prints it on stderr at most once a day
+ * (people in a terminal and agents like OpenClaw both read it there); the MCP
+ * server adds it once to a tool result so the assistant can tell the user. How
+ * to update depends on how WilmAI was installed.
  */
 const VERSION_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 export function installKind(env = process.env, scriptPath = fileURLToPath(import.meta.url)) {
@@ -34,15 +34,17 @@ export function isNewerVersion(latest, current) {
     return false;
 }
 /** The CLI's notice, for a person or an agent reading stderr. */
+/** Release notes: a wilm.ai redirect, so the target can move without a CLI release. */
+export const CHANGES_URL = "https://wilm.ai/changes";
 export function cliUpdateNotice(current, latest) {
-    return `Update available: ${current} → ${latest}\nRun "wilma update" to update.`;
+    return `Update available: ${current} → ${latest}\nWhat's new: ${CHANGES_URL}\nRun "wilma update" to update.`;
 }
 /** The note the MCP server adds for the assistant, who passes it on. */
 export function mcpUpdateNote(kind, current, latest) {
     const how = kind === "claude-desktop"
         ? "download https://wilm.ai/get/claude and open the file; Claude Desktop asks to install it"
         : 'run "wilma update" in a terminal';
-    return `Update note: WilmAI ${latest} is available (this computer has ${current}). After answering, tell the user in one sentence that they can update: ${how}.`;
+    return `Update note: WilmAI ${latest} is available (this computer has ${current}; what's new: ${CHANGES_URL}). After answering, tell the user in one sentence that they can update: ${how}.`;
 }
 function versionCachePath() {
     return resolve(dirname(getConfigPath()), "version-check.json");
@@ -78,13 +80,13 @@ export function startUpdateCheck() {
             const response = await fetch("https://registry.npmjs.org/@wilm-ai/wilma-cli/latest", { signal: controller.signal });
             const data = response.ok ? (await response.json()) : {};
             const latestVersion = data.version ?? cache?.latestVersion ?? null;
-            await writeVersionCache({ latestVersion, checkedAt: Date.now() });
+            await writeVersionCache({ ...cache, latestVersion, checkedAt: Date.now() });
             return latestVersion;
         }
         catch {
             // Cancelled because the command finished: try again next time.
             if (!cancelled)
-                await writeVersionCache({ latestVersion: cache?.latestVersion ?? null, checkedAt: Date.now() }).catch(() => { });
+                await writeVersionCache({ ...cache, latestVersion: cache?.latestVersion ?? null, checkedAt: Date.now() }).catch(() => { });
             return cache?.latestVersion ?? null;
         }
         finally {
@@ -99,6 +101,23 @@ export function startUpdateCheck() {
         },
     };
 }
+/**
+ * Whether to show the CLI's notice for `latest` now, and if so, record it: at
+ * most once a day, and right away for a version not announced before. An
+ * agent's morning run of ten commands should see it once, not ten times.
+ */
+export async function claimNotice(latest, now = Date.now()) {
+    const cache = await readVersionCache();
+    if (cache?.notifiedVersion === latest && now - (cache.notifiedAt ?? 0) < VERSION_CHECK_INTERVAL_MS)
+        return false;
+    await writeVersionCache({
+        latestVersion: cache?.latestVersion ?? latest,
+        checkedAt: cache?.checkedAt ?? now,
+        notifiedVersion: latest,
+        notifiedAt: now,
+    });
+    return true;
+}
 /** The latest version if the check has an answer within `waitMs`, else null. */
 export async function latestWithin(check, waitMs) {
     let timer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wilm-ai/wilma-cli",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Read your children's Wilma (Finnish school system) from the terminal or an AI assistant: schedule, homework, exams, messages and news.",
   "license": "MIT",
   "repository": {