@buaa_smat/hometrans 0.1.7 → 0.1.9

package/dist/cli/mcp-setup.js

@@ -0,0 +1,262 @@
+/**
+ * `ht init` 阶段：按 editors.json 中每个 editor 的 mcp.format 把 hometrans MCP
+ * server 注册到对应的 editor 配置文件。
+ *
+ * 支持的 mcp.format：
+ *   jsonc-object        Cursor / Claude Code 风格：jsonc 文件，key 路径写对象
+ *   jsonc-command-array OpenCode 风格：jsonc 文件，value 是 {type, command:[]}
+ *   codex-cli           Codex：优先 `codex mcp add`，失败回退追加 TOML section
+ *   toml-section        纯 TOML：追加 [<section>] 段
+ *   none                跳过 MCP 写入
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { execFile, execFileSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { promisify } from 'node:util';
+import { parseTree, modify, applyEdits, } from 'jsonc-parser';
+import { dirExists } from './init.js';
+import { expandHome } from './config-store.js';
+const execFileAsync = promisify(execFile);
+const _require = createRequire(import.meta.url);
+const _pkg = _require('../../package.json');
+if (typeof _pkg.version !== 'string' || !_pkg.version) {
+    throw new Error('hometrans package.json#version is missing — cannot generate MCP fallback config.');
+}
+const PKG_NAME = typeof _pkg.name === 'string' && _pkg.name ? _pkg.name : 'hometrans';
+const NPX_REF = `${PKG_NAME}@${_pkg.version}`;
+/** Locate the globally-installed `hometrans` (or `ht`) binary. */
+function resolveHometransBin() {
+    const isWin = process.platform === 'win32';
+    const cmd = isWin ? 'where' : 'which';
+    for (const candidate of ['hometrans', 'ht']) {
+        try {
+            const output = execFileSync(cmd, [candidate], {
+                encoding: 'utf-8',
+                timeout: 5000,
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+            const lines = output
+                .split('\n')
+                .map(l => l.trim())
+                .filter(Boolean);
+            if (lines.length === 0)
+                continue;
+            if (isWin) {
+                const cmdLine = lines.find(l => /\.(cmd|bat)$/i.test(l));
+                return cmdLine || lines[0];
+            }
+            return lines[0];
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return null;
+}
+/**
+ * MCP server entry written to editor config.
+ *
+ * Prefers global binary (fast startup) over `npx -y hometrans@<version> mcp`
+ * (cold-start may exceed Claude Code's 30s MCP connect timeout, esp. with
+ * arkanalyzer install). Falls back to npx when binary not on PATH.
+ */
+function getMcpEntry() {
+    const bin = resolveHometransBin();
+    if (bin) {
+        return { command: bin, args: ['mcp'] };
+    }
+    if (process.platform === 'win32') {
+        return { command: 'cmd', args: ['/c', 'npx', '-y', NPX_REF, 'mcp'] };
+    }
+    return { command: 'npx', args: ['-y', NPX_REF, 'mcp'] };
+}
+/** OpenCode uses a flat command-array format. */
+function getOpenCodeMcpEntry() {
+    const bin = resolveHometransBin();
+    if (bin) {
+        return { type: 'local', command: [bin, 'mcp'] };
+    }
+    if (process.platform === 'win32') {
+        return {
+            type: 'local',
+            command: ['cmd', '/c', 'npx', '-y', NPX_REF, 'mcp'],
+        };
+    }
+    return { type: 'local', command: ['npx', '-y', NPX_REF, 'mcp'] };
+}
+function detectIndentation(raw) {
+    const firstIndented = raw.match(/^( +|\t)/m);
+    if (!firstIndented)
+        return { tabSize: 2, insertSpaces: true };
+    if (firstIndented[1] === '\t')
+        return { tabSize: 1, insertSpaces: false };
+    return { tabSize: firstIndented[1].length, insertSpaces: true };
+}
+/**
+ * Merge a key/value pair into a JSONC config file, preserving comments and formatting.
+ * Returns false if the file is genuinely corrupt (leaves it untouched).
+ */
+async function mergeJsoncFile(filePath, keyPath, value) {
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        raw = '';
+    }
+    if (raw.trim().length === 0) {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        const formattingOptions = { tabSize: 2, insertSpaces: true };
+        const edits = modify('{}', keyPath, value, { formattingOptions });
+        const result = applyEdits('{}', edits);
+        await fs.writeFile(filePath, result, 'utf-8');
+        return true;
+    }
+    const parseErrors = [];
+    const tree = parseTree(raw, parseErrors);
+    if (tree && tree.type === 'object' && parseErrors.length === 0) {
+        const formattingOptions = detectIndentation(raw);
+        const edits = modify(raw, keyPath, value, { formattingOptions });
+        const result = applyEdits(raw, edits);
+        await fs.writeFile(filePath, result, 'utf-8');
+        return true;
+    }
+    return false;
+}
+function getTomlSection(sectionHeader) {
+    const entry = getMcpEntry();
+    const command = JSON.stringify(entry.command);
+    const args = `[${entry.args.map(arg => JSON.stringify(arg)).join(', ')}]`;
+    return `[${sectionHeader}]\ncommand = ${command}\nargs = ${args}\n`;
+}
+async function upsertTomlSection(configPath, sectionHeader) {
+    let existing = '';
+    try {
+        existing = await fs.readFile(configPath, 'utf-8');
+    }
+    catch {
+        existing = '';
+    }
+    if (existing.includes(`[${sectionHeader}]`)) {
+        return;
+    }
+    const section = getTomlSection(sectionHeader);
+    const nextContent = existing.trim().length > 0 ? `${existing.trimEnd()}\n\n${section}` : section;
+    await fs.mkdir(path.dirname(configPath), { recursive: true });
+    await fs.writeFile(configPath, `${nextContent.trimEnd()}\n`, 'utf-8');
+}
+// ─── Per-format writers ────────────────────────────────────────────
+async function writeJsoncObject(editor, result) {
+    const mcp = editor.mcp;
+    if (!mcp.path || !mcp.keyPath) {
+        result.errors.push(`${editor.name} MCP: jsonc-object format requires path + keyPath`);
+        return;
+    }
+    const configPath = expandHome(mcp.path);
+    try {
+        const ok = await mergeJsoncFile(configPath, mcp.keyPath, getMcpEntry());
+        if (ok) {
+            result.configured.push(`${editor.name} MCP (${prettyConfigPath(configPath)})`);
+        }
+        else {
+            result.errors.push(`${editor.name} MCP: ${configPath} is corrupt — skipping to preserve existing content`);
+        }
+    }
+    catch (err) {
+        result.errors.push(`${editor.name} MCP: ${err.message}`);
+    }
+}
+async function writeJsoncCommandArray(editor, result) {
+    const mcp = editor.mcp;
+    if (!mcp.path || !mcp.keyPath) {
+        result.errors.push(`${editor.name} MCP: jsonc-command-array format requires path + keyPath`);
+        return;
+    }
+    const configPath = expandHome(mcp.path);
+    try {
+        const ok = await mergeJsoncFile(configPath, mcp.keyPath, getOpenCodeMcpEntry());
+        if (ok) {
+            result.configured.push(`${editor.name} MCP (${prettyConfigPath(configPath)})`);
+        }
+        else {
+            result.errors.push(`${editor.name} MCP: ${configPath} is corrupt — skipping to preserve existing content`);
+        }
+    }
+    catch (err) {
+        result.errors.push(`${editor.name} MCP: ${err.message}`);
+    }
+}
+async function writeCodexCli(editor, result) {
+    try {
+        const entry = getMcpEntry();
+        await execFileAsync('codex', ['mcp', 'add', 'hometrans', '--', entry.command, ...entry.args], { shell: process.platform === 'win32' });
+        result.configured.push(`${editor.name} MCP (via codex mcp add)`);
+        return;
+    }
+    catch {
+        // Fall through to TOML write.
+    }
+    const mcp = editor.mcp;
+    if (!mcp.path || !mcp.section) {
+        result.errors.push(`${editor.name} MCP: codex-cli fallback requires path + section`);
+        return;
+    }
+    try {
+        const configPath = expandHome(mcp.path);
+        await upsertTomlSection(configPath, mcp.section);
+        result.configured.push(`${editor.name} MCP (${prettyConfigPath(configPath)})`);
+    }
+    catch (err) {
+        result.errors.push(`${editor.name} MCP: ${err.message}`);
+    }
+}
+async function writeTomlSection(editor, result) {
+    const mcp = editor.mcp;
+    if (!mcp.path || !mcp.section) {
+        result.errors.push(`${editor.name} MCP: toml-section format requires path + section`);
+        return;
+    }
+    try {
+        const configPath = expandHome(mcp.path);
+        await upsertTomlSection(configPath, mcp.section);
+        result.configured.push(`${editor.name} MCP (${prettyConfigPath(configPath)})`);
+    }
+    catch (err) {
+        result.errors.push(`${editor.name} MCP: ${err.message}`);
+    }
+}
+function prettyConfigPath(p) {
+    // 与 init.ts 中 prettyHome 行为一致，但避免循环引用：就地实现。
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    if (home && p.startsWith(home)) {
+        return '~' + p.slice(home.length).replace(/\\/g, '/');
+    }
+    return p.replace(/\\/g, '/');
+}
+async function setupOneEditor(editor, result) {
+    const marker = expandHome(editor.markerDir);
+    if (marker && !(await dirExists(marker))) {
+        result.skipped.push(`${editor.name} MCP (not installed)`);
+        return;
+    }
+    switch (editor.mcp.format) {
+        case 'jsonc-object':
+            return writeJsoncObject(editor, result);
+        case 'jsonc-command-array':
+            return writeJsoncCommandArray(editor, result);
+        case 'codex-cli':
+            return writeCodexCli(editor, result);
+        case 'toml-section':
+            return writeTomlSection(editor, result);
+        case 'none':
+            return;
+        default:
+            result.errors.push(`${editor.name} MCP: unknown mcp.format "${editor.mcp.format}"`);
+    }
+}
+export async function setupMcpForAllEditors(editors, result) {
+    for (const editor of editors) {
+        await setupOneEditor(editor, result);
+    }
+}

package/dist/cli/mcp.js

@@ -0,0 +1,94 @@
+/**
+ * `ht mcp` — stdio MCP server exposing HomeTrans tools.
+ *
+ * Currently registers a single tool: `extract_commit_context`, which wraps
+ * the vendored ArkTS commit-context extractor (src/context/index.ts).
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { extractCommitContext } from '../context/index.js';
+// stdio is the MCP protocol channel — any console.log from vendored code
+// would corrupt frames. Redirect stdout-side logging to stderr.
+console.log = console.error;
+console.info = console.error;
+console.dir = (...args) => process.stderr.write(args.map(a => (typeof a === 'string' ? a : JSON.stringify(a))).join(' ') + '\n');
+const EXTRACT_COMMIT_CONTEXT_TOOL = {
+    name: 'extract_commit_context',
+    description: '提取 HarmonyOS 工程指定 commit 的代码上下文索引（git diff + ArkTS 语义依赖：模块依赖、字符串/复数/数组资源依赖），供 AI 评审 Android→HarmonyOS 转换代码时使用。返回 {path, kind, ranges?, resourceNames?}[]：source 文件给出 1-based 行号区间数组，调用方按需读取；resource 文件给出引用到的资源名列表。不返回文件内容，避免上下文过长。',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectPath: {
+                type: 'string',
+                description: 'HarmonyOS 工程的绝对路径（包含 .git 目录的仓库根）',
+            },
+            commitId: {
+                type: 'string',
+                description: '要分析的 git commit id（会和它的第一个父提交做 diff）',
+            },
+            mode: {
+                type: 'string',
+                description: '分析模式：default = 构建完整 call graph 做调用链上下文；其它值跳过 call graph 构建',
+                default: 'default',
+            },
+            ohosSdkPath: {
+                type: 'string',
+                description: 'OpenHarmony SDK ETS 目录绝对路径（如 D:/DevEco Studio/sdk/default/openharmony/ets）。未传则读环境变量 OHOS_SDK_PATH。',
+            },
+            hmsSdkPath: {
+                type: 'string',
+                description: 'HMS SDK ETS 目录绝对路径（如 D:/DevEco Studio/sdk/default/hms/ets）。未传则读环境变量 HMS_SDK_PATH。',
+            },
+        },
+        required: ['projectPath', 'commitId'],
+    },
+};
+export async function runMcpServer() {
+    const server = new Server({ name: 'hometrans', version: '0.1.2' }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [EXTRACT_COMMIT_CONTEXT_TOOL],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        if (name !== EXTRACT_COMMIT_CONTEXT_TOOL.name) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+            };
+        }
+        try {
+            const input = (args ?? {});
+            const result = await extractCommitContext({
+                projectPath: input.projectPath ?? '',
+                commitId: input.commitId ?? '',
+                mode: input.mode,
+                ohosSdkPath: input.ohosSdkPath,
+                hmsSdkPath: input.hmsSdkPath,
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `extract_commit_context failed: ${err?.message ?? String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+    process.on('uncaughtException', err => {
+        console.error('[hometrans/mcp] uncaughtException:', err);
+    });
+    process.on('unhandledRejection', err => {
+        console.error('[hometrans/mcp] unhandledRejection:', err);
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[hometrans/mcp] server connected on stdio');
+}

package/dist/cli/uninstall.js

@@ -0,0 +1,310 @@
+/**
+ * `ht uninstall` — remove all skills, agents, and MCP entries that
+ * `ht init` installed into the configured editors.
+ *
+ * Determines what to remove by matching bundled skill/agent names against
+ * each editor's target directories. MCP entries are scrubbed from editor
+ * config files (JSONC key removal or TOML section removal).
+ *
+ * Shows a plan and prompts for confirmation before proceeding.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { modify, applyEdits } from 'jsonc-parser';
+import { expandHome, loadHomeTransConfig, } from './config-store.js';
+import { dirExists, prettyHome } from './init.js';
+const execFileAsync = promisify(execFile);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/* ------------------------------------------------------------------ */
+/*  Bundled content discovery                                          */
+/* ------------------------------------------------------------------ */
+function resolveSkillsRoot() {
+    return path.resolve(__dirname, '..', '..', 'skills');
+}
+function resolveAgentsRoot() {
+    return path.resolve(__dirname, '..', '..', 'agents');
+}
+async function listBundledSkillNames(skillsRoot) {
+    const names = [];
+    try {
+        const entries = await fs.readdir(skillsRoot, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const hasSkill = await fs
+                .access(path.join(skillsRoot, entry.name, 'SKILL.md'))
+                .then(() => true)
+                .catch(() => false);
+            if (hasSkill)
+                names.push(entry.name);
+        }
+    }
+    catch {
+        // dir doesn't exist
+    }
+    return names;
+}
+async function listBundledAgentEntries(agentsRoot) {
+    try {
+        const entries = await fs.readdir(agentsRoot, { withFileTypes: true });
+        return {
+            dirs: entries.filter((e) => e.isDirectory()).map((e) => e.name),
+            files: entries.filter((e) => e.isFile()).map((e) => e.name),
+        };
+    }
+    catch {
+        return { dirs: [], files: [] };
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  MCP config removal helpers                                         */
+/* ------------------------------------------------------------------ */
+function detectIndentation(raw) {
+    const firstIndented = raw.match(/^( +|\t)/m);
+    if (!firstIndented)
+        return { tabSize: 2, insertSpaces: true };
+    if (firstIndented[1] === '\t')
+        return { tabSize: 1, insertSpaces: false };
+    return { tabSize: firstIndented[1].length, insertSpaces: true };
+}
+async function tryRemoveJsoncKey(filePath, keyPath) {
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const formattingOptions = detectIndentation(raw);
+    const edits = modify(raw, keyPath, undefined, { formattingOptions });
+    if (edits.length === 0)
+        return null;
+    return applyEdits(raw, edits);
+}
+async function tryRemoveTomlSection(filePath, sectionHeader) {
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const sectionTag = `[${sectionHeader}]`;
+    if (!raw.includes(sectionTag))
+        return null;
+    const lines = raw.split('\n');
+    const result = [];
+    let inSection = false;
+    for (const line of lines) {
+        if (line.trim() === sectionTag) {
+            inSection = true;
+            continue;
+        }
+        if (inSection && line.trim().startsWith('[')) {
+            inSection = false;
+        }
+        if (!inSection) {
+            result.push(line);
+        }
+    }
+    let content = result.join('\n').replace(/\n{3,}/g, '\n\n').trimEnd();
+    if (content.length > 0)
+        content += '\n';
+    return content;
+}
+/* ------------------------------------------------------------------ */
+/*  Plan building                                                      */
+/* ------------------------------------------------------------------ */
+async function buildPlanForEditor(editor, skillNames, agentEntries, plan) {
+    const marker = expandHome(editor.markerDir);
+    if (marker && !(await dirExists(marker)))
+        return;
+    const skillsDir = expandHome(editor.skillsDir);
+    const agentsDir = expandHome(editor.agentsDir);
+    for (const name of skillNames) {
+        const p = path.join(skillsDir, name);
+        if (await dirExists(p)) {
+            plan.deletions.push({
+                display: `${editor.name}: ${prettyHome(p)}/`,
+                absPath: p,
+            });
+        }
+    }
+    for (const fileName of agentEntries.files) {
+        const p = path.join(agentsDir, fileName);
+        const exists = await fs
+            .access(p)
+            .then(() => true)
+            .catch(() => false);
+        if (exists) {
+            plan.deletions.push({
+                display: `${editor.name}: ${prettyHome(p)}`,
+                absPath: p,
+            });
+        }
+    }
+    for (const dirName of agentEntries.dirs) {
+        const p = path.join(agentsDir, dirName);
+        if (await dirExists(p)) {
+            plan.deletions.push({
+                display: `${editor.name}: ${prettyHome(p)}/`,
+                absPath: p,
+            });
+        }
+    }
+    const { mcp } = editor;
+    switch (mcp.format) {
+        case 'jsonc-object':
+        case 'jsonc-command-array': {
+            if (!mcp.path || !mcp.keyPath)
+                break;
+            const configPath = expandHome(mcp.path);
+            const newContent = await tryRemoveJsoncKey(configPath, mcp.keyPath);
+            if (newContent !== null) {
+                plan.modifications.push({
+                    display: `${editor.name}: ${prettyHome(configPath)}`,
+                    absPath: configPath,
+                    reason: 'Remove hometrans MCP entry',
+                    newContent,
+                });
+            }
+            break;
+        }
+        case 'codex-cli': {
+            plan.codexRemove = true;
+            if (mcp.path && mcp.section) {
+                const configPath = expandHome(mcp.path);
+                const newContent = await tryRemoveTomlSection(configPath, mcp.section);
+                if (newContent !== null) {
+                    plan.modifications.push({
+                        display: `${editor.name}: ${prettyHome(configPath)}`,
+                        absPath: configPath,
+                        reason: 'Remove hometrans MCP section',
+                        newContent,
+                    });
+                }
+            }
+            break;
+        }
+        case 'toml-section': {
+            if (!mcp.path || !mcp.section)
+                break;
+            const configPath = expandHome(mcp.path);
+            const newContent = await tryRemoveTomlSection(configPath, mcp.section);
+            if (newContent !== null) {
+                plan.modifications.push({
+                    display: `${editor.name}: ${prettyHome(configPath)}`,
+                    absPath: configPath,
+                    reason: 'Remove hometrans MCP section',
+                    newContent,
+                });
+            }
+            break;
+        }
+        case 'none':
+            break;
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  Render                                                             */
+/* ------------------------------------------------------------------ */
+function renderPlan(plan) {
+    console.log(chalk.bold('\nHomeTrans uninstall plan\n'));
+    if (plan.deletions.length === 0 && plan.modifications.length === 0) {
+        console.log(chalk.gray('  Nothing to uninstall — no hometrans files found in configured editors.\n'));
+        return;
+    }
+    if (plan.deletions.length > 0) {
+        console.log(chalk.red.bold(`  Will be deleted (${plan.deletions.length} entries):`));
+        for (const d of plan.deletions) {
+            console.log(`    ${chalk.red('-')} ${d.display}`);
+        }
+        console.log('');
+    }
+    if (plan.modifications.length > 0) {
+        console.log(chalk.yellow.bold(`  Will be modified (${plan.modifications.length} files):`));
+        for (const m of plan.modifications) {
+            console.log(`    ${chalk.yellow('~')} ${m.display}  ${chalk.gray(`(${m.reason})`)}`);
+        }
+        console.log('');
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  Execute                                                            */
+/* ------------------------------------------------------------------ */
+async function executePlan(plan) {
+    let deleted = 0;
+    let modified = 0;
+    for (const mod of plan.modifications) {
+        await fs.writeFile(mod.absPath, mod.newContent, 'utf-8');
+        modified++;
+    }
+    if (plan.codexRemove) {
+        try {
+            await execFileAsync('codex', ['mcp', 'remove', 'hometrans'], {
+                shell: process.platform === 'win32',
+            });
+        }
+        catch {
+            // codex CLI unavailable or failed — TOML path already handled above
+        }
+    }
+    for (const del of plan.deletions) {
+        try {
+            await fs.rm(del.absPath, { recursive: true, force: true });
+            deleted++;
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return { deleted, modified };
+}
+/* ------------------------------------------------------------------ */
+/*  Entry point                                                        */
+/* ------------------------------------------------------------------ */
+export async function uninstallCommand() {
+    const skillNames = await listBundledSkillNames(resolveSkillsRoot());
+    const agentEntries = await listBundledAgentEntries(resolveAgentsRoot());
+    const totalBundled = skillNames.length + agentEntries.dirs.length + agentEntries.files.length;
+    if (totalBundled === 0) {
+        console.log(chalk.yellow('\n  No bundled skills or agents found — cannot determine what to uninstall.'));
+        console.log(chalk.gray('  Reinstall hometrans or manually remove skill/agent directories from your editors.\n'));
+        return;
+    }
+    const { editors } = await loadHomeTransConfig();
+    const plan = {
+        deletions: [],
+        modifications: [],
+        codexRemove: false,
+    };
+    for (const editor of editors) {
+        await buildPlanForEditor(editor, skillNames, agentEntries, plan);
+    }
+    renderPlan(plan);
+    if (plan.deletions.length === 0 && plan.modifications.length === 0) {
+        return;
+    }
+    const { proceed } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'proceed',
+            message: 'Continue?',
+            default: false,
+        },
+    ]);
+    if (!proceed) {
+        console.log(chalk.yellow('\n  Uninstall cancelled. No files modified.\n'));
+        return;
+    }
+    const summary = await executePlan(plan);
+    console.log('');
+    console.log(chalk.green(`  Uninstalled: ${summary.deleted} entries deleted, ${summary.modified} files modified.`));
+    console.log('');
+}