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

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

@@ -1,3 +1,10 @@
+import {
+  WecomCardActionKey,
+  buildWecomButtonInteractionCard,
+  buildWecomTextNoticeCard,
+  sendWecomReply,
+  sendWecomTemplateCard
+} from "./roy-agent-core-m3vjepzz.js";
 import {
   getSharedEventStore
 } from "./roy-agent-core-na18zwj0.js";
@@ -24,7 +31,7 @@ import {
 import {
   LarkCardPatchNotifier,
   humanizeValue
-} from "./roy-agent-core-w0qjeq2v.js";
+} from "./roy-agent-core-7dd0s3xb.js";
 import {
   validateWorkflowDefinition
 } from "./roy-agent-core-1v4g0d4x.js";
@@ -38,7 +45,8 @@ import {
   init_context
 } from "./roy-agent-core-qqaak24r.js";
 import {
-  getEnvContextOrEmpty
+  getEnvContextOrEmpty,
+  init_env_context
 } from "./roy-agent-core-7cbpmk4q.js";
 import {
   TracedAs,
@@ -2384,6 +2392,66 @@ class LarkCliTaskNotifyHook {
       logger7.warn(`repinAfterResume failed (non-fatal) for task #${task.id}: ${err.message}`);
     }
   }
+  async reopenReuseCard(task, persisted, changes) {
+    if (!this.cardNotifier)
+      return false;
+    const messageId = persisted.messageId;
+    if (!messageId) {
+      logger7.debug(`reopenReuseCard: task #${task.id} 记录无 messageId → 走建卡路径`);
+      return false;
+    }
+    const ctx = getEnvContextOrEmpty();
+    const profile = this.resolveProfile(task, ctx);
+    this.cardNotifier.unfinaliseCard?.(messageId);
+    const reopenMilestone = {
+      title: "\uD83D\uDD04 任务重新打开",
+      timestamp: new Date().toISOString(),
+      description: task.current_status || undefined
+    };
+    const changeKeys = Object.keys(changes ?? {});
+    const reopenSteps = changeKeys.length > 0 ? [
+      {
+        title: "任务重新打开",
+        timestamp: new Date().toISOString(),
+        description: changeKeys.map((k) => `${k}=${humanizeValue(changes[k], 80)}`).join(" · ")
+      }
+    ] : [];
+    const hasState = this.cardNotifier.exportState?.(messageId) !== undefined;
+    if (!hasState) {
+      const persistedRec = this.cardStateStore?.get(task.id);
+      if (persistedRec?.timeline) {
+        this.hydrateNotifierState(persistedRec);
+        logger7.debug(`reopenReuseCard: task #${task.id} 内存态缺失 → ` + `从持久层快照恢复卡片内容（历史时间线保留）`);
+      }
+    }
+    const merged = this.cardNotifier.mergeTimelineState?.(messageId, [reopenMilestone], reopenSteps) ?? false;
+    try {
+      await this.cardNotifier.updateTask({
+        messageId,
+        profile,
+        status: "running",
+        meta: this.buildTaskMeta(task),
+        progress: typeof task.progress === "number" && task.progress > 0 ? task.progress : undefined,
+        milestones: merged ? [] : [reopenMilestone],
+        processSteps: merged ? [] : reopenSteps
+      });
+    } catch (err) {
+      logger7.warn(`reopenReuseCard: task #${task.id} 原卡 patch 失败: ` + `${err.message}`);
+      return false;
+    }
+    this.persistReopened(task.id);
+    this.refreshTimeline(task.id);
+    try {
+      await this.repinAfterResume(task, {
+        ...persisted,
+        status: "open"
+      });
+    } catch (pinErr) {
+      logger7.warn(`reopenReuseCard: task #${task.id} 重新 pin 失败（非致命，卡片内容已更新）: ` + `${pinErr.message}`);
+    }
+    logger7.info(`reopenReuseCard: task #${task.id} 已复用原卡 ${messageId} ` + `(patch + reopen 里程碑 + 重新 pin)`);
+    return true;
+  }
   buildCardState(task, messageId, chatId, profile, pinned) {
     let existing;
     try {
@@ -2542,7 +2610,12 @@ class LarkCliTaskNotifyHook {
         logger7.debug(`sendCardUpdate: task #${task.id} 卡片已终结（closed）且任务仍终态 → skip patch`);
         return;
       }
-      logger7.info(`sendCardUpdate: task #${task.id} 已 reopen（closed 记录 + 当前 status=${task.status}）` + `→ 重新建卡`);
+      const reused = await this.reopenReuseCard(task, persisted, changes);
+      if (reused) {
+        this.cardMessageIds.set(task.id, persisted.messageId);
+        return;
+      }
+      logger7.info(`sendCardUpdate: task #${task.id} 已 reopen 但原卡 patch 失败 → 降级发新卡`);
       this.cardMessageIds.delete(task.id);
       this.dropStaleMessageId(task.id);
     }
@@ -2605,7 +2678,7 @@ class LarkCliTaskNotifyHook {
         messageId,
         chatId,
         profile,
-        status: "running",
+        status: String(task.status) === "to_validate" ? "to_validate" : "running",
         meta: this.buildTaskMeta(task),
         progress: typeof task.progress === "number" && task.progress > 0 ? task.progress : undefined,
         milestones: [],
@@ -2770,12 +2843,744 @@ __legacyDecorateClassTS([
 function createLarkCliTaskNotifyHook(config = {}) {
   return new LarkCliTaskNotifyHook(config);
 }
+// src/env/task/plugins/wecom-task-notify-plugin.ts
+init_logger();
+init_env_context();
+
+// src/env/task/plugins/wecom-card-state-store.ts
+init_logger();
+init_sqlite_task_store();
+import { join as join2 } from "path";
+var logger8 = createLogger("wecom:card-state");
+
+class MemoryWecomCardStateStore {
+  records = new Map;
+  upsert(state) {
+    this.records.set(state.taskId, { ...state });
+  }
+  get(taskId) {
+    const r = this.records.get(taskId);
+    return r ? { ...r } : undefined;
+  }
+  list() {
+    return [...this.records.values()].map((r) => ({ ...r }));
+  }
+  markPaused(taskId) {
+    const r = this.records.get(taskId);
+    if (!r)
+      return;
+    r.status = "paused";
+    r.updatedAt = Date.now();
+  }
+  markReopened(taskId) {
+    const r = this.records.get(taskId);
+    if (!r)
+      return;
+    r.status = "open";
+    delete r.closedAt;
+    r.updatedAt = Date.now();
+  }
+  markClosed(taskId) {
+    const r = this.records.get(taskId);
+    if (!r)
+      return;
+    const now = Date.now();
+    r.status = "closed";
+    r.closedAt = now;
+    r.updatedAt = now;
+  }
+  delete(taskId) {
+    this.records.delete(taskId);
+  }
+  close() {
+    this.records.clear();
+  }
+}
+function createMemoryWecomCardStore() {
+  return new MemoryWecomCardStateStore;
+}
+function rowToState2(row) {
+  const state = {
+    taskId: row.task_id,
+    chatId: row.chat_id,
+    pinned: row.pinned === 1,
+    status: row.status ?? "open",
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+    updateCount: row.update_count ?? 0
+  };
+  if (row.closed_at !== null && row.closed_at !== undefined) {
+    state.closedAt = row.closed_at;
+  }
+  if (row.timeline)
+    state.timeline = row.timeline;
+  return state;
+}
+
+class SqliteWecomCardStateStore {
+  db;
+  constructor(dbPath) {
+    if (dbPath !== ":memory:") {
+      const { mkdirSync } = __require("fs");
+      const dir = __require("path").dirname(dbPath);
+      try {
+        mkdirSync(dir, { recursive: true });
+      } catch {}
+    }
+    this.db = createCompatibleDatabase(dbPath);
+    try {
+      this.db.run("PRAGMA journal_mode = WAL");
+      this.db.run("PRAGMA busy_timeout = 5000");
+      this.db.run("PRAGMA synchronous = NORMAL");
+    } catch {}
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS wecom_card (
+        task_id INTEGER PRIMARY KEY,
+        chat_id TEXT NOT NULL,
+        pinned INTEGER NOT NULL DEFAULT 0,
+        status TEXT NOT NULL DEFAULT 'open',
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        closed_at INTEGER,
+        update_count INTEGER NOT NULL DEFAULT 0,
+        timeline TEXT
+      )
+    `);
+    this.db.run("CREATE INDEX IF NOT EXISTS idx_wecom_card_status ON wecom_card(status)");
+  }
+  upsert(state) {
+    this.db.prepare(`INSERT INTO wecom_card
+          (task_id, chat_id, pinned, status, created_at, updated_at, closed_at, update_count, timeline)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(task_id) DO UPDATE SET
+           chat_id     = excluded.chat_id,
+           pinned      = excluded.pinned,
+           status      = excluded.status,
+           updated_at  = excluded.updated_at,
+           closed_at   = excluded.closed_at,
+           update_count = excluded.update_count,
+           timeline    = excluded.timeline`).run(state.taskId, state.chatId, state.pinned ? 1 : 0, state.status, state.createdAt, state.updatedAt, state.closedAt ?? null, state.updateCount, state.timeline ?? null);
+  }
+  get(taskId) {
+    const row = this.db.prepare("SELECT * FROM wecom_card WHERE task_id = ?").get(taskId);
+    return row ? rowToState2(row) : undefined;
+  }
+  list() {
+    const rows = this.db.prepare("SELECT * FROM wecom_card ORDER BY task_id ASC").all();
+    return rows.map(rowToState2);
+  }
+  markPaused(taskId) {
+    this.db.prepare("UPDATE wecom_card SET status = 'paused', updated_at = ? WHERE task_id = ?").run(Date.now(), taskId);
+  }
+  markReopened(taskId) {
+    this.db.prepare("UPDATE wecom_card SET status = 'open', closed_at = NULL, updated_at = ? WHERE task_id = ?").run(Date.now(), taskId);
+  }
+  markClosed(taskId) {
+    const now = Date.now();
+    this.db.prepare("UPDATE wecom_card SET status = 'closed', closed_at = ?, updated_at = ? WHERE task_id = ?").run(now, now, taskId);
+  }
+  delete(taskId) {
+    this.db.prepare("DELETE FROM wecom_card WHERE task_id = ?").run(taskId);
+  }
+  close() {
+    try {
+      this.db.close?.();
+    } catch {}
+  }
+}
+function getDefaultWecomCardDbPath() {
+  const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+  return join2(home, ".local", "share", "roy-agent", "wecom-cards.db");
+}
+function createWecomCardStateStore(dbPath) {
+  const isTestEnv = "BUN_TEST_WORKER_ID" in process.env;
+  if (!dbPath && !process.env.ROY_AGENT_WECOM_CARD_DB && isTestEnv) {
+    return new MemoryWecomCardStateStore;
+  }
+  const path = dbPath ?? process.env.ROY_AGENT_WECOM_CARD_DB ?? getDefaultWecomCardDbPath();
+  try {
+    return new SqliteWecomCardStateStore(path);
+  } catch (err) {
+    logger8.warn(`WecomCardStateStore: sqlite unavailable at ${path} (${err.message}) ` + `→ falling back to in-memory (卡片仍可发，但重启后时间线丢失)`);
+    return new MemoryWecomCardStateStore;
+  }
+}
+
+// src/env/task/plugins/wecom-task-notify-plugin.ts
+var logger9 = createLogger("wecom:task-notify");
+var WecomNotifyType = {
+  TASK_CREATED: "task_created",
+  TASK_UPDATED: "task_updated",
+  TASK_COMPLETED: "task_completed",
+  OPERATION_CREATED: "operation_created"
+};
+var WECOM_EVENT_TYPE = "event-source.event.wecom-cli";
+var WECOM_CHANNEL_TYPE = "wecom-cli";
+function extractWecomFields(env, fallbackSourceId) {
+  const evt = env.envEvent;
+  const rcType = env.replyChannel?.type;
+  const isWecom = evt?.type === WECOM_EVENT_TYPE || rcType === WECOM_CHANNEL_TYPE;
+  if (!isWecom)
+    return { isWecom: false };
+  const chatId = env.replyChannel?.chatId || (typeof evt?.metadata?.chatId === "string" ? evt.metadata.chatId : undefined);
+  const sourceId = (typeof evt?.metadata?.sourceId === "string" ? evt.metadata.sourceId : undefined) ?? fallbackSourceId ?? undefined;
+  return { isWecom: true, chatId, sourceId };
+}
+function statusLabelOf(task, terminalStatus) {
+  const s = String(terminalStatus ?? task.status ?? "");
+  switch (s) {
+    case "todo":
+      return "\uD83D\uDCDD 待办";
+    case "active":
+      return "\uD83D\uDD04 进行中";
+    case "to_validate":
+      return "\uD83D\uDD0D 待验证";
+    case "completed":
+      return "\uD83C\uDF89 已完成";
+    case "paused":
+      return "⏸️ 已暂停";
+    case "cancelled":
+      return "\uD83D\uDEAB 已取消";
+    case "archived":
+      return "\uD83D\uDCE6 已归档";
+    case "failed":
+    case "timeout":
+      return "\uD83D\uDEA8 已失败";
+    default:
+      return "\uD83D\uDD04 进行中";
+  }
+}
+function isTerminalUpdate(task, changes) {
+  const effective = String(changes?.status ?? task.status ?? "");
+  return effective === "completed" || effective === "cancelled" || effective === "failed" || effective === "timeout" || effective === "archived" || effective === "paused";
+}
+function isHardTerminal(status) {
+  return status === "completed" || status === "cancelled" || status === "failed" || status === "timeout" || status === "archived";
+}
+function clip(text, max = 200) {
+  if (!text)
+    return "";
+  const t = text.trim();
+  return t.length > max ? `${t.slice(0, max)}…` : t;
+}
+function buildWecomTaskCard(input) {
+  const { task, statusLabel, milestones } = input;
+  const lines = [];
+  lines.push(`### \uD83D\uDCCB Task #${task.id} · ${task.title}`);
+  lines.push("");
+  const progress = typeof task.progress === "number" && task.progress > 0 ? `（${task.progress}%）` : "";
+  lines.push(`**状态**：${statusLabel}${progress}`);
+  if (input.terminal) {
+    lines.push(`---`);
+  }
+  lines.push("");
+  const desc = clip(task.description, 120);
+  if (desc) {
+    lines.push(`> ${desc}`);
+    lines.push("");
+  }
+  if (input.changeSummary) {
+    lines.push(`**本次更新**：${clip(input.changeSummary, 120)}`);
+    lines.push("");
+  }
+  if (milestones.length > 0) {
+    lines.push(`**时间线**`);
+    for (const m of milestones) {
+      const ts = formatTs(m.timestamp);
+      const d = m.description ? `：${clip(m.description, 100)}` : "";
+      lines.push(`- \uD83D\uDD50 ${ts} — ${m.title}${d}`);
+    }
+    lines.push("");
+  }
+  return lines.join(`
+`).trim();
+}
+function formatTs(iso) {
+  try {
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+      return iso;
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` + `${pad(d.getHours())}:${pad(d.getMinutes())}`;
+  } catch {
+    return iso;
+  }
+}
+function milestoneFromOperation(op) {
+  const raw = op;
+  const title = op.milestoneTitle ?? raw.action_title ?? String(op.milestoneType ?? "里程碑");
+  const detail = op.milestoneDescription ?? raw.action_description ?? undefined;
+  return {
+    title,
+    timestamp: op.timestamp ?? new Date().toISOString(),
+    description: detail ?? op.processDescription ?? undefined
+  };
+}
+
+class WecomTaskNotifyHook {
+  name;
+  priority;
+  description;
+  pluginName;
+  sourceId;
+  config;
+  sender;
+  cardStateStore;
+  lastNotifyTimestamps = new Map;
+  constructor(config = {}) {
+    this.name = config.pluginName || "WecomTaskNotifyHook";
+    this.priority = config.priority ?? 5;
+    this.description = "Wecom 任务进展通知 Hook（markdown 卡片）";
+    this.pluginName = config.pluginName;
+    this.sourceId = config.sourceId;
+    this.config = {
+      enabled: true,
+      priority: 5,
+      notifyTypes: [
+        WecomNotifyType.TASK_CREATED,
+        WecomNotifyType.TASK_UPDATED,
+        WecomNotifyType.TASK_COMPLETED,
+        WecomNotifyType.OPERATION_CREATED
+      ],
+      ...config
+    };
+    this.sender = config.sender ?? {
+      send: (input) => this.defaultSend(input)
+    };
+    this.cardStateStore = config.cardStateStore ?? createWecomCardStateStore();
+  }
+  async defaultSend(input) {
+    const env = getEnvContextOrEmpty();
+    const { sourceId } = extractWecomFields(env, this.sourceId);
+    return sendWecomReply({
+      sourceId: sourceId ?? "unknown",
+      rawChatId: input.chatId,
+      content: input.content
+    });
+  }
+  async execute(ctx) {
+    if (!this.config.enabled)
+      return;
+    const env = getEnvContextOrEmpty();
+    if (this.pluginName && this.sourceId) {
+      const key = `${this.sourceId}:${this.pluginName}`;
+      if (env.pluginEnabled && env.pluginEnabled[key] !== true) {
+        logger9.debug(`Plugin not enabled for source: ${key}`);
+        return;
+      }
+    }
+    const fields = extractWecomFields(env, this.sourceId);
+    if (!fields.isWecom) {
+      logger9.debug("not a wecom event, skip");
+      return;
+    }
+    switch (ctx.hookPoint) {
+      case TaskHookPoints.AFTER_CREATE:
+        await this.onAfterCreate(ctx);
+        break;
+      case TaskHookPoints.AFTER_UPDATE:
+        await this.onAfterUpdate(ctx);
+        break;
+      case TaskHookPoints.AFTER_COMPLETE:
+        await this.onAfterComplete(ctx);
+        break;
+      case TaskHookPoints.OPERATION_AFTER_CREATE:
+        await this.onAfterOperationCreate(ctx);
+        break;
+      case TaskHookPoints.AFTER_DELETE:
+        await this.onAfterDelete(ctx);
+        break;
+    }
+  }
+  async onAfterCreate(ctx) {
+    const { task } = ctx.data;
+    if (!task || !this.shouldNotify(WecomNotifyType.TASK_CREATED))
+      return;
+    await this.sendCardStart(task);
+  }
+  async onAfterUpdate(ctx) {
+    const data = ctx.data;
+    if (!data?.task)
+      return;
+    const { task, changes } = data;
+    const changeKeys = Object.keys(changes ?? {});
+    if (changeKeys.length === 0)
+      return;
+    if (isTerminalUpdate(task, changes)) {
+      if (!this.shouldNotify(WecomNotifyType.TASK_COMPLETED))
+        return;
+      await this.sendCardFinish(task, String(changes?.status ?? task.status));
+      return;
+    }
+    if (!this.shouldNotify(WecomNotifyType.TASK_UPDATED))
+      return;
+    await this.sendCardUpdate(task, changes);
+  }
+  async onAfterComplete(ctx) {
+    const data = ctx.data;
+    const task = data?.task ?? data;
+    if (!task || !this.shouldNotify(WecomNotifyType.TASK_COMPLETED))
+      return;
+    const terminalStatus = data.terminalStatus;
+    if (terminalStatus === "to_validate" || task.status === "to_validate") {
+      return;
+    }
+    await this.sendCardFinish(task, String(task.status));
+  }
+  async onAfterDelete(ctx) {
+    const data = ctx.data;
+    const taskId = data?.id;
+    if (data?.deleted !== true || typeof taskId !== "number")
+      return;
+    if (!this.shouldNotify(WecomNotifyType.TASK_COMPLETED))
+      return;
+    const rec = this.getRecord(taskId);
+    if (!rec) {
+      logger9.debug(`onAfterDelete: task #${taskId} 无卡片记录，skip`);
+      return;
+    }
+    const milestones = this.parseTimeline(rec.timeline);
+    milestones.push({
+      title: "任务已取消（删除）",
+      timestamp: new Date().toISOString()
+    });
+    await this.deliver({
+      chatId: rec.chatId,
+      task: {
+        id: taskId,
+        title: `(已删除)`,
+        description: "",
+        status: "cancelled",
+        progress: 0
+      },
+      statusLabel: statusLabelOf({ status: "cancelled" }),
+      milestones,
+      terminal: true
+    });
+    this.cardStateStore.markClosed(taskId);
+    logger9.debug(`onAfterDelete: task #${taskId} 卡片已收尾`);
+  }
+  async onAfterOperationCreate(ctx) {
+    const { operation } = ctx.data;
+    if (!operation)
+      return;
+    if (!this.shouldNotify(WecomNotifyType.OPERATION_CREATED))
+      return;
+    const rec = this.getRecord(operation.taskId);
+    if (!rec) {
+      logger9.debug(`onAfterOperationCreate: task #${operation.taskId} 无卡片记录，skip`);
+      return;
+    }
+    if (rec.status !== "open") {
+      logger9.debug(`onAfterOperationCreate: task #${operation.taskId} status=${rec.status}, skip`);
+      return;
+    }
+    const milestone = milestoneFromOperation(operation);
+    const milestones = this.parseTimeline(rec.timeline);
+    milestones.push(milestone);
+    const trimmed = this.trimTimeline(milestones);
+    this.persistTimeline(operation.taskId, rec, trimmed, rec.updateCount);
+    logger9.debug(`[single-card] OPERATION_CREATED for task ` + `#${operation.taskId} merged into timeline`);
+  }
+  async sendCardStart(task) {
+    const env = getEnvContextOrEmpty();
+    const fields = extractWecomFields(env, this.sourceId);
+    const chatId = fields.chatId;
+    if (!chatId) {
+      logger9.debug(`sendCardStart: no chatId for task #${task.id}, skip`);
+      return;
+    }
+    const existing = this.getRecord(task.id);
+    if (existing?.status === "open") {
+      logger9.debug(`sendCardStart: task #${task.id} 已有 open 记录 → 跳过重复发卡`);
+      return;
+    }
+    const milestones = [
+      {
+        title: "Task 创建",
+        timestamp: new Date().toISOString(),
+        description: task.current_status || undefined
+      }
+    ];
+    const ok = await this.deliver({
+      chatId,
+      task,
+      statusLabel: statusLabelOf(task),
+      milestones
+    });
+    if (ok) {
+      this.cardStateStore.upsert({
+        taskId: task.id,
+        chatId,
+        pinned: false,
+        status: "open",
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+        updateCount: 1,
+        timeline: JSON.stringify(milestones)
+      });
+    } else {
+      this.cardStateStore.upsert({
+        taskId: task.id,
+        chatId,
+        pinned: false,
+        status: "open",
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+        updateCount: 0,
+        timeline: JSON.stringify(milestones)
+      });
+      logger9.warn(`sendCardStart: task #${task.id} 首卡发送失败（已落库待重试）`);
+    }
+  }
+  async sendCardUpdate(task, changes) {
+    const rec = this.getRecord(task.id);
+    if (!rec) {
+      if (isHardTerminal(String(task.status))) {
+        logger9.debug(`sendCardUpdate: task #${task.id} 终态且无卡片 → skip`);
+        return;
+      }
+      logger9.debug(`sendCardUpdate: task #${task.id} 无卡片记录 → ` + `单卡语义不补发（进展落时间线）`);
+      return;
+    }
+    if (rec.status === "closed" && isHardTerminal(String(task.status))) {
+      logger9.debug(`sendCardUpdate: task #${task.id} closed + 终态 → skip`);
+      return;
+    }
+    const reopened = rec.status === "closed" && !isHardTerminal(String(task.status));
+    if (reopened) {
+      this.cardStateStore.markReopened(task.id);
+      logger9.debug(`sendCardUpdate: task #${task.id} reopen（复用记录）`);
+    }
+    const fresh = reopened ? this.getRecord(task.id) : rec;
+    const milestones = this.parseTimeline(fresh.timeline);
+    if (reopened) {
+      const last = milestones[milestones.length - 1];
+      if (last?.title !== REOPEN_TITLE) {
+        milestones.push({
+          title: REOPEN_TITLE,
+          timestamp: new Date().toISOString(),
+          description: task.current_status ? task.current_status.slice(0, 80) : undefined
+        });
+      }
+    }
+    this.persistTimeline(task.id, fresh, milestones, fresh.updateCount);
+    logger9.debug(`sendCardUpdate: task #${task.id} 单卡语义（不发新卡，` + `进展走时间线；点「刷新详情」可见）`);
+  }
+  async sendCardFinish(task, rawStatus) {
+    const rec = this.getRecord(task.id);
+    if (!rec) {
+      logger9.debug(`sendCardFinish: no card record for task #${task.id}, skip（不发新卡）`);
+      return;
+    }
+    if (rec.status === "closed" && rec.closedAt !== undefined && Date.now() - rec.closedAt < 60000) {
+      const milestones2 = this.parseTimeline(rec.timeline);
+      milestones2.push({
+        title: FINISH_TITLE[rawStatus] ?? "任务收尾",
+        timestamp: new Date().toISOString(),
+        description: task.current_status || undefined
+      });
+      this.persistTimeline(task.id, rec, milestones2, rec.updateCount);
+      logger9.debug(`sendCardFinish: task #${task.id} 已收尾（60s 内重复终态）→ ` + `合并不发新卡`);
+      return;
+    }
+    const milestones = this.parseTimeline(rec.timeline);
+    milestones.push({
+      title: FINISH_TITLE[rawStatus] ?? "任务收尾",
+      timestamp: new Date().toISOString(),
+      description: task.current_status || undefined
+    });
+    await this.deliver({
+      chatId: rec.chatId,
+      task,
+      statusLabel: statusLabelOf(task, rawStatus),
+      milestones,
+      terminal: true
+    });
+    this.persistTimeline(task.id, rec, milestones, rec.updateCount + 1);
+    if (rawStatus === "paused") {
+      this.cardStateStore.markPaused(task.id);
+    } else {
+      this.cardStateStore.markClosed(task.id);
+    }
+    logger9.debug(`sendCardFinish: task #${task.id} → status=${rawStatus}`);
+  }
+  async deliver(input) {
+    const content = buildWecomTaskCard({
+      task: input.task,
+      statusLabel: input.statusLabel,
+      milestones: input.milestones,
+      changeSummary: input.changeSummary,
+      terminal: input.terminal
+    });
+    const cardResult = await this.deliverTemplateCard(input);
+    if (cardResult)
+      return true;
+    try {
+      const r = await this.sender.send({
+        chatId: input.chatId,
+        content
+      });
+      if (!r.ok) {
+        logger9.warn(`deliver failed for task #${input.task.id}: ${r.error ?? "unknown"}`);
+        return false;
+      }
+      return true;
+    } catch (err) {
+      logger9.error(`deliver threw for task #${input.task.id}: ${err.message}`);
+      return false;
+    }
+  }
+  async deliverTemplateCard(input) {
+    try {
+      const env = getEnvContextOrEmpty();
+      const fields = extractWecomFields(env, this.sourceId);
+      const sourceId = fields.sourceId ?? "unknown";
+      const chatType = env.replyChannel?.params?.chatType === "group" || fields.chatId !== input.chatId ? "group" : "single";
+      const notice = buildWecomTextNoticeCard({
+        taskId: input.task.id,
+        title: input.task.title,
+        statusLabel: input.statusLabel,
+        progress: Number(input.task.progress ?? 0),
+        description: input.task.description,
+        changeSummary: input.changeSummary,
+        milestones: input.milestones,
+        terminal: input.terminal
+      });
+      const card = input.terminal ? notice : buildWecomButtonInteractionCard({
+        taskId: input.task.id,
+        title: input.task.title,
+        statusLabel: input.statusLabel,
+        progress: Number(input.task.progress ?? 0),
+        description: input.task.description,
+        changeSummary: input.changeSummary,
+        milestones: input.milestones,
+        buttons: [
+          { text: "刷新详情", key: WecomCardActionKey.VIEW, style: 1 }
+        ]
+      });
+      const r = await sendWecomTemplateCard({
+        sourceId,
+        chatId: input.chatId,
+        chatType,
+        card
+      });
+      if (!r.ok) {
+        logger9.warn(`deliverTemplateCard failed for task #${input.task.id}: ` + `${r.error ?? "unknown"}（回落 markdown）`);
+        return false;
+      }
+      return true;
+    } catch (err) {
+      logger9.warn(`deliverTemplateCard threw for task #${input.task.id}: ` + `${err.message}（回落 markdown）`);
+      return false;
+    }
+  }
+  getRecord(taskId) {
+    try {
+      return this.cardStateStore.get(taskId);
+    } catch (err) {
+      logger9.warn(`getRecord failed for task #${taskId}: ${err.message}`);
+      return;
+    }
+  }
+  parseTimeline(timeline) {
+    if (!timeline)
+      return [];
+    try {
+      const arr = JSON.parse(timeline);
+      return Array.isArray(arr) ? arr : [];
+    } catch {
+      return [];
+    }
+  }
+  trimTimeline(milestones) {
+    const max = this.config.maxTimelineEntries ?? 20;
+    if (milestones.length <= max)
+      return milestones;
+    return milestones.slice(milestones.length - max);
+  }
+  persistTimeline(taskId, rec, milestones, updateCount) {
+    try {
+      this.cardStateStore.upsert({
+        ...rec,
+        updatedAt: Date.now(),
+        updateCount,
+        timeline: JSON.stringify(milestones)
+      });
+    } catch (err) {
+      logger9.warn(`persistTimeline failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  hydrateTask(taskId, rec) {
+    return {
+      id: taskId,
+      title: `Task #${taskId}`,
+      description: "",
+      status: "active",
+      priority: "medium",
+      type: "normal",
+      progress: 0,
+      current_status: "",
+      goals_and_expected_deliverables: "",
+      createdAt: new Date(rec.createdAt).toISOString(),
+      updatedAt: new Date(rec.updatedAt).toISOString(),
+      project_path: "",
+      context: "{}"
+    };
+  }
+  shouldThrottleOperation(operation) {
+    const throttleMs = this.config.operationThrottleMs ?? 5000;
+    if (throttleMs <= 0)
+      return false;
+    const key = `op:${operation.taskId}`;
+    const now = Date.now();
+    const lastTime = this.lastNotifyTimestamps.get(key);
+    if (lastTime && now - lastTime < throttleMs) {
+      logger9.debug(`[throttle] skip OPERATION_CREATED send for task #${operation.taskId} ` + `(${now - lastTime}ms ago)`);
+      return true;
+    }
+    this.lastNotifyTimestamps.set(key, now);
+    return false;
+  }
+  shouldNotify(type) {
+    const { notifyTypes } = this.config;
+    if (!notifyTypes || notifyTypes.length === 0)
+      return true;
+    return notifyTypes.includes(type);
+  }
+}
+__legacyDecorateClassTS([
+  TracedExecute
+], WecomTaskNotifyHook.prototype, "execute", null);
+var FINISH_TITLE = {
+  completed: "\uD83C\uDF89 任务完成",
+  cancelled: "\uD83D\uDEAB 任务取消",
+  failed: "\uD83D\uDEA8 任务失败",
+  timeout: "\uD83D\uDEA8 任务超时",
+  archived: "\uD83D\uDCE6 任务归档",
+  paused: "⏸️ 任务暂停"
+};
+var REOPEN_TITLE = "\uD83D\uDD04 已重开";
+function createWecomTaskNotifyHook(config = {}) {
+  return new WecomTaskNotifyHook(config);
+}
+function TracedExecute(_target, _propertyKey, descriptor) {
+  const original = descriptor.value;
+  descriptor.value = async function(...args) {
+    try {
+      return await original.apply(this, args);
+    } catch (err) {
+      logger9.error(`wecom-task-notify execute threw: ${err.message}`);
+    }
+  };
+  return descriptor;
+}
 // src/env/task/plugins/per-task-group-chat-plugin.ts
 init_decorator();
 init_logger();
 init_context();
 import { spawn } from "child_process";
-var logger8 = createLogger("lark-cli:per-task-group");
+var logger10 = createLogger("lark-cli:per-task-group");
 function isPluginDebugEnabled() {
   return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
 }
@@ -2830,7 +3635,7 @@ class PerTaskGroupChatPlugin {
     const renderedName = this.renderTemplate(this.config.nameTemplate, task);
     const existingChatId = this.getTaskChatId(task);
     if (existingChatId) {
-      logger8.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 已有专属群 ${existingChatId} → 复用（不重复建群）`);
+      logger10.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 已有专属群 ${existingChatId} → 复用（不重复建群）`);
       return {
         chatId: existingChatId,
         profile: this.parseProfileFromContext(task.context),
@@ -2839,7 +3644,7 @@ class PerTaskGroupChatPlugin {
     }
     const inflight = this.groupChatInflight.get(task.id);
     if (inflight) {
-      logger8.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 建群已在进行中 → 复用同一 promise`);
+      logger10.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 建群已在进行中 → 复用同一 promise`);
       return inflight;
     }
     const pending = this.doEnsureGroupChat(task, renderedName, replyChannelOverride);
@@ -2853,7 +3658,7 @@ class PerTaskGroupChatPlugin {
   async doEnsureGroupChat(task, name, replyChannelOverride) {
     const replyChannel = replyChannelOverride ?? getEnvContextOrEmpty().replyChannel;
     if (!replyChannel?.chatId && this.config.requireReplyChannel) {
-      logger8.warn(`ensureGroupChat[${this.pluginName}]: no replyChannel.chatId for task #${task.id} ` + `(requireReplyChannel=true) → 无法建群`);
+      logger10.warn(`ensureGroupChat[${this.pluginName}]: no replyChannel.chatId for task #${task.id} ` + `(requireReplyChannel=true) → 无法建群`);
       return;
     }
     const description = this.renderTemplate(this.config.descriptionTemplate, task);
@@ -2871,30 +3676,30 @@ class PerTaskGroupChatPlugin {
       await this.writeChatBinding(task, chatId, profile, "creating");
       await this.attachChatIdToTask(task, chatId, profile);
       await this.writeChatBinding(task, chatId, profile, "ready");
-      logger8.info(`ensureGroupChat[${this.pluginName}]: created group ${chatId} for task #${task.id}`);
+      logger10.info(`ensureGroupChat[${this.pluginName}]: created group ${chatId} for task #${task.id}`);
       return { chatId, profile, name };
     } catch (error) {
-      logger8.error(`ensureGroupChat[${this.pluginName}]: failed for task #${task.id}: ${error}`);
+      logger10.error(`ensureGroupChat[${this.pluginName}]: failed for task #${task.id}: ${error}`);
       return;
     }
   }
   setTaskUpdater(updater) {
     this.taskUpdater = updater;
-    logger8.debug(`TaskUpdater injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+    logger10.debug(`TaskUpdater injected for plugin ${this.name} (sourceId=${this.sourceId})`);
   }
   hasTaskUpdater() {
     return this.taskUpdater !== undefined;
   }
   setTaskGetter(getter) {
     this.taskGetter = getter;
-    logger8.debug(`TaskGetter injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+    logger10.debug(`TaskGetter injected for plugin ${this.name} (sourceId=${this.sourceId})`);
   }
   hasTaskGetter() {
     return this.taskGetter !== undefined;
   }
   setSessionComponent(sessionComponent) {
     this.sessionComponent = sessionComponent;
-    logger8.debug(`SessionComponent injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+    logger10.debug(`SessionComponent injected for plugin ${this.name} (sourceId=${this.sourceId})`);
   }
   hasSessionComponent() {
     return this.sessionComponent !== undefined;
@@ -2907,7 +3712,7 @@ class PerTaskGroupChatPlugin {
       if (process.env.ROY_HOOK_DEBUG === "1") {
         console.error(`[DEBUG per-task-group-chat.execute] → SKIP (config.enabled=false)`);
       }
-      logger8.debug(`execute: plugin disabled (pluginName=${this.pluginName})`);
+      logger10.debug(`execute: plugin disabled (pluginName=${this.pluginName})`);
       return;
     }
     if (this.pluginName && this.sourceId) {
@@ -2920,13 +3725,13 @@ class PerTaskGroupChatPlugin {
         if (process.env.ROY_HOOK_DEBUG === "1") {
           console.error(`[DEBUG per-task-group-chat.execute] → SKIP (plugin NOT enabled for ${key})`);
         }
-        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`);
+        logger10.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)";
-      logger8.debug(`execute[${this.pluginName}]: ${enabledState} (key=${key}, ` + `hookPoint=${ctx.hookPoint}, taskUpdaterInjected=${this.hasTaskUpdater()})`);
+      logger10.debug(`execute[${this.pluginName}]: ${enabledState} (key=${key}, ` + `hookPoint=${ctx.hookPoint}, taskUpdaterInjected=${this.hasTaskUpdater()})`);
     } else {
-      logger8.debug(`execute[${this.pluginName}]: missing pluginName/sourceId metadata ` + `(pluginName=${this.pluginName}, sourceId=${this.sourceId}), ` + `skipping pluginEnabled check. hookPoint=${ctx.hookPoint}`);
+      logger10.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}`);
@@ -2945,13 +3750,13 @@ class PerTaskGroupChatPlugin {
         await this.onAfterComplete(ctx);
         break;
       default:
-        logger8.debug(`execute: unhandled hookPoint=${ctx.hookPoint}, skip`);
+        logger10.debug(`execute: unhandled hookPoint=${ctx.hookPoint}, skip`);
     }
   }
   async onAfterCreate(ctx) {
     const data = ctx.data;
     if (!data?.task) {
-      logger8.debug("onAfterCreate: task is missing, skip");
+      logger10.debug("onAfterCreate: task is missing, skip");
       return;
     }
     const { task } = data;
@@ -2962,38 +3767,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}`);
     }
-    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}`);
+    logger10.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) {
-      logger8.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} autoCreateGroup=false ` + `→ skip group chat creation（按需建群：用户在卡片顶部按钮触发）`);
+      logger10.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) {
-      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/无）`);
+      logger10.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) {
-      logger8.debug(`onAfterCreate[${this.pluginName}]: no replyChannel but requireReplyChannel=false, ` + `proceeding with profile fallback (fallbackProfile="${this.config.fallbackProfile}")`);
+      logger10.debug(`onAfterCreate[${this.pluginName}]: no replyChannel but requireReplyChannel=false, ` + `proceeding with profile fallback (fallbackProfile="${this.config.fallbackProfile}")`);
     }
     if (this.isSubTask(task) && !this.config.disableSubTaskSkip) {
-      logger8.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task, ` + `skip group chat creation. 关闭方式：config.disableSubTaskSkip=true`);
+      logger10.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) {
-      logger8.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task but ` + `disableSubTaskSkip=true, proceeding to create group chat`);
+      logger10.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) {
-        logger8.error(`onAfterCreate[${this.pluginName}]: ensureGroupChat 未返回 chatId for task #${task.id}`);
+        logger10.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;
       }
-      logger8.info(`onAfterCreate[${this.pluginName}]: task #${task.id} → group ${created.chatId} ` + `(initial card owned by LarkCliTaskNotifyHook)`);
+      logger10.info(`onAfterCreate[${this.pluginName}]: task #${task.id} → group ${created.chatId} ` + `(initial card owned by LarkCliTaskNotifyHook)`);
     } catch (error) {
-      logger8.error(`onAfterCreate[${this.pluginName}]: group chat failed for task #${task.id}: ${error}`);
+      logger10.error(`onAfterCreate[${this.pluginName}]: group chat failed for task #${task.id}: ${error}`);
       if (!this.config.fallbackToMain)
         throw error;
     }
@@ -3001,7 +3806,7 @@ class PerTaskGroupChatPlugin {
   async writeChatBinding(task, chatId, profile, status, errorMessage) {
     if (!this.sessionComponent) {
       if (isPluginDebugEnabled()) {
-        logger8.debug(`writeChatBinding[${this.pluginName}]: no sessionComponent injected, ` + `skip chat-task binding for chat ${chatId} (status=${status})`);
+        logger10.debug(`writeChatBinding[${this.pluginName}]: no sessionComponent injected, ` + `skip chat-task binding for chat ${chatId} (status=${status})`);
       }
       return;
     }
@@ -3014,37 +3819,37 @@ class PerTaskGroupChatPlugin {
         errorMessage: errorMessage ?? null
       });
     } catch (bindErr) {
-      logger8.warn(`writeChatBinding[${this.pluginName}]: failed to write chat-task binding for ` + `chat ${chatId} / task #${task.id} (status=${status}): ${bindErr}. ` + `群消息 handler 将无法自动注入 parentTaskId。`);
+      logger10.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) {
-      logger8.debug("onAfterUpdate: task is missing, skip");
+      logger10.debug("onAfterUpdate: task is missing, skip");
       return;
     }
-    logger8.debug(`onAfterUpdate[${this.pluginName}]: task #${data.task.id} 卡片由 ` + `LarkCliTaskNotifyHook 负责（本插件不再 patch），skip`);
+    logger10.debug(`onAfterUpdate[${this.pluginName}]: task #${data.task.id} 卡片由 ` + `LarkCliTaskNotifyHook 负责（本插件不再 patch），skip`);
   }
   async onAfterOperationCreate(ctx) {
     const data = ctx.data;
     if (!data?.operation) {
-      logger8.debug("onAfterOperationCreate: operation is missing, skip");
+      logger10.debug("onAfterOperationCreate: operation is missing, skip");
       return;
     }
-    logger8.debug(`onAfterOperationCreate[${this.pluginName}]: operation #${data.operation.id} ` + `卡片由 LarkCliTaskNotifyHook 负责，skip`);
+    logger10.debug(`onAfterOperationCreate[${this.pluginName}]: operation #${data.operation.id} ` + `卡片由 LarkCliTaskNotifyHook 负责，skip`);
   }
   async onAfterComplete(ctx) {
     const data = ctx.data;
     if (!data?.task) {
-      logger8.debug("onAfterComplete: task is missing, skip");
+      logger10.debug("onAfterComplete: task is missing, skip");
       return;
     }
-    logger8.debug(`onAfterComplete[${this.pluginName}]: task #${data.task.id} 终态卡片由 ` + `LarkCliTaskNotifyHook 负责，skip`);
+    logger10.debug(`onAfterComplete[${this.pluginName}]: task #${data.task.id} 终态卡片由 ` + `LarkCliTaskNotifyHook 负责，skip`);
   }
   createGroupChat(opts) {
     const args = this.buildCreateGroupChatArgs(opts);
     if (isPluginDebugEnabled()) {
-      logger8.debug(`Creating group chat: lark-cli ${args.join(" ")}`);
+      logger10.debug(`Creating group chat: lark-cli ${args.join(" ")}`);
     }
     return new Promise((resolve, reject) => {
       const proc = spawn("lark-cli", args, {
@@ -3119,16 +3924,16 @@ class PerTaskGroupChatPlugin {
     parsed[CTX_FIELD_CHAT_TASK_ID] = task.id;
     const newContext = JSON.stringify(parsed);
     if (!this.taskUpdater) {
-      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。`);
+      logger10.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;
-      logger8.debug(`attachChatIdToTask[${this.pluginName}]: ✅ persisted chat_id ${chatId} ` + `to task #${task.id} context`);
+      logger10.debug(`attachChatIdToTask[${this.pluginName}]: ✅ persisted chat_id ${chatId} ` + `to task #${task.id} context`);
     } catch (error) {
-      logger8.error(`Failed to persist chat_id to task #${task.id}: ${error}`);
+      logger10.error(`Failed to persist chat_id to task #${task.id}: ${error}`);
       task.context = newContext;
     }
   }
@@ -3223,15 +4028,15 @@ class PerTaskGroupChatPlugin {
   }
   resolveBotAppIds(replyChannel) {
     if (this.config.botAppIds.length > 0) {
-      logger8.debug(`resolveBotAppIds[${this.pluginName}]: using config.botAppIds=${JSON.stringify(this.config.botAppIds)}`);
+      logger10.debug(`resolveBotAppIds[${this.pluginName}]: using config.botAppIds=${JSON.stringify(this.config.botAppIds)}`);
       return this.config.botAppIds;
     }
     const appId = replyChannel ? replyChannel.appId : undefined;
     if (appId) {
-      logger8.debug(`resolveBotAppIds[${this.pluginName}]: using replyChannel.appId=${appId} (auto-detected from event header.app_id)`);
+      logger10.debug(`resolveBotAppIds[${this.pluginName}]: using replyChannel.appId=${appId} (auto-detected from event header.app_id)`);
       return [appId];
     }
-    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。`);
+    logger10.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) {
@@ -3241,7 +4046,7 @@ class PerTaskGroupChatPlugin {
         if (id && id !== "sender" && id.startsWith("ou_")) {
           ids.add(id);
         } else if (id && id !== "sender") {
-          logger8.debug(`resolveUserIds[${this.pluginName}]: skip non-open_id in defaultInviteUserIds: "${id}"`);
+          logger10.debug(`resolveUserIds[${this.pluginName}]: skip non-open_id in defaultInviteUserIds: "${id}"`);
         }
       }
     }
@@ -3264,7 +4069,7 @@ class PerTaskGroupChatPlugin {
       }
     }
     if (isPluginDebugEnabled()) {
-      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))}`);
+      logger10.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);
   }
@@ -3417,4 +4222,4 @@ __legacyDecorateClassTS([
 function createPerTaskGroupChatPlugin(config = {}) {
   return new PerTaskGroupChatPlugin(config);
 }
-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 };
+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, MemoryWecomCardStateStore, createMemoryWecomCardStore, SqliteWecomCardStateStore, getDefaultWecomCardDbPath, createWecomCardStateStore, WecomNotifyType, extractWecomFields, buildWecomTaskCard, WecomTaskNotifyHook, createWecomTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };