@nordsym/apiclaw 1.5.13 → 1.5.14

package/dist/src/cli/commands/restore.js

@@ -0,0 +1,259 @@
+/**
+ * Restore Command
+ * Rollback MCP client configs from backups
+ */
+import { existsSync } from 'fs';
+import { listBackups, restoreBackup as doRestore, getLatestBackup, formatBackupInfo } from '../../utils/backup.js';
+import { getAllClients, getClientConfig, parseClientArg } from '../../utils/paths.js';
+/**
+ * List all available backups for a client
+ */
+function listClientBackups(client) {
+    const config = getClientConfig(client);
+    return listBackups(config.configPath);
+}
+/**
+ * List all backups across all clients
+ */
+export function listAllBackups() {
+    const results = new Map();
+    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) {
+    const lines = [];
+    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) {
+    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, client) {
+    // 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() {
+    const results = [];
+    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) {
+    const lines = [];
+    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 = {}) {
+    // 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/dist/src/cli/commands/setup.js

@@ -0,0 +1,205 @@
+/**
+ * Setup Command
+ * Configures APIClaw for MCP clients
+ */
+import { existsSync } from 'fs';
+import { detectOS, getOSDisplayName } from '../../utils/os.js';
+import { getAllClients, getConfigPath, getClientConfig, parseClientArg } from '../../utils/paths.js';
+import { readConfig, writeConfig, mergeApiclawConfig, mergeApiclawContinueConfig, hasApiclawConfig, isContinueFormat } from '../../utils/config.js';
+/**
+ * Detect which MCP clients are installed
+ */
+function detectInstalledClients() {
+    const clients = getAllClients();
+    const installed = [];
+    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) {
+    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, configPath, options) {
+    const displayName = client === 'custom' ? 'Custom' : getClientConfig(client).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;
+    if (client === 'continue' || isContinueFormat(existingConfig)) {
+        newConfig = mergeApiclawContinueConfig(existingConfig, {
+            workspace: options.workspace,
+            force: options.force,
+        });
+    }
+    else {
+        newConfig = mergeApiclawConfig(existingConfig, {
+            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;
+            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;
+            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) {
+    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 = [];
+    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 = [];
+    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.nordsym.com/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.nordsym.com/docs/setup/troubleshooting\n');
+        process.exit(1);
+    }
+}

package/dist/src/cli/commands/uninstall.js

@@ -0,0 +1,188 @@
+/**
+ * Uninstall Command
+ * Remove APIClaw configuration from MCP clients
+ */
+import { existsSync } from 'fs';
+import { getAllClients, getClientConfig, parseClientArg } from '../../utils/paths.js';
+import { readConfig, writeConfig, removeApiclawConfig, hasApiclawConfig } from '../../utils/config.js';
+import { createBackup } from '../../utils/backup.js';
+/**
+ * Remove APIClaw from a single client
+ */
+export function uninstallFromClient(client, options = {}) {
+    const config = getClientConfig(client);
+    const configPath = config.configPath;
+    const serverName = options.serverName || 'apiclaw';
+    // Check if config file exists
+    if (!existsSync(configPath)) {
+        return {
+            success: true,
+            client: config.displayName,
+            action: 'not-found',
+            message: 'Config file not found (client not installed)',
+        };
+    }
+    // Read config
+    const readResult = readConfig(configPath);
+    if (!readResult.success || !readResult.config) {
+        return {
+            success: false,
+            client: config.displayName,
+            action: 'error',
+            message: readResult.error || 'Failed to read config',
+        };
+    }
+    // Check if APIClaw is configured
+    if (!hasApiclawConfig(readResult.config, serverName)) {
+        if (options.force) {
+            return {
+                success: true,
+                client: config.displayName,
+                action: 'skipped',
+                message: `${serverName} not configured (forced check)`,
+            };
+        }
+        return {
+            success: true,
+            client: config.displayName,
+            action: 'skipped',
+            message: `${serverName} not configured`,
+        };
+    }
+    // Dry run - just report what would happen
+    if (options.dryRun) {
+        return {
+            success: true,
+            client: config.displayName,
+            action: 'skipped',
+            message: `Would remove ${serverName} (dry run)`,
+        };
+    }
+    // Create backup before modifying
+    let backupPath;
+    if (!options.noBackup) {
+        const backupResult = createBackup(configPath);
+        if (backupResult.success) {
+            backupPath = backupResult.backupPath || undefined;
+        }
+    }
+    // Remove APIClaw from config
+    const updatedConfig = removeApiclawConfig(readResult.config, serverName);
+    // Write updated config (without creating another backup)
+    const writeResult = writeConfig(configPath, updatedConfig, false);
+    if (!writeResult.success) {
+        return {
+            success: false,
+            client: config.displayName,
+            action: 'error',
+            message: writeResult.error || 'Failed to write config',
+            backupPath,
+        };
+    }
+    return {
+        success: true,
+        client: config.displayName,
+        action: 'removed',
+        message: `${serverName} removed`,
+        backupPath,
+    };
+}
+/**
+ * Uninstall from all clients
+ */
+export function uninstallFromAll(options = {}) {
+    const results = [];
+    for (const client of getAllClients()) {
+        results.push(uninstallFromClient(client, options));
+    }
+    return results;
+}
+/**
+ * Format uninstall results for display
+ */
+export function formatUninstallResults(results) {
+    const lines = [];
+    lines.push('');
+    lines.push('🗑️  Uninstall Results');
+    lines.push('====================');
+    lines.push('');
+    const removed = results.filter(r => r.action === 'removed');
+    const skipped = results.filter(r => r.action === 'skipped');
+    const notFound = results.filter(r => r.action === 'not-found');
+    const errors = results.filter(r => r.action === 'error');
+    // Show removed
+    if (removed.length > 0) {
+        lines.push('Removed:');
+        for (const result of removed) {
+            lines.push(`  ✓ ${result.client}`);
+            if (result.backupPath) {
+                lines.push(`      Backup: ${result.backupPath}`);
+            }
+        }
+        lines.push('');
+    }
+    // Show skipped
+    if (skipped.length > 0) {
+        lines.push('Skipped (not configured):');
+        for (const result of skipped) {
+            lines.push(`  ○ ${result.client}`);
+        }
+        lines.push('');
+    }
+    // Show not found
+    if (notFound.length > 0) {
+        lines.push('Not installed:');
+        for (const result of notFound) {
+            lines.push(`  ○ ${result.client}`);
+        }
+        lines.push('');
+    }
+    // Show errors
+    if (errors.length > 0) {
+        lines.push('Errors:');
+        for (const result of errors) {
+            lines.push(`  ✗ ${result.client}: ${result.message}`);
+        }
+        lines.push('');
+    }
+    // Summary
+    if (removed.length > 0) {
+        lines.push(`✓ APIClaw removed from ${removed.length} client(s).`);
+        lines.push('  Restart your MCP clients for changes to take effect.');
+    }
+    else if (errors.length === 0) {
+        lines.push('No changes made - APIClaw was not configured in any client.');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Uninstall command handler
+ */
+export async function uninstallCommand(options = {}) {
+    const serverName = options.serverName || 'apiclaw';
+    // Dry run notice
+    if (options.dryRun) {
+        console.log('\n🔍 Dry run - no changes will be made\n');
+    }
+    let results;
+    // Uninstall from 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);
+        }
+        results = [uninstallFromClient(client, options)];
+    }
+    else {
+        // Uninstall from all clients
+        results = uninstallFromAll(options);
+    }
+    console.log(formatUninstallResults(results));
+    const errors = results.filter(r => r.action === 'error');
+    if (errors.length > 0) {
+        process.exit(1);
+    }
+}