@git.zone/cli 2.15.0 → 2.16.1

package/dist_ts/mod_tools/index.js

@@ -0,0 +1,290 @@
+import * as plugins from "./mod.plugins.js";
+import { commitinfo } from "../00_commitinfo_data.js";
+import { getCliMode, printJson } from "../helpers.climode.js";
+import { PackageManagerUtil, } from "./classes.packagemanager.js";
+export const GITZONE_PACKAGES = [
+    "@git.zone/cli",
+    "@git.zone/tsdoc",
+    "@git.zone/tsbuild",
+    "@git.zone/tstest",
+    "@git.zone/tspublish",
+    "@git.zone/tsbundle",
+    "@git.zone/tsdocker",
+    "@git.zone/tsview",
+    "@git.zone/tswatch",
+    "@git.zone/tsrust",
+];
+export const run = async (argvArg = {}) => {
+    const mode = await getCliMode(argvArg);
+    const command = argvArg._?.[1] || "help";
+    if (mode.help || command === "help") {
+        showHelp(mode);
+        return;
+    }
+    switch (command) {
+        case "update":
+            await runUpdate(argvArg, mode);
+            break;
+        case "install":
+            await runInstall(argvArg, mode);
+            break;
+        default:
+            showHelp(mode);
+            break;
+    }
+};
+async function runUpdate(argvArg, mode) {
+    const verbose = Boolean(argvArg.v || argvArg.verbose);
+    const pmUtil = new PackageManagerUtil();
+    console.log("Scanning for installed @git.zone packages...\n");
+    const pnpmInfo = await pmUtil.getPnpmVersionInfo();
+    if (!pnpmInfo.available) {
+        console.log("pnpm is required for gitzone tools update, but it was not found.");
+        return;
+    }
+    console.log("Package manager:\n");
+    console.log("  Name     Current     Latest      Status");
+    console.log("  ----------------------------------------------");
+    const latestPnpm = (pnpmInfo.latestVersion || "unknown").padEnd(12);
+    const pnpmStatus = pnpmInfo.latestVersion === null
+        ? "? Version unknown"
+        : pnpmInfo.needsUpdate
+            ? "Update available"
+            : "Up to date";
+    console.log(`  ${"pnpm".padEnd(9)}${pnpmInfo.currentVersion.padEnd(12)}${latestPnpm}${pnpmStatus}`);
+    console.log("");
+    if (verbose) {
+        console.log("Using pnpm as the supported global package manager.\n");
+    }
+    const selfUpdated = await handleSelfUpdate(pmUtil, mode);
+    if (selfUpdated) {
+        return;
+    }
+    const installedPackages = await pmUtil.getInstalledPackages();
+    const packageInfos = await getPackageUpdateInfos(pmUtil, installedPackages);
+    if (packageInfos.length === 0) {
+        console.log("No managed @git.zone packages found installed globally.");
+        return;
+    }
+    console.log("Installed @git.zone packages:\n");
+    console.log("  Package                      Current     Latest      Status");
+    console.log("  ------------------------------------------------------------");
+    for (const packageInfo of packageInfos) {
+        const status = packageInfo.latestVersion === "unknown"
+            ? "? Version unknown"
+            : packageInfo.needsUpdate
+                ? "Update available"
+                : "Up to date";
+        console.log(`  ${packageInfo.name.padEnd(28)}${packageInfo.currentVersion.padEnd(12)}${packageInfo.latestVersion.padEnd(12)}${status}`);
+    }
+    console.log("");
+    await printMissingPackages(pmUtil, installedPackages);
+    const packagesToUpdate = packageInfos.filter((packageInfo) => packageInfo.needsUpdate);
+    if (packagesToUpdate.length === 0) {
+        console.log("All managed packages are up to date.");
+        return;
+    }
+    console.log(`Found ${packagesToUpdate.length} package(s) with available updates.\n`);
+    if (!mode.yes && !mode.interactive) {
+        console.log("Run gitzone tools update -y to update without prompts.");
+        return;
+    }
+    let shouldUpdate = mode.yes;
+    if (!shouldUpdate) {
+        const interactInstance = new plugins.smartinteract.SmartInteract();
+        const answer = await interactInstance.askQuestion({
+            type: "confirm",
+            name: "confirmUpdate",
+            message: "Do you want to update these packages?",
+            default: true,
+        });
+        shouldUpdate = answer.value === true;
+    }
+    if (!shouldUpdate) {
+        console.log("Update cancelled.");
+        return;
+    }
+    await installPackages(pmUtil, packagesToUpdate.map((packageInfo) => packageInfo.name), "updated");
+}
+async function runInstall(argvArg, mode) {
+    const verbose = Boolean(argvArg.v || argvArg.verbose);
+    const pmUtil = new PackageManagerUtil();
+    console.log("Scanning for missing @git.zone packages...\n");
+    const pnpmAvailable = await pmUtil.detectPnpm();
+    if (!pnpmAvailable) {
+        console.log("pnpm is required for gitzone tools install, but it was not found.");
+        return;
+    }
+    if (verbose) {
+        console.log("Using pnpm as the supported global package manager.\n");
+    }
+    const installedPackages = await pmUtil.getInstalledPackages();
+    const installedNames = new Set(installedPackages.map((packageInfo) => packageInfo.name));
+    const missingPackages = GITZONE_PACKAGES.filter((packageName) => !installedNames.has(packageName));
+    if (missingPackages.length === 0) {
+        console.log("All managed @git.zone packages are already installed.");
+        return;
+    }
+    console.log(`Found ${missingPackages.length} missing package(s).\n`);
+    if (!mode.yes && !mode.interactive) {
+        await printPackageListWithLatest(pmUtil, missingPackages);
+        console.log("Run gitzone tools install -y to install all missing packages without prompts.");
+        return;
+    }
+    let selectedPackages = missingPackages;
+    if (!mode.yes) {
+        const choicesWithVersions = [];
+        for (const packageName of missingPackages) {
+            const latest = await pmUtil.getLatestVersion(packageName);
+            choicesWithVersions.push({
+                name: `${packageName}${latest ? `@${latest}` : ""}`,
+                value: packageName,
+            });
+        }
+        const interactInstance = new plugins.smartinteract.SmartInteract();
+        const answer = await interactInstance.askQuestion({
+            type: "checkbox",
+            name: "packages",
+            message: "Select packages to install:",
+            default: missingPackages,
+            choices: choicesWithVersions,
+        });
+        selectedPackages = answer.value;
+        if (selectedPackages.length === 0) {
+            console.log("No packages selected. Nothing to install.");
+            return;
+        }
+    }
+    await installPackages(pmUtil, selectedPackages, "installed");
+}
+async function handleSelfUpdate(pmUtil, mode) {
+    console.log("Checking for gitzone self-update...\n");
+    const currentVersion = commitinfo.version;
+    const latestVersion = await pmUtil.getLatestVersion("@git.zone/cli");
+    if (!latestVersion || !pmUtil.isNewerVersion(currentVersion, latestVersion)) {
+        console.log(`  @git.zone/cli  ${currentVersion}  Up to date\n`);
+        return false;
+    }
+    console.log(`  @git.zone/cli  ${currentVersion} -> ${latestVersion}  Update available\n`);
+    if (!mode.yes && !mode.interactive) {
+        console.log("Run gitzone tools update -y to update gitzone first.");
+        return true;
+    }
+    let shouldUpdate = mode.yes;
+    if (!shouldUpdate) {
+        const interactInstance = new plugins.smartinteract.SmartInteract();
+        const answer = await interactInstance.askQuestion({
+            type: "confirm",
+            name: "confirmSelfUpdate",
+            message: "Do you want to update gitzone itself first?",
+            default: true,
+        });
+        shouldUpdate = answer.value === true;
+    }
+    if (!shouldUpdate) {
+        console.log("Skipping gitzone self-update.\n");
+        return false;
+    }
+    const success = await pmUtil.installLatest("@git.zone/cli");
+    if (!success) {
+        console.log("\ngitzone self-update failed. Continuing with the current version.\n");
+        return false;
+    }
+    console.log("\ngitzone has been updated. Re-run gitzone tools update to check remaining packages.");
+    return true;
+}
+async function getPackageUpdateInfos(pmUtil, installedPackages) {
+    const packageInfos = [];
+    for (const installedPackage of installedPackages) {
+        if (!GITZONE_PACKAGES.includes(installedPackage.name)) {
+            continue;
+        }
+        const latestVersion = await pmUtil.getLatestVersion(installedPackage.name);
+        packageInfos.push({
+            name: installedPackage.name,
+            currentVersion: installedPackage.version,
+            latestVersion: latestVersion || "unknown",
+            needsUpdate: latestVersion
+                ? pmUtil.isNewerVersion(installedPackage.version, latestVersion)
+                : false,
+        });
+    }
+    return packageInfos;
+}
+async function printMissingPackages(pmUtil, installedPackages) {
+    const installedNames = new Set(installedPackages.map((packageInfo) => packageInfo.name));
+    const missingPackages = GITZONE_PACKAGES.filter((packageName) => !installedNames.has(packageName));
+    if (missingPackages.length === 0) {
+        return;
+    }
+    console.log("Not installed (managed @git.zone packages):\n");
+    await printPackageListWithLatest(pmUtil, missingPackages);
+    console.log("Run gitzone tools install to install missing packages.\n");
+}
+async function printPackageListWithLatest(pmUtil, packageNames) {
+    console.log("  Package                      Latest");
+    console.log("  ----------------------------------------");
+    for (const packageName of packageNames) {
+        const latest = await pmUtil.getLatestVersion(packageName);
+        console.log(`  ${packageName.padEnd(28)}  ${latest || "unknown"}`);
+    }
+    console.log("");
+}
+async function installPackages(pmUtil, packageNames, action) {
+    let successCount = 0;
+    let failCount = 0;
+    for (const packageName of packageNames) {
+        const success = await pmUtil.installLatest(packageName);
+        if (success) {
+            console.log(`  ${packageName} ${action} successfully`);
+            successCount++;
+        }
+        else {
+            console.log(`  ${packageName} failed`);
+            failCount++;
+        }
+    }
+    console.log("");
+    if (failCount === 0) {
+        console.log(`All ${successCount} package(s) ${action} successfully.`);
+    }
+    else {
+        console.log(`${successCount} package(s) ${action}, ${failCount} failed.`);
+    }
+}
+export function showHelp(mode) {
+    if (mode?.json) {
+        printJson({
+            name: "gitzone tools",
+            usage: "gitzone tools <command> [options]",
+            commands: [
+                { name: "update", description: "Check and update globally installed @git.zone packages" },
+                { name: "install", description: "Install missing managed @git.zone packages" },
+            ],
+            flags: [
+                { flag: "-y, --yes", description: "Run without confirmation prompts" },
+                { flag: "-v, --verbose", description: "Show package manager diagnostics" },
+            ],
+            packageManager: "pnpm",
+            managedPackages: GITZONE_PACKAGES,
+        });
+        return;
+    }
+    console.log("");
+    console.log("Usage: gitzone tools <command> [options]");
+    console.log("");
+    console.log("Commands:");
+    console.log("  update             Check and update globally installed @git.zone packages");
+    console.log("  install            Install missing managed @git.zone packages");
+    console.log("");
+    console.log("Options:");
+    console.log("  -y, --yes          Run without confirmation prompts");
+    console.log("  -v, --verbose      Show package manager diagnostics");
+    console.log("");
+    console.log("Examples:");
+    console.log("  gitzone tools update");
+    console.log("  gitzone tools update -y");
+    console.log("  gitzone tools install");
+    console.log("");
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9tb2RfdG9vbHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxrQkFBa0IsQ0FBQztBQUM1QyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFFdEQsT0FBTyxFQUFFLFVBQVUsRUFBRSxTQUFTLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUM5RCxPQUFPLEVBQ0wsa0JBQWtCLEdBR25CLE1BQU0sNkJBQTZCLENBQUM7QUFFckMsTUFBTSxDQUFDLE1BQU0sZ0JBQWdCLEdBQUc7SUFDOUIsZUFBZTtJQUNmLGlCQUFpQjtJQUNqQixtQkFBbUI7SUFDbkIsa0JBQWtCO0lBQ2xCLHFCQUFxQjtJQUNyQixvQkFBb0I7SUFDcEIsb0JBQW9CO0lBQ3BCLGtCQUFrQjtJQUNsQixtQkFBbUI7SUFDbkIsa0JBQWtCO0NBQ25CLENBQUM7QUFFRixNQUFNLENBQUMsTUFBTSxHQUFHLEdBQUcsS0FBSyxFQUFFLFVBQWUsRUFBRSxFQUFpQixFQUFFO0lBQzVELE1BQU0sSUFBSSxHQUFHLE1BQU0sVUFBVSxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQ3ZDLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxNQUFNLENBQUM7SUFFekMsSUFBSSxJQUFJLENBQUMsSUFBSSxJQUFJLE9BQU8sS0FBSyxNQUFNLEVBQUUsQ0FBQztRQUNwQyxRQUFRLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDZixPQUFPO0lBQ1QsQ0FBQztJQUVELFFBQVEsT0FBTyxFQUFFLENBQUM7UUFDaEIsS0FBSyxRQUFRO1lBQ1gsTUFBTSxTQUFTLENBQUMsT0FBTyxFQUFFLElBQUksQ0FBQyxDQUFDO1lBQy9CLE1BQU07UUFDUixLQUFLLFNBQVM7WUFDWixNQUFNLFVBQVUsQ0FBQyxPQUFPLEVBQUUsSUFBSSxD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

package/dist_ts/mod_tools/mod.plugins.d.ts

@@ -0,0 +1 @@
+export * from "../plugins.js";

package/dist_ts/mod_tools/mod.plugins.js

@@ -0,0 +1,2 @@
+export * from "../plugins.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibW9kLnBsdWdpbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9tb2RfdG9vbHMvbW9kLnBsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxlQUFlLENBQUMifQ==

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@git.zone/cli",
   "private": false,
-  "version": "2.15.0",
+  "version": "2.16.1",
   "description": "A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",

package/readme.md

@@ -57,6 +57,7 @@ gitzone release
 | `format` | Plan or apply project formatting and standardization |
 | `config` | Inspect, update, and migrate `.smartconfig.json` |
 | `services` | Manage local MongoDB, MinIO, and Elasticsearch containers |
+| `tools` | Manage the global `@git.zone` toolchain |
 | `template` | Scaffold projects from built-in templates |
 | `meta` | Manage multi-repository workspaces |
 | `open` | Open repository assets like CI pages |
@@ -67,6 +68,23 @@ gitzone release
 
 Global flags include `--help`, `--json`, `--plain`, `--agent`, `--no-interactive`, and `--no-check-updates`.
 
+## Toolchain Management
+
+`gitzone tools` replaces the former `gtools` command from `@git.zone/tools`. It manages globally installed `@git.zone` development tools through pnpm.
+
+```bash
+# Check installed @git.zone tools and update outdated packages
+gitzone tools update
+
+# Update without prompts
+gitzone tools update -y
+
+# Install missing managed @git.zone tools
+gitzone tools install
+```
+
+`gitzone tools update` checks `@git.zone/cli` first. If the CLI itself needs an update, it updates `@git.zone/cli` and asks you to rerun the command before updating the rest of the toolchain.
+
 ## Commit Workflow
 
 `gitzone commit` creates one semantic source commit. It does not bump versions, create tags, publish packages, or push Docker images.

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@git.zone/cli',
-  version: '2.15.0',
+  version: '2.16.1',
   description: 'A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.'
 }

package/ts/gitzone.cli.ts

@@ -2,6 +2,7 @@ import * as plugins from "./plugins.js";
 import * as paths from "./paths.js";
 import { GitzoneConfig } from "./classes.gitzoneconfig.js";
 import { getRawCliMode } from "./helpers.climode.js";
+import { commitinfo } from "./00_commitinfo_data.js";
 
 const gitzoneSmartcli = new plugins.smartcli.Smartcli();
 
@@ -11,20 +12,29 @@ export let run = async () => {
 
   // get packageInfo
   const projectInfo = new plugins.projectinfo.ProjectInfo(paths.packageDir);
+  const projectInfoVersion = (projectInfo.npm as any)?.version;
+  const packageVersion =
+    typeof projectInfoVersion === "string" && projectInfoVersion.length > 0
+      ? projectInfoVersion
+      : commitinfo.version;
 
   // check for updates
   if (rawCliMode.checkUpdates) {
     const smartupdateInstance = new plugins.smartupdate.SmartUpdate();
-    await smartupdateInstance.check(
-      "gitzone",
-      projectInfo.npm.version,
-      "http://gitzone.gitlab.io/gitzone/changelog.html",
-    );
+    try {
+      await smartupdateInstance.check(
+        "gitzone",
+        packageVersion,
+        "http://gitzone.gitlab.io/gitzone/changelog.html",
+      );
+    } catch {
+      // Update checks must never block actual CLI commands.
+    }
   }
   if (rawCliMode.output === "human") {
     console.log("---------------------------------------------");
   }
-  gitzoneSmartcli.addVersion(projectInfo.npm.version);
+  gitzoneSmartcli.addVersion(packageVersion);
 
   // ======> Standard task <======
 
@@ -137,6 +147,14 @@ export let run = async () => {
     modHelpers.run(argvArg);
   });
 
+  /**
+   * manage the global @git.zone toolchain
+   */
+  gitzoneSmartcli.addCommand("tools").subscribe(async (argvArg) => {
+    const modTools = await import("./mod_tools/index.js");
+    await modTools.run(argvArg);
+  });
+
   /**
    * manage release configuration
    */

package/ts/mod_standard/index.ts

@@ -23,6 +23,7 @@ const commandSummaries: ICommandHelpSummary[] = [
   { name: "format", description: "Plan or apply project formatting changes" },
   { name: "config", description: "Read and change .smartconfig.json settings" },
   { name: "services", description: "Manage or configure development services" },
+  { name: "tools", description: "Manage the global @git.zone toolchain" },
   { name: "template", description: "Create a project from a template" },
   { name: "open", description: "Open project assets and CI pages" },
   { name: "docker", description: "Run Docker-related maintenance tasks" },
@@ -75,6 +76,7 @@ export let run = async (argvArg: any = {}) => {
       { name: "Configure release settings", value: "config" },
       { name: "Create from template", value: "template" },
       { name: "Manage dev services (MongoDB, S3)", value: "services" },
+      { name: "Manage global @git.zone tools", value: "tools" },
       { name: "Open project assets", value: "open" },
       { name: "Show help", value: "help" },
     ],
@@ -113,6 +115,11 @@ export let run = async (argvArg: any = {}) => {
       await modServices.run({ _: ["services"] });
       break;
     }
+    case "tools": {
+      const modTools = await import("../mod_tools/index.js");
+      await modTools.run({ _: ["tools"] });
+      break;
+    }
     case "open": {
       const modOpen = await import("../mod_open/index.js");
       await modOpen.run({ _: ["open"] });
@@ -196,6 +203,7 @@ export async function showHelp(
   console.log("  gitzone release --plan");
   console.log("  gitzone format plan --json");
   console.log("  gitzone services set mongodb,minio");
+  console.log("  gitzone tools update");
   console.log("");
   console.log("Run gitzone <command> --help for command-specific usage.");
   console.log("");
@@ -231,6 +239,11 @@ async function showCommandHelp(
       modServices.showHelp(mode);
       return true;
     }
+    case "tools": {
+      const modTools = await import("../mod_tools/index.js");
+      modTools.showHelp(mode);
+      return true;
+    }
     default:
       return false;
   }

package/ts/mod_tools/classes.packagemanager.ts

@@ -0,0 +1,176 @@
+import * as plugins from "./mod.plugins.js";
+
+export interface IInstalledPackage {
+  name: string;
+  version: string;
+}
+
+export interface IPackageUpdateInfo {
+  name: string;
+  currentVersion: string;
+  latestVersion: string;
+  needsUpdate: boolean;
+}
+
+export interface IPackageManagerInfo {
+  available: boolean;
+  currentVersion: string;
+  latestVersion: string | null;
+  needsUpdate: boolean;
+}
+
+export class PackageManagerUtil {
+  private shell = new plugins.smartshell.Smartshell({
+    executor: "bash",
+  });
+
+  public async detectPnpm(): Promise<boolean> {
+    try {
+      const result = await this.shell.execSilent("pnpm --version 2>/dev/null");
+      return result.exitCode === 0 && Boolean(result.stdout.trim());
+    } catch {
+      return false;
+    }
+  }
+
+  public async getPnpmVersionInfo(): Promise<IPackageManagerInfo> {
+    const available = await this.detectPnpm();
+    if (!available) {
+      return {
+        available: false,
+        currentVersion: "unknown",
+        latestVersion: null,
+        needsUpdate: false,
+      };
+    }
+
+    const currentVersion = await this.getCurrentPnpmVersion();
+    const latestVersion = await this.getLatestVersion("pnpm", ["https://registry.npmjs.org"]);
+
+    return {
+      available: true,
+      currentVersion,
+      latestVersion,
+      needsUpdate: latestVersion ? this.isNewerVersion(currentVersion, latestVersion) : false,
+    };
+  }
+
+  public async getInstalledPackages(): Promise<IInstalledPackage[]> {
+    const packages: IInstalledPackage[] = [];
+
+    try {
+      const result = await this.shell.execSilent("pnpm list -g --depth=0 --json 2>/dev/null || true");
+      const output = result.stdout.trim();
+      if (!output) {
+        return packages;
+      }
+
+      const data = JSON.parse(output);
+      const dataArray = Array.isArray(data) ? data : [data];
+      for (const item of dataArray) {
+        const dependencies = item.dependencies || {};
+        for (const [name, info] of Object.entries(dependencies)) {
+          if (!name.startsWith("@git.zone/")) {
+            continue;
+          }
+          packages.push({
+            name,
+            version: (info as any).version || "unknown",
+          });
+        }
+      }
+    } catch {
+      return packages;
+    }
+
+    return packages;
+  }
+
+  public async getLatestVersion(
+    packageName: string,
+    registries = ["https://verdaccio.lossless.digital", "https://registry.npmjs.org"],
+  ): Promise<string | null> {
+    for (const registry of registries) {
+      const latest = await this.getLatestVersionFromRegistry(registry, packageName);
+      if (latest) {
+        return latest;
+      }
+    }
+    return null;
+  }
+
+  public async installLatest(packageName: string): Promise<boolean> {
+    const packageSpecifier = `${packageName}@latest`;
+    console.log(`  Installing ${packageSpecifier} via pnpm...`);
+
+    try {
+      const result = await this.shell.exec(`pnpm add -g ${shellQuote(packageSpecifier)}`);
+      return result.exitCode === 0;
+    } catch {
+      return false;
+    }
+  }
+
+  public isNewerVersion(current: string, latest: string): boolean {
+    const currentParts = normalizeSemver(current);
+    const latestParts = normalizeSemver(latest);
+
+    for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
+      const currentPart = currentParts[i] || 0;
+      const latestPart = latestParts[i] || 0;
+      if (latestPart > currentPart) return true;
+      if (latestPart < currentPart) return false;
+    }
+
+    return false;
+  }
+
+  private async getCurrentPnpmVersion(): Promise<string> {
+    try {
+      const result = await this.shell.execSilent("pnpm --version 2>/dev/null");
+      const versionMatch = result.stdout.trim().match(/(\d+\.\d+\.\d+)/);
+      return versionMatch?.[1] || "unknown";
+    } catch {
+      return "unknown";
+    }
+  }
+
+  private async getLatestVersionFromRegistry(
+    registry: string,
+    packageName: string,
+  ): Promise<string | null> {
+    const encodedName = packageName.replace("/", "%2f");
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 8000);
+
+    try {
+      const response = await fetch(`${registry}/${encodedName}`, {
+        signal: controller.signal,
+        headers: {
+          accept: "application/json",
+        },
+      });
+      if (!response.ok) {
+        return null;
+      }
+      const data = await response.json();
+      const latest = (data as any)["dist-tags"]?.latest;
+      return typeof latest === "string" && latest.length > 0 ? latest : null;
+    } catch {
+      return null;
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+}
+
+function normalizeSemver(version: string): number[] {
+  return version
+    .replace(/^[^\d]*/, "")
+    .split(".")
+    .map((part) => parseInt(part, 10) || 0);
+}
+
+function shellQuote(value: string): string {
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}