snow-flow 3.4.6 → 3.4.7

package/dist/cli.js

@@ -2183,455 +2183,10 @@ async function copyCLAUDEmd(targetDir, force = false) {
             }
         }
         if (!foundSource) {
-            // Use Snow-Flow specific CLAUDE.md content
-            console.log('⚠️  Could not find CLAUDE.md source, creating minimal version');
-            claudeMdContent = `# Snow-Flow Development with Claude Code
-
-## 🚨 CRITICAL: MCP-FIRST WORKFLOW (READ THIS FIRST!)
-
-**Snow-flow's core value is REAL ServiceNow integration through MCP tools. NEVER work in offline mode!**
-
-### ⚠️ MANDATORY WORKFLOW - NO EXCEPTIONS
-
-**Every ServiceNow task MUST start with this sequence:**
-
-\`\`\`javascript
-// 1. MANDATORY: Pre-flight authentication check
-const authCheck = await snow_validate_live_connection({ test_level: "permissions" });
-if (!authCheck.success) {
-  // STOP! Fix authentication first
-  return authenticationError(authCheck.error);
-}
-
-// 2. MANDATORY: Discovery before creation
-const discovery = await snow_find_artifact({ 
-  query: "your objective",
-  type: "widget|flow|script|any" 
-});
-
-// 3. MANDATORY: Real ServiceNow deployment
-const deployment = await snow_deploy({
-  type: "widget|application",  // Note: flow removed in v1.4.0+
-  config: { /* your config */ },
-  auto_update_set: true  // Always track changes
-});
-
-// 4. MANDATORY: Track in Update Set
-await snow_update_set_add_artifact({
-  type: deployment.type,
-  sys_id: deployment.result.sys_id,
-  name: deployment.result.name
-});
-\`\`\`
-
-### 🚫 FORBIDDEN ACTIONS
-
-**THESE ACTIONS ARE BANNED - NEVER DO THESE:**
-
-❌ **Creating local files** without MCP check first  
-❌ **Generating mock data** instead of using MCP tools  
-❌ **Working in "offline mode"** when ServiceNow is available  
-❌ **Skipping authentication validation**  
-❌ **Planning mode** without trying MCP tools first
-
-### ✅ CORRECT: MCP-First Decision Tree
-
-\`\`\`
-User Request → ALWAYS START HERE:
-    ↓
-1. snow_validate_live_connection()
-    ↓
-   SUCCESS? → Continue to Step 2
-    ↓
-   FAILURE? → Fix auth: snow_auth_diagnostics()
-              Then guide user: "snow-flow auth login"
-              STOP until auth works
-    ↓
-2. snow_find_artifact() // Check if exists
-    ↓
-   FOUND? → Ask: "Reuse existing or create new?"
-    ↓
-   NOT FOUND? → Continue to Step 3
-    ↓
-3. snow_deploy() // Real deployment to ServiceNow
-    ↓
-   SUCCESS? → Step 4: Track in Update Set
-    ↓
-   FAILURE? → Use fallback strategies
-    ↓
-4. snow_update_set_add_artifact() // Always track
-    ↓
-   DONE! ✅
-\`\`\`
-
-## 🚀 Snow-Flow Swarm Command - MCP-Orchestrated Multi-Agent Intelligence
-
-**The Swarm system is MCP-native and ALWAYS uses ServiceNow tools first!**
-
-### 🧠 Queen Agent with Parallel Execution (v1.4.0+)
-- Automatically spawns 6+ specialized agents for widget development
-- Achieves proven 2.8x speedup through intelligent parallel execution
-- All agents coordinate through Snow-Flow's memory system
-- Every agent uses MCP tools directly - no offline mode
-
-## 🛠️ Complete ServiceNow MCP Tools Reference
-
-### Discovery & Search Tools
-\`\`\`javascript
-// Find any ServiceNow artifact using natural language
-snow_find_artifact({
-  query: "the widget that shows incidents on homepage",
-  type: "widget" // or "flow", "script", "application", "any"
-});
-
-// Search catalog items with fuzzy matching
-snow_catalog_item_search({
-  query: "laptop",
-  fuzzy_match: true,        // Finds variations: notebook, MacBook, etc.
-  category_filter: "hardware",
-  include_variables: true   // Get catalog variables too
-});
-
-// Direct sys_id lookup (faster than search)
-snow_get_by_sysid({
-  sys_id: "<artifact_sys_id>",
-  table: "sp_widget"
-});
-\`\`\`
-
-### Flow Development Tools
-\`\`\`javascript
-// Create flows from natural language
-snow_create_flow({
-  instruction: "create a flow that sends email when incident priority is high",
-  deploy_immediately: true  // Automatically deploys XML to ServiceNow
-});
-
-// Test flows with mock data
-snow_test_flow_with_mock({
-  flow_id: "incident_notification_flow",
-  create_test_user: true,
-  mock_catalog_items: true,
-  test_inputs: {
-    priority: "1",
-    category: "hardware"
-  },
-  simulate_approvals: true
-});
-
-// Link catalog items to flows
-snow_link_catalog_to_flow({
-  catalog_item_id: "New Laptop Request",
-  flow_id: "laptop_provisioning_flow",
-  link_type: "flow_catalog_process",
-  variable_mapping: [
-    {
-      catalog_variable: "laptop_model",
-      flow_input: "equipment_type"
-    }
-  ]
-});
-\`\`\`
-
-### Widget Development Tools
-\`\`\`javascript
-// Deploy widgets with automatic validation
-snow_deploy_widget({
-  name: "incident_dashboard",
-  title: "Incident Dashboard",
-  template: htmlContent,
-  css: cssContent,
-  client_script: clientJS,
-  server_script: serverJS,
-  demo_data: { incidents: [...] }
-});
-
-// Preview and test widgets
-snow_preview_widget({
-  widget_id: "incident_dashboard",
-  check_dependencies: true
-});
-
-snow_widget_test({
-  widget_id: "incident_dashboard",
-  test_scenarios: [
-    {
-      name: "Load with no data",
-      server_data: { incidents: [] }
-    }
-  ]
-});
-\`\`\`
-
-### Bulk Operations
-\`\`\`javascript
-// Deploy multiple artifacts at once
-snow_bulk_deploy({
-  artifacts: [
-    { type: "widget", data: widgetData },
-    { type: "flow", data: flowData },
-    { type: "script", data: scriptData }
-  ],
-  transaction_mode: true,     // All or nothing
-  parallel: true,            // Deploy simultaneously
-  dry_run: false
-});
-\`\`\`
-
-### Intelligent Analysis
-\`\`\`javascript
-// Analyze incidents with AI
-snow_analyze_incident({
-  incident_id: "INC0010001",
-  include_similar: true,
-  suggest_resolution: true
-});
-
-// Pattern analysis
-snow_pattern__analysis({
-  analysis_type: "incident_patterns",
-  timeframe: "month"
-});
-\`\`\`
-
-## ⚡ Performance Optimization
-
-### Parallel Execution Patterns
-\`\`\`javascript
-// Execute multiple searches concurrently
-Promise.all([
-  snow_find_artifact({ query: "incident widget" }),
-  snow_catalog_item_search({ query: "laptop" }),
-  snow_query_table({ table: "incident", query: "priority=1" })  // Universal query tool
-]);
-\`\`\`
-
-### Batch File Operations
-\`\`\`javascript
-// Read multiple files in one operation
-MultiRead([
-  "/path/to/widget.html",
-  "/path/to/widget.css",
-  "/path/to/widget.js"
-]);
-\`\`\`
-
-## 📝 Workflow Guidelines
-
-### Standard Development Flow
-1. **Discovery Phase**: Use search tools to find existing artifacts
-2. **Planning Phase**: Use TodoWrite to plan all tasks
-3. **Development Phase**: Launch agents concurrently
-4. **Testing Phase**: Use mock testing tools
-5. **Deployment Phase**: Use bulk deploy with validation
-
-### Error Recovery Patterns
-\`\`\`javascript
-// Always implement rollback strategies
-if (deployment.failed) {
-  snow_deployment_rollback_manager({
-    update_set_id: deployment.update_set,
-    restore_point: deployment.backup_id
-  });
-}
-\`\`\`
-
-## 🔧 Advanced Configuration
-
-## Build Commands
-- \`npm run build\`: Build the project
-- \`npm run test\`: Run the full test suite
-- \`npm run lint\`: Run ESLint and format checks
-- \`npm run typecheck\`: Run TypeScript type checking
-
-## Snow-Flow Commands
-- \`snow-flow init\`: Initialize project with MCP servers and SPARC environment and SPARC environment
-- \`snow-flow auth login\`: Authenticate with ServiceNow OAuth
-- \`snow-flow swarm "<objective>"\`: Start multi-agent swarm - één command voor alles!
-- \`snow-flow sparc <mode> "<task>"\`: Run specific SPARC mode
-
-## Enhanced Swarm Command (v1.1.41+)
-The swarm command now includes intelligent features that are **enabled by default**:
-
-\`\`\`bash
-# Simple usage - ALL autonomous systems enabled by default!
-snow-flow swarm "create incident management dashboard"
-
-# Disable specific autonomous systems if needed
-snow-flow swarm "create simple widget" --no-autonomous-cost-optimization --no-autonomous-compliance
-
-# Disable ALL autonomous systems
-snow-flow swarm "basic development only" --no-autonomous-all
-
-# Force enable all (overrides any --no- flags)
-snow-flow swarm "full orchestration mode" --autonomous-all
-\`\`\`
-
-### 🤖 NEW: Autonomous Systems (v1.3.26+) - **ENABLED BY DEFAULT!**
-True orchestration with zero manual intervention - all systems active unless disabled:
-
-- ✅ **Documentation**: Self-documenting system (auto-generates and updates docs)
-- ✅ **Cost Optimization**: AI-driven cost management with auto-optimization  
-- ✅ **Compliance**: Multi-framework compliance monitoring with auto-remediation
-- ✅ **Self-Healing**: Predictive failure detection with automatic recovery
-
-**Disable Options**:
-- \`--no-autonomous-documentation\`: Disable documentation system
-- \`--no-autonomous-cost-optimization\`: Disable cost optimization
-- \`--no-autonomous-compliance\`: Disable compliance monitoring
-- \`--no-autonomous-healing\`: Disable self-healing
-- \`--no-autonomous-all\`: Disable ALL autonomous systems
-
-**Force Options**:
-- \`--autonomous-all\`: Force enable all (overrides --no- flags)
-
-**Perfect Orchestrator**: Systems work autonomously, make intelligent decisions, and continuously improve - no manual intervention needed!
-
-### Default Settings (no flags needed):
-- ✅ \`--smart-discovery\` - Automatically discovers and reuses existing artifacts
-- ✅ \`--live-testing\` - Tests in real-time on your ServiceNow instance
-- ✅ \`--auto-deploy\` - Deploys automatically (safe with update sets)
-- ✅ \`--auto-rollback\` - Automatically rollbacks on failures
-- ✅ \`--shared-memory\` - All agents share context and coordination
-- ✅ \`--progress-monitoring\` - Real-time progress tracking
-- ❌ \`--auto-permissions\` - Disabled by default (enable with flag for automatic role elevation)
-
-### Advanced Usage:
-\`\`\`bash
-# Enable automatic permission escalation
-snow-flow swarm "create global workflow" --auto-permissions
-
-# Disable specific features
-snow-flow swarm "test widget" --no-auto-deploy --no-live-testing
-
-# Full control
-snow-flow swarm "complex integration" \\
-  --max-agents 8 \\
-  --strategy development \\
-  --mode distributed \\
-  --parallel \\
-  --auto-permissions
-\`\`\`
-
-## New MCP Tools (v1.1.44+)
-
-### Catalog Item Search
-Find catalog items with intelligent fuzzy matching:
-\`\`\`javascript
-snow_catalog_item_search({
-  query: "iPhone",          // Will find iPhone 6S, iPhone 7, etc.
-  fuzzy_match: true,        // Enable intelligent variations
-  include_variables: true   // Include catalog variables
-})
-\`\`\`
-
-### Flow Testing with Mock Data
-Test flows without real data:
-\`\`\`javascript
-snow_test_flow_with_mock({
-  flow_id: "equipment_provisioning_flow",
-  create_test_user: true,      // Creates test user
-  mock_catalog_items: true,    // Creates test catalog items
-  simulate_approvals: true,    // Auto-approves during test
-  cleanup_after_test: true     // Removes test data after
-})
-\`\`\`
-
-### Direct Catalog-Flow Linking
-Link catalog items directly to flows:
-\`\`\`javascript
-snow_link_catalog_to_flow({
-  catalog_item_id: "iPhone 6S",
-  flow_id: "mobile_provisioning_flow",
-  link_type: "flow_catalog_process",  // Modern approach
-  variable_mapping: [
-    {
-      catalog_variable: "phone_model",
-      flow_input: "device_type"
-    }
-  ],
-  test_link: true  // Creates test request
-})
-\`\`\`
-
-### OAuth Configuration
-\`\`\`env
-# .env file
-SNOW_INSTANCE=dev123456
-SNOW_CLIENT_ID=your_oauth_client_id
-SNOW_CLIENT_SECRET=your_oauth_client_secret
-SNOW_USERNAME=admin
-SNOW_PASSWORD=admin_password
-\`\`\`
-
-### Update Set Management
-\`\`\`javascript
-// Smart update set creation
-snow_smart_update_set({
-  name: "Auto-generated for widget development",
-  detect_context: true,  // Auto-detects what you're working on
-  auto_switch: true     // Switches when context changes
-});
-\`\`\`
-
-## 🎯 Quick Start
-1. \`snow-flow init\` - Initialize project with MCP servers and SPARC environment and SPARC environment
-2. Configure ServiceNow credentials in .env file
-3. \`snow-flow auth login\` - Authenticate with ServiceNow OAuth
-4. \`snow-flow swarm "create a widget for incident management"\` - Everything automatic!
-
-## 💡 Important Notes
-
-### Do's
-- ✅ Use TodoWrite extensively for task tracking
-- ✅ Batch MCP tool calls for performance
-- ✅ Store important data in Memory for coordination
-- ✅ Test with mock data before deploying
-- ✅ Work within Update Sets for safety
-- ✅ Use fuzzy search for finding artifacts
-
-### Don'ts
-- ❌ Don't make sequential tool calls when batch is possible
-- ❌ Don't hardcode credentials or sys_ids
-- ❌ Don't deploy without testing
-- ❌ Don't ignore OAuth permission errors
-- ❌ Don't create artifacts without checking if they exist
-
-## 🚀 Performance Benchmarks
-
-With concurrent execution and batch operations:
-- **Widget Development**: 3x faster than sequential
-- **Flow Creation**: 2.5x faster with parallel validation
-- **Bulk Deployment**: Up to 5x faster with parallel mode
-- **Search Operations**: 4x faster with concurrent queries
-
-## 📚 Additional Resources
-
-### MCP Server Documentation
-- **servicenow-deployment**: Widget, flow, and application deployment
-- **servicenow-intelligent**: Smart search and artifact discovery
-- **servicenow-operations**: Incident management and catalog operations
-- **servicenow-platform-development**: Scripts, rules, and policies
-
-### SPARC Modes
-- \`orchestrator\`: Coordinates complex multi-step tasks
-- \`coder\`: Focused code implementation
-- \`researcher\`: Deep _analysis and discovery
-- \`tester\`: Comprehensive testing strategies
-- \`architect\`: System design and architecture
-
----
-
-This is a minimal CLAUDE.md file. The full documentation should be available in your Snow-Flow installation.
-
-## Quick Start
-1. \`snow-flow init\` - Initialize project with MCP servers and SPARC environment and SPARC environment
-2. Configure ServiceNow credentials in .env file  
-3. \`snow-flow auth login\` - Authenticate with ServiceNow OAuth
-4. \`snow-flow swarm "create a widget for incident management"\` - Everything automatic!
-
-For full documentation, visit: https://github.com/groeimetai/snow-flow
-`;
+            // Import the template from the dedicated file
+            const { CLAUDE_MD_TEMPLATE } = await Promise.resolve().then(() => __importStar(require('./templates/claude-md-template.js')));
+            claudeMdContent = CLAUDE_MD_TEMPLATE;
+            console.log('✅ Using built-in CLAUDE.md template');
         }
         const claudeMdPath = (0, path_1.join)(targetDir, 'CLAUDE.md');
         try {
@@ -2650,273 +2205,11 @@ For full documentation, visit: https://github.com/groeimetai/snow-flow
     }
     catch (error) {
         console.log('⚠️  Error copying CLAUDE.md, creating Snow-Flow specific version');
-        // Snow-Flow specific fallback content
-        const claudeMdFallback = `# Snow-Flow Development with Claude Code
-
-## 🚨 CRITICAL: MCP-FIRST WORKFLOW (READ THIS FIRST!)
-
-**Snow-flow's core value is REAL ServiceNow integration through MCP tools. NEVER work in offline mode!**
-
-### ⚠️ MANDATORY WORKFLOW - NO EXCEPTIONS
-
-**Every ServiceNow task MUST start with this sequence:**
-
-\`\`\`javascript
-// 1. MANDATORY: Pre-flight authentication check
-const authCheck = await snow_validate_live_connection({ test_level: "permissions" });
-if (!authCheck.success) {
-  // STOP! Fix authentication first
-  return authenticationError(authCheck.error);
-}
-
-// 2. MANDATORY: Discovery before creation
-const discovery = await snow_find_artifact({ 
-  query: "your objective",
-  type: "widget|flow|script|any" 
-});
-
-// 3. MANDATORY: Real ServiceNow deployment
-const deployment = await snow_deploy({
-  type: "widget|application",  // Note: flow removed in v1.4.0+
-  config: { /* your config */ },
-  auto_update_set: true  // Always track changes
-});
-
-// 4. MANDATORY: Track in Update Set
-await snow_update_set_add_artifact({
-  type: deployment.type,
-  sys_id: deployment.result.sys_id,
-  name: deployment.result.name
-});
-\`\`\`
-
-### 🚫 FORBIDDEN ACTIONS
-
-**THESE ACTIONS ARE BANNED - NEVER DO THESE:**
-
-❌ **Creating local files** without MCP check first  
-❌ **Generating mock data** instead of using MCP tools  
-❌ **Working in "offline mode"** when ServiceNow is available  
-❌ **Skipping authentication validation**  
-❌ **Planning mode** without trying MCP tools first
-
-### ✅ CORRECT: MCP-First Decision Tree
-
-\`\`\`
-User Request → ALWAYS START HERE:
-    ↓
-1. snow_validate_live_connection()
-    ↓
-   SUCCESS? → Continue to Step 2
-    ↓
-   FAILURE? → Fix auth: snow_auth_diagnostics()
-              Then guide user: "snow-flow auth login"
-              STOP until auth works
-    ↓
-2. snow_find_artifact() // Check if exists
-    ↓
-   FOUND? → Ask: "Reuse existing or create new?"
-    ↓
-   NOT FOUND? → Continue to Step 3
-    ↓
-3. snow_deploy() // Real deployment to ServiceNow
-    ↓
-   SUCCESS? → Step 4: Track in Update Set
-    ↓
-   FAILURE? → Use fallback strategies
-    ↓
-4. snow_update_set_add_artifact() // Always track
-    ↓
-   DONE! ✅
-\`\`\`
-
-## 🚀 Snow-Flow Swarm Command - MCP-Orchestrated Multi-Agent Intelligence
-
-**The Swarm system is MCP-native and ALWAYS uses ServiceNow tools first!**
-
-### 🧠 Queen Agent with Parallel Execution (v1.4.0+)
-- Automatically spawns 6+ specialized agents for widget development
-- Achieves proven 2.8x speedup through intelligent parallel execution
-- All agents coordinate through Snow-Flow's memory system
-- Every agent uses MCP tools directly - no offline mode
-
-### Swarm Command Examples
-\`\`\`bash
-# Simple widget creation
-snow-flow swarm "create incident dashboard widget"
-
-# Complex development
-snow-flow swarm "build employee onboarding portal with approval workflows"
-
-# With specific options
-snow-flow swarm "create service catalog item" --no-auto-deploy --monitor
-\`\`\`
-
-## 🛠️ Complete ServiceNow MCP Tools Reference
-
-### Discovery & Search Tools
-\`\`\`javascript
-// Find any ServiceNow artifact using natural language
-snow_find_artifact({
-  query: "the widget that shows incidents on homepage",
-  type: "widget" // or "flow", "script", "application", "any"
-});
-
-// Search catalog items with fuzzy matching
-snow_catalog_item_search({
-  query: "laptop",
-  fuzzy_match: true,        // Finds variations: notebook, MacBook, etc.
-  include_variables: true   // Include catalog variables
-});
-
-// Comprehensive search across all tables
-snow_comprehensive_search({
-  query: "approval",
-  include_inactive: false
-});
-\`\`\`
-
-### Deployment Tools
-\`\`\`javascript
-// Universal deployment tool
-snow_deploy({
-  type: "widget",
-  config: {
-    name: "Incident Dashboard",
-    template: "<html>...</html>",
-    css: "/* styles */",
-    server_script: "// server code",
-    client_script: "// client code"
-  },
-  auto_update_set: true
-});
-
-// Bulk deployment
-snow_bulk_deploy({
-  artifacts: [...],
-  transaction_mode: true,
-  rollback_on_error: true
-});
-\`\`\`
-
-### Update Set Management
-\`\`\`javascript
-// Ensure active Update Set
-snow_ensure_active_update_set({
-  context: "Widget development"
-});
-
-// Track artifacts
-snow_update_set_add_artifact({
-  type: "widget",
-  sys_id: "abc123",
-  name: "My Widget"
-});
-
-// Preview changes
-snow_update_set_preview({
-  update_set_id: "current"
-});
-\`\`\`
-
-### Testing Tools
-\`\`\`javascript
-// Test flows with mock data
-snow_test_flow_with_mock({
-  flow_id: "equipment_provisioning_flow",
-  create_test_user: true,
-  mock_catalog_items: true,
-  simulate_approvals: true,
-  cleanup_after_test: true
-});
-
-// Link catalog to flow
-snow_link_catalog_to_flow({
-  catalog_item_id: "iPhone 6S",
-  flow_id: "mobile_provisioning_flow",
-  test_link: true
-});
-\`\`\`
-
-## 📋 Essential Patterns
-
-### Authentication Handling
-\`\`\`javascript
-// Always handle auth failures gracefully
-if (error.includes('401') || error.includes('403')) {
-  // Guide user to fix authentication
-  console.log('Run: snow-flow auth login');
-  console.log('Check .env file for credentials');
-  // STOP - don't continue without auth
-}
-\`\`\`
-
-### Error Recovery
-\`\`\`javascript
-// Implement fallback strategies
-if (deployment.failed) {
-  // Try global scope
-  const globalAttempt = await snow_deploy({ 
-    ...config, 
-    scope_preference: 'global' 
-  });
-  
-  if (globalAttempt.failed) {
-    // Provide manual instructions
-    return createManualStepsGuide(config, error);
-  }
-}
-\`\`\`
-
-## 🔧 Configuration
-
-### Build Commands
-- \`npm run build\`: Build the project
-- \`npm run test\`: Run the full test suite
-- \`npm run lint\`: Run ESLint and format checks
-- \`npm run typecheck\`: Run TypeScript type checking
-
-### Snow-Flow Commands
-- \`snow-flow init\`: Initialize project with MCP servers and SPARC environment
-- \`snow-flow auth login\`: Authenticate with ServiceNow
-- \`snow-flow swarm "<objective>"\`: Execute multi-agent development
-- \`snow-flow mcp start\`: Start MCP servers manually
-
-### Environment Setup
-\`\`\`bash
-# .env file
-SNOW_INSTANCE=dev123456
-SNOW_CLIENT_ID=your_oauth_client_id
-SNOW_CLIENT_SECRET=your_oauth_client_secret
-\`\`\`
-
-## 💡 Best Practices
-
-### DO's
-✅ Always use \`snow_validate_live_connection()\` first  
-✅ Check for existing artifacts with \`snow_find_artifact()\`  
-✅ Use Update Sets for all changes  
-✅ Test with mock data before production  
-✅ Handle errors gracefully with fallbacks  
-
-### DON'Ts
-❌ Don't create local files first  
-❌ Don't skip authentication  
-❌ Don't hardcode sys_ids or credentials  
-❌ Don't work in offline mode  
-❌ Don't deploy without testing  
-
-## 🎯 Quick Start
-1. \`snow-flow init\` - Initialize project with MCP servers and SPARC environment
-2. Configure ServiceNow credentials in .env file  
-3. \`snow-flow auth login\` - Authenticate with ServiceNow
-4. \`snow-flow swarm "create a widget for incident management"\` - Everything automatic!
-
-For full documentation, visit: https://github.com/groeimetai/snow-flow
-`;
+        // Import the template as fallback
+        const { CLAUDE_MD_TEMPLATE } = await Promise.resolve().then(() => __importStar(require('./templates/claude-md-template.js')));
         const claudeMdPath = (0, path_1.join)(targetDir, 'CLAUDE.md');
         if (force || !(0, fs_2.existsSync)(claudeMdPath)) {
-            await fs_1.promises.writeFile(claudeMdPath, claudeMdFallback);
+            await fs_1.promises.writeFile(claudeMdPath, CLAUDE_MD_TEMPLATE);
         }
     }
 }

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

@@ -0,0 +1,2 @@
+export declare const CLAUDE_MD_TEMPLATE = "# Snow-Flow Configuration & Best Practices\n\nThis document provides comprehensive instructions for Snow-Flow, an advanced ServiceNow development and orchestration framework powered by Claude AI.\n\n## Table of Contents\n1. [Core Philosophy](#core-philosophy)\n2. [Fundamental Rules](#fundamental-rules)\n3. [ServiceNow Development Standards](#servicenow-development-standards)\n4. [MCP Server Capabilities](#mcp-server-capabilities)\n5. [Debugging Best Practices](#debugging-best-practices)\n6. [Command Reference](#command-reference)\n7. [Workflow Guidelines](#workflow-guidelines)\n\n## Core Philosophy\n\n### The Prime Directive: Verify, Don't Assume\n\nSnow-Flow operates on evidence-based development. Never make assumptions about what exists or doesn't exist in a ServiceNow environment. Every environment is unique with custom tables, fields, integrations, and configurations that you cannot predict.\n\n**Cardinal Rules:**\n1. If code references something, it probably exists\n2. Test before declaring something broken\n3. Verify before modifying\n4. Fix only what's confirmed broken\n5. Respect existing configurations\n\n### The Verification-First Approach\n\n```javascript\n// Before claiming anything doesn't work or exist:\n// Step 1: Test the actual implementation\nconst verify = await snow_execute_script_with_output({\n  script: `/* Test the exact code or resource */`\n});\n\n// Step 2: Check if resources exist\nconst tableCheck = await snow_discover_table_fields({\n  table_name: 'potentially_custom_table'\n});\n\n// Step 3: Validate configurations\nconst propertyCheck = await snow_property_manager({\n  action: 'get',\n  name: 'system.property'\n});\n\n// Step 4: Only then make informed decisions\n```\n\n## Fundamental Rules\n\n### Rule 1: ES5 JavaScript Only in ServiceNow\n\nServiceNow uses the Rhino JavaScript engine which supports only ES5. Modern JavaScript syntax will fail.\n\n**Never Use:**\n- `const` or `let` - use `var`\n- Arrow functions `() => {}` - use `function() {}`\n- Template literals `` `${var}` `` - use string concatenation\n- Destructuring `{a, b} = obj` - use explicit property access\n- `for...of` loops - use traditional `for` loops\n- Default parameters - use `typeof` checks\n- `async/await` - use callbacks or GlideAjax\n\n**Always Use:**\n```javascript\n// ES5 compatible code\nvar name = 'value';\nfunction processData() {\n  return 'result';\n}\nvar message = 'Hello ' + userName;\nfor (var i = 0; i < array.length; i++) {\n  var item = array[i];\n}\n```\n\n### Rule 2: Background Scripts as Primary Debug Tool\n\nBackground scripts provide immediate, factual feedback from the actual ServiceNow instance. Use them extensively for verification and debugging.\n\n```javascript\n// Universal verification pattern\nconst verify = await snow_execute_script_with_output({\n  script: `\n    gs.info('=== VERIFICATION TEST ===');\n    \n    // Test table existence\n    var table = new GlideRecord('table_name');\n    gs.info('Table valid: ' + table.isValid());\n    \n    // Test property existence\n    var prop = gs.getProperty('property.name');\n    gs.info('Property: ' + (prop || 'NOT SET'));\n    \n    // Test actual code\n    try {\n      // User's code here\n      gs.info('SUCCESS');\n    } catch(e) {\n      gs.error('ERROR: ' + e.message);\n    }\n  `\n});\n```\n\n### Rule 3: Widget Coherence - Critical Client-Server Communication\n\nServiceNow widgets MUST have perfect communication between client and server scripts. This is not optional - widgets fail when these components don't talk to each other correctly.\n\n**The Three-Way Contract:**\n\n**Server Script Must:**\n- Initialize all `data` properties that HTML will reference\n- Handle every `input.action` that client sends\n- Return data in the format client expects\n\n**Client Script Must:**\n- Implement every method that HTML calls via `ng-click`\n- Use `c.server.get({action: 'name'})` for server communication\n- Update `c.data` when server responds\n\n**HTML Template Must:**\n- Only reference `data` properties that server provides\n- Only call methods that client implements\n- Use correct Angular directives and bindings\n\n**Critical Communication Points:**\n\n1. **Server \u2192 Client Data Flow**\n   - Server sets `data.property`\n   - Client receives via `c.data.property`\n   - HTML displays with `{{data.property}}`\n\n2. **Client \u2192 Server Requests**\n   - Client sends `c.server.get({action: 'name'})`\n   - Server receives via `input.action`\n   - Server processes and returns updated `data`\n\n3. **HTML \u2192 Client Method Calls**\n   - HTML has `ng-click=\"methodName()\"`\n   - Client must have `$scope.methodName = function()`\n   - Method typically calls server with `c.server.get()`\n\n**Common Failures to Avoid:**\n- Action name mismatches between client and server\n- Method name mismatches between HTML and client  \n- Property name mismatches between server and HTML\n- Missing handlers for client requests\n- Orphaned data properties or methods\n\n**Coherence Validation Checklist:**\n- [ ] Every `data.property` in server is used in HTML/client\n- [ ] Every `ng-click` in HTML has matching `$scope.method` in client\n- [ ] Every `c.server.get({action})` in client has matching `if(input.action)` in server\n- [ ] Data flows correctly: Server \u2192 HTML \u2192 Client \u2192 Server\n- [ ] No orphaned methods or unused data properties\n\n### Rule 4: Evidence-Based Debugging\n\nFollow this systematic approach for all debugging:\n\n1. **Reproduce** - Run the exact failing code\n2. **Inventory** - List all dependencies\n3. **Verify** - Test each dependency exists\n4. **Fix** - Correct only confirmed issues\n\n**Fix only:**\n- \u2705 Confirmed syntax errors\n- \u2705 Verified null references\n- \u2705 Missing dependencies (after verification)\n- \u2705 Real type mismatches\n\n**Never change:**\n- \u274C Unverified resources\n- \u274C Configurations that \"seem wrong\"\n- \u274C APIs you haven't tested\n- \u274C Working code that could be \"better\"\n\n## ServiceNow Development Standards\n\n### Table Operations\n- Always verify table existence before operations\n- Use proper field types and references\n- Check for ACLs and permissions\n- Handle large datasets with pagination\n\n### Script Development\n- Use Script Includes for reusable code\n- Implement proper error handling\n- Add meaningful logging with gs.info/warn/error\n- Test in scoped applications when applicable\n\n### Widget Development\n- Ensure HTML/Client/Server coherence\n- Use Angular providers correctly\n- Implement proper data binding\n- Test across different themes and portals\n\n### Flow Development\n- Use proper trigger conditions\n- Implement error handling paths\n- Add appropriate logging actions\n- Test with various data scenarios\n\n## MCP Server Capabilities\n\nSnow-Flow includes 12 specialized MCP servers, each providing specific ServiceNow capabilities:\n\n### 1. ServiceNow Deployment Server\n**Purpose:** Widget and artifact deployment with coherence validation\n\n**Key Tools:**\n- `snow_deploy_widget` - Deploy widgets with HTML/Client/Server validation\n- `snow_deploy_portal_page` - Deploy portal pages\n- `snow_deploy_flow` - Deploy Flow Designer flows\n- `snow_create_update_set` - Create update sets\n- `snow_validate_deployment` - Validate deployed artifacts\n- `snow_rollback_deployment` - Rollback failed deployments\n\n**Special Features:**\n- Automatic widget coherence validation\n- Data flow contract verification\n- Method implementation checking\n- CSS class validation\n\n### 2. ServiceNow Operations Server\n**Purpose:** Core ServiceNow operations and queries\n\n**Key Tools:**\n- `snow_query_table` - Universal table querying with pagination\n- `snow_create_incident` - Create and manage incidents\n- `snow_update_record` - Update any table record\n- `snow_delete_record` - Delete records with validation\n- `snow_discover_table_fields` - Discover table schema\n- `snow_cmdb_search` - Search Configuration Management Database\n\n**Features:**\n- Full CRUD operations on any table\n- Advanced query capabilities\n- Field discovery and validation\n- Relationship navigation\n\n### 3. ServiceNow Automation Server\n**Purpose:** Script execution and automation\n\n**Key Tools:**\n- `snow_execute_script_with_output` - Execute scripts with output capture\n- `snow_get_script_output` - Retrieve script execution history\n- `snow_execute_script_sync` - Synchronous script execution\n- `snow_get_logs` - Access system logs\n- `snow_test_rest_connection` - Test REST integrations\n- `snow_trace_execution` - Trace script execution\n- `snow_schedule_job` - Create scheduled jobs\n- `snow_create_event` - Trigger system events\n\n**Features:**\n- Full output capture (gs.print/info/warn/error)\n- Execution history tracking\n- System log access\n- REST message testing\n- Performance tracing\n\n### 4. ServiceNow Platform Development Server\n**Purpose:** Platform development artifacts\n\n**Key Tools:**\n- `snow_create_script_include` - Create reusable scripts\n- `snow_create_business_rule` - Create business rules\n- `snow_create_client_script` - Create client-side scripts\n- `snow_create_ui_policy` - Create UI policies\n- `snow_create_ui_action` - Create UI actions\n- `snow_create_ui_page` - Create UI pages\n\n**Features:**\n- Full artifact creation\n- Proper scoping support\n- Condition builder integration\n- Script validation\n\n### 5. ServiceNow Integration Server\n**Purpose:** Integration and data management\n\n**Key Tools:**\n- `snow_create_rest_message` - Create REST integrations\n- `snow_create_transform_map` - Create data transformation maps\n- `snow_create_import_set` - Manage import sets\n- `snow_test_web_service` - Test web services\n- `snow_configure_email` - Configure email settings\n\n**Features:**\n- REST/SOAP integration\n- Data transformation\n- Import/Export capabilities\n- Email configuration\n\n### 6. ServiceNow System Properties Server\n**Purpose:** System property management\n\n**Key Tools:**\n- `snow_property_get` - Retrieve property values\n- `snow_property_set` - Set property values\n- `snow_property_list` - List properties by pattern\n- `snow_property_delete` - Remove properties\n- `snow_property_bulk_update` - Bulk operations\n- `snow_property_export` - Export to JSON\n- `snow_property_import` - Import from JSON\n\n**Features:**\n- Full CRUD on sys_properties\n- Bulk operations\n- Import/Export capabilities\n- Property validation\n\n### 7. ServiceNow Update Set Server\n**Purpose:** Change management and deployment\n\n**Key Tools:**\n- `snow_create_update_set` - Create new update sets\n- `snow_switch_update_set` - Switch active update set\n- `snow_complete_update_set` - Mark as complete\n- `snow_preview_update_set` - Preview changes\n- `snow_export_update_set` - Export as XML\n\n**Features:**\n- Full update set lifecycle\n- Change tracking\n- XML export/import\n- Conflict detection\n\n### 8. ServiceNow Development Assistant Server\n**Purpose:** Code generation and best practices\n\n**Key Tools:**\n- `snow_generate_code` - Generate ServiceNow code\n- `snow_suggest_pattern` - Suggest design patterns\n- `snow_review_code` - Code review and analysis\n- `snow_optimize_performance` - Performance recommendations\n\n**Features:**\n- Pattern-based code generation\n- Best practice enforcement\n- Performance optimization\n- Security review\n\n### 9. ServiceNow Security & Compliance Server\n**Purpose:** Security and compliance management\n\n**Key Tools:**\n- `snow_create_security_policy` - Create security policies\n- `snow_audit_compliance` - Compliance auditing\n- `snow_scan_vulnerabilities` - Vulnerability scanning\n- `snow_assess_risk` - Risk assessment\n- `snow_review_access_control` - ACL review\n\n**Features:**\n- SOX/GDPR/HIPAA compliance\n- Security policy management\n- Vulnerability assessment\n- Access control validation\n\n### 10. ServiceNow Reporting & Analytics Server\n**Purpose:** Reporting and data visualization\n\n**Key Tools:**\n- `snow_create_report` - Create reports\n- `snow_create_dashboard` - Create dashboards\n- `snow_define_kpi` - Define KPIs\n- `snow_schedule_report` - Schedule report delivery\n- `snow_analyze_data_quality` - Data quality analysis\n\n**Features:**\n- Advanced reporting\n- Dashboard creation\n- KPI management\n- Scheduled delivery\n\n### 11. ServiceNow Machine Learning Server\n**Purpose:** AI/ML capabilities\n\n**Key Tools:**\n- `snow_train_classifier` - Train incident classifier\n- `snow_predict_change_risk` - Predict change risks\n- `snow_detect_anomalies` - Anomaly detection\n- `snow_forecast_incidents` - Incident forecasting\n- `snow_optimize_process` - Process optimization\n\n**Features:**\n- Predictive analytics\n- Pattern recognition\n- Anomaly detection\n- Process optimization\n\n### 12. Snow-Flow Orchestration Server\n**Purpose:** Multi-agent coordination and task management\n\n**Key Tools:**\n- `snow_swarm_init` - Initialize agent swarms\n- `snow_agent_spawn` - Create specialized agents\n- `snow_task_orchestrate` - Orchestrate complex tasks\n- `snow_memory_store` - Persistent memory storage\n- `snow_neural_train` - Train neural networks\n- `snow_performance_analyze` - Performance analysis\n\n**Features:**\n- Multi-agent coordination\n- Task orchestration\n- Neural network training (TensorFlow.js)\n- Memory management\n- Performance monitoring\n\n## Debugging Best Practices\n\n### Systematic Debugging Protocol\n\n1. **Reproduce the Issue**\n   ```javascript\n   // Always use ES5 and test exact code\n   const result = await snow_execute_script_with_output({\n     script: `/* Exact failing code in ES5 */`\n   });\n   ```\n\n2. **Verify Dependencies**\n   - Check all referenced tables exist\n   - Verify all properties are set\n   - Confirm all fields are present\n   - Test all integrations work\n\n3. **Test in Context**\n   - Use same scope and variables\n   - Include same imports\n   - Test with same data\n\n4. **Apply Evidence-Based Fixes**\n   - Fix only confirmed issues\n   - Document why changes were made\n   - Test fixes thoroughly\n\n### Common Verification Patterns\n\n**Table Verification:**\n```javascript\nvar table = new GlideRecord('table_name');\ngs.info('Table exists: ' + table.isValid());\n```\n\n**Property Verification:**\n```javascript\nvar prop = gs.getProperty('property.name');\ngs.info('Property value: ' + (prop || 'NOT SET'));\n```\n\n**Field Verification:**\n```javascript\nvar gr = new GlideRecord('table');\nvar element = gr.getElement('field_name');\ngs.info('Field exists: ' + (element ? 'Yes' : 'No'));\n```\n\n## Command Reference\n\n### Core Commands\n- `./snow-flow start` - Start orchestration system\n- `./snow-flow status` - System status\n- `./snow-flow monitor` - Real-time monitoring\n\n### Agent Management\n- `./snow-flow agent spawn <type>` - Create agents\n- `./snow-flow agent list` - List active agents\n\n### Task Management\n- `./snow-flow task create` - Create tasks\n- `./snow-flow task list` - View task queue\n\n### Memory Operations\n- `./snow-flow memory store <key> <data>` - Store data\n- `./snow-flow memory get <key>` - Retrieve data\n- `./snow-flow memory list` - List all keys\n\n### SPARC Modes\n- `./snow-flow sparc \"<task>\"` - Orchestrator mode\n- `./snow-flow sparc run <mode> \"<task>\"` - Specific mode\n- `./snow-flow sparc tdd \"<feature>\"` - Test-driven development\n\n### Swarm Coordination\n- `./snow-flow swarm \"<objective>\"` - Multi-agent coordination\n- Options: `--strategy`, `--mode`, `--parallel`, `--monitor`\n\n## Workflow Guidelines\n\n### Development Workflow\n1. **Plan** - Use TodoWrite for task management\n2. **Verify** - Check existing resources\n3. **Develop** - Follow ES5 standards\n4. **Test** - Use background scripts\n5. **Deploy** - Use update sets\n6. **Validate** - Verify deployment\n\n### Testing Workflow\n1. Run unit tests with background scripts\n2. Test integrations with REST tools\n3. Validate UI with widget coherence\n4. Check performance with tracing\n5. Review logs for errors\n\n### Debugging Workflow\n1. Reproduce issue exactly\n2. Gather evidence with scripts\n3. Verify all assumptions\n4. Apply minimal fixes\n5. Test thoroughly\n6. Document changes\n\n## Important Reminders\n\n### Always Remember\n- Every ServiceNow instance is unique\n- Custom implementations exist that you don't know about\n- Preview/beta features may be available\n- Organization-specific configurations are common\n- Test everything before making assumptions\n\n### Never Assume\n- That something doesn't exist without verification\n- That configurations are wrong without testing\n- That APIs aren't available without checking\n- That code won't work without running it\n- That you know better than existing implementations\n\n### Golden Rules\n1. **Verify First** - Test before declaring broken\n2. **ES5 Only** - No modern JavaScript in ServiceNow\n3. **Evidence-Based** - Make decisions on facts, not assumptions\n4. **Minimal Changes** - Fix only what's broken\n5. **Respect Context** - Understand why things exist as they do\n\n## Conclusion\n\nSnow-Flow is a powerful framework for ServiceNow development that emphasizes verification, testing, and evidence-based decision making. By following these guidelines and best practices, you ensure reliable, maintainable, and effective ServiceNow solutions.\n\nRemember: Your job is to solve problems, not to judge implementations. Every environment has its reasons for existing configurations. Verify, test, and respect what you find.";
+//# sourceMappingURL=claude-md-template.d.ts.map

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

@@ -0,0 +1,546 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLAUDE_MD_TEMPLATE = void 0;
+exports.CLAUDE_MD_TEMPLATE = `# Snow-Flow Configuration & Best Practices
+
+This document provides comprehensive instructions for Snow-Flow, an advanced ServiceNow development and orchestration framework powered by Claude AI.
+
+## Table of Contents
+1. [Core Philosophy](#core-philosophy)
+2. [Fundamental Rules](#fundamental-rules)
+3. [ServiceNow Development Standards](#servicenow-development-standards)
+4. [MCP Server Capabilities](#mcp-server-capabilities)
+5. [Debugging Best Practices](#debugging-best-practices)
+6. [Command Reference](#command-reference)
+7. [Workflow Guidelines](#workflow-guidelines)
+
+## Core Philosophy
+
+### The Prime Directive: Verify, Don't Assume
+
+Snow-Flow operates on evidence-based development. Never make assumptions about what exists or doesn't exist in a ServiceNow environment. Every environment is unique with custom tables, fields, integrations, and configurations that you cannot predict.
+
+**Cardinal Rules:**
+1. If code references something, it probably exists
+2. Test before declaring something broken
+3. Verify before modifying
+4. Fix only what's confirmed broken
+5. Respect existing configurations
+
+### The Verification-First Approach
+
+\`\`\`javascript
+// Before claiming anything doesn't work or exist:
+// Step 1: Test the actual implementation
+const verify = await snow_execute_script_with_output({
+  script: \`/* Test the exact code or resource */\`
+});
+
+// Step 2: Check if resources exist
+const tableCheck = await snow_discover_table_fields({
+  table_name: 'potentially_custom_table'
+});
+
+// Step 3: Validate configurations
+const propertyCheck = await snow_property_manager({
+  action: 'get',
+  name: 'system.property'
+});
+
+// Step 4: Only then make informed decisions
+\`\`\`
+
+## Fundamental Rules
+
+### Rule 1: ES5 JavaScript Only in ServiceNow
+
+ServiceNow uses the Rhino JavaScript engine which supports only ES5. Modern JavaScript syntax will fail.
+
+**Never Use:**
+- \`const\` or \`let\` - use \`var\`
+- Arrow functions \`() => {}\` - use \`function() {}\`
+- Template literals \`\` \`\${var}\` \`\` - use string concatenation
+- Destructuring \`{a, b} = obj\` - use explicit property access
+- \`for...of\` loops - use traditional \`for\` loops
+- Default parameters - use \`typeof\` checks
+- \`async/await\` - use callbacks or GlideAjax
+
+**Always Use:**
+\`\`\`javascript
+// ES5 compatible code
+var name = 'value';
+function processData() {
+  return 'result';
+}
+var message = 'Hello ' + userName;
+for (var i = 0; i < array.length; i++) {
+  var item = array[i];
+}
+\`\`\`
+
+### Rule 2: Background Scripts as Primary Debug Tool
+
+Background scripts provide immediate, factual feedback from the actual ServiceNow instance. Use them extensively for verification and debugging.
+
+\`\`\`javascript
+// Universal verification pattern
+const verify = await snow_execute_script_with_output({
+  script: \`
+    gs.info('=== VERIFICATION TEST ===');
+    
+    // Test table existence
+    var table = new GlideRecord('table_name');
+    gs.info('Table valid: ' + table.isValid());
+    
+    // Test property existence
+    var prop = gs.getProperty('property.name');
+    gs.info('Property: ' + (prop || 'NOT SET'));
+    
+    // Test actual code
+    try {
+      // User's code here
+      gs.info('SUCCESS');
+    } catch(e) {
+      gs.error('ERROR: ' + e.message);
+    }
+  \`
+});
+\`\`\`
+
+### Rule 3: Widget Coherence - Critical Client-Server Communication
+
+ServiceNow widgets MUST have perfect communication between client and server scripts. This is not optional - widgets fail when these components don't talk to each other correctly.
+
+**The Three-Way Contract:**
+
+**Server Script Must:**
+- Initialize all \`data\` properties that HTML will reference
+- Handle every \`input.action\` that client sends
+- Return data in the format client expects
+
+**Client Script Must:**
+- Implement every method that HTML calls via \`ng-click\`
+- Use \`c.server.get({action: 'name'})\` for server communication
+- Update \`c.data\` when server responds
+
+**HTML Template Must:**
+- Only reference \`data\` properties that server provides
+- Only call methods that client implements
+- Use correct Angular directives and bindings
+
+**Critical Communication Points:**
+
+1. **Server → Client Data Flow**
+   - Server sets \`data.property\`
+   - Client receives via \`c.data.property\`
+   - HTML displays with \`{{data.property}}\`
+
+2. **Client → Server Requests**
+   - Client sends \`c.server.get({action: 'name'})\`
+   - Server receives via \`input.action\`
+   - Server processes and returns updated \`data\`
+
+3. **HTML → Client Method Calls**
+   - HTML has \`ng-click="methodName()"\`
+   - Client must have \`$scope.methodName = function()\`
+   - Method typically calls server with \`c.server.get()\`
+
+**Common Failures to Avoid:**
+- Action name mismatches between client and server
+- Method name mismatches between HTML and client  
+- Property name mismatches between server and HTML
+- Missing handlers for client requests
+- Orphaned data properties or methods
+
+**Coherence Validation Checklist:**
+- [ ] Every \`data.property\` in server is used in HTML/client
+- [ ] Every \`ng-click\` in HTML has matching \`$scope.method\` in client
+- [ ] Every \`c.server.get({action})\` in client has matching \`if(input.action)\` in server
+- [ ] Data flows correctly: Server → HTML → Client → Server
+- [ ] No orphaned methods or unused data properties
+
+### Rule 4: Evidence-Based Debugging
+
+Follow this systematic approach for all debugging:
+
+1. **Reproduce** - Run the exact failing code
+2. **Inventory** - List all dependencies
+3. **Verify** - Test each dependency exists
+4. **Fix** - Correct only confirmed issues
+
+**Fix only:**
+- ✅ Confirmed syntax errors
+- ✅ Verified null references
+- ✅ Missing dependencies (after verification)
+- ✅ Real type mismatches
+
+**Never change:**
+- ❌ Unverified resources
+- ❌ Configurations that "seem wrong"
+- ❌ APIs you haven't tested
+- ❌ Working code that could be "better"
+
+## ServiceNow Development Standards
+
+### Table Operations
+- Always verify table existence before operations
+- Use proper field types and references
+- Check for ACLs and permissions
+- Handle large datasets with pagination
+
+### Script Development
+- Use Script Includes for reusable code
+- Implement proper error handling
+- Add meaningful logging with gs.info/warn/error
+- Test in scoped applications when applicable
+
+### Widget Development
+- Ensure HTML/Client/Server coherence
+- Use Angular providers correctly
+- Implement proper data binding
+- Test across different themes and portals
+
+### Flow Development
+- Use proper trigger conditions
+- Implement error handling paths
+- Add appropriate logging actions
+- Test with various data scenarios
+
+## MCP Server Capabilities
+
+Snow-Flow includes 12 specialized MCP servers, each providing specific ServiceNow capabilities:
+
+### 1. ServiceNow Deployment Server
+**Purpose:** Widget and artifact deployment with coherence validation
+
+**Key Tools:**
+- \`snow_deploy_widget\` - Deploy widgets with HTML/Client/Server validation
+- \`snow_deploy_portal_page\` - Deploy portal pages
+- \`snow_deploy_flow\` - Deploy Flow Designer flows
+- \`snow_create_update_set\` - Create update sets
+- \`snow_validate_deployment\` - Validate deployed artifacts
+- \`snow_rollback_deployment\` - Rollback failed deployments
+
+**Special Features:**
+- Automatic widget coherence validation
+- Data flow contract verification
+- Method implementation checking
+- CSS class validation
+
+### 2. ServiceNow Operations Server
+**Purpose:** Core ServiceNow operations and queries
+
+**Key Tools:**
+- \`snow_query_table\` - Universal table querying with pagination
+- \`snow_create_incident\` - Create and manage incidents
+- \`snow_update_record\` - Update any table record
+- \`snow_delete_record\` - Delete records with validation
+- \`snow_discover_table_fields\` - Discover table schema
+- \`snow_cmdb_search\` - Search Configuration Management Database
+
+**Features:**
+- Full CRUD operations on any table
+- Advanced query capabilities
+- Field discovery and validation
+- Relationship navigation
+
+### 3. ServiceNow Automation Server
+**Purpose:** Script execution and automation
+
+**Key Tools:**
+- \`snow_execute_script_with_output\` - Execute scripts with output capture
+- \`snow_get_script_output\` - Retrieve script execution history
+- \`snow_execute_script_sync\` - Synchronous script execution
+- \`snow_get_logs\` - Access system logs
+- \`snow_test_rest_connection\` - Test REST integrations
+- \`snow_trace_execution\` - Trace script execution
+- \`snow_schedule_job\` - Create scheduled jobs
+- \`snow_create_event\` - Trigger system events
+
+**Features:**
+- Full output capture (gs.print/info/warn/error)
+- Execution history tracking
+- System log access
+- REST message testing
+- Performance tracing
+
+### 4. ServiceNow Platform Development Server
+**Purpose:** Platform development artifacts
+
+**Key Tools:**
+- \`snow_create_script_include\` - Create reusable scripts
+- \`snow_create_business_rule\` - Create business rules
+- \`snow_create_client_script\` - Create client-side scripts
+- \`snow_create_ui_policy\` - Create UI policies
+- \`snow_create_ui_action\` - Create UI actions
+- \`snow_create_ui_page\` - Create UI pages
+
+**Features:**
+- Full artifact creation
+- Proper scoping support
+- Condition builder integration
+- Script validation
+
+### 5. ServiceNow Integration Server
+**Purpose:** Integration and data management
+
+**Key Tools:**
+- \`snow_create_rest_message\` - Create REST integrations
+- \`snow_create_transform_map\` - Create data transformation maps
+- \`snow_create_import_set\` - Manage import sets
+- \`snow_test_web_service\` - Test web services
+- \`snow_configure_email\` - Configure email settings
+
+**Features:**
+- REST/SOAP integration
+- Data transformation
+- Import/Export capabilities
+- Email configuration
+
+### 6. ServiceNow System Properties Server
+**Purpose:** System property management
+
+**Key Tools:**
+- \`snow_property_get\` - Retrieve property values
+- \`snow_property_set\` - Set property values
+- \`snow_property_list\` - List properties by pattern
+- \`snow_property_delete\` - Remove properties
+- \`snow_property_bulk_update\` - Bulk operations
+- \`snow_property_export\` - Export to JSON
+- \`snow_property_import\` - Import from JSON
+
+**Features:**
+- Full CRUD on sys_properties
+- Bulk operations
+- Import/Export capabilities
+- Property validation
+
+### 7. ServiceNow Update Set Server
+**Purpose:** Change management and deployment
+
+**Key Tools:**
+- \`snow_create_update_set\` - Create new update sets
+- \`snow_switch_update_set\` - Switch active update set
+- \`snow_complete_update_set\` - Mark as complete
+- \`snow_preview_update_set\` - Preview changes
+- \`snow_export_update_set\` - Export as XML
+
+**Features:**
+- Full update set lifecycle
+- Change tracking
+- XML export/import
+- Conflict detection
+
+### 8. ServiceNow Development Assistant Server
+**Purpose:** Code generation and best practices
+
+**Key Tools:**
+- \`snow_generate_code\` - Generate ServiceNow code
+- \`snow_suggest_pattern\` - Suggest design patterns
+- \`snow_review_code\` - Code review and analysis
+- \`snow_optimize_performance\` - Performance recommendations
+
+**Features:**
+- Pattern-based code generation
+- Best practice enforcement
+- Performance optimization
+- Security review
+
+### 9. ServiceNow Security & Compliance Server
+**Purpose:** Security and compliance management
+
+**Key Tools:**
+- \`snow_create_security_policy\` - Create security policies
+- \`snow_audit_compliance\` - Compliance auditing
+- \`snow_scan_vulnerabilities\` - Vulnerability scanning
+- \`snow_assess_risk\` - Risk assessment
+- \`snow_review_access_control\` - ACL review
+
+**Features:**
+- SOX/GDPR/HIPAA compliance
+- Security policy management
+- Vulnerability assessment
+- Access control validation
+
+### 10. ServiceNow Reporting & Analytics Server
+**Purpose:** Reporting and data visualization
+
+**Key Tools:**
+- \`snow_create_report\` - Create reports
+- \`snow_create_dashboard\` - Create dashboards
+- \`snow_define_kpi\` - Define KPIs
+- \`snow_schedule_report\` - Schedule report delivery
+- \`snow_analyze_data_quality\` - Data quality analysis
+
+**Features:**
+- Advanced reporting
+- Dashboard creation
+- KPI management
+- Scheduled delivery
+
+### 11. ServiceNow Machine Learning Server
+**Purpose:** AI/ML capabilities
+
+**Key Tools:**
+- \`snow_train_classifier\` - Train incident classifier
+- \`snow_predict_change_risk\` - Predict change risks
+- \`snow_detect_anomalies\` - Anomaly detection
+- \`snow_forecast_incidents\` - Incident forecasting
+- \`snow_optimize_process\` - Process optimization
+
+**Features:**
+- Predictive analytics
+- Pattern recognition
+- Anomaly detection
+- Process optimization
+
+### 12. Snow-Flow Orchestration Server
+**Purpose:** Multi-agent coordination and task management
+
+**Key Tools:**
+- \`snow_swarm_init\` - Initialize agent swarms
+- \`snow_agent_spawn\` - Create specialized agents
+- \`snow_task_orchestrate\` - Orchestrate complex tasks
+- \`snow_memory_store\` - Persistent memory storage
+- \`snow_neural_train\` - Train neural networks
+- \`snow_performance_analyze\` - Performance analysis
+
+**Features:**
+- Multi-agent coordination
+- Task orchestration
+- Neural network training (TensorFlow.js)
+- Memory management
+- Performance monitoring
+
+## Debugging Best Practices
+
+### Systematic Debugging Protocol
+
+1. **Reproduce the Issue**
+   \`\`\`javascript
+   // Always use ES5 and test exact code
+   const result = await snow_execute_script_with_output({
+     script: \`/* Exact failing code in ES5 */\`
+   });
+   \`\`\`
+
+2. **Verify Dependencies**
+   - Check all referenced tables exist
+   - Verify all properties are set
+   - Confirm all fields are present
+   - Test all integrations work
+
+3. **Test in Context**
+   - Use same scope and variables
+   - Include same imports
+   - Test with same data
+
+4. **Apply Evidence-Based Fixes**
+   - Fix only confirmed issues
+   - Document why changes were made
+   - Test fixes thoroughly
+
+### Common Verification Patterns
+
+**Table Verification:**
+\`\`\`javascript
+var table = new GlideRecord('table_name');
+gs.info('Table exists: ' + table.isValid());
+\`\`\`
+
+**Property Verification:**
+\`\`\`javascript
+var prop = gs.getProperty('property.name');
+gs.info('Property value: ' + (prop || 'NOT SET'));
+\`\`\`
+
+**Field Verification:**
+\`\`\`javascript
+var gr = new GlideRecord('table');
+var element = gr.getElement('field_name');
+gs.info('Field exists: ' + (element ? 'Yes' : 'No'));
+\`\`\`
+
+## Command Reference
+
+### Core Commands
+- \`./snow-flow start\` - Start orchestration system
+- \`./snow-flow status\` - System status
+- \`./snow-flow monitor\` - Real-time monitoring
+
+### Agent Management
+- \`./snow-flow agent spawn <type>\` - Create agents
+- \`./snow-flow agent list\` - List active agents
+
+### Task Management
+- \`./snow-flow task create\` - Create tasks
+- \`./snow-flow task list\` - View task queue
+
+### Memory Operations
+- \`./snow-flow memory store <key> <data>\` - Store data
+- \`./snow-flow memory get <key>\` - Retrieve data
+- \`./snow-flow memory list\` - List all keys
+
+### SPARC Modes
+- \`./snow-flow sparc "<task>"\` - Orchestrator mode
+- \`./snow-flow sparc run <mode> "<task>"\` - Specific mode
+- \`./snow-flow sparc tdd "<feature>"\` - Test-driven development
+
+### Swarm Coordination
+- \`./snow-flow swarm "<objective>"\` - Multi-agent coordination
+- Options: \`--strategy\`, \`--mode\`, \`--parallel\`, \`--monitor\`
+
+## Workflow Guidelines
+
+### Development Workflow
+1. **Plan** - Use TodoWrite for task management
+2. **Verify** - Check existing resources
+3. **Develop** - Follow ES5 standards
+4. **Test** - Use background scripts
+5. **Deploy** - Use update sets
+6. **Validate** - Verify deployment
+
+### Testing Workflow
+1. Run unit tests with background scripts
+2. Test integrations with REST tools
+3. Validate UI with widget coherence
+4. Check performance with tracing
+5. Review logs for errors
+
+### Debugging Workflow
+1. Reproduce issue exactly
+2. Gather evidence with scripts
+3. Verify all assumptions
+4. Apply minimal fixes
+5. Test thoroughly
+6. Document changes
+
+## Important Reminders
+
+### Always Remember
+- Every ServiceNow instance is unique
+- Custom implementations exist that you don't know about
+- Preview/beta features may be available
+- Organization-specific configurations are common
+- Test everything before making assumptions
+
+### Never Assume
+- That something doesn't exist without verification
+- That configurations are wrong without testing
+- That APIs aren't available without checking
+- That code won't work without running it
+- That you know better than existing implementations
+
+### Golden Rules
+1. **Verify First** - Test before declaring broken
+2. **ES5 Only** - No modern JavaScript in ServiceNow
+3. **Evidence-Based** - Make decisions on facts, not assumptions
+4. **Minimal Changes** - Fix only what's broken
+5. **Respect Context** - Understand why things exist as they do
+
+## Conclusion
+
+Snow-Flow is a powerful framework for ServiceNow development that emphasizes verification, testing, and evidence-based decision making. By following these guidelines and best practices, you ensure reliable, maintainable, and effective ServiceNow solutions.
+
+Remember: Your job is to solve problems, not to judge implementations. Every environment has its reasons for existing configurations. Verify, test, and respect what you find.`;
+//# sourceMappingURL=claude-md-template.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "3.4.6",
+  "version": "3.4.7",
   "description": "ServiceNow development framework with MCP server integration. Executes background scripts using ES5 JavaScript only (ServiceNow Rhino engine requirement). Provides 12 MCP servers for ServiceNow operations including widget deployment with coherence validation, table operations, script execution, and system property management.",
   "main": "dist/index.js",
   "type": "commonjs",