snow-flow 1.4.23 → 1.4.25

package/CLAUDE.md

@@ -59,301 +59,161 @@ If ANY answer is "No", you MUST combine operations into a single message!
 
 ## Project Overview
 
-This project combines the SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) methodology with **14 Advanced ServiceNow Features** for systematic Test-Driven Development with AI assistance through Claude-Flow orchestration.
+This project combines the SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) methodology with **Real ServiceNow Integration** for systematic Test-Driven Development with AI assistance.
 
 **🚀 Batchtools Optimization Enabled**: This configuration includes optimized prompts and parallel processing capabilities for improved performance and efficiency.
 
-## 🔥 **NEW: 14 ADVANCED SERVICENOW FEATURES (100% WORKING)**
+## 🏔️ **SNOW-FLOW: COMPLETE MCP TOOLKIT**
+
+**Production-Ready ServiceNow Integration + AI Orchestration via Natural Language**
+
+Snow-Flow provides comprehensive MCP tools for ServiceNow integration and AI orchestration. All tools work directly with your ServiceNow instance using OAuth authentication and are accessible through the natural language swarm interface.
+
+### **🛠️ Complete Snow-Flow MCP Tools**
+
+#### **🐝 AI Swarm Orchestration** (4 tools working)
+- `swarm_init` - Initialize AI swarm coordination topology  
+- `agent_spawn` - Create specialized AI agents for different tasks
+- `memory_usage` - Persistent memory across sessions
+- `neural_status` - Neural network pattern effectiveness
+
+#### **📊 ServiceNow Operations** (12/15 tools working)
+- ✅ `snow_operational_metrics` - Retrieve operational metrics and analytics
+- ✅ `snow_user_lookup` - Analyze user information with groups and roles
+- ✅ `snow_query_incidents` - Advanced incident querying with filters
+- ✅ `snow_catalog_item_search` - Search catalog items with fuzzy matching
+- ✅ `snow_catalog_item_manager` - Manage service catalog items
+- ✅ `snow_test_flow_with_mock` - Test flows with mock data
+- ✅ `snow_link_catalog_to_flow` - Link catalog items to flows
+- ✅ `snow_cleanup_test_artifacts` - Clean test artifacts safely
+- ✅ `snow_create_user_group` - Create ServiceNow user groups
+- ✅ `snow_create_user` - Create ServiceNow users
+- ✅ `snow_assign_user_to_group` - Manage group memberships
+- ✅ `snow_list_group_members` - List group members
+- ⚠️ `snow_analyze_incident` - Incident analysis (needs verification)
+- ⚠️ `snow_auto_resolve_incident` - Auto incident resolution (needs verification)
+- ⚠️ `snow_query_requests` - Service request queries (needs verification)
+
+#### **🔧 Platform Development** (2/2 tools working)
+- ✅ `snow_discover_platform_tables` - Discover UI, script, policy tables
+- ✅ `snow_table_schema_discovery` - Comprehensive table schema analysis
+
+#### **🔗 Integration** (10+ tools)
+- ✅ `snow_discover_integration_endpoints` - Find REST/SOAP endpoints
+- `snow_create_rest_message` - Create REST Message endpoints
+- `snow_create_rest_method` - Create REST methods
+- `snow_create_transform_map` - Create Transform Maps
+- `snow_create_field_map` - Create Field Maps
+- `snow_create_import_set` - Create Import Set tables
+- `snow_create_web_service` - Create Web Services
+- `snow_create_email_config` - Create Email configurations
+- `snow_test_integration` - Test integration endpoints
+- `snow_discover_data_sources` - Discover data sources
+
+#### **📈 Reporting & Analytics** (12+ tools)
+- ✅ `snow_discover_reporting_tables` - Table discovery for reporting
+- ✅ `snow_analyze_data_quality` - Data quality assessment
+- `snow_create_report` - Create reports with dynamic discovery
+- `snow_create_dashboard` - Create dashboards
+- `snow_create_kpi` - Create KPIs
+- `snow_create_data_visualization` - Create data visualizations
+- `snow_create_performance_analytics` - Performance analytics
+- `snow_create_scheduled_report` - Scheduled reports
+- `snow_discover_report_fields` - Discover report fields
+- `snow_generate_insights` - Generate data insights
+- `snow_export_report_data` - Export report data
+
+#### **⚙️ Automation** (11+ tools)
+- ✅ `snow_discover_automation_jobs` - Find scheduled jobs, notifications, SLAs
+- ✅ `snow_discover_events` - Discover ServiceNow events
+- ✅ `snow_discover_schedules` - Find system schedules
+- `snow_create_scheduled_job` - Create scheduled jobs
+- `snow_create_event_rule` - Create event rules
+- `snow_create_notification` - Create notifications
+- `snow_create_sla_definition` - Create SLA definitions
+- `snow_create_escalation_rule` - Create escalation rules
+- `snow_create_workflow_activity` - Create workflow activities
+- `snow_test_scheduled_job` - Test scheduled job execution
+
+#### **🛡️ Security & Compliance** (12+ tools)
+- `snow_create_security_policy` - Create security policies
+- `snow_create_compliance_rule` - Create compliance rules
+- `snow_create_audit_rule` - Create audit rules
+- `snow_create_access_control` - Create access controls
+- `snow_create_data_policy` - Create data policies
+- `snow_create_vulnerability_scan` - Create vulnerability scans
+- `snow_discover_security_frameworks` - Discover frameworks
+- `snow_discover_security_policies` - Discover policies
+- `snow_run_compliance_scan` - Run compliance scans
+- `snow_audit_trail_analysis` - Analyze audit trails
+- `snow_security_risk_assessment` - Security risk assessment
+
+#### **📦 Update Set Management** (9+ tools)
+- ✅ `snow_update_set_current` - Get current update set
+- ✅ `snow_update_set_list` - List update sets
+- `snow_update_set_create` - Create new update sets
+- `snow_update_set_switch` - Switch update sets
+- `snow_update_set_complete` - Mark update sets complete
+- `snow_update_set_add_artifact` - Track artifacts
+- `snow_update_set_preview` - Preview changes
+- `snow_update_set_export` - Export update sets
+- `snow_ensure_active_update_set` - Ensure active session
+
+#### **🚀 Deployment & Development** (15+ tools)
+- ✅ `snow_preview_widget` - Preview widget rendering
+- ✅ `snow_validate_deployment` - Validate deployments
+- ⚠️ `snow_deploy` - Deploy artifacts (permission issues)
+- ⚠️ `snow_widget_test` - Test widgets (404 errors)
+- `snow_auth_diagnostics` - Authentication diagnostics
+- `snow_create_ui_page` - Create UI pages
+- `snow_create_script_include` - Create script includes
+- `snow_create_business_rule` - Create business rules
+- `snow_create_client_script` - Create client scripts
+- `snow_create_ui_policy` - Create UI policies
+- `snow_create_ui_action` - Create UI actions
+- `snow_rollback_deployment` - Rollback deployments
+- `snow_deployment_status` - Check deployment status
+- `snow_export_artifact` - Export artifacts
+- `snow_import_artifact` - Import artifacts
+
+### **🎯 Natural Language Interface**
+
+Access all 50+ tools through the swarm command:
 
-**ZERO Mock Data - 100% Real ServiceNow API Integration**
-
-All features work directly with your ServiceNow instance using OAuth authentication. No placeholder code, no mock data, no demo implementations - everything is production-ready!
-
-### **📊 Core Analytics & Performance (Features 1-4)**
-
-#### **1. Smart Batch API Operations (`snow_batch_api`)**
-
-- **80% API call reduction** through intelligent batching
-- **Parallel execution** with transaction support
-- **Query optimization** and result caching
-- **Real-time performance monitoring**
-
-```javascript
-// Execute multiple operations in a single transaction
-snow_batch_api({
-  operations: [
-    {
-      operation: 'query',
-      table: 'incident',
-      query: 'state=1',
-      fields: ['number', 'short_description'],
-    },
-    { operation: 'update', table: 'incident', sys_id: 'xxx', data: { urgency: '1' } },
-    { operation: 'insert', table: 'problem', data: { short_description: 'System issue' } },
-  ],
-  parallel: true,
-  transactional: true,
-});
-```
-
-#### **2. Table Relationship Mapping (`snow_get_table_relationships`)**
-
-- **Deep relationship discovery** across table hierarchies
-- **Visual relationship diagrams** (Mermaid format)
-- **Impact analysis** for schema changes
-- **Performance optimization** recommendations
-
-```javascript
-// Discover all table relationships with visualization
-snow_get_table_relationships({
-  table: 'incident',
-  max_depth: 3,
-  generate_visualization: true,
-  include_counts: true,
-});
-```
-
-#### **3. Query Performance Analyzer (`snow_analyze_query`)**
-
-- **Query execution analysis** with bottleneck detection
-- **Index recommendations** for performance optimization
-- **Alternative query suggestions**
-- **Risk assessment** and execution time prediction
-
-```javascript
-// Analyze query performance and get optimization suggestions
-snow_analyze_query({
-  query: 'state=1^priority<=2^assigned_to.manager=javascript:gs.getUserID()',
-  table: 'incident',
-  analyze_indexes: true,
-  suggest_optimizations: true,
-});
-```
-
-#### **4. Field Usage Intelligence (`snow_analyze_field_usage`)**
-
-- **Comprehensive field usage analysis** across all ServiceNow components
-- **Unused field detection** with deprecation recommendations
-- **Technical debt scoring** and optimization opportunities
-- **Cross-component impact analysis**
-
-```javascript
-// Analyze field usage patterns across all ServiceNow areas
-snow_analyze_field_usage({
-  table: 'incident',
-  analyze_queries: true,
-  analyze_reports: true,
-  analyze_business_rules: true,
-  unused_threshold_days: 90,
-});
-```
-
-### **🔄 Migration & Architecture (Features 5-7)**
-
-#### **5. Migration Helper (`snow_create_migration_plan`)**
-
-- **Automated migration planning** with risk assessment
-- **Data transformation scripts** generation
-- **Performance impact estimation**
-- **Rollback strategy** creation
-
-```javascript
-// Create comprehensive migration plan for table restructuring
-snow_create_migration_plan({
-  migration_type: 'field_restructure',
-  source_table: 'incident',
-  target_table: 'incident',
-  target_changes: {
-    fields_to_add: [{ name: 'u_severity_score', type: 'integer' }],
-    fields_to_modify: [{ name: 'urgency', new_type: 'choice' }],
-  },
-});
-```
-
-#### **6. Deep Table Analysis (`snow_analyze_table_deep`)**
-
-- **Multi-dimensional table analysis** (structure, data quality, performance)
-- **Security and compliance** assessment
-- **Usage pattern analysis** and optimization recommendations
-- **Risk scoring** and remediation guidance
-
-```javascript
-// Perform comprehensive table analysis
-snow_analyze_table_deep({
-  table_name: 'incident',
-  analysis_scope: ['structure', 'data_quality', 'performance', 'security'],
-  generate_recommendations: true,
-});
-```
-
-#### **7. Code Pattern Detector (`snow_detect_code_patterns`)**
-
-- **Advanced pattern recognition** across all script types
-- **Performance anti-pattern detection**
-- **Security vulnerability scanning**
-- **Maintainability scoring** and refactoring suggestions
-
-```javascript
-// Detect patterns across all ServiceNow scripts
-snow_detect_code_patterns({
-  analysis_scope: ['business_rules', 'script_includes', 'workflows'],
-  pattern_categories: ['performance', 'security', 'maintainability'],
-  max_scripts: 100,
-});
-```
-
-### **🔮 AI-Powered Intelligence (Features 8-10)**
-
-#### **8. Predictive Impact Analysis (`snow_predict_change_impact`)**
-
-- **AI-powered change impact prediction**
-- **Risk assessment** with confidence scoring
-- **Dependency chain analysis**
-- **Rollback requirement prediction**
-
-```javascript
-// Predict impact of field mandatory change
-snow_predict_change_impact({
-  change_type: 'field_change',
-  target_object: 'incident',
-  change_details: {
-    field_changes: ['urgency'],
-    new_values: { mandatory: true },
-  },
-});
-```
-
-#### **9. Auto Documentation Generator (`snow_generate_documentation`)**
-
-- **Intelligent documentation generation** from code and configuration
-- **Multiple output formats** (Markdown, HTML, PDF)
-- **Relationship diagrams** and architecture documentation
-- **Usage examples** and best practices
-
-```javascript
-// Generate comprehensive documentation automatically
-snow_generate_documentation({
-  documentation_scope: ['tables', 'workflows', 'integrations'],
-  target_objects: ['incident', 'problem'],
-  output_format: 'markdown',
-  include_diagrams: true,
-});
-```
-
-#### **10. Intelligent Refactoring (`snow_refactor_code`)**
-
-- **AI-driven code refactoring** with performance optimization
-- **Modern JavaScript patterns** and best practices
-- **Security hardening** and error handling improvements
-- **Preview and validation** before applying changes
-
-```javascript
-// Analyze and refactor ServiceNow scripts intelligently
-snow_refactor_code({
-  refactoring_scope: ['business_rules', 'script_includes'],
-  refactoring_goals: ['performance', 'security', 'readability'],
-  generate_preview: true,
-});
-```
-
-### **⚙️ Process Mining & Workflow (Features 11-14)**
-
-#### **11. Process Mining Engine (`snow_discover_process`)**
-
-- **Real process discovery** from ServiceNow event logs
-- **Process variant analysis** and bottleneck identification
-- **Compliance checking** against reference models
-- **Optimization recommendations** with ROI calculation
-
-```javascript
-// Discover actual incident management processes
-snow_discover_process({
-  process_type: 'incident_management',
-  analysis_period: '30d',
-  include_variants: true,
-  compliance_analysis: true,
-});
-```
-
-#### **12. Workflow Reality Analyzer (`snow_analyze_workflow_execution`)**
+```bash
+# AI Orchestration
+snow-flow swarm "Initialize a development swarm with 5 agents to analyze my ServiceNow instance"
 
-- **Real workflow execution analysis** vs. designed processes
-- **Performance bottleneck identification**
-- **SLA compliance monitoring**
-- **Resource utilization optimization**
+# User and group management  
+snow-flow swarm "Create a new user group for incident managers and add users"
 
-```javascript
-// Analyze actual workflow execution patterns
-snow_analyze_workflow_execution({
-  workflow_type: 'incident',
-  analysis_period: '7d',
-  include_performance_metrics: true,
-  identify_bottlenecks: true,
-});
-```
+# Advanced analytics
+snow-flow swarm "Create a performance dashboard for incident resolution metrics"
 
-#### **13. Cross Table Process Discovery (`snow_discover_cross_table_process`)**
+# Integration setup
+snow-flow swarm "Set up REST integration with external system for data import"
 
-- **Multi-table process flow discovery**
-- **Data lineage and transformation tracking**
-- **Integration point analysis**
-- **Process automation opportunities**
+# Security analysis
+snow-flow swarm "Run comprehensive security scan and create compliance report"
 
-```javascript
-// Discover processes spanning multiple tables
-snow_discover_cross_table_process({
-  start_table: 'incident',
-  end_tables: ['problem', 'change_request'],
-  analysis_period: '90d',
-  include_data_flow: true,
-});
+# Automation deployment
+snow-flow swarm "Create automated notification rules for high priority incidents"
 ```
 
-#### **14. Real Time Process Monitoring (`snow_monitor_process`)**
+### **📊 Tool Status Summary**
 
-- **Live process monitoring** with real-time alerts
-- **Anomaly detection** using machine learning
-- **Performance trend analysis**
-- **Predictive failure detection**
+- **✅ Working Tools**: 35+ tools (70% success rate)
+- **⚠️ Limited Tools**: 8 tools (permission/config issues)
+- **🔧 In Development**: 5+ tools (under development)
 
-```javascript
-// Setup real-time process monitoring
-snow_monitor_process({
-  process_name: 'incident_resolution',
-  tables_to_monitor: ['incident', 'task'],
-  monitoring_duration: '24h',
-  enable_anomaly_detection: true,
-});
-```
+### **🔧 Technical Details**
 
-### **🚀 Performance Metrics & Benefits**
-
-- **80% API call reduction** through intelligent batching
-- **60% faster analysis** with parallel processing
-- **90% automation** of manual ServiceNow tasks
-- **100% real data** - no mocks or placeholders
-- **Zero configuration** - works with any ServiceNow instance
-
-### **🔧 Technical Implementation**
-
-- **Real OAuth Authentication** with your ServiceNow instance
-- **82+ ServiceNow API calls** for comprehensive data gathering
-- **21 MCP-compliant responses** with proper formatting
-- **TypeScript implementation** with full type safety
-- **Comprehensive error handling** and retry logic
-
-### **💡 Usage Examples**
-
-```bash
-# Quick ServiceNow analysis
-npx snow-flow sparc run servicenow-analyzer "Analyze incident table performance and suggest optimizations"
-
-# Comprehensive process mining
-npx snow-flow swarm "Discover all incident management processes and identify bottlenecks" --strategy analysis --auto-deploy
-
-# Real-time monitoring setup
-npx snow-flow sparc run servicenow-monitor "Setup real-time monitoring for change management processes"
-```
+- **OAuth Authentication** with ServiceNow instances
+- **50+ MCP tools** across 8 categories
+- **AI Swarm Orchestration** for complex workflows
+- **TypeScript implementation** with comprehensive error handling
+- **Real-time API integration** - no mock data or demos
+- **Natural language interface** for all operations
 
 ## SPARC Development Commands