snow-flow 1.3.1 → 1.3.2

package/.env.example

@@ -1,4 +1,6 @@
+# ===========================================
 # ServiceNow OAuth Configuration
+# ===========================================
 # Replace these values with your actual ServiceNow instance and OAuth credentials
 
 # ServiceNow Instance URL (without https://)
@@ -12,26 +14,235 @@ SNOW_CLIENT_ID=your-oauth-client-id
 # OAuth Client Secret from ServiceNow Application Registry
 SNOW_CLIENT_SECRET=your-oauth-client-secret
 
-# Optional: Additional Configuration
-# SNOW_REDIRECT_URI=http://localhost:3000/callback
+# Optional: Basic authentication (not recommended for production)
+# SNOW_USERNAME=your-username
+# SNOW_PASSWORD=your-password
+
+# Authentication type: oauth (default) or basic
+# SNOW_AUTH_TYPE=oauth
+
+# API version to use (default: now)
+# SNOW_API_VERSION=now
+
+# ServiceNow request timeout in milliseconds (default: 60000 = 60s)
+# SNOW_REQUEST_TIMEOUT=60000
+
+# Max retry attempts for failed requests (default: 3)
+# SNOW_MAX_RETRIES=3
+
+# Delay between retry attempts in milliseconds (default: 2000 = 2s)
+# SNOW_RETRY_DELAY=2000
+
+# OAuth redirect configuration
+# Host for OAuth callback (default: localhost)
+# SNOW_REDIRECT_HOST=localhost
+
+# Port for OAuth callback (default: 3005)
+# SNOW_REDIRECT_PORT=3005
+
+# Path for OAuth callback (default: /callback)
+# SNOW_REDIRECT_PATH=/callback
+
+# ===========================================
+# Snow-Flow System Configuration
+# ===========================================
+
+# Environment: development, staging, production (default: development)
+# SNOW_FLOW_ENV=development
+
+# Log level: debug, info, warn, error (default: info)
+# SNOW_FLOW_LOG_LEVEL=info
+
+# Data directory for configuration, cache, logs (default: ~/.snow-flow)
+# SNOW_FLOW_DATA_DIR=/path/to/custom/data/dir
+
+# Maximum concurrent operations (default: 10)
+# SNOW_FLOW_MAX_CONCURRENT_OPS=10
+
+# Session timeout in milliseconds (default: 3600000 = 1 hour)
+# SNOW_FLOW_SESSION_TIMEOUT=3600000
+
+# ===========================================
+# Agent Configuration
+# ===========================================
+
+# Maximum number of worker agents (default: 10)
+# SNOW_FLOW_MAX_WORKER_AGENTS=10
+
+# Agent spawn timeout in milliseconds (default: 30000 = 30s)
+# SNOW_FLOW_SPAWN_TIMEOUT=30000
+
+# Agent coordination interval in milliseconds (default: 5000 = 5s)
+# SNOW_FLOW_COORDINATION_INTERVAL=5000
+
+# Maximum retry attempts for agent operations (default: 3)
+# SNOW_FLOW_RETRY_ATTEMPTS=3
+
+# Worker agent heartbeat interval in milliseconds (default: 10000 = 10s)
+# SNOW_FLOW_HEARTBEAT_INTERVAL=10000
+
+# Task timeout for worker agents in milliseconds (default: 300000 = 5 minutes)
+# SNOW_FLOW_TASK_TIMEOUT=300000
+
+# Maximum memory usage per worker agent in MB (default: 500)
+# SNOW_FLOW_MAX_MEMORY_USAGE=500
+
+# Auto-shutdown idle time in milliseconds (default: 600000 = 10 minutes)
+# SNOW_FLOW_AUTO_SHUTDOWN_IDLE=600000
+
+# ===========================================
+# MCP Server Configuration
+# ===========================================
+
+# MCP server ports (defaults: 3001, 3002, 3003, 3004, 3005)
+# MCP_DEPLOYMENT_PORT=3001
+# MCP_INTELLIGENT_PORT=3002
+# MCP_OPERATIONS_PORT=3003
+# MCP_FLOW_COMPOSER_PORT=3004
+# MCP_PLATFORM_DEV_PORT=3005
+
+# MCP server host (default: localhost)
+# MCP_HOST=localhost
+
+# MCP transport timeout in milliseconds (default: 30000 = 30s)
+# MCP_TIMEOUT=30000
+
+# MCP retry attempts (default: 3)
+# MCP_RETRY_ATTEMPTS=3
+
+# MCP retry delay in milliseconds (default: 5000 = 5s)
+# MCP_RETRY_DELAY=5000
+
+# MCP authentication token expiry in milliseconds (default: 86400000 = 24 hours)
+# MCP_AUTH_TOKEN_EXPIRY=86400000
+
+# ===========================================
+# Memory System Configuration
+# ===========================================
+
+# Database path for persistent memory (default: auto-generated in data dir)
+# SNOW_FLOW_DB_PATH=/path/to/custom/memory.db
+
+# Enable memory cache (default: true)
+# SNOW_FLOW_CACHE_ENABLED=true
+
+# Cache maximum size in MB (default: 100)
+# SNOW_FLOW_CACHE_MAX_SIZE=100
+
+# Cache TTL in milliseconds (default: 3600000 = 1 hour)
+# SNOW_FLOW_CACHE_TTL=3600000
+
+# Default TTL for memory entries in milliseconds (default: 86400000 = 24 hours)
+# SNOW_FLOW_DEFAULT_TTL=86400000
+
+# Session memory TTL in milliseconds (default: 86400000 = 24 hours)
+# SNOW_FLOW_SESSION_TTL=86400000
+
+# Artifact memory TTL in milliseconds (default: 604800000 = 7 days)
+# SNOW_FLOW_ARTIFACT_TTL=604800000
+
+# Metrics memory TTL in milliseconds (default: 2592000000 = 30 days)
+# SNOW_FLOW_METRIC_TTL=2592000000
+
+# Memory cleanup interval in milliseconds (default: 86400000 = 24 hours)
+# SNOW_FLOW_CLEANUP_INTERVAL=86400000
+
+# Memory retention in days (default: 30)
+# SNOW_FLOW_RETENTION_DAYS=30
+
+# ===========================================
+# Monitoring Configuration
+# ===========================================
+
+# Enable performance monitoring (default: true)
+# SNOW_FLOW_PERFORMANCE_ENABLED=true
+
+# Performance monitoring sample rate 0.0-1.0 (default: 1.0 = 100%)
+# SNOW_FLOW_SAMPLE_RATE=1.0
+
+# Metrics retention in milliseconds (default: 604800000 = 7 days)
+# SNOW_FLOW_METRICS_RETENTION=604800000
+
+# Metrics aggregation interval in milliseconds (default: 300000 = 5 minutes)
+# SNOW_FLOW_AGGREGATION_INTERVAL=300000
+
+# Health check interval in milliseconds (default: 60000 = 1 minute)
+# SNOW_FLOW_HEALTH_CHECK_INTERVAL=60000
+
+# Memory usage threshold 0.0-1.0 (default: 0.8 = 80%)
+# SNOW_FLOW_MEMORY_THRESHOLD=0.8
+
+# CPU usage threshold 0.0-1.0 (default: 0.8 = 80%)
+# SNOW_FLOW_CPU_THRESHOLD=0.8
+
+# Error rate threshold 0.0-1.0 (default: 0.05 = 5%)
+# SNOW_FLOW_ERROR_RATE_THRESHOLD=0.05
+
+# Webhook URL for alerts (optional)
+# SNOW_FLOW_WEBHOOK_URL=https://your-webhook-url.com/alerts
+
+# Alert severity threshold: info, warn, error (default: warn)
+# SNOW_FLOW_ALERT_SEVERITY=warn
+
+# ===========================================
+# Health Check Thresholds
+# ===========================================
+
+# Response time threshold in milliseconds (default: 5000 = 5s)
+# SNOW_FLOW_RESPONSE_TIME_THRESHOLD=5000
+
+# Health check memory threshold in MB (default: 1000)
+# SNOW_FLOW_HEALTH_MEMORY_THRESHOLD=1000
+
+# Queue size threshold (default: 100)
+# SNOW_FLOW_QUEUE_SIZE_THRESHOLD=100
+
+# ===========================================
+# Feature Flags
+# ===========================================
+
+# Enable automatic permission escalation (default: false)
+# SNOW_FLOW_AUTO_PERMISSIONS=false
+
+# Enable smart artifact discovery and reuse (default: true)
+# SNOW_FLOW_SMART_DISCOVERY=true
+
+# Enable live testing during development (default: true)
+# SNOW_FLOW_LIVE_TESTING=true
+
+# Enable automatic deployment when ready (default: true)
+# SNOW_FLOW_AUTO_DEPLOY=true
+
+# Enable automatic rollback on failures (default: true)
+# SNOW_FLOW_AUTO_ROLLBACK=true
+
+# Enable shared memory between agents (default: true)
+# SNOW_FLOW_SHARED_MEMORY=true
+
+# Enable real-time progress monitoring (default: true)
+# SNOW_FLOW_PROGRESS_MONITORING=true
+
+# Enable neural pattern recognition (default: false)
+# SNOW_FLOW_NEURAL_PATTERNS=false
+
+# Enable cognitive analysis features (default: false)
+# SNOW_FLOW_COGNITIVE_ANALYSIS=false
 
 # ===========================================
-# Snow-Flow Configuration
+# Legacy Configuration (for backwards compatibility)
 # ===========================================
 
-# Enable debug logging (true/false)
-SNOW_FLOW_DEBUG=false
+# Legacy debug flag (use SNOW_FLOW_LOG_LEVEL=debug instead)
+# SNOW_FLOW_DEBUG=false
 
-# Default coordination strategy
-SNOW_FLOW_STRATEGY=development
+# Legacy strategy flag (use swarm command options instead) 
+# SNOW_FLOW_STRATEGY=development
 
-# Maximum number of agents
-SNOW_FLOW_MAX_AGENTS=5
+# Legacy max agents flag (use swarm command options instead)
+# 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
+# Legacy timeout flag (use SNOW_FLOW_SESSION_TIMEOUT instead)
+# SNOW_FLOW_TIMEOUT_MINUTES=0
 
 # ===========================================
 # How to Set Up ServiceNow OAuth
@@ -43,7 +254,31 @@ SNOW_FLOW_TIMEOUT_MINUTES=0
 #    - Name: Snow-Flow Development
 #    - Client ID: (will be generated)
 #    - Client Secret: (will be generated)  
-#    - Redirect URL: http://localhost:3000/callback
+#    - Redirect URL: http://localhost:3005/callback
 #    - Grant Type: Authorization Code
+#    - Scopes: useraccount write admin
 # 5. Copy the Client ID and Client Secret to this file
 # 6. Run: snow-flow auth login
+
+# ===========================================
+# Environment-Specific Examples
+# ===========================================
+
+# Development Environment (high logging, low timeouts)
+# SNOW_FLOW_ENV=development
+# SNOW_FLOW_LOG_LEVEL=debug
+# SNOW_REQUEST_TIMEOUT=30000
+# SNOW_FLOW_PERFORMANCE_ENABLED=true
+
+# Production Environment (optimized for performance)
+# SNOW_FLOW_ENV=production
+# SNOW_FLOW_LOG_LEVEL=warn
+# SNOW_REQUEST_TIMEOUT=60000
+# SNOW_FLOW_MAX_CONCURRENT_OPS=20
+# SNOW_FLOW_PERFORMANCE_ENABLED=false
+
+# Testing Environment (isolated and controlled)
+# SNOW_FLOW_ENV=staging
+# SNOW_FLOW_LOG_LEVEL=info
+# SNOW_FLOW_AUTO_DEPLOY=false
+# SNOW_FLOW_AUTO_ROLLBACK=true

package/CLAUDE.md

@@ -38,18 +38,36 @@ const gapAnalysis = await analyzeGaps("your objective", mcpTools, logger, {
 console.log('🧠 Queen Agent spawning 6+ parallel agents for 2.8x faster development...');
 
 // 5. MANDATORY: Real ServiceNow deployment
-const deployment = await snow_deploy({
-  type: "widget|flow|application",
-  config: { /* your config */ },
-  auto_update_set: true  // Always track changes
-});
-
-// 4. MANDATORY: Track in Update Set
-await snow_update_set_add_artifact({
-  type: deployment.type,
-  sys_id: deployment.result.sys_id,
-  name: deployment.result.name
-});
+// For flows: Use XML-first approach (automatic detection)
+if (isFlowDesignerTask) {
+  // XML generation and deployment
+  const xmlResult = generateProductionFlowXML(flowDefinition);
+  
+  // Option 1: Auto-deploy XML (recommended)
+  const deployment = await snow_deploy({
+    type: "xml_update_set",
+    xml_file_path: xmlResult.filePath,
+    auto_preview: true,
+    auto_commit: true
+  });
+  
+  // Option 2: Manual deployment command
+  console.log(`Deploy with: snow-flow deploy-xml "${xmlResult.filePath}"`);
+} else {
+  // For widgets, applications, scripts: Use standard MCP deployment
+  const deployment = await snow_deploy({
+    type: "widget|application|script",
+    config: { /* your config */ },
+    auto_update_set: true  // Always track changes
+  });
+  
+  // Track in Update Set
+  await snow_update_set_add_artifact({
+    type: deployment.type,
+    sys_id: deployment.result.sys_id,
+    name: deployment.result.name
+  });
+}
 ```
 
 ### 🚫 FORBIDDEN ACTIONS
@@ -157,15 +175,16 @@ snow-flow swarm "build approval workflow for equipment requests"
 snow-flow swarm "deploy mobile-responsive widget with accessibility features"
 ```
 
-**What happens internally in every swarm (v1.1.93):**
+**What happens internally in every swarm (v1.3.1):**
 1. ✅ **Pre-flight auth check** with `snow_validate_live_connection()`
 2. ✅ **Smart discovery** with `snow_comprehensive_search()`  
-3. 🧠 **NEW: Intelligent Gap Analysis** - detects ALL required ServiceNow configurations
-4. 🚀 **REVOLUTIONARY: 6+ Parallel Agent Spawning** - automatic specialized team creation
-5. ✅ **Multi-agent coordination** with shared MCP context and 2.8x speedup
-6. ✅ **Real deployment** with `snow_deploy()`
-7. ✅ **Automatic tracking** with `snow_update_set_add_artifact()`
-8. ✅ **Live testing** with `snow_test_flow_with_mock()` or `snow_widget_test()`
+3. 🧠 **Intelligent Gap Analysis** - detects ALL required ServiceNow configurations
+4. 🔧 **NEW: Automatic Flow Designer Detection** - auto-switches to XML-first for Flow Designer flows
+5. 🚀 **REVOLUTIONARY: 6+ Parallel Agent Spawning** - automatic specialized team creation
+6. ✅ **Multi-agent coordination** with shared MCP context and 2.8x speedup
+7. ✅ **Real deployment** with `snow_deploy()` or **XML Auto-Import** for flows
+8. ✅ **Automatic tracking** with `snow_update_set_add_artifact()`
+9. ✅ **Live testing** with `snow_test_flow_with_mock()` or `snow_widget_test()`
 
 ### Swarm MCP Integration Features
 
@@ -174,8 +193,124 @@ snow-flow swarm "deploy mobile-responsive widget with accessibility features"
 - **🔄 Update Set Management**: Automatic `snow_smart_update_set()` creation
 - **🐝 Swarm Coordination**: All agents share MCP context and coordinate via real ServiceNow data
 - **🚀 Live Deployment**: Direct ServiceNow integration via MCP tools
+- **🔧 Flow Designer Auto-Detection**: Automatically detects Flow Designer tasks and uses XML-first approach
+- **📦 XML Auto-Import**: Automatically imports, previews, and commits XML update sets to ServiceNow
 - **⚡ Revolutionary Parallel Execution**: 6+ specialized agents (widget-creator, css-specialist, backend-specialist, frontend-specialist, integration-specialist, performance-specialist, tester) work simultaneously for 2.8x faster development
 
+## 🔧 NEW: Flow Designer XML Auto-Deployment (v1.3.1)
+
+**No more manual XML imports! Snow-flow now automatically deploys Flow Designer flows to ServiceNow.**
+
+### ⚡ Automatic Detection & Deployment
+
+When you run any flow-related swarm command, Snow-flow automatically:
+
+1. **🔍 Detects Flow Designer Tasks**: 
+   ```bash
+   snow-flow swarm "create approval flow for equipment requests"
+   snow-flow swarm "build automated notification workflow"  
+   snow-flow swarm "design escalation flow with manager approval"
+   ```
+
+2. **🔧 Shows XML-First Detection**:
+   ```
+   🔧 Flow Designer Detected - Using XML-First Approach!
+   📋 Creating production-ready ServiceNow flow XML...
+   💡 Reason: Flow Designer flows are most reliable with XML-first approach
+   ```
+
+3. **📦 Generates Complete XML**: Creates production-ready Update Set XML with:
+   - `sys_hub_flow` - Main flow record
+   - `sys_hub_flow_snapshot` - Flow definition and structure  
+   - `sys_hub_trigger_instance` - Flow trigger configuration
+   - `sys_hub_action_instance` - All flow activities (approval, notification, etc.)
+   - `sys_hub_flow_logic` - Activity connections and flow paths
+
+4. **🚀 Provides Auto-Deploy Command**:
+   ```bash
+   🚀 Auto-Deploy enabled - importing XML to ServiceNow...
+   💡 To deploy, use the following command:
+      snow-flow deploy-xml "flow-update-sets/your_flow.xml"
+   ```
+
+### 🚀 One-Command Deployment
+
+```bash
+# Deploy any generated XML flow directly to ServiceNow
+snow-flow deploy-xml flow-update-sets/my_flow.xml
+
+# With options:
+snow-flow deploy-xml my_flow.xml --no-preview    # Skip preview step
+snow-flow deploy-xml my_flow.xml --no-commit     # Preview only, manual commit
+```
+
+**What the deploy-xml command does:**
+1. ✅ **Import**: Uploads XML to ServiceNow as remote update set
+2. ✅ **Load**: Loads the update set into local update sets
+3. ✅ **Preview**: Checks for problems and conflicts  
+4. ✅ **Commit**: Auto-commits if preview is clean
+5. ✅ **Verify**: Confirms flow is available in Flow Designer
+
+### 🎯 Complete Flow Development Workflow
+
+**End-to-End Flow Creation (Zero Manual Steps):**
+
+```bash
+# 1. Create flow with automatic XML generation
+snow-flow swarm "create incident escalation flow with email notifications"
+
+# Output:
+# 🔧 Flow Designer Detected - Using XML-First Approach!
+# ✅ XML Generated Successfully!
+# 📁 File saved to: flow-update-sets/incident_escalation_flow.xml
+# 🚀 Auto-Deploy enabled - importing XML to ServiceNow...
+# 💡 To deploy, use the following command:
+#    snow-flow deploy-xml "flow-update-sets/incident_escalation_flow.xml"
+
+# 2. Deploy to ServiceNow (one command!)
+snow-flow deploy-xml flow-update-sets/incident_escalation_flow.xml
+
+# Output:
+# 📦 Deploying XML Update Set: flow-update-sets/incident_escalation_flow.xml
+# ✅ XML imported successfully (sys_id: abc123...)
+# ✅ Update set loaded: Incident_Escalation_Flow_Import
+# 🔍 Previewing update set...
+# ✅ Preview successful - no problems found
+# 🚀 Committing update set...
+# ✅ Update Set committed successfully!
+# 📍 Navigate to Flow Designer > Designer to see your flow
+# 🎉 Deployment complete!
+```
+
+### 🔧 Advanced XML Deployment Features
+
+**Error Handling & Safety**:
+- **Preview Problems Detection**: Automatically detects and reports conflicts
+- **Safe Auto-Commit**: Only commits if preview is completely clean
+- **Graceful Fallbacks**: Provides manual steps if auto-deployment fails
+- **Authentication Validation**: Ensures valid ServiceNow connection before deployment
+
+**Manual Control Options**:
+```bash
+# Preview only (no commit) - for review and testing
+snow-flow deploy-xml my_flow.xml --no-commit
+
+# Direct commit (skip preview) - for trusted environments  
+snow-flow deploy-xml my_flow.xml --no-preview
+
+# Check authentication first
+snow-flow auth status
+```
+
+**Troubleshooting**:
+```bash
+# If deployment fails, check:
+1. snow-flow auth status              # Verify authentication
+2. Check XML file exists and is valid
+3. Ensure admin permissions in ServiceNow
+4. Review any preview problems reported
+```
+
 ## 🔒 MANDATORY ServiceNow Development Workflow
 
 ### **STEP 1: Authentication Validation (ALWAYS FIRST)**
@@ -460,7 +595,15 @@ snow-flow queen "create ITSM solution with approval workflows"
 ### Core Deployment Tools
 ```javascript
 // Universal deployment (replaces all old deploy_* tools)
-snow_deploy({ type: "widget|flow|application", config: {...} })
+snow_deploy({ type: "widget|application|script", config: {...} })
+
+// NEW: XML Update Set deployment for flows
+snow_deploy({ 
+  type: "xml_update_set",
+  xml_file_path: "/path/to/flow.xml",
+  auto_preview: true,
+  auto_commit: true
+})
 
 // Smart artifact discovery  
 snow_find_artifact({ query: "natural language", type: "widget" })
@@ -624,14 +767,32 @@ Snow-flow is built on **MCP-native architecture**:
 ```bash
 # ✅ PRIMARY INTERFACE - Use this!
 snow-flow swarm "create incident dashboard widget"
-snow-flow swarm "build approval workflow for equipment requests"
+snow-flow swarm "build approval flow for equipment requests"  # Auto-detects Flow Designer!
 snow-flow swarm "deploy mobile-responsive widget with accessibility features"
 
 # ✅ All swarm operations automatically include:
 # 1. snow_validate_live_connection() - Auth check
 # 2. snow_comprehensive_search() - Smart discovery  
-# 3. snow_deploy() - Real ServiceNow deployment
-# 4. snow_update_set_add_artifact() - Automatic tracking
+# 3. 🔧 Automatic Flow Designer detection (NEW!)
+# 4. snow_deploy() OR XML generation + auto-import for flows
+# 5. snow_update_set_add_artifact() - Automatic tracking
 ```
 
-**Every swarm operation is MCP-native and ServiceNow-first!** 🐝
+**Every swarm operation is MCP-native and ServiceNow-first!** 🐝
+
+### 🚀 Complete Commands Reference
+
+```bash
+# Flow Designer workflows (auto-XML generation + deployment)
+snow-flow swarm "create approval flow for equipment requests"
+snow-flow deploy-xml flow-update-sets/approval_flow.xml
+
+# Widget development (standard MCP deployment)  
+snow-flow swarm "create incident dashboard widget"
+
+# Application development (standard MCP deployment)
+snow-flow swarm "build complete ITSM application"
+
+# Mixed development (intelligent routing)
+snow-flow swarm "create incident management system with approval flows and dashboard widgets"
+```

package/README.md

@@ -12,9 +12,31 @@
 - 🎯 **Claude Code Integration**: All coordination happens through Claude Code interface
 - 🚀 **One Command**: `snow-flow swarm "objective"` - everything else is automatic
 
-## ✨ What's New in v1.1.93 - Revolutionary Parallel Agent Spawning WORKING!
+## ✨ What's New in v1.3.1 - Flow Designer XML Auto-Deployment COMPLETE!
 
-### 🚀 BREAKTHROUGH: 6+ Parallel Agents Working Simultaneously!
+### 🚀 BREAKTHROUGH: Complete XML Update Set Auto-Import!
+- **✅ ZERO MANUAL STEPS**: One command imports, previews, and commits XML update sets automatically
+- **✅ FLOW DESIGNER INTEGRATION**: Automatic detection of Flow Designer artifacts in swarm commands
+- **✅ XML GENERATION & DEPLOYMENT**: Complete workflow from swarm creation to XML deployment
+- **✅ SAFETY CONTROLS**: Auto-preview with problem detection, only commits if clean
+- **✅ NEW CLI COMMAND**: `snow-flow deploy-xml <file>` for standalone XML deployment
+- **✅ MCP INTEGRATION**: Extended deployment MCP to support xml_update_set type
+
+### 🔄 Flow Designer XML Workflow
+```bash
+# 1. Create flow with swarm
+snow-flow swarm "create approval workflow for equipment requests"
+
+# 2. Export XML automatically generated in flow-update-sets/
+# 3. Deploy XML with single command - no manual import!
+snow-flow deploy-xml flow-update-sets/flow_approval_workflow.xml
+
+# ✅ Complete automation: Import → Load → Preview → Commit (only if clean)
+```
+
+### 🚀 Previous Release: v1.1.93 - Revolutionary Parallel Agent Spawning WORKING!
+
+#### 🚀 BREAKTHROUGH: 6+ Parallel Agents Working Simultaneously!
 - **✅ PROVEN RESULTS**: 6+ specialized agents spawn automatically for widget development
 - **✅ 2.8x SPEEDUP**: Demonstrated 2.8x faster development vs single-agent approach
 - **✅ SPECIALIZED TEAMS**: widget-creator, css-specialist, backend-specialist, frontend-specialist, integration-specialist, performance-specialist, ui-ux-specialist, tester
@@ -171,6 +193,10 @@ snow-flow swarm "Create incident management dashboard with real-time charts"
 
 # 🧠 NEW: Advanced example showing Gap Analysis Engine
 snow-flow queen "create ITSM solution with LDAP authentication and custom approval workflows"
+
+# 🚀 NEW: Complete Flow Designer XML deployment workflow
+snow-flow swarm "create approval workflow for equipment requests"
+snow-flow deploy-xml flow-update-sets/flow_approval_workflow.xml
 ```
 
 ### 🧠 What You'll See with Gap Analysis Engine
@@ -233,10 +259,24 @@ snow-flow memory stats
 snow-flow memory export <file>
 ```
 
+### 🚀 NEW: XML Update Set Deployment
+```bash
+# Deploy XML update sets automatically (Import → Preview → Commit)
+snow-flow deploy-xml <xmlFile>
+
+# Deploy with custom options
+snow-flow deploy-xml flow.xml --no-preview  # Skip preview step
+snow-flow deploy-xml flow.xml --no-commit   # Preview only, don't commit
+
+# Example: Deploy generated flow XML
+snow-flow deploy-xml flow-update-sets/flow_approval_workflow.xml
+```
+
 ### 🚀 Intelligent Features (Enabled by Default)
 - **🧠 Gap Analysis Engine**: Automatically detects ALL ServiceNow configurations beyond MCP tools
 - **🤖 Auto-Resolution**: Attempts automatic configuration of system properties, navigation, auth
 - **📚 Manual Guides**: Generates detailed step-by-step instructions for complex setups
+- **🚀 XML Auto-Deployment**: Complete XML update set import workflow with safety controls
 - **Smart Discovery**: Automatically discovers and reuses existing artifacts
 - **Live Testing**: Real-time testing during development on your ServiceNow instance
 - **Auto Deploy**: Automatic deployment when ready (safe with update sets)
@@ -294,16 +334,26 @@ snow-flow swarm "Create incident dashboard widget with pie charts and filter opt
 # 4. Automatic deployment to ServiceNow with Update Set tracking
 ```
 
-### Flow Creation
+### Flow Creation & XML Deployment
 ```bash
-# Complex approval workflow
+# Complex approval workflow with automatic XML generation
 snow-flow swarm "Build approval flow for equipment requests with manager and finance approval"
 
 # The Queen Agent will:
 # 1. Spawn Flow Builder + Security Agent
 # 2. Flow Builder designs multi-step approval process
 # 3. Security Agent validates permissions and compliance
-# 4. Live testing with mock data before deployment
+# 4. Automatic XML generation in flow-update-sets/ directory
+# 5. Display deploy-xml command for seamless deployment
+
+# 🚀 NEW: Complete XML deployment workflow
+snow-flow deploy-xml flow-update-sets/flow_equipment_approval.xml
+
+# ✅ Automatic process:
+# • Import XML to ServiceNow
+# • Load remote update set  
+# • Preview changes & check for conflicts
+# • Commit automatically if clean (or prompt if issues found)
 ```
 
 ### Complete Solutions