feat(genkit-tools/cli): add update cmd

genkit-tools/cli/package.json

@@ -19,7 +19,7 @@
     "build:watch": "tsc --watch",
     "compile:bun": "bun build src/bin/genkit.ts --compile --outfile dist/bin/genkit --minify",
     "test": "jest --verbose",
-    "genversion": "genversion -esf src/utils/version.ts"
+    "genversion": "genversion -esf --property name,version src/utils/version.ts"
   },
   "repository": {
     "type": "git",
@@ -37,13 +37,15 @@
     "get-port": "5.1.1",
     "inquirer": "^8.2.0",
     "open": "^6.3.0",
-    "ora": "^5.4.1"
+    "ora": "^5.4.1",
+    "semver": "^7.7.2"
   },
   "devDependencies": {
     "@jest/globals": "^29.7.0",
     "@types/inquirer": "^8.1.3",
     "@types/jest": "^29.5.12",
     "@types/node": "^20.11.19",
+    "@types/semver": "^7.7.0",
     "bun-types": "^1.2.16",
     "genversion": "^3.2.0",
     "jest": "^29.7.0",

genkit-tools/cli/src/cli.ts

@@ -37,6 +37,7 @@ import {
 import { start } from './commands/start';
 import { uiStart } from './commands/ui-start';
 import { uiStop } from './commands/ui-stop';
+import { showUpdateNotification, update } from './commands/update';
 import { version } from './utils/version';
 
 /**
@@ -56,6 +57,7 @@ const commands: Command[] = [
   config,
   start,
   mcp,
+  update,
 ];
 
 /** Main entry point for CLI. */
@@ -64,6 +66,7 @@ export async function startCLI(): Promise<void> {
     .name('genkit')
     .description('Genkit CLI')
     .version(version)
+    .option('--no-update-notification', 'Do not show update notification')
     .hook('preAction', async (_, actionCommand) => {
       await notifyAnalyticsIfFirstRun();
 
@@ -85,6 +88,21 @@ export async function startCLI(): Promise<void> {
       await record(new RunCommandEvent(commandName));
     });
 
+  // Check for updates and show notification if available,
+  // unless --no-update-notification is set
+  // Run this synchronously to ensure it shows before command execution
+  const hasNoUpdateNotification = process.argv.includes(
+    '--no-update-notification'
+  );
+  if (!hasNoUpdateNotification) {
+    try {
+      await showUpdateNotification();
+    } catch (e) {
+      logger.debug('Failed to show update notification', e);
+      // Silently ignore errors - update notifications shouldn't break the CLI
+    }
+  }
+
   // When running as a spawned UI server process, argv[1] will be '__server-harness'
   // instead of a normal command. This allows the same binary to serve both CLI and server roles.
   if (process.argv[2] === SERVER_HARNESS_COMMAND) {

genkit-tools/cli/src/commands/config.ts

@@ -25,6 +25,9 @@ import {
 import * as clc from 'colorette';
 import { Command } from 'commander';
 
+export const UPDATE_NOTIFICATIONS_OPT_OUT_CONFIG_TAG =
+  'updateNotificationsOptOut';
+
 const CONFIG_TAGS: Record<
   string,
   (value: string) => string | boolean | number
@@ -38,6 +41,15 @@ const CONFIG_TAGS: Record<
       return o;
     }
   },
+  [UPDATE_NOTIFICATIONS_OPT_OUT_CONFIG_TAG]: (value) => {
+    let o: boolean | undefined;
+    try {
+      o = JSON.parse(value);
+    } finally {
+      if (typeof o !== 'boolean') throw new Error('Expected boolean');
+      return o;
+    }
+  },
 };
 
 export const config = new Command('config');