@ai-setting/roy-agent-core 1.7.56 → 1.7.58

package/dist/shared/@ai-setting/{roy-agent-core-ezsyyjxw.js → roy-agent-core-8bngppw0.js}

@@ -1,6 +1,10 @@
+import {
+  createCompatibleDatabase,
+  init_sqlite_task_store
+} from "./roy-agent-core-fbjd7bt6.js";
 import {
   getSharedEventStore
-} from "./roy-agent-core-zmeka63k.js";
+} from "./roy-agent-core-2ctyjy62.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";
@@ -10,31 +14,31 @@ import {
 import {
   LarkCardPatchNotifier,
   humanizeValue
-} from "./roy-agent-core-nntphgww.js";
+} from "./roy-agent-core-c36335nw.js";
 import {
   validateWorkflowDefinition
-} from "./roy-agent-core-202v00x4.js";
+} from "./roy-agent-core-89sxsrc7.js";
 import {
   enqueueToAddFakeUserMessage
-} from "./roy-agent-core-wafk25ff.js";
+} from "./roy-agent-core-gksw1gjb.js";
 import {
   BasePlugin
 } from "./roy-agent-core-az13yzmc.js";
 import {
   init_context
-} from "./roy-agent-core-16t0zfbk.js";
+} from "./roy-agent-core-m97jn2ra.js";
 import {
   getEnvContextOrEmpty
-} from "./roy-agent-core-jszgaevt.js";
+} from "./roy-agent-core-syyw58p9.js";
 import {
   TracedAs,
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-b599jgyd.js";
+} from "./roy-agent-core-8p63s836.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-8seq65bp.js";
+} from "./roy-agent-core-rt115qfc.js";
 import {
   __legacyDecorateClassTS,
   __require
@@ -299,11 +303,11 @@ ${prompt}`;
     }
     if (!this._workflowRepo) {
       try {
-        const sqlite = await import("./roy-agent-core-8cgtwytv.js");
+        const sqlite = await import("./roy-agent-core-4096f575.js");
         this.ensureDataDir();
         const db = sqlite.getDatabase();
         sqlite.initializeTables();
-        const { WorkflowRepository } = await import("./roy-agent-core-d14h726p.js");
+        const { WorkflowRepository } = await import("./roy-agent-core-jjhw9am6.js");
         this._workflowRepo = new WorkflowRepository(db);
         return this._workflowRepo;
       } catch {
@@ -377,6 +381,179 @@ init_decorator();
 init_logger();
 init_context();
 
+// src/env/task/plugins/lark-card-state-store.ts
+init_logger();
+init_sqlite_task_store();
+import { join } from "path";
+var logger3 = createLogger("lark-cli:card-state");
+
+class MemoryLarkCardStateStore {
+  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 }));
+  }
+  markPinned(taskId, pinned) {
+    const r = this.records.get(taskId);
+    if (!r)
+      return;
+    r.pinned = pinned;
+    r.updatedAt = Date.now();
+  }
+  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 rowToState(row) {
+  const state = {
+    taskId: row.task_id,
+    messageId: row.message_id,
+    chatId: row.chat_id,
+    pinned: row.pinned === 1,
+    status: row.status ?? "open",
+    createdAt: row.created_at,
+    updatedAt: row.updated_at
+  };
+  if (row.profile)
+    state.profile = row.profile;
+  if (row.closed_at !== null && row.closed_at !== undefined) {
+    state.closedAt = row.closed_at;
+  }
+  if (row.timeline)
+    state.timeline = row.timeline;
+  return state;
+}
+
+class SqliteLarkCardStateStore {
+  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 lark_card (
+        task_id INTEGER PRIMARY KEY,
+        message_id TEXT NOT NULL,
+        chat_id TEXT NOT NULL,
+        profile TEXT,
+        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,
+        timeline TEXT
+      )
+    `);
+    try {
+      this.db.run("ALTER TABLE lark_card ADD COLUMN timeline TEXT");
+    } catch {}
+    this.db.run("CREATE INDEX IF NOT EXISTS idx_lark_card_status ON lark_card(status)");
+  }
+  upsert(state) {
+    this.db.prepare(`INSERT INTO lark_card
+          (task_id, message_id, chat_id, profile, pinned, status, created_at, updated_at, closed_at, timeline)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(task_id) DO UPDATE SET
+           message_id = excluded.message_id,
+           chat_id    = excluded.chat_id,
+           profile    = excluded.profile,
+           pinned     = excluded.pinned,
+           status     = excluded.status,
+           updated_at = excluded.updated_at,
+           closed_at  = excluded.closed_at,
+           timeline   = excluded.timeline`).run(state.taskId, state.messageId, state.chatId, state.profile ?? null, state.pinned ? 1 : 0, state.status, state.createdAt, state.updatedAt, state.closedAt ?? null, state.timeline ?? null);
+  }
+  get(taskId) {
+    const row = this.db.prepare("SELECT * FROM lark_card WHERE task_id = ?").get(taskId);
+    return row ? rowToState(row) : undefined;
+  }
+  list() {
+    const rows = this.db.prepare("SELECT * FROM lark_card ORDER BY task_id ASC").all();
+    return rows.map(rowToState);
+  }
+  markPinned(taskId, pinned) {
+    this.db.prepare("UPDATE lark_card SET pinned = ?, updated_at = ? WHERE task_id = ?").run(pinned ? 1 : 0, Date.now(), taskId);
+  }
+  markPaused(taskId) {
+    this.db.prepare("UPDATE lark_card SET status = 'paused', updated_at = ? WHERE task_id = ?").run(Date.now(), taskId);
+  }
+  markReopened(taskId) {
+    this.db.prepare("UPDATE lark_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 lark_card SET status = 'closed', closed_at = ?, updated_at = ? WHERE task_id = ?").run(now, now, taskId);
+  }
+  delete(taskId) {
+    this.db.prepare("DELETE FROM lark_card WHERE task_id = ?").run(taskId);
+  }
+  close() {
+    try {
+      this.db.close?.();
+    } catch {}
+  }
+}
+function getDefaultLarkCardDbPath() {
+  const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+  return join(home, ".local", "share", "roy-agent", "lark-cards.db");
+}
+function createLarkCardStateStore(dbPath) {
+  const isTestEnv = "BUN_TEST_WORKER_ID" in process.env;
+  if (!dbPath && !process.env.ROY_AGENT_LARK_CARD_DB && isTestEnv) {
+    return new MemoryLarkCardStateStore;
+  }
+  const path = dbPath ?? process.env.ROY_AGENT_LARK_CARD_DB ?? getDefaultLarkCardDbPath();
+  try {
+    return new SqliteLarkCardStateStore(path);
+  } catch (err) {
+    logger3.warn(`LarkCardStateStore: sqlite unavailable at ${path} (${err.message}) ` + `→ falling back to in-memory (卡片仍可发，但重启后无法 patch 旧卡)`);
+    return new MemoryLarkCardStateStore;
+  }
+}
+
 // src/env/task/plugins/card-chat-routing.ts
 var CTX_FIELD_LARK_PER_TASK_CHAT_ID = "larkPerTaskChatId";
 function extractPerTaskChatId(contextStr) {
@@ -454,7 +631,7 @@ function decideCardChatTarget(input) {
 }
 
 // src/env/task/plugins/lark-cli-task-notify-plugin.ts
-var logger3 = createLogger("lark-cli:task-notify");
+var logger4 = createLogger("lark-cli:task-notify");
 var CTX_FIELD_CHAT_ID = "larkPerTaskChatId";
 var CTX_FIELD_CHAT_PROFILE = "larkPerTaskChatProfile";
 function parseLarkPerTaskChatId(ctxStr) {
@@ -479,6 +656,23 @@ function parseLarkPerTaskChatProfile(ctxStr) {
     return;
   }
 }
+function isTerminalTaskStatus(status) {
+  return status === "completed" || status === "cancelled" || status === "failed" || status === "timeout" || status === "archived";
+}
+function mapTaskStatusToCardStatus(taskStatus) {
+  switch (taskStatus) {
+    case "cancelled":
+      return "cancelled";
+    case "paused":
+    case "archived":
+      return "stopped";
+    case "failed":
+    case "timeout":
+      return "failed";
+    default:
+      return "completed";
+  }
+}
 var NotifyType;
 ((NotifyType2) => {
   NotifyType2["TASK_CREATED"] = "task_created";
@@ -497,6 +691,8 @@ class LarkCliTaskNotifyHook {
   config;
   cardNotifier;
   cardMessageIds = new Map;
+  cardStateStore;
+  restoredTaskIds = new Set;
   lastNotifyTimestamps = new Map;
   cardRoutingPorts;
   static CARD_START_FAILED_SENTINEL = "__card_start_failed__";
@@ -520,11 +716,12 @@ class LarkCliTaskNotifyHook {
     };
     if (this.config.cardMode !== false) {
       this.cardNotifier = config.cardNotifier ?? new LarkCardPatchNotifier;
+      this.cardStateStore = config.cardStateStore ?? createLarkCardStateStore();
     }
   }
   setCardRoutingPorts(ports) {
     this.cardRoutingPorts = ports;
-    logger3.debug(`CardRoutingPorts injected: getTask=${typeof ports.getTask}`);
+    logger4.debug(`CardRoutingPorts injected: getTask=${typeof ports.getTask}`);
   }
   hasCardRoutingPorts() {
     return this.cardRoutingPorts !== undefined;
@@ -537,7 +734,7 @@ class LarkCliTaskNotifyHook {
     if (this.pluginName && this.sourceId) {
       const key = `${this.sourceId}:${this.pluginName}`;
       if (env.pluginEnabled && env.pluginEnabled[key] !== true) {
-        logger3.debug(`Plugin not enabled for source: ${key}`);
+        logger4.debug(`Plugin not enabled for source: ${key}`);
         return;
       }
     }
@@ -554,6 +751,9 @@ class LarkCliTaskNotifyHook {
       case TaskHookPoints.OPERATION_AFTER_CREATE:
         await this.onAfterOperationCreate(ctx);
         break;
+      case TaskHookPoints.AFTER_DELETE:
+        await this.onAfterDelete(ctx);
+        break;
     }
   }
   async onAfterCreate(ctx) {
@@ -569,13 +769,19 @@ class LarkCliTaskNotifyHook {
     if (!data?.task)
       return;
     const { task, changes } = data;
+    const terminalCardStatus = this.cardStatusOf(task, changes);
+    if (terminalCardStatus) {
+      const notifyType2 = terminalCardStatus === "completed" || terminalCardStatus === "cancelled" ? "task_completed" /* TASK_COMPLETED */ : "task_updated" /* TASK_UPDATED */;
+      if (!this.shouldNotify(notifyType2))
+        return;
+      if (!this.isCardModeEnabled())
+        return;
+      await this.sendCardFinish(task);
+      return;
+    }
     let notifyType;
-    if (changes?.status === "completed" || changes?.progress === 100) {
-      notifyType = "task_completed" /* TASK_COMPLETED */;
-    } else if (changes?.status) {
+    if (changes?.status) {
       notifyType = "task_updated" /* TASK_UPDATED */;
-    } else if (task.status === "completed" || task.progress === 100) {
-      notifyType = "task_completed" /* TASK_COMPLETED */;
     } else if (changes && Object.keys(changes).length > 0) {
       notifyType = "task_updated" /* TASK_UPDATED */;
     } else {
@@ -585,11 +791,27 @@ class LarkCliTaskNotifyHook {
       return;
     if (!this.isCardModeEnabled())
       return;
-    if (notifyType === "task_completed" /* TASK_COMPLETED */ || task.status === "completed") {
-      await this.sendCardFinish(task);
-    } else {
-      await this.sendCardUpdate(task, changes);
+    await this.sendCardUpdate(task, changes);
+  }
+  cardStatusOf(task, changes) {
+    const changedStatus = changes?.status;
+    const effective = String(changedStatus ?? task.status ?? "");
+    switch (effective) {
+      case "completed":
+        return "completed";
+      case "cancelled":
+        return "cancelled";
+      case "paused":
+        return "stopped";
+      case "archived":
+        return "stopped";
+      case "failed":
+      case "timeout":
+        return "failed";
+      default:
+        break;
     }
+    return;
   }
   async onAfterComplete(ctx) {
     const data = ctx.data;
@@ -600,6 +822,52 @@ class LarkCliTaskNotifyHook {
       return;
     await this.sendCardFinish(task);
   }
+  async onAfterDelete(ctx) {
+    const data = ctx.data;
+    const taskId = data?.id;
+    if (data?.deleted !== true || typeof taskId !== "number")
+      return;
+    if (!this.shouldNotify("task_completed" /* TASK_COMPLETED */))
+      return;
+    if (!this.isCardModeEnabled())
+      return;
+    if (!this.cardNotifier)
+      return;
+    let record;
+    try {
+      record = this.cardStateStore?.get(taskId);
+    } catch (err) {
+      logger4.warn(`onAfterDelete: 读取卡片记录失败 task #${taskId}: ${err.message}`);
+    }
+    const messageId = record?.messageId || this.cardMessageIds.get(taskId);
+    if (!messageId) {
+      logger4.debug(`onAfterDelete: task #${taskId} 无卡片记录，skip（不发新卡）`);
+      return;
+    }
+    this.restoreCardState(taskId);
+    const profile = record?.profile;
+    const chatId = record?.chatId;
+    try {
+      await this.cardNotifier.finishTask({
+        messageId,
+        profile,
+        chatId,
+        status: "deleted",
+        finalStep: "任务已取消（删除）"
+      });
+    } catch (err) {
+      logger4.warn(`onAfterDelete: patch 卡片失败 task #${taskId} message=${messageId}: ${err.message}`);
+    }
+    try {
+      await this.cardNotifier.unpinMessage(messageId, profile);
+    } catch (err) {
+      logger4.warn(`onAfterDelete: unpin 失败 task #${taskId} message=${messageId}: ${err.message}`);
+    }
+    this.persistClosed(taskId);
+    this.persistPinned(taskId, false);
+    this.cardMessageIds.delete(taskId);
+    logger4.debug(`onAfterDelete: task #${taskId} 卡片已收尾 status=deleted message=${messageId}`);
+  }
   async onAfterOperationCreate(ctx) {
     const { operation } = ctx.data;
     if (!operation)
@@ -610,9 +878,14 @@ class LarkCliTaskNotifyHook {
       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) {
-      logger3.debug(`onAfterOperationCreate: no card for task #${operation.taskId}, skip`);
+    if (!messageId || messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL || messageId === LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
+      logger4.debug(`onAfterOperationCreate: no usable card for task #${operation.taskId}, skip`);
+      return;
+    }
+    if (persisted && persisted.status !== "open") {
+      logger4.debug(`onAfterOperationCreate: task #${operation.taskId} card status=${persisted.status}, skip`);
       return;
     }
     const { milestones, processSteps } = this.deriveTimelineFromOperation(operation);
@@ -629,12 +902,186 @@ class LarkCliTaskNotifyHook {
         processSteps
       });
     } catch (err) {
-      logger3.error(`sendCardOperation failed for task #${operation.taskId}: ${err.message}`);
+      logger4.error(`sendCardOperation failed for task #${operation.taskId}: ${err.message}`);
+    }
+  }
+  restoreCardState(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      const rec = this.cardStateStore.get(taskId);
+      if (!rec)
+        return;
+      if (!this.restoredTaskIds.has(taskId)) {
+        this.restoredTaskIds.add(taskId);
+        if (rec.status !== "closed" && rec.messageId) {
+          this.cardMessageIds.set(taskId, rec.messageId);
+          this.hydrateNotifierState(rec);
+          logger4.debug(`restoreCardState: task #${taskId} ← 持久层 message ${rec.messageId} ` + `(status=${rec.status}, pinned=${rec.pinned}, timeline=${rec.timeline ? "yes" : "no"})`);
+        }
+      }
+      return rec;
+    } catch (err) {
+      logger4.warn(`restoreCardState failed for task #${taskId}: ${err.message}`);
+      return;
+    }
+  }
+  hydrateNotifierState(rec) {
+    if (!this.cardNotifier || !rec.timeline)
+      return;
+    try {
+      const snapshot = JSON.parse(rec.timeline);
+      this.cardNotifier.hydrateState?.(rec.messageId, snapshot);
+    } catch (err) {
+      logger4.warn(`hydrateNotifierState failed for task #${rec.taskId}: ${err.message}`);
+    }
+  }
+  snapshotTimeline(state) {
+    if (!this.cardNotifier || !state.messageId)
+      return state;
+    try {
+      const snap = this.cardNotifier.exportState?.(state.messageId);
+      if (!snap)
+        return state;
+      return { ...state, timeline: JSON.stringify(snap) };
+    } catch (err) {
+      logger4.warn(`snapshotTimeline failed for task #${state.taskId}: ${err.message}`);
+      return state;
+    }
+  }
+  persistCardState(state, includeTimeline = false) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      const payload = includeTimeline ? this.snapshotTimeline(state) : state;
+      this.cardStateStore.upsert(payload);
+    } catch (err) {
+      logger4.warn(`persistCardState failed for task #${state.taskId}: ${err.message}`);
+    }
+  }
+  persistPinned(taskId, pinned) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      this.cardStateStore.markPinned(taskId, pinned);
+    } catch (err) {
+      logger4.warn(`persistPinned failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  persistPaused(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      this.cardStateStore.markPaused(taskId);
+    } catch (err) {
+      logger4.warn(`persistPaused failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  dropStaleMessageId(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      const existing = this.cardStateStore.get(taskId);
+      if (!existing)
+        return;
+      this.cardStateStore.upsert({
+        ...existing,
+        messageId: "",
+        pinned: false,
+        updatedAt: Date.now()
+      });
+    } catch (err) {
+      logger4.warn(`dropStaleMessageId failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  persistReopened(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      this.cardStateStore.markReopened(taskId);
+    } catch (err) {
+      logger4.warn(`persistReopened failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  persistClosed(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      this.cardStateStore.markClosed(taskId);
+    } catch (err) {
+      logger4.warn(`persistClosed failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  refreshTimeline(taskId) {
+    if (!this.cardStateStore || !this.cardNotifier)
+      return;
+    try {
+      const rec = this.cardStateStore.get(taskId);
+      if (!rec || !rec.messageId)
+        return;
+      this.cardStateStore.upsert(this.snapshotTimeline(rec));
+    } catch (err) {
+      logger4.warn(`refreshTimeline failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  async repinAfterResume(task, persisted) {
+    if (!this.cardNotifier || typeof this.cardNotifier.pinMessage !== "function") {
+      return;
+    }
+    if (!persisted.messageId)
+      return;
+    if (persisted.pinned)
+      return;
+    const ctx = getEnvContextOrEmpty();
+    const profile = this.resolveProfile(task, ctx);
+    try {
+      await this.cardNotifier.pinMessage(persisted.messageId, profile);
+      this.persistPinned(task.id, true);
+      logger4.debug(`repinAfterResume: task #${task.id} 卡片 ${persisted.messageId} 已重新置顶`);
+    } catch (err) {
+      logger4.warn(`repinAfterResume failed (non-fatal) for task #${task.id}: ${err.message}`);
+    }
+  }
+  buildCardState(task, messageId, chatId, profile, pinned) {
+    let existing;
+    try {
+      existing = this.cardStateStore?.get(task.id);
+    } catch (err) {
+      logger4.warn(`buildCardState: read existing failed for task #${task.id}: ${err.message}`);
+    }
+    const now = Date.now();
+    return {
+      taskId: task.id,
+      messageId,
+      chatId,
+      profile,
+      pinned,
+      status: "open",
+      createdAt: existing?.createdAt ?? now,
+      updatedAt: now
+    };
+  }
+  getCardState(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      return this.cardStateStore.get(taskId);
+    } catch {
+      return;
+    }
+  }
+  listCardStates() {
+    if (!this.cardStateStore)
+      return [];
+    try {
+      return this.cardStateStore.list();
+    } catch {
+      return [];
     }
   }
   isCardModeEnabled() {
     if (this.config.cardMode === false || !this.cardNotifier) {
-      logger3.debug("cardMode=false (legacy opt-out), skip task notification (no text fallback)");
+      logger4.debug("cardMode=false (legacy opt-out), skip task notification (no text fallback)");
       return false;
     }
     return true;
@@ -696,9 +1143,15 @@ class LarkCliTaskNotifyHook {
   async sendCardStart(task) {
     if (!this.cardNotifier)
       return;
+    const persisted = this.restoreCardState(task.id);
+    if (persisted?.status === "closed") {
+      this.cardMessageIds.delete(task.id);
+    } else if (persisted?.status === "paused") {
+      this.persistReopened(task.id);
+    }
     const claim = this.cardMessageIds.get(task.id);
     if (claim) {
-      logger3.debug(`sendCardStart: task #${task.id} 已有首卡（${claim}）→ 跳过重复发卡`);
+      logger4.debug(`sendCardStart: task #${task.id} 已有首卡（${claim}）→ 跳过重复发卡`);
       return;
     }
     this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL);
@@ -713,7 +1166,7 @@ class LarkCliTaskNotifyHook {
     const profile = target.profile;
     if (!chatId) {
       this.cardMessageIds.delete(task.id);
-      logger3.debug(`sendCardStart: no chatId for task #${task.id}, skip`);
+      logger4.debug(`sendCardStart: no chatId for task #${task.id}, skip`);
       return;
     }
     try {
@@ -730,29 +1183,55 @@ class LarkCliTaskNotifyHook {
         ]
       });
       this.cardMessageIds.set(task.id, messageId);
-      logger3.debug(`sendCardStart: task #${task.id} → message ${messageId} (pinned=${pinned}) ` + `chat=${chatId} source=${target.source} reason=${target.reason}`);
+      this.persistCardState(this.buildCardState(task, messageId, chatId, profile, pinned), true);
+      logger4.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);
-      logger3.error(`sendCardStart failed for task #${task.id}: ${err.message}`);
+      logger4.error(`sendCardStart failed for task #${task.id}: ${err.message}`);
     }
   }
   async sendCardUpdate(task, changes) {
     if (!this.cardNotifier)
       return;
+    const persisted = this.restoreCardState(task.id);
+    if (persisted?.status === "closed") {
+      const stillTerminal = isTerminalTaskStatus(String(task.status));
+      if (stillTerminal) {
+        logger4.debug(`sendCardUpdate: task #${task.id} 卡片已终结（closed）且任务仍终态 → skip patch`);
+        return;
+      }
+      logger4.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);
+      logger4.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))) {
+      logger4.debug(`sendCardUpdate: task #${task.id} 状态=${task.status}（终结/归档）且无卡片 → skip`);
+      return;
+    }
+    if (!messageId) {
+      this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL);
+    }
     const target = messageId ? undefined : await this.resolveCardTarget(task);
     const chatId = target?.chatId ?? this.resolveChatId(task, getEnvContextOrEmpty());
     const profile = target?.profile ?? this.resolveProfile(task, getEnvContextOrEmpty());
     if (!chatId) {
-      logger3.debug(`sendCardUpdate: no chatId for task #${task.id}, skip`);
+      if (!messageId)
+        this.cardMessageIds.delete(task.id);
+      logger4.debug(`sendCardUpdate: no chatId for task #${task.id}, skip`);
       return;
     }
     if (messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL) {
-      logger3.debug(`sendCardUpdate: startTask failed previously for task #${task.id}, skip`);
+      logger4.debug(`sendCardUpdate: startTask failed previously for task #${task.id}, skip`);
       return;
     }
     if (messageId === LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
-      logger3.debug(`sendCardUpdate: task #${task.id} 首卡正在发送中（in-flight）→ 跳过本次 update`);
+      logger4.debug(`sendCardUpdate: task #${task.id} 首卡正在发送中（in-flight）→ 跳过本次 update`);
       return;
     }
     if (!messageId) {
@@ -764,9 +1243,10 @@ class LarkCliTaskNotifyHook {
         });
         messageId = res.messageId;
         this.cardMessageIds.set(task.id, messageId);
+        this.persistCardState(this.buildCardState(task, messageId, chatId, profile, res.pinned), true);
       } catch (err) {
         this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL);
-        logger3.error(`sendCardUpdate fallback start failed: ${err.message}`);
+        logger4.error(`sendCardUpdate fallback start failed: ${err.message}`);
         return;
       }
     }
@@ -789,32 +1269,49 @@ class LarkCliTaskNotifyHook {
         milestones: [],
         processSteps
       });
+      const current = this.getCardState(task.id);
+      this.persistPinned(task.id, current?.pinned ?? persisted?.pinned ?? true);
+      this.refreshTimeline(task.id);
     } catch (err) {
-      logger3.error(`sendCardUpdate failed: ${err.message}`);
+      logger4.error(`sendCardUpdate failed: ${err.message}`);
     }
   }
   async sendCardFinish(task) {
     if (!this.cardNotifier)
       return;
+    this.restoreCardState(task.id);
     const messageId = this.cardMessageIds.get(task.id);
     const ctx = getEnvContextOrEmpty();
     const profile = this.resolveProfile(task, ctx);
     if (!messageId || messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL) {
-      logger3.debug(`sendCardFinish: no card messageId for task #${task.id}, skip`);
+      logger4.debug(`sendCardFinish: no card messageId for task #${task.id}, skip ` + `(记录缺失 → 不发新卡，保持幂等)`);
       return;
     }
-    const status = String(task.status) === "failed" || String(task.status) === "cancelled" || String(task.status) === "timeout" ? "failed" : "completed";
+    const rawStatus = String(task.status);
+    const status = mapTaskStatusToCardStatus(rawStatus);
+    const isPaused = rawStatus === "paused" || rawStatus === "archived";
     try {
-      await this.cardNotifier.finishTask({
+      const finish = isPaused ? this.cardNotifier.pauseTask.bind(this.cardNotifier) : this.cardNotifier.finishTask.bind(this.cardNotifier);
+      await finish({
         messageId,
         profile,
         status,
         meta: this.buildTaskMeta(task),
-        finalStep: task.current_status || undefined
+        finalStep: task.current_status || undefined,
+        ...rawStatus === "archived" ? { pausedMilestoneTitle: "Task 已归档" } : {}
       });
-      this.cardMessageIds.delete(task.id);
+      if (isPaused) {
+        this.persistPaused(task.id);
+        this.persistPinned(task.id, false);
+        this.refreshTimeline(task.id);
+      } else {
+        this.persistClosed(task.id);
+        this.persistPinned(task.id, false);
+        this.cardMessageIds.delete(task.id);
+      }
+      logger4.debug(`sendCardFinish: task #${task.id} → status=${status} ` + `(raw=${rawStatus}) message=${messageId}`);
     } catch (err) {
-      logger3.error(`sendCardFinish failed: ${err.message}`);
+      logger4.error(`sendCardFinish failed: ${err.message}`);
     }
   }
   resolveChatId(task, env) {
@@ -891,7 +1388,7 @@ class LarkCliTaskNotifyHook {
     const now = Date.now();
     const lastTime = this.lastNotifyTimestamps.get(key);
     if (lastTime && now - lastTime < throttleMs) {
-      logger3.debug(`[throttle] skip OPERATION_CREATED patch for task #${operation.taskId} (${now - lastTime}ms ago)`);
+      logger4.debug(`[throttle] skip OPERATION_CREATED patch for task #${operation.taskId} (${now - lastTime}ms ago)`);
       return true;
     }
     this.lastNotifyTimestamps.set(key, now);
@@ -934,7 +1431,7 @@ init_decorator();
 init_logger();
 init_context();
 import { spawn } from "child_process";
-var logger4 = createLogger("lark-cli:per-task-group");
+var logger5 = createLogger("lark-cli:per-task-group");
 function isPluginDebugEnabled() {
   return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
 }
@@ -989,7 +1486,7 @@ class PerTaskGroupChatPlugin {
     const renderedName = this.renderTemplate(this.config.nameTemplate, task);
     const existingChatId = this.getTaskChatId(task);
     if (existingChatId) {
-      logger4.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 已有专属群 ${existingChatId} → 复用（不重复建群）`);
+      logger5.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 已有专属群 ${existingChatId} → 复用（不重复建群）`);
       return {
         chatId: existingChatId,
         profile: this.parseProfileFromContext(task.context),
@@ -998,7 +1495,7 @@ class PerTaskGroupChatPlugin {
     }
     const inflight = this.groupChatInflight.get(task.id);
     if (inflight) {
-      logger4.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 建群已在进行中 → 复用同一 promise`);
+      logger5.debug(`ensureGroupChat[${this.pluginName}]: task #${task.id} 建群已在进行中 → 复用同一 promise`);
       return inflight;
     }
     const pending = this.doEnsureGroupChat(task, renderedName, replyChannelOverride);
@@ -1012,7 +1509,7 @@ class PerTaskGroupChatPlugin {
   async doEnsureGroupChat(task, name, replyChannelOverride) {
     const replyChannel = replyChannelOverride ?? getEnvContextOrEmpty().replyChannel;
     if (!replyChannel?.chatId && this.config.requireReplyChannel) {
-      logger4.warn(`ensureGroupChat[${this.pluginName}]: no replyChannel.chatId for task #${task.id} ` + `(requireReplyChannel=true) → 无法建群`);
+      logger5.warn(`ensureGroupChat[${this.pluginName}]: no replyChannel.chatId for task #${task.id} ` + `(requireReplyChannel=true) → 无法建群`);
       return;
     }
     const description = this.renderTemplate(this.config.descriptionTemplate, task);
@@ -1030,30 +1527,30 @@ class PerTaskGroupChatPlugin {
       await this.writeChatBinding(task, chatId, profile, "creating");
       await this.attachChatIdToTask(task, chatId, profile);
       await this.writeChatBinding(task, chatId, profile, "ready");
-      logger4.info(`ensureGroupChat[${this.pluginName}]: created group ${chatId} for task #${task.id}`);
+      logger5.info(`ensureGroupChat[${this.pluginName}]: created group ${chatId} for task #${task.id}`);
       return { chatId, profile, name };
     } catch (error) {
-      logger4.error(`ensureGroupChat[${this.pluginName}]: failed for task #${task.id}: ${error}`);
+      logger5.error(`ensureGroupChat[${this.pluginName}]: failed for task #${task.id}: ${error}`);
       return;
     }
   }
   setTaskUpdater(updater) {
     this.taskUpdater = updater;
-    logger4.debug(`TaskUpdater injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+    logger5.debug(`TaskUpdater injected for plugin ${this.name} (sourceId=${this.sourceId})`);
   }
   hasTaskUpdater() {
     return this.taskUpdater !== undefined;
   }
   setTaskGetter(getter) {
     this.taskGetter = getter;
-    logger4.debug(`TaskGetter injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+    logger5.debug(`TaskGetter injected for plugin ${this.name} (sourceId=${this.sourceId})`);
   }
   hasTaskGetter() {
     return this.taskGetter !== undefined;
   }
   setSessionComponent(sessionComponent) {
     this.sessionComponent = sessionComponent;
-    logger4.debug(`SessionComponent injected for plugin ${this.name} (sourceId=${this.sourceId})`);
+    logger5.debug(`SessionComponent injected for plugin ${this.name} (sourceId=${this.sourceId})`);
   }
   hasSessionComponent() {
     return this.sessionComponent !== undefined;
@@ -1066,7 +1563,7 @@ class PerTaskGroupChatPlugin {
       if (process.env.ROY_HOOK_DEBUG === "1") {
         console.error(`[DEBUG per-task-group-chat.execute] → SKIP (config.enabled=false)`);
       }
-      logger4.debug(`execute: plugin disabled (pluginName=${this.pluginName})`);
+      logger5.debug(`execute: plugin disabled (pluginName=${this.pluginName})`);
       return;
     }
     if (this.pluginName && this.sourceId) {
@@ -1079,13 +1576,13 @@ class PerTaskGroupChatPlugin {
         if (process.env.ROY_HOOK_DEBUG === "1") {
           console.error(`[DEBUG per-task-group-chat.execute] → SKIP (plugin NOT enabled for ${key})`);
         }
-        logger4.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`);
+        logger5.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)";
-      logger4.debug(`execute[${this.pluginName}]: ${enabledState} (key=${key}, ` + `hookPoint=${ctx.hookPoint}, taskUpdaterInjected=${this.hasTaskUpdater()})`);
+      logger5.debug(`execute[${this.pluginName}]: ${enabledState} (key=${key}, ` + `hookPoint=${ctx.hookPoint}, taskUpdaterInjected=${this.hasTaskUpdater()})`);
     } else {
-      logger4.debug(`execute[${this.pluginName}]: missing pluginName/sourceId metadata ` + `(pluginName=${this.pluginName}, sourceId=${this.sourceId}), ` + `skipping pluginEnabled check. hookPoint=${ctx.hookPoint}`);
+      logger5.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}`);
@@ -1104,13 +1601,13 @@ class PerTaskGroupChatPlugin {
         await this.onAfterComplete(ctx);
         break;
       default:
-        logger4.debug(`execute: unhandled hookPoint=${ctx.hookPoint}, skip`);
+        logger5.debug(`execute: unhandled hookPoint=${ctx.hookPoint}, skip`);
     }
   }
   async onAfterCreate(ctx) {
     const data = ctx.data;
     if (!data?.task) {
-      logger4.debug("onAfterCreate: task is missing, skip");
+      logger5.debug("onAfterCreate: task is missing, skip");
       return;
     }
     const { task } = data;
@@ -1121,38 +1618,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}`);
     }
-    logger4.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}`);
+    logger5.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) {
-      logger4.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} autoCreateGroup=false ` + `→ skip group chat creation（按需建群：用户在卡片顶部按钮触发）`);
+      logger5.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) {
-      logger4.debug(`onAfterCreate[${this.pluginName}]: no replyChannel.chatId for task #${task.id}, skip. ` + `修复：eventsource 收到 im.message.receive_v1 事件时 replyChannel 应有值；` + `或在 plugin config 设 requireReplyChannel=false 强制创建群聊（profile 降级到 fallbackProfile/无）`);
+      logger5.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) {
-      logger4.debug(`onAfterCreate[${this.pluginName}]: no replyChannel but requireReplyChannel=false, ` + `proceeding with profile fallback (fallbackProfile="${this.config.fallbackProfile}")`);
+      logger5.debug(`onAfterCreate[${this.pluginName}]: no replyChannel but requireReplyChannel=false, ` + `proceeding with profile fallback (fallbackProfile="${this.config.fallbackProfile}")`);
     }
     if (this.isSubTask(task) && !this.config.disableSubTaskSkip) {
-      logger4.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task, ` + `skip group chat creation. 关闭方式：config.disableSubTaskSkip=true`);
+      logger5.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) {
-      logger4.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} is sub-task but ` + `disableSubTaskSkip=true, proceeding to create group chat`);
+      logger5.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) {
-        logger4.error(`onAfterCreate[${this.pluginName}]: ensureGroupChat 未返回 chatId for task #${task.id}`);
+        logger5.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;
       }
-      logger4.info(`onAfterCreate[${this.pluginName}]: task #${task.id} → group ${created.chatId} ` + `(initial card owned by LarkCliTaskNotifyHook)`);
+      logger5.info(`onAfterCreate[${this.pluginName}]: task #${task.id} → group ${created.chatId} ` + `(initial card owned by LarkCliTaskNotifyHook)`);
     } catch (error) {
-      logger4.error(`onAfterCreate[${this.pluginName}]: group chat failed for task #${task.id}: ${error}`);
+      logger5.error(`onAfterCreate[${this.pluginName}]: group chat failed for task #${task.id}: ${error}`);
       if (!this.config.fallbackToMain)
         throw error;
     }
@@ -1160,7 +1657,7 @@ class PerTaskGroupChatPlugin {
   async writeChatBinding(task, chatId, profile, status, errorMessage) {
     if (!this.sessionComponent) {
       if (isPluginDebugEnabled()) {
-        logger4.debug(`writeChatBinding[${this.pluginName}]: no sessionComponent injected, ` + `skip chat-task binding for chat ${chatId} (status=${status})`);
+        logger5.debug(`writeChatBinding[${this.pluginName}]: no sessionComponent injected, ` + `skip chat-task binding for chat ${chatId} (status=${status})`);
       }
       return;
     }
@@ -1173,37 +1670,37 @@ class PerTaskGroupChatPlugin {
         errorMessage: errorMessage ?? null
       });
     } catch (bindErr) {
-      logger4.warn(`writeChatBinding[${this.pluginName}]: failed to write chat-task binding for ` + `chat ${chatId} / task #${task.id} (status=${status}): ${bindErr}. ` + `群消息 handler 将无法自动注入 parentTaskId。`);
+      logger5.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) {
-      logger4.debug("onAfterUpdate: task is missing, skip");
+      logger5.debug("onAfterUpdate: task is missing, skip");
       return;
     }
-    logger4.debug(`onAfterUpdate[${this.pluginName}]: task #${data.task.id} 卡片由 ` + `LarkCliTaskNotifyHook 负责（本插件不再 patch），skip`);
+    logger5.debug(`onAfterUpdate[${this.pluginName}]: task #${data.task.id} 卡片由 ` + `LarkCliTaskNotifyHook 负责（本插件不再 patch），skip`);
   }
   async onAfterOperationCreate(ctx) {
     const data = ctx.data;
     if (!data?.operation) {
-      logger4.debug("onAfterOperationCreate: operation is missing, skip");
+      logger5.debug("onAfterOperationCreate: operation is missing, skip");
       return;
     }
-    logger4.debug(`onAfterOperationCreate[${this.pluginName}]: operation #${data.operation.id} ` + `卡片由 LarkCliTaskNotifyHook 负责，skip`);
+    logger5.debug(`onAfterOperationCreate[${this.pluginName}]: operation #${data.operation.id} ` + `卡片由 LarkCliTaskNotifyHook 负责，skip`);
   }
   async onAfterComplete(ctx) {
     const data = ctx.data;
     if (!data?.task) {
-      logger4.debug("onAfterComplete: task is missing, skip");
+      logger5.debug("onAfterComplete: task is missing, skip");
       return;
     }
-    logger4.debug(`onAfterComplete[${this.pluginName}]: task #${data.task.id} 终态卡片由 ` + `LarkCliTaskNotifyHook 负责，skip`);
+    logger5.debug(`onAfterComplete[${this.pluginName}]: task #${data.task.id} 终态卡片由 ` + `LarkCliTaskNotifyHook 负责，skip`);
   }
   createGroupChat(opts) {
     const args = this.buildCreateGroupChatArgs(opts);
     if (isPluginDebugEnabled()) {
-      logger4.debug(`Creating group chat: lark-cli ${args.join(" ")}`);
+      logger5.debug(`Creating group chat: lark-cli ${args.join(" ")}`);
     }
     return new Promise((resolve, reject) => {
       const proc = spawn("lark-cli", args, {
@@ -1278,16 +1775,16 @@ class PerTaskGroupChatPlugin {
     parsed[CTX_FIELD_CHAT_TASK_ID] = task.id;
     const newContext = JSON.stringify(parsed);
     if (!this.taskUpdater) {
-      logger4.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。`);
+      logger5.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;
-      logger4.debug(`attachChatIdToTask[${this.pluginName}]: ✅ persisted chat_id ${chatId} ` + `to task #${task.id} context`);
+      logger5.debug(`attachChatIdToTask[${this.pluginName}]: ✅ persisted chat_id ${chatId} ` + `to task #${task.id} context`);
     } catch (error) {
-      logger4.error(`Failed to persist chat_id to task #${task.id}: ${error}`);
+      logger5.error(`Failed to persist chat_id to task #${task.id}: ${error}`);
       task.context = newContext;
     }
   }
@@ -1382,15 +1879,15 @@ class PerTaskGroupChatPlugin {
   }
   resolveBotAppIds(replyChannel) {
     if (this.config.botAppIds.length > 0) {
-      logger4.debug(`resolveBotAppIds[${this.pluginName}]: using config.botAppIds=${JSON.stringify(this.config.botAppIds)}`);
+      logger5.debug(`resolveBotAppIds[${this.pluginName}]: using config.botAppIds=${JSON.stringify(this.config.botAppIds)}`);
       return this.config.botAppIds;
     }
     const appId = replyChannel ? replyChannel.appId : undefined;
     if (appId) {
-      logger4.debug(`resolveBotAppIds[${this.pluginName}]: using replyChannel.appId=${appId} (auto-detected from event header.app_id)`);
+      logger5.debug(`resolveBotAppIds[${this.pluginName}]: using replyChannel.appId=${appId} (auto-detected from event header.app_id)`);
       return [appId];
     }
-    logger4.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。`);
+    logger5.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) {
@@ -1400,7 +1897,7 @@ class PerTaskGroupChatPlugin {
         if (id && id !== "sender" && id.startsWith("ou_")) {
           ids.add(id);
         } else if (id && id !== "sender") {
-          logger4.debug(`resolveUserIds[${this.pluginName}]: skip non-open_id in defaultInviteUserIds: "${id}"`);
+          logger5.debug(`resolveUserIds[${this.pluginName}]: skip non-open_id in defaultInviteUserIds: "${id}"`);
         }
       }
     }
@@ -1423,7 +1920,7 @@ class PerTaskGroupChatPlugin {
       }
     }
     if (isPluginDebugEnabled()) {
-      logger4.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))}`);
+      logger5.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);
   }