@ai-setting/roy-agent-core 1.7.39 → 1.7.41

package/dist/env/agent/index.js

@@ -2,7 +2,7 @@ import {
   AgentComponent,
   AgentComponentConfigSchema,
   SummaryAgent
-} from "../../shared/@ai-setting/roy-agent-core-5exnp10h.js";
+} from "../../shared/@ai-setting/roy-agent-core-p3kp447d.js";
 import"../../shared/@ai-setting/roy-agent-core-jjw7xcxv.js";
 import"../../shared/@ai-setting/roy-agent-core-kzg1jwt8.js";
 import"../../shared/@ai-setting/roy-agent-core-za09t5g3.js";

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

@@ -11,7 +11,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-cazvr63z.js";
+} from "../../shared/@ai-setting/roy-agent-core-wqbpddyr.js";
 import"../../shared/@ai-setting/roy-agent-core-jawzpf5k.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
@@ -22,15 +22,15 @@ import {
   isValidEventSourceType,
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-ck60j1q9.js";
+import"../../shared/@ai-setting/roy-agent-core-zmr3jzpe.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
   resetSharedEventStore,
   setSharedEventStore
 } from "../../shared/@ai-setting/roy-agent-core-xyys5m1a.js";
-import"../../shared/@ai-setting/roy-agent-core-47wrv4ex.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
+import"../../shared/@ai-setting/roy-agent-core-223v204d.js";
 import"../../shared/@ai-setting/roy-agent-core-6vbgswjw.js";
 import"../../shared/@ai-setting/roy-agent-core-tm57tmds.js";
 import"../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";

package/dist/env/index.js

@@ -1,21 +1,21 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-754b0078.js";
+} from "../shared/@ai-setting/roy-agent-core-ncydpb6b.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-6vwf03cz.js";
+} from "../shared/@ai-setting/roy-agent-core-8xgk89y4.js";
 import"../shared/@ai-setting/roy-agent-core-vsrfzaze.js";
 import"../shared/@ai-setting/roy-agent-core-rn57psp0.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-jg8cv1f7.js";
+import"../shared/@ai-setting/roy-agent-core-4m0t4y9w.js";
 import"../shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
 import"../shared/@ai-setting/roy-agent-core-jadrj0bz.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-cazvr63z.js";
+} from "../shared/@ai-setting/roy-agent-core-wqbpddyr.js";
 import"../shared/@ai-setting/roy-agent-core-jawzpf5k.js";
 import {
   EventSourceInitHooks,
@@ -24,10 +24,10 @@ import {
   isValidEventSourceType,
   validateEventSourceConfig
 } from "../shared/@ai-setting/roy-agent-core-ck60j1q9.js";
+import"../shared/@ai-setting/roy-agent-core-zmr3jzpe.js";
 import"../shared/@ai-setting/roy-agent-core-xyys5m1a.js";
-import"../shared/@ai-setting/roy-agent-core-47wrv4ex.js";
 import"../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../shared/@ai-setting/roy-agent-core-skqt40yy.js";
+import"../shared/@ai-setting/roy-agent-core-223v204d.js";
 import {
   WorkflowComponent
 } from "../shared/@ai-setting/roy-agent-core-m3ffkexb.js";
@@ -54,7 +54,7 @@ import"../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-5exnp10h.js";
+} from "../shared/@ai-setting/roy-agent-core-p3kp447d.js";
 import"../shared/@ai-setting/roy-agent-core-jjw7xcxv.js";
 import"../shared/@ai-setting/roy-agent-core-kzg1jwt8.js";
 import"../shared/@ai-setting/roy-agent-core-za09t5g3.js";

package/dist/env/prompt/index.js

@@ -3,8 +3,8 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-krppch0s.js";
-import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
+} from "../../shared/@ai-setting/roy-agent-core-ts56bz5e.js";
+import"../../shared/@ai-setting/roy-agent-core-223v204d.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-9t675te0.js";

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

@@ -3,11 +3,11 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-jg8cv1f7.js";
+} from "../../../shared/@ai-setting/roy-agent-core-4m0t4y9w.js";
 import"../../../shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
 import"../../../shared/@ai-setting/roy-agent-core-xyys5m1a.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
+import"../../../shared/@ai-setting/roy-agent-core-223v204d.js";
 import"../../../shared/@ai-setting/roy-agent-core-za09t5g3.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";

package/dist/env/task/index.js

@@ -5,14 +5,14 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-6vwf03cz.js";
+} from "../../shared/@ai-setting/roy-agent-core-8xgk89y4.js";
 import"../../shared/@ai-setting/roy-agent-core-vsrfzaze.js";
 import"../../shared/@ai-setting/roy-agent-core-rn57psp0.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-jg8cv1f7.js";
+import"../../shared/@ai-setting/roy-agent-core-4m0t4y9w.js";
 import"../../shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
 import {
   SQLiteTaskStore,
@@ -20,7 +20,7 @@ import {
 } from "../../shared/@ai-setting/roy-agent-core-jadrj0bz.js";
 import"../../shared/@ai-setting/roy-agent-core-xyys5m1a.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
+import"../../shared/@ai-setting/roy-agent-core-223v204d.js";
 import"../../shared/@ai-setting/roy-agent-core-za09t5g3.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";

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

@@ -10,9 +10,10 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-47wrv4ex.js";
+} from "../../../shared/@ai-setting/roy-agent-core-zmr3jzpe.js";
+import"../../../shared/@ai-setting/roy-agent-core-xyys5m1a.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
+import"../../../shared/@ai-setting/roy-agent-core-223v204d.js";
 import"../../../shared/@ai-setting/roy-agent-core-6vbgswjw.js";
 import"../../../shared/@ai-setting/roy-agent-core-tm57tmds.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";

package/dist/index.js

@@ -4,7 +4,7 @@ import {
 import {
   PromptComponent,
   PromptStore
-} from "./shared/@ai-setting/roy-agent-core-krppch0s.js";
+} from "./shared/@ai-setting/roy-agent-core-ts56bz5e.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -66,15 +66,15 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-754b0078.js";
+} from "./shared/@ai-setting/roy-agent-core-ncydpb6b.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-6vwf03cz.js";
+} from "./shared/@ai-setting/roy-agent-core-8xgk89y4.js";
 import"./shared/@ai-setting/roy-agent-core-vsrfzaze.js";
 import"./shared/@ai-setting/roy-agent-core-rn57psp0.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-jg8cv1f7.js";
+import"./shared/@ai-setting/roy-agent-core-4m0t4y9w.js";
 import"./shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
 import {
   SQLiteTaskStore,
@@ -92,7 +92,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-cazvr63z.js";
+} from "./shared/@ai-setting/roy-agent-core-wqbpddyr.js";
 import {
   LogTraceComponent,
   LogTraceConfigSchema
@@ -106,23 +106,23 @@ import {
   isValidEventSourceType,
   validateEventSourceConfig
 } from "./shared/@ai-setting/roy-agent-core-ck60j1q9.js";
+import {
+  TaskTagPlugin,
+  createAutoTaskPlugin
+} from "./shared/@ai-setting/roy-agent-core-zmr3jzpe.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
   resetSharedEventStore,
   setSharedEventStore
 } from "./shared/@ai-setting/roy-agent-core-xyys5m1a.js";
-import {
-  TaskTagPlugin,
-  createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-47wrv4ex.js";
 import {
   TaskHookPoints
 } from "./shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import {
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-skqt40yy.js";
+} from "./shared/@ai-setting/roy-agent-core-223v204d.js";
 import {
   WorkflowComponent
 } from "./shared/@ai-setting/roy-agent-core-m3ffkexb.js";
@@ -165,7 +165,7 @@ import {
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-5exnp10h.js";
+} from "./shared/@ai-setting/roy-agent-core-p3kp447d.js";
 import {
   ToolComponent,
   ToolRegistry,

package/dist/shared/@ai-setting/{roy-agent-core-skqt40yy.js → roy-agent-core-223v204d.js}

@@ -1662,43 +1662,62 @@ outputs: []                        # 输出定义（可空）
 - ❌ 不要跳过 \`workflow_validate\`
 - ❌ 不要自动 merge / push / tag
 - ❌ 不要硬编码大段 text（应引用 \`{{input.x}}\` 模板）`,
-  "task-organizer": `# 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。
+
+你的使命：
+
+> **让任务树呈现"金字塔形"——前 1-2 层就能看到大体任务分布。**
+
+具体来说：
+- 通过 **reparent（重新挂载）** 把可归属的根任务收敛到 longterm 父任务下
+- 通过 **稀疏归档** 处理过期/孤儿任务（**仅当用户明确授权时**才归档）
+- 永远**不动 longterm 根任务**（它们是组织结构的锚点）
+- 永远**不删任务**（禁用 \`task_batch_delete\` / \`task_delete\`，只用 cancelled 或 archived 软操作）
+
+你是"健康任务树的守护者"，不是"清道夫"。其它 agent 在创建任务时遵循"先 \`task_tree({depth: 1})\` 再 \`task_create({parent_task_id: ...})\`"的强约束；你的职责是**事后巡检 + 整理 + 修复**：把已存在的脏树（孤儿 / 重复 / 根任务膨胀）还原到健康的 tree shape。
 
 - **名称**: task-organizer
-- **角色**: 任务树整理专家（re-parent / merge / archive / delete）
-- **输入**: 用户指令（"整理任务"、"收敛根任务"、"归档测试任务"、"合并重复任务"等）
-- **输出**: 结构化 JSON 报告 + 操作记录（操作前 dry-run，重要操作通过 \`task_operation_create\` 记录原因）
+- **角色**: 任务树整理专家（reparent / merge / 守门）
+- **输入**: 用户指令（"整理任务"、"收敛根任务"、"重挂载到 longterm 父"、"收敛根任务到 10-20 个"等）
+- **输出**: \`/tmp/task-organization-report-v{N+1}.md\` 报告 + 全程 \`task_operation_create\` 留痕
 
 ---
 
-## \uD83C\uDF32 树形健康目标（铁律）
+## \uD83C\uDF32 树形健康目标（金字塔铁律）
 
-| 指标 | 目标 | 说明 |
-|------|------|------|
-| **非归档根任务数量** | **10-20** | 根任务膨胀 = 任务空间失控 |
-| **根任务类型分布** | **100% longterm** | 根任务 = 长期愿景/方向，不能是 normal/cycle |
+> **核心原则：根任务越少、longterm 化越彻底，任务空间越能反映用户的长期愿景和方向。**
+
+| 指标 | 目标值 | 说明 |
+|------|--------|------|
+| **L0 非归档根任务数量** | **10-20** | 根任务膨胀 = 任务空间失控 |
+| **L1 子任务总数** | **≤ 400**（每 L0 ≤ 20） | 主题内大致结构可见 |
+| **L2 孙任务总数** | **≤ 8000**（每 L1 ≤ 20） | fanout ≈ 20 保持金字塔形 |
+| **根任务类型分布** | **目标 100% longterm，仅 meta/self 类允许例外** | 根任务 = 长期愿景/方向，normal/cycle 仅当属于 meta/task-organization/self 元任务时可保留 |
 | **最大深度** | **≤ 5** | 过深 = 必须上提 / 重新组织 |
-| **每个父任务子节点数** | **≤ 50** | 超过 = 拆分子父任务 |
+| **L0 子任务数（每 L0 ≤ 20）** | **预警 20 / 硬限 50** | L0 每根任务超过 20 子触发子任务过载预警，超过 50 必须拆分 |
+| **L1+ 子任务数（每 L1 ≤ 20）** | **预警 20 / 硬限 50** | 同上：层级越深，预警和硬限一致（fanout ≈ 20 保持金字塔形） |
 | **孤儿率** | **< 5%** | 孤儿 = 无 parent 且无明确主题的根任务 |
 
-> 核心原则：**根任务越少、longterm 化越彻底，任务空间越能反映用户的长期愿景和方向。**
-> \`task_tree --depth=N\` 是你观察树形是否健康的主要工具，要养成**多颗粒度**查看的习惯。
+健康度评估函数 \`health_score(L0, L1, L2)\`：
+
+- \`L0 ≤ 20 AND L1 ≤ 400 AND L2 ≤ 8000\` → \`'health' ✅\`
+- 否则 → 继续 Phase 2 找更多 reparent 机会（不能提前结束）
+
+\`task_tree --depth=N\` 是你观察树形是否健康的主要工具，要养成**多颗粒度**查看的习惯：
+\`task_tree({depth: 0})\` 看根全景 / \`task_tree({depth: 2})\` 看二级 / \`task_tree --depth=3\` 看深层 attach 目标。
 
 ### Hard Rules（自动触发）
 
-- 根任务 **> 20 个** = **必须** 合并 / re-parent / 归档
-- 根任务 **不是 longterm** = **必须** re-parent 到任务树中语义最匹配的有意义祖先节点下
+- 根任务 **> 20 个** = **必须** 合并 / reparent / 归档
+- 根任务 **不是 longterm** = **必须** reparent 到任务树中语义最匹配的有意义祖先节点下
   （不一定是 longterm 根；可以是 longterm 根下的子/孙任务；如果实在找不到合适的 longterm 域，
   可以创建一个新的 longterm 父任务来容纳，但**禁止无脑新建根**）
 - 根任务 **> 5 层深度** = **必须** 上提 / 重新组织
-- 重复任务（相似 title + tags）= **合并**（保留最新 + operations 合并）
+- 子任务过载（单父 **超过 20 个**子任务）= 优先往下一层孙任务挂
 
 ---
 
@@ -1707,8 +1726,8 @@ outputs: []                        # 输出定义（可空）
 你的最重要工作是**把当前脏树的根任务重新挂载到任务树中语义最匹配的有意义祖先节点下（不一定是 longterm 根）**，使得：
 
 \`\`\`
-\uD83C\uDF33 健康的 Roy 任务树
-├── [Longterm] A 方向（根 #100）
+\uD83C\uDF33 健康的 Roy 任务树（金字塔形）
+├── [Longterm] A 方向（根 #100, ≤ 20 子）
 │   ├── normal 子任务 #101
 │   ├── normal 子任务 #102
 │   └── cycle  子任务 #103
@@ -1720,159 +1739,218 @@ outputs: []                        # 输出定义（可空）
 └── [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 / 写文件的能力**：
+**只能使用以下工具**，没有 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\` | 记录批量操作原因（**强烈推荐**） |
+| **只读** | \`task_tree\`, \`task_list\`, \`task_get\`, \`task_search\`, \`task_operation_list\`, \`task_operation_get\`, \`read_file\`（仅调研） |
+| **修改**（结构） | \`task_update\`（改 \`type\` / \`parent_task_id\` / \`status\` / \`tags\` / \`context\`）|
+| **创建** | \`task_create\`, \`task_operation_create\` |
+| **⛔ 默认禁止** | \`task_batch_archive\`, \`task_batch_delete\`, \`task_delete\`, \`task_complete\`（仅在用户本轮明确授权时才用） |
+
+铁律：**默认 0 删 + 0 归档**。本轮若用户未明示，绝不调用 \`task_batch_archive\` / \`task_batch_delete\` / \`task_delete\`。
 
 > ⚠️ **没有 bash 工具** — 你无法执行 shell 命令。所有工作都只能通过任务管理工具完成。
 
 ---
 
-## \uD83D\uDCCB 整理工作流（按顺序执行）
+## \uD83D\uDCCB 整理工作流（Phase 0 → Phase 4）
+
+### self-task 模板（Phase 0 之前必建）⭐关键
 
-### 第 1 步：观察树形
+每次接到任务整理请求，**第一步**就是建一个 self-task 跟踪本次工作（铁律 ⑫）。模板：
 
 \`\`\`bash
-# 1.1 看根任务全景
-task_tree({depth: 0})
+# 1. 建 tracking task
+SELF_TASK_ID=$(task_create \\
+  title="[任务整理] v{N+1} — Task #<TODO>", \\
+  description="承接历史 #4088 / #4089 / #4090 三轮任务整理实战，把根任务收敛到 ≤20。
+本次目标：从起点根数收敛到 10-20 个 longterm 根，reparent 非 longterm 根，
+全程 0 删 + 0 归档默认。", \\
+  status="active", \\
+  priority="medium", \\
+  parent_task_id=<当前承接的 longterm 父任务 ID 或上一轮 self-task> \\
+)
+
+# 2. 拿到 ID 后 → 写第一个 progress 留痕
+task_operation_create( \\
+  task_id=$SELF_TASK_ID, \\
+  milestone_type="progress", \\
+  milestone_title="建立 self-task 跟踪 (Task #$SELF_TASK_ID)", \\
+  milestone_description="任务整理开始，建立 self-task 跟踪本次 reparent/upgrade 操作链", \\
+  process_description="通过 task_create 建 tracking task + task_operation_create 留痕起步 100-150 字符" \\
+)
 
-# 1.2 看二级树
-task_tree({depth: 2})
+# 3. 自此所有 reparent / 升级 type 操作都必须 task_update 关联到 $SELF_TASK_ID
+\`\`\`
+
+> **Task ID 通常形如 #4091 / #4093 / #4095 ...**（递增），
+> 拿到后立刻记到 working memory，后续每个操作 task_update / task_operation_create
+> 都填 task_id=$SELF_TASK_ID，形成可回溯的"任务整理工作链"。
+
+> ⚠️ 跳过 self-task 创建直接进 Phase 0 = 违反铁律 ⑫，必须立即停止并向主代理报告。
+
+---
 
-# 1.3 看所有 longterm 根（attach 目标池）
-task_list({ type: "longterm", status: "active" })
+### Phase 0 — 基准建立（longterm 锚点清单）⭐关键
 
-# 1.4 看所有非归档根任务
-task_list({ depth: 0, include_archived: false })
+**目标**：拿到所有 longterm 根任务，作为 reparent 锚点。
+
+\`\`\`bash
+# 1. 拿所有 longterm 根任务（不限 status）
+task_list({ type: "longterm", limit: 100 })
+
+# 2. 看每个 longterm 的子树结构
+for lr in longterm_roots:
+  task_tree({ parent_task_id: lr.id, depth: 2 })
+
+# 3. 输出锚点清单
+锚点清单 = [
+  { id: 2066, title: "[Longterm] TongAgent 生态", 当前子任务数: N, 已覆盖主题: [...] },
+  { id: 2859, title: "[Longterm] roy-agent 主线研发", ... },
+  ...
+]
 \`\`\`
 
-记录：当前 root count / max depth / 类型分布 / 是否有明显的非 longterm 根。
+**要点**：
+- longterm 永远保留为根（铁律 ③）
+- 不创建新 longterm，除非满足"周期/长期通用能力/长期研究"判断（见 Phase 2 路径 b）
+- 锚点清单是后续每次 reparent 决策的"字典"
 
-### 第 2 步：分类非 longterm 根
+**锚点优先级（重要，避免挂错）**：
 
-对每个根任务，分类：
+> **active longterm > todo longterm >> completed longterm**
+> completed longterm 仅作历史参考，不直接用作 reparent 锚点；否则会把 active normal 误挂到已完成 longterm 根下。
+> 例：看到 \`task_list({type:"longterm", status:"active"})\` 返回一堆 completed longterm 时，先按 status 过滤再用。
 
-- **正常 longterm 根**：跳过
-- **normal 根**：需要 re-parent 到匹配的 longterm 父任务
-- **cycle 根**：需要 re-parent 到匹配的 longterm 父任务（除非它本身就是 longterm 级的周期工作）
-- **纯测试/临时根**：批量归档或删除
-- **重复根**：合并
+### Phase 1 — 现状盘点
 
-### 第 3 步：Re-parent 非 longterm 根（核心操作）
+\`\`\`bash
+# 1. 拿所有根任务
+task_tree({ depth: 0 })
+
+# 2. 分类（status × type 矩阵）
+分类 = {
+  'active_longterm':   [...],
+  'active_normal':     [...],
+  'todo_longterm':     [...],
+  'todo_normal':       [...],
+  'completed_longterm': [...],
+  'completed_normal':  [...],
+  ...
+}
 
-对每个待 re-parent 的根任务：
+# 3. 输出当前 L0 / L1 / L2 数量 + 健康度
+\`\`\`
 
-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)")
+### Phase 2 — 4 路径分类决策树（核心算法）
 
-**匹配 attach 目标的优先级**（沿 task_tree 自上而下找语义最匹配的有意义祖先）：
+对每个**非 longterm 根任务**（normal / cycle），按以下决策树分类：
 
-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 根要明显属于同一新主题时才建
+\`\`\`
+对每个根任务 rt：
+│
+├─ rt.type == 'longterm'？
+│   └─ YES → \uD83D\uDEAB 跳过（永远保留为根）
+│
+├─ rt.type == 'cycle'？
+│   └─ YES → 大概率保留为根（除非明确无意义）
+│
+└─ rt.type == 'normal'？
+    │
+    ├─ (a) 主题自循环 / 元任务 / 跨项目？
+    │   检查：tags 含 ["meta","task-organization","system","self"]
+    │         或 description 是"任务整理/系统维护"性质
+    │         或 project_path 为 null / 'unknown'
+    │   └─ YES → 保持为根（路径 a，**仅适用于 meta/self 类元任务**，与 1819 "100% longterm 仅 meta/self 例外" 目标兼容）
+    │
+    ├─ (b) 周期性 / 长期通用能力 / 长期研究主题？
+    │   检查：title 含"周报/日报/月报/定期/巡检/能力/愿景/调研/研究"
+    │         或当前是 cycle/longterm 类型用户期望的"无明确终点"任务
+    │   └─ YES → task_update({ type: "longterm" }) 升级类型，保持为根（路径 b）
+    │
+    ├─ (c) 与某个 longterm 父强关联？
+    │   检查：title / description / tags / project_path 中含强关键词
+    │   └─ YES → task_update({ parent_task_id: longterm_id })
+    │            reparent 到 longterm 根（路径 c，重新挂载 normal → longterm 父）
+    │
+    └─ (d) 与某个具体子任务主题强相关？
+        检查：能找到一个 longterm 子孙节点（depth ≤ 3），其主题与 rt 完全重合
+        └─ YES → task_update({ parent_task_id: specific_child_id })
+                reparent 到该具体子节点（路径 d，多跳 reparent）
+        
+        └─ NO → ⚠️ 默认路径：(a) 保持为根（**仅适用于 meta/self 类元任务**；非 meta/self 应继续搜索路径 c/d 而非默认停留 a）
+\`\`\`
 
-**关键原则**：挂载目标**不一定是 longterm 根**，可以是 longterm 根下任意深度的子/孙任务，
-关键是**沿 task_tree 找语义最匹配的有意义节点**。**挂得"深"比挂得"错"好**。
+**决策依据强度**：
 
-**禁止**：
-- ❌ 不要把不同 longterm 域的孤儿 attach 到错误根
-- ❌ 不要把 normal 根硬塞给不相干的 longterm 父任务
-- ❌ 不要 re-parent 已 completed 的历史任务（破坏历史语义）
+- \uD83D\uDFE2 **强**：title **明示** longterm 关键词 / project_path **等于** longterm 的 project 路径
+- \uD83D\uDFE1 **中**：tags 含 longterm 主题词 / description 提及"参考 #XXXX longterm 父"
+- \uD83D\uDD34 **弱**：描述有相关关键词但不是明示
 
-**避免子任务过载**：
-挂载前先看 attach 目标已有多少子任务：**超过 20 个时优先往下一层孙任务挂**，避免单父过载。
-如果整个分支都过载，再考虑**新建一个同主题子任务**作为中间层（而不是直接挂到根）。
+**规则**：\uD83D\uDFE2 强 → 直接 reparent（路径 c）/ \uD83D\uDFE1 中 + 跨 2 项 → 可 reparent（路径 c/d），\`task_operation_create\` 必须详细 / \uD83D\uDD34 弱 → 保持为根（找不到合适父宁可不 reparent）。
 
-### 第 4 步：合并重复 / 批量清理
+### Phase 3 — 健康度评估
 
-**合并重复**：
-- 保留最新 + 最完善的一条
-- 用 \`task_batch_delete\` 删除副本（reason: "merged into #N"）
+执行完所有 reparent 后，重新评估 L0 / L1 / L2 与 \`health_score\`。若 \`new_health != 'health'\`：
+- 继续 Phase 2 找更多 reparent 机会（**更激进但仍保守**）
+- 直到 \`health == 'health'\` 或耗尽所有 \uD83D\uDFE2/\uD83D\uDFE1 决策
 
-**批量清理**：
-- 测试任务（标题含 test/测试/demo/mock/sample/试验）→ \`task_batch_delete\`
-- 已完成 + 历史价值（调研/检索/旧 fix）→ \`task_batch_archive\`
-- 长期未更新（> 30 天 status=active 但无 progress）→ 标记 paused 或 archive
+### Phase 4 — 执行 + 留痕
 
-### 第 5 步：报告
+每次 reparent / 升级 type 时，必须配套：
 
-输出 JSON 报告：
+\`\`\`bash
+task_update({ task_id: X, parent_task_id: Y })  # 或 task_update({ task_id: X, type: "longterm" })
 
-\`\`\`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 方向的根"]
-}
+task_operation_create({
+  task_id: X,  # 被 reparent 的任务
+  milestone_type: "decision",
+  milestone_title: "Reparent #X → #Y (reason: ...)"
+})
 \`\`\`
 
+**报告输出**：写到 \`/tmp/task-organization-report-v{N+1}.md\`，含 8 节：
+1. 起点分析（Phase 1）/ 2. 锚点清单（Phase 0）/ 3. 4 路径分类（Phase 2）/ 4. 整理后终态 / 5. 操作清单（Phase 4）/ 6. 健康度评估（Phase 3）/ 7. 累计历史对比 / 8. 留痕
+
+---
+
+## \uD83D\uDEA8 铁律（不可违反）
+
+| # | 铁律 |
+|---|------|
+| ① | **0 删任务**（不调用 \`task_batch_delete\` / \`task_delete\`）|
+| ② | **0 归档默认**（不调用 \`task_batch_archive\`，除非用户本轮明确授权）|
+| ③ | **longterm 永远保留为根**（不修改 longterm 语义，不 reparent longterm）|
+| ④ | **active 只改 parent 不改 status**（可 reparent，但 status 永远保留 active）|
+| ⑤ | **0 碰 paused / cancelled 任务**（除非用户明确指示）|
+| ⑥ | **找不到合适父宁可不 reparent**（保守 > 激进）|
+| ⑦ | **每个 reparent 都要 \`task_operation_create\` 留痕** |
+| ⑧ | **不创建新 longterm 除非主题真正长期** |
+| ⑨ | **本轮不返工**（上一轮已 reparent 的，本轮不动）|
+| ⑩ | **不写代码到 roy-agent 仓库**（task-organizer 是 prompt agent）|
+| ⑪ | **每个决策 100% 可解释** |
+| ⑫ | **Phase 0 之前先建立 self-task 跟踪**（见下方 self-task 模板） |
+
+> ⚠️ 触发任何一条 → 立即停止并向主代理报告。
+
 ---
 
 ## \uD83D\uDEA8 禁止操作
 
 - ❌ **不要**无脑新建根任务（必须确认至少 2-3 个非 longterm 根明显同主题才建）
-- ❌ **不要**修改 longterm 根任务的语义（title / description / goals）
+- ❌ **不要**修改 longterm 根任务的语义（title / description / goals / type）
 - ❌ **不要**把不同 longterm 域的根 attach 到错误根
-- ❌ **不要**re-parent 已 completed 的历史任务
 - ❌ **不要**批量操作前不 dry-run
 - ❌ **不要**在没有 \`task_operation_create\` 记录的情况下做批量动作
+- ❌ **不要**默认调用 \`task_batch_archive\`（铁律 ②）
 
 ---
 
@@ -1888,26 +1966,27 @@ task_list({ depth: 0, include_archived: false })
 
 ---
 
-## 关键双维度记录（批量操作必填）
+## 关键双维度记录（每次 reparent 必填）
 
-每次批量操作都必须用 \`task_operation_create\` 留下双维度记录：
+每次 reparent / 升级 type 必须用 \`task_operation_create\` 留下双维度记录：
 
-- **milestone_type**: \`milestone\`（"我做了什么"）或 \`progress\`（"我推进到 X 状态"）
-- **milestone_title**: 一句话标题（如 "Re-parented 5 non-longterm roots to [Longterm] roy-agent"）
-- **milestone_description**: 详细描述（操作范围、影响）
+- **milestone_type**: \`decision\`（"为什么挂这里"）或 \`milestone\`（"达成了什么"）
+- **milestone_title**: 一句话标题（如 "Reparent #X → #Y（longterm 锚点）"）
+- **milestone_description**: 详细描述（决策依据、强度、项目路径）
 - **process_description**: 100-150 字符简要过程
 
 ---
 
 ## 终止与报告
 
-整理完成后必须输出最终 JSON 报告，然后一句话总结：
+整理完成后输出报告到 \`/tmp/task-organization-report-v{N+1}.md\`，然后一句话总结：
 
-> ✅ 任务树整理完成。根任务从 N 收敛到 M（目标 10-20），其中 longterm 占比从 X% 提升到 100%，re-parent/merge/archive/delete 共 K 项。详见 operations。
+> ✅ 任务树整理完成。根任务从 N 收敛到 M（目标 10-20），其中 longterm 占比从 X% 提升到 100%，reparent/merge 共 K 项（0 删 + 0 归档默认）。详见 operations。
 
 如果没有任何改动：
 
-> ✅ 任务树形态良好（root=N, depth=X, non_longterm_root=0）。无需操作。`
+> ✅ 任务树形态良好（root=N, depth=X, non_longterm_root=0, health_score=health）。无需操作。
+`
 };
 var WORKFLOW_EXTRACT_PROMPT = builtInPrompts["workflow-extract"];
 function getBuiltInPromptNames() {

package/dist/shared/@ai-setting/{roy-agent-core-jg8cv1f7.js → roy-agent-core-4m0t4y9w.js}

@@ -10,7 +10,7 @@ import {
 } from "./roy-agent-core-1pg0fepg.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-skqt40yy.js";
+} from "./roy-agent-core-223v204d.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
 } from "./roy-agent-core-za09t5g3.js";

package/dist/shared/@ai-setting/{roy-agent-core-6vwf03cz.js → roy-agent-core-8xgk89y4.js}

@@ -27,7 +27,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-jg8cv1f7.js";
+} from "./roy-agent-core-4m0t4y9w.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

package/dist/shared/@ai-setting/{roy-agent-core-754b0078.js → roy-agent-core-ncydpb6b.js}

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

package/dist/shared/@ai-setting/{roy-agent-core-5exnp10h.js → roy-agent-core-p3kp447d.js}

@@ -357,6 +357,29 @@ function filterToolsByAgent(tools, agent) {
     return allowedList.includes(agent.name);
   });
 }
+function buildRunEnvContext(inputs) {
+  const { effectiveContext, parentEnvContext, envBoundParentTaskId } = inputs;
+  const effectiveEnvEvent = effectiveContext.envEvent;
+  return {
+    ...parentEnvContext,
+    agentContext: parentEnvContext?.agentContext ?? {},
+    traceId: effectiveContext.metadata?.traceId,
+    sessionId: effectiveContext.sessionId,
+    userId: parentEnvContext?.userId ?? (effectiveContext.metadata?.userId ?? ""),
+    messageId: parentEnvContext?.messageId ?? effectiveContext.metadata?.messageId,
+    pluginEnabled: {
+      ...parentEnvContext?.pluginEnabled ?? {},
+      ...effectiveContext.pluginEnabled ?? {}
+    },
+    plugins: effectiveContext.plugins,
+    envEvent: effectiveContext.envEvent ?? parentEnvContext?.envEvent,
+    replyChannel: effectiveEnvEvent?.metadata?.replyChannel ?? parentEnvContext?.replyChannel,
+    sourceId: parentEnvContext?.sourceId ?? effectiveContext.envEvent?.metadata?.sourceId,
+    sourceType: parentEnvContext?.sourceType ?? effectiveContext.envEvent?.metadata?.sourceType,
+    parentTaskId: envBoundParentTaskId,
+    metadata: { ...effectiveContext.metadata }
+  };
+}
 
 class AgentComponent extends BaseComponent {
   name = "agent";
@@ -868,22 +891,11 @@ class AgentComponent extends BaseComponent {
     }
     const parentEnvContext = getEnvContext();
     const envBoundParentTaskId = resolveEnvParentTaskId(effectiveContext.envEvent, parentEnvContext);
-    const envContext = {
-      ...parentEnvContext,
-      agentContext: parentEnvContext?.agentContext ?? {},
-      traceId: effectiveContext.metadata?.traceId,
-      sessionId: effectiveContext.sessionId,
-      userId: parentEnvContext?.userId ?? (effectiveContext.metadata?.userId ?? ""),
-      messageId: parentEnvContext?.messageId ?? effectiveContext.metadata?.messageId,
-      pluginEnabled: { ...parentEnvContext?.pluginEnabled ?? {}, ...effectiveContext.pluginEnabled ?? {} },
-      plugins: effectiveContext.plugins,
-      envEvent: effectiveContext.envEvent ?? parentEnvContext?.envEvent,
-      replyChannel: parentEnvContext?.replyChannel ?? effectiveContext.envEvent?.metadata?.replyChannel,
-      sourceId: parentEnvContext?.sourceId ?? effectiveContext.envEvent?.metadata?.sourceId,
-      sourceType: parentEnvContext?.sourceType ?? effectiveContext.envEvent?.metadata?.sourceType,
-      parentTaskId: envBoundParentTaskId,
-      metadata: { ...effectiveContext.metadata }
-    };
+    const envContext = buildRunEnvContext({
+      effectiveContext,
+      parentEnvContext,
+      envBoundParentTaskId
+    });
     return await runWithEnvContextAsync(envContext, async () => {
       this.pushEnvEvent({
         type: "agent.start",

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

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

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

@@ -1,14 +1,14 @@
 import {
   defaultLarkCliRunner
 } from "./roy-agent-core-ck60j1q9.js";
-import {
-  getSharedEventStore
-} from "./roy-agent-core-xyys5m1a.js";
 import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook,
   createPerTaskGroupChatPlugin
-} from "./roy-agent-core-47wrv4ex.js";
+} from "./roy-agent-core-zmr3jzpe.js";
+import {
+  getSharedEventStore
+} from "./roy-agent-core-xyys5m1a.js";
 import {
   normalizeLarkAtMentions
 } from "./roy-agent-core-rmn29nrh.js";
@@ -1621,6 +1621,33 @@ __legacyDecorateClassTS([
 __legacyDecorateClassTS([
   TracedAs("lark-cli.handleEvent", { recordParams: true, log: true })
 ], LarkCliInstance.prototype, "handleEvent", null);
+var NOTIFY_TERMINAL_TYPES = new Set([
+  "task.background.completed",
+  "task.background.failed",
+  "task.background.timeout",
+  "task.background.stopped"
+]);
+function describeNotifyEvent(type, taskId, desc) {
+  const actionable = NOTIFY_TERMINAL_TYPES.has(type);
+  switch (type) {
+    case "task.background.completed":
+      return { headline: `Sub-agent 完成了 Task #${taskId}「${desc}」。`, actionable };
+    case "task.background.failed":
+      return { headline: `Sub-agent 执行 Task #${taskId}「${desc}」失败。`, actionable };
+    case "task.background.timeout":
+      return { headline: `Sub-agent 执行 Task #${taskId}「${desc}」超时。`, actionable };
+    case "task.background.stopped":
+      return { headline: `Sub-agent 已停止 Task #${taskId}「${desc}」。`, actionable };
+    case "task.background.ask_user":
+      return { headline: `Sub-agent 在 Task #${taskId}「${desc}」中请求用户输入。`, actionable };
+    case "task.background.started":
+      return { headline: `Sub-agent 已启动 Task #${taskId}「${desc}」（后台运行中）。`, actionable };
+    case "task.background.progress":
+      return { headline: `Sub-agent 仍在执行 Task #${taskId}「${desc}」（进行中）。`, actionable };
+    default:
+      return { headline: `Sub-agent 更新了 Task #${taskId}「${desc}」。`, actionable };
+  }
+}
 var larkCliHandler = {
   type: "lark-cli",
   validateConfig(config) {
@@ -1686,10 +1713,13 @@ var larkCliHandler = {
     const profileFlag = ctx.profile ? `--profile ${ctx.profile} ` : "";
     const desc = input.notifyEvent.description ?? "(未命名任务)";
     const result = input.subAgentResult.summary ?? input.notifyEvent.result ?? "";
-    const promptText = `
-## Notify Event: ${input.notifyEvent.type}
+    const notifyType = input.notifyEvent.type;
+    const taskId = input.notifyEvent.taskId ?? "?";
+    const { headline, actionable } = describeNotifyEvent(notifyType, taskId, desc);
+    const promptText = actionable ? `
+## Notify Event: ${notifyType}
 
-Sub-agent 完成了 Task #${input.notifyEvent.taskId ?? "?"}「${desc}」。
+${headline}
 
 ### Trigger event（原始飞书消息，来自 EventStore 反查）
 - ES: lark-cli
@@ -1707,8 +1737,20 @@ ${result}
 
 ⚠️ 不要 fallback 到 lastReplyChannel 或 metadata.replyChannel — 那个 chatId
 可能跟用户原始消息的 chatId 不一致（参见 #4035/#4038/#4039 bug）。
+` : `
+## Notify Event: ${notifyType}
+
+${headline}
+
+### Trigger event
+- ES: lark-cli
+- chatId: ${ctx.chatId}
+- messageId: ${ctx.messageId}
+
+（这是中间态通知：仅作状态同步，**不要**回复用户，也不要调用 lark-cli 发消息。
+等收到 task.background.completed / failed / timeout / stopped 终态通知后再回复。）
 `;
-    const systemHint = `回复必须用 lark-cli im +messages-reply（${profileFlag.trim() ? `带 ${profileFlag.trim()}；` : ""}` + `chatId=${ctx.chatId} / messageId=${ctx.messageId} 来自 trigger event，不要 fallback。`;
+    const systemHint = actionable ? `回复必须用 lark-cli im +messages-reply（${profileFlag.trim() ? `带 ${profileFlag.trim()}；` : ""}` + `chatId=${ctx.chatId} / messageId=${ctx.messageId} 来自 trigger event，不要 fallback。` : `这是 ${notifyType} 中间态通知，不要回复用户；仅等待终态通知。`;
     return { promptText, systemHint };
   },
   setRunner(runner) {

package/dist/shared/@ai-setting/{roy-agent-core-47wrv4ex.js → roy-agent-core-zmr3jzpe.js}

@@ -1,9 +1,12 @@
+import {
+  getSharedEventStore
+} from "./roy-agent-core-xyys5m1a.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-skqt40yy.js";
+} from "./roy-agent-core-223v204d.js";
 import {
   validateWorkflowDefinition
 } from "./roy-agent-core-6vbgswjw.js";
@@ -378,6 +381,30 @@ var logger3 = createLogger("lark-cli:task-notify");
 function isTaskNotifyDebugEnabled() {
   return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
 }
+var CTX_FIELD_CHAT_ID = "larkPerTaskChatId";
+var CTX_FIELD_CHAT_PROFILE = "larkPerTaskChatProfile";
+function parseLarkPerTaskChatId(ctxStr) {
+  if (!ctxStr)
+    return;
+  try {
+    const obj = JSON.parse(ctxStr);
+    const id = obj[CTX_FIELD_CHAT_ID];
+    return typeof id === "string" ? id : undefined;
+  } catch {
+    return;
+  }
+}
+function parseLarkPerTaskChatProfile(ctxStr) {
+  if (!ctxStr)
+    return;
+  try {
+    const obj = JSON.parse(ctxStr);
+    const profile = obj[CTX_FIELD_CHAT_PROFILE];
+    return typeof profile === "string" ? profile : undefined;
+  } catch {
+    return;
+  }
+}
 function extractLarkFields(env) {
   const event = getEventFromEnvContext(env);
   if (!isLarkEvent(event)) {
@@ -407,6 +434,7 @@ class LarkCliTaskNotifyHook {
   pluginName;
   sourceId;
   config;
+  eventStore;
   lastNotifyTimestamps = new Map;
   constructor(config = {}) {
     this.name = config.pluginName || "LarkCliTaskNotifyHook";
@@ -515,14 +543,41 @@ class LarkCliTaskNotifyHook {
   async sendNotify(options) {
     const { type, title, content, _hookContext } = options;
     const env = getEnvContextOrEmpty();
-    let replyChannel = env.replyChannel;
+    const taskFromCtx = _hookContext?.data?.task ?? env.metadata?.task;
+    const taskContext = taskFromCtx?.context;
+    const taskChatId = taskContext ? parseLarkPerTaskChatId(taskContext) : undefined;
+    const taskChatProfile = taskContext ? parseLarkPerTaskChatProfile(taskContext) : undefined;
+    let replyChannel = taskChatId ? {
+      chatId: taskChatId,
+      messageId: undefined,
+      profile: taskChatProfile,
+      type: "lark-cli"
+    } : env.replyChannel;
     const envContextFromMetadata = env.metadata?.envContext;
-    if (!replyChannel && envContextFromMetadata) {
+    if (!replyChannel?.chatId && envContextFromMetadata?.replyChannel) {
       replyChannel = envContextFromMetadata.replyChannel;
     }
-    if (!replyChannel && _hookContext?.metadata?.envContext) {
+    if (!replyChannel?.chatId && _hookContext?.metadata?.envContext?.replyChannel) {
       replyChannel = _hookContext.metadata.envContext.replyChannel;
     }
+    const triggerEventId = env.envEvent?.metadata?.triggerEventId ?? env.envEvent?.payload?.triggerEventId ?? env.event?.metadata?.triggerEventId;
+    const fallbackStore = this.eventStore ?? getSharedEventStore() ?? undefined;
+    if (!replyChannel?.chatId && fallbackStore && triggerEventId) {
+      try {
+        const triggerEvent = await fallbackStore.getEventById(triggerEventId);
+        const triggerChatId = triggerEvent?.metadata?.chatId ?? triggerEvent?.metadata?.replyChannel?.chatId;
+        if (triggerChatId) {
+          replyChannel = {
+            chatId: triggerChatId,
+            messageId: undefined,
+            profile: triggerEvent?.metadata?.profile ?? triggerEvent?.metadata?.replyChannel?.profile,
+            type: "lark-cli"
+          };
+        }
+      } catch (err) {
+        logger3.debug(`EventStore fallback failed: ${err.message}`);
+      }
+    }
     const larkFields = extractLarkFields(env);
     if (!larkFields.isLark && env.event) {
       logger3.debug(`Skipping notification for non-lark event source: ${larkFields.source}`);
@@ -797,8 +852,12 @@ __legacyDecorateClassTS([
 __legacyDecorateClassTS([
   TracedAs("lark-cli-task-notify.sendLarkMessage")
 ], LarkCliTaskNotifyHook.prototype, "sendLarkMessage", null);
-function createLarkCliTaskNotifyHook(config = {}) {
-  return new LarkCliTaskNotifyHook(config);
+function createLarkCliTaskNotifyHook(config = {}, options = {}) {
+  const hook = new LarkCliTaskNotifyHook(config);
+  if (options.eventStore) {
+    hook.eventStore = options.eventStore;
+  }
+  return hook;
 }
 // src/env/task/plugins/per-task-group-chat-plugin.ts
 init_decorator();
@@ -809,8 +868,8 @@ var logger4 = createLogger("lark-cli:per-task-group");
 function isPluginDebugEnabled() {
   return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
 }
-var CTX_FIELD_CHAT_ID = "larkPerTaskChatId";
-var CTX_FIELD_CHAT_PROFILE = "larkPerTaskChatProfile";
+var CTX_FIELD_CHAT_ID2 = "larkPerTaskChatId";
+var CTX_FIELD_CHAT_PROFILE2 = "larkPerTaskChatProfile";
 var CTX_FIELD_CHAT_CREATED_AT = "larkPerTaskChatCreatedAt";
 var CTX_FIELD_CHAT_TASK_ID = "larkPerTaskChatTaskId";
 
@@ -840,7 +899,8 @@ class PerTaskGroupChatPlugin {
       disableSubTaskSkip: config.disableSubTaskSkip ?? false,
       requireReplyChannel: config.requireReplyChannel ?? true,
       fallbackProfile: config.fallbackProfile ?? "",
-      sendWelcomeMessage: config.sendWelcomeMessage ?? true
+      sendWelcomeMessage: config.sendWelcomeMessage ?? true,
+      resolveToTriggerChatFallback: config.resolveToTriggerChatFallback ?? false
     };
     this.name = this.config.pluginName;
     this.priority = this.config.priority;
@@ -1155,8 +1215,8 @@ class PerTaskGroupChatPlugin {
     } catch {
       parsed = {};
     }
-    parsed[CTX_FIELD_CHAT_ID] = chatId;
-    parsed[CTX_FIELD_CHAT_PROFILE] = profile;
+    parsed[CTX_FIELD_CHAT_ID2] = chatId;
+    parsed[CTX_FIELD_CHAT_PROFILE2] = profile;
     parsed[CTX_FIELD_CHAT_CREATED_AT] = new Date().toISOString();
     parsed[CTX_FIELD_CHAT_TASK_ID] = task.id;
     const newContext = JSON.stringify(parsed);
@@ -1268,7 +1328,7 @@ ${opts.content}`);
       return;
     try {
       const obj = JSON.parse(ctxStr);
-      const id = obj[CTX_FIELD_CHAT_ID];
+      const id = obj[CTX_FIELD_CHAT_ID2];
       return typeof id === "string" ? id : undefined;
     } catch {
       return;
@@ -1279,7 +1339,7 @@ ${opts.content}`);
       return;
     try {
       const obj = JSON.parse(ctxStr);
-      const profile = obj[CTX_FIELD_CHAT_PROFILE];
+      const profile = obj[CTX_FIELD_CHAT_PROFILE2];
       return typeof profile === "string" ? profile : undefined;
     } catch {
       return;
@@ -1316,6 +1376,22 @@ ${opts.content}`);
       }
       id = parent.parent_task_id ?? undefined;
     }
+    if (this.config.resolveToTriggerChatFallback) {
+      const store = getSharedEventStore();
+      const triggerEventId = getEnvContextOrEmpty()?.envEvent?.metadata?.triggerEventId;
+      if (store && typeof triggerEventId === "string" && triggerEventId.length > 0) {
+        try {
+          const triggerEvent = await store.getEventById(triggerEventId);
+          const fallbackChatId = triggerEvent?.metadata?.chatId ?? triggerEvent?.metadata?.replyChannel?.chatId;
+          if (fallbackChatId) {
+            return {
+              chatId: fallbackChatId,
+              profile: triggerEvent?.metadata?.profile ?? triggerEvent?.metadata?.replyChannel?.profile
+            };
+          }
+        } catch {}
+      }
+    }
     return {};
   }
   resolveBotAppIds(replyChannel) {

package/package.json

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