snow-flow 4.5.46 → 4.5.47

package/README.md

@@ -9,6 +9,11 @@
 
 ---
 
+TO FIX TEMP CLAUDE CODE INK ERROR, RUN BEFORE SWARM COMMAND: 
+```bash
+npm install -g @anthropic-ai/claude-code@1.0.95 --save-exact
+```
+
 ## What is Snow-Flow?
 
 Snow-Flow is a conversational ServiceNow development platform that bridges Claude Code with ServiceNow through specialized MCP (Model Context Protocol) servers. Instead of navigating ServiceNow's web interface, you develop through natural conversation with Claude Code, which orchestrates multi-agent workflows to handle complex ServiceNow operations.
@@ -310,4 +315,4 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ---
 
-**Snow-Flow: Conversational ServiceNow development through Claude Code.**
+**Snow-Flow: Conversational ServiceNow development through Claude Code.**

package/dist/mcp/servicenow-flow-workspace-mobile-mcp.js

@@ -2582,6 +2582,15 @@ ${configList}${layoutsText}${offlineText}
     async snow_create_ux_experience(args) {
         try {
             this.logger.info(`Creating UX Experience: ${args.name}`);
+            // Test mode validation - reject fake test data
+            if (args.name && (args.name.toLowerCase().includes('test') || args.name === 'Test Experience')) {
+                return {
+                    success: false,
+                    error: 'Test mode detected. This tool requires a real workspace name.',
+                    suggestion: 'Use a realistic workspace name like "IT Support Workspace" or "Customer Service Hub"',
+                    test_mode: true
+                };
+            }
             // Find default shell macroponent - usually x_snc_app_shell_uib_app_shell
             const shellQuery = await this.client.searchRecords('sys_ux_macroponent', 'name=x_snc_app_shell_uib_app_shell');
             let shellSysId = null;
@@ -2600,8 +2609,19 @@ ${configList}${layoutsText}${offlineText}
                 root_macroponent: shellSysId,
                 description: args.description || `Experience for ${args.name}`
             };
+            // Check if UX framework is available
+            const uxCheck = await this.client.searchRecords('sys_ux_experience', '', 1);
+            if (!uxCheck.success) {
+                return {
+                    success: false,
+                    error: 'Now Experience Framework (UXF) is not available in this ServiceNow instance.',
+                    suggestion: 'UX Workspace creation requires the Now Experience Framework plugin. Contact your ServiceNow administrator.',
+                    plugin_required: 'Now Experience Framework (UXF)',
+                    licensing_note: 'UXF may require additional ServiceNow licensing'
+                };
+            }
             const result = await this.client.createRecord('sys_ux_experience', experienceData);
-            if (result.success) {
+            if (result.success && result.data && result.data.result && result.data.result.sys_id) {
                 this.logger.info(`✅ UX Experience created with sys_id: ${result.data.result.sys_id}`);
                 return {
                     success: true,
@@ -2611,7 +2631,8 @@ ${configList}${layoutsText}${offlineText}
                 };
             }
             else {
-                throw new Error(`Failed to create experience: ${result.data.error}`);
+                const error = (result.data && result.data.error) || (result.error) || 'Unknown error creating experience';
+                throw new Error(`Failed to create experience: ${error}`);
             }
         }
         catch (error) {
@@ -2626,10 +2647,23 @@ ${configList}${layoutsText}${offlineText}
     async snow_create_ux_app_config(args) {
         try {
             this.logger.info(`Creating UX App Config: ${args.name}`);
+            // Validate experience_sys_id format
+            if (!args.experience_sys_id || args.experience_sys_id.length !== 32) {
+                return {
+                    success: false,
+                    error: `Invalid experience_sys_id: '${args.experience_sys_id}'. Must be a valid 32-character ServiceNow sys_id.`,
+                    suggestion: 'Use the sys_id returned from snow_create_ux_experience (Step 1)',
+                    validation_error: true
+                };
+            }
             // Validate experience exists
             const experienceCheck = await this.client.getRecord('sys_ux_experience', args.experience_sys_id);
             if (!experienceCheck.success) {
-                throw new Error(`Experience with sys_id ${args.experience_sys_id} not found`);
+                return {
+                    success: false,
+                    error: `Experience with sys_id ${args.experience_sys_id} not found. Please create the experience first using snow_create_ux_experience.`,
+                    suggestion: 'Run Step 1: snow_create_ux_experience before creating app config'
+                };
             }
             // Create app config record
             const configData = {
@@ -2639,7 +2673,7 @@ ${configList}${layoutsText}${offlineText}
                 // landing_page_route will be set in Step 6
             };
             const result = await this.client.createRecord('sys_ux_app_config', configData);
-            if (result.success) {
+            if (result.success && result.data && result.data.result && result.data.result.sys_id) {
                 this.logger.info(`✅ UX App Config created with sys_id: ${result.data.result.sys_id}`);
                 return {
                     success: true,
@@ -2649,7 +2683,8 @@ ${configList}${layoutsText}${offlineText}
                 };
             }
             else {
-                throw new Error(`Failed to create app config: ${result.data.error}`);
+                const error = (result.data && result.data.error) || (result.error) || 'Unknown error creating app config';
+                throw new Error(`Failed to create app config: ${error}`);
             }
         }
         catch (error) {
@@ -2680,7 +2715,7 @@ ${configList}${layoutsText}${offlineText}
                 description: args.description || `Page macroponent for ${args.name}`
             };
             const result = await this.client.createRecord('sys_ux_macroponent', macroponentData);
-            if (result.success) {
+            if (result.success && result.data && result.data.result && result.data.result.sys_id) {
                 this.logger.info(`✅ UX Page Macroponent created with sys_id: ${result.data.result.sys_id}`);
                 return {
                     success: true,
@@ -2690,7 +2725,8 @@ ${configList}${layoutsText}${offlineText}
                 };
             }
             else {
-                throw new Error(`Failed to create page macroponent: ${result.data.error}`);
+                const error = (result.data && result.data.error) || (result.error) || 'Unknown error creating page macroponent';
+                throw new Error(`Failed to create page macroponent: ${error}`);
             }
         }
         catch (error) {
@@ -2708,11 +2744,19 @@ ${configList}${layoutsText}${offlineText}
             // Validate app config and macroponent exist
             const configCheck = await this.client.getRecord('sys_ux_app_config', args.app_config_sys_id);
             if (!configCheck.success) {
-                throw new Error(`App Config with sys_id ${args.app_config_sys_id} not found`);
+                return {
+                    success: false,
+                    error: `App Config with sys_id ${args.app_config_sys_id} not found. Please create the app config first using snow_create_ux_app_config.`,
+                    suggestion: 'Run Step 2: snow_create_ux_app_config before creating page registry'
+                };
             }
             const macroponentCheck = await this.client.getRecord('sys_ux_macroponent', args.macroponent_sys_id);
             if (!macroponentCheck.success) {
-                throw new Error(`Macroponent with sys_id ${args.macroponent_sys_id} not found`);
+                return {
+                    success: false,
+                    error: `Macroponent with sys_id ${args.macroponent_sys_id} not found. Please create the macroponent first using snow_create_ux_page_macroponent.`,
+                    suggestion: 'Run Step 3: snow_create_ux_page_macroponent before creating page registry'
+                };
             }
             // Create page registry record
             const registryData = {
@@ -2722,7 +2766,7 @@ ${configList}${layoutsText}${offlineText}
                 description: args.description || `Page registry for ${args.sys_name}`
             };
             const result = await this.client.createRecord('sys_ux_page_registry', registryData);
-            if (result.success) {
+            if (result.success && result.data && result.data.result && result.data.result.sys_id) {
                 this.logger.info(`✅ UX Page Registry created with sys_id: ${result.data.result.sys_id}`);
                 return {
                     success: true,
@@ -2733,7 +2777,8 @@ ${configList}${layoutsText}${offlineText}
                 };
             }
             else {
-                throw new Error(`Failed to create page registry: ${result.data.error}`);
+                const error = (result.data && result.data.error) || (result.error) || 'Unknown error creating page registry';
+                throw new Error(`Failed to create page registry: ${error}`);
             }
         }
         catch (error) {
@@ -2751,7 +2796,11 @@ ${configList}${layoutsText}${offlineText}
             // Validate app config exists
             const configCheck = await this.client.getRecord('sys_ux_app_config', args.app_config_sys_id);
             if (!configCheck.success) {
-                throw new Error(`App Config with sys_id ${args.app_config_sys_id} not found`);
+                return {
+                    success: false,
+                    error: `App Config with sys_id ${args.app_config_sys_id} not found. Please create the app config first using snow_create_ux_app_config.`,
+                    suggestion: 'Run Step 2: snow_create_ux_app_config before creating route'
+                };
             }
             // Create route record
             const routeData = {
@@ -2762,7 +2811,7 @@ ${configList}${layoutsText}${offlineText}
                 description: args.description || `Route for page ${args.page_sys_name}`
             };
             const result = await this.client.createRecord('sys_ux_app_route', routeData);
-            if (result.success) {
+            if (result.success && result.data && result.data.result && result.data.result.sys_id) {
                 this.logger.info(`✅ UX App Route created with sys_id: ${result.data.result.sys_id}`);
                 return {
                     success: true,
@@ -2774,7 +2823,8 @@ ${configList}${layoutsText}${offlineText}
                 };
             }
             else {
-                throw new Error(`Failed to create app route: ${result.data.error}`);
+                const error = (result.data && result.data.error) || (result.error) || 'Unknown error creating app route';
+                throw new Error(`Failed to create app route: ${error}`);
             }
         }
         catch (error) {
@@ -2804,7 +2854,8 @@ ${configList}${layoutsText}${offlineText}
                 };
             }
             else {
-                throw new Error(`Failed to update app config: ${result.data.error}`);
+                const error = (result.data && result.data.error) || (result.error) || 'Unknown error updating app config';
+                throw new Error(`Failed to update app config: ${error}`);
             }
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "4.5.46",
+  "version": "4.5.47",
   "description": "Conversational ServiceNow development platform using Claude Code. Multi-agent orchestration with 20+ MCP servers providing 240+ ServiceNow tools including complete 6-step UX Workspace creation workflow.",
   "main": "dist/index.js",
   "type": "commonjs",