snow-flow 3.4.29 → 3.4.30

package/dist/cli.js

@@ -123,9 +123,60 @@ program
     .option('--auto-confirm', 'Auto-confirm background script executions (bypasses human-in-the-loop)')
     .option('--no-auto-confirm', 'Force confirmation for all background scripts (default behavior)')
     .option('--verbose', 'Show detailed execution information')
+    .option('--debug', 'Enable debug mode (sets LOG_LEVEL=debug)')
+    .option('--trace', 'Enable trace mode (MAXIMUM debug output - sets LOG_LEVEL=trace)')
+    .option('--debug-mcp', 'Enable MCP server debug output')
+    .option('--debug-http', 'Enable HTTP request/response debugging')
+    .option('--debug-memory', 'Enable memory operation debugging')
+    .option('--debug-servicenow', 'Enable ServiceNow API debugging')
+    .option('--debug-all', 'Enable ALL debug output (WARNING: Very verbose!)')
     .action(async (objective, options) => {
     // Check for flow deprecation first
     checkFlowDeprecation('swarm', objective);
+    // Set debug levels based on options
+    if (options.debugAll) {
+        process.env.DEBUG = '*';
+        process.env.LOG_LEVEL = 'trace';
+        process.env.SNOW_FLOW_DEBUG = 'true';
+        process.env.MCP_DEBUG = 'true';
+        process.env.MCP_LOG_LEVEL = 'trace';
+        process.env.HTTP_TRACE = 'true';
+        process.env.VERBOSE = 'true';
+        cliLogger.info('🔍 DEBUG MODE: ALL (Maximum verbosity enabled!)');
+    }
+    else {
+        if (options.trace) {
+            process.env.LOG_LEVEL = 'trace';
+            process.env.SNOW_FLOW_TRACE = 'true';
+            cliLogger.info('🔍 TRACE MODE: Enabled (Maximum detail level)');
+        }
+        else if (options.debug) {
+            process.env.LOG_LEVEL = 'debug';
+            process.env.SNOW_FLOW_DEBUG = 'true';
+            cliLogger.info('🔍 DEBUG MODE: Enabled');
+        }
+        if (options.debugMcp) {
+            process.env.MCP_DEBUG = 'true';
+            process.env.MCP_LOG_LEVEL = 'trace';
+            cliLogger.info('🔍 MCP DEBUG: Enabled');
+        }
+        if (options.debugHttp) {
+            process.env.HTTP_TRACE = 'true';
+            cliLogger.info('🔍 HTTP DEBUG: Enabled (Request/Response tracing)');
+        }
+        if (options.debugMemory) {
+            process.env.DEBUG = process.env.DEBUG ? `${process.env.DEBUG},memory:*` : 'memory:*';
+            cliLogger.info('🔍 MEMORY DEBUG: Enabled');
+        }
+        if (options.debugServicenow) {
+            process.env.DEBUG = process.env.DEBUG ? `${process.env.DEBUG},servicenow:*` : 'servicenow:*';
+            cliLogger.info('🔍 SERVICENOW DEBUG: Enabled');
+        }
+        if (options.verbose) {
+            process.env.VERBOSE = 'true';
+            cliLogger.info('🔍 VERBOSE MODE: Enabled');
+        }
+    }
     // Always show essential info
     cliLogger.info(`\n🚀 Snow-Flow v${version_js_1.VERSION}`);
     cliLogger.info(`📋 Objective: ${objective}`);
@@ -464,9 +515,25 @@ async function executeClaudeCode(prompt) {
         const claudeArgs = hasMcpConfig
             ? ['--mcp-config', '.mcp.json', '--dangerously-skip-permissions']
             : ['--dangerously-skip-permissions'];
+        // Add debug args if debug is enabled
+        if (process.env.SNOW_FLOW_DEBUG === 'true' || process.env.LOG_LEVEL === 'debug' || process.env.LOG_LEVEL === 'trace') {
+            claudeArgs.push('--verbose');
+            if (process.env.LOG_LEVEL === 'trace') {
+                claudeArgs.push('--trace');
+            }
+        }
         cliLogger.info('🚀 Launching Claude Code automatically...');
         if (hasMcpConfig) {
             cliLogger.info('🔧 Starting Claude Code with ServiceNow MCP servers...');
+            if (process.env.MCP_DEBUG === 'true') {
+                cliLogger.info('🔍 MCP Debug Mode Active - Expect detailed connection logs');
+            }
+        }
+        // Debug output if enabled
+        if (process.env.SNOW_FLOW_DEBUG === 'true' || process.env.VERBOSE === 'true') {
+            cliLogger.info(`🔍 Claude Command: claude ${claudeArgs.join(' ')}`);
+            cliLogger.info(`🔍 Working Directory: ${process.cwd()}`);
+            cliLogger.info(`🔍 MCP Config: ${mcpConfigPath}`);
         }
         // Start Claude Code process in interactive mode with stdin piping
         const claudeProcess = (0, child_process_1.spawn)('claude', claudeArgs, {
@@ -546,80 +613,6 @@ function startMonitoringDashboard(claudeProcess) {
     }, 5000); // Check every 5 seconds silently
     return monitoringInterval;
 }
-async function executeWithClaude(claudeCommand, prompt, resolve) {
-    cliLogger.info('🚀 Starting Claude Code execution...');
-    // Write prompt to temporary file for large prompts
-    const tempFile = (0, path_1.join)(process.cwd(), '.snow-flow-prompt.tmp');
-    await fs_1.promises.writeFile(tempFile, prompt);
-    // Check if .mcp.json exists in current directory
-    const mcpConfigPath = (0, path_1.join)(process.cwd(), '.mcp.json');
-    let hasMcpConfig = false;
-    try {
-        await fs_1.promises.access(mcpConfigPath);
-        hasMcpConfig = true;
-        cliLogger.info('✅ Found MCP configuration in current directory');
-    }
-    catch {
-        cliLogger.warn('⚠️  No MCP configuration found. Run "snow-flow init" to set up MCP servers');
-    }
-    const claudeArgs = hasMcpConfig
-        ? ['--mcp-config', '.mcp.json', '--dangerously-skip-permissions']
-        : ['--dangerously-skip-permissions'];
-    if (hasMcpConfig) {
-        cliLogger.info('🔧 Starting Claude Code with ServiceNow MCP servers...');
-    }
-    // Start Claude Code process in interactive mode
-    const claudeProcess = (0, child_process_1.spawn)(claudeCommand, claudeArgs, {
-        stdio: ['pipe', 'inherit', 'inherit'], // inherit stdout/stderr for interactive mode
-        cwd: process.cwd()
-    });
-    // Send the prompt via stdin
-    cliLogger.info('📝 Sending orchestration prompt to Claude Code...');
-    cliLogger.info('🚀 Claude Code interactive interface opening...\n');
-    claudeProcess.stdin.write(prompt);
-    claudeProcess.stdin.end();
-    // Start silent monitoring dashboard (doesn't interfere with Claude Code UI)
-    const monitoringInterval = startMonitoringDashboard(claudeProcess);
-    claudeProcess.on('close', (code) => {
-        clearInterval(monitoringInterval);
-        if (code === 0) {
-            cliLogger.info('\n✅ Claude Code session completed successfully!');
-            resolve(true);
-        }
-        else {
-            cliLogger.warn(`\n❌ Claude Code session ended with code: ${code}`);
-            resolve(false);
-        }
-    });
-    claudeProcess.on('error', (error) => {
-        clearInterval(monitoringInterval);
-        cliLogger.error(`❌ Failed to start Claude Code: ${error.message}`);
-        resolve(false);
-    });
-    // Set timeout for Claude Code execution (configurable via environment variable)
-    const timeoutMinutes = process.env.SNOW_FLOW_TIMEOUT_MINUTES ? parseInt(process.env.SNOW_FLOW_TIMEOUT_MINUTES) : 60;
-    const timeoutMs = timeoutMinutes * 60 * 1000;
-    cliLogger.info(`⏱️  Claude Code timeout set to ${timeoutMinutes} minutes (configure with SNOW_FLOW_TIMEOUT_MINUTES=0 for no timeout)`);
-    let timeout = null;
-    // Only set timeout if not disabled (0 = no timeout)
-    if (timeoutMinutes > 0) {
-        timeout = setTimeout(() => {
-            clearInterval(monitoringInterval);
-            cliLogger.warn(`⏱️  Claude Code session timeout (${timeoutMinutes} minutes), terminating...`);
-            claudeProcess.kill('SIGTERM');
-            // Force kill if it doesn't respond
-            setTimeout(() => {
-                claudeProcess.kill('SIGKILL');
-            }, 2000);
-            resolve(false);
-        }, timeoutMs);
-    }
-    claudeProcess.on('close', () => {
-        if (timeout) {
-            clearTimeout(timeout);
-        }
-    });
-}
 // Helper function to build Queen Agent orchestration prompt
 // Helper function to build Queen Agent orchestration prompt - CLEANED UP VERSION
 function buildQueenAgentPrompt(objective, taskAnalysis, options, isAuthenticated = false, sessionId, isFlowDesignerTask = false) {

package/dist/mcp/advanced/servicenow-advanced-features-mcp.d.ts

@@ -920,6 +920,10 @@ export declare class ServiceNowAdvancedFeaturesMCP extends BaseMCPServer {
     private generateMonitoringHtmlReport;
     private generateMetricsExport;
     private generateAlertSummary;
+    /**
+     * Run the MCP server
+     */
+    run(): Promise<void>;
 }
 export default ServiceNowAdvancedFeaturesMCP;
 //# sourceMappingURL=servicenow-advanced-features-mcp.d.ts.map

package/dist/mcp/advanced/servicenow-advanced-features-mcp.js

@@ -9,6 +9,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceNowAdvancedFeaturesMCP = void 0;
 const base_mcp_server_js_1 = require("../base-mcp-server.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const snow_memory_manager_js_1 = require("../../utils/snow-memory-manager.js");
 class ServiceNowAdvancedFeaturesMCP extends base_mcp_server_js_1.BaseMCPServer {
     constructor() {
@@ -14148,12 +14149,21 @@ function getIncidentsByUser(userSysId) {
             size: JSON.stringify(alertSummary).length
         };
     }
+    /**
+     * Run the MCP server
+     */
+    async run() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        // Use stderr for logs to keep stdout clean for JSON-RPC
+        console.error('ServiceNow Advanced Features MCP server running on stdio');
+    }
 }
 exports.ServiceNowAdvancedFeaturesMCP = ServiceNowAdvancedFeaturesMCP;
 // CLI entry point
 if (require.main === module) {
     const server = new ServiceNowAdvancedFeaturesMCP();
-    server.start().catch(console.error);
+    server.run().catch(console.error);
 }
 exports.default = ServiceNowAdvancedFeaturesMCP;
 //# sourceMappingURL=servicenow-advanced-features-mcp.js.map

package/dist/mcp/service-discovery-client.js

@@ -210,13 +210,13 @@ class ServiceDiscoveryClient {
      * COMPATIBILITY FIX: makeRequest method for phantom calls
      */
     async makeRequest(config) {
-        console.log('🔧 ServiceDiscoveryClient.makeRequest called with config:', config);
+        console.error('🔧 ServiceDiscoveryClient.makeRequest called with config:', config);
         try {
             // Route the request to the appropriate HTTP method
             const method = (config.method || 'GET').toLowerCase();
             const url = config.url || config.endpoint;
             const data = config.data || config.body;
-            console.log(`🔧 ServiceDiscovery routing ${method.toUpperCase()} request to: ${url}`);
+            console.error(`🔧 ServiceDiscovery routing ${method.toUpperCase()} request to: ${url}`);
             switch (method) {
                 case 'get':
                     return await this.client.get(url, { params: config.params });

package/dist/mcp/servicenow-deployment-mcp.js

@@ -548,7 +548,7 @@ class ServiceNowDeploymentMCP {
                 // Create the sys_update_xml record to track the artifact
                 const trackingResult = await this.client.createRecord('sys_update_xml', updateXmlData);
                 if (trackingResult.success) {
-                    console.log(`✅ Artifact tracked in Update Set: ${artifact.name} (${artifact.sys_id})`);
+                    console.error(`✅ Artifact tracked in Update Set: ${artifact.name} (${artifact.sys_id})`);
                 }
                 else {
                     console.warn(`⚠️ Failed to track artifact in Update Set: ${trackingResult.error}`);
@@ -8593,7 +8593,7 @@ Use \`snow_deploy\` to create a new ${args.type} instead.`
 - "Change the title to 'New Widget Title'"
 - "Update the description to 'Updated description'"  
 - "Add this CSS: .my-class { color: blue; }"
-- "Change the script to: function() { console.log('updated'); }"
+- "Change the script to: function() { console.error('updated'); }"
 - "Set active to false"
 
 💡 **Or use the config parameter directly:**
@@ -9077,10 +9077,19 @@ c.$onInit = function() {
             .replace(/"/g, '"')
             .replace(/'/g, ''');
     }
+    /**
+     * Run the MCP server
+     */
+    async run() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        // Use stderr for logs to keep stdout clean for JSON-RPC
+        console.error('ServiceNow Deployment MCP server running on stdio');
+    }
 }
 // Start the server
 const server = new ServiceNowDeploymentMCP();
-server.start().catch((error) => {
+server.run().catch((error) => {
     console.error('Failed to start ServiceNow Deployment MCP:', error);
     process.exit(1);
 });

package/dist/mcp/servicenow-mcp-server.js

@@ -626,7 +626,7 @@ class ServiceNowMCPServer {
         // Keep the server running
         await new Promise((resolve) => {
             process.on('SIGINT', () => {
-                console.log('\nServiceNow MCP Server shutting down...');
+                console.error('\nServiceNow MCP Server shutting down...');
                 resolve();
             });
         });

package/dist/mcp/servicenow-system-properties-mcp.d.ts

@@ -65,6 +65,6 @@ export declare class ServiceNowSystemPropertiesMCP {
      * Get property audit history
      */
     private getPropertyHistory;
-    start(): Promise<void>;
+    run(): Promise<void>;
 }
 //# sourceMappingURL=servicenow-system-properties-mcp.d.ts.map

package/dist/mcp/servicenow-system-properties-mcp.js

@@ -1156,16 +1156,17 @@ Note: Audit history requires sys_audit to be enabled for sys_properties table.`
             };
         }
     }
-    async start() {
+    async run() {
         const transport = new stdio_js_1.StdioServerTransport();
         await this.server.connect(transport);
-        this.logger.info('ServiceNow System Properties MCP Server started');
+        // Use stderr for logs to keep stdout clean for JSON-RPC
+        console.error('ServiceNow System Properties MCP Server running on stdio');
     }
 }
 exports.ServiceNowSystemPropertiesMCP = ServiceNowSystemPropertiesMCP;
 // Start the server
 const server = new ServiceNowSystemPropertiesMCP();
-server.start().catch((error) => {
+server.run().catch((error) => {
     console.error('Failed to start ServiceNow System Properties MCP:', error);
     process.exit(1);
 });

package/dist/mcp/servicenow-update-set-mcp.js

@@ -37,16 +37,16 @@ class ServiceNowUpdateSetMCP {
      * Test credentials on startup
      */
     async testCredentials() {
-        console.log('🔍 [UPDATE-SET MCP] Testing credentials...');
+        console.error('🔍 [UPDATE-SET MCP] Testing credentials...');
         try {
             const credentials = await this.oauth.loadCredentials();
             if (credentials) {
-                console.log('✅ [UPDATE-SET MCP] Credentials loaded successfully');
+                console.error('✅ [UPDATE-SET MCP] Credentials loaded successfully');
                 const isAuth = await this.oauth.isAuthenticated();
-                console.log(`🔐 [UPDATE-SET MCP] Authentication status: ${isAuth ? '✅ Valid' : '❌ Expired'}`);
+                console.error(`🔐 [UPDATE-SET MCP] Authentication status: ${isAuth ? '✅ Valid' : '❌ Expired'}`);
             }
             else {
-                console.log('❌ [UPDATE-SET MCP] No credentials found');
+                console.error('❌ [UPDATE-SET MCP] No credentials found');
             }
         }
         catch (error) {

package/dist/mcp/start-all-mcp-servers.js

@@ -48,7 +48,7 @@ async function startAllServers() {
     logger.warn('⚠️ DEPRECATED: This start-all-mcp-servers.ts script is deprecated!');
     logger.warn('   Please use MCPServerManager or scripts/start-mcp-proper.js instead');
     logger.warn('   This provides proper process management and singleton protection');
-    console.log('\n🔄 Redirecting to proper MCPServerManager...\n');
+    console.error('\n🔄 Redirecting to proper MCPServerManager...\n');
     try {
         // Redirect to proper approach
         const { MCPServerManager } = await Promise.resolve().then(() => __importStar(require('../utils/mcp-server-manager.js')));

package/dist/mcp/start-servicenow-mcp.js

@@ -14,19 +14,19 @@ const dotenv_1 = __importDefault(require("dotenv"));
 // Load environment variables
 dotenv_1.default.config();
 async function startServiceNowMCPServer() {
-    console.log('🚀 Starting ServiceNow MCP Server...');
+    console.error('🚀 Starting ServiceNow MCP Server...');
     // Check if OAuth is configured
     const oauth = new snow_oauth_js_1.ServiceNowOAuth();
     const isAuthenticated = await oauth.isAuthenticated();
     if (isAuthenticated) {
-        console.log('✅ ServiceNow OAuth authentication detected');
+        console.error('✅ ServiceNow OAuth authentication detected');
         const credentials = await oauth.loadCredentials();
-        console.log(`🏢 Instance: ${credentials?.instance}`);
+        console.error(`🏢 Instance: ${credentials?.instance}`);
     }
     else {
-        console.log('⚠️  ServiceNow OAuth not configured');
-        console.log('💡 Some tools will be unavailable until authentication is complete');
-        console.log('🔑 Run "snow-flow auth login" to authenticate');
+        console.error('⚠️  ServiceNow OAuth not configured');
+        console.error('💡 Some tools will be unavailable until authentication is complete');
+        console.error('🔑 Run "snow-flow auth login" to authenticate');
     }
     const config = {
         name: "servicenow-mcp-server",
@@ -37,19 +37,19 @@ async function startServiceNowMCPServer() {
             clientSecret: process.env.SNOW_CLIENT_SECRET || ''
         }
     };
-    console.log('🔧 MCP Server Configuration:');
-    console.log(`   📛 Name: ${config.name}`);
-    console.log(`   🏷️ Version: ${config.version}`);
-    console.log(`   🏢 Instance: ${config.oauth.instance || 'Not configured'}`);
-    console.log(`   🔑 Client ID: ${config.oauth.clientId ? '✅ Set' : '❌ Not set'}`);
-    console.log(`   🔐 Client Secret: ${config.oauth.clientSecret ? '✅ Set' : '❌ Not set'}`);
-    console.log('');
+    console.error('🔧 MCP Server Configuration:');
+    console.error(`   📛 Name: ${config.name}`);
+    console.error(`   🏷️ Version: ${config.version}`);
+    console.error(`   🏢 Instance: ${config.oauth.instance || 'Not configured'}`);
+    console.error(`   🔑 Client ID: ${config.oauth.clientId ? '✅ Set' : '❌ Not set'}`);
+    console.error(`   🔐 Client Secret: ${config.oauth.clientSecret ? '✅ Set' : '❌ Not set'}`);
+    console.error('');
     const server = new servicenow_mcp_server_js_1.ServiceNowMCPServer(config);
-    console.log('🌐 ServiceNow MCP Server is running...');
-    console.log('💡 This server provides Claude Code with direct access to ServiceNow APIs');
-    console.log('🔧 Available tools depend on authentication status');
-    console.log('🛑 Press Ctrl+C to stop the server');
-    console.log('');
+    console.error('🌐 ServiceNow MCP Server is running...');
+    console.error('💡 This server provides Claude Code with direct access to ServiceNow APIs');
+    console.error('🔧 Available tools depend on authentication status');
+    console.error('🛑 Press Ctrl+C to stop the server');
+    console.error('');
     try {
         await server.run();
     }

package/fix-console-logs.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+
+# Fix console.log statements in MCP servers to use console.error instead
+# This prevents stdout pollution which breaks JSON-RPC protocol
+
+echo "🔧 Fixing console.log statements in MCP servers..."
+
+# List of files to fix
+files=(
+  "src/mcp/service-discovery-client.ts"
+  "src/mcp/servicenow-deployment-mcp.ts"
+  "src/mcp/servicenow-mcp-server.ts"
+  "src/mcp/servicenow-update-set-mcp.ts"
+  "src/mcp/start-all-mcp-servers.ts"
+  "src/mcp/start-servicenow-mcp.ts"
+)
+
+for file in "${files[@]}"; do
+  if [ -f "$file" ]; then
+    echo "  Fixing $file..."
+    # Replace console.log with console.error
+    sed -i.bak 's/console\.log(/console.error(/g' "$file"
+    # Remove backup file
+    rm -f "${file}.bak"
+  else
+    echo "  ⚠️  File not found: $file"
+  fi
+done
+
+echo "✅ Console.log statements fixed!"
+echo ""
+echo "Note: console.error is used for logging in MCP servers to keep stdout clean for JSON-RPC protocol."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "3.4.29",
+  "version": "3.4.30",
   "description": "ServiceNow development framework with MCP server integration. Executes background scripts using ES5 JavaScript only (ServiceNow Rhino engine requirement). Provides 17 MCP servers for complete ServiceNow operations including widget deployment with coherence validation, table operations, script execution, machine learning, advanced features, and comprehensive platform management.",
   "main": "dist/index.js",
   "type": "commonjs",