@xgjktech/xg_cwork_im 1.18.9 → 1.19.1

package/dist/src/plan-core-db.test.js

@@ -0,0 +1,115 @@
+import assert from "node:assert/strict";
+import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { after, afterEach, describe, it } from "node:test";
+import { readCoreProgressCard, resolveCoreAgentSqlitePath, setCoreAgentStateBase, } from "./plan-core-db.js";
+const tempDirs = [];
+function makeTempBase() {
+    const dir = mkdtempSync(join(tmpdir(), "xg-plan-core-db-"));
+    tempDirs.push(dir);
+    return dir;
+}
+/** 造一个带 session_progress_cards 的 openclaw-agent.sqlite。 */
+function seedAgentDb(baseDir, agentId, rows) {
+    const agentDir = join(baseDir, "agents", agentId, "agent");
+    mkdirSync(agentDir, { recursive: true });
+    const dbPath = join(agentDir, "openclaw-agent.sqlite");
+    const db = new DatabaseSync(dbPath);
+    try {
+        db.exec(`
+            CREATE TABLE session_progress_cards (
+              session_key TEXT NOT NULL PRIMARY KEY,
+              markdown TEXT,
+              steps_json TEXT,
+              revision INTEGER NOT NULL,
+              created_at INTEGER NOT NULL,
+              updated_at INTEGER NOT NULL
+            ) STRICT;
+        `);
+        const insert = db.prepare("INSERT INTO session_progress_cards (session_key, markdown, steps_json, revision, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?);");
+        for (const row of rows) {
+            insert.run(row.sessionKey, null, row.stepsJson, row.revision ?? 1, row.createdAtMs ?? 1_700_000_000_000, row.updatedAtMs ?? 1_700_000_600_000);
+        }
+    }
+    finally {
+        db.close();
+    }
+    return dbPath;
+}
+after(() => {
+    for (const dir of tempDirs.splice(0)) {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        catch {
+            // Windows 偶发句柄未释放导致删除失败，忽略
+        }
+    }
+});
+afterEach(() => {
+    // 避免 module 级 base 残留影响后续用例
+    setCoreAgentStateBase("");
+});
+describe("resolveCoreAgentSqlitePath / readCoreProgressCard", () => {
+    it("未注入 base → 路径与读取均为 undefined，不外抛", () => {
+        setCoreAgentStateBase("");
+        assert.equal(resolveCoreAgentSqlitePath("main"), undefined);
+        assert.equal(readCoreProgressCard({ agentId: "main", sessionKey: "s-1" }), undefined);
+    });
+    it("读取到 typed steps 与时间戳/revision", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        seedAgentDb(base, "main", [
+            {
+                sessionKey: "agent:main:s-1",
+                stepsJson: JSON.stringify([
+                    { step: "备份", status: "completed" },
+                    { step: "校验", status: "in_progress" },
+                ]),
+                revision: 3,
+                createdAtMs: 1_700_000_000_000,
+                updatedAtMs: 1_700_000_900_000,
+            },
+        ]);
+        const card = readCoreProgressCard({ agentId: "main", sessionKey: "agent:main:s-1" });
+        assert.ok(card);
+        assert.deepEqual(card.steps, [
+            { step: "备份", status: "completed" },
+            { step: "校验", status: "in_progress" },
+        ]);
+        assert.equal(card.revision, 3);
+        assert.equal(card.createdAtMs, 1_700_000_000_000);
+        assert.equal(card.updatedAtMs, 1_700_000_900_000);
+    });
+    it("steps_json 为 null → undefined；非法 JSON → undefined；非法步骤被过滤", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        seedAgentDb(base, "main", [
+            { sessionKey: "s-empty", stepsJson: null },
+            { sessionKey: "s-bad-json", stepsJson: "{not json" },
+            {
+                sessionKey: "s-filtered",
+                stepsJson: JSON.stringify([
+                    { step: "keep", status: "pending" },
+                    { step: "", status: "pending" },
+                    { status: "completed" },
+                    { step: "bad-status", status: "blocked" },
+                ]),
+            },
+        ]);
+        assert.equal(readCoreProgressCard({ agentId: "main", sessionKey: "s-empty" }), undefined);
+        assert.equal(readCoreProgressCard({ agentId: "main", sessionKey: "s-bad-json" }), undefined);
+        const filtered = readCoreProgressCard({ agentId: "main", sessionKey: "s-filtered" });
+        assert.deepEqual(filtered?.steps, [{ step: "keep", status: "pending" }]);
+    });
+    it("行/库不存在 → undefined；库文件不存在 → undefined 不外抛", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        assert.equal(readCoreProgressCard({ agentId: "missing-agent", sessionKey: "s-1" }), undefined);
+        seedAgentDb(base, "main", [{ sessionKey: "s-1", stepsJson: "[]" }]);
+        assert.equal(readCoreProgressCard({ agentId: "main", sessionKey: "s-not-exist" }), undefined);
+    });
+});
+//# sourceMappingURL=plan-core-db.test.js.map

package/dist/src/plan-core-db.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-core-db.test.js","sourceRoot":"","sources":["../../src/plan-core-db.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EACH,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,QAAQ,GAAa,EAAE,CAAC;AAE9B,SAAS,YAAY;IACjB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,GAAG,CAAC;AACf,CAAC;AAED,2DAA2D;AAC3D,SAAS,WAAW,CAAC,OAAe,EAAE,OAAe,EAAE,IAMrD;IACE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3D,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC;QACD,EAAE,CAAC,IAAI,CAAC;;;;;;;;;SASP,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACrB,qIAAqI,CACxI,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CACN,GAAG,CAAC,UAAU,EACd,IAAI,EACJ,GAAG,CAAC,SAAS,EACb,GAAG,CAAC,QAAQ,IAAI,CAAC,EACjB,GAAG,CAAC,WAAW,IAAI,iBAAiB,EACpC,GAAG,CAAC,WAAW,IAAI,iBAAiB,CACvC,CAAC;QACN,CAAC;IACL,CAAC;YAAS,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,KAAK,CAAC,GAAG,EAAE;IACP,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC;YACD,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACL,2BAA2B;QAC/B,CAAC;IACL,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACX,4BAA4B;IAC5B,qBAAqB,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC/D,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;QAC5B,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE;YACtB;gBACI,UAAU,EAAE,gBAAgB;gBAC5B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC;oBACtB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE;oBACnC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE;iBACxC,CAAC;gBACF,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,iBAAiB;gBAC9B,WAAW,EAAE,iBAAiB;aACjC;SACJ,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,oBAAoB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE;YACzB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE;YACnC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE;SACxC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACjE,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;QAC5B,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE;YACtB,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;YAC1C,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE;YACpD;gBACI,UAAU,EAAE,YAAY;gBACxB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC;oBACtB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE;oBACnC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;oBAC/B,EAAE,MAAM,EAAE,WAAW,EAAE;oBACvB,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE;iBAC5C,CAAC;aACL;SACJ,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAC1F,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7F,MAAM,QAAQ,GAAG,oBAAoB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;QAC5B,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAC/F,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/src/plan-core-snapshot.d.ts

@@ -0,0 +1,23 @@
+import type { Plan } from "@xgjktech/xg-openclaw-shared";
+import type { ImStreamClient } from "./connection.js";
+import { type StoredCoreProgressCard } from "./plan-core-db.js";
+/** 由 core 落库卡合成 Plan（source:"snapshot"）；任何失败静默返回 undefined。 */
+export declare function buildPlanFromCoreCard(params: {
+    sessionKey: string;
+    groupId: string;
+    card: StoredCoreProgressCard;
+    accountId?: string;
+}): Plan | undefined;
+/**
+ * 每轮 @ 触发时（热路径入口）：登记 WS client 后 fire-and-forget 推送一次快照。
+ * 纪律：登记必须先于快照、快照失败绝不影响登记（沿用原 PLAN_STAT 快照语义）。
+ */
+export declare function registerCorePlanSnapshotClient(params: {
+    groupId: string;
+    client: ImStreamClient;
+    replyToMsgId: string;
+    agentId: string;
+    sessionKey: string;
+    nowMs?: number;
+}): void;
+//# sourceMappingURL=plan-core-snapshot.d.ts.map

package/dist/src/plan-core-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-core-snapshot.d.ts","sourceRoot":"","sources":["../../src/plan-core-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAetF,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,GAAG,SAAS,CAWnB;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAqCP"}

package/dist/src/plan-core-snapshot.js

@@ -0,0 +1,65 @@
+import { readCoreProgressCard } from "./plan-core-db.js";
+import { buildPlanFromCoreUpdate } from "./plan-core-adapter.js";
+import { sendPlanStat } from "./plan-stat-event.js";
+import { setPlanWsClient } from "./plan-ws-registry.js";
+const LOG_PREFIX = "[xg_cwork_im] [plan-core-snapshot]";
+/** 快照新鲜度阈值：core 卡超过 1 小时未更新，视为已失败/过期，快照不再推给前端。 */
+const CORE_PLAN_SNAPSHOT_STALE_MS = 60 * 60 * 1_000;
+/** 「未完成」判定：存在 status !== "completed" 的步骤。空 steps 已被读取层过滤。 */
+function isUnfinished(card) {
+    return card.steps.some((step) => step.status !== "completed");
+}
+/** 由 core 落库卡合成 Plan（source:"snapshot"）；任何失败静默返回 undefined。 */
+export function buildPlanFromCoreCard(params) {
+    const { sessionKey, groupId, card, accountId } = params;
+    const createdAtIso = card.createdAtMs > 0 ? new Date(card.createdAtMs).toISOString() : undefined;
+    return buildPlanFromCoreUpdate({
+        sessionKey,
+        groupId,
+        accountId,
+        payload: { phase: "update", title: "Plan updated", steps: card.steps },
+        nowMs: card.updatedAtMs > 0 ? card.updatedAtMs : Date.now(),
+        ...(createdAtIso ? { createdAtIso } : {}),
+    });
+}
+/**
+ * 每轮 @ 触发时（热路径入口）：登记 WS client 后 fire-and-forget 推送一次快照。
+ * 纪律：登记必须先于快照、快照失败绝不影响登记（沿用原 PLAN_STAT 快照语义）。
+ */
+export function registerCorePlanSnapshotClient(params) {
+    const { groupId, client, replyToMsgId, agentId, sessionKey } = params;
+    setPlanWsClient(groupId, client, replyToMsgId);
+    try {
+        const card = readCoreProgressCard({ agentId, sessionKey });
+        if (!card) {
+            return;
+        }
+        const nowMs = params.nowMs ?? Date.now();
+        if (nowMs - card.updatedAtMs > CORE_PLAN_SNAPSHOT_STALE_MS) {
+            console.warn("[xg_cwork_im] [plan-telemetry] stale-core-plan-dropped " +
+                JSON.stringify({
+                    sessionKey,
+                    planId: sessionKey,
+                    updatedAt: new Date(card.updatedAtMs).toISOString(),
+                    revision: card.revision,
+                }));
+            return;
+        }
+        if (!isUnfinished(card)) {
+            return;
+        }
+        const plan = buildPlanFromCoreCard({
+            sessionKey,
+            groupId,
+            card,
+        });
+        if (!plan) {
+            return;
+        }
+        sendPlanStat({ plan, source: "snapshot" });
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} 快照失败已吞 sessionKey=${sessionKey} groupId=${groupId}: ${String(err)}`);
+    }
+}
+//# sourceMappingURL=plan-core-snapshot.js.map

package/dist/src/plan-core-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-core-snapshot.js","sourceRoot":"","sources":["../../src/plan-core-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/src/plan-core-snapshot.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plan-core-snapshot.test.d.ts.map

package/dist/src/plan-core-snapshot.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-core-snapshot.test.d.ts","sourceRoot":"","sources":["../../src/plan-core-snapshot.test.ts"],"names":[],"mappings":""}

package/dist/src/plan-core-snapshot.test.js

@@ -0,0 +1,155 @@
+import assert from "node:assert/strict";
+import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { after, afterEach, describe, it } from "node:test";
+import { buildCorePlanId } from "./plan-core-adapter.js";
+import { setCoreAgentStateBase } from "./plan-core-db.js";
+import { registerCorePlanSnapshotClient } from "./plan-core-snapshot.js";
+import { resetPlanWsRegistryForTest } from "./plan-ws-registry.js";
+const NOW = Date.parse("2026-09-08T12:00:00.000Z");
+const HOUR = 60 * 60_000;
+const tempDirs = [];
+function makeTempBase() {
+    const dir = mkdtempSync(join(tmpdir(), "xg-plan-core-snapshot-"));
+    tempDirs.push(dir);
+    return dir;
+}
+function seedCard(baseDir, agentId, sessionKey, opts) {
+    const agentDir = join(baseDir, "agents", agentId, "agent");
+    mkdirSync(agentDir, { recursive: true });
+    const db = new DatabaseSync(join(agentDir, "openclaw-agent.sqlite"));
+    try {
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS session_progress_cards (
+              session_key TEXT NOT NULL PRIMARY KEY,
+              markdown TEXT,
+              steps_json TEXT,
+              revision INTEGER NOT NULL,
+              created_at INTEGER NOT NULL,
+              updated_at INTEGER NOT NULL
+            ) STRICT;
+        `);
+        db.prepare("INSERT INTO session_progress_cards (session_key, markdown, steps_json, revision, created_at, updated_at) VALUES (?, NULL, ?, 1, ?, ?);").run(sessionKey, opts.stepsJson, opts.createdAtMs ?? NOW - HOUR, opts.updatedAtMs ?? NOW - 5 * 60_000);
+    }
+    finally {
+        db.close();
+    }
+}
+function makeRecordingClient() {
+    const calls = [];
+    const client = {
+        start: async () => { },
+        streamProgress: async () => { },
+        streamUsage: async () => { },
+        sendEvent: async (opts) => {
+            calls.push(opts);
+        },
+        end: async () => { },
+    };
+    return { client, calls };
+}
+after(() => {
+    for (const dir of tempDirs.splice(0)) {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        catch {
+            // Windows 偶发句柄未释放导致删除失败，忽略
+        }
+    }
+});
+afterEach(() => {
+    resetPlanWsRegistryForTest();
+    setCoreAgentStateBase("");
+});
+describe("registerCorePlanSnapshotClient", () => {
+    it("登记 client 并推送一份 source=snapshot 的未完成新鲜计划", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        const sessionKey = "agent:main:s-1";
+        seedCard(base, "main", sessionKey, {
+            stepsJson: JSON.stringify([
+                { step: "备份", status: "completed" },
+                { step: "校验", status: "in_progress" },
+            ]),
+            createdAtMs: NOW - HOUR,
+            updatedAtMs: NOW - 5 * 60_000,
+        });
+        const { client, calls } = makeRecordingClient();
+        registerCorePlanSnapshotClient({
+            groupId: "g-1",
+            client,
+            replyToMsgId: "msg-1",
+            agentId: "main",
+            sessionKey,
+            nowMs: NOW,
+        });
+        assert.equal(calls.length, 1);
+        const sent = calls[0];
+        assert.equal(sent.event, "PLAN_STAT");
+        assert.equal(sent.data.source, "snapshot");
+        const plan = sent.data.plan;
+        assert.equal(plan.planId, buildCorePlanId(sessionKey));
+        assert.equal(plan.createdAt, new Date(NOW - HOUR).toISOString());
+        assert.equal(plan.updatedAt, new Date(NOW - 5 * 60_000).toISOString());
+        assert.deepEqual(plan.tasks, [
+            { title: "备份", status: "completed" },
+            { title: "校验", status: "in_progress" },
+        ]);
+    });
+    it("超过 1 小时未更新 → 不发（陈旧）", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        const sessionKey = "agent:main:s-1";
+        seedCard(base, "main", sessionKey, {
+            stepsJson: JSON.stringify([{ step: "A", status: "in_progress" }]),
+            updatedAtMs: NOW - 2 * HOUR,
+        });
+        const { client, calls } = makeRecordingClient();
+        registerCorePlanSnapshotClient({
+            groupId: "g-1",
+            client,
+            replyToMsgId: "msg-1",
+            agentId: "main",
+            sessionKey,
+            nowMs: NOW,
+        });
+        assert.equal(calls.length, 0);
+    });
+    it("全部 completed → 不发", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        const sessionKey = "agent:main:s-1";
+        seedCard(base, "main", sessionKey, {
+            stepsJson: JSON.stringify([{ step: "A", status: "completed" }]),
+            updatedAtMs: NOW - 5 * 60_000,
+        });
+        const { client, calls } = makeRecordingClient();
+        registerCorePlanSnapshotClient({
+            groupId: "g-1",
+            client,
+            replyToMsgId: "msg-1",
+            agentId: "main",
+            sessionKey,
+            nowMs: NOW,
+        });
+        assert.equal(calls.length, 0);
+    });
+    it("core 无卡 / 库不存在 → 登记成功但不发，不外抛", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        const { client, calls } = makeRecordingClient();
+        assert.doesNotThrow(() => registerCorePlanSnapshotClient({
+            groupId: "g-1",
+            client,
+            replyToMsgId: "msg-1",
+            agentId: "main",
+            sessionKey: "agent:main:nope",
+            nowMs: NOW,
+        }));
+        assert.equal(calls.length, 0);
+    });
+});
+//# sourceMappingURL=plan-core-snapshot.test.js.map

package/dist/src/plan-core-snapshot.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-core-snapshot.test.js","sourceRoot":"","sources":["../../src/plan-core-snapshot.test.ts"],"names":[],"mappings":"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"}

package/dist/src/plan-stat-event.d.ts

@@ -1,5 +1,4 @@
-import { type Plan } from "@xgjktech/xg-openclaw-shared";
-import type { ImStreamClient } from "./connection.js";
+import type { Plan } from "@xgjktech/xg-openclaw-shared";
 /**
  * 组装发往前端的 plan：剥离 origin（内部路由信息，含 sessionKey，前端不需要也不该看到）。
  * 返回浅拷贝，不 mutate 入参（middleware 拿到的 plan 引用可能别处还要用）。
@@ -7,26 +6,12 @@ import type { ImStreamClient } from "./connection.js";
 export declare function toWirePlan(plan: Plan): Plan;
 /**
  * 发送一条 PLAN_STAT。绝不抛、绝不 await 调用方（内部自己 catch）。
+ *
+ * 计划状态来自 core progress_card（工具事件 or DB 回放），内部 origin 的
+ * channel/to 用于路由到对应群的 WS client。
  */
 export declare function sendPlanStat(params: {
     plan: Plan;
     source: "tool" | "snapshot";
 }): void;
-/**
- * 登记 WS client（供后续 PLAN_STAT 增量路由），登记完立刻 fire-and-forget 触发一次快照：
- * 反查该群未完成的计划，只发最新一份 PLAN_STAT（source: "snapshot"）。
- * 同群残留的多份旧未完成计划不再逐个推给前端（前端按群只展示最新计划）；
- * 若最新一份超过 1 小时未更新，则视为已失败/过期，快照也不发（不留死计划在展示位）。
- *
- * dispatch 是热路径：整个快照过程包 try/catch、绝不 await、绝不抛——快照失败不能连累
- * WS 绑定本身（登记必须先于快照执行、且不受快照结果影响）。
- *
- * `deps.listPlansByOrigin` 默认注入 plan-store-access 的实现；测试可传入假实现
- * 模拟反查异常（红线防御性场景——即便被注入的反查实现意外抛出，本函数也绝不外抛）。
- * `deps.nowMs` 供测试注入固定时钟，缺省取 Date.now()。
- */
-export declare function registerPlanWsClientAndSnapshot(groupId: string, client: ImStreamClient, replyToMsgId: string, deps?: {
-    listPlansByOrigin: (channel: string, to: string) => Plan[];
-    nowMs?: number;
-}): void;
 //# sourceMappingURL=plan-stat-event.d.ts.map

package/dist/src/plan-stat-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-stat-event.d.ts","sourceRoot":"","sources":["../../src/plan-stat-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAG3C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,GAAG,IAAI,CA4BtF;AA8CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE;IACF,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;CACM,GAC1B,IAAI,CAkCN"}
+{"version":3,"file":"plan-stat-event.d.ts","sourceRoot":"","sources":["../../src/plan-stat-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAKzD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAG3C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,GAAG,IAAI,CA4BtF"}

package/dist/src/plan-stat-event.js

@@ -1,6 +1,4 @@
-import { isPlanCancelled } from "@xgjktech/xg-openclaw-shared";
-import { getPlanWsClient, setPlanWsClient } from "./plan-ws-registry.js";
-import { listPlansByOrigin } from "./plan-store-access.js";
+import { getPlanWsClient } from "./plan-ws-registry.js";
 const LOG_PREFIX = "[xg_cwork_im] [plan-stat-event]";
 /**
  * 组装发往前端的 plan：剥离 origin（内部路由信息，含 sessionKey，前端不需要也不该看到）。
@@ -12,6 +10,9 @@ export function toWirePlan(plan) {
 }
 /**
  * 发送一条 PLAN_STAT。绝不抛、绝不 await 调用方（内部自己 catch）。
+ *
+ * 计划状态来自 core progress_card（工具事件 or DB 回放），内部 origin 的
+ * channel/to 用于路由到对应群的 WS client。
  */
 export function sendPlanStat(params) {
     const { plan, source } = params;
@@ -37,89 +38,4 @@ export function sendPlanStat(params) {
         console.warn(`${LOG_PREFIX} 发送失败 planId=${plan.planId} groupId=${to}: ${String(err)}`);
     });
 }
-/** 「未完成」判定：计划未取消，且存在 status !== "completed" 的 task。 */
-function isUnfinished(plan) {
-    return !isPlanCancelled(plan) && plan.tasks.some((task) => task.status !== "completed");
-}
-/** 解析时间戳（ISO 或 epoch）；无效按 0 处理。 */
-function planTime(plan, key) {
-    const raw = plan[key];
-    if (typeof raw === "string" && raw.trim() !== "") {
-        const ts = Date.parse(raw);
-        if (!Number.isNaN(ts))
-            return ts;
-    }
-    return 0;
-}
-/** 取「最新」一份：优先 updatedAt（缺失时回退 createdAt）；键相同再比 createdAt，仍相同保持入参顺序。 */
-function pickNewestPlan(plans) {
-    if (plans.length === 0)
-        return undefined;
-    return plans.reduce((newest, plan) => {
-        const newestKey = planTime(newest, "updatedAt") || planTime(newest, "createdAt") || 0;
-        const planKey = planTime(plan, "updatedAt") || planTime(plan, "createdAt") || 0;
-        if (planKey > newestKey)
-            return plan;
-        if (planKey === newestKey) {
-            const newestCreated = planTime(newest, "createdAt");
-            const planCreated = planTime(plan, "createdAt");
-            return planCreated > newestCreated ? plan : newest;
-        }
-        return newest;
-    });
-}
-/** 快照新鲜度阈值：最新未完成计划超过 1 小时未更新，视为已失败/过期，快照不再推给前端。 */
-const PLAN_SNAPSHOT_STALE_MS = 60 * 60 * 1_000;
-/** 「新鲜」判定：以 updatedAt（缺失回退 createdAt）距 now 不超过 1 小时；取不到时间一律视为过期。 */
-function isPlanSnapshotFresh(plan, nowMs) {
-    const lastUpdateMs = planTime(plan, "updatedAt") || planTime(plan, "createdAt") || 0;
-    if (!lastUpdateMs)
-        return false;
-    return nowMs - lastUpdateMs <= PLAN_SNAPSHOT_STALE_MS;
-}
-/**
- * 登记 WS client（供后续 PLAN_STAT 增量路由），登记完立刻 fire-and-forget 触发一次快照：
- * 反查该群未完成的计划，只发最新一份 PLAN_STAT（source: "snapshot"）。
- * 同群残留的多份旧未完成计划不再逐个推给前端（前端按群只展示最新计划）；
- * 若最新一份超过 1 小时未更新，则视为已失败/过期，快照也不发（不留死计划在展示位）。
- *
- * dispatch 是热路径：整个快照过程包 try/catch、绝不 await、绝不抛——快照失败不能连累
- * WS 绑定本身（登记必须先于快照执行、且不受快照结果影响）。
- *
- * `deps.listPlansByOrigin` 默认注入 plan-store-access 的实现；测试可传入假实现
- * 模拟反查异常（红线防御性场景——即便被注入的反查实现意外抛出，本函数也绝不外抛）。
- * `deps.nowMs` 供测试注入固定时钟，缺省取 Date.now()。
- */
-export function registerPlanWsClientAndSnapshot(groupId, client, replyToMsgId, deps = { listPlansByOrigin }) {
-    setPlanWsClient(groupId, client, replyToMsgId);
-    try {
-        const nowMs = deps.nowMs ?? Date.now();
-        const plans = deps.listPlansByOrigin("xg_cwork_im", groupId);
-        const unfinishedPlans = plans.filter(isUnfinished);
-        if (unfinishedPlans.length > 1) {
-            console.warn("[xg_cwork_im] [plan-telemetry] multi-active " + JSON.stringify({
-                to: groupId,
-                count: unfinishedPlans.length,
-                planIds: unfinishedPlans.map((plan) => plan.planId),
-            }));
-        }
-        // 快照只发最新一份：同群多份未完成计划时旧计划被丢弃，仅遥测提示。
-        const newest = pickNewestPlan(unfinishedPlans);
-        if (!newest)
-            return;
-        if (!isPlanSnapshotFresh(newest, nowMs)) {
-            console.warn("[xg_cwork_im] [plan-telemetry] stale-plan-dropped " + JSON.stringify({
-                to: groupId,
-                planId: newest.planId,
-                updatedAt: newest.updatedAt ?? null,
-                createdAt: newest.createdAt ?? null,
-            }));
-            return;
-        }
-        sendPlanStat({ plan: newest, source: "snapshot" });
-    }
-    catch (err) {
-        console.warn(`${LOG_PREFIX} 会话快照失败，已吞 groupId=${groupId}: ${String(err)}`);
-    }
-}
 //# sourceMappingURL=plan-stat-event.js.map

package/dist/src/plan-stat-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-stat-event.js","sourceRoot":"","sources":["../../src/plan-stat-event.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan-stat-event.js","sourceRoot":"","sources":["../../src/plan-stat-event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,UAAU,GAAG,iCAAiC,CAAC;AAErD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACjC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC9C,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmD;IAC5E,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEhC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,aAAa,IAAI,CAAC,EAAE,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CACR,GAAG,UAAU,4CAA4C,IAAI,CAAC,MAAM,YAAY,OAAO,IAAI,QAAQ,EAAE,CACxG,CAAC;QACF,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,sCAAsC,IAAI,CAAC,MAAM,YAAY,EAAE,EAAE,CAAC,CAAC;QAC7F,OAAO;IACX,CAAC;IAED,KAAK,MAAM,CAAC,MAAM;SACb,SAAS,CAAC;QACP,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;KAC3C,CAAC;SACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACpB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,gBAAgB,IAAI,CAAC,MAAM,YAAY,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACX,CAAC"}