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

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

@@ -3,7 +3,7 @@ import {
 } from "./roy-agent-core-na18zwj0.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-zv8bswpw.js";
+} from "./roy-agent-core-3e6gg17d.js";
 import {
   createCompatibleDatabase,
   init_sqlite_task_store
@@ -24,10 +24,10 @@ import {
 import {
   LarkCardPatchNotifier,
   humanizeValue
-} from "./roy-agent-core-46rv4d7d.js";
+} from "./roy-agent-core-nmx9934r.js";
 import {
   validateWorkflowDefinition
-} from "./roy-agent-core-yr1mryb8.js";
+} from "./roy-agent-core-1v4g0d4x.js";
 import {
   enqueueToAddFakeUserMessage
 } from "./roy-agent-core-f77k3gqt.js";
@@ -1254,6 +1254,423 @@ function createAutoTaskPlugin(config) {
     execute
   };
 }
+// src/env/task/plugins/laya-completion-plugin.ts
+init_logger();
+init_decorator();
+var logger5 = createLogger("plugin:laya-completion");
+var LAYA_COMPLETION_THRESHOLD = 0.92;
+var CHOICE_PASS = "PASS_COMPLETED";
+var CHOICE_FAIL = "FAIL_INCOMPLETE";
+var MAX_OPERATIONS_IN_STATE = 20;
+var OP_TITLE_MAX = 60;
+var OP_DESC_MAX = 120;
+var GOALS_MAX = 400;
+function buildCompletionHint(task, confidence) {
+  return [
+    "[TASK_COMPLETION_HINT] 决策模型检测到「目标 vs 交付物」可能不匹配：任务已标记完成，但操作记录链显示目标或交付物可能未达成。",
+    "",
+    `任务：#${task.id} [${task.type}] ${task.title}`,
+    `状态：${task.status} ｜ 判定置信度：${confidence.toFixed(4)}`,
+    "",
+    "⚠️ 你必须核实本提示：先用 task_get(task_id=" + task.id + ") 复核任务的目标（description / goals_and_expected_deliverables）与交付物证据（context.deliverable_storage_path、操作记录链）。",
+    "核实后二选一执行：",
+    "(a) 确认未完成 → task_update(task_id=" + task.id + ", status=todo) 重开任务继续推进；",
+    "(b) 确认已完成 → task_operation_create(task_id=" + task.id + ", milestone_type=decision, ...) 落一条操作记录说明已完成的理由。",
+    "不允许无视本提示。"
+  ].join(`
+`);
+}
+function renderOperations(ops) {
+  if (ops.length === 0)
+    return "(无操作记录)";
+  const sorted = [...ops].sort((a, b) => new Date(a.timestamp ?? 0).getTime() - new Date(b.timestamp ?? 0).getTime());
+  let windowed;
+  if (sorted.length <= MAX_OPERATIONS_IN_STATE) {
+    windowed = sorted;
+  } else {
+    const tail = sorted.slice(-(MAX_OPERATIONS_IN_STATE - 1));
+    const head = sorted.slice(0, 1);
+    const seen = new Set(tail.map((o) => o.id));
+    windowed = seen.has(head[0].id) ? tail : [...head, ...tail];
+  }
+  return windowed.map((op, i) => {
+    const title = (op.milestoneTitle || "").slice(0, OP_TITLE_MAX);
+    const desc = (op.milestoneDescription || "").replace(/\n/g, " ").slice(0, OP_DESC_MAX);
+    const proc = (op.processDescription || "").replace(/\n/g, " ").slice(0, OP_DESC_MAX);
+    const parts = [`#${i + 1} [${op.milestoneType}] ${title}`];
+    if (desc)
+      parts.push(`    ${desc}`);
+    if (proc)
+      parts.push(`    过程：${proc}`);
+    return parts.join(`
+`);
+  }).join(`
+`);
+}
+function readDeliverablePath(task) {
+  try {
+    const parsed = JSON.parse(task.context || "{}");
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      const p = parsed.deliverable_storage_path;
+      return typeof p === "string" ? p : "";
+    }
+  } catch {}
+  return "";
+}
+function looksLikeFilePath(token) {
+  if (token.startsWith("//"))
+    return false;
+  if ((token.match(/\//g) ?? []).length >= 2)
+    return true;
+  return /\.[A-Za-z0-9]+$/.test(token);
+}
+function firstPathToken(text) {
+  const m = text.match(/(?:^|[\s（(【「:：,，])(\/[A-Za-z0-9._~\-/@%+]{2,})/);
+  if (!m)
+    return null;
+  return looksLikeFilePath(m[1]) ? m[1] : null;
+}
+var CHECKLIST_MAX = 1200;
+var DELIVERABLE_SPLIT = /[,，;；、\n]/;
+var DELIVERABLE_PLUS_SPLIT = /\s\+\s/;
+function stripDeliverableToken(t) {
+  const seg = t.trim();
+  if (!seg)
+    return null;
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(seg))
+    return null;
+  const m = seg.match(/(?:^|[\s（(【「:：,，])(\/[A-Za-z0-9._~\-/@%+]{2,})/);
+  if (!m)
+    return null;
+  const path = m[1].replace(/[。，、；：）】」"'”’.,;:!?)\]}]+$/u, "");
+  return path.startsWith("/") ? path : null;
+}
+function isUrlSegment(seg) {
+  return /^[a-z][a-z0-9+.-]*:\/\//i.test(seg.trim());
+}
+function splitDeliverableSegments(deliverable) {
+  return deliverable.split(DELIVERABLE_PLUS_SPLIT).flatMap((s) => s.split(DELIVERABLE_SPLIT)).flatMap((s) => splitUrlSegments(s)).flatMap((s) => splitSpaceSeparatedPaths(s)).map((s) => s.trim()).filter(Boolean);
+}
+function splitUrlSegments(seg) {
+  const re = /([a-z][a-z0-9+.-]*:\/\/\S+)/gi;
+  const parts = [];
+  let last = 0;
+  let m;
+  while ((m = re.exec(seg)) !== null) {
+    const before = seg.slice(last, m.index).trim();
+    if (before)
+      parts.push(before);
+    const url = m[1];
+    if (/^file:\/\//i.test(url)) {
+      const local = url.replace(/^file:\/\//i, "");
+      if (local)
+        parts.push(local);
+    } else {
+      parts.push(url);
+    }
+    last = m.index + url.length;
+  }
+  const rest = seg.slice(last).trim();
+  if (rest)
+    parts.push(rest);
+  return parts.length > 0 ? parts : [seg];
+}
+function spaceSeparatedPathStarts(seg) {
+  const re = /(?:^|[\s（(【「:：,，])(\/[A-Za-z0-9._~\-/@%+]{2,})/g;
+  const starts = [];
+  let m;
+  while ((m = re.exec(seg)) !== null) {
+    const pathStart = m[0].startsWith("/") ? m.index : m.index + 1;
+    if (m[1].startsWith("//"))
+      continue;
+    starts.push(pathStart);
+  }
+  return starts;
+}
+function splitSpaceSeparatedPaths(seg) {
+  const starts = spaceSeparatedPathStarts(seg);
+  if (starts.length < 2)
+    return [seg];
+  const parts = [seg.slice(0, starts[1])];
+  for (let i = 1;i < starts.length; i++) {
+    const end = i + 1 < starts.length ? starts[i + 1] : seg.length;
+    parts.push(seg.slice(starts[i], end));
+  }
+  return parts;
+}
+function isPathLikeDeliverable(deliverable) {
+  if (!deliverable.includes("/"))
+    return false;
+  const segs = splitDeliverableSegments(deliverable);
+  if (segs.length === 0)
+    return false;
+  const paths = segs.map(stripDeliverableToken).filter((p) => p !== null);
+  if (paths.length === 0)
+    return false;
+  return segs.every((s, i) => stripDeliverableToken(s) !== null || isUrlSegment(s));
+}
+function renderCriteriaChecklist(goalsText, deliverable) {
+  if (!deliverable || deliverable === "(未声明)")
+    return null;
+  if (!isPathLikeDeliverable(deliverable))
+    return null;
+  const items = goalsText.split(`
+`).map((l) => l.trim()).filter((l) => /^\d+\s*[.、)）]/.test(l));
+  if (items.length === 0)
+    return null;
+  const tokens = items.map(firstPathToken);
+  if (tokens.some((t) => t === null))
+    return null;
+  const declared = splitDeliverableSegments(deliverable).map(stripDeliverableToken).filter((t) => t !== null);
+  const declaredSet = new Set(declared);
+  const lines = items.map((item, i) => {
+    const token = tokens[i];
+    const done = declaredSet.has(token);
+    const origNum = item.match(/^(\d+)\s*[.、)）]/)?.[1] ?? String(i + 1);
+    return done ? `${origNum}. ${token} 已产出` : `${origNum}. ${token} 未产出`;
+  });
+  const anyUndone = tokens.some((t) => !declaredSet.has(t));
+  const raw = `【逐条对照】${lines.join("；")}，目标${anyUndone ? "未完成" : "全部完成"}`;
+  if (raw.length > CHECKLIST_MAX) {
+    const suffix = `目标${anyUndone ? "未完成" : "全部完成"}`;
+    const head = raw.slice(0, CHECKLIST_MAX - suffix.length - 2);
+    const lastSep = head.lastIndexOf("；");
+    const cut = lastSep > 0 ? head.slice(0, lastSep) : head;
+    return `${cut}；…，${suffix}`;
+  }
+  return raw;
+}
+function renderCompletionState(task, ops) {
+  const goals = (task.goals_and_expected_deliverables || "(无)").replace(/\n/g, " ").slice(0, GOALS_MAX);
+  const deliverable = readDeliverablePath(task) || "(未声明)";
+  const checklist = renderCriteriaChecklist(task.goals_and_expected_deliverables || "", deliverable);
+  return `【任务标题】${task.title}
+` + `【任务目标】${goals}
+` + `【交付物声明】${deliverable}
+` + (checklist ? `${checklist}
+` : "") + `【操作记录】
+` + renderOperations(ops);
+}
+function buildCompletionQuestion() {
+  return {
+    completion_check: {
+      type: "choice",
+      instructions: "根据任务目标、交付物声明与操作记录链，判断该任务是否真正达成目标且产出交付物。" + `若证据充分支持已完成，选 ${CHOICE_PASS}；若目标或交付物疑似未达成，选 ${CHOICE_FAIL}。`,
+      criteria: {
+        [CHOICE_PASS]: "目标已达成且交付物已产出",
+        [CHOICE_FAIL]: "目标或交付物疑似未达成"
+      }
+    }
+  };
+}
+
+class LayaCompletionPlugin {
+  name = "laya-completion";
+  version = "1.0.0";
+  description = "Task #4760 — task:after.complete 完成判定（目标/交付物 match，只提示不拦截）";
+  options;
+  port = null;
+  portResolved = false;
+  constructor(options = {}) {
+    this.options = options;
+    if (options.decisionPort) {
+      this.port = options.decisionPort;
+      this.portResolved = true;
+    }
+  }
+  isDisabled() {
+    return this.port?.isDisabled() ?? false;
+  }
+  async resolvePort() {
+    if (this.portResolved)
+      return this.port;
+    this.portResolved = true;
+    try {
+      const auth = await loadLayaAuthForPurpose(this.options.authPath ?? `${process.env.HOME ?? "~"}/.roy-agent/auth.json`, "goal");
+      if (!auth)
+        return null;
+      this.port = new LayaDecisionPort({
+        baseURL: auth.baseURL,
+        apiKey: auth.apiKey,
+        model: auth.model,
+        timeoutMs: this.options.timeoutMs,
+        maxStrikes: this.options.maxStrikes
+      });
+    } catch (err) {
+      logger5.warn(`[laya-completion] loadLayaAuth failed (fail-open): ${err?.message}`);
+      this.port = null;
+    }
+    return this.port;
+  }
+  async execute(ctx, taskComponent) {
+    try {
+      const data = normalizeHookCtx2(ctx);
+      await this.run(data, taskComponent);
+    } catch (err) {
+      logger5.warn(`[laya-completion] unexpected failure, ignored: ${err?.message}`);
+    }
+  }
+  async run(ctx, taskComponent) {
+    if (!taskComponent) {
+      logger5.warn("[laya-completion] taskComponent not injected — skip");
+      return;
+    }
+    if (ctx.terminalStatus !== "completed") {
+      logger5.debug(`[laya-completion] terminalStatus=${ctx.terminalStatus} — skip (only completed)`);
+      return;
+    }
+    const task = ctx.task;
+    if (!task?.id)
+      return;
+    let ops = [];
+    try {
+      ops = await taskComponent.listOperations({
+        taskId: task.id,
+        limit: 1e6,
+        offset: 0
+      });
+    } catch (err) {
+      logger5.warn(`[laya-completion] listOperations failed (fail-open): ${err?.message}`);
+      return;
+    }
+    logger5.info(`[laya-completion] judging task #${task.id}: chain=${ops?.length ?? 0} ops, terminalStatus=${ctx.terminalStatus}`);
+    if (!ops || ops.length === 0) {
+      logger5.debug("[laya-completion] empty operation chain — pass through");
+      return;
+    }
+    const port = await this.resolvePort();
+    if (!port) {
+      logger5.debug("[laya-completion] no decision port configured — skip");
+      return;
+    }
+    if (port.isDisabled()) {
+      logger5.debug("[laya-completion] port self-disabled (circuit open) — skip");
+      return;
+    }
+    const req = {
+      state: renderCompletionState(task, ops),
+      questions: buildCompletionQuestion()
+    };
+    let answer;
+    try {
+      const res = await port.decide(req);
+      answer = res?.answers?.["completion_check"];
+    } catch (err) {
+      logger5.warn(`[laya-completion] decide failed (fail-open): ${err?.message}`);
+      return;
+    }
+    if (!answer || typeof answer.choice !== "string") {
+      logger5.debug("[laya-completion] malformed answer — skip");
+      return;
+    }
+    const confidence = pickGateConfidence(answer);
+    const threshold = this.options.completionThreshold ?? LAYA_COMPLETION_THRESHOLD;
+    if (confidence < threshold) {
+      logger5.debug(`[laya-completion] confidence ${confidence} < ${threshold} — pass through`);
+      return;
+    }
+    if (answer.choice !== CHOICE_FAIL) {
+      logger5.debug(`[laya-completion] choice=${answer.choice} (not FAIL_INCOMPLETE) — no hint`);
+      return;
+    }
+    await this.writeHint(task, confidence, taskComponent);
+  }
+  async writeHint(task, confidence, taskComponent) {
+    const hint = buildCompletionHint(task, confidence);
+    try {
+      let parsed = {};
+      try {
+        const p = JSON.parse(task.context || "{}");
+        if (p && typeof p === "object" && !Array.isArray(p)) {
+          parsed = p;
+        }
+      } catch {}
+      parsed.completion_hint = hint;
+      await taskComponent.updateTaskContext(task.id, JSON.stringify(parsed));
+      logger5.info(`[laya-completion] hint written to task #${task.id} context (conf=${confidence.toFixed(4)})`);
+    } catch (err) {
+      logger5.warn(`[laya-completion] updateTask hint failed (ignored): ${err?.message}`);
+    }
+    try {
+      await taskComponent.createOperation({
+        taskId: task.id,
+        sessionId: "laya-completion",
+        milestoneType: "decision",
+        milestoneTitle: "[TASK_COMPLETION_HINT] 目标/交付物疑似未达成",
+        milestoneDescription: `决策模型判定 FAIL_INCOMPLETE（conf=${confidence.toFixed(4)}）。hint 已写入 task.context.completion_hint，等待 agent 核实。`
+      });
+    } catch (err) {
+      logger5.warn(`[laya-completion] createOperation hint failed (ignored): ${err?.message}`);
+    }
+  }
+}
+__legacyDecorateClassTS([
+  TracedAs("task.laya.completion.onAfterComplete", {
+    recordParams: false,
+    recordResult: false,
+    log: false,
+    paramFilter: (args) => {
+      const raw = args[0] ?? {};
+      const ctx = raw?.data ?? raw;
+      return {
+        taskId: ctx?.task?.id,
+        terminalStatus: ctx?.terminalStatus,
+        hasTaskComponent: Boolean(args[1])
+      };
+    },
+    resultFilter: (_res) => ({ ok: true })
+  })
+], LayaCompletionPlugin.prototype, "execute", null);
+function normalizeHookCtx2(ctx) {
+  const maybe = ctx;
+  return maybe && typeof maybe === "object" && maybe.data ? maybe.data : ctx;
+}
+function createLayaCompletionPlugin(options) {
+  const inner = options && Object.keys(options).length > 0 ? new LayaCompletionPlugin(options) : getSharedCompletionPlugin();
+  return {
+    name: "laya-completion",
+    priority: 20,
+    execute: async (ctx) => {
+      await inner.execute(ctx, inner.__taskComponent);
+    },
+    plugin: inner
+  };
+}
+var sharedCompletionPlugin = null;
+function getSharedCompletionPlugin() {
+  if (!sharedCompletionPlugin) {
+    sharedCompletionPlugin = new LayaCompletionPlugin;
+  }
+  return sharedCompletionPlugin;
+}
+function registerLayaCompletionTaskHook(taskComponent, options) {
+  if (!taskComponent) {
+    logger5.warn("[registerLayaCompletionTaskHook] TaskComponent not available — skip (fail-open)");
+    return false;
+  }
+  try {
+    const hook = createLayaCompletionPlugin(options);
+    hook.plugin.__taskComponent = taskComponent;
+    taskComponent.unregisterHook(TaskHookPoints.AFTER_COMPLETE, hook.name);
+    taskComponent.registerHook(TaskHookPoints.AFTER_COMPLETE, {
+      name: hook.name,
+      priority: hook.priority,
+      execute: async (ctx) => {
+        try {
+          const data = ctx && typeof ctx === "object" && "data" in ctx ? ctx.data : ctx;
+          await hook.plugin.execute(data, taskComponent);
+        } catch (err) {
+          logger5.warn(`[registerLayaCompletionTaskHook] hook execution failed (ignored): ${err?.message}`);
+        }
+      }
+    });
+    logger5.info(`[registerLayaCompletionTaskHook] registered hook "${hook.name}" at ${TaskHookPoints.AFTER_COMPLETE} (priority=${hook.priority})`);
+    return true;
+  } catch (err) {
+    logger5.warn(`[registerLayaCompletionTaskHook] registration failed (ignored): ${err?.message}`);
+    return false;
+  }
+}
 // src/env/task/plugins/lark-cli-task-notify-plugin.ts
 init_decorator();
 init_logger();
@@ -1263,7 +1680,7 @@ init_context();
 init_logger();
 init_sqlite_task_store();
 import { join } from "path";
-var logger5 = createLogger("lark-cli:card-state");
+var logger6 = createLogger("lark-cli:card-state");
 
 class MemoryLarkCardStateStore {
   records = new Map;
@@ -1427,7 +1844,7 @@ function createLarkCardStateStore(dbPath) {
   try {
     return new SqliteLarkCardStateStore(path);
   } catch (err) {
-    logger5.warn(`LarkCardStateStore: sqlite unavailable at ${path} (${err.message}) ` + `→ falling back to in-memory (卡片仍可发，但重启后无法 patch 旧卡)`);
+    logger6.warn(`LarkCardStateStore: sqlite unavailable at ${path} (${err.message}) ` + `→ falling back to in-memory (卡片仍可发，但重启后无法 patch 旧卡)`);
     return new MemoryLarkCardStateStore;
   }
 }
@@ -1509,7 +1926,7 @@ function decideCardChatTarget(input) {
 }
 
 // src/env/task/plugins/lark-cli-task-notify-plugin.ts
-var logger6 = createLogger("lark-cli:task-notify");
+var logger7 = createLogger("lark-cli:task-notify");
 var CTX_FIELD_CHAT_ID = "larkPerTaskChatId";
 var CTX_FIELD_CHAT_PROFILE = "larkPerTaskChatProfile";
 function parseLarkPerTaskChatId(ctxStr) {
@@ -1572,6 +1989,7 @@ class LarkCliTaskNotifyHook {
   cardStateStore;
   restoredTaskIds = new Set;
   lastNotifyTimestamps = new Map;
+  trailingPatchTimers = new Map;
   cardRoutingPorts;
   static CARD_START_FAILED_SENTINEL = "__card_start_failed__";
   static CARD_START_INFLIGHT_SENTINEL = "__card_start_inflight__";
@@ -1599,7 +2017,7 @@ class LarkCliTaskNotifyHook {
   }
   setCardRoutingPorts(ports) {
     this.cardRoutingPorts = ports;
-    logger6.debug(`CardRoutingPorts injected: getTask=${typeof ports.getTask}`);
+    logger7.debug(`CardRoutingPorts injected: getTask=${typeof ports.getTask}`);
   }
   hasCardRoutingPorts() {
     return this.cardRoutingPorts !== undefined;
@@ -1612,7 +2030,7 @@ class LarkCliTaskNotifyHook {
     if (this.pluginName && this.sourceId) {
       const key = `${this.sourceId}:${this.pluginName}`;
       if (env.pluginEnabled && env.pluginEnabled[key] !== true) {
-        logger6.debug(`Plugin not enabled for source: ${key}`);
+        logger7.debug(`Plugin not enabled for source: ${key}`);
         return;
       }
     }
@@ -1715,11 +2133,11 @@ class LarkCliTaskNotifyHook {
     try {
       record = this.cardStateStore?.get(taskId);
     } catch (err) {
-      logger6.warn(`onAfterDelete: 读取卡片记录失败 task #${taskId}: ${err.message}`);
+      logger7.warn(`onAfterDelete: 读取卡片记录失败 task #${taskId}: ${err.message}`);
     }
     const messageId = record?.messageId || this.cardMessageIds.get(taskId);
     if (!messageId) {
-      logger6.debug(`onAfterDelete: task #${taskId} 无卡片记录，skip（不发新卡）`);
+      logger7.debug(`onAfterDelete: task #${taskId} 无卡片记录，skip（不发新卡）`);
       return;
     }
     this.restoreCardState(taskId);
@@ -1734,17 +2152,18 @@ class LarkCliTaskNotifyHook {
         finalStep: "任务已取消（删除）"
       });
     } catch (err) {
-      logger6.warn(`onAfterDelete: patch 卡片失败 task #${taskId} message=${messageId}: ${err.message}`);
+      logger7.warn(`onAfterDelete: patch 卡片失败 task #${taskId} message=${messageId}: ${err.message}`);
     }
     try {
       await this.cardNotifier.unpinMessage(messageId, profile);
     } catch (err) {
-      logger6.warn(`onAfterDelete: unpin 失败 task #${taskId} message=${messageId}: ${err.message}`);
+      logger7.warn(`onAfterDelete: unpin 失败 task #${taskId} message=${messageId}: ${err.message}`);
     }
+    this.cancelTrailingPatch(taskId);
     this.persistClosed(taskId);
     this.persistPinned(taskId, false);
     this.cardMessageIds.delete(taskId);
-    logger6.debug(`onAfterDelete: task #${taskId} 卡片已收尾 status=deleted message=${messageId}`);
+    logger7.debug(`onAfterDelete: task #${taskId} 卡片已收尾 status=deleted message=${messageId}`);
   }
   async onAfterOperationCreate(ctx) {
     const { operation } = ctx.data;
@@ -1752,18 +2171,16 @@ class LarkCliTaskNotifyHook {
       return;
     if (!this.shouldNotify("operation_created" /* OPERATION_CREATED */))
       return;
-    if (this.shouldThrottleOperation(operation))
-      return;
     if (!this.isCardModeEnabled())
       return;
     const persisted = this.restoreCardState(operation.taskId);
     const messageId = this.cardMessageIds.get(operation.taskId);
     if (!messageId || messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL || messageId === LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
-      logger6.debug(`onAfterOperationCreate: no usable card for task #${operation.taskId}, skip`);
+      logger7.debug(`onAfterOperationCreate: no usable card for task #${operation.taskId}, skip`);
       return;
     }
     if (persisted && persisted.status !== "open") {
-      logger6.debug(`onAfterOperationCreate: task #${operation.taskId} card status=${persisted.status}, skip`);
+      logger7.debug(`onAfterOperationCreate: task #${operation.taskId} card status=${persisted.status}, skip`);
       return;
     }
     const { milestones, processSteps } = this.deriveTimelineFromOperation(operation);
@@ -1771,6 +2188,17 @@ class LarkCliTaskNotifyHook {
       return;
     const env = getEnvContextOrEmpty();
     const profile = env.replyChannel?.profile;
+    this.cardNotifier.mergeTimelineState?.(messageId, milestones, processSteps);
+    this.refreshTimeline(operation.taskId);
+    const throttled = this.shouldThrottleOperation(operation);
+    if (throttled) {
+      this.scheduleTrailingPatch(operation.taskId, messageId, profile);
+      logger7.debug(`[throttle] OPERATION_CREATED for task #${operation.taskId} ` + `merged into state + ledger; card patch deferred to window end`);
+      return;
+    }
+    await this.patchOperationTimeline(operation.taskId, messageId, profile, milestones, processSteps);
+  }
+  async patchOperationTimeline(taskId, messageId, profile, milestones, processSteps) {
     try {
       await this.cardNotifier.updateTask({
         messageId,
@@ -1780,9 +2208,41 @@ class LarkCliTaskNotifyHook {
         processSteps
       });
     } catch (err) {
-      logger6.error(`sendCardOperation failed for task #${operation.taskId}: ${err.message}`);
+      logger7.error(`sendCardOperation failed for task #${taskId}: ${err.message}`);
     }
   }
+  scheduleTrailingPatch(taskId, messageId, profile) {
+    const existing = this.trailingPatchTimers.get(taskId);
+    if (existing) {
+      return;
+    }
+    const throttleMs = this.config.operationThrottleMs ?? 5000;
+    const delay = throttleMs > 0 ? throttleMs : 0;
+    const timer = setTimeout(() => {
+      this.trailingPatchTimers.delete(taskId);
+      const liveMessageId = this.cardMessageIds.get(taskId);
+      if (liveMessageId !== messageId) {
+        logger7.debug(`[throttle] trailing patch skipped for task #${taskId}: ` + `card no longer tracked (finished/closed)`);
+        return;
+      }
+      const rec = this.cardStateStore?.get(taskId);
+      if (rec && rec.status !== "open") {
+        logger7.debug(`[throttle] trailing patch skipped for task #${taskId}: ` + `card status=${rec.status}`);
+        return;
+      }
+      this.patchOperationTimeline(taskId, messageId, profile, [], []);
+    }, delay);
+    if (typeof timer.unref === "function")
+      timer.unref();
+    this.trailingPatchTimers.set(taskId, timer);
+  }
+  cancelTrailingPatch(taskId) {
+    const timer = this.trailingPatchTimers.get(taskId);
+    if (!timer)
+      return;
+    clearTimeout(timer);
+    this.trailingPatchTimers.delete(taskId);
+  }
   restoreCardState(taskId) {
     if (!this.cardStateStore)
       return;
@@ -1795,12 +2255,12 @@ class LarkCliTaskNotifyHook {
         if (rec.status !== "closed" && rec.messageId) {
           this.cardMessageIds.set(taskId, rec.messageId);
           this.hydrateNotifierState(rec);
-          logger6.debug(`restoreCardState: task #${taskId} ← 持久层 message ${rec.messageId} ` + `(status=${rec.status}, pinned=${rec.pinned}, timeline=${rec.timeline ? "yes" : "no"})`);
+          logger7.debug(`restoreCardState: task #${taskId} ← 持久层 message ${rec.messageId} ` + `(status=${rec.status}, pinned=${rec.pinned}, timeline=${rec.timeline ? "yes" : "no"})`);
         }
       }
       return rec;
     } catch (err) {
-      logger6.warn(`restoreCardState failed for task #${taskId}: ${err.message}`);
+      logger7.warn(`restoreCardState failed for task #${taskId}: ${err.message}`);
       return;
     }
   }
@@ -1811,7 +2271,7 @@ class LarkCliTaskNotifyHook {
       const snapshot = JSON.parse(rec.timeline);
       this.cardNotifier.hydrateState?.(rec.messageId, snapshot);
     } catch (err) {
-      logger6.warn(`hydrateNotifierState failed for task #${rec.taskId}: ${err.message}`);
+      logger7.warn(`hydrateNotifierState failed for task #${rec.taskId}: ${err.message}`);
     }
   }
   snapshotTimeline(state) {
@@ -1823,7 +2283,7 @@ class LarkCliTaskNotifyHook {
         return state;
       return { ...state, timeline: JSON.stringify(snap) };
     } catch (err) {
-      logger6.warn(`snapshotTimeline failed for task #${state.taskId}: ${err.message}`);
+      logger7.warn(`snapshotTimeline failed for task #${state.taskId}: ${err.message}`);
       return state;
     }
   }
@@ -1834,7 +2294,7 @@ class LarkCliTaskNotifyHook {
       const payload = includeTimeline ? this.snapshotTimeline(state) : state;
       this.cardStateStore.upsert(payload);
     } catch (err) {
-      logger6.warn(`persistCardState failed for task #${state.taskId}: ${err.message}`);
+      logger7.warn(`persistCardState failed for task #${state.taskId}: ${err.message}`);
     }
   }
   persistPinned(taskId, pinned) {
@@ -1843,7 +2303,7 @@ class LarkCliTaskNotifyHook {
     try {
       this.cardStateStore.markPinned(taskId, pinned);
     } catch (err) {
-      logger6.warn(`persistPinned failed for task #${taskId}: ${err.message}`);
+      logger7.warn(`persistPinned failed for task #${taskId}: ${err.message}`);
     }
   }
   persistPaused(taskId) {
@@ -1852,7 +2312,7 @@ class LarkCliTaskNotifyHook {
     try {
       this.cardStateStore.markPaused(taskId);
     } catch (err) {
-      logger6.warn(`persistPaused failed for task #${taskId}: ${err.message}`);
+      logger7.warn(`persistPaused failed for task #${taskId}: ${err.message}`);
     }
   }
   dropStaleMessageId(taskId) {
@@ -1869,7 +2329,7 @@ class LarkCliTaskNotifyHook {
         updatedAt: Date.now()
       });
     } catch (err) {
-      logger6.warn(`dropStaleMessageId failed for task #${taskId}: ${err.message}`);
+      logger7.warn(`dropStaleMessageId failed for task #${taskId}: ${err.message}`);
     }
   }
   persistReopened(taskId) {
@@ -1878,7 +2338,7 @@ class LarkCliTaskNotifyHook {
     try {
       this.cardStateStore.markReopened(taskId);
     } catch (err) {
-      logger6.warn(`persistReopened failed for task #${taskId}: ${err.message}`);
+      logger7.warn(`persistReopened failed for task #${taskId}: ${err.message}`);
     }
   }
   persistClosed(taskId) {
@@ -1887,7 +2347,7 @@ class LarkCliTaskNotifyHook {
     try {
       this.cardStateStore.markClosed(taskId);
     } catch (err) {
-      logger6.warn(`persistClosed failed for task #${taskId}: ${err.message}`);
+      logger7.warn(`persistClosed failed for task #${taskId}: ${err.message}`);
     }
   }
   refreshTimeline(taskId) {
@@ -1899,7 +2359,7 @@ class LarkCliTaskNotifyHook {
         return;
       this.cardStateStore.upsert(this.snapshotTimeline(rec));
     } catch (err) {
-      logger6.warn(`refreshTimeline failed for task #${taskId}: ${err.message}`);
+      logger7.warn(`refreshTimeline failed for task #${taskId}: ${err.message}`);
     }
   }
   async repinAfterResume(task, persisted) {
@@ -1915,9 +2375,9 @@ class LarkCliTaskNotifyHook {
     try {
       await this.cardNotifier.pinMessage(persisted.messageId, profile);
       this.persistPinned(task.id, true);
-      logger6.debug(`repinAfterResume: task #${task.id} 卡片 ${persisted.messageId} 已重新置顶`);
+      logger7.debug(`repinAfterResume: task #${task.id} 卡片 ${persisted.messageId} 已重新置顶`);
     } catch (err) {
-      logger6.warn(`repinAfterResume failed (non-fatal) for task #${task.id}: ${err.message}`);
+      logger7.warn(`repinAfterResume failed (non-fatal) for task #${task.id}: ${err.message}`);
     }
   }
   buildCardState(task, messageId, chatId, profile, pinned) {
@@ -1925,7 +2385,7 @@ class LarkCliTaskNotifyHook {
     try {
       existing = this.cardStateStore?.get(task.id);
     } catch (err) {
-      logger6.warn(`buildCardState: read existing failed for task #${task.id}: ${err.message}`);
+      logger7.warn(`buildCardState: read existing failed for task #${task.id}: ${err.message}`);
     }
     const now = Date.now();
     return {
@@ -1959,7 +2419,7 @@ class LarkCliTaskNotifyHook {
   }
   isCardModeEnabled() {
     if (this.config.cardMode === false || !this.cardNotifier) {
-      logger6.debug("cardMode=false (legacy opt-out), skip task notification (no text fallback)");
+      logger7.debug("cardMode=false (legacy opt-out), skip task notification (no text fallback)");
       return false;
     }
     return true;
@@ -2029,7 +2489,7 @@ class LarkCliTaskNotifyHook {
     }
     const claim = this.cardMessageIds.get(task.id);
     if (claim) {
-      logger6.debug(`sendCardStart: task #${task.id} 已有首卡（${claim}）→ 跳过重复发卡`);
+      logger7.debug(`sendCardStart: task #${task.id} 已有首卡（${claim}）→ 跳过重复发卡`);
       return;
     }
     this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL);
@@ -2044,7 +2504,7 @@ class LarkCliTaskNotifyHook {
     const profile = target.profile;
     if (!chatId) {
       this.cardMessageIds.delete(task.id);
-      logger6.debug(`sendCardStart: no chatId for task #${task.id}, skip`);
+      logger7.debug(`sendCardStart: no chatId for task #${task.id}, skip`);
       return;
     }
     try {
@@ -2062,10 +2522,10 @@ class LarkCliTaskNotifyHook {
       });
       this.cardMessageIds.set(task.id, messageId);
       this.persistCardState(this.buildCardState(task, messageId, chatId, profile, pinned), true);
-      logger6.debug(`sendCardStart: task #${task.id} → message ${messageId} (pinned=${pinned}) ` + `chat=${chatId} source=${target.source} reason=${target.reason}`);
+      logger7.debug(`sendCardStart: task #${task.id} → message ${messageId} (pinned=${pinned}) ` + `chat=${chatId} source=${target.source} reason=${target.reason}`);
     } catch (err) {
       this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL);
-      logger6.error(`sendCardStart failed for task #${task.id}: ${err.message}`);
+      logger7.error(`sendCardStart failed for task #${task.id}: ${err.message}`);
     }
   }
   async sendCardUpdate(task, changes) {
@@ -2075,21 +2535,21 @@ class LarkCliTaskNotifyHook {
     if (persisted?.status === "closed") {
       const stillTerminal = isTerminalTaskStatus(String(task.status));
       if (stillTerminal) {
-        logger6.debug(`sendCardUpdate: task #${task.id} 卡片已终结（closed）且任务仍终态 → skip patch`);
+        logger7.debug(`sendCardUpdate: task #${task.id} 卡片已终结（closed）且任务仍终态 → skip patch`);
         return;
       }
-      logger6.info(`sendCardUpdate: task #${task.id} 已 reopen（closed 记录 + 当前 status=${task.status}）` + `→ 重新建卡`);
+      logger7.info(`sendCardUpdate: task #${task.id} 已 reopen（closed 记录 + 当前 status=${task.status}）` + `→ 重新建卡`);
       this.cardMessageIds.delete(task.id);
       this.dropStaleMessageId(task.id);
     }
     if (persisted?.status === "paused" && String(task.status) !== "paused") {
       this.persistReopened(task.id);
-      logger6.debug(`sendCardUpdate: task #${task.id} resume（paused → open），复用卡片 ${persisted.messageId}`);
+      logger7.debug(`sendCardUpdate: task #${task.id} resume（paused → open），复用卡片 ${persisted.messageId}`);
       await this.repinAfterResume(task, persisted);
     }
     let messageId = this.cardMessageIds.get(task.id);
     if (!messageId && isTerminalTaskStatus(String(task.status))) {
-      logger6.debug(`sendCardUpdate: task #${task.id} 状态=${task.status}（终结/归档）且无卡片 → skip`);
+      logger7.debug(`sendCardUpdate: task #${task.id} 状态=${task.status}（终结/归档）且无卡片 → skip`);
       return;
     }
     if (!messageId) {
@@ -2101,15 +2561,15 @@ class LarkCliTaskNotifyHook {
     if (!chatId) {
       if (!messageId)
         this.cardMessageIds.delete(task.id);
-      logger6.debug(`sendCardUpdate: no chatId for task #${task.id}, skip`);
+      logger7.debug(`sendCardUpdate: no chatId for task #${task.id}, skip`);
       return;
     }
     if (messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL) {
-      logger6.debug(`sendCardUpdate: startTask failed previously for task #${task.id}, skip`);
+      logger7.debug(`sendCardUpdate: startTask failed previously for task #${task.id}, skip`);
       return;
     }
     if (messageId === LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
-      logger6.debug(`sendCardUpdate: task #${task.id} 首卡正在发送中（in-flight）→ 跳过本次 update`);
+      logger7.debug(`sendCardUpdate: task #${task.id} 首卡正在发送中（in-flight）→ 跳过本次 update`);
       return;
     }
     if (!messageId) {
@@ -2124,7 +2584,7 @@ class LarkCliTaskNotifyHook {
         this.persistCardState(this.buildCardState(task, messageId, chatId, profile, res.pinned), true);
       } catch (err) {
         this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL);
-        logger6.error(`sendCardUpdate fallback start failed: ${err.message}`);
+        logger7.error(`sendCardUpdate fallback start failed: ${err.message}`);
         return;
       }
     }
@@ -2151,7 +2611,7 @@ class LarkCliTaskNotifyHook {
       this.persistPinned(task.id, current?.pinned ?? persisted?.pinned ?? true);
       this.refreshTimeline(task.id);
     } catch (err) {
-      logger6.error(`sendCardUpdate failed: ${err.message}`);
+      logger7.error(`sendCardUpdate failed: ${err.message}`);
     }
   }
   async sendCardFinish(task) {
@@ -2162,13 +2622,14 @@ class LarkCliTaskNotifyHook {
     const ctx = getEnvContextOrEmpty();
     const profile = this.resolveProfile(task, ctx);
     if (!messageId || messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL) {
-      logger6.debug(`sendCardFinish: no card messageId for task #${task.id}, skip ` + `(记录缺失 → 不发新卡，保持幂等)`);
+      logger7.debug(`sendCardFinish: no card messageId for task #${task.id}, skip ` + `(记录缺失 → 不发新卡，保持幂等)`);
       return;
     }
     const rawStatus = String(task.status);
     const status = mapTaskStatusToCardStatus(rawStatus);
     const isPaused = rawStatus === "paused" || rawStatus === "archived";
     try {
+      this.cancelTrailingPatch(task.id);
       const finish = isPaused ? this.cardNotifier.pauseTask.bind(this.cardNotifier) : this.cardNotifier.finishTask.bind(this.cardNotifier);
       await finish({
         messageId,
@@ -2188,9 +2649,9 @@ class LarkCliTaskNotifyHook {
         this.persistPinned(task.id, false);
         this.cardMessageIds.delete(task.id);
       }
-      logger6.debug(`sendCardFinish: task #${task.id} → status=${status} ` + `(raw=${rawStatus}) message=${messageId}`);
+      logger7.debug(`sendCardFinish: task #${task.id} → status=${status} ` + `(raw=${rawStatus}) message=${messageId}`);
     } catch (err) {
-      logger6.error(`sendCardFinish failed: ${err.message}`);
+      logger7.error(`sendCardFinish failed: ${err.message}`);
     }
   }
   resolveChatId(task, env) {
@@ -2267,7 +2728,7 @@ class LarkCliTaskNotifyHook {
     const now = Date.now();
     const lastTime = this.lastNotifyTimestamps.get(key);
     if (lastTime && now - lastTime < throttleMs) {
-      logger6.debug(`[throttle] skip OPERATION_CREATED patch for task #${operation.taskId} (${now - lastTime}ms ago)`);
+      logger7.debug(`[throttle] skip OPERATION_CREATED patch for task #${operation.taskId} (${now - lastTime}ms ago)`);
       return true;
     }
     this.lastNotifyTimestamps.set(key, now);
@@ -2310,7 +2771,7 @@ init_decorator();
 init_logger();
 init_context();
 import { spawn } from "child_process";
-var logger7 = createLogger("lark-cli:per-task-group");
+var logger8 = createLogger("lark-cli:per-task-group");
 function isPluginDebugEnabled() {
   return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
 }
@@ -2365,7 +2826,7 @@ class PerTaskGroupChatPlugin {
     const renderedName = this.renderTemplate(this.config.nameTemplate, task);
     const existingChatId = this.getTaskChatId(task);
     if (existingChatId) {
-      logger7.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 已有专属群 ${existingChatId} → 复用（不重复建群）`);
+      logger8.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 已有专属群 ${existingChatId} → 复用（不重复建群）`);
       return {
         chatId: existingChatId,
         profile: this.parseProfileFromContext(task.context),
@@ -2374,7 +2835,7 @@ class PerTaskGroupChatPlugin {
     }
     const inflight = this.groupChatInflight.get(task.id);
     if (inflight) {
-      logger7.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 建群已在进行中 → 复用同一 promise`);
+      logger8.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 建群已在进行中 → 复用同一 promise`);
       return inflight;
     }
     const pending = this.doEnsureGroupChat(task, renderedName, replyChannelOverride);
@@ -2388,7 +2849,7 @@ class PerTaskGroupChatPlugin {
   async doEnsureGroupChat(task, name, replyChannelOverride) {
     const replyChannel = replyChannelOverride ?? getEnvContextOrEmpty().replyChannel;
     if (!replyChannel?.chatId && this.config.requireReplyChannel) {
-      logger7.warn(`ensureGroupChat[${this.pluginName}]: no replyChannel.chatId for task #${task.id} ` + `(requireReplyChannel=true) → 无法建群`);
+      logger8.warn(`ensureGroupChat[${this.pluginName}]: no replyChannel.chatId for task #${task.id} ` + `(requireReplyChannel=true) → 无法建群`);
       return;
     }
     const description = this.renderTemplate(this.config.descriptionTemplate, task);
@@ -2406,30 +2867,30 @@ class PerTaskGroupChatPlugin {
       await this.writeChatBinding(task, chatId, profile, "creating");
       await this.attachChatIdToTask(task, chatId, profile);
       await this.writeChatBinding(task, chatId, profile, "ready");
-      logger7.info(`ensureGroupChat[${this.pluginName}]: created group ${chatId} for task #${task.id}`);
+      logger8.info(`ensureGroupChat[${this.pluginName}]: created group ${chatId} for task #${task.id}`);
       return { chatId, profile, name };
     } catch (error) {
-      logger7.error(`ensureGroupChat[${this.pluginName}]: failed for task #${task.id}: ${error}`);
+      logger8.error(`ensureGroupChat[${this.pluginName}]: failed for task #${task.id}: ${error}`);
       return;
     }
   }
   setTaskUpdater(updater) {
     this.taskUpdater = updater;
-    logger7.debug(`TaskUpdater injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+    logger8.debug(`TaskUpdater injected for plugin ${this.name} (sourceId=${this.sourceId})`);
   }
   hasTaskUpdater() {
     return this.taskUpdater !== undefined;
   }
   setTaskGetter(getter) {
     this.taskGetter = getter;
-    logger7.debug(`TaskGetter injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+    logger8.debug(`TaskGetter injected for plugin ${this.name} (sourceId=${this.sourceId})`);
   }
   hasTaskGetter() {
     return this.taskGetter !== undefined;
   }
   setSessionComponent(sessionComponent) {
     this.sessionComponent = sessionComponent;
-    logger7.debug(`SessionComponent injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+    logger8.debug(`SessionComponent injected for plugin ${this.name} (sourceId=${this.sourceId})`);
   }
   hasSessionComponent() {
     return this.sessionComponent !== undefined;
@@ -2442,7 +2903,7 @@ class PerTaskGroupChatPlugin {
       if (process.env.ROY_HOOK_DEBUG === "1") {
         console.error(`[DEBUG per-task-group-chat.execute] → SKIP (config.enabled=false)`);
       }
-      logger7.debug(`execute: plugin disabled (pluginName=${this.pluginName})`);
+      logger8.debug(`execute: plugin disabled (pluginName=${this.pluginName})`);
       return;
     }
     if (this.pluginName && this.sourceId) {
@@ -2455,13 +2916,13 @@ class PerTaskGroupChatPlugin {
         if (process.env.ROY_HOOK_DEBUG === "1") {
           console.error(`[DEBUG per-task-group-chat.execute] → SKIP (plugin NOT enabled for ${key})`);
         }
-        logger7.debug(`execute[${this.pluginName}]: plugin NOT enabled (key=${key}, ` + `env.pluginEnabled=${JSON.stringify(env.pluginEnabled)}, ` + `hookPoint=${ctx.hookPoint}). ` + `→ skip. 修复：roy-agent eventsource update <id> 必须包含 PerTaskGroupChatPlugin`);
+        logger8.debug(`execute[${this.pluginName}]: plugin NOT enabled (key=${key}, ` + `env.pluginEnabled=${JSON.stringify(env.pluginEnabled)}, ` + `hookPoint=${ctx.hookPoint}). ` + `→ skip. 修复：roy-agent eventsource update <id> 必须包含 PerTaskGroupChatPlugin`);
         return;
       }
       const enabledState = env.pluginEnabled ? env.pluginEnabled[key] === true ? "✅ enabled" : "❌ NOT enabled" : "⚠️  env.pluginEnabled 未设置 (env 没创建 / 插件未注册到 eventsource)";
-      logger7.debug(`execute[${this.pluginName}]: ${enabledState} (key=${key}, ` + `hookPoint=${ctx.hookPoint}, taskUpdaterInjected=${this.hasTaskUpdater()})`);
+      logger8.debug(`execute[${this.pluginName}]: ${enabledState} (key=${key}, ` + `hookPoint=${ctx.hookPoint}, taskUpdaterInjected=${this.hasTaskUpdater()})`);
     } else {
-      logger7.debug(`execute[${this.pluginName}]: missing pluginName/sourceId metadata ` + `(pluginName=${this.pluginName}, sourceId=${this.sourceId}), ` + `skipping pluginEnabled check. hookPoint=${ctx.hookPoint}`);
+      logger8.debug(`execute[${this.pluginName}]: missing pluginName/sourceId metadata ` + `(pluginName=${this.pluginName}, sourceId=${this.sourceId}), ` + `skipping pluginEnabled check. hookPoint=${ctx.hookPoint}`);
     }
     if (process.env.ROY_HOOK_DEBUG === "1") {
       console.error(`[DEBUG per-task-group-chat.execute] → PASSED pluginEnabled check, will dispatch hookPoint=${ctx.hookPoint}`);
@@ -2480,13 +2941,13 @@ class PerTaskGroupChatPlugin {
         await this.onAfterComplete(ctx);
         break;
       default:
-        logger7.debug(`execute: unhandled hookPoint=${ctx.hookPoint}, skip`);
+        logger8.debug(`execute: unhandled hookPoint=${ctx.hookPoint}, skip`);
     }
   }
   async onAfterCreate(ctx) {
     const data = ctx.data;
     if (!data?.task) {
-      logger7.debug("onAfterCreate: task is missing, skip");
+      logger8.debug("onAfterCreate: task is missing, skip");
       return;
     }
     const { task } = data;
@@ -2497,38 +2958,38 @@ class PerTaskGroupChatPlugin {
       console.error(`[DEBUG per-task-group-chat.onAfterCreate] env.messageId=${env.messageId}`);
       console.error(`[DEBUG per-task-group-chat.onAfterCreate] env.sourceId=${env.sourceId}`);
     }
-    logger7.debug(`onAfterCreate[${this.pluginName}]: enter task=${task.id} "${task.title}" ` + `parent_task_id=${task.parent_task_id ?? "none"} ` + `requireReplyChannel=${this.config.requireReplyChannel} ` + `disableSubTaskSkip=${this.config.disableSubTaskSkip} ` + `sendWelcomeMessage=${this.config.sendWelcomeMessage} ` + `autoCreateGroup=${this.config.autoCreateGroup}`);
+    logger8.debug(`onAfterCreate[${this.pluginName}]: enter task=${task.id} "${task.title}" ` + `parent_task_id=${task.parent_task_id ?? "none"} ` + `requireReplyChannel=${this.config.requireReplyChannel} ` + `disableSubTaskSkip=${this.config.disableSubTaskSkip} ` + `sendWelcomeMessage=${this.config.sendWelcomeMessage} ` + `autoCreateGroup=${this.config.autoCreateGroup}`);
     if (!this.config.autoCreateGroup) {
-      logger7.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} autoCreateGroup=false ` + `→ skip group chat creation（按需建群：用户在卡片顶部按钮触发）`);
+      logger8.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} autoCreateGroup=false ` + `→ skip group chat creation（按需建群：用户在卡片顶部按钮触发）`);
       return;
     }
     const replyChannel = this.getReplyChannelFromCtx(ctx);
     if (!replyChannel?.chatId && this.config.requireReplyChannel) {
-      logger7.debug(`onAfterCreate[${this.pluginName}]: no replyChannel.chatId for task #${task.id}, skip. ` + `修复：eventsource 收到 im.message.receive_v1 事件时 replyChannel 应有值；` + `或在 plugin config 设 requireReplyChannel=false 强制创建群聊（profile 降级到 fallbackProfile/无）`);
+      logger8.debug(`onAfterCreate[${this.pluginName}]: no replyChannel.chatId for task #${task.id}, skip. ` + `修复：eventsource 收到 im.message.receive_v1 事件时 replyChannel 应有值；` + `或在 plugin config 设 requireReplyChannel=false 强制创建群聊（profile 降级到 fallbackProfile/无）`);
       return;
     }
     if (!replyChannel?.chatId && !this.config.requireReplyChannel) {
-      logger7.debug(`onAfterCreate[${this.pluginName}]: no replyChannel but requireReplyChannel=false, ` + `proceeding with profile fallback (fallbackProfile="${this.config.fallbackProfile}")`);
+      logger8.debug(`onAfterCreate[${this.pluginName}]: no replyChannel but requireReplyChannel=false, ` + `proceeding with profile fallback (fallbackProfile="${this.config.fallbackProfile}")`);
     }
     if (this.isSubTask(task) && !this.config.disableSubTaskSkip) {
-      logger7.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task, ` + `skip group chat creation. 关闭方式：config.disableSubTaskSkip=true`);
+      logger8.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task, ` + `skip group chat creation. 关闭方式：config.disableSubTaskSkip=true`);
       return;
     }
     if (this.isSubTask(task) && this.config.disableSubTaskSkip) {
-      logger7.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task but ` + `disableSubTaskSkip=true, proceeding to create group chat`);
+      logger8.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task but ` + `disableSubTaskSkip=true, proceeding to create group chat`);
     }
     try {
       const created = await this.ensureGroupChat(task, replyChannel);
       if (!created?.chatId) {
-        logger7.error(`onAfterCreate[${this.pluginName}]: ensureGroupChat 未返回 chatId for task #${task.id}`);
+        logger8.error(`onAfterCreate[${this.pluginName}]: ensureGroupChat 未返回 chatId for task #${task.id}`);
         if (!this.config.fallbackToMain) {
           throw new Error(`per-task group chat unavailable for task #${task.id}`);
         }
         return;
       }
-      logger7.info(`onAfterCreate[${this.pluginName}]: task #${task.id} → group ${created.chatId} ` + `(initial card owned by LarkCliTaskNotifyHook)`);
+      logger8.info(`onAfterCreate[${this.pluginName}]: task #${task.id} → group ${created.chatId} ` + `(initial card owned by LarkCliTaskNotifyHook)`);
     } catch (error) {
-      logger7.error(`onAfterCreate[${this.pluginName}]: group chat failed for task #${task.id}: ${error}`);
+      logger8.error(`onAfterCreate[${this.pluginName}]: group chat failed for task #${task.id}: ${error}`);
       if (!this.config.fallbackToMain)
         throw error;
     }
@@ -2536,7 +2997,7 @@ class PerTaskGroupChatPlugin {
   async writeChatBinding(task, chatId, profile, status, errorMessage) {
     if (!this.sessionComponent) {
       if (isPluginDebugEnabled()) {
-        logger7.debug(`writeChatBinding[${this.pluginName}]: no sessionComponent injected, ` + `skip chat-task binding for chat ${chatId} (status=${status})`);
+        logger8.debug(`writeChatBinding[${this.pluginName}]: no sessionComponent injected, ` + `skip chat-task binding for chat ${chatId} (status=${status})`);
       }
       return;
     }
@@ -2549,37 +3010,37 @@ class PerTaskGroupChatPlugin {
         errorMessage: errorMessage ?? null
       });
     } catch (bindErr) {
-      logger7.warn(`writeChatBinding[${this.pluginName}]: failed to write chat-task binding for ` + `chat ${chatId} / task #${task.id} (status=${status}): ${bindErr}. ` + `群消息 handler 将无法自动注入 parentTaskId。`);
+      logger8.warn(`writeChatBinding[${this.pluginName}]: failed to write chat-task binding for ` + `chat ${chatId} / task #${task.id} (status=${status}): ${bindErr}. ` + `群消息 handler 将无法自动注入 parentTaskId。`);
     }
   }
   async onAfterUpdate(ctx) {
     const data = ctx.data;
     if (!data?.task) {
-      logger7.debug("onAfterUpdate: task is missing, skip");
+      logger8.debug("onAfterUpdate: task is missing, skip");
       return;
     }
-    logger7.debug(`onAfterUpdate[${this.pluginName}]: task #${data.task.id} 卡片由 ` + `LarkCliTaskNotifyHook 负责（本插件不再 patch），skip`);
+    logger8.debug(`onAfterUpdate[${this.pluginName}]: task #${data.task.id} 卡片由 ` + `LarkCliTaskNotifyHook 负责（本插件不再 patch），skip`);
   }
   async onAfterOperationCreate(ctx) {
     const data = ctx.data;
     if (!data?.operation) {
-      logger7.debug("onAfterOperationCreate: operation is missing, skip");
+      logger8.debug("onAfterOperationCreate: operation is missing, skip");
       return;
     }
-    logger7.debug(`onAfterOperationCreate[${this.pluginName}]: operation #${data.operation.id} ` + `卡片由 LarkCliTaskNotifyHook 负责，skip`);
+    logger8.debug(`onAfterOperationCreate[${this.pluginName}]: operation #${data.operation.id} ` + `卡片由 LarkCliTaskNotifyHook 负责，skip`);
   }
   async onAfterComplete(ctx) {
     const data = ctx.data;
     if (!data?.task) {
-      logger7.debug("onAfterComplete: task is missing, skip");
+      logger8.debug("onAfterComplete: task is missing, skip");
       return;
     }
-    logger7.debug(`onAfterComplete[${this.pluginName}]: task #${data.task.id} 终态卡片由 ` + `LarkCliTaskNotifyHook 负责，skip`);
+    logger8.debug(`onAfterComplete[${this.pluginName}]: task #${data.task.id} 终态卡片由 ` + `LarkCliTaskNotifyHook 负责，skip`);
   }
   createGroupChat(opts) {
     const args = this.buildCreateGroupChatArgs(opts);
     if (isPluginDebugEnabled()) {
-      logger7.debug(`Creating group chat: lark-cli ${args.join(" ")}`);
+      logger8.debug(`Creating group chat: lark-cli ${args.join(" ")}`);
     }
     return new Promise((resolve, reject) => {
       const proc = spawn("lark-cli", args, {
@@ -2654,16 +3115,16 @@ class PerTaskGroupChatPlugin {
     parsed[CTX_FIELD_CHAT_TASK_ID] = task.id;
     const newContext = JSON.stringify(parsed);
     if (!this.taskUpdater) {
-      logger7.warn(`attachChatIdToTask[${this.pluginName}]: ⚠️  no taskUpdater injected, ` + `chat_id ${chatId} NOT persisted to db for task #${task.id}. ` + `后果：下次 AFTER_UPDATE 从 DB 加载 task 时 getTaskChatId() 返回 undefined，` + `所有 update/complete/operation 通知 silently 丢失。` + `修复：event-source-handlers.ts:registerPluginHooks 应自动注入 setTaskUpdater。`);
+      logger8.warn(`attachChatIdToTask[${this.pluginName}]: ⚠️  no taskUpdater injected, ` + `chat_id ${chatId} NOT persisted to db for task #${task.id}. ` + `后果：下次 AFTER_UPDATE 从 DB 加载 task 时 getTaskChatId() 返回 undefined，` + `所有 update/complete/operation 通知 silently 丢失。` + `修复：event-source-handlers.ts:registerPluginHooks 应自动注入 setTaskUpdater。`);
       task.context = newContext;
       return;
     }
     try {
       await this.taskUpdater(task.id, newContext);
       task.context = newContext;
-      logger7.debug(`attachChatIdToTask[${this.pluginName}]: ✅ persisted chat_id ${chatId} ` + `to task #${task.id} context`);
+      logger8.debug(`attachChatIdToTask[${this.pluginName}]: ✅ persisted chat_id ${chatId} ` + `to task #${task.id} context`);
     } catch (error) {
-      logger7.error(`Failed to persist chat_id to task #${task.id}: ${error}`);
+      logger8.error(`Failed to persist chat_id to task #${task.id}: ${error}`);
       task.context = newContext;
     }
   }
@@ -2758,15 +3219,15 @@ class PerTaskGroupChatPlugin {
   }
   resolveBotAppIds(replyChannel) {
     if (this.config.botAppIds.length > 0) {
-      logger7.debug(`resolveBotAppIds[${this.pluginName}]: using config.botAppIds=${JSON.stringify(this.config.botAppIds)}`);
+      logger8.debug(`resolveBotAppIds[${this.pluginName}]: using config.botAppIds=${JSON.stringify(this.config.botAppIds)}`);
       return this.config.botAppIds;
     }
     const appId = replyChannel ? replyChannel.appId : undefined;
     if (appId) {
-      logger7.debug(`resolveBotAppIds[${this.pluginName}]: using replyChannel.appId=${appId} (auto-detected from event header.app_id)`);
+      logger8.debug(`resolveBotAppIds[${this.pluginName}]: using replyChannel.appId=${appId} (auto-detected from event header.app_id)`);
       return [appId];
     }
-    logger7.warn(`resolveBotAppIds[${this.pluginName}]: ⚠️ no botAppIds found, creating group WITHOUT --bots. ` + `Bot will NOT be invited automatically. ` + `可能原因：(1) eventsource 没有收到 im.message.receive_v1 事件（replyChannel.appId 缺失）；` + `(2) 配置了 requireReplyChannel=false 模式；` + `(3) buildReplyChannel 没透传 appId（应在 v1.10+ 修复）。` + `修复：手动设置 config.botAppIds: ["cli_xxx"] 或确认 eventsource 处理了 lark event。`);
+    logger8.warn(`resolveBotAppIds[${this.pluginName}]: ⚠️ no botAppIds found, creating group WITHOUT --bots. ` + `Bot will NOT be invited automatically. ` + `可能原因：(1) eventsource 没有收到 im.message.receive_v1 事件（replyChannel.appId 缺失）；` + `(2) 配置了 requireReplyChannel=false 模式；` + `(3) buildReplyChannel 没透传 appId（应在 v1.10+ 修复）。` + `修复：手动设置 config.botAppIds: ["cli_xxx"] 或确认 eventsource 处理了 lark event。`);
     return [];
   }
   resolveUserIds(replyChannel) {
@@ -2776,7 +3237,7 @@ class PerTaskGroupChatPlugin {
         if (id && id !== "sender" && id.startsWith("ou_")) {
           ids.add(id);
         } else if (id && id !== "sender") {
-          logger7.debug(`resolveUserIds[${this.pluginName}]: skip non-open_id in defaultInviteUserIds: "${id}"`);
+          logger8.debug(`resolveUserIds[${this.pluginName}]: skip non-open_id in defaultInviteUserIds: "${id}"`);
         }
       }
     }
@@ -2799,7 +3260,7 @@ class PerTaskGroupChatPlugin {
       }
     }
     if (isPluginDebugEnabled()) {
-      logger7.debug(`resolveUserIds[${this.pluginName}]: ` + `defaultInviteUserIds=${JSON.stringify(this.config.defaultInviteUserIds)} ` + `inviteUserIds=${JSON.stringify(this.config.inviteUserIds)} ` + `replyChannel.userId=${replyChannel?.userId ?? "(none)"} ` + `→ final userIds=${JSON.stringify(Array.from(ids))}`);
+      logger8.debug(`resolveUserIds[${this.pluginName}]: ` + `defaultInviteUserIds=${JSON.stringify(this.config.defaultInviteUserIds)} ` + `inviteUserIds=${JSON.stringify(this.config.inviteUserIds)} ` + `replyChannel.userId=${replyChannel?.userId ?? "(none)"} ` + `→ final userIds=${JSON.stringify(Array.from(ids))}`);
     }
     return Array.from(ids);
   }
@@ -2952,4 +3413,4 @@ __legacyDecorateClassTS([
 function createPerTaskGroupChatPlugin(config = {}) {
   return new PerTaskGroupChatPlugin(config);
 }
-export { createAutoTaskPlugin, pickGateConfidence, LayaDecisionPort, loadLayaAuthForPurpose, LAYA_REUSE_THRESHOLD, LayaDecisionPlugin, createLayaDecisionPlugin, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, MemoryLarkCardStateStore, SqliteLarkCardStateStore, getDefaultLarkCardDbPath, createLarkCardStateStore, extractPerTaskChatId, extractPerTaskChatName, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };
+export { createAutoTaskPlugin, LAYA_REUSE_THRESHOLD, LayaDecisionPlugin, createLayaDecisionPlugin, LAYA_COMPLETION_THRESHOLD, buildCompletionHint, renderCompletionState, buildCompletionQuestion, LayaCompletionPlugin, createLayaCompletionPlugin, registerLayaCompletionTaskHook, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, MemoryLarkCardStateStore, SqliteLarkCardStateStore, getDefaultLarkCardDbPath, createLarkCardStateStore, extractPerTaskChatId, extractPerTaskChatName, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };