zuppaclaude 1.0.2 → 1.2.0

package/lib/components/cloud.js

@@ -0,0 +1,335 @@
+/**
+ * Cloud Backup Manager - rclone integration for cloud sync
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { Logger } = require('../utils/logger');
+const { Platform } = require('../utils/platform');
+
+class CloudManager {
+  constructor() {
+    this.platform = new Platform();
+    this.logger = new Logger();
+    this.backupDir = path.join(this.platform.zuppaconfigDir, 'backups');
+    this.cloudPath = 'zuppaclaude-backups';
+  }
+
+  /**
+   * Check if rclone is installed
+   */
+  isRcloneInstalled() {
+    return this.platform.commandExists('rclone');
+  }
+
+  /**
+   * Get available rclone remotes
+   */
+  getRemotes() {
+    if (!this.isRcloneInstalled()) {
+      return [];
+    }
+
+    try {
+      const output = this.platform.exec('rclone listremotes', { silent: true });
+      if (!output) return [];
+
+      return output
+        .split('\n')
+        .map(r => r.trim().replace(/:$/, ''))
+        .filter(r => r.length > 0);
+    } catch (error) {
+      return [];
+    }
+  }
+
+  /**
+   * Check remote exists
+   */
+  remoteExists(remote) {
+    const remotes = this.getRemotes();
+    return remotes.includes(remote);
+  }
+
+  /**
+   * Show rclone setup instructions
+   */
+  showSetupInstructions() {
+    console.log('');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('\x1b[35m                    Cloud Backup Setup\x1b[0m');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('');
+
+    if (!this.isRcloneInstalled()) {
+      console.log('\x1b[33m[!]\x1b[0m rclone is not installed.');
+      console.log('');
+      console.log('Install rclone:');
+      console.log('');
+      if (this.platform.isMac) {
+        console.log('  \x1b[36mbrew install rclone\x1b[0m');
+      } else if (this.platform.isLinux) {
+        console.log('  \x1b[36mcurl https://rclone.org/install.sh | sudo bash\x1b[0m');
+      } else {
+        console.log('  \x1b[36mwinget install Rclone.Rclone\x1b[0m');
+      }
+      console.log('');
+      console.log('Or visit: https://rclone.org/install/');
+      console.log('');
+      return false;
+    }
+
+    console.log('\x1b[32m[✓]\x1b[0m rclone is installed');
+    console.log('');
+
+    const remotes = this.getRemotes();
+
+    if (remotes.length === 0) {
+      console.log('\x1b[33m[!]\x1b[0m No cloud remotes configured.');
+      console.log('');
+      console.log('Configure a remote:');
+      console.log('');
+      console.log('  \x1b[36mrclone config\x1b[0m');
+      console.log('');
+      console.log('Popular options:');
+      console.log('  • Google Drive: Choose "drive"');
+      console.log('  • Dropbox: Choose "dropbox"');
+      console.log('  • OneDrive: Choose "onedrive"');
+      console.log('  • S3/Minio: Choose "s3"');
+      console.log('  • SFTP: Choose "sftp"');
+      console.log('  • FTP: Choose "ftp"');
+      console.log('');
+      return false;
+    }
+
+    console.log('Available remotes:');
+    console.log('');
+    for (const remote of remotes) {
+      console.log(`  \x1b[36m${remote}\x1b[0m`);
+    }
+    console.log('');
+    console.log('Usage:');
+    console.log('');
+    console.log(`  \x1b[36mnpx zuppaclaude backup --cloud ${remotes[0]}\x1b[0m`);
+    console.log(`  \x1b[36mnpx zuppaclaude restore --cloud ${remotes[0]}\x1b[0m`);
+    console.log('');
+
+    return true;
+  }
+
+  /**
+   * List remotes
+   */
+  listRemotes() {
+    if (!this.isRcloneInstalled()) {
+      this.logger.error('rclone is not installed');
+      this.showSetupInstructions();
+      return [];
+    }
+
+    const remotes = this.getRemotes();
+
+    if (remotes.length === 0) {
+      this.logger.warning('No remotes configured');
+      this.showSetupInstructions();
+      return [];
+    }
+
+    console.log('');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('\x1b[35m                    Available Cloud Remotes\x1b[0m');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('');
+
+    for (const remote of remotes) {
+      // Try to get remote type
+      let type = 'unknown';
+      try {
+        const config = this.platform.exec(`rclone config show ${remote}`, { silent: true });
+        const typeMatch = config?.match(/type\s*=\s*(\w+)/);
+        if (typeMatch) type = typeMatch[1];
+      } catch (e) {
+        // Ignore
+      }
+
+      const icon = this.getRemoteIcon(type);
+      console.log(`  ${icon} \x1b[36m${remote}\x1b[0m (${type})`);
+    }
+
+    console.log('');
+    return remotes;
+  }
+
+  /**
+   * Get icon for remote type
+   */
+  getRemoteIcon(type) {
+    const icons = {
+      'drive': '📁',
+      'dropbox': '📦',
+      'onedrive': '☁️',
+      's3': '🪣',
+      'sftp': '🔐',
+      'ftp': '📡',
+      'b2': '🅱️',
+      'box': '📥',
+      'mega': '🔷',
+      'pcloud': '☁️'
+    };
+    return icons[type] || '☁️';
+  }
+
+  /**
+   * Upload backup to cloud
+   */
+  async upload(remote, backupId = null) {
+    if (!this.isRcloneInstalled()) {
+      this.logger.error('rclone is not installed');
+      this.showSetupInstructions();
+      return false;
+    }
+
+    if (!this.remoteExists(remote)) {
+      this.logger.error(`Remote not found: ${remote}`);
+      this.logger.info('Run "npx zuppaclaude cloud remotes" to see available remotes');
+      return false;
+    }
+
+    // Determine what to upload
+    let sourcePath = this.backupDir;
+    let destPath = `${remote}:${this.cloudPath}`;
+
+    if (backupId) {
+      sourcePath = path.join(this.backupDir, backupId);
+      if (!fs.existsSync(sourcePath)) {
+        this.logger.error(`Backup not found: ${backupId}`);
+        return false;
+      }
+      destPath = `${remote}:${this.cloudPath}/${backupId}`;
+    }
+
+    if (!fs.existsSync(sourcePath)) {
+      this.logger.error('No backups to upload');
+      this.logger.info('Run "npx zuppaclaude backup" first');
+      return false;
+    }
+
+    console.log('');
+    this.logger.step(`Uploading to ${remote}...`);
+    console.log('');
+
+    try {
+      // Use rclone sync for efficiency
+      const cmd = `rclone sync "${sourcePath}" "${destPath}" --progress`;
+      this.platform.exec(cmd, { silent: false, stdio: 'inherit' });
+
+      console.log('');
+      this.logger.success(`Backup uploaded to ${remote}:${this.cloudPath}`);
+      console.log('');
+      return true;
+    } catch (error) {
+      this.logger.error(`Upload failed: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Download backup from cloud
+   */
+  async download(remote, backupId = null) {
+    if (!this.isRcloneInstalled()) {
+      this.logger.error('rclone is not installed');
+      this.showSetupInstructions();
+      return false;
+    }
+
+    if (!this.remoteExists(remote)) {
+      this.logger.error(`Remote not found: ${remote}`);
+      return false;
+    }
+
+    let sourcePath = `${remote}:${this.cloudPath}`;
+    let destPath = this.backupDir;
+
+    if (backupId) {
+      sourcePath = `${remote}:${this.cloudPath}/${backupId}`;
+      destPath = path.join(this.backupDir, backupId);
+    }
+
+    this.platform.ensureDir(destPath);
+
+    console.log('');
+    this.logger.step(`Downloading from ${remote}...`);
+    console.log('');
+
+    try {
+      const cmd = `rclone sync "${sourcePath}" "${destPath}" --progress`;
+      this.platform.exec(cmd, { silent: false, stdio: 'inherit' });
+
+      console.log('');
+      this.logger.success(`Backup downloaded from ${remote}`);
+      console.log('');
+      return true;
+    } catch (error) {
+      this.logger.error(`Download failed: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * List cloud backups
+   */
+  async listCloudBackups(remote) {
+    if (!this.isRcloneInstalled()) {
+      this.logger.error('rclone is not installed');
+      return [];
+    }
+
+    if (!this.remoteExists(remote)) {
+      this.logger.error(`Remote not found: ${remote}`);
+      return [];
+    }
+
+    try {
+      const cmd = `rclone lsd "${remote}:${this.cloudPath}" 2>/dev/null`;
+      const output = this.platform.exec(cmd, { silent: true });
+
+      if (!output) {
+        this.logger.warning('No cloud backups found');
+        return [];
+      }
+
+      const backups = output
+        .split('\n')
+        .filter(line => line.trim())
+        .map(line => {
+          const parts = line.trim().split(/\s+/);
+          const name = parts[parts.length - 1];
+          return name;
+        })
+        .filter(name => name && name.match(/^\d{4}-\d{2}-\d{2}T/));
+
+      console.log('');
+      console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+      console.log(`\x1b[35m                    Cloud Backups (${remote})\x1b[0m`);
+      console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+      console.log('');
+
+      if (backups.length === 0) {
+        console.log('  No backups found');
+      } else {
+        for (const backup of backups) {
+          console.log(`  📦 ${backup}`);
+        }
+      }
+
+      console.log('');
+      return backups;
+    } catch (error) {
+      this.logger.warning('Could not list cloud backups');
+      return [];
+    }
+  }
+}
+
+module.exports = { CloudManager };

package/lib/components/commands.js

@@ -0,0 +1,139 @@
+/**
+ * ZuppaClaude Commands Installer
+ * Installs /zc:* slash commands for Claude Code
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { Logger } = require('../utils/logger');
+const { Platform } = require('../utils/platform');
+
+class CommandsInstaller {
+  constructor() {
+    this.platform = new Platform();
+    this.logger = new Logger();
+    this.commandsDir = path.join(this.platform.claudeDir, 'commands', 'zc');
+    this.sourceDir = path.join(__dirname, '..', '..', 'assets', 'commands', 'zc');
+  }
+
+  /**
+   * Check if commands are installed
+   */
+  isInstalled() {
+    return fs.existsSync(this.commandsDir) &&
+           fs.existsSync(path.join(this.commandsDir, 'help.md'));
+  }
+
+  /**
+   * Install ZuppaClaude commands
+   */
+  async install() {
+    this.logger.step('Installing ZuppaClaude Slash Commands');
+
+    try {
+      // Ensure commands directory exists
+      this.platform.ensureDir(this.commandsDir);
+
+      // Get list of command files
+      const files = fs.readdirSync(this.sourceDir);
+
+      let installed = 0;
+      for (const file of files) {
+        if (!file.endsWith('.md')) continue;
+
+        const srcPath = path.join(this.sourceDir, file);
+        const destPath = path.join(this.commandsDir, file);
+
+        try {
+          fs.copyFileSync(srcPath, destPath);
+          installed++;
+        } catch (error) {
+          this.logger.warning(`Failed to install ${file}: ${error.message}`);
+        }
+      }
+
+      this.logger.success(`Installed ${installed} slash commands`);
+      this.logger.info('Commands available: /zc:backup, /zc:restore, /zc:cloud, /zc:session, /zc:settings, /zc:help');
+
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to install commands: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Uninstall commands
+   */
+  uninstall() {
+    if (!fs.existsSync(this.commandsDir)) {
+      this.logger.info('ZuppaClaude commands not found');
+      return true;
+    }
+
+    try {
+      fs.rmSync(this.commandsDir, { recursive: true });
+      this.logger.success('ZuppaClaude commands removed');
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to remove commands: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Verify installation
+   */
+  verify() {
+    if (this.isInstalled()) {
+      this.logger.success('ZuppaClaude Commands: Installed');
+
+      // Count installed commands
+      try {
+        const files = fs.readdirSync(this.commandsDir)
+          .filter(f => f.endsWith('.md') && f !== 'README.md');
+        this.logger.info(`Available: /zc:${files.map(f => f.replace('.md', '')).join(', /zc:')}`);
+      } catch (e) {
+        // Ignore
+      }
+
+      return true;
+    } else {
+      this.logger.warning('ZuppaClaude Commands: Not installed');
+      return false;
+    }
+  }
+
+  /**
+   * List available commands
+   */
+  list() {
+    console.log('');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('\x1b[35m                    ZuppaClaude Commands\x1b[0m');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('');
+
+    const commands = [
+      { cmd: '/zc:backup', desc: 'Full backup (sessions + settings + cloud)' },
+      { cmd: '/zc:restore', desc: 'Restore from backup' },
+      { cmd: '/zc:cloud', desc: 'Cloud backup management' },
+      { cmd: '/zc:session', desc: 'Session management' },
+      { cmd: '/zc:settings', desc: 'Settings management' },
+      { cmd: '/zc:help', desc: 'Show help' }
+    ];
+
+    for (const { cmd, desc } of commands) {
+      console.log(`  \x1b[36m${cmd.padEnd(18)}\x1b[0m ${desc}`);
+    }
+
+    console.log('');
+    console.log('Usage:');
+    console.log('  Type the command in Claude Code chat, e.g., /zc:backup');
+    console.log('');
+
+    return commands;
+  }
+}
+
+module.exports = { CommandsInstaller };

package/lib/components/index.js

@@ -8,6 +8,9 @@ const { ConfigInstaller } = require('./config');
 const { ClaudeZInstaller } = require('./claudez');
 const { ClaudeHUDInstaller } = require('./claudehud');
 const { SessionManager } = require('./session');
+const { CloudManager } = require('./cloud');
+const { BackupManager } = require('./backup');
+const { CommandsInstaller } = require('./commands');
 
 module.exports = {
   SuperClaudeInstaller,
@@ -15,5 +18,8 @@ module.exports = {
   ConfigInstaller,
   ClaudeZInstaller,
   ClaudeHUDInstaller,
-  SessionManager
+  SessionManager,
+  CloudManager,
+  BackupManager,
+  CommandsInstaller
 };

package/lib/installer.js

@@ -11,7 +11,8 @@ const {
   SpecKitInstaller,
   ConfigInstaller,
   ClaudeZInstaller,
-  ClaudeHUDInstaller
+  ClaudeHUDInstaller,
+  CommandsInstaller
 } = require('./components');
 
 class Installer {
@@ -27,6 +28,7 @@ class Installer {
     this.config = new ConfigInstaller();
     this.claudeZ = new ClaudeZInstaller();
     this.claudeHUD = new ClaudeHUDInstaller();
+    this.commands = new CommandsInstaller();
   }
 
   /**
@@ -36,7 +38,7 @@ class Installer {
     this.logger.banner();
 
     // Step 1: Check dependencies
-    this.logger.step('Step 1/7: Checking Dependencies');
+    this.logger.step('Step 1/8: Checking Dependencies');
     const depsOk = await this.checkDependencies();
     if (!depsOk) {
       this.logger.error('Dependency check failed. Please install required dependencies.');
@@ -110,8 +112,12 @@ class Installer {
       this.logger.info('Skipping Claude HUD installation');
     }
 
-    // Step 7: Verification
-    this.logger.step('Step 7/7: Verifying Installation');
+    // Step 7: Install ZuppaClaude Commands
+    this.logger.step('Step 7/8: Installing ZuppaClaude Slash Commands');
+    const cmdsInstalled = await this.commands.install();
+
+    // Step 8: Verification
+    this.logger.step('Step 8/8: Verifying Installation');
     console.log('');
 
     this.superClaude.verify();
@@ -119,6 +125,7 @@ class Installer {
     this.config.verify();
     if (installClaudeZ) this.claudeZ.verify();
     if (installClaudeHUD) this.claudeHUD.verify();
+    this.commands.verify();
 
     // Save settings
     const newSettings = {
@@ -139,7 +146,8 @@ class Installer {
       specKit: skInstalled,
       config: cfgInstalled,
       claudeZ: czInstalled,
-      claudeHUD: hudInstalled
+      claudeHUD: hudInstalled,
+      commands: cmdsInstalled
     });
 
     return true;
@@ -205,7 +213,8 @@ class Installer {
       { name: 'Spec Kit', installed: results.specKit },
       { name: 'CLAUDE.md', installed: results.config },
       { name: 'Claude-Z', installed: results.claudeZ },
-      { name: 'Claude HUD', installed: results.claudeHUD }
+      { name: 'Claude HUD', installed: results.claudeHUD },
+      { name: 'ZC Commands', installed: results.commands }
     ];
 
     let installed = 0;
@@ -223,7 +232,14 @@ class Installer {
     console.log('  Next steps:');
     console.log('  1. Restart your terminal or run: source ~/.bashrc');
     console.log('  2. Start Claude Code: claude');
-    console.log('  3. Try: /sc:help');
+    console.log('  3. Try: /sc:help or /zc:help');
+    console.log('');
+
+    console.log('  ZuppaClaude commands:');
+    console.log('  /zc:backup    - Full backup (sessions + settings)');
+    console.log('  /zc:restore   - Restore from backup');
+    console.log('  /zc:cloud     - Cloud backup management');
+    console.log('  /zc:help      - Show all commands');
     console.log('');
 
     if (results.claudeZ) {

package/lib/uninstaller.js

@@ -10,7 +10,8 @@ const {
   SpecKitInstaller,
   ConfigInstaller,
   ClaudeZInstaller,
-  ClaudeHUDInstaller
+  ClaudeHUDInstaller,
+  CommandsInstaller
 } = require('./components');
 
 class Uninstaller {
@@ -25,6 +26,7 @@ class Uninstaller {
     this.config = new ConfigInstaller();
     this.claudeZ = new ClaudeZInstaller();
     this.claudeHUD = new ClaudeHUDInstaller();
+    this.commands = new CommandsInstaller();
   }
 
   /**
@@ -57,7 +59,8 @@ class Uninstaller {
       specKit: this.specKit.uninstall(),
       config: this.config.uninstall(),
       claudeZ: this.claudeZ.uninstall(),
-      claudeHUD: this.claudeHUD.uninstall()
+      claudeHUD: this.claudeHUD.uninstall(),
+      commands: this.commands.uninstall()
     };
 
     // Handle settings
@@ -89,7 +92,8 @@ class Uninstaller {
       { name: 'Spec Kit', removed: results.specKit },
       { name: 'CLAUDE.md', removed: results.config },
       { name: 'Claude-Z', removed: results.claudeZ },
-      { name: 'Claude HUD', removed: results.claudeHUD }
+      { name: 'Claude HUD', removed: results.claudeHUD },
+      { name: 'ZC Commands', removed: results.commands }
     ];
 
     let removed = 0;

package/package.json

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