snow-flow 5.0.2 → 5.0.5

package/.mcp.json

@@ -1,220 +1,22 @@
 {
-  "mcpServers": {
-    "servicenow-deployment": {
+  "servers": {
+    "servicenow-unified": {
       "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-deployment-mcp.js"
-      ],
-      "description": "Widget and artifact deployment with COHERENCE VALIDATION - ensures HTML template, client script, server script work together perfectly. Tools: snow_deploy, snow_update, snow_validate_deployment, snow_rollback_deployment, snow_deployment_status, snow_export_artifact, snow_import_artifact, snow_preview_widget, snow_widget_test, snow_create_solution_package",
+      "args": ["/Users/nielsvanderwerf/Projects/snow-flow-dev/snow-flow/dist/mcp/servicenow-mcp-unified/index.js"],
+      "description": "Unified ServiceNow MCP Server - ALL 235+ ServiceNow tools in ONE server including: deployment, operations, automation, platform dev, integrations, properties, update sets, dev assistant, security, reporting, ML, knowledge, catalog, change management, virtual agent, PA, flows, workspaces, mobile, UI Builder, CMDB, events, HR, CSM, DevOps, advanced features, and local development",
       "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}",
-        "SNOW_DEPLOYMENT_TIMEOUT": "${SNOW_DEPLOYMENT_TIMEOUT}",
-        "MCP_DEPLOYMENT_TIMEOUT": "${MCP_DEPLOYMENT_TIMEOUT}"
+        "SERVICENOW_INSTANCE_URL": "${SNOW_INSTANCE}",
+        "SERVICENOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
+        "SERVICENOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
       }
     },
-    "servicenow-operations": {
+    "snow-flow-orchestration": {
       "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-operations-mcp.js"
-      ],
-      "description": "Core ServiceNow operations - universal table query (snow_query_table), CRUD operations, incident/request/problem management, CMDB search, user/group management, catalog items, knowledge search, field discovery (snow_discover_table_fields), get by sys_id",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-automation": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-automation-mcp.js"
-      ],
-      "description": "Script execution with output capture (snow_execute_script_with_output), scheduled jobs, event rules, notifications, SLA definitions, workflow activities, script history, REST testing, system logs (snow_get_logs), execution tracing, background scripts with autoConfirm option",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-platform-development": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-platform-development-mcp.js"
-      ],
-      "description": "Platform development - create UI pages, script includes, business rules, client scripts, UI policies/actions, ACLs, dictionary entries, catalog items, workflows, transform maps",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-integration": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-integration-mcp.js"
-      ],
-      "description": "Integration management - REST messages, SOAP messages, transform maps, import sets, web services, email configuration, OAuth providers, endpoint discovery, integration testing",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-system-properties": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-system-properties-mcp.js"
-      ],
-      "description": "System property management - get/set/list/delete properties (snow_property_get, snow_property_set), bulk operations, import/export JSON, validate values, search by pattern, categories, audit history",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-update-set": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-update-set-mcp.js"
-      ],
-      "description": "Update set management - create/switch/complete update sets, preview changes, export/import XML, ensure active update set, add artifacts to sets, batch operations",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-development-assistant": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-development-assistant-mcp.js"
-      ],
-      "description": "Development assistance - code generation, best practices, pattern recommendations, code review, performance optimization, ES5 conversion, documentation generation, requirement analysis (snow_find_artifact, snow_edit_artifact, snow_analyze_artifact)",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-security-compliance": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-security-compliance-mcp.js"
-      ],
-      "description": "Security and compliance - security policies, compliance rules (SOX/GDPR/HIPAA), audit trails, access control review, vulnerability scanning, risk assessment, encryption settings",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-reporting-analytics": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-reporting-analytics-mcp.js"
-      ],
-      "description": "Reporting and analytics - create reports/dashboards/KPIs, data visualization, performance analytics, scheduled reports, data quality analysis, metrics collection, trend analysis",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-machine-learning": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-machine-learning-mcp.js"
-      ],
-      "description": "Machine learning - train/classify incidents (snow_train_classifier), change risk prediction, anomaly detection, forecast incidents, sentiment analysis, process optimization, hybrid recommendations with TensorFlow.js",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-knowledge-catalog": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-knowledge-catalog-mcp.js"
-      ],
-      "description": "Knowledge and catalog management - CORRECTED v3.6.10 with proper catalog UI policy creation (2-table system: policy with embedded conditions string, separate actions table). Create/search/update knowledge articles, catalog items, variables, UI policies with conditions as query string and actions array",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-change-virtualagent-pa": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-change-virtualagent-pa-mcp.js"
-      ],
-      "description": "Change management, Virtual Agent, and Performance Analytics - create/manage change requests, CAB meetings, VA topics/blocks, conversations, PA indicators/widgets/breakdowns, thresholds, data collection",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-flow-workspace-mobile": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-flow-workspace-mobile-mcp.js"
-      ],
-      "description": "Flow Designer, Workspace, and Mobile - create flows/actions/subflows/triggers, test flows, workspaces/tabs/lists, contextual panels, mobile app config, layouts, push notifications, offline sync",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-cmdb-event-hr-csm-devops": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-cmdb-event-hr-csm-devops-mcp.js"
-      ],
-      "description": "CMDB, Event Management, HR, CSM, and DevOps - create CIs/relationships, discovery, impact analysis, events/alerts, HR cases/onboarding, customer cases/accounts, DevOps pipelines/deployments",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-advanced-features": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/advanced/servicenow-advanced-features-mcp.js"
-      ],
-      "description": "Advanced features - batch API operations (80% reduction), table relationships analysis, query optimization, field usage analysis, code pattern detection, process discovery, workflow analysis, documentation generation",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-local-development": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/servicenow-local-development-mcp.js"
-      ],
-      "description": "UNIVERSAL ARTIFACT DETECTION v3.6.6 - finds ANY ServiceNow record by sys_id using sys_metadata! Pull any artifact (even custom tables) to local files with Claude Code native tools. Supports all tables, generic artifact creation for unknown types, smart chunking, ES5 validation, coherence checking. Tools: snow_pull_artifact, snow_push_artifact, snow_validate_artifact_coherence",
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "snow-flow": {
-      "command": "node",
-      "args": [
-        "/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow/dist/mcp/snow-flow-mcp.js"
-      ],
-      "description": "Snow-Flow orchestration - swarm init/status, agent spawn/discover, task orchestrate/categorize, neural train/patterns (TensorFlow.js), memory store/search (timeout-protected), performance reports, token usage tracking",
+      "args": ["/Users/nielsvanderwerf/Projects/snow-flow-dev/snow-flow/dist/mcp/snow-flow-mcp.js"],
+      "description": "Snow-Flow orchestration - swarm coordination, agent spawning, task orchestration, neural training (TensorFlow.js), memory management, performance tracking",
       "env": {
         "SNOW_FLOW_ENV": "${SNOW_FLOW_ENV}"
       }
     }
   }
-}
+}

package/.mcp.json.template

@@ -1,5 +1,5 @@
 {
-  "mcpServers": {
+  "servers": {
     "servicenow-unified": {
       "command": "node",
       "args": ["{{PROJECT_ROOT}}/dist/mcp/servicenow-mcp-unified/index.js"],

package/README.md

@@ -80,16 +80,31 @@ snow-flow auth status
 
 #### ServiceNow OAuth Configuration
 
-To set up OAuth in your ServiceNow instance:
-
-1. **Navigate to System OAuth → Application Registry**
-2. **Click "New" → "Create an OAuth API endpoint"** (not client credentials)
-3. **Fill required fields:**
-   - Name: `Snow-Flow Integration`
-   - Client ID: `snow-flow-client`  
-   - Redirect URL: `http://localhost:3000/callback`
-4. **Save and copy the Client ID and Client Secret**
-5. **Run `snow-flow auth login`** - this opens browser for authentication
+⚠️ **IMPORTANT:** Snow-Flow uses OAuth 2.0 Authorization Code Flow with browser authentication. Follow these exact steps:
+
+1. **Navigate to:** System OAuth → Application Registry
+2. **Click:** New → **"Create an OAuth API endpoint for external clients"**
+3. **Configure OAuth Application:**
+   - **Name:** `Snow-Flow Integration` (or any name you prefer)
+   - **Redirect URL:** `http://localhost:3005/callback` ⚠️ **MUST be exactly this!**
+   - **Refresh Token Lifespan:** `0` (unlimited - recommended)
+   - **Access Token Lifespan:** `1800` (30 minutes)
+4. **Save** - ServiceNow will auto-generate:
+   - Client ID (copy this)
+   - Client Secret (copy this - shown only once!)
+5. **Create `.env` file** in your project with:
+   ```bash
+   SNOW_INSTANCE=your-instance.service-now.com
+   SNOW_CLIENT_ID=<your_client_id>
+   SNOW_CLIENT_SECRET=<your_client_secret>
+   ```
+6. **Run:** `snow-flow auth login`
+   - Opens browser automatically for ServiceNow login
+   - Redirects to `http://localhost:3005/callback` after authentication
+   - Stores OAuth tokens locally for future use
+
+**Why this exact redirect URL?**
+Snow-Flow starts a local OAuth callback server on port 3005. ServiceNow must redirect to **exactly** `http://localhost:3005/callback` - any mismatch (wrong port, missing `/callback`) will cause "Invalid redirect_uri" errors.
 
 #### Common Authentication Issues
 

package/dist/cli.js

@@ -574,7 +574,7 @@ async function executeClaudeCode(prompt) {
         // SDK automatically initializes MCP servers from configuration
         if (hasMcpConfig) {
             console.log(chalk_1.default.blue('ℹ️  MCP servers managed by Claude Agent SDK v0.1.1'));
-            console.log(chalk_1.default.green('✅ 448 ServiceNow tools available via SDK integration'));
+            console.log(chalk_1.default.green('✅ 235+ ServiceNow tools available via unified MCP server'));
         }
         // Launch Claude Code with MCP config and skip permissions to avoid raw mode issues
         const claudeArgs = hasMcpConfig
@@ -1720,14 +1720,14 @@ program
         console.log(chalk_1.default.green.bold('\n✅ Snow-Flow project initialized successfully!'));
         console.log('\n📋 Created Snow-Flow configuration:');
         console.log('   ✓ .claude/ - Claude Code MCP configuration');
-        console.log('   ✓ .mcp.json - 20+ ServiceNow MCP servers (240+ tools including complete UX Workspace workflow)');
+        console.log('   ✓ .mcp.json - 2 unified MCP servers (235+ tools including complete UX Workspace workflow)');
         console.log('   ✓ CLAUDE.md - Complete development guide');
         console.log('   ✓ README.md - Current capabilities documentation');
         console.log('   ✓ .snow-flow/ - Project workspace and memory');
         if (!options.skipMcp) {
             // NOTE: MCP servers now managed by Claude Agent SDK (v4.7.0+)
             console.log(chalk_1.default.blue('\nℹ️  MCP servers now managed by Claude Agent SDK v0.1.1'));
-            console.log(chalk_1.default.green('✅ 448 ServiceNow tools automatically available via SDK'));
+            console.log(chalk_1.default.green('✅ 235+ ServiceNow tools automatically available via unified server'));
             console.log(chalk_1.default.blue('📋 SDK handles MCP server lifecycle automatically'));
         }
         console.log(chalk_1.default.blue.bold('\n🎯 Next steps:'));
@@ -1736,7 +1736,7 @@ program
         console.log('2. Authenticate Snow-Flow: ' + chalk_1.default.cyan('snow-flow auth login'));
         console.log('3. Start developing: ' + chalk_1.default.cyan('snow-flow swarm "create incident dashboard"'));
         console.log('\n📚 Complete documentation: ' + chalk_1.default.blue('https://snow-flow.dev'));
-        console.log('💡 Complete 6-step UX Workspace creation, UI Builder, and 240+ tools now available');
+        console.log('💡 Complete UX Workspace creation, UI Builder, and 235+ unified tools now available');
         // Force exit to prevent hanging
         process.exit(0);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "snow-flow",
-  "version": "5.0.2",
-  "description": "CLAUDE AGENT SDK INTEGRATION - v5.0.2 with @anthropic-ai/claude-agent-sdk@0.1.1 (official latest) featuring 86% code reduction (2832→400 lines), unified MCP server (235+ tools), SDK-native execution, intelligent orchestration, advanced memory, and 2.8-4.4x parallelization speedup.",
+  "version": "5.0.5",
+  "description": "CLAUDE AGENT SDK INTEGRATION - v5.0.5 with @anthropic-ai/claude-agent-sdk@0.1.1 (official latest) featuring 86% code reduction (2832→400 lines), unified MCP server (235+ tools), SDK-native execution, intelligent orchestration, advanced memory, and 2.8-4.4x parallelization speedup.",
   "main": "dist/index.js",
   "type": "commonjs",
   "bin": {