snow-flow 2.0.2 → 2.0.4

package/{.claude/mcp-config.json → .mcp.json}

@@ -8,13 +8,15 @@
       "env": {
         "SNOW_INSTANCE": "${SNOW_INSTANCE}",
         "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
+        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}",
+        "SNOW_DEPLOYMENT_TIMEOUT": "${SNOW_DEPLOYMENT_TIMEOUT}",
+        "MCP_DEPLOYMENT_TIMEOUT": "${MCP_DEPLOYMENT_TIMEOUT}"
       }
     },
-    "servicenow-flow-composer": {
+    "servicenow-update-set": {
       "command": "node",
       "args": [
-        "/Users/nielsvanderwerf/Projects/servicenow_multiagent/dist/mcp/servicenow-flow-composer-mcp.js"
+        "/Users/nielsvanderwerf/Projects/servicenow_multiagent/dist/mcp/servicenow-update-set-mcp.js"
       ],
       "env": {
         "SNOW_INSTANCE": "${SNOW_INSTANCE}",
@@ -22,10 +24,10 @@
         "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
       }
     },
-    "servicenow-update-set": {
+    "servicenow-intelligent": {
       "command": "node",
       "args": [
-        "/Users/nielsvanderwerf/Projects/servicenow_multiagent/dist/mcp/servicenow-update-set-mcp.js"
+        "/Users/nielsvanderwerf/Projects/servicenow_multiagent/dist/mcp/servicenow-intelligent-mcp.js"
       ],
       "env": {
         "SNOW_INSTANCE": "${SNOW_INSTANCE}",
@@ -33,15 +35,14 @@
         "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
       }
     },
-    "servicenow-intelligent": {
+    "servicenow-memory": {
       "command": "node",
       "args": [
-        "/Users/nielsvanderwerf/Projects/servicenow_multiagent/dist/mcp/servicenow-intelligent-mcp.js"
+        "/Users/nielsvanderwerf/Projects/servicenow_multiagent/dist/mcp/servicenow-memory-mcp.js"
       ],
       "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
+        "MEMORY_PATH": "${MEMORY_PATH}",
+        "SNOW_FLOW_HOME": "${SNOW_FLOW_HOME}"
       }
     },
     "servicenow-graph-memory": {
@@ -124,10 +125,10 @@
         "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
       }
     },
-    "servicenow-memory": {
+    "servicenow-flow-composer": {
       "command": "node",
       "args": [
-        "/Users/nielsvanderwerf/Projects/servicenow_multiagent/dist/mcp/servicenow-memory-mcp.js"
+        "/Users/nielsvanderwerf/Projects/servicenow_multiagent/dist/mcp/servicenow-flow-composer-mcp.js"
       ],
       "env": {
         "SNOW_INSTANCE": "${SNOW_INSTANCE}",

package/.releaserc.json

@@ -0,0 +1,47 @@
+{
+  "branches": [
+    "main",
+    {
+      "name": "develop",
+      "prerelease": "beta"
+    }
+  ],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    [
+      "@semantic-release/changelog",
+      {
+        "changelogFile": "CHANGELOG.md"
+      }
+    ],
+    [
+      "@semantic-release/npm",
+      {
+        "npmPublish": true
+      }
+    ],
+    [
+      "@semantic-release/github",
+      {
+        "assets": [
+          {
+            "path": "dist/**",
+            "label": "Distribution files"
+          },
+          {
+            "path": "CHANGELOG.md",
+            "label": "Changelog"
+          }
+        ]
+      }
+    ],
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["CHANGELOG.md", "package.json", "package-lock.json"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ]
+  ]
+}

package/README.md

@@ -2,6 +2,12 @@
 
 [![npm version](https://badge.fury.io/js/snow-flow.svg)](https://badge.fury.io/js/snow-flow)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI/CD](https://github.com/groeimetai/snow-flow/actions/workflows/ci.yml/badge.svg)](https://github.com/groeimetai/snow-flow/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/groeimetai/snow-flow/branch/main/graph/badge.svg)](https://codecov.io/gh/groeimetai/snow-flow)
+[![Downloads](https://img.shields.io/npm/dm/snow-flow.svg)](https://www.npmjs.com/package/snow-flow)
+[![Node Version](https://img.shields.io/node/v/snow-flow.svg)](https://www.npmjs.com/package/snow-flow)
+[![GitHub Stars](https://img.shields.io/github/stars/groeimetai/snow-flow?style=social)](https://github.com/groeimetai/snow-flow)
+[![Discord](https://img.shields.io/discord/DISCORD_ID?logo=discord&label=Discord)](https://discord.gg/snow-flow)
 
 Snow-Flow revolutionizes ServiceNow development by bringing the power of AI orchestration directly to your platform. With 100+ MCP tools and intelligent multi-agent coordination, Snow-Flow transforms how developers and administrators work with ServiceNow.
 
@@ -16,10 +22,51 @@ Every interaction with Snow-Flow provides insights into ServiceNow best practice
 ### **Real Integration, Real Results**
 Unlike mock tools or simulations, Snow-Flow connects directly to your ServiceNow instance through secure OAuth authentication. Every operation is real, every deployment is functional, and every result is production-ready.
 
+## 🔐 ServiceNow API Integration & Security
+
+### **Direct ServiceNow API Connection**
+All 100+ MCP tools use **official ServiceNow REST APIs** exclusively:
+- **No third-party services** - Your data stays between you and ServiceNow
+- **Standard OAuth 2.0** - Industry-standard authentication protocol
+- **ServiceNow ACLs respected** - Only access what your ServiceNow user can access
+- **Real-time operations** - Direct API calls, no data caching or storage
+
+### **How OAuth Authentication Works**
+```bash
+snow-flow auth login
+# 1. Opens ServiceNow OAuth consent screen in your browser
+# 2. You authenticate with YOUR ServiceNow credentials
+# 3. ServiceNow returns OAuth token directly to Snow-Flow
+# 4. Token stored locally in ~/.snow-flow/auth.json (encrypted)
+# 5. All API calls use this token with proper ServiceNow permissions
+```
+
+### **Data Privacy & Security**
+- ✅ **Zero data collection** - Snow-Flow doesn't collect or store your ServiceNow data
+- ✅ **Local processing** - All operations happen on your machine
+- ✅ **No external servers** - Direct ServiceNow ↔ Snow-Flow communication only
+- ✅ **Audit compliance** - All actions logged in ServiceNow audit trails
+- ✅ **Role-based access** - Respects your ServiceNow user permissions exactly
+
+### **Network Architecture**
+```
+┌─────────────┐    OAuth 2.0 + REST APIs    ┌─────────────────┐
+│  Snow-Flow  │ ◄─────────────────────────► │ Your ServiceNow │
+│   (Local)   │      HTTPS Only              │    Instance     │
+└─────────────┘                              └─────────────────┘
+     ▲                                               
+     │ No external connections                       
+     ▼                                               
+┌─────────────┐                                     
+│ Claude Code │ ◄── Local AI processing only        
+│   (Local)   │                                     
+└─────────────┘                                     
+```
+
 ## ✨ Core Capabilities
 
 ### 🤖 **Intelligent Multi-Agent System**
-- **25+ Specialized Agents**: From architects to testers, each agent brings specific expertise
+- **38 Specialized Agents**: From architects to testers, each agent brings specific expertise
 - **Swarm Coordination**: Agents work together using hierarchical, mesh, or adaptive topologies
 - **Shared Memory**: Persistent knowledge base ensures consistency across all operations
 - **Neural Learning**: Pattern recognition improves suggestions and automation over time

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Snow-Flow: ServiceNow Advanced Intelligence Platform - 100+ real MCP tools with AI-powered swarm orchestration. Zero Mock Data, 100% Real API Integration. Natural language interface for ServiceNow operations.",
   "main": "dist/index.js",
   "type": "commonjs",

package/.claude/claude-settings.json

@@ -1,15 +0,0 @@
-{
-  "mcpServers": {
-    "servicenow": {
-      "command": "node",
-      "args": [
-        "dist/mcp/start-servicenow-mcp.js"
-      ],
-      "env": {
-        "SNOW_INSTANCE": "${SNOW_INSTANCE}",
-        "SNOW_CLIENT_ID": "${SNOW_CLIENT_ID}",
-        "SNOW_CLIENT_SECRET": "${SNOW_CLIENT_SECRET}"
-      }
-    }
-  }
-}

package/.claude/commands/analysis/README.md

@@ -1,9 +0,0 @@
-# Analysis Commands
-
-Commands for analysis operations in Claude Flow.
-
-## Available Commands
-
-- [bottleneck-detect](./bottleneck-detect.md)
-- [token-usage](./token-usage.md)
-- [performance-report](./performance-report.md)

package/.claude/commands/automation/README.md

@@ -1,9 +0,0 @@
-# Automation Commands
-
-Commands for automation operations in Claude Flow.
-
-## Available Commands
-
-- [auto-agent](./auto-agent.md)
-- [smart-spawn](./smart-spawn.md)
-- [workflow-select](./workflow-select.md)

package/.claude/commands/github/README.md

@@ -1,11 +0,0 @@
-# Github Commands
-
-Commands for github operations in Claude Flow.
-
-## Available Commands
-
-- [github-swarm](./github-swarm.md)
-- [repo-analyze](./repo-analyze.md)
-- [pr-enhance](./pr-enhance.md)
-- [issue-triage](./issue-triage.md)
-- [code-review](./code-review.md)

package/.claude/commands/helpers/standard-checkpoint-hooks.sh

@@ -1,179 +0,0 @@
-#!/bin/bash
-# Standard checkpoint hook functions for Claude settings.json (without GitHub features)
-
-# Function to handle pre-edit checkpoints
-pre_edit_checkpoint() {
-    local tool_input="$1"
-    local file=$(echo "$tool_input" | jq -r '.file_path // empty')
-    
-    if [ -n "$file" ]; then
-        local checkpoint_branch="checkpoint/pre-edit-$(date +%Y%m%d-%H%M%S)"
-        local current_branch=$(git branch --show-current)
-        
-        # Create checkpoint
-        git add -A
-        git stash push -m "Pre-edit checkpoint for $file" >/dev/null 2>&1
-        git branch "$checkpoint_branch"
-        
-        # Store metadata
-        mkdir -p .claude/checkpoints
-        cat > ".claude/checkpoints/$(date +%s).json" <<EOF
-{
-  "branch": "$checkpoint_branch",
-  "file": "$file",
-  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
-  "type": "pre-edit",
-  "original_branch": "$current_branch"
-}
-EOF
-        
-        # Restore working directory
-        git stash pop --quiet >/dev/null 2>&1 || true
-        
-        echo "✅ Created checkpoint: $checkpoint_branch for $file"
-    fi
-}
-
-# Function to handle post-edit checkpoints
-post_edit_checkpoint() {
-    local tool_input="$1"
-    local file=$(echo "$tool_input" | jq -r '.file_path // empty')
-    
-    if [ -n "$file" ] && [ -f "$file" ]; then
-        # Check if file was modified - first check if file is tracked
-        if ! git ls-files --error-unmatch "$file" >/dev/null 2>&1; then
-            # File is not tracked, add it first
-            git add "$file"
-        fi
-        
-        # Now check if there are changes
-        if git diff --cached --quiet "$file" 2>/dev/null && git diff --quiet "$file" 2>/dev/null; then
-            echo "ℹ️  No changes to checkpoint for $file"
-        else
-            local tag_name="checkpoint-$(date +%Y%m%d-%H%M%S)"
-            local current_branch=$(git branch --show-current)
-            
-            # Create commit
-            git add "$file"
-            if git commit -m "🔖 Checkpoint: Edit $file
-
-Automatic checkpoint created by Claude
-- File: $file
-- Branch: $current_branch
-- Timestamp: $(date -u +%Y-%m-%dT%H:%M:%SZ)
-
-[Auto-checkpoint]" --quiet; then
-                # Create tag only if commit succeeded
-                git tag -a "$tag_name" -m "Checkpoint after editing $file"
-                
-                # Store metadata
-                mkdir -p .claude/checkpoints
-                local diff_stats=$(git diff HEAD~1 --stat | tr '\n' ' ' | sed 's/"/\\"/g')
-                cat > ".claude/checkpoints/$(date +%s).json" <<EOF
-{
-  "tag": "$tag_name",
-  "file": "$file",
-  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
-  "type": "post-edit",
-  "branch": "$current_branch",
-  "diff_summary": "$diff_stats"
-}
-EOF
-                
-                echo "✅ Created checkpoint: $tag_name for $file"
-            else
-                echo "ℹ️  No commit created (no changes or commit failed)"
-            fi
-        fi
-    fi
-}
-
-# Function to handle task checkpoints
-task_checkpoint() {
-    local user_prompt="$1"
-    local task=$(echo "$user_prompt" | head -c 100 | tr '\n' ' ')
-    
-    if [ -n "$task" ]; then
-        local checkpoint_name="task-$(date +%Y%m%d-%H%M%S)"
-        
-        # Commit current state
-        git add -A
-        git commit -m "🔖 Task checkpoint: $task..." --quiet || true
-        
-        # Store metadata
-        mkdir -p .claude/checkpoints
-        cat > ".claude/checkpoints/task-$(date +%s).json" <<EOF
-{
-  "checkpoint": "$checkpoint_name",
-  "task": "$task",
-  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
-  "commit": "$(git rev-parse HEAD)"
-}
-EOF
-        
-        echo "✅ Created task checkpoint: $checkpoint_name"
-    fi
-}
-
-# Function to handle session end
-session_end_checkpoint() {
-    local session_id="session-$(date +%Y%m%d-%H%M%S)"
-    local summary_file=".claude/checkpoints/summary-$session_id.md"
-    
-    mkdir -p .claude/checkpoints
-    
-    # Create summary
-    cat > "$summary_file" <<EOF
-# Session Summary - $(date +'%Y-%m-%d %H:%M:%S')
-
-## Checkpoints Created
-$(find .claude/checkpoints -name '*.json' -mtime -1 -exec basename {} \; | sort)
-
-## Files Modified
-$(git diff --name-only $(git log --format=%H -n 1 --before="1 hour ago" 2>/dev/null) 2>/dev/null || echo "No files tracked")
-
-## Recent Commits
-$(git log --oneline -10 --grep="Checkpoint" || echo "No checkpoint commits")
-
-## Rollback Instructions
-To rollback to a specific checkpoint:
-\`\`\`bash
-# List all checkpoints
-git tag -l 'checkpoint-*' | sort -r
-
-# Rollback to a checkpoint
-git checkout checkpoint-YYYYMMDD-HHMMSS
-
-# Or reset to a checkpoint (destructive)
-git reset --hard checkpoint-YYYYMMDD-HHMMSS
-\`\`\`
-EOF
-    
-    # Create final checkpoint
-    git add -A
-    git commit -m "🏁 Session end checkpoint: $session_id" --quiet || true
-    git tag -a "session-end-$session_id" -m "End of Claude session"
-    
-    echo "✅ Session summary saved to: $summary_file"
-    echo "📌 Final checkpoint: session-end-$session_id"
-}
-
-# Main entry point
-case "$1" in
-    pre-edit)
-        pre_edit_checkpoint "$2"
-        ;;
-    post-edit)
-        post_edit_checkpoint "$2"
-        ;;
-    task)
-        task_checkpoint "$2"
-        ;;
-    session-end)
-        session_end_checkpoint
-        ;;
-    *)
-        echo "Usage: $0 {pre-edit|post-edit|task|session-end} [input]"
-        exit 1
-        ;;
-esac

package/.claude/commands/hooks/README.md

@@ -1,11 +0,0 @@
-# Hooks Commands
-
-Commands for hooks operations in Claude Flow.
-
-## Available Commands
-
-- [pre-task](./pre-task.md)
-- [post-task](./post-task.md)
-- [pre-edit](./pre-edit.md)
-- [post-edit](./post-edit.md)
-- [session-end](./session-end.md)

package/.claude/commands/monitoring/README.md

@@ -1,9 +0,0 @@
-# Monitoring Commands
-
-Commands for monitoring operations in Claude Flow.
-
-## Available Commands
-
-- [swarm-monitor](./swarm-monitor.md)
-- [agent-metrics](./agent-metrics.md)
-- [real-time-view](./real-time-view.md)

package/.claude/commands/optimization/README.md

@@ -1,9 +0,0 @@
-# Optimization Commands
-
-Commands for optimization operations in Claude Flow.
-
-## Available Commands
-
-- [topology-optimize](./topology-optimize.md)
-- [parallel-execute](./parallel-execute.md)
-- [cache-manage](./cache-manage.md)

package/.claude/commands/training/README.md

@@ -1,9 +0,0 @@
-# Training Commands
-
-Commands for training operations in Claude Flow.
-
-## Available Commands
-
-- [neural-train](./neural-train.md)
-- [pattern-learn](./pattern-learn.md)
-- [model-update](./model-update.md)

package/.claude/commands/workflows/README.md

@@ -1,9 +0,0 @@
-# Workflows Commands
-
-Commands for workflows operations in Claude Flow.
-
-## Available Commands
-
-- [workflow-create](./workflow-create.md)
-- [workflow-execute](./workflow-execute.md)
-- [workflow-export](./workflow-export.md)

package/.claude/config.json

@@ -1,36 +0,0 @@
-{
-  "version": "1.0",
-  "sparc": {
-    "enabled": true,
-    "modes": [
-      "orchestrator",
-      "coder",
-      "researcher",
-      "tdd",
-      "architect",
-      "reviewer",
-      "debugger",
-      "tester",
-      "analyzer",
-      "optimizer",
-      "documenter",
-      "designer",
-      "innovator",
-      "swarm-coordinator",
-      "memory-manager",
-      "batch-executor",
-      "workflow-manager"
-    ]
-  },
-  "swarm": {
-    "enabled": true,
-    "strategies": [
-      "research",
-      "development",
-      "analysis",
-      "testing",
-      "optimization",
-      "maintenance"
-    ]
-  }
-}

package/.claude/helpers/github-setup.sh

@@ -1,28 +0,0 @@
-#!/bin/bash
-# Setup GitHub integration for Claude Flow
-
-echo "🔗 Setting up GitHub integration..."
-
-# Check for gh CLI
-if ! command -v gh &> /dev/null; then
-    echo "⚠️  GitHub CLI (gh) not found"
-    echo "Install from: https://cli.github.com/"
-    echo "Continuing without GitHub features..."
-else
-    echo "✅ GitHub CLI found"
-    
-    # Check auth status
-    if gh auth status &> /dev/null; then
-        echo "✅ GitHub authentication active"
-    else
-        echo "⚠️  Not authenticated with GitHub"
-        echo "Run: gh auth login"
-    fi
-fi
-
-echo ""
-echo "📦 GitHub swarm commands available:"
-echo "  - npx snow-flow github swarm"
-echo "  - npx snow-flow repo analyze"
-echo "  - npx snow-flow pr enhance"
-echo "  - npx snow-flow issue triage"

package/.claude/helpers/quick-start.sh

@@ -1,19 +0,0 @@
-#!/bin/bash
-# Quick start guide for Claude Flow
-
-echo "🚀 Snow-Flow Quick Start"
-echo "=========================="
-echo ""
-echo "1. Initialize a swarm:"
-echo "   npx snow-flow swarm init --topology hierarchical"
-echo ""
-echo "2. Spawn agents:"
-echo "   npx snow-flow agent spawn --type coder --name "API Developer""
-echo ""
-echo "3. Orchestrate tasks:"
-echo "   npx snow-flow task orchestrate --task "Build REST API""
-echo ""
-echo "4. Monitor progress:"
-echo "   npx snow-flow swarm monitor"
-echo ""
-echo "📚 For more examples, see .claude/commands/"

package/.claude/helpers/setup-mcp.sh

@@ -1,18 +0,0 @@
-#!/bin/bash
-# Setup MCP server for Snow-Flow
-
-echo "🚀 Setting up Snow-Flow MCP server..."
-
-# Check if claude command exists
-if ! command -v claude &> /dev/null; then
-    echo "❌ Error: Claude Code CLI not found"
-    echo "Please install Claude Code first"
-    exit 1
-fi
-
-# Add MCP server
-echo "📦 Adding Snow-Flow MCP server..."
-claude mcp add snow-flow npx snow-flow mcp start
-
-echo "✅ MCP server setup complete!"
-echo "🎯 You can now use mcp__snow-flow__ tools in Claude Code"