snow-flow 8.37.26 → 8.38.0

package/scripts/postinstall.js

@@ -1,75 +0,0 @@
-#!/usr/bin/env node
-
-// Gracefully handle missing dependencies in restricted environments
-try {
-  const fs = require('fs');
-  const path = require('path');
-  const os = require('os');
-
-  console.log('🚀 Setting up Snow-Flow...');
-
-  // Fix binary permissions (critical for containers/codespaces)
-  try {
-    const platforms = [
-      'snow-code-darwin-arm64',
-      'snow-code-darwin-x64',
-      'snow-code-linux-arm64',
-      'snow-code-linux-x64',
-      'snow-code-windows-x64'
-    ];
-
-    // Try both global and local node_modules locations
-    const locations = [
-      path.join(__dirname, '..', 'node_modules'),
-      path.join(process.cwd(), 'node_modules'),
-      path.join(os.homedir(), '.npm', '_npx', 'node_modules')
-    ];
-
-    platforms.forEach(platform => {
-      locations.forEach(location => {
-        const binaryPath = path.join(location, '@groeimetai', platform, 'bin', 'snow-code');
-        if (fs.existsSync(binaryPath)) {
-          try {
-            fs.chmodSync(binaryPath, 0o755);
-            console.log(`✅ Fixed permissions for ${platform}`);
-          } catch (err) {
-            // Silently continue if chmod fails
-          }
-        }
-      });
-    });
-  } catch (error) {
-    // Continue silently if permission fixing fails
-  }
-
-  // Check if we're in a global install
-  const isGlobalInstall = process.env.npm_config_global === 'true' ||
-                          process.env.npm_config_global === true;
-
-  if (isGlobalInstall) {
-    console.log('✅ Snow-Flow installed globally');
-    console.log('📁 Run "snow-flow init" in your project directory to initialize');
-
-    // Create global config directory
-    try {
-      const globalConfigDir = path.join(os.homedir(), '.snow-flow');
-      if (!fs.existsSync(globalConfigDir)) {
-        fs.mkdirSync(globalConfigDir, { recursive: true });
-        console.log(`✅ Created global config directory at ${globalConfigDir}`);
-      }
-    } catch (err) {
-      // Silently fail if can't create directory
-    }
-  } else {
-    // Local installation - don't create directories automatically
-    console.log('✅ Snow-Flow installed locally');
-    console.log('🔧 Run "snow-flow init" to initialize your project');
-  }
-
-  console.log('\n📚 Documentation: https://github.com/groeimetai/snow-flow#readme');
-  console.log('🆘 Get help: snow-flow --help');
-} catch (error) {
-  // Silently fail in restricted environments (Docker, Cloud Build, etc.)
-  // The || true in package.json postinstall ensures installation continues
-  process.exit(0);
-}

package/scripts/reset-mcp-servers.js

@@ -1,266 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Reset MCP Servers Script
- * Kills all running MCP processes and optionally restarts them
- */
-
-const { exec, spawn } = require('child_process');
-const os = require('os');
-const path = require('path');
-const fs = require('fs');
-
-// Colors for console output
-const colors = {
-  reset: '\x1b[0m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  magenta: '\x1b[35m',
-  cyan: '\x1b[36m'
-};
-
-function log(message, color = 'reset') {
-  console.log(`${colors[color]}${message}${colors.reset}`);
-}
-
-function logStep(step, message) {
-  console.log(`${colors.cyan}[${step}]${colors.reset} ${message}`);
-}
-
-// Get platform-specific commands
-function getKillCommand() {
-  const platform = os.platform();
-  if (platform === 'win32') {
-    return {
-      list: 'wmic process where "commandline like \'%servicenow-%mcp%\'" get processid,commandline',
-      kill: (pid) => `taskkill /F /PID ${pid}`
-    };
-  } else {
-    return {
-      list: "ps aux | grep -E 'servicenow-.*-mcp' | grep -v grep",
-      kill: (pid) => `kill -9 ${pid}`
-    };
-  }
-}
-
-// Kill all MCP processes
-async function killMCPProcesses() {
-  return new Promise((resolve) => {
-    logStep('1/4', 'Finding running MCP processes...');
-    
-    const commands = getKillCommand();
-    
-    exec(commands.list, (error, stdout, stderr) => {
-      if (error && !stderr) {
-        log('No MCP processes found running.', 'green');
-        resolve(0);
-        return;
-      }
-      
-      const lines = stdout.split('\n').filter(line => line.trim());
-      let killed = 0;
-      
-      if (os.platform() === 'win32') {
-        // Windows: Extract PIDs from wmic output
-        lines.forEach(line => {
-          const match = line.match(/(\d+)\s*$/);
-          if (match) {
-            const pid = match[1];
-            exec(commands.kill(pid), (err) => {
-              if (!err) {
-                log(`  ✓ Killed process ${pid}`, 'yellow');
-                killed++;
-              }
-            });
-          }
-        });
-      } else {
-        // Unix-like: Extract PIDs from ps output
-        lines.forEach(line => {
-          const parts = line.trim().split(/\s+/);
-          if (parts.length > 1) {
-            const pid = parts[1];
-            exec(commands.kill(pid), (err) => {
-              if (!err) {
-                log(`  ✓ Killed process ${pid}`, 'yellow');
-                killed++;
-              }
-            });
-          }
-        });
-      }
-      
-      setTimeout(() => {
-        if (killed > 0) {
-          log(`Killed ${killed} MCP processes.`, 'green');
-        }
-        resolve(killed);
-      }, 1000);
-    });
-  });
-}
-
-// Clear temporary files and cache
-async function clearCache() {
-  logStep('2/4', 'Clearing MCP cache and temporary files...');
-  
-  const cacheLocations = [
-    path.join(os.homedir(), '.snow-flow', 'mcp-cache'),
-    path.join(os.homedir(), '.snow-flow', 'memory', '*.lock'),
-    path.join(process.cwd(), '.mcp-temp'),
-    path.join(process.cwd(), 'dist', 'mcp', '*.lock')
-  ];
-  
-  let cleared = 0;
-  
-  cacheLocations.forEach(location => {
-    try {
-      if (location.includes('*')) {
-        // Handle glob patterns
-        const dir = path.dirname(location);
-        const pattern = path.basename(location);
-        if (fs.existsSync(dir)) {
-          const files = fs.readdirSync(dir);
-          files.forEach(file => {
-            if (file.match(pattern.replace('*', '.*'))) {
-              fs.unlinkSync(path.join(dir, file));
-              cleared++;
-            }
-          });
-        }
-      } else if (fs.existsSync(location)) {
-        // Handle directories
-        fs.rmSync(location, { recursive: true, force: true });
-        cleared++;
-      }
-    } catch (error) {
-      // Ignore errors for non-existent files
-    }
-  });
-  
-  if (cleared > 0) {
-    log(`  ✓ Cleared ${cleared} cache locations`, 'green');
-  } else {
-    log('  ✓ No cache files found to clear', 'green');
-  }
-}
-
-// Verify no processes are running
-async function verifyClean() {
-  return new Promise((resolve) => {
-    logStep('3/4', 'Verifying all MCP processes are stopped...');
-    
-    const commands = getKillCommand();
-    
-    exec(commands.list, (error, stdout) => {
-      if (error || !stdout.trim()) {
-        log('  ✓ All MCP processes successfully stopped', 'green');
-        resolve(true);
-      } else {
-        log('  ⚠ Some MCP processes may still be running', 'yellow');
-        resolve(false);
-      }
-    });
-  });
-}
-
-// Restart MCP servers if requested
-async function restartServers() {
-  logStep('4/4', 'Restarting MCP servers using proper MCPServerManager...');
-  
-  const properStarterPath = path.join(__dirname, 'start-mcp-proper.js');
-  
-  if (!fs.existsSync(properStarterPath)) {
-    log('  ⚠ Proper MCP starter not found. Run "npm run build" first.', 'yellow');
-    return;
-  }
-  
-  log('  Starting MCP servers with singleton protection...', 'cyan');
-  
-  try {
-    // Use the proper MCPServerManager approach
-    const child = spawn('node', [properStarterPath], {
-      detached: true,
-      stdio: ['ignore', 'pipe', 'pipe']
-    });
-    
-    // Log startup messages
-    child.stdout?.on('data', (data) => {
-      log(`  ${data.toString().trim()}`, 'green');
-    });
-    
-    child.stderr?.on('data', (data) => {
-      log(`  Error: ${data.toString().trim()}`, 'red');
-    });
-    
-    child.unref();
-    
-    // Give it time to start
-    await new Promise(resolve => setTimeout(resolve, 2000));
-    
-    log('  ✅ MCP servers started with proper management!', 'green');
-    log('  💡 No more duplicate servers or memory issues!', 'cyan');
-    
-  } catch (error) {
-    log(`  ❌ Failed to start MCP servers: ${error.message}`, 'red');
-    log('  🔧 Try: npm run cleanup-mcp', 'yellow');
-  }
-  log('\n  To view logs, check ~/.snow-flow/logs/', 'cyan');
-}
-
-// Main execution
-async function main() {
-  console.log('\n' + colors.magenta + '🔄 Snow-Flow MCP Server Reset' + colors.reset + '\n');
-  
-  const args = process.argv.slice(2);
-  const shouldRestart = args.includes('--restart') || args.includes('-r');
-  
-  try {
-    // Kill processes
-    await killMCPProcesses();
-    
-    // Clear cache
-    await clearCache();
-    
-    // Verify clean
-    await verifyClean();
-    
-    // Restart if requested
-    if (shouldRestart) {
-      await restartServers();
-    } else {
-      log('\n✅ MCP servers reset complete!', 'green');
-      log('To restart servers, run: npm run reset-mcp -- --restart', 'cyan');
-    }
-    
-  } catch (error) {
-    log(`\n❌ Error resetting MCP servers: ${error.message}`, 'red');
-    process.exit(1);
-  }
-}
-
-// Help text
-if (process.argv.includes('--help') || process.argv.includes('-h')) {
-  console.log(`
-${colors.cyan}Snow-Flow MCP Server Reset${colors.reset}
-
-Usage: node reset-mcp-servers.js [options]
-
-Options:
-  -r, --restart    Restart MCP servers after reset
-  -h, --help       Show this help message
-
-Examples:
-  node reset-mcp-servers.js              # Reset only
-  node reset-mcp-servers.js --restart    # Reset and restart
-`);
-  process.exit(0);
-}
-
-// Run the script
-main().catch(error => {
-  log(`Fatal error: ${error.message}`, 'red');
-  process.exit(1);
-});

package/scripts/safe-mcp-cleanup.js

@@ -1,151 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Safe MCP Cleanup Script
- * Manual cleanup for MCP servers without causing memory crashes
- */
-
-const { execSync } = require('child_process');
-const readline = require('readline');
-
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-
-function getProcesses() {
-  try {
-    const output = execSync('ps aux | grep -E "mcp|servicenow.*mcp" | grep -v grep', {
-      encoding: 'utf8'
-    }).trim();
-    
-    if (!output) return [];
-    
-    const lines = output.split('\n');
-    const processes = [];
-    
-    for (const line of lines) {
-      const parts = line.split(/\s+/);
-      if (parts.length > 10) {
-        processes.push({
-          pid: parseInt(parts[1]),
-          memory: Math.round(parseInt(parts[5]) / 1024), // MB
-          name: parts.slice(10).join(' ').substring(0, 80)
-        });
-      }
-    }
-    
-    return processes;
-  } catch (error) {
-    return [];
-  }
-}
-
-async function main() {
-  console.log('🧹 Safe MCP Cleanup Utility\n');
-  console.log('⚠️  WARNING: This will terminate MCP server processes');
-  console.log('Only use if experiencing memory issues or crashes\n');
-  
-  const processes = getProcesses();
-  
-  if (processes.length === 0) {
-    console.log('✅ No MCP processes found');
-    process.exit(0);
-  }
-  
-  console.log(`Found ${processes.length} MCP processes:\n`);
-  
-  // Group by type
-  const groups = {};
-  let totalMemory = 0;
-  
-  for (const proc of processes) {
-    const match = proc.name.match(/servicenow-([^-]+)-mcp/);
-    const type = match ? match[1] : 'other';
-    
-    if (!groups[type]) {
-      groups[type] = [];
-    }
-    groups[type].push(proc);
-    totalMemory += proc.memory;
-  }
-  
-  // Display summary
-  for (const [type, procs] of Object.entries(groups)) {
-    const memSum = procs.reduce((sum, p) => sum + p.memory, 0);
-    console.log(`  ${type}: ${procs.length} process(es), ${memSum}MB`);
-  }
-  
-  console.log(`\nTotal memory usage: ${totalMemory}MB`);
-  
-  // Ask for confirmation
-  const answer = await new Promise(resolve => {
-    rl.question('\nOptions:\n1. Kill ALL MCP processes\n2. Kill duplicates only (keep 1 of each type)\n3. Kill high memory processes (>100MB)\n4. Cancel\n\nChoice (1-4): ', resolve);
-  });
-  
-  switch (answer.trim()) {
-    case '1':
-      console.log('\n🔴 Killing ALL MCP processes...');
-      for (const proc of processes) {
-        try {
-          process.kill(proc.pid, 'SIGTERM');
-          console.log(`  Killed PID ${proc.pid}`);
-        } catch (e) {
-          // Already dead
-        }
-      }
-      console.log('✅ All MCP processes terminated');
-      break;
-      
-    case '2':
-      console.log('\n🟡 Killing duplicate processes...');
-      for (const [type, procs] of Object.entries(groups)) {
-        if (procs.length > 1) {
-          // Keep the first one, kill the rest
-          for (let i = 1; i < procs.length; i++) {
-            try {
-              process.kill(procs[i].pid, 'SIGTERM');
-              console.log(`  Killed duplicate ${type} (PID ${procs[i].pid})`);
-            } catch (e) {
-              // Already dead
-            }
-          }
-        }
-      }
-      console.log('✅ Duplicates removed');
-      break;
-      
-    case '3':
-      console.log('\n🟠 Killing high memory processes...');
-      const highMem = processes.filter(p => p.memory > 100);
-      for (const proc of highMem) {
-        try {
-          process.kill(proc.pid, 'SIGTERM');
-          console.log(`  Killed PID ${proc.pid} (${proc.memory}MB)`);
-        } catch (e) {
-          // Already dead
-        }
-      }
-      console.log('✅ High memory processes terminated');
-      break;
-      
-    default:
-      console.log('❌ Cancelled');
-      break;
-  }
-  
-  rl.close();
-  
-  // Show final status
-  setTimeout(() => {
-    console.log('\n📊 Final status:');
-    const remaining = getProcesses();
-    console.log(`  Remaining processes: ${remaining.length}`);
-    if (remaining.length > 0) {
-      const memSum = remaining.reduce((sum, p) => sum + p.memory, 0);
-      console.log(`  Memory usage: ${memSum}MB`);
-    }
-  }, 1000);
-}
-
-main().catch(console.error);

package/scripts/setup-mcp.js

@@ -1,106 +0,0 @@
-#!/usr/bin/env node
-/**
- * Dynamic MCP Configuration Generator
- * Generates .mcp.json from template with absolute paths and actual environment variables
- * This ensures compatibility with Claude Code while keeping the project portable
- */
-
-const fs = require('fs');
-const path = require('path');
-// Try to load .env file if it exists, but don't fail if it doesn't
-try {
-  require('dotenv').config();
-} catch (err) {
-  // .env file not found, that's OK
-}
-
-// Determine if we're in a global npm installation
-const isGlobalInstall = __dirname.includes('node_modules/snow-flow') || 
-                       __dirname.includes('.nvm/versions/node');
-
-// For global installs, use the package directory, not cwd
-const packageRoot = isGlobalInstall 
-  ? path.resolve(__dirname, '..') // Go up from scripts/ to package root
-  : process.cwd();
-
-// The actual project root where we're running the command
-const projectRoot = process.cwd();
-
-const templatePath = path.join(packageRoot, '.mcp.json.template');
-const mcpFilePath = path.join(projectRoot, '.mcp.json');
-
-// Check if template exists
-if (!fs.existsSync(templatePath)) {
-  console.error('❌ Error: .mcp.json.template not found!');
-  console.error('   This file should be in the project root.');
-  process.exit(1);
-}
-
-// Check if required environment variables are set
-const requiredEnvVars = ['SNOW_INSTANCE', 'SNOW_CLIENT_ID', 'SNOW_CLIENT_SECRET'];
-const missingVars = requiredEnvVars.filter(varName => !process.env[varName]);
-
-if (missingVars.length > 0) {
-  console.warn('⚠️  Warning: Missing environment variables:', missingVars.join(', '));
-  console.warn('   MCP servers may not work without proper ServiceNow credentials.');
-  console.warn('   Copy .env.example to .env and configure your ServiceNow credentials.');
-}
-
-// Read template
-const template = fs.readFileSync(templatePath, 'utf8');
-
-// Replace placeholders
-const replacements = {
-  '{{PROJECT_ROOT}}': packageRoot, // Use packageRoot for MCP server paths
-  '{{SNOW_INSTANCE}}': process.env.SNOW_INSTANCE || 'your-instance.service-now.com',
-  '{{SNOW_CLIENT_ID}}': process.env.SNOW_CLIENT_ID || 'your-oauth-client-id',
-  '{{SNOW_CLIENT_SECRET}}': process.env.SNOW_CLIENT_SECRET || 'your-oauth-client-secret',
-  '{{NEO4J_URI}}': process.env.NEO4J_URI || 'bolt://localhost:7687',
-  '{{NEO4J_USER}}': process.env.NEO4J_USER || 'neo4j',
-  '{{NEO4J_PASSWORD}}': process.env.NEO4J_PASSWORD || 'password'
-};
-
-let mcpConfig = template;
-for (const [placeholder, value] of Object.entries(replacements)) {
-  mcpConfig = mcpConfig.replace(new RegExp(placeholder, 'g'), value);
-}
-
-// Write the configuration file
-fs.writeFileSync(mcpFilePath, mcpConfig);
-
-// Make all MCP server files executable
-const mcpServerFiles = [
-  'servicenow-deployment-mcp.js',
-  'servicenow-update-set-mcp.js',
-  'servicenow-intelligent-mcp.js',
-  'servicenow-graph-memory-mcp.js',
-  'servicenow-operations-mcp.js',
-  'servicenow-platform-development-mcp.js',
-  'servicenow-integration-mcp.js',
-  'servicenow-automation-mcp.js',
-  'servicenow-security-compliance-mcp.js',
-  'servicenow-reporting-analytics-mcp.js',
-  'servicenow-memory-mcp.js'
-];
-
-mcpServerFiles.forEach(file => {
-  const filePath = path.join(packageRoot, 'dist/mcp', file);
-  if (fs.existsSync(filePath)) {
-    fs.chmodSync(filePath, '755');
-  }
-});
-
-console.log('✅ Generated .mcp.json with dynamic configuration');
-console.log('📁 Project directory:', projectRoot);
-console.log('📦 Package directory:', packageRoot);
-console.log('🔧 Environment variables:', requiredEnvVars.filter(v => process.env[v]).length + '/' + requiredEnvVars.length + ' configured');
-console.log('🔐 Made MCP server files executable');
-console.log('📝 Using node + args format for Claude Code compatibility');
-
-if (missingVars.length === 0) {
-  console.log('🎉 All ServiceNow environment variables are configured!');
-  console.log('💡 MCP servers should now work properly in Claude Code');
-} else {
-  console.log('⚠️  Configure missing environment variables in .env file');
-  console.log('📖 See .env.example for setup instructions');
-}

package/scripts/start-mcp-proper.js

@@ -1,76 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Proper MCP Server Starter using MCPServerManager
- * REPLACES the legacy start-all-mcp-servers.ts approach
- */
-
-const path = require('path');
-
-async function startMCPServersProper() {
-  console.log('🚀 Starting MCP servers using proper MCPServerManager...\n');
-  
-  try {
-    // Import the proper MCPServerManager
-    const { MCPServerManager } = require('../dist/utils/mcp-server-manager.js');
-    
-    // Initialize manager
-    const manager = new MCPServerManager();
-    await manager.initialize();
-    
-    console.log('📋 Initializing MCP server configuration...');
-    
-    // Start all servers with singleton protection built-in
-    await manager.startAllServers();
-    
-    console.log('✅ All MCP servers started successfully!\n');
-    console.log('📊 Server Status:');
-    
-    // Show server status
-    const servers = manager.getServerList();
-    for (const server of servers) {
-      const status = server.status === 'running' ? '🟢' : 
-                    server.status === 'starting' ? '🟡' : 
-                    server.status === 'error' ? '🔴' : '⚫';
-      console.log(`  ${status} ${server.name}: ${server.status}`);
-    }
-    
-    console.log('\n💡 Benefits of using MCPServerManager:');
-    console.log('  • ✅ Singleton protection (no duplicates)');
-    console.log('  • ✅ Process lifecycle management');
-    console.log('  • ✅ Configuration management');
-    console.log('  • ✅ Proper logging and monitoring');
-    console.log('  • ✅ Graceful shutdown handling');
-    console.log('  • ✅ OAuth integration');
-    
-    console.log('\n🔧 Management commands:');
-    console.log('  • Status: manager.getServerStatus()');
-    console.log('  • Stop: manager.stopAllServers()');
-    console.log('  • Restart: manager.restartServer(name)');
-    
-    // Keep process alive to monitor servers
-    process.on('SIGINT', async () => {
-      console.log('\n🛑 Gracefully shutting down all MCP servers...');
-      await manager.stopAllServers();
-      console.log('✅ All servers stopped. Goodbye!');
-      process.exit(0);
-    });
-    
-    console.log('\n⏳ MCP servers running. Press Ctrl+C to stop.');
-    
-  } catch (error) {
-    console.error('❌ Failed to start MCP servers:', error.message);
-    console.error('\n🔧 Troubleshooting:');
-    console.error('  1. Run "npm run build" first');
-    console.error('  2. Check if servers are already running');
-    console.error('  3. Run "npm run cleanup-mcp" to clean state');
-    process.exit(1);
-  }
-}
-
-// Run if executed directly
-if (require.main === module) {
-  startMCPServersProper().catch(console.error);
-}
-
-module.exports = { startMCPServersProper };