snow-flow 8.37.26 → 8.38.0

package/scripts/diagnose-mcp.js

@@ -1,299 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * MCP Diagnostic Tool - Verifies SnowCode MCP configuration and server startup
- */
-
-var fs = require('fs');
-var path = require('path');
-var { execSync } = require('child_process');
-var os = require('os');
-
-console.log('\n🔍 SnowCode MCP Diagnostic Tool\n');
-console.log('='.repeat(80));
-
-var issues = [];
-var warnings = [];
-var successes = [];
-
-// 1. Check SnowCode installation
-console.log('\n1️⃣  Checking SnowCode installation...');
-try {
-  var snowcodeVersion = execSync('snow-code --version 2>&1', { encoding: 'utf-8' }).trim();
-  if (snowcodeVersion.includes('command not found')) {
-    issues.push('SnowCode CLI not found - install with: npm install -g @groeimetai/snow-code');
-  } else {
-    successes.push('SnowCode installed: ' + snowcodeVersion);
-    console.log('   ✅ ' + snowcodeVersion);
-  }
-} catch (e) {
-  issues.push('SnowCode not installed or not in PATH');
-  console.log('   ❌ SnowCode not found');
-}
-
-// 2. Check global snowcode.json
-console.log('\n2️⃣  Checking global SnowCode configuration...');
-var globalConfigPath = path.join(os.homedir(), '.snowcode', 'snowcode.json');
-if (fs.existsSync(globalConfigPath)) {
-  try {
-    var globalConfig = JSON.parse(fs.readFileSync(globalConfigPath, 'utf-8'));
-    successes.push('Global config exists: ' + globalConfigPath);
-    console.log('   ✅ Config file found: ' + globalConfigPath);
-
-    // Check MCP section
-    if (globalConfig.mcp) {
-      var serverCount = Object.keys(globalConfig.mcp).length;
-      successes.push('MCP servers configured: ' + serverCount);
-      console.log('   ✅ MCP servers configured: ' + serverCount);
-
-      // List servers
-      for (var serverName in globalConfig.mcp) {
-        var server = globalConfig.mcp[serverName];
-        console.log('      - ' + serverName + ' (type: ' + server.type + ', enabled: ' + server.enabled + ')');
-
-        // Validate server config
-        if (server.type === 'local') {
-          // Check command exists
-          if (server.command && server.command.length > 0) {
-            var scriptPath = server.command[server.command.length - 1]; // Last arg is usually the script
-            if (fs.existsSync(scriptPath)) {
-              successes.push(serverName + ' script exists: ' + scriptPath);
-              console.log('        ✅ Script exists: ' + scriptPath);
-            } else {
-              issues.push(serverName + ' script NOT found: ' + scriptPath);
-              console.log('        ❌ Script NOT found: ' + scriptPath);
-            }
-
-            // Check environment variables
-            if (server.environment) {
-              var emptyVars = [];
-              for (var key in server.environment) {
-                var value = server.environment[key];
-                if (!value || value === '' || value === '${' + key + '}') {
-                  emptyVars.push(key);
-                }
-              }
-              if (emptyVars.length > 0) {
-                warnings.push(serverName + ' has empty env vars: ' + emptyVars.join(', '));
-                console.log('        ⚠️  Empty env vars: ' + emptyVars.join(', '));
-              } else {
-                successes.push(serverName + ' environment variables configured');
-                console.log('        ✅ Environment variables configured');
-              }
-            }
-          }
-        } else if (server.type === 'remote') {
-          // Check URL and headers
-          if (server.url) {
-            console.log('        ✅ Remote URL: ' + server.url);
-          }
-          if (server.headers && server.headers.Authorization) {
-            var authHeader = server.headers.Authorization;
-            if (authHeader === 'Bearer ' || authHeader === 'Bearer') {
-              warnings.push(serverName + ' has empty Authorization token');
-              console.log('        ⚠️  Authorization token is empty (server disabled)');
-            } else {
-              console.log('        ✅ Authorization configured');
-            }
-          }
-        }
-      }
-    } else {
-      issues.push('No MCP servers configured in global config');
-      console.log('   ❌ No MCP section found in config');
-    }
-
-    // Validate schema
-    if (globalConfig.$schema !== 'https://opencode.ai/config.json') {
-      warnings.push('Schema URL mismatch: ' + globalConfig.$schema);
-      console.log('   ⚠️  Schema: ' + (globalConfig.$schema || 'NOT SET'));
-    }
-  } catch (e) {
-    issues.push('Failed to parse global config: ' + e.message);
-    console.log('   ❌ Failed to parse config: ' + e.message);
-  }
-} else {
-  issues.push('Global SnowCode config not found: ' + globalConfigPath);
-  console.log('   ❌ Config file not found: ' + globalConfigPath);
-  console.log('   💡 Run: snow-flow auth login');
-}
-
-// 3. Check local project config
-console.log('\n3️⃣  Checking local project configuration...');
-var localConfigPath = path.join(process.cwd(), '.snowcode', 'snowcode.json');
-if (fs.existsSync(localConfigPath)) {
-  console.log('   ✅ Local config exists: ' + localConfigPath);
-  console.log('   💡 Local config takes priority over global config');
-  successes.push('Local project config found (takes priority)');
-} else {
-  console.log('   ℹ️  No local config (using global config)');
-}
-
-// 4. Test MCP server startup
-console.log('\n4️⃣  Testing MCP server startup...');
-if (globalConfig && globalConfig.mcp && globalConfig.mcp['servicenow-unified']) {
-  var unifiedServer = globalConfig.mcp['servicenow-unified'];
-  if (unifiedServer.type === 'local' && unifiedServer.command) {
-    var scriptPath = unifiedServer.command[unifiedServer.command.length - 1];
-    console.log('   🧪 Testing servicenow-unified server startup...');
-
-    try {
-      // Try to start the server with a timeout
-      var testEnv = Object.assign({}, process.env);
-      if (unifiedServer.environment) {
-        Object.assign(testEnv, unifiedServer.environment);
-      }
-
-      // Start server and kill after 2 seconds
-      console.log('   ⏳ Starting server (2 second timeout)...');
-      var nodeCmd = unifiedServer.command[0];
-      var serverArgs = unifiedServer.command.slice(1).join(' ');
-
-      try {
-        execSync('timeout 2 ' + nodeCmd + ' ' + serverArgs + ' 2>&1 || true', {
-          encoding: 'utf-8',
-          env: testEnv,
-          timeout: 3000
-        });
-        console.log('   ✅ Server started successfully (no immediate errors)');
-        successes.push('MCP server startup test passed');
-      } catch (e) {
-        if (e.message.includes('timeout')) {
-          console.log('   ✅ Server running (killed after 2s)');
-          successes.push('MCP server startup test passed');
-        } else {
-          console.log('   ❌ Server startup failed:');
-          console.log('      ' + e.message);
-          issues.push('MCP server fails to start: ' + e.message);
-        }
-      }
-    } catch (e) {
-      console.log('   ⚠️  Could not test server startup: ' + e.message);
-      warnings.push('MCP server startup test skipped: ' + e.message);
-    }
-  }
-}
-
-// 5. Check Snow-Flow version
-console.log('\n5️⃣  Checking Snow-Flow version...');
-try {
-  var snowFlowVersion = execSync('snow-flow --version 2>&1', { encoding: 'utf-8' }).trim();
-  console.log('   ✅ ' + snowFlowVersion);
-  successes.push('Snow-Flow installed: ' + snowFlowVersion);
-
-  // Check if it's the latest version
-  if (snowFlowVersion !== '8.6.38') {
-    warnings.push('Snow-Flow version mismatch (installed: ' + snowFlowVersion + ', latest: 8.6.38)');
-    console.log('   ⚠️  Not the latest version (8.6.38)');
-    console.log('   💡 Update with: npm install -g snow-flow@latest');
-  }
-} catch (e) {
-  issues.push('Snow-Flow not installed');
-  console.log('   ❌ Snow-Flow not found');
-}
-
-// 6. Check for running MCP processes
-console.log('\n6️⃣  Checking for running MCP processes...');
-try {
-  var processes = execSync('ps aux | grep -i "servicenow-mcp\\|snow-flow-mcp" | grep -v grep || echo "No MCP processes"', {
-    encoding: 'utf-8'
-  }).trim();
-
-  if (processes === 'No MCP processes') {
-    warnings.push('No MCP server processes currently running');
-    console.log('   ⚠️  No MCP server processes found');
-    console.log('   💡 SnowCode should start these automatically when launched');
-  } else {
-    console.log('   ✅ MCP processes running:');
-    var lines = processes.split('\n');
-    for (var i = 0; i < lines.length; i++) {
-      console.log('      ' + lines[i]);
-    }
-    successes.push('MCP server processes running');
-  }
-} catch (e) {
-  console.log('   ℹ️  Could not check processes');
-}
-
-// Summary
-console.log('\n' + '='.repeat(80));
-console.log('📊 DIAGNOSTIC SUMMARY\n');
-
-if (successes.length > 0) {
-  console.log('✅ SUCCESSES (' + successes.length + '):');
-  for (var i = 0; i < successes.length; i++) {
-    console.log('   ✓ ' + successes[i]);
-  }
-  console.log('');
-}
-
-if (warnings.length > 0) {
-  console.log('⚠️  WARNINGS (' + warnings.length + '):');
-  for (var i = 0; i < warnings.length; i++) {
-    console.log('   ⚠ ' + warnings[i]);
-  }
-  console.log('');
-}
-
-if (issues.length > 0) {
-  console.log('❌ ISSUES (' + issues.length + '):');
-  for (var i = 0; i < issues.length; i++) {
-    console.log('   ✗ ' + issues[i]);
-  }
-  console.log('');
-}
-
-// Recommendations
-console.log('💡 RECOMMENDATIONS:\n');
-
-if (issues.length > 0) {
-  console.log('1. Fix the issues above first:');
-  if (issues.some(function(i) { return i.includes('SnowCode not installed'); })) {
-    console.log('   → Install SnowCode: npm install -g @groeimetai/snow-code');
-  }
-  if (issues.some(function(i) { return i.includes('config not found'); })) {
-    console.log('   → Configure Snow-Flow: snow-flow auth login');
-  }
-  if (issues.some(function(i) { return i.includes('script NOT found'); })) {
-    console.log('   → Reinstall Snow-Flow: npm install -g snow-flow@latest');
-  }
-  if (issues.some(function(i) { return i.includes('server fails to start'); })) {
-    console.log('   → Check MCP server logs for errors');
-    console.log('   → Verify credentials in snowcode.json are correct');
-  }
-  console.log('');
-}
-
-if (warnings.length > 0 && issues.length === 0) {
-  console.log('2. Address warnings:');
-  if (warnings.some(function(w) { return w.includes('empty env vars'); })) {
-    console.log('   → Run: snow-flow auth login (to set credentials)');
-  }
-  if (warnings.some(function(w) { return w.includes('version mismatch'); })) {
-    console.log('   → Update: npm install -g snow-flow@latest');
-  }
-  if (warnings.some(function(w) { return w.includes('No MCP processes'); })) {
-    console.log('   → SnowCode should auto-start MCP servers');
-    console.log('   → If tools still unavailable, restart SnowCode completely');
-  }
-  console.log('');
-}
-
-if (issues.length === 0 && warnings.length === 0) {
-  console.log('✅ Configuration looks good!');
-  console.log('');
-  console.log('If MCP tools are still not available in SnowCode:');
-  console.log('1. Completely quit SnowCode (not just close window)');
-  console.log('2. Restart SnowCode: snow-code');
-  console.log('3. Tools should be available immediately');
-  console.log('');
-  console.log('Test MCP tools with:');
-  console.log('   await snow_query_table({ table: "sys_user", limit: 1 })');
-  console.log('');
-}
-
-console.log('📝 Next steps if issues persist:');
-console.log('   1. Check SnowCode logs for MCP startup errors');
-console.log('   2. Verify SnowCode is reading ~/.snowcode/snowcode.json');
-console.log('   3. Try manual MCP server test: node ' + (globalConfig && globalConfig.mcp && globalConfig.mcp['servicenow-unified'] ? globalConfig.mcp['servicenow-unified'].command[1] : '[path-to-mcp-server]'));
-console.log('');

package/scripts/generate-mcp-config.js

@@ -1,45 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const dotenv = require('dotenv');
-
-// Load environment variables
-const envPath = path.join(__dirname, '..', '.env');
-if (fs.existsSync(envPath)) {
-  dotenv.config({ path: envPath });
-} else {
-  console.error('❌ .env file not found!');
-  process.exit(1);
-}
-
-// Read template
-const templatePath = path.join(__dirname, '..', '.mcp.json.template');
-const template = JSON.parse(fs.readFileSync(templatePath, 'utf-8'));
-
-// Process template - replace variables
-const config = JSON.parse(JSON.stringify(template)
-  .replace(/{{PROJECT_ROOT}}/g, path.resolve(__dirname, '..'))
-  .replace(/{{SNOW_INSTANCE}}/g, process.env.SNOW_INSTANCE || '')
-  .replace(/{{SNOW_CLIENT_ID}}/g, process.env.SNOW_CLIENT_ID || '')
-  .replace(/{{SNOW_CLIENT_SECRET}}/g, process.env.SNOW_CLIENT_SECRET || '')
-  .replace(/{{SNOW_DEPLOYMENT_TIMEOUT}}/g, process.env.SNOW_DEPLOYMENT_TIMEOUT || '300000')
-  .replace(/{{MCP_DEPLOYMENT_TIMEOUT}}/g, process.env.MCP_DEPLOYMENT_TIMEOUT || '360000')
-  .replace(/{{SNOW_FLOW_ENV}}/g, process.env.SNOW_FLOW_ENV || 'production')
-);
-
-// Write config
-const outputPath = path.join(__dirname, '..', '.mcp.json');
-fs.writeFileSync(outputPath, JSON.stringify(config, null, 2));
-
-console.log('✅ Generated .mcp.json with all ServiceNow MCP servers');
-console.log(`📁 Location: ${outputPath}`);
-console.log(`🔧 Servers configured: ${Object.keys(config.servers).length}`);
-console.log('\nServers:');
-Object.keys(config.servers).forEach(server => {
-  console.log(`  ✓ ${server}`);
-});
-
-console.log('\n💡 Next steps:');
-console.log('1. Restart Claude Code to load the new configuration');
-console.log('2. Run /doctor again to verify everything is working');

package/scripts/mcp-server-manager.sh

@@ -1,320 +0,0 @@
-#!/bin/bash
-#
-# MCP Server Manager for Snow-Flow
-# Helps start, stop, and monitor MCP servers for OpenCode
-#
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
-MCP_SERVER_PATH="$PROJECT_ROOT/dist/mcp/servicenow-mcp-unified/index.js"
-PID_FILE="/tmp/snow-flow-mcp.pid"
-LOG_FILE="/tmp/snow-flow-mcp.log"
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Load .env file if exists
-load_env() {
-  if [ -f "$PROJECT_ROOT/.env" ]; then
-    echo -e "${BLUE}Loading environment from .env...${NC}"
-    export $(cat "$PROJECT_ROOT/.env" | grep -v '^#' | grep -v '^$' | xargs)
-  else
-    echo -e "${YELLOW}Warning: No .env file found${NC}"
-    echo "Please create one from .env.example:"
-    echo "  cp .env.example .env"
-    echo "  # Then edit .env with your credentials"
-    exit 1
-  fi
-}
-
-# Check if MCP server is built
-check_build() {
-  if [ ! -f "$MCP_SERVER_PATH" ]; then
-    echo -e "${RED}Error: MCP server not built!${NC}"
-    echo "Run: npm run build"
-    exit 1
-  fi
-  echo -e "${GREEN}✓ MCP server binary found${NC}"
-}
-
-# Check if MCP server is running
-is_running() {
-  if [ -f "$PID_FILE" ]; then
-    PID=$(cat "$PID_FILE")
-    if ps -p "$PID" > /dev/null 2>&1; then
-      return 0
-    else
-      rm -f "$PID_FILE"
-      return 1
-    fi
-  fi
-  return 1
-}
-
-# Start MCP server
-start_server() {
-  echo -e "${BLUE}Starting MCP server...${NC}"
-
-  load_env
-  check_build
-
-  if is_running; then
-    echo -e "${YELLOW}MCP server is already running (PID: $(cat $PID_FILE))${NC}"
-    return 0
-  fi
-
-  # Prepare environment variables
-  export SERVICENOW_INSTANCE_URL="https://${SNOW_INSTANCE}"
-
-  # Try OAuth first, fall back to username/password
-  if [ -n "$SNOW_CLIENT_ID" ] && [ -n "$SNOW_CLIENT_SECRET" ]; then
-    echo -e "${GREEN}Using OAuth authentication${NC}"
-    export SERVICENOW_CLIENT_ID="$SNOW_CLIENT_ID"
-    export SERVICENOW_CLIENT_SECRET="$SNOW_CLIENT_SECRET"
-  elif [ -n "$SNOW_USERNAME" ] && [ -n "$SNOW_PASSWORD" ]; then
-    echo -e "${GREEN}Using Username/Password authentication${NC}"
-    export SERVICENOW_USERNAME="$SNOW_USERNAME"
-    export SERVICENOW_PASSWORD="$SNOW_PASSWORD"
-  else
-    echo -e "${RED}Error: No authentication credentials found!${NC}"
-    echo "Set either:"
-    echo "  - SNOW_CLIENT_ID + SNOW_CLIENT_SECRET (OAuth)"
-    echo "  - SNOW_USERNAME + SNOW_PASSWORD"
-    exit 1
-  fi
-
-  # Start server in background
-  nohup node "$MCP_SERVER_PATH" > "$LOG_FILE" 2>&1 &
-  PID=$!
-  echo $PID > "$PID_FILE"
-
-  # Wait for server to start
-  echo -e "${BLUE}Waiting for server to start...${NC}"
-  sleep 2
-
-  if is_running; then
-    echo -e "${GREEN}✓ MCP server started (PID: $PID)${NC}"
-    echo -e "${BLUE}Log file: $LOG_FILE${NC}"
-    return 0
-  else
-    echo -e "${RED}✗ Failed to start MCP server${NC}"
-    echo "Check logs: cat $LOG_FILE"
-    return 1
-  fi
-}
-
-# Stop MCP server
-stop_server() {
-  echo -e "${BLUE}Stopping MCP server...${NC}"
-
-  if ! is_running; then
-    echo -e "${YELLOW}MCP server is not running${NC}"
-    return 0
-  fi
-
-  PID=$(cat "$PID_FILE")
-  kill $PID 2>/dev/null || true
-  sleep 1
-
-  if ! is_running; then
-    echo -e "${GREEN}✓ MCP server stopped${NC}"
-    rm -f "$PID_FILE"
-  else
-    echo -e "${YELLOW}Forcing server shutdown...${NC}"
-    kill -9 $PID 2>/dev/null || true
-    rm -f "$PID_FILE"
-    echo -e "${GREEN}✓ MCP server killed${NC}"
-  fi
-}
-
-# Check MCP server status
-status_check() {
-  echo -e "${BLUE}Checking MCP server status...${NC}"
-
-  check_build
-
-  if is_running; then
-    PID=$(cat "$PID_FILE")
-    echo -e "${GREEN}✓ MCP server is running (PID: $PID)${NC}"
-
-    # Check tool count
-    TOOL_COUNT=$(grep -c "Registered:" "$LOG_FILE" 2>/dev/null || echo "0")
-    echo -e "${GREEN}✓ Tools loaded: $TOOL_COUNT${NC}"
-
-    # Check last 10 log lines
-    echo -e "\n${BLUE}Recent logs:${NC}"
-    tail -n 10 "$LOG_FILE" 2>/dev/null || echo "No logs available"
-
-    return 0
-  else
-    echo -e "${RED}✗ MCP server is not running${NC}"
-    return 1
-  fi
-}
-
-# Health check with tool test
-health_check() {
-  echo -e "${BLUE}Running health check...${NC}"
-
-  if ! is_running; then
-    echo -e "${RED}✗ MCP server is not running${NC}"
-    echo "Start it with: $0 start"
-    return 1
-  fi
-
-  load_env
-
-  # Test JSON-RPC communication
-  echo -e "${BLUE}Testing JSON-RPC communication...${NC}"
-
-  cat > /tmp/mcp_health_check.js << 'EOF'
-const { spawn } = require('child_process');
-
-const mcp = spawn('node', [process.argv[2]], {
-  env: process.env,
-  stdio: ['pipe', 'pipe', 'pipe']
-});
-
-let buffer = '';
-let testPassed = false;
-
-mcp.stdout.on('data', (data) => {
-  buffer += data.toString();
-  const lines = buffer.split('\n');
-  buffer = lines.pop();
-
-  lines.forEach(line => {
-    if (line.trim() && line.startsWith('{')) {
-      try {
-        const msg = JSON.parse(line);
-        if (msg.result && msg.result.tools) {
-          console.log(`✓ Health check passed - ${msg.result.tools.length} tools available`);
-          testPassed = true;
-          mcp.kill();
-          process.exit(0);
-        }
-      } catch (e) {}
-    }
-  });
-});
-
-mcp.stderr.on('data', (data) => {
-  // Ignore stderr logs from server
-});
-
-// Initialize and list tools
-setTimeout(() => {
-  const initRequest = {
-    jsonrpc: '2.0',
-    id: 1,
-    method: 'initialize',
-    params: {
-      protocolVersion: '2024-11-05',
-      capabilities: {},
-      clientInfo: { name: 'health-check', version: '1.0.0' }
-    }
-  };
-  mcp.stdin.write(JSON.stringify(initRequest) + '\n');
-}, 500);
-
-setTimeout(() => {
-  const toolsRequest = {
-    jsonrpc: '2.0',
-    id: 2,
-    method: 'tools/list'
-  };
-  mcp.stdin.write(JSON.stringify(toolsRequest) + '\n');
-}, 1500);
-
-setTimeout(() => {
-  if (!testPassed) {
-    console.log('✗ Health check failed - timeout');
-    mcp.kill();
-    process.exit(1);
-  }
-}, 5000);
-EOF
-
-  SERVICENOW_INSTANCE_URL="https://${SNOW_INSTANCE}" \
-  SERVICENOW_CLIENT_ID="$SNOW_CLIENT_ID" \
-  SERVICENOW_CLIENT_SECRET="$SNOW_CLIENT_SECRET" \
-  SERVICENOW_USERNAME="$SNOW_USERNAME" \
-  SERVICENOW_PASSWORD="$SNOW_PASSWORD" \
-  node /tmp/mcp_health_check.js "$MCP_SERVER_PATH"
-
-  rm -f /tmp/mcp_health_check.js
-}
-
-# Show logs
-show_logs() {
-  if [ -f "$LOG_FILE" ]; then
-    echo -e "${BLUE}MCP Server Logs:${NC}"
-    tail -f "$LOG_FILE"
-  else
-    echo -e "${YELLOW}No logs available${NC}"
-  fi
-}
-
-# Restart server
-restart_server() {
-  stop_server
-  sleep 1
-  start_server
-}
-
-# Main menu
-show_help() {
-  echo "MCP Server Manager for Snow-Flow"
-  echo ""
-  echo "Usage: $0 [command]"
-  echo ""
-  echo "Commands:"
-  echo "  start       Start MCP server"
-  echo "  stop        Stop MCP server"
-  echo "  restart     Restart MCP server"
-  echo "  status      Show server status"
-  echo "  health      Run health check"
-  echo "  logs        Show server logs (live)"
-  echo "  help        Show this help"
-  echo ""
-  echo "Examples:"
-  echo "  $0 start        # Start MCP server in background"
-  echo "  $0 health       # Test JSON-RPC communication"
-  echo "  $0 logs         # Follow server logs"
-}
-
-# Parse command
-case "${1:-help}" in
-  start)
-    start_server
-    ;;
-  stop)
-    stop_server
-    ;;
-  restart)
-    restart_server
-    ;;
-  status)
-    status_check
-    ;;
-  health)
-    health_check
-    ;;
-  logs)
-    show_logs
-    ;;
-  help|--help|-h)
-    show_help
-    ;;
-  *)
-    echo -e "${RED}Unknown command: $1${NC}"
-    show_help
-    exit 1
-    ;;
-esac