feat: add operation and resource validation with intelligent suggestions

- Added OperationSimilarityService for validating operations with "Did you mean...?" suggestions
- Added ResourceSimilarityService for validating resources with plural/singular detection
- Implements Levenshtein distance algorithm for typo detection
- Pattern matching for common operation/resource mistakes
- 5-minute cache with automatic cleanup to prevent memory leaks
- Confidence scoring (30% minimum threshold) for suggestion quality
- Resource-aware operation filtering for contextual suggestions
- Safe JSON parsing with ValidationServiceError for proper error handling
- Type guards for safe property access
- Performance optimizations with early termination
- Comprehensive test coverage (37 new tests)
- Integration tested with n8n-mcp-tester agent

Example use cases:
- "listFiles" → suggests "search" for Google Drive
- "files" → suggests singular "file"
- "flie" → suggests "file" (typo correction)
- "downlod" → suggests "download"

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
czlonkowski
2025-09-24 23:57:25 +02:00
parent c23442249a
commit f6160d43a0
13 changed files with 2498 additions and 3 deletions

View File

@@ -5,6 +5,45 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [2.13.2] - 2025-01-24
### Added
- **Operation and Resource Validation with Intelligent Suggestions**: New similarity services for n8n node configuration validation
- `OperationSimilarityService`: Validates operations and suggests similar alternatives using Levenshtein distance and pattern matching
- `ResourceSimilarityService`: Validates resources with automatic plural/singular conversion and typo detection
- Provides "Did you mean...?" suggestions when invalid operations or resources are used
- Example: `operation: "listFiles"` suggests `"search"` for Google Drive nodes
- Example: `resource: "files"` suggests singular `"file"` with 95% confidence
- Confidence-based suggestions (minimum 30% threshold) with contextual fix messages
- Resource-aware operation filtering ensures suggestions are contextually appropriate
- 5-minute cache duration for performance optimization
- Integrated into `EnhancedConfigValidator` for seamless validation flow
- **Custom Error Handling**: New `ValidationServiceError` class for better error management
- Proper error chaining with cause tracking
- Specialized factory methods for common error scenarios
- Type-safe error propagation throughout the validation pipeline
### Enhanced
- **Code Quality and Security Improvements** (based on code review feedback):
- Safe JSON parsing with try-catch error boundaries
- Type guards for safe property access (`getOperationValue`, `getResourceValue`)
- Memory leak prevention with periodic cache cleanup
- Performance optimization with early termination for exact matches
- Replaced magic numbers with named constants for better maintainability
- Comprehensive JSDoc documentation for all public methods
- Improved confidence calculation for typos and transpositions
### Fixed
- **Test Compatibility**: Updated test expectations to correctly handle exact match scenarios
- **Cache Management**: Fixed cache cleanup to prevent unbounded memory growth
- **Validation Deduplication**: Enhanced config validator now properly replaces base validator errors with detailed suggestions
### Testing
- Added comprehensive test coverage for similarity services (37 new tests)
- All unit tests passing with proper edge case handling
- Integration confirmed via n8n-mcp-tester agent validation
## [2.13.1] - 2025-01-24
### Changed