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

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

@@ -1,13 +1,18 @@
+import {
+  sendWecomReply,
+  sendWecomTemplateCard
+} from "./roy-agent-core-h1e1fm9b.js";
+import {
+  WecomCardActionKey,
+  buildWecomButtonInteractionCard,
+  buildWecomTextNoticeCard
+} from "./roy-agent-core-c4ec7k0p.js";
 import {
   getSharedEventStore
-} from "./roy-agent-core-na18zwj0.js";
+} from "./roy-agent-core-4t3yskp8.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-9vxh6f8h.js";
-import {
-  createCompatibleDatabase,
-  init_sqlite_task_store
-} from "./roy-agent-core-ezvpreqz.js";
+} from "./roy-agent-core-y7fqtzk2.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";
@@ -20,31 +25,43 @@ import {
   renderCandidateKey,
   renderCandidateValue,
   writeDecisionHint
-} from "./roy-agent-core-tr3ep81v.js";
+} from "./roy-agent-core-d6zdbgtc.js";
 import {
   LarkCardPatchNotifier,
+  buildSessionCard,
+  buildTaskCard,
+  createLarkCardStateStore,
+  getSharedLarkCardNotifier,
   humanizeValue
-} from "./roy-agent-core-w0qjeq2v.js";
+} from "./roy-agent-core-shb1qsyg.js";
+import {
+  RECENT_MESSAGE_LIMIT
+} from "./roy-agent-core-418zc9ha.js";
+import {
+  createCompatibleDatabase,
+  init_sqlite_task_store
+} from "./roy-agent-core-6k8mb7zx.js";
 import {
   validateWorkflowDefinition
-} from "./roy-agent-core-1v4g0d4x.js";
+} from "./roy-agent-core-rm7seqwb.js";
 import {
   enqueueToAddFakeUserMessage
-} from "./roy-agent-core-h21gngxf.js";
+} from "./roy-agent-core-7yh5wps0.js";
 import {
   BasePlugin
 } from "./roy-agent-core-az13yzmc.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
-  getEnvContextOrEmpty
-} from "./roy-agent-core-7cbpmk4q.js";
+  getEnvContextOrEmpty,
+  init_env_context
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   TracedAs,
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger
@@ -313,11 +330,11 @@ ${prompt}`;
     }
     if (!this._workflowRepo) {
       try {
-        const sqlite = await import("./roy-agent-core-dc9zq75z.js");
+        const sqlite = await import("./roy-agent-core-0crmsc12.js");
         this.ensureDataDir();
         const db = sqlite.getDatabase();
         sqlite.initializeTables();
-        const { WorkflowRepository } = await import("./roy-agent-core-xvt7kf7p.js");
+        const { WorkflowRepository } = await import("./roy-agent-core-w9ryeg2p.js");
         this._workflowRepo = new WorkflowRepository(db);
         return this._workflowRepo;
       } catch {
@@ -1676,178 +1693,10 @@ init_decorator();
 init_logger();
 init_context();
 
-// src/env/task/plugins/lark-card-state-store.ts
+// src/env/task/plugins/lark-card-action-handler.ts
 init_logger();
-init_sqlite_task_store();
-import { join } from "path";
-var logger6 = 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) {
-    logger6.warn(`LarkCardStateStore: sqlite unavailable at ${path} (${err.message}) ` + `→ falling back to in-memory (卡片仍可发，但重启后无法 patch 旧卡)`);
-    return new MemoryLarkCardStateStore;
-  }
-}
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
 
 // src/env/task/plugins/card-chat-routing.ts
 var CTX_FIELD_LARK_PER_TASK_CHAT_ID = "larkPerTaskChatId";
@@ -1925,804 +1774,2538 @@ function decideCardChatTarget(input) {
   };
 }
 
-// src/env/task/plugins/lark-cli-task-notify-plugin.ts
-var logger7 = createLogger("lark-cli:task-notify");
-var CTX_FIELD_CHAT_ID = "larkPerTaskChatId";
-var CTX_FIELD_CHAT_PROFILE = "larkPerTaskChatProfile";
-function parseLarkPerTaskChatId(ctxStr) {
-  if (!ctxStr)
-    return;
-  try {
-    const obj = JSON.parse(ctxStr);
-    const id = obj[CTX_FIELD_CHAT_ID];
-    return typeof id === "string" ? id : undefined;
-  } catch {
+// src/env/task/plugins/card-subject.ts
+function pickCardSubject(value) {
+  const rawSession = value?.sessionId;
+  const sessionId = typeof rawSession === "string" && rawSession.trim() ? rawSession : undefined;
+  if (!sessionId)
     return;
+  const rawTask = value?.taskId;
+  const taskId = typeof rawTask === "number" ? rawTask : typeof rawTask === "string" && rawTask.trim() ? Number(rawTask.trim()) : undefined;
+  return {
+    sessionId,
+    ...taskId !== undefined && Number.isSafeInteger(taskId) && taskId > 0 ? { taskId } : {}
+  };
+}
+
+// src/env/task/plugins/lark-card-action-handler.ts
+var logger6 = createLogger("lark-card-action-handler");
+var execAsync = promisify(exec);
+var KNOWN_CARD_ACTIONS = new Set([
+  "create_group",
+  "disband_group",
+  "refresh_activity"
+]);
+function isCardActionName(v) {
+  return typeof v === "string" && KNOWN_CARD_ACTIONS.has(v);
+}
+var ACTION_SUBJECT_FIELD = {
+  create_group: "taskId or sessionId",
+  disband_group: "taskId or sessionId",
+  refresh_activity: "sessionId"
+};
+function validateCardActionValue(raw) {
+  const action = raw.action;
+  if (!isCardActionName(action)) {
+    return { ok: false, action: String(action), error: `Unknown action: ${String(action)}` };
+  }
+  const requiredField = ACTION_SUBJECT_FIELD[action];
+  if (action === "create_group" || action === "disband_group") {
+    const rawTaskId = raw.taskId;
+    const rawSessionId2 = typeof raw.sessionId === "string" ? raw.sessionId.trim() : "";
+    if (rawTaskId === undefined || rawTaskId === null || rawTaskId === "") {
+      if (rawSessionId2) {
+        return { ok: true, action, sessionId: rawSessionId2 };
+      }
+      return {
+        ok: false,
+        action,
+        error: `Missing required field: ${requiredField} (action=${action})`
+      };
+    }
+    const taskId = typeof rawTaskId === "number" ? rawTaskId : typeof rawTaskId === "string" ? parseInt(rawTaskId, 10) : Number.NaN;
+    if (!Number.isFinite(taskId) || Number.isNaN(taskId) || taskId <= 0) {
+      return { ok: false, action, error: `Invalid taskId: ${String(rawTaskId)}` };
+    }
+    return {
+      ok: true,
+      action,
+      taskId,
+      ...rawSessionId2 ? { sessionId: rawSessionId2 } : {}
+    };
+  }
+  const rawSessionId = raw.sessionId;
+  const sessionId = typeof rawSessionId === "string" ? rawSessionId.trim() : "";
+  if (!sessionId) {
+    return {
+      ok: false,
+      action,
+      error: `Missing required field: ${requiredField} (action=${action})`
+    };
   }
+  return { ok: true, action, sessionId };
 }
-function parseLarkPerTaskChatProfile(ctxStr) {
-  if (!ctxStr)
+function extractTargetSessionId(context) {
+  if (!context)
     return;
   try {
-    const obj = JSON.parse(ctxStr);
-    const profile = obj[CTX_FIELD_CHAT_PROFILE];
-    return typeof profile === "string" ? profile : undefined;
+    const parsed = JSON.parse(context);
+    for (const key of ["subSessionId", "sessionId"]) {
+      const v = parsed[key];
+      if (typeof v === "string" && v.trim().length > 0)
+        return v.trim();
+    }
+    return;
   } catch {
     return;
   }
 }
-function isTerminalTaskStatus(status) {
-  return status === "completed" || status === "cancelled" || status === "failed" || status === "timeout" || status === "archived";
+async function resolveGroupLinkTargetSessionId(event, ports, taskId, taskContext) {
+  const fromCard = event.actionValue?.sessionId;
+  if (typeof fromCard === "string" && fromCard.trim().length > 0) {
+    return { sessionId: fromCard.trim(), source: "card" };
+  }
+  const fromContext = extractTargetSessionId(taskContext);
+  if (fromContext) {
+    return { sessionId: fromContext, source: "task.context" };
+  }
+  if (ports.resolveSessionIdByTask) {
+    try {
+      const resolved = await ports.resolveSessionIdByTask(taskId);
+      if (typeof resolved === "string" && resolved.trim().length > 0) {
+        return { sessionId: resolved.trim(), source: "resolveSessionIdByTask" };
+      }
+    } catch (err) {
+      logger6.warn(`resolveGroupLinkTargetSessionId: resolveSessionIdByTask(${taskId}) 失败（继续跳过 link）: ` + `${err.message}`);
+    }
+  }
+  return { sessionId: undefined, source: "none" };
 }
-function mapTaskStatusToCardStatus(taskStatus) {
-  switch (taskStatus) {
-    case "cancelled":
-      return "cancelled";
-    case "paused":
-    case "archived":
-      return "stopped";
-    case "failed":
-    case "timeout":
-      return "failed";
-    default:
-      return "completed";
+async function attachGroupSessionForTask(event, ports, taskId, chatId, taskContext) {
+  if (!ports.attachGroupSession)
+    return;
+  const { sessionId: targetSessionId, source } = await resolveGroupLinkTargetSessionId(event, ports, taskId, taskContext);
+  if (!targetSessionId) {
+    logger6.warn(`attachGroupSessionForTask: 取不到目标 session（card/context/resolveSessionIdByTask 全空），` + `跳过关联 —— 群 ${chatId} 将是独立空会话（无背景提示）`);
+    return;
+  }
+  try {
+    await ports.attachGroupSession({
+      chatId,
+      originSessionId: targetSessionId,
+      title: `Lark Chat ${chatId}`
+    });
+    logger6.info(`attachGroupSessionForTask: ${chatId} ← ${targetSessionId}` + `（来源=${source}，已注入 1 条 user 事件作为背景提示）`);
+  } catch (err) {
+    logger6.warn(`attachGroupSessionForTask: attach(${chatId} ← ${targetSessionId}) 失败（不阻断建群）: ` + `${err.message}`);
   }
 }
-var NotifyType;
-((NotifyType2) => {
-  NotifyType2["TASK_CREATED"] = "task_created";
-  NotifyType2["TASK_COMPLETED"] = "task_completed";
-  NotifyType2["TASK_UPDATED"] = "task_updated";
-  NotifyType2["TASK_FAILED"] = "task_failed";
-  NotifyType2["OPERATION_CREATED"] = "operation_created";
-})(NotifyType ||= {});
-
-class LarkCliTaskNotifyHook {
-  name;
-  priority;
-  description;
-  pluginName;
-  sourceId;
-  config;
-  cardNotifier;
-  cardMessageIds = new Map;
-  cardStateStore;
-  restoredTaskIds = new Set;
-  lastNotifyTimestamps = new Map;
-  trailingPatchTimers = new Map;
-  cardRoutingPorts;
-  static CARD_START_FAILED_SENTINEL = "__card_start_failed__";
-  static CARD_START_INFLIGHT_SENTINEL = "__card_start_inflight__";
-  constructor(config = {}) {
-    this.name = config.pluginName || "LarkCliTaskNotifyHook";
-    this.priority = config.priority ?? 5;
-    this.description = "LarkCli 任务通知 Hook（卡片模式）";
-    this.pluginName = config.pluginName;
-    this.sourceId = config.sourceId;
-    this.config = {
-      enabled: true,
-      priority: 5,
-      notifyTypes: [
-        "task_created" /* TASK_CREATED */,
-        "task_updated" /* TASK_UPDATED */,
-        "task_completed" /* TASK_COMPLETED */,
-        "operation_created" /* OPERATION_CREATED */
-      ],
-      ...config
+var CTX_FIELD_CHAT_ID = "larkPerTaskChatId";
+var CTX_FIELD_CHAT_NAME = "larkPerTaskChatName";
+var CTX_FIELD_CHAT_CREATED_AT = "larkPerTaskChatCreatedAt";
+var CTX_FIELD_CHAT_TASK_ID = "larkPerTaskChatTaskId";
+var CTX_FIELD_CHAT_INVITEES = "larkPerTaskChatInvitees";
+var cardActionInflight = new Map;
+async function handleCardAction(event, ports) {
+  const rawAction = event.actionValue.action;
+  if (!isCardActionName(rawAction)) {
+    return { ok: false, action: String(rawAction), error: `Unknown action: ${String(rawAction)}` };
+  }
+  if (rawAction === "refresh_activity") {
+    return await handleRefreshSessionCard(event, ports);
+  }
+  const validation = validateCardActionValue(event.actionValue);
+  if (!validation.ok) {
+    const failed = validation;
+    return { ok: false, action: rawAction, error: failed.error };
+  }
+  if (validation.action === "refresh_activity") {
+    return await handleRefreshSessionCard(event, ports);
+  }
+  const groupValidation = validation;
+  const action = groupValidation.action;
+  const taskId = groupValidation.taskId;
+  const subjectSessionId = groupValidation.sessionId;
+  const inflightSubject = event.messageId || (taskId !== undefined ? String(taskId) : subjectSessionId) || "-";
+  const inflightKey = `${event.profile ?? "-"}:${inflightSubject}:${action}`;
+  const inflight = cardActionInflight.get(inflightKey);
+  if (inflight) {
+    logger6.warn(`handleCardAction: ${inflightKey} 已有同操作在处理中（疑似用户重复点击），本次忽略。`);
+    return { ok: false, action, error: `重复点击：${inflightKey} 正在处理中，已忽略` };
+  }
+  const pending = taskId !== undefined ? handleCardActionInner(event, ports, action, taskId) : handleGroupActionSessionOnly(event, ports, action, subjectSessionId);
+  cardActionInflight.set(inflightKey, pending);
+  try {
+    return await pending;
+  } finally {
+    cardActionInflight.delete(inflightKey);
+  }
+}
+async function handleRefreshSessionCard(event, ports) {
+  const action = "refresh_activity";
+  let subject = pickCardSubject(event.actionValue);
+  if (!subject) {
+    const legacyTaskId = parseTaskIdLoose(event.actionValue.taskId);
+    if (legacyTaskId !== undefined) {
+      let resolved;
+      try {
+        resolved = await ports.resolveSessionIdByTask?.(legacyTaskId);
+      } catch {
+        resolved = undefined;
+      }
+      if (resolved) {
+        subject = { sessionId: resolved, taskId: legacyTaskId };
+        logger6.info(`handleCardAction: 旧 task 卡 #${legacyTaskId} 无 sessionId，` + `反查得到 ${resolved}（按 session 主键刷新）`);
+      }
+    }
+  }
+  if (!subject) {
+    return {
+      ok: false,
+      action,
+      error: `Missing required field: sessionId (action=${action}; sessionId is required ` + `as the card primary key, got taskId=${String(event.actionValue.taskId)})`
     };
-    if (this.config.cardMode !== false) {
-      this.cardNotifier = config.cardNotifier ?? new LarkCardPatchNotifier;
-      this.cardStateStore = config.cardStateStore ?? createLarkCardStateStore();
+  }
+  const canRenderSessionCard = ports.loadSessionActivity !== undefined || typeof ports.notifier?.buildSessionCardWithActivity === "function";
+  if (!canRenderSessionCard && ports.loadSubSessionActivity && subject.taskId !== undefined) {
+    const legacyTask = await ports.getTask?.(subject.taskId);
+    if (legacyTask) {
+      logger6.info(`handleCardAction: 旧装配点（无 loadSessionActivity）—— task #${subject.taskId} ` + `刷新回落到 task 主键路径（保留 #5360 之前的可达性）`);
+      return await handleRefreshActivity(event, ports, legacyTask, subject.taskId);
     }
   }
-  setCardRoutingPorts(ports) {
-    this.cardRoutingPorts = ports;
-    logger7.debug(`CardRoutingPorts injected: getTask=${typeof ports.getTask}`);
-  }
-  hasCardRoutingPorts() {
-    return this.cardRoutingPorts !== undefined;
+  if (!canRenderSessionCard && !ports.refreshSessionCard) {
+    logger6.warn(`handleCardAction: refresh_activity 已通过 sessionId 校验（sessionId=${subject.sessionId}），` + `但既没有 ports.refreshSessionCard，也没有 loadSessionActivity / ` + `buildSessionCardWithActivity —— 无 session 卡渲染实现。`);
+    return {
+      ok: false,
+      action,
+      error: `refresh_activity not available: no session card renderer injected ` + `(sessionId=${subject.sessionId}; ports.refreshSessionCard / loadSessionActivity both missing)`
+    };
   }
-  async execute(ctx) {
-    if (!this.config.enabled) {
-      return;
+  if (ports.refreshSessionCard) {
+    const inflightKey = `${event.profile ?? "-"}:${event.messageId || subject.sessionId}:${action}`;
+    const inflight = cardActionInflight.get(inflightKey);
+    if (inflight) {
+      logger6.warn(`handleCardAction: ${inflightKey} 已有同操作在处理中（疑似用户重复点击），本次忽略。`);
+      return { ok: false, action, error: `重复点击：${inflightKey} 正在处理中，已忽略` };
     }
-    const env = getEnvContextOrEmpty();
-    if (this.pluginName && this.sourceId) {
-      const key = `${this.sourceId}:${this.pluginName}`;
-      if (env.pluginEnabled && env.pluginEnabled[key] !== true) {
-        logger7.debug(`Plugin not enabled for source: ${key}`);
-        return;
+    const pending = (async () => {
+      try {
+        const result = await ports.refreshSessionCard({
+          sessionId: subject.sessionId,
+          chatId: event.chatId,
+          messageId: event.messageId,
+          token: event.token,
+          profile: event.profile
+        });
+        if (result.error) {
+          return { ok: false, action, error: result.error };
+        }
+        return { ok: true, action, cardUpdate: result.cardUpdate };
+      } catch (err) {
+        logger6.error(`handleCardAction.refresh_activity failed: ${err.message}`);
+        return { ok: false, action, error: err.message };
       }
+    })();
+    cardActionInflight.set(inflightKey, pending);
+    try {
+      return await pending;
+    } finally {
+      cardActionInflight.delete(inflightKey);
     }
-    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;
+  }
+  return await handleRefreshSessionActivity(event, ports, subject);
+}
+async function handleGroupActionSessionOnly(event, ports, action, sessionId) {
+  const existing = await lookupSessionGroup(ports, sessionId);
+  if (action === "create_group") {
+    if (existing?.chatId) {
+      logger6.info(`handleGroupActionSessionOnly: 会话 ${sessionId} 已有群 ${existing.chatId}` + `（幂等命中，不重复建群）`);
+      return {
+        ok: true,
+        action,
+        newChatId: existing.chatId,
+        cardUpdate: buildCardAfterSessionGroupChange(event, ports, {
+          sessionId,
+          chatId: existing.chatId
+        })
+      };
+    }
+    if (!ports.createGroupChat) {
+      return { ok: false, action, error: "ports.createGroupChat not injected" };
+    }
+    try {
+      let title;
+      try {
+        const t = await ports.getSessionTitle?.(sessionId);
+        if (typeof t === "string" && t.trim())
+          title = t.trim();
+      } catch (err) {
+        logger6.warn(`handleGroupActionSessionOnly: getSessionTitle(${sessionId}) 失败（用 sessionId 兜底）: ` + `${err.message}`);
+      }
+      const renderedName = truncateText(`会话 ${title ?? sessionId}`, 60);
+      const description = truncateText(`roy-agent session ${sessionId}`, 100);
+      const operatorOpenId = extractOperatorOpenId(event.operatorId);
+      const initialUserIds = operatorOpenId ? [operatorOpenId] : undefined;
+      let initialBotIds;
+      try {
+        const botAppId = await resolveBotAppId(event.profile);
+        if (botAppId)
+          initialBotIds = [botAppId];
+      } catch (err) {
+        logger6.warn(`handleGroupActionSessionOnly: resolveBotAppId 失败` + `（bot 可能不在群里，发卡会 230002）: ${err.message}`);
+      }
+      const chatId = await ports.createGroupChat({
+        name: renderedName,
+        description,
+        profile: event.profile,
+        initialUserIds,
+        initialBotIds
+      });
+      if (operatorOpenId && !initialUserIds && ports.inviteUser) {
+        try {
+          await ports.inviteUser(chatId, operatorOpenId, event.profile);
+        } catch (err) {
+          logger6.warn(`handleGroupActionSessionOnly: inviteUser(${chatId}, ${operatorOpenId}) 失败` + `（不阻断主流程）: ${err.message}`);
+        }
+      }
+      await attachGroupSessionForSession(ports, chatId, sessionId, renderedName);
+      if (ports.notifier?.upsertSessionCard) {
+        try {
+          const cardRes = await ports.notifier.upsertSessionCard({
+            chatId,
+            sessionId: chatId,
+            title: renderedName,
+            lifecycle: "running",
+            perTaskChatId: chatId
+          });
+          logger6.info(`handleGroupActionSessionOnly: 新群卡已发 chatId=${chatId} ` + `messageId=${cardRes.messageId}（session_id=群 session，#5417）`);
+        } catch (err) {
+          logger6.warn(`handleGroupActionSessionOnly: 新群卡发送失败（不阻断建群）: ` + `${err.message}`);
+        }
+      }
+      return {
+        ok: true,
+        action,
+        newChatId: chatId,
+        cardUpdate: buildCardAfterSessionGroupChange(event, ports, {
+          sessionId,
+          chatId,
+          chatName: renderedName
+        })
+      };
+    } catch (err) {
+      logger6.error(`handleCardAction.create_group(session-only) failed: ${err.message}`);
+      return { ok: false, action, error: err.message };
     }
   }
-  async onAfterCreate(ctx) {
-    const { task } = ctx.data;
-    if (!task || !this.shouldNotify("task_created" /* TASK_CREATED */))
-      return;
-    if (!this.isCardModeEnabled())
-      return;
-    await this.sendCardStart(task);
+  if (!existing?.chatId) {
+    return {
+      ok: false,
+      action,
+      error: `会话 ${sessionId} 没有专属群，无需解散`
+    };
   }
-  async onAfterUpdate(ctx) {
-    const data = ctx.data;
-    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) {
-      notifyType = "task_updated" /* TASK_UPDATED */;
-    } else if (changes && Object.keys(changes).length > 0) {
-      notifyType = "task_updated" /* TASK_UPDATED */;
+  if (!ports.deleteGroupChat) {
+    return { ok: false, action, error: "ports.deleteGroupChat not injected" };
+  }
+  try {
+    await ports.deleteGroupChat(existing.chatId, event.profile);
+    if (!ports.detachGroupSession) {
+      logger6.warn(`handleGroupActionSessionOnly: detachGroupSession 端口未注入 ⇒ 群 ${existing.chatId} ` + `已解散但关联标记残留（反查仍会命中这个群）`);
     } else {
-      return;
+      const unlinkTarget = existing.aliasSessionId ?? existing.chatId;
+      try {
+        await ports.detachGroupSession(unlinkTarget);
+      } catch (err) {
+        logger6.warn(`handleGroupActionSessionOnly: detachGroupSession(${unlinkTarget}) 失败` + `（不阻断解散）: ${err.message}`);
+      }
     }
-    if (!this.shouldNotify(notifyType))
-      return;
-    if (!this.isCardModeEnabled())
-      return;
-    await this.sendCardUpdate(task, changes);
+    return {
+      ok: true,
+      action,
+      cardUpdate: buildCardAfterSessionGroupChange(event, ports, { sessionId })
+    };
+  } catch (err) {
+    logger6.error(`handleCardAction.disband_group(session-only) failed: ${err.message}`);
+    return { ok: false, action, error: err.message };
   }
-  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;
+}
+async function lookupSessionGroup(ports, sessionId) {
+  if (!ports.findGroupChatForSession)
+    return;
+  try {
+    const r = await ports.findGroupChatForSession(sessionId);
+    if (r && typeof r.chatId === "string" && r.chatId.trim()) {
+      return { chatId: r.chatId.trim(), ...r.aliasSessionId ? { aliasSessionId: r.aliasSessionId } : {} };
     }
     return;
+  } catch (err) {
+    logger6.warn(`lookupSessionGroup(${sessionId}) 失败（当作没有群）: ${err.message}`);
+    return;
   }
-  async onAfterComplete(ctx) {
-    const data = ctx.data;
-    const task = data?.task ?? data;
-    if (!task || !this.shouldNotify("task_completed" /* TASK_COMPLETED */))
-      return;
-    if (!this.isCardModeEnabled())
-      return;
-    const terminalStatus = data.terminalStatus;
-    if (terminalStatus === "to_validate" || task.status === "to_validate") {
-      return;
-    }
-    await this.sendCardFinish(task);
+}
+async function attachGroupSessionForSession(ports, chatId, sessionId, title) {
+  if (!ports.attachGroupSession) {
+    logger6.warn(`attachGroupSessionForSession: 端口未注入 ⇒ 群 ${chatId} 将没有背景提示事件` + `（连不到 ${sessionId} 的溯源信息）`);
+    return;
   }
-  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) {
-      logger7.warn(`onAfterDelete: 读取卡片记录失败 task #${taskId}: ${err.message}`);
-    }
-    const messageId = record?.messageId || this.cardMessageIds.get(taskId);
-    if (!messageId) {
-      logger7.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) {
-      logger7.warn(`onAfterDelete: patch 卡片失败 task #${taskId} message=${messageId}: ${err.message}`);
-    }
-    try {
-      await this.cardNotifier.unpinMessage(messageId, profile);
-    } catch (err) {
-      logger7.warn(`onAfterDelete: unpin 失败 task #${taskId} message=${messageId}: ${err.message}`);
-    }
-    this.cancelTrailingPatch(taskId);
-    this.persistClosed(taskId);
-    this.persistPinned(taskId, false);
-    this.cardMessageIds.delete(taskId);
-    logger7.debug(`onAfterDelete: task #${taskId} 卡片已收尾 status=deleted message=${messageId}`);
+  try {
+    await ports.attachGroupSession({
+      chatId,
+      originSessionId: sessionId,
+      ...title ? { title } : {}
+    });
+    logger6.info(`attachGroupSessionForSession: ${chatId} ← ${sessionId}` + `（已注入 1 条 user 事件作为背景提示）`);
+  } catch (err) {
+    logger6.warn(`attachGroupSessionForSession: attach(${chatId} ← ${sessionId}) 失败（不阻断建群）: ` + `${err.message}`);
   }
-  async onAfterOperationCreate(ctx) {
-    const { operation } = ctx.data;
-    if (!operation)
-      return;
-    if (!this.shouldNotify("operation_created" /* OPERATION_CREATED */))
-      return;
-    if (!this.isCardModeEnabled())
-      return;
-    const persisted = this.restoreCardState(operation.taskId);
-    const messageId = this.cardMessageIds.get(operation.taskId);
-    if (!messageId || messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL || messageId === LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
-      logger7.debug(`onAfterOperationCreate: no usable card for task #${operation.taskId}, skip`);
-      return;
-    }
-    if (persisted && persisted.status !== "open") {
-      logger7.debug(`onAfterOperationCreate: task #${operation.taskId} card status=${persisted.status}, skip`);
-      return;
+}
+function buildCardAfterSessionGroupChange(event, ports, opts) {
+  const preserved = ports.notifier?.applySessionGroupChange?.(event.messageId, {
+    sessionId: opts.sessionId,
+    ...opts.chatId ? { perTaskChatId: opts.chatId } : {},
+    ...opts.chatName ? { perTaskChatName: opts.chatName } : {}
+  });
+  if (preserved)
+    return preserved;
+  logger6.warn(`buildCardAfterSessionGroupChange: notifier 无 messageId=${event.messageId} 的状态，` + `fallback 重建 session 卡（历史里程碑可能丢失）`);
+  return buildSessionCard({
+    sessionId: opts.sessionId,
+    ...opts.chatId ? { perTaskChatId: opts.chatId } : {},
+    ...opts.chatName ? { perTaskChatName: opts.chatName } : {}
+  });
+}
+async function handleCardActionInner(event, ports, action, taskId) {
+  if (!ports.getTask) {
+    return { ok: false, action, error: "ports.getTask not injected" };
+  }
+  const task = await ports.getTask(taskId);
+  if (!task) {
+    return { ok: false, action, error: `Task #${taskId} not found` };
+  }
+  const existingChatId = extractPerTaskChatId(task.context);
+  switch (action) {
+    case "create_group":
+      return await handleCreateGroup(event, ports, task, existingChatId);
+    case "disband_group":
+      return await handleDisbandGroup(event, ports, task, existingChatId);
+  }
+}
+function buildCardAfterGroupChange(event, ports, task, perTaskChatId, perTaskChatName) {
+  const meta = buildTaskMetaFromTask(task, perTaskChatId, perTaskChatName);
+  const preserved = ports.notifier?.updateMetaAndBuildCard?.(event.messageId, meta, { clearPerTaskChat: !perTaskChatId });
+  if (preserved) {
+    logger6.debug(`buildCardAfterGroupChange: 复用 notifier 累积状态（里程碑历史保留）messageId=${event.messageId}`);
+    return preserved;
+  }
+  logger6.warn(`buildCardAfterGroupChange: notifier 无 messageId=${event.messageId} 的状态，` + `fallback 重建卡片（该卡片的历史里程碑可能丢失）`);
+  return buildTaskCard({
+    status: "running",
+    meta,
+    milestones: [
+      { title: "Task 创建", timestamp: new Date().toISOString(), description: task.current_status }
+    ]
+  });
+}
+async function handleCreateGroup(event, ports, task, existingChatId) {
+  if (existingChatId) {
+    const existingName = extractPerTaskChatName(task.context);
+    logger6.info(`handleCreateGroup: Task #${task.id} 已有专属群 ${existingChatId}（幂等命中，不重复建群）`);
+    await attachGroupSessionForTask(event, ports, task.id, existingChatId, task.context);
+    return {
+      ok: true,
+      action: "create_group",
+      newChatId: existingChatId,
+      cardUpdate: buildCardAfterGroupChange(event, ports, task, existingChatId, existingName)
+    };
+  }
+  if (!ports.createGroupChat) {
+    return { ok: false, action: "create_group", error: "ports.createGroupChat not injected" };
+  }
+  try {
+    const renderedName = truncateText(`Task #${task.id} - ${task.title ?? "(无标题)"}`, 60);
+    const description = truncateText(`roy-agent task #${task.id} - ${task.project_path ?? ""}`, 100);
+    const operatorOpenId = extractOperatorOpenId(event.operatorId);
+    const initialUserIds = operatorOpenId ? [operatorOpenId] : undefined;
+    const chatId = await ports.createGroupChat({
+      name: renderedName,
+      description,
+      profile: event.profile,
+      initialUserIds
+    });
+    let invitedOpenIds = [];
+    if (operatorOpenId) {
+      if (initialUserIds) {
+        invitedOpenIds = [operatorOpenId];
+        logger6.debug(`handleCreateGroup: ${operatorOpenId} 已在建群时邀请（initialUserIds 路径）`);
+      } else if (ports.inviteUser) {
+        try {
+          await ports.inviteUser(chatId, operatorOpenId, event.profile);
+          invitedOpenIds = [operatorOpenId];
+          logger6.debug(`handleCreateGroup: 走 inviteUser 端口邀请 ${operatorOpenId} 进 ${chatId}`);
+        } catch (err) {
+          logger6.warn(`handleCreateGroup: inviteUser(${chatId}, ${operatorOpenId}) 失败（不阻断主流程）: ${err.message}`);
+        }
+      } else {
+        logger6.warn(`handleCreateGroup: createGroupChat 不支持 initialUserIds 且 inviteUser 未注入，` + `${operatorOpenId} 未被拉进群 ${chatId}。` + `需升级 caller（bridge/real impl）使用 ports.inviteUser 或实现 createGroupChat.initialUserIds 参数。`);
+      }
     }
-    const { milestones, processSteps } = this.deriveTimelineFromOperation(operation);
-    if (milestones.length === 0 && processSteps.length === 0)
-      return;
-    const env = getEnvContextOrEmpty();
-    const profile = env.replyChannel?.profile;
-    this.cardNotifier.mergeTimelineState?.(messageId, milestones, processSteps);
-    this.refreshTimeline(operation.taskId);
-    const throttled = this.shouldThrottleOperation(operation);
-    if (throttled) {
-      this.scheduleTrailingPatch(operation.taskId, messageId, profile);
-      logger7.debug(`[throttle] OPERATION_CREATED for task #${operation.taskId} ` + `merged into state + ledger; card patch deferred to window end`);
-      return;
+    const newContext = patchContext(task.context ?? "{}", {
+      [CTX_FIELD_CHAT_ID]: chatId,
+      [CTX_FIELD_CHAT_NAME]: renderedName,
+      [CTX_FIELD_CHAT_CREATED_AT]: new Date().toISOString(),
+      [CTX_FIELD_CHAT_TASK_ID]: task.id,
+      [CTX_FIELD_CHAT_INVITEES]: invitedOpenIds.length > 0 ? invitedOpenIds : undefined
+    });
+    if (ports.updateTaskContext) {
+      await ports.updateTaskContext(task.id, newContext);
     }
-    await this.patchOperationTimeline(operation.taskId, messageId, profile, milestones, processSteps);
+    const cardUpdate = buildCardAfterGroupChange(event, ports, task, chatId, renderedName);
+    await attachGroupSessionForTask(event, ports, task.id, chatId, task.context);
+    return { ok: true, action: "create_group", newChatId: chatId, cardUpdate };
+  } catch (err) {
+    logger6.error(`handleCardAction.create_group failed: ${err.message}`);
+    return { ok: false, action: "create_group", error: err.message };
   }
-  async patchOperationTimeline(taskId, messageId, profile, milestones, processSteps) {
-    try {
-      await this.cardNotifier.updateTask({
-        messageId,
+}
+function extractOperatorOpenId(raw) {
+  if (!raw)
+    return;
+  if (typeof raw === "string")
+    return raw;
+  if (typeof raw === "object" && typeof raw.open_id === "string")
+    return raw.open_id;
+  return;
+}
+function parseTaskIdLoose(raw) {
+  if (typeof raw === "number") {
+    return Number.isSafeInteger(raw) && raw > 0 ? raw : undefined;
+  }
+  if (typeof raw === "string" && /^\d+$/.test(raw.trim())) {
+    const n = Number(raw.trim());
+    return Number.isSafeInteger(n) && n > 0 ? n : undefined;
+  }
+  return;
+}
+async function handleRefreshSessionActivity(event, ports, subject) {
+  const action = "refresh_activity";
+  const sessionId = subject.sessionId;
+  let probe;
+  try {
+    probe = await ports.loadSessionActivity?.(sessionId);
+  } catch (err) {
+    logger6.warn(`handleRefreshSessionActivity: loadSessionActivity failed for ${sessionId}: ` + `${err.message}（降级为「暂无数据」）`);
+    probe = undefined;
+  }
+  let taskEnrichment;
+  if (subject.taskId !== undefined) {
+    taskEnrichment = await loadTaskEnrichment(subject.taskId, ports);
+  }
+  let recentMessages;
+  try {
+    recentMessages = await ports.loadSessionMessages?.(sessionId, RECENT_MESSAGE_LIMIT);
+  } catch (err) {
+    logger6.warn(`handleRefreshSessionActivity: loadSessionMessages failed for ${sessionId}: ` + `${err.message}（降级为不渲染最近消息面板）`);
+    recentMessages = undefined;
+  }
+  const snapshot = probe?.activity ?? null;
+  const sessionAlive = probe?.activity !== undefined && !probe?.terminal;
+  const lifecycle = probe?.lifecycle ? probe.lifecycle : probe?.terminal ? "completed" : sessionAlive ? "running" : taskEnrichment?.lifecycle ?? "running";
+  const preserved = ports.notifier?.buildSessionCardWithActivity?.(event.messageId, sessionId, snapshot, {
+    lifecycle,
+    task: taskEnrichment?.info,
+    ...recentMessages !== undefined ? { recentMessages } : {}
+  });
+  if (preserved) {
+    logger6.debug(`handleRefreshSessionActivity: ${sessionId} 活性已刷新 ` + `(messageCount=${snapshot?.messageCount ?? "n/a"}, task=${subject.taskId ?? "none"})`);
+    return { ok: true, action, cardUpdate: preserved };
+  }
+  logger6.warn(`handleRefreshSessionActivity: notifier 无 messageId=${event.messageId} 的状态，` + `fallback 重建 session 卡`);
+  const groupChat = taskEnrichment?.info ? undefined : await lookupSessionGroup(ports, sessionId);
+  return {
+    ok: true,
+    action,
+    cardUpdate: buildSessionCard({
+      sessionId,
+      activity: snapshot,
+      lifecycle,
+      ...taskEnrichment?.info ? { task: taskEnrichment.info } : {},
+      ...groupChat?.chatId ? { perTaskChatId: groupChat.chatId } : {},
+      ...recentMessages !== undefined ? { recentMessages } : {}
+    })
+  };
+}
+async function loadTaskEnrichment(taskId, ports) {
+  try {
+    const task = await ports.getTask?.(taskId);
+    if (!task)
+      return;
+    const raw = task;
+    return {
+      lifecycle: lifecycleOfTaskStatus(raw.status),
+      info: {
+        id: typeof raw.id === "number" ? raw.id : taskId,
+        ...raw.title ? { title: raw.title } : {},
+        ...raw.status ? { status: raw.status } : {},
+        ...typeof raw.progress === "number" ? { progress: raw.progress } : {},
+        ...raw.current_status ? { currentStatus: raw.current_status } : {},
+        ...Array.isArray(raw.milestones) && raw.milestones.length > 0 ? { milestones: raw.milestones } : {},
+        ...raw.priority ? { priority: raw.priority } : {},
+        ...raw.goals_and_expected_deliverables || raw.goals ? { goals: raw.goals_and_expected_deliverables ?? raw.goals } : {},
+        ...typeof raw.parent_task_id === "number" && raw.parent_task_id > 0 ? { parentTaskId: raw.parent_task_id } : {},
+        ...raw.created_at || raw.createdAt ? { createdAt: raw.created_at ?? raw.createdAt } : {},
+        ...raw.updated_at || raw.updatedAt ? { updatedAt: raw.updated_at ?? raw.updatedAt } : {}
+      }
+    };
+  } catch (err) {
+    logger6.warn(`loadTaskEnrichment: task #${taskId} 读取失败（降级为无 task 信息）: ` + `${err.message}`);
+    return;
+  }
+}
+function lifecycleOfTaskStatus(status) {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "failed":
+      return "failed";
+    case "cancelled":
+    case "archived":
+    case "paused":
+      return "stopped";
+    case "active":
+    case "todo":
+    case "to_validate":
+      return "running";
+    default:
+      return;
+  }
+}
+async function handleRefreshActivity(event, ports, task, taskId) {
+  const action = "refresh_activity";
+  let activity;
+  try {
+    activity = await ports.loadSubSessionActivity?.(taskId);
+  } catch (err) {
+    logger6.warn(`handleRefreshActivity: loadSubSessionActivity failed for task #${taskId}: ` + `${err.message}（降级为「暂无数据」）`);
+    activity = undefined;
+  }
+  const snapshot = activity?.activity ?? null;
+  const terminal = activity?.terminal ?? false;
+  const preserved = ports.notifier?.buildCardWithActivity?.(event.messageId, snapshot, {
+    terminal
+  });
+  if (preserved) {
+    logger6.debug(`handleRefreshActivity: task #${taskId} 活性已刷新 ` + `(messageCount=${snapshot?.messageCount ?? "n/a"}, terminal=${terminal})`);
+    return { ok: true, action, cardUpdate: preserved };
+  }
+  logger6.warn(`handleRefreshActivity: notifier 无 messageId=${event.messageId} 的状态，` + `fallback 重建卡片（历史里程碑可能丢失）`);
+  const meta = buildTaskMetaFromTask(task, extractPerTaskChatId(task.context), undefined);
+  return {
+    ok: true,
+    action,
+    cardUpdate: buildTaskCard({
+      status: cardStatusOfTaskStatus(task.status),
+      meta,
+      activity: snapshot,
+      activityTerminal: terminal
+    })
+  };
+}
+function cardStatusOfTaskStatus(status) {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "cancelled":
+      return "cancelled";
+    case "failed":
+      return "failed";
+    case "paused":
+      return "stopped";
+    case "archived":
+      return "stopped";
+    default:
+      return "running";
+  }
+}
+async function handleDisbandGroup(event, ports, task, existingChatId) {
+  if (!existingChatId) {
+    return {
+      ok: false,
+      action: "disband_group",
+      error: `Task #${task.id} 无专属群（context.larkPerTaskChatId 空），无需解散`
+    };
+  }
+  if (!ports.deleteGroupChat) {
+    return { ok: false, action: "disband_group", error: "ports.deleteGroupChat not injected" };
+  }
+  try {
+    await ports.deleteGroupChat(existingChatId, event.profile);
+    const newContext = patchContext(task.context ?? "{}", {
+      [CTX_FIELD_CHAT_ID]: undefined,
+      [CTX_FIELD_CHAT_NAME]: undefined,
+      [CTX_FIELD_CHAT_CREATED_AT]: undefined,
+      [CTX_FIELD_CHAT_TASK_ID]: undefined
+    });
+    if (ports.updateTaskContext) {
+      await ports.updateTaskContext(task.id, newContext);
+    }
+    const cardUpdate = buildCardAfterGroupChange(event, ports, task, undefined, undefined);
+    return { ok: true, action: "disband_group", cardUpdate };
+  } catch (err) {
+    logger6.error(`handleCardAction.disband_group failed: ${err.message}`);
+    return { ok: false, action: "disband_group", error: err.message };
+  }
+}
+function patchContext(contextStr, changes) {
+  let obj = {};
+  try {
+    const parsed = JSON.parse(contextStr);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      obj = parsed;
+    }
+  } catch {
+    obj = {};
+  }
+  for (const [k, v] of Object.entries(changes)) {
+    if (v === undefined) {
+      delete obj[k];
+    } else {
+      obj[k] = v;
+    }
+  }
+  return JSON.stringify(obj);
+}
+function buildTaskMetaFromTask(task, perTaskChatId, perTaskChatName) {
+  return {
+    id: task.id,
+    title: task.title,
+    description: task.description,
+    goals: task.goals,
+    parentTaskId: typeof task.parent_task_id === "number" && task.parent_task_id > 0 ? task.parent_task_id : undefined,
+    priority: task.priority,
+    type: task.type,
+    projectPath: task.project_path,
+    context: task.context,
+    currentStatus: task.current_status,
+    perTaskChatId,
+    perTaskChatName
+  };
+}
+async function deleteGroupChatViaLarkCli(chatId, profile) {
+  const profileFlag = profile ? `--profile ${profile} ` : "";
+  try {
+    const { stdout: authStdout } = await execAsync(`lark-cli ${profileFlag}auth status --json`, { timeout: 15000 });
+    const appId = JSON.parse(authStdout).appId;
+    if (!appId) {
+      throw new Error(`lark-cli auth status 未返回 appId: ${authStdout.slice(0, 200)}`);
+    }
+    const cmd = `lark-cli ${profileFlag}api DELETE /open-apis/im/v1/chats/${chatId}/members ` + `--params '{"member_id_type":"app_id"}' ` + `--data ${shellQuote(JSON.stringify({ id_list: [appId] }))} ` + `--as bot`;
+    const { stdout, stderr } = await execAsync(cmd, { timeout: 30000 });
+    logger6.debug(`deleteGroupChatViaLarkCli(${chatId}) bot 退群 ok: ` + `stdout=${stdout?.slice(0, 300)} stderr=${stderr?.slice(0, 300)}`);
+  } catch (err) {
+    logger6.warn(`deleteGroupChatViaLarkCli(${chatId}) bot 退群失败（task.context 仍会清掉，` + `飞书侧群会保留）：${err.message}`);
+  }
+}
+function shellQuote(s) {
+  return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+async function resolveBotAppId(profile) {
+  const profileFlag = profile ? `--profile ${profile} ` : "";
+  const { stdout } = await execAsync(`lark-cli ${profileFlag}auth status --json`, { timeout: 15000 });
+  const appId = JSON.parse(stdout).appId;
+  if (!appId) {
+    throw new Error(`lark-cli auth status 未返回 appId: ${stdout.slice(0, 200)}`);
+  }
+  return appId;
+}
+function truncateText(text, maxLen) {
+  if (!text)
+    return "";
+  if (text.length <= maxLen)
+    return text;
+  return text.substring(0, Math.max(0, maxLen - 3)) + "...";
+}
+async function createGroupChatViaLarkCli(opts) {
+  const profileFlag = opts.profile ? `--profile ${opts.profile} ` : "";
+  const usersFlag = opts.initialUserIds && opts.initialUserIds.length > 0 ? `--users ${shellQuote(opts.initialUserIds.join(","))} ` : "";
+  const botsFlag = opts.initialBotIds && opts.initialBotIds.length > 0 ? `--bots ${shellQuote(opts.initialBotIds.join(","))} ` : "";
+  const cmd = `lark-cli ${profileFlag}im +chat-create --name ${shellQuote(truncateText(opts.name, 60))} ` + usersFlag + botsFlag + `--description ${shellQuote(truncateText(opts.description, 100))} --as bot`;
+  const { stdout } = await execAsync(cmd, { timeout: 60000 });
+  const m = stdout.match(/"chat_id"\s*:\s*"(oc_[a-f0-9]+)"/);
+  if (!m) {
+    throw new Error(`lark-cli +chat-create 返回无法解析: ${stdout.slice(0, 300)}`);
+  }
+  return m[1];
+}
+
+// src/env/task/plugins/lark-cli-task-notify-plugin.ts
+var logger7 = createLogger("lark-cli:task-notify");
+var CTX_FIELD_CHAT_ID2 = "larkPerTaskChatId";
+var CTX_FIELD_CHAT_PROFILE = "larkPerTaskChatProfile";
+function parseLarkPerTaskChatId(ctxStr) {
+  if (!ctxStr)
+    return;
+  try {
+    const obj = JSON.parse(ctxStr);
+    const id = obj[CTX_FIELD_CHAT_ID2];
+    return typeof id === "string" ? id : undefined;
+  } catch {
+    return;
+  }
+}
+function parseLarkPerTaskChatProfile(ctxStr) {
+  if (!ctxStr)
+    return;
+  try {
+    const obj = JSON.parse(ctxStr);
+    const profile = obj[CTX_FIELD_CHAT_PROFILE];
+    return typeof profile === "string" ? profile : undefined;
+  } catch {
+    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";
+  NotifyType2["TASK_COMPLETED"] = "task_completed";
+  NotifyType2["TASK_UPDATED"] = "task_updated";
+  NotifyType2["TASK_FAILED"] = "task_failed";
+  NotifyType2["OPERATION_CREATED"] = "operation_created";
+})(NotifyType ||= {});
+
+class LarkCliTaskNotifyHook {
+  name;
+  priority;
+  description;
+  pluginName;
+  sourceId;
+  config;
+  cardNotifier;
+  cardMessageIds = new Map;
+  cardStateStore;
+  restoredTaskIds = new Set;
+  lastNotifyTimestamps = new Map;
+  trailingPatchTimers = new Map;
+  cardRoutingPorts;
+  static CARD_START_FAILED_SENTINEL = "__card_start_failed__";
+  static CARD_START_INFLIGHT_SENTINEL = "__card_start_inflight__";
+  constructor(config = {}) {
+    this.name = config.pluginName || "LarkCliTaskNotifyHook";
+    this.priority = config.priority ?? 5;
+    this.description = "LarkCli 任务通知 Hook（卡片模式）";
+    this.pluginName = config.pluginName;
+    this.sourceId = config.sourceId;
+    this.config = {
+      enabled: true,
+      priority: 5,
+      notifyTypes: [
+        "task_created" /* TASK_CREATED */,
+        "task_updated" /* TASK_UPDATED */,
+        "task_completed" /* TASK_COMPLETED */,
+        "operation_created" /* OPERATION_CREATED */
+      ],
+      ...config
+    };
+    if (this.config.cardMode !== false) {
+      const isTestEnv = "BUN_TEST_WORKER_ID" in process.env;
+      this.cardNotifier = config.cardNotifier ?? (isTestEnv ? new LarkCardPatchNotifier : getSharedLarkCardNotifier());
+      this.cardStateStore = config.cardStateStore ?? createLarkCardStateStore();
+    }
+  }
+  setCardRoutingPorts(ports) {
+    this.cardRoutingPorts = ports;
+    logger7.debug(`CardRoutingPorts injected: getTask=${typeof ports.getTask}`);
+  }
+  hasCardRoutingPorts() {
+    return this.cardRoutingPorts !== undefined;
+  }
+  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) {
+        logger7.debug(`Plugin not enabled for source: ${key}`);
+        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, sessionId: ctxSessionId } = ctx.data;
+    if (!task || !this.shouldNotify("task_created" /* TASK_CREATED */))
+      return;
+    if (!this.isCardModeEnabled())
+      return;
+    const sessionId = typeof ctxSessionId === "string" && ctxSessionId.trim() ? ctxSessionId.trim() : this.resolveSessionIdForTask(task.id);
+    if (sessionId) {
+      const merged = await this.patchSessionCardForTask(task, {
+        sessionId,
+        lifecycle: "running",
+        milestones: [
+          {
+            title: "Task 创建",
+            timestamp: new Date().toISOString(),
+            description: task.current_status || undefined
+          }
+        ]
+      });
+      if (merged) {
+        logger7.debug(`onAfterCreate: task #${task.id} 已渲染进 session 卡 ${sessionId}（单卡语义）`);
+        return;
+      }
+    }
+    await this.sendCardStart(task);
+  }
+  async onAfterUpdate(ctx) {
+    const data = ctx.data;
+    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;
+      const sessionIdTerminal = this.resolveSessionIdForTask(task.id);
+      if (sessionIdTerminal) {
+        const mergedTerminal = await this.patchSessionCardForTask(task, {
+          sessionId: sessionIdTerminal,
+          lifecycle: lifecycleOfTaskStatus(String(task.status)) ?? "running",
+          milestones: [
+            {
+              title: terminalCardStatus === "completed" ? "任务已完成" : "任务状态更新",
+              timestamp: new Date().toISOString(),
+              description: task.current_status || undefined
+            }
+          ]
+        });
+        if (mergedTerminal)
+          return;
+      }
+      await this.sendCardFinish(task);
+      return;
+    }
+    let notifyType;
+    if (changes?.status) {
+      notifyType = "task_updated" /* TASK_UPDATED */;
+    } else if (changes && Object.keys(changes).length > 0) {
+      notifyType = "task_updated" /* TASK_UPDATED */;
+    } else {
+      return;
+    }
+    if (!this.shouldNotify(notifyType))
+      return;
+    if (!this.isCardModeEnabled())
+      return;
+    const sessionIdUpdate = this.resolveSessionIdForTask(task.id);
+    if (sessionIdUpdate) {
+      const mergedUpdate = await this.patchSessionCardForTask(task, {
+        sessionId: sessionIdUpdate,
+        lifecycle: lifecycleOfTaskStatus(String(task.status)) ?? "running"
+      });
+      if (mergedUpdate)
+        return;
+    }
+    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;
+    const task = data?.task ?? data;
+    if (!task || !this.shouldNotify("task_completed" /* TASK_COMPLETED */))
+      return;
+    if (!this.isCardModeEnabled())
+      return;
+    const terminalStatus = data.terminalStatus;
+    if (terminalStatus === "to_validate" || task.status === "to_validate") {
+      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) {
+      logger7.warn(`onAfterDelete: 读取卡片记录失败 task #${taskId}: ${err.message}`);
+    }
+    const messageId = record?.messageId || this.cardMessageIds.get(taskId);
+    if (!messageId) {
+      logger7.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) {
+      logger7.warn(`onAfterDelete: patch 卡片失败 task #${taskId} message=${messageId}: ${err.message}`);
+    }
+    try {
+      await this.cardNotifier.unpinMessage(messageId, profile);
+    } catch (err) {
+      logger7.warn(`onAfterDelete: unpin 失败 task #${taskId} message=${messageId}: ${err.message}`);
+    }
+    this.cancelTrailingPatch(taskId);
+    this.persistClosed(taskId);
+    this.persistPinned(taskId, false);
+    this.cardMessageIds.delete(taskId);
+    logger7.debug(`onAfterDelete: task #${taskId} 卡片已收尾 status=deleted message=${messageId}`);
+  }
+  async onAfterOperationCreate(ctx) {
+    const { operation } = ctx.data;
+    if (!operation)
+      return;
+    if (!this.shouldNotify("operation_created" /* OPERATION_CREATED */))
+      return;
+    if (!this.isCardModeEnabled())
+      return;
+    const persisted = this.restoreCardState(operation.taskId);
+    const messageId = this.cardMessageIds.get(operation.taskId);
+    if (!messageId || messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL || messageId === LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
+      logger7.debug(`onAfterOperationCreate: no usable card for task #${operation.taskId}, skip`);
+      return;
+    }
+    if (persisted && persisted.status !== "open") {
+      logger7.debug(`onAfterOperationCreate: task #${operation.taskId} card status=${persisted.status}, skip`);
+      return;
+    }
+    const { milestones, processSteps } = this.deriveTimelineFromOperation(operation);
+    if (milestones.length === 0 && processSteps.length === 0)
+      return;
+    const env = getEnvContextOrEmpty();
+    const profile = env.replyChannel?.profile;
+    this.cardNotifier.mergeTimelineState?.(messageId, milestones, processSteps);
+    this.refreshTimeline(operation.taskId);
+    const throttled = this.shouldThrottleOperation(operation);
+    if (throttled) {
+      this.scheduleTrailingPatch(operation.taskId, messageId, profile);
+      logger7.debug(`[throttle] OPERATION_CREATED for task #${operation.taskId} ` + `merged into state + ledger; card patch deferred to window end`);
+      return;
+    }
+    await this.patchOperationTimeline(operation.taskId, messageId, profile, milestones, processSteps);
+  }
+  async patchOperationTimeline(taskId, messageId, profile, milestones, processSteps) {
+    try {
+      await this.cardNotifier.updateTask({
+        messageId,
+        profile,
+        status: "running",
+        milestones,
+        processSteps
+      });
+    } catch (err) {
+      logger7.error(`sendCardOperation failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  scheduleTrailingPatch(taskId, messageId, profile) {
+    const existing = this.trailingPatchTimers.get(taskId);
+    if (existing) {
+      return;
+    }
+    const throttleMs = this.config.operationThrottleMs ?? 5000;
+    const delay = throttleMs > 0 ? throttleMs : 0;
+    const timer = setTimeout(() => {
+      this.trailingPatchTimers.delete(taskId);
+      const liveMessageId = this.cardMessageIds.get(taskId);
+      if (liveMessageId !== messageId) {
+        logger7.debug(`[throttle] trailing patch skipped for task #${taskId}: ` + `card no longer tracked (finished/closed)`);
+        return;
+      }
+      const rec = this.cardStateStore?.get(taskId);
+      if (rec && rec.status !== "open") {
+        logger7.debug(`[throttle] trailing patch skipped for task #${taskId}: ` + `card status=${rec.status}`);
+        return;
+      }
+      this.patchOperationTimeline(taskId, messageId, profile, [], []);
+    }, delay);
+    if (typeof timer.unref === "function")
+      timer.unref();
+    this.trailingPatchTimers.set(taskId, timer);
+  }
+  cancelTrailingPatch(taskId) {
+    const timer = this.trailingPatchTimers.get(taskId);
+    if (!timer)
+      return;
+    clearTimeout(timer);
+    this.trailingPatchTimers.delete(taskId);
+  }
+  restoreCardState(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      const rec = this.cardStateStore.get(taskId);
+      if (!rec)
+        return;
+      if (rec.sessionId) {
+        this.cardNotifier?.bindTaskToSession?.(taskId, rec.sessionId);
+        if (rec.messageId) {
+          this.cardNotifier?.adoptSessionCard?.(rec.sessionId, rec.messageId);
+        }
+      }
+      if (!this.restoredTaskIds.has(taskId)) {
+        this.restoredTaskIds.add(taskId);
+        if (rec.status !== "closed" && rec.messageId) {
+          this.cardMessageIds.set(taskId, rec.messageId);
+          this.hydrateNotifierState(rec);
+          logger7.debug(`restoreCardState: task #${taskId} ← 持久层 message ${rec.messageId} ` + `(status=${rec.status}, pinned=${rec.pinned}, timeline=${rec.timeline ? "yes" : "no"})`);
+        }
+      }
+      return rec;
+    } catch (err) {
+      logger7.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) {
+      logger7.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) {
+      logger7.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) {
+      logger7.warn(`persistCardState failed for task #${state.taskId}: ${err.message}`);
+    }
+  }
+  persistPinned(taskId, pinned) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      this.cardStateStore.markPinned(taskId, pinned);
+    } catch (err) {
+      logger7.warn(`persistPinned failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  persistPaused(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      this.cardStateStore.markPaused(taskId);
+    } catch (err) {
+      logger7.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) {
+      logger7.warn(`dropStaleMessageId failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  persistReopened(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      this.cardStateStore.markReopened(taskId);
+    } catch (err) {
+      logger7.warn(`persistReopened failed for task #${taskId}: ${err.message}`);
+    }
+  }
+  persistClosed(taskId) {
+    if (!this.cardStateStore)
+      return;
+    try {
+      this.cardStateStore.markClosed(taskId);
+    } catch (err) {
+      logger7.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) {
+      logger7.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);
+      logger7.debug(`repinAfterResume: task #${task.id} 卡片 ${persisted.messageId} 已重新置顶`);
+    } catch (err) {
+      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 {
+      existing = this.cardStateStore?.get(task.id);
+    } catch (err) {
+      logger7.warn(`buildCardState: read existing failed for task #${task.id}: ${err.message}`);
+    }
+    const now = Date.now();
+    const sessionId = this.resolveSessionIdForTask(task.id);
+    return {
+      taskId: task.id,
+      messageId,
+      chatId,
+      profile,
+      pinned,
+      status: "open",
+      ...sessionId ? { sessionId } : {},
+      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) {
+      logger7.debug("cardMode=false (legacy opt-out), skip task notification (no text fallback)");
+      return false;
+    }
+    return true;
+  }
+  async resolveCardTarget(task) {
+    const env = getEnvContextOrEmpty();
+    const triggerChatId = env.replyChannel?.chatId;
+    const triggerProfile = env.replyChannel?.profile;
+    const lineage = await this.collectLineage(task);
+    const lineageIds = lineage.map((t) => t.id);
+    const selfChatId = extractPerTaskChatId(task.context);
+    let lineageChat;
+    for (const node of lineage) {
+      const chatId = extractPerTaskChatId(node.context);
+      if (chatId) {
+        lineageChat = {
+          chatId,
+          profile: extractPerTaskChatProfile(node.context),
+          isSelf: node.id === task.id
+        };
+        break;
+      }
+    }
+    if (!lineageChat && selfChatId) {
+      lineageChat = {
+        chatId: selfChatId,
+        profile: extractPerTaskChatProfile(task.context),
+        isSelf: true
+      };
+    }
+    return decideCardChatTarget({
+      taskId: task.id,
+      lineageIds,
+      lineageChat,
+      triggerChatId,
+      triggerProfile
+    });
+  }
+  async collectLineage(task) {
+    const out = [
+      { id: task.id, context: task.context }
+    ];
+    let parentId = typeof task.parent_task_id === "number" && task.parent_task_id > 0 ? task.parent_task_id : undefined;
+    let depth = 0;
+    while (parentId && depth < 10 && this.cardRoutingPorts?.getTask) {
+      try {
+        const parent = await this.cardRoutingPorts.getTask(parentId);
+        if (!parent)
+          break;
+        out.push({ id: parentId, context: parent.context });
+        parentId = typeof parent.parent_task_id === "number" && parent.parent_task_id > 0 ? parent.parent_task_id : undefined;
+      } catch {
+        break;
+      }
+      depth++;
+    }
+    return out;
+  }
+  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) {
+      logger7.debug(`sendCardStart: task #${task.id} 已有首卡（${claim}）→ 跳过重复发卡`);
+      return;
+    }
+    this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL);
+    let target;
+    try {
+      target = await this.resolveCardTarget(task);
+    } catch (err) {
+      this.cardMessageIds.delete(task.id);
+      throw err;
+    }
+    const chatId = target.chatId;
+    const profile = target.profile;
+    if (!chatId) {
+      this.cardMessageIds.delete(task.id);
+      logger7.debug(`sendCardStart: no chatId for task #${task.id}, skip`);
+      return;
+    }
+    try {
+      const { messageId, pinned } = await this.cardNotifier.startTask({
+        chatId,
+        profile,
+        meta: this.buildTaskMeta(task),
+        milestones: [
+          {
+            title: "Task 创建",
+            timestamp: new Date().toISOString(),
+            description: task.current_status || undefined
+          }
+        ]
+      });
+      this.cardMessageIds.set(task.id, messageId);
+      this.persistCardState(this.buildCardState(task, messageId, chatId, profile, pinned), true);
+      logger7.debug(`sendCardStart: task #${task.id} → message ${messageId} (pinned=${pinned}) ` + `chat=${chatId} source=${target.source} reason=${target.reason}`);
+    } catch (err) {
+      this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL);
+      logger7.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) {
+        logger7.debug(`sendCardUpdate: task #${task.id} 卡片已终结（closed）且任务仍终态 → skip patch`);
+        return;
+      }
+      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);
+    }
+    if (persisted?.status === "paused" && String(task.status) !== "paused") {
+      this.persistReopened(task.id);
+      logger7.debug(`sendCardUpdate: task #${task.id} resume（paused → open），复用卡片 ${persisted.messageId}`);
+      await this.repinAfterResume(task, persisted);
+    }
+    let messageId = this.cardMessageIds.get(task.id);
+    if (!messageId && isTerminalTaskStatus(String(task.status))) {
+      logger7.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) {
+      if (!messageId)
+        this.cardMessageIds.delete(task.id);
+      logger7.debug(`sendCardUpdate: no chatId for task #${task.id}, skip`);
+      return;
+    }
+    if (messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL) {
+      logger7.debug(`sendCardUpdate: startTask failed previously for task #${task.id}, skip`);
+      return;
+    }
+    if (messageId === LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
+      logger7.debug(`sendCardUpdate: task #${task.id} 首卡正在发送中（in-flight）→ 跳过本次 update`);
+      return;
+    }
+    if (!messageId) {
+      try {
+        const res = await this.cardNotifier.startTask({
+          chatId,
+          profile,
+          meta: this.buildTaskMeta(task)
+        });
+        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);
+        logger7.error(`sendCardUpdate fallback start failed: ${err.message}`);
+        return;
+      }
+    }
+    const changeKeys = Object.keys(changes ?? {});
+    const processSteps = changeKeys.length > 0 ? [
+      {
+        title: "状态更新",
+        timestamp: new Date().toISOString(),
+        description: changeKeys.map((k) => `${k}=${humanizeValue(changes[k], 80)}`).join(" · ")
+      }
+    ] : [];
+    try {
+      await this.cardNotifier.updateTask({
+        messageId,
+        chatId,
         profile,
-        status: "running",
-        milestones,
+        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: [],
         processSteps
       });
+      const current = this.getCardState(task.id);
+      this.persistPinned(task.id, current?.pinned ?? persisted?.pinned ?? true);
+      this.refreshTimeline(task.id);
     } catch (err) {
-      logger7.error(`sendCardOperation failed for task #${taskId}: ${err.message}`);
+      logger7.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) {
+      logger7.debug(`sendCardFinish: no card messageId for task #${task.id}, skip ` + `(记录缺失 → 不发新卡，保持幂等)`);
+      return;
+    }
+    const rawStatus = String(task.status);
+    const status = mapTaskStatusToCardStatus(rawStatus);
+    const isPaused = rawStatus === "paused" || rawStatus === "archived";
+    try {
+      this.cancelTrailingPatch(task.id);
+      const finish = isPaused ? this.cardNotifier.pauseTask.bind(this.cardNotifier) : this.cardNotifier.finishTask.bind(this.cardNotifier);
+      await finish({
+        messageId,
+        profile,
+        status,
+        meta: this.buildTaskMeta(task),
+        finalStep: task.current_status || undefined,
+        expandTimeline: rawStatus === "archived" ? true : undefined,
+        ...rawStatus === "archived" ? { pausedMilestoneTitle: "Task 已归档" } : {}
+      });
+      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);
+      }
+      logger7.debug(`sendCardFinish: task #${task.id} → status=${status} ` + `(raw=${rawStatus}) message=${messageId}`);
+    } catch (err) {
+      logger7.error(`sendCardFinish failed: ${err.message}`);
+    }
+  }
+  resolveChatId(task, env) {
+    const envChat = env.replyChannel?.chatId;
+    if (envChat)
+      return envChat;
+    const ctxStr = task.context;
+    if (typeof ctxStr === "string") {
+      const ctxChat = parseLarkPerTaskChatId(ctxStr);
+      if (ctxChat)
+        return ctxChat;
+    }
+    return;
+  }
+  resolveProfile(task, env) {
+    const envProfile = env.replyChannel?.profile;
+    if (envProfile)
+      return envProfile;
+    const ctxStr = task.context;
+    if (typeof ctxStr === "string") {
+      const ctxProfile = parseLarkPerTaskChatProfile(ctxStr);
+      if (ctxProfile)
+        return ctxProfile;
+    }
+    return;
+  }
+  buildTaskMeta(task) {
+    const sessionId = this.resolveSessionIdForTask(task.id);
+    const recordedNames = extractRecordedChatNames(task.context);
+    const matchedName = recordedNames.find((n) => new RegExp(`(?:Task\\s*#?\\s*|#)(?<![\\d])(?<!\\d)${task.id}(?!\\d)(?![\\d])`, "i").test(n));
+    return {
+      id: task.id,
+      title: task.title,
+      description: task.description,
+      goals: task.goals_and_expected_deliverables,
+      parentTaskId: typeof task.parent_task_id === "number" && task.parent_task_id > 0 ? task.parent_task_id : undefined,
+      priority: task.priority,
+      type: task.type,
+      projectPath: task.project_path,
+      context: task.context,
+      currentStatus: task.current_status,
+      perTaskChatId: extractPerTaskChatId(task.context),
+      perTaskChatName: matchedName,
+      ...sessionId ? { sessionId } : {}
+    };
+  }
+  resolveSessionIdForTask(taskId) {
+    const fromIndex = this.cardNotifier?.getSessionIdByTask?.(taskId);
+    if (fromIndex)
+      return fromIndex;
+    try {
+      const rec = this.cardStateStore?.get(taskId);
+      if (rec?.sessionId)
+        return rec.sessionId;
+    } catch {}
+    const ctx = getEnvContextOrEmpty();
+    const fromCtx = ctx?.sessionId ?? ctx?.replyChannel?.sessionId;
+    return typeof fromCtx === "string" && fromCtx ? fromCtx : undefined;
+  }
+  async patchSessionCardForTask(task, opts) {
+    if (!this.cardNotifier)
+      return false;
+    const meta = this.buildTaskMeta(task);
+    const sessionId = opts.sessionId;
+    const chatId = meta.perTaskChatId ?? this.resolveChatId(task, getEnvContextOrEmpty());
+    if (!chatId)
+      return false;
+    const profile = this.resolveProfile(task, getEnvContextOrEmpty());
+    const agentType = this.resolveAgentType();
+    const res = await this.cardNotifier.upsertSessionCard({
+      chatId,
+      ...profile ? { profile } : {},
+      sessionId,
+      ...task.title ? { title: task.title } : {},
+      ...opts.statusPhrase ? { statusPhrase: opts.statusPhrase } : {},
+      ...agentType ? { agentType } : {},
+      startedAt: task.createdAt ? String(task.createdAt) : new Date().toISOString(),
+      ...opts.milestones ? { milestones: opts.milestones } : {},
+      lifecycle: opts.lifecycle,
+      task: this.buildSessionCardTask(task, meta),
+      ...meta.perTaskChatId ? { perTaskChatId: meta.perTaskChatId } : {},
+      ...meta.perTaskChatName ? { perTaskChatName: meta.perTaskChatName } : {}
+    });
+    this.recordSessionCardForTask(task, sessionId, chatId, profile, res.messageId);
+    if (this.syncGroupCardFromOriginFn) {
+      await this.cardNotifier.syncGroupCardFromOrigin(sessionId, {
+        lifecycle: opts.lifecycle,
+        ...task.title ? { title: task.title } : {},
+        ...opts.milestones ? { milestones: opts.milestones } : {}
+      }, this.syncGroupCardFromOriginFn);
+    }
+    return true;
+  }
+  syncGroupCardFromOriginFn;
+  recordSessionCardForTask(task, sessionId, chatId, profile, messageIdIn) {
+    this.cardNotifier?.bindTaskToSession?.(task.id, sessionId);
+    if (!this.cardStateStore)
+      return;
+    const messageId = messageIdIn ?? this.cardNotifier?.getSessionCardMessageId?.(sessionId);
+    if (!messageId)
+      return;
+    this.cardMessageIds.set(task.id, messageId);
+    try {
+      const existing = this.cardStateStore.get(task.id);
+      const now = Date.now();
+      this.cardStateStore.upsert({
+        taskId: task.id,
+        messageId,
+        chatId: chatId ?? existing?.chatId ?? "",
+        ...profile ?? existing?.profile ? { profile: profile ?? existing?.profile } : {},
+        pinned: existing?.pinned ?? true,
+        status: existing?.status ?? "open",
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+        sessionId,
+        ...existing?.timeline ? { timeline: existing.timeline } : {}
+      });
+    } catch (err) {
+      logger7.warn(`recordSessionCardForTask failed for task #${task.id}: ${err.message}`);
+    }
+  }
+  resolveAgentType() {
+    const ctx = getEnvContextOrEmpty();
+    return typeof ctx?.subagentType === "string" && ctx.subagentType ? ctx.subagentType : undefined;
+  }
+  buildSessionCardTask(task, meta) {
+    return {
+      id: task.id,
+      ...task.title ? { title: task.title } : {},
+      ...task.status ? { status: String(task.status) } : {},
+      ...typeof task.progress === "number" ? { progress: task.progress } : {},
+      ...task.current_status ? { currentStatus: task.current_status } : {},
+      ...meta.priority ? { priority: meta.priority } : {},
+      ...typeof meta.parentTaskId === "number" ? { parentTaskId: meta.parentTaskId } : {},
+      ...meta.goals ? { goals: meta.goals } : {},
+      ...task.createdAt ? { createdAt: String(task.createdAt) } : {},
+      ...task.updatedAt ? { updatedAt: String(task.updatedAt) } : {}
+    };
+  }
+  deriveTimelineFromOperation(operation) {
+    const raw = operation;
+    const title = operation.milestoneTitle ?? operation.actionTitle ?? raw.action_title ?? raw.description ?? raw.type ?? undefined;
+    const detail = operation.milestoneDescription ?? operation.actionDescription ?? raw.action_description ?? undefined;
+    const timestamp = operation.timestamp ?? new Date().toISOString();
+    const milestones = [];
+    const processSteps = [];
+    if (operation.milestoneTitle || operation.milestoneType || title) {
+      milestones.push({
+        title: title ?? String(operation.milestoneType ?? "里程碑"),
+        timestamp,
+        description: detail
+      });
+    }
+    if (operation.processDescription || detail) {
+      processSteps.push({
+        title: title ?? "过程",
+        timestamp,
+        description: operation.processDescription ?? detail
+      });
+    }
+    const currentStep = operation.processDescription ?? detail ?? title ?? undefined;
+    return { milestones, processSteps, currentStep };
+  }
+  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) {
+      logger7.debug(`[throttle] skip OPERATION_CREATED patch 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;
+    if (notifyTypes)
+      return notifyTypes.includes(type);
+    return type === "task_completed" /* TASK_COMPLETED */;
+  }
+}
+__legacyDecorateClassTS([
+  TracedAs("lark-cli-task-notify.execute")
+], LarkCliTaskNotifyHook.prototype, "execute", null);
+__legacyDecorateClassTS([
+  TracedAs("lark-cli-task-notify.resolveCardTarget", {
+    recordParams: true,
+    recordResult: true,
+    flattenParamFilter: true,
+    paramFilter: (args) => ({
+      taskId: args[0]?.id,
+      triggerChatId: undefined
+    }),
+    resultFilter: (r) => ({
+      source: r?.source,
+      chatId: r?.chatId,
+      chatName: r?.chatName,
+      reason: r?.reason?.slice(0, 200)
+    })
+  })
+], LarkCliTaskNotifyHook.prototype, "resolveCardTarget", null);
+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 } from "path";
+var logger8 = createLogger("wecom:card-state");
+
+class MemoryWecomCardStateStore {
+  records = new Map;
+  upsert(state) {
+    this.records.set(state.taskId, { ...state });
   }
-  scheduleTrailingPatch(taskId, messageId, profile) {
-    const existing = this.trailingPatchTimers.get(taskId);
-    if (existing) {
-      return;
-    }
-    const throttleMs = this.config.operationThrottleMs ?? 5000;
-    const delay = throttleMs > 0 ? throttleMs : 0;
-    const timer = setTimeout(() => {
-      this.trailingPatchTimers.delete(taskId);
-      const liveMessageId = this.cardMessageIds.get(taskId);
-      if (liveMessageId !== messageId) {
-        logger7.debug(`[throttle] trailing patch skipped for task #${taskId}: ` + `card no longer tracked (finished/closed)`);
-        return;
-      }
-      const rec = this.cardStateStore?.get(taskId);
-      if (rec && rec.status !== "open") {
-        logger7.debug(`[throttle] trailing patch skipped for task #${taskId}: ` + `card status=${rec.status}`);
-        return;
-      }
-      this.patchOperationTimeline(taskId, messageId, profile, [], []);
-    }, delay);
-    if (typeof timer.unref === "function")
-      timer.unref();
-    this.trailingPatchTimers.set(taskId, timer);
+  get(taskId) {
+    const r = this.records.get(taskId);
+    return r ? { ...r } : undefined;
   }
-  cancelTrailingPatch(taskId) {
-    const timer = this.trailingPatchTimers.get(taskId);
-    if (!timer)
-      return;
-    clearTimeout(timer);
-    this.trailingPatchTimers.delete(taskId);
+  list() {
+    return [...this.records.values()].map((r) => ({ ...r }));
   }
-  restoreCardState(taskId) {
-    if (!this.cardStateStore)
+  markPaused(taskId) {
+    const r = this.records.get(taskId);
+    if (!r)
       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);
-          logger7.debug(`restoreCardState: task #${taskId} ← 持久层 message ${rec.messageId} ` + `(status=${rec.status}, pinned=${rec.pinned}, timeline=${rec.timeline ? "yes" : "no"})`);
-        }
-      }
-      return rec;
-    } catch (err) {
-      logger7.warn(`restoreCardState failed for task #${taskId}: ${err.message}`);
+    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();
   }
-  hydrateNotifierState(rec) {
-    if (!this.cardNotifier || !rec.timeline)
+  markClosed(taskId) {
+    const r = this.records.get(taskId);
+    if (!r)
       return;
-    try {
-      const snapshot = JSON.parse(rec.timeline);
-      this.cardNotifier.hydrateState?.(rec.messageId, snapshot);
-    } catch (err) {
-      logger7.warn(`hydrateNotifierState failed for task #${rec.taskId}: ${err.message}`);
+    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 rowToState(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)");
   }
-  snapshotTimeline(state) {
-    if (!this.cardNotifier || !state.messageId)
-      return state;
+  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 ? rowToState(row) : undefined;
+  }
+  list() {
+    const rows = this.db.prepare("SELECT * FROM wecom_card ORDER BY task_id ASC").all();
+    return rows.map(rowToState);
+  }
+  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 {
-      const snap = this.cardNotifier.exportState?.(state.messageId);
-      if (!snap)
-        return state;
-      return { ...state, timeline: JSON.stringify(snap) };
-    } catch (err) {
-      logger7.warn(`snapshotTimeline failed for task #${state.taskId}: ${err.message}`);
-      return state;
+      this.db.close?.();
+    } catch {}
+  }
+}
+function getDefaultWecomCardDbPath() {
+  const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+  return join(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;
+  esStatusNotifications;
+  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.esStatusNotifications = config.statusNotifications === true;
+    this.sender = config.sender ?? {
+      send: (input) => this.defaultSend(input)
+    };
+    this.cardStateStore = config.cardStateStore ?? createWecomCardStateStore();
   }
-  persistCardState(state, includeTimeline = false) {
-    if (!this.cardStateStore)
+  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;
-    try {
-      const payload = includeTimeline ? this.snapshotTimeline(state) : state;
-      this.cardStateStore.upsert(payload);
-    } catch (err) {
-      logger7.warn(`persistCardState failed for task #${state.taskId}: ${err.message}`);
+    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;
+      }
     }
-  }
-  persistPinned(taskId, pinned) {
-    if (!this.cardStateStore)
+    const fields = extractWecomFields(env, this.sourceId);
+    if (!fields.isWecom) {
+      logger9.debug("not a wecom event, skip");
       return;
-    try {
-      this.cardStateStore.markPinned(taskId, pinned);
-    } catch (err) {
-      logger7.warn(`persistPinned failed for task #${taskId}: ${err.message}`);
+    }
+    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;
     }
   }
-  persistPaused(taskId) {
-    if (!this.cardStateStore)
+  async onAfterCreate(ctx) {
+    const { task } = ctx.data;
+    if (!task || !this.shouldNotify(WecomNotifyType.TASK_CREATED))
       return;
-    try {
-      this.cardStateStore.markPaused(taskId);
-    } catch (err) {
-      logger7.warn(`persistPaused failed for task #${taskId}: ${err.message}`);
-    }
+    await this.sendCardStart(task);
   }
-  dropStaleMessageId(taskId) {
-    if (!this.cardStateStore)
+  async onAfterUpdate(ctx) {
+    const data = ctx.data;
+    if (!data?.task)
       return;
-    try {
-      const existing = this.cardStateStore.get(taskId);
-      if (!existing)
+    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;
-      this.cardStateStore.upsert({
-        ...existing,
-        messageId: "",
-        pinned: false,
-        updatedAt: Date.now()
-      });
-    } catch (err) {
-      logger7.warn(`dropStaleMessageId failed for task #${taskId}: ${err.message}`);
-    }
-  }
-  persistReopened(taskId) {
-    if (!this.cardStateStore)
+      await this.sendCardFinish(task, String(changes?.status ?? task.status));
       return;
-    try {
-      this.cardStateStore.markReopened(taskId);
-    } catch (err) {
-      logger7.warn(`persistReopened failed for task #${taskId}: ${err.message}`);
     }
-  }
-  persistClosed(taskId) {
-    if (!this.cardStateStore)
+    if (!this.shouldNotify(WecomNotifyType.TASK_UPDATED))
       return;
-    try {
-      this.cardStateStore.markClosed(taskId);
-    } catch (err) {
-      logger7.warn(`persistClosed failed for task #${taskId}: ${err.message}`);
-    }
+    await this.sendCardUpdate(task, changes);
   }
-  refreshTimeline(taskId) {
-    if (!this.cardStateStore || !this.cardNotifier)
+  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;
-    try {
-      const rec = this.cardStateStore.get(taskId);
-      if (!rec || !rec.messageId)
-        return;
-      this.cardStateStore.upsert(this.snapshotTimeline(rec));
-    } catch (err) {
-      logger7.warn(`refreshTimeline failed for task #${taskId}: ${err.message}`);
     }
+    await this.sendCardFinish(task, String(task.status));
   }
-  async repinAfterResume(task, persisted) {
-    if (!this.cardNotifier || typeof this.cardNotifier.pinMessage !== "function") {
+  async onAfterDelete(ctx) {
+    const data = ctx.data;
+    const taskId = data?.id;
+    if (data?.deleted !== true || typeof taskId !== "number")
       return;
-    }
-    if (!persisted.messageId)
+    if (!this.shouldNotify(WecomNotifyType.TASK_COMPLETED))
       return;
-    if (persisted.pinned)
+    const rec = this.getRecord(taskId);
+    if (!rec) {
+      logger9.debug(`onAfterDelete: task #${taskId} 无卡片记录，skip`);
       return;
-    const ctx = getEnvContextOrEmpty();
-    const profile = this.resolveProfile(task, ctx);
-    try {
-      await this.cardNotifier.pinMessage(persisted.messageId, profile);
-      this.persistPinned(task.id, true);
-      logger7.debug(`repinAfterResume: task #${task.id} 卡片 ${persisted.messageId} 已重新置顶`);
-    } catch (err) {
-      logger7.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) {
-      logger7.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
-    };
+    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} 卡片已收尾`);
   }
-  getCardState(taskId) {
-    if (!this.cardStateStore)
+  async onAfterOperationCreate(ctx) {
+    const { operation } = ctx.data;
+    if (!operation)
       return;
-    try {
-      return this.cardStateStore.get(taskId);
-    } catch {
+    if (!this.shouldNotify(WecomNotifyType.OPERATION_CREATED))
+      return;
+    const rec = this.getRecord(operation.taskId);
+    if (!rec) {
+      logger9.debug(`onAfterOperationCreate: task #${operation.taskId} 无卡片记录，skip`);
       return;
     }
-  }
-  listCardStates() {
-    if (!this.cardStateStore)
-      return [];
-    try {
-      return this.cardStateStore.list();
-    } catch {
-      return [];
-    }
-  }
-  isCardModeEnabled() {
-    if (this.config.cardMode === false || !this.cardNotifier) {
-      logger7.debug("cardMode=false (legacy opt-out), skip task notification (no text fallback)");
-      return false;
-    }
-    return true;
-  }
-  async resolveCardTarget(task) {
-    const env = getEnvContextOrEmpty();
-    const triggerChatId = env.replyChannel?.chatId;
-    const triggerProfile = env.replyChannel?.profile;
-    const lineage = await this.collectLineage(task);
-    const lineageIds = lineage.map((t) => t.id);
-    const selfChatId = extractPerTaskChatId(task.context);
-    let lineageChat;
-    for (const node of lineage) {
-      const chatId = extractPerTaskChatId(node.context);
-      if (chatId) {
-        lineageChat = {
-          chatId,
-          profile: extractPerTaskChatProfile(node.context),
-          isSelf: node.id === task.id
-        };
-        break;
-      }
-    }
-    if (!lineageChat && selfChatId) {
-      lineageChat = {
-        chatId: selfChatId,
-        profile: extractPerTaskChatProfile(task.context),
-        isSelf: true
-      };
-    }
-    return decideCardChatTarget({
-      taskId: task.id,
-      lineageIds,
-      lineageChat,
-      triggerChatId,
-      triggerProfile
-    });
-  }
-  async collectLineage(task) {
-    const out = [
-      { id: task.id, context: task.context }
-    ];
-    let parentId = typeof task.parent_task_id === "number" && task.parent_task_id > 0 ? task.parent_task_id : undefined;
-    let depth = 0;
-    while (parentId && depth < 10 && this.cardRoutingPorts?.getTask) {
-      try {
-        const parent = await this.cardRoutingPorts.getTask(parentId);
-        if (!parent)
-          break;
-        out.push({ id: parentId, context: parent.context });
-        parentId = typeof parent.parent_task_id === "number" && parent.parent_task_id > 0 ? parent.parent_task_id : undefined;
-      } catch {
-        break;
-      }
-      depth++;
+    if (rec.status !== "open") {
+      logger9.debug(`onAfterOperationCreate: task #${operation.taskId} status=${rec.status}, skip`);
+      return;
     }
-    return out;
+    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) {
-    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) {
-      logger7.debug(`sendCardStart: task #${task.id} 已有首卡（${claim}）→ 跳过重复发卡`);
+    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;
     }
-    this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL);
-    let target;
-    try {
-      target = await this.resolveCardTarget(task);
-    } catch (err) {
-      this.cardMessageIds.delete(task.id);
-      throw err;
-    }
-    const chatId = target.chatId;
-    const profile = target.profile;
-    if (!chatId) {
-      this.cardMessageIds.delete(task.id);
-      logger7.debug(`sendCardStart: no chatId for task #${task.id}, skip`);
+    const existing = this.getRecord(task.id);
+    if (existing?.status === "open") {
+      logger9.debug(`sendCardStart: task #${task.id} 已有 open 记录 → 跳过重复发卡`);
       return;
     }
-    try {
-      const { messageId, pinned } = await this.cardNotifier.startTask({
+    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,
-        profile,
-        meta: this.buildTaskMeta(task),
-        milestones: [
-          {
-            title: "Task 创建",
-            timestamp: new Date().toISOString(),
-            description: task.current_status || undefined
-          }
-        ]
+        pinned: false,
+        status: "open",
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+        updateCount: 1,
+        timeline: JSON.stringify(milestones)
       });
-      this.cardMessageIds.set(task.id, messageId);
-      this.persistCardState(this.buildCardState(task, messageId, chatId, profile, pinned), true);
-      logger7.debug(`sendCardStart: task #${task.id} → message ${messageId} (pinned=${pinned}) ` + `chat=${chatId} source=${target.source} reason=${target.reason}`);
-    } catch (err) {
-      this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL);
-      logger7.error(`sendCardStart failed for task #${task.id}: ${err.message}`);
+    } 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) {
-    if (!this.cardNotifier)
-      return;
-    const persisted = this.restoreCardState(task.id);
-    if (persisted?.status === "closed") {
-      const stillTerminal = isTerminalTaskStatus(String(task.status));
-      if (stillTerminal) {
-        logger7.debug(`sendCardUpdate: task #${task.id} 卡片已终结（closed）且任务仍终态 → skip patch`);
+    const rec = this.getRecord(task.id);
+    if (!rec) {
+      if (isHardTerminal(String(task.status))) {
+        logger9.debug(`sendCardUpdate: task #${task.id} 终态且无卡片 → skip`);
         return;
       }
-      logger7.info(`sendCardUpdate: task #${task.id} 已 reopen（closed 记录 + 当前 status=${task.status}）` + `→ 重新建卡`);
-      this.cardMessageIds.delete(task.id);
-      this.dropStaleMessageId(task.id);
-    }
-    if (persisted?.status === "paused" && String(task.status) !== "paused") {
-      this.persistReopened(task.id);
-      logger7.debug(`sendCardUpdate: task #${task.id} resume（paused → open），复用卡片 ${persisted.messageId}`);
-      await this.repinAfterResume(task, persisted);
+      logger9.debug(`sendCardUpdate: task #${task.id} 无卡片记录 → ` + `单卡语义不补发（进展落时间线）`);
+      return;
     }
-    let messageId = this.cardMessageIds.get(task.id);
-    if (!messageId && isTerminalTaskStatus(String(task.status))) {
-      logger7.debug(`sendCardUpdate: task #${task.id} 状态=${task.status}（终结/归档）且无卡片 → skip`);
+    if (rec.status === "closed" && isHardTerminal(String(task.status))) {
+      logger9.debug(`sendCardUpdate: task #${task.id} closed + 终态 → skip`);
       return;
     }
-    if (!messageId) {
-      this.cardMessageIds.set(task.id, LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL);
+    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
+        });
+      }
     }
-    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) {
-      if (!messageId)
-        this.cardMessageIds.delete(task.id);
-      logger7.debug(`sendCardUpdate: no chatId for task #${task.id}, skip`);
+    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 (messageId === LarkCliTaskNotifyHook.CARD_START_FAILED_SENTINEL) {
-      logger7.debug(`sendCardUpdate: startTask failed previously for task #${task.id}, skip`);
+    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;
     }
-    if (messageId === LarkCliTaskNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
-      logger7.debug(`sendCardUpdate: task #${task.id} 首卡正在发送中（in-flight）→ 跳过本次 update`);
-      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);
     }
-    if (!messageId) {
-      try {
-        const res = await this.cardNotifier.startTask({
-          chatId,
-          profile,
-          meta: this.buildTaskMeta(task)
+    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) {
+      if (this.statusNotificationsEnabled()) {
+        await this.sendStatusMarkdown(input, content).catch((err) => {
+          logger9.warn(`sendStatusMarkdown failed for task #${input.task.id}: ` + `${err.message}（不影响卡片送达）`);
         });
-        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);
-        logger7.error(`sendCardUpdate fallback start failed: ${err.message}`);
-        return;
       }
+      return true;
     }
-    const changeKeys = Object.keys(changes ?? {});
-    const processSteps = changeKeys.length > 0 ? [
-      {
-        title: "状态更新",
-        timestamp: new Date().toISOString(),
-        description: changeKeys.map((k) => `${k}=${humanizeValue(changes[k], 80)}`).join(" · ")
-      }
-    ] : [];
     try {
-      await this.cardNotifier.updateTask({
-        messageId,
-        chatId,
-        profile,
-        status: "running",
-        meta: this.buildTaskMeta(task),
-        progress: typeof task.progress === "number" && task.progress > 0 ? task.progress : undefined,
-        milestones: [],
-        processSteps
+      const r = await this.sender.send({
+        chatId: input.chatId,
+        content
       });
-      const current = this.getCardState(task.id);
-      this.persistPinned(task.id, current?.pinned ?? persisted?.pinned ?? true);
-      this.refreshTimeline(task.id);
+      if (!r.ok) {
+        logger9.warn(`deliver failed for task #${input.task.id}: ${r.error ?? "unknown"}`);
+        return false;
+      }
+      return true;
     } catch (err) {
-      logger7.error(`sendCardUpdate failed: ${err.message}`);
+      logger9.error(`deliver threw for task #${input.task.id}: ${err.message}`);
+      return false;
     }
   }
-  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) {
-      logger7.debug(`sendCardFinish: no card messageId for task #${task.id}, skip ` + `(记录缺失 → 不发新卡，保持幂等)`);
-      return;
+  statusNotificationsEnabled() {
+    try {
+      return this.esStatusNotifications === true;
+    } catch {
+      return false;
     }
-    const rawStatus = String(task.status);
-    const status = mapTaskStatusToCardStatus(rawStatus);
-    const isPaused = rawStatus === "paused" || rawStatus === "archived";
+  }
+  async sendStatusMarkdown(input, content) {
+    const r = await this.sender.send({ chatId: input.chatId, content });
+    if (!r.ok) {
+      logger9.warn(`sendStatusMarkdown failed for task #${input.task.id}: ` + `${r.error ?? "unknown"}（不影响卡片送达）`);
+    }
+  }
+  async deliverTemplateCard(input) {
     try {
-      this.cancelTrailingPatch(task.id);
-      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,
-        expandTimeline: rawStatus === "archived" ? true : undefined,
-        ...rawStatus === "archived" ? { pausedMilestoneTitle: "Task 已归档" } : {}
+      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
       });
-      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);
+      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 },
+          {
+            text: "刷新活性",
+            key: WecomCardActionKey.REFRESH_ACTIVITY,
+            style: 2
+          }
+        ]
+      });
+      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;
       }
-      logger7.debug(`sendCardFinish: task #${task.id} → status=${status} ` + `(raw=${rawStatus}) message=${messageId}`);
+      return true;
     } catch (err) {
-      logger7.error(`sendCardFinish failed: ${err.message}`);
+      logger9.warn(`deliverTemplateCard threw for task #${input.task.id}: ` + `${err.message}（回落 markdown）`);
+      return false;
     }
   }
-  resolveChatId(task, env) {
-    const envChat = env.replyChannel?.chatId;
-    if (envChat)
-      return envChat;
-    const ctxStr = task.context;
-    if (typeof ctxStr === "string") {
-      const ctxChat = parseLarkPerTaskChatId(ctxStr);
-      if (ctxChat)
-        return ctxChat;
+  getRecord(taskId) {
+    try {
+      return this.cardStateStore.get(taskId);
+    } catch (err) {
+      logger9.warn(`getRecord failed for task #${taskId}: ${err.message}`);
+      return;
     }
-    return;
   }
-  resolveProfile(task, env) {
-    const envProfile = env.replyChannel?.profile;
-    if (envProfile)
-      return envProfile;
-    const ctxStr = task.context;
-    if (typeof ctxStr === "string") {
-      const ctxProfile = parseLarkPerTaskChatProfile(ctxStr);
-      if (ctxProfile)
-        return ctxProfile;
+  parseTimeline(timeline) {
+    if (!timeline)
+      return [];
+    try {
+      const arr = JSON.parse(timeline);
+      return Array.isArray(arr) ? arr : [];
+    } catch {
+      return [];
     }
-    return;
   }
-  buildTaskMeta(task) {
-    const recordedNames = extractRecordedChatNames(task.context);
-    const matchedName = recordedNames.find((n) => new RegExp(`(?:Task\\s*#?\\s*|#)(?<![\\d])(?<!\\d)${task.id}(?!\\d)(?![\\d])`, "i").test(n));
-    return {
-      id: task.id,
-      title: task.title,
-      description: task.description,
-      goals: task.goals_and_expected_deliverables,
-      parentTaskId: typeof task.parent_task_id === "number" && task.parent_task_id > 0 ? task.parent_task_id : undefined,
-      priority: task.priority,
-      type: task.type,
-      projectPath: task.project_path,
-      context: task.context,
-      currentStatus: task.current_status,
-      perTaskChatId: extractPerTaskChatId(task.context),
-      perTaskChatName: matchedName
-    };
+  trimTimeline(milestones) {
+    const max = this.config.maxTimelineEntries ?? 20;
+    if (milestones.length <= max)
+      return milestones;
+    return milestones.slice(milestones.length - max);
   }
-  deriveTimelineFromOperation(operation) {
-    const raw = operation;
-    const title = operation.milestoneTitle ?? operation.actionTitle ?? raw.action_title ?? raw.description ?? raw.type ?? undefined;
-    const detail = operation.milestoneDescription ?? operation.actionDescription ?? raw.action_description ?? undefined;
-    const timestamp = operation.timestamp ?? new Date().toISOString();
-    const milestones = [];
-    const processSteps = [];
-    if (operation.milestoneTitle || operation.milestoneType || title) {
-      milestones.push({
-        title: title ?? String(operation.milestoneType ?? "里程碑"),
-        timestamp,
-        description: detail
-      });
-    }
-    if (operation.processDescription || detail) {
-      processSteps.push({
-        title: title ?? "过程",
-        timestamp,
-        description: operation.processDescription ?? detail
+  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}`);
     }
-    const currentStep = operation.processDescription ?? detail ?? title ?? undefined;
-    return { milestones, processSteps, currentStep };
+  }
+  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;
@@ -2732,7 +4315,7 @@ class LarkCliTaskNotifyHook {
     const now = Date.now();
     const lastTime = this.lastNotifyTimestamps.get(key);
     if (lastTime && now - lastTime < throttleMs) {
-      logger7.debug(`[throttle] skip OPERATION_CREATED patch for task #${operation.taskId} (${now - lastTime}ms ago)`);
+      logger9.debug(`[throttle] skip OPERATION_CREATED send for task #${operation.taskId} ` + `(${now - lastTime}ms ago)`);
       return true;
     }
     this.lastNotifyTimestamps.set(key, now);
@@ -2740,49 +4323,50 @@ class LarkCliTaskNotifyHook {
   }
   shouldNotify(type) {
     const { notifyTypes } = this.config;
-    if (notifyTypes && notifyTypes.length === 0)
+    if (!notifyTypes || notifyTypes.length === 0)
       return true;
-    if (notifyTypes)
-      return notifyTypes.includes(type);
-    return type === "task_completed" /* TASK_COMPLETED */;
+    return notifyTypes.includes(type);
   }
 }
 __legacyDecorateClassTS([
-  TracedAs("lark-cli-task-notify.execute")
-], LarkCliTaskNotifyHook.prototype, "execute", null);
-__legacyDecorateClassTS([
-  TracedAs("lark-cli-task-notify.resolveCardTarget", {
-    recordParams: true,
-    recordResult: true,
-    flattenParamFilter: true,
-    paramFilter: (args) => ({
-      taskId: args[0]?.id,
-      triggerChatId: undefined
-    }),
-    resultFilter: (r) => ({
-      source: r?.source,
-      chatId: r?.chatId,
-      chatName: r?.chatName,
-      reason: r?.reason?.slice(0, 200)
-    })
-  })
-], LarkCliTaskNotifyHook.prototype, "resolveCardTarget", null);
-function createLarkCliTaskNotifyHook(config = {}) {
-  return new LarkCliTaskNotifyHook(config);
+  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";
 }
-var CTX_FIELD_CHAT_ID2 = "larkPerTaskChatId";
+var CTX_FIELD_CHAT_ID3 = "larkPerTaskChatId";
 var CTX_FIELD_CHAT_PROFILE2 = "larkPerTaskChatProfile";
-var CTX_FIELD_CHAT_CREATED_AT = "larkPerTaskChatCreatedAt";
-var CTX_FIELD_CHAT_TASK_ID = "larkPerTaskChatTaskId";
+var CTX_FIELD_CHAT_CREATED_AT2 = "larkPerTaskChatCreatedAt";
+var CTX_FIELD_CHAT_TASK_ID2 = "larkPerTaskChatTaskId";
 
 class PerTaskGroupChatPlugin {
   name;
@@ -2818,7 +4402,7 @@ class PerTaskGroupChatPlugin {
       resolveToTriggerChatFallback: config.resolveToTriggerChatFallback ?? false,
       cardInitialMessage: config.cardInitialMessage !== false,
       autoCreateGroup: config.autoCreateGroup === true,
-      cardNotifier: config.cardNotifier ?? new LarkCardPatchNotifier
+      cardNotifier: config.cardNotifier ?? getSharedLarkCardNotifier()
     };
     this.cardNotifier = this.config.cardNotifier;
     this.name = this.config.pluginName;
@@ -2830,7 +4414,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 +4423,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 +4437,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 +4455,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 +4491,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 +4504,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 +4529,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 +4546,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 +4585,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 +4598,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, {
@@ -3113,22 +4697,22 @@ class PerTaskGroupChatPlugin {
     } catch {
       parsed = {};
     }
-    parsed[CTX_FIELD_CHAT_ID2] = chatId;
+    parsed[CTX_FIELD_CHAT_ID3] = chatId;
     parsed[CTX_FIELD_CHAT_PROFILE2] = profile;
-    parsed[CTX_FIELD_CHAT_CREATED_AT] = new Date().toISOString();
-    parsed[CTX_FIELD_CHAT_TASK_ID] = task.id;
+    parsed[CTX_FIELD_CHAT_CREATED_AT2] = new Date().toISOString();
+    parsed[CTX_FIELD_CHAT_TASK_ID2] = 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;
     }
   }
@@ -3155,7 +4739,7 @@ class PerTaskGroupChatPlugin {
       return;
     try {
       const obj = JSON.parse(ctxStr);
-      const id = obj[CTX_FIELD_CHAT_ID2];
+      const id = obj[CTX_FIELD_CHAT_ID3];
       return typeof id === "string" ? id : undefined;
     } catch {
       return;
@@ -3223,15 +4807,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 +4825,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 +4848,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 +5001,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, handleCardAction, deleteGroupChatViaLarkCli, createGroupChatViaLarkCli, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, MemoryWecomCardStateStore, createMemoryWecomCardStore, SqliteWecomCardStateStore, getDefaultWecomCardDbPath, createWecomCardStateStore, WecomNotifyType, extractWecomFields, buildWecomTaskCard, WecomTaskNotifyHook, createWecomTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };