zuppaclaude 1.0.0 → 1.0.2

package/README.md

@@ -197,6 +197,27 @@ npx zuppaclaude settings reset             # 🔄 Fabrika ayarları
 | 🔐 API key koruması | Base64 encoded saklama |
 | 🛡️ Uninstall koruması | Kaldırırken ayarları koruma opsiyonu |
 
+### 💾 Session Yedekleme
+
+Claude Code session'larınızı yedekleyin ve geri yükleyin. Context kaybı, format veya compacting durumlarında kullanışlı.
+
+```bash
+npx zuppaclaude session list        # 📋 Tüm session'ları listele
+npx zuppaclaude session backup      # 💾 Tüm session'ları yedekle
+npx zuppaclaude session backups     # 📦 Mevcut yedekleri listele
+npx zuppaclaude session restore <id> # ♻️ Yedekten geri yükle
+npx zuppaclaude session export <id>  # 📤 Belirli session'ı export et
+```
+
+**📁 Yedek konumu:** `~/.config/zuppaclaude/backups/`
+
+**✨ Özellikler:**
+| Özellik | Açıklama |
+|---------|----------|
+| 🔒 Güvenli restore | Mevcut session'lar üzerine yazılmaz |
+| 📜 History desteği | Command history de yedeklenir |
+| 📋 Manifest | Her yedekte metadata saklanır |
+
 ### 🗑️ Kaldırma
 
 **📦 NPM ile:**
@@ -423,6 +444,27 @@ npx zuppaclaude settings reset             # 🔄 Reset to defaults
 | 🔐 API key protection | Base64 encoded storage |
 | 🛡️ Uninstall protection | Option to preserve settings when uninstalling |
 
+### 💾 Session Backup
+
+Backup and restore your Claude Code sessions. Useful for context loss, formatting, or conversation compacting.
+
+```bash
+npx zuppaclaude session list        # 📋 List all sessions
+npx zuppaclaude session backup      # 💾 Backup all sessions
+npx zuppaclaude session backups     # 📦 List available backups
+npx zuppaclaude session restore <id> # ♻️ Restore from backup
+npx zuppaclaude session export <id>  # 📤 Export specific session
+```
+
+**📁 Backup location:** `~/.config/zuppaclaude/backups/`
+
+**✨ Features:**
+| Feature | Description |
+|---------|-------------|
+| 🔒 Safe restore | Existing sessions are not overwritten |
+| 📜 History support | Command history is also backed up |
+| 📋 Manifest | Metadata saved with each backup |
+
 ### 🗑️ Uninstall
 
 **📦 Via NPM:**

package/bin/zuppaclaude.js

@@ -71,6 +71,49 @@ async function main() {
         }
         break;
 
+      case 'session':
+      case 'sessions':
+        const { SessionManager } = require('../lib/components/session');
+        const sessionManager = new SessionManager();
+        const sessionCmd = args[1] || 'list';
+        const sessionArg = args[2];
+
+        switch (sessionCmd) {
+          case 'list':
+          case 'ls':
+            sessionManager.list();
+            break;
+          case 'backup':
+          case 'save':
+            sessionManager.backup();
+            break;
+          case 'backups':
+            sessionManager.listBackups();
+            break;
+          case 'restore':
+            if (!sessionArg) {
+              logger.error('Please specify backup ID');
+              logger.info('Usage: zuppaclaude session restore <backup-id>');
+              logger.info('Run "zuppaclaude session backups" to see available backups');
+              process.exit(1);
+            }
+            sessionManager.restore(sessionArg);
+            break;
+          case 'export':
+            if (!sessionArg) {
+              logger.error('Please specify session ID');
+              logger.info('Usage: zuppaclaude session export <session-id> [output-file]');
+              logger.info('Run "zuppaclaude session list" to see session IDs');
+              process.exit(1);
+            }
+            sessionManager.export(sessionArg, args[3]);
+            break;
+          default:
+            logger.error(`Unknown session command: ${sessionCmd}`);
+            showSessionHelp();
+        }
+        break;
+
       case 'version':
       case 'v':
       case '-v':
@@ -108,6 +151,7 @@ Commands:
   install, i          Install ZuppaClaude components (default)
   uninstall, u        Uninstall ZuppaClaude components
   settings, s         Manage settings
+  session             Manage Claude Code sessions
   version, v          Show version
   help, h             Show this help
 
@@ -118,12 +162,20 @@ Settings Commands:
   settings reset      Reset settings to default
   settings path       Show settings file path
 
+Session Commands:
+  session list        List all sessions
+  session backup      Backup all sessions
+  session backups     List available backups
+  session restore     Restore from backup
+  session export      Export a specific session
+
 Examples:
   npx zuppaclaude                    # Install
   npx zuppaclaude install            # Install
   npx zuppaclaude uninstall          # Uninstall
   npx zuppaclaude settings show      # View settings
-  npx zuppaclaude settings export ~/backup.json
+  npx zuppaclaude session backup     # Backup sessions
+  npx zuppaclaude session restore 2026-01-05T12-00-00
 `);
 }
 
@@ -144,4 +196,22 @@ Examples:
 `);
 }
 
+function showSessionHelp() {
+  console.log(`
+Session Commands:
+  list       List all Claude Code sessions
+  backup     Backup all sessions to ~/.config/zuppaclaude/backups/
+  backups    List available backups
+  restore    Restore sessions from a backup
+  export     Export a specific session to a file
+
+Examples:
+  zuppaclaude session list
+  zuppaclaude session backup
+  zuppaclaude session backups
+  zuppaclaude session restore 2026-01-05T12-00-00
+  zuppaclaude session export abc123 ./my-session.jsonl
+`);
+}
+
 main();

package/lib/components/index.js

@@ -7,11 +7,13 @@ const { SpecKitInstaller } = require('./speckit');
 const { ConfigInstaller } = require('./config');
 const { ClaudeZInstaller } = require('./claudez');
 const { ClaudeHUDInstaller } = require('./claudehud');
+const { SessionManager } = require('./session');
 
 module.exports = {
   SuperClaudeInstaller,
   SpecKitInstaller,
   ConfigInstaller,
   ClaudeZInstaller,
-  ClaudeHUDInstaller
+  ClaudeHUDInstaller,
+  SessionManager
 };

package/lib/components/session.js

@@ -0,0 +1,425 @@
+/**
+ * Session Manager - Backup and restore Claude Code sessions
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { Logger } = require('../utils/logger');
+const { Platform } = require('../utils/platform');
+
+class SessionManager {
+  constructor() {
+    this.platform = new Platform();
+    this.logger = new Logger();
+    this.claudeDir = this.platform.claudeDir;
+    this.projectsDir = path.join(this.claudeDir, 'projects');
+    this.backupDir = path.join(this.platform.zuppaconfigDir, 'backups');
+  }
+
+  /**
+   * Get all projects with sessions
+   */
+  getProjects() {
+    if (!fs.existsSync(this.projectsDir)) {
+      return [];
+    }
+
+    return fs.readdirSync(this.projectsDir)
+      .filter(name => {
+        const projectPath = path.join(this.projectsDir, name);
+        return fs.statSync(projectPath).isDirectory() && name !== '.' && name !== '..';
+      })
+      .map(name => {
+        const projectPath = path.join(this.projectsDir, name);
+        const sessions = this.getProjectSessions(projectPath);
+        const realPath = name.replace(/-/g, '/').replace(/^\//, '');
+
+        return {
+          id: name,
+          path: realPath,
+          sessionsDir: projectPath,
+          sessions: sessions,
+          totalSize: sessions.reduce((sum, s) => sum + s.size, 0)
+        };
+      })
+      .filter(p => p.sessions.length > 0);
+  }
+
+  /**
+   * Get sessions for a project
+   */
+  getProjectSessions(projectPath) {
+    if (!fs.existsSync(projectPath)) {
+      return [];
+    }
+
+    return fs.readdirSync(projectPath)
+      .filter(name => name.endsWith('.jsonl'))
+      .map(name => {
+        const filePath = path.join(projectPath, name);
+        const stats = fs.statSync(filePath);
+        const isAgent = name.startsWith('agent-');
+
+        return {
+          id: name.replace('.jsonl', ''),
+          file: name,
+          path: filePath,
+          size: stats.size,
+          modified: stats.mtime,
+          isAgent: isAgent,
+          type: isAgent ? 'agent' : 'main'
+        };
+      })
+      .sort((a, b) => b.modified - a.modified);
+  }
+
+  /**
+   * List all sessions
+   */
+  list(options = {}) {
+    const projects = this.getProjects();
+
+    if (projects.length === 0) {
+      this.logger.warning('No sessions found');
+      return [];
+    }
+
+    console.log('');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('\x1b[35m                    Claude Code Sessions\x1b[0m');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('');
+
+    let totalSessions = 0;
+    let totalSize = 0;
+
+    for (const project of projects) {
+      const shortPath = project.path.length > 50
+        ? '...' + project.path.slice(-47)
+        : project.path;
+
+      console.log(`\x1b[36m📁 ${shortPath}\x1b[0m`);
+
+      for (const session of project.sessions) {
+        const sizeStr = this.formatSize(session.size);
+        const dateStr = this.formatDate(session.modified);
+        const typeIcon = session.isAgent ? '🤖' : '💬';
+        const shortId = session.id.length > 20 ? session.id.slice(0, 20) + '...' : session.id;
+
+        console.log(`   ${typeIcon} ${shortId}  ${sizeStr}  ${dateStr}`);
+        totalSessions++;
+        totalSize += session.size;
+      }
+      console.log('');
+    }
+
+    console.log(`Total: ${totalSessions} sessions, ${this.formatSize(totalSize)}`);
+    console.log('');
+
+    return projects;
+  }
+
+  /**
+   * Backup all sessions
+   */
+  backup(options = {}) {
+    const projects = this.getProjects();
+
+    if (projects.length === 0) {
+      this.logger.warning('No sessions to backup');
+      return null;
+    }
+
+    // Create backup directory with timestamp
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const backupPath = path.join(this.backupDir, timestamp);
+    const sessionsBackupPath = path.join(backupPath, 'sessions');
+
+    this.platform.ensureDir(sessionsBackupPath);
+
+    console.log('');
+    this.logger.step('Backing up Claude Code sessions...');
+    console.log('');
+
+    let backedUp = 0;
+    let totalSize = 0;
+    const manifest = {
+      timestamp: new Date().toISOString(),
+      version: require('../../package.json').version,
+      projects: []
+    };
+
+    for (const project of projects) {
+      const projectBackupPath = path.join(sessionsBackupPath, project.id);
+      this.platform.ensureDir(projectBackupPath);
+
+      const projectManifest = {
+        id: project.id,
+        path: project.path,
+        sessions: []
+      };
+
+      for (const session of project.sessions) {
+        try {
+          const destPath = path.join(projectBackupPath, session.file);
+          fs.copyFileSync(session.path, destPath);
+
+          projectManifest.sessions.push({
+            id: session.id,
+            file: session.file,
+            size: session.size,
+            modified: session.modified.toISOString(),
+            type: session.type
+          });
+
+          backedUp++;
+          totalSize += session.size;
+        } catch (error) {
+          this.logger.warning(`Failed to backup ${session.id}: ${error.message}`);
+        }
+      }
+
+      manifest.projects.push(projectManifest);
+    }
+
+    // Also backup history.jsonl if exists
+    const historyPath = path.join(this.claudeDir, 'history.jsonl');
+    if (fs.existsSync(historyPath)) {
+      try {
+        fs.copyFileSync(historyPath, path.join(backupPath, 'history.jsonl'));
+        const historyStats = fs.statSync(historyPath);
+        manifest.history = {
+          size: historyStats.size,
+          modified: historyStats.mtime.toISOString()
+        };
+        totalSize += historyStats.size;
+        this.logger.success('Command history backed up');
+      } catch (error) {
+        this.logger.warning(`Failed to backup history: ${error.message}`);
+      }
+    }
+
+    // Save manifest
+    fs.writeFileSync(
+      path.join(backupPath, 'manifest.json'),
+      JSON.stringify(manifest, null, 2)
+    );
+
+    console.log('');
+    this.logger.success(`Backup complete: ${backedUp} sessions, ${this.formatSize(totalSize)}`);
+    this.logger.info(`Location: ${backupPath}`);
+    console.log('');
+
+    return {
+      path: backupPath,
+      sessions: backedUp,
+      size: totalSize,
+      timestamp: timestamp
+    };
+  }
+
+  /**
+   * List available backups
+   */
+  listBackups() {
+    if (!fs.existsSync(this.backupDir)) {
+      this.logger.warning('No backups found');
+      return [];
+    }
+
+    const backups = fs.readdirSync(this.backupDir)
+      .filter(name => {
+        const backupPath = path.join(this.backupDir, name);
+        return fs.statSync(backupPath).isDirectory();
+      })
+      .map(name => {
+        const backupPath = path.join(this.backupDir, name);
+        const manifestPath = path.join(backupPath, 'manifest.json');
+
+        let manifest = null;
+        if (fs.existsSync(manifestPath)) {
+          try {
+            manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+          } catch (e) {
+            // Ignore parse errors
+          }
+        }
+
+        const totalSessions = manifest?.projects?.reduce(
+          (sum, p) => sum + (p.sessions?.length || 0), 0
+        ) || 0;
+
+        return {
+          id: name,
+          path: backupPath,
+          timestamp: manifest?.timestamp || name,
+          sessions: totalSessions,
+          projects: manifest?.projects?.length || 0
+        };
+      })
+      .sort((a, b) => b.id.localeCompare(a.id));
+
+    if (backups.length === 0) {
+      this.logger.warning('No backups found');
+      return [];
+    }
+
+    console.log('');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('\x1b[35m                    Available Backups\x1b[0m');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('');
+
+    for (const backup of backups) {
+      const dateStr = backup.id.replace('T', ' ').replace(/-/g, ':').slice(0, 16).replace(/:/g, '-').slice(0,10) + ' ' + backup.id.slice(11, 16).replace(/-/g, ':');
+      console.log(`  📦 ${backup.id}`);
+      console.log(`     ${backup.projects} projects, ${backup.sessions} sessions`);
+      console.log('');
+    }
+
+    return backups;
+  }
+
+  /**
+   * Restore from backup
+   */
+  restore(backupId) {
+    const backupPath = path.join(this.backupDir, backupId);
+
+    if (!fs.existsSync(backupPath)) {
+      this.logger.error(`Backup not found: ${backupId}`);
+      return false;
+    }
+
+    const manifestPath = path.join(backupPath, 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+      this.logger.error('Invalid backup: manifest.json not found');
+      return false;
+    }
+
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+
+    console.log('');
+    this.logger.step(`Restoring from backup: ${backupId}`);
+    console.log('');
+
+    let restored = 0;
+
+    for (const project of manifest.projects) {
+      const projectBackupPath = path.join(backupPath, 'sessions', project.id);
+      const projectDestPath = path.join(this.projectsDir, project.id);
+
+      if (!fs.existsSync(projectBackupPath)) continue;
+
+      this.platform.ensureDir(projectDestPath);
+
+      for (const session of project.sessions) {
+        const srcPath = path.join(projectBackupPath, session.file);
+        const destPath = path.join(projectDestPath, session.file);
+
+        if (fs.existsSync(srcPath)) {
+          try {
+            // Don't overwrite existing sessions, create with .restored suffix
+            if (fs.existsSync(destPath)) {
+              const restoredPath = destPath.replace('.jsonl', '.restored.jsonl');
+              fs.copyFileSync(srcPath, restoredPath);
+            } else {
+              fs.copyFileSync(srcPath, destPath);
+            }
+            restored++;
+          } catch (error) {
+            this.logger.warning(`Failed to restore ${session.id}: ${error.message}`);
+          }
+        }
+      }
+    }
+
+    // Restore history if exists
+    const historyBackupPath = path.join(backupPath, 'history.jsonl');
+    if (fs.existsSync(historyBackupPath)) {
+      const historyDestPath = path.join(this.claudeDir, 'history.jsonl');
+      try {
+        if (fs.existsSync(historyDestPath)) {
+          fs.copyFileSync(historyBackupPath, historyDestPath + '.restored');
+          this.logger.info('History restored as history.jsonl.restored');
+        } else {
+          fs.copyFileSync(historyBackupPath, historyDestPath);
+          this.logger.success('Command history restored');
+        }
+      } catch (error) {
+        this.logger.warning(`Failed to restore history: ${error.message}`);
+      }
+    }
+
+    console.log('');
+    this.logger.success(`Restored ${restored} sessions`);
+    this.logger.info('Restart Claude Code to see restored sessions');
+    console.log('');
+
+    return true;
+  }
+
+  /**
+   * Export a specific session to a file
+   */
+  export(sessionId, outputPath) {
+    const projects = this.getProjects();
+
+    let foundSession = null;
+    let foundProject = null;
+
+    for (const project of projects) {
+      for (const session of project.sessions) {
+        if (session.id === sessionId || session.id.startsWith(sessionId)) {
+          foundSession = session;
+          foundProject = project;
+          break;
+        }
+      }
+      if (foundSession) break;
+    }
+
+    if (!foundSession) {
+      this.logger.error(`Session not found: ${sessionId}`);
+      return false;
+    }
+
+    const destPath = outputPath || `${foundSession.id}.jsonl`;
+
+    try {
+      fs.copyFileSync(foundSession.path, destPath);
+      this.logger.success(`Session exported to: ${destPath}`);
+      this.logger.info(`Size: ${this.formatSize(foundSession.size)}`);
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to export: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Format file size
+   */
+  formatSize(bytes) {
+    if (bytes < 1024) return bytes + ' B';
+    if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(1) + ' KB';
+    return (bytes / (1024 * 1024)).toFixed(1) + ' MB';
+  }
+
+  /**
+   * Format date
+   */
+  formatDate(date) {
+    const now = new Date();
+    const diff = now - date;
+
+    if (diff < 60000) return 'just now';
+    if (diff < 3600000) return Math.floor(diff / 60000) + 'm ago';
+    if (diff < 86400000) return Math.floor(diff / 3600000) + 'h ago';
+    if (diff < 604800000) return Math.floor(diff / 86400000) + 'd ago';
+
+    return date.toISOString().slice(0, 10);
+  }
+}
+
+module.exports = { SessionManager };

package/package.json

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