snow-flow 3.0.27 → 3.1.1

package/README.md

@@ -100,28 +100,36 @@ snow-flow auth login
 The revolutionary `snow_query_table` replaces all table-specific query tools with intelligent performance optimization:
 
 ```javascript
-// Smart Performance Modes - LLM chooses the best approach:
+// Smart Performance Modes - System auto-detects the best approach:
 
-// 1. Count-only (default) - 99.9% memory savings for ML training
-snow_query_table({ table: "incident", query: "state!=7", limit: 2000 })
-// Returns: {total_results: 2000} - Only 13 bytes!
+// 1. Analytics mode - OMIT limit for ALL records with minimal fields
+snow_query_table({ 
+  table: "incident", 
+  query: "state!=7",
+  fields: ["sys_created_on", "priority"]  // Get ALL records, minimal data
+})
+// Auto-detects analytics context and returns ALL records!
 
-// 2. Specific fields - Get exactly what you need
+// 2. Count-only mode - Ultra efficient for large datasets
 snow_query_table({ 
   table: "sc_request",
-  fields: ["number", "short_description", "requested_for"],
-  include_display_values: true  // Names instead of sys_ids
+  include_content: false  // Just counts, no data
 })
+// Returns: {total_results: 15234} - Maximum efficiency!
 
-// 3. Group by aggregation - Analytics and statistics
+// 3. Display mode - Limited records with full details
 snow_query_table({ 
   table: "problem",
-  group_by: "category",
-  order_by: "-priority"  // - means descending (highest first)
+  limit: 50,  // Explicitly limit for display
+  include_display_values: true
 })
 
-// 4. Full content - When complete data is needed
-snow_query_table({ table: "change_request", include_content: true })
+// 4. Group by aggregation - Server-side analytics
+snow_query_table({ 
+  table: "change_request",
+  group_by: "risk",
+  order_by: "-count"  // Sorted by frequency
+})
 ```
 
 Works with ANY table: `incident`, `sc_request`, `problem`, `cmdb_ci`, even `u_custom_table`!

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

@@ -132,7 +132,7 @@ class ServiceNowOperationsMCP {
                     // 🎯 UNIVERSAL TABLE QUERY - Works for ANY ServiceNow table!
                     {
                         name: 'snow_query_table',
-                        description: 'Universal query tool for any ServiceNow table. SMART ANALYTICS: For analysis use limit:99999 with minimal fields. For display use limit:50. For counting use include_content:false. See CLAUDE.md for query patterns.',
+                        description: 'Universal query tool for any ServiceNow table. SMART ANALYTICS: OMIT limit for ALL records with minimal fields. For display use limit:50. For counting use include_content:false. See CLAUDE.md for optimal query patterns.',
                         inputSchema: {
                             type: 'object',
                             properties: {
@@ -147,8 +147,8 @@ class ServiceNowOperationsMCP {
                                 },
                                 limit: {
                                     type: 'number',
-                                    description: 'Maximum records. For analytics: 99999 (get ALL data with minimal fields). For display: 10-50. For ML: 5000+. NO DEFAULT - think about your use case!',
-                                    examples: [99999, 50, 5000, 10]
+                                    description: 'Maximum records to return. OMIT for analytics (gets ALL records). Use 10-50 for display, 5000+ for ML training. No default - system auto-detects best approach.',
+                                    examples: [50, 1000, 5000]
                                 },
                                 include_content: {
                                     type: 'boolean',
@@ -844,7 +844,7 @@ class ServiceNowOperationsMCP {
                 (fields && fields.length <= 2); // Minimal fields = analytics
             if (isAnalyticsContext) {
                 logger_js_1.logger.info(`📊 Analytics context detected - NO LIMIT applied for complete analysis`);
-                return 99999; // Get ALL data for accurate analytics
+                return undefined; // No limit - get ALL records
             }
             // 🤖 ML Training context
             const isMLContext = query?.toLowerCase().includes('train') ||
@@ -871,6 +871,8 @@ class ServiceNowOperationsMCP {
         const { table, query, include_content = false, fields, include_display_values = false, group_by, order_by } = args;
         // Apply intelligent limit strategy
         const limit = determineSmartLimit(args.limit, table, query, include_content || !!fields, fields);
+        // For analytics, we want NO limit at all
+        const effectiveLimit = limit === undefined ? 999999 : limit; // ServiceNow theoretical max (actual varies by instance)
         // 🚨 ML Training Warning for low limits
         const isMLTrainingContext = query?.toLowerCase().includes('train') ||
             query?.toLowerCase().includes('ml') ||
@@ -878,7 +880,7 @@ class ServiceNowOperationsMCP {
         if (isMLTrainingContext && limit < 1000) {
             logger_js_1.logger.warn(`⚠️  ML Training detected with low limit (${limit}). Consider setting limit=5000+ for better training data!`);
         }
-        logger_js_1.logger.info(`Universal query on table '${table}' with: ${query} (limit: ${limit}, include_content: ${include_content})`);
+        logger_js_1.logger.info(`Universal query on table '${table}' with: ${query} (limit: ${limit === undefined ? 'UNLIMITED' : limit}, include_content: ${include_content})`);
         try {
             // Convert natural language to ServiceNow query if needed
             const processedQuery = this.processNaturalLanguageQuery(query, table);
@@ -890,7 +892,7 @@ class ServiceNowOperationsMCP {
                 finalQuery += `^ORDERBY${orderDirection}${orderField}`;
             }
             // Query the table
-            const records = await this.client.searchRecords(table, finalQuery, limit);
+            const records = await this.client.searchRecords(table, finalQuery, effectiveLimit);
             let result = {
                 table: table,
                 total_results: records.success ? records.data.result.length : 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "3.0.27",
+  "version": "3.1.1",
   "description": "Snow-Flow v3.0.18: DIRECT API VERIFICATION! 🚀 Replaced unreliable searchRecords with direct API calls (snow_query_table style) for widget verification. All null/403 error recovery now uses GET /api/now/table/sp_widget with precise queries. NO MORE FALSE NEGATIVES - verification works consistently every time!",
   "main": "dist/index.js",
   "type": "commonjs",