feat: add upgrade notification when newer CLI version is available

src/cli/utils/runCommand.ts

@@ -6,6 +6,7 @@ import { isCLIError } from "@/core/errors.js";
 import { login } from "@/cli/commands/auth/login-flow.js";
 import { printBanner } from "@/cli/utils/banner.js";
 import { theme } from "@/cli/utils/theme.js";
+import { printUpgradeNotificationIfAvailable } from "@/cli/utils/upgradeNotification.js";
 
 export interface RunCommandOptions {
   /**
@@ -73,6 +74,8 @@ export async function runCommand(
     intro(theme.colors.base44OrangeBackground(" Base 44 "));
   }
 
+  await printUpgradeNotificationIfAvailable();
+
   try {
     // Check authentication if required
     if (options?.requireAuth) {

src/cli/utils/upgradeNotification.ts

@@ -0,0 +1,25 @@
+import { log } from "@clack/prompts";
+import type { UpgradeInfo } from "@/cli/utils/version-check.js";
+import { checkForUpgrade } from "@/cli/utils/version-check.js";
+import { theme } from "@/cli/utils/theme.js";
+
+function formatUpgradeMessage(info: UpgradeInfo): string {
+  const { shinyOrange } = theme.colors;
+  const { bold } = theme.styles;
+
+  return `${shinyOrange("Update available!")} ${shinyOrange(`${info.currentVersion} → ${info.latestVersion}`)}  ${shinyOrange("Run:")} ${bold(shinyOrange("npm update -g base44"))}`;
+}
+
+/**
+ * Checks for available upgrades and prints a notification if one exists.
+ */
+export async function printUpgradeNotificationIfAvailable(): Promise<void> {
+  try {
+    const upgradeInfo = await checkForUpgrade();
+    if (upgradeInfo) {
+      log.message(formatUpgradeMessage(upgradeInfo));
+    }
+  } catch {
+    // Silently ignore errors
+  }
+}

src/cli/utils/version-check.ts

@@ -0,0 +1,25 @@
+import { execa } from "execa";
+import packageJson from "../../../package.json";
+
+export interface UpgradeInfo {
+  currentVersion: string;
+  latestVersion: string;
+}
+
+/**
+ * Checks if a newer version of the CLI is available.
+ */
+export async function checkForUpgrade(): Promise<UpgradeInfo | null> {
+  try {
+    const { stdout } = await execa("npm", ["view", "base44", "version"], { timeout: 5000 });
+    const latestVersion = stdout.trim();
+    const currentVersion = packageJson.version;
+
+    if (latestVersion !== currentVersion) {
+      return { currentVersion, latestVersion };
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}

tests/cli/version-check.spec.ts

@@ -0,0 +1,60 @@
+import { describe, it, vi, beforeEach } from "vitest";
+import { setupCLITests } from "./testkit/index.js";
+import type { UpgradeInfo } from "@/cli/utils/version-check.js";
+
+// Mock the version-check module
+vi.mock("@/cli/utils/version-check.js", () => ({
+  checkForUpgrade: vi.fn(),
+}));
+
+describe("upgrade notification", () => {
+  const t = setupCLITests();
+
+  beforeEach(async () => {
+    const { checkForUpgrade } = await import("@/cli/utils/version-check.js");
+    vi.mocked(checkForUpgrade).mockReset();
+  });
+
+  it("displays upgrade notification when newer version is available", async () => {
+    const { checkForUpgrade } = await import("@/cli/utils/version-check.js");
+    const upgradeInfo: UpgradeInfo = {
+      currentVersion: "0.0.26",
+      latestVersion: "1.0.0",
+    };
+    vi.mocked(checkForUpgrade).mockResolvedValue(upgradeInfo);
+
+    await t.givenLoggedIn({ email: "test@example.com", name: "Test User" });
+
+    const result = await t.run("whoami");
+
+    t.expectResult(result).toSucceed();
+    t.expectResult(result).toContain("Update available!");
+    t.expectResult(result).toContain("0.0.26 → 1.0.0");
+    t.expectResult(result).toContain("npm update -g base44");
+  });
+
+  it("does not display notification when version is current", async () => {
+    const { checkForUpgrade } = await import("@/cli/utils/version-check.js");
+    vi.mocked(checkForUpgrade).mockResolvedValue(null);
+
+    await t.givenLoggedIn({ email: "test@example.com", name: "Test User" });
+
+    const result = await t.run("whoami");
+
+    t.expectResult(result).toSucceed();
+    t.expectResult(result).not.toContain("Update available!");
+  });
+
+  it("does not display notification when version check fails", async () => {
+    const { checkForUpgrade } = await import("@/cli/utils/version-check.js");
+    vi.mocked(checkForUpgrade).mockRejectedValue(new Error("Network error"));
+
+    await t.givenLoggedIn({ email: "test@example.com", name: "Test User" });
+
+    const result = await t.run("whoami");
+
+    // Command still succeeds (upgrade check doesn't block)
+    t.expectResult(result).toSucceed();
+    t.expectResult(result).not.toContain("Update available!");
+  });
+});