snow-flow 3.2.1 → 3.2.3

package/README.md

@@ -10,6 +10,31 @@
 
 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.
 
+## Quick Start - One Command to Rule Them All
+
+### 🚀 The Swarm Command
+The simplest way to use Snow-Flow is with the swarm command. Just describe what you want in natural language:
+
+```bash
+# Basic usage - no flags needed!
+snow-flow swarm "Create an incident dashboard with real-time updates"
+```
+
+This single command automatically:
+- Spawns multiple specialized AI agents
+- Discovers existing ServiceNow artifacts
+- Creates complete working solutions
+- Deploys directly to your instance
+- Handles all technical complexity
+
+More examples:
+```bash
+snow-flow swarm "Build employee onboarding workflow"
+snow-flow swarm "Create knowledge base for IT support"
+snow-flow swarm "Set up change management process"
+snow-flow swarm "Analyze last month's incident patterns"
+```
+
 ## Core Functionality
 
 Snow-Flow connects directly to ServiceNow instances through OAuth 2.0 authentication and provides:
@@ -51,6 +76,171 @@ snow-flow auth login
 
 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:
 
@@ -204,8 +394,43 @@ snow-flow auth login
 snow-flow auth test
 ```
 
+### Troubleshooting: Claude Code stdio Error
+
+If you encounter a stdio/permissions error when using Snow-Flow with Claude Code:
+
+```bash
+# 1. Fix Claude permissions
+claude --dangerously-skip-permissions
+
+# 2. Activate Claude Code
+# Open Claude Code and ensure it's activated with your account
+
+# 3. Login to Claude
+# Sign in with your Claude account in the Claude Code interface
+
+# 4. Close Claude Code completely
+# Make sure Claude Code is fully closed before proceeding
+
+# 5. Now run Snow-Flow swarm
+snow-flow swarm "Your ServiceNow task here"
+```
+
+This resolves the common "stdio" error that occurs when Claude Code doesn't have proper permissions to communicate with MCP servers.
+
 ## Usage Examples
 
+### Swarm Command (Recommended)
+```bash
+# The simplest way - just describe what you want!
+snow-flow swarm "Create incident management dashboard"
+
+# No flags needed for basic usage
+snow-flow swarm "Build service catalog for laptop requests"
+
+# Advanced usage with optional flags
+snow-flow swarm "Optimize incident resolution process" --monitor --parallel
+```
+
 ### Natural Language Commands
 ```bash
 # Create an incident dashboard
@@ -230,19 +455,24 @@ snow-flow deploy widget --name "SLA Dashboard" --template dashboard
 snow-flow generate docs --scope "incident_management"
 ```
 
-### Swarm Coordination
+### Advanced Swarm Options
 ```bash
-# Multi-agent development
+# With specific strategy
 snow-flow swarm "Build complete HR service portal" \
   --strategy development \
   --mode hierarchical \
   --max-agents 8
 
-# Analysis swarm
+# Parallel analysis
 snow-flow swarm "Analyze system performance bottlenecks" \
   --strategy analysis \
   --mode mesh \
   --parallel
+
+# With monitoring
+snow-flow swarm "Deploy production changes" \
+  --monitor \
+  --auto-rollback
 ```
 
 ## Configuration

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.1';
+    return '3.2.3';
 }
 // Export a constant that uses the dynamic version
 exports.VERSION = getDynamicVersion();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "snow-flow",
-  "version": "3.2.1",
-  "description": "Snow-Flow v3.2.1: 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.",
+  "version": "3.2.3",
+  "description": "Snow-Flow v3.2.3: ServiceNow development platform with 180+ MCP tools. One command to rule them all: 'snow-flow swarm'. 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": {