@nordsym/apiclaw 2.1.0 → 2.2.1

package/src/cli/commands/restore.ts

@@ -1,333 +0,0 @@
-/**
- * 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

@@ -1,297 +0,0 @@
-/**
- * Setup Command
- * Configures APIClaw for MCP clients
- */
-
-import { existsSync } from 'fs';
-import { detectOS, getOSDisplayName } from '../../utils/os.js';
-import { readSession } from '../../session.js';
-import { loginCommand } from './login.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`);
-
-  // Step 0: Ensure user is signed in
-  if (!options.workspace) {
-    const session = readSession();
-    if (!session) {
-      console.log('First, sign in to link your workspace:\n');
-      const loginResult = await loginCommand({});
-      if (!loginResult) {
-        console.error('\n❌ Login failed. Setup cancelled.');
-        process.exit(1);
-      }
-      // Use the session token as workspace identifier
-      options.workspace = loginResult.workspaceId;
-      console.log('');
-    } else {
-      console.log(`✓ Signed in as ${session.email}\n`);
-      options.workspace = options.workspace || session.workspaceId;
-    }
-  }
-
-  // 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://apiclaw.cloud/docs/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://apiclaw.cloud/docs/setup/troubleshooting\n');
-    process.exit(1);
-  }
-}