@ai-setting/roy-agent-core 1.7.75 → 1.7.77

package/dist/env/task/task-component.d.ts

@@ -161,6 +161,14 @@ export declare class TaskComponent extends BaseComponent {
      * 按 session_id 反查该 session 创建的第一个 task（sub-session → task 确定性映射）。
      */
     getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
+    /**
+     * Task #5081 — 按 session_id 反查该 session 绑定的**全部** task。
+     *
+     * 为什么需要：一个 sub-session 可能创建/关联多个 task
+     * （getTaskIdBySessionId 只返回第一个，ORDER BY timestamp ASC）。
+     * TaskOpWatermarkPlugin 对全部 task 求并集水位（保守不漏报）。
+     */
+    getTaskIdsBySessionId(sessionId: string): Promise<number[]>;
     /**
      * Get task with operations
      *
@@ -213,6 +221,54 @@ export declare class TaskComponent extends BaseComponent {
         operations: TaskOperation[];
         task: Task;
     }) | undefined>;
+    /**
+     * ★ Task #5063 — 终态 current_status 收口辅助（**唯一**措辞/规则来源）
+     *
+     * 规则（测试锁死，勿改）：
+     *   1. **只在 status 迁移到终态时**补 current_status
+     *      —— 非终态（todo/active/paused）原样返回，不碰 current_status。
+     *         （否则会破坏 `task_update(current_status="推进中")` 这类合法用法。）
+     *   2. **调用方显式传了 current_status 就尊重调用方**，不覆盖
+     *      —— completeTask / cancelTaskTool 已在自己的调用里写好了带
+     *         deliverable / reason 的终态文案，不能被这里冲掉。
+     *   3. 只认**本次更新要落**的 status —— `status` 缺省时一律不动。
+     *
+     * 终态集合与措辞：
+     *   - completed → TASK_COMPLETED_STATUS_WORD（但 completeTask 自己写了带
+     *     deliverable 的版本，走的是规则 2「尊重调用方」，不受这里影响）
+     *   - cancelled → TASK_CANCELLED_STATUS_WORD
+     *   - archived  → TASK_ARCHIVED_STATUS_WORD
+     *
+     * ⚠️ 与 TASK_COMPLETE_TERMINAL_STATUSES（hooks/contexts.ts）**故意不同**：
+     *   那个集合决定「要不要 fire AFTER_COMPLETE 钩子」（archived 不 fire）；
+     *   这个集合决定「要不要刷新 current_status」（archived 要刷）。
+     *   两者语义正交，别合并。
+     *
+     * ★ Task #5067 — 新增**反向**收口（reopen：终态 → 非终态）
+     *
+     *   #5063 只管「迁入终态」。反向路径没管 ⇒ 任务从终态被 reopen 回
+     *   active/todo 时，current_status 仍停在终态文案（"已归档"/"已取消"/"已完成"），
+     *   出现「status: active 但 current_status: 已归档」的自相矛盾状态。
+     *
+     *   规则 4（新增，测试锁死）：
+     *     **从终态迁出到非终态，且当前 current_status 是系统写的终态文案时，
+     *       把 current_status 换成 reopen 措辞。**
+     *
+     *   为什么这不违反规则 1：
+     *     规则 1 说的「非终态迁移不碰 current_status」指的是**普通进度更新**
+     *     （如 `task_update(current_status="推进中")`）—— 那必须保留调用方
+     *     显式传的值。而 reopen 时 current_status 里留着的是**系统自己写的
+     *     终态文案**，不是调用方的意图 ⇒ 这种情况**应该**被刷新。
+     *
+     *   判定用「值比对 + 前态 status」双条件（修法 A 增强版）：
+     *     - 值比对：current_status 以某个终态锚点**开头**（TASK_TERMINAL_STATUS_WORDS）
+     *     - 前态 status：任务**当前**确实处于终态（archived/cancelled/completed）
+     *     两个条件同时成立才替换。为什么要加「前态」条件：
+     *       只看值的话，active 任务上手写的「已完成的部分：A/B/C」会被误判
+     *       成陈旧终态文案而被冲掉。加上前态判定后，只有**真的从终态迁出**
+     *       时才动 —— 把误伤面压到极窄。
+     */
+    private withTerminalCurrentStatus;
     /**
      * Update task
      */
@@ -278,6 +334,37 @@ export declare class TaskComponent extends BaseComponent {
      * @returns 更新后的 Task，任务不存在时返回 undefined
      */
     updateTaskContext(id: number, context: string): Promise<Task | undefined>;
+    /**
+     * ★ Task #5073 — 提交待验证（两阶段验收的第一阶段）
+     *
+     * 需求（用户 2026-11-06 飞书）：sub-agent 觉得可以完成了，
+     * 传交付物等参数调 task_pre_complete → task 状态变为 to_validate；
+     * default agent 调 task_complete 校验之后状态正式 completed。
+     *
+     * 语义要点：
+     *   - to_validate **不是终态**：
+     *     - 不加入 isTerminalTaskStatus（reopen 反向收口不管它）
+     *     - 卡片（lark 插件）保持 running 更新态（cardStatusOf 不识别
+     *       to_validate → 走 sendCardUpdate 普通 patch，不 unpin）
+     *   - ★ 设计调整②（38603）：preCompleteTask 在 updateTask 后**显式
+     *     fire 一次 AFTER_COMPLETE**（goal 检查自查关，terminalStatus=
+     *     to_validate）；updateTask 本体已**不再**触发 AFTER_COMPLETE
+     *     （见 updateTask 注释），本钩子的触发点唯一 = preCompleteTask。
+     *   - current_status 同步（#5060 收口模式）：措辞同源锚点
+     *     TASK_TO_VALIDATE_STATUS_WORD =「待验证」，调用方传了
+     *     progressSummary 就带上（「待验证：<summary>」）
+     *   - 交付物双写（#2778 v2 同模式）：context.deliverable_storage_path
+     *     + operation 的 Deliverable 行
+     *   - 幂等：重复提交安全（后一次覆盖前一次的 current_status /
+     *     deliverable，operation 各自留痕）
+     *
+     * @param id 任务 ID
+     * @param sessionId 当前 session ID
+     * @param deliverableStoragePath 可选，交付物寻址地址
+     * @param progressSummary 可选，本次交付的进展摘要（拼进 current_status）
+     * @returns 更新后的 Task 或 undefined
+     */
+    preCompleteTask(id: number, sessionId: string, deliverableStoragePath?: string, progressSummary?: string): Promise<Task | undefined>;
     /**
      * Create operation record
      */
@@ -304,6 +391,14 @@ export declare class TaskComponent extends BaseComponent {
      * List operations for a task
      */
     listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081 — 绕过 operationsCache 的直读（optional 能力探测）。
+     *
+     * store 实现 `listOperationsFresh` 时直打 DB；否则降级
+     * `listOperations` + `invalidateOperationsCache`（若支持）。
+     * 语义等价，保证跨进程写入的记录可见。
+     */
+    listOperationsFresh(options: ListOperationsOptions): Promise<TaskOperation[]>;
     /**
      * 获取 TagService
      */

package/dist/env/task/tools/cancel-tool.d.ts

@@ -7,7 +7,13 @@
  *   且 sub-agent 超时 / 未更新状态时任务状态会长期不同步。
  *   调整后 default agent 承担验收：
  *     - task_complete —— 核对产出后判定完成（触发 goal 检查 decision model）
- *     - task_cancel   —— 验收不通过 / 用户要求时取消任务
+ *     - task_cancel   —— **仅在用户明令取消时**取消任务
+ *
+ * 语义边界（Task #5055，用户明令）：
+ *   task_cancel 是**用户明令**才能调的 —— 用户说"取消 / 停掉这个任务"。
+ *   失败 / 超时 ≠ 取消：正确的出路是找根因 → 提修复方案 → 重新委托
+ *   （可用 sub_session_id 续跑）→ 实在推不动就如实告知用户、等用户决定，
+ *   **不自行 cancel**。
  *
  * 本工具的职责边界：
  *   - **取消 Task 本身**（task.status = "cancelled"）
@@ -15,9 +21,11 @@
  *     task_cancel 停 Task 记录）。两者正交，default agent 可能需要连用：
  *     先 stop_task 掐掉还在跑的 sub-agent，再 task_cancel 取消任务记录。
  *
- * 终态 hook：`cancelled` 属于 TASK_COMPLETE_TERMINAL_STATUSES
- *   ⇒ 走 taskComponent.updateTask ⇒ 自动 fire AFTER_COMPLETE
- *   ⇒ 飞书终态通知 / lark-card 状态机正常收敛，无需额外接线。
+ * 终态 hook：`cancelled` 属于 TASK_COMPLETE_TERMINAL_STATUSES。
+ *   ⚠️ Task #5073 设计调整②：updateTask **不再** fire
+ *   AFTER_COMPLETE —— 终态通知走 task:after.update
+ *   （lark-card 状态机 cardStatusOf 覆盖 completed/cancelled/
+ *   archived 等），本工具无需额外接线。
  */
 import type { Tool } from "../../tool/types";
 import type { TaskComponent } from "../task-component";

package/dist/env/task/tools/completion-copy.d.ts

@@ -25,3 +25,95 @@ export declare const TASK_COMPLETE_ACCEPTANCE: {
     readonly hintAnchor: "TASK_COMPLETION_HINT";
     readonly verifyDuty: "核实义务";
 };
+/**
+ * Task #5060 — 终态 current_status 文案同源锚点
+ *
+ * 背景：`task_complete` / `task_cancel` 原来只改 status/progress，
+ * **完全不碰 current_status** ⇒ 任务落终态后 current_status 仍留着
+ * 完成前的旧文案（如「按用户方案 X 决定暂停：未 commit」），出现
+ * 「status=completed 但描述说没做完」的自相矛盾状态。
+ *
+ * 修复：终态工具在同一次 updateTask 里把 current_status 一起写成终态语义。
+ * 下面的短语是「终态 current_status」的**唯一措辞来源** ——
+ * task-component（完成）/ cancel-tool（取消）都引用它，避免两处漂移。
+ */
+/** 完成态 current_status 的核心语义词 */
+export declare const TASK_COMPLETED_STATUS_WORD = "\u5DF2\u5B8C\u6210";
+/** 取消态 current_status 的核心语义词 */
+export declare const TASK_CANCELLED_STATUS_WORD = "\u5DF2\u53D6\u6D88";
+/** 交付物已记录的前缀（跟在终态词之后） */
+export declare const TASK_DELIVERABLE_RECORDED = "\u4EA4\u4ED8\u7269\u5DF2\u8BB0\u5F55";
+/**
+ * Task #5063 — 归档态 current_status 的核心语义词
+ *
+ * 背景（Task #5060 的 follow-up，DS review 留档 MINOR m2）：
+ *   `archived` 是「终态 current_status 不刷新」这个 bug 的**第四个出口**。
+ *   #5060 只修了 completed / cancelled 两条路径，导致走归档路径
+ *   （`tasks complete --archive`、批量归档工具、通用 task_update）
+ *   的任务完成后 current_status 仍留着归档前的旧文案。
+ *
+ *   本锚点与 TASK_COMPLETED_STATUS_WORD / TASK_CANCELLED_STATUS_WORD 并列，
+ *   是「归档态 current_status」的**唯一措辞来源**。
+ */
+export declare const TASK_ARCHIVED_STATUS_WORD = "\u5DF2\u5F52\u6863";
+/**
+ * Task #5067 — reopen（终态 → 非终态）后 current_status 的核心语义词
+ *
+ * 背景（Task #5063 DS review 留档 MINOR m1）：
+ *   #5063 只收口了「**迁入**终态时刷新 current_status」，**反向**路径没管：
+ *   任务从终态被 reopen 回 active/todo 时，current_status 仍停在终态文案
+ *   （"已归档" / "已取消" / "已完成"）⇒ 出现
+ *       status: active / current_status: "已归档"     ← 说反了
+ *
+ * 为什么措辞是「已重新打开」而不是清空：
+ *   卡片渲染（lark-card-patch-notifier.ts）与 CLI（tasks get / tasks search）
+ *   都用 `if (current_status)` 守卫 —— **空串会让整行消失**，用户看到的是
+ *   一张没有「📶 当前状态」行的卡片，而不是「已重新打开」。
+ *   「已重新打开」非空、可渲染、语义明确（区别于「已完成」这类终态词）。
+ */
+export declare const TASK_REOPENED_STATUS_WORD = "\u5DF2\u91CD\u65B0\u6253\u5F00";
+/**
+ * Task #5073 — 待验证（to_validate）current_status 的核心语义词
+ *
+ * 两阶段验收（#5007 的机制化落地）：
+ *   sub-agent 干完 → `task_pre_complete` → status=to_validate，
+ *   current_status 刷成「待验证」；default agent `task_complete`
+ *   校验通过后才落 completed（措辞 TASK_COMPLETED_STATUS_WORD）。
+ *
+ * 与终态措辞（TASK_COMPLETED_STATUS_WORD 等）并列但**不入**
+ * TASK_TERMINAL_STATUS_WORDS —— to_validate 是**非终态**
+ * （reopen 反向收口管不着它：从 to_validate 迁出时 current_status
+ * 本来就该带「待验证」语义，由 withTerminalCurrentStatus 的
+ * 非终态分支按调用方意图处理）。
+ */
+export declare const TASK_TO_VALIDATE_STATUS_WORD = "\u5F85\u9A8C\u8BC1";
+/**
+ * Task #5067 — 终态 current_status 措辞锚点集合（reopen 判定的**唯一**依据）
+ *
+ * 用途：`withTerminalCurrentStatus` 在「迁出终态」时，需要判断当前
+ * current_status 是不是**系统写的终态文案**（而不是调用方自己写的）。
+ * 判定方式 = current_status 以本集合中任一锚点**开头**。
+ *
+ * ⚠️ 为什么用 startsWith 而不是 includes：
+ *   终态文案可能带后缀（如「已归档：批量整理」「已完成（交付物已记录：/x.md）」），
+ *   但**开头**的锚点才是系统写的语义主体。反过来，包含判断会误伤
+ *   调用方自己写的「已完成的部分：A/B/C」这类正常文案。
+ *
+ * ⚠️ 边界取舍（已知且接受）：
+ *   若调用方**恰好手动写了**以「已完成」/「已取消」/「已归档」开头的文案，
+ *   且任务当时正处于终态，reopen 时该文案会被系统措辞替换。
+ *   这是「值比对」方案的固有代价 —— 用「前态 status 是终态」这一额外条件
+ *   把它压到极窄（只在真的从终态迁出、且文案形状与系统措辞完全一致时触发）。
+ */
+export declare const TASK_TERMINAL_STATUS_WORDS: readonly ["已完成", "已取消", "已归档"];
+/**
+ * ★ Task #5073（DS review r4 MINOR-3）— 终态护栏集合的同源锚点：
+ *   已终态（cancelled / archived）任务**不可**被「验收通过」翻转成
+ *   completed。消费点：TaskComponent.completeTask（组件层护栏，
+ *   兜底 CLI / 直连通道）+ complete-tool.ts（tool 层友好报错）。
+ *
+ *   ⚠️ to_validate / active / todo / paused **不在**集合里 ——
+ *   规范路径 to_validate → completed 与兜底路径 active →
+ *   completed（#5054 补验收）都必须放行。
+ */
+export declare const TERMINAL_NON_ACCEPTABLE_STATUSES: readonly ["cancelled", "archived"];

package/dist/env/task/tools/index.d.ts

@@ -11,4 +11,5 @@ export { updateTaskTool } from "./update-tool";
 export { deleteTaskTool } from "./delete-tool";
 export { completeTaskTool } from "./complete-tool";
 export { cancelTaskTool } from "./cancel-tool";
+export { preCompleteTaskTool } from "./pre-complete-tool";
 export { treeTasksTool } from "./task-tree-tool";

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

@@ -7,12 +7,14 @@ import {
   deleteTaskTool,
   getTaskTool,
   listTasksTool,
+  preCompleteTaskTool,
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-hnyk1by7.js";
+} from "../../../shared/@ai-setting/roy-agent-core-vffccgf6.js";
 import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
-import"../../../shared/@ai-setting/roy-agent-core-11shp00p.js";
+import"../../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
+import"../../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
 import"../../../shared/@ai-setting/roy-agent-core-7cbpmk4q.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
@@ -22,6 +24,7 @@ export {
   updateTaskTool,
   treeTasksTool,
   searchTasksTool,
+  preCompleteTaskTool,
   listTasksTool,
   getTaskTool,
   deleteTaskTool,

package/dist/env/task/tools/operation/operation-types.d.ts

@@ -82,31 +82,31 @@ export declare const CreateOperationToolSchema: z.ZodEffects<z.ZodObject<{
     md_path: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     task_id: number;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     milestone_title?: string | undefined;
     milestone_description?: string | undefined;
     process_description?: string | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     action_title?: string | undefined;
     action_description?: string | undefined;
     md_path?: string | undefined;
 }, {
     task_id: number;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     milestone_title?: string | undefined;
     milestone_description?: string | undefined;
     process_description?: string | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     action_title?: string | undefined;
     action_description?: string | undefined;
     md_path?: string | undefined;
 }>, CreateOperationToolParams, {
     task_id: number;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     milestone_title?: string | undefined;
     milestone_description?: string | undefined;
     process_description?: string | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     action_title?: string | undefined;
     action_description?: string | undefined;
     md_path?: string | undefined;
@@ -144,17 +144,17 @@ export declare const ListOperationsToolSchema: z.ZodEffects<z.ZodObject<{
     task_id: number;
     limit: number;
     offset: number;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
 }, {
     task_id: number;
     limit?: number | undefined;
     offset?: number | undefined;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
 }>, {
     task_id: number;
-    milestone_type: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     limit: number;
     offset: number;
     _deprecated_fields_used: string[];
@@ -162,8 +162,8 @@ export declare const ListOperationsToolSchema: z.ZodEffects<z.ZodObject<{
     task_id: number;
     limit?: number | undefined;
     offset?: number | undefined;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
 }>;
 export interface ListOperationsToolParams {
     task_id: number;

package/dist/env/task/tools/pre-complete-tool.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Task Pre-Complete Tool (Task #5073 — 两阶段验收)
+ *
+ * 需求（用户 2026-11-06 飞书原话）：
+ *   「给 subagent 添加一个跟 task_complete 类似的工具，比如
+ *     task_pre_complete，sub agent 觉得可以完成了就传入交付物等参数，
+ *     task 状态变为待验证（to_validate），default agent 调用
+ *     task_complete 校验之后状态正式完成。」
+ *
+ * 职责边界（沿用 #5007「执行与验收分离」架构）：
+ *   - **执行方（roy sub-agent）**：干完活 → task_pre_complete 提交待验证
+ *     （status → to_validate + 交付物落 context/operation）
+ *   - **验收方（default agent）**：task_complete 逐条验收 → completed
+ *
+ * 与 task_complete 的关系：
+ *   - 参数同构（deliverable_storage_path），调用体验一致
+ *   - 语义不同：这里只是「提交待验证」，不是终态 —— 会 fire 一次
+ *     AFTER_COMPLETE（terminalStatus="to_validate"）作为 goal 检查
+ *     自查关（design v2 #38603），卡片保持 running 更新态
+ *
+ * current_status 同步：走 TaskComponent.preCompleteTask →
+ * updateTask（withTerminalCurrentStatus 收口模式之外的本层显式文案，
+ * 措辞同源锚点 TASK_TO_VALIDATE_STATUS_WORD = 「待验证」，
+ * 见 tools/completion-copy.ts —— 与 #5060 的 completed/cancelled 同模式）。
+ */
+import type { Tool } from "../../tool/types";
+import type { TaskComponent } from "../task-component";
+/**
+ * task_pre_complete 工具描述（导出便于单测和 reuse）
+ */
+export declare const TASK_PRE_COMPLETE_DESCRIPTION: string;
+export declare function preCompleteTaskTool(taskComponent: TaskComponent): Tool;

package/dist/env/task/tools/task-types.d.ts

@@ -87,7 +87,7 @@ export type GetTaskToolParams = z.infer<typeof GetTaskToolSchema>;
  * task_list tool parameters
  */
 export declare const ListTasksToolSchema: z.ZodObject<{
-    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -99,12 +99,12 @@ export declare const ListTasksToolSchema: z.ZodObject<{
     offset: number;
     include_archived: boolean;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     depth?: number | undefined;
 }, {
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
@@ -119,7 +119,7 @@ export declare const SearchTasksToolSchema: z.ZodObject<{
     keywords: z.ZodArray<z.ZodString, "many">;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
     exclude_task_id: z.ZodOptional<z.ZodNumber>;
@@ -131,14 +131,14 @@ export declare const SearchTasksToolSchema: z.ZodObject<{
     include_archived: boolean;
     keywords: string[];
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     depth?: number | undefined;
     exclude_task_id?: number | undefined;
 }, {
     keywords: string[];
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
@@ -155,7 +155,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
 } & {
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
     progress: z.ZodOptional<z.ZodNumber>;
@@ -169,7 +169,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     task_id: number;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     progress?: number | undefined;
@@ -184,7 +184,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
 }, {
     task_id: number;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     progress?: number | undefined;
@@ -199,7 +199,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     task_id: number;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;
     progress?: number | undefined;
@@ -228,26 +228,58 @@ export type DeleteTaskToolParams = z.infer<typeof DeleteTaskToolSchema>;
  * task_complete tool parameters
  *
  * Task #2778: 新增 deliverable_storage_path 参数。
- * 调用方在完成任务时，应提供实际交付物的寻址地址，便于后续追溯。
+ * Task #5073 设计调整① — task_complete 精简为**纯验收动作**：
  *
- * 支持任意形式的寻址：本地文件路径 / 飞书 doc URL / git 分支名 / GitHub PR/commit URL。
- * 该参数会持久化到 task.context.deliverable_storage_path。
+ *   deliverable_storage_path 入参已删除（用户 2026-11-06 明令）。
+ *   交付物在 pre_complete 阶段（task_pre_complete）提交落库
+ *   （task.context.deliverable_storage_path + operation Deliverable 行），
+ *   task_complete 只做状态修改验收：逐条核对 goals 子项后
+ *   把 to_validate → completed（TASK_COMPLETION_TERMINAL）。
+ *
+ *   ⚠️ 交付物通道 = task_pre_complete，验收通道 = task_complete ——
+ *     两者职责分离后，交付物参数不该再出现在 complete 的 schema 里。
+ *
+ *   兼容性：unknown-key 被 zod 静默剥离（withLegacyTaskId 的 object
+ *   不含 additionalProperties:false）→ 老调用方传了 deliverable 也
+ *   不报错，只是不再被读取。CLI / TaskStoreBackend（MCP 通道）的
+ *   completeTask(deliverable) 底层签名保留（#5060 修复链不破坏）。
  */
 export declare const CompleteTaskToolSchema: z.ZodEffects<z.ZodObject<{
     task_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    task_id: number;
+}, {
+    task_id: number;
+}>, {
+    task_id: number;
+}, unknown>;
+export type CompleteTaskToolParams = z.infer<typeof CompleteTaskToolSchema>;
+/**
+ * task_pre_complete tool parameters (Task #5073 — 两阶段验收)
+ *
+ * sub-agent 交付时调用：把任务置为 to_validate（待验证），
+ * 交付物参数与 task_complete 完全同构（deliverable_storage_path），
+ * 让执行方「提交待验证」的调用体验与验收方「落终态」一致。
+ */
+export declare const PreCompleteTaskToolSchema: z.ZodEffects<z.ZodObject<{
+    task_id: z.ZodNumber;
 } & {
     deliverable_storage_path: z.ZodOptional<z.ZodString>;
+    current_status: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     task_id: number;
+    current_status?: string | undefined;
     deliverable_storage_path?: string | undefined;
 }, {
     task_id: number;
+    current_status?: string | undefined;
     deliverable_storage_path?: string | undefined;
 }>, {
     task_id: number;
+    current_status?: string | undefined;
     deliverable_storage_path?: string | undefined;
 }, unknown>;
-export type CompleteTaskToolParams = z.infer<typeof CompleteTaskToolSchema>;
+export type PreCompleteTaskToolParams = z.infer<typeof PreCompleteTaskToolSchema>;
 /**
  * task_cancel tool parameters (Task #5007)
  *
@@ -304,7 +336,7 @@ export type BatchDeleteToolParams = z.infer<typeof BatchDeleteToolSchema>;
 export declare const TreeTasksToolSchema: z.ZodObject<{
     depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     parent_task_id: z.ZodOptional<z.ZodNumber>;
-    status: z.ZodOptional<z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>>;
+    status: z.ZodOptional<z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>>;
     priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     type: z.ZodOptional<z.ZodEnum<["normal", "cycle", "longterm"]>>;
     include_archived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -312,12 +344,12 @@ export declare const TreeTasksToolSchema: z.ZodObject<{
     depth: number;
     include_archived: boolean;
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     parent_task_id?: number | undefined;
 }, {
     type?: "normal" | "cycle" | "longterm" | undefined;
-    status?: "todo" | "active" | "completed" | "paused" | "cancelled" | "archived" | undefined;
+    status?: "todo" | "active" | "to_validate" | "completed" | "paused" | "cancelled" | "archived" | undefined;
     priority?: "low" | "medium" | "high" | undefined;
     parent_task_id?: number | undefined;
     depth?: number | undefined;

package/dist/env/task/types.d.ts

@@ -4,8 +4,20 @@
 import { z } from "zod";
 /**
  * Task status enum
+ *
+ * ★ Task #5073 — 新增 `to_validate`（待验证）。
+ *
+ * 两阶段验收（#5007 的机制化落地）：
+ *   sub-agent 干完 → task_pre_complete → status=to_validate（待验证）
+ *   default agent  → task_complete    → status=completed（正式完成）
+ *
+ * ⚠️ 其余 6 个旧状态（todo/active/completed/paused/cancelled/archived）
+ *   **全部保留** —— 存量库有 paused/cancelled/archived 记录，
+ *   不做状态迁移、不删任何旧值（用户 2026-11-06 明令修正）。
+ *   to_validate 是唯一的**新增**状态，是「非终态」（可被 task_complete
+ *   落成 completed，也可被 reopen 回 active）。
  */
-export declare const TaskStatusEnum: z.ZodEnum<["todo", "active", "completed", "paused", "cancelled", "archived"]>;
+export declare const TaskStatusEnum: z.ZodEnum<["todo", "active", "to_validate", "completed", "paused", "cancelled", "archived"]>;
 export type TaskStatus = z.infer<typeof TaskStatusEnum>;
 /**
  * Task priority enum

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

@@ -1,8 +1,8 @@
 import {
   LarkCliWorkflowNotifyHook,
   createLarkCliWorkflowNotifyHook
-} from "../../../shared/@ai-setting/roy-agent-core-p3zv1mx5.js";
-import"../../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+} from "../../../shared/@ai-setting/roy-agent-core-hd3n57zs.js";
+import"../../../shared/@ai-setting/roy-agent-core-w0qjeq2v.js";
 import"../../../shared/@ai-setting/roy-agent-core-c2gbt68e.js";
 import"../../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
 import"../../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";

package/dist/env/workflow/types/event.d.ts

@@ -206,17 +206,17 @@ export declare const NodeProgressEventSchema: z.ZodObject<{
     message: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "node.progress";
+    progress: number;
     run_id: string;
     timestamp: number;
     node_id: string;
-    progress: number;
     message?: string | undefined;
 }, {
     type: "node.progress";
+    progress: number;
     run_id: string;
     timestamp: number;
     node_id: string;
-    progress: number;
     message?: string | undefined;
 }>;
 export declare const NodeCompletedEventSchema: z.ZodObject<{
@@ -632,17 +632,17 @@ export declare const WorkflowEventSchema: z.ZodUnion<[z.ZodObject<{
     message: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "node.progress";
+    progress: number;
     run_id: string;
     timestamp: number;
     node_id: string;
-    progress: number;
     message?: string | undefined;
 }, {
     type: "node.progress";
+    progress: number;
     run_id: string;
     timestamp: number;
     node_id: string;
-    progress: number;
     message?: string | undefined;
 }>, z.ZodObject<{
     run_id: z.ZodString;