@ai-setting/roy-agent-cli 1.5.49 → 1.5.50

package/dist/bin/roy-agent.js

@@ -7290,7 +7290,7 @@ var require_dist = __commonJS((exports) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@ai-setting/roy-agent-cli",
-    version: "1.5.49",
+    version: "1.5.50",
     type: "module",
     description: "CLI for roy-agent - Non-interactive command execution",
     main: "./dist/index.js",
@@ -7317,7 +7317,7 @@ var require_package = __commonJS((exports, module) => {
     },
     dependencies: {
       "@ai-setting/roy-agent-coder-harness": "^1.5.46",
-      "@ai-setting/roy-agent-core": "^1.5.48",
+      "@ai-setting/roy-agent-core": "^1.5.49",
       "@ai-setting/roy-agent-ontology-harness": "^1.5.47",
       chalk: "^5.6.2",
       commander: "^14.0.3",
@@ -8216,7 +8216,7 @@ class TaskEventHandler {
   logTaskCreated(payload) {
     const task = payload.task;
     console.log(`\uD83D\uDCDD Task created: #${task.id} - ${task.title}`);
-    console.log(`   Status: ${task.status}, Priority: ${task.priority}`);
+    console.log(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}`);
     if (task.project_path) {
       console.log(`   Project: ${task.project_path}`);
     }
@@ -8228,7 +8228,7 @@ class TaskEventHandler {
     const task = payload.task;
     const changes = payload.changes;
     console.log(`✏️  Task updated: #${task.id} - ${task.title}`);
-    console.log(`   Status: ${task.status}, Progress: ${task.progress}%`);
+    console.log(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}, Progress: ${task.progress}%`);
     if (changes) {
       console.log(`   Changes: ${JSON.stringify(changes)}`);
     }
@@ -11578,6 +11578,10 @@ var ListCommand2 = {
     type: "string",
     choices: ["low", "medium", "high"],
     description: "按优先级筛选"
+  }).option("type", {
+    type: "string",
+    choices: ["normal", "cycle", "longterm"],
+    description: "按任务类型筛选"
   }).option("limit", { alias: "n", type: "number", default: 20, description: "返回数量" }).option("offset", { type: "number", default: 0, description: "偏移量" }).option("json", { alias: "j", type: "boolean", default: false, description: "JSON 输出" }).option("quiet", { alias: "q", type: "boolean", hidden: true }),
   async handler(args) {
     const output = new OutputService;
@@ -11597,6 +11601,7 @@ var ListCommand2 = {
       const listOptions = {
         status: args.status,
         priority: args.priority,
+        type: args.type,
         limit: args.limit,
         offset: args.offset
       };
@@ -11608,6 +11613,7 @@ var ListCommand2 = {
             title: t.title,
             status: t.status,
             priority: t.priority,
+            type: t.type,
             progress: t.progress,
             current_status: t.current_status,
             project_path: t.project_path,
@@ -11625,6 +11631,7 @@ var ListCommand2 = {
           chalk16.bold("Title"),
           chalk16.bold("Status"),
           chalk16.bold("Priority"),
+          chalk16.bold("Type"),
           chalk16.bold("Progress")
         ].join(" │ ");
         const rows = tasks.map((t, i) => {
@@ -11635,6 +11642,7 @@ var ListCommand2 = {
             t.title.length > 30 ? t.title.slice(0, 27) + "..." : t.title,
             statusColor(t.status),
             priorityColor(t.priority),
+            t.type || "normal",
             `${t.progress}%`
           ].join(" │ ");
         });
@@ -11701,7 +11709,7 @@ var GetCommand2 = {
           output.log(chalk17.bold(`
 Task #${result.task.id}: ${result.task.title}
 `));
-          output.log(`Status: ${chalk17.blue(result.task.status)} | Priority: ${result.task.priority} | Progress: ${result.task.progress}%`);
+          output.log(`Status: ${chalk17.blue(result.task.status)} | Priority: ${result.task.priority} | Type: ${result.task.type} | Progress: ${result.task.progress}%`);
           output.log(`Created: ${result.task.createdAt} | Updated: ${result.task.updatedAt}`);
           output.log(`Project Path: ${result.task.project_path}`);
           output.log(`Context: ${result.task.context}`);
@@ -11732,7 +11740,7 @@ Operations (${result.operations.length}):
           output.log(chalk17.bold(`
 Task #${task.id}: ${task.title}
 `));
-          output.log(`Status: ${chalk17.blue(task.status)} | Priority: ${task.priority} | Progress: ${task.progress}%`);
+          output.log(`Status: ${chalk17.blue(task.status)} | Priority: ${task.priority} | Type: ${task.type} | Progress: ${task.progress}%`);
           output.log(`Created: ${task.createdAt} | Updated: ${task.updatedAt}`);
           output.log(`Project Path: ${task.project_path}`);
           output.log(`Context: ${task.context}`);
@@ -11775,6 +11783,11 @@ var CreateCommand = {
     choices: ["low", "medium", "high"],
     default: "medium",
     description: "优先级"
+  }).option("type", {
+    type: "string",
+    choices: ["normal", "cycle", "longterm"],
+    desc: "任务类型。normal=常规, cycle=周期任务（如周报）, longterm=长期目标",
+    default: "normal"
   }).option("goals", {
     alias: "g",
     type: "string",
@@ -11813,6 +11826,7 @@ var CreateCommand = {
         title: args.title,
         description: args.description,
         priority: args.priority,
+        type: args.type,
         goals_and_expected_deliverables: args.goals,
         due_date: args.due,
         tags: args.tags ? args.tags.split(",").map((t) => t.trim()) : undefined,
@@ -11829,6 +11843,7 @@ var CreateCommand = {
         output.log(`  Title: ${task.title}`);
         output.log(`  Status: ${task.status}`);
         output.log(`  Priority: ${task.priority}`);
+        output.log(`  Type: ${task.type}`);
         output.log(`  Created at: ${task.createdAt}`);
       }
     } catch (error) {
@@ -11850,7 +11865,7 @@ var UpdateCommand = {
     type: "number",
     describe: "任务 ID",
     demandOption: true
-  }).option("title", { alias: "t", type: "string", description: "标题" }).option("description", { alias: "d", type: "string", description: "描述" }).option("status", { alias: "s", type: "string", choices: ["todo", "active", "completed", "paused", "cancelled"], description: "状态" }).option("priority", { alias: "p", type: "string", choices: ["low", "medium", "high"], description: "优先级" }).option("progress", { type: "number", min: 0, max: 100, description: "进度 (0-100)" }).option("current_status", { alias: "c", type: "string", description: "当前状态描述" }).option("project-path", { type: "string", description: "项目路径" }).option("context", { type: "string", description: "任务上下文 (JSON 字符串)" }).option("json", { alias: "j", type: "boolean", default: false, description: "JSON 输出" }),
+  }).option("title", { alias: "t", type: "string", description: "标题" }).option("description", { alias: "d", type: "string", description: "描述" }).option("status", { alias: "s", type: "string", choices: ["todo", "active", "completed", "paused", "cancelled"], description: "状态" }).option("priority", { alias: "p", type: "string", choices: ["low", "medium", "high"], description: "优先级" }).option("type", { type: "string", choices: ["normal", "cycle", "longterm"], description: "任务类型 (normal/cycle/longterm)" }).option("progress", { type: "number", min: 0, max: 100, description: "进度 (0-100)" }).option("current_status", { alias: "c", type: "string", description: "当前状态描述" }).option("project-path", { type: "string", description: "项目路径" }).option("context", { type: "string", description: "任务上下文 (JSON 字符串)" }).option("json", { alias: "j", type: "boolean", default: false, description: "JSON 输出" }),
   async handler(args) {
     const output = new OutputService;
     const envService = new EnvironmentService(output);
@@ -11873,6 +11888,7 @@ var UpdateCommand = {
         description: args.description,
         status: args.status,
         priority: args.priority,
+        type: args.type,
         progress: args.progress,
         current_status: args.current_status,
         project_path: args["project-path"],
@@ -11903,6 +11919,7 @@ var UpdateCommand = {
         output.log(`  Title: ${task.title}`);
         output.log(`  Status: ${task.status}`);
         output.log(`  Priority: ${task.priority}`);
+        output.log(`  Type: ${task.type}`);
         output.log(`  Progress: ${task.progress}%`);
         output.log(`  Project Path: ${task.project_path}`);
         output.log(`  Context: ${task.context}`);
@@ -12117,7 +12134,238 @@ Operations for Task #${task.id}: ${task.title}
   }
 };
 
+// src/commands/tasks/organize.ts
+var command = "organize";
+var desc = "整理系统中的任务（清理测试任务、聚合相似任务、构建任务树）";
+var builder = (yargs) => yargs.option("dry-run", {
+  type: "boolean",
+  desc: "试运行模式，只展示计划不执行",
+  default: false
+}).option("delete-test", {
+  type: "boolean",
+  desc: "使用 AI 分析判断哪些是纯测试/示例任务并清理（避免误删正式任务）"
+}).option("aggregate", {
+  type: "boolean",
+  desc: "聚合相似任务（基于标题文本相似度）"
+}).option("build-tree", {
+  type: "boolean",
+  desc: "构建任务树（为散落的同类任务构建父任务）"
+}).option("auto", {
+  type: "boolean",
+  desc: "全自动模式，执行所有整理策略"
+}).example([
+  ["$0 tasks organize --dry-run", "试运行，只展示整理计划"],
+  ["$0 tasks organize --auto", "全自动整理"],
+  ["$0 tasks organize --delete-test", "用 AI 清理测试任务"]
+]);
+async function handleDeleteTest(store, allTasks, shouldExecute, report) {
+  const testPatterns = [
+    /^test\b/i,
+    /^测试/i,
+    /^示例/i,
+    /^demo\b/i,
+    /^sample\b/i,
+    /event test/i,
+    /test task/i
+  ];
+  const excludePatterns = [
+    /strict-task-agent/i,
+    /集成测试/i,
+    /bench测试/i,
+    /测试用例/i,
+    /typecheck/i,
+    /traffic_test/i
+  ];
+  const matched = allTasks.filter((t) => {
+    const title = t.title;
+    for (const pat of excludePatterns) {
+      if (pat.test(title))
+        return false;
+    }
+    for (const pat of testPatterns) {
+      if (pat.test(title))
+        return true;
+    }
+    return false;
+  });
+  if (matched.length === 0) {
+    report.push("没有发现需要清理的测试任务");
+    return;
+  }
+  report.push("发现 " + matched.length + " 个测试任务:");
+  for (const task of matched) {
+    report.push("   - #" + task.id + ": " + task.title + " (" + task.status + ")");
+  }
+  report.push("");
+  report.push("  ℹ️ 提示：如需更智能的语义分析，请运行:");
+  report.push('     roy-agent act "整理测试任务" --agent task-organizer');
+  if (shouldExecute) {
+    let count = 0;
+    for (const task of matched) {
+      try {
+        await store.deleteTask(task.id);
+        report.push("  ✅ 已删除: #" + task.id + " - " + task.title);
+        count++;
+      } catch (err) {
+        report.push("  ❌ 删除失败: #" + task.id + " - " + err.message);
+      }
+    }
+    report.push("  共删除 " + count + " 个测试任务");
+  }
+}
+async function handleAggregate(store, allTasks, shouldExecute, report) {
+  function sim(a, b) {
+    const s1 = new Set(a.toLowerCase().split(/[\s_-]+/));
+    const s2 = new Set(b.toLowerCase().split(/[\s_-]+/));
+    const inter = new Set([...s1].filter((w) => s2.has(w)));
+    const union = new Set([...s1, ...s2]);
+    return inter.size / union.size;
+  }
+  const visited = new Set;
+  const groups = [];
+  const THRESHOLD = 0.7;
+  for (let i = 0;i < allTasks.length; i++) {
+    if (visited.has(allTasks[i].id))
+      continue;
+    const group = [allTasks[i]];
+    visited.add(allTasks[i].id);
+    for (let j = i + 1;j < allTasks.length; j++) {
+      if (visited.has(allTasks[j].id))
+        continue;
+      if (sim(allTasks[i].title, allTasks[j].title) >= THRESHOLD) {
+        group.push(allTasks[j]);
+        visited.add(allTasks[j].id);
+      }
+    }
+    if (group.length > 1)
+      groups.push(group);
+  }
+  if (groups.length === 0) {
+    report.push("未发现相似任务");
+    return;
+  }
+  report.push("发现 " + groups.length + " 组相似任务:");
+  for (const g of groups) {
+    report.push("  组:");
+    for (const t of g)
+      report.push("    - #" + t.id + ": " + t.title);
+    if (shouldExecute) {
+      const tagName = "group:" + g[0].title.slice(0, 20).replace(/[\s_-]+/g, "-").toLowerCase();
+      for (const t of g) {
+        const currentTags = t.tags || [];
+        if (!currentTags.includes(tagName)) {
+          await store.updateTask(t.id, { tags: [...currentTags, tagName] });
+        }
+      }
+      report.push("    -> 添加关联标签: " + tagName);
+    }
+  }
+}
+async function handleBuildTree(store, allTasks, shouldExecute, report) {
+  const rootTasks = allTasks.filter((t) => !t.parent_task_id);
+  if (rootTasks.length === 0) {
+    report.push("所有任务已有父任务");
+    return;
+  }
+  const stopWords = new Set(["test", "测试", "task", "任务", "add", "create", "fix"]);
+  const groups = new Map;
+  for (const task of rootTasks) {
+    const words = task.title.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fa5]/g, " ").split(/\s+/).filter(Boolean);
+    const topicWords = words.filter((w) => !stopWords.has(w)).slice(0, 2);
+    const topic = topicWords.join("-") || words[0] || "未分类";
+    if (!groups.has(topic))
+      groups.set(topic, []);
+    groups.get(topic).push(task);
+  }
+  const toBuild = [...groups.entries()].filter(([, tasks]) => tasks.length >= 2);
+  if (toBuild.length === 0) {
+    report.push("没有需要构建父任务的主题组");
+    return;
+  }
+  report.push("将为 " + toBuild.length + " 个主题组创建父任务:");
+  for (const [topic, tasks] of toBuild) {
+    const types = tasks.map((t) => t.type);
+    const allCycle = types.every((t) => t === "cycle");
+    const hasLongterm = types.some((t) => t === "longterm");
+    let parentType = "normal";
+    if (allCycle)
+      parentType = "cycle";
+    else if (hasLongterm)
+      parentType = "longterm";
+    const parentTitle = "[" + topic.toUpperCase() + "] " + topic + "相关工作";
+    report.push("  \uD83D\uDCC2 主题: " + topic + " -> 父任务: " + parentTitle + " (" + parentType + ")");
+    for (const t of tasks)
+      report.push("     - #" + t.id + ": " + t.title);
+    if (shouldExecute) {
+      try {
+        const parentTask = await store.createTask({
+          title: parentTitle,
+          description: "自动创建，聚合 " + tasks.length + ' 个 "' + topic + '" 相关子任务',
+          type: parentType,
+          priority: "medium",
+          sessionId: "cli-organize",
+          project_path: "organize",
+          context: JSON.stringify({ type: "organize-auto", topic })
+        });
+        for (const t of tasks) {
+          await store.updateTask(t.id, { parent_task_id: parentTask.id });
+        }
+        report.push("     ✅ 已创建父任务 #" + parentTask.id);
+      } catch (err) {
+        report.push("     ❌ 创建失败: " + err.message);
+      }
+    }
+  }
+}
+var handler = async (args) => {
+  console.log("\uD83D\uDD0D Task Organizer");
+  const { getDefaultTaskDbPath, SQLiteTaskStore } = await import("@ai-setting/roy-agent-core");
+  const store = new SQLiteTaskStore(getDefaultTaskDbPath());
+  await store.initialize?.();
+  const allTasks = await store.listTasks({ limit: 9999 });
+  console.log(`
+\uD83D\uDCCA 系统中共有 ` + allTasks.length + ` 个任务
+`);
+  const report = [];
+  if (args.deleteTest || args.auto) {
+    await handleDeleteTest(store, allTasks, !args.dryRun, report);
+  }
+  if (args.aggregate || args.auto) {
+    await handleAggregate(store, allTasks, !args.dryRun, report);
+  }
+  if (args.buildTree || args.auto) {
+    await handleBuildTree(store, allTasks, !args.dryRun, report);
+  }
+  console.log(`
+` + "=".repeat(60));
+  console.log("\uD83D\uDCCB 整理报告");
+  console.log("=".repeat(60));
+  if (report.length === 0) {
+    console.log("  ✨ 未指定整理策略。请使用以下选项：");
+    console.log("     --delete-test    用 AI 清理测试任务");
+    console.log("     --aggregate      聚合相似任务");
+    console.log("     --build-tree     构建任务树");
+    console.log("     --auto           全自动执行所有策略");
+    console.log("     --dry-run        试运行预览");
+  } else {
+    console.log(report.join(`
+`));
+  }
+  console.log("=".repeat(60));
+  if (args.dryRun) {
+    console.log(`
+✨ 提示：去掉 --dry-run 参数执行实际整理操作`);
+  }
+  store.close();
+};
+
 // src/commands/tasks/index.ts
+var OrganizeCommand = {
+  command,
+  describe: desc,
+  builder,
+  handler
+};
 var TasksCommand = {
   command: "tasks",
   describe: "任务管理 - 创建、追踪、管理任务",
@@ -12127,7 +12375,7 @@ var TasksCommand = {
     array: true,
     description: "Enable plugin (e.g., --plugin task-tag)",
     global: false
-  }).command(ListCommand2).command(GetCommand2).command(CreateCommand).command(UpdateCommand).command(DeleteCommand2).command(CompleteCommand).command(OperationsCommand).demandCommand().help(),
+  }).command(ListCommand2).command(GetCommand2).command(CreateCommand).command(UpdateCommand).command(DeleteCommand2).command(CompleteCommand).command(OperationsCommand).command(OrganizeCommand).demandCommand().help(),
   handler: () => {
     console.log("Use 'roy-agent tasks --help' for usage information");
   }
@@ -12204,10 +12452,10 @@ var ListCommand3 = {
           }
         };
         const rows = filtered.map((s) => {
-          const desc = s.description.length > 50 ? s.description.slice(0, 47) + "..." : s.description;
+          const desc2 = s.description.length > 50 ? s.description.slice(0, 47) + "..." : s.description;
           return [
             chalk23.cyan(s.name),
-            desc,
+            desc2,
             sourceColor(s.source)(`[${s.source}]`)
           ].join(" | ");
         });
@@ -12362,10 +12610,10 @@ var SearchCommand = {
         const rows = results.map((s) => {
           const matchedIn = s.name.toLowerCase().includes(term) ? "name" : "description";
           const matchColor = matchedIn === "name" ? chalk25.green : chalk25.blue;
-          const desc = s.description.length > 40 ? s.description.slice(0, 37) + "..." : s.description;
+          const desc2 = s.description.length > 40 ? s.description.slice(0, 37) + "..." : s.description;
           return [
             chalk25.cyan(s.name),
-            desc,
+            desc2,
             matchColor(`[${matchedIn}]`)
           ].join(" | ");
         });
@@ -12581,13 +12829,13 @@ var ListCommand4 = {
           return chalk28.blue;
         };
         const rows = agents.map((a) => {
-          const desc = (a.description || "").length > 40 ? (a.description || "").slice(0, 37) + "..." : a.description || "-";
+          const desc2 = (a.description || "").length > 40 ? (a.description || "").slice(0, 37) + "..." : a.description || "-";
           const workflowDisplay = a.type === "workflow" && a.workflow ? chalk28.cyan(a.workflow.length > 30 ? a.workflow.slice(0, 27) + "..." : a.workflow) : chalk28.gray("-");
           return [
             chalk28.cyan(a.name),
             typeColor(a.type)(a.type),
             workflowDisplay,
-            desc
+            desc2
           ].join(" | ");
         });
         if (rows.length === 0) {
@@ -13301,8 +13549,8 @@ function formatCommandsTable(commands) {
   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 desc2 = truncateVisual(cmd.description || "-", DESC_WIDTH);
+    return `${name}${GAP}${source}${GAP}${desc2}`;
   };
   const rows = commands.map(formatRow);
   return [headerLine, sepLine, ...rows].join(`
@@ -14009,8 +14257,8 @@ function showHelp(output) {
   output.log(`  ${chalk42.cyan("-s, --sources")}  只显示配置源`);
   output.log("");
   output.log(chalk42.bold("Examples:"));
-  for (const { command, description } of USAGE_COMMANDS) {
-    output.log(`  ${chalk42.cyan(command.padEnd(40))} ${chalk42.gray(description)}`);
+  for (const { command: command2, description } of USAGE_COMMANDS) {
+    output.log(`  ${chalk42.cyan(command2.padEnd(40))} ${chalk42.gray(description)}`);
   }
 }
 async function showAllComponents(output, configService) {
@@ -14524,9 +14772,9 @@ var ToolsCommand = {
           output.log(chalk46.bold.cyan(`
 [${serverName}] ${serverTools.length} tools`));
           for (const tool of serverTools) {
-            const desc = tool.description.length > 80 ? tool.description.slice(0, 77) + "..." : tool.description;
+            const desc2 = tool.description.length > 80 ? tool.description.slice(0, 77) + "..." : tool.description;
             output.log(`  ${chalk46.green("+")} ${chalk46.white(tool.name)}`);
-            output.log(`    ${chalk46.gray(desc)}`);
+            output.log(`    ${chalk46.gray(desc2)}`);
           }
         }
         output.log(chalk46.gray(`
@@ -14646,10 +14894,10 @@ var ListCommand7 = {
           chalk48.bold("Category")
         ].join(" | ");
         const rows = tools.map((t) => {
-          const desc = t.description.length > 40 ? t.description.slice(0, 37) + "..." : t.description;
+          const desc2 = t.description.length > 40 ? t.description.slice(0, 37) + "..." : t.description;
           return [
             chalk48.cyan(t.name),
-            desc,
+            desc2,
             t.metadata?.category ? chalk48.gray(`[${t.metadata.category}]`) : "-"
           ].join(" | ");
         });
@@ -17328,6 +17576,7 @@ var WorkflowGetCommand = {
 import chalk62 from "chalk";
 import fs4 from "fs";
 import path7 from "path";
+import { parseWorkflowFile } from "@ai-setting/roy-agent-core/env/workflow/types";
 var WorkflowUpdateCommand = {
   command: "update <name>",
   describe: "更新已存在的 Workflow",
@@ -17391,7 +17640,7 @@ var WorkflowUpdateCommand = {
           process.exit(1);
         }
         const content = fs4.readFileSync(filePath, "utf-8");
-        const { definition } = await workflowComponent.parseWorkflowFile(content, filePath);
+        const { definition } = await parseWorkflowFile(content, filePath);
         updates.definition = definition;
       }
       const tags = a.tags ? a.tags.split(",").map((t) => t.trim()) : undefined;
@@ -18213,8 +18462,8 @@ function renderNodeTypesTable(nodes) {
   for (const node of nodes) {
     const type = node.type.padEnd(10);
     const name = node.name.padEnd(18);
-    const desc = node.description.substring(0, 59).padEnd(59);
-    lines.push(`│ ${type} │ ${name} │ ${desc} │`);
+    const desc2 = node.description.substring(0, 59).padEnd(59);
+    lines.push(`│ ${type} │ ${name} │ ${desc2} │`);
   }
   lines.push("└────────────┴────────────────────┴─────────────────────────────────────────────────────────────┘");
   return lines.join(`

package/dist/index.js

@@ -7289,7 +7289,7 @@ var require_dist = __commonJS((exports) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@ai-setting/roy-agent-cli",
-    version: "1.5.49",
+    version: "1.5.50",
     type: "module",
     description: "CLI for roy-agent - Non-interactive command execution",
     main: "./dist/index.js",
@@ -7316,7 +7316,7 @@ var require_package = __commonJS((exports, module) => {
     },
     dependencies: {
       "@ai-setting/roy-agent-coder-harness": "^1.5.46",
-      "@ai-setting/roy-agent-core": "^1.5.48",
+      "@ai-setting/roy-agent-core": "^1.5.49",
       "@ai-setting/roy-agent-ontology-harness": "^1.5.47",
       chalk: "^5.6.2",
       commander: "^14.0.3",
@@ -8215,7 +8215,7 @@ class TaskEventHandler {
   logTaskCreated(payload) {
     const task = payload.task;
     console.log(`\uD83D\uDCDD Task created: #${task.id} - ${task.title}`);
-    console.log(`   Status: ${task.status}, Priority: ${task.priority}`);
+    console.log(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}`);
     if (task.project_path) {
       console.log(`   Project: ${task.project_path}`);
     }
@@ -8227,7 +8227,7 @@ class TaskEventHandler {
     const task = payload.task;
     const changes = payload.changes;
     console.log(`✏️  Task updated: #${task.id} - ${task.title}`);
-    console.log(`   Status: ${task.status}, Progress: ${task.progress}%`);
+    console.log(`   Status: ${task.status}, Priority: ${task.priority}, Type: ${task.type || "normal"}, Progress: ${task.progress}%`);
     if (changes) {
       console.log(`   Changes: ${JSON.stringify(changes)}`);
     }
@@ -11577,6 +11577,10 @@ var ListCommand2 = {
     type: "string",
     choices: ["low", "medium", "high"],
     description: "按优先级筛选"
+  }).option("type", {
+    type: "string",
+    choices: ["normal", "cycle", "longterm"],
+    description: "按任务类型筛选"
   }).option("limit", { alias: "n", type: "number", default: 20, description: "返回数量" }).option("offset", { type: "number", default: 0, description: "偏移量" }).option("json", { alias: "j", type: "boolean", default: false, description: "JSON 输出" }).option("quiet", { alias: "q", type: "boolean", hidden: true }),
   async handler(args) {
     const output = new OutputService;
@@ -11596,6 +11600,7 @@ var ListCommand2 = {
       const listOptions = {
         status: args.status,
         priority: args.priority,
+        type: args.type,
         limit: args.limit,
         offset: args.offset
       };
@@ -11607,6 +11612,7 @@ var ListCommand2 = {
             title: t.title,
             status: t.status,
             priority: t.priority,
+            type: t.type,
             progress: t.progress,
             current_status: t.current_status,
             project_path: t.project_path,
@@ -11624,6 +11630,7 @@ var ListCommand2 = {
           chalk16.bold("Title"),
           chalk16.bold("Status"),
           chalk16.bold("Priority"),
+          chalk16.bold("Type"),
           chalk16.bold("Progress")
         ].join(" │ ");
         const rows = tasks.map((t, i) => {
@@ -11634,6 +11641,7 @@ var ListCommand2 = {
             t.title.length > 30 ? t.title.slice(0, 27) + "..." : t.title,
             statusColor(t.status),
             priorityColor(t.priority),
+            t.type || "normal",
             `${t.progress}%`
           ].join(" │ ");
         });
@@ -11700,7 +11708,7 @@ var GetCommand2 = {
           output.log(chalk17.bold(`
 Task #${result.task.id}: ${result.task.title}
 `));
-          output.log(`Status: ${chalk17.blue(result.task.status)} | Priority: ${result.task.priority} | Progress: ${result.task.progress}%`);
+          output.log(`Status: ${chalk17.blue(result.task.status)} | Priority: ${result.task.priority} | Type: ${result.task.type} | Progress: ${result.task.progress}%`);
           output.log(`Created: ${result.task.createdAt} | Updated: ${result.task.updatedAt}`);
           output.log(`Project Path: ${result.task.project_path}`);
           output.log(`Context: ${result.task.context}`);
@@ -11731,7 +11739,7 @@ Operations (${result.operations.length}):
           output.log(chalk17.bold(`
 Task #${task.id}: ${task.title}
 `));
-          output.log(`Status: ${chalk17.blue(task.status)} | Priority: ${task.priority} | Progress: ${task.progress}%`);
+          output.log(`Status: ${chalk17.blue(task.status)} | Priority: ${task.priority} | Type: ${task.type} | Progress: ${task.progress}%`);
           output.log(`Created: ${task.createdAt} | Updated: ${task.updatedAt}`);
           output.log(`Project Path: ${task.project_path}`);
           output.log(`Context: ${task.context}`);
@@ -11774,6 +11782,11 @@ var CreateCommand = {
     choices: ["low", "medium", "high"],
     default: "medium",
     description: "优先级"
+  }).option("type", {
+    type: "string",
+    choices: ["normal", "cycle", "longterm"],
+    desc: "任务类型。normal=常规, cycle=周期任务（如周报）, longterm=长期目标",
+    default: "normal"
   }).option("goals", {
     alias: "g",
     type: "string",
@@ -11812,6 +11825,7 @@ var CreateCommand = {
         title: args.title,
         description: args.description,
         priority: args.priority,
+        type: args.type,
         goals_and_expected_deliverables: args.goals,
         due_date: args.due,
         tags: args.tags ? args.tags.split(",").map((t) => t.trim()) : undefined,
@@ -11828,6 +11842,7 @@ var CreateCommand = {
         output.log(`  Title: ${task.title}`);
         output.log(`  Status: ${task.status}`);
         output.log(`  Priority: ${task.priority}`);
+        output.log(`  Type: ${task.type}`);
         output.log(`  Created at: ${task.createdAt}`);
       }
     } catch (error) {
@@ -11849,7 +11864,7 @@ var UpdateCommand = {
     type: "number",
     describe: "任务 ID",
     demandOption: true
-  }).option("title", { alias: "t", type: "string", description: "标题" }).option("description", { alias: "d", type: "string", description: "描述" }).option("status", { alias: "s", type: "string", choices: ["todo", "active", "completed", "paused", "cancelled"], description: "状态" }).option("priority", { alias: "p", type: "string", choices: ["low", "medium", "high"], description: "优先级" }).option("progress", { type: "number", min: 0, max: 100, description: "进度 (0-100)" }).option("current_status", { alias: "c", type: "string", description: "当前状态描述" }).option("project-path", { type: "string", description: "项目路径" }).option("context", { type: "string", description: "任务上下文 (JSON 字符串)" }).option("json", { alias: "j", type: "boolean", default: false, description: "JSON 输出" }),
+  }).option("title", { alias: "t", type: "string", description: "标题" }).option("description", { alias: "d", type: "string", description: "描述" }).option("status", { alias: "s", type: "string", choices: ["todo", "active", "completed", "paused", "cancelled"], description: "状态" }).option("priority", { alias: "p", type: "string", choices: ["low", "medium", "high"], description: "优先级" }).option("type", { type: "string", choices: ["normal", "cycle", "longterm"], description: "任务类型 (normal/cycle/longterm)" }).option("progress", { type: "number", min: 0, max: 100, description: "进度 (0-100)" }).option("current_status", { alias: "c", type: "string", description: "当前状态描述" }).option("project-path", { type: "string", description: "项目路径" }).option("context", { type: "string", description: "任务上下文 (JSON 字符串)" }).option("json", { alias: "j", type: "boolean", default: false, description: "JSON 输出" }),
   async handler(args) {
     const output = new OutputService;
     const envService = new EnvironmentService(output);
@@ -11872,6 +11887,7 @@ var UpdateCommand = {
         description: args.description,
         status: args.status,
         priority: args.priority,
+        type: args.type,
         progress: args.progress,
         current_status: args.current_status,
         project_path: args["project-path"],
@@ -11902,6 +11918,7 @@ var UpdateCommand = {
         output.log(`  Title: ${task.title}`);
         output.log(`  Status: ${task.status}`);
         output.log(`  Priority: ${task.priority}`);
+        output.log(`  Type: ${task.type}`);
         output.log(`  Progress: ${task.progress}%`);
         output.log(`  Project Path: ${task.project_path}`);
         output.log(`  Context: ${task.context}`);
@@ -12116,7 +12133,238 @@ Operations for Task #${task.id}: ${task.title}
   }
 };
 
+// src/commands/tasks/organize.ts
+var command = "organize";
+var desc = "整理系统中的任务（清理测试任务、聚合相似任务、构建任务树）";
+var builder = (yargs) => yargs.option("dry-run", {
+  type: "boolean",
+  desc: "试运行模式，只展示计划不执行",
+  default: false
+}).option("delete-test", {
+  type: "boolean",
+  desc: "使用 AI 分析判断哪些是纯测试/示例任务并清理（避免误删正式任务）"
+}).option("aggregate", {
+  type: "boolean",
+  desc: "聚合相似任务（基于标题文本相似度）"
+}).option("build-tree", {
+  type: "boolean",
+  desc: "构建任务树（为散落的同类任务构建父任务）"
+}).option("auto", {
+  type: "boolean",
+  desc: "全自动模式，执行所有整理策略"
+}).example([
+  ["$0 tasks organize --dry-run", "试运行，只展示整理计划"],
+  ["$0 tasks organize --auto", "全自动整理"],
+  ["$0 tasks organize --delete-test", "用 AI 清理测试任务"]
+]);
+async function handleDeleteTest(store, allTasks, shouldExecute, report) {
+  const testPatterns = [
+    /^test\b/i,
+    /^测试/i,
+    /^示例/i,
+    /^demo\b/i,
+    /^sample\b/i,
+    /event test/i,
+    /test task/i
+  ];
+  const excludePatterns = [
+    /strict-task-agent/i,
+    /集成测试/i,
+    /bench测试/i,
+    /测试用例/i,
+    /typecheck/i,
+    /traffic_test/i
+  ];
+  const matched = allTasks.filter((t) => {
+    const title = t.title;
+    for (const pat of excludePatterns) {
+      if (pat.test(title))
+        return false;
+    }
+    for (const pat of testPatterns) {
+      if (pat.test(title))
+        return true;
+    }
+    return false;
+  });
+  if (matched.length === 0) {
+    report.push("没有发现需要清理的测试任务");
+    return;
+  }
+  report.push("发现 " + matched.length + " 个测试任务:");
+  for (const task of matched) {
+    report.push("   - #" + task.id + ": " + task.title + " (" + task.status + ")");
+  }
+  report.push("");
+  report.push("  ℹ️ 提示：如需更智能的语义分析，请运行:");
+  report.push('     roy-agent act "整理测试任务" --agent task-organizer');
+  if (shouldExecute) {
+    let count = 0;
+    for (const task of matched) {
+      try {
+        await store.deleteTask(task.id);
+        report.push("  ✅ 已删除: #" + task.id + " - " + task.title);
+        count++;
+      } catch (err) {
+        report.push("  ❌ 删除失败: #" + task.id + " - " + err.message);
+      }
+    }
+    report.push("  共删除 " + count + " 个测试任务");
+  }
+}
+async function handleAggregate(store, allTasks, shouldExecute, report) {
+  function sim(a, b) {
+    const s1 = new Set(a.toLowerCase().split(/[\s_-]+/));
+    const s2 = new Set(b.toLowerCase().split(/[\s_-]+/));
+    const inter = new Set([...s1].filter((w) => s2.has(w)));
+    const union = new Set([...s1, ...s2]);
+    return inter.size / union.size;
+  }
+  const visited = new Set;
+  const groups = [];
+  const THRESHOLD = 0.7;
+  for (let i = 0;i < allTasks.length; i++) {
+    if (visited.has(allTasks[i].id))
+      continue;
+    const group = [allTasks[i]];
+    visited.add(allTasks[i].id);
+    for (let j = i + 1;j < allTasks.length; j++) {
+      if (visited.has(allTasks[j].id))
+        continue;
+      if (sim(allTasks[i].title, allTasks[j].title) >= THRESHOLD) {
+        group.push(allTasks[j]);
+        visited.add(allTasks[j].id);
+      }
+    }
+    if (group.length > 1)
+      groups.push(group);
+  }
+  if (groups.length === 0) {
+    report.push("未发现相似任务");
+    return;
+  }
+  report.push("发现 " + groups.length + " 组相似任务:");
+  for (const g of groups) {
+    report.push("  组:");
+    for (const t of g)
+      report.push("    - #" + t.id + ": " + t.title);
+    if (shouldExecute) {
+      const tagName = "group:" + g[0].title.slice(0, 20).replace(/[\s_-]+/g, "-").toLowerCase();
+      for (const t of g) {
+        const currentTags = t.tags || [];
+        if (!currentTags.includes(tagName)) {
+          await store.updateTask(t.id, { tags: [...currentTags, tagName] });
+        }
+      }
+      report.push("    -> 添加关联标签: " + tagName);
+    }
+  }
+}
+async function handleBuildTree(store, allTasks, shouldExecute, report) {
+  const rootTasks = allTasks.filter((t) => !t.parent_task_id);
+  if (rootTasks.length === 0) {
+    report.push("所有任务已有父任务");
+    return;
+  }
+  const stopWords = new Set(["test", "测试", "task", "任务", "add", "create", "fix"]);
+  const groups = new Map;
+  for (const task of rootTasks) {
+    const words = task.title.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fa5]/g, " ").split(/\s+/).filter(Boolean);
+    const topicWords = words.filter((w) => !stopWords.has(w)).slice(0, 2);
+    const topic = topicWords.join("-") || words[0] || "未分类";
+    if (!groups.has(topic))
+      groups.set(topic, []);
+    groups.get(topic).push(task);
+  }
+  const toBuild = [...groups.entries()].filter(([, tasks]) => tasks.length >= 2);
+  if (toBuild.length === 0) {
+    report.push("没有需要构建父任务的主题组");
+    return;
+  }
+  report.push("将为 " + toBuild.length + " 个主题组创建父任务:");
+  for (const [topic, tasks] of toBuild) {
+    const types = tasks.map((t) => t.type);
+    const allCycle = types.every((t) => t === "cycle");
+    const hasLongterm = types.some((t) => t === "longterm");
+    let parentType = "normal";
+    if (allCycle)
+      parentType = "cycle";
+    else if (hasLongterm)
+      parentType = "longterm";
+    const parentTitle = "[" + topic.toUpperCase() + "] " + topic + "相关工作";
+    report.push("  \uD83D\uDCC2 主题: " + topic + " -> 父任务: " + parentTitle + " (" + parentType + ")");
+    for (const t of tasks)
+      report.push("     - #" + t.id + ": " + t.title);
+    if (shouldExecute) {
+      try {
+        const parentTask = await store.createTask({
+          title: parentTitle,
+          description: "自动创建，聚合 " + tasks.length + ' 个 "' + topic + '" 相关子任务',
+          type: parentType,
+          priority: "medium",
+          sessionId: "cli-organize",
+          project_path: "organize",
+          context: JSON.stringify({ type: "organize-auto", topic })
+        });
+        for (const t of tasks) {
+          await store.updateTask(t.id, { parent_task_id: parentTask.id });
+        }
+        report.push("     ✅ 已创建父任务 #" + parentTask.id);
+      } catch (err) {
+        report.push("     ❌ 创建失败: " + err.message);
+      }
+    }
+  }
+}
+var handler = async (args) => {
+  console.log("\uD83D\uDD0D Task Organizer");
+  const { getDefaultTaskDbPath, SQLiteTaskStore } = await import("@ai-setting/roy-agent-core");
+  const store = new SQLiteTaskStore(getDefaultTaskDbPath());
+  await store.initialize?.();
+  const allTasks = await store.listTasks({ limit: 9999 });
+  console.log(`
+\uD83D\uDCCA 系统中共有 ` + allTasks.length + ` 个任务
+`);
+  const report = [];
+  if (args.deleteTest || args.auto) {
+    await handleDeleteTest(store, allTasks, !args.dryRun, report);
+  }
+  if (args.aggregate || args.auto) {
+    await handleAggregate(store, allTasks, !args.dryRun, report);
+  }
+  if (args.buildTree || args.auto) {
+    await handleBuildTree(store, allTasks, !args.dryRun, report);
+  }
+  console.log(`
+` + "=".repeat(60));
+  console.log("\uD83D\uDCCB 整理报告");
+  console.log("=".repeat(60));
+  if (report.length === 0) {
+    console.log("  ✨ 未指定整理策略。请使用以下选项：");
+    console.log("     --delete-test    用 AI 清理测试任务");
+    console.log("     --aggregate      聚合相似任务");
+    console.log("     --build-tree     构建任务树");
+    console.log("     --auto           全自动执行所有策略");
+    console.log("     --dry-run        试运行预览");
+  } else {
+    console.log(report.join(`
+`));
+  }
+  console.log("=".repeat(60));
+  if (args.dryRun) {
+    console.log(`
+✨ 提示：去掉 --dry-run 参数执行实际整理操作`);
+  }
+  store.close();
+};
+
 // src/commands/tasks/index.ts
+var OrganizeCommand = {
+  command,
+  describe: desc,
+  builder,
+  handler
+};
 var TasksCommand = {
   command: "tasks",
   describe: "任务管理 - 创建、追踪、管理任务",
@@ -12126,7 +12374,7 @@ var TasksCommand = {
     array: true,
     description: "Enable plugin (e.g., --plugin task-tag)",
     global: false
-  }).command(ListCommand2).command(GetCommand2).command(CreateCommand).command(UpdateCommand).command(DeleteCommand2).command(CompleteCommand).command(OperationsCommand).demandCommand().help(),
+  }).command(ListCommand2).command(GetCommand2).command(CreateCommand).command(UpdateCommand).command(DeleteCommand2).command(CompleteCommand).command(OperationsCommand).command(OrganizeCommand).demandCommand().help(),
   handler: () => {
     console.log("Use 'roy-agent tasks --help' for usage information");
   }
@@ -12203,10 +12451,10 @@ var ListCommand3 = {
           }
         };
         const rows = filtered.map((s) => {
-          const desc = s.description.length > 50 ? s.description.slice(0, 47) + "..." : s.description;
+          const desc2 = s.description.length > 50 ? s.description.slice(0, 47) + "..." : s.description;
           return [
             chalk23.cyan(s.name),
-            desc,
+            desc2,
             sourceColor(s.source)(`[${s.source}]`)
           ].join(" | ");
         });
@@ -12361,10 +12609,10 @@ var SearchCommand = {
         const rows = results.map((s) => {
           const matchedIn = s.name.toLowerCase().includes(term) ? "name" : "description";
           const matchColor = matchedIn === "name" ? chalk25.green : chalk25.blue;
-          const desc = s.description.length > 40 ? s.description.slice(0, 37) + "..." : s.description;
+          const desc2 = s.description.length > 40 ? s.description.slice(0, 37) + "..." : s.description;
           return [
             chalk25.cyan(s.name),
-            desc,
+            desc2,
             matchColor(`[${matchedIn}]`)
           ].join(" | ");
         });
@@ -12580,13 +12828,13 @@ var ListCommand4 = {
           return chalk28.blue;
         };
         const rows = agents.map((a) => {
-          const desc = (a.description || "").length > 40 ? (a.description || "").slice(0, 37) + "..." : a.description || "-";
+          const desc2 = (a.description || "").length > 40 ? (a.description || "").slice(0, 37) + "..." : a.description || "-";
           const workflowDisplay = a.type === "workflow" && a.workflow ? chalk28.cyan(a.workflow.length > 30 ? a.workflow.slice(0, 27) + "..." : a.workflow) : chalk28.gray("-");
           return [
             chalk28.cyan(a.name),
             typeColor(a.type)(a.type),
             workflowDisplay,
-            desc
+            desc2
           ].join(" | ");
         });
         if (rows.length === 0) {
@@ -13300,8 +13548,8 @@ function formatCommandsTable(commands) {
   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 desc2 = truncateVisual(cmd.description || "-", DESC_WIDTH);
+    return `${name}${GAP}${source}${GAP}${desc2}`;
   };
   const rows = commands.map(formatRow);
   return [headerLine, sepLine, ...rows].join(`
@@ -14008,8 +14256,8 @@ function showHelp(output) {
   output.log(`  ${chalk42.cyan("-s, --sources")}  只显示配置源`);
   output.log("");
   output.log(chalk42.bold("Examples:"));
-  for (const { command, description } of USAGE_COMMANDS) {
-    output.log(`  ${chalk42.cyan(command.padEnd(40))} ${chalk42.gray(description)}`);
+  for (const { command: command2, description } of USAGE_COMMANDS) {
+    output.log(`  ${chalk42.cyan(command2.padEnd(40))} ${chalk42.gray(description)}`);
   }
 }
 async function showAllComponents(output, configService) {
@@ -14523,9 +14771,9 @@ var ToolsCommand = {
           output.log(chalk46.bold.cyan(`
 [${serverName}] ${serverTools.length} tools`));
           for (const tool of serverTools) {
-            const desc = tool.description.length > 80 ? tool.description.slice(0, 77) + "..." : tool.description;
+            const desc2 = tool.description.length > 80 ? tool.description.slice(0, 77) + "..." : tool.description;
             output.log(`  ${chalk46.green("+")} ${chalk46.white(tool.name)}`);
-            output.log(`    ${chalk46.gray(desc)}`);
+            output.log(`    ${chalk46.gray(desc2)}`);
           }
         }
         output.log(chalk46.gray(`
@@ -14645,10 +14893,10 @@ var ListCommand7 = {
           chalk48.bold("Category")
         ].join(" | ");
         const rows = tools.map((t) => {
-          const desc = t.description.length > 40 ? t.description.slice(0, 37) + "..." : t.description;
+          const desc2 = t.description.length > 40 ? t.description.slice(0, 37) + "..." : t.description;
           return [
             chalk48.cyan(t.name),
-            desc,
+            desc2,
             t.metadata?.category ? chalk48.gray(`[${t.metadata.category}]`) : "-"
           ].join(" | ");
         });
@@ -17327,6 +17575,7 @@ var WorkflowGetCommand = {
 import chalk62 from "chalk";
 import fs4 from "fs";
 import path7 from "path";
+import { parseWorkflowFile } from "@ai-setting/roy-agent-core/env/workflow/types";
 var WorkflowUpdateCommand = {
   command: "update <name>",
   describe: "更新已存在的 Workflow",
@@ -17390,7 +17639,7 @@ var WorkflowUpdateCommand = {
           process.exit(1);
         }
         const content = fs4.readFileSync(filePath, "utf-8");
-        const { definition } = await workflowComponent.parseWorkflowFile(content, filePath);
+        const { definition } = await parseWorkflowFile(content, filePath);
         updates.definition = definition;
       }
       const tags = a.tags ? a.tags.split(",").map((t) => t.trim()) : undefined;
@@ -18212,8 +18461,8 @@ function renderNodeTypesTable(nodes) {
   for (const node of nodes) {
     const type = node.type.padEnd(10);
     const name = node.name.padEnd(18);
-    const desc = node.description.substring(0, 59).padEnd(59);
-    lines.push(`│ ${type} │ ${name} │ ${desc} │`);
+    const desc2 = node.description.substring(0, 59).padEnd(59);
+    lines.push(`│ ${type} │ ${name} │ ${desc2} │`);
   }
   lines.push("└────────────┴────────────────────┴─────────────────────────────────────────────────────────────┘");
   return lines.join(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-cli",
-  "version": "1.5.49",
+  "version": "1.5.50",
   "type": "module",
   "description": "CLI for roy-agent - Non-interactive command execution",
   "main": "./dist/index.js",
@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "@ai-setting/roy-agent-coder-harness": "^1.5.46",
-    "@ai-setting/roy-agent-core": "^1.5.48",
+    "@ai-setting/roy-agent-core": "^1.5.49",
     "@ai-setting/roy-agent-ontology-harness": "^1.5.47",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",