From 5cb1263468f2ed53a3ee98bf46f3bdbc87756803 Mon Sep 17 00:00:00 2001
From: czlonkowski <56956555+czlonkowski@users.noreply.github.com>
Date: Thu, 13 Nov 2025 13:48:43 +0100
Subject: [PATCH] chore: bump version to 2.22.16 with telemetry changelog
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Updated package.json and package.runtime.json to version 2.22.16.
Added comprehensive CHANGELOG entry documenting workflow mutation
telemetry enhancements for better AI-powered workflow assistance.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en

Co-Authored-By: Claude <noreply@anthropic.com>
---
 CHANGELOG.md         | 61 ++++++++++++++++++++++++++++++++++++++++++++
 package.json         |  2 +-
 package.runtime.json |  2 +-
 3 files changed, 63 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d68eefd..3a0ea5d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,67 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.22.16] - 2025-11-13
+
+### ✨ Enhanced Features
+
+**Workflow Mutation Telemetry for AI-Powered Workflow Assistance**
+
+Added comprehensive telemetry tracking for workflow mutations to enable more context-aware and intelligent responses when users modify their n8n workflows. The AI can better understand user intent and provide more relevant suggestions.
+
+#### Key Improvements
+
+1. **Intent Parameter for Better Context**
+   - Added `intent` parameter to `n8n_update_full_workflow` and `n8n_update_partial_workflow` tools
+   - Captures user's goals and reasoning behind workflow changes
+   - Example: "Add error handling for API failures" or "Migrate to new node versions"
+   - Helps AI provide more relevant and context-aware responses
+
+2. **Comprehensive Data Sanitization**
+   - Multi-layer sanitization at workflow, node, and parameter levels
+   - Removes credentials, API keys, tokens, and sensitive data
+   - Redacts URLs with authentication, long tokens (32+ chars), OpenAI-style keys
+   - Ensures telemetry data is safe while preserving structural patterns
+
+3. **Improved Auto-Flush Performance**
+   - Reduced mutation auto-flush threshold from 5 to 2 events
+   - Provides faster feedback and reduces data loss risk
+   - Balances database write efficiency with responsiveness
+
+4. **Enhanced Mutation Tracking**
+   - Tracks before/after workflow states with secure hashing
+   - Captures intent classification, operation types, and change metrics
+   - Records validation improvements (errors resolved/introduced)
+   - Monitors success rates, errors, and operation duration
+
+#### Technical Changes
+
+**Modified Files:**
+- `src/telemetry/mutation-tracker.ts`: Added comprehensive sanitization methods
+- `src/telemetry/telemetry-manager.ts`: Reduced auto-flush threshold, improved error logging
+- `src/mcp/handlers-workflow-diff.ts`: Added telemetry tracking integration
+- `src/mcp/tool-docs/workflow_management/n8n-update-full-workflow.ts`: Added intent parameter documentation
+- `src/mcp/tool-docs/workflow_management/n8n-update-partial-workflow.ts`: Added intent parameter documentation
+
+**New Test Files:**
+- `tests/unit/telemetry/mutation-tracker.test.ts`: 13 comprehensive sanitization tests
+- `tests/unit/telemetry/mutation-validator.test.ts`: 22 validation tests
+
+**Test Coverage:**
+- Added 35 new unit tests for mutation tracking and validation
+- All 357 telemetry-related tests passing
+- Coverage includes sanitization, validation, intent classification, and auto-flush behavior
+
+#### Impact
+
+Users will experience more helpful and context-aware AI responses when working with workflows. The AI can better understand:
+- What changes the user is trying to make
+- Why certain operations succeed or fail
+- Common patterns and best practices
+- How to suggest relevant improvements
+
+This feature is completely privacy-focused with comprehensive sanitization to protect sensitive data while capturing the structural patterns needed for better AI assistance.
+
 ## [2.22.15] - 2025-11-11
 
 ### 🔄 Dependencies
diff --git a/package.json b/package.json
index c13410c..c47bdfe 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "n8n-mcp",
-  "version": "2.22.15",
+  "version": "2.22.16",
   "description": "Integration between n8n workflow automation and Model Context Protocol (MCP)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
diff --git a/package.runtime.json b/package.runtime.json
index c27188a..62c7e11 100644
--- a/package.runtime.json
+++ b/package.runtime.json
@@ -1,6 +1,6 @@
 {
   "name": "n8n-mcp-runtime",
-  "version": "2.22.14",
+  "version": "2.22.16",
   "description": "n8n MCP Server Runtime Dependencies Only",
   "private": true,
   "dependencies": {