ros/n8n-mcp
1
0
Fork 0
mirror of https://github.com/czlonkowski/n8n-mcp.git synced 2026-01-30 06:22:04 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
bb81f3d89456fc3245ca44b827e1e044863e7ed3
n8n-mcp/benchmarks/data.js

1548 lines
139 KiB
JavaScript
Raw Blame History

window.BENCHMARK_DATA = {
"lastUpdate": 1765993195926,
"repoUrl": "https://github.com/czlonkowski/n8n-mcp",
"entries": {
"n8n-mcp Benchmarks": [
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "b87f638e52d85ab77302f60293113d01d28a14ae",
"message": "Merge pull request #370 from czlonkowski/claude/version-bump-2.22.5-011CUTuNP2G3vGqSo8R9uubN\n\nchore: bump version to 2.22.5",
"timestamp": "2025-10-25T17:19:15+02:00",
"tree_id": "aad35ed51b6ec46de9a86a59e67c7189c02ba65d",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/b87f638e52d85ab77302f60293113d01d28a14ae"
},
"date": 1761405669681,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "ee7229b4dbef765f5dce6516787eb137fec4c8a2",
"message": "Merge pull request #372 from czlonkowski/fix/sync-package-runtime-version-2.22.3\n\nfix: resolve release workflow YAML parsing errors with script-based approach",
"timestamp": "2025-10-25T21:23:10+02:00",
"tree_id": "687db9045c0a0b78aba6c5468f67545d094020ab",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/ee7229b4dbef765f5dce6516787eb137fec4c8a2"
},
"date": 1761420304574,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "590dc087ac83acf7a1a2711abc086e9aeedb6fdd",
"message": "fix: resolve Docker port configuration mismatch (Issue #228) (#373)",
"timestamp": "2025-10-25T23:56:54+02:00",
"tree_id": "b750516e0ed62dce7dedc9e28c75a7c14adfdee8",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/590dc087ac83acf7a1a2711abc086e9aeedb6fdd"
},
"date": 1761429520889,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "892c4ed70a40c22c74155fe3625257a6e4988221",
"message": "Resolve GitHub Issue 292 in n8n-mcp (#375)\n\n* docs: add comprehensive documentation for removing node properties with undefined\n\nAdd detailed documentation section for property removal pattern in n8n_update_partial_workflow tool:\n- New \"Removing Properties with undefined\" section explaining the pattern\n- Examples showing basic, nested, and batch property removal\n- Migration guide for deprecated properties (continueOnFail → onError)\n- Best practices for when to use undefined\n- Pitfalls to avoid (null vs undefined, mutual exclusivity, etc.)\n\nThis addresses the documentation gap reported in issue #292 where users\nwere confused about how to remove properties during node updates.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: correct array property removal documentation in n8n_update_partial_workflow (Issue #292)\n\nFixed critical documentation error showing array index notation [0] which doesn't work.\nThe setNestedProperty implementation treats \"headers[0]\" as a literal object key, not an array index.\n\nChanges:\n- Updated nested property removal section to show entire array removal\n- Corrected example rm5 to use \"parameters.headers\" instead of \"parameters.headers[0]\"\n- Replaced misleading pitfall with accurate warning about array index notation not being supported\n\nImpact:\n- Prevents user confusion and non-functional code\n- All examples now show correct, working patterns\n- Clear warning helps users avoid this mistake\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-10-26T11:07:30+01:00",
"tree_id": "013b8088524cd46df3e8251f6fab3177df0abfda",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/892c4ed70a40c22c74155fe3625257a6e4988221"
},
"date": 1761473384397,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "3f427f952836fd35cb6d054a45d179d88b9cb37b",
"message": "Update n8n to 1.117.2 (#379)",
"timestamp": "2025-10-28T08:55:20+01:00",
"tree_id": "19b592c4b1b26554b72fb4d46e5c2c87afac7aea",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/3f427f952836fd35cb6d054a45d179d88b9cb37b"
},
"date": 1761638228013,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "af6efe9e888b1723855544dd7b7bbf0e03ef8d59",
"message": "chore: update n8n to 1.118.1 and bump version to 2.22.8 (#393)\n\n- Updated n8n from 1.117.2 to 1.118.1\n- Updated n8n-core from 1.116.0 to 1.117.0\n- Updated n8n-workflow from 1.114.0 to 1.115.0\n- Updated @n8n/n8n-nodes-langchain from 1.116.2 to 1.117.0\n- Rebuilt node database with 542 nodes (439 from n8n-nodes-base, 103 from @n8n/n8n-nodes-langchain)\n- Updated README badge with new n8n version\n- Updated CHANGELOG with dependency changes\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-03T22:27:56+01:00",
"tree_id": "e384071cfbed76fe227c9b79dcf8b59f75eae8a9",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/af6efe9e888b1723855544dd7b7bbf0e03ef8d59"
},
"date": 1762205387424,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "65f51ad8b5f3f95fa752ea0eb597c903eb99e27f",
"message": "chore: bump version to 2.22.9 (#395)\n\n* chore: bump version to 2.22.9\n\nUpdated version number to trigger release workflow after n8n 1.118.1 update.\nPrevious version 2.22.8 was already released on 2025-10-28, so the release\nworkflow did not trigger when PR #393 was merged.\n\nChanges:\n- Bump package.json version from 2.22.8 to 2.22.9\n- Update CHANGELOG.md with correct version and date\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* docs: update n8n update workflow with lessons learned\n\nAdded new fast workflow section based on 2025-11-04 update experience:\n- CRITICAL: Check existing releases first to avoid version conflicts\n- Skip local tests - CI runs them anyway (saves 2-3 min)\n- Integration test failures with 'unauthorized' are infrastructure issues\n- Release workflow only triggers on version CHANGE\n- Updated time estimates for fast vs full workflow\n\nThis will make future n8n updates smoother and faster.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: exclude versionCounter from workflow updates for n8n 1.118.1\n\nn8n 1.118.1 returns versionCounter in GET /workflows/{id} responses but\nrejects it in PUT /workflows/{id} updates with the error:\n'request/body must NOT have additional properties'\n\nThis was causing all integration tests to fail in CI with n8n 1.118.1.\n\nChanges:\n- Added versionCounter to excluded properties in cleanWorkflowForUpdate()\n- Tested and verified fix works with n8n 1.118.1 test instance\n\nFixes CI failures in PR #395\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* chore: improve versionCounter fix with types and tests\n\n- Add versionCounter type definition to Workflow and WorkflowExport interfaces\n- Add comprehensive test coverage for versionCounter exclusion\n- Update CHANGELOG with detailed bug fix documentation\n\nAddresses code review feedback from PR #395\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-04T11:33:54+01:00",
"tree_id": "b970df13ad4ec3c77e756ff21b994b94a8af6b1d",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/65f51ad8b5f3f95fa752ea0eb597c903eb99e27f"
},
"date": 1762252526334,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "a4ef1efaf87795bafda3e230ffb2c0b4e3fcb253",
"message": "fix: Gracefully handle FTS5 unavailability in sql.js fallback (#398)\n\nFixed critical startup crash when server falls back to sql.js adapter\ndue to Node.js version mismatches.\n\nProblem:\n- better-sqlite3 fails to load when Node runtime version differs from build version\n- Server falls back to sql.js (pure JS, no native dependencies)\n- Database health check crashed with \"no such module: fts5\"\n- Server exits immediately, preventing Claude Desktop connection\n\nSolution:\n- Wrapped FTS5 health check in try-catch block\n- Logs warning when FTS5 not available\n- Server continues with fallback search (LIKE queries)\n- Graceful degradation: works with any Node.js version\n\nImpact:\n- Server now starts successfully with sql.js fallback\n- Works with Node v20 (Claude Desktop) even when built with Node v22\n- Clear warnings about FTS5 unavailability\n- Users can choose: sql.js (slower, works everywhere) or rebuild better-sqlite3 (faster)\n\nFiles Changed:\n- src/mcp/server.ts: Added try-catch around FTS5 health check (lines 299-317)\n\nTesting:\n- ✅ Tested with Node v20.17.0 (Claude Desktop)\n- ✅ Tested with Node v22.17.0 (build version)\n- ✅ All 6 startup checkpoints pass\n- ✅ Database health check passes with warning\n\nFixes: Claude Desktop connection failures with Node.js version mismatches\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en",
"timestamp": "2025-11-04T16:14:16+01:00",
"tree_id": "dacb97a77111098208d181d2b2726235819bd78a",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/a4ef1efaf87795bafda3e230ffb2c0b4e3fcb253"
},
"date": 1762269350066,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "czlonkowski",
"username": "czlonkowski"
},
"committer": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "czlonkowski",
"username": "czlonkowski"
},
"distinct": true,
"id": "1834d474a52f5d111685bdbb7750ed5f951e4361",
"message": "update privacy policy",
"timestamp": "2025-11-06T00:20:36+01:00",
"tree_id": "606cdc1a54f4cddb6eb845474c6707376901d337",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/1834d474a52f5d111685bdbb7750ed5f951e4361"
},
"date": 1762384945651,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "0e0f0998af7fa8dd60fc014fbc0e99be8bc2c5ff",
"message": "Merge pull request #403 from czlonkowski/feat/workflow-activation-operations",
"timestamp": "2025-11-07T07:54:33+01:00",
"tree_id": "150a25e99e1083077a438e5281e6514f8ca7c2b1",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/0e0f0998af7fa8dd60fc014fbc0e99be8bc2c5ff"
},
"date": 1762498579070,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "eee52a7f5379cb016273495fc3f1f6b0ad4dc5c4",
"message": "Merge pull request #406 from czlonkowski/fix/helpful-error-changes-vs-updates\n\nfix: Add helpful error messages for 'changes' vs 'updates' parameter (Issue #392)",
"timestamp": "2025-11-08T13:39:26+01:00",
"tree_id": "9ddfce9b63ebcf1092de02cf6e9e8b7bdc0181f3",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/eee52a7f5379cb016273495fc3f1f6b0ad4dc5c4"
},
"date": 1762605671991,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "2010d77ed85d10979895d38045326c7ee2994d0b",
"message": "Merge pull request #407 from czlonkowski/feat/telemetry-quick-wins-validation-errors\n\nfeat: Telemetry-driven quick wins to reduce AI agent validation errors by 30-40%",
"timestamp": "2025-11-08T19:09:27+01:00",
"tree_id": "7834dc2d3600674efa5251b04885077c5f306175",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/2010d77ed85d10979895d38045326c7ee2994d0b"
},
"date": 1762625470818,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "14f3b9c12a7ecd1ff0f87e4e2de47b9c27b39cb7",
"message": "Merge pull request #411 from czlonkowski/feat/disabled-tools-env-var\n\nfeat: Add DISABLED_TOOLS environment variable for tool filtering (Issue #410)",
"timestamp": "2025-11-09T17:47:42+01:00",
"tree_id": "55a6d4ddc063c3618812f78e69588d6a96ea4447",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/14f3b9c12a7ecd1ff0f87e4e2de47b9c27b39cb7"
},
"date": 1762706960174,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "77151e013ee3fea15be34f009594bcde81edf8e2",
"message": "chore: update n8n to 1.119.1 (#414)",
"timestamp": "2025-11-11T22:28:50+01:00",
"tree_id": "cf928a8c8dd26cdf025396d3481748294ba10ecf",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/77151e013ee3fea15be34f009594bcde81edf8e2"
},
"date": 1762896649631,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "99c5907b71a6c3228d345a2f0879cd893f30cd7e",
"message": "feat: enhance workflow mutation telemetry for better AI responses (#419)\n\n* feat: add comprehensive telemetry for partial workflow updates\n\nImplement telemetry infrastructure to track workflow mutations from\npartial update operations. This enables data-driven improvements to\npartial update tooling by capturing:\n\n- Workflow state before and after mutations\n- User intent and operation patterns\n- Validation results and improvements\n- Change metrics (nodes/connections modified)\n- Success/failure rates and error patterns\n\nNew Components:\n- Intent classifier: Categorizes mutation patterns\n- Intent sanitizer: Removes PII from user instructions\n- Mutation validator: Ensures data quality before tracking\n- Mutation tracker: Coordinates validation and metric calculation\n\nExtended Components:\n- TelemetryManager: New trackWorkflowMutation() method\n- EventTracker: Mutation queue management\n- BatchProcessor: Mutation data flushing to Supabase\n\nMCP Tool Enhancements:\n- n8n_update_partial_workflow: Added optional 'intent' parameter\n- n8n_update_full_workflow: Added optional 'intent' parameter\n- Both tools now track mutations asynchronously\n\nDatabase Schema:\n- New workflow_mutations table with 20+ fields\n- Comprehensive indexes for efficient querying\n- Supports deduplication and data analysis\n\nThis telemetry system is:\n- Privacy-focused (PII sanitization, anonymized users)\n- Non-blocking (async tracking, silent failures)\n- Production-ready (batching, retries, circuit breaker)\n- Backward compatible (all parameters optional)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: correct SQL syntax for expression index in workflow_mutations schema\n\nThe expression index for significant changes needs double parentheses\naround the arithmetic expression to be valid PostgreSQL syntax.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: enable RLS policies for workflow_mutations table\n\nEnable Row-Level Security and add policies:\n- Allow anonymous (anon) inserts for telemetry data collection\n- Allow authenticated reads for data analysis and querying\n\nThese policies are required for the telemetry system to function\ncorrectly with Supabase, as the MCP server uses the anon key to\ninsert mutation data.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: reduce mutation auto-flush threshold from 5 to 2\n\nLower the auto-flush threshold for workflow mutations from 5 to 2 to ensure\nmore timely data persistence. Since mutations are less frequent than regular\ntelemetry events, a lower threshold provides:\n\n- Faster data persistence (don't wait for 5 mutations)\n- Better testing experience (easier to verify with fewer operations)\n- Reduced risk of data loss if process exits before threshold\n- More responsive telemetry for low-volume mutation scenarios\n\nThis complements the existing 5-second periodic flush and process exit\nhandlers, ensuring mutations are persisted promptly.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: improve mutation telemetry error logging and diagnostics\n\nChanges:\n- Upgrade error logging from debug to warn level for better visibility\n- Add diagnostic logging to track mutation processing\n- Log telemetry disabled state explicitly\n- Add context info (sessionId, intent, operationCount) to error logs\n- Remove 'await' from telemetry calls to make them truly non-blocking\n\nThis will help identify why mutations aren't being persisted to the\nworkflow_mutations table despite successful workflow operations.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* feat: enhance workflow mutation telemetry for better AI responses\n\nImprove workflow mutation tracking to capture comprehensive data that helps provide better responses when users update workflows. This enhancement collects workflow state, user intent, and operation details to enable more context-aware assistance.\n\nKey improvements:\n- Reduce auto-flush threshold from 5 to 2 for more reliable mutation tracking\n- Add comprehensive workflow and credential sanitization to mutation tracker\n- Document intent parameter in workflow update tools for better UX\n- Fix mutation queue handling in telemetry manager (flush now handles 3 queues)\n- Add extensive unit tests for mutation tracking and validation (35 new tests)\n\nTechnical changes:\n- mutation-tracker.ts: Multi-layer sanitization (workflow, node, parameter levels)\n- batch-processor.ts: Support mutation data flushing to Supabase\n- telemetry-manager.ts: Auto-flush mutations at threshold 2, track mutations queue\n- handlers-workflow-diff.ts: Track workflow mutations with sanitized data\n- Tests: 13 tests for mutation-tracker, 22 tests for mutation-validator\n\nThe intent parameter messaging emphasizes user benefit (\"helps to return better response\") rather than technical implementation details.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* chore: bump version to 2.22.16 with telemetry changelog\n\nUpdated package.json and package.runtime.json to version 2.22.16.\nAdded comprehensive CHANGELOG entry documenting workflow mutation\ntelemetry enhancements for better AI-powered workflow assistance.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: resolve TypeScript lint errors in telemetry tests\n\nFixed type issues in mutation-tracker and mutation-validator tests:\n- Import and use MutationToolName enum instead of string literals\n- Fix ValidationResult.errors to use proper object structure\n- Add UpdateNodeOperation type assertion for operation with nodeName\n\nAll TypeScript errors resolved, lint now passes.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-13T14:21:51+01:00",
"tree_id": "d0347d8622a8e263f3a11f66ce4df4416c1b9e70",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/99c5907b71a6c3228d345a2f0879cd893f30cd7e"
},
"date": 1763040232425,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "597bd290b69459c3b84bbd7cffc5e51c4aa0f28b",
"message": "fix: critical telemetry improvements for data quality and security (#421)\n\n* fix: critical telemetry improvements for data quality and security\n\nFixed three critical issues in workflow mutation telemetry:\n\n1. Fixed Inconsistent Sanitization (Security Critical)\n - Problem: 30% of workflows unsanitized, exposing credentials/tokens\n - Solution: Use robust WorkflowSanitizer.sanitizeWorkflowRaw()\n - Impact: 100% sanitization with 17 sensitive patterns redacted\n - Files: workflow-sanitizer.ts, mutation-tracker.ts\n\n2. Enabled Validation Data Capture (Data Quality)\n - Problem: Zero validation metrics captured (all NULL)\n - Solution: Add pre/post mutation validation with WorkflowValidator\n - Impact: Measure mutation quality, track error resolution\n - Non-blocking validation that captures errors/warnings\n - Files: handlers-workflow-diff.ts\n\n3. Improved Intent Capture (Data Quality)\n - Problem: 92.62% generic \"Partial workflow update\" intents\n - Solution: Enhanced docs + automatic intent inference\n - Impact: Meaningful intents auto-generated from operations\n - Files: n8n-update-partial-workflow.ts, handlers-workflow-diff.ts\n\nExpected Results:\n- 100% sanitization coverage (up from 70%)\n- 100% validation capture (up from 0%)\n- 50%+ meaningful intents (up from 7.33%)\n\nVersion bumped to 2.22.17\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* perf: implement validator instance caching to avoid redundant initialization\n\n- Add module-level cached WorkflowValidator instance\n- Create getValidator() helper to reuse validator across mutations\n- Update pre/post mutation validation to use cached instance\n- Avoids redundant NodeSimilarityService initialization on every mutation\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: restore backward-compatible sanitization with context preservation\n\nFixed CI test failures by updating WorkflowSanitizer to use pattern-specific\nplaceholders while maintaining backward compatibility:\n\nChanges:\n- Convert SENSITIVE_PATTERNS to PatternDefinition objects with specific placeholders\n- Update sanitizeString() to preserve context (Bearer prefix, URL paths)\n- Refactor sanitizeObject() to handle sensitive fields vs URL fields differently\n- Remove overly greedy field patterns that conflicted with token patterns\n\nPattern-specific placeholders:\n- [REDACTED_URL_WITH_AUTH] for URLs with credentials\n- [REDACTED_TOKEN] for long tokens (32+ chars)\n- [REDACTED_APIKEY] for OpenAI-style keys\n- Bearer [REDACTED] for Bearer tokens (preserves \"Bearer \" prefix)\n- [REDACTED] for generic sensitive fields\n\nTest Results:\n- All 13 mutation-tracker tests passing\n- URL with auth: preserves path after credentials\n- Long tokens: properly detected and marked\n- OpenAI keys: correctly identified\n- Bearer tokens: prefix preserved\n- Sensitive field names: generic redaction for non-URL fields\n\nFixes #421 CI failures\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: prevent double-redaction in workflow sanitizer\n\nAdded safeguard to stop pattern matching once a placeholder is detected,\npreventing token patterns from matching text inside placeholders like\n[REDACTED_URL_WITH_AUTH].\n\nAlso expanded database URL pattern to match full URLs including port and\npath, and updated test expectations to match context-preserving sanitization.\n\nFixes:\n- Database URLs now properly sanitized to [REDACTED_URL_WITH_AUTH]\n- Prevents [[REDACTED]] double-redaction issue\n- All 25 workflow-sanitizer tests passing\n- No regression in mutation-tracker tests\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-13T22:13:31+01:00",
"tree_id": "0f995c2058dd6eb68594208e60197f562f9acd12",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/597bd290b69459c3b84bbd7cffc5e51c4aa0f28b"
},
"date": 1763068523930,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "1bbfaabbc20f4989d81bc8a2cfc9f16795134ed8",
"message": "fix: add structural hash tracking for workflow mutations (#422)\n\n* feat: add structural hashes and success tracking for workflow mutations\n\nEnables cross-referencing workflow_mutations with telemetry_workflows by adding structural hashes (nodeTypes + connections) alongside existing full hashes.\n\n**Database Changes:**\n- Added workflow_structure_hash_before/after columns\n- Added is_truly_successful computed column\n- Created 3 analytics views: successful_mutations, mutation_training_data, mutations_with_workflow_quality\n- Created 2 helper functions: get_mutation_success_rate_by_intent(), get_mutation_crossref_stats()\n\n**Code Changes:**\n- Updated mutation-tracker.ts to generate both hash types\n- Updated mutation-types.ts with new fields\n- Auto-converts to snake_case via existing toSnakeCase() function\n\n**Testing:**\n- Added 5 new unit tests for structural hash generation\n- All 17 tests passing\n\n**Tooling:**\n- Created backfill script to populate hashes for existing 1,499 mutations\n- Created comprehensive documentation (STRUCTURAL_HASHES.md)\n\n**Impact:**\n- Before: 0% cross-reference match rate\n- After: Expected 60-70% match rate (post-backfill)\n- Unlocks quality impact analysis, training data curation, and mutation pattern insights\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n* fix: correct test operation types for structural hash tests\n\nFixed TypeScript errors in mutation-tracker tests by adding required\n'updates' parameter to updateNode operations. Used 'as any' for test\noperations to maintain backward compatibility while tests are updated.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* chore: remove documentation files from tracking\n\nRemoved internal documentation files from version control:\n- Telemetry implementation docs\n- Implementation roadmap\n- Disabled tools analysis docs\n\nThese files are for internal reference only.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* chore: remove telemetry documentation files from tracking\n\nRemoved all telemetry analysis and documentation files from root directory.\nThese files are for internal reference only and should not be in version control.\n\nFiles removed:\n- TELEMETRY_ANALYSIS*.md\n- TELEMETRY_MUTATION_SPEC.md\n- TELEMETRY_*_DATASET.md\n- VALIDATION_ANALYSIS*.md\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* chore: bump version to 2.22.18 and update CHANGELOG\n\nVersion 2.22.18 adds structural hash tracking for workflow mutations,\nenabling cross-referencing with workflow quality data and automated\nsuccess detection.\n\nKey changes:\n- Added workflowStructureHashBefore/After fields\n- Added isTrulySuccessful computed field\n- Enhanced mutation tracking with structural hashes\n- All tests passing (17/17)\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* chore: remove migration and documentation files from PR\n\nRemoved internal database migration files and documentation from\nversion control:\n- docs/migrations/\n- docs/telemetry/\n\nUpdated CHANGELOG to remove database migration references.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en",
"timestamp": "2025-11-14T13:57:54+01:00",
"tree_id": "7e4b59726deadbda59817c8cc790bc76dc07fdc0",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/1bbfaabbc20f4989d81bc8a2cfc9f16795134ed8"
},
"date": 1763125191377,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "5575630711733f121edf298a64c94ab971051243",
"message": "fix: eliminate stack overflow in session removal (#427) (#428)\n\nCritical bug fix for production crashes during session cleanup.\n\n**Root Cause:**\nInfinite recursion caused by circular event handler chain:\n- removeSession() called transport.close()\n- transport.close() triggered onclose event handler\n- onclose handler called removeSession() again\n- Loop continued until stack overflow\n\n**Solution:**\nDelete transport from registry BEFORE closing to break circular reference:\n1. Store transport reference\n2. Delete from this.transports first\n3. Close transport after deletion\n4. When onclose fires, transport no longer found, no recursion\n\n**Impact:**\n- Eliminates \"RangeError: Maximum call stack size exceeded\" errors\n- Fixes session cleanup crashes every 5 minutes in production\n- Prevents potential memory leaks from failed cleanup\n\n**Testing:**\n- Added regression test for infinite recursion prevention\n- All 39 session management tests pass\n- Build and typecheck succeed\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\nCloses #427",
"timestamp": "2025-11-18T17:41:17+01:00",
"tree_id": "805eca371f4ec079e7e97a0a2badeeecd7af28a2",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/5575630711733f121edf298a64c94ab971051243"
},
"date": 1763484189965,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "47d9f55dc55b600b953d885bad2dba729f5baecc",
"message": "chore: update n8n to 1.120.3 and bump version to 2.22.20 (#430)\n\n- Updated n8n from 1.119.1 to 1.120.3\n- Updated n8n-core from 1.118.0 to 1.119.2\n- Updated n8n-workflow from 1.116.0 to 1.117.0\n- Updated @n8n/n8n-nodes-langchain from 1.118.0 to 1.119.1\n- Rebuilt node database with 544 nodes (439 from n8n-nodes-base, 105 from @n8n/n8n-nodes-langchain)\n- Updated README badge with new n8n version\n- Updated CHANGELOG with dependency changes\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-19T11:31:51+01:00",
"tree_id": "89d14ead67bd7b1f340ea82e53fef8e96c82beec",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/47d9f55dc55b600b953d885bad2dba729f5baecc"
},
"date": 1763548440457,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "fc37907348692bf46ff60286354677a59bfa98f8",
"message": "fix: resolve empty settings validation error in workflow updates (#431) (#432)",
"timestamp": "2025-11-20T19:19:08+01:00",
"tree_id": "f8f8f5774ac636412fd1d434c4671e173586056b",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/fc37907348692bf46ff60286354677a59bfa98f8"
},
"date": 1763662852189,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "717d6f927fd863f82b5ecd23b56e01acc6835872",
"message": "Release v2.23.0: Type Structure Validation (Phases 1-4) (#434)\n\n* feat: implement Phase 1 - Type Structure Definitions\n\nPhase 1 Complete: Type definitions and service layer for all 22 n8n NodePropertyTypes\n\nNew Files:\n- src/types/type-structures.ts (273 lines)\n * TypeStructure and TypePropertyDefinition interfaces\n * Type guards: isComplexType, isPrimitiveType, isTypeStructure\n * ComplexPropertyType and PrimitivePropertyType unions\n\n- src/constants/type-structures.ts (677 lines)\n * Complete definitions for all 22 NodePropertyTypes\n * Structures for complex types (filter, resourceMapper, etc.)\n * COMPLEX_TYPE_EXAMPLES with real-world usage patterns\n\n- src/services/type-structure-service.ts (441 lines)\n * Static service class with 15 public methods\n * Type querying, validation, and metadata access\n * No database dependencies (code-only constants)\n\n- tests/unit/types/type-structures.test.ts (14 tests)\n- tests/unit/constants/type-structures.test.ts (39 tests)\n- tests/unit/services/type-structure-service.test.ts (64 tests)\n\nModified Files:\n- src/types/index.ts - Export new type-structures module\n\nTest Results:\n- 117 tests passing (100% pass rate)\n- 99.62% code coverage (exceeds 90% target)\n- Zero breaking changes\n\nKey Features:\n- Complete coverage of all 22 n8n NodePropertyTypes\n- Real-world examples from actual workflows\n- Validation infrastructure ready for Phase 2 integration\n- Follows project patterns (static services, type guards)\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* feat: implement Phase 2 type structure validation integration\n\nIntegrates TypeStructureService into EnhancedConfigValidator to validate\ncomplex property types (filter, resourceMapper, assignmentCollection,\nresourceLocator) against their expected structures.\n\n**Changes:**\n\n1. Enhanced Config Validator (src/services/enhanced-config-validator.ts):\n - Added `properties` parameter to `addOperationSpecificEnhancements()`\n - Implemented `validateSpecialTypeStructures()` - detects and validates special types\n - Implemented `validateComplexTypeStructure()` - deep validation for each type\n - Implemented `validateFilterOperations()` - validates filter operator/operation pairs\n\n2. Test Coverage (tests/unit/services/enhanced-config-validator-type-structures.test.ts):\n - 23 comprehensive test cases\n - Filter validation: combinator, conditions, operation compatibility\n - ResourceMapper validation: mappingMode values\n - AssignmentCollection validation: assignments array structure\n - ResourceLocator validation: mode and value fields (3 tests skipped for debugging)\n\n**Validation Features:**\n- ✅ Filter: Validates combinator ('and'/'or'), conditions array, operator types\n- ✅ Filter Operations: Type-specific operation validation (string, number, boolean, dateTime, array)\n- ✅ ResourceMapper: Validates mappingMode ('defineBelow'/'autoMapInputData')\n- ✅ AssignmentCollection: Validates assignments array presence and type\n- ⚠️ ResourceLocator: Basic validation (needs debugging - 3 tests skipped)\n\n**Test Results:**\n- 20/23 new tests passing (87% success rate)\n- 97+ existing tests still passing\n- ZERO breaking changes\n\n**Next Steps:**\n- Debug resourceLocator test failures\n- Integrate structure definitions into MCP tools (getNodeEssentials, getNodeInfo)\n- Update tools documentation\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: add type guard for condition.operator in validateFilterOperations\n\nAddresses code review warning W1 by adding explicit type checking\nfor condition.operator before accessing its properties.\n\nThis prevents potential runtime errors if operator is not an object.\n\n**Change:**\n- Added `typeof condition.operator !== 'object'` check in validateFilterOperations\n\n**Impact:**\n- More robust validation\n- Prevents edge case runtime errors\n- All tests still passing (20/23)\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* feat: complete Phase 3 real-world type structure validation\n\nImplemented and validated type structure definitions against 91 real-world\nworkflow templates from n8n.io with 100% pass rate.\n\n**Validation Results:**\n- Pass Rate: 100% (target: >95%) ✅\n- False Positive Rate: 0% (target: <5%) ✅\n- Avg Validation Time: 0.01ms (target: <50ms) ✅\n- Templates Tested: 91 templates, 616 nodes, 776 validations\n\n**Changes:**\n\n1. Filter Operations Enhancement (enhanced-config-validator.ts)\n - Added exists, notExists, isNotEmpty operations to all filter types\n - Fixed 6 validation errors for field existence checks\n - Operations now match real-world n8n workflow usage\n\n2. Google Sheets Node Validator (node-specific-validators.ts)\n - Added validateGoogleSheets() to filter credential-provided fields\n - Removes false positives for sheetId (comes from credentials at runtime)\n - Fixed 113 validation errors (91% of all failures)\n\n3. Phase 3 Validation Script (scripts/test-structure-validation.ts)\n - Loads and validates top 100 templates by popularity\n - Tests filter, resourceMapper, assignmentCollection, resourceLocator types\n - Generates detailed statistics and error reports\n - Supports compressed workflow data (gzip + base64)\n\n4. npm Script (package.json)\n - Added test:structure-validation script using tsx\n\nAll success criteria met for Phase 3 real-world validation.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: resolve duplicate validateGoogleSheets function (CRITICAL)\n\nFixed build-breaking duplicate function implementation found in code review.\n\n**Issue:**\n- Two validateGoogleSheets() implementations at lines 234 and 1717\n- Caused TypeScript compilation error: TS2393 duplicate function\n- Blocked all builds and deployments\n\n**Solution:**\n- Merged both implementations into single function at line 234\n- Removed sheetId validation check (comes from credentials)\n- Kept all operation-specific validation logic\n- Added error filtering at end to remove credential-provided field errors\n- Maintains 100% pass rate on Phase 3 validation (776/776 validations)\n\n**Validation Confirmed:**\n- TypeScript compilation: ✅ Success\n- Phase 3 validation: ✅ 100% pass rate maintained\n- All 4 special types: ✅ 100% pass rate (filter, resourceMapper, assignmentCollection, resourceLocator)\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* feat: complete Phase 3 real-world validation with 100% pass rate\n\nPhase 3: Real-World Type Structure Validation - COMPLETED\n\nResults:\n- 91 templates tested (616 nodes with special types)\n- 776 property validations performed\n- 100.00% pass rate (776/776 passed)\n- 0.00% false positive rate\n- 0.01ms average validation time (500x better than 50ms target)\n\nType-specific results:\n- filter: 93/93 passed (100.00%)\n- resourceMapper: 69/69 passed (100.00%)\n- assignmentCollection: 213/213 passed (100.00%)\n- resourceLocator: 401/401 passed (100.00%)\n\nChanges:\n- Add scripts/test-structure-validation.ts for standalone validation\n- Add integration test suite for real-world structure validation\n- Update implementation plan with Phase 3 completion details\n- All success criteria exceeded (>95% pass rate, <5% FP, <50ms)\n\nEdge cases fixed:\n- Filter operations: Added exists, notExists, isNotEmpty support\n- Google Sheets: Properly handle credential-provided fields\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* feat: complete Phase 4 documentation and polish\n\nPhase 4: Documentation & Polish - COMPLETED\n\nChanges:\n- Created docs/TYPE_STRUCTURE_VALIDATION.md (239 lines) - comprehensive technical reference\n- Updated CLAUDE.md with Phase 1-3 completion and architecture updates\n- Added minimal structure validation notes to tools-documentation.ts (progressive discovery)\n\nDocumentation approach:\n- Separate brief technical reference file (no README bloat)\n- Minimal one-line mentions in tools documentation\n- Comprehensive internal documentation (CLAUDE.md)\n- Respects progressive discovery principle\n\nAll Phase 1-4 complete:\n- Phase 1: Type Structure Definitions ✅\n- Phase 2: Validation Integration ✅\n- Phase 3: Real-World Validation ✅ (100% pass rate)\n- Phase 4: Documentation & Polish ✅\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: correct line counts and dates in Phase 4 documentation\n\nCode review feedback fixes:\n\n1. Fixed line counts in TYPE_STRUCTURE_VALIDATION.md:\n - Type Definitions: 273 → 301 lines (actual)\n - Type Structures: 677 → 741 lines (actual)\n - Service Layer: 441 → 427 lines (actual)\n\n2. Fixed completion dates:\n - Changed from 2025-01-21 to 2025-11-21 (November, not January)\n - Updated in both TYPE_STRUCTURE_VALIDATION.md and CLAUDE.md\n\n3. Enhanced filter example:\n - Added rightValue field for completeness\n - Example now shows complete filter condition structure\n\nAll corrections per code-reviewer agent feedback.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* chore: release v2.23.0 - Type Structure Validation (Phases 1-4)\n\nVersion bump from 2.22.21 to 2.23.0 (minor version bump for new backwards-compatible feature)\n\nChanges:\n- Comprehensive CHANGELOG.md entry documenting all 4 phases\n- Version bumped in package.json, package.runtime.json, package-lock.json\n- Database included (consistent with release pattern)\n\nType Structure Validation Feature (v2.23.0):\n- Phase 1: 22 complete type structures defined\n- Phase 2: Validation integrated in all MCP tools\n- Phase 3: 100% pass rate on 776 real-world validations (91 templates, 616 nodes)\n- Phase 4: Documentation and polish completed\n\nKey Metrics:\n- 100% pass rate on 776 validations\n- 0.01ms average validation time (500x faster than target)\n- 0% false positive rate\n- Zero breaking changes (100% backward compatible)\n- Automatic, zero-configuration operation\n\nSemantic Versioning:\n- Minor version bump (2.22.21 → 2.23.0) for new backwards-compatible feature\n- No breaking changes\n- All existing functionality preserved\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: update tests for Type Structure Validation improvements in v2.23.0\n\nCI test failures fixed for Type Structure Validation:\n\n1. Google Sheets validator test (node-specific-validators.test.ts:313-328)\n - Test now expects 'range' error instead of 'sheetId' error\n - sheetId is credential-provided and excluded from configuration validation\n - Validation correctly prioritizes user-provided fields\n\n2. If node workflow validation test (workflow-fixed-collection-validation.test.ts:164-178)\n - Test now expects 3 errors instead of 1\n - Type Structure Validation catches multiple filter structure errors:\n * Missing combinator field\n * Missing conditions field\n * Invalid nested structure (conditions.values)\n - Comprehensive error detection is correct behavior\n\nBoth tests now correctly verify the improved validation behavior introduced in the Type Structure Validation system (v2.23.0).\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-21T16:48:49+01:00",
"tree_id": "02e9112a0f58ca917879449878d2e26c54cb1452",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/717d6f927fd863f82b5ecd23b56e01acc6835872"
},
"date": 1763740253885,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "9050967cd6de4a8f2e3f067f2d093f111b8881c3",
"message": "Release v2.24.0: Unified get_node Tool with Code Review Fixes (#437)\n\n* feat(tools): unify node information retrieval with get_node tool\n\nImplements v2.24.0 featuring a unified node information tool that consolidates\nget_node_info and get_node_essentials functionality while adding version history\nand type structure metadata capabilities.\n\nKey Features:\n- Unified get_node tool with progressive detail levels (minimal/standard/full)\n- Version history access (versions, compare, breaking changes, migrations)\n- Type structure metadata integration from v2.23.0\n- Token-efficient defaults optimized for AI agents\n- Backward-compatible via private method preservation\n\nBreaking Changes:\n- Removed get_node_info tool (replaced by get_node with detail='full')\n- Removed get_node_essentials tool (replaced by get_node with detail='standard')\n- Tool count: 40 → 39 tools\n\nImplementation:\n- src/mcp/tools.ts: Added unified get_node tool definition\n- src/mcp/server.ts: Implemented getNode() with 7 mode-specific methods\n- Type structure integration via TypeStructureService.getStructure()\n- Updated documentation in CHANGELOG.md and README.md\n- Version bumped to 2.24.0\n\nToken Costs:\n- minimal: ~200 tokens (basic metadata)\n- standard: ~1000-2000 tokens (essential properties, default)\n- full: ~3000-8000 tokens (complete information)\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* docs: update tools-documentation.ts to reference unified get_node tool\n\nUpdated all references from deprecated get_node_essentials and get_node_info\nto the new unified get_node tool with appropriate detail levels.\n\nChanges:\n- Standard Workflow Pattern: Updated to show get_node with detail levels\n- Configuration Tools: Replaced two separate tool descriptions with unified get_node\n- Performance Characteristics: Updated to reference get_node detail levels\n- Usage Notes: Updated recommendation to use get_node with detail='standard'\n\nThis completes the v2.24.0 unified get_node tool implementation.\nAll 13/13 test scenarios passed in n8n-mcp-tester agent validation.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n* test: update tests to reference unified get_node tool\n\nUpdated test files to replace references to deprecated get_node_info and\nget_node_essentials tools with the new unified get_node tool.\n\nChanges:\n- tests/unit/mcp/tools.test.ts: Updated get_node tests and removed references\n to get_node_essentials in toolsWithExamples array and categories object\n- tests/unit/mcp/parameter-validation.test.ts: Updated all get_node_info\n references to get_node throughout the test suite\n\nTest results: Successfully reduced test failures from 11 to 3 non-critical failures:\n- 1 description length test (expected for unified tool with comprehensive docs)\n- 1 database initialization issue (test infrastructure, not related to changes)\n- 1 timeout issue (unrelated to changes)\n\nAll get_node_info → get_node migration tests now pass successfully.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n* fix: implement all code review fixes for v2.24.0 unified get_node tool\n\nComprehensive improvements addressing all critical, high-priority, and code quality issues identified in code review.\n\n## Critical Fixes (Phase 1)\n- Add missing getNode mock in parameter-validation tests\n- Shorten tool description from 670 to 288 characters (under 300 limit)\n\n## High Priority Fixes (Phase 2)\n- Add null safety check in enrichPropertyWithTypeInfo (prevent crashes on null properties)\n- Add nodeType context to all error messages in handleVersionMode (better debugging)\n- Optimize version summary fetch (conditional on detail level, skip for minimal mode)\n- Add comprehensive parameter validation for detail and mode with clear error messages\n\n## Code Quality Improvements (Phase 3)\n- Refactor property enrichment with new enrichPropertiesWithTypeInfo helper (eliminate duplication)\n- Add TypeScript interfaces for all return types (replace any with proper union types)\n- Implement version data caching with 24-hour TTL (improve performance)\n- Enhance JSDoc documentation with detailed parameter explanations\n\n## New TypeScript Interfaces\n- VersionSummary: Version metadata structure\n- NodeMinimalInfo: ~200 token response for minimal detail\n- NodeStandardInfo: ~1-2K token response for standard detail\n- NodeFullInfo: ~3-8K token response for full detail\n- VersionHistoryInfo: Version history response\n- VersionComparisonInfo: Version comparison response\n- NodeInfoResponse: Union type for all possible responses\n\n## Testing\n- All 130 test files passed (3778 tests, 42 skipped)\n- Build successful with no TypeScript errors\n- Proper test mocking for unified get_node tool\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: update integration tests to use unified get_node tool\n\nReplace all references to deprecated get_node_info and get_node_essentials\nwith the new unified get_node tool in integration tests.\n\n## Changes\n- Replace get_node_info → get_node in 6 integration test files\n- Replace get_node_essentials → get_node in 2 integration test files\n- All tool calls now use unified interface\n\n## Files Updated\n- tests/integration/mcp-protocol/error-handling.test.ts\n- tests/integration/mcp-protocol/performance.test.ts\n- tests/integration/mcp-protocol/session-management.test.ts\n- tests/integration/mcp-protocol/tool-invocation.test.ts\n- tests/integration/mcp-protocol/protocol-compliance.test.ts\n- tests/integration/telemetry/mcp-telemetry.test.ts\n\nThis fixes CI test failures caused by calling removed tools.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* test: add comprehensive tests for unified get_node tool\n\nAdd 81 comprehensive unit tests for the unified get_node tool to improve\ncode coverage of the v2.24.0 implementation.\n\n## Test Coverage\n\n### Parameter Validation (6 tests)\n- Invalid detail/mode validation with clear error messages\n- All valid parameter combinations\n- Default values and node type normalization\n\n### Info Mode Tests (21 tests)\n- Minimal detail: Basic metadata only, no version info (~200 tokens)\n- Standard detail: Essentials with version info (~1-2K tokens)\n- Full detail: Complete info with version info (~3-8K tokens)\n- includeTypeInfo and includeExamples parameter handling\n\n### Version Mode Tests (24 tests)\n- versions: Version history and details\n- compare: Version comparison with proper error handling\n- breaking: Breaking changes with upgradeSafe flags\n- migrations: Auto-migratable changes detection\n\n### Helper Methods (18 tests)\n- enrichPropertyWithTypeInfo: Null safety, type handling, structure hints\n- enrichPropertiesWithTypeInfo: Array handling, mixed properties\n- getVersionSummary: Caching with 24-hour TTL\n\n### Error Handling (3 tests)\n- Repository initialization checks\n- NodeType context in error messages\n- Invalid mode/detail handling\n\n### Integration Tests (8 tests)\n- Mode routing logic\n- Cache effectiveness across calls\n- Type safety validation\n- Edge cases (empty data, alternatives, long names)\n\n## Results\n- 81 tests passing\n- 100% coverage of new get_node methods\n- All parameter combinations tested\n- All error conditions covered\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: update integration test assertions for unified get_node tool\n\nUpdated integration tests to match the new unified get_node response structure:\n- error-handling.test.ts: Added detail='full' parameter for large payload test\n- tool-invocation.test.ts: Updated property assertions for standard/full detail levels\n- Fixed duplicate describe block and comparison logic\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: correct property names in integration test for standard detail\n\nUpdated test to check for requiredProperties and commonProperties\ninstead of essentialProperties to match actual get_node response structure.\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-24T17:06:21+01:00",
"tree_id": "7c2eb1bc27a182c2c5fde4b0fdbf5d3a7eb4e8b2",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/9050967cd6de4a8f2e3f067f2d093f111b8881c3"
},
"date": 1764000493345,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "05424f66af655c36deeb78e0cfceb5cbc9a9fd7f",
"message": "feat: Session Persistence API for Zero-Downtime Deployments (v2.24.1) (#438)\n\n* feat: Add session persistence API for zero-downtime deployments (v2.24.1)\n\nImplements export/restore functionality for MCP sessions to support container\nrestarts without losing user sessions. This enables zero-downtime deployments\nfor multi-tenant platforms and Kubernetes/Docker environments.\n\nNew Features:\n- exportSessionState() - Export active sessions to JSON\n- restoreSessionState() - Restore sessions from exported data\n- SessionState type - Serializable session structure\n- Comprehensive test suite (22 tests, 100% passing)\n\nImplementation Details:\n- Only exports sessions with valid n8nApiUrl and n8nApiKey\n- Automatically filters expired sessions (respects sessionTimeout)\n- Validates context structure using existing validation\n- Handles null/invalid sessions gracefully with warnings\n- Enforces MAX_SESSIONS limit during restore (100 sessions)\n- Dormant sessions recreate transport/server on first request\n\nFiles Modified:\n- src/http-server-single-session.ts: Core export/restore logic\n- src/mcp-engine.ts: Public API wrapper methods\n- src/types/session-state.ts: Type definitions\n- tests/: Comprehensive unit tests\n\nSecurity Note:\nSession data contains plaintext n8n API keys. Downstream applications\nMUST encrypt session data before persisting to disk.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* feat: implement 7 critical session persistence API fixes for production readiness\n\nThis commit implements all 7 critical fixes identified in the code review\nto make the session persistence API production-ready for zero-downtime\ncontainer deployments in multi-tenant environments.\n\nFixes implemented:\n1. Made instanceId optional in SessionState interface\n2. Removed redundant validation, properly using validateInstanceContext()\n3. Fixed race condition in MAX_SESSIONS check using real-time count\n4. Added comprehensive security logging with logSecurityEvent() helper\n5. Added duplicate session ID detection during export with Set tracking\n6. Added date parsing validation with isNaN checks for Invalid Date objects\n7. Restructured null checks for proper TypeScript type narrowing\n\nChanges:\n- src/types/session-state.ts: Made instanceId optional\n- src/http-server-single-session.ts: Implemented all validation and security fixes\n- tests/unit/http-server/session-persistence.test.ts: Fixed MAX_SESSIONS test\n\nAll 13 session persistence unit tests passing.\nAll 9 MCP engine session persistence tests passing.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-24T18:53:26+01:00",
"tree_id": "d6d24a33a7a1e3bc94294f00557b9f8bc2dd6d70",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/05424f66af655c36deeb78e0cfceb5cbc9a9fd7f"
},
"date": 1764006913151,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "ff69e4cccaf0008107072bfeda245b0dfec14c7c",
"message": "feat: Tool Consolidation - Reduce MCP Tools by 38% (v2.26.0) (#439)\n\n* feat: Remove 9 low-value tools and consolidate n8n_health_check (v2.25.0)\n\nTelemetry-driven tool cleanup to improve API clarity:\n\n**Removed Tools (9):**\n- list_nodes - Use search_nodes instead\n- list_ai_tools - Use search_nodes with isAITool filter\n- list_tasks - Low usage (0.02%)\n- get_database_statistics - Use n8n_health_check\n- list_templates - Use search_templates or get_templates_for_task\n- get_node_as_tool_info - Documented in get_node\n- validate_workflow_connections - Use validate_workflow\n- validate_workflow_expressions - Use validate_workflow\n- n8n_list_available_tools - Use n8n_health_check\n- n8n_diagnostic - Merged into n8n_health_check\n\n**Consolidated Tool:**\n- n8n_health_check now supports mode='diagnostic' for detailed troubleshooting\n\n**Tool Count:**\n- Before: 38 tools\n- After: 31 tools (18% reduction)\n\nConcieved by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.ai/code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: cleanup stale references and update tests after tool removal\n\n- Remove handleListAvailableTools dead code from handlers-n8n-manager.ts\n- Update error messages to reference n8n_health_check(mode=\"diagnostic\") instead of n8n_diagnostic\n- Update tool counts in diagnostic messages (14 doc tools, 31 total)\n- Fix error-handling.test.ts to use valid tools (search_nodes, tools_documentation)\n- Remove obsolete list-tools.test.ts integration tests\n- Remove unused ListToolsResponse type from response-types.ts\n- Update tools.ts QUICK REFERENCE to remove list_nodes references\n- Update tools-documentation.ts to remove references to removed tools\n- Update tool-docs files to remove stale relatedTools references\n- Fix tools.test.ts to not test removed tools (list_nodes, list_ai_tools, etc.)\n- Fix parameter-validation.test.ts to not test removed tools\n- Update handlers-n8n-manager.test.ts error message expectations\n\nAll 399 MCP unit tests now pass.\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: update integration tests to use valid tools after v2.25.0 removal\n\nReplaced all references to removed tools in integration tests:\n- list_nodes -> search_nodes\n- get_database_statistics -> tools_documentation\n- list_ai_tools -> search_nodes/tools_documentation\n- list_tasks -> tools_documentation\n- get_node_as_tool_info -> removed test section\n\nUpdated test files:\n- tests/integration/mcp-protocol/basic-connection.test.ts\n- tests/integration/mcp-protocol/performance.test.ts\n- tests/integration/mcp-protocol/session-management.test.ts\n- tests/integration/mcp-protocol/test-helpers.ts\n- tests/integration/mcp-protocol/tool-invocation.test.ts\n- tests/integration/telemetry/mcp-telemetry.test.ts\n- tests/unit/mcp/disabled-tools.test.ts\n- tests/unit/mcp/tools-documentation.test.ts\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* feat: Tool consolidation v2.26.0 - reduce tools by 38% (31 → 19)\n\nMajor consolidation of MCP tools using mode-based parameters for better\nAI agent ergonomics:\n\nNode Tools:\n- get_node_documentation → get_node with mode='documentation'\n- search_node_properties → get_node with mode='search_properties'\n- get_property_dependencies → removed\n\nValidation Tools:\n- validate_node_operation + validate_node_minimal → validate_node with mode param\n\nTemplate Tools:\n- list_node_templates → search_templates with searchMode='nodes'\n- search_templates_by_metadata → search_templates with searchMode='metadata'\n- get_templates_for_task → search_templates with searchMode='task'\n\nWorkflow Getters:\n- n8n_get_workflow_details/structure/minimal → n8n_get_workflow with mode param\n\nExecution Tools:\n- n8n_list/get/delete_execution → n8n_executions with action param\n\nTest updates for all consolidated tools.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* docs: comprehensive README update for v2.26.0 tool consolidation\n\n- Quick Start: Added hosted service (dashboard.n8n-mcp.com) as primary option\n- Self-hosting: Renamed options to A (npx), B (Docker), C (Local), D (Railway)\n- Removed: \"Memory Leak Fix (v2.20.2)\" section (outdated)\n- Removed: \"Known Issues\" section (outdated container management)\n- Claude Project Setup: Updated all tool references to v2.26.0 consolidated tools\n - validate_node({mode: 'minimal'|'full'}) instead of separate tools\n - search_templates({searchMode: ...}) unified template search\n - get_node({mode: 'docs'|'search_properties'}) for documentation\n - n8n_executions({action: ...}) unified execution management\n- Available MCP Tools: Updated to show 19 consolidated tools (7 core + 12 mgmt)\n- Recent Updates: Simplified to just link to CHANGELOG.md\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: update tool count from 31 to 19 in diagnostic message\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix(tests): update tool count expectations for v2.26.0\n\nUpdate handlers-n8n-manager.test.ts to expect new consolidated\ntool counts (7/12/19) after v2.26.0 tool consolidation.\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-25T18:39:00+01:00",
"tree_id": "a53dcf4b08f889d1e23f3c820e3820fde0b8db8a",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/ff69e4cccaf0008107072bfeda245b0dfec14c7c"
},
"date": 1764092468869,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "c974947c84f939475ad0a37c8ca3dfb998921550",
"message": "chore: update n8n to 1.121.2 (#441)\n\n* chore: update n8n to 1.121.2 and bump version to 2.26.1\n\n- Updated n8n from 1.120.3 to 1.121.2\n- Updated n8n-core from 1.119.2 to 1.120.1\n- Updated n8n-workflow from 1.117.0 to 1.118.1\n- Updated @n8n/n8n-nodes-langchain from 1.119.1 to 1.120.1\n- Rebuilt node database with 545 nodes (439 from n8n-nodes-base, 106 from @n8n/n8n-nodes-langchain)\n- Updated README badge with new n8n version\n- Updated CHANGELOG with dependency changes\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* chore: expand template database to 2,768 templates\n\n- Added 170 new workflow templates from n8n.io\n- Sanitized 27 templates containing API tokens\n- Updated CHANGELOG with template expansion info\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-25T19:21:26+01:00",
"tree_id": "b78a49195d5f03e525c29f33b86a92a70a63bf9a",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/c974947c84f939475ad0a37c8ca3dfb998921550"
},
"date": 1764095014574,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "1be06c217f088d6d9a7e273c773fe8ab1e8de7dc",
"message": "fix: synchronize tool documentation with v2.26.0 tool consolidation (v2.26.2) (#442)\n\n* fix: synchronize tool documentation with v2.26.0 tool consolidation (v2.26.2)\n\n- Delete 23 obsolete documentation files for removed tools\n- Create consolidated documentation for get_node, validate_node, n8n_executions\n- Update search_templates with all searchModes\n- Update n8n_get_workflow with all modes\n- Fix stale relatedTools references\n- Update tools-documentation.ts overview to reflect 19 consolidated tools\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: address code review - fix remaining stale tool references\n\n- Fix relatedTools in system/tools-documentation.ts (get_node_for_task → search_templates)\n- Fix relatedTools in validation/validate-workflow.ts (remove references to removed tools)\n- Fix relatedTools in n8n-autofix-workflow.ts (remove references to removed tools)\n- Update tools-n8n-friendly.ts with consolidated tools (validate_node, get_node, search_templates)\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: address final code review - fix remaining stale references\n\n- Fix ai-agents-guide.ts: get_node_essentials → get_node, remove list_ai_tools\n- Fix get-template.ts: list_node_templates → search_templates, remove get_templates_for_task\n- Fix n8n-list-workflows.ts: n8n_get_workflow_minimal → n8n_get_workflow, n8n_list_executions → n8n_executions\n- Fix n8n-trigger-webhook-workflow.ts: n8n_get_execution/n8n_list_executions → n8n_executions\n- Fix n8n-delete-workflow.ts: n8n_get_workflow_minimal → n8n_get_workflow, n8n_delete_execution → n8n_executions\n- Fix CHANGELOG date typo: 2025-01-25 → 2025-11-25\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* test: adjust comprehensive docs threshold after tool consolidation\n\nReduce expected character count from 5000 to 4000 in tool-invocation.test.ts\nto account for reduced documentation after v2.26.0 tool consolidation\n(31→19 tools, actual output is ~4645 chars).\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-25T21:28:11+01:00",
"tree_id": "985ac102ed667d28285a6fec8838582171744aa1",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/1be06c217f088d6d9a7e273c773fe8ab1e8de7dc"
},
"date": 1764102788423,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "25784142fe12ebaebde961f3488577311755cd05",
"message": "fix: address tools documentation gaps and outdated references (v2.26.3) (#443)",
"timestamp": "2025-11-26T00:57:15+01:00",
"tree_id": "adccab663f47aabed599b8585de91aa7a6e955eb",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/25784142fe12ebaebde961f3488577311755cd05"
},
"date": 1764115140293,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "bac4936c6d4b1c5675a893f18ba3ffcd2e58dc08",
"message": "fix: add n8n 1.121 availableInMCP and callerPolicy settings support (v2.26.4) (#445)\n\n* fix: add n8n 1.121 availableInMCP and callerPolicy settings support (v2.26.4)\n\nn8n 1.121 introduced a new workflow setting `availableInMCP` (boolean)\nthat controls whether a workflow is \"Available in MCP\". The sanitization\nwhitelist was missing this field, causing it to be silently stripped\nduring workflow updates.\n\nChanges:\n- Added `availableInMCP` to Zod schema in workflowSettingsSchema\n- Added `availableInMCP` and `callerPolicy` to safeSettingsProperties whitelist\n- Both settings are now preserved during workflow updates\n- Settings can be toggled via updateSettings operation\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n* test: update tests for callerPolicy and availableInMCP whitelist changes\n\nUpdated 5 tests in n8n-validation.test.ts that expected callerPolicy\nto be filtered out. Since callerPolicy and availableInMCP are now\nwhitelisted (n8n 1.121+), the tests now verify these settings are\npreserved during workflow updates.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-26T20:17:34+01:00",
"tree_id": "212b8cc8337c320b7564f184f2f686f1fd60557a",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/bac4936c6d4b1c5675a893f18ba3ffcd2e58dc08"
},
"date": 1764184761981,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "c7e7bda5051b1e3a28ecca2a174a4a82870edc2c",
"message": "fix: remove historical migration info from tools documentation (v2.26.5) (#448)\n\n- Remove \"Replaces X, Y, Z...\" sentences from full.description in:\n - get_node, validate_node, search_templates, n8n_executions, n8n_get_workflow\n- Remove version/issue references from n8n_update_partial_workflow\n- Clean up consolidation comments in index.ts\n- Documentation now starts directly with functional content\n- Estimated token savings: ~128 tokens per full documentation request\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-27T13:50:45+01:00",
"tree_id": "58364b70cce2ede7f3441e7f68a55122477feb12",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/c7e7bda5051b1e3a28ecca2a174a4a82870edc2c"
},
"date": 1764247962585,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "e7dd04b4710a652992d9ecbd7d69b182c23cebcc",
"message": "feat: add n8n_deploy_template tool for one-click template deployment (v2.27.0) (#453)\n\n* feat: add n8n_deploy_template tool for one-click template deployment (v2.27.0)\n\nAdd new MCP tool that deploys n8n.io workflow templates directly to user's\nn8n instance in a single operation.\n\nFeatures:\n- Fetch template from local database\n- Extract and report required credentials\n- Optionally strip credentials (default: true)\n- Optionally auto-upgrade node typeVersions (default: true)\n- Optionally validate before deployment (default: true)\n- Return workflow ID, URL, and setup guidance\n\nParameters:\n- templateId (required): Template ID from n8n.io\n- name (optional): Custom workflow name\n- autoUpgradeVersions (default: true)\n- validate (default: true)\n- stripCredentials (default: true)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: address code review findings for n8n_deploy_template\n\n- Fix health check tool count (12 → 13) to include new tool\n- Add templateId validation (must be positive integer)\n- Use deep copy of workflow to prevent template mutation\n- Expand unit tests with negative/zero/decimal validation cases\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* docs: update README with n8n_deploy_template tool\n\n- Update management tools count from 12 to 13\n- Add n8n_deploy_template to the tools list\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: prevent workflow validator from mutating node types\n\nThe validator was incorrectly mutating node types from full form\n(n8n-nodes-base.*) to short form (nodes-base.*) during validation.\nThis caused deployed workflows to show \"?\" icons in n8n UI because\nthe API requires full form node types.\n\nAlso updated SplitInBatches detection to check both node type forms\nsince workflows may contain either format.\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* test: update tool counts in handlers-n8n-manager test\n\nUpdate expected managementTools count from 12 to 13 and\ntotalAvailable from 19 to 20 to account for the new\nn8n_deploy_template tool.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: pin MCP SDK and Zod versions to prevent Zod v4 resolution\n\nFixes #440, #444, #446, #447, #450\n\nRoot cause: package.json declared `\"@modelcontextprotocol/sdk\": \"^1.20.1\"`\nwhich allowed npm to resolve to SDK 1.23.0. That version accepts\n`\"zod\": \"^3.25 || ^4.0\"`, causing npm to deduplicate to Zod v4.\nSDK 1.23.0's `isZ4Schema()` function crashes when called with undefined,\nwhich happens for plain JSON Schema objects.\n\nChanges:\n- Pin SDK to exact version 1.20.1 (removes ^ prefix)\n- Pin Zod to exact version 3.24.1 (removes ^ prefix)\n- Add CI workflow to verify fresh installs get compatible versions\n\nThe new CI workflow:\n- Packs and installs package fresh (without lockfile)\n- Verifies SDK is exactly 1.20.1\n- Verifies Zod is NOT v4 (blocks 4.x.x)\n- Runs weekly to catch upstream dependency changes\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* chore: improve dependency-check workflow based on code review\n\n- Add workflow_dispatch for manual triggering/debugging\n- Add explicit \"not found\" handling for version detection failures\n- Use regex pattern for Zod v4 check to catch pre-release versions\n- Add Zod error pattern detection in functionality test\n- Capture stderr output for comprehensive error checking\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-29T00:48:26+01:00",
"tree_id": "402722de3b63bd4c7f6488f3bdd5049535dfd2b6",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/e7dd04b4710a652992d9ecbd7d69b182c23cebcc"
},
"date": 1764373822081,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "7d9b45688718cdb186c2018d85f0acd19fb48148",
"message": "fix: pin MCP SDK version in Docker build files (v2.27.1) (#456)\n\n* fix: pin MCP SDK version in Docker build files (#454)\n\nThe Docker image 2.27.0 was missing the Zod fix from #450 because:\n- package.runtime.json had @modelcontextprotocol/sdk@^1.13.2\n- Dockerfile builder had @modelcontextprotocol/sdk@^1.12.1\n\nBoth now use the pinned version 1.20.1 (no caret) to match package.json.\nAlso pinned zod@3.24.1 in Dockerfile for consistency.\n\nFixes #454\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* chore: bump version to 2.27.1 and update CHANGELOG\n\n- Version bump from 2.27.0 to 2.27.1\n- Added CHANGELOG entry for #454 fix (Docker SDK version)\n- Added missing CHANGELOG entry for 2.27.0 (n8n_deploy_template)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-29T10:13:16+01:00",
"tree_id": "e744e19e2463d673547bb5c40cc7f9a46dc364ad",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/7d9b45688718cdb186c2018d85f0acd19fb48148"
},
"date": 1764407709248,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "ddf95567591a5b0a56e9df393e368969536fce3e",
"message": "feat: n8n_deploy_template deploy-first with auto-fix (v2.27.2) (#457)\n\n* feat: n8n_deploy_template deploy-first with auto-fix (v2.27.2)\n\nImproved template deployment to deploy first, then automatically fix common\nissues. This dramatically improves deployment success rates for templates\nwith expression format issues.\n\nKey Changes:\n- Deploy-first behavior: templates deployed before validation\n- Auto-fix runs automatically after deployment (configurable via `autoFix`)\n- Returns `fixesApplied` array showing all corrections made\n- Fixed expression validator \"nested expressions\" false positive\n- Fixed Zod schema missing `typeversion-upgrade` and `version-migration` fix types\n\nTesting: 87% deployment success rate across 15 diverse templates\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n* fix: address code review findings for deploy template\n\nCode review fixes:\n- CRITICAL: Update test schema to use `autoFix` instead of old `validate` parameter\n- WARNING: Add `AppliedFix` and `AutofixResultData` interfaces for type safety\n- WARNING: Add `autoFixStatus` field to response (success/failed/skipped)\n- WARNING: Report auto-fix failure in response message\n\nChanges:\n- tests/unit/mcp/handlers-deploy-template.test.ts: Fixed schema and test cases\n- src/mcp/handlers-n8n-manager.ts: Added type definitions, autoFixStatus tracking\n- src/mcp/tool-docs/workflow_management/n8n-deploy-template.ts: Updated docs\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-11-29T16:10:14+01:00",
"tree_id": "56b1723f2108688a5528e4ad0ca621e73aa41495",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/ddf95567591a5b0a56e9df393e368969536fce3e"
},
"date": 1764429114513,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "33690c5650e680b2c9cfbae75cac81a761742389",
"message": "feat: rename n8n_trigger_webhook_workflow to n8n_test_workflow with multi-trigger support (#460)\n\n* feat: rename n8n_trigger_webhook_workflow to n8n_test_workflow with multi-trigger support\n\n- Rename tool from n8n_trigger_webhook_workflow to n8n_test_workflow\n- Add support for webhook, form, and chat triggers (auto-detection)\n- Implement modular trigger system with registry pattern\n- Add trigger detector for automatic trigger type inference\n- Remove execute trigger type (n8n public API limitation)\n- Add comprehensive tests for trigger detection and handlers\n\nThe tool now auto-detects trigger type from workflow structure and\nsupports all externally-triggerable workflows via n8n's public API.\n\nNote: Direct workflow execution (Schedule/Manual triggers) requires\nn8n's instance-level MCP access, not available via REST API.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: add SSRF protection to webhook handler and update tests\n\n- Add SSRF URL validation to webhook-handler.ts (critical security fix)\n Aligns with existing SSRF protection in form-handler.ts and chat-handler.ts\n- Update parameter-validation.test.ts to use new n8n_test_workflow tool name\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* feat: n8n_test_workflow unified trigger tool (v2.28.0)\n\nAdded new `n8n_test_workflow` tool replacing `n8n_trigger_webhook_workflow`:\n\nFeatures:\n- Auto-detects trigger type (webhook/form/chat) from workflow\n- Supports multiple trigger types with type-specific parameters\n- SSRF protection for all trigger handlers\n- Extensible handler architecture with registry pattern\n\nChanges:\n- Fixed Zod schema to remove invalid 'execute' trigger type\n- Updated README.md tool documentation\n- Added CHANGELOG entry for v2.28.0\n- Bumped version to 2.28.0\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* test: add comprehensive unit tests for trigger handlers\n\nAdded 87 unit tests across 4 test files to improve code coverage:\n\n- base-handler.test.ts (19 tests) - 100% coverage\n- webhook-handler.test.ts (22 tests) - 100% coverage\n- chat-handler.test.ts (23 tests) - 100% coverage\n- form-handler.test.ts (23 tests) - 100% coverage\n\nTests cover:\n- Input validation and parameter handling\n- SSRF protection integration\n- HTTP method handling and URL building\n- Error response formatting\n- Execution paths for all trigger types\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-01T15:55:14+01:00",
"tree_id": "697e26aaef8badfb98fdaf88b436acabc949de93",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/33690c5650e680b2c9cfbae75cac81a761742389"
},
"date": 1764601040167,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "3188d209b78ad8267fb0afb70bf3050174116230",
"message": "fix: AI connection type propagation and get_node improvements (v2.28.1) (#461)\n\n* fix: AI connection type propagation and get_node improvements (v2.28.1)\n\nBug fixes:\n- Issue #458: addConnection now preserves AI connection types (ai_tool, ai_memory, ai_languageModel) instead of defaulting to 'main'\n- Fixed false positive \"AI Agent has no tools connected\" validation warning\n\nEnhancements:\n- Added expectedFormat field to resourceLocator properties in get_node output\n- Added versionNotice field to make typeVersion more prominent\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* test: add missing test coverage for PR #461 improvements\n\n- Added test for AI Agent validation positive case (tools properly connected)\n- Added 3 tests for expectedFormat on resourceLocator properties\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-01T18:54:15+01:00",
"tree_id": "22bdf426543cce8d7ff7a2cacc9e70eb68994bed",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/3188d209b78ad8267fb0afb70bf3050174116230"
},
"date": 1764611764753,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "ef9b6f634145fcb9434894c78ae7e082b9a88581",
"message": "fix: n8n_test_workflow webhookId resolution and form handling (v2.28.2) (#462)",
"timestamp": "2025-12-01T22:33:25+01:00",
"tree_id": "026244aca6861837436dd0bfadb89a84776aa77e",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/ef9b6f634145fcb9434894c78ae7e082b9a88581"
},
"date": 1764624920817,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "527e9874ab6b26b3dbae131f5259f81bac1cd1ab",
"message": "chore: update n8n to 1.122.4 and remove ludwig's templates (v2.28.3) (#463)\n\n- Updated n8n from 1.121.2 to 1.122.4\n- Updated n8n-core from 1.120.1 to 1.121.1\n- Updated n8n-workflow from 1.118.1 to 1.119.1\n- Updated @n8n/n8n-nodes-langchain from 1.120.1 to 1.121.1\n- Rebuilt node database with 544 nodes (438 from n8n-nodes-base, 106 from @n8n/n8n-nodes-langchain)\n- Removed 7 templates from creator \"ludwig\" at author's request (IDs: 2795, 2816, 2825, 2850, 2869, 2939, 3847)\n- Updated README badge with new n8n version\n- Updated CHANGELOG with dependency changes\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-03T00:11:41+01:00",
"tree_id": "72f7371af9598b14c1914c2b5a82b75d2b9d4851",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/527e9874ab6b26b3dbae131f5259f81bac1cd1ab"
},
"date": 1764717221232,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "c2dc7c9c51b08a975fa4a54737c79a9634bcbf36",
"message": "feat: configurable MAX_SESSIONS via N8N_MCP_MAX_SESSIONS env var (v2.28.4) (#469)\n\n* fix: n8n_test_workflow webhookId resolution and form handling (v2.28.2)\n\n## Bug Fixes\n\n- **webhookId Resolution**: Fixed trigger handlers using `node.id` instead of\n `node.webhookId` for building webhook URLs. This caused 404 errors when\n nodes had custom IDs.\n\n- **Chat Trigger URL**: Fixed chat triggers using wrong URL pattern. Now\n correctly uses `/webhook/<webhookId>/chat` endpoint.\n\n- **Form Content-Type**: Fixed form triggers failing with \"Expected\n multipart/form-data\" error by switching to proper multipart encoding.\n\n## Enhancements\n\n- **Form Field Types**: Added support for all n8n form field types (text,\n textarea, email, number, password, date, dropdown, checkbox, file, hidden)\n\n- **Checkbox Arrays**: Automatically converts arrays to `field[]` format\n\n- **Helpful Warnings**: Reports missing required fields with names and labels\n\n- **Error Hints**: Provides complete field structure on failure\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: address code review issues for form trigger improvements\n\n- Add form-data as direct dependency (was only in devDependencies)\n- Add TypeScript interfaces (FormFieldValue, FormFieldOption) replacing any types\n- Add FORM_FIELD_TYPES constants for type-safe switch statements\n- Add isValidBase64() validation for file uploads with size limits\n- Add MAX_FILE_SIZE_BYTES (10MB) constant with validation\n- Update form-handler.test.ts for FormData instead of JSON\n- Update trigger-detector.test.ts for chat URL /chat suffix\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* feat: configurable MAX_SESSIONS via N8N_MCP_MAX_SESSIONS env var (v2.28.3) (#468)\n\nMake MAX_SESSIONS limit configurable for multi-tenant SaaS deployments.\n\n- Add N8N_MCP_MAX_SESSIONS environment variable (default: 100)\n- Include safety floor with Math.max(1, ...) to prevent invalid configs\n- Update documentation in LIBRARY_USAGE.md, SESSION_PERSISTENCE.md\n- Update CLAUDE.md and CHANGELOG.md\n\nFixes #468\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: add QEMU setup for multi-arch Docker builds\n\nAdd docker/setup-qemu-action@v3 before Buildx setup to enable\nproper QEMU emulation for linux/arm64 builds on GitHub Actions.\n\nFixes CI Docker build failure with \"execve: No such file or directory\"\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>\nCo-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>",
"timestamp": "2025-12-05T11:17:51+01:00",
"tree_id": "4011272f947cb2dd5c9b3728b81b807c9a03ae81",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/c2dc7c9c51b08a975fa4a54737c79a9634bcbf36"
},
"date": 1764929993006,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"committer": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"distinct": true,
"id": "90407f845d61028d83c4c084e9a5f6b466a5558c",
"message": "fix: version-aware settings filtering for n8n API compatibility (#467)\n\nFixes #464, #465, #466\n\n- Add n8n version detection via /rest/settings endpoint\n- Filter workflow settings based on n8n version support:\n - All versions: 7 core properties\n - n8n 1.37.0+: adds executionOrder\n - n8n 1.119.0+: adds callerPolicy, callerIds, timeSavedPerExecution, availableInMCP\n- Add read-only field filtering (activeVersionId, activeVersion)\n- Version cache with 5-minute TTL for server upgrades\n- Race condition protection with promise-based locking\n- Type validation for version string responses\n\nThanks to @thesved for this contribution!\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-05T12:15:48+01:00",
"tree_id": "08daaed46e0df4dfbae917c9b8942cfcdf13b8fb",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/90407f845d61028d83c4c084e9a5f6b466a5558c"
},
"date": 1764933475477,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "60479e0eb47a7c83e77f36e2667a73e2e3ec115a",
"message": "test: update tests for v2.28.5 behavior changes (v2.28.6) (#470)\n\n- Update n8n-version tests: 'v' prefix now supported in version strings\n- Update n8n-validation tests: empty settings now return minimal defaults\n { executionOrder: 'v1' } instead of {} to avoid API rejection (Issue #431)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-05T13:38:06+01:00",
"tree_id": "399afed181c7f2e2552ec90c91b0418f9dcc6382",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/60479e0eb47a7c83e77f36e2667a73e2e3ec115a"
},
"date": 1764938407093,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "cdaa29e7a2445f1e84144965a7b803be00f6b760",
"message": "fix: memory leak in session removal - close MCP server properly (#471) (#472)\n\n- Add close() method to N8NDocumentationMCPServer that:\n - Calls server.close() (MCP SDK cleanup)\n - Clears internal cache\n - Nullifies service references to help GC\n- Update removeSession() to call server.close() before releasing references\n\nRoot cause: removeSession() deleted server from map but didn't call cleanup\nEvidence: Production server memory grew ~1GB in 43 minutes (10% to 35%)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-05T18:30:51+01:00",
"tree_id": "2e72fdb4e4336b7c17f579b885fbdeae90c0439c",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/cdaa29e7a2445f1e84144965a7b803be00f6b760"
},
"date": 1764955975115,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "560e0c5b86d5e44a1537b7c3299cdc5aff3f645e",
"message": "fix: pass context parameter to handleGetWorkflow in handleValidateWorkflow (#474) (#475)\n\nFixed n8n_validate_workflow tool failing in multi-tenant mode with error:\n\"n8n API not configured. Please set N8N_API_URL and N8N_API_KEY environment variables.\"\n\nRoot cause: handleValidateWorkflow called handleGetWorkflow without the context parameter.\n\nCloses #474\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-07T23:49:21+01:00",
"tree_id": "07ce244e8e060e3c75a1207dcd2602aafb70d65b",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/560e0c5b86d5e44a1537b7c3299cdc5aff3f645e"
},
"date": 1765147873707,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "130dd44ea5e6172870a1d6e2dd2ab789452ea819",
"message": "chore: update n8n to 1.123.4 and bump version to 2.28.9 (#478)\n\n- Updated n8n from 1.122.4 to 1.123.4\n- Updated n8n-core from 1.121.1 to 1.122.1\n- Updated n8n-workflow from 1.119.1 to 1.120.0\n- Updated @n8n/n8n-nodes-langchain from 1.121.1 to 1.122.1\n- Rebuilt node database with 545 nodes (439 from n8n-nodes-base, 106 from @n8n/n8n-nodes-langchain)\n- Updated README badge with new n8n version\n- Updated CHANGELOG with dependency changes\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-08T22:54:50+01:00",
"tree_id": "667d3a9dd9770565c0aa319255f0bf2110cbc2f5",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/130dd44ea5e6172870a1d6e2dd2ab789452ea819"
},
"date": 1765230995549,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "b92e5114634e52aee1fbb477396a21f8c229d470",
"message": "perf: optimize workflow tool responses for token efficiency (v2.29.0) (#479)\n\n* perf: optimize workflow tool responses for token efficiency (v2.29.0)\n\nReduce response sizes by 75-90% for 4 workflow management tools:\n\n- n8n_update_partial_workflow: Returns {id, name, active, operationsApplied}\n- n8n_create_workflow: Returns {id, name, active, nodeCount}\n- n8n_update_full_workflow: Returns {id, name, active, nodeCount}\n- n8n_delete_workflow: Returns {id, name, deleted: true}\n\nAI agents can use n8n_get_workflow with mode 'structure' if they need\nto verify the current workflow state after operations.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: update tests and add nodeCount to partial update response\n\n- Fix handleCreateWorkflow test to expect minimal response\n- Fix handleDeleteWorkflow test to expect minimal response\n- Add nodeCount to n8n_update_partial_workflow response for consistency\n- Update documentation and CHANGELOG\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: update handlers-workflow-diff tests for minimal response\n\nUpdate 3 more tests that expected full workflow in response:\n- should apply diff operations successfully\n- should activate workflow after successful update\n- should deactivate workflow after successful update\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\n\n* fix: update integration tests to use minimal response format\n\nIntegration tests now verify minimal response format and use\nclient.getWorkflow() to fetch actual workflow state for verification.\n\nConceived by Romuald Czlonkowski - www.aiadvisors.pl/en\n\n* fix: update create/update workflow integration tests for minimal response\n\nIntegration tests now verify minimal response and use client.getWorkflow()\nto fetch actual workflow state for detailed verification.\n\nConceived by Romuald Czlonkowski - www.aiadvisors.pl/en\n\n* fix: add type assertions to fix TypeScript errors in tests\n\nConceived by Romuald Czlonkowski - www.aiadvisors.pl/en\n\n---------\n\nCo-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-09T16:36:17+01:00",
"tree_id": "6120e3cad0bd15cbc7b0ab855182413de487bcb7",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/b92e5114634e52aee1fbb477396a21f8c229d470"
},
"date": 1765294674834,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "47510ef6dad95bfe463ca6e006ab9e9bd2b9a482",
"message": "feat: add Tool variant support for AI Agent integration (v2.29.1) (#484)\n\n* feat: add Tool variant support for AI Agent integration (v2.29.1)\n\nAdd comprehensive support for n8n Tool variants - specialized node versions\ncreated for AI Agent tool connections (e.g., nodes-base.supabaseTool from\nnodes-base.supabase).\n\nKey Features:\n- 266 Tool variants auto-generated during database rebuild\n- Bidirectional cross-references between base nodes and Tool variants\n- Clear AI guidance in get_node responses via toolVariantInfo object\n- Tool variants include toolDescription property and ai_tool output type\n\nDatabase Schema Changes:\n- Added is_tool_variant, tool_variant_of, has_tool_variant columns\n- Added indexes for efficient Tool variant queries\n\nFiles Changed:\n- src/database/schema.sql - New columns and indexes\n- src/parsers/node-parser.ts - Extended ParsedNode interface\n- src/services/tool-variant-generator.ts - NEW Tool variant generation\n- src/database/node-repository.ts - Store/retrieve Tool variant fields\n- src/scripts/rebuild.ts - Generate Tool variants during rebuild\n- src/mcp/server.ts - Add toolVariantInfo to get_node responses\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n* fix: address code review issues for Tool variant feature\n\n- Add input validation in ToolVariantGenerator.generateToolVariant()\n - Validate nodeType exists before use\n - Ensure properties is array before spreading\n- Fix isToolVariantNodeType() edge case\n - Add robust validation for package.nodeName pattern\n - Prevent false positives for nodes ending in 'Tool'\n- Add validation in NodeRepository.getToolVariant()\n - Validate node type format (must contain dot)\n- Add null check in buildToolVariantGuidance()\n - Check node.nodeType exists before concatenation\n- Extract magic number to constant in rebuild.ts\n - MIN_EXPECTED_TOOL_VARIANTS = 200 with documentation\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n* test: update unit tests for Tool variant schema changes\n\nUpdated node-repository-core.test.ts and node-repository-outputs.test.ts\nto include the new Tool variant columns (is_tool_variant, tool_variant_of,\nhas_tool_variant) in mock data and parameter position assertions.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n* feat: add validation and autofix for Tool variant corrections\n\n- Add validateAIToolSource() to detect base nodes incorrectly used as\n AI tools when Tool variant exists (e.g., supabase vs supabaseTool)\n- Add WRONG_NODE_TYPE_FOR_AI_TOOL error code with fix suggestions\n- Add tool-variant-correction fix type to WorkflowAutoFixer\n- Add toWorkflowFormat() method to NodeTypeNormalizer for converting\n database format back to n8n API format\n- Update ValidationIssue interface to include code and fix properties\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n* feat(v2.29.2): Tool variant validation, auto-fix, and comprehensive tests\n\nFeatures:\n- validateAIToolSource() detects base nodes incorrectly used as AI tools\n- WRONG_NODE_TYPE_FOR_AI_TOOL error with actionable fix suggestions\n- tool-variant-correction fix type in n8n_autofix_workflow\n- NodeTypeNormalizer.toWorkflowFormat() for db→API format conversion\n\nCode Review Improvements:\n- Removed duplicate database lookup in validateAIToolSource()\n- Exported ValidationIssue interface for downstream type safety\n- Added fallback description for fix operations\n\nTest Coverage (83 new tests):\n- 12 tests for workflow-validator-tool-variants\n- 13 tests for workflow-auto-fixer-tool-variants\n- 19 tests for toWorkflowFormat() in node-type-normalizer\n- Edge cases: langchain tools, unknown nodes, community nodes\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n* fix: skip templates validation test when templates not available\n\nThe real-world-structure-validation test was failing in CI because\ntemplates are not populated in the CI environment. Updated test to\ngracefully handle missing templates by checking availability in\nbeforeAll and skipping validation when templates are not present.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n* fix: increase memory threshold in performance test for CI variability\n\nThe memory efficiency test was failing in CI with ~23MB memory increase\nvs 20MB threshold. Increased threshold to 30MB to account for CI\nenvironment variability while still catching significant memory leaks.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>\nCo-authored-by: Claude Opus 4.5 <noreply@anthropic.com>",
"timestamp": "2025-12-12T12:51:38+01:00",
"tree_id": "af23f172e1a21379c9268081aa4f30b8ab792669",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/47510ef6dad95bfe463ca6e006ab9e9bd2b9a482"
},
"date": 1765540397564,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"committer": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"distinct": true,
"id": "fa7d0b420ec6be9688f83d148c39ed9912ff8adc",
"message": "ci: switch NPM publishing to Trusted Publishing (OIDC)\n\nReplace static NPM_TOKEN with OIDC-based authentication for improved\nsecurity. This uses NPM's Trusted Publishing feature which:\n- Eliminates need for long-lived tokens\n- Provides provenance attestation\n- Is the recommended approach by npm\n\nRequires configuring Trusted Publishing in npm package settings:\n- Repository owner: czlonkowski\n- Repository name: n8n-mcp\n- Workflow filename: release.yml\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>",
"timestamp": "2025-12-12T13:24:25+01:00",
"tree_id": "68a2ec850bbdd41aa04ad5bba72ed38fcef81f81",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/fa7d0b420ec6be9688f83d148c39ed9912ff8adc"
},
"date": 1765542755830,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"committer": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"distinct": true,
"id": "6e85c68d6259eb78b256f5ac4559ba3e665e0886",
"message": "chore: bump version to 2.29.3 to trigger OIDC publish\n\nThe previous workflow re-run used cached old workflow code with\nNPM_TOKEN. This version bump triggers a fresh workflow run with\nthe new OIDC Trusted Publishing configuration.\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>",
"timestamp": "2025-12-12T13:48:11+01:00",
"tree_id": "75e0a58025fd75c9285d68d7eca4cbc5f0ebb877",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/6e85c68d6259eb78b256f5ac4559ba3e665e0886"
},
"date": 1765543862564,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"committer": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"distinct": true,
"id": "c6f3733fbd6de37b1514f5800cb8d43bded30eee",
"message": "fix: upgrade npm for OIDC trusted publishing support\n\nOIDC trusted publishing requires npm >= 11.5.1, but Node.js 20/22\nships with npm 10.x. Added explicit npm upgrade step before publish.\n\nAlso upgraded to Node.js 22 for better npm compatibility.\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>",
"timestamp": "2025-12-12T14:17:23+01:00",
"tree_id": "9ba01f9525d17511d27acffe82237b3ec98b5e23",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/c6f3733fbd6de37b1514f5800cb8d43bded30eee"
},
"date": 1765545538067,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"committer": {
"email": "romualdczlonkowski@MacBook-Pro-Romuald.local",
"name": "Romuald Członkowski"
},
"distinct": true,
"id": "551445bcd5b8bd16fb273a3a129142e50401ed99",
"message": "fix: revert to Node 20 and use granular NPM token\n\nNPM classic tokens were revoked on Dec 9, 2025. OIDC trusted publishing\nrequires npm >= 11.5.1 which caused lockfile sync issues with npm ci.\n\nReverted to Node 20 with granular access token approach:\n- Removed OIDC permissions block\n- Removed npm upgrade step\n- Restored NODE_AUTH_TOKEN usage\n- Removed --provenance flag\n\nUser created new granular token with \"Bypass 2FA\" enabled.\n\nConceived by Romuald Członkowski - www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>",
"timestamp": "2025-12-12T16:22:04+01:00",
"tree_id": "ca956e8b4150654d91afa6662138a60406f46e99",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/551445bcd5b8bd16fb273a3a129142e50401ed99"
},
"date": 1765553025512,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "0f13e7aeee497d03c80e2a2e50227aed1e57a0a8",
"message": "chore: update n8n to 2.0.2 and bump version to 2.30.0 (#487)\n\n- Updated n8n from 1.123.4 to 2.0.2\n- Updated n8n-core from 1.122.1 to 2.0.1\n- Updated n8n-workflow from 1.120.0 to 2.0.1\n- Updated @n8n/n8n-nodes-langchain from 1.122.1 to 2.0.1\n- Rebuilt node database with 541 nodes (435 from n8n-nodes-base, 106 from @n8n/n8n-nodes-langchain)\n- Updated README badge with new n8n version\n- Updated CHANGELOG with dependency changes\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>\nCo-authored-by: Claude <noreply@anthropic.com>",
"timestamp": "2025-12-15T23:34:49+01:00",
"tree_id": "f137970fb5ce3f036135bb967cf55180407a7f4c",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/0f13e7aeee497d03c80e2a2e50227aed1e57a0a8"
},
"date": 1765838207599,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
},
{
"commit": {
"author": {
"email": "56956555+czlonkowski@users.noreply.github.com",
"name": "Romuald Członkowski",
"username": "czlonkowski"
},
"committer": {
"email": "noreply@github.com",
"name": "GitHub",
"username": "web-flow"
},
"distinct": true,
"id": "562f4b0c4ecb98d3e9c8993ea4a911f64a5d7c40",
"message": "feat: add _cnd conditional operator support and n8n 2.0+ executeWorkflowTrigger fix (#495)\n\n* feat: add _cnd conditional operator support and n8n 2.0+ executeWorkflowTrigger fix\n\nAdded:\n- Support for all 12 _cnd operators in displayOptions validation (eq, not, gte, lte, gt, lt, between, startsWith, endsWith, includes, regex, exists)\n- Version-based visibility checking with @version in config\n- 42 new unit tests for _cnd operators\n\nFixed:\n- n8n 2.0+ breaking change: executeWorkflowTrigger now recognized as activatable trigger\n- Removed outdated validation blocking Execute Workflow Trigger workflows\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n* fix: harden _cnd operators and add edge case tests\n\n- Add try/catch for invalid regex patterns in regex operator\n- Add structure validation for between operator (from/to fields)\n- Add 5 new edge case tests for invalid inputs\n- Bump version to 2.30.1\n- Resolve merge conflict with main (n8n 2.0 update)\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n* fix: update workflow activation tests for n8n 2.0+ executeWorkflowTrigger\n\n- Update test to expect SUCCESS for executeWorkflowTrigger-only workflows\n- Remove outdated assertion about \"executeWorkflowTrigger cannot activate\"\n- executeWorkflowTrigger is now a valid activatable trigger in n8n 2.0+\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n* test: skip flaky versionId test pending n8n 2.0 investigation\n\nThe versionId behavior appears to have changed in n8n 2.0 - simple\nname updates may no longer trigger versionId changes. This needs\ninvestigation but is unrelated to the _cnd operator PR.\n\nConceived by Romuald Członkowski - https://www.aiadvisors.pl/en\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>\nCo-authored-by: Claude Opus 4.5 <noreply@anthropic.com>",
"timestamp": "2025-12-17T18:37:55+01:00",
"tree_id": "77fb60c370c021171dab06a01f19e0d523c926ba",
"url": "https://github.com/czlonkowski/n8n-mcp/commit/562f4b0c4ecb98d3e9c8993ea4a911f64a5d7c40"
},
"date": 1765993195530,
"tool": "customSmallerIsBetter",
"benches": [
{
"name": "sample - array sorting - small",
"value": 0.0136,
"range": "0.3096",
"unit": "ms",
"extra": "73341 ops/sec"
}
]
}
]
}
}
Reference in New Issue View Git Blame Copy Permalink