snow-flow 1.3.17 → 1.3.18

package/CLAUDE.md

@@ -38,21 +38,15 @@ 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
-// For flows: Use XML-first approach (automatic detection)
+// For flows: Use XML-first approach with full automation (NEW v1.3.17!)
 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
+  // ✅ SINGLE COMMAND: XML generation + automatic deployment
+  const deployment = await snow_create_flow({
+    instruction: "your natural language flow description",
+    deploy_immediately: true  // 🚀 Fully automated: Generate → Import → Preview → Commit
   });
   
-  // Option 2: Manual deployment command
-  console.log(`Deploy with: snow-flow deploy-xml "${xmlResult.filePath}"`);
+  // That's it! Flow is now live in ServiceNow Flow Designer
 } else {
   // For widgets, applications, scripts: Use standard MCP deployment
   const deployment = await snow_deploy({
@@ -226,52 +220,42 @@ When you run any flow-related swarm command, Snow-flow automatically:
    - `sys_hub_action_instance` - All flow activities (approval, notification, etc.)
    - `sys_hub_flow_logic` - Activity connections and flow paths
 
-4. **🚀 Provides Auto-Deploy Command**:
+4. **🚀 Fully Automated Deployment** (NEW v1.3.17!):
    ```bash
-   🚀 Auto-Deploy enabled - importing XML to ServiceNow...
-   💡 To deploy, use the following command:
-      snow-flow deploy-xml "flow-update-sets/your_flow.xml"
+   🚀 Auto-Deploy enabled - deploying directly to ServiceNow...
+   ✅ XML imported successfully (sys_id: abc123...)
+   ✅ Update set loaded: Flow_Import_2025
+   🔍 Preview completed with no problems
+   ✅ Update set committed successfully!
+   🎉 Flow is ready in Flow Designer!
    ```
 
-### 🚀 One-Command Deployment
+### 🚀 Zero-Manual-Steps Deployment
 
-```bash
-# Deploy any generated XML flow directly to ServiceNow
-snow-flow deploy-xml flow-update-sets/my_flow.xml
+**No commands needed!** Everything happens automatically in one swarm call:
 
-# 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
+**What happens automatically:**
+1. ✅ **Generate**: Creates production-ready Update Set XML
+2. ✅ **Import**: Uploads XML to ServiceNow as remote update set
+3. ✅ **Load**: Loads the update set into local update sets
+4. ✅ **Preview**: Checks for problems and conflicts  
+5. ✅ **Commit**: Auto-commits if preview is clean
+6. ✅ **Verify**: Confirms flow is available in Flow Designer
 
 ### 🎯 Complete Flow Development Workflow
 
-**End-to-End Flow Creation (Zero Manual Steps):**
+**End-to-End Flow Creation (Truly Zero Manual Steps):**
 
 ```bash
-# 1. Create flow with automatic XML generation
+# Single command creates AND deploys flow automatically!
 snow-flow swarm "create incident escalation flow with email notifications"
 
-# Output:
+# Complete Output:
 # 🔧 Flow Designer Detected - Using XML-First Approach!
+# 📋 Creating production-ready ServiceNow flow XML...
 # ✅ 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
+# 🚀 Auto-Deploy enabled - deploying directly to ServiceNow...
 # ✅ XML imported successfully (sys_id: abc123...)
 # ✅ Update set loaded: Incident_Escalation_Flow_Import
 # 🔍 Previewing update set...
@@ -279,37 +263,41 @@ snow-flow deploy-xml flow-update-sets/incident_escalation_flow.xml
 # 🚀 Committing update set...
 # ✅ Update Set committed successfully!
 # 📍 Navigate to Flow Designer > Designer to see your flow
-# 🎉 Deployment complete!
+# 🎉 Flow deployed and ready to use!
 ```
 
-### 🔧 Advanced XML Deployment Features
+**That's it! One command, zero manual steps.** 🚀
 
-**Error Handling & Safety**:
+### 🔧 Advanced Auto-Deployment Features
+
+**Built-in Safety & Intelligence**:
 - **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
+- **Safe Auto-Commit**: Only commits if preview is completely clean  
+- **Graceful Fallbacks**: Provides manual instructions if auto-deployment fails
 - **Authentication Validation**: Ensures valid ServiceNow connection before deployment
+- **Error Recovery**: Intelligent retry and fallback strategies
 
-**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
+**What Happens Behind the Scenes**:
+```javascript
+// When you run: snow-flow swarm "create approval flow"
+await snow_create_flow({
+  instruction: "create approval flow", 
+  deploy_immediately: true  // This triggers all safety checks:
+});
 
-# Check authentication first
-snow-flow auth status
+// 1. ✅ Authentication check
+// 2. ✅ XML generation with validation
+// 3. ✅ Import to ServiceNow as remote update set
+// 4. ✅ Preview for conflicts
+// 5. ✅ Auto-commit only if clean
+// 6. ✅ Error handling with manual fallback instructions
 ```
 
-**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
-```
+**Troubleshooting (if auto-deployment fails)**:
+- Error messages include specific troubleshooting steps
+- Authentication issues: `snow-flow auth status` 
+- Manual fallback: `snow-flow deploy-xml filename.xml`
+- Permission issues: Check admin roles in ServiceNow
 
 ## 🔒 MANDATORY ServiceNow Development Workflow
 
@@ -711,7 +699,7 @@ snow-flow swarm "create incident dashboard widget"
 # Swarm handles all MCP orchestration with multiple agents
 snow-flow swarm "create approval workflow for equipment requests"
 
-# What happens: snow_create_flow() → snow_test_flow_with_mock() → multi-agent validation → auto tracking
+# What happens: snow_create_flow({ deploy_immediately: true }) → live deployment → flow ready in ServiceNow
 ```
 
 ### 🎯 Smart Discovery Before Creation
@@ -783,9 +771,9 @@ snow-flow swarm "deploy mobile-responsive widget with accessibility features"
 ### 🚀 Complete Commands Reference
 
 ```bash
-# Flow Designer workflows (auto-XML generation + deployment)
+# Flow Designer workflows (fully automated generation + deployment)
 snow-flow swarm "create approval flow for equipment requests"
-snow-flow deploy-xml flow-update-sets/approval_flow.xml
+# ✅ Above command automatically deploys! No manual steps needed.
 
 # Widget development (standard MCP deployment)  
 snow-flow swarm "create incident dashboard widget"

package/README.md

@@ -17,21 +17,22 @@
 ### 🚀 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
+- **✅ FULLY AUTOMATED FLOW DEPLOYMENT**: Complete workflow from natural language to live ServiceNow flow in one command
+- **✅ ZERO MANUAL STEPS**: XML generation, import, preview, and commit all happen automatically
+- **✅ INTELLIGENT SAFETY**: Auto-preview with problem detection, only commits if clean
+- **✅ GRACEFUL FALLBACKS**: Provides manual instructions if auto-deployment fails
 
-### 🔄 Flow Designer XML Workflow
+### 🔄 Fully Automated Flow Workflow (NEW v1.3.17!)
 ```bash
-# 1. Create flow with swarm
+# Single command creates AND deploys flow automatically!
 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 output shows:
+# 🔧 Flow Designer Detected - Using XML-First Approach!
+# ✅ XML Generated & Auto-Deployed to ServiceNow!
+# 🎉 Flow ready in Flow Designer!
 
-# ✅ Complete automation: Import → Load → Preview → Commit (only if clean)
+# ✅ Zero manual steps: Generate → Import → Preview → Commit (only if clean)
 ```
 
 ### 🚀 Previous Release: v1.1.93 - Revolutionary Parallel Agent Spawning WORKING!
@@ -114,7 +115,7 @@ snow-flow deploy-xml flow-update-sets/flow_approval_workflow.xml
 - **Flow Design**: Creates Flow Designer workflows with intelligent structure
 - **Trigger Configuration**: Sets up optimal triggers (record events, scheduled, manual)
 - **Approval Processes**: Implements complex approval hierarchies with escalation
-- **Integration**: Uses `snow_create_flow` MCP tools with comprehensive testing
+- **Integration**: Uses `snow_xml_flow_from_instruction` with auto-deployment for maximum reliability
 
 ### 📝 Script Writer Agent
 - **Business Rules**: Creates optimized business logic with performance considerations
@@ -194,9 +195,9 @@ 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
+# 🚀 NEW: Fully automated Flow Designer deployment (v1.3.17!)
 snow-flow swarm "create approval workflow for equipment requests"
-snow-flow deploy-xml flow-update-sets/flow_approval_workflow.xml
+# ✅ Above command automatically deploys flow to ServiceNow! Zero manual steps.
 ```
 
 ### 🧠 What You'll See with Gap Analysis Engine
@@ -259,17 +260,20 @@ snow-flow memory stats
 snow-flow memory export <file>
 ```
 
-### 🚀 NEW: XML Update Set Deployment
+### 🚀 NEW: Fully Automated Flow Deployment (v1.3.17!)
 ```bash
-# Deploy XML update sets automatically (Import → Preview → Commit)
-snow-flow deploy-xml <xmlFile>
+# Single command creates AND deploys flows automatically!
+snow-flow swarm "create approval workflow for equipment requests"
 
-# 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
+# What happens automatically:
+# 1. ✅ Detects Flow Designer task
+# 2. ✅ Generates production-ready XML 
+# 3. ✅ Imports to ServiceNow as remote update set
+# 4. ✅ Previews for conflicts
+# 5. ✅ Auto-commits if clean
+# 6. ✅ Reports deployment status
 
-# Example: Deploy generated flow XML
-snow-flow deploy-xml flow-update-sets/flow_approval_workflow.xml
+# Manual deployment (fallback only): snow-flow deploy-xml filename.xml
 ```
 
 ### 🚀 Intelligent Features (Enabled by Default)
@@ -343,11 +347,10 @@ snow-flow swarm "Build approval flow for equipment requests with manager and fin
 # 1. Spawn Flow Builder + Security Agent
 # 2. Flow Builder designs multi-step approval process
 # 3. Security Agent validates permissions and compliance
-# 4. Automatic XML generation in flow-update-sets/ directory
-# 5. Display deploy-xml command for seamless deployment
+# 4. Automatic XML generation AND deployment to ServiceNow
+# 5. Flow ready in Flow Designer - zero manual steps!
 
-# 🚀 NEW: Complete XML deployment workflow
-snow-flow deploy-xml flow-update-sets/flow_equipment_approval.xml
+# 🚀 NEW: Fully automated - no separate deployment command needed!
 
 # ✅ Automatic process:
 # • Import XML to ServiceNow

package/dist/agents/index.js

@@ -37,7 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENT_CLASS_MAP = exports.SecurityAgent = exports.TestAgent = exports.ScriptWriterAgent = exports.FlowBuilderAgent = exports.WidgetCreatorAgent = exports.BaseAgent = void 0;
+exports.AGENT_CLASS_MAP = exports.SecurityAgent = exports.ScriptWriterAgent = exports.FlowBuilderAgent = exports.WidgetCreatorAgent = exports.BaseAgent = void 0;
 var base_agent_1 = require("./base-agent");
 Object.defineProperty(exports, "BaseAgent", { enumerable: true, get: function () { return base_agent_1.BaseAgent; } });
 var widget_creator_agent_1 = require("./widget-creator-agent");
@@ -46,8 +46,6 @@ var flow_builder_agent_1 = require("./flow-builder-agent");
 Object.defineProperty(exports, "FlowBuilderAgent", { enumerable: true, get: function () { return flow_builder_agent_1.FlowBuilderAgent; } });
 var script_writer_agent_1 = require("./script-writer-agent");
 Object.defineProperty(exports, "ScriptWriterAgent", { enumerable: true, get: function () { return script_writer_agent_1.ScriptWriterAgent; } });
-var test_agent_1 = require("./test-agent");
-Object.defineProperty(exports, "TestAgent", { enumerable: true, get: function () { return test_agent_1.TestAgent; } });
 var security_agent_1 = require("./security-agent");
 Object.defineProperty(exports, "SecurityAgent", { enumerable: true, get: function () { return security_agent_1.SecurityAgent; } });
 // Agent type mapping for factory
@@ -55,6 +53,5 @@ exports.AGENT_CLASS_MAP = {
     'widget-creator': () => Promise.resolve().then(() => __importStar(require('./widget-creator-agent'))).then(m => m.WidgetCreatorAgent),
     'flow-builder': () => Promise.resolve().then(() => __importStar(require('./flow-builder-agent'))).then(m => m.FlowBuilderAgent),
     'script-writer': () => Promise.resolve().then(() => __importStar(require('./script-writer-agent'))).then(m => m.ScriptWriterAgent),
-    'tester': () => Promise.resolve().then(() => __importStar(require('./test-agent'))).then(m => m.TestAgent),
     'security': () => Promise.resolve().then(() => __importStar(require('./security-agent'))).then(m => m.SecurityAgent)
 };

package/dist/agents/queen-agent.js

@@ -260,7 +260,9 @@ class QueenAgent extends eventemitter3_1.EventEmitter {
             status: 'active',
             objectiveId,
             specialization,
-            startTime: Date.now()
+            startTime: Date.now(),
+            capabilities: [],
+            mcpTools: []
         };
         this.activeAgents.set(agentId, agent);
         // Store agent info in memory for coordination

package/dist/cli.js

@@ -45,6 +45,7 @@ const dotenv_1 = __importDefault(require("dotenv"));
 const fs_1 = require("fs");
 const path_1 = require("path");
 const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
 const fs_2 = require("fs");
 const snow_oauth_js_1 = require("./utils/snow-oauth.js");
 const servicenow_client_js_1 = require("./utils/servicenow-client.js");
@@ -617,26 +618,39 @@ You are the Queen Agent, master coordinator of the Snow-Flow hive-mind. Your mis
 - **Estimated Total Agents**: ${taskAnalysis.estimatedAgentCount}
 - **ServiceNow Artifacts**: ${taskAnalysis.serviceNowArtifacts.join(', ')}
 
-${isFlowDesignerTask ? `## 🔧 Flow Designer Task Detected
-You need to create a ServiceNow Flow Designer flow. Follow these steps:
-
-1. **Analyze Requirements**: Parse the objective to understand all required activities
-2. **Design Flow Structure**: Plan the flow with triggers, activities, and logic
-3. **Generate XML**: Use the improved flow XML generator to create production-ready XML
-4. **Deploy to ServiceNow**: Use snow-flow deploy-xml or MCP tools to deploy
-
-**Important Flow Development Instructions**:
-- Use \`generateImprovedFlowXML\` from './utils/improved-flow-xml-generator.js'
-- This generator follows EXACT patterns extracted from real ServiceNow Flow Designer XML examples
-- CRITICAL: Use v2 tables (sys_hub_action_instance_v2), Base64+gzip encoding, complete label_cache
-- The generator creates production-ready XML that ServiceNow can actually import (not "too small to work")
-- Include appropriate activities based on the objective:
-  - Approval activities for approval workflows
-  - Notification activities for email/messaging
-  - Create record activities for task creation
-  - Script activities for custom logic
-- Save generated XML to flow-update-sets directory
-- Deploy using: \`snow-flow deploy-xml "path/to/flow.xml"\`
+${isFlowDesignerTask ? `## 🔧 Flow Designer Task Detected - Using XML-First Approach!
+🚀 **FULLY AUTOMATED FLOW DEPLOYMENT** - Zero manual steps required!
+
+**MANDATORY: Use this exact approach for Flow Designer tasks:**
+
+\`\`\`javascript
+// ✅ CORRECT: Fully automated XML generation + deployment
+await snow_create_flow({
+  instruction: "your natural language flow description", 
+  deploy_immediately: true  // 🔥 Automatically deploys to ServiceNow!
+});
+\`\`\`
+
+🎯 **What this does automatically:**
+- ✅ Parses natural language to complete flow structure
+- ✅ Generates production-ready Update Set XML (v2 format)
+- ✅ Imports XML to ServiceNow as remote update set
+- ✅ Previews for conflicts and validates structure
+- ✅ Commits update set if preview is clean
+- ✅ Reports deployment status and provides flow URL
+- ✅ Handles all errors gracefully with fallback instructions
+
+🚫 **FORBIDDEN APPROACHES:**
+- ❌ DO NOT use old API-only approach without XML generation
+- ❌ DO NOT use manual \`snow-flow deploy-xml\` commands 
+- ❌ DO NOT generate XML without auto-deployment
+
+💡 **Why XML-First?**
+- Works with complex flows that break API methods
+- Production-ready Flow Designer format with all required fields
+- Complete automation from instruction to live ServiceNow flow
+- Zero chance of "too small to work" or import failures
+
 ` : ''}
 - **Recommended Team**: ${getTeamRecommendation(taskAnalysis.taskType)}
 
@@ -1061,7 +1075,7 @@ Your agents MUST use these MCP tools IN THIS ORDER:
    - \`snow_get_by_sysid\` - Direct sys_id lookup
 
 3. **Flow Tools** (servicenow-flow-composer-mcp)
-   - \`snow_create_flow\` - Create flows from natural language
+   - \`snow_create_flow\` - Create flows using XML-first approach with auto-deployment (RECOMMENDED)
    - \`snow_test_flow_with_mock\` - Test flows with mock data
    - \`snow_link_catalog_to_flow\` - Link catalog items to flows
 
@@ -1316,11 +1330,14 @@ if (flows.error?.includes("OAuth")) {
     trigger: "When record created on [table]",
     steps: ["Step 1: Validate data", "Step 2: Process", "Step 3: Notify"],
     natural_language: "Complete flow instruction for snow_create_flow",
-    deployment_command: "snow_create_flow with instruction from Memory"
+    deployment_command: "snow_create_flow with deploy_immediately: true"
   });
 } else {
-  // Create flow directly
-  await snow_create_flow({ instruction: "natural language description" });
+  // Create flow directly using XML-first approach
+  await snow_create_flow({ 
+    instruction: "natural language description",
+    deploy_immediately: true 
+  });
 }
 \`\`\`
 
@@ -2890,7 +2907,7 @@ await snow_update_set_add_artifact({
                 steps: [
                     "snow_validate_live_connection",
                     "snow_discover_existing_flows",
-                    "snow_create_flow",
+                    "snow_create_flow (with deploy_immediately: true)",
                     "snow_test_flow_with_mock",
                     "snow_link_catalog_to_flow (if needed)",
                     "snow_comprehensive_flow_test (if authenticated)"
@@ -2903,7 +2920,7 @@ await snow_update_set_add_artifact({
                     "snow_analyze_requirements",
                     "snow_update_set_create",
                     "snow_deploy (multiple artifacts)",
-                    "snow_create_flow (for workflows)",
+                    "snow_create_flow (for flows)",
                     "snow_deploy (for widgets)",
                     "snow_update_set_complete"
                 ]
@@ -3196,8 +3213,7 @@ snow_get_by_sysid({
 // Create flows from natural language
 snow_create_flow({
   instruction: "create a flow that sends email when incident priority is high",
-  deploy_immediately: true,
-  enable_intelligent_analysis: true
+  deploy_immediately: true  // Automatically deploys XML to ServiceNow
 });
 
 // Test flows with mock data
@@ -3571,12 +3587,16 @@ SNOW_FLOW_TIMEOUT_MINUTES=0
     // Check if .env already exists
     try {
         await fs_1.promises.access(envFilePath);
-        console.log('⚠️  .env file already exists, creating .env.example instead...');
+        console.log('⚠️  .env file already exists, creating .env.example template instead');
+        console.log('📝 To recreate .env: delete existing .env file and run init again');
         await fs_1.promises.writeFile((0, path_1.join)(targetDir, '.env.example'), envContent);
+        console.log('✅ .env.example template created');
     }
     catch {
         // .env doesn't exist, create it
+        console.log('📄 Creating new .env file...');
         await fs_1.promises.writeFile(envFilePath, envContent);
+        console.log('✅ .env file created successfully');
     }
 }
 async function appendToEnvFile(targetDir, content) {
@@ -5149,7 +5169,7 @@ program
     console.log(`\n👑 ServiceNow Queen Agent v${version_js_1.VERSION} - Hive-Mind Intelligence`);
     console.log('🐝 Elegant orchestration replacing complex team coordination\n');
     try {
-        const { QueenIntegration } = await Promise.resolve().then(() => __importStar(require('../examples/queen/integration-example.js')));
+        const { QueenIntegration } = await Promise.resolve().then(() => __importStar(require('./examples/queen/integration-example.js')));
         const queenIntegration = new QueenIntegration({
             debugMode: options.debug || false
         });

package/dist/mcp/servicenow-deployment-mcp-refactored.js

@@ -355,6 +355,9 @@ class ServiceNowDeploymentMCP extends base_mcp_server_js_1.BaseMCPServer {
             case 'business_rule':
                 result = await this.deployScript(type, config, context, finalUpdateSetId);
                 break;
+            case 'xml_update_set':
+                result = await this.deployXMLUpdateSet(config, context);
+                break;
             default:
                 throw new Error(`Unsupported deployment type: ${type}`);
         }

package/dist/mcp/servicenow-deployment-mcp.js

@@ -5231,10 +5231,145 @@ Use individual deployment tools like \`snow_deploy_${args.type}\` with manual co
                 return await this.deployFlow(scopedConfig);
             case 'application':
                 return await this.deployApplication(scopedConfig);
+            case 'xml_update_set':
+                return await this.deployXMLUpdateSet(scopedConfig);
             default:
                 throw new Error(`Unsupported artifact type for unified deployment: ${type}`);
         }
     }
+    /**
+     * Deploy XML Update Set to ServiceNow
+     */
+    async deployXMLUpdateSet(config) {
+        const { xml_file_path, auto_preview = true, auto_commit = true } = config;
+        if (!xml_file_path) {
+            throw new Error('XML file path is required for xml_update_set deployment');
+        }
+        this.logger.info('🚀 Deploying XML Update Set', {
+            file: xml_file_path,
+            auto_preview,
+            auto_commit
+        });
+        try {
+            // Read XML file
+            const fs = require('fs').promises;
+            const xmlContent = await fs.readFile(xml_file_path, 'utf-8');
+            // Import XML as remote update set
+            const importResponse = await this.client.makeRequest({
+                method: 'POST',
+                url: '/api/now/table/sys_remote_update_set',
+                headers: {
+                    'Content-Type': 'application/xml',
+                    'Accept': 'application/json'
+                },
+                data: xmlContent
+            });
+            if (!importResponse.result || !importResponse.result.sys_id) {
+                throw new Error('Failed to import XML update set');
+            }
+            const remoteUpdateSetId = importResponse.result.sys_id;
+            this.logger.info('✅ XML imported successfully', { sys_id: remoteUpdateSetId });
+            // Load the update set
+            await this.client.makeRequest({
+                method: 'PUT',
+                url: `/api/now/table/sys_remote_update_set/${remoteUpdateSetId}`,
+                data: {
+                    state: 'loaded'
+                }
+            });
+            // Find the loaded update set
+            const loadedResponse = await this.client.makeRequest({
+                method: 'GET',
+                url: '/api/now/table/sys_update_set',
+                params: {
+                    sysparm_query: `remote_sys_id=${remoteUpdateSetId}`,
+                    sysparm_limit: 1
+                }
+            });
+            if (!loadedResponse.result || loadedResponse.result.length === 0) {
+                throw new Error('Failed to find loaded update set');
+            }
+            const updateSetId = loadedResponse.result[0].sys_id;
+            const updateSetName = loadedResponse.result[0].name;
+            // Preview if requested
+            if (auto_preview) {
+                const previewResponse = await this.client.makeRequest({
+                    method: 'POST',
+                    url: `/api/now/table/sys_update_set/${updateSetId}/preview`
+                });
+                // Check preview results
+                const previewProblems = await this.client.makeRequest({
+                    method: 'GET',
+                    url: '/api/now/table/sys_update_preview_problem',
+                    params: {
+                        sysparm_query: `update_set=${updateSetId}`,
+                        sysparm_limit: 100
+                    }
+                });
+                if (previewProblems.result && previewProblems.result.length > 0) {
+                    const problems = previewProblems.result.map((p) => `- ${p.type}: ${p.description}`).join('\n');
+                    if (auto_commit) {
+                        this.logger.warn('Preview found problems, skipping auto-commit', { problems });
+                    }
+                    return {
+                        success: true,
+                        message: 'XML imported and previewed with problems',
+                        update_set_id: updateSetId,
+                        update_set_name: updateSetName,
+                        preview_status: 'problems_found',
+                        problems: previewProblems.result,
+                        next_steps: [
+                            '1. Review preview problems in ServiceNow',
+                            '2. Resolve any issues',
+                            '3. Commit manually when ready'
+                        ]
+                    };
+                }
+                // Commit if clean and requested
+                if (auto_commit) {
+                    await this.client.makeRequest({
+                        method: 'POST',
+                        url: `/api/now/table/sys_update_set/${updateSetId}/commit`
+                    });
+                    return {
+                        success: true,
+                        message: '✅ XML Update Set imported, previewed, and committed successfully!',
+                        update_set_id: updateSetId,
+                        update_set_name: updateSetName,
+                        status: 'committed',
+                        flow_location: 'Flow Designer > Designer',
+                        next_steps: [
+                            '1. Navigate to Flow Designer',
+                            '2. Your flow should be visible in the list',
+                            '3. Open the flow to verify all components'
+                        ]
+                    };
+                }
+            }
+            // Return success without preview/commit
+            return {
+                success: true,
+                message: 'XML Update Set imported successfully',
+                update_set_id: updateSetId,
+                update_set_name: updateSetName,
+                status: 'imported',
+                next_steps: [
+                    '1. Navigate to System Update Sets > Local Update Sets',
+                    '2. Find your update set: ' + updateSetName,
+                    '3. Click Preview Update Set',
+                    '4. Review and commit when ready'
+                ]
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            this.logger.error('XML deployment failed', { error: errorMsg, file: xml_file_path });
+            if (errorMsg.includes('ENOENT') || errorMsg.includes('no such file')) {
+                throw new Error(`XML file not found: ${xml_file_path}`);
+            }
+            throw new Error(`XML deployment failed: ${errorMsg}`);
+        }
+    }
     /**
      * Check if error is permission-related
      */