couchloop-eq-mcp 1.1.4 → 1.2.0

package/dist/tools/generate-upgrade-report.d.ts

@@ -0,0 +1,85 @@
+/**
+ * MCP Tool: generate_upgrade_report
+ *
+ * Generates comprehensive upgrade reports with migration guides, breaking changes,
+ * and rollback strategies for updating dependencies.
+ */
+export declare const generateUpgradeReportTool: {
+    name: string;
+    description: string;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: {
+        type: string;
+        properties: {
+            package_name: {
+                type: string;
+                description: string;
+            };
+            current_version: {
+                type: string;
+                description: string;
+            };
+            target_version: {
+                type: string;
+                description: string;
+            };
+            registry: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGenerateUpgradeReport(args: unknown): Promise<{
+    success: boolean;
+    error: string;
+    package?: undefined;
+    from_version?: undefined;
+    to_version?: undefined;
+    complexity?: undefined;
+    estimated_time?: undefined;
+    upgrade_command?: undefined;
+    install_command?: undefined;
+    breaking_changes?: undefined;
+    deprecations?: undefined;
+    migration_steps?: undefined;
+    testing_strategy?: undefined;
+    rollback_strategy?: undefined;
+    risks?: undefined;
+    resources?: undefined;
+} | {
+    success: boolean;
+    package: string;
+    from_version: string | undefined;
+    to_version: string;
+    complexity: "medium" | "low" | "high";
+    estimated_time: string;
+    upgrade_command: string;
+    install_command: string;
+    breaking_changes: import("../developer/validators/version-checker.js").BreakingChange[];
+    deprecations: import("../developer/validators/version-checker.js").DeprecationNotice[];
+    migration_steps: {
+        step: number;
+        title: string;
+        description: string;
+        commands: string[] | undefined;
+        code_changes: import("../developer/updaters/dependency-updater.js").CodeChange[] | undefined;
+        verification: string;
+    }[];
+    testing_strategy: string[];
+    rollback_strategy: string;
+    risks: {
+        level: "medium" | "low" | "high" | "critical";
+        factors: string[];
+        mitigations: string[];
+    };
+    resources: import("../developer/updaters/dependency-updater.js").MigrationResource[];
+    error?: undefined;
+}>;
+//# sourceMappingURL=generate-upgrade-report.d.ts.map

package/dist/tools/generate-upgrade-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-upgrade-report.d.ts","sourceRoot":"","sources":["../../src/tools/generate-upgrade-report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BrC,CAAC;AAEF,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4D9D"}

package/dist/tools/generate-upgrade-report.js

@@ -0,0 +1,102 @@
+/**
+ * MCP Tool: generate_upgrade_report
+ *
+ * Generates comprehensive upgrade reports with migration guides, breaking changes,
+ * and rollback strategies for updating dependencies.
+ */
+import { z } from 'zod';
+import { DependencyUpdater } from '../developer/updaters/dependency-updater.js';
+import { VersionChecker } from '../developer/validators/version-checker.js';
+import { logger } from '../utils/logger.js';
+const GenerateUpgradeReportInputSchema = z.object({
+    package_name: z.string().describe('Package name to upgrade'),
+    current_version: z.string().optional().describe('Current version (auto-detected if not provided)'),
+    target_version: z.string().optional().describe('Target version (latest if not specified)'),
+    registry: z.enum(['npm', 'pypi', 'maven', 'cargo', 'go', 'nuget', 'gem']).default('npm').describe('Package registry'),
+});
+export const generateUpgradeReportTool = {
+    name: 'generate_upgrade_report',
+    description: 'Generates comprehensive upgrade reports for dependencies: breaking changes, migration steps, code changes needed, testing strategy, and rollback commands. Essential before major version upgrades.',
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true, // Makes network requests
+    },
+    inputSchema: {
+        type: 'object',
+        properties: {
+            package_name: {
+                type: 'string',
+                description: 'Package name to upgrade',
+            },
+            current_version: {
+                type: 'string',
+                description: 'Current version (auto-detected if not provided)',
+            },
+            target_version: {
+                type: 'string',
+                description: 'Target version (latest if not specified)',
+            },
+            registry: {
+                type: 'string',
+                enum: ['npm', 'pypi', 'maven', 'cargo', 'go', 'nuget', 'gem'],
+                description: 'Package registry (default: npm)',
+            },
+        },
+        required: ['package_name'],
+    },
+};
+export async function handleGenerateUpgradeReport(args) {
+    try {
+        const input = GenerateUpgradeReportInputSchema.parse(args);
+        logger.info(`Generating upgrade report for ${input.package_name}`);
+        // First, get version info from the checker
+        const versionChecker = new VersionChecker();
+        const versionInfo = await versionChecker.checkVersion(input.package_name, input.current_version, input.registry);
+        if (!versionInfo.latestVersion) {
+            return {
+                success: false,
+                error: `Could not find version info for ${input.package_name} in ${input.registry} registry`,
+            };
+        }
+        // Generate the upgrade report
+        const updater = new DependencyUpdater();
+        const report = updater.generateUpgradeReport(versionInfo, input.current_version);
+        return {
+            success: true,
+            package: report.packageName,
+            from_version: report.fromVersion,
+            to_version: report.toVersion,
+            complexity: report.complexity,
+            estimated_time: report.estimatedTime,
+            upgrade_command: report.upgradeCommand,
+            install_command: report.installCommand,
+            breaking_changes: report.breakingChanges,
+            deprecations: report.deprecations,
+            migration_steps: report.migrationSteps.map(step => ({
+                step: step.step,
+                title: step.title,
+                description: step.description,
+                commands: step.commands,
+                code_changes: step.codeChanges,
+                verification: step.verification,
+            })),
+            testing_strategy: report.testingStrategy,
+            rollback_strategy: report.rollbackStrategy,
+            risks: {
+                level: report.risks.level,
+                factors: report.risks.factors,
+                mitigations: report.risks.mitigations,
+            },
+            resources: report.resources,
+        };
+    }
+    catch (error) {
+        logger.error('Error in generate_upgrade_report:', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+//# sourceMappingURL=generate-upgrade-report.js.map

package/dist/tools/generate-upgrade-report.js.map

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