@ai-setting/roy-agent-cli 1.0.0

package/src/commands/skills/search.ts

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Skills Search Command
+ * 
+ * 命令：roy skills search <term>
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../../services/environment.service";
+import { OutputService } from "../../services/output.service";
+import chalk from "chalk";
+import type { SkillComponent, SkillListItem } from "@ai-setting/roy-agent-core";
+
+interface SearchOptions {
+  term: string;
+  json?: boolean;
+  quiet?: boolean;
+  config?: string;
+}
+
+export const SearchCommand: CommandModule<object, SearchOptions> = {
+  command: "search <term>",
+  aliases: ["find"],
+  describe: "搜索技能（按名称或描述）",
+  
+  builder: (yargs) =>
+    yargs
+      .positional("term", {
+        type: "string",
+        demandOption: true,
+        description: "搜索关键词",
+      })
+      .option("json", {
+        alias: "j",
+        type: "boolean",
+        default: false,
+        description: "JSON 输出",
+      })
+      .option("quiet", {
+        alias: "q",
+        type: "boolean",
+        default: false,
+        description: "简洁输出",
+      }),
+  
+  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 skillComponent = env.getComponent("skill") as SkillComponent | undefined;
+
+      if (!skillComponent) {
+        output.error("SkillComponent not available");
+        process.exit(1);
+      }
+
+      const allSkills = skillComponent.getSkillList() as SkillListItem[];
+      const term = args.term.toLowerCase();
+
+      // 搜索匹配（name 或 description 包含 term）
+      const results = allSkills.filter((s: SkillListItem) => 
+        s.name.toLowerCase().includes(term) ||
+        s.description.toLowerCase().includes(term)
+      );
+
+      if (results.length === 0) {
+        output.log(chalk.yellow(`No skills found matching: ${args.term}`));
+        return;
+      }
+
+      if (args.json) {
+        output.json({
+          results: results.map((s: SkillListItem) => ({
+            name: s.name,
+            description: s.description,
+            source: s.source,
+            matchedIn: s.name.toLowerCase().includes(term) ? "name" : "description",
+          })),
+          count: results.length,
+          term: args.term,
+        });
+      } else if (args.quiet) {
+        results.forEach((s: SkillListItem) => output.log(s.name));
+      } else {
+        output.log(chalk.bold(`Search results for "${args.term}":`));
+        output.log("");
+
+        const header = [
+          chalk.bold("Name"),
+          chalk.bold("Description"),
+          chalk.bold("Match"),
+        ].join(" | ");
+
+        const rows = results.map((s: SkillListItem) => {
+          const matchedIn = s.name.toLowerCase().includes(term) ? "name" : "description";
+          const matchColor = matchedIn === "name" ? chalk.green : chalk.blue;
+          
+          const desc = s.description.length > 40 
+            ? s.description.slice(0, 37) + "..." 
+            : s.description;
+            
+          return [
+            chalk.cyan(s.name),
+            desc,
+            matchColor(`[${matchedIn}]`),
+          ].join(" | ");
+        });
+
+        output.log([
+          `┌─ Skills ${"─".repeat(55)}┐`,
+          `│${header}│`,
+          "├" + "─".repeat(header.length + 2) + "┤",
+          ...rows.map(r => `│${r}│`),
+          "└" + "─".repeat(header.length + 2) + "┘",
+          "",
+          chalk.gray(`${results.length} matching skill(s) found.`),
+        ].join("\n"));
+      }
+    } catch (error) {
+      output.error(`Failed to search skills: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/skills/show-config.ts

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Skills Show Config Command
+ * 
+ * 命令：roy skills show-config
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../../services/environment.service";
+import { OutputService } from "../../services/output.service";
+import chalk from "chalk";
+import type { SkillComponent, SkillConfig } from "@ai-setting/roy-agent-core";
+
+interface ShowConfigOptions {
+  config?: string;
+}
+
+export const ShowConfigCommand: CommandModule<object, ShowConfigOptions> = {
+  command: "show-config",
+  aliases: ["config"],
+  describe: "显示技能配置信息",
+  
+  builder: (yargs) =>
+    yargs
+      .option("config", {
+        type: "string",
+        description: "配置文件路径",
+      }),
+  
+  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 skillComponent = env.getComponent("skill") as SkillComponent | undefined;
+
+      if (!skillComponent) {
+        output.error("SkillComponent not available");
+        process.exit(1);
+      }
+
+      // SkillComponent 当前使用默认配置，还没有从配置系统读取
+      // 这里展示的是默认配置路径
+      const defaultConfig = skillComponent.getConfig?.();
+      
+      output.log(chalk.bold.cyan("# Skills Configuration\n"));
+      
+      // 扫描路径
+      output.log(chalk.bold("## Scan Paths\n"));
+      
+      const paths = [
+        { type: "user", desc: "用户路径", path: "~/.config/roy-agent/skills/" },
+        { type: "project", desc: "项目路径", path: ".roy/skills/" },
+      ];
+
+      for (const p of paths) {
+        const typeColor = p.type === "project" ? chalk.green : chalk.blue;
+        output.log(`  ${typeColor("[ " + p.type + " ]")} ${chalk.gray(p.desc)}`);
+        output.log(`         ${chalk.cyan(p.path)}\n`);
+      }
+
+      // 扫描规则
+      output.log(chalk.bold("## Scan Rules\n"));
+      output.log(`  ${chalk.gray("Pattern:")} ${chalk.cyan("**/SKILL.md")}`);
+      output.log(`  ${chalk.gray("Recursive:")} ${chalk.green("true")}`);
+      output.log(`  ${chalk.gray("Ignore:")} ${chalk.cyan("**/node_modules/**")}\n`);
+
+      // 优先级说明
+      output.log(chalk.bold("## Priority (High to Low)\n"));
+      output.log(`  ${chalk.green("1. project")} - 项目路径（最高优先级）`);
+      output.log(`  ${chalk.blue("2. user")} - 用户路径`);
+      output.log(`  ${chalk.gray("3. built-in")} - 内置路径（预留）\n`);
+
+      // 使用提示
+      output.log(chalk.bold("## Usage\n"));
+      output.log(`  ${chalk.cyan("roy skills list")} ${chalk.gray("- 列出所有技能")}`);
+      output.log(`  ${chalk.cyan("roy skills get <name>")} ${chalk.gray("- 获取技能内容")}`);
+      output.log(`  ${chalk.cyan("roy skills search <term>")} ${chalk.gray("- 搜索技能")}`);
+      output.log(`  ${chalk.cyan("roy skills reload")} ${chalk.gray("- 重新扫描技能")}`);
+
+    } catch (error) {
+      output.error(`Failed to show config: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/tasks/complete.ts

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Tasks Complete Command
+ * 
+ * 命令：roy tasks complete <task-id>
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../../services/environment.service";
+import { OutputService } from "../../services/output.service";
+import chalk from "chalk";
+import type {
+  SessionComponent,
+  TaskComponent,
+  Task,
+} from "@ai-setting/roy-agent-core";
+
+interface CompleteOptions {
+  id: number;
+  json?: boolean;
+  config?: string;
+  plugin?: string[];
+}
+
+export const CompleteCommand: CommandModule<object, CompleteOptions> = {
+  command: "complete <id>",
+  aliases: ["done", "finish"],
+  describe: "完成任务",
+  
+  builder: (yargs) =>
+    yargs
+      .positional("id", {
+        type: "number",
+        describe: "任务 ID",
+        demandOption: true,
+      })
+      .option("json", { alias: "j", type: "boolean", default: false, description: "JSON 输出" })
+      .option("plugin", {
+        alias: "p",
+        type: "string",
+        array: true,
+        description: "Enable plugin (e.g., --plugin task-tag)",
+      }),
+  
+  async handler(args) {
+    const output = new OutputService();
+    const envService = new EnvironmentService(output);
+
+    try {
+      // 传递 plugin 选项到 EnvironmentService
+      await envService.create({ 
+        configPath: args.config,
+        plugins: args.plugin,
+      });
+      const env = envService.getEnvironment();
+      if (!env) {
+        output.error("Failed to create environment");
+        process.exit(1);
+      }
+      const sessionComponent = env.getComponent("session") as SessionComponent | undefined;
+      const taskComponent = env.getComponent("task") as TaskComponent | undefined;
+
+      if (!taskComponent) {
+        output.error("TaskComponent not available");
+        process.exit(1);
+      }
+
+      // Get current session ID
+      const currentSessionId = sessionComponent?.getActiveSessionId() || "cli";
+      
+      const task: Task | undefined = await taskComponent.completeTask(args.id, currentSessionId);
+      
+      if (!task) {
+        output.error(`Task not found: ${args.id}`);
+        process.exit(1);
+      }
+
+      if (args.json) {
+        output.json(task);
+      } else {
+        output.log(chalk.green(`\n✓ Task completed: #${task.id}`));
+        output.log(`  Title: ${task.title}`);
+        output.log(`  Progress: ${task.progress}%`);
+        output.log(`  Completed at: ${task.updatedAt}`);
+      }
+    } catch (error) {
+      output.error(`Failed to complete task: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/tasks/create.ts

@@ -0,0 +1,118 @@
+/**
+ * @fileoverview Tasks Create Command
+ * 
+ * 命令：roy tasks create <title>
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../../services/environment.service";
+import { OutputService } from "../../services/output.service";
+import chalk from "chalk";
+import type {
+  SessionComponent,
+  TaskComponent,
+  Task,
+  CreateTaskOptions,
+  TaskPriority,
+} from "@ai-setting/roy-agent-core";
+
+interface CreateOptions {
+  title: string;
+  description?: string;
+  priority?: string;
+  goals?: string;
+  due?: string;
+  tags?: string;
+  json?: boolean;
+  config?: string;
+}
+
+export const CreateCommand: CommandModule<object, CreateOptions> = {
+  command: "create <title>",
+  aliases: ["add", "new"],
+  describe: "创建新任务",
+  
+  builder: (yargs) =>
+    yargs
+      .positional("title", {
+        type: "string",
+        describe: "任务标题",
+        demandOption: true,
+      })
+      .option("description", {
+        alias: "d",
+        type: "string",
+        description: "任务描述",
+      })
+      .option("priority", {
+        alias: "p",
+        type: "string",
+        choices: ["low", "medium", "high"],
+        default: "medium",
+        description: "优先级",
+      })
+      .option("goals", {
+        alias: "g",
+        type: "string",
+        description: "目标和预期产出",
+      })
+      .option("due", {
+        type: "string",
+        description: "截止日期 (ISO 格式)",
+      })
+      .option("tags", {
+        type: "string",
+        description: "标签 (逗号分隔)",
+      })
+      .option("json", { alias: "j", type: "boolean", default: false, description: "JSON 输出" }),
+  
+  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 sessionComponent = env.getComponent("session") as SessionComponent | undefined;
+      const taskComponent = env.getComponent("task") as TaskComponent | undefined;
+
+      if (!taskComponent) {
+        output.error("TaskComponent not available");
+        process.exit(1);
+      }
+
+      // Get current session ID
+      const currentSessionId = sessionComponent?.getActiveSessionId() || "cli";
+      
+      const createOptions: CreateTaskOptions = {
+        title: args.title,
+        description: args.description,
+        priority: args.priority as TaskPriority,
+        goals_and_expected_deliverables: args.goals,
+        due_date: args.due,
+        tags: args.tags ? args.tags.split(",").map(t => t.trim()) : undefined,
+        sessionId: currentSessionId,
+      };
+      const task: Task = await taskComponent.createTask(createOptions);
+
+      if (args.json) {
+        output.json(task);
+      } else {
+        output.log(chalk.green(`\n✓ Task created: #${task.id}`));
+        output.log(`  Title: ${task.title}`);
+        output.log(`  Status: ${task.status}`);
+        output.log(`  Priority: ${task.priority}`);
+        output.log(`  Created at: ${task.createdAt}`);
+      }
+    } catch (error) {
+      output.error(`Failed to create task: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/tasks/delete.ts

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Tasks Delete Command
+ * 
+ * 命令：roy tasks delete <task-id>
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../../services/environment.service";
+import { OutputService } from "../../services/output.service";
+import chalk from "chalk";
+import type { TaskComponent, Task } from "@ai-setting/roy-agent-core";
+
+interface DeleteOptions {
+  id: number;
+  force?: boolean;
+  config?: string;
+}
+
+export const DeleteCommand: CommandModule<object, DeleteOptions> = {
+  command: "delete <id>",
+  aliases: ["remove", "rm", "del"],
+  describe: "删除任务",
+  
+  builder: (yargs) =>
+    yargs
+      .positional("id", {
+        type: "number",
+        describe: "任务 ID",
+        demandOption: true,
+      })
+      .option("force", { 
+        alias: "f", 
+        type: "boolean", 
+        default: false, 
+        description: "强制删除，不确认" 
+      }),
+  
+  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 taskComponent = env.getComponent("task") as TaskComponent | undefined;
+
+      if (!taskComponent) {
+        output.error("TaskComponent not available");
+        process.exit(1);
+      }
+
+      // Check if task exists
+      const task: Task | undefined = await taskComponent.getTask(args.id);
+      if (!task) {
+        output.error(`Task not found: ${args.id}`);
+        process.exit(1);
+      }
+
+      if (!args.force) {
+        output.log(chalk.yellow(`Are you sure you want to delete task #${args.id}?`));
+        output.log(chalk.yellow(`  Title: ${task.title}`));
+        output.log(chalk.yellow(`  Status: ${task.status}`));
+        output.log(chalk.yellow(`\nUse --force to skip this confirmation`));
+        process.exit(1);
+      }
+
+      const deleted = await taskComponent.deleteTask(args.id);
+      
+      if (deleted) {
+        output.log(chalk.green(`\n✓ Task deleted: #${args.id}`));
+      } else {
+        output.error(`Failed to delete task: ${args.id}`);
+        process.exit(1);
+      }
+    } catch (error) {
+      output.error(`Failed to delete task: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/tasks/get.ts

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Tasks Get Command
+ * 
+ * 命令：roy tasks get <task-id>
+ */
+
+import { CommandModule } from "yargs";
+import { EnvironmentService } from "../../services/environment.service";
+import { OutputService } from "../../services/output.service";
+import chalk from "chalk";
+import type {
+  TaskComponent,
+  Task,
+  TaskOperation,
+} from "@ai-setting/roy-agent-core";
+
+interface GetOptions {
+  id: number;
+  operations?: boolean;
+  json?: boolean;
+  config?: string;
+}
+
+export const GetCommand: CommandModule<object, GetOptions> = {
+  command: "get <id>",
+  aliases: ["show"],
+  describe: "获取任务详情",
+  
+  builder: (yargs) =>
+    yargs
+      .positional("id", {
+        type: "number",
+        describe: "任务 ID",
+        demandOption: true,
+      })
+      .option("operations", {
+        alias: "o",
+        type: "boolean",
+        default: false,
+        description: "包含操作记录",
+      })
+      .option("json", { alias: "j", type: "boolean", default: false, description: "JSON 输出" }),
+  
+  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 taskComponent = env.getComponent("task") as TaskComponent | undefined;
+
+      if (!taskComponent) {
+        output.error("TaskComponent not available");
+        process.exit(1);
+      }
+
+      if (args.operations) {
+        const result = await taskComponent.getTaskWithOperations(args.id);
+        if (!result) {
+          output.error(`Task not found: ${args.id}`);
+          process.exit(1);
+        }
+        
+        if (args.json) {
+          output.json(result);
+        } else {
+          output.log(chalk.bold(`\nTask #${result.task.id}: ${result.task.title}\n`));
+          output.log(`Status: ${chalk.blue(result.task.status)} | Priority: ${result.task.priority} | Progress: ${result.task.progress}%`);
+          output.log(`Created: ${result.task.createdAt} | Updated: ${result.task.updatedAt}`);
+          if (result.task.current_status) {
+            output.log(`\nCurrent Status: ${result.task.current_status}`);
+          }
+          
+          output.log(chalk.bold(`\nOperations (${result.operations.length}):\n`));
+          result.operations.forEach((op: TaskOperation, i: number) => {
+            output.log(`  ${i + 1}. [${op.actionType}] ${op.actionTitle}`);
+            output.log(`     Session: ${op.sessionId} | Time: ${op.timestamp}`);
+            if (op.actionDescription) {
+              output.log(`     ${op.actionDescription}`);
+            }
+          });
+        }
+      } else {
+        const task: Task | undefined = await taskComponent.getTask(args.id);
+        if (!task) {
+          output.error(`Task not found: ${args.id}`);
+          process.exit(1);
+        }
+        
+        if (args.json) {
+          output.json(task);
+        } else {
+          output.log(chalk.bold(`\nTask #${task.id}: ${task.title}\n`));
+          output.log(`Status: ${chalk.blue(task.status)} | Priority: ${task.priority} | Progress: ${task.progress}%`);
+          output.log(`Created: ${task.createdAt} | Updated: ${task.updatedAt}`);
+          if (task.current_status) {
+            output.log(`\nCurrent Status: ${task.current_status}`);
+          }
+          if (task.description) {
+            output.log(`\nDescription: ${task.description}`);
+          }
+        }
+      }
+    } catch (error) {
+      output.error(`Failed to get task: ${error}`);
+      process.exit(1);
+    } finally {
+      await envService.dispose();
+    }
+  },
+};

package/src/commands/tasks/index.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Tasks Command Entry
+ * 
+ * 命令入口：roy tasks [action]
+ */
+
+import { CommandModule } from "yargs";
+import { ListCommand } from "./list";
+import { GetCommand } from "./get";
+import { CreateCommand } from "./create";
+import { UpdateCommand } from "./update";
+import { DeleteCommand } from "./delete";
+import { CompleteCommand } from "./complete";
+import { OperationsCommand } from "./operations";
+
+/**
+ * Tasks Command
+ * 
+ * 任务管理命令，提供以下子命令：
+ * - list: 列出所有任务
+ * - get: 获取任务详情
+ * - create: 创建任务
+ * - update: 更新任务
+ * - delete: 删除任务
+ * - complete: 完成任务
+ * - operations: 操作记录管理
+ */
+export const TasksCommand: CommandModule = {
+  command: "tasks",
+  describe: "任务管理 - 创建、追踪、管理任务",
+  builder: (yargs) =>
+    yargs
+      // 传递全局 plugin 选项到子命令
+      .option("plugin", {
+        alias: "p",
+        type: "string",
+        array: true,
+        description: "Enable plugin (e.g., --plugin task-tag)",
+        global: false,  // 不再是 global，避免重复
+      })
+      .command(ListCommand)
+      .command(GetCommand)
+      .command(CreateCommand)
+      .command(UpdateCommand)
+      .command(DeleteCommand)
+      .command(CompleteCommand)
+      .command(OperationsCommand)
+      .demandCommand()
+      .help(),
+  handler: () => {
+    console.log("Use 'roy tasks --help' for usage information");
+  },
+};