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

@@ -248,4 +248,133 @@ export class NodeRepository {
outputNames: row.output_names ? this.safeJsonParse(row.output_names, null) : null
};
}
/**
* Get operations for a specific node, optionally filtered by resource
*/
getNodeOperations(nodeType: string, resource?: string): any[] {
const node = this.getNode(nodeType);
if (!node) return [];
const operations: any[] = [];
// Parse operations field
if (node.operations) {
if (Array.isArray(node.operations)) {
operations.push(...node.operations);
} else if (typeof node.operations === 'object') {
// Operations might be grouped by resource
if (resource && node.operations[resource]) {
return node.operations[resource];
} else {
// Return all operations
Object.values(node.operations).forEach(ops => {
if (Array.isArray(ops)) {
operations.push(...ops);
}
});
}
}
}
// Also check properties for operation fields
if (node.properties && Array.isArray(node.properties)) {
for (const prop of node.properties) {
if (prop.name === 'operation' && prop.options) {
// If resource is specified, filter by displayOptions
if (resource && prop.displayOptions?.show?.resource) {
const allowedResources = Array.isArray(prop.displayOptions.show.resource)
? prop.displayOptions.show.resource
: [prop.displayOptions.show.resource];
if (!allowedResources.includes(resource)) {
continue;
}
}
// Add operations from this property
operations.push(...prop.options);
}
}
}
return operations;
}
/**
* Get all resources defined for a node
*/
getNodeResources(nodeType: string): any[] {
const node = this.getNode(nodeType);
if (!node || !node.properties) return [];
const resources: any[] = [];
// Look for resource property
for (const prop of node.properties) {
if (prop.name === 'resource' && prop.options) {
resources.push(...prop.options);
}
}
return resources;
}
/**
* Get operations that are valid for a specific resource
*/
getOperationsForResource(nodeType: string, resource: string): any[] {
const node = this.getNode(nodeType);
if (!node || !node.properties) return [];
const operations: any[] = [];
// Find operation properties that are visible for this resource
for (const prop of node.properties) {
if (prop.name === 'operation' && prop.displayOptions?.show?.resource) {
const allowedResources = Array.isArray(prop.displayOptions.show.resource)
? prop.displayOptions.show.resource
: [prop.displayOptions.show.resource];
if (allowedResources.includes(resource) && prop.options) {
operations.push(...prop.options);
}
}
}
return operations;
}
/**
* Get all operations across all nodes (for analysis)
*/
getAllOperations(): Map<string, any[]> {
const allOperations = new Map<string, any[]>();
const nodes = this.getAllNodes();
for (const node of nodes) {
const operations = this.getNodeOperations(node.nodeType);
if (operations.length > 0) {
allOperations.set(node.nodeType, operations);
}
}
return allOperations;
}
/**
* Get all resources across all nodes (for analysis)
*/
getAllResources(): Map<string, any[]> {
const allResources = new Map<string, any[]>();
const nodes = this.getAllNodes();
for (const node of nodes) {
const resources = this.getNodeResources(node.nodeType);
if (resources.length > 0) {
allResources.set(node.nodeType, resources);
}
}
return allResources;
}
}