snow-flow 2.0.2 → 2.0.3

package/scripts/create-env.js

@@ -1,91 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Create .env file for Snow-Flow
- * This helps users set up their ServiceNow credentials
- */
-
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
-
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-
-function question(query) {
-  return new Promise(resolve => rl.question(query, resolve));
-}
-
-async function createEnvFile() {
-  console.log('🔧 Snow-Flow Environment Setup\n');
-  console.log('This will create a .env file with your ServiceNow credentials.\n');
-  
-  // Get ServiceNow instance
-  const instance = await question('ServiceNow instance (e.g., dev12345.service-now.com): ');
-  
-  // Get OAuth credentials
-  const clientId = await question('OAuth Client ID: ');
-  const clientSecret = await question('OAuth Client Secret: ');
-  
-  // Optional Neo4j settings
-  console.log('\n📊 Neo4j Configuration (optional - press Enter to skip)');
-  const neo4jUri = await question('Neo4j URI (default: bolt://localhost:7687): ') || 'bolt://localhost:7687';
-  const neo4jUser = await question('Neo4j username (default: neo4j): ') || 'neo4j';
-  const neo4jPassword = await question('Neo4j password (default: password): ') || 'password';
-  
-  // Create .env content
-  const envContent = `# ServiceNow OAuth Configuration (recommended)
-SNOW_INSTANCE=${instance}
-SNOW_CLIENT_ID=${clientId}
-SNOW_CLIENT_SECRET=${clientSecret}
-
-# OAuth URLs (these are automatically generated)
-OAUTH_TOKEN_URL=https://${instance}/oauth_token.do
-OAUTH_REDIRECT_URI=http://localhost:3000/callback
-
-# Basic Auth Configuration (deprecated - use OAuth instead)
-# Uncomment these lines ONLY if you need to use basic auth:
-# SNOW_USERNAME=your_username
-# SNOW_PASSWORD=your_password
-
-# Neo4j Configuration (optional - for Graph Memory MCP)
-NEO4J_URI=${neo4jUri}
-NEO4J_USER=${neo4jUser}
-NEO4J_PASSWORD=${neo4jPassword}
-
-# Environment
-NODE_ENV=production
-`;
-
-  // Determine where to save .env
-  const isGlobalInstall = __dirname.includes('node_modules/snow-flow') || 
-                         __dirname.includes('.nvm/versions/node');
-  
-  const envPath = isGlobalInstall 
-    ? path.join(__dirname, '..', '.env')
-    : path.join(process.cwd(), '.env');
-  
-  // Write .env file
-  fs.writeFileSync(envPath, envContent);
-  
-  console.log(`\n✅ Created .env file at: ${envPath}`);
-  console.log('🎉 Your ServiceNow credentials are now configured!');
-  console.log('\n💡 Next steps:');
-  console.log('   1. Run: snow-flow init');
-  console.log('   2. Run: snow-flow auth login');
-  console.log('   3. Use /mcp in Claude Code to access ServiceNow tools');
-  
-  rl.close();
-}
-
-// Run if called directly
-if (require.main === module) {
-  createEnvFile().catch(error => {
-    console.error('❌ Error creating .env file:', error.message);
-    process.exit(1);
-  });
-}
-
-module.exports = { createEnvFile };

package/scripts/postinstall.js

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-console.log('🚀 Setting up Snow-Flow...');
-
-// 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
-  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}`);
-  }
-} 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');

package/scripts/register-mcp-servers.js

@@ -1,210 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Register Snow-Flow MCP servers with Claude Desktop
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Claude Code config path
-const CLAUDE_CONFIG_PATH = path.join(
-  os.homedir(),
-  '.claude',
-  'mcp_config.json'
-);
-
-// Snow-Flow MCP servers configuration
-const SNOW_FLOW_SERVERS = {
-  "servicenow-deployment": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-deployment-mcp.js"
-    ]
-  },
-  "servicenow-update-set": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-update-set-mcp.js"
-    ]
-  },
-  "servicenow-intelligent": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-intelligent-mcp.js"
-    ]
-  },
-  "servicenow-memory": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-memory-mcp.js"
-    ]
-  },
-  "servicenow-graph-memory": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-graph-memory-mcp.js"
-    ]
-  },
-  "servicenow-operations": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-operations-mcp.js"
-    ]
-  },
-  "servicenow-platform-development": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-platform-development-mcp.js"
-    ]
-  },
-  "servicenow-integration": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-integration-mcp.js"
-    ]
-  },
-  "servicenow-automation": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-automation-mcp.js"
-    ]
-  },
-  "servicenow-security-compliance": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-security-compliance-mcp.js"
-    ]
-  },
-  "servicenow-reporting-analytics": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-reporting-analytics-mcp.js"
-    ]
-  },
-  "servicenow-flow-composer": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/servicenow-flow-composer-mcp.js"
-    ]
-  },
-  "snow-flow": {
-    "command": "node",
-    "args": [
-      "${SNOW_FLOW_PATH}/dist/mcp/snow-flow-mcp.js"
-    ]
-  }
-};
-
-async function registerMCPServers() {
-  try {
-    // Determine Snow-Flow installation path
-    const isGlobalInstall = __dirname.includes('node_modules/snow-flow') || 
-                           __dirname.includes('.nvm/versions/node');
-    
-    const snowFlowPath = process.env.SNOW_FLOW_PATH || 
-                        (isGlobalInstall ? path.resolve(__dirname, '..') : process.cwd());
-    
-    // Replace ${SNOW_FLOW_PATH} with actual path
-    const servers = JSON.parse(JSON.stringify(SNOW_FLOW_SERVERS));
-    Object.keys(servers).forEach(key => {
-      // Replace path placeholder
-      if (servers[key].args && servers[key].args[0]) {
-        servers[key].args[0] = servers[key].args[0].replace('${SNOW_FLOW_PATH}', snowFlowPath);
-      }
-      
-      // Add environment variables from .env if it exists
-      const envPath = path.join(snowFlowPath, '.env');
-      if (fs.existsSync(envPath)) {
-        try {
-          const envContent = fs.readFileSync(envPath, 'utf8');
-          const envVars = {};
-          
-          envContent.split('\n').forEach(line => {
-            // Skip comments and empty lines
-            if (line.trim() && !line.trim().startsWith('#')) {
-              const [key, ...valueParts] = line.split('=');
-              if (key && valueParts.length > 0) {
-                const value = valueParts.join('=').trim().replace(/^["']|["']$/g, '');
-                envVars[key.trim()] = value;
-              }
-            }
-          });
-          
-          // Add env vars to server config
-          if (Object.keys(envVars).length > 0) {
-            servers[key].env = envVars;
-          }
-        } catch (err) {
-          console.warn('⚠️  Could not read .env file:', err.message);
-        }
-      }
-    });
-
-    // Check if Claude config exists
-    if (!fs.existsSync(CLAUDE_CONFIG_PATH)) {
-      console.log('⚠️  Claude Code configuration not found.');
-      console.log('📍 Creating new configuration at:', CLAUDE_CONFIG_PATH);
-      
-      // Ensure directory exists
-      const configDir = path.dirname(CLAUDE_CONFIG_PATH);
-      if (!fs.existsSync(configDir)) {
-        fs.mkdirSync(configDir, { recursive: true });
-      }
-      
-      // Create new config with "servers" (Claude Code expects this)
-      const newConfig = {
-        servers: servers
-      };
-      
-      fs.writeFileSync(CLAUDE_CONFIG_PATH, JSON.stringify(newConfig, null, 2));
-      console.log('✅ Created new Claude Code configuration with Snow-Flow MCP servers');
-    } else {
-      // Read existing config
-      let config = JSON.parse(fs.readFileSync(CLAUDE_CONFIG_PATH, 'utf8'));
-      
-      // Initialize servers if not exists (Claude Code uses "servers")
-      if (!config.servers) {
-        config.servers = {};
-      }
-      
-      // Add Snow-Flow servers
-      let addedCount = 0;
-      Object.keys(servers).forEach(key => {
-        if (!config.servers[key]) {
-          config.servers[key] = servers[key];
-          addedCount++;
-        }
-      });
-      
-      // Write updated config
-      fs.writeFileSync(CLAUDE_CONFIG_PATH, JSON.stringify(config, null, 2));
-      
-      if (addedCount > 0) {
-        console.log(`✅ Added ${addedCount} Snow-Flow MCP servers to Claude Code configuration`);
-      } else {
-        console.log('✅ All Snow-Flow MCP servers already registered');
-      }
-    }
-    
-    console.log('\n📋 Registered MCP servers:');
-    Object.keys(servers).forEach(key => {
-      console.log(`   - ${key}`);
-    });
-    
-    console.log('\n🔄 MCP servers are now available in Claude Code');
-    console.log('💡 Use /mcp in Claude Code to verify the servers are available');
-    
-  } catch (error) {
-    console.error('❌ Error registering MCP servers:', error.message);
-    process.exit(1);
-  }
-}
-
-// Run if called directly
-if (require.main === module) {
-  registerMCPServers();
-}
-
-module.exports = { registerMCPServers };

package/scripts/reset-mcp-servers.js

@@ -1,246 +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...');
-  
-  const serverPath = path.join(__dirname, '..', 'dist', 'mcp', 'start-all-mcp-servers.js');
-  
-  if (!fs.existsSync(serverPath)) {
-    log('  ⚠ MCP server starter not found. Run "npm run build" first.', 'yellow');
-    return;
-  }
-  
-  log('  Starting MCP servers in background...', 'cyan');
-  
-  const child = spawn('node', [serverPath], {
-    detached: true,
-    stdio: 'ignore'
-  });
-  
-  child.unref();
-  
-  log('  ✓ MCP servers starting...', 'green');
-  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/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');
-}