@ai-setting/roy-agent-cli 1.3.15 → 1.3.17

package/dist/cli/src/commands/commands-add.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Commands Add Command
+ *
+ * 添加收藏命令
+ */
+import { EnvironmentService } from "../services/environment.service.js";
+import { OutputService } from "../services/output.service.js";
+import chalk from "chalk";
+export const CommandsAddCommand = {
+    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");
+            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) {
+            output.error(`添加失败: ${error.message}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=commands-add.js.map

package/dist/cli/src/commands/commands-dirs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Commands Dirs Command
+ *
+ * 显示命令目录
+ */
+import { CommandModule } from "yargs";
+export interface CommandsDirsOptions {
+    json?: boolean;
+    config?: string;
+}
+export declare const CommandsDirsCommand: CommandModule<object, CommandsDirsOptions>;
+//# sourceMappingURL=commands-dirs.d.ts.map

package/dist/cli/src/commands/commands-dirs.js

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Commands Dirs Command
+ *
+ * 显示命令目录
+ */
+import { EnvironmentService } from "../services/environment.service.js";
+import { OutputService } from "../services/output.service.js";
+import chalk from "chalk";
+export const CommandsDirsCommand = {
+    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");
+            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) {
+            output.error(`错误: ${error.message}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=commands-dirs.js.map

package/dist/cli/src/commands/commands-info.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Commands Info Command
+ *
+ * 显示命令详细信息
+ */
+import { CommandModule } from "yargs";
+export interface CommandsInfoOptions {
+    name: string;
+    config?: string;
+}
+export declare const CommandsInfoCommand: CommandModule<object, CommandsInfoOptions>;
+//# sourceMappingURL=commands-info.d.ts.map

package/dist/cli/src/commands/commands-info.js

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Commands Info Command
+ *
+ * 显示命令详细信息
+ */
+import { EnvironmentService } from "../services/environment.service.js";
+import { OutputService } from "../services/output.service.js";
+import chalk from "chalk";
+import { exec } from "child_process";
+import { promisify } from "util";
+const execAsync = promisify(exec);
+export const CommandsInfoCommand = {
+    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");
+            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) {
+            output.error(`错误: ${error.message}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=commands-info.js.map

package/dist/cli/src/commands/commands-list.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Commands List Command
+ *
+ * 列出收藏的命令
+ */
+import { CommandModule } from "yargs";
+export interface CommandsListOptions {
+    pattern?: string;
+    json?: boolean;
+    config?: string;
+}
+export declare const CommandsListCommand: CommandModule<object, CommandsListOptions>;
+//# sourceMappingURL=commands-list.d.ts.map

package/dist/cli/src/commands/commands-list.js

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Commands List Command
+ *
+ * 列出收藏的命令
+ */
+import { EnvironmentService } from "../services/environment.service.js";
+import { OutputService } from "../services/output.service.js";
+import chalk from "chalk";
+/**
+ * 计算字符串的视觉宽度（中文字符占2格）
+ */
+function visualWidth(str) {
+    let width = 0;
+    for (const char of str) {
+        if (char.charCodeAt(0) > 255) {
+            width += 2;
+        }
+        else {
+            width += 1;
+        }
+    }
+    return width;
+}
+/**
+ * 按视觉宽度截断字符串
+ */
+function truncateVisual(str, maxWidth) {
+    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) {
+    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) => {
+        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 = {
+    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");
+            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 = 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();
+        }
+    },
+};
+//# sourceMappingURL=commands-list.js.map

package/dist/cli/src/commands/commands-remove.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Commands Remove Command
+ *
+ * 移除收藏命令
+ */
+import { CommandModule } from "yargs";
+export interface CommandsRemoveOptions {
+    name: string;
+    global: boolean;
+    local: boolean;
+    config?: string;
+}
+export declare const CommandsRemoveCommand: CommandModule<object, CommandsRemoveOptions>;
+//# sourceMappingURL=commands-remove.d.ts.map

package/dist/cli/src/commands/commands-remove.js

@@ -0,0 +1,136 @@
+/**
+ * @fileoverview Commands Remove Command
+ *
+ * 移除收藏命令
+ */
+import { EnvironmentService } from "../services/environment.service.js";
+import { OutputService } from "../services/output.service.js";
+import chalk from "chalk";
+export const CommandsRemoveCommand = {
+    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");
+            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) {
+                    // 忽略"命令不存在"的错误
+                    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) {
+                    // 忽略"命令不存在"的错误
+                    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) {
+                    // 忽略"命令不存在"的错误
+                    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) {
+                    // 忽略"命令不存在"的错误
+                    if (!error.message?.includes("不存在")) {
+                        throw error;
+                    }
+                }
+                if (!removed) {
+                    output.error(`命令 '${args.name}' 不存在`);
+                    process.exit(1);
+                }
+            }
+        }
+        catch (error) {
+            output.error(`移除失败: ${error.message}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=commands-remove.js.map

package/dist/cli/src/commands/commands.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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 declare const CommandsCommand: CommandModule<object, CommandsOptions>;
+export { CommandsListCommand, CommandsAddCommand, CommandsRemoveCommand, CommandsInfoCommand, CommandsDirsCommand, };
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/src/commands/commands.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Commands Command
+ *
+ * 命令库管理 - CLI 主命令
+ *
+ * 功能：
+ * - 列出收藏命令（roy commands list）
+ * - 添加命令（roy commands add）
+ * - 移除命令（roy commands remove）
+ * - 显示命令详情（roy commands info）
+ * - 显示命令目录（roy commands dirs）
+ */
+import { CommandsListCommand } from "./commands-list.js";
+import { CommandsAddCommand } from "./commands-add.js";
+import { CommandsRemoveCommand } from "./commands-remove.js";
+import { CommandsInfoCommand } from "./commands-info.js";
+import { CommandsDirsCommand } from "./commands-dirs.js";
+/**
+ * CommandsCommand - 命令库管理
+ */
+export const CommandsCommand = {
+    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, };
+//# sourceMappingURL=commands.js.map

package/dist/cli/src/commands/config/config-service.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview ConfigService - 配置服务工具类
+ *
+ * 提供配置的导出、导入等功能
+ */
+import type { ConfigComponent } from "@ai-setting/roy-agent-core";
+import type { OutputService } from "../../services/output.service";
+export interface ConfigExportOptions {
+    /** 导出到文件路径（不指定则返回内容） */
+    filePath?: string;
+    /** 格式化输出（默认 true） */
+    pretty?: boolean;
+}
+export interface ConfigImportOptions {
+    /** 导入源配置文件 */
+    sourceFile: string;
+    /** 预览模式，不实际写入 */
+    dryRun?: boolean;
+    /** 显示详细操作信息 */
+    verbose?: boolean;
+}
+export interface ImportResult {
+    success: boolean;
+    merged: boolean;
+    changes: Array<{
+        key: string;
+        oldValue: unknown;
+        newValue: unknown;
+    }>;
+    filePath: string;
+    message?: string;
+}
+/**
+ * ConfigService - 配置服务
+ */
+export declare class ConfigService {
+    private configComponent;
+    private output;
+    constructor(configComponent: ConfigComponent, output: OutputService);
+    /**
+     * 获取 component 的运行时配置值
+     *
+     * 从所有配置源读取配置，合并后返回：
+     * - memory source（最高优先级，用户运行时修改）
+     * - file source（配置文件）
+     * - defaults（注册到 memory 的默认值）
+     */
+    getComponentConfig(componentName: string): Record<string, unknown>;
+    /**
+     * 获取 component 的 file source 物理路径
+     */
+    getComponentFilePath(componentName: string): string | undefined;
+    /**
+     * 导出配置到文件
+     */
+    exportToFile(componentName: string, options: ConfigExportOptions): Promise<string>;
+    /**
+     * 从文件导入配置（只写入 file source）
+     */
+    importFromFile(componentName: string, options: ConfigImportOptions): Promise<ImportResult>;
+    /**
+     * 计算配置变更
+     */
+    private calculateChanges;
+    /**
+     * 设置嵌套值
+     */
+    private setNestedValue;
+}
+//# sourceMappingURL=config-service.d.ts.map