recoder-code 2.2.1 → 2.2.2

package/README.md

@@ -30,20 +30,65 @@
 
 ## 🚀 Quick Start
 
-### Get Up and Running in 30 Seconds
+### Perfect Production-Ready User Flow
+
+**⚠️ Important:** Use `npm install -g` (not `npm i` shown on some npm pages) for global installation.
 
 ```bash
-# Install globally
+# 1. Install globally (use full command for global install)
 npm install -g recoder-code
 
-# Quick setup (first time only)
-recoder-code --setup
+# 2. Launch Recoder Code
+recoder-code
+```
+
+**That's it!** When you run `recoder-code`, you'll see:
+
+1. **🎨 Beautiful ASCII Logo** - Professional welcome screen
+2. **👋 Personal Setup** - Enter your name and get your free API key
+3. **🤖 Model Selection** - Choose your AI model (defaults to free DeepSeek)
+4. **🚀 Ready to Code** - Interactive AI terminal launches instantly
 
-# Start chatting with AI
-recoder-code "Hello! Create a simple calculator app"
+### ✨ First-Time User Experience
+
+```
+██████╗ ███████╗ ██████╗ ██████╗ ██████╗ ███████╗██████╗ 
+██╔══██╗██╔════╝██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔══██╗
+██████╔╝█████╗  ██║     ██║   ██║██║  ██║█████╗  ██████╔╝
+██╔══██╗██╔══╝  ██║     ██║   ██║██║  ██║██╔══╝  ██╔══██╗
+██║  ██║███████╗╚██████╗╚██████╔╝██████╔╝███████╗██║  ██║
+╚═╝  ╚═╝╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝
+
+Welcome to Recoder Code v2.2.2
+Your AI-powered development companion
+
+👋 What's your name? John
+🔑 Enter your OpenRouter API key: [your-free-key]
+🤖 Model Selection:
+  1. DeepSeek Chat v3.1 (Free) - Recommended ✨
+  2. Claude 3.5 Sonnet - Advanced reasoning
+  3. GPT-4 Turbo - OpenAI's latest
+  4. Custom model
+
+✅ Setup Complete! Welcome aboard, John! 🎉
+Ready for AI-powered development...
 ```
 
-**That's it!** No complex configuration, no API juggling, no subscription required.
+### 🔄 Returning Users
+
+For returning users, just run `recoder-code` and you'll get:
+- Instant welcome back with your saved preferences  
+- No setup required - jumps straight to AI chat
+- Your chosen model and settings remembered
+
+### 🆓 Free API Key Setup
+
+1. Visit [OpenRouter.ai](https://openrouter.ai/keys) 
+2. Sign up for free account
+3. Generate your API key
+4. Paste when prompted during setup
+
+**Default Model:** `deepseek/deepseek-chat-v3.1:free` - Completely free, no subscription needed!
 
 ### All Available Commands
 
@@ -152,10 +197,17 @@ Recoder-Code automatically suggests new features as you become ready:
 
 ## 🛠️ Installation & Setup Options
 
+> **⚠️ NPM Command Important Notice**  
+> Always use `npm install -g recoder-code` (full command) for global installation.  
+> The `npm i` shorthand shown on some npm websites is incorrect for global installs and may cause issues.
+
 ### Option 1: NPM Global Install (Recommended)
 ```bash
+# Use full command for global install (not npm i)
 npm install -g recoder-code
-recoder-code --setup
+
+# Launch with onboarding
+recoder-code
 ```
 
 ### Option 2: From Source
@@ -360,9 +412,13 @@ MIT License - see [LICENSE.md](LICENSE.md) for details.
 **Ready to transform your development workflow?**
 
 ```bash
+# Install globally (use full command, not npm i)
 npm install -g recoder-code
-recoder-code --setup
-recoder-code "Build me something amazing!"
+
+# Launch with beautiful onboarding
+recoder-code
+
+# Start building amazing things!
 ```
 
 *The AI development platform that grows with you.* 🚀

package/cli/collaboration-manager.js

@@ -1,6 +1,8 @@
 const fs = require('fs');
 const path = require('path');
-const chalk = require('chalk');
+// Handle chalk properly
+const chalkModule = require('chalk');
+const chalk = chalkModule.default || chalkModule;
 const crypto = require('crypto');
 
 class CollaborationManager {

package/cli/dev-tools-integration.js

@@ -4,7 +4,9 @@ const fs = require('fs');
 const path = require('path');
 const { exec, spawn } = require('child_process');
 const { promisify } = require('util');
-const chalk = require('chalk');
+// Handle chalk properly
+const chalkModule = require('chalk');
+const chalk = chalkModule.default || chalkModule;
 const { EventEmitter } = require('events');
 
 const execAsync = promisify(exec);

package/cli/enhanced-setup.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 
 const inquirer = require('inquirer');
-const chalk = require('chalk');
+// Handle chalk properly
+const chalkModule = require('chalk');
+const chalk = chalkModule.default || chalkModule;;
 const fs = require('fs');
 const path = require('path');
 

package/cli/file-watcher-manager.js

@@ -0,0 +1,216 @@
+#!/usr/bin/env node
+
+const chokidar = require('chokidar');
+const chalkModule = require('chalk');
+const chalk = chalkModule.default || chalkModule;
+
+/**
+ * File Watcher Resource Manager
+ * Prevents EMFILE errors by managing file watchers globally
+ */
+class FileWatcherManager {
+  constructor() {
+    this.watchers = new Map();
+    this.watchTargets = new Map(); // Track what's being watched
+    this.maxWatchers = 50; // Conservative limit
+    this.isShuttingDown = false;
+    
+    // Global cleanup on process exit
+    process.on('exit', () => this.cleanup());
+    process.on('SIGINT', () => this.cleanup());
+    process.on('SIGTERM', () => this.cleanup());
+  }
+
+  /**
+   * Create or reuse a file watcher
+   */
+  createWatcher(id, paths, options = {}, callbacks = {}) {
+    // If we already have a watcher for this ID, clean it up first
+    if (this.watchers.has(id)) {
+      this.removeWatcher(id);
+    }
+
+    // Check watcher limit
+    if (this.watchers.size >= this.maxWatchers) {
+      console.log(chalk.yellow(`⚠️  File watcher limit reached (${this.maxWatchers}), skipping ${id}`));
+      return null;
+    }
+
+    try {
+      // Create watcher with safe defaults
+      const safeOptions = {
+        persistent: false, // Don't keep process alive
+        ignoreInitial: true,
+        usePolling: false,
+        ignorePermissionErrors: true,
+        ...options
+      };
+
+      const watcher = chokidar.watch(paths, safeOptions);
+      
+      // Set up callbacks
+      if (callbacks.onChange) {
+        watcher.on('change', (path) => {
+          try {
+            callbacks.onChange(path);
+          } catch (error) {
+            if (process.env.RECODER_DEBUG === 'true') {
+              console.log(chalk.gray(`📁 File watcher ${id} change error:`, error.message));
+            }
+          }
+        });
+      }
+
+      if (callbacks.onAdd) {
+        watcher.on('add', (path) => {
+          try {
+            callbacks.onAdd(path);
+          } catch (error) {
+            if (process.env.RECODER_DEBUG === 'true') {
+              console.log(chalk.gray(`📁 File watcher ${id} add error:`, error.message));
+            }
+          }
+        });
+      }
+
+      if (callbacks.onUnlink) {
+        watcher.on('unlink', (path) => {
+          try {
+            callbacks.onUnlink(path);
+          } catch (error) {
+            if (process.env.RECODER_DEBUG === 'true') {
+              console.log(chalk.gray(`📁 File watcher ${id} unlink error:`, error.message));
+            }
+          }
+        });
+      }
+
+      // Handle watcher errors gracefully
+      watcher.on('error', (error) => {
+        if (process.env.RECODER_DEBUG === 'true') {
+          console.log(chalk.gray(`📁 File watcher ${id} error:`, error.message));
+        }
+        // Auto-remove problematic watchers
+        this.removeWatcher(id);
+      });
+
+      // Store watcher
+      this.watchers.set(id, watcher);
+      this.watchTargets.set(id, { paths, options, callbacks });
+
+      if (process.env.RECODER_DEBUG === 'true') {
+        console.log(chalk.gray(`📁 File watcher ${id} created (total: ${this.watchers.size})`));
+      }
+
+      return watcher;
+    } catch (error) {
+      console.log(chalk.yellow(`⚠️  Failed to create file watcher ${id}:`, error.message));
+      return null;
+    }
+  }
+
+  /**
+   * Remove a specific watcher
+   */
+  removeWatcher(id) {
+    const watcher = this.watchers.get(id);
+    if (watcher) {
+      try {
+        watcher.close();
+      } catch (error) {
+        // Ignore cleanup errors
+      }
+      this.watchers.delete(id);
+      this.watchTargets.delete(id);
+      
+      if (process.env.RECODER_DEBUG === 'true') {
+        console.log(chalk.gray(`📁 File watcher ${id} removed (total: ${this.watchers.size})`));
+      }
+    }
+  }
+
+  /**
+   * Get watcher by ID
+   */
+  getWatcher(id) {
+    return this.watchers.get(id);
+  }
+
+  /**
+   * Check if watcher exists
+   */
+  hasWatcher(id) {
+    return this.watchers.has(id);
+  }
+
+  /**
+   * Get watcher count
+   */
+  getWatcherCount() {
+    return this.watchers.size;
+  }
+
+  /**
+   * List all active watchers
+   */
+  listWatchers() {
+    return Array.from(this.watchers.keys());
+  }
+
+  /**
+   * Cleanup all watchers
+   */
+  cleanup() {
+    if (this.isShuttingDown) return;
+    this.isShuttingDown = true;
+
+    console.log(chalk.gray(`📁 Cleaning up ${this.watchers.size} file watchers...`));
+    
+    for (const [id, watcher] of this.watchers) {
+      try {
+        watcher.close();
+      } catch (error) {
+        // Ignore cleanup errors
+      }
+    }
+    
+    this.watchers.clear();
+    this.watchTargets.clear();
+  }
+
+  /**
+   * Health check - remove dead watchers
+   */
+  healthCheck() {
+    const deadWatchers = [];
+    
+    for (const [id, watcher] of this.watchers) {
+      try {
+        // Try to get watched paths - if this fails, watcher is dead
+        if (!watcher.getWatched || Object.keys(watcher.getWatched()).length === 0) {
+          deadWatchers.push(id);
+        }
+      } catch (error) {
+        deadWatchers.push(id);
+      }
+    }
+
+    // Remove dead watchers
+    deadWatchers.forEach(id => this.removeWatcher(id));
+    
+    if (deadWatchers.length > 0 && process.env.RECODER_DEBUG === 'true') {
+      console.log(chalk.gray(`📁 Removed ${deadWatchers.length} dead file watchers`));
+    }
+  }
+}
+
+// Global singleton instance
+const fileWatcherManager = new FileWatcherManager();
+
+// Periodic health check
+setInterval(() => {
+  fileWatcherManager.healthCheck();
+}, 30000); // Every 30 seconds
+
+module.exports = FileWatcherManager;
+module.exports.instance = fileWatcherManager;