movehat 0.0.8-alpha.0 → 0.0.10-alpha.0

package/dist/helpers/semver-utils.js

@@ -0,0 +1,47 @@
+/**
+ * Compare two semver versions
+ * Returns true if newVersion > currentVersion
+ * Handles variable-length versions (1.2, 1.2.3, 1.2.3.4, etc.)
+ */
+export function isNewerVersion(currentVersion, newVersion) {
+    // Remove any pre-release tags (e.g., -alpha.0, -beta.1)
+    const cleanCurrent = currentVersion.split("-")[0];
+    const cleanNew = newVersion.split("-")[0];
+    // Split and validate numeric parts
+    const currentParts = cleanCurrent.split(".").map((part) => {
+        const num = Number(part);
+        if (isNaN(num) || !part.trim()) {
+            throw new Error(`Invalid version format: ${currentVersion}`);
+        }
+        return num;
+    });
+    const newerParts = cleanNew.split(".").map((part) => {
+        const num = Number(part);
+        if (isNaN(num) || !part.trim()) {
+            throw new Error(`Invalid version format: ${newVersion}`);
+        }
+        return num;
+    });
+    // Compare up to the maximum length, treating missing parts as 0
+    const maxLength = Math.max(currentParts.length, newerParts.length);
+    for (let i = 0; i < maxLength; i++) {
+        const currentPart = currentParts[i] || 0;
+        const newerPart = newerParts[i] || 0;
+        if (newerPart > currentPart)
+            return true;
+        if (newerPart < currentPart)
+            return false;
+    }
+    // If base versions are equal, check pre-release tags
+    // A version with no pre-release tag is considered newer than one with a tag
+    const currentHasPrerelease = currentVersion.includes("-");
+    const newHasPrerelease = newVersion.includes("-");
+    if (!currentHasPrerelease && newHasPrerelease) {
+        return false; // Current stable is newer than new pre-release
+    }
+    if (currentHasPrerelease && !newHasPrerelease) {
+        return true; // New stable is newer than current pre-release
+    }
+    return false;
+}
+//# sourceMappingURL=semver-utils.js.map

package/dist/helpers/semver-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver-utils.js","sourceRoot":"","sources":["../../src/helpers/semver-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,cAAsB,EAAE,UAAkB;IACvE,wDAAwD;IACxD,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1C,mCAAmC;IACnC,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,2BAA2B,cAAc,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,gEAAgE;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEnE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,SAAS,GAAG,WAAW;YAAE,OAAO,IAAI,CAAC;QACzC,IAAI,SAAS,GAAG,WAAW;YAAE,OAAO,KAAK,CAAC;IAC5C,CAAC;IAED,qDAAqD;IACrD,4EAA4E;IAC5E,MAAM,oBAAoB,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAElD,IAAI,CAAC,oBAAoB,IAAI,gBAAgB,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC,CAAC,+CAA+C;IAC/D,CAAC;IAED,IAAI,oBAAoB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,CAAC,+CAA+C;IAC9D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/helpers/version-check.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Check if a newer version is available and notify the user
+ * This runs synchronously using cache, and updates cache in background
+ */
+export declare function checkForUpdates(currentVersion: string, packageName: string): void;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/helpers/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/helpers/version-check.ts"],"names":[],"mappings":"AAmDA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAyCjF"}

package/dist/helpers/version-check.js

@@ -0,0 +1,85 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { isNewerVersion } from "./semver-utils.js";
+import { fetchLatestVersion } from "./npm-registry.js";
+const CACHE_DURATION = 24 * 60 * 60 * 1000; // 24 hours in milliseconds
+const CACHE_DIR = join(homedir(), ".movehat");
+const CACHE_FILE = join(CACHE_DIR, "version-cache.json");
+/**
+ * Read version from cache
+ */
+function readCache() {
+    try {
+        if (!existsSync(CACHE_FILE)) {
+            return null;
+        }
+        const cacheContent = readFileSync(CACHE_FILE, "utf-8");
+        return JSON.parse(cacheContent);
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Write version to cache
+ */
+function writeCache(latestVersion) {
+    try {
+        if (!existsSync(CACHE_DIR)) {
+            mkdirSync(CACHE_DIR, { recursive: true });
+        }
+        const cache = {
+            lastChecked: Date.now(),
+            latestVersion,
+        };
+        writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2));
+    }
+    catch (error) {
+        // Silently fail - don't interrupt user's workflow
+    }
+}
+/**
+ * Check if a newer version is available and notify the user
+ * This runs synchronously using cache, and updates cache in background
+ */
+export function checkForUpdates(currentVersion, packageName) {
+    try {
+        const cache = readCache();
+        let shouldNotify = false;
+        // Check cache synchronously for immediate notification
+        if (cache && isNewerVersion(currentVersion, cache.latestVersion)) {
+            shouldNotify = true;
+        }
+        // Display notification immediately if cache says there's an update
+        if (shouldNotify && cache) {
+            const updateMessage = "\n" +
+                "┌" + "─".repeat(60) + "┐\n" +
+                `│  Update available: ${currentVersion} → ${cache.latestVersion}`.padEnd(61) + "│\n" +
+                `│  Run: movehat update`.padEnd(61) + "│\n" +
+                "└" + "─".repeat(60) + "┘\n";
+            console.error(updateMessage);
+        }
+        // Update cache in background if needed (doesn't block)
+        if (!cache || Date.now() - cache.lastChecked > CACHE_DURATION) {
+            setImmediate(async () => {
+                try {
+                    const latestVersion = await fetchLatestVersion(packageName, {
+                        timeout: 2000,
+                        throwOnError: false,
+                    });
+                    if (latestVersion) {
+                        writeCache(latestVersion);
+                    }
+                }
+                catch (error) {
+                    // Silently fail
+                }
+            });
+        }
+    }
+    catch (error) {
+        // Silently fail - never interrupt user's workflow
+    }
+}
+//# sourceMappingURL=version-check.js.map

package/dist/helpers/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/helpers/version-check.ts"],"names":[],"mappings":"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"}

package/dist/templates/README.md

@@ -12,7 +12,7 @@ A Move smart contract project built with Movehat.
 
   Verify: `movement --version`
 
-**⚠️ Important:** Without Movement CLI, compilation will fail!
+**IMPORTANT:** Without Movement CLI, compilation will fail!
 
 ## Getting Started
 
@@ -52,11 +52,25 @@ npm run compile
 npm test
 ```
 
-**How it works:**
-- Tests use **Transaction Simulation** - no real blockchain required
-- Runs instantly without gas costs
-- Uses Movement testnet by default with auto-generated test accounts
-- Perfect for TDD and CI/CD workflows
+**Two types of tests available:**
+
+1. **Move Unit Tests** (`tests/Counter.move` lines 50-63)
+   - Written in Move with `#[test]` annotations
+   - Test internal logic and business rules
+   - Ultra-fast execution (milliseconds)
+   - Run with: `npm run test:move`
+
+2. **TypeScript Integration Tests** (`tests/Counter.test.ts`)
+   - Written in TypeScript using Transaction Simulation
+   - Test end-to-end flows and SDK integration
+   - No blockchain or gas costs required
+   - Run with: `npm run test:ts`
+
+**Commands:**
+- `npm test` - Runs both Move + TypeScript tests
+- `npm run test:move` - Only Move unit tests (fast)
+- `npm run test:ts` - Only TypeScript integration tests
+- `npm run test:watch` - TypeScript tests in watch mode
 
 ### 5. Deploy (optional)
 

package/dist/templates/move/Move.toml

@@ -7,8 +7,9 @@ authors = []
 counter = "_"
 
 [dev-addresses]
-# Dev addresses are auto-detected by movehat during compilation
-# You can also add them manually here if needed
+# Dev addresses for testing (used with movement move test --dev)
+# These addresses are temporary and used for local development/testing only
+counter = "0xcafe"
 
 [dependencies.AptosFramework]
 git = "https://github.com/movementlabsxyz/aptos-core.git"

package/dist/templates/package.json

@@ -3,8 +3,10 @@
   "version": "1.0.0",
   "type": "module",
   "scripts": {
-    "test": "mocha",
-    "test:watch": "mocha --watch",
+    "test": "movehat test",
+    "test:move": "movehat test:move",
+    "test:ts": "movehat test:ts",
+    "test:watch": "movehat test:ts --watch",
     "deploy": "movehat run scripts/deploy-counter.ts"
   },
   "dependencies": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "movehat",
-  "version": "0.0.8-alpha.0",
+  "version": "0.0.10-alpha.0",
   "type": "module",
   "description": "Hardhat-like development framework for Movement L1 and Aptos Move smart contracts",
   "bin": {

package/src/cli.ts

@@ -4,19 +4,23 @@ import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import testCommand from './commands/test.js';
+import testMoveCommand from './commands/test-move.js';
 import compileCommand from './commands/compile.js';
 import initCommand from './commands/init.js';
 import runCommand from './commands/run.js';
+import updateCommand from './commands/update.js';
 import forkCreateCommand from './commands/fork/create.js';
 import forkViewResourceCommand from './commands/fork/view-resource.js';
 import forkFundCommand from './commands/fork/fund.js';
 import forkListCommand from './commands/fork/list.js';
 import forkServeCommand from './commands/fork/serve.js';
+import { checkForUpdates } from './helpers/version-check.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
 const version = packageJson.version;
+const packageName = packageJson.name;
 
 /**
  * Parse and validate port number
@@ -29,6 +33,15 @@ function parsePort(value: string): number {
   return port;
 }
 
+// Check for updates at startup (skip if running update command or help)
+const args = process.argv.slice(2);
+const isUpdateCommand = args.includes('update');
+const isHelpOnly = args.length === 0 || args.includes('-h') || args.includes('--help');
+
+if (!isUpdateCommand && !isHelpOnly) {
+  checkForUpdates(version, packageName);
+}
+
 const program = new Command();
 
 program
@@ -67,8 +80,30 @@ program
 
 program
     .command('test')
-    .description('Run TypeScript tests with Mocha')
-    .action(testCommand);
+    .description('Run all tests (Move + TypeScript)')
+    .option('--move-only', 'Run only Move unit tests')
+    .option('--ts-only', 'Run only TypeScript integration tests')
+    .option('--watch', 'Run TypeScript tests in watch mode (implies --ts-only)')
+    .option('--filter <pattern>', 'Filter Move tests by name pattern (Move tests only)')
+    .action((options) => testCommand(options));
+
+program
+    .command('test:move')
+    .description('Run Move unit tests')
+    .option('--filter <pattern>', 'Filter tests by name pattern')
+    .option('--ignore-warnings', 'Ignore compilation warnings')
+    .action((options) => testMoveCommand(options));
+
+program
+    .command('test:ts')
+    .description('Run TypeScript integration tests')
+    .option('--watch', 'Run tests in watch mode')
+    .action((options) => testCommand({ tsOnly: true, watch: options.watch }));
+
+program
+    .command('update')
+    .description('Check for updates and upgrade to the latest version')
+    .action(() => updateCommand());
 
 // Fork commands
 const fork = program

package/src/commands/test-move.ts

@@ -0,0 +1,26 @@
+import { runMoveTests } from "../helpers/move-tests.js";
+
+interface TestMoveOptions {
+  filter?: string;
+  ignoreWarnings?: boolean;
+}
+
+export default async function testMoveCommand(options: TestMoveOptions = {}) {
+  try {
+    console.log("Running Move unit tests...\n");
+
+    await runMoveTests({
+      filter: options.filter,
+      ignoreWarnings: options.ignoreWarnings,
+      skipIfMissing: false, // Fail if no Move directory (standalone command mode)
+    });
+
+    process.exit(0);
+  } catch (err: any) {
+    console.error("\n✗ Move tests failed");
+    if (err.message) {
+      console.error(`   ${err.message}`);
+    }
+    process.exit(1);
+  }
+}

package/src/commands/test.ts

@@ -1,42 +1,121 @@
 import { spawn } from "child_process";
-import { join } from "path";
+import { join, resolve } from "path";
 import { existsSync } from "fs";
+import { runMoveTests } from "../helpers/move-tests.js";
 
-export default async function testCommand() {
-  const testDir = join(process.cwd(), "tests");
+interface TestOptions {
+  moveOnly?: boolean;
+  tsOnly?: boolean;
+  watch?: boolean;
+  filter?: string;
+}
 
-  if (!existsSync(testDir)) {
-    console.error("No tests directory found.");
-    console.error("   Create a 'tests' directory with your TypeScript test files.");
-    process.exit(1);
+export default async function testCommand(options: TestOptions = {}) {
+  // Handle move-only flag
+  if (options.moveOnly) {
+    if (options.watch) {
+      console.error("ERROR: --watch flag is not supported with --move-only");
+      console.error("       Watch mode only works with TypeScript tests");
+      process.exit(1);
+    }
+    return runMoveTestsSync(options.filter);
   }
 
-  console.log("Running TypeScript tests with Mocha...\n");
+  // Handle ts-only flag or watch flag (watch implies ts-only)
+  if (options.tsOnly || options.watch) {
+    return runTypeScriptTests(options.watch);
+  }
 
-  // Find mocha from project's node_modules
-  const mochaPath = join(process.cwd(), "node_modules", ".bin", "mocha");
+  // Default: Run both Move and TypeScript tests (no watch mode)
+  console.log("Running all tests...\n");
+  console.log("=" + "=".repeat(60) + "\n");
 
-  if (!existsSync(mochaPath)) {
-    console.error("Mocha not found in project dependencies.");
-    console.error("   Install it with: npm install --save-dev mocha");
+  // First run Move tests (fail fast)
+  try {
+    await runMoveTestsSync();
+    console.log("\n" + "=" + "=".repeat(60) + "\n");
+  } catch (error) {
+    console.error("\n✗ Move tests failed");
+    console.log("\n" + "=" + "=".repeat(60));
     process.exit(1);
   }
 
-  // Run mocha with TypeScript support
-  const child = spawn(mochaPath, [], {
-    stdio: "inherit",
-    env: {
-      ...process.env,
-      // Inherit network if set
-    },
-  });
+  // Then run TypeScript tests (never in watch mode for "all tests")
+  try {
+    await runTypeScriptTests(false);
+    console.log("\n" + "=" + "=".repeat(60));
+    console.log("\n✓ All tests passed!\n");
+  } catch (error) {
+    console.error("\n" + "=" + "=".repeat(60));
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\n${message}\n`);
+    process.exit(1);
+  }
+}
+
+async function runMoveTestsSync(filter?: string): Promise<void> {
+  console.log("1. Move Unit Tests");
+  console.log("-" + "-".repeat(60) + "\n");
 
-  child.on("exit", (code) => {
-    process.exit(code || 0);
+  return runMoveTests({
+    filter,
+    skipIfMissing: true, // Gracefully skip if no Move directory (orchestrated test mode)
   });
+}
 
-  child.on("error", (error) => {
-    console.error(`Failed to run tests: ${error.message}`);
-    process.exit(1);
+function runTypeScriptTests(watch: boolean = false): Promise<void> {
+  return new Promise((resolve, reject) => {
+    console.log("2. TypeScript Integration Tests");
+    console.log("-" + "-".repeat(60) + "\n");
+
+    const testDir = join(process.cwd(), "tests");
+
+    if (!existsSync(testDir)) {
+      console.log("⊘ No TypeScript tests found (tests directory not found)");
+      console.log("   Skipping TypeScript tests...\n");
+      resolve();
+      return;
+    }
+
+    const mochaPath = join(process.cwd(), "node_modules", ".bin", "mocha");
+
+    if (!existsSync(mochaPath)) {
+      console.error("✗ Mocha not found in project dependencies.");
+      console.error("   Install it with: npm install --save-dev mocha");
+      reject(new Error("Mocha not found"));
+      return;
+    }
+
+    const args = watch ? ["--watch"] : [];
+
+    const child = spawn(mochaPath, args, {
+      stdio: "inherit",
+      env: {
+        ...process.env,
+      },
+    });
+
+    // In watch mode, Mocha never exits, so resolve immediately
+    if (watch) {
+      console.log("Watch mode active. Press Ctrl+C to exit.\n");
+      resolve();
+      return;
+    }
+
+    // Non-watch mode: wait for exit
+    child.on("exit", (code) => {
+      if (code === 0) {
+        console.log("\n✓ TypeScript tests passed");
+        resolve();
+      } else {
+        const exitCode = typeof code === "number" ? code : 1;
+        reject(new Error(`TypeScript tests failed with exit code ${exitCode}`));
+      }
+    });
+
+    child.on("error", (error) => {
+      console.error(`Failed to run TypeScript tests: ${error.message}`);
+      reject(error);
+    });
   });
-}
+}

package/src/commands/update.ts

@@ -0,0 +1,148 @@
+import { spawn } from "child_process";
+import { readFileSync, existsSync } from "fs";
+import { join, dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+import { isNewerVersion } from "../helpers/semver-utils.js";
+import { fetchLatestVersion } from "../helpers/npm-registry.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+interface PackageJson {
+  name: string;
+  version: string;
+}
+
+/**
+ * Detect which package manager to use for update
+ * Searches for lockfiles upward from cwd, checks user agent, or falls back to defaults
+ */
+function detectPackageManager(): "yarn" | "npm" | "pnpm" {
+  // First, try to detect from lockfiles by searching upward
+  let currentDir = process.cwd();
+  const root = resolve("/");
+
+  while (currentDir !== root) {
+    if (existsSync(join(currentDir, "pnpm-lock.yaml"))) {
+      return "pnpm";
+    }
+    if (existsSync(join(currentDir, "yarn.lock"))) {
+      return "yarn";
+    }
+    if (
+      existsSync(join(currentDir, "package-lock.json")) ||
+      existsSync(join(currentDir, "npm-shrinkwrap.json"))
+    ) {
+      return "npm";
+    }
+
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) break; // Reached root
+    currentDir = parentDir;
+  }
+
+  // No lockfile found, check user agent environment variables
+  const userAgent =
+    process.env.npm_config_user_agent || process.env.npm_execpath || "";
+
+  if (userAgent.includes("pnpm")) {
+    return "pnpm";
+  }
+  if (userAgent.includes("yarn")) {
+    return "yarn";
+  }
+  if (userAgent.includes("npm")) {
+    return "npm";
+  }
+
+  // Default fallback to npm for global installs
+  return "npm";
+}
+
+/**
+ * Update command - checks for updates and installs the latest version
+ */
+export default async function updateCommand() {
+  try {
+    console.log("Checking for updates...\n");
+
+    // Read current version from package.json
+    const packageJsonPath = join(__dirname, "../../package.json");
+    const packageJson: PackageJson = JSON.parse(
+      readFileSync(packageJsonPath, "utf-8")
+    );
+
+    const currentVersion = packageJson.version;
+    const packageName = packageJson.name;
+
+    console.log(`Current version: ${currentVersion}`);
+
+    // Fetch latest version from npm
+    const latestVersion = await fetchLatestVersion(packageName, {
+      throwOnError: true,
+    });
+
+    if (!latestVersion) {
+      console.error("Failed to fetch latest version from npm registry");
+      process.exit(1);
+    }
+
+    console.log(`Latest version:  ${latestVersion}\n`);
+
+    // Compare versions
+    if (!isNewerVersion(currentVersion, latestVersion)) {
+      console.log("✓ You are already using the latest version!");
+      return;
+    }
+
+    console.log(`New version available: ${currentVersion} -> ${latestVersion}`);
+    console.log("\nUpdating movehat...\n");
+
+    // Detect package manager
+    const packageManager = detectPackageManager();
+
+    // Build update command based on package manager
+    let updateArgs: string[];
+    switch (packageManager) {
+      case "yarn":
+        updateArgs = ["global", "upgrade", packageName];
+        break;
+      case "pnpm":
+        updateArgs = ["add", "-g", `${packageName}@latest`];
+        break;
+      case "npm":
+      default:
+        updateArgs = ["update", "-g", packageName];
+        break;
+    }
+
+    // Execute update
+    // Use home directory as cwd to avoid packageManager conflicts from local package.json
+    const child = spawn(packageManager, updateArgs, {
+      stdio: "inherit",
+      cwd: homedir() || process.cwd(),
+    });
+
+    child.on("exit", (code) => {
+      if (code === 0) {
+        console.log(`\n✓ Successfully updated to version ${latestVersion}!`);
+        process.exit(0);
+      } else {
+        console.error("\n✗ Update failed");
+        console.error(`   Try manually: ${packageManager} ${updateArgs.join(" ")}`);
+        process.exit(1);
+      }
+    });
+
+    child.on("error", (error) => {
+      console.error(`Failed to update: ${error.message}`);
+      console.error(`   Try manually: ${packageManager} ${updateArgs.join(" ")}`);
+      process.exit(1);
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Error: ${message}`);
+    process.exit(1);
+  }
+}