snow-flow 1.4.22 → 1.4.24

package/README.md

@@ -32,38 +32,52 @@ Snow-Flow is the **most advanced ServiceNow intelligence platform** available, c
 
 ---
 
-## 🎯 **Core Capabilities**
+## 🤖 **The Power of Swarm: One Command, Infinite Possibilities**
+
+**Snow-Flow's revolutionary approach: Just describe what you want in natural language, and our AI swarm makes it happen.**
+
+### ⚡ **The Only Command You Need**
+
+```bash
+# Instead of manually using 14 different tools...
+snow-flow swarm "Your natural language request here"
+
+# Examples:
+snow-flow swarm "Analyze my incident table for performance issues and unused fields"
+snow-flow swarm "Discover all change management processes and identify bottlenecks"  
+snow-flow swarm "Optimize my ServiceNow instance for better performance"
+snow-flow swarm "Create documentation for all my custom workflows"
+```
+
+**Behind the scenes:** Our AI swarm automatically:
+- 🎯 **Analyzes your request** and determines which of the 14 tools to use
+- 🤖 **Spawns specialist agents** (Performance, Process Mining, Security, Analytics)
+- ⚡ **Executes in parallel** for maximum speed and efficiency
+- 🧠 **Learns from each interaction** to improve future responses
+- 📊 **Delivers comprehensive results** with actionable insights
+
+### 🎯 **Why Swarm Changes Everything**
 
 <table>
 <tr>
 <td width="50%">
 
-### 🧠 **AI Intelligence**
-- **Predictive Impact Analysis** with 90%+ accuracy
-- **Pattern Recognition** across all scripts
-- **Automated Documentation** generation
-- **Intelligent Code Refactoring**
-
-### ⚡ **Performance Revolution**
-- **80% API call reduction** through smart batching
-- **60% faster analysis** with parallel processing
-- **Real-time monitoring** with anomaly detection
-- **Query optimization** with index recommendations
+### **❌ Traditional Approach**
+- Learn 14 different tool syntaxes
+- Manually coordinate multiple analyses
+- Sequential execution (slow)
+- Miss connections between insights
+- Complex command-line operations
 
 </td>
 <td width="50%">
 
-### 🔍 **Deep Analytics**
-- **Process Mining** from real event logs
-- **Cross-table process discovery**
-- **Field usage intelligence** across all components
-- **Migration planning** with risk assessment
-
-### 🤖 **Multi-Agent Orchestration**
-- **Autonomous specialist agents** for every domain
-- **Swarm coordination** with shared memory
-- **Self-healing workflows** with auto-recovery
-- **Claude Code integration** for ultimate control
+### **✅ Snow-Flow Swarm Approach**
+- **One natural language command**
+- **AI automatically coordinates everything**  
+- **Parallel execution** (60% faster)
+- **Holistic insights** across all domains
+- **Conversational interface**
 
 </td>
 </tr>
@@ -71,7 +85,9 @@ Snow-Flow is the **most advanced ServiceNow intelligence platform** available, c
 
 ---
 
-## 🛠️ **14 Advanced Intelligence Tools**
+## 🛠️ **Underlying AI Capabilities (Automatically Used by Swarm)**
+
+*You don't need to learn these - the swarm uses them automatically based on your natural language requests*
 
 ### 📊 **Performance & Analytics**
 
@@ -272,102 +288,164 @@ snow-flow tool snow_analyze_table_deep \
 
 ---
 
-## ⚡ **Quick Start**
+## ⚡ **Quick Start: From Zero to AI-Powered Analysis in 5 Minutes**
 
-### 1. **Installation**
+### 0. **Prerequisites**
+
+⚠️ **IMPORTANT: Claude Code must be installed first** (Snow-Flow orchestrates through Claude Code):
 
 ```bash
-# Install globally for command-line use
-npm install -g snow-flow
+# 1. Install Claude Code globally
+npm install -g @anthropic-ai/claude-code
+
+# 2. (Optional) Skip permissions check for faster setup
+# Only use if you understand the security implications
+claude --dangerously-skip-permissions
+```
+
+**Platform Support:**
+- ✅ **macOS**: Extensively tested and fully supported
+- ⚙️ **Linux/Windows**: Should work but not extensively tested yet
 
-# Or install in your project
-npm install snow-flow
+### 1. **Install Snow-Flow**
+
+```bash
+# Install Snow-Flow globally
+npm install -g snow-flow
 
 # Verify installation
 snow-flow --version
 ```
 
-### 2. **Authentication Setup**
+### 2. **Authentication (One-Time Setup)**
 
 ```bash
-# Interactive OAuth setup (recommended)
+# Interactive OAuth setup (guided process)
 snow-flow auth login
 
-# Or use environment variables
-export SNOW_INSTANCE=your-instance.service-now.com
-export SNOW_CLIENT_ID=your-oauth-client-id
-export SNOW_CLIENT_SECRET=your-oauth-client-secret
+# That's it! Snow-Flow handles the rest
 ```
 
-### 3. **First Analysis**
+### 3. **Start Using Swarm (The Magic Begins)**
+
+**How it works:** Snow-Flow orchestrates through Claude Code, giving you natural language control over 14 advanced ServiceNow tools.
 
 ```bash
-# Test connection and analyze your incident table
-snow-flow tool snow_analyze_table_deep \
-  --table_name incident \
-  --analysis_scope '["structure", "performance", "data_quality"]'
+# Just tell Snow-Flow what you want in natural language:
 
-# Discover processes in your instance
-snow-flow tool snow_discover_process \
-  --process_type incident_management --analysis_period 30d
-```
+# 🔍 Analyze your ServiceNow instance
+snow-flow swarm "Give me a comprehensive health check of my ServiceNow instance"
 
-### 4. **Multi-Agent Swarm (Advanced)**
+# 📊 Performance optimization  
+snow-flow swarm "Find and fix performance issues in my incident management"
 
-```bash
-# Let AI agents analyze and optimize your entire ServiceNow instance
-snow-flow swarm "Comprehensive ServiceNow health check and optimization" \
-  --strategy analysis --parallel --agents 8
+# 🔄 Process discovery
+snow-flow swarm "Discover all my ITSM processes and identify bottlenecks"
+
+# 📚 Documentation generation
+snow-flow swarm "Create documentation for all my custom workflows and scripts"
 
-# AI-powered process optimization
-snow-flow swarm "Discover and optimize all incident management processes" \
-  --strategy development --auto-deploy
+# 🛡️ Security analysis
+snow-flow swarm "Analyze my instance for security vulnerabilities and compliance issues"
 ```
 
+**That's literally it!** No complex command syntax, no manual tool selection, no configuration. Just natural language requests and Snow-Flow's AI swarm handles everything through Claude Code's intelligent orchestration.
+
+### 🎯 **What Happens Behind the Scenes**
+
+When you run a swarm command, Snow-Flow automatically:
+
+1. 🧠 **Understands your request** using advanced NLP
+2. 🎯 **Selects optimal tools** from the 14 available capabilities  
+3. 🤖 **Spawns specialist agents** for each domain (Performance, Security, Process Mining)
+4. ⚡ **Executes everything in parallel** for maximum speed
+5. 🔗 **Combines insights** into a comprehensive, actionable report
+6. 💾 **Learns from the interaction** to improve future responses
+
 ---
 
-## 🌟 **Real-World Examples**
+## 🌟 **Real-World Swarm Examples**
+
+*Just describe what you need - no technical syntax required*
 
-### 🎯 **Performance Optimization**
+### 🎯 **Performance Issues? Just Ask**
 
 ```bash
-# Scenario: Slow incident queries affecting user experience
-snow-flow tool snow_analyze_query \
-  --query 'state=1^priority<=2^assigned_toISNOTEMPTY' \
-  --table incident --analyze_indexes true
+# You say:
+snow-flow swarm "My incident table is really slow, can you fix it?"
+
+# Swarm automatically:
+# ✅ Analyzes query performance patterns
+# ✅ Identifies slow queries and bottlenecks  
+# ✅ Recommends database indexes
+# ✅ Suggests field usage optimizations
+# ✅ Provides concrete improvement plan
 
-# Result: Index recommendations, query optimization, 70% faster response
+# Result: 70% faster incident queries, detailed optimization roadmap
 ```
 
-### 🔍 **Technical Debt Reduction**
+### 🔍 **ServiceNow Cleanup Made Simple**
 
 ```bash
-# Scenario: Too many unused fields cluttering the instance
-snow-flow tool snow_analyze_field_usage \
-  --table incident --analyze_queries true --unused_threshold_days 90
+# You say:
+snow-flow swarm "My ServiceNow instance feels cluttered and messy"
 
-# Result: List of unused fields, deprecation plan, cleaner data model
+# Swarm automatically:
+# ✅ Scans for unused fields across all tables
+# ✅ Identifies orphaned workflows and rules
+# ✅ Analyzes technical debt patterns
+# ✅ Creates prioritized cleanup plan
+# ✅ Estimates impact of each cleanup action
+
+# Result: Clean instance roadmap with risk assessment and ROI calculations
 ```
 
-### 📊 **Process Discovery**
+### 📊 **Process Understanding Without the Hassle**
 
 ```bash
-# Scenario: Unknown bottlenecks in change management
-snow-flow tool snow_discover_process \
-  --process_type change_management --analysis_period 90d
+# You say:
+snow-flow swarm "I need to understand how our change management actually works"
 
-# Result: Process map, bottleneck identification, optimization recommendations
+# Swarm automatically:
+# ✅ Mines actual process flows from event logs
+# ✅ Discovers real vs. designed processes
+# ✅ Identifies bottlenecks and delays
+# ✅ Maps cross-table data flows
+# ✅ Creates visual process diagrams
+
+# Result: Complete process maps, bottleneck analysis, optimization opportunities
 ```
 
-### 🤖 **AI-Powered Refactoring**
+### 🛡️ **Security & Compliance on Autopilot**
 
 ```bash
-# Scenario: Legacy business rules need modernization
-snow-flow tool snow_refactor_code \
-  --refactoring_scope '["business_rules"]' \
-  --refactoring_goals '["performance", "security", "maintainability"]'
+# You say:
+snow-flow swarm "Check my ServiceNow instance for security issues and compliance problems"
 
-# Result: Modern code patterns, improved performance, enhanced security
+# Swarm automatically:
+# ✅ Scans code patterns for vulnerabilities
+# ✅ Analyzes access control configurations
+# ✅ Checks compliance framework alignment
+# ✅ Identifies security anti-patterns
+# ✅ Provides remediation recommendations
+
+# Result: Security audit report with prioritized actions and compliance gaps
+```
+
+### 🤖 **Documentation That Writes Itself**
+
+```bash
+# You say:
+snow-flow swarm "Create documentation for all my custom stuff"
+
+# Swarm automatically:
+# ✅ Discovers all custom workflows, scripts, and configurations
+# ✅ Analyzes code to understand functionality
+# ✅ Generates technical documentation
+# ✅ Creates user guides and process maps
+# ✅ Includes best practices and usage examples
+
+# Result: Comprehensive, always-current documentation suite
 ```
 
 ---
@@ -384,40 +462,54 @@ snow-flow tool snow_refactor_code \
 
 ---
 
-## 🧠 **Multi-Agent Architecture**
+## 🧠 **How Swarm Intelligence Works**
 
-Snow-Flow includes revolutionary multi-agent orchestration inspired by hive-mind intelligence:
+*The magic behind "snow-flow swarm" - you just talk, AI does everything*
 
-### 🎯 **Core Concepts**
+### 🎯 **What Happens When You Run a Swarm Command**
 
-- **👑 Coordinator Agent**: Master strategist that analyzes objectives and spawns specialists
-- **🤖 Specialist Agents**: Domain experts (Performance, Security, Process Mining, Analytics)
-- **💾 Shared Memory**: Persistent learning and coordination across all agents
-- **🔄 Self-Healing**: Automatic error recovery and workflow adaptation
+```bash
+snow-flow swarm "Optimize my ServiceNow for better performance"
+```
 
-### 🚀 **Swarm Commands**
+**Behind the scenes in seconds:**
 
-```bash
-# Intelligent health check with auto-spawning specialists
-snow-flow swarm "Complete ServiceNow instance analysis and optimization" \
-  --strategy analysis --parallel --auto-spawn
+1. **🧠 Natural Language Understanding**
+   - AI parses your request and intent
+   - Identifies scope, urgency, and objectives
+   - Maps to relevant ServiceNow domains
 
-# Process mining with coordinated specialist agents  
-snow-flow swarm "Discover bottlenecks in all ITSM processes" \
-  --agents 6 --strategy development --shared-memory
+2. **🎯 Intelligent Agent Spawning**
+   - **Performance Specialist** → Query optimization, indexing analysis
+   - **Process Mining Expert** → Workflow efficiency analysis  
+   - **Security Analyst** → Performance-related security checks
+   - **Data Specialist** → Field usage and data quality assessment
 
-# Real-time monitoring setup with self-healing
-snow-flow swarm "Setup monitoring for critical ServiceNow workflows" \
-  --auto-deploy --self-healing --predictive-alerts
-```
+3. **⚡ Parallel Execution**
+   - All agents work simultaneously
+   - Each uses multiple underlying tools automatically
+   - Real-time coordination through shared memory
+
+4. **🔗 Insight Integration**
+   - Combines findings from all specialists
+   - Identifies cross-domain patterns and dependencies
+   - Prioritizes recommendations by impact
+
+5. **📊 Comprehensive Reporting**
+   - Single, unified report with all insights
+   - Actionable recommendations with clear next steps
+   - Performance predictions and ROI estimates
+
+### 🌟 **Why This Changes Everything**
 
-### 🌟 **Advanced Features**
+**Traditional approach:** Learn 14 tools, understand complex syntax, manually coordinate analyses
+**Swarm approach:** Just describe what you need in plain English
 
-- **🎯 Auto-Agent Spawning**: AI automatically creates the right specialists for your task
-- **⚡ Parallel Execution**: All agents work simultaneously for maximum efficiency
-- **🧠 Continuous Learning**: Agents learn from every analysis and improve over time
-- **🔄 Self-Healing Workflows**: Automatic error recovery and retry mechanisms
-- **💾 Cross-Session Memory**: Persistent context and learning across all sessions
+- **🎯 Zero Learning Curve**: No commands to memorize, no syntax to learn
+- **⚡ 60% Faster Results**: Parallel execution vs. sequential tool use  
+- **🧠 Holistic Insights**: Connections across domains that manual analysis misses
+- **🔄 Continuous Improvement**: Each interaction makes future responses smarter
+- **💾 Persistent Memory**: Remembers your instance and preferences across sessions
 
 ---
 
@@ -523,11 +615,11 @@ npm run build
 npm test
 ```
 
-### **Roadmap**
-- 🚀 **Q1 2024**: Advanced ML models for process optimization
-- 🧠 **Q2 2024**: Natural language query interface
-- 🔮 **Q3 2024**: Predictive maintenance capabilities
-- 🌟 **Q4 2024**: Integration with additional ITSM platforms
+### **Future Vision (2025-2026)**
+- 🧠 **Q4 2025**: Advanced ML models for process optimization and prediction
+- 🔮 **Q1 2026**: Predictive maintenance capabilities with anomaly detection  
+- 🌟 **Q2 2026**: Multi-platform ITSM integration (Jira, Azure DevOps, etc.)
+- 🚀 **Q3 2026**: Enhanced natural language processing with domain-specific understanding
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "1.4.22",
+  "version": "1.4.24",
   "description": "Snow-Flow: ServiceNow Advanced Intelligence Platform - 14 AI-powered analysis tools with multi-agent orchestration. Zero Mock Data, 100% Real API Integration. Revolutionize ServiceNow development with hive-mind intelligence.",
   "main": "dist/index.js",
   "type": "commonjs",