@buaa_smat/hometrans 0.1.0

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('');
+}