n8n-mcp 2.77.0 → 2.79.0

package/dist/mcp/param-aliases.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGetNodeAliases = resolveGetNodeAliases;
+exports.suggestExecutionsAction = suggestExecutionsAction;
+exports.withWorkflowIdAlias = withWorkflowIdAlias;
+exports.hasText = hasText;
+const logger_1 = require("../utils/logger");
+const GET_NODE_MODE_ALIASES = {
+    essentials: { mode: 'info', detail: 'standard' },
+    minimal: { mode: 'info', detail: 'minimal' },
+    standard: { mode: 'info', detail: 'standard' },
+    full: { mode: 'info', detail: 'full' },
+    operations: { mode: 'info', detail: 'standard' },
+    properties: { mode: 'search_properties' },
+    search: { mode: 'search_properties' },
+};
+const GET_NODE_DETAIL_ALIASES = {
+    essentials: 'standard',
+    summary: 'minimal',
+    short: 'minimal',
+};
+function resolveGetNodeAliases(mode, detail) {
+    const aliased = [];
+    let resolvedMode = mode;
+    let resolvedDetail = detail;
+    if (typeof resolvedDetail === 'string') {
+        const detailAlias = GET_NODE_DETAIL_ALIASES[resolvedDetail.toLowerCase()];
+        if (detailAlias) {
+            aliased.push(`detail=${resolvedDetail}→${detailAlias}`);
+            resolvedDetail = detailAlias;
+        }
+    }
+    if (typeof resolvedMode === 'string') {
+        const modeAlias = GET_NODE_MODE_ALIASES[resolvedMode.toLowerCase()];
+        if (modeAlias) {
+            const target = modeAlias.detail
+                ? `mode=${modeAlias.mode}, detail=${modeAlias.detail}`
+                : `mode=${modeAlias.mode}`;
+            aliased.push(`mode=${resolvedMode}→${target}`);
+            resolvedMode = modeAlias.mode;
+            if (modeAlias.detail)
+                resolvedDetail = modeAlias.detail;
+        }
+    }
+    if (aliased.length > 0) {
+        logger_1.logger.debug(`get_node: retired parameter vocabulary aliased (${aliased.join('; ')})`);
+    }
+    return { mode: resolvedMode, detail: resolvedDetail };
+}
+const EXECUTIONS_ACTION_HINTS = {
+    get_many: "Did you mean action='list'?",
+    getmany: "Did you mean action='list'?",
+    getall: "Did you mean action='list'?",
+    get_all: "Did you mean action='list'?",
+    list_executions: "Did you mean action='list'?",
+    listexecutions: "Did you mean action='list'?",
+    search: "Did you mean action='list'?",
+    get_execution: "Did you mean action='get'?",
+    getexecution: "Did you mean action='get'?",
+    retry: "Retrying an execution is not supported; re-run the workflow with n8n_test_workflow.",
+    list_runs: 'Evaluation test runs are managed by n8n_evaluations.',
+    get_run: 'Evaluation test runs are managed by n8n_evaluations.',
+    getrows: 'Data table rows are managed by n8n_manage_datatable.',
+    get_rows: 'Data table rows are managed by n8n_manage_datatable.',
+};
+function suggestExecutionsAction(action) {
+    return EXECUTIONS_ACTION_HINTS[action.toLowerCase()];
+}
+function withWorkflowIdAlias(args) {
+    const workflowIdMissing = args.workflowId === undefined || args.workflowId === null
+        || (typeof args.workflowId === 'string' && args.workflowId.trim() === '');
+    if (!workflowIdMissing) {
+        return args;
+    }
+    const id = typeof args.id === 'number' ? String(args.id) : args.id;
+    if (typeof id !== 'string' || id.trim() === '') {
+        return typeof args.workflowId === 'string' ? { ...args, workflowId: undefined } : args;
+    }
+    return { ...args, workflowId: id };
+}
+function hasText(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
+//# sourceMappingURL=param-aliases.js.map

package/dist/mcp/param-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-aliases.js","sourceRoot":"","sources":["../../src/mcp/param-aliases.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts

@@ -8,6 +8,7 @@ export declare class N8NDocumentationMCPServer {
     private server;
     private db;
     private repository;
+    private breakingChangeDetector;
     private templateService;
     private initialized;
     private cache;
@@ -43,6 +44,7 @@ export declare class N8NDocumentationMCPServer {
     private validateToolParamsBasic;
     private validateExtractedArgs;
     private coerceStringifiedJsonParams;
+    private listExecutionsInsteadOfGet;
     private listNodes;
     private getNodeInfo;
     private searchNodes;
@@ -66,6 +68,8 @@ export declare class N8NDocumentationMCPServer {
     private getVersionSummary;
     private versionMetadataUnavailable;
     private getVersionHistory;
+    private analyzeVersionUpgrade;
+    private defaultTargetVersion;
     private compareVersions;
     private getBreakingChanges;
     private getMigrations;

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AA8DA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,2BAA2B,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAwInE,UAAU,gBAAgB;IACxB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAAgC;IAC1C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,sBAAsB,CAAuC;IACrE,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,qBAAqB,CAAsB;IACnD,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,2BAA2B,CAAyC;IAC5E,OAAO,CAAC,4BAA4B,CAAiC;IACrE,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,qBAAqB,CAA0C;gBAE3D,eAAe,CAAC,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAgHzG,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,yBAAyB;IAWjC,OAAO,CAAC,cAAc;IAoBhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA+Cd,kBAAkB;YAoDlB,wBAAwB;IA0BtC,OAAO,CAAC,kBAAkB;YA6CZ,iBAAiB;IAa/B,OAAO,CAAC,eAAe,CAAkB;YAE3B,sBAAsB;IA8CpC,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,4BAA4B;IAgEpC,OAAO,CAAC,aAAa;IAudrB,OAAO,CAAC,wBAAwB;IAoFhC,OAAO,CAAC,kBAAkB;IA6G1B,OAAO,CAAC,uBAAuB;IAwB/B,OAAO,CAAC,qBAAqB;IAiF7B,OAAO,CAAC,2BAA2B;YAgHrB,0BAA0B;YAiY1B,SAAS;YA2DT,WAAW;YAkGX,WAAW;YA2CX,cAAc;YAuNd,gBAAgB;IAuE9B,OAAO,CAAC,mBAAmB;IAwE3B,OAAO,CAAC,eAAe;YAsBT,eAAe;IA4M7B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,uBAAuB;IA0D/B,OAAO,CAAC,iBAAiB;YAqFX,WAAW;YAgCX,oBAAoB;IAuFlC,OAAO,CAAC,aAAa;YAQP,qBAAqB;IA4DnC,OAAO,CAAC,mBAAmB;YAyCb,iBAAiB;YAuLjB,OAAO;YAkDP,cAAc;YAwFd,iBAAiB;IAqC/B,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,0BAA0B;YAgBpB,iBAAiB;YAyDjB,qBAAqB;IA+BnC,OAAO,CAAC,oBAAoB;YAcd,eAAe;YAwCf,kBAAkB;YA4ClB,aAAa;IA2C3B,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,4BAA4B;YAKtB,oBAAoB;IAsDlC,OAAO,CAAC,gBAAgB;YAiBV,SAAS;YA6CT,kBAAkB;YAqElB,uBAAuB;IAsDrC,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,uBAAuB;IA4D/B,OAAO,CAAC,wBAAwB;YAkClB,mBAAmB;YAoEnB,qBAAqB;IAY7B,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAS9B,aAAa;YAcb,iBAAiB;YAoBjB,WAAW;YAwBX,eAAe;IAqB7B,OAAO,CAAC,qBAAqB,CASb;IAEhB,OAAO,CAAC,mBAAmB;YAsDb,mBAAmB;YAwBnB,yBAAyB;IAmEvC,OAAO,CAAC,kBAAkB;YAiBZ,gBAAgB;YA6HhB,2BAA2B;YAiE3B,2BAA2B;IAyEnC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAgFhC"}

package/dist/mcp/server.js

@@ -50,6 +50,7 @@ const tool_policy_1 = require("./tool-policy");
 const tools_n8n_friendly_1 = require("./tools-n8n-friendly");
 const workflow_examples_1 = require("./workflow-examples");
 const logger_1 = require("../utils/logger");
+const param_aliases_1 = require("./param-aliases");
 const stdio_guard_1 = require("../utils/stdio-guard");
 const redaction_1 = require("../utils/redaction");
 const node_repository_1 = require("../database/node-repository");
@@ -76,6 +77,8 @@ const node_type_normalizer_1 = require("../utils/node-type-normalizer");
 const typeversion_1 = require("../utils/typeversion");
 const validation_schemas_1 = require("../utils/validation-schemas");
 const protocol_version_1 = require("../utils/protocol-version");
+const breaking_change_detector_1 = require("../services/breaking-change-detector");
+const node_parser_1 = require("../parsers/node-parser");
 const telemetry_1 = require("../telemetry");
 const startup_checkpoints_1 = require("../telemetry/startup-checkpoints");
 const STDIO_MAX_BUFFER_SIZE = Math.max(1024 * 1024, parseInt(process.env.N8N_MCP_STDIO_MAX_BUFFER_SIZE || '', 10) || 64 * 1024 * 1024);
@@ -86,6 +89,7 @@ class N8NDocumentationMCPServer {
     constructor(instanceContext, earlyLogger, options) {
         this.db = null;
         this.repository = null;
+        this.breakingChangeDetector = null;
         this.templateService = null;
         this.cache = new simple_cache_1.SimpleCache();
         this.clientInfo = null;
@@ -399,8 +403,13 @@ class N8NDocumentationMCPServer {
             const cloned = JSON.parse(JSON.stringify(original));
             const remaining = [...(0, tool_policy_1.getValidOperations)(toolName)].filter(v => !ops.has(v));
             const param = cloned.inputSchema?.properties?.[paramName];
+            let defaultRemoved = false;
             if (param?.enum) {
                 param.enum = param.enum.filter(v => !ops.has(v.toLowerCase()));
+                if (typeof param.default === 'string' && ops.has(param.default.toLowerCase())) {
+                    delete param.default;
+                    defaultRemoved = true;
+                }
                 if (param.enum.length === 0) {
                     logger_1.logger.warn(`DISABLED_TOOL_OPERATIONS: all operations for '${toolName}' are disabled ` +
                         `but the tool still appears in ListTools. ` +
@@ -408,11 +417,13 @@ class N8NDocumentationMCPServer {
                 }
                 if (param.description) {
                     const disabledList = [...ops].join(', ');
-                    param.description = `${param.description} (disabled by server policy: ${disabledList})`;
+                    param.description = `${param.description} (disabled by server policy: ${disabledList}`
+                        + `${defaultRemoved ? '; no default, pass a value' : ''})`;
                 }
             }
             const disabledList = [...ops].join(', ');
-            cloned.description = `${cloned.description}\n\n> Operations disabled by server policy: ${disabledList}`;
+            cloned.description = `${cloned.description}\n\n> Operations disabled by server policy: ${disabledList}`
+                + (defaultRemoved ? `. The default for ${paramName} was one of them, so ${paramName} must be passed explicitly.` : '');
             const destructive = tools_n8n_manager_1.DESTRUCTIVE_TOOL_OPERATIONS[toolName];
             if (destructive && cloned.annotations) {
                 const stillDestructive = remaining.some(v => destructive.has(String(v).toLowerCase()));
@@ -857,9 +868,18 @@ class N8NDocumentationMCPServer {
                     validationResult = validation_schemas_1.ToolValidation.validateWorkflowId(args);
                     break;
                 case 'n8n_executions':
-                    validationResult = args.action
+                    validationResult = { valid: true, errors: [] };
+                    break;
+                case 'n8n_test_workflow':
+                    validationResult = (0, param_aliases_1.hasText)(args.workflowId)
                         ? { valid: true, errors: [] }
-                        : { valid: false, errors: [{ field: 'action', message: 'action is required' }] };
+                        : {
+                            valid: false,
+                            errors: [{
+                                    field: 'workflowId',
+                                    message: 'workflowId is required: the ID of the workflow to run ("id" is accepted as an alias)'
+                                }]
+                        };
                     break;
                 case 'n8n_evaluations': {
                     const evalErrors = [];
@@ -1083,6 +1103,19 @@ class N8NDocumentationMCPServer {
         }
         return coerced;
     }
+    async listExecutionsInsteadOfGet(args) {
+        if ((0, tool_policy_1.isOperationDisabled)('n8n_executions', 'list')) {
+            throw new Error('id is required for action=get');
+        }
+        const result = await n8nHandlers.handleListExecutions(args, this.instanceContext);
+        if (!result.success)
+            return result;
+        const scope = (0, param_aliases_1.hasText)(args.workflowId) ? `executions of workflow ${args.workflowId}` : 'recent executions';
+        return {
+            ...result,
+            message: `action=get was called without an execution id, so ${scope} were listed instead. Pass id to get one execution.`
+        };
+    }
     async executeTool(name, args) {
         args = args || {};
         const disabledTools = this.getDisabledTools();
@@ -1120,19 +1153,21 @@ class N8NDocumentationMCPServer {
                     includeOperations: args.includeOperations,
                     source: args.source
                 });
-            case 'get_node':
+            case 'get_node': {
                 this.validateToolParams(name, args, ['nodeType']);
-                if (args.mode === 'docs') {
+                const { mode: nodeMode, detail: nodeDetail } = (0, param_aliases_1.resolveGetNodeAliases)(args.mode, args.detail);
+                if (nodeMode === 'docs') {
                     return this.getNodeDocumentation(args.nodeType);
                 }
-                if (args.mode === 'search_properties') {
+                if (nodeMode === 'search_properties') {
                     if (!args.propertyQuery) {
                         throw new Error('propertyQuery is required for mode=search_properties');
                     }
                     const maxResults = args.maxPropertyResults !== undefined ? Number(args.maxPropertyResults) || 20 : 20;
                     return this.searchNodeProperties(args.nodeType, args.propertyQuery, maxResults);
                 }
-                return this.getNode(args.nodeType, args.detail, args.mode, args.includeTypeInfo, args.includeExamples, args.fromVersion, args.toVersion);
+                return this.getNode(args.nodeType, nodeDetail, nodeMode, args.includeTypeInfo, args.includeExamples, args.fromVersion, args.toVersion);
+            }
             case 'validate_node':
                 this.validateToolParams(name, args, ['nodeType', 'config']);
                 if (typeof args.config !== 'object' || args.config === null) {
@@ -1268,27 +1303,32 @@ class N8NDocumentationMCPServer {
                 if (!this.repository)
                     throw new Error('Repository not initialized');
                 return n8nHandlers.handleAutofixWorkflow(args, this.repository, this.instanceContext);
-            case 'n8n_test_workflow':
-                this.validateToolParams(name, args, ['workflowId']);
-                return n8nHandlers.handleTestWorkflow(args, this.instanceContext);
+            case 'n8n_test_workflow': {
+                const testArgs = (0, param_aliases_1.withWorkflowIdAlias)(args);
+                this.validateToolParams(name, testArgs);
+                return n8nHandlers.handleTestWorkflow(testArgs, this.instanceContext);
+            }
             case 'n8n_executions': {
-                this.validateToolParams(name, args, ['action']);
-                const execAction = args.action;
+                this.validateToolParams(name, args);
+                const execAction = String((0, tool_policy_1.resolveRequestedOperation)(name, args));
                 switch (execAction) {
                     case 'get':
-                        if (!args.id) {
-                            throw new Error('id is required for action=get');
+                        if (!(0, param_aliases_1.hasText)(args.id)) {
+                            return this.listExecutionsInsteadOfGet(args);
                         }
                         return n8nHandlers.handleGetExecution(args, this.instanceContext);
                     case 'list':
                         return n8nHandlers.handleListExecutions(args, this.instanceContext);
                     case 'delete':
-                        if (!args.id) {
+                        if (!(0, param_aliases_1.hasText)(args.id)) {
                             throw new Error('id is required for action=delete');
                         }
                         return n8nHandlers.handleDeleteExecution(args, this.instanceContext);
-                    default:
-                        throw new Error(`Unknown action: ${execAction}. Valid actions: get, list, delete`);
+                    default: {
+                        const message = `Unknown action: ${execAction}. Valid actions: get, list, delete.`;
+                        const hint = (0, param_aliases_1.suggestExecutionsAction)(execAction);
+                        throw new Error(hint ? `${message} ${hint}` : message);
+                    }
                 }
             }
             case 'n8n_evaluations': {
@@ -1324,8 +1364,7 @@ class N8NDocumentationMCPServer {
                 }
                 return n8nHandlers.handleHealthCheck(this.instanceContext);
             case 'n8n_workflow_versions':
-                this.validateToolParams(name, args, ['mode']);
-                return n8nHandlers.handleWorkflowVersions(args, this.repository, this.instanceContext);
+                return n8nHandlers.handleWorkflowVersions((0, param_aliases_1.withWorkflowIdAlias)(args), this.repository, this.instanceContext);
             case 'n8n_deploy_template':
                 this.validateToolParams(name, args, ['templateId']);
                 await this.ensureInitialized();
@@ -2410,7 +2449,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
             throw new Error(`get_node: Invalid detail level "${detail}". Valid options: ${validDetailLevels.join(', ')}`);
         }
         if (!validModes.includes(mode)) {
-            throw new Error(`get_node: Invalid mode "${mode}". Valid options: ${validModes.join(', ')}`);
+            throw new Error(`get_node: Invalid mode "${mode}". Valid options: info, docs, search_properties, ${validModes.slice(1).join(', ')}`);
         }
         const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         if (mode !== 'info') {
@@ -2530,28 +2569,75 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
             ...extra
         };
     }
-    getVersionHistory(nodeType) {
+    async getVersionHistory(nodeType) {
         if (!this.repository.hasVersionMetadata(nodeType)) {
+            const node = this.repository.getNode(nodeType);
+            if (node && node.isVersioned === false && node.version) {
+                return {
+                    nodeType,
+                    available: true,
+                    totalVersions: 1,
+                    versions: [{
+                            version: String(node.version),
+                            isCurrent: true,
+                            hasBreakingChanges: false,
+                            breakingChangesCount: 0,
+                            deprecatedProperties: [],
+                            addedProperties: []
+                        }]
+                };
+            }
             return this.versionMetadataUnavailable(nodeType, { totalVersions: 0, versions: [] });
         }
         const versions = this.repository.getNodeVersions(nodeType);
-        return {
-            nodeType,
-            available: true,
-            totalVersions: versions.length,
-            versions: versions.map(v => ({
+        const entries = [];
+        for (let i = 0; i < versions.length; i++) {
+            const v = versions[i];
+            const previous = versions[i + 1];
+            const breakingCount = previous
+                ? (await this.analyzeVersionUpgrade(nodeType, previous.version, v.version))
+                    .changes.filter(c => c.isBreaking).length
+                : 0;
+            entries.push({
                 version: v.version,
                 isCurrent: v.isCurrentMax,
-                minimumN8nVersion: v.minimumN8nVersion,
-                releasedAt: v.releasedAt,
-                hasBreakingChanges: (v.breakingChanges || []).length > 0,
-                breakingChangesCount: (v.breakingChanges || []).length,
+                hasBreakingChanges: breakingCount > 0,
+                breakingChangesCount: breakingCount,
                 deprecatedProperties: v.deprecatedProperties || [],
                 addedProperties: v.addedProperties || []
-            }))
+            });
+        }
+        return {
+            nodeType,
+            available: true,
+            totalVersions: entries.length,
+            versions: entries
         };
     }
-    compareVersions(nodeType, fromVersion, toVersion) {
+    async analyzeVersionUpgrade(nodeType, fromVersion, toVersion) {
+        const from = (0, node_parser_1.normalizeNodeVersion)(fromVersion);
+        const to = (0, node_parser_1.normalizeNodeVersion)(toVersion ?? this.defaultTargetVersion(nodeType, from));
+        for (const version of [from, to]) {
+            if (!this.repository.getNodeVersion(nodeType, version)) {
+                const known = this.repository.getNodeVersions(nodeType).map(v => v.version).join(', ');
+                throw new Error(`get_node: version "${version}" is not a recorded version of ${nodeType} (recorded: ${known})`);
+            }
+        }
+        this.breakingChangeDetector ?? (this.breakingChangeDetector = new breaking_change_detector_1.BreakingChangeDetector(this.repository));
+        return this.breakingChangeDetector.analyzeVersionUpgrade(node_type_normalizer_1.NodeTypeNormalizer.toWorkflowFormat(nodeType), from, to);
+    }
+    defaultTargetVersion(nodeType, fromVersion) {
+        const current = this.repository.getLatestNodeVersion(nodeType)?.version
+            ?? this.repository.getNode(nodeType)?.version;
+        if (!current) {
+            throw new Error('No target version available');
+        }
+        if (Number(fromVersion) <= Number(current))
+            return current;
+        const newest = this.repository.getNodeVersions(nodeType)[0]?.version;
+        return newest ?? current;
+    }
+    async compareVersions(nodeType, fromVersion, toVersion) {
         if (!this.repository.hasVersionMetadata(nodeType)) {
             return this.versionMetadataUnavailable(nodeType, {
                 fromVersion,
@@ -2560,20 +2646,15 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
                 changes: []
             });
         }
-        const latest = this.repository.getLatestNodeVersion(nodeType);
-        const targetVersion = toVersion || latest?.version;
-        if (!targetVersion) {
-            throw new Error('No target version available');
-        }
-        const changes = this.repository.getPropertyChanges(nodeType, fromVersion, targetVersion);
+        const analysis = await this.analyzeVersionUpgrade(nodeType, fromVersion, toVersion);
         return {
             nodeType,
             available: true,
-            fromVersion,
-            toVersion: targetVersion,
-            totalChanges: changes.length,
-            breakingChanges: changes.filter(c => c.isBreaking).length,
-            changes: changes.map(c => ({
+            fromVersion: analysis.fromVersion,
+            toVersion: analysis.toVersion,
+            totalChanges: analysis.changes.length,
+            breakingChanges: analysis.changes.filter(c => c.isBreaking).length,
+            changes: analysis.changes.map(c => ({
                 property: c.propertyName,
                 changeType: c.changeType,
                 isBreaking: c.isBreaking,
@@ -2581,11 +2662,12 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
                 oldValue: c.oldValue,
                 newValue: c.newValue,
                 migrationHint: c.migrationHint,
-                autoMigratable: c.autoMigratable
+                autoMigratable: c.autoMigratable,
+                source: c.source
             }))
         };
     }
-    getBreakingChanges(nodeType, fromVersion, toVersion) {
+    async getBreakingChanges(nodeType, fromVersion, toVersion) {
         if (!this.repository.hasVersionMetadata(nodeType)) {
             return this.versionMetadataUnavailable(nodeType, {
                 fromVersion,
@@ -2594,27 +2676,30 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
                 changes: []
             });
         }
-        const breakingChanges = this.repository.getBreakingChanges(nodeType, fromVersion, toVersion);
+        const analysis = await this.analyzeVersionUpgrade(nodeType, fromVersion, toVersion);
+        const breakingChanges = analysis.changes.filter(c => c.isBreaking);
         return {
             nodeType,
             available: true,
-            fromVersion,
-            toVersion: toVersion || 'latest',
+            fromVersion: analysis.fromVersion,
+            toVersion: analysis.toVersion,
             totalBreakingChanges: breakingChanges.length,
             changes: breakingChanges.map(c => ({
-                fromVersion: c.fromVersion,
-                toVersion: c.toVersion,
+                fromVersion: c.fromVersion ?? analysis.fromVersion,
+                toVersion: c.toVersion ?? analysis.toVersion,
                 property: c.propertyName,
                 changeType: c.changeType,
                 severity: c.severity,
                 migrationHint: c.migrationHint,
                 oldValue: c.oldValue,
-                newValue: c.newValue
+                newValue: c.newValue,
+                source: c.source
             })),
-            upgradeSafe: breakingChanges.length === 0
+            upgradeSafe: breakingChanges.length === 0,
+            recommendations: analysis.recommendations
         };
     }
-    getMigrations(nodeType, fromVersion, toVersion) {
+    async getMigrations(nodeType, fromVersion, toVersion) {
         if (!this.repository.hasVersionMetadata(nodeType)) {
             return this.versionMetadataUnavailable(nodeType, {
                 fromVersion,
@@ -2624,22 +2709,25 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
                 migrations: []
             });
         }
-        const migrations = this.repository.getAutoMigratableChanges(nodeType, fromVersion, toVersion);
-        const allChanges = this.repository.getPropertyChanges(nodeType, fromVersion, toVersion);
+        const analysis = await this.analyzeVersionUpgrade(nodeType, fromVersion, toVersion);
+        const migrations = analysis.changes.filter(c => c.autoMigratable && c.migrationStrategy);
+        const noActionRequired = analysis.changes.filter(c => c.autoMigratable && !c.migrationStrategy).length;
         return {
             nodeType,
             available: true,
-            fromVersion,
-            toVersion,
+            fromVersion: analysis.fromVersion,
+            toVersion: analysis.toVersion,
             autoMigratableChanges: migrations.length,
-            totalChanges: allChanges.length,
+            noActionRequired,
+            totalChanges: analysis.changes.length,
             migrations: migrations.map(m => ({
                 property: m.propertyName,
                 changeType: m.changeType,
                 migrationStrategy: m.migrationStrategy,
-                severity: m.severity
+                severity: m.severity,
+                source: m.source
             })),
-            requiresManualMigration: migrations.length < allChanges.length
+            requiresManualMigration: analysis.manualRequiredCount > 0
         };
     }
     enrichPropertyWithTypeInfo(property) {