snow-flow 3.2.2 → 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:
@@ -369,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
@@ -395,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.2';
+    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.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.",
+  "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": {