Commit Graph

132 Commits

Author SHA1 Message Date
czlonkowski
04e601b172 chore: update n8n to 1.118.1 and bump version to 2.22.8
- Updated n8n from 1.117.2 to 1.118.1
- Updated n8n-core from 1.116.0 to 1.117.0
- Updated n8n-workflow from 1.114.0 to 1.115.0
- Updated @n8n/n8n-nodes-langchain from 1.116.2 to 1.117.0
- Rebuilt node database with 542 nodes (439 from n8n-nodes-base, 103 from @n8n/n8n-nodes-langchain)
- Updated README badge with new n8n version
- Updated CHANGELOG with dependency changes

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

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 22:11:21 +01:00
Romuald Członkowski
3f427f9528 Update n8n to 1.117.2 (#379) 2025-10-28 08:55:20 +01:00
Daniel Ishi
749f1c53eb docs: Emphasize MCP_MODE=stdio requirement for Claude Desktop (#377)
Fixes #376

Without this environment variable, Claude Desktop shows JSON parsing errors
because debug logs contaminate the JSON-RPC stdout channel.

Added prominent warning to Quick Start section explaining:
- Why MCP_MODE=stdio is required
- What happens without it (JSON parse errors)
- How it prevents the issue (suppresses console output)

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

Co-authored-by: Claude Code Assistant <noreply@anthropic.com>
2025-10-27 22:40:44 +01:00
czlonkowski
aaa6be6d74 test: Add comprehensive unit tests for workflow versioning services
Add 158 unit tests (157 passing, 1 skipped) across 5 new test files to
achieve strong coverage of the workflow versioning and auto-update features.

New test files:
- workflow-versioning-service.test.ts (39 tests)
  * Version backup, restore, deletion, pruning
  * Version history and comparison
  * Storage statistics and auto-pruning
  * Edge cases: missing API, version not found, restore failures

- node-version-service.test.ts (37 tests)
  * Version discovery and caching (with TTL)
  * Version comparison and upgrade analysis
  * Breaking change detection and confidence scoring
  * Upgrade path suggestions and intermediate versions

- node-migration-service.test.ts (32 tests, 1 skipped)
  * Node parameter migrations (add/remove/rename/set default)
  * Webhook UUID generation
  * Nested property migrations
  * Batch workflow migrations with validation

- breaking-change-detector.test.ts (26 tests)
  * Registry-based and dynamic breaking change detection
  * Property additions/removals/requirement changes
  * Severity calculation and change merging
  * Nested property handling and recommendations

- post-update-validator.test.ts (24 tests)
  * Post-update guidance generation
  * Required actions and deprecated properties
  * Behavior change documentation (Execute Workflow, Webhook)
  * Migration steps, confidence calculation, time estimation

Also update README.md to include the new n8n_workflow_versions tool
in the Workflow Management tools section.

Coverage impact:
- Targets services with highest missing coverage from Codecov report
- Addresses 1630+ lines of missing coverage in new services
- Comprehensive mocking of dependencies (database, API clients)
- Follows existing test patterns from workflow-auto-fixer.test.ts

All tests use vitest with proper mocking, edge case coverage, and
deterministic assertions following project conventions.

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

Co-Authored-By: Claude <noreply@anthropic.com>

Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-24 11:40:03 +02:00
Romuald Członkowski
7300957d13 chore: update n8n to v1.116.2 (#348)
* docs: Update CLAUDE.md with development notes

* chore: update n8n to v1.116.2

- Updated n8n from 1.115.2 to 1.116.2
- Updated n8n-core from 1.114.0 to 1.115.1
- Updated n8n-workflow from 1.112.0 to 1.113.0
- Updated @n8n/n8n-nodes-langchain from 1.114.1 to 1.115.1
- Rebuilt node database with 542 nodes
- Updated version to 2.20.7
- Updated n8n version badge in README
- All changes will be validated in CI with full test suite

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

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

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: regenerate package-lock.json to sync with updated dependencies

Fixes CI failure caused by package-lock.json being out of sync with
the updated n8n dependencies.

- Regenerated with npm install to ensure all dependency versions match
- Resolves "npm ci" sync errors in CI pipeline

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

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: align FTS5 tests with production boosting logic

Tests were failing because they used raw FTS5 ranking instead of the
exact-match boosting logic that production uses. Updated both test files
to replicate production search behavior from src/mcp/server.ts.

- Updated node-fts5-search.test.ts to use production boosting
- Updated database-population.test.ts to use production boosting
- Both tests now use JOIN + CASE statement for exact-match prioritization

This makes tests more accurate and less brittle to FTS5 ranking changes.

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

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: prioritize exact matches in FTS5 search with case-insensitive comparison

Root cause: SQL ORDER BY was sorting by FTS5 rank first, then CASE statement.
Since ranks are unique, the CASE boosting never applied. Additionally, the
CASE statement used case-sensitive comparison which failed to match nodes
like "Webhook" when searching for "webhook".

Changes:
- Changed ORDER BY from "rank, CASE" to "CASE, rank" in production code
- Added LOWER() for case-insensitive exact match detection
- Updated both test files to match the corrected SQL logic
- Exact matches now consistently rank first regardless of FTS5 score

Impact:
- Improves search quality by ensuring exact matches appear first
- More efficient SQL (less JavaScript sorting needed)
- Tests now accurately validate production search behavior
- Fixes 2/705 failing integration tests

Verified:
- Both tests pass locally after fix
- SQL query tested with SQLite CLI showing webhook ranks 1st

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

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: update CHANGELOG with FTS5 search fix details

Added comprehensive documentation for the FTS5 search ranking bug fix:
- Problem description with SQL examples showing wrong ORDER BY
- Root cause analysis explaining why CASE statement never applied
- Case-sensitivity issue details
- Complete fix description for production code and tests
- Impact section covering search quality, performance, and testing
- Verified search results showing exact matches ranking first

This documents the critical bug fix that ensures exact matches
appear first in search results (webhook, http, code, etc.) with
case-insensitive matching.

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

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-10-22 10:28:32 +02:00
Romuald Członkowski
dbdc88d629 feat: Add Claude Skills documentation and setup guide (#344)
* feat: Add Claude Skills documentation and setup guide

- Added skills section to README.md with video thumbnail
- Added detailed skills installation guide to Claude Code setup
- Included new skills.png image for video preview
- Referenced n8n-skills repository for all 7 complementary skills

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

* feat: Add YouTube video link to skills documentation

- Updated placeholder with actual YouTube video URL
- Video demonstrates skills setup and usage

Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-21 18:57:49 +02:00
Darien Kindlund
41830c88fe fix: clarified n8n_update_partial_workflow instructions in system message (#336)
* fix: clarified n8n_update_partial_workflow instructions in system message

* fix: document IF node branch parameter for addConnection operations

Add critical documentation for using the `branch` parameter when connecting
IF nodes with addConnection operations. Without this parameter, both TRUE
and FALSE outputs route to the same destination, causing logic errors.

Includes:
- Examples of branch="true" and branch="false" usage
- Common pattern for complete IF node routing
- Warning about omitting the branch parameter

Related to GitHub Issue #327

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

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-10-18 22:17:22 +02:00
Romuald Członkowski
0d2d9bdd52 fix: Critical memory leak in sql.js adapter (fixes #330) (#335)
* fix: Critical memory leak in sql.js adapter (fixes #330)

Resolves critical memory leak causing growth from 100Mi to 2.2GB over 72 hours in Docker/Kubernetes deployments.

Problem Analysis:
- Environment: Kubernetes/Docker using sql.js fallback
- Growth rate: ~23 MB/hour (444Mi after 19 hours)
- Pattern: Linear accumulation, garbage collection couldn't keep pace
- Impact: OOM kills every 24-48 hours in memory-limited pods

Root Causes:
1. Over-aggressive save triggering: prepare() called scheduleSave() on reads
2. Too frequent saves: 100ms debounce = 3-5 saves/second under load
3. Double allocation: Buffer.from() copied Uint8Array (4-10MB per save)
4. No cleanup: Relied solely on GC which couldn't keep pace
5. Docker limitation: Missing build tools forced sql.js instead of better-sqlite3

Code-Level Fixes (sql.js optimization):
 Removed scheduleSave() from prepare() (read operations don't modify DB)
 Increased debounce: 100ms → 5000ms (98% reduction in save frequency)
 Removed Buffer.from() copy (50% reduction in temporary allocations)
 Made save interval configurable via SQLJS_SAVE_INTERVAL_MS env var
 Added input validation (minimum 100ms, falls back to 5000ms default)

Infrastructure Fix (Dockerfile):
 Added build tools (python3, make, g++) to main Dockerfile
 Compile better-sqlite3 during npm install, then remove build tools
 Image size increase: ~5-10MB (acceptable for eliminating memory leak)
 Railway Dockerfile already had build tools (added explanatory comment)

Impact:
With better-sqlite3 (now default in Docker):
- Memory: Stable at ~100-120 MB (native SQLite)
- Performance: Better than sql.js (no WASM overhead)
- No periodic saves needed (writes directly to disk)
- Eliminates memory leak entirely

With sql.js (fallback only):
- Memory: Stable at 150-200 MB (vs 2.2GB after 3 days)
- No OOM kills in long-running Kubernetes pods
- Reduced CPU usage (98% fewer disk writes)
- Same data safety (5-second save window acceptable)

Configuration:
- New env var: SQLJS_SAVE_INTERVAL_MS (default: 5000)
- Only relevant when sql.js fallback is used
- Minimum: 100ms, invalid values fall back to default

Testing:
 All unit tests passing
 New integration tests for memory leak prevention
 TypeScript compilation successful
 Docker builds verified (build tools working)

Files Modified:
- src/database/database-adapter.ts: SQLJSAdapter optimization
- Dockerfile: Added build tools for better-sqlite3
- Dockerfile.railway: Added documentation comment
- tests/unit/database/database-adapter-unit.test.ts: New test suites
- tests/integration/database/sqljs-memory-leak.test.ts: Integration tests
- package.json: Version bump to 2.20.2
- package.runtime.json: Version bump to 2.20.2
- CHANGELOG.md: Comprehensive v2.20.2 entry
- README.md: Database & Memory Configuration section

Closes #330

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

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: Address code review findings for memory leak fix (#330)

## Code Review Fixes

1. **Test Assertion Error (line 292)** - CRITICAL
   - Fixed incorrect assertion in sqljs-memory-leak test
   - Changed from `expect(saveCallback).toBeLessThan(10)`
   - To: `expect(saveCallback.mock.calls.length).toBeLessThan(10)`
   -  Test now passes (12/12 tests passing)

2. **Upper Bound Validation**
   - Added maximum value validation for SQLJS_SAVE_INTERVAL_MS
   - Valid range: 100ms - 60000ms (1 minute)
   - Falls back to default 5000ms if out of range
   - Location: database-adapter.ts:255

3. **Railway Dockerfile Optimization**
   - Removed build tools after installing dependencies
   - Reduces image size by ~50-100MB
   - Pattern: install → build native modules → remove tools
   - Location: Dockerfile.railway:38-41

4. **Defensive Programming**
   - Added `closed` flag to prevent double-close issues
   - Early return if already closed
   - Location: database-adapter.ts:236, 283-286

5. **Documentation Improvements**
   - Added comprehensive comments for DEFAULT_SAVE_INTERVAL_MS
   - Documented data loss window trade-off (5 seconds)
   - Explained constructor optimization (no initial save)
   - Clarified scheduleSave() debouncing under load

6. **CHANGELOG Accuracy**
   - Fixed discrepancy about explicit cleanup
   - Updated to reflect automatic cleanup via function scope
   - Removed misleading `data = null` reference

## Verification

-  Build: Success
-  Lint: No errors
-  Critical test: sqljs-memory-leak (12/12 passing)
-  All code review findings addressed

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

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-10-18 22:11:27 +02:00
Romuald Członkowski
4399899255 chore: update n8n to 1.115.2 and bump version to 2.18.11 (#323)
- Updated n8n to ^1.115.2 (from ^1.114.3)
- Updated n8n-core to ^1.114.0 (from ^1.113.1)
- Updated n8n-workflow to ^1.112.0 (from ^1.111.0)
- Updated @n8n/n8n-nodes-langchain to ^1.114.1 (from ^1.113.1)
- Rebuilt node database with 537 nodes (increased from 525)
- All 1,181 functional tests passing (1 flaky performance test)
- All validation tests passing
- Built and ready for deployment
- Updated README n8n version badge
- Updated CHANGELOG.md

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

Co-authored-by: Claude <noreply@anthropic.com>
2025-10-14 11:08:25 +02:00
czlonkowski
978347e8d0 tick fix 2025-10-09 23:37:09 +02:00
czlonkowski
1b7dd3b517 docs: add top 20 most used n8n nodes to Claude Project Setup
- Added list of most popular nodes based on telemetry data (16,211 workflows)
- Includes full nodeType identifiers for easy reference
- Helps AI assistants prioritize commonly-used nodes
- Data sourced from real-world usage analysis
2025-10-09 23:33:35 +02:00
czlonkowski
73fa494735 chore: bump version to 2.17.2 and update badges
- Version: 2.17.1 → 2.17.2
- Updated n8n badge: 1.113.3 → 1.114.3

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-07 14:26:19 +02:00
czlonkowski
4cf8bb5c98 release: version 2.17.0 - AI workflow validation fixes
PHASE 4 COMPLETE: Documentation and version bump

### Documentation Updates
- README.md: Added AI workflow validation features section
  - Missing language model detection
  - AI tool connection validation
  - Streaming mode constraints
  - Memory and output parser checks

- CHANGELOG.md: Comprehensive v2.17.0 release notes
  - Fixed 4 critical bugs (HIGH-01, HIGH-04, HIGH-08, MEDIUM-02)
  - Node type normalization bug details
  - Streaming mode validation enhancements
  - Examples retrieval fix
  - All 25 AI validator tests passing

### Version Bump
- package.json: 2.16.3 → 2.17.0

### Impact Summary
This release fixes critical bugs that caused ALL AI validation to be
silently skipped. Before this fix, 0% of AI validation was functional.

**What's Fixed:**
-  Missing language model detection (HIGH-01)
-  AI tool connection detection (HIGH-04)
-  Streaming mode validation (HIGH-08)
-  get_node_essentials examples (MEDIUM-02)

**Test Results:**
- All 25 AI validator tests: PASS (100%)
- Overall test improvement: 37.5% → 62.5%+ (+67%)
- Debug scenarios: 3/3 PASS

**Breaking Change:**
AI validation now actually runs (was completely non-functional before)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-06 23:58:11 +02:00
czlonkowski
06cbb40213 feat: implement security audit fixes - rate limiting and SSRF protection (Issue #265 PR #2)
This commit implements HIGH-02 (Rate Limiting) and HIGH-03 (SSRF Protection)
from the security audit, protecting against brute force attacks and
Server-Side Request Forgery.

Security Enhancements:
- Rate limiting: 20 attempts per 15 minutes per IP (configurable)
- SSRF protection: Three security modes (strict/moderate/permissive)
- DNS rebinding prevention
- Cloud metadata blocking in all modes

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-06 15:40:07 +02:00
czlonkowski
1c56eb0daa docs: update test statistics to 3,336 tests with Phase 8 n8n API integration tests
Updates documentation with accurate test counts following completion of Phase 8:

**Test Statistics:**
- Total: 3,336 tests (was 2,883)
- Unit tests: 2,766 tests
- Integration tests: 570 tests
  - n8n API Integration: 172 tests (all 18 MCP handlers)
  - Database: 226 tests
  - MCP Protocol: 119 tests
  - Templates & Docker: 53 tests

**Updated Files:**
- README.md: Updated badge and Testing Architecture section
- docs/testing-architecture.md: Comprehensive update with detailed breakdown

**Key Additions:**
- Complete coverage of n8n API integration tests (Phase 1-8)
- TypeScript type safety with response interfaces
- Detailed test organization by component and handler type
- Updated execution time estimates

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-05 11:56:35 +02:00
czlonkowski
9380602439 fix: resolve code fence rendering issue in Claude Project Setup section
- Change outer markdown fence from 3 to 4 backticks to prevent nested code blocks from breaking the fence
- Update code block labels from 'javascript' to 'json' for MCP tool parameters to avoid confusion
- Remove language labels from workflow example blocks (mixed content with annotations)

Fixes #260

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-05 09:58:55 +02:00
czlonkowski
d875ac1e0c fix(p0): remove incorrect node type normalization before n8n API calls
## Bug Description
handleCreateWorkflow and handleUpdateFullWorkflow were incorrectly
normalizing node types from FULL form (n8n-nodes-base.webhook) to
SHORT form (nodes-base.webhook) before validation and API calls.

This caused 100% failure rate for workflow creation because:
- n8n API requires FULL form (n8n-nodes-base.*)
- Database stores SHORT form (nodes-base.*)
- NodeTypeNormalizer converts TO SHORT form (for database)
- But was being used BEFORE API calls (incorrect)

## Root Cause
NodeTypeNormalizer was designed for database lookups but was
incorrectly applied to API operations. The method name
`normalizeToFullForm()` is misleading - it actually normalizes
TO SHORT form.

## Changes
1. handlers-n8n-manager.ts:
   - Removed NodeTypeNormalizer.normalizeWorkflowNodeTypes() from
     handleCreateWorkflow (line 288)
   - Removed normalization from handleUpdateFullWorkflow (line 544-557)
   - Added proactive SHORT form detection with helpful errors
   - Added comments explaining n8n API expects FULL form

2. node-type-normalizer.ts:
   - Added prominent WARNING about not using before API calls
   - Added examples showing CORRECT vs INCORRECT usage
   - Clarified this is FOR DATABASE OPERATIONS ONLY

3. handlers-n8n-manager.test.ts:
   - Fixed test to expect FULL form (not SHORT) sent to API
   - Removed incorrect expectedNormalizedInput assertion

4. NEW: workflow-creation-node-type-format.test.ts:
   - 7 integration tests with real validation (unmocked)
   - Tests FULL form acceptance, SHORT form rejection
   - Tests real-world workflows (webhook, schedule trigger)
   - Regression test to prevent bug reintroduction

## Verification
Before fix:
 Manual Trigger → Set: FAILED
 Webhook → HTTP Request: FAILED
Failure rate: 100%

After fix:
 Manual Trigger → Set: SUCCESS (ID: kTAaDZwdpzj8gqzM)
 Webhook → HTTP Request: SUCCESS (ID: aPtQUb54uuHIqX52)
 All 39 tests passing (32 unit + 7 integration)
Success rate: 100%

## Impact
- Fixes: Complete blocking bug preventing all workflow creation
- Risk: Zero (removing buggy behavior)
- Breaking: None (external API unchanged)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-03 11:43:49 +02:00
czlonkowski
5bf1bc46e9 docs: update README to reflect v2.15.0 changes
- Remove all references to deprecated get_node_for_task tool
- Add includeExamples parameter documentation for search_nodes and get_node_essentials
- Update Claude Project instructions with new template-based examples approach
- Update example usage to show includeExamples parameter
- Add template configuration metrics (2,646 pre-extracted configs)
- Update n8n version to v1.113.3
- Update Features section to highlight real-world examples and template library
- Update Overview section with template metrics
2025-10-03 09:14:04 +02:00
czlonkowski
87cc84f593 chore: update n8n to v1.113.3
- Updated n8n from 1.112.3 to 1.113.3
- Updated n8n-core from 1.111.0 to 1.112.1
- Updated n8n-workflow from 1.109.0 to 1.110.0
- Updated @n8n/n8n-nodes-langchain from 1.111.1 to 1.112.2
- Rebuilt node database with 536 nodes
- Bumped version to 2.14.3
- Updated n8n version badge in README
- All validation tests passing

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-29 23:35:03 +02:00
czlonkowski
7a66f71c23 docs: update test statistics in README
- Updated test badge to show 2,883 passing tests
- Corrected unit test count to 2,526 across 99 files
- Corrected integration test count to 357 across 20 files
- Reflects actual CI test results
2025-09-29 21:04:51 +02:00
czlonkowski
09e69df5a7 feat: implement anonymous telemetry system with Supabase integration
Adds zero-configuration anonymous usage statistics to track:
- Number of active users with deterministic user IDs
- Which MCP tools AI agents use most
- What workflows are built (sanitized to protect privacy)
- Common errors and issues

Key features:
- Zero-configuration design with hardcoded write-only credentials
- Privacy-first approach with comprehensive data sanitization
- Opt-out support via config file and environment variables
- Docker-friendly with environment variable support
- Multi-process safe with immediate flush strategy
- Row Level Security (RLS) policies for write-only access

Technical implementation:
- Supabase backend with anon key for INSERT-only operations
- Workflow sanitization removes all sensitive data
- Environment variables checked for opt-out (TELEMETRY_DISABLED, etc.)
- Telemetry enabled by default but respects user preferences
- Cleaned up all debug logging for production readiness

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-26 09:06:19 +02:00
czlonkowski
3981b9108a chore: release v2.13.1 - remove 5-operation limit
- Remove 5-operation limit from n8n_update_partial_workflow
- Update CHANGELOG.md with version 2.13.1 entry
- Bump version in package.json to 2.13.1
- Remove static version badge from README.md (npm badge remains)

The workflow diff engine now supports unlimited operations per request,
enabling complex workflow refactoring in single API calls.
2025-09-24 15:59:38 +02:00
Romuald Członkowski
ceb082efca Merge pull request #222 from czlonkowski/feat/enhanced-node-suggestions
feat: Add intelligent node type suggestions and auto-fix capability
2025-09-24 13:26:08 +02:00
czlonkowski
27339ec78d chore: release v2.13.0 - webhook autofixer and enhanced node suggestions
## 🎉 Release Highlights

###  New Features
- **Webhook Path Autofixer**: Automatically generates UUIDs for webhook nodes missing path configuration
- **Enhanced Node Type Suggestions**: Intelligent node type correction with similarity matching
- **n8n_autofix_workflow Tool**: New MCP tool for automatic workflow error correction

### 🔒 Security & Performance
- Eliminated ReDoS vulnerability in NodeSimilarityService
- Optimized Levenshtein distance algorithm from O(m*n) to O(n) space
- Added cache invalidation with version tracking to prevent memory leaks

### 📚 Documentation
- Comprehensive CHANGELOG entry with detailed feature descriptions
- Updated README with new autofixer tool documentation
- Added tool usage examples in validation workflow

All 16 test cases passing with 100% success rate.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-24 13:03:10 +02:00
Thai Nguyen Hung
9a13b977dc docs(codex): add Codex integration guide 2025-09-23 11:04:12 +07:00
czlonkowski
c1fb3db568 chore: update n8n dependencies to v1.112.3
- Updated n8n from 1.111.0 to 1.112.3
- Updated n8n-core from 1.110.0 to 1.111.0
- Updated n8n-workflow from 1.108.0 to 1.109.0
- Updated @n8n/n8n-nodes-langchain from 1.110.0 to 1.111.1
- Rebuilt node database with 536 nodes (438 from n8n-nodes-base, 98 from langchain)
- Bumped version to 2.12.2
- Updated README.md badges to reflect new n8n version

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-22 23:38:26 +02:00
czlonkowski
1a926630b8 fix: enhance error output validation to detect incorrect configurations
- Add validateErrorOutputConfiguration method to detect when multiple nodes are incorrectly placed in main[0]
- Fix checkWorkflowPatterns to check main[1] for error outputs instead of outputs.error
- Cross-validate onError property matches actual connection structure
- Provide clear error messages with JSON examples showing correct configuration
- Use heuristic detection for error handler nodes (names containing error, fail, catch, etc.)
- Add comprehensive test coverage with 16+ test cases
- Bump version to 2.12.1

Fixes issues where AI agents would incorrectly configure error outputs by placing multiple nodes in the same array instead of separating them into success (main[0]) and error (main[1]) paths.

🤖 Generated with Claude Code (https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-22 21:05:27 +02:00
czlonkowski
b366d40d67 chore: release v2.12.0 - flexible instance configuration
- Bump version from 2.11.3 to 2.12.0
- Add comprehensive documentation for flexible instance configuration
- Update CHANGELOG with new features, security enhancements, and performance improvements
- Document architecture, usage examples, and security considerations
- Include migration guide for existing deployments

This release introduces flexible instance configuration, enabling n8n-mcp to serve
multiple users with different n8n instances dynamically, with full backward compatibility.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-19 21:03:38 +02:00
czlonkowski
e6f1d6bcf0 chore: bump version to 2.11.3 and update documentation
- Bump version from 2.11.2 to 2.11.3
- Update README.md version badge
- Add CHANGELOG.md entry documenting the fix for n8n_update_partial_workflow tool
- Fix resolves GitHub issues #159 and #168
2025-09-17 23:46:24 +02:00
czlonkowski
874aea6920 chore: bump version to 2.11.2 and update documentation
- Bumped version from 2.11.1 to 2.11.2
- Updated README version badge to 2.11.2
- Updated README n8n version badge to ^1.111.0
- Added comprehensive CHANGELOG entry for v2.11.2
- Documented n8n dependency updates and test results

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-16 11:17:24 +02:00
czlonkowski
abc226f111 feat: add optional fields parameter to search_templates tool
- Added fields parameter to filter response fields in search_templates
- Reduces response size by 70-98% when using selective fields
- Maintains backward compatibility with optional parameter
- Supports all template fields: id, name, description, author, nodes, views, created, url, metadata
- Updated tool documentation with examples

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-15 23:46:33 +02:00
czlonkowski
a7a6d64931 docs: add template attribution requirements and acknowledgments
- Add mandatory attribution instructions to Claude Project Setup
- Require AI to share template author name, username, and n8n.io link
- Add Template Attribution section to Acknowledgments
- Credit top template contributors without specific counts
- Explain automatic attribution behavior in AI agent instructions

This ensures proper credit to template creators and demonstrates respect
for the n8n community's contributions while maintaining legal compliance.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-15 11:28:23 +02:00
czlonkowski
1e586c0b23 feat: add template metadata generation and smart discovery
- Implement OpenAI batch API integration for metadata generation
- Add search_templates_by_metadata tool with advanced filtering
- Enhance list_templates to include descriptions and optional metadata
- Generate metadata for 2,534 templates (97.5% coverage)
- Update README with Template Tools section and enhanced Claude setup
- Add comprehensive documentation for metadata system

Enables intelligent template discovery through:
- Complexity levels (simple/medium/complex)
- Setup time estimates (5-480 minutes)
- Target audience filtering (developers/marketers/analysts)
- Required services detection
- Category and use case classification

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-15 00:18:53 +02:00
czlonkowski
6b4bb7ff66 chore: update n8n dependencies to 1.110.1
- Update n8n: 1.109.2 → 1.110.1
- Update n8n-core: 1.108.0 → 1.109.0
- Update n8n-workflow: 1.106.0 → 1.107.0
- Update @n8n/n8n-nodes-langchain: 1.108.1 → 1.109.1
- Rebuild node database with 536 nodes
- Update templates database with 499 latest workflows
- Bump version to 2.10.9
2025-09-10 00:06:42 +02:00
czlonkowski
15e6e97fd9 chore: bump version to 2.10.8
- Updated n8n dependencies to latest versions (n8n 1.109.2, @n8n/n8n-nodes-langchain 1.109.1)
- Fixed CI/CD pipeline issues with Node.js v22 LTS compatibility
- Resolved Rollup native module compatibility for GitHub Actions
- Enhanced cross-platform deployment with better-sqlite3 and SQL.js fallback
- All 1,728+ tests passing
2025-09-04 11:24:13 +02:00
czlonkowski
8fd8c082ee chore: update n8n dependencies to v1.107.4
- Updated n8n from 1.106.3 to 1.107.4
- Updated n8n-core from 1.105.3 to 1.106.2
- Updated n8n-workflow from 1.103.3 to 1.104.1
- Updated @n8n/n8n-nodes-langchain from 1.105.3 to 1.106.2
- Rebuilt node database with 535 nodes
- Bumped version to 2.10.5
- All tests passing

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-20 19:45:30 +02:00
czlonkowski
b2a5cf49f7 chore: update n8n to v1.106.3
- Updated n8n from 1.105.2 to 1.106.3
- Updated n8n-core from 1.104.1 to 1.105.3
- Updated n8n-workflow from 1.102.1 to 1.103.3
- Updated @n8n/n8n-nodes-langchain from 1.104.1 to 1.105.3
- Rebuilt node database with 535 nodes
- All 1,728 tests passing
- Bumped version to 2.10.4

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-12 08:43:30 +02:00
czlonkowski
fddc363221 chore: update version shield to 2.10.3 and add n8n-mcp-tester agent
- Updated README.md version badge from 2.10.2 to 2.10.3
- Added n8n-mcp-tester agent for testing MCP functionality
- Agent successfully validated all validation fixes for issues #58, #68, #70, #73
2025-08-07 20:26:56 +02:00
czlonkowski
72d90a2584 docs: update n8n deployment guide and remove outdated test scripts
- Update N8N_DEPLOYMENT.md to recommend test-n8n-integration.sh
- Remove outdated test-n8n-mode.sh and related files
- The integration test script properly tests full n8n integration with correct protocol version (2024-11-05)
- Removed scripts: test-n8n-mode.sh, test-n8n-mode.ts, debug-n8n-mode.js

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-06 21:24:10 +02:00
czlonkowski
e94bb5479c Fix deploy on Railway button 2025-08-02 21:42:00 +02:00
czlonkowski
df4066022f chore: bump version to 2.10.1 for memory leak fix release
- Updated version in package.json and package.runtime.json
- Updated README version badge
- Moved changelog entry from Unreleased to v2.10.1
- Added version comparison link for v2.10.1

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-02 15:18:58 +02:00
czlonkowski
907d3846a9 chore: release v2.10.0
- Added automated release system with GitHub Actions
- Implemented CI/CD pipeline for zero-touch releases
- Added security fixes for deprecated actions and vulnerabilities
- Created developer tools for release preparation
- Full documentation in docs/AUTOMATED_RELEASES.md
2025-08-02 12:37:18 +02:00
czlonkowski
a2be2b36d5 chore: release v2.9.1
- Bumped version from 2.9.0 to 2.9.1
- Updated version badge in README.md
- Added comprehensive changelog entry documenting fixedCollection validation fixes
- Increased test coverage from 79.95% to 80.16% to meet CI requirements
- Added 50 new tests for fixed-collection-validator and console-manager

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-02 10:16:03 +02:00
czlonkowski
6c7033bb45 feat: complete n8n integration with MCP Client Tool support and version badge automation
This major update adds comprehensive n8n integration, enabling n8n-mcp to run
as an MCP server within n8n workflows using the MCP Client Tool node.

## Key Features

### n8n Integration (NEW)
- Full MCP Client Tool compatibility with protocol version negotiation
- Dedicated n8n mode with optimized Docker deployment
- Workflow examples and n8n-friendly tool descriptions
- Quick deployment script for easy setup

### Protocol & Compatibility
- Intelligent protocol version selection (2024-11-05 for n8n, 2025-03-26 for others)
- Fixed schema validation issues with n8n's nested output format
- Enhanced parameter validation with clear error messages
- Comprehensive test suite for protocol negotiation

### Security Enhancements
- Dynamic UID/GID generation (10000-59999) for Docker containers
- Improved error sanitization for production environments
- Fixed information leakage in error responses
- Enhanced permission handling for mounted volumes

### Performance Optimizations
- Docker build time reduced from 13+ minutes to 1-2 minutes
- Image size reduced from ~1.5GB to ~280MB
- Fixed ARM64 build failures
- Optimized to use runtime-only dependencies

### Developer Experience
- Comprehensive parameter validation for all MCP tools
- Made README version badge dynamic from package.json
- Enhanced test coverage with session management tests
- Improved CI/CD with informational patch coverage

### Documentation
- Added comprehensive N8N_DEPLOYMENT.md guide
- Updated CHANGELOG.md for version 2.9.0
- Enhanced CLAUDE.md with n8n-specific instructions
- Added deployment scripts and examples

## Technical Details

Files Added:
- Dockerfile.n8n, docker-compose.n8n.yml for n8n deployment
- Protocol version negotiation utilities
- n8n integration test suite
- Session management tests
- Deployment and test scripts
- Version badge update scripts

Files Modified:
- Enhanced MCP server with n8n mode support
- Improved HTTP server with better error handling
- Updated Docker configurations for security
- Enhanced logging for n8n compatibility
- CHANGELOG.md with comprehensive update description

This update makes n8n-mcp a first-class citizen in the n8n ecosystem,
enabling powerful AI-assisted workflow automation.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-02 00:01:01 +02:00
czlonkowski
a4053de998 chore: bump version to 2.8.3 and update changelog
- Updated version in package.json and package.runtime.json
- Updated version badge in README.md
- Added comprehensive changelog entry for v2.8.3
- Fixed TypeScript lint errors in test files by making env vars optional
- Fixed edge-cases test to include required NODE_ENV

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-31 17:58:52 +02:00
czlonkowski
903a49d3b0 fix: add Docker configuration file support (fixes #105)
This commit adds comprehensive support for JSON configuration files in Docker containers,
addressing the issue where the Docker image fails to start in server mode and ignores
configuration files.

## Changes

### Docker Configuration Support
- Added parse-config.js to safely parse JSON configs and export as shell variables
- Implemented secure shell quoting to prevent command injection
- Added dangerous environment variable blocking for security
- Support for all JSON data types with proper edge case handling

### Docker Server Mode Fix
- Added support for "n8n-mcp serve" command in entrypoint
- Properly transforms serve command to HTTP mode
- Fixed missing n8n-mcp binary issue in Docker image

### Security Enhancements
- POSIX-compliant shell quoting without eval
- Blocked dangerous variables (PATH, LD_PRELOAD, etc.)
- Sanitized configuration keys to prevent invalid shell variables
- Protection against shell metacharacters in values

### Testing
- Added 53 comprehensive tests for Docker configuration
- Unit tests for parsing, security, and edge cases
- Integration tests for Docker entrypoint behavior
- Security-focused tests for injection prevention

### Documentation
- Updated Docker README with config file mounting examples
- Enhanced troubleshooting guide with config file issues
- Added version bump to 2.8.2

### Additional Files
- Included deployment-engineer and technical-researcher agent files

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-31 11:48:31 +02:00
czlonkowski
dce2d9d83b chore: update n8n to ^1.104.1 and bump version to 2.8.1
- Updated n8n to ^1.104.1
- Updated n8n-core to ^1.103.1
- Updated n8n-workflow to ^1.101.0
- Updated @n8n/n8n-nodes-langchain to ^1.103.1
- Rebuilt node database with 532 nodes
- Sanitized 499 workflow templates
- All 1,182 tests passing (933 unit, 249 integration)
- All validation tests passing
- Built and prepared for npm publish

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-30 16:20:51 +02:00
czlonkowski
c36567875a chore: bump version to 2.8.0
- Update package.json version from 2.7.23 to 2.8.0
- Update README.md test count from 1,182 to 1,356 tests
- Add comprehensive CHANGELOG entry for v2.8.0
- Document all test improvements and fixes from PR #104

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-30 15:43:48 +02:00
czlonkowski
f2eb344476 chore: bump version to 2.7.23 and update documentation
- Bump version from 2.7.22 to 2.7.23 in package.json
- Update version badge in README.md
- Add tests badge showing 1,182 passing tests
- Add comprehensive CHANGELOG entry for v2.7.23 documenting:
  - Complete testing infrastructure implementation
  - 933 unit tests and 249 integration tests
  - All CI test failures fixed
  - Test architecture enhancements
  - Documentation updates
  - Development artifact cleanup

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-30 09:45:42 +02:00
czlonkowski
6d614267af docs: update testing documentation to reflect actual implementation
- Update testing-architecture.md with accurate test counts (1,182 tests)
- Document 933 unit tests and 249 integration tests
- Add real code examples and directory structure
- Include lessons learned and common issues/solutions
- Update README.md testing section with comprehensive test overview
- Include test distribution by component
- Add CI test results from run #41
- Update CLAUDE.md with latest development guidance
2025-07-30 09:42:17 +02:00