@buaa_smat/hometrans 0.1.9 → 0.1.10

package/README.md

@@ -1,6 +1,6 @@
 # hometrans
 
-> Skill + agent installer for the **HomeTrans** Android-to-HarmonyOS conversion toolkit. One command (`ht init`) distributes **7 skills**, **9 subagents** (with a script bundle + on-device test tooling), and an **MCP server** into Claude Code, Cursor, OpenCode, and Codex.
+> Skill + agent installer for the **HomeTrans** Android-to-HarmonyOS conversion toolkit. One command (`ht init`) distributes **7 skills**, **9 subagents** (with a script bundle + on-device test tooling), and an **MCP server** into Claude Code, Cursor, OpenCode, Codex, and CodeBuddy.
 
 ---
 
@@ -23,7 +23,7 @@ After running `ht init`, follow these steps to complete the installation:
 
 ### Step 1: Choose your target editor
 
-`ht init` automatically detects supported editors (Claude Code, Cursor, OpenCode, Codex) and presents an interactive selection prompt. Use **Space** to toggle and **Enter** to confirm.
+`ht init` automatically detects supported editors (Claude Code, Cursor, OpenCode, Codex, CodeBuddy) and presents an interactive selection prompt. Use **Space** to toggle and **Enter** to confirm.
 
 ![Choose target editor](resource/choose_editor.png)
 
@@ -167,12 +167,13 @@ For more details, see the official GitNexus repository: <https://github.com/abhi
 
 ### Target directories
 
-| Editor | Marker | Skills target | Agents target |
-|--------|--------|---------------|---------------|
-| Claude Code | `~/.claude/` | `~/.claude/skills/` | `~/.claude/agents/` |
-| Cursor | `~/.cursor/` | `~/.cursor/skills/` | `~/.cursor/agents/` |
-| OpenCode | `~/.config/opencode/` | `~/.config/opencode/skills/` | `~/.config/opencode/agents/` |
-| Codex | `~/.codex/` | `~/.agents/skills/` | `~/.codex/agents/` |
+| Editor | Marker | Skills target | Agents target | MCP config |
+|--------|--------|---------------|---------------|------------|
+| Claude Code | `~/.claude/` | `~/.claude/skills/` | `~/.claude/agents/` | `~/.claude.json` → `mcpServers.hometrans` |
+| Cursor | `~/.cursor/` | `~/.cursor/skills/` | `~/.cursor/agents/` | `~/.cursor/mcp.json` → `mcpServers.hometrans` |
+| OpenCode | `~/.config/opencode/` | `~/.config/opencode/skills/` | `~/.config/opencode/agents/` | `~/.config/opencode/opencode.json` → `mcp.hometrans` |
+| Codex | `~/.codex/` | `~/.agents/skills/` | `~/.codex/agents/` | `codex mcp add` → `~/.codex/config.toml` `[mcp_servers.hometrans]` |
+| CodeBuddy | `~/.codebuddy/` | `~/.codebuddy/skills/` | `~/.codebuddy/agents/` | `~/.codebuddy/mcp.json` → `mcpServers.hometrans` |
 
 ---
 

package/dist/cli/config-store.js

@@ -1,7 +1,7 @@
 /**
  * 全局配置存储：~/.hometrans/config.json
  *
- * 当前包含 editors 配置（Claude Code / Cursor / OpenCode / Codex），后续可扩展
+ * 当前包含 editors 配置（Claude Code / Cursor / OpenCode / Codex / CodeBuddy），后续可扩展
  * 其它顶层字段。首次 setup 时若文件不存在则写入默认值；之后用户可手动编辑。
  * `ht config` 只读不改。
  */
@@ -76,6 +76,19 @@ export function defaultEditors() {
                 section: 'mcp_servers.hometrans',
             },
         },
+        {
+            // CodeBuddy（腾讯）：与 Claude Code 同构的 .codebuddy/ 目录，
+            // 全局安装映射到 ~/.codebuddy/{skills,agents}，MCP 走 mcpServers JSON。
+            name: 'CodeBuddy',
+            markerDir: '~/.codebuddy',
+            skillsDir: '~/.codebuddy/skills',
+            agentsDir: '~/.codebuddy/agents',
+            mcp: {
+                format: 'jsonc-object',
+                path: '~/.codebuddy/mcp.json',
+                keyPath: ['mcpServers', 'hometrans'],
+            },
+        },
     ];
 }
 async function fileExists(p) {
@@ -139,6 +152,16 @@ export async function loadHomeTransConfig() {
     delete anyParsed.sdkPaths;
     delete anyParsed.params;
     delete anyParsed.tool_path;
+    // Append any default editors that this (older) config predates, matched by
+    // name. Existing entries are never modified, so manual edits are preserved;
+    // we only add editors the user's file is missing (e.g. CodeBuddy shipped
+    // after they first ran `ht init`). Persist so the new editor shows up.
+    const existingNames = new Set(config.editors.map((e) => e.name));
+    const missingEditors = defaultEditors().filter((e) => !existingNames.has(e.name));
+    if (missingEditors.length > 0) {
+        config.editors.push(...missingEditors);
+        await saveHomeTransConfig(config);
+    }
     return config;
 }
 export async function saveHomeTransConfig(config) {

package/dist/cli/config.js

@@ -2,7 +2,7 @@
  * `ht config` — 打印 editors.json 路径与内容。
  *
  * 该命令只读：用户若要修改 editor 配置，直接编辑这个 JSON 文件即可。
- * 文件不存在时自动写入默认 4 个 editor。
+ * 文件不存在时自动写入默认 5 个 editor。
  */
 import fs from 'node:fs/promises';
 import { getConfigPath, loadHomeTransConfig } from './config-store.js';

package/dist/cli/index.js

@@ -1,12 +1,34 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 import { createRequire } from 'node:module';
+import chalk from 'chalk';
 import { initCommand } from './init.js';
 import { runMcpServer } from './mcp.js';
 import { configCommand } from './config.js';
 import { uninstallCommand } from './uninstall.js';
 const _require = createRequire(import.meta.url);
 const pkg = _require('../../package.json');
+/**
+ * Global Ctrl-C safety net.
+ *
+ * inquirer intercepts Ctrl-C as a keypress *inside* a prompt (raw mode) and the
+ * per-command catches print a tailored "Cancelled" notice there. But Ctrl-C
+ * pressed *outside* a prompt — e.g. while `init` is copying files or `uninstall`
+ * is deleting — arrives as an OS SIGINT, which Node would otherwise terminate on
+ * silently. This handler guarantees a cancel notice in that case too.
+ *
+ * The MCP server (`ht mcp`) runs over stdio and must keep its own shutdown
+ * semantics, so it removes this handler on startup.
+ */
+let interrupted = false;
+function onSigint() {
+    if (interrupted)
+        process.exit(130);
+    interrupted = true;
+    console.log(chalk.yellow('\n  Cancelled by Ctrl-C. No further changes will be made.\n'));
+    process.exit(130);
+}
+process.on('SIGINT', onSigint);
 const program = new Command();
 program
     .name('hometrans')
@@ -23,6 +45,8 @@ program
     .command('mcp')
     .description('Run the HomeTrans MCP server (stdio)')
     .action(async () => {
+    // The MCP server owns its own SIGINT/shutdown handling; drop the CLI net.
+    process.off('SIGINT', onSigint);
     await runMcpServer();
 });
 program

package/dist/cli/init.js

@@ -19,6 +19,20 @@ function ensureChalkColor() {
         chalk.level = 1;
     }
 }
+/**
+ * Did the user abort an inquirer prompt with Ctrl-C / Esc?
+ * inquirer v14 (@inquirer/core) rejects with an `ExitPromptError` in that case.
+ * We must distinguish this from a genuine non-interactive failure (no TTY),
+ * otherwise Ctrl-C silently gets swallowed and the install proceeds anyway.
+ */
+export function isPromptAbort(err) {
+    return err instanceof Error && err.name === 'ExitPromptError';
+}
+/** Print a cancellation notice and exit with the conventional SIGINT code. */
+function abortInit() {
+    console.log(chalk.yellow('\n  Cancelled. No changes were made beyond this point.\n'));
+    process.exit(130);
+}
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 export async function dirExists(dirPath) {
@@ -256,13 +270,26 @@ export async function initCommand(options = {}) {
                 {
                     type: 'checkbox',
                     name: 'selectedEditors',
-                    message: 'Select editors to configure (arrow keys + space to toggle, enter to confirm):',
+                    message: 'Select editors to configure:',
                     choices,
+                    // Append a "ctrl-c cancel" entry to the built-in key help line, reusing
+                    // @inquirer/checkbox's default formatting (bold key · dim action · dim
+                    // " • " separator):
+                    //   ↑↓ navigate • space select • a all • i invert • ⏎ submit • ctrl-c cancel
+                    theme: {
+                        style: {
+                            keysHelpTip: (keys) => [...keys, ['ctrl-c', 'cancel']]
+                                .map(([key, action]) => `${chalk.bold(key)} ${chalk.dim(action)}`)
+                                .join(chalk.dim(' • ')),
+                        },
+                    },
                 },
             ]);
             selectedEditors = answers.selectedEditors;
         }
-        catch {
+        catch (err) {
+            if (isPromptAbort(err))
+                abortInit();
             console.log(chalk.yellow('\n  Interactive selection failed. Auto-selecting all detected editors.'));
             console.log(chalk.gray('  Tip: use --all to skip interactive selection.\n'));
             selectedEditors = editors
@@ -304,7 +331,9 @@ export async function initCommand(options = {}) {
         config.env.TEST_API_KEY = answers.TEST_API_KEY.trim();
         await saveHomeTransConfig(config);
     }
-    catch {
+    catch (err) {
+        if (isPromptAbort(err))
+            abortInit();
         console.log(chalk.yellow('  Parameter prompts skipped (non-interactive mode).'));
     }
     // Copy bundled tools/ into ~/.hometrans/tools and record env.TOOL_PATH.

package/dist/cli/uninstall.js

@@ -17,7 +17,7 @@ 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';
+import { dirExists, isPromptAbort, prettyHome } from './init.js';
 const execFileAsync = promisify(execFile);
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -291,14 +291,25 @@ export async function uninstallCommand() {
     if (plan.deletions.length === 0 && plan.modifications.length === 0) {
         return;
     }
-    const { proceed } = await inquirer.prompt([
-        {
-            type: 'confirm',
-            name: 'proceed',
-            message: 'Continue?',
-            default: false,
-        },
-    ]);
+    let proceed;
+    try {
+        ({ proceed } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'proceed',
+                message: 'Continue?',
+                default: false,
+            },
+        ]));
+    }
+    catch (err) {
+        // Ctrl-C / Esc at the confirm prompt — cancel cleanly, no stack trace.
+        if (isPromptAbort(err)) {
+            console.log(chalk.yellow('\n  Uninstall cancelled. No files modified.\n'));
+            process.exit(130);
+        }
+        throw err;
+    }
     if (!proceed) {
         console.log(chalk.yellow('\n  Uninstall cancelled. No files modified.\n'));
         return;

package/dist/context/index.js

@@ -73,6 +73,19 @@ function defaultEditors() {
         path: "~/.codex/config.toml",
         section: "mcp_servers.hometrans"
       }
+    },
+    {
+      // CodeBuddy（腾讯）：与 Claude Code 同构的 .codebuddy/ 目录，
+      // 全局安装映射到 ~/.codebuddy/{skills,agents}，MCP 走 mcpServers JSON。
+      name: "CodeBuddy",
+      markerDir: "~/.codebuddy",
+      skillsDir: "~/.codebuddy/skills",
+      agentsDir: "~/.codebuddy/agents",
+      mcp: {
+        format: "jsonc-object",
+        path: "~/.codebuddy/mcp.json",
+        keyPath: ["mcpServers", "hometrans"]
+      }
     }
   ];
 }
@@ -132,8 +145,21 @@ async function loadHomeTransConfig() {
   delete anyParsed.sdkPaths;
   delete anyParsed.params;
   delete anyParsed.tool_path;
+  const existingNames = new Set(config.editors.map((e) => e.name));
+  const missingEditors = defaultEditors().filter(
+    (e) => !existingNames.has(e.name)
+  );
+  if (missingEditors.length > 0) {
+    config.editors.push(...missingEditors);
+    await saveHomeTransConfig(config);
+  }
   return config;
 }
+async function saveHomeTransConfig(config) {
+  const configPath = getConfigPath();
+  await fs.mkdir(getConfigDir(), { recursive: true });
+  await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
 
 // src/context/analysis/ArkTsGitInfoAnalysis.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buaa_smat/hometrans",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "HomeTrans (Android-to-HarmonyOS) skill + agent installer. Run `ht init` to distribute conversion skills and subagents into AI editors.",
   "license": "MIT",
   "repository": {