snow-flow 1.4.6 → 1.4.7

package/action-v2-implementation.js

@@ -1,338 +0,0 @@
-/**
- * ServiceNow Flow Action v2 Implementation
- * 
- * This module demonstrates the correct way to encode action values
- * and generate proper flow XML for ServiceNow Flow Designer.
- */
-
-const pako = require('pako');
-const crypto = require('crypto');
-
-/**
- * Encodes action parameters for sys_hub_action_instance_v2
- * 
- * @param {Array} parameters - Array of parameter objects
- * @param {string} parameters[].name - Parameter name
- * @param {string} parameters[].value - Parameter value
- * @param {string} parameters[].valueType - Type: 'static', 'fd_data', 'expression'
- * @returns {string} Base64-encoded gzipped parameter array
- */
-function encodeActionValue(parameters) {
-    // Ensure parameters is an array
-    if (!Array.isArray(parameters)) {
-        throw new Error('Parameters must be an array');
-    }
-    
-    // Normalize parameter structure
-    const normalizedParams = parameters.map(param => ({
-        name: param.name,
-        value: param.value,
-        valueType: param.valueType || 'static'
-    }));
-    
-    // Convert to JSON string
-    const jsonString = JSON.stringify(normalizedParams);
-    
-    // Gzip compress
-    const compressed = pako.gzip(jsonString);
-    
-    // Base64 encode
-    const base64 = Buffer.from(compressed).toString('base64');
-    
-    return base64;
-}
-
-/**
- * Decodes action value for debugging/verification
- * 
- * @param {string} encodedValue - Base64-encoded gzipped value
- * @returns {Array} Decoded parameter array
- */
-function decodeActionValue(encodedValue) {
-    // Base64 decode
-    const compressed = Buffer.from(encodedValue, 'base64');
-    
-    // Gunzip
-    const jsonString = pako.ungzip(compressed, { to: 'string' });
-    
-    // Parse JSON
-    return JSON.parse(jsonString);
-}
-
-/**
- * Generates a unique UI ID for flow components
- * 
- * @returns {number} Unique UI ID
- */
-let uiIdCounter = 1;
-function generateUniqueUiId() {
-    return uiIdCounter++;
-}
-
-/**
- * Creates a sys_hub_action_instance_v2 record
- * 
- * @param {Object} config - Action configuration
- * @param {string} config.flowSysId - Parent flow sys_id
- * @param {string} config.actionType - Action type ID
- * @param {string} config.actionName - Display name
- * @param {Array} config.parameters - Action parameters
- * @param {number} config.x - X position in designer
- * @param {number} config.y - Y position in designer
- * @returns {Object} Action instance record
- */
-function createActionInstance(config) {
-    const actionSysId = crypto.randomUUID().replace(/-/g, '');
-    const uiId = generateUniqueUiId();
-    
-    return {
-        sys_id: actionSysId,
-        table: 'sys_hub_action_instance_v2',
-        parent: config.flowSysId,
-        ui_id: uiId,
-        group_ui_id: uiId,
-        type: config.actionType,
-        name: config.actionName,
-        value: encodeActionValue(config.parameters),
-        x: config.x || 100,
-        y: config.y || 100,
-        active: 'true',
-        base_table: 'sys_hub_action_instance_v2'
-    };
-}
-
-/**
- * Creates a sys_hub_flow_logic_instance_v2 record
- * 
- * @param {Object} config - Flow logic configuration
- * @param {string} config.flowSysId - Parent flow sys_id
- * @param {number} config.fromUiId - Source action UI ID
- * @param {number} config.toUiId - Target action UI ID
- * @param {string} config.condition - Optional condition
- * @returns {Object} Flow logic record
- */
-function createFlowLogic(config) {
-    const logicSysId = crypto.randomUUID().replace(/-/g, '');
-    const uiId = generateUniqueUiId();
-    
-    return {
-        sys_id: logicSysId,
-        table: 'sys_hub_flow_logic_instance_v2',
-        parent: config.flowSysId,
-        parent_ui_id: config.fromUiId,
-        ui_id: uiId,
-        group_ui_id: config.toUiId,
-        type: config.toUiId.toString(),
-        condition: config.condition || '',
-        active: 'true',
-        ended: 'false',
-        base_table: 'sys_hub_flow_logic_instance_v2'
-    };
-}
-
-/**
- * Example: Create Record action with proper encoding
- */
-function exampleCreateRecordAction(flowSysId) {
-    return createActionInstance({
-        flowSysId: flowSysId,
-        actionType: '65', // Create Record action type
-        actionName: 'Create Equipment Request',
-        x: 200,
-        y: 150,
-        parameters: [
-            {
-                name: 'table',
-                value: 'sc_request',
-                valueType: 'static'
-            },
-            {
-                name: 'field_values',
-                value: JSON.stringify({
-                    short_description: '{{fd_data.trigger.current.short_description}}',
-                    requested_for: '{{fd_data.trigger.current.opened_by}}',
-                    priority: '3'
-                }),
-                valueType: 'fd_data'
-            }
-        ]
-    });
-}
-
-/**
- * Example: Complete flow with trigger, actions, and logic
- */
-function generateCompleteFlow() {
-    const flowSysId = crypto.randomUUID().replace(/-/g, '');
-    
-    // Reset UI ID counter for new flow
-    uiIdCounter = 1;
-    
-    // Main flow record
-    const flow = {
-        sys_id: flowSysId,
-        table: 'sys_hub_flow',
-        name: 'Equipment Request Approval',
-        description: 'Automated approval workflow for equipment requests',
-        active: 'true',
-        type: 'flow',
-        category: 'Request Management'
-    };
-    
-    // Trigger (Record Created)
-    const triggerUiId = generateUniqueUiId();
-    const trigger = {
-        sys_id: crypto.randomUUID().replace(/-/g, ''),
-        table: 'sys_hub_trigger_instance_v2',
-        parent: flowSysId,
-        ui_id: triggerUiId,
-        type: '14', // Record Created/Updated
-        name: 'Equipment Request Created',
-        configuration: encodeActionValue([
-            {
-                name: 'table',
-                value: 'sc_req_item',
-                valueType: 'static'
-            },
-            {
-                name: 'condition',
-                value: 'category=hardware^active=true',
-                valueType: 'static'
-            }
-        ])
-    };
-    
-    // Action 1: Create Request
-    const createAction = createActionInstance({
-        flowSysId: flowSysId,
-        actionType: '65',
-        actionName: 'Create Approval Request',
-        x: 300,
-        y: 150,
-        parameters: [
-            {
-                name: 'table',
-                value: 'sc_request',
-                valueType: 'static'
-            },
-            {
-                name: 'requested_for',
-                value: '{{fd_data.trigger.current.requested_for}}',
-                valueType: 'fd_data'
-            }
-        ]
-    });
-    
-    // Action 2: Send Notification
-    const notifyAction = createActionInstance({
-        flowSysId: flowSysId,
-        actionType: '89', // Send Email
-        actionName: 'Notify Approver',
-        x: 500,
-        y: 150,
-        parameters: [
-            {
-                name: 'to',
-                value: '{{fd_data.trigger.current.requested_for.manager}}',
-                valueType: 'fd_data'
-            },
-            {
-                name: 'subject',
-                value: 'Equipment Request Approval Needed',
-                valueType: 'static'
-            },
-            {
-                name: 'body',
-                value: 'Please review the equipment request from {{fd_data.trigger.current.requested_for.name}}',
-                valueType: 'fd_data'
-            }
-        ]
-    });
-    
-    // Flow Logic: Trigger → Create Action
-    const logic1 = createFlowLogic({
-        flowSysId: flowSysId,
-        fromUiId: triggerUiId,
-        toUiId: createAction.ui_id
-    });
-    
-    // Flow Logic: Create Action → Notify Action
-    const logic2 = createFlowLogic({
-        flowSysId: flowSysId,
-        fromUiId: createAction.ui_id,
-        toUiId: notifyAction.ui_id
-    });
-    
-    return {
-        flow,
-        trigger,
-        actions: [createAction, notifyAction],
-        logic: [logic1, logic2]
-    };
-}
-
-/**
- * Generates complete XML for import
- */
-function generateFlowXML() {
-    const flowData = generateCompleteFlow();
-    const xml2js = require('xml2js');
-    const builder = new xml2js.Builder();
-    
-    const xmlData = {
-        unload: {
-            $: {
-                unload_date: new Date().toISOString()
-            },
-            sys_hub_flow: flowData.flow,
-            sys_hub_trigger_instance_v2: flowData.trigger,
-            sys_hub_action_instance_v2: flowData.actions,
-            sys_hub_flow_logic_instance_v2: flowData.logic
-        }
-    };
-    
-    return builder.buildObject(xmlData);
-}
-
-// Export functions for use in other modules
-module.exports = {
-    encodeActionValue,
-    decodeActionValue,
-    createActionInstance,
-    createFlowLogic,
-    generateCompleteFlow,
-    generateFlowXML
-};
-
-// Example usage
-if (require.main === module) {
-    console.log('ServiceNow Flow Action v2 Implementation Example\n');
-    
-    // Example 1: Encode parameters
-    const params = [
-        { name: 'table', value: 'incident', valueType: 'static' },
-        { name: 'priority', value: '{{fd_data.trigger.current.urgency}}', valueType: 'fd_data' }
-    ];
-    
-    const encoded = encodeActionValue(params);
-    console.log('Encoded parameters:', encoded);
-    
-    // Example 2: Decode to verify
-    const decoded = decodeActionValue(encoded);
-    console.log('\nDecoded parameters:', JSON.stringify(decoded, null, 2));
-    
-    // Example 3: Generate complete flow
-    const flow = generateCompleteFlow();
-    console.log('\nGenerated flow structure:');
-    console.log('- Flow:', flow.flow.name);
-    console.log('- Trigger:', flow.trigger.name);
-    console.log('- Actions:', flow.actions.map(a => a.name).join(', '));
-    console.log('- Logic connections:', flow.logic.length);
-    
-    // Example 4: Generate XML
-    console.log('\nGenerating XML...');
-    const xml = generateFlowXML();
-    console.log('XML length:', xml.length, 'characters');
-    console.log('\nFirst 500 characters:');
-    console.log(xml.substring(0, 500) + '...');
-}

package/create-snow-flow-env.sh

@@ -1,32 +0,0 @@
-#!/bin/bash
-
-# Create .env file for global Snow-Flow installation
-
-SNOW_FLOW_PATH="/Users/nielsvanderwerf/.nvm/versions/node/v20.15.0/lib/node_modules/snow-flow"
-ENV_FILE="$SNOW_FLOW_PATH/.env"
-
-echo "Creating .env file for Snow-Flow..."
-
-cat > "$ENV_FILE" << 'EOF'
-# ServiceNow OAuth Configuration
-SNOW_INSTANCE=dev198027.service-now.com
-SNOW_CLIENT_ID=0664245521cf423ba1989e4c875b18de
-SNOW_CLIENT_SECRET=Welkom123
-
-# OAuth URLs (these are automatically generated)
-OAUTH_TOKEN_URL=https://dev198027.service-now.com/oauth_token.do
-OAUTH_REDIRECT_URI=http://localhost:3000/callback
-
-# Neo4j Configuration (optional - for Graph Memory MCP)
-NEO4J_URI=bolt://localhost:7687
-NEO4J_USER=neo4j
-NEO4J_PASSWORD=password
-
-# Environment
-NODE_ENV=production
-EOF
-
-echo "✅ Created .env file at: $ENV_FILE"
-echo ""
-echo "🔄 Now restart Claude Desktop to activate the MCP servers"
-echo "💡 Use /mcp in Claude to see all 11 Snow-Flow servers"

package/decode-action-values.js

@@ -1,164 +0,0 @@
-/**
- * Utility to decode ServiceNow Flow Designer action values
- * 
- * Use this to inspect and understand the structure of action values
- * from existing ServiceNow flows.
- */
-
-const pako = require('pako');
-
-/**
- * Decodes a Base64+gzip encoded action value from ServiceNow
- * 
- * @param {string} encodedValue - The value field from sys_hub_action_instance_v2
- * @returns {Object} Decoded value
- */
-function decodeServiceNowValue(encodedValue) {
-    try {
-        // Remove any whitespace
-        const cleanValue = encodedValue.trim();
-        
-        // Base64 decode
-        const compressed = Buffer.from(cleanValue, 'base64');
-        
-        // Decompress with pako
-        const decompressed = pako.ungzip(compressed, { to: 'string' });
-        
-        // Parse JSON
-        const parsed = JSON.parse(decompressed);
-        
-        return {
-            success: true,
-            data: parsed,
-            format: Array.isArray(parsed) ? 'parameter_array' : 'object'
-        };
-    } catch (error) {
-        return {
-            success: false,
-            error: error.message,
-            hint: 'Make sure the value is Base64-encoded gzipped JSON'
-        };
-    }
-}
-
-/**
- * Analyzes an action value and provides insights
- * 
- * @param {string} encodedValue - The encoded value to analyze
- * @returns {Object} Analysis results
- */
-function analyzeActionValue(encodedValue) {
-    const decoded = decodeServiceNowValue(encodedValue);
-    
-    if (!decoded.success) {
-        return decoded;
-    }
-    
-    const analysis = {
-        ...decoded,
-        analysis: {
-            parameterCount: 0,
-            parameters: [],
-            hasFlowData: false,
-            hasStaticValues: false,
-            hasExpressions: false
-        }
-    };
-    
-    if (Array.isArray(decoded.data)) {
-        analysis.analysis.parameterCount = decoded.data.length;
-        
-        decoded.data.forEach(param => {
-            const paramInfo = {
-                name: param.name,
-                valueType: param.valueType || 'unknown',
-                valueLength: param.value ? param.value.length : 0,
-                isFlowData: param.valueType === 'fd_data',
-                isStatic: param.valueType === 'static',
-                isExpression: param.valueType === 'expression'
-            };
-            
-            if (paramInfo.isFlowData) analysis.analysis.hasFlowData = true;
-            if (paramInfo.isStatic) analysis.analysis.hasStaticValues = true;
-            if (paramInfo.isExpression) analysis.analysis.hasExpressions = true;
-            
-            analysis.analysis.parameters.push(paramInfo);
-        });
-    }
-    
-    return analysis;
-}
-
-/**
- * Example values from real ServiceNow flows
- */
-const exampleValues = {
-    // Example 1: Simple static parameter
-    staticParam: 'H4sIAAAAAAAAA1WOMQ6CMBhGX6W8uRgIFMRNjYmDi5ODiUP5+YtNS39ooTFx8O6WuLm95L3ve/kG0oMCTgKO5RwQBMIBIggBQhQjJAjlAQRfQHQQhCQMQxLEMYkCEgdhGAQJl7JeqQE6RqtOWFrPQJWGOvDBKNlxiJKGR0xCGEVxghFCCCOEQoQQJIzDkJAgRAj+AtKDFsxGaFpZKNdqhKaBRlXQWeFI3RppqJKmElKhGaR0JaQOzaBk4tCjFXRcvAr5xAAAAA==',
-    
-    // Example 2: Flow data reference
-    flowDataParam: 'H4sIAAAAAAAAA1WPwQrCMAyGX0VyniDTOe1NQUQ8ePFQvJR2cYu0TWk6QcZ8d+smePA/fPn+P/kDIQxFLmXFCwwRipAdI8xOEGYow4yd0vQ4Q8y2sGMYI3ZaZCeMnTJM2BYzhmL7vhCVFLWwTmhqaV0L6ZwYqJay9kJb14PWrkZP4JWQpe9JXauBrJRoIZQlqrxQVZCFJzaFqJTQhXjJ2gsvbN9Kaz7yB8Mw5LUU3KaaxsT3/SiOk9hH6AOEft+PgiCKwzBJoogQjD5A6PeDMIqDIIn9JIxIFL2B8AaYOo5v4AEAAA==',
-    
-    // Example 3: Complex multi-parameter
-    complexParam: 'H4sIAAAAAAAAA5VRQW7CMAz9L5JzQUkppVyhaWLaYRcOaJfKJE5rldhJ7RREVU/AjhtwBG7AETgCJ+DIddOyMW0S2qStyg5J/vvPz3/2fwEKUIAc5CgPUGECShBQLCSgBGUowaQI5YSIEhQmJSgLkINJAQqFbNnqdE3Nsu56S6FMrW67lqLblqE0jKZuW9QwrUqlRutOw9KNStNqGp1qh6JKl1ptRasoiqpT19VNv6s/aEbPJg4hNz3T0HpQhPH0u6YGLVW3lYqiPqiuX9e6+iMc1FQNu9tSa1SPsX9QfPxBKb3NQhzH3H0QzjfxvDgOSRjFcxKROIn8IApwzBHlHFFO8TwOEY5CHEc4DkkcxTgi8TykYRiFIY4jGoV0HoYUxyGNQhrHYUjDiMYhjX6Bt6PBaDgaDAbgfQCGYHh7O7wZguHgZjS4vh5ej66GI/DxBT4+vz6f/wEAAA=='
-};
-
-// Main execution
-if (require.main === module) {
-    console.log('ServiceNow Action Value Decoder\n');
-    console.log('=' .repeat(50));
-    
-    // Analyze each example
-    Object.entries(exampleValues).forEach(([name, value]) => {
-        console.log(`\n${name}:`);
-        console.log('-'.repeat(30));
-        
-        const analysis = analyzeActionValue(value);
-        
-        if (analysis.success) {
-            console.log('✓ Successfully decoded');
-            console.log(`Format: ${analysis.format}`);
-            console.log(`Parameter count: ${analysis.analysis.parameterCount}`);
-            
-            if (analysis.analysis.parameters.length > 0) {
-                console.log('\nParameters:');
-                analysis.analysis.parameters.forEach((param, i) => {
-                    console.log(`  ${i + 1}. ${param.name} (${param.valueType})`);
-                });
-            }
-            
-            console.log('\nValue types present:');
-            console.log(`  - Static values: ${analysis.analysis.hasStaticValues ? '✓' : '✗'}`);
-            console.log(`  - Flow data refs: ${analysis.analysis.hasFlowData ? '✓' : '✗'}`);
-            console.log(`  - Expressions: ${analysis.analysis.hasExpressions ? '✓' : '✗'}`);
-            
-            console.log('\nRaw decoded data:');
-            console.log(JSON.stringify(analysis.data, null, 2));
-        } else {
-            console.log(`✗ Failed to decode: ${analysis.error}`);
-            console.log(`Hint: ${analysis.hint}`);
-        }
-    });
-    
-    // Interactive mode
-    if (process.argv[2]) {
-        console.log('\n\nDecoding provided value...\n');
-        const inputValue = process.argv[2];
-        const result = analyzeActionValue(inputValue);
-        
-        if (result.success) {
-            console.log('Decoded successfully!');
-            console.log(JSON.stringify(result.data, null, 2));
-        } else {
-            console.log('Decoding failed:', result.error);
-        }
-    } else {
-        console.log('\n\nUsage: node decode-action-values.js [encoded_value]');
-        console.log('Example: node decode-action-values.js "H4sIAAAAAAAAA..."');
-    }
-}
-
-module.exports = {
-    decodeServiceNowValue,
-    analyzeActionValue
-};

package/npm-publish-summary.txt

@@ -1,35 +0,0 @@
-🚀 Snow-Flow v1.3.24 - Ready for NPM Publish!
-
-✅ GITHUB STATUS:
-- All changes committed and pushed to main branch
-- Git tag v1.3.24 created and pushed
-- Repository: https://github.com/groeimetai/snow-flow
-
-✅ FIXES COMPLETED:
-- SNOW-001: Silent Deployment Failures → FIXED with mandatory verification
-- SNOW-002: Search System Failures → FIXED with retry logic
-- SNOW-003: High Failure Rate (19%) → FIXED with enhanced resilience
-- SNOW-004: Security Compliance Module → FIXED variable shadowing
-
-✅ NPM PACKAGE READY:
-- Version: 1.3.24  
-- Package size: 1.6 MB
-- Unpacked size: 9.0 MB
-- Files: 740 total
-
-📦 TO PUBLISH TO NPM:
-1. Make sure you're logged in to npm:
-   npm whoami
-   
-2. If not logged in:
-   npm login
-   
-3. Publish the package:
-   npm publish
-   
-4. Verify publication:
-   npm view snow-flow version
-
-🎉 Snow-Flow is now production-ready with all critical beta test issues resolved!
-
-Release notes available at: RELEASE_NOTES_1.3.24.md