feat(zoo-migration): new service to support community-driven extension

Author: edelauna

packages/types/src/vscode.ts

@@ -42,6 +42,7 @@ export const commandIds = [
 
 	"setCustomStoragePath",
 	"importSettings",
+	"prepareZooMigration",
 
 	"focusInput",
 	"acceptInput",

src/__mocks__/fs/promises.ts

@@ -150,6 +150,68 @@ const mockFs = {
 		throw error
 	}),
 
+	rm: vi.fn().mockImplementation(async (targetPath: string, options?: { recursive?: boolean; force?: boolean }) => {
+		if (mockFiles.has(targetPath)) {
+			mockFiles.delete(targetPath)
+			return Promise.resolve()
+		}
+
+		if (mockDirectories.has(targetPath)) {
+			for (const filePath of Array.from(mockFiles.keys())) {
+				if (filePath.startsWith(`${targetPath}/`)) {
+					mockFiles.delete(filePath)
+				}
+			}
+			for (const dirPath of Array.from(mockDirectories.values()) as string[]) {
+				if (dirPath === targetPath || dirPath.startsWith(`${targetPath}/`)) {
+					mockDirectories.delete(dirPath)
+				}
+			}
+			return Promise.resolve()
+		}
+
+		if (options?.force) {
+			return Promise.resolve()
+		}
+
+		const error = new Error(`ENOENT: no such file or directory, rm '${targetPath}'`)
+		;(error as any).code = "ENOENT"
+		throw error
+	}),
+
+	cp: vi.fn().mockImplementation(async (sourcePath: string, destinationPath: string) => {
+		if (mockFiles.has(sourcePath)) {
+			const parentDir = destinationPath.split("/").slice(0, -1).join("/")
+			ensureDirectoryExists(parentDir)
+			mockFiles.set(destinationPath, mockFiles.get(sourcePath))
+			return Promise.resolve()
+		}
+
+		if (mockDirectories.has(sourcePath)) {
+			ensureDirectoryExists(destinationPath)
+			for (const dirPath of Array.from(mockDirectories.values()) as string[]) {
+				if (dirPath.startsWith(`${sourcePath}/`)) {
+					ensureDirectoryExists(destinationPath + dirPath.slice(sourcePath.length))
+				}
+			}
+			for (const [filePath, content] of Array.from(mockFiles.entries())) {
+				if (filePath.startsWith(`${sourcePath}/`)) {
+					const copiedPath = destinationPath + filePath.slice(sourcePath.length)
+					const parentDir = copiedPath.split("/").slice(0, -1).join("/")
+					ensureDirectoryExists(parentDir)
+					mockFiles.set(copiedPath, content)
+				}
+			}
+			return Promise.resolve()
+		}
+
+		const error = new Error(`ENOENT: no such file or directory, cp '${sourcePath}'`)
+		;(error as any).code = "ENOENT"
+		throw error
+	}),
+
+	chmod: vi.fn().mockResolvedValue(undefined),
+
 	constants: require("fs").constants,
 
 	// Expose mock data for test assertions

src/activate/registerCommands.ts

@@ -13,6 +13,7 @@ import { handleNewTask } from "./handleTask"
 import { CodeIndexManager } from "../services/code-index/manager"
 import { importSettingsWithFeedback } from "../core/config/importExport"
 import { MdmService } from "../services/mdm/MdmService"
+import { createZooMigrationHandoff, promptAndCreateZooMigrationHandoff } from "../services/zoo-migration/ZooMigration"
 import { t } from "../i18n"
 
 /**
@@ -155,6 +156,30 @@ const getCommandsMap = ({ context, outputChannel, provider }: RegisterCommandOpt
 			filePath,
 		)
 	},
+	prepareZooMigration: async (options?: { skipPrompt?: boolean; includeSecrets?: boolean }) => {
+		try {
+			const migrationOptions = {
+				context,
+				contextProxy: provider.contextProxy,
+				providerSettingsManager: provider.providerSettingsManager,
+				outputChannel,
+			}
+
+			if (options?.skipPrompt) {
+				return await createZooMigrationHandoff({
+					...migrationOptions,
+					includeSecrets: options.includeSecrets ?? false,
+				})
+			}
+
+			return await promptAndCreateZooMigrationHandoff(migrationOptions)
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error)
+			outputChannel.appendLine(`[Zoo Migration] Failed to prepare migration handoff: ${message}`)
+			await vscode.window.showErrorMessage(t("common:zooMigration.handoffFailed", { error: message }))
+			return undefined
+		}
+	},
 	focusInput: async () => {
 		try {
 			await focusPanel(tabPanel, sidebarPanel)

src/extension.ts

@@ -39,6 +39,7 @@ import { MdmService } from "./services/mdm/MdmService"
 import { migrateSettings } from "./utils/migrateSettings"
 import { autoImportSettings } from "./utils/autoImportSettings"
 import { API } from "./extension/api"
+import { showZooMigrationNotice } from "./services/zoo-migration/ZooMigration"
 
 import {
 	handleUri,
@@ -317,6 +318,12 @@ export async function activate(context: vscode.ExtensionContext) {
 
 	registerCommands({ context, outputChannel, provider })
 
+	void showZooMigrationNotice(context, { outputChannel }).catch((error) => {
+		outputChannel.appendLine(
+			`[Zoo Migration] Failed to show migration notice: ${error instanceof Error ? error.message : String(error)}`,
+		)
+	})
+
 	/**
 	 * We use the text document content provider API to show the left side for diff
 	 * view by creating a virtual document for the original content. This makes it

src/i18n/locales/ca/common.json

@@ -19,6 +19,22 @@
 		"delete_config_profile": "Are you sure you want to delete this configuration profile?",
 		"delete_custom_mode_with_rules": "Are you sure you want to delete this {scope} mode?\n\nThis will also delete the associated rules folder at:\n{rulesFolderPath}"
 	},
+	"zooMigration": {
+		"actions": {
+			"installZoo": "Install Zoo",
+			"prepareMigration": "Prepare Migration",
+			"learnMore": "Learn More",
+			"later": "Later",
+			"includeApiKeys": "Include API keys",
+			"skipApiKeys": "Skip API keys",
+			"cancel": "Cancel"
+		},
+		"notice": "Roo Code is transitioning to Zoo Code. You can prepare a copy-based migration handoff for Zoo without deleting your Roo data.",
+		"zooNotPublished": "Zoo Code is not published under a confirmed Marketplace extension id yet. The Extensions view has been opened with a Zoo Code search.",
+		"preparePrompt": "Prepare a local Zoo Code migration handoff? Including API keys writes provider secrets to a local file so Zoo can import them, then delete the handoff after import.",
+		"handoffPrepared": "Zoo Code migration handoff prepared at {{path}}. Install Zoo Code and import from this handoff.",
+		"handoffFailed": "Failed to prepare Zoo Code migration handoff: {{error}}"
+	},
 	"errors": {
 		"invalid_data_uri": "Invalid data URI format",
 		"error_copying_image": "Error copying image: {{errorMessage}}",