@ai-setting/roy-agent-cli 1.0.0

package/src/commands/config/filter-history-e2e.test.ts

@@ -0,0 +1,141 @@
+/**
+ * 测试 filterHistory 默认值导出问题
+ * 
+ * RED: 期望 filterHistory=false（用户反馈导出的值不对）
+ * 但根据代码，filterHistory 的默认值应该是 true
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fsSync from "fs";
+import * as path from "path";
+import * as os from "os";
+import { EnvironmentService } from "../../services/environment.service";
+import { OutputService } from "../../services/output.service";
+import { ConfigService } from "./config-service";
+
+describe("filterHistory default value test", () => {
+  let tempDir: string;
+  let configFilePath: string;
+
+  beforeEach(() => {
+    tempDir = fsSync.mkdtempSync(path.join(os.tmpdir(), "filter-history-test-"));
+    configFilePath = path.join(tempDir, "config.jsonc");
+  });
+
+  afterEach(() => {
+    if (fsSync.existsSync(tempDir)) {
+      fsSync.rmSync(tempDir, { recursive: true });
+    }
+  });
+
+  it("should export filterHistory=false when user explicitly sets it", async () => {
+    // 创建 config.jsonc，明确设置 filterHistory=false
+    const configContent = `{
+  "agent": {
+    "defaultAgent": {
+      "filterHistory": false
+    }
+  }
+}`;
+    fsSync.writeFileSync(configFilePath, configContent, "utf-8");
+
+    const output = new OutputService();
+    const envService = new EnvironmentService(output);
+
+    try {
+      await envService.create({ 
+          configPath: configFilePath,
+          sessionStorage: { type: "memory" }  // 使用内存存储，避免污染正式数据库
+        });
+      const env = envService.getEnvironment();
+
+      const configComponent = env!.getComponent("config");
+      const configService = new ConfigService(configComponent as any, output);
+
+      // 获取 agent 配置
+      const agentConfig = configService.getComponentConfig("agent");
+
+      console.log("Agent config (filterHistory=false):", JSON.stringify(agentConfig, null, 2));
+
+      // 验证：filterHistory 应该是 false
+      expect(agentConfig.defaultAgent).toBeDefined();
+      expect(agentConfig.defaultAgent.filterHistory).toBe(false);
+    } finally {
+      await envService.dispose();
+    }
+  });
+
+  it("should export filterHistory=false (default) when not in config file", async () => {
+    // 创建 config.jsonc，只包含部分 agent 配置（不含 filterHistory）
+    const configContent = `{
+  "agent": {
+    "defaultAgent": {
+      "maxIterations": 100
+    }
+  }
+}`;
+    fsSync.writeFileSync(configFilePath, configContent, "utf-8");
+
+    const output = new OutputService();
+    const envService = new EnvironmentService(output);
+
+    try {
+      await envService.create({ 
+          configPath: configFilePath,
+          sessionStorage: { type: "memory" }  // 使用内存存储，避免污染正式数据库
+        });
+      const env = envService.getEnvironment();
+
+      const configComponent = env!.getComponent("config");
+      const configService = new ConfigService(configComponent as any, output);
+
+      // 获取 agent 配置
+      const agentConfig = configService.getComponentConfig("agent");
+
+      console.log("Agent config (no filterHistory):", JSON.stringify(agentConfig, null, 2));
+
+      // 验证：filterHistory 应该有默认值 false
+      expect(agentConfig.defaultAgent).toBeDefined();
+      expect(agentConfig.defaultAgent.filterHistory).toBe(false);
+    } finally {
+      await envService.dispose();
+    }
+  });
+
+  it("should export all key default values when config file is empty", async () => {
+    // 创建空的 config.jsonc
+    const configContent = `{}`;
+    fsSync.writeFileSync(configFilePath, configContent, "utf-8");
+
+    const output = new OutputService();
+    const envService = new EnvironmentService(output);
+
+    try {
+      await envService.create({ 
+          configPath: configFilePath,
+          sessionStorage: { type: "memory" }  // 使用内存存储，避免污染正式数据库
+        });
+      const env = envService.getEnvironment();
+
+      const configComponent = env!.getComponent("config");
+      const configService = new ConfigService(configComponent as any, output);
+
+      // 获取 agent 配置
+      const agentConfig = configService.getComponentConfig("agent");
+
+      console.log("Agent config (empty file):", JSON.stringify(agentConfig, null, 2));
+
+      // 验证：agent 配置应该有默认值
+      expect(agentConfig.defaultAgent).toBeDefined();
+      
+      // 检查关键默认值（根据 AGENT_DEFAULTS）
+      expect(agentConfig.defaultAgent.maxIterations).toBe(200);
+      expect(agentConfig.defaultAgent.temperature).toBe(0);
+      expect(agentConfig.defaultAgent.timeout).toBe(300000);
+      expect(agentConfig.defaultAgent.streaming).toBe(false);
+      expect(agentConfig.defaultAgent.filterHistory).toBe(false);
+    } finally {
+      await envService.dispose();
+    }
+  });
+});

package/src/commands/config/import-preserve-refs.test.ts

@@ -0,0 +1,212 @@
+/**
+ * @fileoverview 验证 config import 保留 JSONC $ 引用语法的测试
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fsSync from "fs";
+import * as fsPromises from "fs/promises";
+import * as path from "path";
+import * as os from "os";
+
+describe("config import 保留 JSONC $ 引用", () => {
+  let tempDir: string;
+  let configFilePath: string;
+
+  beforeEach(() => {
+    tempDir = fsSync.mkdtempSync(path.join(os.tmpdir(), "roy-import-test-"));
+    configFilePath = path.join(tempDir, "config.jsonc");
+  });
+
+  afterEach(() => {
+    if (fsSync.existsSync(tempDir)) {
+      fsSync.rmSync(tempDir, { recursive: true });
+    }
+  });
+
+  it("保留 $file:// 协议引用不被清空", async () => {
+    // 1. 创建包含 $ 引用的原始配置文件
+    const originalContent = `{
+  "agent": {
+    "defaultAgent": {
+      "apiKey": "\${file://auth.json#providers.minimax.apiKey}",
+      "model": "minimax"
+    }
+  }
+}`;
+    await fsPromises.writeFile(configFilePath, originalContent, "utf-8");
+
+    // 2. 创建导入源文件（只包含部分配置）
+    const sourceFilePath = path.join(tempDir, "source.json");
+    const sourceContent = `{
+  "agent": {
+    "defaultAgent": {
+      "filterHistory": true
+    }
+  }
+}`;
+    await fsPromises.writeFile(sourceFilePath, sourceContent, "utf-8");
+
+    // 3. 执行导入
+    const { ConfigService } = await import("./config-service");
+    const mockConfigComponent = createMockConfigComponent(configFilePath);
+    const mockOutput = createMockOutput();
+    const configService = new ConfigService(mockConfigComponent, mockOutput as any);
+    
+    const result = await configService.importFromFile("agent", {
+      sourceFile: sourceFilePath,
+      verbose: false,
+    });
+
+    expect(result.success).toBe(true);
+
+    // 4. 验证 $ 引用被保留
+    const finalContent = await fsPromises.readFile(configFilePath, "utf-8");
+    const finalData = JSON.parse(finalContent);
+    
+    // apiKey 应该保留 $ 引用，而不是空字符串
+    expect(finalData.agent.defaultAgent.apiKey).toBe(
+      "\${file://auth.json#providers.minimax.apiKey}"
+    );
+    // filterHistory 应该是导入的新值
+    expect(finalData.agent.defaultAgent.filterHistory).toBe(true);
+    // model 也应该保留
+    expect(finalData.agent.defaultAgent.model).toBe("minimax");
+  });
+
+  it("保留 $env:// 协议引用不被清空", async () => {
+    // 1. 创建包含 $ 引用和 $env 混合的配置文件
+    const originalContent = `{
+  "llm": {
+    "defaultLlm": {
+      "apiKey": "\${env://MINIMAX_API_KEY:-default_key}",
+      "baseURL": "\${file://config.json#llm.baseURL}",
+      "model": "minimax"
+    }
+  }
+}`;
+    await fsPromises.writeFile(configFilePath, originalContent, "utf-8");
+
+    // 2. 创建导入源文件
+    const sourceFilePath = path.join(tempDir, "source.json");
+    const sourceContent = `{
+  "llm": {
+    "defaultLlm": {
+      "temperature": 0.7
+    }
+  }
+}`;
+    await fsPromises.writeFile(sourceFilePath, sourceContent, "utf-8");
+
+    // 3. 执行导入
+    const { ConfigService } = await import("./config-service");
+    const mockConfigComponent = createMockConfigComponent(configFilePath);
+    const mockOutput = createMockOutput();
+    const configService = new ConfigService(mockConfigComponent, mockOutput as any);
+    
+    const result = await configService.importFromFile("llm", {
+      sourceFile: sourceFilePath,
+      verbose: false,
+    });
+
+    expect(result.success).toBe(true);
+
+    // 4. 验证 $ 引用被保留
+    const finalContent = await fsPromises.readFile(configFilePath, "utf-8");
+    const finalData = JSON.parse(finalContent);
+    
+    // apiKey 应该保留 $env:// 引用
+    expect(finalData.llm.defaultLlm.apiKey).toBe(
+      "\${env://MINIMAX_API_KEY:-default_key}"
+    );
+    // baseURL 应该保留 $file:// 引用
+    expect(finalData.llm.defaultLlm.baseURL).toBe(
+      "\${file://config.json#llm.baseURL}"
+    );
+    // temperature 应该是导入的新值
+    expect(finalData.llm.defaultLlm.temperature).toBe(0.7);
+  });
+
+  it("保留带默认值的 $ 引用", async () => {
+    // 1. 创建包含带默认值 $ 引用的配置文件
+    const originalContent = `{
+  "agent": {
+    "defaultAgent": {
+      "apiKey": "\${file://auth.json#apiKey:-fallback_key}",
+      "timeout": 30
+    }
+  }
+}`;
+    await fsPromises.writeFile(configFilePath, originalContent, "utf-8");
+
+    // 2. 创建导入源文件
+    const sourceFilePath = path.join(tempDir, "source.json");
+    const sourceContent = `{
+  "agent": {
+    "defaultAgent": {
+      "maxRetries": 3
+    }
+  }
+}`;
+    await fsPromises.writeFile(sourceFilePath, sourceContent, "utf-8");
+
+    // 3. 执行导入
+    const { ConfigService } = await import("./config-service");
+    const mockConfigComponent = createMockConfigComponent(configFilePath);
+    const mockOutput = createMockOutput();
+    const configService = new ConfigService(mockConfigComponent, mockOutput as any);
+    
+    const result = await configService.importFromFile("agent", {
+      sourceFile: sourceFilePath,
+      verbose: false,
+    });
+
+    expect(result.success).toBe(true);
+
+    // 4. 验证带默认值的 $ 引用被保留
+    const finalContent = await fsPromises.readFile(configFilePath, "utf-8");
+    const finalData = JSON.parse(finalContent);
+    
+    expect(finalData.agent.defaultAgent.apiKey).toBe(
+      "\${file://auth.json#apiKey:-fallback_key}"
+    );
+    expect(finalData.agent.defaultAgent.timeout).toBe(30);
+    expect(finalData.agent.defaultAgent.maxRetries).toBe(3);
+  });
+});
+
+/**
+ * 创建模拟 ConfigComponent
+ */
+function createMockConfigComponent(filePath: string) {
+  return {
+    name: "config",
+    getSources: () => [
+      {
+        name: "memory",
+        read: () => undefined,
+        write: () => {},
+        list: () => [],
+      },
+      {
+        name: "file",
+        filePath,
+        read: () => undefined,
+        write: () => {},
+        list: () => [],
+      },
+    ],
+  } as any;
+}
+
+/**
+ * 创建模拟 OutputService
+ */
+function createMockOutput() {
+  return {
+    log: () => {},
+    info: () => {},
+    warn: () => {},
+    error: () => {},
+    success: () => {},
+  };
+}

package/src/commands/config/import.ts

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview config import 子命令
+ */
+
+import { CommandModule } from "yargs";
+import chalk from "chalk";
+import { EnvironmentService } from "../../services/environment.service";
+import { OutputService } from "../../services/output.service";
+import { ConfigService } from "./config-service";
+import { SUPPORTED_COMPONENTS, resolveComponentName } from "./types";
+
+export interface ConfigImportOptions {
+  component: string;
+  file: string;
+  dryRun?: boolean;
+  verbose?: boolean;
+  config?: string;
+}
+
+/**
+ * ConfigImportCommand - config import 子命令
+ */
+export const ConfigImportCommand: CommandModule<object, ConfigImportOptions> = {
+  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") as any;
+      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 as any)) {
+        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();
+    }
+  },
+};

package/src/commands/config/index.ts

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