@jezweb/jezpress-cli 1.7.0 → 1.8.0

package/dist/cli.js

@@ -1,1170 +1,32 @@
 #!/usr/bin/env node
+/**
+ * JezPress CLI
+ * CLI for managing JezPress plugins on the update server
+ */
 import { Command } from 'commander';
-import { login, checkAuth } from './auth.js';
-import { deleteToken } from './config.js';
-import * as api from './client.js';
-import { existsSync, statSync, writeFileSync, readFileSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
-import AdmZip from 'adm-zip';
-import { PLATFORM_GUIDE } from './docs.js';
+// Command modules
+import { registerAuthCommands } from './commands/auth.js';
+import { registerDocsCommand } from './commands/docs.js';
+import { registerPluginCommands } from './commands/plugins.js';
+import { registerSitesCommands } from './commands/sites/index.js';
 // Read version from package.json
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
 const VERSION = packageJson.version;
 const program = new Command();
-/**
- * Extract WordPress plugin headers from a ZIP file
- */
-function extractPluginHeaders(zipPath, slug) {
-    let zip;
-    try {
-        zip = new AdmZip(zipPath);
-    }
-    catch {
-        return null;
-    }
-    const entries = zip.getEntries();
-    // Find main plugin file (slug/slug.php or slug.php)
-    const mainFilePath1 = `${slug}/${slug}.php`;
-    const mainFilePath2 = `${slug}.php`;
-    const mainFileEntry = entries.find((e) => e.entryName.toLowerCase() === mainFilePath1.toLowerCase() ||
-        e.entryName.toLowerCase() === mainFilePath2.toLowerCase());
-    if (!mainFileEntry) {
-        return null;
-    }
-    const content = mainFileEntry.getData().toString('utf-8');
-    const headers = {};
-    // Extract headers using regex
-    const nameMatch = content.match(/Plugin Name:\s*(.+)/i);
-    if (nameMatch)
-        headers.name = nameMatch[1].trim();
-    const versionMatch = content.match(/Version:\s*(\d+\.\d+(\.\d+)?)/i);
-    if (versionMatch)
-        headers.version = versionMatch[1];
-    const authorMatch = content.match(/Author:\s*(.+)/i);
-    if (authorMatch)
-        headers.author = authorMatch[1].trim();
-    const requiresWPMatch = content.match(/Requires at least:\s*(\d+\.\d+)/i);
-    if (requiresWPMatch)
-        headers.requires_wp = requiresWPMatch[1];
-    const requiresPHPMatch = content.match(/Requires PHP:\s*(\d+\.\d+)/i);
-    if (requiresPHPMatch)
-        headers.requires_php = requiresPHPMatch[1];
-    const testedWPMatch = content.match(/Tested up to:\s*(\d+\.\d+)/i);
-    if (testedWPMatch)
-        headers.tested_wp = testedWPMatch[1];
-    const descMatch = content.match(/Description:\s*(.+)/i);
-    if (descMatch)
-        headers.description = descMatch[1].trim();
-    return headers;
-}
 program
     .name('jezpress')
     .description('CLI for managing JezPress plugins on the update server')
     .version(VERSION);
-// ============================================================
-// Auth Commands
-// ============================================================
-program
-    .command('login')
-    .description('Log in with your Jezweb Google account')
-    .action(async () => {
-    try {
-        console.log('Starting login...');
-        const user = await login();
-        console.log(`\nLogged in as ${user.name} (${user.email})`);
-    }
-    catch (error) {
-        console.error('Login failed:', error.message);
-        process.exit(1);
-    }
-});
-program
-    .command('logout')
-    .description('Log out and remove stored token')
-    .action(() => {
-    deleteToken();
-    console.log('Logged out successfully');
-});
-// ============================================================
-// Docs Command
-// ============================================================
-program
-    .command('docs')
-    .description('Display JezPress platform guide for developers and Claude Code')
-    .option('--save [path]', 'Save guide to file (default: JEZPRESS.md)')
-    .option('--claude', 'Generate project-level CLAUDE.md template')
-    .action((options) => {
-    if (options.claude) {
-        const path = 'CLAUDE.md';
-        const jezpressSection = `\n\n---\n\n${PLATFORM_GUIDE}`;
-        if (existsSync(path)) {
-            // Append to existing CLAUDE.md
-            const existing = readFileSync(path, 'utf-8');
-            if (existing.includes('# JezPress Platform Guide')) {
-                console.log('CLAUDE.md already contains JezPress guide.');
-                console.log('Remove the existing JezPress section first if you want to update it.');
-                process.exit(1);
-            }
-            writeFileSync(path, existing + jezpressSection);
-            console.log(`JezPress guide appended to existing CLAUDE.md`);
-        }
-        else {
-            // Create new CLAUDE.md with full guide
-            writeFileSync(path, PLATFORM_GUIDE);
-            console.log(`CLAUDE.md created with full JezPress platform guide.`);
-        }
-        console.log('Your Claude Code now has full context about JezPress.');
-    }
-    else if (options.save !== undefined) {
-        const path = typeof options.save === 'string' ? options.save : 'JEZPRESS.md';
-        writeFileSync(path, PLATFORM_GUIDE);
-        console.log(`Platform guide saved to: ${path}`);
-    }
-    else {
-        console.log(PLATFORM_GUIDE);
-    }
-});
-program
-    .command('whoami')
-    .description('Show current user info and owned plugins')
-    .action(async () => {
-    // First check local auth
-    const auth = checkAuth();
-    if (!auth.loggedIn) {
-        console.error('Not logged in. Run `jezpress login` first.');
-        process.exit(1);
-    }
-    try {
-        const data = await api.whoami();
-        console.log(`\nLogged in as: ${data.user.name}`);
-        console.log(`Email: ${data.user.email}`);
-        console.log(`Token expires in: ${auth.expiresIn}`);
-        console.log(`\nPlugins owned (${data.plugins_owned.length}):`);
-        if (data.plugins_owned.length === 0) {
-            console.log('  (none)');
-        }
-        else {
-            data.plugins_owned.forEach((slug) => {
-                console.log(`  - ${slug}`);
-            });
-        }
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-// ============================================================
-// Plugin Commands
-// ============================================================
-const plugins = program
-    .command('plugins')
-    .description('Manage plugins');
-plugins
-    .command('list')
-    .description('List all plugins')
-    .option('--mine', 'Only show plugins you own')
-    .action(async (options) => {
-    try {
-        const pluginsList = await api.listPlugins();
-        let filtered = pluginsList;
-        if (options.mine) {
-            filtered = pluginsList.filter((p) => p.is_owner);
-        }
-        console.log(`\nPlugins (${filtered.length}):\n`);
-        if (filtered.length === 0) {
-            console.log('  (none)');
-            return;
-        }
-        filtered.forEach((p) => {
-            const ownerMark = p.is_owner ? ' (yours)' : '';
-            console.log(`  ${p.slug} v${p.current_version}${ownerMark}`);
-            console.log(`    Name: ${p.name}`);
-            console.log(`    Updated: ${p.last_updated}`);
-            console.log('');
-        });
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('get <slug>')
-    .description('Get plugin details')
-    .action(async (slug) => {
-    try {
-        const data = await api.getPlugin(slug);
-        const p = data.plugin;
-        console.log(`\n${p.name} (${p.slug})\n`);
-        console.log(`Version: ${p.current_version}`);
-        console.log(`Type: ${p.type}`);
-        console.log(`Author: ${p.author}`);
-        console.log(`Requires PHP: ${p.requires_php}`);
-        console.log(`Requires WP: ${p.requires_wp}`);
-        console.log(`Tested WP: ${p.tested_wp}`);
-        console.log(`License required: ${p.requires_license ? 'Yes' : 'No'}`);
-        console.log(`Last updated: ${p.last_updated}`);
-        console.log(`Owner: ${p.owner_email || 'unassigned'}`);
-        console.log(`You own this: ${p.is_owner ? 'Yes' : 'No'}`);
-        console.log(`\nAvailable versions: ${data.available_versions.join(', ') || 'none'}`);
-        console.log(`Total downloads: ${data.download_stats?.total || 0}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('create <slug>')
-    .description('Create a new plugin (you become the owner)')
-    .requiredOption('--name <name>', 'Plugin display name')
-    .option('-v, --ver <version>', 'Initial version', '1.0.0')
-    .option('--type <type>', 'Type: plugin or theme', 'plugin')
-    .option('--no-license', 'Plugin does not require license')
-    .option('--author <author>', 'Author name', 'Jezweb')
-    .action(async (slug, options) => {
-    try {
-        const plugin = await api.createPlugin({
-            slug,
-            name: options.name,
-            version: options.ver,
-            type: options.type,
-            requiresLicense: options.license !== false,
-            author: options.author,
-        });
-        console.log(`\nPlugin created: ${plugin.slug}`);
-        console.log(`Name: ${plugin.name}`);
-        console.log(`Version: ${plugin.current_version}`);
-        console.log(`Owner: ${plugin.owner_email}`);
-        console.log('\nNext: Upload a version with `jezpress plugins upload`');
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('update <slug>')
-    .description('Update plugin metadata (owner only)')
-    .option('--name <name>', 'Update display name')
-    .option('--tested-wp <version>', 'Update tested WP version')
-    .option('--requires-wp <version>', 'Update minimum WP version')
-    .option('--requires-php <version>', 'Update minimum PHP version')
-    .action(async (slug, options) => {
-    try {
-        const updates = {};
-        if (options.name)
-            updates.name = options.name;
-        if (options.testedWp)
-            updates.tested_wp = options.testedWp;
-        if (options.requiresWp)
-            updates.requires_wp = options.requiresWp;
-        if (options.requiresPhp)
-            updates.requires_php = options.requiresPhp;
-        if (Object.keys(updates).length === 0) {
-            console.error('No updates provided. Use --name, --tested-wp, etc.');
-            process.exit(1);
-        }
-        const plugin = await api.updatePlugin(slug, updates);
-        console.log(`\nPlugin updated: ${plugin.slug}`);
-        console.log(`Name: ${plugin.name}`);
-        console.log(`Tested WP: ${plugin.tested_wp}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('upload <slug> <zipFile>')
-    .description('Upload a new plugin version (owner only)')
-    .option('-v, --ver <version>', 'Version number (auto-detected from ZIP if omitted)')
-    .option('--sync-metadata', 'Update plugin metadata (requires_php, requires_wp, tested_wp) from ZIP headers')
-    .action(async (slug, zipFile, options) => {
-    // Check file exists
-    if (!existsSync(zipFile)) {
-        console.error(`File not found: ${zipFile}`);
-        process.exit(1);
-    }
-    try {
-        // Extract headers from ZIP
-        const headers = extractPluginHeaders(zipFile, slug);
-        if (!headers) {
-            console.error(`Could not find main plugin file in ZIP. Expected ${slug}/${slug}.php`);
-            process.exit(1);
-        }
-        // Determine version: use --ver if provided, otherwise extract from ZIP
-        let version = options.ver;
-        if (!version) {
-            if (!headers.version) {
-                console.error('Could not extract version from plugin header. Use -v to specify manually.');
-                process.exit(1);
-            }
-            version = headers.version;
-            console.log(`Auto-detected version: ${version}`);
-        }
-        console.log(`Uploading ${zipFile} as version ${version}...`);
-        const result = await api.uploadVersion(slug, version, zipFile);
-        console.log(`\n${result.message}`);
-        console.log(`Size: ${(result.size_bytes / 1024).toFixed(1)} KB`);
-        // Sync metadata if requested
-        if (options.syncMetadata) {
-            const updates = {};
-            let hasUpdates = false;
-            if (headers.requires_php) {
-                updates.requires_php = headers.requires_php;
-                hasUpdates = true;
-            }
-            if (headers.requires_wp) {
-                updates.requires_wp = headers.requires_wp;
-                hasUpdates = true;
-            }
-            if (headers.tested_wp) {
-                updates.tested_wp = headers.tested_wp;
-                hasUpdates = true;
-            }
-            if (hasUpdates) {
-                console.log('\nSyncing metadata from plugin headers...');
-                const plugin = await api.updatePlugin(slug, updates);
-                console.log(`  Requires PHP: ${plugin.requires_php}`);
-                console.log(`  Requires WP: ${plugin.requires_wp}`);
-                console.log(`  Tested WP: ${plugin.tested_wp}`);
-            }
-            else {
-                console.log('\nNo metadata headers found in plugin file to sync.');
-            }
-        }
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('preflight <slug> <zipFile>')
-    .description('Validate plugin ZIP before uploading')
-    .action(async (slug, zipFile) => {
-    // Check file exists
-    if (!existsSync(zipFile)) {
-        console.error(`File not found: ${zipFile}`);
-        process.exit(1);
-    }
-    console.log(`\nValidating ${zipFile} for plugin "${slug}"...\n`);
-    const issues = [];
-    const warnings = [];
-    const info = [];
-    // Open ZIP file
-    let zip;
-    try {
-        zip = new AdmZip(zipFile);
-    }
-    catch {
-        console.error('❌ FAILED: Not a valid ZIP file');
-        process.exit(1);
-    }
-    const entries = zip.getEntries();
-    const entryNames = entries.map((e) => e.entryName);
-    // Get ZIP file size from filesystem (don't use toBuffer - it corrupts entries)
-    const zipStats = statSync(zipFile);
-    info.push(`ZIP file size: ${(zipStats.size / 1024).toFixed(1)} KB`);
-    info.push(`Files in ZIP: ${entries.length}`);
-    // Find main plugin file (slug/slug.php or slug.php)
-    const mainFilePath1 = `${slug}/${slug}.php`;
-    const mainFilePath2 = `${slug}.php`;
-    let mainFileEntry = entries.find((e) => e.entryName.toLowerCase() === mainFilePath1.toLowerCase() ||
-        e.entryName.toLowerCase() === mainFilePath2.toLowerCase());
-    if (!mainFileEntry) {
-        issues.push(`Missing main plugin file: expected ${mainFilePath1} or ${mainFilePath2}`);
-    }
-    else {
-        info.push(`Main plugin file: ${mainFileEntry.entryName}`);
-        // Read and parse the main plugin file
-        const mainFileContent = mainFileEntry.getData().toString('utf-8');
-        // Check for WordPress plugin headers
-        const pluginNameMatch = mainFileContent.match(/Plugin Name:\s*(.+)/i);
-        const versionMatch = mainFileContent.match(/Version:\s*(\d+\.\d+(\.\d+)?)/i);
-        const authorMatch = mainFileContent.match(/Author:\s*(.+)/i);
-        const requiresWPMatch = mainFileContent.match(/Requires at least:\s*(\d+\.\d+)/i);
-        const requiresPHPMatch = mainFileContent.match(/Requires PHP:\s*(\d+\.\d+)/i);
-        const testedWPMatch = mainFileContent.match(/Tested up to:\s*(\d+\.\d+)/i);
-        if (!pluginNameMatch) {
-            issues.push("Missing 'Plugin Name' header in main plugin file");
-        }
-        else {
-            info.push(`Plugin Name: ${pluginNameMatch[1].trim()}`);
-        }
-        if (!versionMatch) {
-            issues.push("Missing 'Version' header in main plugin file");
-        }
-        else {
-            info.push(`Version: ${versionMatch[1]}`);
-        }
-        if (!authorMatch) {
-            warnings.push("Missing 'Author' header (recommended)");
-        }
-        if (!requiresWPMatch) {
-            warnings.push("Missing 'Requires at least' header (recommended)");
-        }
-        if (!requiresPHPMatch) {
-            warnings.push("Missing 'Requires PHP' header (recommended)");
-        }
-        if (!testedWPMatch) {
-            warnings.push("Missing 'Tested up to' header (recommended)");
-        }
-        // Security checks on all PHP files
-        const phpEntries = entries.filter((e) => e.entryName.toLowerCase().endsWith('.php'));
-        let hasEval = false;
-        let hasBase64 = false;
-        let hasShellExec = false;
-        for (const entry of phpEntries) {
-            const content = entry.getData().toString('utf-8');
-            if (/\beval\s*\(/i.test(content))
-                hasEval = true;
-            if (/\bbase64_decode\s*\(/i.test(content))
-                hasBase64 = true;
-            if (/\b(shell_exec|exec)\s*\(/i.test(content))
-                hasShellExec = true;
-        }
-        if (hasEval) {
-            warnings.push('Uses eval() - ensure this is intentional and safe');
-        }
-        if (hasBase64) {
-            warnings.push('Uses base64_decode() - ensure this is intentional and safe');
-        }
-        if (hasShellExec) {
-            warnings.push('Uses shell_exec/exec - ensure this is intentional and safe');
-        }
-    }
-    // Check for readme.txt
-    const readmePath = `${slug}/readme.txt`;
-    const hasReadme = entryNames.some((name) => name.toLowerCase() === readmePath.toLowerCase());
-    if (!hasReadme) {
-        warnings.push('Missing readme.txt (recommended for update server)');
-    }
-    else {
-        info.push('readme.txt found');
-    }
-    // Check folder structure - should be slug/
-    const hasCorrectFolder = entryNames.some((name) => name.toLowerCase().startsWith(`${slug.toLowerCase()}/`));
-    if (!hasCorrectFolder) {
-        issues.push(`ZIP should contain a "${slug}/" folder with all plugin files`);
-    }
-    // Print results
-    console.log('INFO:');
-    info.forEach((i) => console.log(`  ✓ ${i}`));
-    console.log('');
-    if (warnings.length > 0) {
-        console.log('WARNINGS:');
-        warnings.forEach((w) => console.log(`  ⚠ ${w}`));
-        console.log('');
-    }
-    if (issues.length > 0) {
-        console.log('ISSUES:');
-        issues.forEach((i) => console.log(`  ✗ ${i}`));
-        console.log('');
-        console.log(`❌ FAILED: ${issues.length} issue(s) found`);
-        process.exit(1);
-    }
-    console.log(`✅ PASSED: Plugin "${slug}" is ready for upload${warnings.length > 0 ? ` (with ${warnings.length} warning(s))` : ''}`);
-});
-// ============================================================
-// New Version Management Commands
-// ============================================================
-plugins
-    .command('versions <slug>')
-    .description('List all versions of a plugin')
-    .action(async (slug) => {
-    try {
-        const data = await api.listVersions(slug);
-        console.log(`\nVersions for ${data.name} (${data.slug}):`);
-        console.log(`Current version: ${data.current_version}`);
-        console.log(`Total downloads: ${data.total_downloads}`);
-        console.log(`You own this: ${data.is_owner ? 'Yes' : 'No'}\n`);
-        if (data.versions.length === 0) {
-            console.log('  (no versions)');
-            return;
-        }
-        data.versions.forEach((v) => {
-            const isCurrent = v.version === data.current_version ? ' (current)' : '';
-            console.log(`  v${v.version}${isCurrent}`);
-            console.log(`    Released: ${v.release_date}`);
-            console.log(`    Downloads: ${v.downloads}`);
-            if (v.changelog) {
-                console.log(`    Changelog: ${v.changelog.slice(0, 60)}${v.changelog.length > 60 ? '...' : ''}`);
-            }
-            console.log('');
-        });
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('stats <slug>')
-    .description('View download statistics for a plugin')
-    .action(async (slug) => {
-    try {
-        const data = await api.getStats(slug);
-        console.log(`\nStatistics for ${data.name} (${data.slug}):\n`);
-        console.log(`  Total downloads: ${data.total_downloads}`);
-        console.log(`  Version count: ${data.version_count}`);
-        console.log(`  Current version: ${data.current_version}`);
-        console.log(`  Last updated: ${data.last_updated}`);
-        const byVersion = Object.entries(data.by_version);
-        if (byVersion.length > 0) {
-            console.log(`\n  Downloads by version:`);
-            // Sort by version descending
-            byVersion.sort((a, b) => {
-                const aParts = a[0].split('.').map(Number);
-                const bParts = b[0].split('.').map(Number);
-                for (let i = 0; i < 3; i++) {
-                    if ((bParts[i] || 0) !== (aParts[i] || 0)) {
-                        return (bParts[i] || 0) - (aParts[i] || 0);
-                    }
-                }
-                return 0;
-            });
-            byVersion.forEach(([version, count]) => {
-                console.log(`    v${version}: ${count}`);
-            });
-        }
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('download <slug> <version>')
-    .description('Download a plugin version ZIP (owner only)')
-    .option('-o, --output <path>', 'Output file path')
-    .action(async (slug, version, options) => {
-    try {
-        console.log(`Downloading ${slug} v${version}...`);
-        const result = await api.downloadVersion(slug, version);
-        const outputPath = options.output || result.filename;
-        writeFileSync(outputPath, Buffer.from(result.data));
-        console.log(`\n✅ Downloaded to: ${outputPath}`);
-        console.log(`Size: ${(result.data.byteLength / 1024).toFixed(1)} KB`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('delete-version <slug> <version>')
-    .description('Delete a plugin version (owner only)')
-    .option('-y, --yes', 'Skip confirmation')
-    .action(async (slug, version, options) => {
-    try {
-        if (!options.yes) {
-            console.log(`\n⚠️  You are about to delete version ${version} of ${slug}`);
-            console.log('This action cannot be undone.');
-            console.log('\nRun with --yes to confirm.');
-            process.exit(1);
-        }
-        console.log(`Deleting ${slug} v${version}...`);
-        const result = await api.deleteVersion(slug, version);
-        console.log(`\n✅ ${result.message}`);
-        console.log(`Current version is now: ${result.current_version}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('changelog <slug> [version] [text]')
-    .description('View or update changelog for a plugin version')
-    .option('-s, --set <text>', 'Set changelog text (alternative to positional argument)')
-    .action(async (slug, version, text, options) => {
-    try {
-        // Text can come from positional arg or --set option
-        const changelogText = text || options.set;
-        if (changelogText) {
-            // Update changelog
-            if (!version) {
-                console.error('Version is required when setting changelog');
-                process.exit(1);
-            }
-            console.log(`Updating changelog for ${slug} v${version}...`);
-            const result = await api.updateVersion(slug, version, { changelog: changelogText });
-            console.log(`\n✅ ${result.message}`);
-            console.log(`Changelog: ${result.version.changelog || '(empty)'}`);
-        }
-        else {
-            // View changelog
-            const data = await api.listVersions(slug);
-            if (version) {
-                // Show specific version changelog
-                const v = data.versions.find((ver) => ver.version === version);
-                if (!v) {
-                    console.error(`Version ${version} not found`);
-                    process.exit(1);
-                }
-                console.log(`\nChangelog for ${data.name} v${version}:\n`);
-                console.log(v.changelog || '(no changelog)');
-            }
-            else {
-                // Show all changelogs
-                console.log(`\nChangelogs for ${data.name}:\n`);
-                data.versions.forEach((v) => {
-                    console.log(`v${v.version} (${v.release_date}):`);
-                    console.log(`  ${v.changelog || '(no changelog)'}\n`);
-                });
-            }
-        }
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-plugins
-    .command('transfer <slug> <email>')
-    .description('Transfer plugin ownership to another @jezweb user (owner only)')
-    .option('-y, --yes', 'Skip confirmation')
-    .action(async (slug, email, options) => {
-    try {
-        if (!options.yes) {
-            console.log(`\n⚠️  You are about to transfer ownership of ${slug} to ${email}`);
-            console.log('You will lose all access to this plugin.');
-            console.log('\nRun with --yes to confirm.');
-            process.exit(1);
-        }
-        console.log(`Transferring ${slug} to ${email}...`);
-        const result = await api.transferOwnership(slug, email);
-        console.log(`\n✅ ${result.message}`);
-        console.log(`Previous owner: ${result.previous_owner}`);
-        console.log(`New owner: ${result.new_owner}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-// ============================================================
-// Site Commands
-// ============================================================
-const sites = program
-    .command('sites')
-    .description('Manage WordPress sites');
-sites
-    .command('list')
-    .description('List all registered sites')
-    .option('--status <status>', 'Filter by status (approved/pending/rejected)')
-    .option('--woo', 'Only show sites with WooCommerce')
-    .option('--sort <column>', 'Sort by: domain, version, users, admins (default: domain)')
-    .option('--desc', 'Sort descending')
-    .option('--table', 'Show as compact table')
-    .option('--admins-only', 'Only show sites where total users = admin users')
-    .action(async (options) => {
-    try {
-        let sitesList = await api.listSites({
-            status: options.status,
-            woo: options.woo,
-        });
-        // Filter: admins only (no extra users)
-        if (options.adminsOnly) {
-            sitesList = sitesList.filter((s) => s.user_count_total !== undefined &&
-                s.user_count_total > 0 &&
-                s.user_count_total === s.user_count_admin);
-        }
-        // Sort
-        const sortCol = options.sort || 'domain';
-        sitesList.sort((a, b) => {
-            let cmp = 0;
-            switch (sortCol) {
-                case 'version':
-                    cmp = (a.jezpress_version || '0').localeCompare(b.jezpress_version || '0');
-                    break;
-                case 'users':
-                    cmp = (a.user_count_total || 0) - (b.user_count_total || 0);
-                    break;
-                case 'admins':
-                    cmp = (a.user_count_admin || 0) - (b.user_count_admin || 0);
-                    break;
-                default:
-                    cmp = a.domain.localeCompare(b.domain);
-            }
-            return options.desc ? -cmp : cmp;
-        });
-        console.log(`\nSites (${sitesList.length}):\n`);
-        if (sitesList.length === 0) {
-            console.log('  (none)');
-            return;
-        }
-        if (options.table) {
-            // Compact table format
-            console.log('  Domain                                    | JezPress | Users | Admins | WP   ');
-            console.log('  ------------------------------------------|----------|-------|--------|------');
-            sitesList.forEach((s) => {
-                const domain = s.domain.padEnd(42).slice(0, 42);
-                const version = (s.jezpress_version || '-').padEnd(8);
-                const users = String(s.user_count_total ?? '-').padStart(5);
-                const admins = String(s.user_count_admin ?? '-').padStart(6);
-                const wp = (s.wp_version || '-').padEnd(5);
-                console.log(`  ${domain} | ${version} | ${users} | ${admins} | ${wp}`);
-            });
-        }
-        else {
-            // Detailed format
-            sitesList.forEach((s) => {
-                const woo = s.woocommerce_active ? ' [WooCommerce]' : '';
-                console.log(`  ${s.domain} (${s.status})${woo}`);
-                if (s.jezpress_version) {
-                    console.log(`    JezPress: v${s.jezpress_version}, WP: ${s.wp_version || 'unknown'}, PHP: ${s.php_version || 'unknown'}`);
-                }
-                if (s.user_count_total !== undefined) {
-                    console.log(`    Users: ${s.user_count_total} total (${s.user_count_admin || 0} admins)`);
-                }
-                console.log('');
-            });
-        }
-        // Summary
-        const wooCount = sitesList.filter((s) => s.woocommerce_active === 1).length;
-        console.log(`\nSummary: ${sitesList.length} sites, ${wooCount} with WooCommerce`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('check <domain>')
-    .description('Check if a domain is registered in JezPress')
-    .action(async (domain) => {
-    try {
-        const sitesList = await api.listSites({});
-        const normalizedDomain = domain.toLowerCase()
-            .replace(/^https?:\/\//, '')
-            .replace(/^www\./, '')
-            .replace(/\/$/, '');
-        const found = sitesList.find((s) => s.domain === normalizedDomain);
-        if (found) {
-            console.log(`\n✓ ${normalizedDomain} is registered in JezPress`);
-            console.log(`  Status: ${found.status}`);
-            if (found.jezpress_version) {
-                console.log(`  JezPress: v${found.jezpress_version}`);
-            }
-            if (found.user_count_total !== undefined) {
-                console.log(`  Users: ${found.user_count_total} (${found.user_count_admin} admins)`);
-            }
-        }
-        else {
-            console.log(`\n✗ ${normalizedDomain} is NOT registered in JezPress`);
-        }
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('scan-all')
-    .description('Scan all sites and update cached data')
-    .action(async () => {
-    try {
-        console.log('Queuing scan for all sites...\n');
-        const { jobId, total } = await api.bulkScan();
-        console.log(`Queued ${total} sites (job: ${jobId})\n`);
-        // Poll for progress
-        let lastProgress = -1;
-        // eslint-disable-next-line no-constant-condition
-        while (true) {
-            const status = await api.getScanStatus(jobId);
-            const progress = status.progress;
-            if (progress !== lastProgress) {
-                process.stdout.write(`\rProgress: ${status.completed}/${status.total} complete, ${status.failed} failed (${progress}%)`);
-                lastProgress = progress;
-            }
-            if (status.status === 'completed') {
-                console.log('\n\n✓ Scan complete!');
-                console.log(`  Succeeded: ${status.completed}`);
-                console.log(`  Failed: ${status.failed}`);
-                break;
-            }
-            if (status.status === 'failed') {
-                console.log('\n\n✗ Scan failed');
-                break;
-            }
-            // Wait 2 seconds before polling again
-            await new Promise((r) => setTimeout(r, 2000));
-        }
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('update-all')
-    .description('Update JezPress on all sites')
-    .option('--force', 'Clear WordPress update cache before checking (use when updates are stuck)')
-    .action(async (options) => {
-    try {
-        const force = options.force === true;
-        console.log(`Queuing JezPress updates for all sites${force ? ' (force mode)' : ''}...\n`);
-        const { jobId, total } = await api.bulkUpdate({ force });
-        console.log(`Queued ${total} sites (job: ${jobId})\n`);
-        // Poll for progress
-        let lastProgress = -1;
-        // eslint-disable-next-line no-constant-condition
-        while (true) {
-            const status = await api.getScanStatus(jobId);
-            const progress = status.progress;
-            if (progress !== lastProgress) {
-                process.stdout.write(`\rProgress: ${status.completed}/${status.total} complete, ${status.failed} failed (${progress}%)`);
-                lastProgress = progress;
-            }
-            if (status.status === 'completed') {
-                console.log('\n\n✓ Update complete!');
-                console.log(`  Succeeded: ${status.completed}`);
-                console.log(`  Failed: ${status.failed}`);
-                break;
-            }
-            if (status.status === 'failed') {
-                console.log('\n\n✗ Update failed');
-                break;
-            }
-            // Wait 2 seconds before polling again
-            await new Promise((r) => setTimeout(r, 2000));
-        }
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('update <domain>')
-    .description('Update JezPress on a single site')
-    .action(async (domain) => {
-    try {
-        // First get current status
-        console.log(`Checking ${domain}...`);
-        const status = await api.getSiteStatus(domain);
-        console.log(`Current version: ${status.version}`);
-        console.log(`WP: ${status.wp_version}, PHP: ${status.php_version}\n`);
-        console.log('Triggering update...');
-        const result = await api.updateSitePlugin(domain);
-        if (result.old_version === result.new_version) {
-            console.log(`\n✓ Already up to date (v${result.new_version})`);
-        }
-        else {
-            console.log(`\n✓ Updated: v${result.old_version} → v${result.new_version}`);
-            if (result.reactivated) {
-                console.log('  Plugin was reactivated after update');
-            }
-        }
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('status <domain>')
-    .description('Get live status of a site via REST API')
-    .action(async (domain) => {
-    try {
-        console.log(`Checking ${domain}...\n`);
-        const status = await api.getSiteStatus(domain);
-        console.log(`  Domain: ${status.domain}`);
-        console.log(`  Status: ${status.status}`);
-        console.log(`  JezPress: v${status.version}`);
-        console.log(`  WordPress: ${status.wp_version}`);
-        console.log(`  PHP: ${status.php_version}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('info <domain>')
-    .description('Get comprehensive site information')
-    .action(async (domain) => {
-    try {
-        console.log(`Fetching site info for ${domain}...\n`);
-        const info = await api.getSiteInfo(domain);
-        console.log('Versions:');
-        console.log(`  WordPress: ${info.versions.wp}`);
-        console.log(`  PHP: ${info.versions.php}`);
-        console.log(`  JezPress: ${info.versions.jezpress}`);
-        console.log('\nUsers:');
-        for (const [role, count] of Object.entries(info.users)) {
-            if (count > 0) {
-                console.log(`  ${role}: ${count}`);
-            }
-        }
-        console.log('\nWooCommerce:');
-        if (info.woocommerce.active) {
-            console.log(`  Active: Yes (v${info.woocommerce.version})`);
-        }
-        else {
-            console.log('  Active: No');
-        }
-        console.log('\nSettings:');
-        console.log(`  OAuth Only: ${info.settings.disable_password_login ? 'Yes' : 'No'}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('plugins <domain>')
-    .description('List plugins with update status')
-    .option('--updates', 'Only show plugins with updates available')
-    .action(async (domain, options) => {
-    try {
-        console.log(`Fetching plugins for ${domain}...\n`);
-        const data = await api.getSitePlugins(domain);
-        let plugins = data.plugins;
-        if (options.updates) {
-            plugins = plugins.filter(p => p.update_available);
-        }
-        if (plugins.length === 0) {
-            if (options.updates) {
-                console.log('No plugins with updates available.');
-            }
-            else {
-                console.log('No plugins found.');
-            }
-            return;
-        }
-        for (const plugin of plugins) {
-            const status = plugin.active ? '●' : '○';
-            const update = plugin.update_available
-                ? ` → ${plugin.new_version}`
-                : '';
-            console.log(`${status} ${plugin.name} (v${plugin.version}${update})`);
-        }
-        console.log(`\n${data.total} plugins, ${data.updates_available} with updates`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('clear-cache <domain>')
-    .description('Clear site caches (WP Rocket, LiteSpeed, etc)')
-    .action(async (domain) => {
-    try {
-        console.log(`Clearing cache on ${domain}...`);
-        const result = await api.clearSiteCache(domain);
-        if (result.cleared.length > 0) {
-            console.log(`\n✓ Cleared: ${result.cleared.join(', ')}`);
-        }
-        else {
-            console.log('\n✓ Cache cleared (no specific plugins detected)');
-        }
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('clear-update-cache <domain>')
-    .description('Force site to check for fresh plugin updates')
-    .action(async (domain) => {
-    try {
-        console.log(`Clearing update cache on ${domain}...`);
-        await api.clearSiteUpdateCache(domain);
-        console.log('\n✓ Update cache cleared - next update check will fetch fresh data');
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('approve <domain>')
-    .description('Approve a pending site for OAuth access')
-    .action(async (domain) => {
-    try {
-        console.log(`Approving ${domain}...`);
-        const result = await api.approveSite(domain);
-        console.log(`\n✓ ${result.message}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('reject <domain>')
-    .description('Reject a site from OAuth access')
-    .action(async (domain) => {
-    try {
-        console.log(`Rejecting ${domain}...`);
-        const result = await api.rejectSite(domain);
-        console.log(`\n✓ ${result.message}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-// ========== NEW API COMMANDS (v1.4.0) ==========
-sites
-    .command('export <domain>')
-    .description('Export site content (pages, posts, menus, media)')
-    .option('--include <sections>', 'Sections to include (comma-separated: site,pages,posts,menus,media)')
-    .option('--json', 'Output raw JSON')
-    .action(async (domain, options) => {
-    try {
-        console.log(`Exporting ${domain}...`);
-        const data = await api.getSiteExport(domain, {
-            include: options.include,
-        });
-        if (options.json) {
-            console.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        console.log(`\nExport Summary:`);
-        console.log(`  Exported at: ${data.exported_at}`);
-        if (data.site)
-            console.log(`  Site config: included`);
-        if (data.pages)
-            console.log(`  Pages: ${data.pages.length}`);
-        if (data.posts)
-            console.log(`  Posts: ${data.posts.length}`);
-        if (data.menus)
-            console.log(`  Menus: ${data.menus.length}`);
-        if (data.media)
-            console.log(`  Media: ${data.media.length}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('config <domain>')
-    .description('Get site configuration (theme, Elementor, options)')
-    .option('--json', 'Output raw JSON')
-    .action(async (domain, options) => {
-    try {
-        console.log(`Fetching config for ${domain}...\n`);
-        const data = await api.getSiteConfig(domain);
-        if (options.json) {
-            console.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        console.log('Theme:');
-        console.log(`  Name: ${data.theme.name}`);
-        console.log(`  Version: ${data.theme.version}`);
-        if (data.theme.parent)
-            console.log(`  Parent: ${data.theme.parent}`);
-        console.log('\nElementor:');
-        console.log(`  Active: ${data.elementor.active ? 'Yes' : 'No'}`);
-        if (data.elementor.globals?.colors) {
-            console.log(`  Global colors: ${data.elementor.globals.colors.length}`);
-        }
-        if (data.elementor.globals?.typography) {
-            console.log(`  Global fonts: ${data.elementor.globals.typography.length}`);
-        }
-        console.log('\nSite Options:');
-        const opts = data.options;
-        const keys = ['blogname', 'siteurl', 'admin_email', 'timezone_string'];
-        for (const key of keys) {
-            if (opts[key])
-                console.log(`  ${key}: ${opts[key]}`);
-        }
-        console.log(`  ... and ${Object.keys(opts).length - keys.length} more options`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('diagnostics <domain>')
-    .description('Get site diagnostics (health, errors, cron, database)')
-    .option('--json', 'Output raw JSON')
-    .action(async (domain, options) => {
-    try {
-        console.log(`Fetching diagnostics for ${domain}...\n`);
-        const data = await api.getSiteDiagnostics(domain);
-        if (options.json) {
-            console.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        console.log('Health:');
-        const healthTests = data.health.tests || {};
-        const passed = Object.values(healthTests).filter((t) => t.status === 'good').length;
-        console.log(`  Tests: ${passed}/${Object.keys(healthTests).length} passed`);
-        console.log('\nErrors:');
-        const errors = data.errors.log || [];
-        console.log(`  Log entries: ${errors.length}`);
-        if (errors.length > 0) {
-            console.log(`  Latest: ${errors[0].substring(0, 70)}...`);
-        }
-        console.log('\nDatabase:');
-        console.log(`  Version: ${data.database.version || 'N/A'}`);
-        if (data.database.size)
-            console.log(`  Size: ${data.database.size}`);
-        console.log('\nCron:');
-        if (Array.isArray(data.cron)) {
-            console.log(`  Scheduled jobs: ${data.cron.length}`);
-        }
-        else {
-            console.log(`  Cron entries: ${Object.keys(data.cron).length}`);
-        }
-        console.log('\nTransients:');
-        console.log(`  Count: ${data.transients.count}`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
-sites
-    .command('ai <domain>')
-    .description('Get AI-optimized site knowledge bundle')
-    .option('--json', 'Output raw JSON')
-    .action(async (domain, options) => {
-    try {
-        console.log(`Fetching AI knowledge for ${domain}...\n`);
-        const data = await api.getSiteAI(domain);
-        if (options.json) {
-            console.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        console.log('Site Knowledge Bundle:');
-        console.log(`  Pages: ${data.page_count}`);
-        console.log(`  Plugins: ${data.plugin_count}`);
-        console.log(`  Menus: ${data.menus?.length || 0}`);
-        console.log('\nPages (first 5):');
-        const pages = data.pages || [];
-        pages.slice(0, 5).forEach((p) => {
-            console.log(`  - ${p.title} (/${p.slug})`);
-        });
-        if (pages.length > 5)
-            console.log(`  ... and ${pages.length - 5} more`);
-        console.log('\nActive Plugins:');
-        const plugins = (data.plugins || []).filter((p) => p.active);
-        plugins.slice(0, 5).forEach((p) => {
-            console.log(`  - ${p.name}`);
-        });
-        if (plugins.length > 5)
-            console.log(`  ... and ${plugins.length - 5} more`);
-    }
-    catch (error) {
-        console.error('Error:', error.message);
-        process.exit(1);
-    }
-});
+// Register all command groups
+registerAuthCommands(program);
+registerDocsCommand(program);
+registerPluginCommands(program);
+registerSitesCommands(program);
 // Parse and run
 program.parse();
 //# sourceMappingURL=cli.js.map