snow-flow 3.2.0 → 3.2.2

package/README.md

@@ -1,4 +1,4 @@
-# 🏔️ Snow-Flow: AI-Powered ServiceNow Development Platform
+# Snow-Flow: ServiceNow Development Platform
 
 [![npm version](https://img.shields.io/npm/v/snow-flow.svg)](https://www.npmjs.com/package/snow-flow)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -8,453 +8,472 @@
 [![ServiceNow Compatible](https://img.shields.io/badge/ServiceNow-Compatible-00A1E0?logo=servicenow)](https://www.servicenow.com)
 [![GitHub Stars](https://img.shields.io/github/stars/groeimetai/snow-flow?style=social)](https://github.com/groeimetai/snow-flow)
 
-Snow-Flow revolutionizes ServiceNow development by bringing the power of AI orchestration directly to your platform. With 100+ MCP tools and intelligent multi-agent coordination, Snow-Flow transforms how developers and administrators work with ServiceNow.
+Snow-Flow is an AI-powered development platform for ServiceNow that provides 180+ MCP tools and multi-agent coordination. It enables developers and administrators to interact with ServiceNow through natural language commands and automated workflows.
 
-## 🚀 Why Snow-Flow?
+## Core Functionality
 
-### **Accelerate Development by 10x**
-Traditional ServiceNow development requires deep platform knowledge, manual coding, and countless hours of configuration. Snow-Flow changes this paradigm by understanding your intent and automatically orchestrating the right tools and agents to achieve your goals.
+Snow-Flow connects directly to ServiceNow instances through OAuth 2.0 authentication and provides:
 
-### **Learn While You Build**
-Every interaction with Snow-Flow provides insights into ServiceNow best practices, platform capabilities, and optimal implementation patterns. It's like having a ServiceNow expert guiding you through every step.
+- Direct API integration with ServiceNow REST endpoints
+- Multi-agent system with specialized agents for different tasks
+- Natural language interface for ServiceNow operations
+- Machine learning capabilities using TensorFlow.js
+- Process automation and workflow optimization
 
-### **Real Integration, Real Results**
-Unlike mock tools or simulations, Snow-Flow connects directly to your ServiceNow instance through secure OAuth authentication. Every operation is real, every deployment is functional, and every result is production-ready.
+## ServiceNow API Integration
 
-## 🎉 Version 3.0.2 - Init Command Fixed
+### Authentication
+Snow-Flow uses OAuth 2.0 for secure authentication with ServiceNow:
 
-### **Latest Fix (v3.0.2)**
-- 🔧 **Init Command Fixed** - Now correctly uses .env.template with v3.0.1 timeout configuration
-- 🎯 **No Timeouts by Default** - Operations run until completion for maximum reliability
-- 🎛️ **Optional Timeout Configuration** - All timeouts commented out in generated .env file
-- 🚀 **100% Completion Rate** - No artificial timeout limitations
-
-### **What's New in v3.0.0**
-- ✅ **100% Real Implementation** - No more simulated/mock/demo code
-- ✅ **Fixed MCP Transport Layer** - Resolved memory_usage hanging issues
-- ✅ **Real TensorFlow.js ML** - Actual neural networks, not regex matching
-- ✅ **Direct ServiceNow API** - Widget deployment bypasses broken MCP
-- ✅ **Reliable Memory Manager** - In-memory storage with timeout protection
-- ✅ **Proper Error Handling** - All operations have timeout protection
-- ✅ **Production Ready** - All integration tests passing
-
-### **Critical Issues Fixed**
-- **Memory Operations**: No more hanging on memory_usage calls
-- **Widget Deployment**: Direct API implementation that actually works
-- **ML Accuracy**: Real neural networks delivering actual predictions
-- **Process Management**: No more zombie MCP processes
-- **Error Messages**: Clear, actionable error messages throughout
-
-## 🔐 ServiceNow API Integration & Security
-
-### **Direct ServiceNow API Connection**
-All 100+ MCP tools use **official ServiceNow REST APIs** exclusively:
-- **No third-party services** - Your data stays between you and ServiceNow
-- **Standard OAuth 2.0** - Industry-standard authentication protocol
-- **ServiceNow ACLs respected** - Only access what your ServiceNow user can access
-- **Real-time operations** - Direct API calls, no data caching or storage
-
-### **How OAuth Authentication Works**
 ```bash
 snow-flow auth login
-# 1. Opens ServiceNow OAuth consent screen in your browser
-# 2. You authenticate with YOUR ServiceNow credentials
-# 3. ServiceNow returns OAuth token directly to Snow-Flow
-# 4. Token stored locally in ~/.snow-flow/auth.json (encrypted)
-# 5. All API calls use this token with proper ServiceNow permissions
+# Opens ServiceNow OAuth consent screen
+# Authenticate with ServiceNow credentials
+# Token stored locally in ~/.snow-flow/auth.json
 ```
 
-### **Data Privacy & Security**
-- ✅ **Zero data collection** - Snow-Flow doesn't collect or store your ServiceNow data
-- ✅ **Local processing** - All operations happen on your machine
-- ✅ **No external servers** - Direct ServiceNow ↔ Snow-Flow communication only
-- ✅ **Audit compliance** - All actions logged in ServiceNow audit trails
-- ✅ **Role-based access** - Respects your ServiceNow user permissions exactly
+### Security
+- OAuth 2.0 authentication protocol
+- Respects ServiceNow ACLs and user permissions
+- Local token storage with encryption
+- No external data transmission
+- All operations logged in ServiceNow audit trails
 
-### **Network Architecture**
+### Network Architecture
 ```
 ┌─────────────┐    OAuth 2.0 + REST APIs    ┌─────────────────┐
 │  Snow-Flow  │ ◄─────────────────────────► │ Your ServiceNow │
 │   (Local)   │      HTTPS Only              │    Instance     │
 └─────────────┘                              └─────────────────┘
-     ▲                                               
-     │ No external connections                       
-     ▼                                               
-┌─────────────┐                                     
-│ Claude Code │ ◄── Local AI processing only        
-│   (Local)   │                                     
-└─────────────┘                                     
 ```
 
-## ✨ Core Capabilities
-
-### 🤖 **Intelligent Multi-Agent System**
-- **38 Specialized Agents**: From architects to testers, each agent brings specific expertise
-- **Swarm Coordination**: Agents work together using hierarchical, mesh, or adaptive topologies
-- **Shared Memory**: Persistent knowledge base ensures consistency across all operations
-- **Neural Learning**: Pattern recognition improves suggestions and automation over time
-
-### 🔧 **100+ ServiceNow MCP Tools**
-
-#### 🎯 **Universal Query Tool** - One Tool for ALL Tables
-The revolutionary `snow_query_table` replaces all table-specific query tools with intelligent performance optimization:
+## Available Tools
+
+Snow-Flow provides 180+ tools across 17 specialized MCP servers:
+
+## Complete Tool Reference
+
+### MCP Server Overview
+
+| Server | Tools | Primary Focus |
+|--------|-------|---------------|
+| servicenow-operations | 15 | CRUD operations, data management |
+| servicenow-deployment | 20 | Widget, portal, and application deployment |
+| servicenow-platform-development | 12 | Table creation, field management |
+| servicenow-machine-learning | 15 | Neural networks, predictions, anomaly detection |
+| servicenow-reporting-analytics | 18 | Dashboards, reports, KPIs |
+| servicenow-security-compliance | 14 | Security scanning, ACLs, compliance |
+| servicenow-update-set | 10 | Change packaging, version control |
+| servicenow-automation | 22 | Business rules, scheduled jobs, ATF testing |
+| servicenow-integration | 10 | REST/SOAP, data import/export |
+| servicenow-advanced-features | 15 | Process mining, advanced analytics |
+| servicenow-knowledge-catalog | 15 | Knowledge management, service catalog |
+| servicenow-change-virtualagent-pa | 19 | Change management, virtual agent, PA |
+| servicenow-flow-workspace-mobile | 20 | Flow Designer, agent workspace, mobile |
+| servicenow-cmdb-event-hr-csm-devops | 23 | CMDB, events, HR, CSM, DevOps |
+| servicenow-performance-optimization | 8 | Query optimization, batch operations |
+| servicenow-process-intelligence | 10 | Process mining and discovery |
+| snow-flow | 12 | Orchestration, memory management |
+
+### Detailed Tool Listing by Server
+
+#### 1. ATF Testing Tools (servicenow-automation)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_atf_test | Create automated test | sys_atf_test |
+| snow_create_atf_test_step | Add test steps | sys_atf_step |
+| snow_execute_atf_test | Execute tests | sys_atf_test_result |
+| snow_get_atf_results | Get test results | sys_atf_test_result |
+| snow_create_atf_test_suite | Create test suite | sys_atf_test_suite |
+| snow_discover_atf_tests | Find existing tests | sys_atf_test, sys_atf_test_suite |
+
+#### 2. Knowledge Management (servicenow-knowledge-catalog)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_knowledge_article | Create KB article | kb_knowledge |
+| snow_search_knowledge | Search articles | kb_knowledge |
+| snow_update_knowledge_article | Update article | kb_knowledge |
+| snow_retire_knowledge_article | Retire article | kb_knowledge |
+| snow_create_knowledge_base | Create KB | kb_knowledge_base |
+| snow_discover_knowledge_bases | List KBs | kb_knowledge_base |
+| snow_get_knowledge_stats | Article statistics | kb_knowledge |
+| snow_knowledge_feedback | Manage feedback | kb_feedback |
+
+#### 3. Service Catalog (servicenow-knowledge-catalog)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_catalog_item | Create catalog item | sc_cat_item |
+| snow_create_catalog_variable | Create variables | item_option_new |
+| snow_create_catalog_ui_policy | Create UI policies | catalog_ui_policy |
+| snow_order_catalog_item | Submit order | sc_req_item |
+| snow_search_catalog | Search catalog | sc_cat_item |
+| snow_get_catalog_item_details | Get item details | sc_cat_item |
+| snow_discover_catalogs | List catalogs | sc_catalog |
+
+#### 4. Change Management (servicenow-change-virtualagent-pa)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_change_request | Create change | change_request |
+| snow_create_change_task | Create task | change_task |
+| snow_get_change_request | Get change details | change_request |
+| snow_update_change_state | Update state | change_request |
+| snow_schedule_cab_meeting | Schedule CAB | cab_meeting |
+| snow_search_change_requests | Search changes | change_request |
+
+#### 5. Virtual Agent (servicenow-change-virtualagent-pa)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_va_topic | Create topic | sys_cs_topic |
+| snow_create_va_topic_block | Create blocks | sys_cs_topic_block |
+| snow_get_va_conversation | Get conversation | sys_cs_conversation |
+| snow_send_va_message | Send message | sys_cs_conversation |
+| snow_handoff_to_agent | Escalate to agent | sys_cs_conversation |
+| snow_discover_va_topics | List topics | sys_cs_topic |
+
+#### 6. Performance Analytics (servicenow-change-virtualagent-pa)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_pa_indicator | Create KPI | pa_indicators |
+| snow_create_pa_widget | Create widget | pa_widgets |
+| snow_create_pa_breakdown | Create breakdown | pa_breakdowns |
+| snow_create_pa_threshold | Set threshold | pa_thresholds |
+| snow_get_pa_scores | Get scores | pa_scores |
+| snow_create_pa_target | Set target | pa_targets |
+| snow_analyze_pa_trends | Analyze trends | pa_scores |
+
+#### 7. Flow Designer (servicenow-flow-workspace-mobile)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_flow | Create flow | sys_hub_flow |
+| snow_create_flow_action | Create action | sys_hub_action_instance |
+| snow_create_subflow | Create subflow | sys_hub_sub_flow |
+| snow_add_flow_trigger | Add trigger | sys_hub_trigger_instance |
+| snow_publish_flow | Publish flow | sys_hub_flow |
+| snow_test_flow | Test flow | sys_flow_context |
+| snow_get_flow_execution_details | Get execution | sys_flow_context |
+
+#### 8. Agent Workspace (servicenow-flow-workspace-mobile)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_workspace | Create workspace | sys_aw_workspace |
+| snow_configure_workspace_tab | Configure tabs | sys_aw_tab |
+| snow_add_workspace_list | Add lists | sys_aw_list |
+| snow_create_workspace_form | Create forms | sys_aw_form |
+| snow_configure_workspace_ui_action | Add UI actions | sys_aw_ui_action |
+| snow_deploy_workspace | Deploy workspace | sys_aw_workspace |
+
+#### 9. Mobile Platform (servicenow-flow-workspace-mobile)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_mobile_app_config | Configure app | sys_mobile_config |
+| snow_configure_mobile_layout | Configure layout | sys_mobile_layout |
+| snow_create_mobile_applet | Create applet | sys_mobile_applet |
+| snow_configure_offline_tables | Offline sync | sys_mobile_offline |
+| snow_set_mobile_security | Security settings | sys_mobile_security |
+| snow_push_notification_config | Push notifications | sys_push_notification |
+| snow_deploy_mobile_app | Deploy app | sys_mobile_deployment |
+
+#### 10. CMDB & Discovery (servicenow-cmdb-event-hr-csm-devops)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_cmdb_ci | Create CI | cmdb_ci_* |
+| snow_create_ci_relationship | Create relationship | cmdb_rel_ci |
+| snow_discover_ci_dependencies | Find dependencies | cmdb_rel_ci |
+| snow_run_discovery | Run discovery | discovery_status |
+| snow_get_discovery_status | Get status | discovery_status |
+| snow_import_cmdb_data | Import data | sys_import_set |
+
+#### 11. Event Management (servicenow-cmdb-event-hr-csm-devops)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_event | Create event | em_event |
+| snow_create_alert_rule | Create rule | em_alert_rule |
+| snow_correlate_alerts | Correlate alerts | em_alert |
+| snow_get_event_metrics | Get metrics | em_event |
+
+#### 12. HR Service Delivery (servicenow-cmdb-event-hr-csm-devops)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_hr_case | Create HR case | sn_hr_core_case |
+| snow_manage_onboarding | Onboarding | sn_hr_core_task |
+| snow_manage_offboarding | Offboarding | sn_hr_core_task |
+| snow_get_hr_analytics | HR analytics | sn_hr_core_case |
+
+#### 13. Customer Service Management (servicenow-cmdb-event-hr-csm-devops)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_csm_case | Create case | sn_customerservice_case |
+| snow_manage_customer_account | Manage account | sn_customerservice_account |
+| snow_create_csm_communication | Communications | sn_customerservice_communication |
+| snow_get_customer_satisfaction | Get CSAT | sn_customerservice_csat |
+
+#### 14. DevOps (servicenow-cmdb-event-hr-csm-devops)
+| Tool | Description | ServiceNow Table |
+|------|-------------|------------------|
+| snow_create_devops_pipeline | Create pipeline | sn_devops_pipeline |
+| snow_track_deployment | Track deployment | sn_devops_deployment |
+| snow_manage_devops_change | DevOps change | sn_devops_change |
+| snow_get_velocity_metrics | Team velocity | sn_devops_velocity |
+| snow_create_devops_artifact | Build artifacts | sn_devops_artifact |
+
+### Table Operations
+The universal `snow_query_table` tool works with all ServiceNow tables:
 
 ```javascript
-// Smart Performance Modes - System auto-detects the best approach:
-
-// 1. Analytics mode - OMIT limit for ALL records with minimal fields
+// Query any table with optimized performance
 snow_query_table({ 
-  table: "incident", 
+  table: "incident",  // Works with any table
   query: "state!=7",
-  fields: ["sys_created_on", "priority"]  // Get ALL records, minimal data
+  fields: ["number", "short_description", "priority"],
+  limit: 100
 })
-// Auto-detects analytics context and returns ALL records!
 
-// 2. Count-only mode - Ultra efficient for large datasets
+// Analytics mode - retrieve all records with minimal fields
 snow_query_table({ 
-  table: "sc_request",
-  include_content: false  // Just counts, no data
+  table: "incident",
+  fields: ["sys_created_on", "priority"]  // Omit limit for all records
 })
-// Returns: {total_results: 15234} - Maximum efficiency!
 
-// 3. Display mode - Limited records with full details
+// Count-only mode for large datasets
 snow_query_table({ 
-  table: "problem",
-  limit: 50,  // Explicitly limit for display
-  include_display_values: true
+  table: "sc_request",
+  include_content: false  // Returns count only
 })
 
-// 4. Group by aggregation - Server-side analytics
+// Server-side aggregation
 snow_query_table({ 
   table: "change_request",
   group_by: "risk",
-  order_by: "-count"  // Sorted by frequency
+  order_by: "-count"
 })
 ```
 
-Works with ANY table: `incident`, `sc_request`, `problem`, `cmdb_ci`, even `u_custom_table`!
-
-- **Operations**: Incident, Request, Problem, and Change management with AI analysis
-- **Development**: Create widgets, flows, scripts, and business rules with natural language
-- **Integration**: REST/SOAP endpoints, data transformation, and external system connectivity
-- **Analytics**: Real-time dashboards, KPIs, and predictive insights
-- **Security**: Compliance rules, audit trails, and vulnerability scanning
-
-### 🧠 **Natural Language Interface**
-Simply describe what you want to achieve:
-- "Create an incident management dashboard with SLA tracking"
-- "Build an employee onboarding workflow with approval steps"
-- "Analyze our incident resolution patterns from the last quarter"
-
-Snow-Flow understands your intent and orchestrates the entire implementation.
-
-### 🤖 **Machine Learning & Neural Networks**
-Snow-Flow includes real neural network capabilities powered by TensorFlow.js:
-
-#### **Incident Classification & Prediction**
-Train LSTM neural networks on your historical incident data to:
-- Automatically classify incidents with 95%+ accuracy
-- Predict categories, priorities, and assignment groups
-- Identify patterns in incident descriptions
-- Recommend resolution steps based on similar past incidents
-
+### Development Tools
+- Widget creation and deployment
+- Business rule development
+- Script include management
+- Flow Designer automation
+- UI Page creation
+- Portal configuration
+
+### Service Management
+- Incident management
+- Change management with CAB scheduling
+- Problem management
+- Request fulfillment
+- Knowledge management
+
+### Enterprise APIs
+- Performance Analytics (PA) with KPI management
+- Virtual Agent configuration
+- Agent Workspace customization
+- Mobile platform deployment
+- CMDB and Discovery
+- Event Management
+- HR Service Delivery
+- Customer Service Management
+- DevOps integration
+
+### Machine Learning
+
+Snow-Flow includes TensorFlow.js for neural network capabilities:
+
+#### Incident Classification
+Train LSTM networks on historical incident data:
 ```bash
-# Train incident classifier on historical data
 snow-flow ml train-incident-classifier --sample-size 5000 --epochs 100
-
-# Classify new incidents automatically
 snow-flow ml classify-incident INC0123456
-# Output: Category: Software (98% confidence), Priority: 2, Assignment: Application Support
 ```
 
-#### **Change Risk Prediction**
-Neural networks analyze change requests to predict implementation risk:
-- Risk scoring based on historical success/failure patterns
-- Identify high-risk changes before implementation
-- Recommend additional testing or approval steps
-- Learn from past deployment outcomes
-
+#### Change Risk Prediction
+Analyze change requests to predict implementation risk:
 ```bash
-# Train change risk model
 snow-flow ml train-change-risk --include-failed-changes
-
-# Predict risk for upcoming change
 snow-flow ml predict-change-risk CHG0123456
-# Output: Risk Level: Medium (72% confidence), Recommendation: Additional UAT required
 ```
 
-#### **Incident Volume Forecasting**
-LSTM time series models predict future incident volumes:
-- Forecast daily/weekly incident counts
-- Identify upcoming peak periods
-- Plan staffing and resources proactively
-- Category-specific predictions
-
+#### Time Series Forecasting
+Predict future incident volumes:
 ```bash
-# Forecast next 7 days of incidents
 snow-flow ml forecast-incidents --days 7 --category network
-# Output: Day 3 peak expected (145 incidents), recommend 20% additional staff
 ```
 
-#### **Anomaly Detection**
-Autoencoder neural networks detect unusual patterns:
-- Identify abnormal incident spikes or drops
-- Detect unusual user behavior patterns
-- Find system performance anomalies
-- Alert on potential security incidents
-
+#### Anomaly Detection
+Detect unusual patterns using autoencoder networks:
 ```bash
-# Monitor for anomalies in real-time
 snow-flow ml detect-anomalies --metric incident_patterns --sensitivity 0.9
-# Output: Anomaly detected: 300% increase in password reset requests from Building A
 ```
 
-#### **ML Model Management**
-- Train models on your actual ServiceNow data
-- No external data leaves your instance
-- Models improve with more data over time
-- Export/import trained models between instances
-- Performance metrics and accuracy tracking
+### ServiceNow Native ML Integration
 
-### 🔄 **Hybrid ML: Best of Both Worlds**
-Snow-Flow uniquely combines ServiceNow's native ML capabilities with custom neural networks:
+Access ServiceNow's native ML capabilities when licensed:
 
-**🚨 REAL APIs ONLY - NO MOCK DATA**
-Snow-Flow requires proper ServiceNow ML licensing for native ML features:
-- 🔐 **PA Required**: Performance Analytics plugin for KPI forecasting and analytics
-- 🔐 **PI Required**: Predictive Intelligence plugin for clustering and similarity
-- ✅ **Always Available**: Custom TensorFlow.js neural networks work regardless of ServiceNow plugins
-
-Proper error messages guide you when licenses are not available.
-
-#### **ServiceNow Native ML Integration**
-Access powerful platform ML features through Snow-Flow:
-
-**Performance Analytics ML**
+#### Performance Analytics ML
 ```bash
-# Use PA's predictive models for KPI forecasting
 snow-flow ml performance-analytics --indicator "Incident Resolution Time" --forecast-days 90
-# Output: Trend analysis, seasonality detection, anomaly alerts
 ```
 
-**Predictive Intelligence Framework**
+#### Predictive Intelligence
 ```bash
-# Find similar incidents using ServiceNow's clustering
 snow-flow ml predictive-intelligence --operation similar_incidents --incident INC0123456
-# Output: Top 10 similar incidents with resolution patterns
-
-# Get solution recommendations
-snow-flow ml predictive-intelligence --operation solution_recommendation --incident INC0123456
-# Output: KB articles, past resolutions, confidence scores
 ```
 
-**Agent Intelligence Work Assignment**
+#### Agent Intelligence
 ```bash
-# Get AI-powered assignment recommendations
 snow-flow ml agent-intelligence --task incident --id INC0123456 --auto-assign
-# Output: Best agent match based on skills, workload, and success rate
 ```
 
-**Process Optimization ML**
-```bash
-# Analyze and optimize business processes
-snow-flow ml process-optimization --process "Incident Management" --goal reduce_time
-# Output: Bottlenecks identified, 30% reduction possible, implementation steps
-```
-
-#### **Hybrid Recommendations**
-Combine both approaches for superior results:
-```bash
-# Use both ServiceNow ML and custom neural networks
-snow-flow ml hybrid-recommendation --use-case incident_resolution --native-weight 0.6 --custom-weight 0.4
-# Output: Combined insights from both systems, higher accuracy than either alone
-```
+Note: Native ML features require appropriate ServiceNow plugin licenses (PA, PI, Agent Intelligence).
 
-**Benefits of Hybrid Approach:**
-- ✅ **Higher Accuracy**: Ensemble learning from multiple models
-- ✅ **Fallback Options**: Works even if one system is unavailable
-- ✅ **Complementary Insights**: Platform knowledge + custom patterns
-- ✅ **License Clarity**: Clear error messages when PA/PI licenses needed
-- ✅ **Best Tool for Each Job**: Native for platform features, custom for specific needs
+## Multi-Agent System
 
-## 🎯 Key Benefits
+Snow-Flow includes 38 specialized agents that work together:
 
-### **For Developers**
-- **Rapid Prototyping**: Build complex solutions in minutes instead of days
-- **Best Practices Built-In**: Every generated artifact follows ServiceNow standards
-- **Continuous Learning**: Discover new platform capabilities through AI suggestions
-- **Error Prevention**: Intelligent validation catches issues before deployment
+### Agent Types
+- **Architect**: System design and architecture planning
+- **Developer**: Code generation and implementation
+- **Tester**: Test creation and execution
+- **Analyst**: Data analysis and reporting
+- **Security**: Compliance and security validation
+- **Optimizer**: Performance optimization
+- **Documenter**: Documentation generation
 
-### **For Administrators**
-- **Process Optimization**: AI analyzes workflows and suggests improvements
-- **Predictive Insights**: Anticipate issues before they impact users
-- **Compliance Automation**: Ensure security and regulatory requirements are met
-- **Knowledge Capture**: Document institutional knowledge in the graph database
+### Coordination Modes
+- **Hierarchical**: Top-down task delegation
+- **Mesh**: Peer-to-peer collaboration
+- **Swarm**: Distributed problem solving
+- **Adaptive**: Dynamic reorganization based on task requirements
 
-### **For Organizations**
-- **Reduced Time-to-Value**: Deploy solutions 80% faster
-- **Lower Training Costs**: New team members become productive immediately
-- **Consistent Quality**: AI ensures standardized, maintainable implementations
-- **Innovation Enablement**: Focus on business logic, not technical complexity
+## Installation
 
-## 🚀 Getting Started
+### Prerequisites
+- Node.js 18.0 or higher
+- npm 8.0 or higher
+- ServiceNow instance with admin access
+- OAuth application configured in ServiceNow
 
-### 1. Installation
+### Install via npm
 ```bash
 npm install -g snow-flow
 ```
 
-### 2. Initialize Snow-Flow
+### Initial Setup
 ```bash
+# Initialize configuration
 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
-```
-
-### 4. Authenticate
-```bash
+# Configure authentication
 snow-flow auth login
-```
-This opens your browser for OAuth authentication.
 
-### 5. Start Building!
-```bash
-snow-flow swarm "Create an incident management dashboard with real-time updates"
+# Verify connection
+snow-flow auth test
 ```
 
-### 💡 Quick Examples
-```bash
-# 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"
-
-# ML-Powered Incident Solver Widget
-snow-flow swarm "Create a Service Portal widget that uses ML to suggest incident solutions based on historical data"
-# This will:
-# - First check if Predictive Intelligence (PI) is available (BEST: 95%+ accuracy)
-# - If PI available: Use native incident similarity & solution recommendations
-# - If not: Train custom LSTM neural network (FALLBACK: 80-85% accuracy)
-# - Build widget with real-time classification
-# - Suggest top 5 similar resolved incidents with confidence scores
-
-# Change Risk Assessment Dashboard
-snow-flow swarm "Build a dashboard that predicts change implementation risk using machine learning"
-# Intelligent approach:
-# - With PI license: Uses native change risk scoring (superior results)
-# - Without PI: Falls back to TensorFlow.js neural networks
-# - Hybrid option: Combines both for maximum accuracy
-```
+## Usage Examples
 
-### ⚠️ 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
-
-### **80% Faster Development**
-AI orchestration eliminates repetitive tasks and automates complex workflows.
-
-### **90% Error Reduction**
-Intelligent validation and best practice enforcement prevent common mistakes.
-
-### **100% Platform Coverage**
-Every ServiceNow module and capability is accessible through natural language.
-
-### **∞ Learning Potential**
-Continuous pattern analysis reveals optimization opportunities you didn't know existed.
+### Natural Language Commands
+```bash
+# Create an incident dashboard
+snow-flow sparc "Create incident management dashboard with SLA tracking"
 
-## 🛣️ Roadmap: Snow-Flow Pro (Coming Soon)
+# Build a workflow
+snow-flow sparc "Create employee onboarding workflow with approval steps"
 
-### **Co-Op Mode** 🤝
-Perfect for environments where direct instance access isn't possible:
-- **No OAuth Required**: Work entirely offline with your table schemas
-- **Schema Import**: Provide your custom tables and field definitions
-- **Smart Development**: Snow-Flow develops against your exact configuration
-- **Export Ready**: Receive complete Update Sets or Import Sets
-- **Full Compatibility**: Generated artifacts work perfectly in your instance
+# Analyze data
+snow-flow sparc "Analyze incident resolution patterns from last quarter"
+```
 
-Example workflow:
+### Direct Tool Usage
 ```bash
-# Import your instance schema
-snow-flow coop import --tables incident,change_request,custom_table
+# Query incidents
+snow-flow query --table incident --limit 10
 
-# Develop without connection
-snow-flow coop develop "Create approval workflow for custom_table"
+# Create a widget
+snow-flow deploy widget --name "SLA Dashboard" --template dashboard
 
-# Export ready-to-import package
-snow-flow coop export --format update-set
+# Generate documentation
+snow-flow generate docs --scope "incident_management"
 ```
 
-### **Bring Your Own LLM** 🧠
-Choose your preferred AI backend:
-- **OpenAI GPT**: For maximum capability
-- **Anthropic Claude**: For nuanced understanding
-- **Local Models**: For complete data privacy
-- **Custom Fine-tuned**: For organization-specific patterns
+### Swarm Coordination
+```bash
+# Multi-agent development
+snow-flow swarm "Build complete HR service portal" \
+  --strategy development \
+  --mode hierarchical \
+  --max-agents 8
+
+# Analysis swarm
+snow-flow swarm "Analyze system performance bottlenecks" \
+  --strategy analysis \
+  --mode mesh \
+  --parallel
+```
 
-### **Enterprise Features** 🏢
-- **Multi-Instance Management**: Develop once, deploy everywhere
-- **Team Collaboration**: Shared knowledge graphs and patterns
-- **Audit & Compliance**: Full tracking of AI-generated changes
-- **SLA Guarantees**: Priority support and uptime commitments
+## Configuration
 
-## 🌟 Why Snow-Flow Transforms ServiceNow Development
+Configuration file location: `~/.snow-flow/.env`
 
-### **Democratizes Expertise**
-You don't need 10 years of ServiceNow experience to build enterprise-grade solutions. Snow-Flow bridges the knowledge gap, making expert-level development accessible to everyone.
+### Required Settings
+```env
+SNOW_INSTANCE=your-instance.service-now.com
+SNOW_CLIENT_ID=your-oauth-client-id
+SNOW_CLIENT_SECRET=your-oauth-client-secret
+```
 
-### **Accelerates Innovation**
-Stop spending time on boilerplate code and configuration. Focus on solving business problems while Snow-Flow handles the implementation details.
+### Optional Settings
+```env
+# Timeout configuration (milliseconds)
+# SNOW_FLOW_INIT_TIMEOUT=30000
+# SNOW_FLOW_OPERATION_TIMEOUT=60000
+# SNOW_FLOW_MEMORY_TIMEOUT=5000
+
+# Agent configuration
+SNOW_FLOW_MAX_AGENTS=10
+SNOW_FLOW_AGENT_MODE=hierarchical
+
+# ML configuration
+SNOW_FLOW_ML_ENABLED=true
+SNOW_FLOW_ML_MODEL_PATH=./models
+```
 
-### **Ensures Quality**
-Every line of code, every configuration, and every deployment follows ServiceNow best practices. AI review catches issues human reviewers might miss.
+## Project Structure
+```
+snow-flow/
+├── src/                 # Source code
+│   ├── agents/         # Agent implementations
+│   ├── mcp/           # MCP server implementations
+│   ├── utils/         # Utility functions
+│   └── services/      # Service layer
+├── dist/               # Compiled JavaScript
+├── memory/             # Persistent storage
+├── models/             # ML models
+└── tests/              # Test suite
+```
 
-### **Builds Institutional Knowledge**
-Your development patterns, solutions, and optimizations are captured in the graph database, creating a growing knowledge base for your organization.
+## Documentation
 
-## 🤝 Community & Support
+- [API Reference](docs/api.md)
+- [Agent Documentation](docs/agents.md)
+- [MCP Tools Reference](docs/tools.md)
+- [ML Capabilities](docs/ml.md)
+- [Configuration Guide](docs/configuration.md)
 
-- **Documentation**: [https://docs.snow-flow.ai](https://github.com/groeimetai/snow-flow/wiki)
-- **Discord Community**: [Join our Discord](https://discord.gg/snow-flow)
-- **GitHub Issues**: [Report bugs or request features](https://github.com/groeimetai/snow-flow/issues)
-- **Commercial Support**: Available with Snow-Flow Pro
+## Contributing
 
-## 📄 License
+Contributions are welcome. Please read the [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
 
-Snow-Flow is MIT licensed. See [LICENSE](LICENSE) file for details.
+## Support
 
----
+- GitHub Issues: [github.com/groeimetai/snow-flow/issues](https://github.com/groeimetai/snow-flow/issues)
+- Documentation: [github.com/groeimetai/snow-flow/wiki](https://github.com/groeimetai/snow-flow/wiki)
 
-**Ready to transform your ServiceNow development?**
+## License
 
-```bash
-npm install -g snow-flow
-snow-flow init
-```
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-Join thousands of developers who are already building faster, smarter, and better with Snow-Flow.
+## Acknowledgments
 
-🚀 **The future of ServiceNow development is here. The future is Snow-Flow.**
+- ServiceNow for the comprehensive REST API
+- TensorFlow.js for machine learning capabilities
+- Model Context Protocol (MCP) for tool orchestration

package/dist/dynamic-version.js

@@ -36,7 +36,7 @@ function getDynamicVersion() {
         console.warn('Warning: Could not read version from package.json:', error);
     }
     // Fallback to hardcoded version
-    return '3.2.0';
+    return '3.2.2';
 }
 // Export a constant that uses the dynamic version
 exports.VERSION = getDynamicVersion();

package/dist/mcp/servicenow-automation-mcp.js

@@ -219,7 +219,7 @@ class ServiceNowAutomationMCP {
                 },
                 {
                     name: 'snow_create_atf_test',
-                    description: '🧪 Creates an Automated Test Framework (ATF) test for automated testing of ServiceNow applications and configurations.',
+                    description: 'Creates an Automated Test Framework (ATF) test for automated testing of ServiceNow applications and configurations using the sys_atf_test table.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -235,7 +235,7 @@ class ServiceNowAutomationMCP {
                 },
                 {
                     name: 'snow_create_atf_test_step',
-                    description: '➕ Adds a test step to an existing ATF test. Steps define the actions and assertions for testing.',
+                    description: 'Adds a test step to an existing ATF test. Steps define the actions and assertions for testing using the sys_atf_step table.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -251,7 +251,7 @@ class ServiceNowAutomationMCP {
                 },
                 {
                     name: 'snow_execute_atf_test',
-                    description: '▶️ Executes an ATF test or test suite and returns the results. Tests run asynchronously in ServiceNow.',
+                    description: 'Executes an ATF test or test suite and returns the results. Tests run asynchronously in ServiceNow using sys_atf_test_result table.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -264,7 +264,7 @@ class ServiceNowAutomationMCP {
                 },
                 {
                     name: 'snow_get_atf_results',
-                    description: '📊 Retrieves ATF test execution results including pass/fail status, error details, and execution time.',
+                    description: 'Retrieves ATF test execution results including pass/fail status, error details, and execution time from sys_atf_test_result table.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -276,7 +276,7 @@ class ServiceNowAutomationMCP {
                 },
                 {
                     name: 'snow_create_atf_test_suite',
-                    description: '📦 Creates an ATF test suite to group and run multiple tests together.',
+                    description: 'Creates an ATF test suite to group and run multiple tests together using sys_atf_test_suite table.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -291,7 +291,7 @@ class ServiceNowAutomationMCP {
                 },
                 {
                     name: 'snow_discover_atf_tests',
-                    description: '🔍 Discovers existing ATF tests and test suites in the instance with filtering options.',
+                    description: 'Discovers existing ATF tests and test suites in the instance with filtering options from sys_atf_test and sys_atf_test_suite tables.',
                     inputSchema: {
                         type: 'object',
                         properties: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "snow-flow",
-  "version": "3.2.0",
-  "description": "Snow-Flow v3.2.0: Complete ServiceNow Enterprise Suite with 180+ MCP Tools. ATF Testing, Knowledge Management, Service Catalog, Change Management with CAB scheduling, Virtual Agent chatbots with NLU, Performance Analytics KPIs, Flow Designer automation, Agent Workspace configuration, Mobile app deployment, CMDB/Discovery, Event Management correlation, HR Service Delivery onboarding, Customer Service Management, DevOps CI/CD integration. All using official ServiceNow REST APIs across 17 specialized MCP servers.",
+  "version": "3.2.2",
+  "description": "Snow-Flow v3.2.2: ServiceNow development platform with 180+ MCP tools. Includes ATF Testing, Knowledge Management, Service Catalog, Change Management, Virtual Agent, Performance Analytics, Flow Designer, Agent Workspace, Mobile, CMDB/Discovery, Event Management, HR Service Delivery, Customer Service Management, and DevOps integration. All tools use official ServiceNow REST APIs across 17 specialized MCP servers.",
   "main": "dist/index.js",
   "type": "commonjs",
   "bin": {