@ai-setting/roy-agent-cli 1.0.0

package/src/commands/commands-add.ts

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview Commands Add Command
+ * 
+ * 添加收藏命令
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../services/environment.service";
+import { OutputService } from "../services/output.service";
+import chalk from "chalk";
+import type { CommandsComponent } from "@ai-setting/roy-agent-core";
+
+export interface CommandsAddOptions {
+  name: string;
+  target: string;
+  global: boolean;
+  local: boolean;
+  description: string;
+  tips: string;
+  config?: string;
+}
+
+export const CommandsAddCommand: CommandModule<object, CommandsAddOptions> = {
+  command: "add <name> <target>",
+  describe: "添加收藏命令（自动创建 symlink）",
+
+  builder: (yargs) =>
+    yargs
+      .positional("name", {
+        describe: "命令名称",
+        type: "string",
+        demandOption: true,
+      })
+      .positional("target", {
+        describe: "目标命令路径或名称",
+        type: "string",
+        demandOption: true,
+      })
+      .option("global", {
+        alias: "g",
+        describe: "添加到用户级别目录（默认）",
+        type: "boolean",
+        default: true,
+      })
+      .option("local", {
+        alias: "l",
+        describe: "添加到项目级别目录",
+        type: "boolean",
+        default: false,
+      })
+      .option("description", {
+        alias: "d",
+        describe: "命令功能描述（用于 AI Prompt 注入）",
+        type: "string",
+        demandOption: true,
+      })
+      .option("tips", {
+        alias: "t",
+        describe: "探索提示（告诉用户如何使用 --help 探索）",
+        type: "string",
+        demandOption: true,
+      })
+      .option("config", {
+        describe: "配置文件路径",
+        type: "string",
+      }),
+
+  async handler(args) {
+    const output = new OutputService();
+    const envService = new EnvironmentService(output);
+
+    try {
+      await envService.create({ configPath: args.config });
+      const env = envService.getEnvironment();
+      if (!env) {
+        output.error("Failed to create environment");
+        process.exit(1);
+      }
+      const commandsComponent = env.getComponent("commands") as CommandsComponent | undefined;
+
+      if (!commandsComponent) {
+        output.error("CommandsComponent not available");
+        process.exit(1);
+      }
+
+      const source = args.local ? "project" : "user";
+
+      await commandsComponent.add({
+        name: args.name,
+        target: args.target,
+        source,
+        description: args.description,
+        tips: args.tips,
+      });
+
+      const dirs = await commandsComponent.getCommandDirs();
+      const targetDir = source === "user" ? dirs.user : dirs.project;
+
+      output.log(chalk.green(`✅ 已添加命令 '${args.name}'`));
+      output.log(chalk.gray(`   目标: ${args.target}`));
+      output.log(chalk.gray(`   位置: ${targetDir}/${args.name}`));
+      output.log(chalk.gray(`   级别: ${source === "user" ? "USER" : "PROJECT"}`));
+    } catch (error: any) {
+      output.error(`添加失败: ${error.message}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/commands-dirs.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Commands Dirs Command
+ * 
+ * 显示命令目录
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../services/environment.service";
+import { OutputService } from "../services/output.service";
+import chalk from "chalk";
+import type { CommandsComponent } from "@ai-setting/roy-agent-core";
+
+export interface CommandsDirsOptions {
+  json?: boolean;
+  config?: string;
+}
+
+export const CommandsDirsCommand: CommandModule<object, CommandsDirsOptions> = {
+  command: "dirs",
+  describe: "显示命令目录",
+
+  builder: (yargs) =>
+    yargs
+      .option("json", {
+        alias: "j",
+        describe: "JSON 格式输出",
+        type: "boolean",
+        default: false,
+      })
+      .option("config", {
+        describe: "配置文件路径",
+        type: "string",
+      }),
+
+  async handler(args) {
+    const output = new OutputService();
+    const envService = new EnvironmentService(output);
+
+    try {
+      await envService.create({ configPath: args.config });
+      const env = envService.getEnvironment();
+      if (!env) {
+        output.error("Failed to create environment");
+        process.exit(1);
+      }
+      const commandsComponent = env.getComponent("commands") as CommandsComponent | undefined;
+
+      if (!commandsComponent) {
+        output.error("CommandsComponent not available");
+        process.exit(1);
+      }
+
+      const dirs = await commandsComponent.getCommandDirs();
+
+      if (args.json) {
+        output.json(dirs);
+      } else {
+        output.log(chalk.bold("命令目录:"));
+        output.log();
+        output.log(chalk.cyan("USER:") + `   ${dirs.user}`);
+        output.log(chalk.cyan("PROJECT:") + ` ${dirs.project}`);
+      }
+    } catch (error: any) {
+      output.error(`错误: ${error.message}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/commands-info.ts

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Commands Info Command
+ * 
+ * 显示命令详细信息
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../services/environment.service";
+import { OutputService } from "../services/output.service";
+import chalk from "chalk";
+import { exec } from "child_process";
+import { promisify } from "util";
+import type { CommandsComponent } from "@ai-setting/roy-agent-core";
+
+const execAsync = promisify(exec);
+
+export interface CommandsInfoOptions {
+  name: string;
+  config?: string;
+}
+
+export const CommandsInfoCommand: CommandModule<object, CommandsInfoOptions> = {
+  command: "info <name>",
+  describe: "显示命令详细信息",
+
+  builder: (yargs) =>
+    yargs
+      .positional("name", {
+        describe: "命令名称",
+        type: "string",
+        demandOption: true,
+      })
+      .option("config", {
+        describe: "配置文件路径",
+        type: "string",
+      }),
+
+  async handler(args) {
+    const output = new OutputService();
+    const envService = new EnvironmentService(output);
+
+    try {
+      await envService.create({ configPath: args.config });
+      const env = envService.getEnvironment();
+      if (!env) {
+        output.error("Failed to create environment");
+        process.exit(1);
+      }
+      const commandsComponent = env.getComponent("commands") as CommandsComponent | undefined;
+
+      if (!commandsComponent) {
+        output.error("CommandsComponent not available");
+        process.exit(1);
+      }
+
+      const info = await commandsComponent.getInfo(args.name);
+
+      if (!info) {
+        output.error(`命令 '${args.name}' 不存在`);
+        process.exit(1);
+      }
+
+      output.log(chalk.bold("Name:") + ` ${info.name}`);
+      output.log(chalk.bold("Path:") + ` ${info.path}`);
+      output.log(chalk.bold("Source:") + ` ${info.source.toUpperCase()}`);
+      output.log(chalk.bold("Description:") + ` ${info.shortDescription || "-"}`);
+      output.log();
+      output.log(chalk.gray("─".repeat(50)));
+      output.log();
+
+      // 显示完整 --help
+      try {
+        const { stdout } = await execAsync(`${info.path} --help`, { timeout: 5000 });
+        output.log(stdout);
+      } catch {
+        try {
+          const { stdout } = await execAsync(`${info.path} -h`, { timeout: 5000 });
+          output.log(stdout);
+        } catch {
+          output.log(chalk.gray("（无法获取帮助信息）"));
+        }
+      }
+    } catch (error: any) {
+      output.error(`错误: ${error.message}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/commands-list.ts

@@ -0,0 +1,161 @@
+/**
+ * @fileoverview Commands List Command
+ * 
+ * 列出收藏的命令
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../services/environment.service";
+import { OutputService } from "../services/output.service";
+import chalk from "chalk";
+import type { CommandsComponent } from "@ai-setting/roy-agent-core";
+
+export interface CommandsListOptions {
+  pattern?: string;
+  json?: boolean;
+  config?: string;
+}
+
+interface CommandRow {
+  name: string;
+  path: string;
+  source: string;
+  description: string;
+}
+
+/**
+ * 计算字符串的视觉宽度（中文字符占2格）
+ */
+function visualWidth(str: string): number {
+  let width = 0;
+  for (const char of str) {
+    if (char.charCodeAt(0) > 255) {
+      width += 2;
+    } else {
+      width += 1;
+    }
+  }
+  return width;
+}
+
+/**
+ * 按视觉宽度截断字符串
+ */
+function truncateVisual(str: string, maxWidth: number): string {
+  let result = "";
+  let width = 0;
+  for (const char of str) {
+    const charWidth = char.charCodeAt(0) > 255 ? 2 : 1;
+    if (width + charWidth > maxWidth) break;
+    result += char;
+    width += charWidth;
+  }
+  return result;
+}
+
+/**
+ * 格式化命令表格
+ */
+function formatCommandsTable(commands: CommandRow[]): string {
+  if (commands.length === 0) {
+    return chalk.yellow("命令目录为空，使用 'roy commands add' 添加命令");
+  }
+
+  const NAME_WIDTH = 20;
+  const SOURCE_WIDTH = 10;
+  const DESC_WIDTH = 50;
+  const GAP = "  ";
+
+  const headerLine = [
+    chalk.bold("NAME".padEnd(NAME_WIDTH)),
+    chalk.bold("SOURCE".padEnd(SOURCE_WIDTH)),
+    chalk.bold("DESCRIPTION"),
+  ].join(GAP);
+
+  const sepLine = "─".repeat(NAME_WIDTH + SOURCE_WIDTH + DESC_WIDTH + GAP.length * 2);
+
+  const formatRow = (cmd: CommandRow): string => {
+    const name = truncateVisual(cmd.name, NAME_WIDTH).padEnd(NAME_WIDTH);
+    const source = cmd.source.padEnd(SOURCE_WIDTH);
+    const desc = truncateVisual(cmd.description || "-", DESC_WIDTH);
+    return `${name}${GAP}${source}${GAP}${desc}`;
+  };
+
+  const rows = commands.map(formatRow);
+  return [headerLine, sepLine, ...rows].join("\n");
+}
+
+export const CommandsListCommand: CommandModule<object, CommandsListOptions> = {
+  command: "list [pattern]",
+  describe: "列出收藏的命令（支持 glob 过滤）",
+
+  builder: (yargs) =>
+    yargs
+      .positional("pattern", {
+        describe: "glob 过滤模式",
+        type: "string",
+      })
+      .option("json", {
+        alias: "j",
+        describe: "JSON 格式输出",
+        type: "boolean",
+        default: false,
+      })
+      .option("config", {
+        describe: "配置文件路径",
+        type: "string",
+      }),
+
+  async handler(args) {
+    const output = new OutputService();
+    const envService = new EnvironmentService(output);
+
+    try {
+      await envService.create({ configPath: args.config });
+      const env = envService.getEnvironment();
+      if (!env) {
+        output.error("Failed to create environment");
+        process.exit(1);
+      }
+      const commandsComponent = env.getComponent("commands") as CommandsComponent | undefined;
+
+      if (!commandsComponent) {
+        output.error("CommandsComponent not available");
+        process.exit(1);
+      }
+
+      const result = await commandsComponent.discover({ pattern: args.pattern });
+
+      if (args.json) {
+        output.json({
+          commands: result.commands.map((cmd) => ({
+            name: cmd.name,
+            path: cmd.path,
+            source: cmd.source,
+            description: cmd.shortDescription,
+          })),
+          stats: result.stats,
+        });
+      } else {
+        const rows: CommandRow[] = result.commands.map((cmd) => ({
+          name: cmd.name,
+          path: cmd.path,
+          source: cmd.source === "user" ? "USER" : "PROJECT",
+          description: cmd.shortDescription || "-",
+        }));
+
+        output.log(formatCommandsTable(rows));
+        output.info("");
+        output.log(
+          chalk.green(`✅ 共 ${result.commands.length} 个命令`) +
+            chalk.gray(` (user: ${result.stats.userCount}, project: ${result.stats.projectCount})`)
+        );
+      }
+    } catch (error) {
+      output.error(`Failed to list commands: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/commands-remove.ts

@@ -0,0 +1,147 @@
+/**
+ * @fileoverview Commands Remove Command
+ * 
+ * 移除收藏命令
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../services/environment.service";
+import { OutputService } from "../services/output.service";
+import chalk from "chalk";
+import type { CommandsComponent } from "@ai-setting/roy-agent-core";
+
+export interface CommandsRemoveOptions {
+  name: string;
+  global: boolean;
+  local: boolean;
+  config?: string;
+}
+
+export const CommandsRemoveCommand: CommandModule<object, CommandsRemoveOptions> = {
+  command: "remove <name>",
+  aliases: ["rm"],
+  describe: "移除收藏命令",
+
+  builder: (yargs) =>
+    yargs
+      .positional("name", {
+        describe: "命令名称",
+        type: "string",
+        demandOption: true,
+      })
+      .option("global", {
+        alias: "g",
+        describe: "从用户级别目录移除",
+        type: "boolean",
+        default: false,
+      })
+      .option("local", {
+        alias: "l",
+        describe: "从项目级别目录移除",
+        type: "boolean",
+        default: false,
+      })
+      .option("config", {
+        describe: "配置文件路径",
+        type: "string",
+      }),
+
+  async handler(args) {
+    const output = new OutputService();
+    const envService = new EnvironmentService(output);
+
+    try {
+      await envService.create({ configPath: args.config });
+      const env = envService.getEnvironment();
+      if (!env) {
+        output.error("Failed to create environment");
+        process.exit(1);
+      }
+      const commandsComponent = env.getComponent("commands") as CommandsComponent | undefined;
+
+      if (!commandsComponent) {
+        output.error("CommandsComponent not available");
+        process.exit(1);
+      }
+
+      // 统一移除逻辑：
+      // - 如果指定了 --global，从 user 目录移除
+      // - 如果指定了 --local，从 project 目录移除
+      // - 如果都没指定，同时尝试从两个目录移除
+      if (args.global) {
+        // 从 user 目录移除
+        try {
+          await commandsComponent.remove({
+            name: args.name,
+            source: "user",
+          });
+          output.log(chalk.green(`✅ 已从用户目录移除命令 '${args.name}'`));
+        } catch (error: any) {
+          // 忽略"命令不存在"的错误
+          if (!error.message?.includes("不存在")) {
+            throw error;
+          }
+          output.warn(`命令 '${args.name}' 不存在于用户目录`);
+        }
+      } else if (args.local) {
+        // 从 project 目录移除
+        try {
+          await commandsComponent.remove({
+            name: args.name,
+            source: "project",
+          });
+          output.log(chalk.green(`✅ 已从项目目录移除命令 '${args.name}'`));
+        } catch (error: any) {
+          // 忽略"命令不存在"的错误
+          if (!error.message?.includes("不存在")) {
+            throw error;
+          }
+          output.warn(`命令 '${args.name}' 不存在于项目目录`);
+        }
+      } else {
+        // 同时尝试从两个目录移除
+        let removed = false;
+        
+        // 先尝试从 user 目录移除
+        try {
+          await commandsComponent.remove({
+            name: args.name,
+            source: "user",
+          });
+          output.log(chalk.green(`✅ 已从用户目录移除命令 '${args.name}'`));
+          removed = true;
+        } catch (error: any) {
+          // 忽略"命令不存在"的错误
+          if (!error.message?.includes("不存在")) {
+            throw error;
+          }
+        }
+        
+        // 再尝试从 project 目录移除
+        try {
+          await commandsComponent.remove({
+            name: args.name,
+            source: "project",
+          });
+          output.log(chalk.green(`✅ 已从项目目录移除命令 '${args.name}'`));
+          removed = true;
+        } catch (error: any) {
+          // 忽略"命令不存在"的错误
+          if (!error.message?.includes("不存在")) {
+            throw error;
+          }
+        }
+        
+        if (!removed) {
+          output.error(`命令 '${args.name}' 不存在`);
+          process.exit(1);
+        }
+      }
+    } catch (error: any) {
+      output.error(`移除失败: ${error.message}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/commands.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Commands Command
+ * 
+ * 命令库管理 - CLI 主命令
+ * 
+ * 功能：
+ * - 列出收藏命令（roy commands list）
+ * - 添加命令（roy commands add）
+ * - 移除命令（roy commands remove）
+ * - 显示命令详情（roy commands info）
+ * - 显示命令目录（roy commands dirs）
+ */
+
+import { CommandModule } from "yargs";
+import { CommandsListCommand } from "./commands-list";
+import { CommandsAddCommand } from "./commands-add";
+import { CommandsRemoveCommand } from "./commands-remove";
+import { CommandsInfoCommand } from "./commands-info";
+import { CommandsDirsCommand } from "./commands-dirs";
+
+export interface CommandsOptions {
+  command?: string;
+}
+
+/**
+ * CommandsCommand - 命令库管理
+ */
+export const CommandsCommand: CommandModule<object, CommandsOptions> = {
+  command: "commands",
+  describe: "命令库管理 - 收藏、查询常用命令",
+
+  builder: (yargs) =>
+    yargs
+      .command(CommandsListCommand)
+      .command(CommandsAddCommand)
+      .command(CommandsRemoveCommand)
+      .command(CommandsInfoCommand)
+      .command(CommandsDirsCommand)
+      .demandCommand(1, "请指定子命令：list、add、remove、info、dirs")
+      .help()
+      .strict(),
+
+  handler() {
+    // 默认显示帮助（由 yargs demandCommand 处理）
+  },
+};
+
+// 导出子命令
+export {
+  CommandsListCommand,
+  CommandsAddCommand,
+  CommandsRemoveCommand,
+  CommandsInfoCommand,
+  CommandsDirsCommand,
+};