luxlabs 1.0.21 → 1.0.24

package/README.md

@@ -16,14 +16,11 @@ npm install -g luxlabs
 # Authenticate with Lux
 lux login
 
-# Initialize a new interface project
-lux interface init
-
-# Start local development with hot reload
-lux dev
+# Create a new interface
+lux i create --name my-app
 
 # Deploy your interface
-lux interface up
+lux i deploy <id>
 ```
 
 ## Commands
@@ -40,21 +37,19 @@ lux interface up
 
 | Command | Description |
 |---------|-------------|
-| `lux interface init` | Initialize a new interface project |
-| `lux interface up` | Upload and deploy your interface |
-| `lux interface list` | List all your interfaces |
-| `lux interface link` | Link current directory to an interface |
-| `lux i <subcommand>` | Shorthand alias for interface commands |
-
-### Development
-
-| Command | Description |
-|---------|-------------|
-| `lux dev` | Start local dev server with tunnel |
-| `lux dev -p <port>` | Specify custom port (default: 3000) |
-| `lux dev --no-tunnel` | Disable tunnel (local only) |
-| `lux servers` | List running dev servers |
-| `lux logs <interface>` | View logs from a dev server |
+| `lux i create --name <name>` | Create a new interface |
+| `lux i list` | List all your interfaces |
+| `lux i deploy <id>` | Deploy interface to production |
+| `lux i logs <name-or-id>` | View interface logs (--type terminal\|console\|deployed, --lines N) |
+| `lux i path <name-or-id>` | Get local repo path |
+| `lux i screenshot <name-or-id>` | Take a screenshot |
+| `lux i click <name-or-id> <selector>` | Click an element |
+| `lux i type <name-or-id> <selector> <text>` | Type into an element |
+| `lux i eval <name-or-id> <code>` | Execute JavaScript |
+| `lux i url <name-or-id>` | Get current URL |
+| `lux i nav <name-or-id> <url>` | Navigate to URL |
+| `lux i wait <name-or-id> <ms>` | Wait for duration |
+| `lux i preview <name-or-id>` | Start interface preview |
 
 ### Data Management
 

package/commands/ab-tests.js

@@ -20,7 +20,7 @@ const chalk = require('chalk');
 const fs = require('fs');
 const path = require('path');
 const ora = require('ora');
-const { loadConfig, getProjectId, getStudioApiUrl, getInterfaceRepoDir, getInterfacesDir } = require('../lib/config');
+const { loadConfig, getProjectId, getStudioApiUrl, getInterfaceRepoDir, getInterfacesDir, FOLDER_NAMES } = require('../lib/config');
 
 /**
  * Show help for ab-tests commands
@@ -52,7 +52,7 @@ function showHelp() {
 
 /**
  * Get the path to ab-tests.json for an interface
- * Uses ~/.lux-studio/{orgId}/projects/{projectId}/interfaces/{interfaceId}/repo/.lux/ab-tests.json
+ * Uses ~/.lux-studio/{shortOrgId}/p/{shortProjectId}/i/{shortInterfaceId}/repo/.lux/ab-tests.json
  */
 function getABTestsPath(interfaceIdentifier) {
   // First try the config-based path (preferred - used by Electron app)
@@ -113,13 +113,16 @@ function getABTestsPath(interfaceIdentifier) {
  * Get interface name from identifier
  */
 function getInterfaceName(interfaceIdentifier) {
-  const interfacesDir = path.join(process.cwd(), 'interfaces');
+  // Use short folder name for interfaces
+  const interfacesDir = path.join(process.cwd(), FOLDER_NAMES.interfaces);
 
   if (!interfaceIdentifier) {
-    const entries = fs.readdirSync(interfacesDir, { withFileTypes: true });
-    const dirs = entries.filter(e => e.isDirectory());
-    if (dirs.length === 1) {
-      interfaceIdentifier = dirs[0].name;
+    if (fs.existsSync(interfacesDir)) {
+      const entries = fs.readdirSync(interfacesDir, { withFileTypes: true });
+      const dirs = entries.filter(e => e.isDirectory());
+      if (dirs.length === 1) {
+        interfaceIdentifier = dirs[0].name;
+      }
     }
   }
 
@@ -196,7 +199,7 @@ async function listTests(interfaceId, options) {
 
   for (const test of tests) {
     console.log();
-    console.log(chalk.cyan(`📊 ${test.name}`) + chalk.dim(` (key: ${test.key})`));
+    console.log(chalk.cyan(`${test.name}`) + chalk.dim(` (key: ${test.key})`));
     console.log(chalk.dim(`   Status: ${test.status}${test.posthogFlagId ? ` (PostHog flag: ${test.posthogFlagId})` : ''}`));
 
     if (test.description) {
@@ -252,7 +255,7 @@ async function getTest(testKey, interfaceId, options) {
   }
 
   console.log();
-  console.log(chalk.cyan(`📊 ${test.key}`));
+  console.log(chalk.cyan(`${test.key}`));
   console.log(chalk.white(`   Name: ${test.name}`));
   console.log(chalk.dim(`   Status: ${test.status}${test.posthogFlagId ? ` (PostHog flag: ${test.posthogFlagId})` : ''}`));
 
@@ -339,7 +342,7 @@ async function getVariant(testKey, variantKey, interfaceId, options) {
   }
 
   console.log();
-  console.log(chalk.cyan(`🎯 Variant: ${variant.key}`));
+  console.log(chalk.cyan(`Variant: ${variant.key}`));
   console.log(chalk.dim(`   Test: ${test.name} (${test.key})`));
   console.log(chalk.white(`   Name: ${variant.name || variant.key}`));
   console.log(chalk.dim(`   Traffic: ${variant.percentage}%`));
@@ -446,7 +449,7 @@ function getInterfaceId(options) {
   }
 
   // Try to find from interfaces directory structure
-  const interfacesDir = path.join(process.cwd(), 'interfaces');
+  const interfacesDir = path.join(process.cwd(), FOLDER_NAMES.interfaces);
   if (fs.existsSync(interfacesDir)) {
     const entries = fs.readdirSync(interfacesDir, { withFileTypes: true });
     const dirs = entries.filter(e => e.isDirectory());

package/commands/agents.js

@@ -19,7 +19,7 @@ async function handleAgents(args) {
   // Check authentication
   if (!isAuthenticated()) {
     console.log(
-      chalk.red('❌ Not authenticated. Run'),
+      chalk.red('Not authenticated. Run'),
       chalk.white('lux login'),
       chalk.red('first.')
     );
@@ -94,14 +94,14 @@ ${chalk.bold('Examples:')}
 
         const agent = agentData.agent;
 
-        console.log(`\n🤖 ID: ${agent.id}`);
-        console.log(`📝 Name: ${agent.name}`);
-        console.log(`📄 Description: ${agent.description || '(none)'}`);
-        console.log(`🏷️  Type: ${agent.type}`);
-        console.log(`📂 Category: ${agent.category}`);
-        console.log(`🎯 Purpose: ${agent.purpose || '(none)'}`);
-        console.log(`📅 Created: ${agent.created_at}`);
-        console.log(`📅 Updated: ${agent.updated_at}`);
+        console.log(`\nID: ${agent.id}`);
+        console.log(`Name: ${agent.name}`);
+        console.log(`Description: ${agent.description || '(none)'}`);
+        console.log(`Type: ${agent.type}`);
+        console.log(`Category: ${agent.category}`);
+        console.log(`Purpose: ${agent.purpose || '(none)'}`);
+        console.log(`Created: ${agent.created_at}`);
+        console.log(`Updated: ${agent.updated_at}`);
 
         // Fetch prompt content
         info('Loading agent prompt...');
@@ -111,10 +111,10 @@ ${chalk.bold('Examples:')}
         );
 
         if (promptData.content) {
-          console.log(`\n📋 Prompt:\n`);
+          console.log(`\nPrompt:\n`);
           console.log(promptData.content);
         } else {
-          console.log(`\n📋 Prompt: (empty)`);
+          console.log(`\nPrompt: (empty)`);
         }
 
         break;

package/commands/data.js

@@ -11,6 +11,8 @@ const {
   getOrgId,
   getProjectId,
   loadConfig,
+  getShortId,
+  FOLDER_NAMES,
 } = require('../lib/config');
 const {
   error,
@@ -33,7 +35,9 @@ function getTablesDir() {
   const orgId = getOrgId();
   const projectId = getProjectId();
   if (!orgId) return null;
-  return path.join(LUX_STUDIO_DIR, orgId, 'projects', projectId, 'data', 'tables');
+  const shortOrgId = getShortId(orgId);
+  const shortProjectId = getShortId(projectId);
+  return path.join(LUX_STUDIO_DIR, shortOrgId, FOLDER_NAMES.projects, shortProjectId, FOLDER_NAMES.data, 'tables');
 }
 
 /**
@@ -156,7 +160,7 @@ async function handleData(args) {
   // Check authentication
   if (!isAuthenticated()) {
     console.log(
-      chalk.red('❌ Not authenticated. Run'),
+      chalk.red('Not authenticated. Run'),
       chalk.white('lux login'),
       chalk.red('first.')
     );
@@ -277,11 +281,11 @@ ${chalk.bold('Examples:')}
                   const safeName = tableName.replace(/[<>:"/\\|?*]/g, '_');
                   const tablePath = path.join(tablesDir, `${safeName}.json`);
                   fs.writeFileSync(tablePath, JSON.stringify(tableSchema, null, 2));
-                  console.log(chalk.dim(`  ✓ ${tableName}`));
+                  console.log(chalk.dim(`  ${tableName}`));
                   synced++;
                 }
               } catch (err) {
-                console.log(chalk.yellow(`  ✗ ${tableName}: ${err.message}`));
+                console.log(chalk.yellow(`  ${tableName}: ${err.message}`));
               }
             }
 
@@ -336,7 +340,7 @@ ${chalk.bold('Examples:')}
             schema = parseJson(schemaArg, 'schema');
           } else {
             // Interactive mode: prompt for schema
-            console.log('\n' + chalk.yellow('📝 Define your table schema in JSON format:'));
+            console.log('\n' + chalk.yellow('Define your table schema in JSON format:'));
             console.log(chalk.gray('Example:'));
             console.log(chalk.gray(JSON.stringify({
               columns: [
@@ -409,9 +413,9 @@ ${chalk.bold('Examples:')}
             { headers: getStudioAuthHeaders() }
           );
 
-          console.log(`\n📝 Table: ${data.table.name}`);
-          console.log(`📊 Columns: ${data.table.columnCount}`);
-          console.log(`\n📋 Schema:\n`);
+          console.log(`\nTable: ${data.table.name}`);
+          console.log(`Columns: ${data.table.columnCount}`);
+          console.log(`\nSchema:\n`);
           formatTable(data.table.columns.map(col => ({
             name: col.name,
             type: col.type,
@@ -458,7 +462,7 @@ ${chalk.bold('Examples:')}
           } else {
             console.log('');
             formatTable(data.rows);
-            console.log(`\n${chalk.green('✓')} ${data.rows.length} row(s) returned (total: ${data.pagination.total})\n`);
+            console.log(`\n${data.rows.length} row(s) returned (total: ${data.pagination.total})\n`);
           }
           break;
         }
@@ -916,10 +920,9 @@ ${chalk.bold('Examples:')}
           const namespaceId = args[2]; // Optional - if not provided, sync all
 
           // Get org ID and storage path
-          const { getOrgId } = require('../lib/config');
           const orgId = getOrgId();
-          const os = require('os');
-          const kvDir = path.join(os.homedir(), '.lux-studio', orgId, 'data', 'kv');
+          const shortOrgId = getShortId(orgId);
+          const kvDir = path.join(os.homedir(), '.lux-studio', shortOrgId, FOLDER_NAMES.data, 'kv');
 
           if (!fs.existsSync(kvDir)) {
             fs.mkdirSync(kvDir, { recursive: true });
@@ -1010,9 +1013,9 @@ ${chalk.bold('Examples:')}
                 );
 
                 totalKeys += keys.length;
-                console.log(`  ✓ ${ns.name}: ${keys.length} keys`);
+                console.log(`  ${ns.name}: ${keys.length} keys`);
               } catch (err) {
-                console.error(`  ✗ ${ns.name}: ${err.message}`);
+                console.error(`  ${ns.name}: ${err.message}`);
               }
             }
 
@@ -1026,10 +1029,9 @@ ${chalk.bold('Examples:')}
           requireArgs(args.slice(2), 1, 'lux data kv local <namespace-id>');
           const namespaceId = args[2];
 
-          const { getOrgId } = require('../lib/config');
           const orgId = getOrgId();
-          const os = require('os');
-          const nsDir = path.join(os.homedir(), '.lux-studio', orgId, 'data', 'kv', namespaceId);
+          const shortOrgId = getShortId(orgId);
+          const nsDir = path.join(os.homedir(), '.lux-studio', shortOrgId, FOLDER_NAMES.data, 'kv', namespaceId);
 
           if (!fs.existsSync(nsDir)) {
             console.log('\n(No local data found. Run "lux data kv sync" first.)\n');

package/commands/deploy.js

@@ -1,164 +1,227 @@
 const axios = require('axios');
-const ora = require('ora');
 const chalk = require('chalk');
-const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
 const {
-  loadInterfaceConfig,
-  saveInterfaceConfig,
   getApiUrl,
   getAuthHeaders,
   isAuthenticated,
+  loadInterfaceMetadata,
+  saveInterfaceMetadata,
+  getInterfaceRepoDir,
+  loadConfig,
 } = require('../lib/config');
+const { runGitCommand } = require('./interface/git-utils');
+
+/**
+ * Push local repo to GitHub
+ */
+async function pushToGitHub(repoDir, githubRepoUrl, githubToken) {
+  const targetUrl = githubRepoUrl.replace('https://github.com/', `https://${githubToken}@github.com/`) + '.git';
+  const gitDir = path.join(repoDir, '.git');
+  const needsInit = !fs.existsSync(gitDir);
+
+  if (needsInit) {
+    await runGitCommand(['init'], repoDir);
+    await runGitCommand(['remote', 'add', 'origin', targetUrl], repoDir);
+    await runGitCommand(['branch', '-M', 'main'], repoDir);
+  }
+
+  await runGitCommand(['add', '.'], repoDir);
+
+  // Try to commit - if nothing changed, just push current state
+  try {
+    await runGitCommand(['commit', '-m', 'Deploy from Lux CLI'], repoDir);
+  } catch {
+    // No changes to commit, that's fine - we'll push what's there
+    console.log(chalk.dim('  No new changes to commit, pushing current state'));
+  }
+
+  await runGitCommand(['push', '-u', 'origin', 'main', '--force'], repoDir);
 
-async function deploy() {
+  // Clean up .git directory after push (we don't keep nested git repos)
+  if (needsInit && fs.existsSync(gitDir)) {
+    fs.rmSync(gitDir, { recursive: true, force: true });
+  }
+}
+
+async function deploy(options = {}) {
   // Check authentication
   if (!isAuthenticated()) {
     console.log(
-      chalk.red('❌ Not authenticated. Run'),
+      chalk.red('Not authenticated. Run'),
       chalk.white('lux login'),
       chalk.red('first.')
     );
     process.exit(1);
   }
 
-  // Check if initialized
-  const interfaceConfig = loadInterfaceConfig();
-  if (!interfaceConfig || !interfaceConfig.id) {
-    console.log(
-      chalk.red('❌ No interface found. Run'),
-      chalk.white('lux up'),
-      chalk.red('first.')
-    );
+  // Require interface ID
+  const interfaceId = options.id;
+  if (!interfaceId) {
+    console.log(chalk.red('Interface ID is required.'));
+    console.log(chalk.dim('Usage: lux i deploy <id>'));
+    console.log(chalk.dim('Run'), chalk.white('lux i list'), chalk.dim('to see available interfaces.'));
     process.exit(1);
   }
 
+  // Load interface metadata
+  const metadata = loadInterfaceMetadata(interfaceId);
+  if (!metadata) {
+    console.log(chalk.red(`Interface not found locally: ${interfaceId}`));
+    console.log(chalk.dim('Run'), chalk.white('lux i list'), chalk.dim('to see available interfaces.'));
+    process.exit(1);
+  }
+
+  console.log(chalk.cyan('\nDeploy Interface\n'));
+  console.log(chalk.dim('  Name:'), metadata.name);
+  console.log(chalk.dim('  ID:'), metadata.id);
+  console.log('');
+
   const apiUrl = getApiUrl();
-  const interfaceId = interfaceConfig.id;
 
-  // Pre-deploy accessibility check
-  const spinner = ora('Checking accessibility...').start();
-  try {
-    execSync('npx eslint . --ext .tsx,.jsx --format stylish', {
-      cwd: process.cwd(),
-      stdio: 'pipe',
-    });
-    spinner.succeed(chalk.green('✓ Accessibility check passed'));
-  } catch (error) {
-    const output = error.stdout?.toString() || error.stderr?.toString() || '';
-    // Only fail on jsx-a11y errors, warn on others
-    if (output.includes('jsx-a11y')) {
-      spinner.fail('Accessibility issues found');
-      console.error(chalk.red('\n❌ Fix accessibility issues before deploying:\n'));
-      console.error(output);
-      process.exit(1);
-    } else if (output.trim()) {
-      spinner.warn(chalk.yellow('Linting warnings (non-blocking)'));
-      console.log(chalk.dim(output));
-    } else {
-      spinner.succeed(chalk.green('✓ Accessibility check passed'));
+  // Step 1: Push to GitHub
+  const githubRepoUrl = metadata.githubUrl;
+  if (!githubRepoUrl) {
+    console.log(chalk.red('No GitHub repository URL in metadata.'));
+    console.log(chalk.dim('This interface may not have been set up with GitHub.'));
+    process.exit(1);
+  }
+
+  const repoDir = getInterfaceRepoDir(interfaceId);
+  if (!repoDir || !fs.existsSync(repoDir)) {
+    console.log(chalk.red('Local repository not found.'));
+    console.log(chalk.dim('Expected at:'), repoDir);
+    process.exit(1);
+  }
+
+  // Get GitHub token
+  const config = loadConfig();
+  let githubToken = config?.githubPat;
+  if (!githubToken) {
+    try {
+      const tokenRes = await axios.get(`${apiUrl}/api/studio/github-token`, {
+        headers: getAuthHeaders(),
+      });
+      githubToken = tokenRes.data?.token;
+    } catch {
+      // ignore
     }
   }
 
-  // Proceed with deploy
-  spinner.start('Deploying to production...');
+  if (!githubToken) {
+    console.log(chalk.red('No GitHub token available.'));
+    console.log(chalk.dim('Cannot push to GitHub without a token.'));
+    process.exit(1);
+  }
+
+  console.log(chalk.blue('[1/3]'), 'Pushing to GitHub...');
+  try {
+    await pushToGitHub(repoDir, githubRepoUrl, githubToken);
+    console.log(chalk.green('  Code pushed to GitHub'));
+    console.log(chalk.dim('  Repo:'), githubRepoUrl);
+  } catch (error) {
+    console.log(chalk.red('  Failed to push to GitHub:'), error.message);
+    process.exit(1);
+  }
 
+  // Step 2: Trigger deployment via API
+  console.log(chalk.blue('[2/3]'), 'Triggering deployment...');
   try {
-    // Trigger deployment
     const { data } = await axios.post(
-      `${apiUrl}/api/interfaces/${interfaceId}/deploy`,
+      `${apiUrl}/api/interfaces/${metadata.id}/deploy`,
       {},
       {
         headers: getAuthHeaders(),
       }
     );
 
-    spinner.succeed(chalk.green('✓ Deployment started!'));
-
-    console.log(chalk.dim(`\nDeployment ID: ${data.deploymentId}`));
-    console.log(chalk.dim(`Status: ${data.status}\n`));
-
-    // Poll for deployment status
-    await pollDeploymentStatus(interfaceId, apiUrl);
+    console.log(chalk.green('  Deployment started'));
+    if (data.deploymentId) {
+      console.log(chalk.dim('  Deployment ID:'), data.deploymentId);
+    }
   } catch (error) {
-    spinner.fail('Deployment failed');
-    console.error(
-      chalk.red('\n❌ Error:'),
+    console.log(chalk.red('  Failed to trigger deployment:'),
       error.response?.data?.error || error.message
     );
 
     if (error.response?.status === 401) {
       console.log(
-        chalk.yellow('\nYour session may have expired. Try running:'),
+        chalk.yellow('\nSession may have expired. Run:'),
         chalk.white('lux login')
       );
     }
 
     process.exit(1);
   }
+
+  // Step 3: Poll for deployment status
+  console.log(chalk.blue('[3/3]'), 'Building...');
+  await pollDeploymentStatus(metadata.id, interfaceId, apiUrl);
 }
 
-async function pollDeploymentStatus(interfaceId, apiUrl) {
-  const spinner = ora('Building...').start();
+async function pollDeploymentStatus(interfaceUuid, interfaceId, apiUrl) {
   const maxAttempts = 60; // 5 minutes max
   let attempts = 0;
 
   while (attempts < maxAttempts) {
     try {
       const { data } = await axios.get(
-        `${apiUrl}/api/interfaces/${interfaceId}`,
+        `${apiUrl}/api/interfaces/${interfaceUuid}`,
         { headers: getAuthHeaders() }
       );
 
-      const status = data.interface.status;
+      const status = data.interface?.status;
 
       if (status === 'published') {
-        spinner.succeed(chalk.green('✓ Deployment successful!'));
-
-        const interfaceConfig = loadInterfaceConfig();
-        interfaceConfig.deploymentUrl = data.interface.vercel_deployment_url;
-        interfaceConfig.deploymentId = data.interface.vercel_deployment_id;
-        saveInterfaceConfig(interfaceConfig);
-
-        console.log(chalk.cyan('\n🎉 Your interface is live!\n'));
-        console.log(chalk.white(`  ${data.interface.vercel_deployment_url}\n`));
+        console.log(chalk.green('  Deployment successful!'));
+
+        // Update local metadata
+        const metadata = loadInterfaceMetadata(interfaceId);
+        if (metadata) {
+          metadata.status = 'published';
+          if (data.interface.vercel_deployment_url) {
+            metadata.deploymentUrl = data.interface.vercel_deployment_url;
+          }
+          if (data.interface.vercel_deployment_id) {
+            metadata.deploymentId = data.interface.vercel_deployment_id;
+          }
+          metadata.lastDeployedAt = new Date().toISOString();
+          saveInterfaceMetadata(interfaceId, metadata);
+        }
 
+        console.log(chalk.green('\nYour interface is live!\n'));
+        if (data.interface.vercel_deployment_url) {
+          console.log(chalk.white(`  ${data.interface.vercel_deployment_url}\n`));
+        }
         if (data.interface.github_repo_url) {
-          console.log(chalk.dim(`GitHub: ${data.interface.github_repo_url}`));
+          console.log(chalk.dim(`  GitHub: ${data.interface.github_repo_url}`));
         }
 
         return;
       } else if (status === 'failed') {
-        spinner.fail('Deployment failed');
-
-        console.log(
-          chalk.red('\n❌ Build failed. View logs with:'),
-          chalk.white('lux logs --type build')
-        );
-
+        console.log(chalk.red('  Deployment failed'));
         if (data.interface.error_message) {
-          console.log(chalk.dim(`\nError: ${data.interface.error_message}`));
+          console.log(chalk.dim(`  Error: ${data.interface.error_message}`));
         }
-
+        console.log(chalk.dim('  View logs with:'), chalk.white(`lux i logs ${interfaceId}`));
         process.exit(1);
       } else if (status === 'building') {
-        spinner.text = 'Building... (this may take a few minutes)';
+        process.stdout.write(chalk.dim('.'));
       }
 
       // Wait 5 seconds before next poll
       await new Promise((resolve) => setTimeout(resolve, 5000));
       attempts++;
     } catch (error) {
-      spinner.fail('Failed to check deployment status');
-      console.error(chalk.red('\n❌ Error:'), error.message);
+      console.log(chalk.red('\n  Failed to check status:'), error.message);
       process.exit(1);
     }
   }
 
-  spinner.fail('Deployment timed out');
-  console.log(
-    chalk.yellow('\n⚠️  Deployment is still in progress. Check status with:'),
-    chalk.white('lux logs')
-  );
+  console.log(chalk.yellow('\n  Deployment timed out (5 minutes).'));
+  console.log(chalk.dim('  Deployment may still be in progress.'));
+  console.log(chalk.dim('  Check status with:'), chalk.white(`lux i logs ${interfaceId}`));
 }
 
 module.exports = {