@genrtl/grtl 2.2.0 → 2.3.0

package/README.md

@@ -21,13 +21,13 @@ $env:GRTL_API_KEY = "gtr_live_your_api_key"
 Configure hosted MCP and install the MCP-oriented Skill for your coding agent:
 
 ```bash
-grtl setup --mcp --codex
-grtl setup --mcp --cursor --project
+grtl setup --codex
+grtl setup --cursor --project
 ```
 
-Without `--mcp`, setup asks which mode to install. Knowledge retrieval, CBB
-search, and CBB detail lookup are supported through MCP tools only, not through
-CLI commands.
+MCP + Skill is the default setup mode. Use `--cli` only when you explicitly want
+the CLI-only Skill. Knowledge retrieval, CBB search, and CBB detail lookup are
+supported through MCP tools only, not through CLI commands.
 
 Installing a newer npm package does not modify Skills already written to an
 agent configuration directory. Run setup again after an upgrade to refresh the

package/dist/index.js

@@ -6,7 +6,6 @@ import pc6 from "picocolors";
 import figlet from "figlet";
 
 // src/commands/setup.ts
-import { select } from "@inquirer/prompts";
 import { dirname as dirname4, join as join2 } from "path";
 import { mkdir as mkdir3, readFile as readFile2, writeFile as writeFile3 } from "fs/promises";
 import ora from "ora";
@@ -669,27 +668,7 @@ async function resolveMode(options) {
     return null;
   }
   if (options.cli) return "cli";
-  if (options.mcp || options.yes) return "mcp";
-  try {
-    return await select({
-      message: "How should your coding agent access GenRTL?",
-      choices: [
-        {
-          name: "CLI Skill",
-          value: "cli",
-          description: "The agent runs the installed grtl command."
-        },
-        {
-          name: "MCP Server + Skill",
-          value: "mcp",
-          description: "The agent calls the four hosted GenRTL MCP tools."
-        }
-      ]
-    });
-  } catch {
-    log.warn("Setup cancelled");
-    return null;
-  }
+  return "mcp";
 }
 async function promptAgents() {
   try {
@@ -1419,7 +1398,7 @@ function registerCbbCommands(program2) {
 }
 
 // src/commands/upgrade.ts
-import { confirm } from "@inquirer/prompts";
+import { confirm, select } from "@inquirer/prompts";
 import { spawn } from "child_process";
 import pc5 from "picocolors";
 
@@ -1591,11 +1570,24 @@ async function shouldShowUpdateNotification(info, options = {}) {
   const now = options.now ?? Date.now();
   const cooldownMs = options.cooldownMs ?? DEFAULT_CACHE_TTL_MS;
   const state = await readUpdateState(options.stateFile);
+  if (state.ignoredVersion === info.latestVersion) {
+    return false;
+  }
   if (state.notifiedVersion === info.latestVersion && state.lastNotifiedAt && now - state.lastNotifiedAt < cooldownMs) {
     return false;
   }
   return true;
 }
+async function markUpdateNotificationIgnored(latestVersion, options = {}) {
+  const state = await readUpdateState(options.stateFile);
+  await writeUpdateState(
+    {
+      ...state,
+      ignoredVersion: latestVersion
+    },
+    options.stateFile
+  );
+}
 async function markUpdateNotificationShown(latestVersion, options = {}) {
   const now = options.now ?? Date.now();
   const state = await readUpdateState(options.stateFile);
@@ -1613,6 +1605,7 @@ function shouldSkipUpdateNotifier(argv = process.argv) {
 }
 
 // src/commands/upgrade.ts
+var RELEASE_NOTES_URL = "https://github.com/xroting/grtl/releases/latest";
 function registerUpgradeCommand(program2) {
   program2.command("upgrade").description("Check for a newer grtl version and upgrade when possible").option("-y, --yes", "Run the suggested upgrade command without prompting").option("--check", "Only check for updates without running the upgrade command").action(async (options) => {
     await upgradeCommand(options);
@@ -1656,33 +1649,62 @@ async function maybeShowUpgradeNotice(options = {}) {
   if (!info || !info.updateAvailable || !await shouldShowUpdateNotification(info)) {
     return;
   }
+  const choices = [];
   log.blank();
-  if (info.upgradePlan.needsExplicitVersion) {
-    log.box([
-      `${pc5.white(pc5.bold("Update available:"))} ${pc5.green(pc5.bold(`v${info.currentVersion}`))} ${pc5.dim("->")} ${pc5.green(pc5.bold(`v${info.latestVersion}`))}`,
-      `${pc5.white("Use")} ${pc5.yellow(pc5.bold(info.upgradePlan.displayCommand))} ${pc5.white("to run the latest version")}`
-    ]);
+  log.plain(`${pc5.dim("Release notes:")} ${pc5.underline(pc5.dim(RELEASE_NOTES_URL))}`);
+  if (info.upgradePlan.canRun) {
+    choices.push({
+      name: `Update now (runs \`${info.upgradePlan.displayCommand}\`)`,
+      value: "update"
+    });
+  } else {
+    const verb = info.upgradePlan.needsExplicitVersion ? "Use" : "Run";
+    log.info(`${verb} ${pc5.cyan(info.upgradePlan.displayCommand)} to update.`);
+  }
+  choices.push(
+    { name: "Skip", value: "skip" },
+    {
+      name: "Skip until next version",
+      value: "skip-version",
+      description: `Do not show this prompt again for v${info.latestVersion}.`
+    }
+  );
+  let choice;
+  try {
+    choice = await select({
+      message: `Update available: v${info.currentVersion} -> v${info.latestVersion}`,
+      choices
+    });
+  } catch {
     await markUpdateNotificationShown(info.latestVersion);
     log.blank();
     return;
   }
-  if (!info.upgradePlan.canRun) {
-    log.box([
-      `${pc5.white(pc5.bold("Update available:"))} ${pc5.green(pc5.bold(`v${info.currentVersion}`))} ${pc5.dim("->")} ${pc5.green(pc5.bold(`v${info.latestVersion}`))}`,
-      `${pc5.white("Run")} ${pc5.yellow(pc5.bold("grtl upgrade"))} ${pc5.white("for update steps")}`,
-      `${pc5.white("Or run")} ${pc5.yellow(info.upgradePlan.displayCommand)}`
-    ]);
+  if (choice === "skip-version") {
+    await markUpdateNotificationIgnored(info.latestVersion);
+    log.blank();
+    return;
+  }
+  if (choice === "skip") {
     await markUpdateNotificationShown(info.latestVersion);
     log.blank();
     return;
   }
-  log.box([
-    `${pc5.white(pc5.bold("Update available:"))} ${pc5.green(pc5.bold(`v${info.currentVersion}`))} ${pc5.dim("->")} ${pc5.green(pc5.bold(`v${info.latestVersion}`))}`,
-    `${pc5.white("Run")} ${pc5.yellow(pc5.bold("grtl upgrade"))} ${pc5.white("to update now")}`,
-    `${pc5.white("Or run")} ${pc5.yellow(info.upgradePlan.displayCommand)}`
-  ]);
   await markUpdateNotificationShown(info.latestVersion);
   log.blank();
+  const exitCode = await runUpgradePlan(info.upgradePlan);
+  if (exitCode === 0) {
+    log.blank();
+    log.success("Upgrade complete.");
+    log.info(`Restart your terminal or run ${pc5.cyan("grtl --version")} to verify.`);
+    log.blank();
+    return;
+  }
+  log.blank();
+  log.error(`Upgrade command exited with code ${exitCode ?? "unknown"}.`);
+  showUpgradeFailureHelp(info.upgradePlan);
+  process.exitCode = 1;
+  log.blank();
 }
 async function upgradeCommand(options) {
   trackEvent("command", { name: "upgrade" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genrtl/grtl",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "CLI, MCP, and coding-agent Skills for GenRTL RTL engineering knowledge",
   "type": "module",
   "bin": {