recoder-code 2.5.2 → 2.5.3

package/dist/src/commands/recoderWeb.js

@@ -5,11 +5,21 @@
 import open from 'open';
 import { RecoderWebService } from '../services/RecoderWebService.js';
 import { RecoderAuthService } from '../services/RecoderAuthService.js';
+import { platformSync } from '../services/PlatformSyncService.js';
 export async function handleRecoderWebCommand(args) {
     const webService = new RecoderWebService();
     const authService = new RecoderAuthService();
     const command = args[0];
-    // Check authentication for all commands
+    // Sync command doesn't require auth (uses container context)
+    if (command === 'sync') {
+        await handleSync(args.slice(1));
+        return;
+    }
+    if (command === 'status') {
+        await handleStatus();
+        return;
+    }
+    // Check authentication for all other commands
     const isAuth = await authService.isAuthenticated();
     if (!isAuth) {
         console.error('❌ Not authenticated');
@@ -29,6 +39,9 @@ export async function handleRecoderWebCommand(args) {
         case 'info':
             await handleInfo(webService, args.slice(1));
             break;
+        case 'push':
+            await handlePush(webService, args.slice(1));
+            break;
         default:
             showHelp();
             break;
@@ -172,6 +185,160 @@ async function handleInfo(webService, args) {
         process.exit(1);
     }
 }
+async function handleSync(args) {
+    const subCommand = args[0];
+    switch (subCommand) {
+        case 'start':
+            await startSync();
+            break;
+        case 'stop':
+            stopSync();
+            break;
+        default:
+            await showSyncStatus();
+            break;
+    }
+}
+async function startSync() {
+    console.log('🔄 Starting platform sync...\n');
+    const platform = await platformSync.detectPlatform();
+    if (!platform.isContainer) {
+        console.log('📍 Not running in recoder.xyz container');
+        console.log('');
+        console.log('💡 Platform sync works when you run recoder-code inside:');
+        console.log('   - recoder.xyz web terminal');
+        console.log('   - recoder.xyz Docker container');
+        console.log('');
+        console.log('For local development, changes will sync to web when you');
+        console.log('push with: recoder web push <urlId>');
+        return;
+    }
+    console.log('🐳 Detected recoder.xyz container');
+    console.log(`📁 Project ID: ${platform.projectId || 'Unknown'}`);
+    const connected = await platformSync.connect();
+    if (connected) {
+        console.log('✅ Connected to platform sync');
+        console.log('');
+        console.log('📡 File changes will now sync bidirectionally:');
+        console.log('   - CLI edits → Web editor');
+        console.log('   - Web edits → CLI workspace');
+        console.log('');
+        if (platform.previewUrl) {
+            console.log(`🌐 Live Preview: ${platform.previewUrl}`);
+        }
+        // Start file watcher
+        platformSync.startFileWatcher();
+        // Listen for remote changes
+        platformSync.on('remoteChange', (changes) => {
+            console.log(`\n📥 Remote changes: ${changes.length} files updated`);
+            for (const change of changes) {
+                console.log(`   ${change.type}: ${change.path}`);
+            }
+        });
+        platformSync.on('localChange', (change) => {
+            console.log(`📤 Synced: ${change.type} ${change.path}`);
+        });
+        console.log('');
+        console.log('Press Ctrl+C to stop sync');
+        // Keep process running
+        await new Promise(() => { });
+    }
+    else {
+        console.log('❌ Failed to connect to platform');
+        console.log('💡 Make sure docker-backend is running');
+    }
+}
+function stopSync() {
+    platformSync.disconnect();
+    console.log('✅ Platform sync stopped');
+}
+async function showSyncStatus() {
+    const platform = await platformSync.detectPlatform();
+    platformSync.displayStatus();
+    if (platform.isContainer) {
+        console.log('');
+        console.log('Commands:');
+        console.log('  recoder web sync start  - Start bidirectional sync');
+        console.log('  recoder web sync stop   - Stop sync');
+    }
+}
+async function handleStatus() {
+    console.log('📊 Platform Status\n');
+    const platform = await platformSync.detectPlatform();
+    console.log(`Environment: ${platform.isContainer ? '🐳 Container' : '💻 Local'}`);
+    if (platform.isContainer) {
+        console.log(`Project ID:  ${platform.projectId || 'Not detected'}`);
+        console.log(`Backend:     ${platform.backendUrl}`);
+        console.log(`Web URL:     ${platform.webUrl}`);
+        console.log(`Sync:        ${platformSync.isConnected() ? '✅ Connected' : '❌ Disconnected'}`);
+        if (platform.previewUrl) {
+            console.log(`Preview:     ${platform.previewUrl}`);
+        }
+        console.log('');
+        console.log('💡 Start sync: recoder web sync start');
+    }
+    else {
+        console.log('');
+        console.log('💡 Run recoder-code in recoder.xyz terminal for live sync');
+        console.log('   Or use "recoder web push <urlId>" to upload local files');
+    }
+}
+async function handlePush(webService, args) {
+    const urlId = args[0];
+    const directory = args[1] || process.cwd();
+    if (!urlId) {
+        console.error('❌ Please provide a project URL ID');
+        console.log('\nUsage:');
+        console.log('  recoder web push <urlId> [directory]');
+        console.log('\nExample:');
+        console.log('  recoder web push 1762542265823');
+        console.log('  recoder web push 1762542265823 ./my-project');
+        process.exit(1);
+    }
+    try {
+        console.log(`📤 Scanning files in: ${directory}\n`);
+        const files = await webService.scanDirectory(directory);
+        const fileCount = Object.keys(files).length;
+        if (fileCount === 0) {
+            console.log('❌ No files found to upload');
+            return;
+        }
+        console.log(`Found ${fileCount} files to upload`);
+        // Get remote files for comparison
+        let changes = { added: [], modified: [], deleted: [], unchanged: [] };
+        try {
+            const project = await webService.getProject(urlId);
+            changes = await webService.detectChanges(files, project.fileSnapshot);
+            console.log('');
+            if (changes.added.length)
+                console.log(`  + ${changes.added.length} new files`);
+            if (changes.modified.length)
+                console.log(`  ~ ${changes.modified.length} modified`);
+            if (changes.deleted.length)
+                console.log(`  - ${changes.deleted.length} deleted`);
+            if (changes.unchanged.length)
+                console.log(`  = ${changes.unchanged.length} unchanged`);
+        }
+        catch {
+            // Project doesn't exist yet
+            console.log('  Creating new project...');
+        }
+        console.log('');
+        const result = await webService.uploadProject(urlId, files);
+        if (result.success) {
+            console.log('✅ Upload complete!');
+            console.log(`📁 ${result.fileCount} files synced`);
+            console.log(`🌐 View at: ${webService.getProjectUrl(urlId)}`);
+        }
+        else {
+            console.log('❌ Upload failed');
+        }
+    }
+    catch (error) {
+        console.error(`❌ ${error.message}`);
+        process.exit(1);
+    }
+}
 function showHelp() {
     console.log('Recoder.xyz Web Platform');
     console.log('\nManage projects from your web IDE');
@@ -184,19 +351,31 @@ function showHelp() {
     console.log('  download <urlId>    Download project files to local machine');
     console.log('    [directory]       Optional output directory');
     console.log('');
+    console.log('  push <urlId>        Upload local files to web project');
+    console.log('    [directory]       Optional source directory (default: cwd)');
+    console.log('');
+    console.log('  sync                Platform sync (when in container)');
+    console.log('    start             Start bidirectional sync');
+    console.log('    stop              Stop sync');
+    console.log('');
+    console.log('  status              Show platform connection status');
     console.log('  open <urlId>        Open project in web browser');
     console.log('  info <urlId>        Show detailed project information');
     console.log('\nExamples:');
     console.log('  recoder web list');
     console.log('  recoder web list --limit 10');
     console.log('  recoder web download 1762542265823');
-    console.log('  recoder web download 1762542265823 ./my-project');
-    console.log('  recoder web open 1762542265823');
-    console.log('  recoder web info 1762542265823');
+    console.log('  recoder web push 1762542265823 ./my-project');
+    console.log('  recoder web sync start');
+    console.log('  recoder web status');
     console.log('\n💡 Workflow:');
-    console.log('  1. Create project in web IDE (http://localhost:5173)');
+    console.log('  1. Create project in web IDE (https://web.recoder.xyz)');
     console.log('  2. List projects: recoder web list');
     console.log('  3. Download locally: recoder web download <urlId>');
     console.log('  4. Edit with full file system access');
+    console.log('  5. Push changes: recoder web push <urlId>');
+    console.log('');
+    console.log('💡 In recoder.xyz terminal:');
+    console.log('  Run "recoder web sync start" for live bidirectional sync');
     console.log('\nFor more information, visit: https://recoder.xyz/docs');
 }

package/dist/src/commands/web/diff.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 'recoder web diff' command
+ * Show differences between local and web project
+ */
+import type { CommandModule } from 'yargs';
+interface DiffArgs {
+    urlId?: string;
+    directory?: string;
+    verbose?: boolean;
+    'show-content'?: boolean;
+}
+export declare const diffCommand: CommandModule<{}, DiffArgs>;
+export {};

package/dist/src/commands/web/diff.js

@@ -0,0 +1,235 @@
+/**
+ * 'recoder web diff' command
+ * Show differences between local and web project
+ */
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { RecoderWebService } from '../../services/RecoderWebService.js';
+import { RecoderAuthService } from '../../services/RecoderAuthService.js';
+const DOCKER_BACKEND_URL = process.env['RECODER_DOCKER_URL'] || 'https://docker.recoder.xyz';
+// ANSI color codes
+const colors = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+export const diffCommand = {
+    command: 'diff [urlId]',
+    describe: 'Show differences between local and web project',
+    builder: (yargs) => yargs
+        .positional('urlId', {
+        type: 'string',
+        description: 'Project URL ID (optional, will read from .recoder-web if present)',
+    })
+        .option('directory', {
+        type: 'string',
+        alias: 'd',
+        description: 'Directory to compare (defaults to current directory)',
+        default: process.cwd(),
+    })
+        .option('verbose', {
+        type: 'boolean',
+        alias: 'v',
+        description: 'Show detailed diff for each file',
+        default: false,
+    })
+        .option('show-content', {
+        type: 'boolean',
+        description: 'Show unified diff content for modified files',
+        default: false,
+    }),
+    handler: async (argv) => {
+        const webService = new RecoderWebService();
+        const authService = new RecoderAuthService();
+        try {
+            // Check authentication
+            const isAuth = await authService.isAuthenticated();
+            if (!isAuth) {
+                console.error('Not authenticated');
+                console.log('Run: recoder auth login');
+                process.exit(1);
+            }
+            const targetDir = path.resolve(argv.directory || process.cwd());
+            let urlId = argv.urlId;
+            // Try to read .recoder-web metadata if no urlId provided
+            if (!urlId) {
+                try {
+                    const metadataPath = path.join(targetDir, '.recoder-web');
+                    const metadata = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
+                    urlId = metadata.urlId || metadata.projectId;
+                    console.log(`Found project ID from .recoder-web: ${urlId}`);
+                }
+                catch {
+                    console.error('No project ID provided and no .recoder-web file found');
+                    console.log('Usage: recoder web diff <urlId>');
+                    console.log('   Or run from a linked directory');
+                    process.exit(1);
+                }
+            }
+            console.log(`Comparing project: ${urlId}`);
+            console.log(`Local directory: ${targetDir}\n`);
+            // Scan local files
+            console.log('Scanning local files...');
+            const localFiles = await webService.scanDirectory(targetDir);
+            console.log(`Found ${Object.keys(localFiles).length} local files`);
+            // Get token for backend request
+            const token = await authService.getAccessToken();
+            if (!token) {
+                console.error('Failed to get access token');
+                process.exit(1);
+            }
+            // Try to get diff from docker backend first (has unified diff support)
+            let diffResult = null;
+            try {
+                const response = await fetch(`${DOCKER_BACKEND_URL}/api/sync/${urlId}/diff`, {
+                    method: 'POST',
+                    headers: {
+                        'Authorization': `Bearer ${token}`,
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({ localFiles }),
+                });
+                if (response.ok) {
+                    const data = await response.json();
+                    if (data?.success) {
+                        diffResult = data;
+                        if (data.containerRunning) {
+                            console.log('Comparing with running container');
+                        }
+                    }
+                }
+            }
+            catch {
+                // Docker backend not available
+            }
+            // Fall back to local comparison with web API
+            if (!diffResult) {
+                console.log('Fetching remote files from web API...');
+                let remoteFiles = {};
+                try {
+                    const project = await webService.getProject(urlId);
+                    remoteFiles = project.fileSnapshot || {};
+                }
+                catch (error) {
+                    console.error(`Failed to fetch project: ${error.message}`);
+                    process.exit(1);
+                }
+                const changes = await webService.detectChanges(localFiles, remoteFiles);
+                diffResult = {
+                    diff: changes,
+                    stats: {
+                        totalChanges: changes.added.length + changes.modified.length + changes.deleted.length,
+                        addedCount: changes.added.length,
+                        modifiedCount: changes.modified.length,
+                        deletedCount: changes.deleted.length,
+                    },
+                };
+            }
+            // Display results
+            console.log('\n' + '='.repeat(60));
+            console.log('                    DIFF SUMMARY');
+            console.log('='.repeat(60));
+            const { diff, stats } = diffResult;
+            if (stats.totalChanges === 0) {
+                console.log(`\n${colors.green}No differences - local and remote are in sync!${colors.reset}`);
+                return;
+            }
+            // Summary box
+            console.log(`
+${colors.gray}+----------------------------------+${colors.reset}
+${colors.gray}|${colors.reset}  ${colors.green}+ ${stats.addedCount} added${colors.reset}   (local only)      ${colors.gray}|${colors.reset}
+${colors.gray}|${colors.reset}  ${colors.yellow}~ ${stats.modifiedCount} modified${colors.reset}               ${colors.gray}|${colors.reset}
+${colors.gray}|${colors.reset}  ${colors.red}- ${stats.deletedCount} deleted${colors.reset}  (remote only)   ${colors.gray}|${colors.reset}
+${colors.gray}+----------------------------------+${colors.reset}
+`);
+            // Added files (local only)
+            if (diff.added.length > 0) {
+                console.log(`${colors.green}Added (local only):${colors.reset}`);
+                const toShow = argv.verbose ? diff.added : diff.added.slice(0, 15);
+                for (const file of toShow) {
+                    console.log(`  ${colors.green}+${colors.reset} ${file}`);
+                }
+                if (!argv.verbose && diff.added.length > 15) {
+                    console.log(`  ${colors.gray}... and ${diff.added.length - 15} more${colors.reset}`);
+                }
+                console.log('');
+            }
+            // Modified files
+            if (diff.modified.length > 0) {
+                console.log(`${colors.yellow}Modified:${colors.reset}`);
+                const toShow = argv.verbose ? diff.modified : diff.modified.slice(0, 15);
+                for (const file of toShow) {
+                    console.log(`  ${colors.yellow}~${colors.reset} ${file}`);
+                }
+                if (!argv.verbose && diff.modified.length > 15) {
+                    console.log(`  ${colors.gray}... and ${diff.modified.length - 15} more${colors.reset}`);
+                }
+                console.log('');
+            }
+            // Deleted files (remote only)
+            if (diff.deleted.length > 0) {
+                console.log(`${colors.red}Deleted (remote only):${colors.reset}`);
+                const toShow = argv.verbose ? diff.deleted : diff.deleted.slice(0, 15);
+                for (const file of toShow) {
+                    console.log(`  ${colors.red}-${colors.reset} ${file}`);
+                }
+                if (!argv.verbose && diff.deleted.length > 15) {
+                    console.log(`  ${colors.gray}... and ${diff.deleted.length - 15} more${colors.reset}`);
+                }
+                console.log('');
+            }
+            // Show unified diffs if requested
+            if (argv['show-content'] && diffResult.unifiedDiffs) {
+                console.log('='.repeat(60));
+                console.log('                  UNIFIED DIFFS');
+                console.log('='.repeat(60));
+                for (const [filePath, unifiedDiff] of Object.entries(diffResult.unifiedDiffs)) {
+                    console.log(`\n${colors.cyan}--- ${filePath} ---${colors.reset}`);
+                    // Color the diff output
+                    for (const line of unifiedDiff.split('\n')) {
+                        if (line.startsWith('+') && !line.startsWith('+++')) {
+                            console.log(`${colors.green}${line}${colors.reset}`);
+                        }
+                        else if (line.startsWith('-') && !line.startsWith('---')) {
+                            console.log(`${colors.red}${line}${colors.reset}`);
+                        }
+                        else if (line.startsWith('@@')) {
+                            console.log(`${colors.cyan}${line}${colors.reset}`);
+                        }
+                        else {
+                            console.log(line);
+                        }
+                    }
+                }
+                if (diff.modified.length > Object.keys(diffResult.unifiedDiffs).length) {
+                    console.log(`\n${colors.gray}(Showing first ${Object.keys(diffResult.unifiedDiffs).length} of ${diff.modified.length} modified files)${colors.reset}`);
+                }
+            }
+            // Suggestions
+            console.log('='.repeat(60));
+            console.log('ACTIONS:');
+            console.log('-'.repeat(60));
+            if (diff.added.length > 0 || diff.modified.length > 0) {
+                console.log(`  ${colors.blue}recoder web push${colors.reset}   - Upload local changes to web`);
+            }
+            if (diff.deleted.length > 0 || diff.modified.length > 0) {
+                console.log(`  ${colors.blue}recoder web pull${colors.reset}   - Download remote changes to local`);
+            }
+            console.log(`  ${colors.blue}recoder web sync${colors.reset}   - Two-way sync`);
+            if (!argv['show-content'] && diff.modified.length > 0) {
+                console.log(`\n${colors.gray}Tip: Use --show-content to see unified diff of modified files${colors.reset}`);
+            }
+            if (!argv.verbose && stats.totalChanges > 15) {
+                console.log(`${colors.gray}Tip: Use --verbose to see all changed files${colors.reset}`);
+            }
+        }
+        catch (error) {
+            console.error(`${error.message}`);
+            process.exit(1);
+        }
+    },
+};

package/dist/src/commands/web/link.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 'recoder web link' command
+ * Link current directory to a recoder.xyz web project for real-time sync
+ */
+import type { CommandModule } from 'yargs';
+interface LinkArgs {
+    projectId?: string;
+    directory?: string;
+}
+export declare const linkCommand: CommandModule<{}, LinkArgs>;
+export {};

package/dist/src/commands/web/link.js

@@ -0,0 +1,96 @@
+/**
+ * 'recoder web link' command
+ * Link current directory to a recoder.xyz web project for real-time sync
+ */
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { RecoderAuthService } from '../../services/RecoderAuthService.js';
+import { RecoderWebService } from '../../services/RecoderWebService.js';
+export const linkCommand = {
+    command: 'link [projectId]',
+    describe: 'Link current directory to a recoder.xyz project for real-time sync',
+    builder: (yargs) => yargs
+        .positional('projectId', {
+        type: 'string',
+        description: 'Project URL ID (e.g., abc123 from web.recoder.xyz/chat/abc123)',
+    })
+        .option('directory', {
+        type: 'string',
+        alias: 'd',
+        description: 'Directory to link (defaults to current directory)',
+        default: process.cwd(),
+    }),
+    handler: async (argv) => {
+        const authService = new RecoderAuthService();
+        const webService = new RecoderWebService();
+        try {
+            // Check authentication
+            const isAuth = await authService.isAuthenticated();
+            if (!isAuth) {
+                console.error('❌ Not authenticated');
+                console.log('💡 Run: recoder auth login');
+                process.exit(1);
+            }
+            const targetDir = path.resolve(argv.directory || process.cwd());
+            let projectId = argv.projectId;
+            // If no projectId, try to read from existing .recoder-web
+            if (!projectId) {
+                try {
+                    const metadataPath = path.join(targetDir, '.recoder-web');
+                    const metadata = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
+                    projectId = metadata.urlId || metadata.projectId;
+                    console.log(`📋 Found existing link: ${projectId}`);
+                }
+                catch {
+                    console.error('❌ No project ID provided');
+                    console.log('💡 Usage: recoder web link <projectId>');
+                    console.log('   Example: recoder web link abc123');
+                    console.log('\n📍 Get project ID from your recoder.xyz URL:');
+                    console.log('   https://web.recoder.xyz/chat/abc123 → projectId is "abc123"');
+                    process.exit(1);
+                }
+            }
+            // Verify project exists
+            console.log(`🔍 Verifying project: ${projectId}...`);
+            let project;
+            try {
+                project = await webService.getProject(projectId);
+            }
+            catch {
+                console.error(`❌ Project not found: ${projectId}`);
+                console.log('💡 Make sure you have access to this project');
+                process.exit(1);
+            }
+            // Create .recoder-web metadata file
+            const metadataFile = path.join(targetDir, '.recoder-web');
+            const metadata = {
+                urlId: projectId,
+                projectId: projectId,
+                description: project.description || '',
+                linkedAt: new Date().toISOString(),
+                webUrl: webService.getProjectUrl(projectId),
+                previewUrl: `https://docker.recoder.xyz/preview/${projectId}`,
+                syncEnabled: true,
+            };
+            await fs.writeFile(metadataFile, JSON.stringify(metadata, null, 2), 'utf-8');
+            console.log('\n┌────────────────────────────────────────────────┐');
+            console.log('│  ✅ Project Linked Successfully!               │');
+            console.log('├────────────────────────────────────────────────┤');
+            console.log(`│  📁 Directory: ${targetDir.slice(-30).padEnd(30)}│`);
+            console.log(`│  🔗 Project: ${projectId.slice(0, 32).padEnd(32)}│`);
+            console.log('├────────────────────────────────────────────────┤');
+            console.log('│  Available commands:                           │');
+            console.log('│  • recoder web sync    - Sync files            │');
+            console.log('│  • recoder web push    - Upload local changes  │');
+            console.log('│  • recoder web info    - Show project info     │');
+            console.log('│  • recoder web unlink  - Remove link           │');
+            console.log('└────────────────────────────────────────────────┘');
+            console.log('\n🌐 Web IDE:', metadata.webUrl);
+            console.log('🔗 Preview:', metadata.previewUrl);
+        }
+        catch (error) {
+            console.error(`❌ ${error.message}`);
+            process.exit(1);
+        }
+    },
+};

package/dist/src/commands/web/pull.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 'recoder web pull' command
+ * Pull web project files to local directory
+ */
+import type { CommandModule } from 'yargs';
+interface PullArgs {
+    urlId?: string;
+    directory?: string;
+    'dry-run'?: boolean;
+    force?: boolean;
+}
+export declare const pullCommand: CommandModule<{}, PullArgs>;
+export {};