@nordsym/apiclaw 1.5.17 → 1.5.19

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

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

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

@@ -1,188 +0,0 @@
-/**
- * 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);
-    }
-}