Roo-Code/src/utils/migrateSettings.ts

import * as vscode from "vscode"
import * as path from "path"
import * as fs from "fs/promises"
import { fileExistsAtPath } from "./fs"
import { GlobalFileNames } from "../shared/globalFileNames"

/**
 * Migrates old settings files to new file names
 *
 * TODO: Remove this migration code in September 2025 (6 months after implementation)
 */
export async function migrateSettings(
	context: vscode.ExtensionContext,
	outputChannel: vscode.OutputChannel,
): Promise<void> {
	// Legacy file names that need to be migrated to the new names in GlobalFileNames
	const fileMigrations = [
		{ oldName: "cline_custom_modes.json", newName: GlobalFileNames.customModes },
		{ oldName: "cline_mcp_settings.json", newName: GlobalFileNames.mcpSettings },
	]

	try {
		const settingsDir = path.join(context.globalStorageUri.fsPath, "settings")

		// Check if settings directory exists first
		if (!(await fileExistsAtPath(settingsDir))) {
			outputChannel.appendLine("No settings directory found, no migrations necessary")
			return
		}

		// Process each file migration
		for (const migration of fileMigrations) {
			const oldPath = path.join(settingsDir, migration.oldName)
			const newPath = path.join(settingsDir, migration.newName)

			// Only migrate if old file exists and new file doesn't exist yet
			// This ensures we don't overwrite any existing new files
			const oldFileExists = await fileExistsAtPath(oldPath)
			const newFileExists = await fileExistsAtPath(newPath)

			if (oldFileExists && !newFileExists) {
				await fs.rename(oldPath, newPath)
				outputChannel.appendLine(`Renamed ${migration.oldName} to ${migration.newName}`)
			} else {
				outputChannel.appendLine(
					`Skipping migration of ${migration.oldName} to ${migration.newName}: ${oldFileExists ? "new file already exists" : "old file not found"}`,
				)
			}
		}
	} catch (error) {
		outputChannel.appendLine(`Error migrating settings files: ${error}`)
	}
}