zuppaclaude 1.3.3 → 1.3.4

package/bin/zuppaclaude.js

@@ -8,6 +8,7 @@
 const { Installer } = require('../lib/installer');
 const { Settings } = require('../lib/settings');
 const { Logger } = require('../lib/utils/logger');
+const { UpdateManager } = require('../lib/components/updater');
 
 const args = process.argv.slice(2);
 const command = args[0] || 'install';
@@ -23,11 +24,26 @@ function getCloudArg(args) {
   return null;
 }
 
+/**
+ * Check for updates at startup (non-blocking for some commands)
+ */
+async function checkUpdates(skipCommands = ['version', 'v', '-v', '--version', 'help', 'h', '-h', '--help', 'update']) {
+  if (skipCommands.includes(command)) {
+    return;
+  }
+
+  const updater = new UpdateManager();
+  await updater.checkAndUpdate();
+}
+
 async function main() {
   const logger = new Logger();
 
   logger.banner();
 
+  // Check for updates at startup
+  await checkUpdates();
+
   try {
     switch (command) {
       case 'install':
@@ -192,6 +208,37 @@ async function main() {
         }
         break;
 
+      case 'update':
+        const updateMgr = new UpdateManager();
+        const updateCmd = args[1] || 'check';
+
+        switch (updateCmd) {
+          case 'check':
+            await updateMgr.status();
+            break;
+          case 'now':
+          case 'install':
+            const result = await updateMgr.checkForUpdates();
+            if (result.hasUpdate) {
+              await updateMgr.update();
+            } else {
+              logger.success('You are already on the latest version');
+            }
+            break;
+          case 'enable':
+          case 'on':
+            updateMgr.enableAutoUpdate();
+            break;
+          case 'disable':
+          case 'off':
+            updateMgr.disableAutoUpdate();
+            break;
+          default:
+            logger.error(`Unknown update command: ${updateCmd}`);
+            showUpdateHelp();
+        }
+        break;
+
       case 'version':
       case 'v':
       case '-v':
@@ -233,6 +280,7 @@ Commands:
   settings, s         Manage settings
   session             Manage Claude Code sessions
   cloud               Manage cloud remotes (rclone)
+  update              Check for updates and manage auto-update
   version, v          Show version
   help, h             Show this help
 
@@ -249,6 +297,12 @@ Cloud Commands:
   cloud download <r>   Download backups from remote
   cloud backups <r>    List cloud backups
 
+Update Commands:
+  update               Check for updates
+  update now           Update to latest version
+  update enable        Enable auto-update (default)
+  update disable       Disable auto-update
+
 Session Commands:
   session list         List all sessions
   session backup       Backup sessions only
@@ -262,6 +316,7 @@ Examples:
   npx zuppaclaude backup --cloud gdrive        # Backup to Google Drive
   npx zuppaclaude restore 2026-01-05T12-00-00  # Restore from backup
   npx zuppaclaude cloud setup                  # Configure cloud
+  npx zuppaclaude update                       # Check for updates
 `);
 }
 
@@ -321,4 +376,20 @@ Supported providers (via rclone):
 `);
 }
 
+function showUpdateHelp() {
+  console.log(`
+Update Commands:
+  check      Check for updates (default)
+  now        Update to latest version immediately
+  enable     Enable auto-update at startup
+  disable    Disable auto-update
+
+Examples:
+  zuppaclaude update                         # Check for updates
+  zuppaclaude update now                     # Update immediately
+  zuppaclaude update enable                  # Enable auto-update
+  zuppaclaude update disable                 # Disable auto-update
+`);
+}
+
 main();

package/lib/components/index.js

@@ -11,6 +11,7 @@ const { SessionManager } = require('./session');
 const { CloudManager } = require('./cloud');
 const { BackupManager } = require('./backup');
 const { CommandsInstaller } = require('./commands');
+const { UpdateManager } = require('./updater');
 
 module.exports = {
   SuperClaudeInstaller,
@@ -21,5 +22,6 @@ module.exports = {
   SessionManager,
   CloudManager,
   BackupManager,
-  CommandsInstaller
+  CommandsInstaller,
+  UpdateManager
 };

package/lib/components/updater.js

@@ -0,0 +1,216 @@
+/**
+ * Auto-Update Manager
+ * Checks for updates and auto-updates if enabled
+ */
+
+const { execSync } = require('child_process');
+const https = require('https');
+const { Logger } = require('../utils/logger');
+const { Settings } = require('../settings');
+
+class UpdateManager {
+  constructor() {
+    this.logger = new Logger();
+    this.settings = new Settings();
+    this.packageName = 'zuppaclaude';
+    this.currentVersion = require('../../package.json').version;
+  }
+
+  /**
+   * Get latest version from npm
+   */
+  async getLatestVersion() {
+    return new Promise((resolve, reject) => {
+      const url = `https://registry.npmjs.org/${this.packageName}/latest`;
+
+      https.get(url, (res) => {
+        let data = '';
+
+        res.on('data', (chunk) => {
+          data += chunk;
+        });
+
+        res.on('end', () => {
+          try {
+            const json = JSON.parse(data);
+            resolve(json.version);
+          } catch (e) {
+            reject(e);
+          }
+        });
+      }).on('error', (err) => {
+        reject(err);
+      });
+    });
+  }
+
+  /**
+   * Compare versions (returns true if latest > current)
+   */
+  isNewerVersion(latest, current) {
+    const latestParts = latest.split('.').map(Number);
+    const currentParts = current.split('.').map(Number);
+
+    for (let i = 0; i < 3; i++) {
+      if (latestParts[i] > currentParts[i]) return true;
+      if (latestParts[i] < currentParts[i]) return false;
+    }
+    return false;
+  }
+
+  /**
+   * Check for updates
+   */
+  async checkForUpdates(silent = false) {
+    try {
+      const latestVersion = await this.getLatestVersion();
+      const hasUpdate = this.isNewerVersion(latestVersion, this.currentVersion);
+
+      if (hasUpdate && !silent) {
+        console.log('');
+        console.log('\x1b[33m╔═══════════════════════════════════════════════════════════════════╗\x1b[0m');
+        console.log('\x1b[33m║   Update Available!                                               ║\x1b[0m');
+        console.log('\x1b[33m╚═══════════════════════════════════════════════════════════════════╝\x1b[0m');
+        console.log('');
+        console.log(`  Current version: \x1b[31m${this.currentVersion}\x1b[0m`);
+        console.log(`  Latest version:  \x1b[32m${latestVersion}\x1b[0m`);
+        console.log('');
+      }
+
+      return {
+        hasUpdate,
+        currentVersion: this.currentVersion,
+        latestVersion
+      };
+    } catch (error) {
+      // Silently fail - don't interrupt user workflow
+      return {
+        hasUpdate: false,
+        currentVersion: this.currentVersion,
+        latestVersion: null,
+        error: error.message
+      };
+    }
+  }
+
+  /**
+   * Update to latest version
+   */
+  async update() {
+    try {
+      this.logger.step('Updating ZuppaClaude...');
+
+      // Use npm to update globally
+      execSync(`npm install -g ${this.packageName}@latest`, {
+        stdio: 'inherit'
+      });
+
+      // Verify update
+      const newVersion = await this.getLatestVersion();
+      this.logger.success(`Updated to v${newVersion}`);
+
+      return true;
+    } catch (error) {
+      this.logger.error(`Update failed: ${error.message}`);
+      this.logger.info(`Manual update: npm install -g ${this.packageName}@latest`);
+      return false;
+    }
+  }
+
+  /**
+   * Check and auto-update if enabled
+   * Called at startup
+   */
+  async checkAndUpdate() {
+    const userSettings = this.settings.load() || {};
+    const autoUpdate = userSettings.autoUpdate !== false; // Default true
+
+    const result = await this.checkForUpdates(true);
+
+    if (result.hasUpdate) {
+      if (autoUpdate) {
+        console.log('');
+        console.log(`\x1b[36m[i]\x1b[0m New version available: v${result.latestVersion}`);
+        console.log('\x1b[36m[i]\x1b[0m Auto-updating...');
+        console.log('');
+
+        const updated = await this.update();
+
+        if (updated) {
+          console.log('');
+          console.log('\x1b[32m[✓]\x1b[0m Update complete! Please restart to use the new version.');
+          console.log('');
+          return { updated: true, version: result.latestVersion };
+        }
+      } else {
+        // Just notify
+        console.log('');
+        console.log(`\x1b[33m[!]\x1b[0m Update available: v${this.currentVersion} → v${result.latestVersion}`);
+        console.log(`\x1b[33m[!]\x1b[0m Run: npm install -g ${this.packageName}@latest`);
+        console.log('');
+        return { updated: false, version: result.latestVersion };
+      }
+    }
+
+    return { updated: false, version: this.currentVersion };
+  }
+
+  /**
+   * Enable auto-update
+   */
+  enableAutoUpdate() {
+    const userSettings = this.settings.load() || {};
+    userSettings.autoUpdate = true;
+    this.settings.save(userSettings);
+    this.logger.success('Auto-update enabled');
+  }
+
+  /**
+   * Disable auto-update
+   */
+  disableAutoUpdate() {
+    const userSettings = this.settings.load() || {};
+    userSettings.autoUpdate = false;
+    this.settings.save(userSettings);
+    this.logger.success('Auto-update disabled');
+  }
+
+  /**
+   * Show update status
+   */
+  async status() {
+    const userSettings = this.settings.load() || {};
+    const autoUpdate = userSettings.autoUpdate !== false;
+
+    console.log('');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('\x1b[35m                    Update Status\x1b[0m');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('');
+    console.log(`  Current version: \x1b[36m${this.currentVersion}\x1b[0m`);
+    console.log(`  Auto-update:     ${autoUpdate ? '\x1b[32menabled\x1b[0m' : '\x1b[31mdisabled\x1b[0m'}`);
+    console.log('');
+
+    this.logger.info('Checking for updates...');
+    const result = await this.checkForUpdates(true);
+
+    if (result.latestVersion) {
+      console.log(`  Latest version:  \x1b[36m${result.latestVersion}\x1b[0m`);
+
+      if (result.hasUpdate) {
+        console.log('');
+        console.log('  \x1b[33mUpdate available!\x1b[0m');
+        console.log(`  Run: \x1b[36mnpm install -g ${this.packageName}@latest\x1b[0m`);
+      } else {
+        console.log('');
+        console.log('  \x1b[32mYou are up to date!\x1b[0m');
+      }
+    } else {
+      console.log('  \x1b[31mCould not check for updates\x1b[0m');
+    }
+
+    console.log('');
+  }
+}
+
+module.exports = { UpdateManager };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zuppaclaude",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "Claude Code power-up installer - SuperClaude + Spec Kit + Claude-Z + Claude HUD",
   "main": "lib/index.js",
   "bin": {