coderabbit-upgrade-migration

分析、规划并执行CodeRabbit SDK的升级，包括检测破坏性变更。在升级CodeRabbit SDK版本、检测已弃用的功能或迁移到新的API版本时使用。可以通过诸如“upgrade coderabbit”、“coderabbit migration”、“coderabbit breaking changes”、“update coderabbit SDK”、“analyze coderabbit version”等短语触发。

CodeRabbit Upgrade & Migration

Overview

Guide for upgrading CodeRabbit SDK versions and handling breaking changes.

Prerequisites

Current CodeRabbit SDK installed
Git for version control
Test suite available
Staging environment

Instructions

Step 1: Check Current Version

npm list @coderabbit/sdk
npm view @coderabbit/sdk version

Step 2: Review Changelog

open https://github.com/coderabbit/sdk/releases

Step 3: Create Upgrade Branch

git checkout -b upgrade/coderabbit-sdk-vX.Y.Z
npm install @coderabbit/sdk@latest
npm test

Step 4: Handle Breaking Changes

Update import statements, configuration, and method signatures as needed.

Output

Updated SDK version
Fixed breaking changes
Passing test suite
Documented rollback procedure

Error Handling

| SDK Version | API Version | Node.js | Breaking Changes | |-------------|-------------|---------|------------------| | 3.x | 2024-01 | 18+ | Major refactor | | 2.x | 2023-06 | 16+ | Auth changes | | 1.x | 2022-01 | 14+ | Initial release |

Examples

Import Changes

// Before (v1.x)
import { Client } from '@coderabbit/sdk';

// After (v2.x)
import { CodeRabbitClient } from '@coderabbit/sdk';

Configuration Changes

// Before (v1.x)
const client = new Client({ key: 'xxx' });

// After (v2.x)
const client = new CodeRabbitClient({
  apiKey: 'xxx',
});

Rollback Procedure

npm install @coderabbit/sdk@1.x.x --save-exact

Deprecation Handling

// Monitor for deprecation warnings in development
if (process.env.NODE_ENV === 'development') {
  process.on('warning', (warning) => {
    if (warning.name === 'DeprecationWarning') {
      console.warn('[CodeRabbit]', warning.message);
      // Log to tracking system for proactive updates
    }
  });
}

// Common deprecation patterns to watch for:
// - Renamed methods: client.oldMethod() -> client.newMethod()
// - Changed parameters: { key: 'x' } -> { apiKey: 'x' }
// - Removed features: Check release notes before upgrading

Resources

Next Steps

For CI integration during upgrades, see coderabbit-ci-integration.