brightspace-d2l-mcp 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 1.4.0
+
+- Update check. Running a command like `npx brightspace-d2l-mcp setup` on an older version now says which version is out and asks "Update now? (Y/n)". Yes switches to the new version and carries on with the same command. It never asks when an AI app runs the server, in CI, with `--yes`, or when `BRIGHTSPACE_NO_UPDATE_CHECK` is set.
+- Running `npx brightspace-d2l-mcp` with no command in a terminal now shows help instead of silently starting the server. AI apps are unaffected.
+
 ## 1.3.0
 
 - Setup closes its window when it finishes on Windows, after a 10 second countdown. Press Enter to close it straight away, type k to keep it open, or pass `--keep-open`. Every command now exits as soon as it is done, so the terminal is never left hanging.

package/README.md

@@ -152,6 +152,8 @@ https://github.com/AnonymousOnyx22/brightspace-d2l-mcp/blob/main/llms.txt
 | `npx brightspace-d2l-mcp status` | Show your school, whether you're signed in, and connected apps |
 | `npx brightspace-d2l-mcp doctor` | Check Node, your school, sign-in and connected apps, and say how to fix anything wrong |
 | `npx brightspace-d2l-mcp logout` | Delete the saved session |
+
+When a newer version is out, commands ask whether to update first. Set `BRIGHTSPACE_NO_UPDATE_CHECK=1` to turn that off.
 | `npx brightspace-d2l-mcp uninstall` | Remove from all AI apps and delete all local data |
 | `npx brightspace-d2l-mcp serve --http` | Run over HTTP for ChatGPT and HTTP-based agents |
 | `npx brightspace-d2l-mcp config` | Print the MCP config JSON for any other app |

package/build/cli/update-check.js

@@ -0,0 +1,76 @@
+import { spawn } from "node:child_process";
+import { homedir } from "node:os";
+import { PACKAGE_NAME } from "../utils/paths.js";
+import { packageVersion } from "../utils/version.js";
+import { isNewerVersion } from "./doctor.js";
+import * as ui from "./ui.js";
+const CHECK_TIMEOUT_MS = 1500;
+/** Set on the relaunched process so it never asks again. */
+const RELAUNCHED_ENV = "BRIGHTSPACE_UPDATED";
+/** Commands that never prompt: the MCP server itself, and output meant for scripts. */
+const SKIP_COMMANDS = new Set(["serve", "config", "--version", "-v"]);
+export function shouldCheckForUpdate(command, args, env = process.env, tty = process.stdin.isTTY === true && process.stdout.isTTY === true) {
+    if (!tty || SKIP_COMMANDS.has(command))
+        return false;
+    if (args.includes("--yes") || args.includes("-y"))
+        return false;
+    return !env.CI && !env.BRIGHTSPACE_NO_UPDATE_CHECK && !env[RELAUNCHED_ENV];
+}
+async function latestVersion() {
+    try {
+        const response = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, { signal: AbortSignal.timeout(CHECK_TIMEOUT_MS) });
+        if (!response.ok)
+            return null;
+        const { version } = (await response.json());
+        return typeof version === "string" ? version : null;
+    }
+    catch {
+        return null;
+    }
+}
+function quoteForCmd(arg) {
+    return /[\s"&|<>^]/.test(arg) ? `"${arg.replace(/"/g, '\\"')}"` : arg;
+}
+function relaunch(version, command, args) {
+    const windows = process.platform === "win32";
+    const argv = ["-y", `${PACKAGE_NAME}@${version}`, command, ...args];
+    return new Promise((resolve) => {
+        const child = spawn("npx", windows ? argv.map(quoteForCmd) : argv, {
+            stdio: "inherit",
+            shell: windows,
+            // Run outside the current folder, so a project that itself depends on this package can't shadow the new version.
+            cwd: homedir(),
+            env: { ...process.env, [RELAUNCHED_ENV]: "1" },
+        });
+        child.on("error", () => resolve(-1));
+        child.on("exit", (code) => resolve(code ?? 1));
+    });
+}
+/**
+ * Before an interactive command, offers to switch to a newer release.
+ * Returns the exit code of the updated run, or null to carry on with this version.
+ */
+export async function offerUpdate(command, args) {
+    if (!shouldCheckForUpdate(command, args))
+        return null;
+    const current = packageVersion();
+    const latest = await latestVersion();
+    if (!latest || !isNewerVersion(latest, current))
+        return null;
+    console.log(`\n  ${ui.yellow("↑")} ${ui.bold(`brightspace-d2l-mcp v${latest}`)} is out ${ui.dim(`(you have v${current})`)}`);
+    if (!(await ui.confirm("Update now?"))) {
+        ui.info(ui.dim(`Skipped. Run npx -y ${PACKAGE_NAME}@latest ${command} any time to update.`));
+        return null;
+    }
+    ui.info(ui.dim(`Downloading v${latest}...`));
+    const code = await relaunch(latest, command, args);
+    if (code === -1) {
+        ui.warn(`Couldn't start the update. Carrying on with v${current}.`);
+        return null;
+    }
+    if (!process.argv[1]?.includes("_npx")) {
+        ui.info(ui.dim(`To update your installed copy too, run: npm install -g ${PACKAGE_NAME}@latest`));
+    }
+    return code;
+}
+//# sourceMappingURL=update-check.js.map

package/build/index.js

@@ -1,9 +1,12 @@
 #!/usr/bin/env node
 const CLI_COMMANDS = new Set(["setup", "login", "status", "doctor", "logout", "uninstall", "serve", "config", "help", "--help", "-h", "--version", "-v"]);
-const command = process.argv[2];
+// AI apps launch the server with piped stdio. A person typing the bare command in a terminal gets help instead of a silent server.
+const command = process.argv[2] ?? (process.stdin.isTTY ? "help" : undefined);
 if (command && CLI_COMMANDS.has(command)) {
     const { runCli } = await import("./cli/main.js");
-    const code = await runCli(command, process.argv.slice(3));
+    const { offerUpdate } = await import("./cli/update-check.js");
+    const args = process.argv.slice(3);
+    const code = (await offerUpdate(command, args)) ?? (await runCli(command, args));
     // Exit as soon as a command finishes. A browser or timer left behind would otherwise keep the terminal busy.
     // `serve` only returns once its stdio server is running, so it keeps the process alive.
     if (command === "serve")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brightspace-d2l-mcp",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "mcpName": "io.github.AnonymousOnyx22/brightspace-d2l-mcp",
   "description": "MCP server for D2L Brightspace: connect Brightspace to Claude, ChatGPT, Cursor, Copilot and any AI agent. One-command setup at any school with normal browser sign-in (SSO, Duo, MFA). Due dates with real submission status, exam and calendar events, what's new catch-up, grades and target-grade calculator, calendar export, assignments, content, announcements.",
   "type": "module",