@ai-setting/roy-agent-cli 1.3.14 → 1.3.16

package/dist/cli/src/commands/config/config-service.js

@@ -0,0 +1,233 @@
+/**
+ * @fileoverview ConfigService - 配置服务工具类
+ *
+ * 提供配置的导出、导入等功能
+ */
+import * as fsSync from "fs";
+import * as fsPromises from "fs/promises";
+import * as path from "path";
+import { parseJSONC, parseJSONCWithEnv } from "@ai-setting/roy-agent-core/config";
+import { deepMerge } from "./deep-merge.js";
+/**
+ * ConfigService - 配置服务
+ */
+export class ConfigService {
+    configComponent;
+    output;
+    constructor(configComponent, output) {
+        this.configComponent = configComponent;
+        this.output = output;
+    }
+    /**
+     * 获取 component 的运行时配置值
+     *
+     * 从所有配置源读取配置，合并后返回：
+     * - memory source（最高优先级，用户运行时修改）
+     * - file source（配置文件）
+     * - defaults（注册到 memory 的默认值）
+     */
+    getComponentConfig(componentName) {
+        const sources = this.configComponent.getSources();
+        // 查找 memory source（最高优先级）
+        const memorySource = sources.find((s) => s.name === "memory");
+        // 查找 file source
+        const fileSource = sources.find((s) => s.name === "file");
+        const prefix = `${componentName}.`;
+        const result = {};
+        // 1. 先从 file source 读取（作为基础）
+        if (fileSource) {
+            const fileEntries = fileSource.list();
+            for (const entry of fileEntries) {
+                if (entry.key === componentName) {
+                    // component 本身就是根键
+                    result[entry.key] = entry.value;
+                }
+                else if (entry.key.startsWith(prefix)) {
+                    const restKey = entry.key.slice(prefix.length);
+                    this.setNestedValue(result, restKey, entry.value);
+                }
+            }
+        }
+        // 2. 再从 memory source 读取（覆盖 file source）
+        if (memorySource) {
+            const memoryEntries = memorySource.list();
+            for (const entry of memoryEntries) {
+                if (entry.key === componentName) {
+                    // component 本身就是根键
+                    result[entry.key] = entry.value;
+                }
+                else if (entry.key.startsWith(prefix)) {
+                    const restKey = entry.key.slice(prefix.length);
+                    this.setNestedValue(result, restKey, entry.value);
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * 获取 component 的 file source 物理路径
+     */
+    getComponentFilePath(componentName) {
+        const sources = this.configComponent.getSources();
+        const fileSource = sources.find((s) => s.name === "file");
+        if (fileSource && "filePath" in fileSource) {
+            return fileSource.filePath;
+        }
+        return undefined;
+    }
+    /**
+     * 导出配置到文件
+     */
+    async exportToFile(componentName, options) {
+        const config = this.getComponentConfig(componentName);
+        const content = JSON.stringify({ [componentName]: config }, null, options.pretty !== false ? 2 : 0);
+        if (options.filePath) {
+            const dir = path.dirname(options.filePath);
+            if (!fsSync.existsSync(dir)) {
+                await fsPromises.mkdir(dir, { recursive: true });
+            }
+            await fsPromises.writeFile(options.filePath, content, "utf-8");
+            this.output.log(`✅ 已导出 ${componentName} 配置到 ${options.filePath}`);
+        }
+        return content;
+    }
+    /**
+     * 从文件导入配置（只写入 file source）
+     */
+    async importFromFile(componentName, options) {
+        const result = {
+            success: false,
+            merged: false,
+            changes: [],
+            filePath: "",
+        };
+        // 1. 解析源文件
+        let sourceData;
+        try {
+            const content = await fsPromises.readFile(options.sourceFile, "utf-8");
+            // 源文件也可能是 JSONC 格式，使用 parseJSONCWithEnv 解析
+            sourceData = parseJSONCWithEnv(content);
+        }
+        catch (error) {
+            result.message = `无法读取源文件: ${error}`;
+            return result;
+        }
+        // 提取 component 配置
+        const sourceComponentConfig = sourceData[componentName];
+        if (!sourceComponentConfig || typeof sourceComponentConfig !== "object") {
+            result.message = `源文件中未找到 ${componentName} 配置`;
+            return result;
+        }
+        // 2. 获取目标文件路径
+        const targetFilePath = this.getComponentFilePath(componentName);
+        if (!targetFilePath) {
+            result.message = `无法获取 ${componentName} 的 file source 路径`;
+            return result;
+        }
+        result.filePath = targetFilePath;
+        // 3. 读取目标文件现有内容
+        let targetData = {};
+        try {
+            if (fsSync.existsSync(targetFilePath)) {
+                const content = await fsPromises.readFile(targetFilePath, "utf-8");
+                // 使用 parseJSONC 解析目标文件（保留 JSONC 语法包括 $ 引用）
+                // 注意：不使用 parseJSONCWithEnv，否则会替换掉 $ 引用
+                targetData = parseJSONC(content);
+            }
+        }
+        catch (error) {
+            // 文件不存在或解析失败，使用空对象
+            if (options.verbose) {
+                this.output.log(`📝 目标文件不存在或无法解析，将创建新文件`);
+            }
+        }
+        // 4. 深度合并
+        const existingComponentConfig = (targetData[componentName] || {});
+        const mergedComponentConfig = deepMerge(existingComponentConfig, sourceComponentConfig);
+        targetData[componentName] = mergedComponentConfig;
+        // 计算变更
+        result.changes = this.calculateChanges(existingComponentConfig, sourceComponentConfig);
+        result.merged = result.changes.length > 0;
+        if (options.verbose) {
+            this.output.log(`📋 发现 ${result.changes.length} 个配置变更`);
+            for (const change of result.changes) {
+                this.output.log(`   ${change.key}: ${JSON.stringify(change.oldValue)} → ${JSON.stringify(change.newValue)}`);
+            }
+        }
+        // 5. Dry-run 模式
+        if (options.dryRun) {
+            this.output.log(`🔍 预览模式：${result.changes.length} 个变更待应用`);
+            this.output.log(`   目标文件: ${targetFilePath}`);
+            result.success = true;
+            return result;
+        }
+        // 6. 写入文件
+        try {
+            const dir = path.dirname(targetFilePath);
+            if (!fsSync.existsSync(dir)) {
+                await fsPromises.mkdir(dir, { recursive: true });
+            }
+            const content = JSON.stringify(targetData, null, 2);
+            await fsPromises.writeFile(targetFilePath, content, "utf-8");
+            this.output.log(`✅ 已导入配置到 ${targetFilePath}`);
+            this.output.log(`   ${result.changes.length} 个配置项已更新`);
+            result.success = true;
+        }
+        catch (error) {
+            result.message = `写入文件失败: ${error}`;
+        }
+        return result;
+    }
+    /**
+     * 计算配置变更
+     */
+    calculateChanges(existing, source) {
+        const changes = [];
+        const flatten = (obj, prefix = "") => {
+            const result = [];
+            if (typeof obj !== "object" || obj === null) {
+                return result;
+            }
+            for (const [k, v] of Object.entries(obj)) {
+                const key = prefix ? `${prefix}.${k}` : k;
+                if (v !== null && typeof v === "object" && !Array.isArray(v)) {
+                    result.push(...flatten(v, key));
+                }
+                else {
+                    result.push({ key, value: v });
+                }
+            }
+            return result;
+        };
+        const sourceEntries = flatten(source);
+        const existingEntries = flatten(existing);
+        const existingMap = new Map(existingEntries.map((e) => [e.key, e.value]));
+        for (const entry of sourceEntries) {
+            const oldValue = existingMap.get(entry.key);
+            if (JSON.stringify(oldValue) !== JSON.stringify(entry.value)) {
+                changes.push({
+                    key: entry.key,
+                    oldValue,
+                    newValue: entry.value,
+                });
+            }
+        }
+        return changes;
+    }
+    /**
+     * 设置嵌套值
+     */
+    setNestedValue(obj, key, value) {
+        const keys = key.split(".");
+        let current = obj;
+        for (let i = 0; i < keys.length - 1; i++) {
+            const k = keys[i];
+            if (!(k in current) || typeof current[k] !== "object" || current[k] === null) {
+                current[k] = {};
+            }
+            current = current[k];
+        }
+        current[keys[keys.length - 1]] = value;
+    }
+}
+//# sourceMappingURL=config-service.js.map

package/dist/cli/src/commands/config/deep-merge.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview 深度合并工具
+ *
+ * 将源对象深度合并到目标对象
+ * - target 现有值会被保留
+ * - source 中的值会覆盖 target 中的值
+ * - 嵌套对象递归合并
+ * - 数组会被替换而非合并
+ */
+/**
+ * 深度合并两个对象
+ *
+ * @param target - 目标对象（现有值会被保留）
+ * @param source - 源对象（值会覆盖 target）
+ * @returns 合并后的新对象
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
+/**
+ * 深度合并两个对象（支持任意结构）
+ */
+export declare function deepMerge<T extends object>(target: T, source: Partial<T>): T;
+//# sourceMappingURL=deep-merge.d.ts.map

package/dist/cli/src/commands/config/deep-merge.js

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview 深度合并工具
+ *
+ * 将源对象深度合并到目标对象
+ * - target 现有值会被保留
+ * - source 中的值会覆盖 target 中的值
+ * - 嵌套对象递归合并
+ * - 数组会被替换而非合并
+ */
+export function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key in source) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+            const sourceValue = source[key];
+            const targetValue = result[key];
+            if (sourceValue !== null &&
+                typeof sourceValue === "object" &&
+                !Array.isArray(sourceValue) &&
+                targetValue !== null &&
+                typeof targetValue === "object" &&
+                !Array.isArray(targetValue)) {
+                // 两者都是对象，递归合并
+                result[key] = deepMerge(targetValue, sourceValue);
+            }
+            else {
+                // 其他情况直接覆盖
+                result[key] = sourceValue;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=deep-merge.js.map

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

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview config export 子命令
+ */
+import { CommandModule } from "yargs";
+export interface ConfigExportOptions {
+    component: string;
+    file?: string;
+    pretty?: boolean;
+    config?: string;
+}
+/**
+ * ConfigExportCommand - config export 子命令
+ */
+export declare const ConfigExportCommand: CommandModule<object, ConfigExportOptions>;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview config export 子命令
+ */
+import chalk from "chalk";
+import { EnvironmentService } from "../../services/environment.service.js";
+import { OutputService } from "../../services/output.service.js";
+import { ConfigService } from "./config-service.js";
+import { SUPPORTED_COMPONENTS, resolveComponentName } from "./types.js";
+/**
+ * ConfigExportCommand - config export 子命令
+ */
+export const ConfigExportCommand = {
+    command: "export <component>",
+    describe: "导出组件配置到文件",
+    builder: (yargs) => yargs
+        .positional("component", {
+        type: "string",
+        describe: "Component 名称",
+        choices: [...SUPPORTED_COMPONENTS, "sessions"],
+        demandOption: true,
+    })
+        .option("file", {
+        type: "string",
+        describe: "导出文件路径",
+        alias: "f",
+        demandOption: true,
+    })
+        .option("pretty", {
+        type: "boolean",
+        describe: "格式化 JSON 输出",
+        default: true,
+    })
+        .option("config", {
+        type: "string",
+        describe: "配置文件路径",
+        alias: "c",
+    })
+        .example("roy config export agent --file agent-config.json", "导出 agent 配置")
+        .example("roy config export session --file session-config.json", "导出 session 配置"),
+    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 get environment");
+                process.exit(1);
+            }
+            const configComponent = env.getComponent("config");
+            if (!configComponent) {
+                output.error("ConfigComponent not available");
+                process.exit(1);
+            }
+            const configService = new ConfigService(configComponent, output);
+            // 解析 component 名称（处理别名）
+            const componentName = resolveComponentName(args.component);
+            // 验证 component
+            if (!SUPPORTED_COMPONENTS.includes(componentName)) {
+                output.error(`Unknown component: ${args.component}`);
+                output.log("");
+                output.log("Supported components:");
+                for (const comp of SUPPORTED_COMPONENTS) {
+                    output.log(`  ${chalk.cyan(comp)}`);
+                }
+                process.exit(1);
+            }
+            // 导出配置
+            await configService.exportToFile(componentName, {
+                filePath: args.file,
+                pretty: args.pretty,
+            });
+        }
+        catch (error) {
+            output.error(`Failed to export config: ${error}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=export.js.map

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

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview config import 子命令
+ */
+import { CommandModule } from "yargs";
+export interface ConfigImportOptions {
+    component: string;
+    file: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+    config?: string;
+}
+/**
+ * ConfigImportCommand - config import 子命令
+ */
+export declare const ConfigImportCommand: CommandModule<object, ConfigImportOptions>;
+//# sourceMappingURL=import.d.ts.map

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

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview config import 子命令
+ */
+import chalk from "chalk";
+import { EnvironmentService } from "../../services/environment.service.js";
+import { OutputService } from "../../services/output.service.js";
+import { ConfigService } from "./config-service.js";
+import { SUPPORTED_COMPONENTS, resolveComponentName } from "./types.js";
+/**
+ * ConfigImportCommand - config import 子命令
+ */
+export const ConfigImportCommand = {
+    command: "import <component>",
+    describe: "从文件导入配置到组件的 file source",
+    builder: (yargs) => yargs
+        .positional("component", {
+        type: "string",
+        describe: "Component 名称",
+        choices: [...SUPPORTED_COMPONENTS, "sessions"],
+        demandOption: true,
+    })
+        .option("file", {
+        type: "string",
+        describe: "导入源配置文件",
+        alias: "f",
+        demandOption: true,
+    })
+        .option("dry-run", {
+        type: "boolean",
+        describe: "预览变更，不实际写入",
+        default: false,
+    })
+        .option("verbose", {
+        type: "boolean",
+        describe: "显示详细操作信息",
+        alias: "v",
+        default: false,
+    })
+        .option("config", {
+        type: "string",
+        describe: "配置文件路径",
+        alias: "c",
+    })
+        .example("roy config import session --file session-config.json", "导入 session 配置")
+        .example("roy config import session --file session-config.json --dry-run", "预览变更")
+        .example("roy config import session --file session-config.json --verbose", "显示详细信息"),
+    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 get environment");
+                process.exit(1);
+            }
+            const configComponent = env.getComponent("config");
+            if (!configComponent) {
+                output.error("ConfigComponent not available");
+                process.exit(1);
+            }
+            const configService = new ConfigService(configComponent, output);
+            // 解析 component 名称（处理别名）
+            const componentName = resolveComponentName(args.component);
+            // 验证 component
+            if (!SUPPORTED_COMPONENTS.includes(componentName)) {
+                output.error(`Unknown component: ${args.component}`);
+                output.log("");
+                output.log("Supported components:");
+                for (const comp of SUPPORTED_COMPONENTS) {
+                    output.log(`  ${chalk.cyan(comp)}`);
+                }
+                process.exit(1);
+            }
+            // 导入配置
+            const result = await configService.importFromFile(componentName, {
+                sourceFile: args.file,
+                dryRun: args.dryRun,
+                verbose: args.verbose,
+            });
+            if (!result.success) {
+                output.error(result.message || "导入失败");
+                process.exit(1);
+            }
+            if (result.merged && result.changes.length > 0 && args.verbose) {
+                output.log("");
+                output.log(chalk.bold("变更详情:"));
+                for (const change of result.changes) {
+                    output.log(`  ${change.key}: ${JSON.stringify(change.oldValue)} → ${JSON.stringify(change.newValue)}`);
+                }
+            }
+        }
+        catch (error) {
+            output.error(`Failed to import config: ${error}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=import.js.map

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

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Config Command - 配置管理主入口
+ */
+import { CommandModule } from "yargs";
+/**
+ * ConfigCommand - 配置管理命令
+ */
+export declare const ConfigCommand: CommandModule;
+export { ConfigListCommand } from "./list";
+export { ConfigExportCommand } from "./export";
+export { ConfigImportCommand } from "./import";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Config Command - 配置管理主入口
+ */
+import { ConfigListCommand } from "./list.js";
+import { ConfigExportCommand } from "./export.js";
+import { ConfigImportCommand } from "./import.js";
+/**
+ * ConfigCommand - 配置管理命令
+ */
+export const ConfigCommand = {
+    command: "config",
+    describe: "配置管理 - 查看、导出、导入配置",
+    aliases: ["cfg"],
+    builder: (yargs) => yargs
+        .command(ConfigListCommand)
+        .command(ConfigExportCommand)
+        .command(ConfigImportCommand)
+        .demandCommand()
+        .help(),
+    handler: () => {
+        // 默认显示帮助（由 yargs demandCommand 处理）
+    },
+};
+// 导出子命令
+export { ConfigListCommand } from "./list.js";
+export { ConfigExportCommand } from "./export.js";
+export { ConfigImportCommand } from "./import.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview config list 子命令
+ *
+ * 原 show-config 功能的重构版本
+ */
+import { CommandModule } from "yargs";
+export interface ConfigListOptions {
+    component?: string;
+    json?: boolean;
+    keys?: boolean;
+    sources?: boolean;
+    config?: string;
+}
+/**
+ * ConfigListCommand - config list 子命令
+ */
+export declare const ConfigListCommand: CommandModule<object, ConfigListOptions>;
+//# sourceMappingURL=list.d.ts.map