snow-flow 8.1.4 → 8.1.5

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 CRITICAL: HOW MCP TOOLS WORK IN OPENCODE\n\n**MCP tools are AUTOMATICALLY AVAILABLE - NO bash/npx needed!**\n\n```javascript\n// \u2705 CORRECT - MCP tools are available directly:\nawait snow_create_ui_page({\n  name: \"incident_dashboard\",\n  html: \"<div>...</div>\"\n});\n\nawait snow_create_complete_workspace({\n  workspace_name: \"IT Support\",\n  tables: [\"incident\", \"task\"]\n});\n\n// \u274C WRONG - NEVER use bash to call MCP tools:\n// npx snow-flow-mcp-client servicenow-unified snow_create_ui_page {...}  // DOES NOT EXIST!\n// node ... snow_create_ui_page  // WRONG!\n// Bash('snow_create_ui_page')  // WRONG!\n```\n\n**\uD83D\uDEA8 FORBIDDEN:**\n- Using bash/npx/node to call MCP tools\n- Checking if MCP tools exist with bash commands\n- Using `snow-flow-mcp-client` (DOES NOT EXIST!)\n- Writing scripts to \"call MCP tools\" via CLI\n\n**\u2705 REQUIRED:**\n- Call MCP tools **DIRECTLY** like any other function\n- MCP tools are **automatically loaded** by OpenCode\n- Available tools: All `snow_*` functions listed below\n\n## \uD83D\uDEA8 ABSOLUTE RULES - NO EXCEPTIONS\n\n### \uD83D\uDD34 RULE #0: MCP TOOLS FIRST - NEVER USE LOCAL APPROACHES!\n\n**\u274C WRONG APPROACH (FORBIDDEN):**\n- Writing local scripts to \"test something first\"\n- Using background scripts for complex operations instead of MCP tools\n- Creating files locally \"to prepare before deployment\"\n- Building things locally then deploying to ServiceNow\n- Using generic queries when specific MCP tools exist\n\n**\u2705 CORRECT APPROACH (MANDATORY):**\n- **ALWAYS search for MCP tools FIRST** before doing anything\n- **Use dedicated MCP tools** for every ServiceNow operation\n- **Create directly in ServiceNow** via MCP tools, never locally first\n- **Dedicated tool > Background script** ALWAYS\n\n**Examples:**\n```javascript\n// \u274C WRONG: Using background script for workspace creation\nsnow_execute_background_script({\n  script: \"var gr = new GlideRecord('sys_ux_app_config')...\"\n});\n\n// \u2705 CORRECT: Use dedicated MCP tool\nsnow_create_complete_workspace({\n  workspace_name: \"IT Support Workspace\",\n  tables: [\"incident\", \"task\"]\n});\n\n// \u274C WRONG: Generic query when specific tool exists\nsnow_query_table({ table: 'sp_widget', query: 'sys_id=...' });\n\n// \u2705 CORRECT: Use dedicated widget tool\nsnow_pull_artifact({ sys_id: 'widget_sys_id' });\n```\n\n**MCP Tool Discovery Process:**\n1. **Search**: \"Does a tool exist for [task]?\" (e.g., snow_create_workspace, snow_deploy_widget)\n2. **Check category**: deployment, operations, ui-builder, workspace, automation\n3. **Use dedicated tool**: ALWAYS prefer specific tools over generic ones\n4. **Background scripts**: ONLY for verification, NEVER for development\n\n### \uD83D\uDD34 RULE #1: UPDATE SET WORKFLOW - MANDATORY FOR ALL DEVELOPMENT!\n\n**\uD83D\uDEA8 CRITICAL: EVERY development task MUST follow this workflow:**\n\n```javascript\n// STEP 1: ALWAYS create/ensure active Update Set FIRST (before ANY development)\nconst updateSet = await snow_create_update_set({\n  name: \"Feature: [Descriptive Name]\",  // e.g., \"Feature: Incident Dashboard Widget\"\n  description: \"Complete description of changes\",\n  application: \"global\"  // or specific app scope\n});\n\n// STEP 2: Ensure it's active (Snow-Flow auto-sets as current in ServiceNow!)\nawait snow_ensure_active_update_set({\n  sys_id: updateSet.sys_id\n});\n\n// STEP 3: NOW start development - all changes auto-tracked\nawait snow_deploy({\n  type: 'widget',\n  config: { name: 'incident_dashboard', ... }\n});\n\n// STEP 4: Complete Update Set when done\nawait snow_complete_update_set({\n  sys_id: updateSet.sys_id,\n  state: 'complete'\n});\n```\n\n**\u274C FORBIDDEN WORKFLOW:**\n- Starting development without creating Update Set first\n- Creating artifacts then trying to \"add them to Update Set later\"\n- Assuming changes are being tracked (they're not without active Update Set!)\n- Working across multiple Update Sets for single feature\n\n**\u2705 MANDATORY WORKFLOW:**\n1. **CREATE Update Set** (descriptive name: \"Feature: X\" or \"Fix: Y\")\n2. **ACTIVATE Update Set** (snow_ensure_active_update_set)\n3. **DEVELOP** (all changes auto-tracked in active Update Set)\n4. **COMPLETE Update Set** (mark as complete when done)\n\n**Update Set Best Practices:**\n- **One feature = One Update Set** (clear scope)\n- **Descriptive names**: \"Feature: Incident Auto-Assignment\" not \"Changes\"\n- **Complete description**: What, why, affected tables/components\n- **Always check current**: Use snow_sync_current_update_set if unsure\n\n### \uD83D\uDD34 RULE #2: 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 #3: 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 #4: 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 #5: 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 [MANDATORY FOR ALL DEVELOPMENT!]\n```\nsnow_create_update_set - Create new update set (ALWAYS FIRST STEP!)\nsnow_ensure_active_update_set - Auto-create and activate (sets as current in ServiceNow!)\nsnow_sync_current_update_set - Sync Snow-Flow with user's current Update Set\nsnow_complete_update_set - Mark complete when done\nsnow_export_update_set - Export as XML for deployment\nsnow_preview_update_set - Preview changes before committing\nsnow_list_update_sets - List all update sets\nsnow_get_update_set_changes - View tracked changes\n```\n**\uD83D\uDEA8 CRITICAL:** EVERY development task MUST start with snow_create_update_set or snow_ensure_active_update_set!\n\n**Complete Workflow Example:**\n```javascript\n// 1. CREATE UPDATE SET (before ANY development!)\nconst updateSet = await snow_create_update_set({\n  name: \"Feature: Incident Auto-Assignment\",\n  description: \"Implements automatic incident assignment based on category and location\",\n  application: \"global\"\n});\n\n// 2. ENSURE IT'S ACTIVE (Snow-Flow auto-sets as current in ServiceNow!)\nawait snow_ensure_active_update_set({ sys_id: updateSet.sys_id });\n\n// 3. NOW DEVELOP (all changes auto-tracked)\nawait snow_create_business_rule({\n  name: \"Auto-assign incidents\",\n  table: \"incident\",\n  when: \"before\",\n  active: true,\n  script: \"var assignment = new IncidentAssignment(); assignment.autoAssign(current);\"\n});\n\nawait snow_deploy({\n  type: 'widget',\n  config: { name: 'assignment_dashboard', ... }\n});\n\n// 4. COMPLETE UPDATE SET\nawait snow_complete_update_set({\n  sys_id: updateSet.sys_id,\n  state: 'complete'\n});\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 Native PI + Local ML\n\n**\uD83D\uDEA8 TWO COMPLETELY DIFFERENT ML APPROACHES!**\n\n**\uD83C\uDFE2 Native ServiceNow Predictive Intelligence (NEW! v7.4.0):**\n- Runs INSIDE ServiceNow (requires PI license)\n- Production-ready, auto-retrain, enterprise ML\n- Tools: snow_create_pi_solution, snow_train_pi_solution, snow_monitor_pi_training, snow_activate_pi_solution\n- **ALWAYS ask:** \"Do you have a ServiceNow Predictive Intelligence license?\"\n\n**\uD83D\uDCBB Local TensorFlow.js ML (Experimental):**\n- Runs locally on dev machine (FREE, no license)\n- Development/testing only, NOT for production\n- Tools: ml_train_incident_classifier, ml_predict_change_risk, ml_detect_anomalies\n\n**\uD83D\uDCCB Decision Matrix:**\n| User Says | Has PI License? | Recommend |\n|-----------|----------------|-----------|\n| \"Create incident predictor\" | \u2705 Yes | Native PI: snow_create_pi_solution |\n| \"Create incident predictor\" | \u274C No | Local TensorFlow.js: ml_train_incident_classifier |\n| \"Production ML solution\" | \u2705 Yes | Native PI (always) |\n| \"Production ML solution\" | \u274C No | STOP: Explain PI license required |\n| \"Test/experiment with ML\" | Either | Can use local TensorFlow.js |\n\n**\uD83D\uDEA8 CRITICAL: ALWAYS ask about PI license before recommending ML tools!**\n\n```\n# Native PI Tools (Production):\nsnow_create_pi_solution - Create PI solution definition\nsnow_train_pi_solution - Train model in ServiceNow (10-30 min)\nsnow_monitor_pi_training - Monitor training progress/metrics\nsnow_activate_pi_solution - Activate for production use\nsnow_list_pi_solutions - List all PI solutions\nml_predictive_intelligence - Make predictions (requires trained PI solution)\n\n# Local ML Tools (Dev/Testing Only):\nml_train_incident_classifier - Train LSTM classifier locally\nml_predict_change_risk - Local risk prediction\nml_detect_anomalies - Local anomaly detection\nml_forecast_incidents - Local time series forecast\nml_cluster_similar - Local 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 + UI Builder\n```\n# Flow Designer Tools\nsnow_list_flows - List Flow Designer flows\nsnow_execute_flow - Execute flows programmatically  \nsnow_get_flow_execution_status - Monitor flow status\nsnow_get_flow_execution_history - Flow execution history\nsnow_get_flow_details - Flow configuration details\nsnow_import_flow_from_xml - Import flows from XML\n\n# Agent Workspace Tools  \nsnow_create_workspace - Create agent workspace configurations\nsnow_create_workspace_tab - Add custom workspace tabs\nsnow_create_contextual_panel - Add contextual side panels\nsnow_discover_workspaces - Find all workspace configurations\n\n# Mobile App Tools\nsnow_configure_mobile_app - Configure mobile applications\nsnow_send_push_notification - Send push notifications  \nsnow_configure_offline_sync - Setup offline synchronization\n\n# \uD83C\uDD95 COMPLETE UI BUILDER INTEGRATION (15 NEW TOOLS!)\n# Page Management (sys_ux_page)\nsnow_create_uib_page - Create UI Builder pages with routing\nsnow_update_uib_page - Update page configuration\nsnow_delete_uib_page - Delete pages with dependency validation\nsnow_discover_uib_pages - Find all UI Builder pages\n\n# Component Library (sys_ux_lib_*)  \nsnow_create_uib_component - Create custom UI components\nsnow_update_uib_component - Update component source & schema\nsnow_discover_uib_components - Browse component library\nsnow_clone_uib_component - Clone & modify existing components\n\n# Data Integration (sys_ux_data_broker)\nsnow_create_uib_data_broker - Connect ServiceNow data sources\nsnow_configure_uib_data_broker - Update queries & caching\n\n# Layout Management (sys_ux_page_element)\nsnow_add_uib_page_element - Add components to pages\nsnow_update_uib_page_element - Update component properties\nsnow_remove_uib_page_element - Remove elements with validation\n\n# Advanced UI Builder Features\nsnow_create_uib_page_registry - Configure URL routing\nsnow_discover_uib_routes - Find all page routes\nsnow_create_uib_client_script - Add client-side scripts\nsnow_create_uib_client_state - Manage page state  \nsnow_create_uib_event - Create custom events\nsnow_analyze_uib_page_performance - Performance analysis\nsnow_validate_uib_page_structure - Structure validation\nsnow_discover_uib_page_usage - Usage analytics\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### \uD83D\uDEA8 MANDATORY Development Workflow\n\n**EVERY development task MUST follow these steps IN ORDER:**\n\n1. **\uD83D\uDD0D DISCOVER MCP TOOLS FIRST** - Search for dedicated tools, NEVER assume local approach\n2. **\uD83D\uDCE6 CREATE UPDATE SET** - `snow_create_update_set` or `snow_ensure_active_update_set`\n3. **\u2705 VERIFY ACTIVE** - Ensure Update Set is current in ServiceNow\n4. **\uD83D\uDEE0\uFE0F USE MCP TOOLS** - `snow_deploy`, `snow_create_*`, `snow_update` (NOT background scripts!)\n5. **\uD83D\uDD0D TEST WITH TOOLS** - `snow_execute_script_with_output` for verification ONLY\n6. **\u2714\uFE0F COMPLETE UPDATE SET** - `snow_complete_update_set` when done\n\n**For Widget Development:**\n1. **\uD83D\uDCE6 CREATE UPDATE SET** (always first!)\n2. **\u2B07\uFE0F PULL ARTIFACT** - `snow_pull_artifact` for debugging\n3. **\u270F\uFE0F EDIT LOCALLY** - Use native search/edit tools\n4. **\u2B06\uFE0F PUSH CHANGES** - `snow_push_artifact` to ServiceNow\n5. **\u2705 VALIDATE** - `snow_check_widget_coherence`\n6. **\u2714\uFE0F COMPLETE UPDATE SET**\n\n**For ServiceNow Artifacts (Business Rules, UI Pages, etc.):**\n1. **\uD83D\uDCE6 CREATE UPDATE SET** (always first!)\n2. **\uD83D\uDEE0\uFE0F USE DEDICATED TOOL** - `snow_create_business_rule`, `snow_create_ui_page`, etc.\n3. **\uD83D\uDD0D TEST** - `snow_execute_script_with_output` for verification\n4. **\u2714\uFE0F COMPLETE UPDATE SET**\n\n## \uD83C\uDFAF Golden Rules\n\n1. **MCP TOOLS FIRST** - Search for dedicated tools BEFORE any local approach\n2. **UPDATE SETS MANDATORY** - Create BEFORE development, complete AFTER\n3. **NO MOCK DATA** - Everything real, complete, production-ready\n4. **ES5 ONLY** - var, function(){}, no modern JS\n5. **VERIFY FIRST** - Test before assuming\n6. **LOCAL SYNC FOR WIDGETS** - Use snow_pull_artifact, NOT snow_query_table\n7. **COMPLETE CODE** - No TODOs, no placeholders\n8. **DEDICATED TOOLS** - Specific tools > Background scripts\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";
+export declare const CLAUDE_MD_TEMPLATE = "# Snow-Flow ServiceNow Development Framework\n\n## \uD83D\uDEA8 CRITICAL: HOW MCP TOOLS WORK IN OPENCODE\n\n**MCP tools are AUTOMATICALLY AVAILABLE - NO bash/npx needed!**\n\n```javascript\n// \u2705 CORRECT - MCP tools are available directly:\nawait snow_create_ui_page({\n  name: \"incident_dashboard\",\n  html: \"<div>...</div>\"\n});\n\nawait snow_create_complete_workspace({\n  workspace_name: \"IT Support\",\n  tables: [\"incident\", \"task\"]\n});\n\n// \u274C WRONG - NEVER use bash to call MCP tools:\n// npx snow-flow-mcp-client servicenow-unified snow_create_ui_page {...}  // DOES NOT EXIST!\n// node ... snow_create_ui_page  // WRONG!\n// Bash('snow_create_ui_page')  // WRONG!\n```\n\n**\uD83D\uDEA8 FORBIDDEN:**\n- Using bash/npx/node to call MCP tools\n- Checking if MCP tools exist with bash commands\n- Using `snow-flow-mcp-client` (DOES NOT EXIST!)\n- Writing scripts to \"call MCP tools\" via CLI\n\n**\u2705 REQUIRED:**\n- Call MCP tools **DIRECTLY** like any other function\n- MCP tools are **automatically loaded** by OpenCode\n- Available tools: All `snow_*` functions listed below\n\n## \uD83D\uDEA8 ABSOLUTE RULES - NO EXCEPTIONS\n\n### \uD83D\uDD34 RULE #0: MCP TOOLS FIRST - NEVER USE LOCAL APPROACHES!\n\n**\u274C WRONG APPROACH (FORBIDDEN):**\n- Writing local scripts to \"test something first\"\n- Using background scripts for complex operations instead of MCP tools\n- Creating files locally \"to prepare before deployment\"\n- Building things locally then deploying to ServiceNow\n- Using generic queries when specific MCP tools exist\n\n**\u2705 CORRECT APPROACH (MANDATORY):**\n- **ALWAYS search for MCP tools FIRST** before doing anything\n- **Use dedicated MCP tools** for every ServiceNow operation\n- **Create directly in ServiceNow** via MCP tools, never locally first\n- **Dedicated tool > Background script** ALWAYS\n\n**Examples:**\n```javascript\n// \u274C WRONG: Using background script for workspace creation\nsnow_execute_background_script({\n  script: \"var gr = new GlideRecord('sys_ux_app_config')...\"\n});\n\n// \u2705 CORRECT: Use dedicated MCP tool\nsnow_create_complete_workspace({\n  workspace_name: \"IT Support Workspace\",\n  tables: [\"incident\", \"task\"]\n});\n\n// \u274C WRONG: Generic query when specific tool exists\nsnow_query_table({ table: 'sp_widget', query: 'sys_id=...' });\n\n// \u2705 CORRECT: Use dedicated widget tool\nsnow_pull_artifact({ sys_id: 'widget_sys_id' });\n```\n\n**MCP Tool Discovery Process:**\n1. **Search**: \"Does a tool exist for [task]?\" (e.g., snow_create_workspace, snow_deploy_widget)\n2. **Check category**: deployment, operations, ui-builder, workspace, automation\n3. **Use dedicated tool**: ALWAYS prefer specific tools over generic ones\n4. **Background scripts**: ONLY for verification, NEVER for development\n\n### \uD83D\uDD34 RULE #1: UPDATE SET WORKFLOW - MANDATORY FOR ALL DEVELOPMENT!\n\n**\uD83D\uDEA8 CRITICAL: EVERY development task MUST follow this workflow:**\n\n```javascript\n// STEP 1: ALWAYS create/ensure active Update Set FIRST (before ANY development)\nconst updateSet = await snow_create_update_set({\n  name: \"Feature: [Descriptive Name]\",  // e.g., \"Feature: Incident Dashboard Widget\"\n  description: \"Complete description of changes\",\n  application: \"global\"  // or specific app scope\n});\n\n// STEP 2: Ensure it's active (Snow-Flow auto-sets as current in ServiceNow!)\nawait snow_ensure_active_update_set({\n  sys_id: updateSet.sys_id\n});\n\n// STEP 3: NOW start development - all changes auto-tracked\nawait snow_deploy({\n  type: 'widget',\n  config: { name: 'incident_dashboard', ... }\n});\n\n// STEP 4: Complete Update Set when done\nawait snow_complete_update_set({\n  sys_id: updateSet.sys_id,\n  state: 'complete'\n});\n```\n\n**\u274C FORBIDDEN WORKFLOW:**\n- Starting development without creating Update Set first\n- Creating artifacts then trying to \"add them to Update Set later\"\n- Assuming changes are being tracked (they're not without active Update Set!)\n- Working across multiple Update Sets for single feature\n\n**\u2705 MANDATORY WORKFLOW:**\n1. **CREATE Update Set** (descriptive name: \"Feature: X\" or \"Fix: Y\")\n2. **ACTIVATE Update Set** (snow_ensure_active_update_set)\n3. **DEVELOP** (all changes auto-tracked in active Update Set)\n4. **COMPLETE Update Set** (mark as complete when done)\n\n**Update Set Best Practices:**\n- **One feature = One Update Set** (clear scope)\n- **Descriptive names**: \"Feature: Incident Auto-Assignment\" not \"Changes\"\n- **Complete description**: What, why, affected tables/components\n- **Always check current**: Use snow_sync_current_update_set if unsure\n\n### \uD83D\uDD34 RULE #2: 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 #3: 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 #4: 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 #5: VERIFY FIRST - Never Assume\nTest before claiming broken. Check resources exist. Validate configurations. Evidence-based fixes only.\n\n## \uD83D\uDD0D TOOL DISCOVERY DECISION TREE - USE THIS EVERY TIME!\n\n**Before doing ANYTHING, follow this decision tree:**\n\n### Step 1: What is the user asking for?\n\n| User Request | Task Category | Go to Step 2 |\n|--------------|---------------|--------------|\n| \"Create workspace/UI/widget/rule/etc.\" | CREATE NEW | \u2192 Create Decision |\n| \"Fix/update/modify existing X\" | UPDATE EXISTING | \u2192 Update Decision |\n| \"Debug/check/test X\" | DEBUG/VERIFY | \u2192 Debug Decision |\n| \"Show/list/find X\" | QUERY DATA | \u2192 Query Decision |\n\n### Step 2: Find the Right Tool\n\n**CREATE NEW Decision:**\n- User wants: \"Create workspace for IT agents\"\n  - Category: Workspace (UX Framework)\n  - Tool: `snow_create_complete_workspace`\n  - REMEMBER: Create Update Set FIRST!\n\n- User wants: \"Create business rule\"\n  - Category: Platform Development\n  - Tool: `snow_create_business_rule`\n  - REMEMBER: Create Update Set FIRST!\n\n- User wants: \"Create widget\"\n  - Category: Deployment\n  - Tool: `snow_deploy` (type: 'widget')\n  - REMEMBER: Create Update Set FIRST!\n\n- User wants: \"Create UI Builder page\"\n  - Category: UI Builder\n  - Tool: `snow_create_uib_page`\n  - REMEMBER: Create Update Set FIRST!\n\n**UPDATE EXISTING Decision:**\n- Updating: Widget\n  - Is it debugging? YES: `snow_pull_artifact` (local sync)\n  - Simple field update? NO: `snow_update` (type: 'widget')\n\n- Updating: Any other artifact\n  - Tool: `snow_update` or `snow_edit_artifact`\n  - REMEMBER: Ensure Update Set is active!\n\n**DEBUG/VERIFY Decision:**\n- Debugging: Widget not working\n  - ALWAYS: `snow_pull_artifact` (get all files locally)\n  - NEVER: `snow_query_table` (token limits!)\n\n- Debugging: Script/rule not working\n  - Tool: `snow_execute_script_with_output` (test the code)\n\n- Verifying: Table/field exists\n  - Tool: `snow_execute_script_with_output` (check with GlideRecord)\n\n**QUERY DATA Decision:**\n- Querying: Widget data\n  - NEVER: `snow_query_table` (use `snow_pull_artifact` instead!)\n\n- Querying: Table data (incidents, users, etc.)\n  - Tool: `snow_query_table` or specific tools (`snow_query_incidents`)\n\n- Querying: Multiple tables\n  - Tool: `snow_batch_api` (80% faster!)\n\n### Step 3: MANDATORY - Update Set Check!\n\n**\uD83D\uDEA8 BEFORE calling ANY development tool, ask yourself:**\n\n- \u2705 Did I create an Update Set? If NO: STOP! Create one first!\n- \u2705 Is the Update Set active? If NO: Call `snow_ensure_active_update_set`!\n- \u2705 Ready to develop? NOW you can call the tool!\n\n**The Update Set Mantra (repeat before EVERY development task):**\n1. CREATE Update Set (`snow_create_update_set`)\n2. ACTIVATE Update Set (`snow_ensure_active_update_set`)\n3. DEVELOP (now all changes are tracked!)\n4. COMPLETE Update Set (`snow_complete_update_set`)\n\n---\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 [MANDATORY FOR ALL DEVELOPMENT!]\n```\nsnow_create_update_set - Create new update set (ALWAYS FIRST STEP!)\nsnow_ensure_active_update_set - Auto-create and activate (sets as current in ServiceNow!)\nsnow_sync_current_update_set - Sync Snow-Flow with user's current Update Set\nsnow_complete_update_set - Mark complete when done\nsnow_export_update_set - Export as XML for deployment\nsnow_preview_update_set - Preview changes before committing\nsnow_list_update_sets - List all update sets\nsnow_get_update_set_changes - View tracked changes\n```\n**\uD83D\uDEA8 CRITICAL:** EVERY development task MUST start with snow_create_update_set or snow_ensure_active_update_set!\n\n**Complete Workflow Example:**\n```javascript\n// 1. CREATE UPDATE SET (before ANY development!)\nconst updateSet = await snow_create_update_set({\n  name: \"Feature: Incident Auto-Assignment\",\n  description: \"Implements automatic incident assignment based on category and location\",\n  application: \"global\"\n});\n\n// 2. ENSURE IT'S ACTIVE (Snow-Flow auto-sets as current in ServiceNow!)\nawait snow_ensure_active_update_set({ sys_id: updateSet.sys_id });\n\n// 3. NOW DEVELOP (all changes auto-tracked)\nawait snow_create_business_rule({\n  name: \"Auto-assign incidents\",\n  table: \"incident\",\n  when: \"before\",\n  active: true,\n  script: \"var assignment = new IncidentAssignment(); assignment.autoAssign(current);\"\n});\n\nawait snow_deploy({\n  type: 'widget',\n  config: { name: 'assignment_dashboard', ... }\n});\n\n// 4. COMPLETE UPDATE SET\nawait snow_complete_update_set({\n  sys_id: updateSet.sys_id,\n  state: 'complete'\n});\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 Native PI + Local ML\n\n**\uD83D\uDEA8 TWO COMPLETELY DIFFERENT ML APPROACHES!**\n\n**\uD83C\uDFE2 Native ServiceNow Predictive Intelligence (NEW! v7.4.0):**\n- Runs INSIDE ServiceNow (requires PI license)\n- Production-ready, auto-retrain, enterprise ML\n- Tools: snow_create_pi_solution, snow_train_pi_solution, snow_monitor_pi_training, snow_activate_pi_solution\n- **ALWAYS ask:** \"Do you have a ServiceNow Predictive Intelligence license?\"\n\n**\uD83D\uDCBB Local TensorFlow.js ML (Experimental):**\n- Runs locally on dev machine (FREE, no license)\n- Development/testing only, NOT for production\n- Tools: ml_train_incident_classifier, ml_predict_change_risk, ml_detect_anomalies\n\n**\uD83D\uDCCB Decision Matrix:**\n| User Says | Has PI License? | Recommend |\n|-----------|----------------|-----------|\n| \"Create incident predictor\" | \u2705 Yes | Native PI: snow_create_pi_solution |\n| \"Create incident predictor\" | \u274C No | Local TensorFlow.js: ml_train_incident_classifier |\n| \"Production ML solution\" | \u2705 Yes | Native PI (always) |\n| \"Production ML solution\" | \u274C No | STOP: Explain PI license required |\n| \"Test/experiment with ML\" | Either | Can use local TensorFlow.js |\n\n**\uD83D\uDEA8 CRITICAL: ALWAYS ask about PI license before recommending ML tools!**\n\n```\n# Native PI Tools (Production):\nsnow_create_pi_solution - Create PI solution definition\nsnow_train_pi_solution - Train model in ServiceNow (10-30 min)\nsnow_monitor_pi_training - Monitor training progress/metrics\nsnow_activate_pi_solution - Activate for production use\nsnow_list_pi_solutions - List all PI solutions\nml_predictive_intelligence - Make predictions (requires trained PI solution)\n\n# Local ML Tools (Dev/Testing Only):\nml_train_incident_classifier - Train LSTM classifier locally\nml_predict_change_risk - Local risk prediction\nml_detect_anomalies - Local anomaly detection\nml_forecast_incidents - Local time series forecast\nml_cluster_similar - Local 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 + UI Builder\n```\n# Flow Designer Tools\nsnow_list_flows - List Flow Designer flows\nsnow_execute_flow - Execute flows programmatically  \nsnow_get_flow_execution_status - Monitor flow status\nsnow_get_flow_execution_history - Flow execution history\nsnow_get_flow_details - Flow configuration details\nsnow_import_flow_from_xml - Import flows from XML\n\n# Agent Workspace Tools  \nsnow_create_workspace - Create agent workspace configurations\nsnow_create_workspace_tab - Add custom workspace tabs\nsnow_create_contextual_panel - Add contextual side panels\nsnow_discover_workspaces - Find all workspace configurations\n\n# Mobile App Tools\nsnow_configure_mobile_app - Configure mobile applications\nsnow_send_push_notification - Send push notifications  \nsnow_configure_offline_sync - Setup offline synchronization\n\n# \uD83C\uDD95 COMPLETE UI BUILDER INTEGRATION (15 NEW TOOLS!)\n# Page Management (sys_ux_page)\nsnow_create_uib_page - Create UI Builder pages with routing\nsnow_update_uib_page - Update page configuration\nsnow_delete_uib_page - Delete pages with dependency validation\nsnow_discover_uib_pages - Find all UI Builder pages\n\n# Component Library (sys_ux_lib_*)  \nsnow_create_uib_component - Create custom UI components\nsnow_update_uib_component - Update component source & schema\nsnow_discover_uib_components - Browse component library\nsnow_clone_uib_component - Clone & modify existing components\n\n# Data Integration (sys_ux_data_broker)\nsnow_create_uib_data_broker - Connect ServiceNow data sources\nsnow_configure_uib_data_broker - Update queries & caching\n\n# Layout Management (sys_ux_page_element)\nsnow_add_uib_page_element - Add components to pages\nsnow_update_uib_page_element - Update component properties\nsnow_remove_uib_page_element - Remove elements with validation\n\n# Advanced UI Builder Features\nsnow_create_uib_page_registry - Configure URL routing\nsnow_discover_uib_routes - Find all page routes\nsnow_create_uib_client_script - Add client-side scripts\nsnow_create_uib_client_state - Manage page state  \nsnow_create_uib_event - Create custom events\nsnow_analyze_uib_page_performance - Performance analysis\nsnow_validate_uib_page_structure - Structure validation\nsnow_discover_uib_page_usage - Usage analytics\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 - Quick Reference\n\n### Widget Work: ALWAYS Local Sync!\n```javascript\n// \u2705 CORRECT\nawait snow_pull_artifact({ sys_id: 'widget_sys_id' });\n// ... edit locally ...\nawait snow_push_artifact({ sys_id: 'widget_sys_id' });\n\n// \u274C WRONG - Token limits!\nawait snow_query_table({ table: 'sp_widget', ... });\n```\n\n### Development: ALWAYS Update Set First!\n```javascript\n// \u2705 CORRECT - Update Set workflow\nconst updateSet = await snow_create_update_set({ name: \"Feature: X\" });\nawait snow_ensure_active_update_set({ sys_id: updateSet.sys_id });\n// ... develop ...\nawait snow_complete_update_set({ sys_id: updateSet.sys_id });\n\n// \u274C WRONG - No Update Set tracking!\nawait snow_create_business_rule({ ... }); // Changes NOT tracked!\n```\n\n### Verification: Use Scripts for Testing Only\n```javascript\n// \u2705 For verification/testing\nawait snow_execute_script_with_output({\n  script: `var gr = new GlideRecord('incident'); gs.info('Exists: ' + gr.isValid());`\n});\n\n// \u274C NOT for development!\nawait snow_execute_background_script({\n  script: `var gr = new GlideRecord('sp_widget'); gr.initialize(); ...` // WRONG!\n});\n```\n\n## \uD83D\uDEA8 THE UNIVERSAL WORKFLOW - MEMORIZE THIS!\n\n**Every task follows this pattern:**\n\n1. **\uD83D\uDCE6 UPDATE SET FIRST** - `snow_create_update_set` \u2192 `snow_ensure_active_update_set`\n2. **\uD83D\uDD0D FIND RIGHT TOOL** - Use Tool Discovery Decision Tree above\n3. **\uD83D\uDEE0\uFE0F USE MCP TOOL** - Call the dedicated tool (NEVER background scripts for development!)\n4. **\u2705 TEST/VERIFY** - Use `snow_execute_script_with_output` for verification only\n5. **\u2714\uFE0F COMPLETE UPDATE SET** - `snow_complete_update_set` when done\n\n**Special Case - Widget Debugging:**\n1. UPDATE SET FIRST\n2. `snow_pull_artifact` (get all files locally)\n3. Edit with native tools\n4. `snow_push_artifact` (push back to ServiceNow)\n5. COMPLETE UPDATE SET\n\n## \uD83C\uDFAF The 4 Absolute Rules\n\n1. **\uD83D\uDD34 UPDATE SETS ALWAYS FIRST** - No development without Update Set tracking!\n2. **\uD83D\uDD34 MCP TOOLS ONLY** - Use dedicated tools, NOT background scripts for development\n3. **\uD83D\uDD34 NO MOCK DATA** - Everything real, complete, production-ready (no TODOs, no placeholders)\n4. **\uD83D\uDD34 ES5 JAVASCRIPT ONLY** - var, function(){}, string concatenation (ServiceNow Rhino engine)\n\n## \uD83D\uDCCA Quick Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| Widget doesn't work | `snow_pull_artifact` + debug locally |\n| Forgot Update Set | `snow_create_update_set` \u2192 `snow_ensure_active_update_set` |\n| Syntax error in script | Check ES5! No const/let/arrows/template literals |\n| Widget too large | Use `snow_pull_artifact`, NOT `snow_query_table` |\n| Need to test code | `snow_execute_script_with_output` (verification only!) |\n\n---\n\n**\uD83D\uDEA8 FINAL REMINDER: Update Sets are MANDATORY. MCP Tools are AUTOMATICALLY available. NO Mock Data. ES5 Only.**";
+export declare const CLAUDE_MD_TEMPLATE_VERSION = "8.1.5-OPTIMIZED";
 //# sourceMappingURL=claude-md-template.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"claude-md-template.d.ts","sourceRoot":"","sources":["../../src/templates/claude-md-template.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,unvBA6mBoC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,uBAAuB,CAAC"}
+{"version":3,"file":"claude-md-template.d.ts","sourceRoot":"","sources":["../../src/templates/claude-md-template.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,o/vBA2mBkF,CAAC;AAElH,eAAO,MAAM,0BAA0B,oBAAoB,CAAC"}

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

@@ -156,6 +156,88 @@ snow_pull_artifact({ sys_id: 'widget_sys_id' })
 ### Rule #5: VERIFY FIRST - Never Assume
 Test before claiming broken. Check resources exist. Validate configurations. Evidence-based fixes only.
 
+## 🔍 TOOL DISCOVERY DECISION TREE - USE THIS EVERY TIME!
+
+**Before doing ANYTHING, follow this decision tree:**
+
+### Step 1: What is the user asking for?
+
+| User Request | Task Category | Go to Step 2 |
+|--------------|---------------|--------------|
+| "Create workspace/UI/widget/rule/etc." | CREATE NEW | → Create Decision |
+| "Fix/update/modify existing X" | UPDATE EXISTING | → Update Decision |
+| "Debug/check/test X" | DEBUG/VERIFY | → Debug Decision |
+| "Show/list/find X" | QUERY DATA | → Query Decision |
+
+### Step 2: Find the Right Tool
+
+**CREATE NEW Decision:**
+- User wants: "Create workspace for IT agents"
+  - Category: Workspace (UX Framework)
+  - Tool: \`snow_create_complete_workspace\`
+  - REMEMBER: Create Update Set FIRST!
+
+- User wants: "Create business rule"
+  - Category: Platform Development
+  - Tool: \`snow_create_business_rule\`
+  - REMEMBER: Create Update Set FIRST!
+
+- User wants: "Create widget"
+  - Category: Deployment
+  - Tool: \`snow_deploy\` (type: 'widget')
+  - REMEMBER: Create Update Set FIRST!
+
+- User wants: "Create UI Builder page"
+  - Category: UI Builder
+  - Tool: \`snow_create_uib_page\`
+  - REMEMBER: Create Update Set FIRST!
+
+**UPDATE EXISTING Decision:**
+- Updating: Widget
+  - Is it debugging? YES: \`snow_pull_artifact\` (local sync)
+  - Simple field update? NO: \`snow_update\` (type: 'widget')
+
+- Updating: Any other artifact
+  - Tool: \`snow_update\` or \`snow_edit_artifact\`
+  - REMEMBER: Ensure Update Set is active!
+
+**DEBUG/VERIFY Decision:**
+- Debugging: Widget not working
+  - ALWAYS: \`snow_pull_artifact\` (get all files locally)
+  - NEVER: \`snow_query_table\` (token limits!)
+
+- Debugging: Script/rule not working
+  - Tool: \`snow_execute_script_with_output\` (test the code)
+
+- Verifying: Table/field exists
+  - Tool: \`snow_execute_script_with_output\` (check with GlideRecord)
+
+**QUERY DATA Decision:**
+- Querying: Widget data
+  - NEVER: \`snow_query_table\` (use \`snow_pull_artifact\` instead!)
+
+- Querying: Table data (incidents, users, etc.)
+  - Tool: \`snow_query_table\` or specific tools (\`snow_query_incidents\`)
+
+- Querying: Multiple tables
+  - Tool: \`snow_batch_api\` (80% faster!)
+
+### Step 3: MANDATORY - Update Set Check!
+
+**🚨 BEFORE calling ANY development tool, ask yourself:**
+
+- ✅ Did I create an Update Set? If NO: STOP! Create one first!
+- ✅ Is the Update Set active? If NO: Call \`snow_ensure_active_update_set\`!
+- ✅ Ready to develop? NOW you can call the tool!
+
+**The Update Set Mantra (repeat before EVERY development task):**
+1. CREATE Update Set (\`snow_create_update_set\`)
+2. ACTIVATE Update Set (\`snow_ensure_active_update_set\`)
+3. DEVELOP (now all changes are tracked!)
+4. COMPLETE Update Set (\`snow_complete_update_set\`)
+
+---
+
 ## 📋 MCP SERVERS & TOOLS (18 Servers, 200+ Tools)
 
 ### 1. **servicenow-local-development** 🔧 Widget/Artifact Sync [USE THIS FOR WIDGETS!]
@@ -464,164 +546,80 @@ memory_search - Search persistent memory
 neural_train - Train neural networks
 \`\`\`
 
-## 🔄 Critical Workflows
+## 🔄 Critical Workflows - Quick Reference
 
-### Widget Debugging (ALWAYS use Local Sync!)
+### Widget Work: ALWAYS Local Sync!
 \`\`\`javascript
-// ✅ CORRECT - Local sync for debugging
+// ✅ CORRECT
 await snow_pull_artifact({ sys_id: 'widget_sys_id' });
-// Edit with native tools (search, multi-file, etc.)
+// ... edit locally ...
 await snow_push_artifact({ sys_id: 'widget_sys_id' });
 
-// ❌ WRONG - Token limit explosion
-await snow_query_table({ table: 'sp_widget', query: 'sys_id=...' });
+// ❌ WRONG - Token limits!
+await snow_query_table({ table: 'sp_widget', ... });
 \`\`\`
 
-### Verification Pattern
+### Development: ALWAYS Update Set First!
 \`\`\`javascript
-// Always verify with REAL data, not placeholders
-await snow_execute_script_with_output({
-  script: \`
-    var gr = new GlideRecord('incident');
-    gr.addQuery('active', true);
-    gr.query();
-    gs.info('Found: ' + gr.getRowCount() + ' active incidents');
-    
-    // Test actual property
-    var prop = gs.getProperty('instance_name');
-    gs.info('Instance: ' + prop);
-  \`
-});
+// ✅ CORRECT - Update Set workflow
+const updateSet = await snow_create_update_set({ name: "Feature: X" });
+await snow_ensure_active_update_set({ sys_id: updateSet.sys_id });
+// ... develop ...
+await snow_complete_update_set({ sys_id: updateSet.sys_id });
+
+// ❌ WRONG - No Update Set tracking!
+await snow_create_business_rule({ ... }); // Changes NOT tracked!
 \`\`\`
 
-### Complete Widget Creation (NO PLACEHOLDERS)
+### Verification: Use Scripts for Testing Only
 \`\`\`javascript
-await snow_deploy({
-  type: 'widget',
-  config: {
-    name: 'my_widget',
-    title: 'Production Widget',
-    template: '<div ng-repeat="item in data.items">{{item.name}}</div>',
-    script: \`
-      (function() {
-        data.items = [];
-        var gr = new GlideRecord('incident');
-        gr.addQuery('active', true);
-        gr.setLimit(10);
-        gr.query();
-        while (gr.next()) {
-          data.items.push({
-            name: gr.getDisplayValue('number'),
-            description: gr.getDisplayValue('short_description')
-          });
-        }
-      })();
-    \`,
-    client_script: \`
-      function($scope) {
-        var c = this;
-        c.refresh = function() {
-          c.server.get().then(function(r) {
-            console.log('Refreshed');
-          });
-        };
-      }
-    \`
-  }
+// ✅ For verification/testing
+await snow_execute_script_with_output({
+  script: \`var gr = new GlideRecord('incident'); gs.info('Exists: ' + gr.isValid());\`
 });
-\`\`\`
 
-### 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
-    }
-  ]
+// ❌ NOT for development!
+await snow_execute_background_script({
+  script: \`var gr = new GlideRecord('sp_widget'); gr.initialize(); ...\` // WRONG!
 });
-// 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
-- \`snow-flow init\` - Initialize project with this CLAUDE.md
-- \`snow-flow auth login\` - Authenticate with ServiceNow
-- \`snow-flow status\` - System status
-- \`snow-flow swarm "<task>"\` - Multi-agent coordination
-
-### 🚨 MANDATORY Development Workflow
-
-**EVERY development task MUST follow these steps IN ORDER:**
-
-1. **🔍 DISCOVER MCP TOOLS FIRST** - Search for dedicated tools, NEVER assume local approach
-2. **📦 CREATE UPDATE SET** - \`snow_create_update_set\` or \`snow_ensure_active_update_set\`
-3. **✅ VERIFY ACTIVE** - Ensure Update Set is current in ServiceNow
-4. **🛠️ USE MCP TOOLS** - \`snow_deploy\`, \`snow_create_*\`, \`snow_update\` (NOT background scripts!)
-5. **🔍 TEST WITH TOOLS** - \`snow_execute_script_with_output\` for verification ONLY
-6. **✔️ COMPLETE UPDATE SET** - \`snow_complete_update_set\` when done
-
-**For Widget Development:**
-1. **📦 CREATE UPDATE SET** (always first!)
-2. **⬇️ PULL ARTIFACT** - \`snow_pull_artifact\` for debugging
-3. **✏️ EDIT LOCALLY** - Use native search/edit tools
-4. **⬆️ PUSH CHANGES** - \`snow_push_artifact\` to ServiceNow
-5. **✅ VALIDATE** - \`snow_check_widget_coherence\`
-6. **✔️ COMPLETE UPDATE SET**
-
-**For ServiceNow Artifacts (Business Rules, UI Pages, etc.):**
-1. **📦 CREATE UPDATE SET** (always first!)
-2. **🛠️ USE DEDICATED TOOL** - \`snow_create_business_rule\`, \`snow_create_ui_page\`, etc.
-3. **🔍 TEST** - \`snow_execute_script_with_output\` for verification
-4. **✔️ COMPLETE UPDATE SET**
-
-## 🎯 Golden Rules
-
-1. **MCP TOOLS FIRST** - Search for dedicated tools BEFORE any local approach
-2. **UPDATE SETS MANDATORY** - Create BEFORE development, complete AFTER
-3. **NO MOCK DATA** - Everything real, complete, production-ready
-4. **ES5 ONLY** - var, function(){}, no modern JS
-5. **VERIFY FIRST** - Test before assuming
-6. **LOCAL SYNC FOR WIDGETS** - Use snow_pull_artifact, NOT snow_query_table
-7. **COMPLETE CODE** - No TODOs, no placeholders
-8. **DEDICATED TOOLS** - Specific tools > Background scripts
-
-## 📊 Quick Reference
-
-| Issue | Solution |
-|-------|----------|
-| Widget doesn't work | \`snow_pull_artifact\` → debug locally |
-| Script syntax error | ES5 only! var, function(){} |
-| Can't find table | \`snow_discover_table_fields\` |
-| Property missing | \`snow_property_manager\` |
-| Need to test | \`snow_execute_script_with_output\` |
-| Deployment failed | \`snow_rollback_deployment\` |
-
-Remember: TAKE THE TIME. DO IT RIGHT. NO MOCK DATA. NO EXCEPTIONS.`;
-exports.CLAUDE_MD_TEMPLATE_VERSION = '3.6.2-CONSOLIDATED';
+\`\`\`
+
+## 🚨 THE UNIVERSAL WORKFLOW - MEMORIZE THIS!
+
+**Every task follows this pattern:**
+
+1. **📦 UPDATE SET FIRST** - \`snow_create_update_set\` → \`snow_ensure_active_update_set\`
+2. **🔍 FIND RIGHT TOOL** - Use Tool Discovery Decision Tree above
+3. **🛠️ USE MCP TOOL** - Call the dedicated tool (NEVER background scripts for development!)
+4. **✅ TEST/VERIFY** - Use \`snow_execute_script_with_output\` for verification only
+5. **✔️ COMPLETE UPDATE SET** - \`snow_complete_update_set\` when done
+
+**Special Case - Widget Debugging:**
+1. UPDATE SET FIRST
+2. \`snow_pull_artifact\` (get all files locally)
+3. Edit with native tools
+4. \`snow_push_artifact\` (push back to ServiceNow)
+5. COMPLETE UPDATE SET
+
+## 🎯 The 4 Absolute Rules
+
+1. **🔴 UPDATE SETS ALWAYS FIRST** - No development without Update Set tracking!
+2. **🔴 MCP TOOLS ONLY** - Use dedicated tools, NOT background scripts for development
+3. **🔴 NO MOCK DATA** - Everything real, complete, production-ready (no TODOs, no placeholders)
+4. **🔴 ES5 JAVASCRIPT ONLY** - var, function(){}, string concatenation (ServiceNow Rhino engine)
+
+## 📊 Quick Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| Widget doesn't work | \`snow_pull_artifact\` + debug locally |
+| Forgot Update Set | \`snow_create_update_set\` → \`snow_ensure_active_update_set\` |
+| Syntax error in script | Check ES5! No const/let/arrows/template literals |
+| Widget too large | Use \`snow_pull_artifact\`, NOT \`snow_query_table\` |
+| Need to test code | \`snow_execute_script_with_output\` (verification only!) |
+
+---
+
+**🚨 FINAL REMINDER: Update Sets are MANDATORY. MCP Tools are AUTOMATICALLY available. NO Mock Data. ES5 Only.**`;
+exports.CLAUDE_MD_TEMPLATE_VERSION = '8.1.5-OPTIMIZED';
 //# sourceMappingURL=claude-md-template.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"claude-md-template.js","sourceRoot":"","sources":["../../src/templates/claude-md-template.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mEA6mBiC,CAAC;AAEvD,QAAA,0BAA0B,GAAG,oBAAoB,CAAC"}
+{"version":3,"file":"claude-md-template.js","sourceRoot":"","sources":["../../src/templates/claude-md-template.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iHA2mB+E,CAAC;AAErG,QAAA,0BAA0B,GAAG,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "8.1.4",
+  "version": "8.1.5",
   "description": "ServiceNow development with OpenCode - 75+ LLM providers (Claude, GPT, Gemini, Llama, Mistral, DeepSeek, Groq, Ollama) • 416 Tools • 2 MCP Servers • Native Predictive Intelligence builder • Multi-agent orchestration • Use ANY AI coding assistant",
   "main": "dist/index.js",
   "type": "commonjs",