ropilot 0.1.22 → 0.1.24

package/lib/setup.js

@@ -1,11 +1,5 @@
 /**
  * Setup and initialization for Ropilot CLI
- *
- * Handles:
- * - First-time setup
- * - Downloading system prompts
- * - Creating project configs
- * - Installing Studio plugin
  */
 
 import { existsSync, writeFileSync, mkdirSync, readFileSync, readdirSync } from 'fs';
@@ -46,13 +40,11 @@ function isWSL() {
  * Get Windows username when running in WSL (tries multiple methods)
  */
 function getWindowsUsername() {
-  // Method 1: cmd.exe
   try {
     const result = execSync('cmd.exe /c echo %USERNAME%', { encoding: 'utf-8', timeout: 5000 }).trim();
     if (result && !result.includes('%')) return result;
   } catch {}
 
-  // Method 2: whoami.exe (returns DOMAIN\user)
   try {
     const result = execSync('/mnt/c/Windows/System32/whoami.exe', { encoding: 'utf-8', timeout: 5000 }).trim();
     if (result && result.includes('\\')) {
@@ -60,7 +52,6 @@ function getWindowsUsername() {
     }
   } catch {}
 
-  // Method 3: powershell
   try {
     const result = execSync('powershell.exe -NoProfile -Command "$env:USERNAME"', { encoding: 'utf-8', timeout: 5000 }).trim();
     if (result) return result;
@@ -86,20 +77,16 @@ function getValidWindowsUsers() {
 
 /**
  * Get Roblox plugins folder path based on OS (with WSL detection)
- * Returns { path, needsPrompt, users } - needsPrompt true if user selection needed
  */
 function getPluginsFolder() {
   const os = platform();
 
-  // Check for WSL first - need to use Windows path
   if (os === 'linux' && isWSL()) {
-    // Try to auto-detect Windows username
     const windowsUser = getWindowsUsername();
     if (windowsUser && existsSync(join('/mnt/c/Users', windowsUser))) {
       return { path: join('/mnt/c/Users', windowsUser, 'AppData', 'Local', 'Roblox', 'Plugins') };
     }
 
-    // Fallback: scan /mnt/c/Users
     const validUsers = getValidWindowsUsers();
     if (validUsers.length === 1) {
       return { path: join('/mnt/c/Users', validUsers[0], 'AppData', 'Local', 'Roblox', 'Plugins') };
@@ -115,7 +102,6 @@ function getPluginsFolder() {
   } else if (os === 'darwin') {
     return { path: join(homedir(), 'Documents', 'Roblox', 'Plugins') };
   } else {
-    // Linux without WSL - Roblox doesn't officially support Linux
     return { path: null };
   }
 }
@@ -141,33 +127,26 @@ function prompt(question) {
  * Install Studio plugin to Roblox plugins folder
  */
 async function installPlugin() {
-  console.log('Installing Studio plugin...');
-
   try {
-    // Check plugin version
     const versionResponse = await fetch(PLUGIN_VERSION_URL);
     if (!versionResponse.ok) {
       throw new Error(`Failed to fetch plugin version: ${versionResponse.status}`);
     }
     const versionInfo = await versionResponse.json();
-    console.log(`  Plugin version: ${versionInfo.version}`);
 
-    // Download plugin
     const pluginResponse = await fetch(PLUGIN_DOWNLOAD_URL);
     if (!pluginResponse.ok) {
       throw new Error(`Failed to download plugin: ${pluginResponse.status}`);
     }
     const pluginSource = await pluginResponse.text();
 
-    // Get plugins folder
     let folderResult = getPluginsFolder();
     let pluginsFolder = folderResult.path;
 
-    // If WSL detected multiple users, prompt for selection
     if (folderResult.needsPrompt && folderResult.users) {
-      console.log('  Multiple Windows users detected:');
-      folderResult.users.forEach((u, i) => console.log(`    ${i + 1}. ${u}`));
-      const choice = await prompt(`  Enter number (1-${folderResult.users.length}) or username: `);
+      console.log('Multiple Windows users detected:');
+      folderResult.users.forEach((u, i) => console.log(`  ${i + 1}. ${u}`));
+      const choice = await prompt(`Select user (1-${folderResult.users.length}): `);
 
       let selectedUser;
       const num = parseInt(choice);
@@ -184,81 +163,63 @@ async function installPlugin() {
       }
     }
 
-    // If still no folder and running in WSL, prompt for username directly
     if (!pluginsFolder && isWSL()) {
-      const username = await prompt('  Enter your Windows username: ');
-      if (username && existsSync(join('/mnt/c/Users', username))) {
-        pluginsFolder = join('/mnt/c/Users', username, 'AppData', 'Local', 'Roblox', 'Plugins');
-      } else if (username) {
-        // Trust user input even if path doesn't exist yet
+      const username = await prompt('Enter your Windows username: ');
+      if (username) {
         pluginsFolder = join('/mnt/c/Users', username, 'AppData', 'Local', 'Roblox', 'Plugins');
       }
     }
 
     if (!pluginsFolder) {
-      console.log('  Could not determine Roblox plugins folder');
-      console.log('  Manual install: Download from https://ropilot.ai/plugin/StudioPlugin.lua');
+      console.log('Could not find Roblox plugins folder');
+      console.log('Download manually: https://ropilot.ai/plugin/StudioPlugin.lua');
       return false;
     }
 
-    // Create plugins folder if it doesn't exist
     mkdirSync(pluginsFolder, { recursive: true });
 
-    // Write plugin file
     const pluginPath = join(pluginsFolder, 'RopilotPlugin.lua');
     writeFileSync(pluginPath, pluginSource);
 
-    console.log(`  Installed to: ${pluginPath}`);
+    console.log(`Plugin v${versionInfo.version} installed`);
 
-    // Save version to config
     const config = loadGlobalConfig();
     config.pluginVersion = versionInfo.version;
     saveGlobalConfig(config);
 
     return true;
   } catch (err) {
-    console.error(`  Failed to install plugin: ${err.message}`);
-    console.log('  You can manually download from: https://ropilot.ai/plugin/StudioPlugin.lua');
+    console.error(`Plugin install failed: ${err.message}`);
+    console.log('Download manually: https://ropilot.ai/plugin/StudioPlugin.lua');
     return false;
   }
 }
 
-
 /**
  * Download prompts from edge server
  */
 async function downloadPrompts(apiKey) {
-  console.log('Downloading latest agent package...');
-
   try {
-    // Fetch from edge server
     const response = await fetch(`${EDGE_URL}/package`);
     if (!response.ok) {
       throw new Error(`Server returned ${response.status}`);
     }
 
     const pkg = await response.json();
-    console.log(`Package version: ${pkg.version}`);
 
-    // Ensure prompts directory exists
     mkdirSync(PROMPTS_DIR, { recursive: true });
-
-    // Write package info
     writeFileSync(join(PROMPTS_DIR, 'package.json'), JSON.stringify(pkg, null, 2));
 
-    // Update config with version info
     const config = loadGlobalConfig();
     config.promptsVersion = pkg.version;
     config.lastUpdated = new Date().toISOString();
     saveGlobalConfig(config);
 
-    console.log('Agent package downloaded successfully!');
+    console.log(`Agent package v${pkg.version} downloaded`);
     return pkg;
   } catch (err) {
-    console.error('Failed to download from server:', err.message);
-    console.log('Using bundled defaults...');
+    console.error('Failed to download package:', err.message);
 
-    // Fallback to bundled defaults
     const prompts = getDefaultPrompts();
     mkdirSync(PROMPTS_DIR, { recursive: true });
     for (const [name, content] of Object.entries(prompts)) {
@@ -275,57 +236,12 @@ async function downloadPrompts(apiKey) {
 }
 
 /**
- * Get default prompts (bundled)
+ * Get default prompts (bundled fallback)
  */
 function getDefaultPrompts() {
   return {
-    'CLAUDE.md': `# Ropilot - AI-Powered Roblox Development
-
-You are connected to Ropilot, an AI assistant for Roblox Studio development.
-
-## Available Tools
-
-Ropilot provides MCP tools for interacting with Roblox Studio:
-
-### Reading & Inspection
-- \`ropilot_listchildren\` - List children of an instance
-- \`ropilot_getproperties\` - Get properties of an instance
-- \`ropilot_search\` - Search for instances by name
-- \`ropilot_searchbyclass\` - Search for instances by class name
-
-### Playtesting
-- \`ropilot_test_start_playtest\` - Start a playtest session
-- \`ropilot_test_stop_playtest\` - Stop the current playtest
-- \`ropilot_test_run_client_lua\` - Run Lua code on the client
-- \`ropilot_test_run_server_lua\` - Run Lua code on the server
-
-### Data Management
-- \`ropilot_reset_data\` - Reset player data in DataStore
-
-## Context Targeting
-
-Commands can target different contexts:
-- \`edit\` - Edit mode (default)
-- \`server\` - Server context during playtest
-- \`client\` - Client context during playtest
-
-Use the \`target_context\` parameter to specify which context should execute the command.
-
-## Best Practices
-
-1. **Read before modify** - Always inspect the current state before making changes
-2. **Use specific paths** - Reference instances by their full path (e.g., "Workspace.Map.Building")
-3. **Delegate playtesting** - Use the roblox-tester subagent for playtest operations
-4. **Test incrementally** - Start playtests to verify changes work correctly
-`,
-
-    'subagents.json': JSON.stringify({
-      "roblox-tester": {
-        "description": "Fast subagent for executing Roblox playtest steps",
-        "tools": ["ropilot_test_*", "ropilot_get_*", "ropilot_execute_lua"],
-        "prompt": "You are a Roblox playtest executor. Run the specified test steps and report results concisely."
-      }
-    }, null, 2)
+    'CLAUDE.md': `@import ROPILOT.md\n`,
+    'ROPILOT.md': `# Ropilot\n\nRoblox Studio AI assistant. Use ropilot_* MCP tools to interact with Studio.\n`
   };
 }
 
@@ -334,60 +250,61 @@ Use the \`target_context\` parameter to specify which context should execute the
  */
 function setupProjectPrompts(pkg) {
   const files = pkg.files || {};
+  const preserveFiles = ['CLAUDE.md'];
+
+  let created = 0, updated = 0, skipped = 0;
 
   for (const [filePath, content] of Object.entries(files)) {
     const fullPath = filePath;
     const dir = dirname(fullPath);
 
-    // Create directory if needed
     if (dir && dir !== '.') {
       mkdirSync(dir, { recursive: true });
     }
 
-    // Check if file exists
     if (existsSync(fullPath)) {
-      console.log(`  Exists: ${fullPath}`);
-
-      // For CLAUDE.md, append @import line if not already present
       if (fullPath === 'CLAUDE.md') {
         const existing = readFileSync(fullPath, 'utf-8');
         if (!existing.includes('@import ROPILOT.md')) {
           writeFileSync(fullPath, existing.trimEnd() + '\n\n@import ROPILOT.md\n');
-          console.log(`  Updated: ${fullPath} (added @import ROPILOT.md)`);
+          updated++;
+        } else {
+          skipped++;
         }
+      } else if (preserveFiles.includes(fullPath)) {
+        skipped++;
+      } else {
+        writeFileSync(fullPath, content);
+        updated++;
       }
     } else {
       writeFileSync(fullPath, content);
-      console.log(`  Created: ${fullPath}`);
+      created++;
     }
   }
+
+  console.log(`Project files: ${created} created, ${updated} updated, ${skipped} unchanged`);
 }
 
 /**
  * Initialize Ropilot in current project
  */
 export async function init(providedApiKey = null) {
-  console.log('');
-  console.log('Welcome to Ropilot!');
-  console.log('===================');
-  console.log('');
+  console.log('\nRopilot Setup\n');
 
-  // Always prompt for API key (per-project config)
   const existingKey = loadProjectConfig()?.apiKey;
   const defaultHint = existingKey ? ` [${existingKey.slice(0, 20)}...]` : '';
 
-  console.log('To use Ropilot, you need an API key.');
-  console.log('Get one at: https://ropilot.ai');
-  console.log('');
+  if (!existingKey) {
+    console.log('Get your API key at: https://ropilot.ai\n');
+  }
 
   let apiKey = providedApiKey;
   if (!apiKey) {
-    apiKey = await prompt(`Enter your API key${defaultHint}: `);
+    apiKey = await prompt(`API key${defaultHint}: `);
 
-    // If empty and existing key, use existing
     if (!apiKey && existingKey) {
       apiKey = existingKey;
-      console.log(`Using existing key: ${apiKey.slice(0, 20)}...`);
     }
   }
 
@@ -396,45 +313,26 @@ export async function init(providedApiKey = null) {
     process.exit(1);
   }
 
-  // Save to project config (.ropilot.json)
   setProjectApiKey(apiKey);
-  console.log('API key saved to .ropilot.json');
-  console.log('');
-
+  console.log('API key saved to .ropilot.json\n');
 
-  // Install Studio plugin
   await installPlugin();
-  console.log('');
-
-  // Download prompts
   const pkg = await downloadPrompts(apiKey);
-  console.log('');
-
-  // Set up project files (includes .mcp.json from package)
-  console.log('Setting up project files...');
   setupProjectPrompts(pkg);
-  console.log('');
 
-  // Done!
-  console.log('Setup complete!');
-  console.log('');
+  console.log('\nSetup complete!\n');
   console.log('Next steps:');
-  console.log('1. Open Roblox Studio and check the Plugins tab for "Ropilot AI"');
-  console.log('2. Click Ropilot AI → Enter your API key → Connect');
-  console.log('3. Run Claude Code, Cursor, or any MCP-compatible AI tool in this directory');
-  console.log('');
+  console.log('1. Open Studio → Plugins tab → Click "Ropilot AI"');
+  console.log('2. Enter your API key and click Connect');
+  console.log('3. Start Claude Code or Cursor in this directory\n');
 }
 
 /**
  * Update prompts to latest version
  */
 export async function update() {
-  console.log('');
-  console.log('Updating Ropilot...');
-  console.log('===================');
-  console.log('');
+  console.log('\nUpdating Ropilot...\n');
 
-  // Check project config first, then global
   const projectConfig = loadProjectConfig();
   const apiKey = projectConfig?.apiKey || getApiKey();
 
@@ -443,25 +341,9 @@ export async function update() {
     process.exit(1);
   }
 
-  const source = projectConfig?.apiKey ? '.ropilot.json' : '~/.ropilot/config.json';
-  console.log(`Using API key from ${source}: ${apiKey.slice(0, 20)}...`);
-  console.log('');
-
-  // Re-install Studio plugin
   await installPlugin();
-  console.log('');
-
-  // Re-download prompts
   const pkg = await downloadPrompts(apiKey);
-  console.log('');
-
-  // Re-write project files
-  console.log('Updating project files...');
   setupProjectPrompts(pkg);
-  console.log('');
 
-  console.log('Update complete!');
-  console.log('');
-  console.log('Note: Check the Studio Plugins tab to verify the updated plugin is loaded.');
-  console.log('');
+  console.log('\nUpdate complete! Restart Studio to reload the plugin.\n');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ropilot",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "AI-powered Roblox development assistant - MCP CLI",
   "author": "whut",
   "license": "MIT",