@nordsym/apiclaw 1.3.7 → 1.3.9

package/src/cli/commands/restore.ts

@@ -0,0 +1,333 @@
+/**
+ * Restore Command
+ * Rollback MCP client configs from backups
+ */
+
+import { existsSync } from 'fs';
+import { 
+  listBackups, 
+  restoreBackup as doRestore, 
+  getLatestBackup,
+  formatBackupInfo,
+  BackupInfo 
+} from '../../utils/backup.js';
+import { getAllClients, getClientConfig, MCPClient, parseClientArg } from '../../utils/paths.js';
+
+export interface RestoreOptions {
+  client?: string;         // Specific client to restore
+  backup?: string;         // Specific backup file path
+  list?: boolean;          // List available backups
+  all?: boolean;           // Restore all clients
+  interactive?: boolean;   // Interactive mode (future)
+  dryRun?: boolean;        // Show what would be done
+}
+
+export interface RestoreResult {
+  success: boolean;
+  client: string;
+  message: string;
+  backupUsed?: string;
+  preRestoreBackup?: string;
+}
+
+/**
+ * List all available backups for a client
+ */
+function listClientBackups(client: MCPClient): BackupInfo[] {
+  const config = getClientConfig(client);
+  return listBackups(config.configPath);
+}
+
+/**
+ * List all backups across all clients
+ */
+export function listAllBackups(): Map<MCPClient, BackupInfo[]> {
+  const results = new Map<MCPClient, BackupInfo[]>();
+  
+  for (const client of getAllClients()) {
+    const backups = listClientBackups(client);
+    if (backups.length > 0) {
+      results.set(client, backups);
+    }
+  }
+  
+  return results;
+}
+
+/**
+ * Format backup list for display
+ */
+export function formatBackupList(backups: Map<MCPClient, BackupInfo[]>): string {
+  const lines: string[] = [];
+  
+  lines.push('');
+  lines.push('📦 Available Backups');
+  lines.push('====================');
+  lines.push('');
+  
+  if (backups.size === 0) {
+    lines.push('No backups found.');
+    lines.push('');
+    lines.push('Backups are created automatically when you run setup.');
+    lines.push('');
+    return lines.join('\n');
+  }
+  
+  for (const [client, clientBackups] of backups) {
+    const config = getClientConfig(client);
+    lines.push(`${config.displayName}:`);
+    
+    for (let i = 0; i < clientBackups.length; i++) {
+      const backup = clientBackups[i];
+      const marker = i === 0 ? ' (latest)' : '';
+      lines.push(`  ${i + 1}. ${formatBackupInfo(backup)}${marker}`);
+    }
+    
+    lines.push('');
+  }
+  
+  lines.push('Usage:');
+  lines.push('  npx @nordsym/apiclaw restore                     # Restore latest for all');
+  lines.push('  npx @nordsym/apiclaw restore --client claude     # Restore latest for Claude');
+  lines.push('  npx @nordsym/apiclaw restore --backup <path>     # Restore specific backup');
+  lines.push('');
+  
+  return lines.join('\n');
+}
+
+/**
+ * Restore a specific client to its latest backup
+ */
+export function restoreClient(client: MCPClient): RestoreResult {
+  const config = getClientConfig(client);
+  const configPath = config.configPath;
+  
+  // Check if config exists
+  if (!existsSync(configPath)) {
+    return {
+      success: false,
+      client: config.displayName,
+      message: 'No config file to restore',
+    };
+  }
+  
+  // Get latest backup
+  const latest = getLatestBackup(configPath);
+  
+  if (!latest) {
+    return {
+      success: false,
+      client: config.displayName,
+      message: 'No backups available',
+    };
+  }
+  
+  // Perform restore
+  const result = doRestore(latest.path, configPath);
+  
+  if (result.success) {
+    return {
+      success: true,
+      client: config.displayName,
+      message: 'Restored successfully',
+      backupUsed: latest.filename,
+      preRestoreBackup: result.backupPath || undefined,
+    };
+  }
+  
+  return {
+    success: false,
+    client: config.displayName,
+    message: result.error || 'Unknown error',
+  };
+}
+
+/**
+ * Restore from a specific backup file
+ */
+export function restoreFromFile(backupPath: string, client?: MCPClient): RestoreResult {
+  // Validate backup exists
+  if (!existsSync(backupPath)) {
+    return {
+      success: false,
+      client: client ? getClientConfig(client).displayName : 'Unknown',
+      message: `Backup file not found: ${backupPath}`,
+    };
+  }
+  
+  // If client not specified, try to detect from backup path
+  if (!client) {
+    for (const c of getAllClients()) {
+      const config = getClientConfig(c);
+      if (backupPath.includes(config.configDir)) {
+        client = c;
+        break;
+      }
+    }
+  }
+  
+  if (!client) {
+    return {
+      success: false,
+      client: 'Unknown',
+      message: 'Could not determine target client. Use --client to specify.',
+    };
+  }
+  
+  const config = getClientConfig(client);
+  const result = doRestore(backupPath, config.configPath);
+  
+  if (result.success) {
+    return {
+      success: true,
+      client: config.displayName,
+      message: 'Restored successfully',
+      backupUsed: backupPath,
+      preRestoreBackup: result.backupPath || undefined,
+    };
+  }
+  
+  return {
+    success: false,
+    client: config.displayName,
+    message: result.error || 'Unknown error',
+  };
+}
+
+/**
+ * Restore all clients to their latest backups
+ */
+export function restoreAll(): RestoreResult[] {
+  const results: RestoreResult[] = [];
+  
+  for (const client of getAllClients()) {
+    const config = getClientConfig(client);
+    
+    // Skip clients without backups
+    const backups = listClientBackups(client);
+    if (backups.length === 0) {
+      continue;
+    }
+    
+    results.push(restoreClient(client));
+  }
+  
+  return results;
+}
+
+/**
+ * Format restore results for display
+ */
+export function formatRestoreResults(results: RestoreResult[]): string {
+  const lines: string[] = [];
+  
+  lines.push('');
+  lines.push('🔄 Restore Results');
+  lines.push('==================');
+  lines.push('');
+  
+  if (results.length === 0) {
+    lines.push('No clients had backups to restore.');
+    lines.push('');
+    return lines.join('\n');
+  }
+  
+  for (const result of results) {
+    const icon = result.success ? '✓' : '✗';
+    lines.push(`${icon} ${result.client}: ${result.message}`);
+    
+    if (result.backupUsed) {
+      lines.push(`    Restored from: ${result.backupUsed}`);
+    }
+    
+    if (result.preRestoreBackup) {
+      lines.push(`    Pre-restore backup: ${result.preRestoreBackup}`);
+    }
+  }
+  
+  lines.push('');
+  
+  const successful = results.filter(r => r.success).length;
+  if (successful > 0) {
+    lines.push(`✓ Restored ${successful} client(s). Restart your MCP clients to apply changes.`);
+  }
+  
+  lines.push('');
+  
+  return lines.join('\n');
+}
+
+/**
+ * Restore command handler
+ */
+export async function restoreCommand(options: RestoreOptions = {}): Promise<void> {
+  // List mode
+  if (options.list) {
+    const backups = listAllBackups();
+    console.log(formatBackupList(backups));
+    return;
+  }
+  
+  // Dry run mode
+  if (options.dryRun) {
+    console.log('\n🔍 Dry run - would restore:\n');
+    
+    if (options.backup) {
+      console.log(`  From file: ${options.backup}`);
+    } else if (options.client) {
+      const client = parseClientArg(options.client);
+      if (client) {
+        const latest = getLatestBackup(getClientConfig(client).configPath);
+        console.log(`  ${getClientConfig(client).displayName}: ${latest?.filename || 'No backup'}`);
+      }
+    } else {
+      const backups = listAllBackups();
+      for (const [client, clientBackups] of backups) {
+        console.log(`  ${getClientConfig(client).displayName}: ${clientBackups[0]?.filename || 'No backup'}`);
+      }
+    }
+    
+    console.log('\nRun without --dry-run to perform restore.\n');
+    return;
+  }
+  
+  // Restore from specific file
+  if (options.backup) {
+    const client = options.client ? parseClientArg(options.client) : undefined;
+    const result = restoreFromFile(options.backup, client || undefined);
+    console.log(formatRestoreResults([result]));
+    
+    if (!result.success) {
+      process.exit(1);
+    }
+    return;
+  }
+  
+  // Restore specific client
+  if (options.client) {
+    const client = parseClientArg(options.client);
+    
+    if (!client) {
+      console.error(`\n✗ Unknown client: ${options.client}\n`);
+      console.error('Valid clients: claude, cursor, windsurf, cline, continue\n');
+      process.exit(1);
+    }
+    
+    const result = restoreClient(client);
+    console.log(formatRestoreResults([result]));
+    
+    if (!result.success) {
+      process.exit(1);
+    }
+    return;
+  }
+  
+  // Restore all clients with backups
+  const results = restoreAll();
+  console.log(formatRestoreResults(results));
+  
+  const failures = results.filter(r => !r.success);
+  if (failures.length > 0) {
+    process.exit(1);
+  }
+}

package/src/cli/commands/setup.ts

@@ -0,0 +1,276 @@
+/**
+ * Setup Command
+ * Configures APIClaw for MCP clients
+ */
+
+import { existsSync } from 'fs';
+import { detectOS, getOSDisplayName } from '../../utils/os.js';
+import { 
+  getAllClients, 
+  getConfigPath, 
+  getClientConfig, 
+  parseClientArg,
+  MCPClient,
+  ClientPathConfig 
+} from '../../utils/paths.js';
+import { 
+  readConfig, 
+  writeConfig, 
+  mergeApiclawConfig, 
+  mergeApiclawContinueConfig,
+  hasApiclawConfig,
+  isContinueFormat,
+  MCPConfig,
+  ContinueConfig
+} from '../../utils/config.js';
+import { createBackup, getLatestBackup } from '../../utils/backup.js';
+
+export interface SetupOptions {
+  client?: string;
+  config?: string;
+  workspace?: string;
+  dryRun?: boolean;
+  force?: boolean;
+  wizard?: boolean;
+  all?: boolean;
+  verbose?: boolean;
+}
+
+interface SetupResult {
+  client: string;
+  success: boolean;
+  message: string;
+  backupPath?: string | null;
+  skipped?: boolean;
+}
+
+/**
+ * Detect which MCP clients are installed
+ */
+function detectInstalledClients(): MCPClient[] {
+  const clients = getAllClients();
+  const installed: MCPClient[] = [];
+  
+  for (const client of clients) {
+    const configPath = getConfigPath(client);
+    // Check if config exists OR if parent directory exists (client might be installed but not configured)
+    if (existsSync(configPath)) {
+      installed.push(client);
+    }
+  }
+  
+  return installed;
+}
+
+/**
+ * Check if a client's config directory structure exists (might not have config yet)
+ */
+function clientMightBeInstalled(client: MCPClient): boolean {
+  const config = getClientConfig(client);
+  const configDir = config.configDir;
+  
+  // Check a few levels up to see if the app is installed
+  const pathParts = configDir.split('/').filter(Boolean);
+  for (let i = pathParts.length; i >= Math.max(0, pathParts.length - 3); i--) {
+    const checkPath = '/' + pathParts.slice(0, i).join('/');
+    if (existsSync(checkPath)) {
+      return true;
+    }
+  }
+  
+  return false;
+}
+
+/**
+ * Setup a single client
+ */
+async function setupClient(
+  client: MCPClient | 'custom',
+  configPath: string,
+  options: SetupOptions
+): Promise<SetupResult> {
+  const displayName = client === 'custom' ? 'Custom' : getClientConfig(client as MCPClient).displayName;
+  
+  if (options.verbose) {
+    console.log(`\n📝 Configuring ${displayName}...`);
+    console.log(`   Config path: ${configPath}`);
+  }
+  
+  // Read existing config
+  const readResult = readConfig(configPath);
+  
+  if (!readResult.success) {
+    return {
+      client: displayName,
+      success: false,
+      message: readResult.error || 'Failed to read config',
+    };
+  }
+  
+  const existingConfig = readResult.config!;
+  
+  // Check if APIClaw is already configured
+  if (hasApiclawConfig(existingConfig) && !options.force) {
+    if (options.verbose) {
+      console.log(`   ⏭️  APIClaw already configured (use --force to update)`);
+    }
+    return {
+      client: displayName,
+      success: true,
+      message: 'Already configured',
+      skipped: true,
+    };
+  }
+  
+  // Merge APIClaw config
+  let newConfig: MCPConfig | ContinueConfig;
+  
+  if (client === 'continue' || isContinueFormat(existingConfig)) {
+    newConfig = mergeApiclawContinueConfig(existingConfig as ContinueConfig, {
+      workspace: options.workspace,
+      force: options.force,
+    });
+  } else {
+    newConfig = mergeApiclawConfig(existingConfig as MCPConfig, {
+      workspace: options.workspace,
+      force: options.force,
+    });
+  }
+  
+  // Dry run - show what would happen
+  if (options.dryRun) {
+    console.log(`\n📋 Would configure ${displayName}:`);
+    console.log(`   Path: ${configPath}`);
+    console.log(`   Changes:`);
+    if (isContinueFormat(newConfig)) {
+      const continueConfig = newConfig as ContinueConfig;
+      const apiclaw = continueConfig.mcpServers?.find(s => s.name === 'apiclaw');
+      console.log(JSON.stringify(apiclaw, null, 4).split('\n').map(l => `   ${l}`).join('\n'));
+    } else {
+      const mcpConfig = newConfig as MCPConfig;
+      console.log(JSON.stringify({ apiclaw: mcpConfig.mcpServers?.apiclaw }, null, 4).split('\n').map(l => `   ${l}`).join('\n'));
+    }
+    
+    return {
+      client: displayName,
+      success: true,
+      message: 'Dry run - no changes made',
+      skipped: true,
+    };
+  }
+  
+  // Write config
+  const writeResult = writeConfig(configPath, newConfig, true);
+  
+  if (!writeResult.success) {
+    return {
+      client: displayName,
+      success: false,
+      message: writeResult.error || 'Failed to write config',
+    };
+  }
+  
+  return {
+    client: displayName,
+    success: true,
+    message: readResult.isNew ? 'Created new config' : 'Updated existing config',
+    backupPath: writeResult.backupPath,
+  };
+}
+
+/**
+ * Main setup command handler
+ */
+export async function setupCommand(options: SetupOptions): Promise<void> {
+  const os = detectOS();
+  const osName = getOSDisplayName();
+  
+  console.log('\n🚀 APIClaw MCP Auto-Setup\n');
+  console.log(`Platform: ${osName}\n`);
+  
+  // Determine which clients to configure
+  let clientsToSetup: Array<{ client: MCPClient | 'custom'; path: string }> = [];
+  
+  if (options.config) {
+    // Custom config path
+    clientsToSetup.push({ client: 'custom', path: options.config });
+  } else if (options.client) {
+    // Specific client
+    const client = parseClientArg(options.client);
+    
+    if (!client) {
+      console.error(`❌ Unknown client: ${options.client}`);
+      console.log('   Supported clients: claude-desktop, cursor, windsurf, cline, continue');
+      process.exit(1);
+    }
+    
+    clientsToSetup.push({ client, path: getConfigPath(client) });
+  } else {
+    // Auto-detect or all
+    console.log('🔍 Detecting MCP clients...\n');
+    
+    const allClients = getAllClients();
+    const detected = detectInstalledClients();
+    
+    for (const client of allClients) {
+      const config = getClientConfig(client);
+      const isDetected = detected.includes(client);
+      const icon = isDetected ? '✓' : '✗';
+      const status = isDetected ? 'found' : 'not found';
+      console.log(`   ${icon} ${config.displayName} ${status}`);
+      
+      if (isDetected || options.all) {
+        clientsToSetup.push({ client, path: config.configPath });
+      }
+    }
+    
+    console.log('');
+    
+    if (clientsToSetup.length === 0) {
+      console.log('⚠️  No MCP clients detected. Use --client to specify manually.');
+      console.log('   Example: npx @nordsym/apiclaw setup --client claude-desktop');
+      process.exit(0);
+    }
+  }
+  
+  // Setup each client
+  const results: SetupResult[] = [];
+  
+  for (const { client, path } of clientsToSetup) {
+    const result = await setupClient(client, path, options);
+    results.push(result);
+    
+    const icon = result.success ? (result.skipped ? '⏭️' : '✓') : '✗';
+    console.log(`${icon} ${result.client}: ${result.message}`);
+    
+    if (result.backupPath && options.verbose) {
+      console.log(`   Backup: ${result.backupPath}`);
+    }
+  }
+  
+  // Summary
+  const succeeded = results.filter(r => r.success && !r.skipped).length;
+  const skipped = results.filter(r => r.skipped).length;
+  const failed = results.filter(r => !r.success).length;
+  
+  console.log('\n' + '═'.repeat(50));
+  
+  if (failed === 0) {
+    if (options.dryRun) {
+      console.log('\n✅ Dry run complete! Use without --dry-run to apply changes.\n');
+    } else if (succeeded > 0) {
+      console.log('\n✅ APIClaw configured successfully!\n');
+      console.log('Next steps:');
+      console.log('  1. Restart your AI coding assistant');
+      console.log('  2. Ask your agent: "List available APIs"\n');
+      console.log('Need help? https://docs.apiclaw.com/setup\n');
+    } else if (skipped === results.length) {
+      console.log('\n✅ APIClaw already configured in all clients.\n');
+      console.log('Use --force to reconfigure.\n');
+    }
+  } else {
+    console.log(`\n⚠️  Setup completed with ${failed} error(s).\n`);
+    console.log('For troubleshooting, visit: https://docs.apiclaw.com/setup/troubleshooting\n');
+    process.exit(1);
+  }
+}