From 61b54266b3664d00a224df3b91e680454f8b1c29 Mon Sep 17 00:00:00 2001
From: czlonkowski <56956555+czlonkowski@users.noreply.github.com>
Date: Sun, 14 Sep 2025 18:11:59 +0200
Subject: [PATCH] chore: bump version to 2.11.0

### Added
- Comprehensive template pagination with PaginatedResponse format
- New list_templates tool for efficient template browsing
- Flexible get_template modes (nodes_only, structure, full)

### Enhanced
- Gzip compression for workflow JSONs (84% size reduction)
- Template quality filtering (>10 views required)
- Database statistics now include template metrics

### Performance
- Database: 48MB for 2,596 templates (was 40MB for 499)
- Token usage: 80-90% reduction with new retrieval modes
- All 1,700+ tests passing
---
 docs/CHANGELOG.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++
 package-lock.json |  4 ++--
 package.json      |  2 +-
 3 files changed, 52 insertions(+), 3 deletions(-)

diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 5ff2add..8f640c7 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -7,6 +7,55 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.11.0] - 2025-01-14
+
+### Added
+- **Comprehensive Template Pagination**: All template search and list tools now return paginated responses
+  - Consistent `PaginatedResponse` format with `items`, `total`, `limit`, `offset`, and `hasMore` fields
+  - Customizable limits (1-100) and offset parameters for all template tools
+  - Count methods for accurate pagination information across all template queries
+- **New `list_templates` Tool**: Efficient browsing of all available templates
+  - Returns minimal data (id, name, views, nodeCount) for quick overview
+  - Supports sorting by views, created_at, or name
+  - Optimized for discovering templates without downloading full workflow data
+- **Flexible Template Retrieval Modes**: Enhanced `get_template` with three response modes
+  - `nodes_only`: Returns just node types and names (minimal tokens)
+  - `structure`: Returns nodes with positions and connections (moderate detail)
+  - `full`: Returns complete workflow JSON (default, maximum detail)
+  - Reduces token usage by 80-90% in minimal modes
+
+### Enhanced
+- **Template Database Compression**: Implemented gzip compression for workflow JSONs
+  - Workflow data compressed from ~75MB to 12.10MB (84% reduction)
+  - Database size reduced from 117MB to 48MB despite 5x more templates
+  - Transparent compression/decompression with base64 encoding
+  - No API changes - compression is handled internally
+- **Template Quality Filtering**: Automatic filtering of low-quality templates
+  - Templates with ≤10 views are excluded from the database
+  - Expanded coverage from 499 to 2,596 high-quality templates (5x increase)
+  - Filtered 4,505 raw templates down to 2,596 based on popularity
+  - Ensures AI agents work with proven, valuable workflows
+- **Enhanced Database Statistics**: Template metrics now included
+  - Shows total template count, average/min/max views
+  - Provides complete database overview including template coverage
+
+### Performance
+- **Database Optimization**: 59% size reduction while storing 5x more content
+  - Previous: ~40MB database with 499 templates
+  - Current: ~48MB database with 2,596 templates
+  - Without compression would be ~120MB+
+- **Token Efficiency**: 80-90% reduction in response size for minimal queries
+  - `list_templates`: ~10 tokens per template vs 100+ for full data
+  - `get_template` with `nodes_only`: Returns just essential node information
+  - Pagination prevents overwhelming responses for large result sets
+
+### Fixed
+- **Test Suite Compatibility**: Updated all tests for new template system
+  - Fixed parameter validation tests to expect new method signatures
+  - Updated integration tests to use templates with >10 views
+  - Removed redundant test files that were testing at wrong abstraction level
+  - All 1,700+ tests now passing
+
 ## [2.10.9] - 2025-01-09
 
 ### Changed
diff --git a/package-lock.json b/package-lock.json
index 3b47a9e..31e1925 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "n8n-mcp",
-  "version": "2.10.8",
+  "version": "2.11.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "n8n-mcp",
-      "version": "2.10.8",
+      "version": "2.11.0",
       "license": "MIT",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.13.2",
diff --git a/package.json b/package.json
index 571eb3b..33dd743 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "n8n-mcp",
-  "version": "2.10.9",
+  "version": "2.11.0",
   "description": "Integration between n8n workflow automation and Model Context Protocol (MCP)",
   "main": "dist/index.js",
   "bin": {