snow-flow 2.0.0 → 2.0.2

package/.env.example

@@ -12,10 +12,53 @@ OAUTH_REDIRECT_URI=http://localhost:3000/callback
 # SNOW_USERNAME=your_username
 # SNOW_PASSWORD=your_password
 
-# Neo4j Configuration (optional - for Graph Memory MCP)
-NEO4J_URI=bolt://localhost:7687
-NEO4J_USER=neo4j
-NEO4J_PASSWORD=password
+# ===========================================
+# Snow-Flow Configuration
+# ===========================================
 
-# Environment
-NODE_ENV=production
+# Enable debug logging (true/false)
+SNOW_FLOW_DEBUG=false
+
+# Default coordination strategy
+SNOW_FLOW_STRATEGY=development
+
+# Maximum number of agents
+SNOW_FLOW_MAX_AGENTS=5
+
+# Claude Code timeout configuration (in minutes)
+# Set to 0 to disable timeout (infinite execution time)
+# Default: 60 minutes
+SNOW_FLOW_TIMEOUT_MINUTES=0
+
+# ===========================================
+# Deployment Timeout Configuration
+# ===========================================
+
+# ServiceNow API timeout for regular operations (milliseconds)
+# Default: 60000 (60 seconds)
+SNOW_REQUEST_TIMEOUT=60000
+
+# ServiceNow API timeout for DEPLOYMENT operations (milliseconds)
+# Deployments need more time for complex widgets
+# Default: 300000 (5 minutes)
+SNOW_DEPLOYMENT_TIMEOUT=300000
+
+# MCP transport timeout for deployment operations (milliseconds)
+# Should be higher than SNOW_DEPLOYMENT_TIMEOUT
+# Default: 360000 (6 minutes)
+MCP_DEPLOYMENT_TIMEOUT=360000
+
+# ===========================================
+# How to Set Up ServiceNow OAuth
+# ===========================================
+# 1. Log into your ServiceNow instance as admin
+# 2. Navigate to: System OAuth > Application Registry
+# 3. Click "New" > "Create an OAuth application"
+# 4. Fill in:
+#    - Name: Snow-Flow Development
+#    - Client ID: (will be generated)
+#    - Client Secret: (will be generated)  
+#    - Redirect URL: http://${SNOW_REDIRECT_HOST:-localhost}:${SNOW_REDIRECT_PORT:-3000}/callback
+#    - Grant Type: Authorization Code
+# 5. Copy the Client ID and Client Secret to this file
+# 6. Run: snow-flow auth login

package/README.md

@@ -1,4 +1,4 @@
-# Snow-Flow: AI-Powered ServiceNow Development Platform
+# 🏔️ Snow-Flow: AI-Powered ServiceNow Development Platform
 
 [![npm version](https://badge.fury.io/js/snow-flow.svg)](https://badge.fury.io/js/snow-flow)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -61,29 +61,62 @@ Snow-Flow understands your intent and orchestrates the entire implementation.
 
 ## 🚀 Getting Started
 
-### Installation
+### 1. Installation
 ```bash
 npm install -g snow-flow
 ```
 
-### Quick Setup
+### 2. Initialize Snow-Flow
 ```bash
-# Initialize your project
 snow-flow init
+```
+This creates:
+- `.env` file for your credentials
+- `.mcp.json` for Claude Code integration
+- Project configuration files
+
+### 3. Configure OAuth Credentials
+Edit the generated `.env` file with your ServiceNow OAuth details:
+```env
+SNOW_INSTANCE=your-instance.service-now.com
+SNOW_CLIENT_ID=your-oauth-client-id
+SNOW_CLIENT_SECRET=your-oauth-client-secret
+```
 
-# Configure ServiceNow OAuth credentials
-snow-flow auth setup
+### 4. Authenticate
+```bash
+snow-flow auth login
+```
+This opens your browser for OAuth authentication.
 
-# Start developing!
-snow-flow swarm "Create an IT service portal with catalog items"
+### 5. Start Building!
+```bash
+snow-flow swarm "Create an incident management dashboard with real-time updates"
 ```
 
-### Use with Claude Code
-Add to your Claude Code configuration:
+### 💡 Quick Examples
 ```bash
-/mcp
+# Analyze your ServiceNow instance
+snow-flow swarm "Give me a health check of my ServiceNow instance"
+
+# Build a widget
+snow-flow swarm "Create a widget showing open incidents by priority"
+
+# Optimize performance
+snow-flow swarm "Find and fix performance issues in my incident table"
 ```
-Then access all Snow-Flow tools directly in your Claude conversations.
+
+### ⚠️ Troubleshooting
+
+**OAuth Issues?**
+- Ensure your OAuth client has the necessary scopes in ServiceNow
+- Check that the redirect URI is set to `http://localhost:3000/callback`
+- Try `snow-flow auth logout` then `snow-flow auth login` again
+
+**MCP Connection Failed?**
+- Run `snow-flow init --force` to regenerate configuration
+- Restart Claude Code after configuration changes
+- Check logs with `snow-flow logs`
 
 ## 📊 Real-World Impact
 
@@ -123,7 +156,7 @@ snow-flow coop export --format update-set
 
 ### **Bring Your Own LLM** 🧠
 Choose your preferred AI backend:
-- **OpenAI GPT-4**: For maximum capability
+- **OpenAI GPT**: For maximum capability
 - **Anthropic Claude**: For nuanced understanding
 - **Local Models**: For complete data privacy
 - **Custom Fine-tuned**: For organization-specific patterns

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Snow-Flow: ServiceNow Advanced Intelligence Platform - 100+ real MCP tools with AI-powered swarm orchestration. Zero Mock Data, 100% Real API Integration. Natural language interface for ServiceNow operations.",
   "main": "dist/index.js",
   "type": "commonjs",

package/.claude.mcp-config.template

@@ -1,149 +0,0 @@
-{
-  "servers": {
-    "servicenow-deployment": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-deployment-mcp.js"
-      ],
-      "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-update-set": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-update-set-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-intelligent": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-intelligent-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-memory": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-memory-mcp.js"
-      ],
-      "env": {
-        "MEMORY_PATH": "${MEMORY_PATH}",
-        "SNOW_FLOW_HOME": "${SNOW_FLOW_HOME}"
-      }
-    },
-    "servicenow-graph-memory": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-graph-memory-mcp.js"
-      ],
-      "env": {
-        "NEO4J_URI": "${NEO4J_URI}",
-        "NEO4J_USER": "${NEO4J_USER}",
-        "NEO4J_PASSWORD": "${NEO4J_PASSWORD}",
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-operations": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-operations-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-platform-development": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-platform-development-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-integration": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-integration-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-automation": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-automation-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-security-compliance": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-security-compliance-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-reporting-analytics": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-reporting-analytics-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "servicenow-flow-composer": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/servicenow-flow-composer-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    },
-    "snow-flow": {
-      "command": "node",
-      "args": [
-        "${MCP_PATH}/snow-flow-mcp.js"
-      ],
-      "env": {
-        "SNOW_FLOW_ENV": "${SNOW_FLOW_ENV}"
-      }
-    }
-  }
-}

package/.claude.settings.template

@@ -1,36 +0,0 @@
-{
-  "enabledMcpjsonServers": [
-    "servicenow-deployment",
-    "servicenow-flow-composer",
-    "servicenow-update-set",
-    "servicenow-intelligent",
-    "servicenow-graph-memory",
-    "servicenow-operations",
-    "servicenow-platform-development",
-    "servicenow-integration",
-    "servicenow-automation",
-    "servicenow-security-compliance",
-    "servicenow-reporting-analytics",
-    "snow-flow"
-  ],
-  "permissions": {
-    "allow": [
-      "Bash(*)",
-      "Read(*)",
-      "Write(*)",
-      "Edit(*)",
-      "MultiEdit(*)",
-      "Glob(*)",
-      "Grep(*)",
-      "LS(*)",
-      "TodoWrite",
-      "Task(*)",
-      "mcp__servicenow-*",
-      "mcp__snow-flow__*"
-    ]
-  },
-  "env": {
-    "BASH_DEFAULT_TIMEOUT_MS": "0",
-    "BASH_MAX_TIMEOUT_MS": "0"
-  }
-}

package/SIMPLE_TEST_COMMANDS.txt

@@ -1,143 +0,0 @@
-SNOW-FLOW v1.4.39 TEST COMMANDS - PLAIN TEXT
-
-Copy each command individually and paste into Claude Code terminal.
-
-=== Snow-Flow Native AI Swarm Orchestration (14 tools) ===
-
-mcp__snow-flow__swarm_init --topology hierarchical --maxAgents 5
-mcp__snow-flow__agent_spawn --type researcher --name Research_Agent
-mcp__snow-flow__task_orchestrate --task Analyze_ServiceNow_best_practices
-mcp__snow-flow__swarm_status
-mcp__snow-flow__memory_usage --action store --key test_result --value success
-mcp__snow-flow__memory_search --pattern test --limit 10
-mcp__snow-flow__neural_train --pattern_type optimization --training_data sample_data
-mcp__snow-flow__neural_patterns --action analyze
-mcp__snow-flow__performance_report --format summary
-mcp__snow-flow__neural_status --modelId default-model
-mcp__snow-flow__token_usage --operation all --timeframe 24h
-mcp__snow-flow__memory_usage --action retrieve --key test_result
-mcp__snow-flow__memory_usage --action list --namespace default
-mcp__snow-flow__memory_usage --action delete --key test_result
-
-=== Update Set Management (9 tools) ===
-
-mcp__servicenow-update-set__snow_update_set_create --name TEST-139_v1.4.39_Testing --description Testing_all_tools
-mcp__servicenow-update-set__snow_update_set_current
-mcp__servicenow-update-set__snow_update_set_list --limit 5
-mcp__servicenow-update-set__snow_update_set_add_artifact --type widget --sys_id test123 --name Test_Widget
-mcp__servicenow-update-set__snow_update_set_preview
-mcp__servicenow-update-set__snow_update_set_complete --notes Testing_completed
-mcp__servicenow-update-set__snow_update_set_export --output_path update_set_export.xml
-mcp__servicenow-update-set__snow_ensure_active_update_set --context testing_v1.4.39
-mcp__servicenow-deployment__snow_smart_update_set --detect_context true
-
-=== Deployment Tools (10 tools) ===
-
-mcp__servicenow-deployment__snow_auth_diagnostics
-mcp__servicenow-deployment__snow_deployment_status --limit 5
-mcp__servicenow-deployment__snow_validate_deployment --type widget --artifact {}
-mcp__servicenow-deployment__snow_export_artifact --type widget --sys_id test123
-mcp__servicenow-deployment__snow_validate_sysid --sys_id test123 --table sp_widget
-mcp__servicenow-deployment__snow_deployment_debug
-mcp__servicenow-deployment__snow_preview_widget --template Test
-mcp__servicenow-deployment__snow_widget_test --sys_id test123
-mcp__servicenow-deployment__snow_deploy --type widget --instruction Create_test_widget
-mcp__servicenow-deployment__snow_create_solution_package --name Test_Package --artifacts []
-
-=== ServiceNow Operations (20 tools) ===
-
-mcp__servicenow-operations__snow_query_incidents --query priority=1 --limit 5
-mcp__servicenow-operations__snow_analyze_incident --incident_id INC0000001
-mcp__servicenow-operations__snow_query_requests --query active=true --limit 5
-mcp__servicenow-operations__snow_query_problems --query active=true --limit 5
-mcp__servicenow-operations__snow_cmdb_search --query server --ci_type server
-mcp__servicenow-operations__snow_user_lookup --identifier admin
-mcp__servicenow-operations__snow_operational_metrics --timeframe week
-mcp__servicenow-operations__snow_pattern__analysis --analysis_type incident_patterns
-mcp__servicenow-operations__snow_knowledge_search --query network_issues
-mcp__servicenow-operations__snow_predictive__analysis --prediction_type incident_volume
-mcp__servicenow-operations__snow_catalog_item_manager --action list
-mcp__servicenow-operations__snow_catalog_item_search --query iPhone
-mcp__servicenow-operations__snow_cleanup_test_artifacts --dry_run true
-mcp__servicenow-operations__snow_create_user_group --name Test_Group_v139
-mcp__servicenow-operations__snow_create_user --user_name test.user.v139 --first_name Test --last_name User --email test@example.com
-mcp__servicenow-operations__snow_assign_user_to_group --user test.user.v139 --group Test_Group_v139
-mcp__servicenow-operations__snow_list_group_members --group Test_Group_v139
-mcp__servicenow-operations__snow_auto_resolve_incident --incident_id INC0000001 --dry_run true
-mcp__servicenow-operations__snow_remove_user_from_group --user test.user.v139 --group Test_Group_v139
-mcp__servicenow-operations__snow_catalog_item_manager --action create --name Test_Item_v139
-
-=== Platform Development (9 tools) ===
-
-mcp__servicenow-platform-development__snow_discover_platform_tables --category all
-mcp__servicenow-platform-development__snow_discover_table_fields --tableName incident
-mcp__servicenow-platform-development__snow_table_schema_discovery --tableName incident
-mcp__servicenow-platform-development__snow_create_ui_page --name test_page_v139 --title Test_Page --html Test
-mcp__servicenow-platform-development__snow_create_script_include --name TestUtils139 --script var_TestUtils139_equals_Class.create()
-mcp__servicenow-platform-development__snow_create_business_rule --name Test_Rule_v139 --tableName incident --script test_comment --when before
-mcp__servicenow-platform-development__snow_create_client_script --name Test_Client_v139 --tableName incident --script test_comment --type onLoad
-mcp__servicenow-platform-development__snow_create_ui_policy --name Test_Policy_v139 --tableName incident --condition priority=1
-mcp__servicenow-platform-development__snow_create_ui_action --name Test_Action_v139 --tableName incident --script test_comment
-
-=== Integration (10 tools) ===
-
-mcp__servicenow-integration__snow_discover_integration_endpoints --type all
-mcp__servicenow-integration__snow_discover_data_sources
-mcp__servicenow-integration__snow_create_rest_message --name Test_REST_v139 --endpoint https://api.example.com
-mcp__servicenow-integration__snow_create_rest_method --restMessageName Test_REST_v139 --methodName GET --httpMethod GET
-mcp__servicenow-integration__snow_create_transform_map --name Test_Transform_v139 --sourceTable import_set --targetTable incident
-mcp__servicenow-integration__snow_create_field_map --transformMapName Test_Transform_v139 --sourceField priority --targetField priority
-mcp__servicenow-integration__snow_create_import_set --name test_import_v139 --label Test_Import
-mcp__servicenow-integration__snow_create_web_service --name Test_WS_v139 --wsdlUrl https://example.com/wsdl
-mcp__servicenow-integration__snow_create_email_config --name Test_Email_v139 --serverType SMTP --serverName smtp.example.com
-mcp__servicenow-integration__snow_test_integration --endpointName Test_REST_v139
-
-=== Reporting & Analytics (11 tools) ===
-
-mcp__servicenow-reporting-analytics__snow_discover_reporting_tables
-mcp__servicenow-reporting-analytics__snow_discover_report_fields --table incident
-mcp__servicenow-reporting-analytics__snow_analyze_data_quality --table incident
-mcp__servicenow-reporting-analytics__snow_create_report --name Test_Report_v139 --table incident --fields number,priority
-mcp__servicenow-reporting-analytics__snow_create_dashboard --name Test_Dashboard_v139 --widgets []
-mcp__servicenow-reporting-analytics__snow_create_kpi --name Test_KPI_v139 --table incident --metric count --aggregation count
-mcp__servicenow-reporting-analytics__snow_create_data_visualization --name Test_Viz_v139 --type bar --dataSource incident
-mcp__servicenow-reporting-analytics__snow_create_performance_analytics --name Test_Analytics_v139 --dataSource incident --metrics count
-mcp__servicenow-reporting-analytics__snow_create_scheduled_report --reportName Test_Report_v139 --schedule daily --recipients test@example.com
-mcp__servicenow-reporting-analytics__snow_generate_insights --table incident
-mcp__servicenow-reporting-analytics__snow_export_report_data --reportName Test_Report_v139 --format CSV
-
-=== Automation (10 tools) ===
-
-mcp__servicenow-automation__snow_discover_schedules
-mcp__servicenow-automation__snow_discover_events
-mcp__servicenow-automation__snow_discover_automation_jobs
-mcp__servicenow-automation__snow_create_scheduled_job --name Test_Job_v139 --script gs.log_test --schedule daily
-mcp__servicenow-automation__snow_create_notification --name Test_Notif_v139 --table incident --when inserted --recipients admin --subject Test --message Test
-mcp__servicenow-automation__snow_create_event_rule --name Test_Event_v139 --eventName incident.insert --script test_comment
-mcp__servicenow-automation__snow_create_sla_definition --name Test_SLA_v139 --table incident --condition priority=1 --duration 1_hour
-mcp__servicenow-automation__snow_create_escalation_rule --name Test_Escalation_v139 --table incident --condition priority=1 --escalationTime 60 --escalationScript test_comment
-mcp__servicenow-automation__snow_create_workflow_activity --name Test_Activity_v139 --workflowName Test_Workflow --activityType approval
-mcp__servicenow-automation__snow_test_scheduled_job --jobName Test_Job_v139
-
-=== Security & Compliance (10 tools) ===
-
-mcp__servicenow-security-compliance__snow_discover_security_frameworks
-mcp__servicenow-security-compliance__snow_discover_security_policies
-mcp__servicenow-security-compliance__snow_create_security_policy --name Test_Policy_v139 --type access --rules []
-mcp__servicenow-security-compliance__snow_create_compliance_rule --name Test_Compliance_v139 --framework SOX --requirement Test --validation true
-mcp__servicenow-security-compliance__snow_create_audit_rule --name Test_Audit_v139 --table incident --events create,update
-mcp__servicenow-security-compliance__snow_create_access_control --name Test_ACL_v139 --table incident --operation read
-mcp__servicenow-security-compliance__snow_create_data_policy --name Test_Data_v139 --table incident --fields priority --classification internal
-mcp__servicenow-security-compliance__snow_create_vulnerability_scan --name Test_Scan_v139 --scope application
-mcp__servicenow-security-compliance__snow_run_compliance_scan --framework SOX
-mcp__servicenow-security-compliance__snow_security_risk_assessment --scope instance
-
-TOTAL: 103 commands across 8 categories
-Expected success rate: ~87% (90/103 tools working)
-
-INSTRUCTIONS:
-1. Copy each command line individually
-2. Paste into Claude Code terminal
-3. Press Enter to run
-4. Wait for result before running next command
-5. Report which commands fail with error details

package/SNOW_FLOW_ADVANCED_FEATURES_PLAIN.txt

@@ -1,78 +0,0 @@
-Snow-Flow Advanced Features Implementation Request
-
-PROJECT GOAL:
-Enhance Snow-Flow with 14 new MCP tools that leverage AI capabilities to provide deep ServiceNow insights, automated documentation, and process mining features that would take humans days but AI can do in seconds.
-
-FEATURE 1: Smart Batch API Operations
-Create snow_batch_api tool that executes multiple ServiceNow operations in a single transaction. Should handle queries, updates, inserts, and deletes across different tables. Return organized results with execution time. Goal is 80 percent reduction in API calls.
-
-FEATURE 2: Table Relationship Mapping  
-Create snow_get_table_relationships tool that maps all dependencies for a given table. Show what tables it extends, references to other tables, and what references it. Include common query patterns. Maximum depth parameter to control traversal.
-
-FEATURE 3: Query Performance Analyzer
-Create snow_analyze_query tool that predicts query performance before execution. Identify missing indexes, suggest optimizations, and provide risk scores. Should work with complex encoded queries and return actionable improvements.
-
-FEATURE 4: Field Usage Intelligence
-Create snow_analyze_field_usage tool that discovers which fields are actually used in queries, views, reports, and business rules. Identify safe-to-deprecate fields and critical dependencies. Help clean technical debt safely.
-
-FEATURE 5: Migration Helper
-Create snow_create_migration_plan tool for moving data between tables. Auto-map fields with confidence scores, identify value mismatches, and generate migration scripts. Focus on custom to out-of-box table migrations.
-
-FEATURE 6: Deep Table Analysis with AI
-Create snow_analyze_table_deep tool that analyzes thousands of records to find patterns humans miss. Discover correlations like Monday incidents take longer to resolve or that certain assignment groups never resolve tickets. Find anomalies and optimization opportunities.
-
-FEATURE 7: Code Pattern Detector
-Create snow_detect_code_patterns tool that finds all variations of code patterns across business rules, client scripts, and script includes. For example, find all 234 different ways developers look up users, identify performance issues, and suggest unified approaches.
-
-FEATURE 8: Predictive Impact Analysis
-Create snow_predict_change_impact tool that predicts cascading effects before making changes. If adding a mandatory field to task table, predict how many forms break, which integrations fail, and what performance impact occurs. Include hidden impacts like mobile app crashes.
-
-FEATURE 9: Auto Documentation Generator
-Create snow_generate_documentation tool that reads tables, relationships, code, and usage patterns to generate complete technical documentation. Include mermaid diagrams, common query examples, performance tips, and pitfalls. AI writes better docs than most developers.
-
-FEATURE 10: Intelligent Refactoring
-Create snow_refactor_code tool that modernizes legacy ServiceNow code. Identify deprecated APIs, add error handling, convert synchronous to async operations, and follow best practices. Include migration guide showing what else needs updating.
-
-FEATURE 11: Process Mining Engine
-Create snow_discover_process tool that analyzes audit logs and state transitions to discover how processes really work versus documentation. Find patterns like ping-pong between teams, zombie tickets, and skip assignment flows. Identify bottlenecks and automation opportunities.
-
-FEATURE 12: Workflow Reality Analyzer
-Create snow_analyze_workflow_execution tool specifically for Flow Designer and Workflow Editor flows. Analyze thousands of executions to find where flows deviate from design, common failure points, and optimization opportunities.
-
-FEATURE 13: Cross Table Process Discovery
-Create snow_discover_cross_table_process tool that follows processes across multiple tables. For example, track a request from sc_request through req_item, task, asset, to incident. Find hidden patterns and compliance issues.
-
-FEATURE 14: Real Time Process Monitoring
-Create snow_monitor_process tool that watches processes in real-time and alerts on deviations, bottlenecks, or SLA risks. Detect when tickets bounce too many times or follow anti-patterns.
-
-IMPLEMENTATION REQUIREMENTS:
-- All tools should integrate with existing Snow-Flow MCP architecture
-- Cache results in Snow-Flow memory system for performance
-- Tools should work with ServiceNow instances via REST API
-- Respect all ACLs and security constraints
-- Implement rate limiting to avoid instance impact
-- Each tool should complete analysis in under 30 seconds
-- Results should be actionable, not just informational
-
-SUCCESS METRICS:
-- Batch API reduces calls by 80 percent
-- Query analyzer catches 90 percent of slow queries
-- Process mining finds at least 5 optimization opportunities per process
-- Documentation generator creates docs 10x faster than manual
-- Pattern detector finds 95 percent of code variations
-
-TECHNICAL APPROACH:
-- Use existing ServiceNow MCP server infrastructure
-- Leverage Snow-Flow memory for caching and coordination
-- Implement progressive loading for large datasets
-- Use TypeScript for all new code
-- Follow Snow-Flow coding standards
-- Add comprehensive error handling
-- Include unit tests for each tool
-
-PRIORITY ORDER:
-1. First implement features 1-5 (practical daily tools)
-2. Then implement features 6-10 (AI-powered analysis)  
-3. Finally implement features 11-14 (process mining)
-
-This gives developers immediate value while building toward advanced process mining capabilities that will revolutionize how people understand their ServiceNow instances.