feat(gateway): mask internal backend URL in command outputs for improved user experience

Author: Lasim

services/gateway/src/commands/mcp.ts

@@ -10,6 +10,7 @@ import { TableFormatter } from '../utils/table';
 import { AuthenticationError } from '../types/auth';
 import { RefreshService } from '../services/refresh-service';
 import { ConfigurationChangeService } from '../services/configuration-change-service';
+import { displayBackendUrl } from '../utils/display';
 
 // PID file location
 const PID_FILE = path.join(os.tmpdir(), 'deploystack-gateway.pid');
@@ -222,7 +223,7 @@ export function registerMCPCommand(program: Command) {
 
         console.log(chalk.blue(`🤖 MCP Configuration Status`));
         console.log(chalk.gray(`🎯 Current team: ${chalk.cyan(credentials.selectedTeam.name)}`));
-        console.log(chalk.gray(` Backend: ${backendUrl}\n`));
+        console.log(chalk.gray(` Backend: ${displayBackendUrl(backendUrl)}\n`));
 
         spinner = ora('Checking MCP configuration...').start();
 

services/gateway/src/commands/teams.ts

@@ -6,6 +6,7 @@ import { MCPConfigService } from '../core/mcp';
 import { TableFormatter } from '../utils/table';
 import { ToolDiscoveryManager } from '../utils/tool-discovery-manager';
 import { AuthenticationError } from '../types/auth';
+import { displayBackendUrl } from '../utils/display';
 
 export function registerTeamsCommand(program: Command) {
   program
@@ -71,23 +72,23 @@ export function registerTeamsCommand(program: Command) {
               continueOnError: true
             });
 
-            console.log(chalk.gray(`🌐 Using backend: ${backendUrl}`));
+            console.log(chalk.gray(`🌐 Using backend: ${displayBackendUrl(backendUrl)}`));
           } catch (mcpError) {
             // Team switch succeeded but MCP config failed - still show success but warn about MCP
             console.log(chalk.green(`✅ Switched to team: ${chalk.cyan(teamToSwitch.name)} (#${teamNumber})`));
             console.log(chalk.yellow('⚠️  Could not download MCP configurations for new team'));
             if (mcpError instanceof Error) {
               console.log(chalk.gray(`   MCP Error: ${mcpError.message}`));
             }
-            console.log(chalk.gray(`🌐 Using backend: ${backendUrl}`));
+            console.log(chalk.gray(`🌐 Using backend: ${displayBackendUrl(backendUrl)}`));
           }
           return;
         }
 
         if (teams.length === 0) {
           console.log(chalk.yellow('📭 You are not a member of any teams'));
           console.log(chalk.gray('💡 Contact your administrator to be added to a team'));
-          console.log(chalk.gray(`🌐 Using backend: ${backendUrl}`));
+          console.log(chalk.gray(`🌐 Using backend: ${displayBackendUrl(backendUrl)}`));
           return;
         }
 
@@ -101,7 +102,7 @@ export function registerTeamsCommand(program: Command) {
           console.log(chalk.yellow('⚠️  No team selected - use --switch <team-number> to select one'));
         }
 
-        console.log(chalk.gray(`🌐 Using backend: ${backendUrl}\n`));
+        console.log(chalk.gray(`🌐 Using backend: ${displayBackendUrl(backendUrl)}\n`));
 
         // Create table
         const table = TableFormatter.createTable({

services/gateway/src/commands/whoami.ts

@@ -5,6 +5,7 @@ import { DeployStackAPI } from '../core/auth/api-client';
 import { TableFormatter } from '../utils/table';
 import { SCOPE_DESCRIPTIONS } from '../utils/auth-config';
 import { AuthenticationError } from '../types/auth';
+import { displayBackendUrl } from '../utils/display';
 
 export function registerWhoamiCommand(program: Command) {
   program
@@ -51,7 +52,7 @@ export function registerWhoamiCommand(program: Command) {
           console.log(chalk.gray(`🏷️  Username: ${userInfo.preferred_username}`));
         }
         console.log(chalk.gray(`✅ Email Verified: ${userInfo.email_verified ? 'Yes' : 'No'}`));
-        console.log(chalk.gray(`🌐 Using backend: ${backendUrl}\n`));
+        console.log(chalk.gray(`🌐 Using backend: ${displayBackendUrl(backendUrl)}\n`));
 
         // Display account info in table format if accounts exist
         if (accounts.length > 0) {

services/gateway/src/utils/display.ts

@@ -0,0 +1,17 @@
+/**
+ * Utility functions for displaying information to users
+ */
+
+/**
+ * Masks the internal backend URL for better user experience
+ * Only masks the default DeployStack backend, preserves custom backends as-is
+ * 
+ * @param backendUrl - The actual backend URL used for API calls
+ * @returns The URL to display to the user
+ */
+export function displayBackendUrl(backendUrl: string): string {
+  if (backendUrl === 'https://cloud-api.deploystack.io') {
+    return 'https://cloud.deploystack.io';
+  }
+  return backendUrl;
+}