luxlabs 1.0.18 → 1.0.19

package/commands/{workflows.js → flows.js}

@@ -74,7 +74,7 @@ async function saveWorkflowDraft(workflowId, config) {
   );
 }
 
-async function handleWorkflows(args) {
+async function handleFlows(args) {
   // Check authentication
   if (!isAuthenticated()) {
     console.log(
@@ -89,18 +89,18 @@ async function handleWorkflows(args) {
 
   if (!command) {
     console.log(`
-${chalk.bold('Usage:')} lux workflows <command> [args]
+${chalk.bold('Usage:')} lux flows <command> [args]
 
 ${chalk.bold('Commands:')}
-  list                        List all workflows (from local storage)
-  get <id>                    Get workflow details with config
-  status <id>                 Show sync status for a workflow
-  create <name> [desc] [--publish]  Create workflow (use --publish to publish immediately)
-  init <name> [desc] [--publish]    Initialize workflow (alias for create)
+  list                        List all flows (from local storage)
+  get <id>                    Get flow details with config
+  status <id>                 Show sync status for a flow
+  create <name> [desc] [--publish]  Create flow (use --publish to publish immediately)
+  init <name> [desc] [--publish]    Initialize flow (alias for create)
   save <id> <config-file>     Save draft config from file (local)
-  sync                        Sync published workflows from cloud
-  publish <id>                Publish workflow to cloud
-  delete <id>                 Delete a local workflow
+  sync                        Sync published flows from cloud
+  publish <id>                Publish flow to cloud
+  delete <id>                 Delete a local flow
   diff <id>                   Show local vs published differences
 
 ${chalk.bold('Execution History:')}
@@ -128,33 +128,33 @@ ${chalk.bold('Execution Commands:')}
   last <id>                   Show the last execution result
 
 ${chalk.bold('Examples:')}
-  lux workflows list
-  lux workflows get flow_123
-  lux workflows status flow_123
-  lux workflows create "My Workflow" "Description"
-  lux workflows create "My Workflow" --publish    # Create and publish immediately
-  lux flow init "My Workflow" --publish
-  lux workflows save flow_123 ./config.json
-  lux workflows sync
-  lux workflows publish flow_123
-  lux workflows diff flow_123
+  lux flows list
+  lux flows get flow_123
+  lux flows status flow_123
+  lux flows create "My Flow" "Description"
+  lux flows create "My Flow" --publish    # Create and publish immediately
+  lux flows init "My Flow" --publish
+  lux flows save flow_123 ./config.json
+  lux flows sync
+  lux flows publish flow_123
+  lux flows diff flow_123
 
   ${chalk.bold('Execution history:')}
-  lux flow executions my-flow-id
-  lux flow executions my-flow-id --limit 50
-  lux flow execution my-flow-id exec_abc123
-  lux flow node my-flow-id exec_abc123 node-1
+  lux flows executions my-flow-id
+  lux flows executions my-flow-id --limit 50
+  lux flows execution my-flow-id exec_abc123
+  lux flows node my-flow-id exec_abc123 node-1
 
-  ${chalk.bold('Webhook workflow:')}
-  lux flow webhook-url flow_123
-  lux flow webhook-listen flow_123
-  lux flow webhook-poll flow_123
-  lux flow webhook-accept flow_123
+  ${chalk.bold('Webhook:')}
+  lux flows webhook-url flow_123
+  lux flows webhook-listen flow_123
+  lux flows webhook-poll flow_123
+  lux flows webhook-accept flow_123
 
   ${chalk.bold('Execution debugging:')}
-  lux workflows executions my-flow       # List recent executions
-  lux workflows last my-flow             # Show last execution result
-  lux workflows test my-flow --data '{"name":"test"}'  # Test with data
+  lux flows executions my-flow       # List recent executions
+  lux flows last my-flow             # Show last execution result
+  lux flows test my-flow --data '{"name":"test"}'  # Test with data
 `);
     process.exit(0);
   }
@@ -165,14 +165,14 @@ ${chalk.bold('Examples:')}
   try {
     switch (command) {
       case 'list': {
-        info('Loading workflows from local storage...');
+        info('Loading flows from local storage...');
         const localFlows = listLocalFlows();
 
         if (localFlows.length === 0) {
-          console.log('\n(No local workflows found)');
-          console.log(chalk.gray('Run "lux workflows sync" to sync from cloud, or "lux workflows create" to create one.\n'));
+          console.log('\n(No local flows found)');
+          console.log(chalk.gray('Run "lux flows sync" to sync from cloud, or "lux flows create" to create one.\n'));
         } else {
-          console.log(`\nFound ${localFlows.length} workflow(s):\n`);
+          console.log(`\nFound ${localFlows.length} flow(s):\n`);
 
           // Color-code sync status
           const statusColors = {
@@ -203,12 +203,12 @@ ${chalk.bold('Examples:')}
       }
 
       case 'status': {
-        requireArgs(args.slice(1), 1, 'lux workflows status <id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows status <id>');
+        const flowId = args[1];
 
-        const flow = loadLocalFlow(workflowId);
+        const flow = loadLocalFlow(flowId);
         if (!flow) {
-          error(`Workflow not found locally: ${workflowId}`);
+          error(`Flow not found locally: ${flowId}`);
           break;
         }
 
@@ -231,8 +231,8 @@ ${chalk.bold('Examples:')}
           conflict: chalk.red,
         };
 
-        console.log(`\n📝 Workflow: ${flow.name}`);
-        console.log(`   ID: ${workflowId}`);
+        console.log(`\n📝 Flow: ${flow.name}`);
+        console.log(`   ID: ${flowId}`);
         console.log(`   Sync Status: ${statusColors[syncStatus](syncStatus)}`);
         console.log(`   Local Version: ${flow.localVersion || 1}`);
         console.log(`   Published Version: ${flow.publishedVersion || '(never published)'}`);
@@ -243,17 +243,17 @@ ${chalk.bold('Examples:')}
         console.log(`   Edges: ${flow.edges?.length || 0}`);
 
         if (syncStatus === 'conflict') {
-          console.log(chalk.red('\n⚠️  This workflow has conflicts with the cloud version.'));
+          console.log(chalk.red('\n⚠️  This flow has conflicts with the cloud version.'));
           console.log(chalk.gray('   Use the Lux Studio app to resolve conflicts.\n'));
         } else if (syncStatus === 'dirty') {
-          console.log(chalk.yellow('\n📤 This workflow has unpublished local changes.'));
-          console.log(chalk.gray('   Run "lux workflows publish ' + workflowId + '" to publish.\n'));
+          console.log(chalk.yellow('\n📤 This flow has unpublished local changes.'));
+          console.log(chalk.gray('   Run "lux flows publish ' + flowId + '" to publish.\n'));
         }
         break;
       }
 
       case 'sync': {
-        info('Syncing workflows from cloud...');
+        info('Syncing flows from cloud...');
 
         const { data } = await axios.get(`${apiUrl}/api/workflows?include_config=true`, {
           headers: getAuthHeaders(),
@@ -357,18 +357,18 @@ ${chalk.bold('Examples:')}
         console.log(`   New from cloud: ${newFromCloud}`);
         if (conflicts > 0) {
           console.log(chalk.red(`   Conflicts: ${conflicts}`));
-          console.log(chalk.gray('\n   Use "lux workflows list" to see workflows with conflicts.'));
+          console.log(chalk.gray('\n   Use "lux flows list" to see flows with conflicts.'));
         }
         break;
       }
 
       case 'delete': {
-        requireArgs(args.slice(1), 1, 'lux workflows delete <id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows delete <id>');
+        const flowId = args[1];
 
-        const flow = loadLocalFlow(workflowId);
+        const flow = loadLocalFlow(flowId);
         if (!flow) {
-          error(`Workflow not found locally: ${workflowId}`);
+          error(`Flow not found locally: ${flowId}`);
           break;
         }
 
@@ -377,23 +377,23 @@ ${chalk.bold('Examples:')}
           console.log(chalk.gray('   This only deletes the local copy. The published version remains in the cloud.\n'));
         }
 
-        deleteLocalFlow(workflowId);
-        success(`Deleted local workflow: ${flow.name}`);
+        deleteLocalFlow(flowId);
+        success(`Deleted local flow: ${flow.name}`);
         break;
       }
 
       case 'get': {
-        requireArgs(args.slice(1), 1, 'lux workflows get <id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows get <id>');
+        const flowId = args[1];
 
-        info(`Loading workflow: ${workflowId}`);
+        info(`Loading flow: ${flowId}`);
         const { data } = await axios.get(
-          `${apiUrl}/api/workflows/${workflowId}`,
+          `${apiUrl}/api/workflows/${flowId}`,
           { headers: getAuthHeaders() }
         );
 
         if (!data.workflow) {
-          error(`Workflow not found: ${workflowId}`);
+          error(`Flow not found: ${flowId}`);
         }
 
         const workflow = data.workflow;
@@ -421,7 +421,7 @@ ${chalk.bold('Examples:')}
           args.splice(publishFlagIndex, 1); // Remove flag from args
         }
 
-        requireArgs(args.slice(1), 1, 'lux workflows create <name> [description] [--publish]');
+        requireArgs(args.slice(1), 1, 'lux flows create <name> [description] [--publish]');
         const name = args[1];
         const description = args[2] || '';
 
@@ -454,15 +454,15 @@ ${chalk.bold('Examples:')}
           updatedAt: now,
         };
 
-        info(`Creating local workflow: ${name}`);
+        info(`Creating local flow: ${name}`);
 
         if (saveLocalFlow(flowId, newFlow)) {
-          success(`Workflow created locally!`);
+          success(`Flow created locally!`);
           console.log(`   ID: ${flowId}`);
 
           // If --publish flag was provided, publish immediately
           if (shouldPublish) {
-            info(`Publishing workflow to cloud...`);
+            info(`Publishing flow to cloud...`);
 
             try {
               const publishConfig = {
@@ -485,7 +485,7 @@ ${chalk.bold('Examples:')}
 
               const cloudId = createResponse.data.workflow?.id || createResponse.data.workflow?.workflow_id;
               if (!cloudId) {
-                throw new Error('No workflow ID returned from cloud');
+                throw new Error('No flow ID returned from cloud');
               }
 
               info(`Created in cloud with ID: ${cloudId}`);
@@ -518,41 +518,41 @@ ${chalk.bold('Examples:')}
               };
               saveLocalFlow(flowId, updatedFlow);
 
-              success('Workflow published!');
+              success('Flow published!');
               console.log(`   Cloud ID: ${cloudId}`);
               console.log(`   Status: ${chalk.green('published')}`);
               console.log(`   Version: ${newVersion}`);
             } catch (publishError) {
               error(`Failed to publish: ${publishError.response?.data?.error || publishError.message}`);
               console.log(`   Status: ${chalk.gray('draft')}`);
-              console.log(chalk.gray(`\nRun "lux workflows publish ${flowId}" to try again.`));
+              console.log(chalk.gray(`\nRun "lux flows publish ${flowId}" to try again.`));
             }
           } else {
             console.log(`   Status: ${chalk.gray('draft')}`);
-            console.log(chalk.gray(`\n   This workflow is local only. Run "lux workflows publish ${flowId}" to publish to cloud.`));
+            console.log(chalk.gray(`\n   This flow is local only. Run "lux flows publish ${flowId}" to publish to cloud.`));
           }
         } else {
-          error('Failed to create workflow. Make sure you are authenticated.');
+          error('Failed to create flow. Make sure you are authenticated.');
         }
         break;
       }
 
       case 'save': {
-        requireArgs(args.slice(1), 2, 'lux workflows save <id> <config-file>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 2, 'lux flows save <id> <config-file>');
+        const flowId = args[1];
         const configFile = args[2];
 
         // Load existing local flow
-        const existingFlow = loadLocalFlow(workflowId);
+        const existingFlow = loadLocalFlow(flowId);
         if (!existingFlow) {
-          error(`Workflow not found locally: ${workflowId}`);
-          console.log(chalk.gray('Run "lux workflows sync" to sync from cloud first.'));
+          error(`Flow not found locally: ${flowId}`);
+          console.log(chalk.gray('Run "lux flows sync" to sync from cloud first.'));
           break;
         }
 
         info(`Reading config from: ${configFile}`);
         const configJson = readFile(configFile);
-        const config = parseJson(configJson, 'workflow config');
+        const config = parseJson(configJson, 'flow config');
 
         // Update local flow with new config
         const updatedFlow = {
@@ -563,9 +563,9 @@ ${chalk.bold('Examples:')}
           updatedAt: new Date().toISOString(),
         };
 
-        info(`Saving to local storage: ${workflowId}`);
-        if (saveLocalFlow(workflowId, updatedFlow)) {
-          success('Workflow saved locally!');
+        info(`Saving to local storage: ${flowId}`);
+        if (saveLocalFlow(flowId, updatedFlow)) {
+          success('Flow saved locally!');
           console.log(`   Local Version: ${updatedFlow.localVersion}`);
 
           // Show sync status
@@ -576,22 +576,22 @@ ${chalk.bold('Examples:')}
             console.log(`   Status: ${chalk.yellow('dirty')} (has unpublished changes)`);
           }
 
-          console.log(chalk.gray(`\nRun "lux workflows publish ${workflowId}" to publish to cloud.`));
+          console.log(chalk.gray(`\nRun "lux flows publish ${flowId}" to publish to cloud.`));
         } else {
-          error('Failed to save workflow locally.');
+          error('Failed to save flow locally.');
         }
         break;
       }
 
       case 'publish': {
-        requireArgs(args.slice(1), 1, 'lux workflows publish <id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows publish <id>');
+        const flowId = args[1];
 
         // Load local flow
-        const localFlow = loadLocalFlow(workflowId);
+        const localFlow = loadLocalFlow(flowId);
         if (!localFlow) {
-          error(`Workflow not found locally: ${workflowId}`);
-          console.log(chalk.gray('Run "lux workflows sync" to sync from cloud first.'));
+          error(`Flow not found locally: ${flowId}`);
+          console.log(chalk.gray('Run "lux flows sync" to sync from cloud first.'));
           break;
         }
 
@@ -599,12 +599,12 @@ ${chalk.bold('Examples:')}
         if (localFlow.cloudVersion && localFlow.publishedVersion &&
             localFlow.cloudVersion > localFlow.publishedVersion &&
             localFlow.localVersion > localFlow.publishedVersion) {
-          error('Cannot publish: workflow has conflicts with cloud version.');
+          error('Cannot publish: flow has conflicts with cloud version.');
           console.log(chalk.gray('Resolve conflicts in Lux Studio first.'));
           break;
         }
 
-        info(`Publishing workflow: ${workflowId}`);
+        info(`Publishing flow: ${flowId}`);
 
         // Publish directly to cloud with config in request body
         const publishConfig = {
@@ -615,7 +615,7 @@ ${chalk.bold('Examples:')}
         };
 
         const { data } = await axios.post(
-          `${apiUrl}/api/workflows/${workflowId}/publish`,
+          `${apiUrl}/api/workflows/${flowId}/publish`,
           {
             name: localFlow.name,
             description: localFlow.description,
@@ -643,9 +643,9 @@ ${chalk.bold('Examples:')}
           cloudPublishedAt: now,
           cloudStatus: 'published',
         };
-        saveLocalFlow(workflowId, updatedFlow);
+        saveLocalFlow(flowId, updatedFlow);
 
-        success('Workflow published!');
+        success('Flow published!');
         console.log(`   Name: ${localFlow.name}`);
         console.log(`   Version: ${newVersion}`);
         console.log(`   Status: ${chalk.green('synced')}`);
@@ -653,17 +653,17 @@ ${chalk.bold('Examples:')}
       }
 
       case 'diff': {
-        requireArgs(args.slice(1), 1, 'lux workflows diff <id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows diff <id>');
+        const flowId = args[1];
 
         // Load local flow
-        const localFlow = loadLocalFlow(workflowId);
+        const localFlow = loadLocalFlow(flowId);
         if (!localFlow) {
-          error(`Workflow not found locally: ${workflowId}`);
+          error(`Flow not found locally: ${flowId}`);
           break;
         }
 
-        info(`Comparing local vs published for: ${workflowId}`);
+        info(`Comparing local vs published for: ${flowId}`);
 
         const localConfig = {
           nodes: localFlow.nodes || [],
@@ -672,12 +672,12 @@ ${chalk.bold('Examples:')}
 
         // Check if never published
         if (!localFlow.publishedVersion) {
-          console.log('\n📝 NEW WORKFLOW (not yet published)\n');
+          console.log('\n📝 NEW FLOW (not yet published)\n');
           console.log(`   Name: ${localFlow.name}`);
           console.log(`   Local Version: ${localFlow.localVersion || 1}`);
           console.log(`   Nodes: ${localConfig.nodes.length}`);
           console.log(`   Edges: ${localConfig.edges.length}`);
-          console.log(chalk.gray(`\nRun "lux workflows publish ${workflowId}" to publish.\n`));
+          console.log(chalk.gray(`\nRun "lux flows publish ${flowId}" to publish.\n`));
           break;
         }
 
@@ -709,17 +709,17 @@ ${chalk.bold('Examples:')}
           console.log(`   Published Version: ${localFlow.publishedVersion}`);
           console.log(`   Nodes: ${localConfig.nodes.length}`);
           console.log(`   Edges: ${localConfig.edges.length}`);
-          console.log(chalk.gray(`\nRun "lux workflows publish ${workflowId}" to publish changes.\n`));
+          console.log(chalk.gray(`\nRun "lux flows publish ${flowId}" to publish changes.\n`));
         }
         break;
       }
 
       case 'webhook-url': {
-        requireArgs(args.slice(1), 1, 'lux flow webhook-url <flow-id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows webhook-url <flow-id>');
+        const flowId = args[1];
 
-        info(`Getting webhook URL for: ${workflowId}`);
-        const tokenData = await getWebhookToken(workflowId);
+        info(`Getting webhook URL for: ${flowId}`);
+        const tokenData = await getWebhookToken(flowId);
 
         console.log(`\n📍 Webhook URL:\n${tokenData.webhookUrl}\n`);
         console.log(`📊 Status:`);
@@ -727,17 +727,17 @@ ${chalk.bold('Examples:')}
         console.log(`   Webhook Trigger Enabled: ${tokenData.webhookTrigger ? '✅ Yes' : '❌ No'}\n`);
 
         if (!tokenData.formatConfirmed) {
-          console.log(chalk.yellow('ℹ️  Run "lux flow webhook-listen" to capture a sample webhook'));
+          console.log(chalk.yellow('ℹ️  Run "lux flows webhook-listen" to capture a sample webhook'));
         }
         break;
       }
 
       case 'webhook-listen': {
-        requireArgs(args.slice(1), 1, 'lux flow webhook-listen <flow-id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows webhook-listen <flow-id>');
+        const flowId = args[1];
 
-        info(`Starting webhook listening session for: ${workflowId}`);
-        const tokenData = await getWebhookToken(workflowId);
+        info(`Starting webhook listening session for: ${flowId}`);
+        const tokenData = await getWebhookToken(flowId);
 
         // Start listening session
         await axios.post(`${WEBHOOK_WORKER_URL}/listening/start/${tokenData.token}`);
@@ -746,15 +746,15 @@ ${chalk.bold('Examples:')}
         console.log(`\n📡 Now listening for webhooks at:\n${tokenData.webhookUrl}\n`);
         console.log('Session expires in 5 minutes.');
         console.log(`\nSend a webhook request to the URL above, then run:`);
-        console.log(chalk.white(`   lux flow webhook-poll ${workflowId}\n`));
+        console.log(chalk.white(`   lux flows webhook-poll ${flowId}\n`));
         break;
       }
 
       case 'webhook-poll': {
-        requireArgs(args.slice(1), 1, 'lux flow webhook-poll <flow-id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows webhook-poll <flow-id>');
+        const flowId = args[1];
 
-        const tokenData = await getWebhookToken(workflowId);
+        const tokenData = await getWebhookToken(flowId);
         const pollData = await getCapturedPayload(tokenData.token);
 
         // Return raw JSON response
@@ -763,20 +763,20 @@ ${chalk.bold('Examples:')}
       }
 
       case 'webhook-accept': {
-        requireArgs(args.slice(1), 1, 'lux flow webhook-accept <flow-id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows webhook-accept <flow-id>');
+        const flowId = args[1];
 
-        info(`Accepting webhook format for: ${workflowId}`);
+        info(`Accepting webhook format for: ${flowId}`);
 
         // Step 1: Get webhook token
-        const tokenData = await getWebhookToken(workflowId);
+        const tokenData = await getWebhookToken(flowId);
 
         // Step 2: Poll for captured payload
         const pollData = await getCapturedPayload(tokenData.token);
 
         // Check if payload was captured
         if (pollData.waiting || !pollData.payload) {
-          error('No webhook captured. Run "lux flow webhook-listen" first and send a test webhook.');
+          error('No webhook captured. Run "lux flows webhook-listen" first and send a test webhook.');
           break;
         }
 
@@ -851,11 +851,11 @@ ${chalk.bold('Examples:')}
       }
 
       case 'webhook-decline': {
-        requireArgs(args.slice(1), 1, 'lux flow webhook-decline <flow-id>');
-        const workflowId = args[1];
+        requireArgs(args.slice(1), 1, 'lux flows webhook-decline <flow-id>');
+        const flowId = args[1];
 
-        info(`Declining webhook format for: ${workflowId}`);
-        const tokenData = await getWebhookToken(workflowId);
+        info(`Declining webhook format for: ${flowId}`);
+        const tokenData = await getWebhookToken(flowId);
 
         // Clear webhook schema from database
         info('Clearing webhook schema...');
@@ -870,14 +870,14 @@ ${chalk.bold('Examples:')}
         success('Webhook format declined!');
         console.log('\n✅ Schema cleared from database');
         console.log('✅ Listening session has been reset');
-        console.log(`\nRun "lux flow webhook-listen ${workflowId}" to try again.\n`);
+        console.log(`\nRun "lux flows webhook-listen ${flowId}" to try again.\n`);
         break;
       }
 
       // ============ EXECUTION HISTORY COMMANDS ============
 
       case 'executions': {
-        requireArgs(args.slice(1), 1, 'lux workflows executions <flow-id> [--limit N]');
+        requireArgs(args.slice(1), 1, 'lux flows executions <flow-id> [--limit N]');
         const flowId = args[1];
 
         // Parse --limit flag
@@ -912,7 +912,7 @@ ${chalk.bold('Examples:')}
 
         if (executions.length === 0) {
           console.log('\n(No executions found for this flow)');
-          console.log(chalk.gray('Run the flow from the interface or use "lux workflows test" to create an execution.\n'));
+          console.log(chalk.gray('Run the flow from the interface or use "lux flows test" to create an execution.\n'));
           break;
         }
 
@@ -954,12 +954,12 @@ ${chalk.bold('Examples:')}
           console.log(chalk.dim(`Use --limit N to see more.\n`));
         }
 
-        console.log(chalk.gray(`\nTo see full details: lux workflows execution ${flowId} <execution-id>\n`));
+        console.log(chalk.gray(`\nTo see full details: lux flows execution ${flowId} <execution-id>\n`));
         break;
       }
 
       case 'execution': {
-        requireArgs(args.slice(1), 2, 'lux workflows execution <flow-id> <execution-id>');
+        requireArgs(args.slice(1), 2, 'lux flows execution <flow-id> <execution-id>');
         const flowId = args[1];
         const executionId = args[2];
         const jsonOutput = args.includes('--json');
@@ -1056,14 +1056,14 @@ ${chalk.bold('Examples:')}
 
           formatTable(nodeFormatted);
 
-          console.log(chalk.gray(`\nTo see node details: lux workflows node ${flowId} ${executionId} <node-id>\n`));
+          console.log(chalk.gray(`\nTo see node details: lux flows node ${flowId} ${executionId} <node-id>\n`));
         }
 
         break;
       }
 
       case 'node': {
-        requireArgs(args.slice(1), 3, 'lux workflows node <flow-id> <execution-id> <node-id>');
+        requireArgs(args.slice(1), 3, 'lux flows node <flow-id> <execution-id> <node-id>');
         const flowId = args[1];
         const executionId = args[2];
         const nodeId = args[3];
@@ -1163,7 +1163,7 @@ ${chalk.bold('Examples:')}
       }
 
       case 'last': {
-        requireArgs(args.slice(1), 1, 'lux workflows last <flow-id>');
+        requireArgs(args.slice(1), 1, 'lux flows last <flow-id>');
         const flowId = args[1];
         const jsonOutput = args.includes('--json');
 
@@ -1188,7 +1188,7 @@ ${chalk.bold('Examples:')}
         const executions = listData.executions || [];
         if (executions.length === 0) {
           console.log('\n(No executions found for this flow)');
-          console.log(chalk.gray('Run the flow from the interface or use "lux workflows test" to create an execution.\n'));
+          console.log(chalk.gray('Run the flow from the interface or use "lux flows test" to create an execution.\n'));
           break;
         }
 
@@ -1259,7 +1259,7 @@ ${chalk.bold('Examples:')}
       }
 
       case 'test': {
-        requireArgs(args.slice(1), 1, 'lux workflows test <flow-id> [--data <json>] [--data-file <path>]');
+        requireArgs(args.slice(1), 1, 'lux flows test <flow-id> [--data <json>] [--data-file <path>]');
         const flowId = args[1];
         const jsonOutput = args.includes('--json');
 
@@ -1285,7 +1285,7 @@ ${chalk.bold('Examples:')}
         const flowData = loadLocalFlow(flowId);
         if (!flowData) {
           error(`Flow not found locally: ${flowId}`);
-          console.log(chalk.gray('Run "lux workflows sync" to sync from cloud first.'));
+          console.log(chalk.gray('Run "lux flows sync" to sync from cloud first.'));
           break;
         }
 
@@ -1363,7 +1363,7 @@ ${chalk.bold('Examples:')}
 
       default:
         error(
-          `Unknown command: ${command}\n\nRun 'lux workflows' to see available commands`
+          `Unknown command: ${command}\n\nRun 'lux flows' to see available commands`
         );
     }
   } catch (err) {
@@ -1373,4 +1373,4 @@ ${chalk.bold('Examples:')}
   }
 }
 
-module.exports = { handleWorkflows };
+module.exports = { handleFlows };

package/lux.js

@@ -11,7 +11,7 @@ const { dev } = require('./commands/dev');
 const { handleInterface } = require('./commands/interface');
 const { handleData } = require('./commands/data');
 const { handleStorage } = require('./commands/storage');
-const { handleWorkflows } = require('./commands/workflows');
+const { handleFlows } = require('./commands/flows');
 const { handleSecrets } = require('./commands/secrets');
 const { handleAgents } = require('./commands/agents');
 const { handleKnowledge } = require('./commands/knowledge');
@@ -96,14 +96,14 @@ program
     handleStorage(subcommand ? [subcommand, ...(args || [])] : []);
   });
 
-// Workflows commands (with short aliases 'flow' and 'f')
+// Flows commands (with short alias 'f')
 program
-  .command('workflows [subcommand] [args...]')
-  .aliases(['flow', 'f'])
-  .description('Workflow management (list, get, create/init, save, publish, diff)')
+  .command('flows [subcommand] [args...]')
+  .alias('f')
+  .description('Flow management (list, get, create/init, save, publish, diff)')
   .allowUnknownOption()
   .action((subcommand, args) => {
-    handleWorkflows(subcommand ? [subcommand, ...(args || [])] : []);
+    handleFlows(subcommand ? [subcommand, ...(args || [])] : []);
   });
 
 // Secrets commands

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "luxlabs",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "description": "CLI tool for Lux - Upload and deploy interfaces from your terminal",
   "author": "Jason Henkel <jason@uselux.ai>",
   "license": "SEE LICENSE IN LICENSE",
@@ -24,7 +24,7 @@
     "deploy",
     "interfaces",
     "ai",
-    "workflows",
+    "flows",
     "agents"
   ],
   "repository": {