snow-flow 3.6.6 → 3.6.12

package/.mcp.json.template

@@ -139,7 +139,7 @@
       "args": [
         "{{PROJECT_ROOT}}/dist/mcp/servicenow-knowledge-catalog-mcp.js"
       ],
-      "description": "Knowledge and catalog management - create/search/update knowledge articles, knowledge bases, catalog items, catalog variables, UI policies, client scripts, order items, discover catalogs",
+      "description": "Knowledge and catalog management - CORRECTED v3.6.10 with proper catalog UI policy creation (2-table system: policy with embedded conditions string, separate actions table). Create/search/update knowledge articles, catalog items, variables, UI policies with conditions as query string and actions array",
       "env": {
         "SNOW_INSTANCE": "{{SNOW_INSTANCE}}",
         "SNOW_CLIENT_ID": "{{SNOW_CLIENT_ID}}",

package/dist/mcp/servicenow-knowledge-catalog-mcp.js

@@ -170,19 +170,50 @@ class ServiceNowKnowledgeCatalogMCP {
                 },
                 {
                     name: 'snow_create_catalog_ui_policy',
-                    description: 'Creates UI policies for catalog items to control form behavior based on user input.',
+                    description: 'Creates comprehensive UI policies for catalog items with conditions and actions to control form behavior dynamically.',
                     inputSchema: {
                         type: 'object',
                         properties: {
                             cat_item: { type: 'string', description: 'Catalog item sys_id' },
                             short_description: { type: 'string', description: 'Policy name' },
-                            condition: { type: 'string', description: 'Condition script' },
+                            condition: { type: 'string', description: 'Legacy condition script (optional if conditions array provided)' },
                             applies_to: { type: 'string', description: 'Applies to: item, set, or variable' },
                             active: { type: 'boolean', description: 'Active status', default: true },
                             on_load: { type: 'boolean', description: 'Run on form load', default: true },
-                            reverse_if_false: { type: 'boolean', description: 'Reverse actions if false', default: true }
+                            reverse_if_false: { type: 'boolean', description: 'Reverse actions if false', default: true },
+                            conditions: {
+                                type: 'array',
+                                description: 'Array of condition objects for dynamic policy evaluation',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        type: { type: 'string', description: 'Condition type (catalog_variable, javascript)', default: 'catalog_variable' },
+                                        catalog_variable: { type: 'string', description: 'Target catalog variable sys_id or name' },
+                                        operation: { type: 'string', description: 'Comparison operation: is, is_not, is_empty, is_not_empty, contains, does_not_contain', default: 'is' },
+                                        value: { type: 'string', description: 'Comparison value' },
+                                        and_or: { type: 'string', description: 'Logical operator with next condition: AND, OR', default: 'AND' }
+                                    },
+                                    required: ['catalog_variable', 'operation']
+                                }
+                            },
+                            actions: {
+                                type: 'array',
+                                description: 'Array of action objects to execute when conditions are met',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        type: { type: 'string', description: 'Action type: set_mandatory, set_visible, set_readonly, set_value', default: 'set_visible' },
+                                        catalog_variable: { type: 'string', description: 'Target catalog variable sys_id or name' },
+                                        mandatory: { type: 'boolean', description: 'Set field as mandatory (for set_mandatory type)' },
+                                        visible: { type: 'boolean', description: 'Set field visibility (for set_visible type)' },
+                                        readonly: { type: 'boolean', description: 'Set field as readonly (for set_readonly type)' },
+                                        value: { type: 'string', description: 'Value to set (for set_value type)' }
+                                    },
+                                    required: ['type', 'catalog_variable']
+                                }
+                            }
                         },
-                        required: ['cat_item', 'short_description', 'condition']
+                        required: ['cat_item', 'short_description']
                     }
                 },
                 {
@@ -734,38 +765,173 @@ ${args.help_text ? `❓ Help: ${args.help_text}` : ''}
         }
     }
     /**
-     * Create Catalog UI Policy
-     * Uses catalog_ui_policy table
+     * Create Catalog UI Policy with Actions
+     * Creates records in 2 tables: catalog_ui_policy and catalog_ui_policy_action
+     *
+     * BELANGRIJKE WIJZIGINGEN:
+     * - Conditions worden NIET in een aparte tabel opgeslagen
+     * - Conditions worden als string/script in catalog_conditions veld gezet
+     * - catalog_ui_policy_condition tabel bestaat niet in ServiceNow
      */
     async createCatalogUIPolicy(args) {
         try {
-            this.logger.info('Creating catalog UI policy...');
+            this.logger.info('Creating comprehensive catalog UI policy...');
+            // Helper function to resolve variable names to sys_ids
+            const resolveVariableId = async (variableName, catalogItem) => {
+                // If already a sys_id, return as-is
+                if (variableName && variableName.match(/^[a-f0-9]{32}$/)) {
+                    return variableName;
+                }
+                // Search for variable by name in this catalog item
+                const varResponse = await this.client.searchRecords('item_option_new', `cat_item=${catalogItem}^name=${variableName}`, 1);
+                if (varResponse.success && varResponse.data.result.length > 0) {
+                    return varResponse.data.result[0].sys_id;
+                }
+                this.logger.warn(`Variable '${variableName}' not found for catalog item ${catalogItem}`);
+                return variableName; // Return original if not found
+            };
+            // Build condition string from conditions array
+            let conditionString = '';
+            if (args.conditions && Array.isArray(args.conditions)) {
+                const conditionParts = [];
+                for (const condition of args.conditions) {
+                    // Resolve variable name to sys_id
+                    const variableId = await resolveVariableId(condition.catalog_variable, args.cat_item);
+                    // Build condition string in ServiceNow format
+                    // Format: variable_name=value^ORvariable_name2=value2
+                    const operator = condition.operation || '=';
+                    const connector = condition.and_or === 'OR' ? '^OR' : '^';
+                    // Map common operations to ServiceNow syntax
+                    let operatorSymbol = '=';
+                    switch (operator.toLowerCase()) {
+                        case 'is':
+                        case 'equals':
+                            operatorSymbol = '=';
+                            break;
+                        case 'is not':
+                        case 'not equals':
+                            operatorSymbol = '!=';
+                            break;
+                        case 'contains':
+                            operatorSymbol = 'CONTAINS';
+                            break;
+                        case 'greater than':
+                            operatorSymbol = '>';
+                            break;
+                        case 'less than':
+                            operatorSymbol = '<';
+                            break;
+                        case 'is empty':
+                            operatorSymbol = 'ISEMPTY';
+                            break;
+                        default:
+                            operatorSymbol = operator;
+                    }
+                    // Build the condition part
+                    let conditionPart = '';
+                    if (operatorSymbol === 'ISEMPTY') {
+                        conditionPart = `${variableId}ISEMPTY`;
+                    }
+                    else if (operatorSymbol === 'CONTAINS') {
+                        conditionPart = `${variableId}LIKE${condition.value}`;
+                    }
+                    else {
+                        conditionPart = `${variableId}${operatorSymbol}${condition.value}`;
+                    }
+                    conditionParts.push(conditionPart);
+                }
+                // Join all conditions
+                conditionString = conditionParts.join('');
+            }
+            // Step 1: Create main catalog UI policy record with embedded conditions
             const policyData = {
-                catalog_item: args.cat_item,
+                catalog_item: args.cat_item, // ✅ Link naar het catalog item
                 short_description: args.short_description,
-                catalog_conditions: args.condition,
-                applies_catalog: args.applies_to || 'item',
+                catalog_conditions: conditionString || args.condition || '', // Conditions as string
+                applies_to: args.applies_to || 'item', // ✅ Correct veld: 'item', 'req_item', or 'task'
                 active: args.active !== false,
                 applies_on_load: args.on_load !== false,
-                reverse_if_false: args.reverse_if_false !== false
+                reverse_if_false: args.reverse_if_false !== false,
+                // Optional script fields if needed
+                script_true: args.script_true || '',
+                script_false: args.script_false || ''
             };
-            const response = await this.client.createRecord('catalog_ui_policy', policyData);
-            if (!response.success) {
-                throw new Error(`Failed to create catalog UI policy: ${response.error}`);
+            const policyResponse = await this.client.createRecord('catalog_ui_policy', policyData);
+            if (!policyResponse.success) {
+                throw new Error(`Failed to create catalog UI policy: ${policyResponse.error}`);
             }
-            return {
-                content: [{
-                        type: 'text',
-                        text: `✅ Catalog UI Policy created successfully!
+            const policyId = policyResponse.data.sys_id;
+            this.logger.info(`Created main policy with sys_id: ${policyId}`);
+            const createdActions = [];
+            // Step 2: Create action records (dit werkt wel met aparte tabel)
+            if (args.actions && Array.isArray(args.actions)) {
+                this.logger.info(`Creating ${args.actions.length} action records...`);
+                for (let i = 0; i < args.actions.length; i++) {
+                    const action = args.actions[i];
+                    // Resolve variable name to sys_id
+                    const variableId = await resolveVariableId(action.catalog_variable, args.cat_item);
+                    // Actions structuur in ServiceNow:
+                    // - catalog_ui_policy_action.catalog_variable -> item_option_new (variable)
+                    // - item_option_new.cat_item -> sc_cat_item (catalog item)
+                    // - catalog_ui_policy.catalog_item -> sc_cat_item (catalog item)
+                    // Mogelijk is er toch een ui_policy veld, maar het lijkt niet verplicht
+                    const actionData = {
+                        // Primaire koppeling: naar de variable
+                        catalog_variable: variableId, // Verplicht: koppeling naar variable
+                        // Mogelijk ook een policy koppeling (als het veld bestaat)
+                        ui_policy: policyId, // Probeer dit ook, kan optioneel zijn
+                        // Action settings - gebruik strings zoals ServiceNow verwacht
+                        mandatory: action.mandatory === true ? 'true' : action.mandatory === false ? 'false' : 'ignore',
+                        visible: action.visible === false ? 'false' : action.visible === true ? 'true' : 'ignore',
+                        disabled: action.readonly === true ? 'true' : action.readonly === false ? 'false' : 'ignore',
+                        // Waarde velden (voor set_value acties)
+                        value: action.value || '',
+                        // Metadata
+                        order: (i + 1) * 100,
+                        active: true
+                    };
+                    this.logger.info(`Attempting to create action ${i + 1}:`, actionData);
+                    const actionResponse = await this.client.createRecord('catalog_ui_policy_action', actionData);
+                    if (actionResponse.success) {
+                        createdActions.push({
+                            sys_id: actionResponse.data.sys_id,
+                            variable: action.catalog_variable,
+                            details: this.formatActionDetails(action)
+                        });
+                        this.logger.info(`✅ Created action: ${action.type || 'default'} for ${action.catalog_variable}`);
+                    }
+                    else {
+                        const errorMsg = `❌ Failed to create action ${i + 1}: ${actionResponse.error || 'Unknown error'}`;
+                        this.logger.error(errorMsg);
+                        this.logger.error('Action data was:', actionData);
+                        // BELANGRIJK: Gooi een error zodat de gebruiker weet dat het faalt!
+                        throw new Error(errorMsg);
+                    }
+                }
+            }
+            // Build comprehensive response
+            let responseText = `✅ Catalog UI Policy created successfully!
 
 📋 **${args.short_description}**
-🆔 sys_id: ${response.data.sys_id}
+🆔 Policy sys_id: ${policyId}
 🎯 Applies to: ${args.applies_to || 'item'}
 🔄 Active: ${args.active !== false ? 'Yes' : 'No'}
 ⚡ On Load: ${args.on_load !== false ? 'Yes' : 'No'}
-🔁 Reverse if False: ${args.reverse_if_false !== false ? 'Yes' : 'No'}
-
-✨ UI policy configured!`
+🔁 Reverse if False: ${args.reverse_if_false !== false ? 'Yes' : 'No'}`;
+            if (conditionString) {
+                responseText += `\n\n📝 **Conditions:**\n${conditionString}`;
+            }
+            if (createdActions.length > 0) {
+                responseText += `\n\n⚡ **Actions Created (${createdActions.length}):**\n`;
+                createdActions.forEach((action, i) => {
+                    responseText += `   ${i + 1}. ${action.details} on ${action.variable}\n`;
+                });
+            }
+            responseText += `\n\n✨ UI policy configured successfully with ${createdActions.length} actions!`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: responseText
                     }]
             };
         }
@@ -774,6 +940,46 @@ ${args.help_text ? `❓ Help: ${args.help_text}` : ''}
             throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Failed to create catalog UI policy: ${error}`);
         }
     }
+    /**
+     * Helper function to determine action type based on provided fields
+     * Note: ServiceNow might not use 'type' field, actions are determined by field values
+     */
+    determineActionType(action) {
+        // ServiceNow bepaalt het type waarschijnlijk op basis van de velden zelf
+        // Dit is alleen voor logging/display
+        if (action.value !== undefined && action.value !== '') {
+            return 'set_value';
+        }
+        if (action.mandatory === true) {
+            return 'set_mandatory';
+        }
+        if (action.visible === false) {
+            return 'set_hidden';
+        }
+        if (action.readonly === true) {
+            return 'set_readonly';
+        }
+        return 'default';
+    }
+    /**
+     * Helper function to format action details for display
+     */
+    formatActionDetails(action) {
+        const details = [];
+        if (action.mandatory !== undefined) {
+            details.push(`Mandatory: ${action.mandatory}`);
+        }
+        if (action.visible !== undefined) {
+            details.push(`Visible: ${action.visible}`);
+        }
+        if (action.readonly !== undefined) {
+            details.push(`Read-only: ${action.readonly}`);
+        }
+        if (action.value !== undefined && action.value !== '') {
+            details.push(`Value: "${action.value}"`);
+        }
+        return details.length > 0 ? details.join(', ') : 'No specific action';
+    }
     /**
      * Create Catalog Client Script
      * Uses catalog_script_client table

package/dist/templates/claude-md-template.d.ts

@@ -1,3 +1,3 @@
-export declare const CLAUDE_MD_TEMPLATE = "# Snow-Flow ServiceNow Development Framework\n\n## \uD83D\uDEA8 ABSOLUTE RULES - NO EXCEPTIONS\n\n### Rule #1: NO MOCK DATA - EVERYTHING REAL & COMPLETE\n**FORBIDDEN:** Mock data, placeholders, TODOs, stub implementations, test values, simulations, \"this would normally...\", partial implementations.\n**REQUIRED:** Complete, production-ready, fully functional code. Take time to implement EVERYTHING properly. Real integrations, comprehensive error handling, full validation.\n\n### Rule #2: ES5 ONLY - ServiceNow Rhino Engine\n**NEVER USE:** const/let, arrow functions =>, template literals `${}`, destructuring, for...of, default parameters, classes\n**ALWAYS USE:** var, function(){}, string concatenation +, traditional for loops, typeof checks\n\n### Rule #3: VERIFY FIRST - Never Assume\nTest before claiming broken. Check resources exist. Validate configurations. Evidence-based fixes only.\n\n## \uD83D\uDCCB MCP SERVERS & TOOLS (18 Servers, 200+ Tools)\n\n### 1. **servicenow-local-development** \uD83D\uDD27 Widget/Artifact Sync\n```\nsnow_pull_artifact - Pull ANY artifact to local files for native editing\nsnow_push_artifact - Push local changes back to ServiceNow  \nsnow_cleanup_artifacts - Clean local artifact cache\nsnow_get_sync_status - Check artifact sync status\nsnow_list_local_artifacts - List all pulled artifacts\n```\n\n### 2. **servicenow-deployment** \uD83D\uDE80 Complete Deployment System\n```\nsnow_deploy - Create NEW artifacts (widgets, flows, scripts, pages)\nsnow_update - UPDATE existing artifacts directly\nsnow_validate_deployment - Validate before deploy\nsnow_rollback_deployment - Rollback failed deployments\nsnow_preview_widget - Preview widget rendering\nsnow_widget_test - Test widget functionality\nsnow_deployment_history - View deployment history\nsnow_check_widget_coherence - Validate HTML/Client/Server communication\n```\n\n### 3. **servicenow-operations** \uD83D\uDCCA Core Operations\n```\nsnow_query_table - Universal table query with pagination\nsnow_query_incidents - Query and analyze incidents\nsnow_analyze_incident - AI-powered incident analysis\nsnow_auto_resolve_incident - Automated resolution\nsnow_cmdb_search - Configuration database search\nsnow_user_lookup - Find users and groups\nsnow_operational_metrics - Performance metrics\nsnow_knowledge_search - Search knowledge base\nsnow_catalog_item_manager - Manage service catalog\n```\n\n### 4. **servicenow-automation** \u2699\uFE0F Scripts & Automation\n```\nsnow_execute_background_script - Run ES5 scripts (autoConfirm available)\nsnow_execute_script_with_output - Execute with output capture\nsnow_execute_script_sync - Synchronous execution\nsnow_get_script_output - Retrieve script results\nsnow_schedule_job - Create scheduled jobs\nsnow_create_event - Trigger system events\nsnow_get_logs - Access system logs\nsnow_test_rest_connection - Test REST endpoints\nsnow_trace_execution - Performance tracing\n```\n\n### 5. **servicenow-platform-development** \uD83C\uDFD7\uFE0F Development Artifacts\n```\nsnow_create_ui_page - Create UI pages\nsnow_create_script_include - Reusable scripts\nsnow_create_business_rule - Business rules\nsnow_create_client_script - Client-side scripts\nsnow_create_ui_policy - UI policies\nsnow_create_ui_action - UI actions\nsnow_create_acl - Access controls\nsnow_create_ui_macro - UI macros\n```\n\n### 6. **servicenow-integration** \uD83D\uDD0C Integrations\n```\nsnow_create_rest_message - REST integrations\nsnow_create_soap_message - SOAP integrations\nsnow_create_transform_map - Data transformation\nsnow_create_import_set - Import management\nsnow_test_web_service - Test services\nsnow_configure_email - Email configuration\nsnow_create_data_source - Data sources\n```\n\n### 7. **servicenow-system-properties** \u2699\uFE0F Properties\n```\nsnow_property_get - Get property value\nsnow_property_set - Set property value\nsnow_property_list - List by pattern\nsnow_property_bulk_update - Bulk operations\nsnow_property_export/import - Export/Import JSON\nsnow_property_validate - Validate properties\n```\n\n### 8. **servicenow-update-set** \uD83D\uDCE6 Change Management\n```\nsnow_update_set_create - Create update set\nsnow_update_set_switch - Switch active set\nsnow_update_set_complete - Mark complete\nsnow_update_set_export - Export as XML\nsnow_update_set_preview - Preview changes\nsnow_ensure_active_update_set - Auto-create if needed\n```\n\n### 9. **servicenow-development-assistant** \uD83E\uDD16 AI Assistant\n```\nsnow_find_artifact - Find any artifact by name/type\nsnow_edit_artifact - Edit existing artifacts\nsnow_analyze_artifact - Analyze dependencies\nsnow_comprehensive_search - Deep search all tables\nsnow_analyze_requirements - Requirement analysis\nsnow_generate_code - Pattern-based generation\nsnow_optimize_script - Performance optimization\n```\n\n### 10. **servicenow-security-compliance** \uD83D\uDEE1\uFE0F Security\n```\nsnow_create_security_policy - Security policies\nsnow_audit_compliance - SOX/GDPR/HIPAA audit\nsnow_scan_vulnerabilities - Vulnerability scan\nsnow_assess_risk - Risk assessment\nsnow_review_access_control - ACL review\nsnow_encrypt_field - Field encryption\nsnow_audit_trail_analysis - Audit analysis\n```\n\n### 11. **servicenow-reporting-analytics** \uD83D\uDCC8 Reporting\n```\nsnow_create_report - Create reports\nsnow_create_dashboard - Build dashboards\nsnow_define_kpi - Define KPIs\nsnow_schedule_report - Schedule delivery\nsnow_analyze_data_quality - Data quality\nsnow_create_pa_widget - Performance analytics\n```\n\n### 12. **servicenow-machine-learning** \uD83E\uDDE0 AI/ML\n```\nml_train_incident_classifier - Train LSTM classifier\nml_predict_change_risk - Risk prediction\nml_detect_anomalies - Anomaly detection\nml_forecast_incidents - Time series forecast\nml_cluster_similar - Similarity clustering\nml_performance_analytics - Native PA ML\n```\n\n### 13. **servicenow-change-virtualagent-pa** \uD83D\uDD04 Change & Virtual Agent\n```\nsnow_create_change_request - Change requests\nsnow_assess_change_risk - Risk assessment\nsnow_create_nlu_model - NLU models\nsnow_train_virtual_agent - Train VA\nsnow_configure_conversation - VA conversations\nsnow_analyze_pa_trends - Performance trends\n```\n\n### 14. **servicenow-cmdb-event-hr-csm-devops** \uD83C\uDFE2 Enterprise\n```\nsnow_manage_ci - Configuration items\nsnow_correlate_events - Event correlation\nsnow_manage_hr_case - HR cases\nsnow_csm_project - Customer projects\nsnow_devops_pipeline - CI/CD pipelines\nsnow_manage_cmdb_relationships - CI relationships\n```\n\n### 15. **servicenow-knowledge-catalog** \uD83D\uDCDA Knowledge & Catalog\n```\nsnow_create_knowledge_article - KB articles\nsnow_manage_catalog_item - Catalog items\nsnow_configure_variables - Variable sets\nsnow_create_catalog_policy - Catalog policies\nsnow_manage_categories - Categories\n```\n\n### 16. **servicenow-flow-workspace-mobile** \uD83D\uDCF1 Modern UX\n```\nsnow_create_flow - Flow Designer flows\nsnow_add_flow_action - Flow actions\nsnow_create_workspace - Workspace config\nsnow_configure_mobile_app - Mobile apps\nsnow_configure_offline_sync - Offline mode\n```\n\n### 17. **servicenow-advanced-features** \uD83C\uDFAF Advanced\n```\nsnow_performance_optimization - Optimize instance\nsnow_batch_operations - Bulk processing\nsnow_instance_scan - Health check\nsnow_dependency_analysis - Dependencies\nsnow_code_search - Search all code\n```\n\n### 18. **snow-flow** \uD83C\uDF9B\uFE0F Orchestration\n```\nswarm_init - Initialize agent swarms\nagent_spawn - Create specialized agents\ntask_orchestrate - Complex task coordination\nmemory_search - Search persistent memory\nneural_train - Train neural networks\n```\n\n## \uD83D\uDD04 Critical Workflows\n\n### Widget Debugging (ALWAYS use Local Sync!)\n```javascript\n// \u2705 CORRECT - Local sync for debugging\nawait snow_pull_artifact({ sys_id: 'widget_sys_id' });\n// Edit with native tools (search, multi-file, etc.)\nawait snow_push_artifact({ sys_id: 'widget_sys_id' });\n\n// \u274C WRONG - Token limit explosion\nawait snow_query_table({ table: 'sp_widget', query: 'sys_id=...' });\n```\n\n### Verification Pattern\n```javascript\n// Always verify with REAL data, not placeholders\nawait snow_execute_script_with_output({\n  script: `\n    var gr = new GlideRecord('incident');\n    gr.addQuery('active', true);\n    gr.query();\n    gs.info('Found: ' + gr.getRowCount() + ' active incidents');\n    \n    // Test actual property\n    var prop = gs.getProperty('instance_name');\n    gs.info('Instance: ' + prop);\n  `\n});\n```\n\n### Complete Widget Creation (NO PLACEHOLDERS)\n```javascript\nawait snow_deploy({\n  type: 'widget',\n  config: {\n    name: 'my_widget',\n    title: 'Production Widget',\n    template: '<div ng-repeat=\"item in data.items\">{{item.name}}</div>',\n    script: `\n      (function() {\n        data.items = [];\n        var gr = new GlideRecord('incident');\n        gr.addQuery('active', true);\n        gr.setLimit(10);\n        gr.query();\n        while (gr.next()) {\n          data.items.push({\n            name: gr.getDisplayValue('number'),\n            description: gr.getDisplayValue('short_description')\n          });\n        }\n      })();\n    `,\n    client_script: `\n      function($scope) {\n        var c = this;\n        c.refresh = function() {\n          c.server.get().then(function(r) {\n            console.log('Refreshed');\n          });\n        };\n      }\n    `\n  }\n});\n```\n\n## \u26A1 Command Reference\n\n### Core Commands\n- `snow-flow init` - Initialize project with this CLAUDE.md\n- `snow-flow auth login` - Authenticate with ServiceNow\n- `snow-flow status` - System status\n- `snow-flow swarm \"<task>\"` - Multi-agent coordination\n\n### Development Flow\n1. **Pull artifact**: `snow_pull_artifact` for local editing\n2. **Edit locally**: Use Claude's native search/edit tools\n3. **Push changes**: `snow_push_artifact` to ServiceNow\n4. **Test**: `snow_execute_script_with_output` with REAL code\n5. **Deploy**: `snow_update_set_complete` when ready\n\n## \uD83C\uDFAF Golden Rules\n\n1. **NO MOCK DATA** - Everything real, complete, production-ready\n2. **ES5 ONLY** - var, function(){}, no modern JS\n3. **VERIFY FIRST** - Test before assuming\n4. **LOCAL SYNC** - Use snow_pull_artifact for widgets\n5. **COMPLETE CODE** - No TODOs, no placeholders\n6. **TOKEN AWARE** - Use batch operations\n7. **UPDATE SETS** - Track all changes\n\n## \uD83D\uDCCA Quick Reference\n\n| Issue | Solution |\n|-------|----------|\n| Widget doesn't work | `snow_pull_artifact` \u2192 debug locally |\n| Script syntax error | ES5 only! var, function(){} |\n| Can't find table | `snow_discover_table_fields` |\n| Property missing | `snow_property_manager` |\n| Need to test | `snow_execute_script_with_output` |\n| Deployment failed | `snow_rollback_deployment` |\n\nRemember: TAKE THE TIME. DO IT RIGHT. NO MOCK DATA. NO EXCEPTIONS.";
+export declare const CLAUDE_MD_TEMPLATE = "# Snow-Flow ServiceNow Development Framework\n\n## \uD83D\uDEA8 ABSOLUTE RULES - NO EXCEPTIONS\n\n### \uD83D\uDD34 CRITICAL: Widget Debugging MUST Use Local Sync!\n\n**When user reports ANY widget issue, ALWAYS use:**\n```\nsnow_pull_artifact({ sys_id: 'widget_sys_id' })\n```\n\n**NEVER use snow_query_table for widgets!** It will hit token limits and you can't use native tools.\n\n**Common scenarios requiring snow_pull_artifact:**\n- \"Widget skips questions\" \u2192 snow_pull_artifact\n- \"Form doesn't submit\" \u2192 snow_pull_artifact  \n- \"Data not displaying\" \u2192 snow_pull_artifact\n- \"Button doesn't work\" \u2192 snow_pull_artifact\n- \"Debug this widget\" \u2192 snow_pull_artifact\n- \"Fix widget issue\" \u2192 snow_pull_artifact\n- Widget script > 1000 chars \u2192 snow_pull_artifact\n\n### Rule #1: NO MOCK DATA - EVERYTHING REAL & COMPLETE\n**FORBIDDEN:** Mock data, placeholders, TODOs, stub implementations, test values, simulations, \"this would normally...\", partial implementations.\n**REQUIRED:** Complete, production-ready, fully functional code. Take time to implement EVERYTHING properly. Real integrations, comprehensive error handling, full validation.\n\n### Rule #2: ES5 ONLY - ServiceNow Rhino Engine\n**NEVER USE:** const/let, arrow functions =>, template literals `${}`, destructuring, for...of, default parameters, classes\n**ALWAYS USE:** var, function(){}, string concatenation +, traditional for loops, typeof checks\n\n### Rule #3: VERIFY FIRST - Never Assume\nTest before claiming broken. Check resources exist. Validate configurations. Evidence-based fixes only.\n\n## \uD83D\uDCCB MCP SERVERS & TOOLS (18 Servers, 200+ Tools)\n\n### 1. **servicenow-local-development** \uD83D\uDD27 Widget/Artifact Sync [USE THIS FOR WIDGETS!]\n```\nsnow_pull_artifact - Pull ANY artifact to local files (ALWAYS use for widgets!)\nsnow_push_artifact - Push local changes back to ServiceNow  \nsnow_cleanup_artifacts - Clean local artifact cache\nsnow_get_sync_status - Check artifact sync status\nsnow_list_local_artifacts - List all pulled artifacts\n```\n**\u26A0\uFE0F CRITICAL: For ANY widget work, use snow_pull_artifact FIRST, not snow_query_table!**\n\n### 2. **servicenow-deployment** \uD83D\uDE80 Complete Deployment System\n```\nsnow_deploy - Create NEW artifacts (widgets, flows, scripts, pages)\nsnow_update - UPDATE existing artifacts directly\nsnow_validate_deployment - Validate before deploy\nsnow_rollback_deployment - Rollback failed deployments\nsnow_preview_widget - Preview widget rendering\nsnow_widget_test - Test widget functionality\nsnow_deployment_history - View deployment history\nsnow_check_widget_coherence - Validate HTML/Client/Server communication\n```\n\n### 3. **servicenow-operations** \uD83D\uDCCA Core Operations\n```\nsnow_query_table - Universal table query (NOT for widgets - use snow_pull_artifact!)\nsnow_query_incidents - Query and analyze incidents\nsnow_analyze_incident - AI-powered incident analysis\nsnow_auto_resolve_incident - Automated resolution\nsnow_cmdb_search - Configuration database search\nsnow_user_lookup - Find users and groups\nsnow_operational_metrics - Performance metrics\nsnow_knowledge_search - Search knowledge base\nsnow_catalog_item_manager - Manage service catalog\n```\n\n### 4. **servicenow-automation** \u2699\uFE0F Scripts & Automation\n```\nsnow_execute_background_script - Run ES5 scripts (autoConfirm available)\nsnow_execute_script_with_output - Execute with output capture\nsnow_execute_script_sync - Synchronous execution\nsnow_get_script_output - Retrieve script results\nsnow_schedule_job - Create scheduled jobs\nsnow_create_event - Trigger system events\nsnow_get_logs - Access system logs\nsnow_test_rest_connection - Test REST endpoints\nsnow_trace_execution - Performance tracing\n```\n\n### 5. **servicenow-platform-development** \uD83C\uDFD7\uFE0F Development Artifacts\n```\nsnow_create_ui_page - Create UI pages\nsnow_create_script_include - Reusable scripts\nsnow_create_business_rule - Business rules\nsnow_create_client_script - Client-side scripts\nsnow_create_ui_policy - UI policies\nsnow_create_ui_action - UI actions\nsnow_create_acl - Access controls\nsnow_create_ui_macro - UI macros\n```\n\n### 6. **servicenow-integration** \uD83D\uDD0C Integrations\n```\nsnow_create_rest_message - REST integrations\nsnow_create_soap_message - SOAP integrations\nsnow_create_transform_map - Data transformation\nsnow_create_import_set - Import management\nsnow_test_web_service - Test services\nsnow_configure_email - Email configuration\nsnow_create_data_source - Data sources\n```\n\n### 7. **servicenow-system-properties** \u2699\uFE0F Properties\n```\nsnow_property_get - Get property value\nsnow_property_set - Set property value\nsnow_property_list - List by pattern\nsnow_property_bulk_update - Bulk operations\nsnow_property_export/import - Export/Import JSON\nsnow_property_validate - Validate properties\n```\n\n### 8. **servicenow-update-set** \uD83D\uDCE6 Change Management\n```\nsnow_update_set_create - Create update set\nsnow_update_set_switch - Switch active set\nsnow_update_set_complete - Mark complete\nsnow_update_set_export - Export as XML\nsnow_update_set_preview - Preview changes\nsnow_ensure_active_update_set - Auto-create if needed\n```\n\n### 9. **servicenow-development-assistant** \uD83E\uDD16 AI Assistant\n```\nsnow_find_artifact - Find any artifact by name/type\nsnow_edit_artifact - Edit existing artifacts\nsnow_analyze_artifact - Analyze dependencies\nsnow_comprehensive_search - Deep search all tables\nsnow_analyze_requirements - Requirement analysis\nsnow_generate_code - Pattern-based generation\nsnow_optimize_script - Performance optimization\n```\n\n### 10. **servicenow-security-compliance** \uD83D\uDEE1\uFE0F Security\n```\nsnow_create_security_policy - Security policies\nsnow_audit_compliance - SOX/GDPR/HIPAA audit\nsnow_scan_vulnerabilities - Vulnerability scan\nsnow_assess_risk - Risk assessment\nsnow_review_access_control - ACL review\nsnow_encrypt_field - Field encryption\nsnow_audit_trail_analysis - Audit analysis\n```\n\n### 11. **servicenow-reporting-analytics** \uD83D\uDCC8 Reporting\n```\nsnow_create_report - Create reports\nsnow_create_dashboard - Build dashboards\nsnow_define_kpi - Define KPIs\nsnow_schedule_report - Schedule delivery\nsnow_analyze_data_quality - Data quality\nsnow_create_pa_widget - Performance analytics\n```\n\n### 12. **servicenow-machine-learning** \uD83E\uDDE0 AI/ML\n```\nml_train_incident_classifier - Train LSTM classifier\nml_predict_change_risk - Risk prediction\nml_detect_anomalies - Anomaly detection\nml_forecast_incidents - Time series forecast\nml_cluster_similar - Similarity clustering\nml_performance_analytics - Native PA ML\n```\n\n### 13. **servicenow-change-virtualagent-pa** \uD83D\uDD04 Change & Virtual Agent\n```\nsnow_create_change_request - Change requests\nsnow_assess_change_risk - Risk assessment\nsnow_create_nlu_model - NLU models\nsnow_train_virtual_agent - Train VA\nsnow_configure_conversation - VA conversations\nsnow_analyze_pa_trends - Performance trends\n```\n\n### 14. **servicenow-cmdb-event-hr-csm-devops** \uD83C\uDFE2 Enterprise\n```\nsnow_manage_ci - Configuration items\nsnow_correlate_events - Event correlation\nsnow_manage_hr_case - HR cases\nsnow_csm_project - Customer projects\nsnow_devops_pipeline - CI/CD pipelines\nsnow_manage_cmdb_relationships - CI relationships\n```\n\n### 15. **servicenow-knowledge-catalog** \uD83D\uDCDA Knowledge & Catalog (v3.6.10 Corrected!)\n```\nsnow_create_knowledge_article - KB articles\nsnow_create_catalog_item - Catalog items\nsnow_create_catalog_variable - Variable sets\nsnow_create_catalog_ui_policy - CORRECTED: Creates in 2 tables (conditions as string, actions as records)\nsnow_order_catalog_item - Order catalog items\nsnow_discover_catalogs - Discover available catalogs\n```\n**\u2705 Corrected UI Policy (v3.6.10):** Conditions stored as query string in catalog_conditions field. Actions created in catalog_ui_policy_action table. Based on actual ServiceNow structure!\n\n### 16. **servicenow-flow-workspace-mobile** \uD83D\uDCF1 Modern UX\n```\nsnow_create_flow - Flow Designer flows\nsnow_add_flow_action - Flow actions\nsnow_create_workspace - Workspace config\nsnow_configure_mobile_app - Mobile apps\nsnow_configure_offline_sync - Offline mode\n```\n\n### 17. **servicenow-advanced-features** \uD83C\uDFAF Advanced\n```\nsnow_performance_optimization - Optimize instance\nsnow_batch_operations - Bulk processing\nsnow_instance_scan - Health check\nsnow_dependency_analysis - Dependencies\nsnow_code_search - Search all code\n```\n\n### 18. **snow-flow** \uD83C\uDF9B\uFE0F Orchestration\n```\nswarm_init - Initialize agent swarms\nagent_spawn - Create specialized agents\ntask_orchestrate - Complex task coordination\nmemory_search - Search persistent memory\nneural_train - Train neural networks\n```\n\n## \uD83D\uDD04 Critical Workflows\n\n### Widget Debugging (ALWAYS use Local Sync!)\n```javascript\n// \u2705 CORRECT - Local sync for debugging\nawait snow_pull_artifact({ sys_id: 'widget_sys_id' });\n// Edit with native tools (search, multi-file, etc.)\nawait snow_push_artifact({ sys_id: 'widget_sys_id' });\n\n// \u274C WRONG - Token limit explosion\nawait snow_query_table({ table: 'sp_widget', query: 'sys_id=...' });\n```\n\n### Verification Pattern\n```javascript\n// Always verify with REAL data, not placeholders\nawait snow_execute_script_with_output({\n  script: `\n    var gr = new GlideRecord('incident');\n    gr.addQuery('active', true);\n    gr.query();\n    gs.info('Found: ' + gr.getRowCount() + ' active incidents');\n    \n    // Test actual property\n    var prop = gs.getProperty('instance_name');\n    gs.info('Instance: ' + prop);\n  `\n});\n```\n\n### Complete Widget Creation (NO PLACEHOLDERS)\n```javascript\nawait snow_deploy({\n  type: 'widget',\n  config: {\n    name: 'my_widget',\n    title: 'Production Widget',\n    template: '<div ng-repeat=\"item in data.items\">{{item.name}}</div>',\n    script: `\n      (function() {\n        data.items = [];\n        var gr = new GlideRecord('incident');\n        gr.addQuery('active', true);\n        gr.setLimit(10);\n        gr.query();\n        while (gr.next()) {\n          data.items.push({\n            name: gr.getDisplayValue('number'),\n            description: gr.getDisplayValue('short_description')\n          });\n        }\n      })();\n    `,\n    client_script: `\n      function($scope) {\n        var c = this;\n        c.refresh = function() {\n          c.server.get().then(function(r) {\n            console.log('Refreshed');\n          });\n        };\n      }\n    `\n  }\n});\n```\n\n### Catalog UI Policy (v3.6.10 Corrected)\n```javascript\nawait snow_create_catalog_ui_policy({\n  cat_item: 'catalog_item_sys_id',\n  short_description: 'Dynamic Field Control',\n  // Conditions converted to ServiceNow query string format\n  conditions: [\n    {\n      catalog_variable: 'user_type',  // Can use name or sys_id\n      operation: 'is',  // or 'is not', 'contains', 'is empty', etc.\n      value: 'employee',\n      and_or: 'AND'  // Connect with AND or OR\n    },\n    {\n      catalog_variable: 'department',\n      operation: 'is not empty',\n      value: ''\n    }\n  ],\n  // Actions still create separate records\n  actions: [\n    {\n      catalog_variable: 'manager_approval',\n      visible: true,\n      mandatory: true\n    },\n    {\n      catalog_variable: 'cost_center',\n      mandatory: true\n    }\n  ]\n});\n// Creates policy with conditions as query string in catalog_conditions field\n// Actions created as separate records in catalog_ui_policy_action table\n```\n\n## \u26A1 Command Reference\n\n### Core Commands\n- `snow-flow init` - Initialize project with this CLAUDE.md\n- `snow-flow auth login` - Authenticate with ServiceNow\n- `snow-flow status` - System status\n- `snow-flow swarm \"<task>\"` - Multi-agent coordination\n\n### Development Flow\n1. **Pull artifact**: `snow_pull_artifact` for local editing\n2. **Edit locally**: Use Claude's native search/edit tools\n3. **Push changes**: `snow_push_artifact` to ServiceNow\n4. **Test**: `snow_execute_script_with_output` with REAL code\n5. **Deploy**: `snow_update_set_complete` when ready\n\n## \uD83C\uDFAF Golden Rules\n\n1. **NO MOCK DATA** - Everything real, complete, production-ready\n2. **ES5 ONLY** - var, function(){}, no modern JS\n3. **VERIFY FIRST** - Test before assuming\n4. **LOCAL SYNC** - Use snow_pull_artifact for widgets\n5. **COMPLETE CODE** - No TODOs, no placeholders\n6. **TOKEN AWARE** - Use batch operations\n7. **UPDATE SETS** - Track all changes\n\n## \uD83D\uDCCA Quick Reference\n\n| Issue | Solution |\n|-------|----------|\n| Widget doesn't work | `snow_pull_artifact` \u2192 debug locally |\n| Script syntax error | ES5 only! var, function(){} |\n| Can't find table | `snow_discover_table_fields` |\n| Property missing | `snow_property_manager` |\n| Need to test | `snow_execute_script_with_output` |\n| Deployment failed | `snow_rollback_deployment` |\n\nRemember: TAKE THE TIME. DO IT RIGHT. NO MOCK DATA. NO EXCEPTIONS.";
 export declare const CLAUDE_MD_TEMPLATE_VERSION = "3.6.2-CONSOLIDATED";
 //# sourceMappingURL=claude-md-template.d.ts.map

package/dist/templates/claude-md-template.js

@@ -5,6 +5,24 @@ exports.CLAUDE_MD_TEMPLATE = `# Snow-Flow ServiceNow Development Framework
 
 ## 🚨 ABSOLUTE RULES - NO EXCEPTIONS
 
+### 🔴 CRITICAL: Widget Debugging MUST Use Local Sync!
+
+**When user reports ANY widget issue, ALWAYS use:**
+\`\`\`
+snow_pull_artifact({ sys_id: 'widget_sys_id' })
+\`\`\`
+
+**NEVER use snow_query_table for widgets!** It will hit token limits and you can't use native tools.
+
+**Common scenarios requiring snow_pull_artifact:**
+- "Widget skips questions" → snow_pull_artifact
+- "Form doesn't submit" → snow_pull_artifact  
+- "Data not displaying" → snow_pull_artifact
+- "Button doesn't work" → snow_pull_artifact
+- "Debug this widget" → snow_pull_artifact
+- "Fix widget issue" → snow_pull_artifact
+- Widget script > 1000 chars → snow_pull_artifact
+
 ### Rule #1: NO MOCK DATA - EVERYTHING REAL & COMPLETE
 **FORBIDDEN:** Mock data, placeholders, TODOs, stub implementations, test values, simulations, "this would normally...", partial implementations.
 **REQUIRED:** Complete, production-ready, fully functional code. Take time to implement EVERYTHING properly. Real integrations, comprehensive error handling, full validation.
@@ -18,14 +36,15 @@ Test before claiming broken. Check resources exist. Validate configurations. Evi
 
 ## 📋 MCP SERVERS & TOOLS (18 Servers, 200+ Tools)
 
-### 1. **servicenow-local-development** 🔧 Widget/Artifact Sync
+### 1. **servicenow-local-development** 🔧 Widget/Artifact Sync [USE THIS FOR WIDGETS!]
 \`\`\`
-snow_pull_artifact - Pull ANY artifact to local files for native editing
+snow_pull_artifact - Pull ANY artifact to local files (ALWAYS use for widgets!)
 snow_push_artifact - Push local changes back to ServiceNow  
 snow_cleanup_artifacts - Clean local artifact cache
 snow_get_sync_status - Check artifact sync status
 snow_list_local_artifacts - List all pulled artifacts
 \`\`\`
+**⚠️ CRITICAL: For ANY widget work, use snow_pull_artifact FIRST, not snow_query_table!**
 
 ### 2. **servicenow-deployment** 🚀 Complete Deployment System
 \`\`\`
@@ -41,7 +60,7 @@ snow_check_widget_coherence - Validate HTML/Client/Server communication
 
 ### 3. **servicenow-operations** 📊 Core Operations
 \`\`\`
-snow_query_table - Universal table query with pagination
+snow_query_table - Universal table query (NOT for widgets - use snow_pull_artifact!)
 snow_query_incidents - Query and analyze incidents
 snow_analyze_incident - AI-powered incident analysis
 snow_auto_resolve_incident - Automated resolution
@@ -170,14 +189,16 @@ snow_devops_pipeline - CI/CD pipelines
 snow_manage_cmdb_relationships - CI relationships
 \`\`\`
 
-### 15. **servicenow-knowledge-catalog** 📚 Knowledge & Catalog
+### 15. **servicenow-knowledge-catalog** 📚 Knowledge & Catalog (v3.6.10 Corrected!)
 \`\`\`
 snow_create_knowledge_article - KB articles
-snow_manage_catalog_item - Catalog items
-snow_configure_variables - Variable sets
-snow_create_catalog_policy - Catalog policies
-snow_manage_categories - Categories
+snow_create_catalog_item - Catalog items
+snow_create_catalog_variable - Variable sets
+snow_create_catalog_ui_policy - CORRECTED: Creates in 2 tables (conditions as string, actions as records)
+snow_order_catalog_item - Order catalog items
+snow_discover_catalogs - Discover available catalogs
 \`\`\`
+**✅ Corrected UI Policy (v3.6.10):** Conditions stored as query string in catalog_conditions field. Actions created in catalog_ui_policy_action table. Based on actual ServiceNow structure!
 
 ### 16. **servicenow-flow-workspace-mobile** 📱 Modern UX
 \`\`\`
@@ -273,6 +294,42 @@ await snow_deploy({
 });
 \`\`\`
 
+### Catalog UI Policy (v3.6.10 Corrected)
+\`\`\`javascript
+await snow_create_catalog_ui_policy({
+  cat_item: 'catalog_item_sys_id',
+  short_description: 'Dynamic Field Control',
+  // Conditions converted to ServiceNow query string format
+  conditions: [
+    {
+      catalog_variable: 'user_type',  // Can use name or sys_id
+      operation: 'is',  // or 'is not', 'contains', 'is empty', etc.
+      value: 'employee',
+      and_or: 'AND'  // Connect with AND or OR
+    },
+    {
+      catalog_variable: 'department',
+      operation: 'is not empty',
+      value: ''
+    }
+  ],
+  // Actions still create separate records
+  actions: [
+    {
+      catalog_variable: 'manager_approval',
+      visible: true,
+      mandatory: true
+    },
+    {
+      catalog_variable: 'cost_center',
+      mandatory: true
+    }
+  ]
+});
+// Creates policy with conditions as query string in catalog_conditions field
+// Actions created as separate records in catalog_ui_policy_action table
+\`\`\`
+
 ## ⚡ Command Reference
 
 ### Core Commands

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "snow-flow",
-  "version": "3.6.6",
-  "description": "MCP TEMPLATE FIX - v3.6.6 ensures snow-flow init generates correct .mcp.json with UNIVERSAL ARTIFACT DETECTION. Uses sys_metadata to find ANY ServiceNow record by sys_id alone. Generic artifact support for custom/unknown tables. Auto-creates editable file structure for ANY table type. Includes early auto-compact, audit logging, and consolidated CLAUDE.md.",
+  "version": "3.6.12",
+  "description": "COMPLETE UI POLICY FIX - v3.6.12 fixes both policy and actions. Policy uses catalog_item + applies_to fields. Actions link to catalog_variable. Conditions stored as query string. Based on actual ServiceNow table structure.",
   "main": "dist/index.js",
   "type": "commonjs",
   "bin": {