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

package/dist/env/task/index.js

@@ -5,26 +5,32 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-4gr3k7qg.js";
+} from "../../shared/@ai-setting/roy-agent-core-z43aj03k.js";
 import"../../shared/@ai-setting/roy-agent-core-2akfd64z.js";
 import"../../shared/@ai-setting/roy-agent-core-jm136jzh.js";
-import"../../shared/@ai-setting/roy-agent-core-jg65qnwa.js";
+import"../../shared/@ai-setting/roy-agent-core-aa2j7bk9.js";
 import"../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import"../../shared/@ai-setting/roy-agent-core-ntq0gz7q.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-hnyk1by7.js";
+import"../../shared/@ai-setting/roy-agent-core-vffccgf6.js";
 import"../../shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
 import"../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../../shared/@ai-setting/roy-agent-core-3e6gg17d.js";
+import"../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.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 {
+  TASK_ARCHIVED_STATUS_WORD,
+  TASK_CANCELLED_STATUS_WORD,
+  TASK_COMPLETED_STATUS_WORD,
+  TASK_DELIVERABLE_RECORDED
+} from "../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
 import"../../shared/@ai-setting/roy-agent-core-ed233k5z.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
@@ -46,6 +52,10 @@ export {
   TaskEntityEventTypes,
   TaskConfigSchema,
   TaskComponent,
+  TASK_DELIVERABLE_RECORDED,
+  TASK_COMPLETED_STATUS_WORD,
+  TASK_CANCELLED_STATUS_WORD,
+  TASK_ARCHIVED_STATUS_WORD,
   SQLiteTaskStore,
   ActionTypeEnum
 };

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

@@ -6,13 +6,14 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-hnyk1by7.js";
+} from "../../../shared/@ai-setting/roy-agent-core-vffccgf6.js";
 import {
   createOperationTool,
   listOperationsTool
 } from "../../../shared/@ai-setting/roy-agent-core-p5cz9m8v.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";

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

@@ -24,18 +24,19 @@ import {
   parseExtractorOutput,
   registerLayaCompletionTaskHook,
   renderCompletionState
-} from "../../../shared/@ai-setting/roy-agent-core-y7x2qzwc.js";
+} from "../../../shared/@ai-setting/roy-agent-core-ghnagzrh.js";
 import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../../../shared/@ai-setting/roy-agent-core-3e6gg17d.js";
+import"../../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
 import"../../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"../../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import {
   TASK_COMPLETE_ACCEPTANCE,
   TASK_COMPLETE_ITEM_BY_ITEM,
   TASK_COMPLETE_VERIFY_DUTY,
   TASK_COMPLETION_HINT_ANCHOR
-} from "../../../shared/@ai-setting/roy-agent-core-11shp00p.js";
+} from "../../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
 import {
   DEFAULT_APP_LINK_BASE,
   LarkCardPatchNotifier,

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

@@ -5,7 +5,8 @@ import {
   TASK_DISCIPLINE_LIFECYCLE,
   TASK_DISCIPLINE_OPERATION,
   TASK_DISCIPLINE_PROMPT
-} from "../../../shared/@ai-setting/roy-agent-core-11shp00p.js";
+} from "../../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
+import"../../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   TASK_DISCIPLINE_PROMPT,

package/dist/env/task/prompt/task-discipline.d.ts

@@ -33,6 +33,6 @@ export declare const TASK_DISCIPLINE_GOALS = "### Goals \u5B50\u9879\u62C6\u5206
  *   执行方（roy sub-agent）**没有** `task_complete` 权限，不适用本分片。
  *   为避免执行方误读，段落开头显式声明「仅验收方适用」。
  */
-export declare const TASK_DISCIPLINE_COMPLETE = "### Task Complete \u2014 \u6838\u5B9E\u4E49\u52A1\uFF08**\u4EC5\u9A8C\u6536\u65B9\u9002\u7528**\uFF09\n\n> \u26A0\uFE0F **\u89D2\u8272\u4F5C\u7528\u57DF\uFF08Task #5007\uFF09**\uFF1A\u672C\u8282\u662F**\u9A8C\u6536\u65B9**\uFF08default agent / \u63A5\u5F85\u5458\uFF09\u7684\u52A8\u4F5C\u3002\n> \u82E5\u4F60\u662F**\u6267\u884C\u65B9**\uFF08roy sub-agent\uFF09\uFF0C\u4F60\u6CA1\u6709 `task_complete` \u6743\u9650 \u2014\u2014\n> \u4F60\u7684\u6536\u5C3E\u52A8\u4F5C\u662F\u300C\u8FDB\u5EA6\u63A8\u5230 100% + \u8BB0\u5B8C\u64CD\u4F5C\u8BB0\u5F55 + \u7ED3\u675F\u8FD4\u56DE\u300D\uFF0C\u9A8C\u6536\u7531\u4E3B\u667A\u80FD\u4F53\u8D1F\u8D23\u3002\n\nBefore calling `task_complete`, you MUST:\n\n1. Read the task's `goal` (description) and `delivery` (goals_and_expected_deliverables) fields.\n   - Use `task_get(task_id=<id>)` to fetch the full task record.\n2. **Validate whether each goal sub-item was achieved** \u2014 accept the goal\n   **item-by-item** (\u6309\u5B50\u9879\u9010\u6761\u9A8C\u6536).\n   - Goals should be numbered sub-items (\u7F16\u53F7\u5B50\u9879). Check\n     each sub-item against the operation-record chain (\u64CD\u4F5C\u8BB0\u5F55\u94FE) and the\n     deliverable evidence (context.deliverable_storage_path).\n   - The completion hook (task:after.complete) judges the whole goal vs.\n     deliverables; numbered sub-items give it finer-grained evidence to\n     reason with (\u9010\u6761\u5BF9\u7167\u7684\u8BC1\u636E\u7C92\u5EA6). If it detects that the goal or\n     deliverables appear unmet, the task context will carry a\n     `[TASK_COMPLETION_HINT]`.\n   - **If you receive a [TASK_COMPLETION_HINT]**, you MUST verify it\n     (\u6838\u5B9E\u4E49\u52A1): re-read the task via `task_get`, then do exactly one of:\n     (a) \u786E\u8BA4\u672A\u5B8C\u6210 \u2192 **\u91CD\u65B0\u59D4\u6258**\uFF08\u7528\u4F60\u7684\u59D4\u6258\u5DE5\u5177 + \u540C\u4E00 sub-session \u7EED\u8DD1\uFF0C\n         \u5728\u6307\u4EE4\u91CC\u5199\u660E\"\u76EE\u6807\u5C1A\u672A\u8FBE\u6210\uFF0C\u9700\u8981\u8865 X/Y/Z\"\uFF09\uFF0C\u7531 sub-agent \u7528\n         `task_update(status=active)` \u91CD\u5F00\u5E76\u7EE7\u7EED\u63A8\u8FDB\uFF1B\u82E5\u4F60**\u81EA\u5DF1\u5C31\u662F\u6267\u884C\u65B9**\n         \uFF08\u6709 `task_update` \u6743\u9650\uFF09\uFF0C\u5219\u76F4\u63A5 `task_update(status=todo)` \u91CD\u5F00\uFF1B\u6216\n     (b) \u786E\u8BA4\u5DF2\u5B8C\u6210 \u2192 **\u7528\u4F60\u624B\u4E0A\u6709\u6743\u9650\u7684\u5199\u5DE5\u5177**\u843D\u4E00\u6761 `decision` \u7C7B\u64CD\u4F5C\u8BB0\u5F55\n         \uFF08`task_operation_create`\uFF0Cmilestone_type=decision\uFF0Cmilestone_title=<\u4E00\u884C\u7ED3\u8BBA>\uFF09\n         \u8BF4\u660E\u5B50\u9879\u5B9E\u9645\u5DF2\u8FBE\u6210\uFF08\u8BF4\u660E\u7406\u7531\uFF09\u3002\u82E5\u4F60\u6CA1\u6709\u8BE5\u5DE5\u5177\u7684\u6743\u9650\uFF08\u9A8C\u6536\u65B9\u573A\u666F\uFF09\uFF0C\n         \u5C31\u901A\u8FC7\u4F60\u7684**\u59D4\u6258\u5DE5\u5177**\u8BA9 sub-agent \u4EE3\u5199\u8FD9\u6761\u8BB0\u5F55\uFF0C\u6216\u5728 `task_complete`\n         \u7684 `deliverable_storage_path` / \u6700\u7EC8\u6C47\u62A5\u91CC\u660E\u786E\u5199\u51FA\u6838\u5B9E\u7ED3\u8BBA\u4E0E\u8BC1\u636E\u3002\n     Never ignore it (\u4E0D\u5141\u8BB8\u65E0\u89C6).\n     \u26A0\uFE0F **\u6838\u5B9E\u4E49\u52A1\u7684\u4E24\u6761\u8DEF\u5F84\u90FD\u4F9D\u8D56\u5199\u6743\u9650**\uFF08`task_update` / `task_operation_create`\uFF09\u3002\n     \u82E5\u8FD9\u4E9B\u5DE5\u5177\u5BF9\u4F60**\u4E0D\u53EF\u7528**\uFF08\u5982\u9A8C\u6536\u65B9\u4E0D\u6301\u6709\u6267\u884C\u7C7B\u5DE5\u5177\uFF09\uFF0C\u5FC5\u987B**\u6539\u7528\u59D4\u6258**\u628A\u52A8\u4F5C\n     \u4EA4\u56DE\u7ED9\u6709\u6743\u9650\u7684 sub-agent \u6267\u884C \u2014\u2014 \u4E0D\u8981\u8BD5\u56FE\u8C03\u7528\u4E0D\u53EF\u7528\u7684\u5DE5\u5177\uFF08\u4F1A\u88AB\u62E6\u6389\u5E76\u6D6A\u8D39\u4E00\u8F6E\u8FED\u4EE3\uFF09\u3002\n   - If the goal and delivery mismatch **without** a hint, either:\n     (a) extend the task via `task_update`, or\n     (b) record the discrepancy via `task_operation_create`\n         (milestone_type=decision) \u2014 the reason **must** land in the\n         operation record (\u5FC5\u987B\u843D\u5230\u64CD\u4F5C\u8BB0\u5F55\u91CC), not merely a line in\n         your final report (\u4E0D\u80FD\u53EA\u5728\u62A5\u544A\u91CC\u5E26\u4E00\u53E5).\n3. **Provide `deliverable_storage_path`** parameter with the deliverable's address.\n   It may name **multiple paths** (multiple deliverables), space-separated\n   (`/tmp/report.md /tmp/diff.patch`) \u2014 the judge splits on whitespace as\n   well as `,` `;` `\u3001` and ` + `. A local path may also be written in its\n   `file://` form (`file:///tmp/report.md`) \u2014 the scheme is stripped and the\n   path kept. Declare **every** artefact you produced: a path left out reads\n   as \"not produced\".\n   - Feishu doc URL (e.g., https://my.feishu.cn/docx/abc)\n   - Local file path (e.g., /tmp/report.md)\n   - Git branch or worktree path (e.g., feature/my-feature)\n   - GitHub commit URL or PR URL\n   - Cloud drive URL (e.g., https://my.feishu.cn/file/abc)\n   - Or any other locator that points to where the work product lives\n\nThe `deliverable_storage_path` will be persisted to the task's\n`context.deliverable_storage_path` for future reference and traceability.";
+export declare const TASK_DISCIPLINE_COMPLETE = "### Task Complete \u2014 \u6838\u5B9E\u4E49\u52A1\uFF08**\u4EC5\u9A8C\u6536\u65B9\u9002\u7528**\uFF09\n\n> \u26A0\uFE0F **\u89D2\u8272\u4F5C\u7528\u57DF\uFF08Task #5007\uFF09**\uFF1A\u672C\u8282\u662F**\u9A8C\u6536\u65B9**\uFF08default agent / \u63A5\u5F85\u5458\uFF09\u7684\u52A8\u4F5C\u3002\n> \u82E5\u4F60\u662F**\u6267\u884C\u65B9**\uFF08roy sub-agent\uFF09\uFF0C\u4F60\u6CA1\u6709 `task_complete` \u6743\u9650 \u2014\u2014\n> \u4F60\u7684\u6536\u5C3E\u52A8\u4F5C\u662F\u300C\u8FDB\u5EA6\u63A8\u5230 100% + \u8BB0\u5B8C\u64CD\u4F5C\u8BB0\u5F55 + \u7ED3\u675F\u8FD4\u56DE\u300D\uFF0C\u9A8C\u6536\u7531\u4E3B\u667A\u80FD\u4F53\u8D1F\u8D23\u3002\n\nBefore calling `task_complete`, you MUST:\n\n1. Read the task's `goal` (description) and `delivery` (goals_and_expected_deliverables) fields.\n   - Use `task_get(task_id=<id>)` to fetch the full task record.\n2. **Validate whether each goal sub-item was achieved** \u2014 accept the goal\n   **item-by-item** (\u6309\u5B50\u9879\u9010\u6761\u9A8C\u6536).\n   - Goals should be numbered sub-items (\u7F16\u53F7\u5B50\u9879). Check\n     each sub-item against the operation-record chain (\u64CD\u4F5C\u8BB0\u5F55\u94FE) and the\n     deliverable evidence (context.deliverable_storage_path).\n   - The completion hook (task:after.complete) judges the whole goal vs.\n     deliverables; numbered sub-items give it finer-grained evidence to\n     reason with (\u9010\u6761\u5BF9\u7167\u7684\u8BC1\u636E\u7C92\u5EA6). If it detects that the goal or\n     deliverables appear unmet, the task context will carry a\n     `[TASK_COMPLETION_HINT]`.\n   - **If you receive a [TASK_COMPLETION_HINT]**, you MUST verify it\n     (\u6838\u5B9E\u4E49\u52A1): re-read the task via `task_get`, then do exactly one of:\n     (a) \u786E\u8BA4\u672A\u5B8C\u6210 \u2192 **\u91CD\u65B0\u59D4\u6258**\uFF08\u7528\u4F60\u7684\u59D4\u6258\u5DE5\u5177 + \u540C\u4E00 sub-session \u7EED\u8DD1\uFF0C\n         \u5728\u6307\u4EE4\u91CC\u5199\u660E\"\u76EE\u6807\u5C1A\u672A\u8FBE\u6210\uFF0C\u9700\u8981\u8865 X/Y/Z\"\uFF09\uFF0C\u7531 sub-agent \u7528\n         `task_update(status=active)` \u91CD\u5F00\u5E76\u7EE7\u7EED\u63A8\u8FDB\uFF1B\u82E5\u4F60**\u81EA\u5DF1\u5C31\u662F\u6267\u884C\u65B9**\n         \uFF08\u6709 `task_update` \u6743\u9650\uFF09\uFF0C\u5219\u76F4\u63A5 `task_update(status=todo)` \u91CD\u5F00\uFF1B\u6216\n     (b) \u786E\u8BA4\u5DF2\u5B8C\u6210 \u2192 **\u7528\u4F60\u624B\u4E0A\u6709\u6743\u9650\u7684\u5199\u5DE5\u5177**\u843D\u4E00\u6761 `decision` \u7C7B\u64CD\u4F5C\u8BB0\u5F55\n         \uFF08`task_operation_create`\uFF0Cmilestone_type=decision\uFF0Cmilestone_title=<\u4E00\u884C\u7ED3\u8BBA>\uFF09\n         \u8BF4\u660E\u5B50\u9879\u5B9E\u9645\u5DF2\u8FBE\u6210\uFF08\u8BF4\u660E\u7406\u7531\uFF09\u3002\u82E5\u4F60\u6CA1\u6709\u8BE5\u5DE5\u5177\u7684\u6743\u9650\uFF08\u9A8C\u6536\u65B9\u573A\u666F\uFF09\uFF0C\n         \u5C31\u901A\u8FC7\u4F60\u7684**\u59D4\u6258\u5DE5\u5177**\u8BA9 sub-agent \u4EE3\u5199\u8FD9\u6761\u8BB0\u5F55\uFF0C\u6216\u5728\u6700\u7EC8\u6C47\u62A5\u91CC\n         \u660E\u786E\u5199\u51FA\u6838\u5B9E\u7ED3\u8BBA\u4E0E\u8BC1\u636E\u3002\n     Never ignore it (\u4E0D\u5141\u8BB8\u65E0\u89C6).\n     \u26A0\uFE0F **\u6838\u5B9E\u4E49\u52A1\u7684\u4E24\u6761\u8DEF\u5F84\u90FD\u4F9D\u8D56\u5199\u6743\u9650**\uFF08`task_update` / `task_operation_create`\uFF09\u3002\n     \u82E5\u8FD9\u4E9B\u5DE5\u5177\u5BF9\u4F60**\u4E0D\u53EF\u7528**\uFF08\u5982\u9A8C\u6536\u65B9\u4E0D\u6301\u6709\u6267\u884C\u7C7B\u5DE5\u5177\uFF09\uFF0C\u5FC5\u987B**\u6539\u7528\u59D4\u6258**\u628A\u52A8\u4F5C\n     \u4EA4\u56DE\u7ED9\u6709\u6743\u9650\u7684 sub-agent \u6267\u884C \u2014\u2014 \u4E0D\u8981\u8BD5\u56FE\u8C03\u7528\u4E0D\u53EF\u7528\u7684\u5DE5\u5177\uFF08\u4F1A\u88AB\u62E6\u6389\u5E76\u6D6A\u8D39\u4E00\u8F6E\u8FED\u4EE3\uFF09\u3002\n   - If the goal and delivery mismatch **without** a hint, either:\n     (a) extend the task via `task_update`, or\n     (b) record the discrepancy via `task_operation_create`\n         (milestone_type=decision) \u2014 the reason **must** land in the\n         operation record (\u5FC5\u987B\u843D\u5230\u64CD\u4F5C\u8BB0\u5F55\u91CC), not merely a line in\n         your final report (\u4E0D\u80FD\u53EA\u5728\u62A5\u544A\u91CC\u5E26\u4E00\u53E5).\n3. Deliverables were submitted by the executor via `task_pre_complete`\n   (Task #5073 two-phase acceptance): they live in\n   `context.deliverable_storage_path` and the operation trail\n   (`Deliverable: <path>` lines). Cross-check them in step 2.\n   `task_complete` takes **no** deliverable parameter \u2014 if the\n   deliverables are missing from the record, re-delegate instead of\n   asking for a path here.";
 /** 完整纪律正文（主出口）：4 分片拼装 */
 export declare const TASK_DISCIPLINE_PROMPT: string;

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

@@ -213,6 +213,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 +326,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
      */

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/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/index.d.ts

@@ -31,7 +31,7 @@ export { cascadeStopSessionTree, type CascadeStopOptions, type CascadeStopResult
 export { createMemoryAgentTools, } from "./env/memory/tools/memory-agent-tools";
 export type { SearchSessionsParams, GetSessionParams, WriteMemoryParams, } from "./env/memory/tools/memory-agent-tools";
 export { getBuiltInPrompt, getBuiltInPromptNames, } from "./env/prompt/prompts-index";
-export { TaskComponent, SQLiteTaskStore, getDefaultTaskDbPath, } from "./env/task";
+export { TaskComponent, SQLiteTaskStore, getDefaultTaskDbPath, TASK_COMPLETED_STATUS_WORD, TASK_CANCELLED_STATUS_WORD, TASK_ARCHIVED_STATUS_WORD, TASK_DELIVERABLE_RECORDED, } from "./env/task";
 export type { Task, TaskOperation, TaskStatus, TaskPriority, ActionType, CreateTaskOptions, UpdateTaskOptions, ListTasksOptions, CreateOperationOptions, ListOperationsOptions, TaskConfig, } from "./env/task/types";
 export { TaskTagPlugin, createAutoTaskPlugin, type AutoTaskPluginConfig, } from "./env/task/plugins";
 export { TaskHookPoints, type TaskHookPoint, } from "./env/task/hooks";