@ai-setting/roy-agent-core 1.6.15 → 1.6.17

package/dist/env/agent/index.js

@@ -2,12 +2,12 @@ import {
   AgentComponent,
   AgentComponentConfigSchema,
   SummaryAgent
-} from "../../shared/@ai-setting/roy-agent-core-rmesvpff.js";
+} from "../../shared/@ai-setting/roy-agent-core-edbhy767.js";
 import"../../shared/@ai-setting/roy-agent-core-8n0e62y4.js";
-import"../../shared/@ai-setting/roy-agent-core-b8wn8yhk.js";
+import"../../shared/@ai-setting/roy-agent-core-eskgj8nc.js";
 import"../../shared/@ai-setting/roy-agent-core-ataagh3a.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-mmnac1s6.js";
+import"../../shared/@ai-setting/roy-agent-core-tycbpm17.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../../shared/@ai-setting/roy-agent-core-7r72622v.js";

package/dist/env/event-source/index.js

@@ -11,7 +11,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-wq98qf5y.js";
+} from "../../shared/@ai-setting/roy-agent-core-bsxgrqzq.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -22,13 +22,13 @@ import {
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-ds5f75pg.js";
 import"../../shared/@ai-setting/roy-agent-core-1qjgwjjs.js";
-import"../../shared/@ai-setting/roy-agent-core-1ecgh5ya.js";
+import"../../shared/@ai-setting/roy-agent-core-yqxrekhg.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-1mrc9a1r.js";
 import"../../shared/@ai-setting/roy-agent-core-bq1gskrf.js";
 import"../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-apz6v22z.js";
+import"../../shared/@ai-setting/roy-agent-core-pq1q854s.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-akb8mb9v.js";

package/dist/env/index.js

@@ -1,11 +1,11 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-x7sc21ek.js";
+} from "../shared/@ai-setting/roy-agent-core-dnns0v64.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-wq98qf5y.js";
+} from "../shared/@ai-setting/roy-agent-core-bsxgrqzq.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -17,7 +17,7 @@ import"../shared/@ai-setting/roy-agent-core-1qjgwjjs.js";
 import {
   PluginComponent
 } from "../shared/@ai-setting/roy-agent-core-gc75v3px.js";
-import"../shared/@ai-setting/roy-agent-core-1ecgh5ya.js";
+import"../shared/@ai-setting/roy-agent-core-yqxrekhg.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
@@ -41,22 +41,22 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-rmesvpff.js";
+} from "../shared/@ai-setting/roy-agent-core-edbhy767.js";
 import"../shared/@ai-setting/roy-agent-core-8n0e62y4.js";
-import"../shared/@ai-setting/roy-agent-core-b8wn8yhk.js";
+import"../shared/@ai-setting/roy-agent-core-eskgj8nc.js";
 import"../shared/@ai-setting/roy-agent-core-ataagh3a.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-9jsfqc1m.js";
+} from "../shared/@ai-setting/roy-agent-core-m134hen4.js";
 import"../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-1380b0re.js";
-import"../shared/@ai-setting/roy-agent-core-eaj0b1hm.js";
+import"../shared/@ai-setting/roy-agent-core-4cgkj7v0.js";
+import"../shared/@ai-setting/roy-agent-core-44g3synv.js";
 import"../shared/@ai-setting/roy-agent-core-zdzkzx5g.js";
-import"../shared/@ai-setting/roy-agent-core-apz6v22z.js";
+import"../shared/@ai-setting/roy-agent-core-pq1q854s.js";
 import"../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../shared/@ai-setting/roy-agent-core-mmnac1s6.js";
+import"../shared/@ai-setting/roy-agent-core-tycbpm17.js";
 import {
   XDG_PATHS,
   getXDGPath,

package/dist/env/prompt/index.js

@@ -3,8 +3,8 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-0rwymn7m.js";
-import"../../shared/@ai-setting/roy-agent-core-apz6v22z.js";
+} from "../../shared/@ai-setting/roy-agent-core-cfqm5w9b.js";
+import"../../shared/@ai-setting/roy-agent-core-pq1q854s.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-akb8mb9v.js";

package/dist/env/task/delegate/index.js

@@ -3,11 +3,11 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-1380b0re.js";
-import"../../../shared/@ai-setting/roy-agent-core-eaj0b1hm.js";
-import"../../../shared/@ai-setting/roy-agent-core-apz6v22z.js";
+} from "../../../shared/@ai-setting/roy-agent-core-4cgkj7v0.js";
+import"../../../shared/@ai-setting/roy-agent-core-44g3synv.js";
+import"../../../shared/@ai-setting/roy-agent-core-pq1q854s.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../../shared/@ai-setting/roy-agent-core-mmnac1s6.js";
+import"../../../shared/@ai-setting/roy-agent-core-tycbpm17.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-vc7p80sd.js";

package/dist/env/task/index.js

@@ -5,20 +5,20 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-9jsfqc1m.js";
+} from "../../shared/@ai-setting/roy-agent-core-m134hen4.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-1380b0re.js";
-import"../../shared/@ai-setting/roy-agent-core-eaj0b1hm.js";
+import"../../shared/@ai-setting/roy-agent-core-4cgkj7v0.js";
+import"../../shared/@ai-setting/roy-agent-core-44g3synv.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "../../shared/@ai-setting/roy-agent-core-zdzkzx5g.js";
-import"../../shared/@ai-setting/roy-agent-core-apz6v22z.js";
+import"../../shared/@ai-setting/roy-agent-core-pq1q854s.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../shared/@ai-setting/roy-agent-core-mmnac1s6.js";
+import"../../shared/@ai-setting/roy-agent-core-tycbpm17.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-r0t34bbh.js";
 import"../../shared/@ai-setting/roy-agent-core-rn57psp0.js";

package/dist/env/task/plugins/index.js

@@ -8,13 +8,13 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-1ecgh5ya.js";
+} from "../../../shared/@ai-setting/roy-agent-core-yqxrekhg.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../../shared/@ai-setting/roy-agent-core-1mrc9a1r.js";
 import"../../../shared/@ai-setting/roy-agent-core-bq1gskrf.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../../shared/@ai-setting/roy-agent-core-apz6v22z.js";
+import"../../../shared/@ai-setting/roy-agent-core-pq1q854s.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-sqt96sam.js";
 import"../../../shared/@ai-setting/roy-agent-core-dtkbj8fk.js";

package/dist/env/tool/built-in/index.js

@@ -8,7 +8,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../../shared/@ai-setting/roy-agent-core-vkesx61c.js";
+} from "../../../shared/@ai-setting/roy-agent-core-e9jf4w3z.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
@@ -19,7 +19,7 @@ import {
   createQueryBackgroundProcessTool,
   queryBackgroundProcessTool
 } from "../../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
-import"../../../shared/@ai-setting/roy-agent-core-eaj0b1hm.js";
+import"../../../shared/@ai-setting/roy-agent-core-44g3synv.js";
 import"../../../shared/@ai-setting/roy-agent-core-96mj6gvc.js";
 import"../../../shared/@ai-setting/roy-agent-core-nna4s0qs.js";
 import"../../../shared/@ai-setting/roy-agent-core-m00kamqp.js";

package/dist/env/tool/index.js

@@ -9,7 +9,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../shared/@ai-setting/roy-agent-core-vkesx61c.js";
+} from "../../shared/@ai-setting/roy-agent-core-e9jf4w3z.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
@@ -22,11 +22,11 @@ import {
   ToolValidator,
   getMaxOutputSize,
   setToolConfigComponent
-} from "../../shared/@ai-setting/roy-agent-core-b8wn8yhk.js";
+} from "../../shared/@ai-setting/roy-agent-core-eskgj8nc.js";
 import"../../shared/@ai-setting/roy-agent-core-ataagh3a.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
-import"../../shared/@ai-setting/roy-agent-core-eaj0b1hm.js";
+import"../../shared/@ai-setting/roy-agent-core-44g3synv.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-akb8mb9v.js";
 import"../../shared/@ai-setting/roy-agent-core-02aw62bv.js";

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   PromptComponent,
   PromptStore
-} from "./shared/@ai-setting/roy-agent-core-0rwymn7m.js";
+} from "./shared/@ai-setting/roy-agent-core-cfqm5w9b.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -27,7 +27,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "./shared/@ai-setting/roy-agent-core-vkesx61c.js";
+} from "./shared/@ai-setting/roy-agent-core-e9jf4w3z.js";
 import {
   ATTACH_FILE_MAX_BYTES,
   getUnderstandImageLLMProvider,
@@ -63,7 +63,7 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-x7sc21ek.js";
+} from "./shared/@ai-setting/roy-agent-core-dnns0v64.js";
 import {
   BountyIMInstance,
   EventSourceComponent,
@@ -76,7 +76,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-wq98qf5y.js";
+} from "./shared/@ai-setting/roy-agent-core-bsxgrqzq.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -96,7 +96,7 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-1ecgh5ya.js";
+} from "./shared/@ai-setting/roy-agent-core-yqxrekhg.js";
 import {
   BasePlugin
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
@@ -131,7 +131,7 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-rmesvpff.js";
+} from "./shared/@ai-setting/roy-agent-core-edbhy767.js";
 import {
   createInvokeConfig,
   invoke,
@@ -142,7 +142,7 @@ import {
   ToolComponent,
   ToolRegistry,
   ToolValidator
-} from "./shared/@ai-setting/roy-agent-core-b8wn8yhk.js";
+} from "./shared/@ai-setting/roy-agent-core-eskgj8nc.js";
 import"./shared/@ai-setting/roy-agent-core-ataagh3a.js";
 import {
   AskUserError,
@@ -150,11 +150,11 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-9jsfqc1m.js";
+} from "./shared/@ai-setting/roy-agent-core-m134hen4.js";
 import"./shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-1380b0re.js";
-import"./shared/@ai-setting/roy-agent-core-eaj0b1hm.js";
+import"./shared/@ai-setting/roy-agent-core-4cgkj7v0.js";
+import"./shared/@ai-setting/roy-agent-core-44g3synv.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
@@ -162,11 +162,11 @@ import {
 import {
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-apz6v22z.js";
+} from "./shared/@ai-setting/roy-agent-core-pq1q854s.js";
 import"./shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import {
   AgentRegistry
-} from "./shared/@ai-setting/roy-agent-core-mmnac1s6.js";
+} from "./shared/@ai-setting/roy-agent-core-tycbpm17.js";
 import {
   XDG_PATHS,
   getXDGPath,

package/dist/shared/@ai-setting/{roy-agent-core-eaj0b1hm.js → roy-agent-core-44g3synv.js}

@@ -2,28 +2,34 @@ import {
   createLogger,
   init_logger
 } from "./roy-agent-core-nna4s0qs.js";
+import {
+  __require
+} from "./roy-agent-core-fs0mn2jk.js";
 
 // src/env/task/delegate/process-registry.ts
 import { AsyncLocalStorage } from "async_hooks";
 
 // src/util/process/process-tree-killer.ts
 init_logger();
-import {
-  spawn as _childProcessSpawn,
-  spawnSync as _childProcessSpawnSync
-} from "child_process";
 var logger = createLogger("process-tree-killer");
+function getChildProcess() {
+  return __require("child_process");
+}
 var spawnInjector;
 function spawn(cmd, args, opts) {
   if (spawnInjector)
     return spawnInjector(cmd, args, opts);
-  return _childProcessSpawn(cmd, args, opts);
+  return getChildProcess().spawn(cmd, args, opts);
 }
 var spawnSyncInjector;
 function spawnSyncFn(cmd, args, opts) {
   if (spawnSyncInjector)
     return spawnSyncInjector(cmd, args, opts);
-  return _childProcessSpawnSync(cmd, args, opts);
+  const cp = getChildProcess();
+  if (typeof cp.spawnSync !== "function") {
+    return;
+  }
+  return cp.spawnSync(cmd, args, opts);
 }
 var platformOverride;
 function currentPlatform() {
@@ -43,12 +49,14 @@ function isProcessAlivePosix(pid) {
 }
 function isProcessAliveWindows(pid) {
   try {
-    const { stdout } = spawnSyncFn("tasklist", ["/fi", `PID eq ${pid}`, "/nh"], {
+    const result = spawnSyncFn("tasklist", ["/fi", `PID eq ${pid}`, "/nh"], {
       stdio: ["ignore", "pipe", "ignore"],
       windowsHide: true,
       timeout: 3000
     });
-    return stdout.toString().includes(String(pid));
+    if (!result)
+      return true;
+    return result.stdout.toString().includes(String(pid));
   } catch {
     return true;
   }

package/dist/shared/@ai-setting/{roy-agent-core-1380b0re.js → roy-agent-core-4cgkj7v0.js}

@@ -1,16 +1,16 @@
 import {
   ProcessRegistry,
   runWithProcessRegistryAsync
-} from "./roy-agent-core-eaj0b1hm.js";
+} from "./roy-agent-core-44g3synv.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-apz6v22z.js";
+} from "./roy-agent-core-pq1q854s.js";
 import {
   runWithBgTaskIdAsync
 } from "./roy-agent-core-c1v263jn.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
-} from "./roy-agent-core-mmnac1s6.js";
+} from "./roy-agent-core-tycbpm17.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";

package/dist/shared/@ai-setting/{roy-agent-core-wq98qf5y.js → roy-agent-core-bsxgrqzq.js}

@@ -1,7 +1,7 @@
 import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook
-} from "./roy-agent-core-1ecgh5ya.js";
+} from "./roy-agent-core-yqxrekhg.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";

package/dist/shared/@ai-setting/{roy-agent-core-0rwymn7m.js → roy-agent-core-cfqm5w9b.js}

@@ -1,6 +1,6 @@
 import {
   builtInPrompts
-} from "./roy-agent-core-apz6v22z.js";
+} from "./roy-agent-core-pq1q854s.js";
 import {
   getXDGPath
 } from "./roy-agent-core-qxnbvgwe.js";

package/dist/shared/@ai-setting/{roy-agent-core-x7sc21ek.js → roy-agent-core-dnns0v64.js}

@@ -1,6 +1,6 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-1ecgh5ya.js";
+} from "./roy-agent-core-yqxrekhg.js";
 import {
   ContextError,
   ErrorCodes

package/dist/shared/@ai-setting/{roy-agent-core-vkesx61c.js → roy-agent-core-e9jf4w3z.js}

@@ -7,7 +7,7 @@ import {
 import {
   getCurrentProcessRegistry,
   killProcessTree
-} from "./roy-agent-core-eaj0b1hm.js";
+} from "./roy-agent-core-44g3synv.js";
 import {
   init_decorator,
   wrapFunction

package/dist/shared/@ai-setting/{roy-agent-core-rmesvpff.js → roy-agent-core-edbhy767.js}

@@ -3,14 +3,14 @@ import {
 } from "./roy-agent-core-8n0e62y4.js";
 import {
   truncateOutputInline
-} from "./roy-agent-core-b8wn8yhk.js";
+} from "./roy-agent-core-eskgj8nc.js";
 import {
   AskUserError,
   init_workflow_hil
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-mmnac1s6.js";
+} from "./roy-agent-core-tycbpm17.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";
@@ -363,6 +363,8 @@ class AgentComponent extends BaseComponent {
       logger.info(`[AgentComponent] Loaded ${loadedCount} agents from config directory`);
       this.registry.registerWorkflowRunner();
       logger.info("[AgentComponent] Registered built-in workflow-runner");
+      this.registry.registerTaskOrganizer();
+      logger.info("[AgentComponent] Registered built-in task-organizer");
       this.registry.registerJsonExtractAgent();
       logger.info("[AgentComponent] Registered built-in json-extract agent");
       this.registry.registerWorkflowCreator();

package/dist/shared/@ai-setting/{roy-agent-core-9jsfqc1m.js → roy-agent-core-m134hen4.js}

@@ -8,7 +8,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-1380b0re.js";
+} from "./roy-agent-core-4cgkj7v0.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

package/dist/shared/@ai-setting/{roy-agent-core-apz6v22z.js → roy-agent-core-pq1q854s.js}

@@ -1565,7 +1565,253 @@ outputs: []                        # 输出定义（可空）
 - ❌ 不要 \`delegate_task\` / \`stop_task\`（deniedTools 已禁，禁止递归委托）
 - ❌ 不要跳过 \`workflow_validate\`
 - ❌ 不要自动 merge / push / tag
-- ❌ 不要硬编码大段 text（应引用 \`{{input.x}}\` 模板）`
+- ❌ 不要硬编码大段 text（应引用 \`{{input.x}}\` 模板）`,
+  "task-organizer": `# Task Organizer（任务整理助手）
+
+## 你的身份
+
+你是 Roy 系统的 **task-organizer** 子代理（type=sub），专门负责**维护任务树形态健康**。
+其它 agent 在创建任务时遵循"先 \`task_tree({depth: 1})\` 再 \`task_create({parent_task_id: ...})\`"
+的强约束（参考 roy prompt 的 Task Tree Hygiene 章节）；你的职责是**事后巡检 + 整理 + 修复**：
+把已存在的脏树（孤儿 / 重复 / 根任务膨胀）还原到健康的 tree shape。
+
+- **名称**: task-organizer
+- **角色**: 任务树整理专家（re-parent / merge / archive / delete）
+- **输入**: 用户指令（"整理任务"、"收敛根任务"、"归档测试任务"、"合并重复任务"等）
+- **输出**: 结构化 JSON 报告 + 操作记录（操作前 dry-run，重要操作通过 \`task_operation_create\` 记录原因）
+
+---
+
+## \uD83C\uDF32 树形健康目标（铁律）
+
+| 指标 | 目标 | 说明 |
+|------|------|------|
+| **非归档根任务数量** | **10-20** | 根任务膨胀 = 任务空间失控 |
+| **根任务类型分布** | **100% longterm** | 根任务 = 长期愿景/方向，不能是 normal/cycle |
+| **最大深度** | **≤ 5** | 过深 = 必须上提 / 重新组织 |
+| **每个父任务子节点数** | **≤ 50** | 超过 = 拆分子父任务 |
+| **孤儿率** | **< 5%** | 孤儿 = 无 parent 且无明确主题的根任务 |
+
+> 核心原则：**根任务越少、longterm 化越彻底，任务空间越能反映用户的长期愿景和方向。**
+> \`task_tree --depth=N\` 是你观察树形是否健康的主要工具，要养成**多颗粒度**查看的习惯。
+
+### Hard Rules（自动触发）
+
+- 根任务 **> 20 个** = **必须** 合并 / re-parent / 归档
+- 根任务 **不是 longterm** = **必须** re-parent 到任务树中语义最匹配的有意义祖先节点下
+  （不一定是 longterm 根；可以是 longterm 根下的子/孙任务；如果实在找不到合适的 longterm 域，
+  可以创建一个新的 longterm 父任务来容纳，但**禁止无脑新建根**）
+- 根任务 **> 5 层深度** = **必须** 上提 / 重新组织
+- 重复任务（相似 title + tags）= **合并**（保留最新 + operations 合并）
+
+---
+
+## \uD83C\uDFAF 核心目标：把根任务收敛到 10-20 个 longterm 根，并把散落的非 longterm 根挂到任务树中最合适的位置
+
+你的最重要工作是**把当前脏树的根任务重新挂载到任务树中语义最匹配的有意义祖先节点下（不一定是 longterm 根）**，使得：
+
+\`\`\`
+\uD83C\uDF33 健康的 Roy 任务树
+├── [Longterm] A 方向（根 #100）
+│   ├── normal 子任务 #101
+│   ├── normal 子任务 #102
+│   └── cycle  子任务 #103
+├── [Longterm] B 方向（根 #200）
+│   ├── normal 子任务 #201
+│   └── ...
+├── [Longterm] C 方向（根 #300）
+...
+└── [Longterm] T 方向（根 #900）  ← 10-20 个 longterm 根
+\`\`\`
+
+而不是：
+
+\`\`\`
+❌ 失控的任务树
+├── normal 根 #1  ← 应挂到 longterm
+├── normal 根 #2  ← 应挂到 longterm
+├── cycle  根 #3  ← 应挂到 longterm
+├── normal 根 #4  ← 应挂到 longterm
+... 60+ 根 ...
+\`\`\`
+
+> 注意：散落任务的挂载目标**不一定是 longterm 根**，可以是 longterm 根下任意深度的子/孙任务
+> （沿树找语义最匹配节点）。例如下面的孙任务挂载场景：
+>
+> \`\`\`
+> \uD83C\uDF33 真实的 Roy 任务树（多深度挂载示例）
+> └── [Longterm] Roy 系统（根 #100）
+>     ├── [Longterm] core 包
+>     │   ├── [Longterm] agent-component 模块
+>     │   │   └── [Normal] 修复 ask_user 工具超时 bug  ← ✅ 散落任务挂这里（孙任务）
+>     │   └── [Longterm] tool-component 模块
+>     │       └── [Normal] 新增 ask_user 多模态输入支持
+>     └── [Longterm] cli 包
+>         └── [Normal] roy-agent 二进制发布流程优化
+> \`\`\`
+
+---
+
+## \uD83D\uDEE0 你的工具（白名单）
+
+你只能用以下工具，**没有 bash / edit_file / 写文件的能力**：
+
+| 工具 | 用途 |
+|------|------|
+| \`task_search\` | 关键词搜索（title/description/goals/tags/operations） |
+| \`task_list\` | 按 status/priority/type/depth 列出任务 |
+| \`task_get\` | 查看任务详情（含 operations） |
+| \`task_tree\` | **关键工具** — 多颗粒度观察任务树 |
+| \`task_operation_list\` | 查看任务的操作记录 |
+| \`task_create\` | **必要时** 创建新的 longterm 父任务来容纳非 longterm 根 |
+| \`task_update\` | **关键工具** — 改 \`parent_task_id\`（re-parent）、\`type\`、\`status\` 等 |
+| \`task_complete\` | 标记 normal 任务完成（仅 normal） |
+| \`task_batch_archive\` | 批量归档（已完成 + 历史价值） |
+| \`task_batch_delete\` | 批量删除（测试/垃圾/重复） |
+| \`task_delete\` | 单个删除 |
+| \`task_operation_create\` | 记录批量操作原因（**强烈推荐**） |
+
+> ⚠️ **没有 bash 工具** — 你无法执行 shell 命令。所有工作都只能通过任务管理工具完成。
+
+---
+
+## \uD83D\uDCCB 整理工作流（按顺序执行）
+
+### 第 1 步：观察树形
+
+\`\`\`bash
+# 1.1 看根任务全景
+task_tree({depth: 0})
+
+# 1.2 看二级树
+task_tree({depth: 2})
+
+# 1.3 看所有 longterm 根（attach 目标池）
+task_list({ type: "longterm", status: "active" })
+
+# 1.4 看所有非归档根任务
+task_list({ depth: 0, include_archived: false })
+\`\`\`
+
+记录：当前 root count / max depth / 类型分布 / 是否有明显的非 longterm 根。
+
+### 第 2 步：分类非 longterm 根
+
+对每个根任务，分类：
+
+- **正常 longterm 根**：跳过
+- **normal 根**：需要 re-parent 到匹配的 longterm 父任务
+- **cycle 根**：需要 re-parent 到匹配的 longterm 父任务（除非它本身就是 longterm 级的周期工作）
+- **纯测试/临时根**：批量归档或删除
+- **重复根**：合并
+
+### 第 3 步：Re-parent 非 longterm 根（核心操作）
+
+对每个待 re-parent 的根任务：
+
+1. 用 \`task_get({ task_id: N })\` 读详情，理解语义
+2. 用 \`task_list({ type: "longterm" })\` 找到 longterm 根（attach 目标池的顶层）
+3. 用 \`task_tree --depth=3\` 或更深的搜索找到 longterm 根下所有子/孙任务（attach 目标池的深层）
+4. 综合 2+3 的结果，按"**挂得深但语义匹配**"优先原则选定 attach 目标
+5. 用 \`task_update({ task_id: N, parent_task_id: <matching_id> })\` 重新挂载
+6. 用 \`task_operation_create\` 记录原因（"Re-parented normal root #N to #M (semantic match: ..., depth: X)")
+
+**匹配 attach 目标的优先级**（沿 task_tree 自上而下找语义最匹配的有意义祖先）：
+
+1. **现有 longterm 根**（最匹配主题）→ 强优先（避免新增根）
+2. **现有 longterm 根**（次匹配主题）→ 次优
+3. **现有 longterm 根的子/孙任务**（最匹配主题）→ ✅ **完全合法**！
+   例：把"实现 X 模块的某个函数"挂到 longterm 根"Roy 系统" → 子任务"core 包" → 孙任务"agent-component 模块" 下
+4. **现有 longterm 根的子/孙任务**（次匹配主题）→ 兜底
+5. 全部找不到 → **创建新的 longterm 根**（用 \`task_create({ type: "longterm", parent_task_id: null })\`），
+   但**禁止无脑新建** — 至少 2-3 个 normal 根要明显属于同一新主题时才建
+
+**关键原则**：挂载目标**不一定是 longterm 根**，可以是 longterm 根下任意深度的子/孙任务，
+关键是**沿 task_tree 找语义最匹配的有意义节点**。**挂得"深"比挂得"错"好**。
+
+**禁止**：
+- ❌ 不要把不同 longterm 域的孤儿 attach 到错误根
+- ❌ 不要把 normal 根硬塞给不相干的 longterm 父任务
+- ❌ 不要 re-parent 已 completed 的历史任务（破坏历史语义）
+
+**避免子任务过载**：
+挂载前先看 attach 目标已有多少子任务：**超过 20 个时优先往下一层孙任务挂**，避免单父过载。
+如果整个分支都过载，再考虑**新建一个同主题子任务**作为中间层（而不是直接挂到根）。
+
+### 第 4 步：合并重复 / 批量清理
+
+**合并重复**：
+- 保留最新 + 最完善的一条
+- 用 \`task_batch_delete\` 删除副本（reason: "merged into #N"）
+
+**批量清理**：
+- 测试任务（标题含 test/测试/demo/mock/sample/试验）→ \`task_batch_delete\`
+- 已完成 + 历史价值（调研/检索/旧 fix）→ \`task_batch_archive\`
+- 长期未更新（> 30 天 status=active 但无 progress）→ 标记 paused 或 archive
+
+### 第 5 步：报告
+
+输出 JSON 报告：
+
+\`\`\`json
+{
+  "before": { "root_count": 28, "non_longterm_root_count": 15, "max_depth": 7 },
+  "after":  { "root_count": 12, "non_longterm_root_count": 0,  "max_depth": 4 },
+  "reparent": [
+    { "task_id": 1234, "from": null, "to": 2068, "type": "normal", "reason": "matched [Longterm] roy-agent 开源" }
+  ],
+  "merge":   [{ "kept": 100, "deleted": [101, 102], "reason": "duplicate" }],
+  "archive": [{ "task_ids": [8001, 8002], "reason": "completed > 30d" }],
+  "delete":  [{ "task_ids": [9001, 9002], "reason": "test tasks" }],
+  "next_steps": ["建议保留 #N 作为 [Longterm] X 方向的根"]
+}
+\`\`\`
+
+---
+
+## \uD83D\uDEA8 禁止操作
+
+- ❌ **不要**无脑新建根任务（必须确认至少 2-3 个非 longterm 根明显同主题才建）
+- ❌ **不要**修改 longterm 根任务的语义（title / description / goals）
+- ❌ **不要**把不同 longterm 域的根 attach 到错误根
+- ❌ **不要**re-parent 已 completed 的历史任务
+- ❌ **不要**批量操作前不 dry-run
+- ❌ **不要**在没有 \`task_operation_create\` 记录的情况下做批量动作
+
+---
+
+## 类型修正指南
+
+如果发现任务的 \`type\` 与实际情况不符，用 \`task_update({ type: ... })\` 修正：
+
+| 现状 | 应改为 | 判断依据 |
+|------|--------|----------|
+| \`normal\` 但内容明显是周期性的 | → \`cycle\` | 标题含"周报/日报/月报/定期/每日/每周/巡检/备份" |
+| \`normal\` 但描述抽象无明确完成条件 | → \`longterm\` | 愿景类描述，无法一次完成 |
+| \`cycle\` 但只是普通任务 | → \`normal\` | 没有周期性特征 |
+
+---
+
+## 关键双维度记录（批量操作必填）
+
+每次批量操作都必须用 \`task_operation_create\` 留下双维度记录：
+
+- **milestone_type**: \`milestone\`（"我做了什么"）或 \`progress\`（"我推进到 X 状态"）
+- **milestone_title**: 一句话标题（如 "Re-parented 5 non-longterm roots to [Longterm] roy-agent"）
+- **milestone_description**: 详细描述（操作范围、影响）
+- **process_description**: 100-150 字符简要过程
+
+---
+
+## 终止与报告
+
+整理完成后必须输出最终 JSON 报告，然后一句话总结：
+
+> ✅ 任务树整理完成。根任务从 N 收敛到 M（目标 10-20），其中 longterm 占比从 X% 提升到 100%，re-parent/merge/archive/delete 共 K 项。详见 operations。
+
+如果没有任何改动：
+
+> ✅ 任务树形态良好（root=N, depth=X, non_longterm_root=0）。无需操作。`
 };
 var WORKFLOW_EXTRACT_PROMPT = builtInPrompts["workflow-extract"];
 function getBuiltInPromptNames() {

package/dist/shared/@ai-setting/{roy-agent-core-mmnac1s6.js → roy-agent-core-tycbpm17.js}

@@ -172,6 +172,37 @@ class AgentRegistry {
     };
     this.agents.set(name, agent);
   }
+  registerTaskOrganizer() {
+    const name = "task-organizer";
+    if (this.agents.has(name))
+      return;
+    const agent = {
+      name,
+      type: "sub",
+      description: "任务树整理子智能体 — 把非 longterm 类型的根任务重新挂载到 longterm 父任务下，根任务收敛到 10-20 个；维护任务树形态健康（re-parent / merge / archive / delete）。Task #2348。",
+      systemPromptRef: "task-organizer",
+      allowedTools: [
+        "task_create",
+        "task_get",
+        "task_list",
+        "task_update",
+        "task_delete",
+        "task_complete",
+        "task_tree",
+        "task_search",
+        "task_batch_archive",
+        "task_batch_delete",
+        "task_operation_create",
+        "task_operation_get",
+        "task_operation_list",
+        "task_operation_update",
+        "task_operation_delete"
+      ],
+      deniedTools: ["delegate_task", "stop_task"],
+      maxIterations: 30
+    };
+    this.agents.set(name, agent);
+  }
   registerJsonExtractAgent() {
     const name = "json-extract";
     if (this.agents.has(name))
@@ -445,6 +476,13 @@ __legacyDecorateClassTS([
     log: true
   })
 ], AgentRegistry.prototype, "registerWorkflowRunner", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.registry.registerTaskOrganizer", {
+    recordParams: false,
+    recordResult: true,
+    log: true
+  })
+], AgentRegistry.prototype, "registerTaskOrganizer", null);
 __legacyDecorateClassTS([
   TracedAs("agent.registry.registerWorkflowCreator", {
     recordParams: false,

package/dist/shared/@ai-setting/{roy-agent-core-1ecgh5ya.js → roy-agent-core-yqxrekhg.js}

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-1mrc9a1r.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-apz6v22z.js";
+} from "./roy-agent-core-pq1q854s.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.6.15",
+  "version": "1.6.17",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",