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

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

@@ -81,6 +81,25 @@ export interface TaskBackend {
      * - `cycle` 类型任务拒绝完成（roy 语义）
      */
     completeTask(id: TaskId, sessionId?: string, deliverable?: string): Promise<Task | null>;
+    /**
+     * 提交待验证（Task #5073 两阶段验收的第一阶段，Task #5078）。
+     *
+     * 契约（与 `TaskComponent.preCompleteTask` 语义同构，MCP/
+     * 插件侧共用）：
+     * - `status` → `to_validate`（**非终态**：只进验收队列）
+     * - `current_status` → 「待验证」措辞（progressSummary 拼接：
+     *   「待验证：<summary>」）
+     * - 若给了 `deliverable`，merge 进 `context.deliverable_storage_path`
+     *   并写入 submission operation 的 `milestoneDescription`
+     * - 写一条 `milestoneType: "milestone"` 的提交留痕 operation
+     *   （与 TaskComponent.preCompleteTask 的细微增强：deliverable
+     *   同时落在 operation 的 `mdPath` 字段，便于寻址）
+     * - `cycle` 类型任务拒绝提交（roy 语义，同 completeTask）
+     * - **不 fire 任何钩子**：`TaskStoreBackend` 没有 hook 链，
+     *   goal 判定由上层（MCP withGoalCheck / TaskComponent 钩子）
+     *   负责 —— 本方法只是状态落库。
+     */
+    preCompleteTask(id: TaskId, sessionId?: string, deliverable?: string, progressSummary?: string): Promise<Task | null>;
     /** 子树（所有后代，**不含** root），BFS 按层展开，`depth` 限制层数。 */
     getTaskTree(id: TaskId, depth?: number): Promise<Task[]>;
     /** 关键词检索 + 全部 roy 过滤项（review finding Y2）。 */

package/dist/env/task/delegate/delegate-tool.js

@@ -12,12 +12,13 @@ import {
   deriveTriggerEventIdFromEnvContext,
   getSubAgentSpec,
   handleBackgroundTask
-} from "../../../shared/@ai-setting/roy-agent-core-jg65qnwa.js";
+} from "../../../shared/@ai-setting/roy-agent-core-aa2j7bk9.js";
 import"../../../shared/@ai-setting/roy-agent-core-fttgm52a.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-1pg0fepg.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-ed233k5z.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";

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

@@ -5,12 +5,13 @@ import {
   BackgroundTaskEventTypes,
   BackgroundTaskManager,
   createDelegateTool
-} from "../../../shared/@ai-setting/roy-agent-core-jg65qnwa.js";
+} from "../../../shared/@ai-setting/roy-agent-core-aa2j7bk9.js";
 import"../../../shared/@ai-setting/roy-agent-core-fttgm52a.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-1pg0fepg.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-ed233k5z.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";

package/dist/env/task/hooks/contexts.d.ts

@@ -164,7 +164,18 @@ export interface TaskDelegateResultContext {
  * `timeout` 也算 task 终结（不应继续等待结果）。
  */
 export declare const TASK_COMPLETE_TERMINAL_STATUSES: readonly ["completed", "failed", "cancelled", "timeout"];
-export type TaskCompleteTerminalStatus = typeof TASK_COMPLETE_TERMINAL_STATUSES[number];
+/**
+ * ★ Task #5073（设计调整②）— to_validate 也走 AFTER_COMPLETE：
+ *
+ * AFTER_COMPLETE 的语义从「泛终态事件」收窄为「goal 检查触发点」：
+ *   - to_validate：sub-agent 提交待验证（自查关）—— decision model
+ *     在此判定「目标 vs 交付物」
+ *   - completed：验收落定（default agent 复检）
+ * failed/cancelled/timeout 仍保留在类型里（历史兼容），
+ * 但 updateTask 已**不再**触发 AFTER_COMPLETE（见 task-component.ts），
+ * 实际能看到的触发点唯一 = preCompleteTask（to_validate）。
+ */
+export type TaskCompleteTerminalStatus = typeof TASK_COMPLETE_TERMINAL_STATUSES[number] | "to_validate";
 /**
  * Task Complete Result Hook Context
  *

package/dist/env/task/hooks/task-hook-points.d.ts

@@ -17,13 +17,18 @@ export declare const TaskHookPoints: {
     /** 删除 Task 后 - 清理关联资源 */
     readonly AFTER_DELETE: "task:after.delete";
     /**
-     * Task 完成 hook —— 仅当任务状态变为 terminal (completed / failed / cancelled / timeout)
-     * 时触发。语义级别比 AFTER_UPDATE 更精确，plugin 可用于实现"任务完成时"的副作用
+     * Task 完成 hook —— 当任务进入「完成语义状态」时触发。
+     * 触发点（Task #5073 两阶段验收后）：
+     *   - task_pre_complete：terminalStatus="to_validate"
+     *     （sub-agent 提交待验证时的 goal 自查关）
+     *   - updateTask：仅 status 迁入 TASK_COMPLETE_TERMINAL_STATUSES
+     *     (completed / failed / cancelled / timeout) 时触发
+     * 语义级别比 AFTER_UPDATE 更精确，plugin 可用于实现"任务完成时"的副作用
      * (例如发送通知、刷新看板、上传结果等)。
      *
      * 注意：AFTER_COMPLETE 与 AFTER_UPDATE 不互斥。
      *   - AFTER_UPDATE 在每一次 update 成功后触发，包括 status 变更、progress 变更等
-     *   - AFTER_COMPLETE 仅在 status 进入 terminal 状态时触发
+     *   - AFTER_COMPLETE 仅在上述「完成语义」迁移时触发
      * 一个更新操作可能同时触发两个 hook。
      */
     readonly AFTER_COMPLETE: "task:after.complete";

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

@@ -4,4 +4,5 @@
 export { TaskComponent, type TaskComponentOptions } from "./task-component";
 export * from "./types";
 export { SQLiteTaskStore, getDefaultTaskDbPath, type TaskStore } from "./storage";
+export { TASK_COMPLETED_STATUS_WORD, TASK_CANCELLED_STATUS_WORD, TASK_ARCHIVED_STATUS_WORD, TASK_DELIVERABLE_RECORDED, } from "./tools/completion-copy";
 export * from "./events";

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-rhtdspx6.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"../../shared/@ai-setting/roy-agent-core-q813vafd.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";
+} from "../../shared/@ai-setting/roy-agent-core-ezvpreqz.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

@@ -3,16 +3,18 @@ import {
   createTaskTool,
   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 {
   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";
@@ -29,6 +31,7 @@ var TASK_MCP_TOOL_NAMES = [
   "task_search",
   "task_update",
   "task_complete",
+  "task_pre_complete",
   "task_operation_create",
   "task_operation_list"
 ];
@@ -55,6 +58,7 @@ var TASK_TOOL_FACTORIES = [
   searchTasksTool,
   updateTaskTool,
   completeTaskTool,
+  preCompleteTaskTool,
   createOperationTool,
   listOperationsTool
 ];

package/dist/env/task/mcp/task-mcp-server.d.ts

@@ -35,7 +35,7 @@
  */
 import type { TaskBackend } from "../backend/types";
 /** The task tools exposed over MCP. */
-export declare const TASK_MCP_TOOL_NAMES: readonly ["task_create", "task_tree", "task_get", "task_list", "task_search", "task_update", "task_complete", "task_operation_create", "task_operation_list"];
+export declare const TASK_MCP_TOOL_NAMES: readonly ["task_create", "task_tree", "task_get", "task_list", "task_search", "task_update", "task_complete", "task_pre_complete", "task_operation_create", "task_operation_list"];
 export type TaskMcpToolName = (typeof TASK_MCP_TOOL_NAMES)[number];
 /** An MCP tool definition (JSON Schema document — MCP requires JSON Schema). */
 export interface TaskMcpToolDefinition {

package/dist/env/task/plugins/fake-user-message-helper.d.ts

@@ -45,13 +45,21 @@ import type { ModelMessage } from "ai";
 /**
  * Kinds of fake user messages. Used for deterministic merge ordering.
  *
- * Priority: "max-iter" > "delegate"
+ * Priority (KIND_PRIORITY below): "max-iter" > "task-ops" > "delegate"
  * - "max-iter" reminders contain "不要再调用任何工具，直接总结" (final instruction)
+ * - "task-ops" reminders contain "task_operation_list" (Task #5081:
+ *   sub-agent awareness of others' task operations)
  * - "delegate" reminders contain "use delegate_task" (earlier hint)
  *
  * The final merged message always ends with the max-iter reminder.
  */
-export type FakeUserMessageKind = "delegate" | "max-iter";
+export type FakeUserMessageKind = "delegate" | "task-ops" | "max-iter";
+/**
+ * Merge priority per kind — higher value = appears later in the
+ * merged message / wins the finalKind. Task #5081: "task-ops" sits
+ * between "delegate" (business hint) and "max-iter" (final word).
+ */
+export declare const KIND_PRIORITY: Record<FakeUserMessageKind, number>;
 /**
  * Internal implementation of the enqueue helper. Not exported directly;
  * instead `enqueueToAddFakeUserMessage` (the wrapped version) is exported

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

@@ -4,6 +4,7 @@
 export { TaskTagPlugin } from "./task-tag-plugin";
 export { LayaDecisionPlugin, createLayaDecisionPlugin, LAYA_REUSE_THRESHOLD, type LayaDecisionPluginOptions, } from "./laya-decision-plugin";
 export { createAutoTaskPlugin, type AutoTaskPluginConfig, } from "./auto-task-plugin";
+export { createTaskOpWatermarkPlugin, TaskOpWatermarkPlugin, TASK_OP_WATERMARK_MAX_REMINDERS, TASK_OP_WATERMARK_MESSAGE_LIMIT, TASK_OP_WATERMARK_AUDIT_INTERVAL, type TaskOpWatermarkPluginConfig, } from "./task-op-watermark-plugin";
 export { LayaCompletionPlugin, createLayaCompletionPlugin, registerLayaCompletionTaskHook, buildCompletionHint, renderCompletionState, buildCompletionQuestion, LAYA_COMPLETION_THRESHOLD, type LayaCompletionPluginOptions, } from "./laya-completion-plugin";
 export { TASK_COMPLETION_HINT_ANCHOR, TASK_COMPLETE_ITEM_BY_ITEM, TASK_COMPLETE_VERIFY_DUTY, TASK_COMPLETE_ACCEPTANCE, } from "../tools/completion-copy";
 export type { DecisionPort, DecisionRequest, DecisionAnswer, DecisionResponse, } from "./decision-port";

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-rsn44n9y.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-abqhkbn3.js";
+import"../../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
+import"../../../shared/@ai-setting/roy-agent-core-ezvpreqz.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,
@@ -54,11 +55,17 @@ import {
   renderWorkflowInfoLines,
   resolveTaskTitleForDisplay,
   sanitizeInlineText
-} from "../../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+} from "../../../shared/@ai-setting/roy-agent-core-w0qjeq2v.js";
 import"../../../shared/@ai-setting/roy-agent-core-1v4g0d4x.js";
 import"../../../shared/@ai-setting/roy-agent-core-cgtq6427.js";
 import"../../../shared/@ai-setting/roy-agent-core-er070zjq.js";
-import"../../../shared/@ai-setting/roy-agent-core-f77k3gqt.js";
+import {
+  TASK_OP_WATERMARK_AUDIT_INTERVAL,
+  TASK_OP_WATERMARK_MAX_REMINDERS,
+  TASK_OP_WATERMARK_MESSAGE_LIMIT,
+  TaskOpWatermarkPlugin,
+  createTaskOpWatermarkPlugin
+} from "../../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
 import"../../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../../shared/@ai-setting/roy-agent-core-qqaak24r.js";
@@ -86,6 +93,7 @@ export {
   formatExtractorInput,
   formatDurationMs,
   formatDateTimeForDisplay,
+  createTaskOpWatermarkPlugin,
   createPerTaskGroupChatPlugin,
   createLayaDecisionPlugin,
   createLayaCompletionPlugin,
@@ -99,6 +107,10 @@ export {
   buildChatAppLink,
   WORKFLOW_EXTRACTOR_PROMPT,
   TaskTagPlugin,
+  TaskOpWatermarkPlugin,
+  TASK_OP_WATERMARK_MESSAGE_LIMIT,
+  TASK_OP_WATERMARK_MAX_REMINDERS,
+  TASK_OP_WATERMARK_AUDIT_INTERVAL,
   TASK_COMPLETION_HINT_ANCHOR,
   TASK_COMPLETE_VERIFY_DUTY,
   TASK_COMPLETE_ITEM_BY_ITEM,

package/dist/env/task/plugins/lark-card-patch-notifier.js

@@ -22,7 +22,7 @@ import {
   resolveTaskTitleForDisplay,
   sanitizeInlineText,
   truncateHeadTitle
-} from "../../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+} from "../../../shared/@ai-setting/roy-agent-core-w0qjeq2v.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";

package/dist/env/task/plugins/task-op-watermark-plugin.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @fileoverview TaskOpWatermarkPlugin — sub-agent 感知任务操作记录（Task #5081，M1）
+ *
+ * 设计文档：/tmp/task-op-awareness-design.md（Task #5079，已验收）
+ *
+ * ## 场景
+ *
+ * sub-agent（roy 等）被委托推进某个 task 期间，default agent（或其它
+ * sub-agent / CLI 探针进程）往同一 task 写了新的 operation 记录。
+ * sub-agent 的 ReAct 循环对「别人给我加了记录」**毫无感知** —— 本插件
+ * 在 `agent:after.tool` 时点做水位比对，命中则通过共享 meta-protocol
+ * （`toolResult.result.metadata.toAddFakeUserMessage`）注入一条
+ * user role 提醒，sub-agent 下轮读到后自行调 `task_operation_list` 读取。
+ *
+ * ## 水位语义（关键设计决策）
+ *
+ * - 水位用 **operation id**（SQLite AUTOINCREMENT，严格单调）而非
+ *   timestamp（Date.now() 毫秒，同毫秒多条会漏）。
+ * - 水位存 plugin 实例的 `Map<sessionId, Watermark>` —— 生命周期与
+ *   plugin 实例一致；进程重启后首轮全量扫（N 聚 1 + 限流兜底噪声）。
+ * - **查询必须绕过 operationsCache**：`sqlite-task-store.ts` 的缓存只在
+ *   本进程写入时失效，跨进程（CLI 探针 / 另一 daemon）写入的记录不会
+ *   失效本进程缓存 → 必须走 `listOperationsFresh`（直打 DB）。
+ * - 能力探测：store 未实现 `listOperationsFresh`（外部宿主的后端）时
+ *   降级 `listOperations` + `invalidateOperationsCache`，功能等价。
+ *
+ * ## 自提醒过滤（防 doom loop，核心）
+ *
+ * `op.sessionId === 我的 sessionId` → 不算新记录。三个来源：
+ * 1. sub-agent 自己 `task_operation_create` 记进度（create-tool.ts:87）
+ * 2. sub-agent 自己 `task_pre_complete` 写的留痕（pre-complete-tool.ts:89，
+ *    Task #5073 两阶段验收的提交口 —— 回归保护）
+ * 3. `sessionId = "unknown"` 的 fallback 写入（create-tool.ts:87 的兜底）
+ *
+ * ## 防退化与边界（设计文档 §4）
+ *
+ * - 无 task 绑定 → 跳过；DB 读异常 → catch + warn，不影响工具执行
+ * - N 条新记录聚合 **1 条**提醒（详情 ≤3 条，最新优先，其余折叠）
+ * - 单 session 限流 `TASK_OP_WATERMARK_MAX_REMINDERS`（5）次，超限只推水位
+ * - 消息总长 ≤ `TASK_OP_WATERMARK_MESSAGE_LIMIT`（1500 字符）
+ * - 每 `TASK_OP_WATERMARK_AUDIT_INTERVAL`（15）次工具调用兜底全量对账
+ * - kind 合并顺序：`delegate` → `task-ops` → `max-iter`（max-iter 最终
+ *   指令永远在末尾，见 fake-user-message-helper KIND_PRIORITY）
+ */
+import type { Plugin, HookContext, HookResult } from "../../agent/types";
+import type { TaskOperation } from "../types";
+/** 单 session（plugin 实例生命周期内）最大提醒次数 */
+export declare const TASK_OP_WATERMARK_MAX_REMINDERS = 5;
+/** 注入消息的总长度上限（字符） */
+export declare const TASK_OP_WATERMARK_MESSAGE_LIMIT = 1500;
+/** 兜底全量对账的工具调用间隔 */
+export declare const TASK_OP_WATERMARK_AUDIT_INTERVAL = 15;
+/**
+ * TaskComponent 只读能力面 —— 与 decision-hint-plugin 的
+ * `TaskComponentReadonly` 同款隔离模式（避免类型循环依赖）。
+ */
+export interface TaskOpWatermarkTaskComponentLike {
+    /** 按 session 反查绑定的**全部** task（多 task 并集水位，不漏报） */
+    getTaskIdsBySessionId?(sessionId: string): Promise<number[] | undefined>;
+    /** 老接口：只返回第一个 task（getTaskIdsBySessionId 未实现时的 fallback） */
+    getTaskIdBySessionId?(sessionId: string): Promise<number | undefined>;
+    getTask(id: number): Promise<{
+        id: number;
+        title: string;
+    } | undefined>;
+    /** 绕过 operationsCache 的 fresh 查询（可选 —— 能力探测） */
+    listOperationsFresh?(options: {
+        taskId: number;
+        limit?: number;
+    }): Promise<TaskOperation[]>;
+    /** 常规查询（fallback 路径用） */
+    listOperations(options: {
+        taskId: number;
+        limit?: number;
+    }): Promise<TaskOperation[]>;
+    /** 缓存失效（fallback 路径用；可选 —— 能力探测） */
+    invalidateOperationsCache?(taskId: number): void;
+}
+export interface TaskOpWatermarkPluginConfig {
+    /**
+     * 惰性解析 TaskComponent（推荐注入方式）。
+     *
+     * 为什么惰性：`registerAgent` 可能早于 TaskComponent 注册（时序风险），
+     * 惰性闭包把解析推迟到首次 `execute()`（env 组件已就绪）——
+     * 设计文档 §2.1 方案 (c)。
+     */
+    resolveTaskComponent?: () => TaskOpWatermarkTaskComponentLike | undefined;
+}
+export declare class TaskOpWatermarkPlugin {
+    readonly name = "TaskOpWatermarkPlugin";
+    readonly version = "1.0.0";
+    readonly description = "Task #5081 \u2014 agent:after.tool \u6C34\u4F4D\u6BD4\u5BF9\uFF1A\u540C\u4E00 task \u51FA\u73B0\u4ED6\u4EBA\uFF08sessionId \u8FC7\u6EE4 + unknown \u8FC7\u6EE4\uFF09\u65B0\u589E\u7684 operation \u65F6\uFF0C\u7ECF\u5171\u4EAB meta-protocol \u6CE8\u5165 user role \u63D0\u9192\uFF08N \u805A 1 / \u9650\u6D41 5 / \u957F\u5EA6 1500 / 15 \u6B21\u515C\u5E95\u5BF9\u8D26 / fresh \u65C1\u8DEF\u7ED5 operationsCache\uFF09\u3002";
+    readonly priority = 40;
+    /** session 级水位（plugin 实例生命周期） */
+    private readonly watermarks;
+    private readonly resolveTaskComponent;
+    constructor(config?: TaskOpWatermarkPluginConfig);
+    execute(ctx: HookContext): Promise<HookResult>;
+    private check;
+    /** 自提醒过滤：自己写的 + unknown fallback 写入的都不算「别人的」 */
+    private isSelf;
+    private resolveTaskIds;
+    /**
+     * 拉取记录 —— fresh 优先（绕 operationsCache；跨进程写入可见），
+     * 能力探测失败降级 listOperations + invalidateOperationsCache。
+     */
+    private listOps;
+}
+/**
+ * 创建 TaskOpWatermarkPlugin 实例（与 createMaxIterationReminderPlugin 同款形态）
+ */
+export declare function createTaskOpWatermarkPlugin(config?: TaskOpWatermarkPluginConfig): Plugin;

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/storage/index.js

@@ -1,9 +1,9 @@
-import"../../../shared/@ai-setting/roy-agent-core-ntq0gz7q.js";
+import"../../../shared/@ai-setting/roy-agent-core-q813vafd.js";
 import {
   SQLiteTaskStore,
   getDefaultDataDir,
   getDefaultTaskDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
+} from "../../../shared/@ai-setting/roy-agent-core-ezvpreqz.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";

package/dist/env/task/storage/sqlite-task-store.d.ts

@@ -71,6 +71,13 @@ export interface TaskStore {
      * 确定性映射：sub-agent 的 task_create 用 sessionId=sub-session id）。
      */
     getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
+    /**
+     * Task #5081（optional）— 按 session_id 反查该 session 关联的**全部**
+     * task id（不限定 create 记录）。TaskOpWatermarkPlugin 对全部 task
+     * 求并集水位。optional：外部宿主实现可不提供（调用方降级到
+     * getTaskIdBySessionId 单值）。
+     */
+    getTaskIdsBySessionId?(sessionId: string): Promise<number[]>;
     createOperation(options: CreateOperationOptions): Promise<TaskOperation>;
     getOperation(id: number): Promise<TaskOperation | undefined>;
     updateOperation(id: number, updates: {
@@ -82,6 +89,22 @@ export interface TaskStore {
     }): Promise<TaskOperation | undefined>;
     deleteOperation(id: number): Promise<boolean>;
     listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081（optional）— 绕过 operationsCache 的直读查询。
+     *
+     * 跨进程写入的 operation 不会失效本进程缓存 → `listOperations`
+     * 可能读陈旧快照。本方法**直打 DB**（`ORDER BY id DESC`，不读写
+     * 缓存），供 TaskOpWatermarkPlugin 的水位检查使用。
+     *
+     * optional：不破坏外部宿主实现的 TaskStore 契约（能力探测 +
+     * 降级路径见 plugin 侧）。
+     */
+    listOperationsFresh?(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081（optional）— 主动失效 operationsCache。
+     * 降级路径配套：`listOperations` 前调用，保证读到最新。
+     */
+    invalidateOperationsCache?(taskId: number): void;
     createTag(name: string): Promise<TaskTag>;
     getTag(id: number): Promise<TaskTag | undefined>;
     getTagByName(name: string): Promise<TaskTag | undefined>;
@@ -186,6 +209,28 @@ export declare class SQLiteTaskStore implements TaskStore {
     }): Promise<TaskOperation | undefined>;
     deleteOperation(id: number): Promise<boolean>;
     listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081 — 绕过 operationsCache 的直读查询（optional 能力）。
+     *
+     * 为什么必须有：operationsCache 只在本进程 create/update/delete 时
+     * 失效（:744/:785/:800），**跨进程写入的 operation 不会失效本进程
+     * 缓存** —— CLI 探针 / 另一 daemon 进程写的记录，本进程的
+     * `listOperations` 永远看不到（读陈旧快照）→ TaskOpWatermarkPlugin
+     * 的水位检查会漏报。
+     *
+     * 要点：
+     * - `ORDER BY id DESC`：水位语义要求**单调自增 id**（timestamp 同
+     *   毫秒多条会漏），id 是 AUTOINCREMENT 严格单调。
+     * - **只读，不写 operationsCache**：不污染其它调用方的缓存语义。
+     */
+    listOperationsFresh(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081 — 主动失效 operationsCache（optional 能力）。
+     *
+     * 供不支持 `listOperationsFresh` 的外部宿主 backend 走降级路径：
+     * `listOperations` 之前先失效缓存，保证下次读到最新。
+     */
+    invalidateOperationsCache(taskId: number): void;
     /**
      * 按 session_id 反查该 session 创建的第一个 task。
      *
@@ -195,6 +240,15 @@ export declare class SQLiteTaskStore implements TaskStore {
      * 不依赖易失的 EnvContext.currentTaskId（会被 task_complete 清空）或结果文本正则。
      */
     getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
+    /**
+     * Task #5081 — 按 session_id 反查该 session 关联的**全部** task id
+     * （optional 能力，TaskStore 接口同款 optional）。
+     *
+     * 与 getTaskIdBySessionId 的区别：不限定 milestone_type='create'、
+     * 不 LIMIT 1 —— sub-session 往同一 task 写过任何 operation 记录
+     * （记进度 / milestone / pre_complete 留痕）都算关联。
+     */
+    getTaskIdsBySessionId(sessionId: string): Promise<number[]>;
     private rowToTask;
     /**
      * 安全解析 tags 字段。